多模型智能体团队 toolclub/dsh-agent-team-gui

dsh-agent-team-gui

给 DeepSeek Harness 配一支可复用的团队：一个智能体做规划，一个负责实现，第三个做评审。

团队保存一次，给每个成员选好模型，之后跨项目、跨会话反复使用。
在 Run Center 里跟踪计划、成员输出、重试，以及服务商上报的 Token 用量。
这是 DeepSeek Harness Web 配置档的非官方社区插件。

观看 80 秒 UI 指南 · 安装 v1.3.0 · 跑起你的第一支团队 ·示例配方 ·分享工作流

UI walkthrough: reusable team setup, run inspection, and recipes

基于截图的 UI 指南，使用示例数据和中文合成旁白。展示的任务结果、耗时和 Token 都不是真实运行的基准数据。素材与字幕。

如果它对你的 DSH 工作流有帮助，给项目点个 Star，让更多开发者发现它。

为什么用这个插件

团队是可复用的产品对象，不是一次性的派发表单。在 Settings → Teams 里创建一次，之后跨项目、跨会话使用。

| 能力 | 用户收益 |
| 每个成员单独设置模型和工具策略 | 把规划者、实现者、评审者或专家组合起来，不必让所有人走同一条路线 |
| 默认动态规划工作流 | 由当前会话的模型根据本次请求分配具体任务和依赖关系 |
| Team / Solo / Inherited 模式 | 选择持久的会话覆盖、项目默认值，或只对单条消息生效的例外，不用在含糊的开关之间纠结 |
| 有界 DAG、重试、质量门、后台任务 | 长任务可观察、可取消、有终点，重启后也能恢复 |
| 服务商官方 Token 用量 | 查看输入、缓存读取、缓存写入和输出 Token，覆盖状态分完整/部分/不可用——绝不编造价格 |
| 版本、配方与定义备份 | 复现团队、不带凭据分享、预览影响，并在应用前重映射模型路由 |

安装

| 插件版本 | DSH 目标 | 升级指引 |
| 1.3.0 | >=0.1.5-rc.1 <0.1.6-0 | 推荐；可按需选择委派，模式边界一致 |
| 1.2.0 | >=0.1.5-rc.1 <0.1.6-0 | 失败诊断与有界的主控驱动续跑 |
| 1.1.1 | >=0.1.5-rc.1 <0.1.6-0 | 早期工作流修复；重试仍会重放任务分配 |
| 1.1.0 | >=0.1.5-rc.1 <0.1.6-0 | 最初的 0.1.5 兼容版本；请把插件升级到 1.3.0 |
| 1.0.1 | 已在 0.1.1-rc.2 上验证 | 上一代集成；请同时升级 DSH 和插件 |

演示视频有英文字幕和中文字幕。
在兼容的播放器里把 SRT 和现有视频一起加载；GitHub 不会自动挂上字幕。

要从 0.1.1 升级 DSH？DSH 0.1.5 请用插件 v1.3.0。这个版本修复了插件加载期间的 source.subscribe，迁移了重连和 Session API，并保留现有的团队定义和运行存储。升级后重启 DSH 并刷新浏览器。命令行可能报告 0.1.5-rc.1，而它兼容的内部包实际解析到 0.1.5-rc.2。

环境要求：可用的 DeepSeek Harness Web 配置档、至少一个已配置的服务商/模型、 Node.js >=22.19.0 <23 或 >=24.0.0，以及 pnpm。声明的 DSH 兼容范围是 >=0.1.5-rc.1 <0.1.6-0；v1.3.0 版本已在 DSH 0.1.5-rc.1 上验证。

推荐：安装编译好的发布包。 它包含构建好的 Host 和客户端文件，所以安装时不会跑本插件的 Git prepare 构建，也不需要它的 allowBuilds 条目。

dsh plugin --profile web add https://github.com/toolclub/dsh-agent-team-gui/releases/download/v1.3.0/dsh-agent-team-gui-1.3.0.tgz
dsh --profile web

安装或升级后，停掉正在运行的 DSH Web 进程再重启。然后打开 Settings → Teams。如果某个插件市场选择了 Git 安装并失败，请用上面的直接发布命令；参见安装故障排查。

DSH 0.1.7-rc.2 超出本版本声明的主机范围；它的安装器会拒绝 v1.3.0 的 peer 范围并回滚安装（已在 macOS arm64、Node 26.5.0、pnpm 12.6.0 上复现）。不要把更换安装来源当成运行时支持。Node 引擎范围并不代表每个更新的 Node/DSH 组合都测过。
DSH Plugin Hub 请使用 1.5.2 或更高版本，并刷新目录。Hub 1.4.8 没有 release-package 通道。如果目录仍然选择 Git，请使用上面的直接命令。Hub 会缓存目录一小时，刷新失败时可能复用旧数据。

发布说明与校验和 · Git/源码安装

[!TIP]
如果 dsh 不在 PATH 中，请使用能启动你当前 Harness 安装的启动器。
用 npm 时，把 dsh 替换为 npx @deepseek-ai/dsh@0.1.5-rc.1；从源码检出运行时，替换为
pnpm --dir /absolute/path/to/deepseek-harness dsh。安装和启动请使用同一个启动器。刚接触 Harness？先看它的官方安装指南。

确认 dsh-agent-team-gui bundle 和 agent-team-gui 配置行都已存在：

dsh --profile web --dump-config

运行你的第一个团队

使用内置的全栈交付 recipe，其中包含规划者、实现工程师和审查者。第一次运行时，你可以把三者都绑定到同一个工作模型；多个服务商是可选的。

1. 下载 recipe JSON。打开 Settings → Teams → Recipes & data，选择 Choose recipe file。
2. 把占位路由映射到你配置好的 provider/model 路由，检查预览，然后选择 Create a copy → Import reviewed recipe。在 Member library 中，确认每个成员的确切模型和工具访问权限。
3. 第一次走查时，把 Team usage → Host dispatches first、Dispatch policy → Run assigned work 和成员选择设为 All members，然后保存。提供的 recipe 在其他情况下使用 Smart/adaptive 选择。
4. 选择一个空的临时项目，在编辑器旁选择导入的团队，选择 Select team for this conversation，然后发送可直接复制的任务：构建并测试一个小型待办清单。
5. 打开 Team runs，检查计划、输出、审查和实际 Token 覆盖情况。在把任务视为完成之前，先检查交付的文件和测试结果。

完整走查、预期结果与故障排查 →

创建你自己的团队

在 Settings → Teams → Member library 中，保存每个成员的角色、模型、可选回退和工具策略。
在 Settings → Teams 中，添加这些成员，并选择激活方式、成员选择和执行选项。
关闭 Fixed order 可启用动态规划，开启则使用固定串行顺序。
在编辑器旁选择 Team、Solo 或 Inherited，控制当前会话。

在普通编辑器旁选择 Team、Solo 或 Inherited

UI 示例，使用演示数据。

编排如何工作

flowchart TD
U[用户消息] --> M{生效模式与一次性选择}
M -->|Solo 或 Manual| L[Lead 直接处理请求]
M -->|按需| J{Lead 判断委派是否有帮助}
J -->|否| L
J -->|缺少信息| A[询问用户]
J -->|是：dispatch_to_squad| D[校验并接纳一次初始派发]
M -->|Host 派发或 Force Team next| D
D --> P[使用显式计划或调用有界规划器]
P -->|智能跳过| L
P --> W[依赖就绪的成员、失败策略、可选质量门]
W --> R[持久化结果、诊断与上报用量]
R --> L
R -->|Lead 审查未完成工作| C[有界 continue_squad_run]
C -->|复用成功结果、共享预算、一次续跑| W

新建的编辑器草稿和内置模板默认使用 Lead 决定何时委派。
选中团队只是让它可用；简单回答不会创建规划子进程或团队运行。
已保存/导入的选择和旧版缺失字段的默认值保持不变。
完整流程与边界情况约定。Host 后台运行在 Run Center 中结束；模型发起的工具派发会等待其结果。

派发之后，如果没有提供显式分配/顺序，也不存在固定顺序，插件会在当前对话的服务商/模型路由上启动一个有界、无工具的规划子进程。它接收成员角色，返回结构化分配和一个无环依赖图。它不会把某个成员变成整个团队的替代品。计划有问题、成环或不可用时，回退到确定性的按角色分配。

就绪的 DAG 节点运行到 maxConcurrency 上限。依赖方只接收有界的结构化交接；成员的完整输出保留在持久化运行历史中。固定成员顺序是显式的串行覆盖，会绕过 DAG 规划。

激活与选择

- Run assigned work 在派发选定后要求执行一次；它不强制按需委派。
- Smart 让有界规划器跳过不合适/琐碎的工作。
- Manual 阻止普通的自动/模型派发；需显式选择 Force Team next 或手动 Run Center 操作。
- All members 为每个已配置成员各分配一次。
- Adaptive 让 Smart 规划选出最小的有用非空子集。

对话模式

- Team 为当前对话显式持久选中团队。
- Solo 为显式持久退出，即使项目有默认团队也生效。
- Inherited 移除对话级覆盖，存在项目默认值时跟随项目默认值。
- Next message 是独立的崩溃安全一次性 Team 或 Solo 选择，只消费一次。

这些状态在页面刷新、Host 冷启动和实时重连后仍保持可交互。目录为空或暂时不可用，绝不会静默删除已保存的选择。

安全边界

- 规划器、成员、审查者和修复提示词都放入独占角色与禁止委派契约在用户内容的有界摘录之前。
- 委派的会话不能再派发另一个团队。检测到的 DSH 子代理工具——包括改过名的注册——在团队子会话内一律拒绝。
- 一条持久化声明把自动派发和模型工具派发绑定到最新的人类消息，所以反复调用工具不会创建出成百上千个重复团队。
- 成员超时、并发数、重试一次、团队 Token 软预算、质量轮次都有上限。
- 重试会创建一个关联的不可变运行，并重放原始归一化后的任务分配、顺序和 DAG；它不会悄悄让模型另造一套工作流。

Run Center 与 Token 用量

查看 DAG、成员状态、评审轮次和 Token 分桶

每次执行都会在规划开始前写入。Run Center 展示前台/后台状态、实时阶段、已用时间、子会话 ID、完整输出、有界交接、停止、关联的整队或成员重试、导出、筛选，以及保留期安全的清理。

如果 DSH 子会话在交付非空纯文本后以 stopReason: "error" 结束，该成员计为 Completed，而不是丢掉一份有效的长文交付物。停止原因仍会记录，Run Center 会显示协议交付警告。空输出、被拒绝的运行、清理失败、超时，以及其他非完成原因（如 max-tokens）仍算失败。

每个成员的交接摘要默认最多保留 16,000 个字符。团队可以把 handoffSummaryMaxChars 设为 1,000 到 32,000。完整原始输出仍持久保存在 Run Center；依赖提示词和主导提示词各自保留独立的聚合上限，所以一份很长的产物不会让模型上下文无界增长。

插件复用 DSH 官方的 tokenUsage 投影，保留四个分桶：

- 未缓存输入；
- 缓存读取；
- 缓存写入；
- 输出。

规划、成员、评审、修复的用量仍可分别归因。覆盖率在运行和重试尝试级别明确标为 full、partial 或 unavailable。在服务商上报样本之前，界面显示 Metering…，而不是假的零。Token 不是钱；Harness 服务商没有通过稳定计价契约公布的价格，插件不会去猜。

比较持久化用量与完成情况洞察，不编造价格

质量门与后台运行

可选的质量门指定一名评审者、一名修复负责人、明确的验收标准，以及 0..2 轮修复。一次驳回可以只重跑该修复负责人，随后由指定的评审者复核。它不能创建任意智能体，也不能递归。

前台运行在主导 Agent 合成有界交接之前完成。后台运行返回一条简短确认，并持续显示在插件 Run Center 中；官方 DSH Jobs 服务存在时，同一次运行也会注册到那里，共享同一个取消钩子。没有这个可选服务时，插件回退到进程内后台执行；此时 Host 重启会重新协调未完成的持久状态标记为 Interrupted，而不是假装它已经完成。

版本、配方与定义备份

预览配方、冲突、受影响的团队，以及主/备路由重映射

- 每个保存的团队版本都包含所有引用成员定义的不可变快照。
- 恢复采用预览优先，当共享成员会改变另一个团队时给出警告。
- 配方包含一个团队及其成员，绝不包含服务商凭据。导入支持 Copy 或 Merge、冲突预览，以及分别重映射主/备路由。
- 定义备份导出智能体和团队。导入采用预览优先，支持 Merge 或 Replace；replace 在确认前会报告删除项、悬空 mode/default 清理，以及受影响的团队。
- 多表写入串行化，并在校验、取消或存储失败时使用补偿回滚。读方看到的要么是之前的定义图，要么是已提交的定义图，不会是导入到一半的状态。
- v0.5 中禁用了远程配方 URL。请导入经过审查的本地 JSON 文件；这样有意避免了暴露未受保护的服务器端 fetch/SSRF 面。

从无凭据的全栈交付配方开始，预览它，并把其中的 your-provider / your-model 占位符重映射到你自己 DSH 配置档中配置的路由。

定义导出包含成员系统提示词和模型路由名称。运行导出还额外包含用户任务和成员输出。分享这些文件前请先审查。

设置参考

成员

| 字段 | 含义 |
| 名称与角色提示词 | 该成员的持久身份与专属指令 |
| 主服务商/模型 | 现有 DSH 路由；凭据留在 DSH 中 |
| 备服务商/模型 | 可选配对路由，用于 retry-once |
| maxTokens | 发送给服务商的每次尝试输出硬上限 |
| 工具允许/拒绝 | 对已注册 DSH 工具的最小权限可见性；递归团队/子代理工具保持拒绝 |

团队

| 字段 | 含义 |
| 成员与协作说明 | 可复用的成员定义，加上团队级协调指引 |
| 固定顺序 | 完整串行排列；关闭则使用动态分配和 DAG 依赖 |
| 执行/上下文 | 串行或有界并行；spawn、fork，或仅串行的 chain |
| 激活/选择 | Always、Smart 或 Manual；全部成员或自适应子集 |
| 响应 | 前台综合或可观测的后台运行 |
| 规划器 | 当前/近期/完整上下文，以及有界的规划器 Token 上限 |
| 韧性 | Continue、stop 或 retry-once；成员超时与备路由 |
| 限制 | 最大并发数，以及服务商上报的团队 Token 软预算 |
| 交接摘要 | 每个成员的摘要字符上限；留空使用 16,000，可配置范围 1,000–32,000 |
| 质量 | 指定的审查者、修复负责人、标准，以及最多两轮修复 |
主路径在窄视口下依然可用

Host 配置

Web 包只插入一行唯一的 Host 记录；它依赖 Web 配置档已有的存储、Connection RPC、模型、会话和浏览器模块服务。

- id: agent-team-gui
name: dsh-agent-team-gui
config:
defaultProvider: spawn
defaultExecutionMode: serial
defaultContextMode: spawn
historyMaxRuns: 0
historyMaxAgeDays: 0
versionMaxPerSquad: 0

| 字段 | 默认值 | 含义 |
| defaultProvider | spawn | 已注册的 DSH 子代理服务商 |
| defaultExecutionMode | serial | 团队未指定时生效的模式 |
| defaultContextMode | spawn | 团队未指定时生效的上下文 |
| historyMaxRuns | 0 | 按数量保留；0 关闭自动删除运行记录 |
| historyMaxAgeDays | 0 | 按天数保留；0 关闭自动删除运行记录 |
| versionMaxPerSquad | 0 | 每个团队的版本保留数；0 关闭自动删除版本 |

如果你在配置档补丁里覆盖这一行，必须把需要的字段全部重写一遍：DSH 补丁行会替换整个 config 对象，而不是深度合并。chain 只在串行执行时有效。保留策略刻意设为手动开启：升级到 v0.5 不会悄悄删掉已有的运行历史或团队版本。只有当你确实想要自动清理时，才设置一个正数上限。

其他安装方式

Git 源码安装

打算从源码构建时，用这种方式：

dsh plugin --profile web add -w github:toolclub/dsh-agent-team-gui#v1.3.0

Git 依赖会运行本仓库的 prepare 构建。在 pnpm 10+ 上，只授权 pnpm 在配置档的 pnpm-workspace.yaml 里 allowBuilds 下打印的那个确切包名，然后重复执行同一条带版本锁定的命令。包名可能包含解析后的修订号；从报错信息里复制实际的包名。这一步是给该依赖执行构建脚本的权限。上面的编译产物安装路径可以省掉这一步。

精确提交

解析并审查完整的 commit SHA，然后套用与带标签 Git 安装相同的 allowBuilds 规则：

dsh plugin --profile web add -w github:toolclub/dsh-agent-team-gui#<full-commit-sha>

这是最可复现的源码安装方式。发布 CI 会针对推送的确切修订号，执行同样的全新配置档检查。

本地检出

在本仓库中：

pnpm install --frozen-lockfile
pnpm run preflight
dsh plugin --profile web add -w .

preflight 会类型检查 Host、Client 和测试；运行 Host 与渲染后 Client 的测试套件；从干净的输出目录构建；审计 tarball 和密钥；并启动一个隔离的临时 DSH Web 配置档。

编译后的 tarball

mkdir -p dist
pnpm pack --pack-destination dist
dsh plugin --profile web add -w ./dist/dsh-agent-team-gui-1.3.0.tgz

包审计会校验运行时与声明文件的闭包、示例、治理文件、截图，源码映射、外部依赖声明、不使用绝对路径、不使用符号链接，也不包含任何已知的凭据特征。

让具备终端能力的智能体执行

你可以在 DeepSeek Harness 中发送这一条指令：

按照 https://github.com/toolclub/dsh-agent-team-gui 中的安装与安全说明操作。把编译好的 v1.3.0 Release tarball 安装到 Web 配置档，重启 Web，校验合成后的配置，并报告已安装的版本和安装来源。

模型工具与公共服务

dispatch_to_squad 仍可用于显式、手动、由模型驱动的场景。它接受团队 ID 或不区分大小写的唯一名称、一个任务、可选的分配/顺序，以及在已保存团队允许的范围内覆盖执行与上下文。它返回给模型的结果有长度上限；完整的规范运行记录会持久保存，可通过 Run Center/导出获取。

该包还导出 AgentTeamService、记录/结果类型、Zod schema，以及进程内的定义/分发/版本/recipe/运行 API。DSH 本身尚未稳定，请把这些 API 视为开发者预览接口。

安全与隐私

- 插件 RPC 使用 /api/agentTeamGui，位于 DSH 的浏览器会话 cookie 认证和 Host/Origin 校验之后。请求与结果都会校验；不存在单独的无认证通道。
- 服务商凭据绝不会复制进插件记录、recipe、示例、日志或导出内容。
- 本地持久存储确实会包含团队角色提示词、选定的路由名称、会话/项目标识符、用户任务、运行输出、错误和 Token 用量。请保护好 DSH 主目录。
- 成员工具遵循最小权限。模型可以执行其被允许的 DSH 工具所许可的任何操作。
- URL recipe 抓取已禁用。安装脚本是唯一额外的机器代码权限来源；请审查并固定 Git 依赖，或使用编译好的 tarball。
- 私下报告漏洞，请使用 SECURITY.md，不要在公开 issue 中附带凭据或私有提示词。

兼容性与限制

依赖链和修复链有单独的 12,000 字符序列化 JSON 预算；质量审查链为 32,000 字符。这些预算与每个成员存储的摘要上限相互独立。链会预留成员身份，在各次交付之间共享空间，并报告 chainTruncated 和 omittedHandoffs。完整输出仍保留在 Run Center。审查轮次使用审查者配置的 maxTokens，未设置时默认值仅为 2,048。

retry-once 现在会先诊断失败再重试。显式的计费耗尽、取消，或已配置预算耗尽，都会停止恢复。一个无工具的系统协调器运行在 lead 的模型路由上，评估失败证据和先前进展。只有受支持的瞬时故障才会原地重试；结构性变更会提交给 lead，而不会静默执行。

失败或部分运行结束后，lead 可以调用 continue_squad_run，引用其 run id 以及链修订。首个版本允许每条执行链一次续跑。它会复用独立的成功任务，重跑受影响的后代任务，保留两份计划与结果，并共享原先配置的软 Token 预算。重复提交会返回已接受的结果；改动措辞不会重置准入。同消息的首次派发仍限一次。运行中心的手动重试仍是用户发起的独立显式重放。

续跑为每个现有成员保留一个任务节点。把剩余工作拆成有序步骤；暂不支持为同一成员或新团队添加多个独立节点。契约与限制见执行链与恢复。

对于 DSH 0.1.5，全局拒绝条目会对照全局注册表过滤，而作用域内的允许条目保持不变。执行守卫还会拦截已识别的委派工具，以及对标记的进程内子级的显式成员拒绝。DSH 没有通用的委派能力标签：schema 无关的自定义工具和任意外部程序不构成操作系统级沙箱边界。

- 仅 Web 配置档；没有无头 Settings UI。导出的 Host 服务仍可供另一个进程内插件使用，只要它提供所需服务。
- 声明的兼容性是 DSH >=0.1.5-rc.1 <0.1.6-0；CI 目前验证 DSH 0.1.5-rc.1。DSH 与本插件都处于预稳定阶段，所以要锁定版本。
- 旧的 v0.4 持久化定义和 v1 导出仍可读取/导入。编辑它们必须满足更安全的 v0.5 新写入限制。没有存储计划的旧运行无法忠实重试，会被拒绝并给出说明。
- 服务商 Token 预测是可选的。部分覆盖或不可用是预期内的，并且是显式的。
- 软团队 Token 预算会阻止后续调度；它无法在精确阈值处停止已在运行的服务商。每个成员的 maxTokens 才是服务商的硬性上限。
- DSH 目前没有为自定义持久化 squad/* 会话事件类型提供受支持的注册接缝。插件使用自己的持久化运行存储、标准子会话/工具事件、Jobs 和日志。
- 模型工具触发模式是尽力而为的，因为 DSH 没有暴露 toolChoice 控制。有保证的普通发送模式由 Host 驱动，并且对持久化消息幂等。

验证与项目健康

pnpm run typecheck
pnpm run test
pnpm run build
pnpm run audit:pack
pnpm run smoke:install
pnpm run smoke:browser

CI 运行 Node 22.19 和 Node 24、全新的 DSH 0.1.5-rc.1 Web 配置档、浏览器键盘/无障碍/重连旅程、精确 Git 修订安装，以及社区插件 doctor。详细的产品契约与证据矩阵见 docs/v0.5-product-spec.md 和 docs/v0.5-acceptance.md。

贡献

请阅读 CONTRIBUTING.md、Code of Conduct，以及 SECURITY.md。简明中文教程从零开发一个 DeepSeek Harness 插件 讲解了 apply、Service 插件、profile/bundle 接线、本地验证，以及如何参照官方 Harness 文档从 GitHub 安装。

提 Issue 时请写清 DSH/插件的具体版本，并附上脱敏后的最小复现步骤。提 Pull Request 时请补充聚焦的回归证据，并确保兼容性、有界执行、无障碍、隐私和包闭包都在考虑范围内。

如果这套工作流帮到了你，给个 GitHub Star 能让更多 DSH 用户发现它。真实的配方、截图，还有坦诚的 bug 报告，帮助更大。

卸载

dsh plugin --profile web remove dsh-agent-team-gui

移除包并不会自动删除已配置的 DSH 存储后端里的持久化插件表。

许可证

基于 MIT License 发布。