前言¶
DeepSeek Harness（DSH）的插件化生態允許開發者擴展宿主能力。在處理複雜任務時，單一智能體往往力不從心，需要多智能體協同。dsh-teams-x 插件提供了一個將單次會話轉化爲協調的多智能體團隊的方法：由隊長生成持久的成員子智能體，將目標分解爲依賴感知的任務 DAG，並通過直接信箱消息進行協調，並配有實時的全 SVG 活動面板。
核心功能¶
該插件主要包含以下能力：
* 多代理團隊：支持創建包含隊長與成員的團隊結構。
* 依賴感知任務 DAG：將大目標拆解爲具有依賴關係的任務圖。
* 持久信箱：支持團隊內部通過直接消息進行通信。
* 全 SVG 活動面板：提供實時的全 SVG 渲染活動視圖。
* Web 計劃編輯器：支持在 Web 界面內編輯計劃，包括成員角色/模型與任務行。
* 團隊模板：支持預定義團隊配置，一鍵創建。
* 自動修復循環：任務失敗時自動派生修復任務。
* 會話內團隊卡片：將團隊狀態摺疊爲消息流內的卡片。
* 質量門契約：對任務執行過程中的質量進行契約校驗。
* 173 用例：包含一套完整的驗證用例。
安裝與啓用¶
安裝插件後，必須重啓宿主，dsh plugin add 命令不會熱加載新 bundle。
方式 A：倉庫 tgz 一條命令（推薦）
倉庫根目錄自帶構建好的 dsh-teams-x-<version>.tgz，零運行時依賴。
dsh plugin --profile web add <倉庫路徑>/dsh-teams-x-<version>.tgz
方式 B：npm
npm i dsh-teams-x && dsh plugin --profile web add <node_modules 路徑>/dsh-teams-x
方式 C：從源碼構建
需要 Node ≥ 24、pnpm ≥ 12，且在同一臺機器上有一份 deepseek-harness 源碼 checkout（構建期依賴直連）。
# 1) 佈局
git clone https://github.com/Mlte0907/dsh-teams-x.git && cd dsh-teams-x
ln -s <harness-checkout 絕對路徑> deepseek-harness
# 2) 構建
pnpm install
pnpm build
# 3) 安裝
dsh plugin --profile web add "$(pwd)"
典型用法¶
工具命名空間爲 teamsx_*，狀態目錄爲 .teams-x。
創建團隊
// 創建一個名爲 smoke-test 的團隊，包含一個成員 a1
teamsx_create({"name":"smoke-test","members":[{"name":"a1"}]})
使用模板
在 teamsx_create 描述裏寫入 profile=模板名，即可按預定義配置一鍵建隊。
呼出面板
在輸入框使用斜槓命令：
/teamsx
適用場景與注意事項¶
- 宿主版本要求：原生面向 DeepSeek Harness 0.2.0-rc.1 及以上（
peerDependencies >=0.2.0-rc.1）。 - 重啓生效：安裝後必須重啓宿主才能生效。
- API 漂移處理：宿主 API 漂移點收斂在
src/compat.ts。 - 互不干擾：與宿主內其他團隊模式互不干擾。
- 權限：工具以當前 DSH 進程權限運行。
插件維護者爲 Mlte0907，許可證爲 MIT。可通過 catalog_url 或 github_url 查看更多詳情。
