前言¶
在 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 倉庫。
