多模型编排器 ToxicantX/dsh-multi-model-orchestrator

DSH Multi-model Orchestrator

在 DeepSeek Harness 中配置并运行由不同模型驱动的专业智能体团队。

项目介绍

DSH Multi-model Orchestrator 为 DeepSeek Harness Web 设置页增加了智能体编排功能。你可以配置任意数量的可复用专业智能体，为每个智能体选择 DSH 中已有的模型，并设置清晰的职责。这些智能体是可复用的 specialist 工具；child 任务的数量由有效工作和 runtime 容量决定，而不是由智能体列表数量决定。

会话使用 Multi-model orchestrator 预设后，每个已启用的智能体都会成为独立的子代理工具，供主智能体按任务需要进行委派。禁用智能体会保留其模型和提示词配置，但不参与新会话的委派。

主智能体的定位是产品负责人和工程项目经理，而不是默认开发者。面对非简单工作，它先明确目标与验收标准，拆分互不重叠的范围，并在实施开始前委派开发、调查、测试和审查。每个 child 在返回前独占一个内聚任务和验收目标；主智能体只协调不重叠工作、等待依赖、集成返回结果并执行最终验收。真正的一步小改仍可直接完成。

功能特性

- 配置任意数量的可复用的专业智能体；每个工具可以服务多个 child 任务。
- 直接选择 DSH 中已有的模型。
- 为每个智能体设置固定 ID 和开发职责。
- 从对应模型实际提供的等级中选择可选推理等级。
- 为每个智能体设置可选的最大输出 Token。
- 由主智能体负责需求、计划、分配、集成和最终验收。
- 每个 child 独占一个内聚任务和验收目标，避免主智能体重复实现。
- 按复杂度将非简单工作拆分为任意数量有意义、互不重叠且可独立验收的任务，避免人为制造或过度微拆。
- 每个独立任务创建新的 child，即使多个任务匹配同一 specialist；独立任务可在 runtime 容量内并发，文件、所有权或依赖交叉的任务串行。
- 运行中的会话保持启动时的智能体配置。
- 每个智能体可独立启用或禁用，旧配置默认启用。
- 配置条目可展开或收起；收起时仍可查看模型、切换启用状态和删除，多条目列表可滚动。
- 保留标准模式的项目指令、技能、时间上下文、计划审批和结果展示；定时任务在 Runtime 提供对应插件时可用。

环境要求

- DeepSeek Harness 0.2.0-rc.1 或兼容的新版本
- Node.js 22.19 或更高版本
- DSH 设置 > 模型 中至少有一个可用模型

安装

将插件安装到 DSH Web 配置档：

~~~powershell
dsh plugin --profile web add -w github:ToxicantX/dsh-multi-model-orchestrator

安装完成后重启 DSH Web，并刷新浏览器。Host 启动时，插件会注册智能体预设，同时创建旧版 orchestrator 兼容 ID，使使用该 ID 的已有会话可以恢复，并从 Web 选择列表中隐藏使用官方显示名的兼容项和 Desktop 自动生成的升级、卸载备份。备份文件与历史 ID 保留。内容完全匹配官方旧版的无 marker preset 会被安全收编；经过自定义的用户 preset 不会被覆盖，改用不同名称时仍保持可见。

升级时，已有配置会被完整保留，包括此前超过 3 个智能体的名册；未设置启用状态的旧智能体默认启用，设置页可继续增删、启用或禁用。
如果通过 DSH 源码仓库运行，请将命令中的 dsh 替换为 pnpm dsh。

如果启动时提示受管预设已被修改或与现有预设冲突，并且你确认要丢弃这些本地改动，请显式修复：

~~~powershell
dsh plugin --profile web exec dsh-orchestrator-install --force

使用方法

1. 打开 DSH Web。
2. 进入 设置 > Agent 编排。
3. 点击 添加 Agent。
4. 填写 Agent ID、开发职责和子 Agent 提示词。
5. 从 DSH 可用模型中选择一个模型。
6. 根据需要选择该模型支持的推理等级并设置最大输出 Token。
7. 保存配置。
8. 使用 Multi-model orchestrator 预设创建 Session。

修改 Agent 列表或模型分配后，请创建新的 Session。已经运行的 Session 会继续使用启动时的 Agent 配置。

在非简单 Session 中，主 Agent 会先确定验收标准并分配开发任务，再进入实施。它把已配置的 Agent 视为可复用的 specialist 工具，按复杂度将工作拆分为任意数量有意义、互不重叠且可独立验收的任务，并避免人为制造或过度微拆。每个任务都创建新的 child，即使它匹配已经用于其他任务的 specialist。独立任务可在 runtime 容量内并发；文件、所有权或依赖交叉的任务必须串行。存在合适 specialist 时，主 Agent 不自行承担开发，但不会为了占满 Agent 人为制造任务。每个 child 在返回前独占一个内聚任务和一个验收目标；主 Agent 可以协调其他明确不重叠的任务，但必须等待而不能并行实现相同目标。同一任务需要修正时，复用原 continuable child。specialist 返回后，主 Agent 负责检查集成边界并执行最终验收。

可靠性行为：没有独立工作剩余时，主 Agent 使用前台子调用，不反复轮询 list_agents 来消磨时间。rc.2 的 list_agents 只报告 running 或 inactive：running 表示当前轮次正在执行，inactive 只表示没有轮次正在执行，两者都不表示任务是否完成或成功。后台 child 只有在收到运行时 settlement notice 后才算返回；启动回执、send_message 投递回执和 inactive 状态都不是任务结果。只有 child 明确报告阻塞/死锁、依赖不可用、同一工具或执行错误连续两次，或两次状态检查都没有进展且存在未解决阻塞时，才可判定卡死。耗时、静默、不变状态、其他 child 已完成或主 Agent 准备结束，都不能单独构成卡死证据。只有用户明确取消、明确期限已经到达、有具体证据支持的真实死锁，或验证过的重复工具或执行失败才允许中断；中断前必须说明证据，并对准确的 child ID 只调用一次 interrupt_agent。该调用只确认已接受中断请求，目标可能短暂保持 running；后续 inactive 只证明轮次已停止，不证明任务已完成。主 Agent 不得在必需 child 仍运行、缺少前台结果或缺少后台 settlement notice 时结束；被中断或失败的 child 对应任务仍未完成，必须报告阻塞或重新规划。send_message 对运行中的 child 在下一个 step boundary 生效，对 inactive child 启动或恢复轮次，并且只返回投递确认，不返回 child 回复。specialist 连续两次遇到相同工具或执行协议错误后，改用最简单的有效替代工具调用或报告阻塞，并避免继续发起失败或没有有效输出的重复调用。

Agent 配置项

| 配置项 | 必填 | 说明 |
| Agent ID | 是 | 用于子 Agent 工具名称和逐 Agent 运行配置的稳定身份，例如 architect 或 reviewer。 |
| 启用状态 | 否 | 默认启用。禁用后保留配置，新会话不注册该 Agent 的委派工具；保存后创建新 Session 生效。 |
| 模型 | 是 | 从 DSH 模型目录中选择的 Provider 和 Model。 |
| 开发职责 | 否 | 展示给主 Agent 的简短路由摘要，用于选择 specialist；该字段不用于确定身份。 |
| 子 Agent 提示词 | 否 | 发送给对应子 Agent 的独立 persona 提示词。旧配置未填写该字段时，会回退使用开发职责。 |
| 推理等级 | 否 | 所选模型实际提供的推理等级之一；省略时使用模型默认值。 |
| 最大输出 Token | 否 | 限制 Agent 输出长度的正整数。 |

本地开发

~~~powershell
git clone https://github.com/ToxicantX/dsh-multi-model-orchestrator.git
cd dsh-multi-model-orchestrator
pnpm install
pnpm bundle
pnpm typecheck
pnpm test

发布管理遵循语义化版本（SemVer）。请在 CHANGELOG.md 记录面向用户的变更，使用 vX.Y.Z 格式创建 tag，并运行本地预检：

~~~powershell
pnpm release:check v0.7.0

推送匹配的 vX.Y.Z tag 会触发验证并创建带自动生成说明的 GitHub Release。npm 发布不会自动执行。

将本地仓库安装到 DSH 源码 profile：

~~~powershell
pnpm dsh plugin --profile web add -w D:/path/to/dsh-multi-model-orchestrator

Overview

DSH Multi-model Orchestrator 在 DSH Web 设置里新增一个智能体编排页面。你可以配置任意数量的可复用专家智能体，给每个智能体分配一个已有的 DSH 模型，并明确各自的职责。这些配置好的智能体是可复用的专家工具；子任务的数量取决于有意义的工作和运行时容量，而不是名单大小。

当某个会话使用 Multi-model orchestrator 预设时，每个已启用的智能体都会变成一个独立的子代理工具，主智能体可以把工作委派给它。已禁用的智能体保留模型和提示词设置，但新会话不会向它们派发任务。

主智能体扮演产品负责人和工程经理，而不是默认的开发者。面对非琐碎的工作，它先定义结果和验收标准，拆出不重叠的范围，在动手实现之前把开发、调研、测试和评审委派出去。每个子代理独占一个内聚任务和验收目标，直到任务完成；主智能体只协调不重叠的工作，等待依赖，整合返回的成果，并做最终验收。真正只需一步的小改动可以留在本地处理。

功能

- 配置任意数量的可复用专家智能体；每个工具可在多个子任务中复用。
- 选择 DSH 中已有的模型。
- 给每个智能体设置稳定的 ID、开发范围和子代理提示词。
- 从智能体模型明确公布的档位中，选一个可选的推理强度。
- 为每个智能体设置可选的输出 token 上限。
- 让主智能体负责需求、规划、分配、整合和最终验收。
- 让每个子代理独占一个内聚任务和验收目标，主智能体无法重复它的工作。
- 按复杂度把非琐碎工作拆成任意数量的有意义、不重叠的任务，各自有独立验收目标，同时避免人为或过细的拆分。
- 每个独立任务都新建一个子代理，多个任务用同一个专家时也一样；在运行时容量内并发执行独立任务，文件、归属或依赖有重叠时串行处理。
- 每个运行中的会话保持启动时的智能体配置。
- 每个智能体可独立启用或禁用；已有配置默认启用。
- 每个配置可展开或收起。收起后的行保留模型摘要、启用开关和删除操作；长列表可滚动。
- 保留标准项目指令、技能、时间上下文、计划审批和结果展示；运行时提供对应插件时，提醒功能可用。

要求

- DeepSeek Harness 0.2.0-rc.1 或兼容的更新版本
- Node.js 22.19 或更新版本
- DSH Settings > Models 中至少有一个可用模型

安装

在 DSH Web 配置档中安装插件：

~~~powershell

dsh plugin --profile web add -w github:ToxicantX/dsh-multi-model-orchestrator

安装完成后重启 DSH Web，再刷新浏览器。Host 启动时，插件会自动注册自己的 Agent 预设。它还会注册旧版 orchestrator 预设 ID，让用该 ID 创建的已有会话能继续恢复；同时在 Web 选择列表里隐藏官方名称的兼容条目，以及生成的 Desktop 升级或卸载备份。备份文件和历史身份都会保留。与官方标记前完全一致的副本会被安全采纳；用户自行管理的定制预设绝不会被覆盖，只要起一个不同的名字，它们仍会显示。

升级时会保留已有设置，包括此前超过 3 个 Agent 的名单。没有显式启用状态的 Agent 默认启用。设置页会保留完整名单，供你编辑和开关。

从源码检出运行 DSH 时，命令里用 pnpm dsh 代替 dsh。

如果启动时提示托管预设被编辑过，或与已有预设冲突，而你想丢弃这些本地改动，就显式修复：

~~~powershell
dsh plugin --profile web exec dsh-orchestrator-install --force

用法

1. 打开 DSH Web。
2. 进入 Settings > Agent orchestration。
3. 选择 Add Agent。
4. 输入 Agent ID、开发范围和子代理提示词。
5. 从 DSH 可用的模型里选一个。
6. 可选：选择该模型支持的推理强度，并设置最大输出 token 上限。
7. 保存配置。
8. 用 Multi-model orchestrator 预设创建会话。

改动 Agent 名单或模型分配后，请新建会话。已在运行的会话保持原来的 Agent 配置。

在非简单会话中，主 Agent 先定验收标准，再分配开发任务，然后才动手编辑。它把配置好的 Agent 当作可复用的专家工具，按复杂度把工作拆成任意数量的有意义、互不重叠的任务，每个任务都有独立的验收目标，避免人为或过细的拆分。每个任务都分配新的子代理，即使它和另一个任务用的是同一位专家。独立任务在运行时容量内并发执行；文件、归属或依赖有重叠的任务串行执行。主 Agent 自己开发时，不会让合适的专家闲着，但也不会为了用上每个 Agent 而硬造工作。每个子代理负责一个内聚任务和一个验收目标，直到返回为止；主 Agent 可以协调其他明确不重叠的任务，但要等待，而不是自己去实现同一个结果。同一任务需要修正时，它复用可继续的子代理。专家返回后，主 Agent 检查集成边界，并跑最终验收。
可靠性行为：没有独立工作可做时，主智能体改用前台子调用，不会为了消磨时间反复轮询 list_agents。在 rc.2 中，list_agents 只报告 running 或 inactive：running 表示正在执行某一轮，inactive 表示没有轮次在执行；这两种状态都不描述任务是否完成或结果如何。只有运行时送达结算通知，才说明后台子代理已返回。启动确认、send_message 送达确认、inactive 状态都不是任务结果。只有满足以下任一条件，才判定子代理卡住：它报告了阻塞或死锁；必需的依赖不可用；同一个工具或执行失败出现两次；两次状态检查都显示没有进展，且存在未解决的阻塞。仅凭耗时、沉默、状态不变、其他子代理完成、主智能体已准备好收尾，都不构成判定依据。中断只限于以下情况：用户直接取消；明确的截止时间已到；有具体证据支持的死锁；经确认反复出现的工具或执行失败。中断之前，主智能体要说明证据，并针对确切的子代理 ID 调用一次 interrupt_agent。该调用先确认受理，目标随后才静默，所以它可能短暂保持 running；之后出现 inactive 只能证明该轮已停止，不能证明任务已完成。只要必需子代理仍在运行、缺少前台结果、或缺少后台结算通知，主智能体就绝不收尾；它把被中断或失败的子代理视为未完成工作，需要报告阻塞或重新规划尝试。send_message 会在运行中子代理的下一个步骤边界引导它，或启动、恢复 inactive 子代理；它返回送达确认，而不是子代理的回复。同一个工具或执行协议错误出现两次后，专家智能体改用最简单的有效替代工具调用，或报告阻塞，并避免重复调用那些失败或没有有用输出的调用。

智能体字段

| 字段 | 必填 | 描述 |
| Agent ID | 是 | 稳定标识，用于子代理工具名和各智能体的运行时设置，例如 architect 或 reviewer。 |
| Enabled | 否 | 默认启用。禁用会保留配置，并在新会话中省略该智能体的委派工具。保存并新建会话后生效。 |
| Model | 是 | 从 DSH 模型目录中选择的服务商和模型。 |
| Development scope | 否 | 简短的路由摘要，主智能体选择专家智能体时会看到。它不决定智能体身份。 |
| Child Agent prompt | 否 | 发送给所选子智能体的专用角色提示词。没有此字段的旧配置回退到开发范围。 |
| Reasoning effort | 否 | 所选模型公布的确切推理强度级别之一；省略则使用模型默认值。 |
| Maximum output tokens | 否 | 正整数，限制智能体生成的输出。 |
本地开发

~~~powershell
git clone https://github.com/ToxicantX/dsh-multi-model-orchestrator.git
cd dsh-multi-model-orchestrator
pnpm install
pnpm bundle
pnpm typecheck
pnpm test

版本管理遵循 Semantic Versioning（SemVer）。把面向用户的改动记到 CHANGELOG.md，按 vX.Y.Z 打标签，再跑一遍本地预检：

~~~powershell
pnpm release:check v0.7.0

推送匹配的 vX.Y.Z 标签会触发校验，并生成一个 GitHub Release，附上自动生成的说明。npm 发布不会自动进行。

把本地检出的代码装进 DSH 源码配置档：

~~~powershell
pnpm dsh plugin --profile web add -w D:/path/to/dsh-multi-model-orchestrator

License

MIT