前言¶
用 DeepSeek Harness（DSH）做單 Agent 對話已經夠用，但一旦任務變長、角色變多——規劃、實現、審覈要分開，模型路由也要各走各的——很多人還是會回到「手動開多個會話」或「臨時寫一段 subagent 腳本」的老路上。問題是：這類編排往往是一次性的，換項目、換對話就要重來；跑在後臺的長任務也缺少統一的可觀測入口。
社區插件 dsh-agent-team-gui（維護者 toolclub）針對的正是這個缺口：把「多成員、多模型、有依賴關係」的工作流做成 DSH Web 裏可持久保存、可跨對話複用的「小隊」對象，並配上運行中心與 Token 洞察。它在 SkillHub 插件庫 歸類爲「工作流」；GitHub 倉庫當前約 129 stars（MIT 許可證）。SkillHub 是面向中國用戶的社區目錄站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令與能力說明以倉庫 README 爲準。
這是什麼¶
一句話：爲 DeepSeek Harness 提供持久、可複用的多模型 Agent 小隊 GUI——每個成員可獨立配置模型、角色提示詞、備用路由、輸出 Token 上限和工具策略；在普通對話輸入框旁選擇已保存的小隊後，由當前對話的主模型做有界規劃、執行無環依賴圖（DAG），最後綜合各成員結果。
它解決的核心問題不是「再做一個聊天窗口」，而是把小隊當成長期可用的產品對象：在 Settings → 小隊 裏創建一次，之後可在不同項目、不同對話中反覆選用，而不必每次重新填派單表單。
核心功能與亮點¶
成員級模型與工具策略¶
規劃者、實現者、審覈者、領域專家可以綁定不同的 DSH provider/model 路由，並各自配置工具白名單/黑名單。憑證仍留在 DSH 配置裏，不會複製進插件記錄。成員還可設置 maxTokens 硬上限和可選的備用路由（用於一次重試）。
動態編排與有界 DAG¶
默認情況下，插件用當前對話的 provider/model 啓動有界、無工具的規劃子任務，根據成員角色生成分工與無環依賴圖；就緒節點可按 maxConcurrency 並行，依賴節點只接收有界結構化交接，完整輸出保存在持久運行歷史中。若啓用「固定順序」，則走可重複的串行流水線，繞過 DAG 規劃。
計劃無效、有環或不可用時，會回退到確定性的角色專屬任務分配，避免一次壞計劃拖垮整支小隊。
小隊 / 單人 / 繼承三態¶
對話旁可選擇 Team（小隊）、Solo（單人） 或 Inherited（繼承項目默認）；還可爲「下一條消息」單獨排隊另一種模式。這些狀態在頁面刷新、Host 冷啓動、在線重連後仍可操作，目錄暫時爲空時也不會悄悄刪掉已保存的選擇。
觸發策略支持 始終 / 智能 / 手動：智能模式下規劃器可跳過過於簡單或不適合小隊的任務；手動模式下普通發送保持單人，需要時再排隊小隊或由模型工具顯式派發。
運行中心（Run Center）與 Token 洞察¶
每次執行在規劃開始前即寫入持久記錄。運行中心展示 DAG、成員狀態、審覈/返工輪次、完整輸出、錯誤、耗時、重試，並支持停止、整次或單成員重試、導出與篩選。
Token 用量複用 DSH 官方 tokenUsage 投影，分爲非緩存輸入、緩存讀取、緩存寫入、輸出四個桶；規劃、成員、審覈、返工可分別歸因。覆蓋狀態明確標爲完整 / 部分 / 無計量，計量未到前 UI 顯示「正在計量…」而非假零。插件不僞造價格——Harness provider 未通過穩定契約公佈單價時，不會猜測費用。
質量門禁、後臺運行與版本管理¶
可選質量門禁指定審覈人、返工負責人、標準與最多 2 輪返工。前臺運行結束後主 Agent 才綜合有界交接；後臺運行立即返回簡短確認，並在運行中心持續可見；若存在 DSH 官方 Jobs 服務，同一運行也會註冊到官方界面並共享取消邏輯。
小隊支持版本快照、無憑證「配方（recipe）」導入導出，以及定義備份的合併/替換預覽。v0.5 起禁止從 URL 拉取配方，需使用已審查的本地 JSON，以降低 SSRF 風險。
安裝與啓用¶
前置條件（據官方 README）：
- DeepSeek Harness
>=0.1.0-rc.5 <0.2.0（當前 CI 驗證 rc.6） - Web profile
- Node.js
>=22.19.0 <23或>=24.0.0（不支持 Node 23） - pnpm
- 至少一條已配置好的 DSH provider/model 路由
推薦安裝命令（固定 v1.0.1 tag）：
dsh plugin --profile web add -w github:toolclub/dsh-agent-team-gui#v1.0.1
dsh --profile web
Git 依賴會執行倉庫的 prepare 構建。pnpm 10+ 首次可能要求授權構建；按提示在 Web profile 的 pnpm-workspace.yaml（通常爲 ~/.dsh/profiles/web/pnpm-workspace.yaml）中僅放行本包後，重複上述固定版本命令：
allowBuilds:
dsh-agent-team-gui: true
安裝或更新後若 DSH Web 已在運行，需重啓進程。驗證 bundle 是否載入：
dsh --profile web --dump-config | grep -E "agent-team-gui|dsh-agent-team-gui"
預期輸出應同時包含 dsh-agent-team-gui bundle 層與 agent-team-gui 行。
若終端找不到 dsh，可在 Harness 源碼目錄使用 pnpm dsh --version，並將文中 dsh ... 替換爲 pnpm --dir /absolute/path/to/deepseek-harness dsh ...。
安全提示：allowBuilds 允許 Git 依賴在本機執行構建，安裝前應審查源碼並固定 tag 或完整 commit SHA；已編譯的 release tarball 則不需要 Git prepare 權限。
卸載：
dsh plugin --profile web remove dsh-agent-team-gui
刪除包不會自動清除 DSH 存儲後端中的持久插件表。
典型用法：五步創建第一個小隊¶
- 在 Settings → 成員庫 創建可複用成員：選擇已配置的 provider/model，寫清單一角色提示詞，按需設備用路由，只授權該角色需要的工具。
- 在 Settings → 小隊 創建小隊並選成員：不啓用「固定順序」則默認動態編排；啓用則得到可重複串行流水線。
- 配置觸發（始終 / 智能 / 手動）、成員選擇（全部或自適應子集）、響應模式（前臺或後臺），以及可選的恢復、預算、審覈策略。
- 在對話輸入框旁選擇 小隊 / 單人 / 繼承；可爲下一條消息單獨排隊，或設置項目默認小隊。
- 像平時一樣發送任務；打開 小隊運行 查看計劃、階段、成員輸出、錯誤、重試與 Token 計量。
進階起點：倉庫提供不含憑證的 全棧交付配方，可先預覽，再把其中的 your-provider / your-model 佔位路由映射到本機 DSH 配置。
模型工具 dispatch_to_squad 仍可用於顯式派發：接受小隊 ID 或唯一名稱、任務及可選分工/順序；返回給模型的內容有界，完整運行記錄可通過運行中心或導出獲取。
適用場景與注意事項¶
適合誰
- 需要在 DSH Web 里長期維護「規劃 + 實現 + 審覈」等多角色流水線，且希望各角色走不同模型或工具策略的團隊。
- 希望長任務可觀察、可取消、可重試，並需要按成員歸因 Token 用量的 DSH 用戶。
- 需要把小隊定義導出、分享給同事（無憑證配方），或在多項目間複用同一套成員配置的場景。
注意事項
- 僅 Web profile 提供 Settings GUI；無 headless 設置界面。導出的 Host service 可供其他進程內插件在提供必要 service 後調用。
- 插件以當前 dsh 進程權限運行；成員被授權的工具即其能力上限，安裝前請閱讀源碼與 MIT 許可證，並按最小權限配置工具。
- DSH 與插件均處預穩定階段，建議固定 Harness 與插件版本；聲明兼容
>=0.1.0-rc.5 <0.2.0。 - 軟小隊 Token 預算只能阻止後續調度，無法在閾值處精確截斷已在運行的 provider；單成員
maxTokens纔是 provider 硬上限。 - 定義導出含成員 system prompt 與路由名；運行導出還含用戶任務與成員輸出，分享前需自行脫敏。
- 本地持久存儲包含角色提示詞、路由名、對話/項目標識、任務與輸出等，請保護 DSH home 目錄。
結尾¶
如果你已經在 DSH 裏配好了多條模型路由，卻還在爲「多 Agent 協作只能臨時拼湊」發愁，dsh-agent-team-gui 把小隊做成可保存、可觀測、可版本化的工作流對象，是值得納入試裝清單的工作流類插件。
- 插件目錄頁：https://www.skillhub.cn/plugins/toolclub/dsh-agent-team-gui
- GitHub 倉庫：https://github.com/toolclub/dsh-agent-team-gui
- DeepSeek Harness 官方倉庫：https://github.com/deepseek-ai/deepseek-harness
