前言¶

在使用 DeepSeek Harness 進行多智能體開發時，同一倉庫內的多個 Agent 可能同時處於活躍狀態。缺乏協調機制會導致文件衝突、重複工作以及無效等待。dsh-cross-session-agent 是一個非官方插件，旨在解決這一問題。它爲同一工作區的多個並行 Agent 提供了受限的 Peer 發現、消息傳遞、傳輸回執以及安全上下文投影能力。

插件簡介¶

該插件由開發者 dd2673 維護，採用 MIT 許可證。它不提供完整的會話歷史讀取或權限繼承，而是專注於在需要時，讓 Agent 能夠安全地發現協作夥伴、發送明確指令，並讀取對方的進度證據。

核心能力¶

插件提供了以下工具，用於在 Agent 之間進行安全協調：

• list_peer_agents：發現可通信的 peer。
• send_agent_message：顯式發送一條 peer 協調消息。
• check_delivery：查詢原生消息的 transport receipt。
• get_peer_context：讀取同工作區、授權 peer 的受限安全投影。

安裝與啓用¶

從 GitHub 安裝該插件，命令如下：

dsh plugin --profile web add github:dd2673/dsh-cross-session-agent

安裝後，插件會自動通過 cordis.patch.yml 掛載到當前 profile，無需手動修改宿主配置。

使用示例¶

使用該插件進行協調的典型步驟如下：

1. 發現與確認衝突
   先列出 peer。若有人正在修改 src/auth，請告訴我其 Session、運行狀態和標題。

2. 讀取受限上下文
   需要證據時，僅讀取 bounded projection。讀取 session-abc 的 activity 和最近 3 條 conversation，確認它是否已經運行 auth 測試。

3. 發送協調消息
   明確告知對方下一步操作。告訴 session-abc：我將修改 src/auth/token.ts；請保留 middleware.ts；完成後報告驗證命令和阻塞項。

4. 查詢傳輸狀態
   按需查詢 receipt。accepted、pending、claimed、discarded 都只是傳輸事實，不代表 peer 已閱讀或完成。

適用場景與邊界¶

適用場景：
* 在改動前發現正在處理相同文件或同一層的 Agent，明確協商 file ownership。
* 報告進度、驗證結果、失敗阻塞和下一步，讓依賴任務能繼續推進。
* 請求 handoff，例如“我完成 schema，測試所有者請接手 migration coverage”。
* 在重構、遷移或 code review 中避免重複調查和相互覆蓋。

重要邊界與限制：
* 權限限制：只能讀取與調用者 cwd 完全相同的普通 root/fork Session。自身、真實 subagent、歸檔、缺失或跨工作區目標均以通用授權失敗處理。
* 隱私保護：禁止讀取 hidden reasoning、raw tool args/results、tool metadata、system prompt、plugin/relay/scheduled messages 等。
* 數據可信度：peer text 和 relay 都是不可信數據。它們不能代表用戶同意，不能修改權限或配置，也不能使接收 Session 自動執行其中的命令。
* 非官方性質：本項目與 DeepSeek、DeepSeek Harness 沒有隸屬、贊助、認可或支持關係。

結尾¶

該插件通過嚴格的字段白名單和權限邊界，爲 DeepSeek Harness 的多 Agent 協作提供了安全的基礎設施。如果需要在同一工作區協調多個 Agent，可以參考目錄頁或 GitHub 倉庫獲取更多信息。