前言¶

在 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