前言¶
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 查看更多详情。
