dsh-plugin-agent-teams

English · 简体中文

一句话，拉起一支真正协作的团队

dsh-agent-teams 让当前 DeepSeek Harness 会话成为队长：创建可续聊的子 Agent、把目标拆成有依赖的任务，并通过直达消息协调成员工作。

你只需用自然语言提出目标。插件会提供团队协议、10 个协作工具、持久化状态和实时 Web UI，不需要额外的 Workflow 引擎。

为什么需要 AgentTeams？

安装

[!NOTE] 使用前请确保已安装 DeepSeek Harness。

npm

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

从源码构建

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。本地安装会继续链接到当前源码目录。

检查组合配置、重启 DSH，然后刷新 Web UI：

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

接着直接用自然语言拉团队：

使用 AgentTeams 审查 v0.5.3 之后的提交，分别从性能、安全和产品角度分工，最后输出一份汇总报告。

工作方式

1. 当前会话创建团队并成为队长。
2. 队长按角色添加由可续聊子 Agent 驱动的成员；每次添加都会创建并认领该成员的第一份任务。
3. 后续任务只能使用已返回的 id（t1、t2、…），并且负责人必须已经入队。
4. 出生 brief 就是第一份任务。之后的邮箱消息默认插话补信息或改方案；只有 mode=queue 才等到当前轮次结束。
5. 成员执行任务、更新状态，并直接向队长或其他成员汇报。
6. 队长汇总结果，随后归档完整团队记录。

团队状态保存在 <workspace>/.agent-teams/；Web 面板读取这份磁盘真相，并与实时子 Agent 活动合并展示。

成员创建默认零交互：插件会快照队长当前这一步实际使用的 LLM provider、model 与思考强度，成员后续续跑仍使用这份快照。只有当用户明确提出异构分工（例如“后端用 provider A/model X，前端用 provider B/model Y”）时，队长才会把对应的 provider + model 传给该成员；不会逐个弹出模型或思考强度选择。

配置

默认配置可以直接使用。受信任的 Profile 可以覆盖成员行为：

- id: agent-teams
  config:
    stateDir: .agent-teams
    memberProvider: spawn
    memberModel: deepseek-v4
    memberMaxDepth: 1
    # maxMembers: 8               # 可选在册人数上限；省略表示不封顶

这里的 memberProvider 指子 Agent 的运行后端（spawn / fork），不是 LLM provider。跨 LLM provider 由 agent_teams_add_member 的可选 provider + model 参数表达；memberModel 只是所有成员的模型默认覆盖。省略 maxMembers 表示不限制在册人数；显式配置数字后仍会拒绝超员。

使用边界

• 一个队长同一时间只能带一个活动团队。
• 成员被唤醒后才行动；参与者空闲时，消息会持久保存在邮箱中。
• 状态使用文件持久化，并在单个 DSH 进程内串行操作；多个进程同时修改同一团队不保证一致。
• 活动面板如实展示持久化状态；模型偶尔可能完成工作却没有按协议更新任务状态。

完整工具列表、状态模型、Web UI 行为、配置与已知限制见 docs/usage.md。

插件开发 Skill

仓库同时提供开放 Agent Skills 包 dsh-plugin-development：

npx skills add NanmiCoder/dsh-agent-teams --skill dsh-plugin-development

文档

开发

pnpm install
pnpm build
pnpm verify

许可证

MIT