前言¶
DeepSeek Harness(DSH)把「一切皆插件」貫徹得很徹底:模型、工具、界面能力都可以按需拼裝。但對實際開發來說,單會話 Agent 往往力不從心——審查代碼要分安全、性能、產品多條線,調研競品要並行抓取,寫文檔又要前後端分工。自己手寫多 Agent 編排、任務隊列和狀態機,成本不低;接一套獨立 Workflow 引擎,部署和維護又更重。
社區插件 dsh-agent-teams(npm 包名 @nanmicoder/dsh-agent-teams)走了一條更貼近 DSH 原生體驗的路:讓當前會話當「隊長」,自動拉起可續聊的子 Agent 成員,把目標拆成帶依賴的任務,並提供持久化狀態、共享調度器和 Web 活動面板。該插件由 NanmiCoder(作者 Relakkes)維護,在 SkillHub 插件庫 歸類爲工作流,GitHub 倉庫 NanmiCoder/dsh-agent-teams 採用 MIT 許可證;截至 2026-08-25,GitHub 顯示約 962 star、82 fork,npm 最新版本爲 0.1.13。需要說明的是,SkillHub 與 DeepSeek Harness 官方並無從屬關係,它只是社區整理的插件目錄之一。
這是什麼¶
dsh-agent-teams 是 DeepSeek Harness 的 AgentTeams 協作插件。一句話定位:用自然語言描述目標,當前 DSH 會話成爲隊長,創建一支由子 Agent 組成的團隊,按依賴關係分工執行,最後由隊長彙總結果。
它解決的核心痛點是:在 Harness 內部完成多 Agent 編排,而不必額外搭建 Workflow 引擎。插件自帶團隊協議、10 個協作工具、文件持久化、自動任務調度,以及 Web GUI 裏的即時活動面板(分段進度、成員樹、可交互任務 DAG)。
核心功能與亮點¶
根據官方 README 與倉庫文檔,已覈實的主要能力如下:
- 隊長式委派:當前會話負責建隊、分配角色、彙總最終結果,流程清晰。
- 可續聊成員:成員是 DSH 可繼續喚醒的子 Agent,適合多輪聚焦跟進,而不是一次性腳本。
- 帶依賴的任務拆分:任務有明確狀態(如
running / idle / ready),前置依賴未完成時不能領取,避免亂序執行。 - 自動調度與安全接管:空閒成員自動領取下一項就緒任務;轉派會撤銷舊 attempt;進程冷重啓後,調度器會重試遺留的開放任務。
- 成員直達消息:成員通過持久化郵箱直接聯繫隊友或隊長,無需隊長逐條中轉。
- 即時 Web 活動面板:Web UI 展示團隊進度與任務 DAG;團隊歸檔後仍保留完整成員與任務歷史。面板文案隨 Harness 官方 locale 在中英文間切換。
- Slash 命令入口:註冊
/agent-teams命令,Web GUI 的 slash 菜單可直接選用;headless CLI 下以/agent-teams開頭的用戶消息也會觸發協議。 - 默認零交互建隊:成員默認沿用隊長當前 LLM 路由;只有明確提出異構分工(如「後端用 A 模型、前端用 B 模型」)時,才爲特定成員指定
provider+model。
安裝與啓用¶
使用前請確認本機已安裝 DeepSeek Harness。插件要求 Node ^22.19.0 或 >=24(見倉庫 package.json)。
方式一:npm 安裝(官方 README 推薦,適合 Web Profile)¶
dsh plugin --profile web add @nanmicoder/dsh-agent-teams@latest
方式二:從 GitHub 源碼安裝¶
社區目錄 deepseek-harness-plugin.com 給出的命令爲:
dsh plugin add github:NanmiCoder/dsh-agent-teams
如需可復現安裝,可固定 commit:
dsh plugin add github:NanmiCoder/dsh-agent-teams#<commit-hash>
方式三:本地源碼構建¶
git clone https://github.com/NanmiCoder/dsh-agent-teams.git
cd dsh-agent-teams
pnpm install
pnpm build
dsh plugin --profile web add .
安裝完成後,檢查組合配置並啓動 Web UI:
dsh --profile web --dump-config
dsh web
安全提示:DSH 插件以當前 dsh 進程權限運行。安裝前建議瀏覽 GitHub 源碼與 LICENSE,確認符合你的信任策略。
典型用法示例¶
自然語言拉團隊¶
安裝並重啓 DSH 後,可直接在對話中描述目標,例如官方 README 中的示例:
使用 AgentTeams 審查 v0.5.3 之後的提交,分別從性能、安全和產品角度分工,最後輸出一份彙總報告。
隊長會創建團隊、添加角色成員、拆分任務並協調執行,最終彙總成一份報告。
Slash 命令¶
在 Web GUI 中選擇 slash 菜單裏的 agent-teams,或直接輸入:
/agent-teams 調研三家競品的定價頁
命令會以普通用戶消息形式保留在聊天記錄中,同時觸發 AgentTeams 協議。
可選配置¶
默認即可使用。若需在 Profile 中覆蓋成員行爲,可參考:
- id: agent-teams
config:
stateDir: .agent-teams
memberProvider: spawn
memberModel: deepseek-v4
memberMaxDepth: 1
maxMembers: 8
其中 memberProvider 指子 Agent 運行後端(spawn / fork),不是 LLM provider。設置 slashCommand: false 可關閉 /agent-teams 的確定性激活,僅保留自然語言觸發。
團隊狀態默認保存在工作區下的 .agent-teams/ 目錄;Web 面板讀取該目錄並與即時子 Agent 活動合併展示。
適用場景與注意事項¶
適合誰用
- 已在用 DeepSeek Harness Web 界面,希望把「多角色並行 + 任務依賴 + 結果彙總」留在同一會話裏完成的開發者。
- 需要代碼審查、競品調研、文檔分工等可拆成多子任務的場景,又不想自建編排系統的人。
使用邊界(官方文檔已說明)
- 一個隊長同一時間只能帶一個活動團隊。
- 狀態爲文件持久化,在單個 DSH 進程內串行操作;多個進程同時改同一團隊不保證一致。
- 活動面板展示持久化狀態;模型偶爾可能完成工作但未按協議更新任務狀態,需人工留意。
- 插件依賴 DSH 子 Agent、Web Client 等 peer 包,請保持 Harness 與插件版本相對匹配。
結語¶
如果你已經在 DeepSeek Harness 裏做複雜任務,卻還在手動切換多個對話窗口來模擬「團隊分工」,dsh-agent-teams 值得試一次:一句目標、一支隊伍、一塊活動面板,把多 Agent 協作收進 Harness 原生流程裏。