Erick114514/dsh-agent-mailbox

dsh-agent-mailbox

一个 DeepSeek Harness 宿主插件，它在进程范围内注册 Agent Hub 邮箱工具，
因此每个 DSH 智能体会话都可以通过一个共享的文件邮箱与其他智能体通信：

- deepseek（本 harness）
- claude-code
- codex
- openclaw（预留，可选）

文件

| 文件 | 用途 |
| --- | --- |
| agent-hub.plugin.mjs | 宿主插件（ESM Cordis 插件行），注册 agent_hub_send / agent_hub_check / agent_hub_status / agent_hub_bootstrap。 |
| cordis.patch.yml.example | 用于 web 配置文件用户层的安装行。 |

安装

1. 将插件复制到你的 DSH web 配置文件中：

/profiles/web/agent-hub.plugin.mjs

在 Windows 上，默认的 DSH 主目录是 C:\Users\\.dsh，因此目标位置是
C:\Users\\.dsh\profiles\web\agent-hub.plugin.mjs。

2. 将 cordis.patch.yml.example 中的插入行追加到
/profiles/web/cordis.patch.yml。

3. 确保 /profiles/web/package.json 声明了 "version"。DSH 的
dsh_plugin_packages 请求扩展会读取活动插件的所属包清单；如果没有
version，每个模型请求都会以 REQUEST_EXTENSION 失败。

4. 重启 DeepSeek Harness。

5. 在新的 DSH 会话中，确认四个工具都可见，然后运行一次
agent_hub_bootstrap，使邮箱根目录包含 hub.mjs、hub.json、
protocol.json、README.md 以及各智能体指南。

工具行为

- agent_hub_status 报告邮箱根目录、已注册的智能体、已投递数量
以及读取游标。
- agent_hub_check 默认读取 deepseek 的新消息；mark: false 会保持
游标不变。
- agent_hub_send 将一条消息文件写入收件人收件箱。
- agent_hub_bootstrap 以幂等方式刷新引导文件，并且绝不会重置
收件箱历史或已读游标。

默认 hub 根目录是 /.agent-hub（在 Windows 上为 \.agent-hub）；
设置 config.hubRoot 以使用其他位置。

卸载

从 cordis.patch.yml 中移除 agent-hub 插入块，删除
agent-hub.plugin.mjs，然后重启 DeepSeek Harness。