一句話拉起 Agent 團隊:DeepSeek Harness 插件 dsh-agent-teams 上手

前言

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 與倉庫文檔,已覈實的主要能力如下:

  1. 隊長式委派:當前會話負責建隊、分配角色、彙總最終結果,流程清晰。
  2. 可續聊成員:成員是 DSH 可繼續喚醒的子 Agent,適合多輪聚焦跟進,而不是一次性腳本。
  3. 帶依賴的任務拆分:任務有明確狀態(如 running / idle / ready),前置依賴未完成時不能領取,避免亂序執行。
  4. 自動調度與安全接管:空閒成員自動領取下一項就緒任務;轉派會撤銷舊 attempt;進程冷重啓後,調度器會重試遺留的開放任務。
  5. 成員直達消息:成員通過持久化郵箱直接聯繫隊友或隊長,無需隊長逐條中轉。
  6. 即時 Web 活動面板:Web UI 展示團隊進度與任務 DAG;團隊歸檔後仍保留完整成員與任務歷史。面板文案隨 Harness 官方 locale 在中英文間切換。
  7. Slash 命令入口:註冊 /agent-teams 命令,Web GUI 的 slash 菜單可直接選用;headless CLI 下以 /agent-teams 開頭的用戶消息也會觸發協議。
  8. 默認零交互建隊:成員默認沿用隊長當前 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 原生流程裏。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜