社区整理已复核原始来源

DSH: 0.2.0-rc.2
系统: Windows / macOS / Linux
风险: high

本页目录（11）

对应插件dsh-agent-teams

先查看功能、兼容性、权限和同类选择，再按本文操作。

查看插件详情 →

2026-10-02 更新到 Agent Teams 0.1.22，适配 DSH 0.2.0-rc.2

本页安装目标更新为 @nanmicoder/[email protected]，命令固定使用 DSH 0.2.0-rc.2。新版本声明兼容 0.2.0-rc.2；本站只做了固定版本的源码与发布包静态复核，没有安装或运行。

安装方式改为 npm 包 @nanmicoder/dsh-agent-teams：本站原来固定的 Git 提交不含构建产物，很可能无法加载。
团队先生成可审查的成员阵容和任务计划，批准后才启动成员；成员默认不能再委派（memberMaxDepth 默认 0）。
仍没有全局并发上限，默认最多 8 个成员（maxMembers 默认 8）同时调用模型，费用和 429 限流风险随成员数增加。
版本范围是精确列表：0.2.0-rc.1 和列表外的 0.1.x 版本会被拒绝。

仍在使用 DSH 0.1.x： 仍在使用 DSH 0.1.x 的用户：0.1.22 的 peer 列表只接受 0.1.7-rc.2、0.1.5-rc.1/rc.2/rc.3、0.1.2-rc.1、0.1.2-alpha.5、0.1.2-alpha.2 这些精确版本，其它 0.1.x（如 0.1.6、0.1.7-rc.1）会被拒绝；若宿主不在列表内，请保留当前可用的插件版本并用精确版本安装，不要用 allow-version 绕过。本站此前收录的 0.1.11（提交 0c21e5d2f45e）声明 ^0.1.0-rc.6，且其 Git 提交不含 lib/ 构建产物，建议改用 npm 精确版本（如 @nanmicoder/[email protected]）。从 0.1.18 起降级前需先完成或归档新版本创建的团队（作者说明旧版本无法识别空会话 ID 的休眠成员）。升级宿主前请先归档用过 /agent-teams 的重要会话（见 issue #160）。

依据：固定证据 1（外部链接，在新标签页打开）、固定证据 2（外部链接，在新标签页打开）、固定证据 3（外部链接，在新标签页打开）。

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

如果你的目标是创建可续聊子 Agent、依赖任务和自动续领的多 Agent 团队，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-agent-teams。本文锁定作者仓库提交 9cba4fe4171f；已复核固定提交的原始资料，未进行运行实测。

对应插件：查看 dsh-agent-teams 的功能、权限与兼容性说明。先确认它适合你的工作流，再执行安装。

先确认是否适合你

分类：Agent 与工作流
风险等级：high
核验证据：source_reviewed
兼容性边界：0.1.22 的 21 个 @deepseek-ai/dsh-* peer 采用精确版本列表，声明兼容 DSH 0.2.0-rc.2（推荐）及 0.1.7-rc.2、0.1.5-rc.1～rc.3、0.1.2-rc.1、0.1.2-alpha.5/alpha.2；不接受 0.2.0-rc.1 或未来 0.2.0 正式版。Node.js ^22.19.0 或 >=24。本站仅做静态审阅，未在 0.2.0-rc.2 上运行验证。
主要权限关注：成员是持久子 Agent，拥有宿主普通编码/研究工具（bash、文件、网络等）加 4 个团队工具；14 个队长工具对成员屏蔽。成员再委派深度默认 0（禁止），可配置放开。团队状态写入工作区 .agent-teams，Web 路由经宿主连接鉴权。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本： 0.2.0-rc.2。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 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 工作区。

安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 pnpm 可用。
使用独立的 web Profile 和可丢弃测试工作区，不直接连接生产目录。
备份当前 Profile 配置，并记录安装前的 --dump-config 输出。
核对固定来源中的外部服务、账号、运行时和平台限制。
作者资料未显示明确的插件专属环境变量；如果运行时要求凭据，不要根据同类插件猜测变量名。

安装 dsh-agent-teams

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

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

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项，不要全局放行未知依赖。

插件专属配置

配置目标

$DSH_HOME/profiles/web/cordis.patch.yml：覆盖 agent-teams 的状态目录、成员模型、委派深度和人数上限。

web Profile 的 agent-teams 配置

证据：固定来源（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

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

安装后设置

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

配置验证与成功结果

先导出配置，再启动同一版本的 DSH Web：

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

导出 web Profile 组合配置，确认 agent-teams 已加载。
```
npx --yes @deepseek-ai/[email protected] --profile web --dump-config
```
期望结果：输出中出现 id: agent-teams 与 @nanmicoder/dsh-agent-teams 配置层。
在 Web 聊天输入 /agent-teams 加一个两成员、两任务的小目标。

期望结果：先出现待审计划，未批准前不创建成员、不领取任务。
批准后检查工作区 .agent-teams/<teamId>/team.json 与 inbox 目录。

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

第一次使用

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

数据、权限与凭据

数据流：/agent-teams 或自然语言 → 队长调用 agent_teams_* 生成待审计划（不启动成员）→ 用户批准 → DSH 子 Agent 服务按成员路由调用 LLM 并行执行任务 → 结果与消息写入工作区 .agent-teams/<team>/team.json 与 inbox/*.jsonl → 已鉴权的插件 Web 路由读取状态供团队面板展示。

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

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

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

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

先在面板或用 agent_teams_delete 结束团队，确认没有运行中的成员。
执行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove @nanmicoder/dsh-agent-teams，并重新导出配置确认已移除。
按需删除工作区中的 .agent-teams 目录（含 archive）。

常见问题

安装时报 peer 版本不兼容

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

添加成员报 UNKNOWN_MODEL

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

多个成员同时触发 429

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

成员停在待继续执行

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

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile，再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时，应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据：

继续查看：返回 dsh-agent-teams 插件详情页，重新核对兼容性、权限、同类插件和来源状态。

来源与维护信息

本文根据以下原始资料整理。版本变化后，请以官方资料和页面标注的验证日期为准。

完成当前任务后

按结果继续，不要停在文章末尾

已成功

继续完成配置、验证或下一阶段任务。

继续下一步 →

仍未解决

保留现象和错误原文，再进入对应排障路径。

DSH 安装 Git 插件被 allowBuilds 阻止怎么办 →安装和管理 DeepSeek Harness（DSH）插件 →

用 DSH Agent Teams 拆分任务并协调可续聊子 Agent