dsh-agent-teams 是什么？把 DSH 会话变成能指挥的多代理团队并自动调度任务

dsh-agent-teams 是 DeepSeek Harness（DSH）的多代理协作插件，把当前会话升级为“队长”，可以组建持久子代理、把目标拆成依赖感知任务，并通过直接消息协调整个团队完成复杂工作。 本文介绍 dsh-agent-teams 是什么、核心功能、完整的安装更新卸载命令、典型用法与常见排错，让你用一个自然语言请求就能指挥一个团队，而不需要单独的工作流引擎。

dsh-agent-teams 是什么？

dsh-agent-teams 解决的是 DSH 里缺少多代理协作机制的问题：把一次会话变成一名队长，靠团队协议、十一个协调工具、持久状态和自动共享任务调度器，让团队在自然语言指挥下协作完成目标。 以下定位与事实均来自官方 README（来源）：

dsh-agent-teams（GitHub 仓库 NanmiCoder/dsh-agent-teams）由 NanmiCoder 维护，MIT 协议开源。它不替换 DeepSeek Harness 本体，而是把会话升级为队长：队长创建团队、分配角色、拆分任务并整合最终结果。团队状态持久存储在 <workspace>/.agent-teams/ 目录，Web 面板读取磁盘事实并结合实时子代理活动。它属于 DSH Plugin 生态中的 Agent 协作插件，同时支持 DSH Web 与 headless 模式。

dsh-agent-teams 的核心功能有哪些？

核心能力围绕「队长式委派 + 依赖感知调度 + 直接消息 + 实时面板」展开：持久成员、自动共享任务调度器、先计划再执行，以及可选质量门禁。 这些能力全部来自官方 README（来源）：

• 队长式委派：当前会话创建团队、分配角色并整合最终结果。
• 持久成员：成员是可继续的 DSH 子代理，可在后续专注轮次中被唤醒。
• 依赖感知任务：任务具有显式状态，依赖未完成前不能被认领；调度器用真实的 running、idle、ready 状态，让每个空闲成员原子性地认领一个就绪任务。
• 自动复用与安全接管：空闲成员自动认领下一个就绪任务；重新分配会撤销旧尝试并等待旧工作停止，冷恢复会重试搁置的开放工作。
• 直接消息：成员通过持久邮箱直接向队友或队长发消息，无需中继。
• 实时活动面板：Web UI 结合分段进度、可折叠名册和交互式任务 DAG，运行中的任务显示成员模型，归档保留完整历史。

怎么安装与启用 dsh-agent-teams？

安装用一条官方 npm 命令，装完校验配置并重启 DSH，Web 面板里就会出现 /agent-teams 命令与实时活动面板。

1. 安装 dsh-agent-teams：推荐通过 npm 将插件安装到 DeepSeek Harness Web profile：

dsh plugin --profile web add @nanmicoder/dsh-agent-teams@latest

已全局安装 DSH CLI 时可直接使用；否则先用 npx -y @deepseek-ai/dsh。需要固定版本时把 @latest 换成具体版本号。

2. 从源码构建安装：开发或审计场景克隆仓库后本地构建安装：

git clone https://github.com/NanmiCoder/dsh-agent-teams.git
cd dsh-agent-teams
pnpm install
pnpm build
dsh plugin --profile web add .

源码改动后重跑 pnpm build，本地插件安装会保持链接到该检出目录。

3. 校验并重启生效：安装完成后校验组合配置、重启 DSH 并刷新 Web UI：

dsh --profile web --dump-config
dsh web

4. 更新插件：需要升级时重跑更新命令：

dsh plugin --profile web update @nanmicoder/dsh-agent-teams

5. 卸载插件：不再需要时用卸载命令移除：

dsh plugin --profile web remove @nanmicoder/dsh-agent-teams

以上命令形式与宿主文档一致，包名 @nanmicoder/dsh-agent-teams 取自 README 与插件目录（来源）。

dsh-agent-teams 典型用法

dsh-agent-teams 装完即用：直接用自然语言提出目标，或通过 /agent-teams 命令启动，规划确认后由队长自动调度整个团队。

1. 用自然语言指挥团队：启用后直接提问，例如审查指定提交并返回综合报告：

使用 AgentTeams 从性能、安全和产品角度审查 v0.5.3 之后的提交，并返回一份综合报告。

2. 使用 /agent-teams 斜杠命令：插件注册了封闭命名空间的宿主命令，Web 斜杠菜单中会显示带输入提示的 agent-teams 占位符：

/agent-teams research the pricing pages of three competitors

命令管线认领该行后，把这段精确输入作为普通用户后续消息保留在主对话中，队长协议立即启动。

3. 先规划后执行：普通 /agent-teams 运行先暂存未生成的成员名册和 DAG；只有点击「批准并运行」后才会真正创建成员并开始调度。返回对话可以修改同一份草稿，丢弃则归档草稿并明确禁止自动重建。

4. 用命名多角色 profile 调度固定团队：在 cordis.patch.yml 中配置完整团队 profile 后，用显式 profile 标志启动：

/agent-teams --profile demo-delivery implement the feature

第一个普通词不会被当作隐式 profile（来源）。

dsh-agent-teams 常见问题与排错

装好后遇到「命令不生效」「面板空白」「任务不认领」等问题时，按下面的症状对号入座排查。 以下排错要点均来自官方 README（来源）：

1. /agent-teams 命令不生效：症状是输入命令后没有启动团队协议。原因是 Web profile 未重启，或 slashCommand 配置被关闭。解决：重启 DSH 并刷新 Web UI；确认配置未设 slashCommand: false。

2. 活动面板空白或状态异常：症状是 Web 面板看不到成员或任务进度。原因是面板按 <workspace>/.agent-teams/ 的磁盘事实渲染，或模型偶尔完成了工作却没有更新任务状态。解决：确认工作区目录存在且由同一 DSH 进程写入；并发进程编辑同一团队不受协调。

3. 就绪任务长时间无人认领：症状是任务 DAG 中就绪任务一直空闲。原因是依赖未完成，或成员正处于暂停状态。解决：检查任务 DAG 的依赖关系；对暂停成员发直接消息或显式重新分配来唤醒。

4. 冷重启后任务看起来丢失：症状是重启后开放任务没有继续。原因是冷进程重启会重试搁置的开放工作并使用新的尝试 ID。解决：等待调度器自动重试；被中断的常驻尝试保持暂停，通过直接消息即可恢复。

适用场景与注意

dsh-agent-teams 适合所有想在 DSH 里做多代理协作的用户，尤其是需要把大目标拆给多个角色并行推进、又要保持过程可见的团队。

适用场景：需要把一个复杂目标拆成多个角色并行推进的开发者；希望每个子任务依赖关系清晰、进度可视的人；想在单一会话内指挥团队而不引入外部工作流引擎的用户。

注意事项：一个队长同一时间只带领一个活动团队；空闲成员会自动复用于就绪工作，但仍有开放尝试的成员会暂停直到被消息或重新分配；状态由文件承载并在单个 DSH 进程内串行化，并发进程编辑同一团队不受协调；模型偶尔可能完成工作却没更新任务状态，面板按持久化状态如实报告（来源）。

项目链接

dsh-agent-teams 是 NanmiCoder 维护的 MIT 开源项目。 插件详情页：dsh-agent-teams 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：NanmiCoder/dsh-agent-teams。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。