前言¶
DeepSeek Harness (DSH) 旨在通過插件化架構實現功能的無限擴展。在分佈式智能體開發場景中,跨主機的連接、信任建立以及會話管理是常見痛點。DSH Weave 專注於解決這一問題,它通過 Iroh 協議層,爲多個 DSH 實例提供加密、可信的連接通道,並統一管理主機身份和可達性。
插件介紹¶
DSH Weave 是一個連接明確信任的 DeepSeek Harness 主機的插件。它基於 Iroh 實現 QUIC 加密傳輸,負責主機信任、端點刷新、可達性檢測以及認證請求的傳遞。插件的核心職責包括身份的持久化存儲和受信任對等方的管理。
核心功能¶
該插件主要提供以下能力:
* 持久化身份:主機身份在重啓後保持一致,無需重複初始化。
* 明確配對:通過交換票據並在本地明確信任對方,建立安全連接。
* 加密傳輸:利用 Iroh 提供 QUIC 連接、直連路徑和中繼回退機制,確保傳輸安全。
* 遠程目錄:發現並訪問已配對主機上的工作區和會話。
* 可見狀態:主機可達性與 DSH Agent 的空閒/運行/離線狀態是分離的。
* 原生設置:提供分組管理的身份和配對控制,包含複製反饋和移除確認。
安裝與啓用¶
在目標主機上執行以下命令進行安裝:
dsh plugin --profile web add dsh-weave@latest
安裝完成後,運行 dsh web 啓動 Web 界面。
典型用法¶
- 在參與連接的每臺主機上分別執行上述安裝命令。
- 在每臺主機上啓動 DSH Web:
dsh web。 - 在兩臺主機的 Web 界面中,分別打開 Settings -> Weave。
- 通過一個雙方都信任的渠道(如安全聊天或終端)交換兩臺主機的票據。
- 在每臺主機的 Weave 設置中,添加並明確信任對方提供的票據。
- 配對完成後,使用 DSH Chat 等插件選擇遠程會話進行操作。
適用場景與注意¶
DSH Weave 以當前 DSH 進程的權限運行。安裝前應檢查源碼與許可證(MIT)。
- 前置條件:需要 Node.js >= 22。
- 數據存儲:身份和受信任的對等方存儲在
$DSH_HOME/dsh-weave(默認爲~/.dsh),僅限所有者權限。 - 連接行爲:取消請求會關閉連接,接收端的監聽器會收到斷開通知。取消操作不會將主機標記爲離線。
- 當前版本狀態:當前版本爲傳輸 MVP(最小可行性產品),主要提供配對、目錄訪問和認證請求投遞。尚未實現通用的遠程任務審批工作流,也不具備持久化傳輸出站消息或斷線重連重放機制。
- 生態背景:該插件是 DSH 生態系統的一部分,社區目錄與 DeepSeek 官方無從屬關係。
結尾¶
DSH Weave 爲 DSH 多機協作提供了基礎的信任傳輸層。通過 Iroh 的加密和持久化能力,開發者可以更安全地管理分佈式智能體的連接。更多詳情可查閱社區目錄或 GitHub 倉庫。