--- title: "用 DSH Agent Teams 拆分任务并协调可续聊子 Agent" seo_title: "DSH Agent Teams 配置：创建可续聊的多 Agent 团队" description: "在 DeepSeek Harness（DSH）中安装 Agent Teams，配置子 Agent、依赖任务、成员邮箱和调度，并限制工具与工作区权限。" canonical: https://52dsh.com/tutorials/nanmicoder-dsh-agent-teams-install-config/ authors: ["52DSH 编辑部"] audience: [] outcomes: [] prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"] difficulty: advanced estimated_action_time: null next_steps: null published_at: 2026-08-22 updated_at: 2026-10-02 verified_on: 2026-10-02 maintenance_status: community verification_level: source_reviewed risk_level: high dsh_version: 0.2.0-rc.2 plugin_id: nanmicoder-dsh-agent-teams tutorial_kind: plugin_configuration related_plugin_url: https://52dsh.com/plugins/nanmicoder-dsh-agent-teams/ --- # 用 DSH Agent Teams 拆分任务并协调可续聊子 Agent 在 DeepSeek Harness（DSH）中安装 Agent Teams，配置子 Agent、依赖任务、成员邮箱和调度，并限制工具与工作区权限。 ## 2026-10-02 更新到 Agent Teams 0.1.22，适配 DSH 0.2.0-rc.2 本页安装目标更新为 `@nanmicoder/dsh-agent-teams@0.1.22`，命令固定使用 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/dsh-agent-teams@0.1.11）。从 0.1.18 起降级前需先完成或归档新版本创建的团队（作者说明旧版本无法识别空会话 ID 的休眠成员）。升级宿主前请先归档用过 /agent-teams 的重要会话（见 issue #160）。 依据：[固定证据 1](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/README_ZH.md)、[固定证据 2](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/package.json)、[固定证据 3](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/src/index.ts)。 把当前 DSH 会话变成团队队长：先生成可审查的成员阵容与任务 DAG，批准后创建可续聊子 Agent，按依赖自动调度、成员互发消息，并在 Web 团队工作区展示进度。 如果你的目标是创建可续聊子 Agent、依赖任务和自动续领的多 Agent 团队，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-agent-teams。本文锁定作者仓库提交 `9cba4fe4171f`；已复核固定提交的原始资料，未进行运行实测。 > 对应插件：[查看 dsh-agent-teams 的功能、权限与兼容性说明](/plugins/nanmicoder-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 工作区。 1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 `pnpm` 可用。 2. 使用独立的 `web` Profile 和可丢弃测试工作区，不直接连接生产目录。 3. 备份当前 Profile 配置，并记录安装前的 `--dump-config` 输出。 4. 核对固定来源中的外部服务、账号、运行时和平台限制。 5. 作者资料未显示明确的插件专属环境变量；如果运行时要求凭据，不要根据同类插件猜测变量名。 ## 安装 dsh-agent-teams 52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.22 ``` GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 `web` Profile 中放行确实需要的构建项，不要全局放行未知依赖。 ## 插件专属配置 ### 配置目标 - `$DSH_HOME/profiles/web/cordis.patch.yml`：覆盖 agent-teams 的状态目录、成员模型、委派深度和人数上限。 ### web Profile 的 agent-teams 配置 证据：[固定来源](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/README_ZH.md)。将路径、账号和凭据占位符替换为测试值。 ```yaml - 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。 ## 配置验证与成功结果 先导出配置，再启动同一版本的 DSH Web： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web ``` 1. **导出 web Profile 组合配置，确认 agent-teams 已加载。** ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config ``` 期望结果：输出中出现 id: agent-teams 与 @nanmicoder/dsh-agent-teams 配置层。 2. **在 Web 聊天输入 /agent-teams 加一个两成员、两任务的小目标。** 期望结果：先出现待审计划，未批准前不创建成员、不领取任务。 3. **批准后检查工作区 .agent-teams//team.json 与 inbox 目录。** 期望结果：出现团队、成员、任务状态和邮箱 JSONL 文件，面板进度与之一致。 ## 第一次使用 - /agent-teams 让 2 名成员分别审阅 README 和测试目录，只读不改文件，最后汇总一份报告。 ## 数据、权限与凭据 **数据流：**/agent-teams 或自然语言 → 队长调用 agent_teams_* 生成待审计划（不启动成员）→ 用户批准 → DSH 子 Agent 服务按成员路由调用 LLM 并行执行任务 → 结果与消息写入工作区 .agent-teams//team.json 与 inbox/*.jsonl → 已鉴权的插件 Web 路由读取状态供团队面板展示。 **权限关注：**成员是持久子 Agent，拥有宿主普通编码/研究工具（bash、文件、网络等）加 4 个团队工具；14 个队长工具对成员屏蔽。成员再委派深度默认 0（禁止），可配置放开。团队状态写入工作区 .agent-teams，Web 路由经宿主连接鉴权。 **数据存储：**/.agent-teams// 保存 team.json 与 inbox/*.jsonl；删除团队后移入 .agent-teams/archive// 保留。成员会话另由 DSH 会话存储保存。 真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。 ## 卸载、回退与清理 停止 DSH 后，从同一个 Profile 移除包： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove @nanmicoder/dsh-agent-teams ``` 1. 先在面板或用 agent_teams_delete 结束团队，确认没有运行中的成员。 2. 执行 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove @nanmicoder/dsh-agent-teams，并重新导出配置确认已移除。 3. 按需删除工作区中的 .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、保留日志并回退插件。 ## 固定来源证据 以下资料是本文配置结论的依据： - [README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/README.md) - [docs/usage.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/usage.md) - [docs/harness-0.2.0-rc.2/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/harness-0.2.0-rc.2/README.md) - [docs/maintenance-2026-09-06/release/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/maintenance-2026-09-06/release/README.md) - [skills/README.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/skills/README.md) - [docs/verification-guide.md](https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/verification-guide.md) 继续查看：[返回 dsh-agent-teams 插件详情页](/plugins/nanmicoder-dsh-agent-teams/)，重新核对兼容性、权限、同类插件和来源状态。 ## 原始来源 - https://github.com/NanmiCoder/dsh-agent-teams - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/package.json - https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/boot/app-boot/src/plugin-compatibility.ts - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/README.md - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/usage.md - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/harness-0.2.0-rc.2/README.md - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/docs/maintenance-2026-09-06/release/README.md - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/README_ZH.md - https://github.com/NanmiCoder/dsh-agent-teams/blob/9cba4fe4171f27c019991cafd2a107f87ef3517b/src/index.ts