dsh-agent-teams-meta

English | 简体中文

按任务自由组建团队。随时组合专项成员，为每个成员分配独立模型路由，让并行协作持续到结果交付。

dsh-agent-teams-meta 是 DeepSeek Harness（DSH）的独立多 Agent 团队协作插件。它让一个队长 AI 可以组织多个并行成员，每个成员都有自己的模型路由、私有信箱、明确任务和独立的用量记录。

它解决什么问题

有些工作天然适合拆分：排查问题、审查改动、对比多种方案，或从不同角度检查一次发布。dsh-agent-teams-meta 让队长把这些独立工作交给专门的成员，持续跟踪进度，并在同一个地方汇总结果。

它面向真实工作流，而不是模拟聊天群。成员是可持续执行的 DSH 子 Agent，会按分配的 provider/model 路由运行，并能在多轮执行之间保留自己的任务上下文和信箱。

核心能力

• 并行成员与真实模型路由：为成员设置名称、角色和已配置的 provider/model。同一团队的不同成员可以运行在不同模型上。
• 持久化任务协作：任务支持负责人和依赖关系。成员只能认领自己且依赖已满足的工作；所有状态变化都会校验并保存。
• 私有持久信箱：队长与成员之间可以互发直达消息，不会把无关信息塞进其他会话。每个参与者只能看到自己的信箱。
• 运行中切换模型：随时为成员切换路由。新路由在下一次模型请求生效；已经开始的请求保留原来的 provider/model 归属。
• 错误直达队长：成员请求失败时，原始错误文本会作为普通的下一轮消息投递给队长，不会变成难以判断的附件或笼统状态。
• 已配置模型目录：插件会把 DSH 当前真正配置好的 provider 和模型生成到工作区目录，方便 Agent 在创建成员前查找可用路由。
• 创建时预检：未知 provider、未配置的 provider，以及不在可枚举模型目录中的 model，会在创建成员时直接拒绝。
• 按路由统计用量：每次请求的 token 用量都会归属到请求开始时实际使用的路由，即使成员之后切换了模型也不会混淆。
• DSH Web 可视化：侧边栏中的只读抽屉会展示团队进度、成员、任务、路由和团队阶段，同时所有变更仍由 Agent 工具完成。

工具一览

所有操作都通过 teams_meta_* 前缀的 Agent 工具完成：

| 工具 | 用途 | | --- | --- | | teams_meta_create | 创建团队，带标题和目的 | | teams_meta_add_member | 添加成员，带角色和已配置的 provider/model | | teams_meta_remove_member | 停用成员并取消其未完成的工作 | | teams_meta_create_task | 定义任务，可指定负责人和依赖 | | teams_meta_claim_task | 认领符合条件的任务（只能认领自己，且依赖已完成） | | teams_meta_update_task | 推进任务状态并记录结果 | | teams_meta_send_message | 向成员或队长发送持久直达消息 | | teams_meta_route_switch | 为成员切换 provider/model，下一次请求生效 | | teams_meta_status | 查看成员、任务、路由、自己的信箱和用量 | | teams_meta_close | 工作结束后归档团队（也可强制取消） | | teams_meta_guide | 随时获取完整协作规范 |

Agent 会自动收到协作规范，也可以随时用 teams_meta_guide 再次获取。

一个典型流程

队长创建团队，加入一个专项成员，分配明确任务，再发送工作上下文：

teams_meta_create(title="Release audit", purpose="Review the release before publishing")
teams_meta_add_member(name="Reviewer", role="Find regressions", provider="deepseek-official", model="deepseek-v4-flash")
teams_meta_create_task(title="Review routing", owner="Reviewer")
teams_meta_send_message(to="Reviewer", body="Claim the routing task and report material findings.")

之后成员会认领符合条件的任务，通过信箱报告进度，并提交最终结果。队长可以随时查看团队状态、把成员切换到另一条已配置路由，或在工作结束后关闭团队。

工作方式

每个成员会话都有一个稳定的标记路由：

agent-teams-meta-route/<team-id>/<member-key>

在 DSH 的公开请求边界上，插件会在请求准备前把该标记解析为成员当前真实的 provider/model。这样 DSH 的请求头、遥测和用量统计仍然使用真实路由，同时路由切换具有明确、可预测的请求边界语义。

插件的全部数据都保存在工作区，与 DSH 会话存储完全分离：

.dsh-agent-teams-meta/
  routes.json        # 当前标记到真实路由的绑定
  requests.jsonl     # 追加式路由用量账本
  model-catalog.md   # 自动生成的已配置 provider/model 目录
  teams/<team-id>/   # 团队快照和成员信箱

团队快照通过原子替换写入，并会重试短暂的 Windows 文件锁。信箱和用量账本只追加写入。状态目录不会保存 prompt、模型回复、凭据或接口地址。

运行环境

• Node.js ^22.19.0 或 >=24
• 使用 Web profile（dsh web）的 DeepSeek Harness，且至少配置了一个 LLM provider/model

安装

插件是标准 npm 包，可以用 DSH 插件命令，也可以在 profile 里直接用 pnpm 安装。

方式一：DSH 插件命令

dsh plugin --profile web add dsh-agent-teams-meta

方式二：pnpm 安装

# 在 DSH Web profile 目录下执行（例如 ~/.dsh/profiles/web）
pnpm add dsh-agent-teams-meta

然后在 profile 的 cordis.patch.yml 中挂载：

- insert:
    - id: agent-teams-meta
      name: 'dsh-agent-teams-meta'
      config:
        stateDir: .dsh-agent-teams-meta
        markerProvider: agent-teams-meta-route

安装或升级 host 侧插件后，需要重启 DSH。

方式三：从源码构建

先克隆仓库、安装依赖并构建：

git clone https://github.com/YshuY/dsh-agent-teams-meta.git
cd dsh-agent-teams-meta
pnpm install
pnpm build

然后将构建产物链接进 DSH Web profile：

# 在 DSH Web profile 目录下执行
pnpm add link:E:/path/to/dsh-agent-teams-meta

link: 安装会共享源码目录，每次重新构建后，下一次重启 DSH 即生效。

本地开发（link 安装）

开发调试时使用与上面相同的 link 流程：修改源码 → pnpm build → 重启 DSH 加载变更。

可选配置

插件开箱即用。如需自定义状态目录或路由标记，可通过 cordis.patch.yml 挂载：

- insert:
    - id: agent-teams-meta
      name: 'dsh-agent-teams-meta'
      config:
        stateDir: .dsh-agent-teams-meta
        markerProvider: agent-teams-meta-route

两个键都可选，以上即为默认值。

常见问题

成员可以用不同的模型吗？ 可以。每个成员在添加时都有独立的 provider/model 路由，队长也可以随时把成员切换到任意已配置路由。

数据存在哪里？ 全部在工作区的 .dsh-agent-teams-meta/ 下。团队快照原子替换，信箱和用量账本只追加。不保存 prompt、模型回复、凭据或接口地址。

Web 面板

DSH Web 侧边栏中的只读抽屉会展示当前团队快照：任务进度、成员、路由和阶段。所有变更仍然通过 teams_meta_* 工具完成。

开发

pnpm install
pnpm verify

pnpm verify 会执行类型检查、生产构建、单元测试，以及持久成员路由的集成验证。

深入了解

仓库内还包含几份按主题整理的技术说明：

• 架构设计
• 运行与操作
• 验证说明

许可证

MIT