插件简介
dsh-agent-teams 是 DeepSeek Harness 生态中的多 Agent 团队协作插件,由 NanmiCoder 开发,GitHub 星标 1433,综合评分 70.1,最近更新于 2026 年 9 月 6 日。该插件的核心定位是"一句话,拉起一支真正协作的团队"——让当前 DeepSeek Harness 会话成为队长,自动创建可续聊的子 Agent,把目标拆成有依赖关系的任务,并通过直达消息协调成员工作。
与传统的单 Agent 串行执行不同,dsh-agent-teams 提供了完整的团队协议、11 个协作工具、持久化状态管理、自动共享任务调度和实时 Web UI 面板,用户无需额外安装 Workflow 引擎即可实现多 Agent 并行协作。该插件已被收录进"办公自动化工作套装"组合方案,同作者还维护了 dsh-auto-mode 插件。
核心功能
队长式委派
当前 DeepSeek Harness 会话自动担任队长角色,负责创建团队、分配角色、协调任务并汇总最终结果。用户只需用自然语言提出目标,队长会自动拆解任务并分配给合适的成员 Agent。
可续聊成员 Agent
团队中的每个成员都是可持续唤醒的 DSH 子 Agent,拥有独立的上下文和聚焦方向。成员完成当前任务后可以被再次唤醒执行后续轮次,不会因为任务切换而丢失上下文。
带依赖的任务调度
任务具有明确的状态机(待领取、进行中、已完成、失败等),任务之间支持依赖关系声明——依赖未完成的任务不能被领取。这确保了复杂项目的执行顺序正确性。
自动续领与安全接管
成员 Agent 完成当前任务后会自动领取下一项就绪任务,无需队长手动调度。任务转派时会自动撤销旧的执行尝试;冷恢复时会自动重试遗留任务;迟到的结果无法覆盖已完成的任务状态,保证了数据一致性。
成员直达消息
成员之间通过持久化邮箱直接通信,可以联系队友或队长,不需要所有消息都经过队长中转。这大幅提升了多 Agent 协作的效率,减少了队长的消息处理负担。
实时活动面板
内置 Web UI 面板,用分段进度条、可折叠成员树和可交互 DAG(有向无环图)展示团队实时工作状态。运行中的子任务会标出当前使用的模型,团队结束后仍保留完整的成员与任务历史记录,方便复盘。
质量门禁
默认任务执行顺序为需求分析 → 实现 → 验证 → 审查 → 集成,任务失败后自动触发修复和复审流程。恢复团队必须显式执行 resume 操作,第一版范围控制为完成时审计而非实时写入拦截。用户只需提供目标和约束,质量门禁会自动保障输出质量。
安装与配置
dsh-agent-teams 目前未发布到 npm registry,仅可从 GitHub 源码安装。安装前需确保已安装 DeepSeek Harness CLI 引擎。
基础安装命令:
# 先安装 DSH CLI 引擎(如未安装)
npm install -g @deepseek-ai/dsh
# 从 GitHub 源码安装 dsh-agent-teams
dsh plugin add NanmiCoder/dsh-agent-teams
当前最新版本为 v0.1.16-rc.1,已发布到 npm next 标签,该版本修复了 Harness RC / Alpha 版本的启动、成员消息与任务协作兼容问题。安装时建议参考官方版本配对表选择与当前 Harness 版本兼容的插件版本。
插件安装后无需额外配置即可使用。在 DSH 会话中用自然语言描述目标,插件会自动启动团队协作流程。实时活动面板可通过 Web UI 访问,查看团队进度和任务 DAG。
兼容性与避坑指南
Node 版本要求严格
dsh-agent-teams 的 package.json 声明 Node 引擎要求为 ^22.19.0 || >=24。这意味着 Node 23 不在支持范围内,Node 22.19 以下的版本也不满足要求。使用前请执行 node -v 确认版本,如不满足需升级 Node 到 22.19+ 或 24+。
未发布到 npm,需源码安装
npm 包 @nanmicoder/dsh-agent-teams 尚未发布到 npm registry,执行标准 dsh plugin add 时会自动回退到 GitHub 源码安装。如果安装过程中出现网络问题,建议配置 GitHub 镜像或使用代理。
中风险插件,建议隔离环境使用
dsh-agent-teams 被标记为中风险插件——可读取本地文件,虽然不会主动执行 shell 命令,但拉起的多 Agent 协作可能按需执行命令。建议在隔离环境或虚拟机中使用,避免在包含敏感文件的生产环境中直接运行。
依赖 14 个 DSH/Cordis 模块
该插件依赖 14 个 @deepseek-ai 命名空间下的 DSH/Cordis 模块,包括 cordis、dsh、dsh-agent、dsh-api-session-controller、dsh-client-connection、dsh-client-locale、dsh-client-store、dsh-client-ui-chat、dsh-client-ui-conversation、dsh-client-ui-layout、dsh-client-ui-model-selection、dsh-client-ui-primitives 等。安装时确保这些依赖能正常解析,如出现依赖缺失错误可尝试清理 node_modules 后重装。
版本兼容性需关注
v0.1.16-rc.1 专门修复了 Harness RC / Alpha 版本的兼容问题。如果使用的是较旧的 Harness 版本,可能需要安装对应兼容的旧版插件。建议始终保持 Harness 和插件版本同步更新。
适合人群
dsh-agent-teams 适合以下用户:需要处理复杂多步骤任务的开发者和研究人员;希望利用多 Agent 并行协作提升效率的团队;需要自动化执行需求-实现-验证-审查-集成完整工作流的项目;对 Agent 协作过程有可视化监控需求的用户。
不适合以下用户:只需要简单单轮问答的普通用户;对本地文件安全有极高要求且无法提供隔离环境的用户;Node 版本无法升级到 22.19+ 的环境。
总结
dsh-agent-teams 是 DeepSeek Harness 生态中少有的完整多 Agent 团队协作解决方案,1433 星的社区认可度和 70.1 的综合评分证明了其实用价值。它通过队长式委派、可续聊成员、带依赖任务调度和质量门禁,将复杂的多 Agent 协作简化为"一句话提目标"的操作。虽然存在 Node 版本要求严格、需源码安装、中风险等门槛,但对于需要处理复杂任务的开发者而言,这些成本是值得的。
查看插件详情页,获取完整安装命令和兼容性检查结果。
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。