前言¶

對於 DSH 使用者來說，如果一次委託只處理一句任務，面對一批有依賴關係的任務時，還需要人工處理並行、隔離、衝突和恢復。TaskSwarm 把這些事情收進一個插件裏：先按依賴關係把任務分成 waves，再讓同 wave 內的任務在獨立 lane 中並行執行，最後做審查、合併和狀態保留。

下面介紹 TaskSwarm 的定位、核心能力、安裝方式和典型用法。

這是什麼¶

TaskSwarm（蜂羣）是 DeepSeek Harness (DSH) 上的多智能體任務編排插件，npm 包名爲 dsh-taskswarm，由 february2015 維護，許可證爲 MIT。資料標註其上游爲 TaskPlane，本項目爲 native port。

它把一批任務組織爲任務包，並在 DSH 會話中提供 supervisor、worker、reviewer、merger 的協作流程。

核心功能¶

Waves / Lanes 並行編排¶

• 任務按依賴 DAG 分層爲 waves。
• 同一個 wave 內的任務併發執行，形成 parallel lanes。
• lane worktree 從 taskswarm/orch HEAD 創建，繼承先前已合併的輸出。

Git worktree 隔離¶

• 每個任務或 lane 使用獨立 worktree。
• lane 的結果合併到 taskswarm/orch。
• taskswarm/orch 是集成分支，應保留，不要刪除。

Task packets¶

• 每個任務包含 PROMPT.md 與 STATUS.md。
• PROMPT.md 保存任務說明、步驟和約束。
• STATUS.md 保存進度，爲 worker 提供跨上下文重置的持久任務記憶。

Checkpoint discipline¶

• 步驟邊界自動 git commit。
• worker 崩潰時，已提交工作不會丟失。
• 持久磁盤狀態、checkpoints 和保留的 lane 分支共同支持崩潰恢復。

Cross-model review¶

• 獨立 reviewer 按任務 Review Level 打分。
• PASS 合併。
• REVISE 回退給 worker 修改。

File mailbox¶

• worker 與 supervisor 通過文件異步通信。
• 通信不依賴共享上下文。

Conversational supervisor¶

• supervisor 與當前 DSH 會話共享。
• 支持 start、pause、abort、integrate、open dashboard 等指令。
• 通知和 prompt 爲中文 / English 雙語。
• 語言設置持久化到 .taskswarm/config.json。

Web Dashboard¶

• 本地即時 dashboard，基於 node:http + SSE。
• 啓動批次時自動啓動 dashboard，並在會話中打印鏈接。
• 每個 workspace 僅一個實例；已有實例會被複用，不會重複啓動。

LLM merge agent¶

• lane 合併到 taskswarm/orch 發生衝突時，由獨立 merger 代理做語義解決。
• 無法解決時，lane 進入 conflict 狀態並暫停批次。

安裝與啓用¶

先安裝 npm 包：

dsh plugin --profile web add dsh-taskswarm

安裝後重啓：

Restart dsh web

插件在 DSH 啓動時生效。

2026-08-17 至 2026-08-18 期間，npm 包 dsh-taskswarm 曾下架，需從 GitHub 安裝；2026-08-19 起 npm 包恢復。

升級已安裝版本時，如果直接執行：

dsh plugin --profile web add dsh-taskswarm

可能報告 Already up to date。此時需要顯式指定新版本：

dsh plugin --profile web add dsh-taskswarm@<new-version>

或者運行：

pnpm update --latest

完成後重啓 dsh web。

典型用法¶

先創建示例任務包：

/tswarm-init

該命令會創建 EXAMPLE-001 和 EXAMPLE-002 兩個示例任務包。

再預覽 wave 計劃：

/tswarm-plan all

該步驟只預覽按依賴分組後的任務計劃，不執行任務。

然後啓動批次：

/tswarm all

並行運行所有任務；也可以運行單個任務：

/tswarm EXAMPLE-002

隨時查看進度：

/tswarm-status

打開 dashboard：

/tswarm-dashboard

也可以用獨立 CLI 啓動：

npx taskswarm-dashboard --root <repo>

或不先安裝插件，通過 npx 臨時獲取：

npx --package dsh-taskswarm taskswarm-dashboard --root <repo> [--port 8100] [--no-open]

啓動批次時，dashboard 會啓動並在會話中打印鏈接。

校驗任務包：

/tswarm-check

或：

npm run check:tasks

狀態與 Git 模型¶

持久狀態位於：

<repo>/.taskswarm/

批次狀態文件爲：

.taskswarm/batches/<batchId>.json

Git 模型中，taskswarm/orch 是集成分支，所有 lane 輸出合併到這裏；它應保留，不要刪除。

lane worktree 的基線來自 taskswarm/orch HEAD，這樣 lane 會繼承此前已合併的輸出。

適用場景與注意¶

適合一批相關任務需要依賴排序、並行執行、工作區隔離、審查合併和崩潰恢復的場景。

注意：

• 插件會以當前 dsh 進程的權限運行，能訪問倉庫、git 狀態和本地端口；安裝前應檢查源碼、依賴和 MIT 許可證。
• taskswarm/orch 是集成分支，不要誤刪。
• 升級後如果仍停留在舊版本，需顯式指定新版本或更新依賴，再重啓 dsh web。
• 它發佈在社區目錄中，目錄是獨立站點，不應視爲官方應用商店。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/february2015/dsh-taskswarm
• GitHub：https://github.com/february2015/dsh-taskswarm