ToxicantX/dsh-multi-model-orchestrator

DSH 多模型编排器

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

Release
Downloads
License
Stars
Issues
Tests
Node.js
DSH

中文

项目介绍

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

Session 使用 Multi-model orchestrator 预设后，每个已配置的 Agent 都会成为独立的子 Agent 工具，供主 Agent 按任务需要进行委派。

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

功能特性

- 配置最多 3 个可复用的专业 Agent；每个工具可以服务多个 child 任务。
- 直接选择 DSH 中已有的模型。
- 为每个 Agent 设置固定 ID 和开发职责。
- 从对应模型实际提供的等级中选择可选推理等级。
- 为每个 Agent 设置可选的最大输出 Token。
- 由主 Agent 负责需求、计划、分配、集成和最终验收。
- 每个 child 独占一个内聚任务和验收目标，避免主 Agent 重复实现。
- 按复杂度将非简单工作拆分为任意数量有意义、互不重叠且可独立验收的任务，避免人为制造或过度微拆。
- 每个独立任务创建新的 child，即使多个任务匹配同一 specialist；独立任务可在 runtime 容量内并发，文件、所有权或依赖交叉的任务串行。
- 运行中的 Session 保持启动时的 Agent 配置。

环境要求

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

安装

将插件安装到 DSH Web profile：

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

安装完成后重启 DSH Web，并刷新浏览器。Host 启动时，插件会自动预置并维护 Agent 预设，同时创建旧版 orchestrator 兼容 ID，使使用该 ID 的已有 Session 可以恢复，并从 Web 选择列表中隐藏使用官方显示名的兼容项。内容完全匹配官方旧版的无 marker preset 会被安全收编；经过自定义的用户 preset 不会被覆盖，改用不同名称时仍保持可见。

升级时，已有的超过 3 个 Agent 的配置会被完整保留。运行时先启用前 3 个，设置页继续显示完整列表，并要求在下次保存前缩减到 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 来消磨时间。running 表示 child 正在执行，必须等待；idle 或 ready 只表示当前没有活动轮次，不代表完成或卡死。只有 child 明确报告阻塞/死锁、依赖不可用、同一工具或执行错误连续两次，或两次状态检查都没有进展且存在未解决阻塞时，才可判定卡死。耗时、静默、不变状态、其他 child 已完成或主 Agent 准备结束，都不能单独构成卡死证据。只有用户明确取消、明确期限已经到达、有具体证据支持的真实死锁，或验证过的重复工具或执行失败才允许中断；中断前必须说明证据，只调用一次 interrupt_agent，随后用 list_agents 验证。interrupt_agent 只停止当前轮次、保留可继续 child，因此中断后显示 idle 或 ready 是预期行为，不应重复中断。主 Agent 不得在必需 child 仍运行或没有返回结果时结束；被中断或失败的 child 对应任务仍未完成，必须报告阻塞或重新规划。主 Agent 绝不能为了催要提前报告、缩短等待、重新取得控制权、开始集成或避免等待而中断，也不能仅根据运行时长或没有新消息推断死锁。send_message 只排队下一轮，不会改道当前工作。specialist 连续两次遇到相同工具或执行协议错误后，改用最简单的有效替代工具调用或报告阻塞，并避免继续发起失败或没有有效输出的重复调用。

Agent 配置项

| 配置项 | 必填 | 说明 |
| --- | --- | --- |
| Agent ID | 是 | 用于子 Agent 工具名称和逐 Agent 运行配置的稳定身份，例如 architect 或 reviewer。 |
| 模型 | 是 | 从 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
~~~

English

Overview

DSH Multi-model Orchestrator adds an Agent orchestration page to the DSH Web settings. You can configure up to 3 reusable specialist Agents, assign an existing DSH model to each one, and give each Agent a clear responsibility. These configured Agents are reusable specialist tools; the number of child tasks is determined by meaningful work and runtime capacity, not by the roster size.

When a session uses the Multi-model orchestrator preset, every configured Agent becomes an independent subagent tool that the primary Agent can delegate work to.
主 Agent 充当产品负责人和工程经理，而不是默认的开发者。对于非平凡的工作，它定义结果和验收标准，分解互不重叠的范围，并在实现开始前委派开发、调查、测试和审查。每个子 Agent 独占拥有一个内聚任务和验收目标，直到其完成；主 Agent 只协调互不重叠的工作，等待依赖项，集成返回的工作，并执行最终验收。真正微小的一步式变更可以留在本地处理。

功能

- 配置最多 3 个可复用的专家 Agent；在多个子任务中复用每个工具。
- 选择 DSH 中已有的模型。
- 为每个 Agent 提供稳定的 ID、开发范围和子 Agent 提示词。
- 从 Agent 模型所公布的精确级别中选择可选的推理强度。
- 为每个 Agent 设置可选的输出 token 上限。
- 让主 Agent 负责需求、规划、分配、集成和最终验收。
- 让每个子 Agent 独占拥有一个内聚任务和验收目标，使主 Agent 无法重复其工作。
- 按复杂度将非平凡工作拆分为任意数量的有意义、互不重叠的任务，并具有独立的验收目标，同时避免人为或过于细碎的拆分。
- 为每个独立任务创建新的子 Agent，包括多个任务使用同一专家的情况；在运行时容量内并发运行独立任务，并串行化文件、所有权或依赖重叠的任务。
- 让每个运行中的会话保持其启动时所用的 Agent 配置。

要求

- DeepSeek Harness 0.1.6-alpha.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 选择列表中隐藏官方名称兼容条目。完全一致的官方标记前副本会被安全采用；用户管理的自定义预设绝不会被覆盖，并在赋予不同名称时保持可见。

升级期间会保留超过 3 个 Agent 的现有设置。前 3 个保持活跃，设置页面继续显示完整名单，下次保存时要求将其缩减到 3 个或更少。

从源代码检出运行 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、开发范围和子 Agent 提示词。
5. 选择 DSH 中可用的模型之一。
6. 可选：选择该模型支持的推理强度，并设置最大输出 token 限制。
7. 保存配置。
8. 使用 Multi-model orchestrator 预设创建会话。

更改 Agent 名单或模型分配后，请创建新会话。已在运行的会话会保留其原始 Agent 配置。

在非平凡会话中，主 Agent 会先建立验收标准并分配开发任务，然后再进行编辑。它将配置的 Agent 视为可复用的专家工具，按复杂度将工作分解为任意数量的有意义、互不重叠且具有独立验收目标的任务，并避免人为或过于细碎的拆分。每个任务都会获得一个新的子 Agent，即使它与已用于另一任务的专家相匹配。独立任务在运行时容量内并发运行；在文件、所有权或依赖上重叠的任务串行运行。当主 Agent 执行开发时，合适的专家不会被闲置，但主 Agent 不会仅仅为了使用每个 Agent 而虚构工作。每个子 Agent 在返回前拥有一个内聚任务和一个验收目标；主 Agent 可以协调其他明确不相交的任务，但会等待，而不是实现相同的结果。对于同一任务的修正，它会复用可继续的子 Agent。专家返回后，主 Agent 会审查集成边界并运行最终验收检查。
可靠性行为：当没有独立工作剩余时，主 Agent 使用前台子调用，不会仅仅为了消磨时间而反复轮询 list_agents。running 表示子 Agent 正在执行，必须允许其继续；idle 或 ready 表示没有活动中的轮次，而不是任务已完成或已死锁。只有当子 Agent 报告阻塞或死锁、所需依赖不可用、同一工具或执行失败发生两次，或两次状态检查均显示无进展且存在未解决的阻塞时，才判定子 Agent 卡住。仅凭经过的时间、沉默、状态未变、另一个子 Agent 完成，或主 Agent 已准备好结束，都不足以判定。中断仅限于以下情况：用户直接取消、明确的截止时间已到、有具体证据支持的死锁，或经证实的重复工具或执行失败。在中断之前，主 Agent 需陈述证据，仅针对直接子 Agent，调用一次 interrupt_agent，然后检查 list_agents；中断会停止当前轮次，但保留可恢复的子 Agent，因此之后出现 idle 或 ready 是预期行为。当所需子 Agent 正在运行或没有返回结果时，主 Agent 绝不进行最终整合，并将被中断或失败的子 Agent 视为未完成的工作，需要提交阻塞报告或重新规划尝试。主 Agent 绝不为了请求提前报告、缩短等待、重新获得控制权、开始整合或避免等待而中断，也绝不根据持续时间或缺少消息推断死锁。send_message 会将下一轮次排队，而不会重定向当前工作。在同一个工具或执行协议错误发生两次后，专家 Agent 会切换到最简单的有效替代工具调用，或报告阻塞，并避免重复调用那些失败或产生无有用输出的调用。

Agent 字段

| 字段 | 必填 | 描述 |
| --- | --- | --- |
| Agent ID | 是 | 稳定标识，用于子 Agent 工具名称和每个 Agent 的运行时设置，例如 architect 或 reviewer。 |
| Model | 是 | 从 DSH 模型目录中选择的提供商和模型。 |
| Development scope | 否 | 当主 Agent 选择专家 Agent 时向其显示的简短路由摘要。它不决定 Agent 身份。 |
| Child Agent prompt | 否 | 发送给所选子 Agent 的专用角色提示。没有此字段的旧配置会回退到开发范围。 |
| Reasoning effort | 否 | 所选模型公布的精确推理强度级别之一；省略则使用模型默认值。 |
| Maximum output tokens | 否 | 限制 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 格式创建标签，并运行本地预检：

~~~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
~~~

许可证

MIT