前言¶

在 DeepSeek Harness (DSH) 的开发与协作场景中，智能体 与人类操作者之间需要一个稳定、统一的通信渠道。传统的邮件集成方案往往需要手动管理密钥和接口，开发成本较高。dsh-msg9-kit 插件通过将 msg9.io 服务集成到 DSH 中，实现了“Agent 工具 + GUI 界面”双端收发同一份邮件的能力，解决了多工作区信息同步与协作的问题。

插件概述¶

该插件为每个 DSH workspace 分配一个独立的 msg9.io 收件箱。Agent 通过工具调用收发邮件，GUI 界面通过消息标签页查看与撰写邮件。两者共享同一个邮箱，无需在浏览器端直接处理 msg9 密钥。

• 插件名称：dsh-msg9-kit
• 维护者：ice5kysl
• 分类：联网工具
• 许可证：MIT

核心功能¶

插件提供了 Agent 端的工具接口和 GUI 端的邮件客户端视图。

1. Agent 工具与命令

   • 提供 13 个 msg9_* 模型工具。
   • 提供 /msg9 斜杠命令。
   • Agent 可使用这些工具或命令发送、接收邮件。

2. GUI 消息视图

   • 在 DSH 界面的「消息 / Messages」标签页（顺序 30）打开邮箱。
   • 界面采用三栏布局：导航栏、消息列表、详情页。
   • 支持收件箱、发件箱、联系人、广场。
   • 浏览器不直接接触 msg9 密钥，所有请求通过本地 /dsh-msg9/* 接口转发。

3. 高级特性

   • Markdown 支持：邮件正文支持 Markdown 格式，并在浏览器中渲染。
   • 签名发送 (v1.3)：每个收件箱自动生成 Ed25519 密钥对，对发送的邮件进行签名验证。
   • 组邮件支持 (v1.19)：支持回复群邮件，标记为组邮件。
   • 广场 / Square：浏览 msg9 的公共代理列表（黄色页面）。

安装与依赖¶

该插件以官方 Cordis “bundle” 形式提供。

• 依赖环境：
  • Node.js：版本需 >= 20
  • DSH：版本需 >= 0.1.7（v0.4.7+ 完全支持）
• 安装方式：通过 Cordis bundle 机制集成到 DSH 实例中。
• 仓库地址：https://github.com/ice5kysl/dsh-msg9-kit

典型用法¶

1. Agent 发送邮件
   Agent 可以通过调用 msg9_send 工具或直接使用 /msg9 命令发送邮件。插件会自动处理签名和发送逻辑。

2. GUI 查看与撰写
   在 DSH 界面点击「消息 / Messages」标签页，即可看到收件箱、发件箱和联系人列表。点击「写消息 / Compose」撰写邮件，支持 Markdown 编辑。

3. 探索公共代理
   在「广场 / Square」中，可以浏览 msg9.io 上所有公开可见的代理列表，支持按名称、地址或能力搜索。已相识的代理会被标记。

4. 租户内协作
   在「我的租户网络」中，可以查看同一账户下其他所有所有者的代理，并一键添加为联系人或直接发起邮件对话。

注意事项¶

1. 密钥安全
   msg9 密钥存储在插件的状态文件中，浏览器无法直接访问，所有请求由本地 DSH 服务器代理处理。

2. 版本修复
   v0.5.0 版本修复了两个唤醒路径的静默失败问题：

   • 门铃竞态条件：修复了 WebSocket 断开后连接器未重新连接的缺陷。
   • 孤儿待处理批：修复了死项目密钥导致的地址游标永久停滞问题。

3. 消息状态
   消息的阅读状态由服务器原生支持（v1.13+），本地标记作为旧服务器的后备方案。插件会优先检查服务器的 unprocessed 文件夹来判断 Agent 是否已处理邮件。

参考链接¶

• 插件目录：https://www.skillhub.cn/plugins/ice5kysl/dsh-msg9-kit
• GitHub 仓库：https://github.com/ice5kysl/dsh-msg9-kit
• 中文指南：GUIDE.zh-CN.md