角色团队编排 MisRightW/dsh-agent-teams

dsh-agent-teams

面向 DeepSeek Harness（dsh）的基于角色的多智能体团队编排，独立维护。

把一项复杂任务拆解成角色分工，按依赖 DAG 并发执行各角色子代理，并记录为持久的 team/ 会话事件，Web GUI 会将其回放成一块角色看板。

包

| 包 | 作用 |
| @deepseek-ai/dsh-agent-teams | 宿主插件：TeamEngine（ctx.teamEngine）+ 面向模型的 team 工具 + 内置模板（engineering、research）+ 持久 team/ 事件不变式 |
| @deepseek-ai/dsh-client-ui-agent-teams | 浏览器插件：team-run Conversation Node，在 dsh Web GUI 里渲染角色看板 |

团队运行流程

- 组建 —— team: { template } 指定一份名册（engineering：planner → implementer → reviewer；research：researcher → analyst → writer；配置项 templates 可扩展这套集合），引擎通过 planner 子代理把它拆解成每个角色一条具体分工，并带上依赖边；team: { roles } 接受模型自己写的内联名册，跳过规划。
- 执行 —— 依赖已满足的角色并发启动（上限为 maxConcurrentRoles）；每个角色结束后，其输出会喂给依赖它的角色的提示词；若某角色的依赖全部失败或取消，该角色标记为 blocked，永不启动。
- 进度 —— 每次状态转换都会追加到编排它的父会话，记为 team/start、team/plan、team/role/start、team/role/end、team/end，因此工具结果可以从日志重建，Web 看板也能实时回放。

配置（dsh-agent-teams）

| 键 | 默认值 | 含义 |
| provider | spawn | 角色子代理运行所用的 ctx.subagents 服务商。 |
| toolName | team | 面向模型的工具名。 |
| maxConcurrentRoles | 4 | 并发运行的角色子代理上限。 |
| maxRoleOutputChars | 20000 | 每个角色的输出上限，按字符计。 |
| maxRoles | 8 | 每次运行的角色数上限。 |
| maxDepth | 3 | 每个子项的委派深度绝对上限。 |
| enableRunInBackground | true | 在工具上暴露 run_in_background。 |
| maxResultChars | 50000 | 渲染结果的上限，按字符计。 |
| templates | [] | 额外团队模板，合并覆盖内置模板。 |

安装与使用

宿主插件是普通的 dsh 叶子插件。只要某个组合已经挂载 dsh 基础主干（提供 dsh-tools、dsh-subagent + spawn 后端、dsh-system-prompt），加一行即可：

- id: agent-teams
name: '@deepseek-ai/dsh-agent-teams'
config:
provider: spawn

或者在 pnpm add @deepseek-ai/dsh-agent-teams 之后直接加载该包。最小依赖范围见 examples/cordis.yml。Web 角色看板是额外的一行客户端配置：

- id: ui-agent-teams
name: '@deepseek-ai/dsh-client-ui-agent-teams'

team 工具面向模型：给它一个复杂任务，再给一份角色名单，父智能体就能收到按角色汇总的结果。只有任务确实能拆成多个并发的专职角色时才用它；一两次委派，直接用 subagent 就好。

开发

pnpm install # workspace install; the dsh family resolves from npm (^0.1.0-rc.8 baseline)
pnpm run typecheck # tsc -b for both packages and their tests
pnpm test # vitest: engine/tool/invariant + client node/panel suites
pnpm run build # tsc emit + tsdown bundles (lib/index.js, lib/invariant.js, lib/client.js)

各包的 README（host、client）记录了契约与 Model Experience；源码历史里的 Agent Note 记录了设计决策。

许可证

MIT — 见 LICENSE。