前言¶
DSH 可以通過插件擴展能力。對多智能體場景來說，難點不只是給每個 agent 寫 persona，還要決定誰能向誰發消息、誰只能看到下游、最後由誰輸出結果。
DSH Cluster Plugin 提供一套 cluster mode：在 dsh web 中打開畫布，用節點表示 agent，用有向邊聲明允許的消息流，並讓 agent 通過 cluster_view、cluster_send、cluster_spawn 進行協作。
這是什麼¶
DSH Cluster Plugin 的包名是 @lanxi266/dsh-cluster-plugin，倉庫爲 https://github.com/Lanxi26/dsh-cluster，維護者爲 Lanxi26，許可證爲 MIT。
它面向 DeepSeek Harness 的 cluster mode，提供三件事：
- Canvas node-graph
- Agent management
- Flow-constrained message routing
一句話定位：它是一個把多智能體協作畫成圖、並限制消息可達範圍的 DSH 插件。
核心功能¶
畫布節點圖¶
在 dsh web 的 cluster canvas 中，可以做以下操作：
- 添加節點
- 連接邊，邊可以是
one-way、two-way或none - 將節點綁定到 agent
- 重命名節點或 agent
這裏的“節點”不是普通流程塊，而是承載一個 agent 的運行位置。
Agent 管理¶
每個 agent 有：
nameprompt，即 personamode- 可選的
space
agent 數據會自動保存到：
$DSH_HOME/cluster-agents/<id>/agent.json
三種 mode 分別是：
| mode | 行爲 |
|---|---|
single |
用 cluster_send 尋址，目標是該 agent 最近運行 session |
multi |
用 cluster_spawn 尋址，每次創建新的實例 |
any |
cluster_send 和 cluster_spawn 都可以 |
信息流約束¶
邊是有向的，且 deny-by-default：只有聲明過的流可以 cluster_send / cluster_spawn。
如果沒有邊，圖是完全開放的，適合先試流程。
cluster_view 只會顯示自己以及自己的下游。所以下游 agent 看不到上游，只能把消息繼續往下傳。
運行時工具包括：
cluster_view：查看當前可用接收消息的 agent 實例和類別cluster_spawn：創建一個新 agent 實例，併發送第一條消息cluster_send：向某個正在運行的實例 inbox 投遞消息
導出 / 加載¶
可以把圖和 agent 屬性一起導出爲 .txt JSON，版本爲 v2；在另一個位置加載後，可以恢復 agent 並寫回磁盤。
Identity space¶
可以爲某個 agent 可選地掛一個磁盤目錄。agent 的 persona 會被提示先瀏覽這個空間。這樣 Skills、scripts、long-term memory、personality files、agent.md 等材料可以放在各自 agent 的空間裏。
安裝與啓用¶
前置條件：
- Node ≥ 22.19（official DSH requirement）
- 當前 profile 已包含官方
@deepseek-ai/dsh-base和@deepseek-ai/dsh-web-appbundles
先添加插件：
dsh plugin --profile web add @lanxi266/dsh-cluster-plugin
然後啓動 web profile：
dsh --profile web web
也可以寫成：
dsh web
插件包本身是 bundle，會引入：
@lanxi266/dsh-cluster-agent-fs@lanxi266/dsh-tool-cluster@lanxi266/dsh-client-ui-cluster
典型用法¶
1、打開 dsh web，點擊左下角的 cluster icon，打開 canvas。
2、在 Agents bar 中添加 agent，例如 id math_teacher，填 name、persona，並選擇 mode。
3、在 canvas 上雙擊添加節點，把節點綁定到 agent，然後連接節點；拖拽 A → B 表示 A 可以發消息給 B。
4、進入某個節點：入口 agent 會收到 persona 和 workflow hint，並使用 cluster_view、cluster_send、cluster_spawn 進行協作。
5、最後一個鏈接的 cluster_view 只顯示自己；此時 agent 被提示直接產出最終結果，使流程終止。
適用場景與注意¶
適合：
- 需要在 DSH 中可視化多 agent 協作
- 需要限制 agent 之間誰能向誰發消息
- 需要把 graph 和 agent 配置導出、加載
- 需要給 agent 掛獨立目錄，讓其先讀取本地材料
注意：
- 插件會以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴和 MIT 許可證。
- 空圖是完全開放的；正式使用前，應明確畫出需要的有向邊。
- agent 數據會寫入
$DSH_HOME/cluster-agents/<id>/agent.json，備份、遷移和清理時要包含這個路徑。 cluster_view的可見範圍只到下游，不要依賴上游信息在下游出現。- 作者說明項目可能仍有較多 bug；建議先在本地驗證關鍵鏈路。
鏈接¶
GitHub：https://github.com/Lanxi26/dsh-cluster
包名：@lanxi266/dsh-cluster-plugin
社區目錄頁 URL 未在本次資料中確認，可按上述包名檢索。
