DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在构建复杂工作流时，往往需要多个智能体并行协作。dsh-agent-teams-meta 是一个独立插件，它为 DSH 提供了更健壮的 Agent 团队管理能力，支持持久化团队、动态路由、任务图、私有信箱、代币账本以及 Web 侧边栏面板。
是什么¶
该插件由 kaka-in-home 维护，旨在解决多智能体协作中的协调问题。它允许一个主导智能体将工作拆解给专门的成员，每个成员拥有独立的模型路由、任务上下文和私有信箱，并在同一个持久化会话中保持工作状态。
核心功能¶
- 并行成员与真实路由：可以为成员指定不同的 Provider 和 Model。同一团队内的不同成员可以使用不同的模型。
- 持久化任务协调：支持创建任务、指定所有者、定义依赖关系。成员只能领取符合资格的任务，任务状态变更会被验证并持久化。
- 私有持久化信箱：主导智能体与成员之间通过信箱交换消息，互不干扰。每个参与者只能看到自己的信箱内容。
- 实时模型切换：可以在运行时切换成员的模型路由，下次请求将使用新路由，而正在进行的请求保持原路由。
- 有用的失败报告：成员请求失败时，错误信息会作为普通消息文本传递给主导智能体，不会消失或变得晦涩。
- 模型目录与路由检查：插件会生成当前 DSH 中配置的 Provider/Model 目录。创建成员时会检查路由有效性，防止使用未配置的模型。
- 按路由使用账本：Token 使用量记录基于请求开始时的路由，即使后续切换路由，账本仍记录初始路由的使用情况。
- Web 可视化：提供只读侧边栏，展示团队进度、成员、任务、路由和阶段。
- 工具集：提供
teams_meta_*前缀的工具族，包括create,add_member,create_task,claim_task,send_message,route_switch,status,close,guide等。
安装与启用¶
通过 DSH 的插件命令安装：
dsh plugin --profile web add dsh-agent-teams-meta
插件安装后，可以通过 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。
- 创建任务：定义具体任务并指定所有者。
- 发送指令：通过信箱发送消息，引导成员行动。
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.")
运行要求与注意事项¶
- 环境要求：需要 Node.js
^22.19.0或>=24。需要 DeepSeek Harness 的 Web Profile (dsh web)，且至少配置了一个 LLM Provider/Model。 - 数据存储：所有数据存储在工作区的
.dsh-agent-teams-meta/目录下。插件不会存储提示词、模型响应、凭据或端点 URL。 - 版本说明：当前版本号为 0.1.1（基于 package.json）。
总结¶
dsh-agent-teams-meta 为 DSH 提供了从模拟聊天到真实工作流协作的进阶能力。通过私有信箱、任务依赖管理和按路由的代币追踪，它能让主导智能体更有效地组织团队完成复杂任务。
