dsh-agent-teams

把当前 DSH 会话变成团队队长：先生成可审查的成员阵容与任务 DAG，批准后创建可续聊子 Agent，按依赖自动调度、成员互发消息，并在 Web 团队工作区展示进度。

• DSH 0.2.0-rc.2（必需）：插件 peer 只接受精确宿主版本；先确认实际运行的 DSH（含桌面端内置核心）为 0.2.0-rc.2。
• Node.js ^22.19.0 或 >=24（必需）：插件 engines 字段要求的 Node.js 版本。
• 独立 web Profile（必需）：在单独的 web Profile 中安装，避免影响日常会话。
• 已配置的 LLM 路由（必需）：成员默认沿用队长当前 provider/model，需要宿主已能正常对话。
• 可丢弃测试工作区（必需）：成员拥有普通编码工具，首次试用放在可丢弃的 Git 工作区。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

@nanmicoder/[email protected]

0.1.22 的 21 个 DSH peer 是精确版本列表，包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2；0.2.0-rc.1 与列表外的 0.1.x 版本会被拒绝。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add @nanmicoder/[email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @nanmicoder/dsh-agent-teams或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams

$DSH_HOME/profiles/web/cordis.patch.yml

覆盖 agent-teams 的状态目录、成员模型、委派深度和人数上限。

- id: agent-teams
  config:
    stateDir: .agent-teams
    memberProvider: spawn
    memberModel: deepseek-v4
    memberMaxDepth: 0
    maxMembers: 8

1. 停止并重新启动 web Profile 的 DSH 进程，然后刷新浏览器。
2. 首次试用把 maxMembers 调小（例如 2～3），保持 memberMaxDepth 为 0，避免并发与费用失控。
3. 如果 memberModel 与队长当前 provider 不匹配，删除该项或在成员上显式指定 provider 与 model。

1. 01
   导出 web Profile 组合配置，确认 agent-teams 已加载。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：输出中出现 id: agent-teams 与 @nanmicoder/dsh-agent-teams 配置层。

2. 02
   在 Web 聊天输入 /agent-teams 加一个两成员、两任务的小目标。

   期望结果：先出现待审计划，未批准前不创建成员、不领取任务。

3. 03
   批准后检查工作区 .agent-teams/<teamId>/team.json 与 inbox 目录。

   期望结果：出现团队、成员、任务状态和邮箱 JSONL 文件，面板进度与之一致。

• /agent-teams 让 2 名成员分别审阅 README 和测试目录，只读不改文件，最后汇总一份报告。

成员是持久子 Agent，拥有宿主普通编码/研究工具（bash、文件、网络等）加 4 个团队工具；14 个队长工具对成员屏蔽。成员再委派深度默认 0（禁止），可配置放开。团队状态写入工作区 .agent-teams，Web 路由经宿主连接鉴权。

数据存储：<workspace>/.agent-teams/<teamId>/ 保存 team.json 与 inbox/*.jsonl；删除团队后移入 .agent-teams/archive/<teamId>/ 保留。成员会话另由 DSH 会话存储保存。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

安装时报 peer 版本不兼容

确认实际运行的 DSH 为 0.2.0-rc.2；0.2.0-rc.1 等未列出的版本会被拒绝，不要用 allow-version 强行放行。

添加成员报 UNKNOWN_MODEL

memberModel 与队长 provider 配对；删除 memberModel 或在成员上同时指定 provider 与 model。

多个成员同时触发 429

插件无全局并发上限，减少成员数或任务并行度，改用配额更高的模型路由。

成员停在待继续执行

由队长发消息恢复或重新指派任务，不要直接编辑 team.json。