HA Orchestrator

HA Orchestrator 是 DeepSeek Harness（dsh）的插件：

• 模型调用中途出错时，自动改用备用模型重试，任务继续跑下去。
• 提供一个 orchestrate 工具，模型遇到适合的任务会自己调用它，把工作拆给多个子智能体并行执行（fanout）、分阶段执行（pipeline），或进行评审/归约（supervisor、map-reduce、router）。

配置页里还能定义自己的子智能体（也可以一句话让 AI 生成）；界面和提示词文案支持中英文，跟随 DSH 语言。

English

扛住模型故障，并行推进复杂工作，把结果交付得更可靠。

HA Orchestrator 让 DSH 长任务在模型出错时继续运行，再把复杂工作拆成可观测、可恢复、可评审的并行子智能体流程。

🛡️ 模型故障不终止长任务	⚡ 复杂工作横向并行	✅ 结果可检查、可交付
备用轮换、冷却、Provider 熔断和恢复探测，避免单个模型故障拖垮任务。	五种编排模式覆盖并行调研、分阶段计划、路由、归约和监督评审。	预算、运行历史、resume、结构化输出和多评审者，让最终结果更可追踪。

特别适合： 深度调研、大型代码库阅读、批量审查、多方案对比和实现计划编排。

功能

模型失败自动回退

• 模型请求出错时，自动改用下一个备用模型重试，备用模型按顺序轮换。
• 出错的模型被暂时跳过（进入冷却），冷却结束后自动恢复使用。
• 支持突发窗口失败计数、Provider 级熔断、低成本恢复探测，以及可选的上下文超长降级。
• 每次故障有重试上限，用尽后停止重试，不会无限循环。
• 模型错误中断任务时，插件会把任务重新拉起一次，工作不丢失。

备用模型、冷却时间、失败阈值、错误码过滤都可以在 设置 →「HA 与编排」里调整。

编排工具（自动触发）

orchestrate 工具在所有会话中可用；工具说明和系统提示词里的引导会让模型在任务可并行、分阶段或需要评审时自己调用：

• fanout — 拆成子任务并行执行，再汇总结果。
• pipeline — 各阶段依次执行，上一阶段的输出作为下一阶段的输入。
• supervisor — 并行执行子任务后，由监督子智能体审查合并。
• map-reduce — 并行执行 map 任务，再由归约子智能体合并结果。
• router — 把候选任务交给一个路由子智能体，由它选择或安排后续工作。

工具还支持保存配方、按 runId 恢复中断任务、监督评审轮次、多评审者、单次子智能体调用预算、结构化输出 Schema，以及自定义子智能体的工具白名单/黑名单。子智能体默认不能再次发起嵌套编排。

如果某次没有自动编排，直接说"用编排"即可。

注意：如果当前会话使用 minimal / minimal-v3 这类 complete: true 人设预设，平台会按设计丢弃插件注入的系统提示词段落；此时自动触发仅靠 orchestrate 工具描述承载。插件已把“阅读大型项目”等触发条件写进工具描述，但若仍不触发，请直接说“用编排”。

不想让模型自动调用的话，可以在 设置 →「HA 与编排」→「系统」卡片里关掉上下文注入；之后在提示词里写"使用 dsh-ha-orchestrator 插件进行调用"即可手动触发。

子智能体默认不会获得这段上下文注入，避免子代理被引导再次发起编排形成层层外包；如需让子智能体也看到同一段上下文，可在「系统」卡片打开同时注入子智能体。

自定义子智能体

在配置页定义可复用的子智能体：名称、provider/模型、模型 effort、描述、系统提示词，以及可选的工具白名单/黑名单。每个角色还可以单独配置按顺序执行的 fallbacks 模型链，并为每个回退项写 provider/model@effort；启动失败或子智能体返回模型错误时，只切换该角色自己的回退链，不读取全局 HA 备用模型。任务按名称调用，模型随时可以查询清单；单个任务还可以指定输出要求或 object 根 JSON Schema（前提是 provider 支持）。「智能新增」按钮：一句话描述需求，由当前模型生成完整定义。

中英双语

配置界面和提示词文案支持中文、英文，自动跟随 DSH 语言设置；语言包加载失败时回退中文。也可以在「系统」卡片手动固定语言。

安装

需要：DeepSeek Harness（web profile）。发布包无需本地构建，运行时 peer 服务由 DSH 提供。

方法一：npm 一条命令安装（推荐）

本包已发布到 npm（包名 dsh-ha-orchestrator）：

1. 执行一条命令：

   dsh plugin --profile web add dsh-ha-orchestrator
   

2. 因为本包声明了 dsh.bundle.patch，dsh plugin add 会自动把 dsh-ha-orchestrator 加进 dsh.profile.bundles 并应用 cordis.patch.yml，无需手写组合行。

3. 无需重启：bundle patch 层会被热加载（Cordis HMR），插件在运行中的进程里直接生效。刷新浏览器页面即可看到配置页。插件同样随进程启动自动加载，重启后依然生效。

方法二：本地仓库安装（开发用）

用于开发或测试未发布版本。需要 PATH 里有 pnpm：

1. 执行一条命令：

   dsh plugin --profile web add "file:<本仓库绝对路径>"
   

2. 因为本包声明了 dsh.bundle.patch，dsh plugin add 会自动把 dsh-ha-orchestrator 加进 dsh.profile.bundles 并应用 cordis.patch.yml，无需手写组合行。

3. 无需重启：bundle patch 层会被热加载（Cordis HMR），插件在运行中的进程里直接生效。刷新浏览器页面即可看到配置页。插件同样随进程启动自动加载，重启后依然生效。

方法三：手动安装（无需 pnpm）

1. 把本仓库复制到 DSH profile 的 node_modules 下：~/.dsh/profiles/web/node_modules/dsh-ha-orchestrator

2. 在组合文件 ~/.dsh/profiles/web/cordis.patch.yml 中加入：

   - insert:
       - id: dsh-ha-orchestrator
         name: dsh-ha-orchestrator
   

3. 无需重启：profile 的 patch 层会被热加载（Cordis HMR），插件在运行中的进程里直接生效。刷新浏览器页面即可看到配置页。插件同样随进程启动自动加载，重启后依然生效。

版本说明： v0.1.0 是上一代动态版（经 cordis_define 按会话加载），仅作功能预览；从 v0.2.0 起为静态插件，随 DSH 启动自动加载。从引入 bundle patch 的版本起，推荐使用方法一（一条命令安装）安装。

用法

日常使用无需特殊指令，模型自己决定何时编排：

…