在 DeepSeek Harness（DSH）的插件生態中，構建多 Agent 協作系統通常面臨 Agent 崩潰導致任務丟失、長輸出消耗大量 Token、以及 Agent 頻繁冷啓動帶來的延遲。dsh-swarm 插件 v0.4.0 通過引入常駐進程和任務賬本機制，解決了這些問題。
核心功能¶
- 常駐 Agent：每個 Agent 是一個獨立 Node.js 進程，循環讀取 inbox、執行任務、寫入 outbox，無需每次冷啓動。
- 獨立 API：每個 Agent 獨立配置模型、Provider、apiBaseUrl 和 apiKey，寫入各自的
state.json。 - 工件引用傳遞：長產出自動落盤到共享工件庫，Agent 間消息只傳遞
art://<id>引用 + 200 字摘要，需要全文時按引用展開，大幅節省 Token。 - 任務賬本 + 看門狗：任務狀態機爲
pending → claimed → done/failed。失敗會自動重試（最多 3 次），claimed狀態超過 5 分鐘無進展會自動重派，防止 Agent 崩潰導致任務丟失。 - 可視化 UI：DSH 界面內置團隊面板，支持可視化創建/刪除空白 Agent、查看任務賬本進度。
- 內置聯網：Agent 自帶
web_search/web_fetch（jina.ai），無需額外插件。
安裝與啓用¶
# 複製到本地插件目錄
cp -r dsh-swarm ~/.dsh/local-plugins/dsh-swarm
# 同步到 desktop profile 副本（Windows 下 link: 不生效，是物理拷貝）
robocopy "local-plugins\dsh-swarm" "profiles\desktop\node_modules\dsh-swarm" /MIR
# 重啓 DSH（引擎啓動時自動加載）
典型用法¶
- 添加 Agent：可以在對話中直接添加，例如：“添加一個 Agent，ID 叫 researcher1，用 deepseek-chat，API 是 https://api.deepseek.com/v1”。也可以在團隊面板點擊“添加”。
- 組隊幹活：當遇到複雜任務時，領隊會自動拆分任務並分配給 Agent 執行。例如：“幫我調研 X 框架和 Y 框架的優劣，寫一份對比報告”。
- 看進度：DSH 界面內置的團隊面板會實時顯示 Agent 狀態（⏳pending 🔄claimed ✅done 💀dead）與任務賬本進度。
與 agent-teams 的區別¶
| 維度 | agent-teams | dsh-swarm |
|---|---|---|
| 隊員形態 | 同進程 subagent | 獨立常駐進程 + 獨立 API |
| 結果傳遞 | 全文經主會話中轉 | 工件引用 + 摘要，按需展開 |
| 失敗處理 | 任務丟失 | 賬本重試 + 看門狗自動重派 |
| 適用場景 | 簡單委派 | 複雜多角色協作 / 長任務 |
工具列表¶
用戶工具
swarm_add_agent：添加空白 Agent（指定 agent_id / model / provider / api_base_url / api_key）。swarm_remove_agent：刪除 Agent，停止其進程。swarm_list_agents：查看所有 Agent 狀態與角色分配情況。
Captain 工具
swarm_create_team：組建團隊：自動給空白 Agent 分配角色（researcher/coder/analyst/reviewer），啓動進程。swarm_set_agent_prompt：給 Agent 寫角色提示詞（內置 4 種模板或自定義全文）。swarm_send_task：派發任務：寫 inbox → 輪詢 outbox → 返回結果（長結果返回art://引用）。swarm_read_results：非阻塞讀取 Agent 已產出的結果。swarm_read_artifact：按art://<id>引用展開工件全文（支持 max_chars 分段）。swarm_status：團隊狀態 + 任務賬本（觸發一次看門狗掃描）。swarm_disband：解散團隊，停止所有 Agent 進程（不刪除 Agent）。
適用場景與注意¶
該插件適合需要多角色分工、長流程輸出的複雜任務場景。由於插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-swarm 通過常駐進程、獨立 API、工件引用傳遞和任務賬本看門狗機制，構建了一個健壯的多 Agent 協作環境。它解決了傳統多 Agent 系統中 Token 浪費和任務可靠性低的問題。
- 目錄頁：https://www.skillhub.cn/plugins/wanghj040530/dsh-swarm
- GitHub：https://github.com/wanghj040530/dsh-swarm
