前言¶
在 DeepSeek Harness（DSH）里跑多智能体或协作工作流时，常见做法是各自维护上下文、用临时文件或聊天窗口传话。项目一变大，文档共享、收件箱式沟通和任务进度上报就会和「当前会话里正在用的模型与账号」脱节。若再单独起一个员工 CLI 或在本插件里配置 LLM Provider，权限和身份边界也更难控。
下面介绍 dsh-agent-mailbox：由 polaris-smart 维护的 DSH 插件，把已有 DSH 会话桥接到本地 agent-mailbox v0.8，用项目私有会话连接文件绑定「一名员工 ↔ 一个项目」，在会话内暴露 agent-mailbox 授权的 project_* MCP 工具。插件不启动额外的员工 CLI，也不替你配置模型供应商；运行时除宿主提供的 @deepseek-ai/cordis 外无其它 npm 依赖，要求 Node >= 22.18（候选版本 0.8.0，MIT 许可证）。
这是什么¶
dsh-agent-mailbox 是项目范围的 agent-mailbox 适配层：激活时发现并注册后端已授权的 project_* MCP 工具及其真实 schema。当前 v0.8 侧重的能力是上下文、共享 memory/资源、收件箱与回复、以及分配任务的进度相关工具。会话文件把一名 DSH 员工固定到一个项目；读邮件不会自动标记为已接受或已完成，普通消息也不会自动开任务，人工接受流程仍与工具桥接分离。
与旧版「全局 mailbox 桥」不同，0.8 不再暴露 legacy 的 mailbox_* 别名、身份覆盖或托管任务唤醒类工具；旧的 agentId、home、runner、uvxFrom、pythonSrc 等配置会被拒绝并提示迁移，旧全局收件箱也不会自动导入。
核心功能（v0.8）¶
依据仓库 README，可核对的能力包括：
- 项目级 MCP 工具：插件实例各自维护连接与生命周期；启动或发现失败会明确失败，销毁时注销工具并关闭子进程。插件本身不读取 token 或数据库。
- 协作语义：加入项目、共享经批准的文档、通过信箱交换消息、上报任务进度，均在使用该员工自己的模型与账号的 DSH 会话内进行。
- 身份与 subagent：subagent 向父 agent 汇报；不要把私有 session 文件共享给 subagent。应用侧的自动通知能力与该工具桥接是分开的。
- Workbench 依赖：agent-mailbox 工作台需保持打开；可在本机换端口重启。成员资格过期或撤销后，需重新连接并导出新的连接文件。
安装与启用（v0.8 迁移路径）¶
官方 README 给出的路径是：先在本机安装 agent-mailbox v0.8 并打开其工作台，再在 agent-mailbox 中注册你的 DSH 员工、加入项目，并导出该项目的私有 session 连接文件。随后在 DSH 环境中安装本插件，并通过 overlay 注入配置（路径须为绝对路径；不要把密钥或 bearer token 写进 overlay、版本库或聊天）：
- insert:
- id: dsh-agent-mailbox
name: dsh-agent-mailbox
config:
sessionFile: /absolute/path/to/private/employee-session.json
executable: /absolute/path/to/agent-mailbox
说明：
executable指向已安装的 agent-mailbox 命令/后端，不是 DMG 容器路径。- 若为 Python 安装方式，可设
executable: /absolute/path/to/python，并用executableArgs: ['-m', 'agent_mailbox']；参数以数组形式传递，不经 shell 展开。
按你所在宿主环境的 profile/patch 流程，用该 overlay 新开一条 DSH 会话；文档未声称对已在进行中的对话热更新配置。npm 发布渠道名为 dsh-agent-mailbox（维护者 polaris-smart）；请勿与无 scope 的无关 npm 包 agent-mailbox 混淆。
典型用法（可复现流程）¶
- 安装 agent-mailbox v0.8，打开 workbench，完成员工注册与项目加入。
- 导出 private employee-session.json（或 README 所称的 private session connection file）。
- 在 DSH 插件配置中填入
sessionFile与executable（及可选的executableArgs）。 - 新开 DSH 会话后，在对话中调用已注册的
project_*工具：查阅共享资源、处理收件箱与回复、更新分配任务进度等（具体工具名以激活时发现的 schema 为准）。
适用场景与注意¶
适合：已在用 DSH 做长会话开发、并希望与 agent-mailbox 项目成员、共享文档和任务进度对齐的团队；需要「零额外运行时 npm 依赖、Node 22+」的轻量桥接。
务必注意：
- 插件以当前 dsh 进程权限运行；安装与启用前应自行审阅 GitHub 源码 与 MIT 许可证（agent-mailbox 应用本身为 Apache-2.0，含 NoFox 署名，安装适配器不改变各自许可证）。
- 资料中未给出统一的
dsh plugin add github:...一行命令；以 README 的 overlay + 新会话流程为准。 - 社区目录页（skillhub.cn 插件条目）为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本稿事实以仓库 README 与 package 元数据为准。
结尾¶
dsh-agent-mailbox 把 DSH 里正在跑的那条会话，接到 agent-mailbox 的项目私有连接上，用 MCP 工具完成信箱与任务进度协作，而不用在本插件里再配一套 Provider 或员工 CLI。若要查看分类与简介，可打开目录页 polaris-smart/dsh-agent-mailbox；实现细节与迁移说明见 GitHub 仓库。
