任务编排器 hasan-aghayev/dsh-task-orchestrator

DSH Task Orchestrator

使用指南 · 升级到 1.2 · 从 1.0 升级 · 发布验证

父模型先写好 TODO 计划并分配任务，再启动相互隔离的 worker。默认最多用两条模型流跑独立工作；多出来的任务在依赖感知队列里等待。父模型会收到结构化结果、缺数据请求和最终评审。简短问题走普通的单智能体路径。

作者：Hasan Aghayev · 许可证：MIT

执行

1. 遇到大块工作，父模型要给 task_orchestrate 提供明确的 plan。每个任务都有唯一的 id 和 owner，还有目标、角色、依赖和读写策略。初始 worker 任务里至少有两个必须相互独立。必需的 reviewer 依赖所有 worker，并占用一个普通任务槽位。
2. 插件先校验完整任务图，再写入原生 TODO，然后才创建第一个子任务。简短问题不需要团队。复杂度检测器只补充规划指令，绝不根据关键词构造或执行任务图。
3. 就绪任务在全新的 spawn 上下文里运行。子任务只拿到分配给自己的数据包、压缩后的依赖报告，以及明确提供的额外数据。只读子任务拿到的是真正的工具白名单。输出预留量会成为子任务的 maxTokens 设置。
4. 默认最多同时跑两个逻辑子任务。一个子任务结算后，立刻为下一个就绪任务腾出槽位。另有共享调度器统计实际模型流数量，父模型也算在内。新请求和已活跃请求的限制同时生效。大上下文可以单独运行。等待过久的请求能预留容量，免得后来的小请求一直插队。
5. 每次原生 todo/write 快照都包含 TODO 列表和带版本号的插件检查点元数据。检查点保留分配、尝试次数、子任务身份、报告和原因。恢复时已完成任务保持完成；崩溃中断的子任务标记为等待，如果它仍然存活就不会重复创建。
6. NEED_FILE、NEED_HISTORY、NEED_BUDGET 等需求会返回给父模型。没有新数据，或者没有明确修正未完成的任务数据包/预算，就不会自动重试。只有所有任务都成功、且必需评审通过，一次运行才算完成。

安装

版本 1.2.1 面向 DSH 0.2.1 API 系列，并已针对 0.2.1-rc.2 做过激活测试。支持的主机范围是 >=0.2.1-rc.2 <0.2.2。把带版本号的发布包安装到 DSH 配置档：

dsh plugin --profile web add https://github.com/hasan-aghayev/dsh-task-orchestrator/releases/download/v1.2.1/dsh-task-orchestrator-1.2.1.tgz

把 web 换成你自己的配置档名。同一条命令也接受本地构建的 tarball。要从默认分支安装最新源码，用：

dsh plugin --profile web add https://github.com/hasan-aghayev/dsh-task-orchestrator.git
cordis.patch.yml 提供 task-orchestrator-suite 分组和配套的委派工具。编排器直接使用子代理服务；配套的工作流组件不是它的执行引擎。配置和组件启用仍由配置档负责。如果套件和编排器在 Plugins 中处于禁用状态，请启用它们。更新已安装的包后重启 DSH，让 Host 加载新的配置字段。

配置

config:
mode: hybrid
subagentProvider: spawn
minParallelTasks: 2
preferredWorkers: 2
maxWorkers: 6
maxTotalAgents: 6
maxConcurrentAgents: 2
maxActiveGenerations: 2
maxChildStarts: 12
maxAttemptsPerTask: 2
requireReview: true
allowWrites: false
allowParallelWrites: false
hardContextTokens: 65536
totalContextTokens: 98304
contextCompactionChars: 4096
maxPlanningReminders: 2
scheduledProviders: []

maxWorkers 和 maxTotalAgents 限制逻辑任务数，评审也算在内。maxChildStarts 单独限制启动次数和显式重试次数。preferredWorkers 是规划时的参考值；minParallelTasks 校验初始独立任务数。产出不同且有用的结果，是父级的责任。

默认的 concurrencyByContext 允许两条流在估算输入 token 不超过 49,152 时并行，超过这个大小则只允许一条流，上限 150,000。并发上限取当前活跃请求中最小的那个，新来的请求也受它约束。hardContextTokens 守住估算输入；totalContextTokens 统计活跃流上的估算输入、预留输出和安全余量。每个本地编排子级还各自持有分配到的整请求 contextBudget。请求选项省略 maxTokens 时，defaultOutputReserveTokens 预留 2,048 个输出 token；请求没有任务专属预留时，requestSafetyReserveTokens 再预留 1,024 个 token。这些估算不测量 VRAM，也不替代服务商的 tokenizer。

scheduledProviders 为空列表时，本进程内所有 LLM 路由都会参与调度。把它设为本地服务商注册的名称，就能让云端路由留在本地共享队列之外。子级仍保留任务级输出上限。子级上下文的硬性检查要求进程内 spawn 执行；远程运行时需要自己对应的资源策略。

mode: off 关闭自动规划指令和守卫，但保留显式工具。suggest 先要求保存计划；已有的人工授权允许执行。hybrid 和 auto 指示父级在现有授权范围内规划并执行实质性工作。请求确认的计划，以及未授权的写任务，返回 plan-only。有界提醒策略在必需的计划始终未保存时报告失败。
Web 端 Settings → Task Orchestrator 页面可以编辑全部三个角色的模型与推理、规划模式、活动任务槽、逻辑任务数、最终审查、共享模型流，以及两个上下文预算。高级控制项可以编辑上下文/并发范围、子任务启动总数和每个任务的启动数。数值型上下文输入框保留精确的已保存值；滑块以 1,024 token 为步长。填 0 会关闭对应的全局上下文检查，但任务预算和并发限制仍然生效。组合冲突时 Save 会禁用。默认值操作只把双 worker 设置暂存到表单，不会自动保存，并保留模型分配。

一次原子、带修订栅栏的 Save 只改动配置档中编辑过的字段。被拒绝时草稿保留；Host 修订更新时要求 Reload。结果通知显示在 shell 中，关闭 Settings 后仍然存在。新任务运行会快照其执行策略；活动运行保持该策略。模型流读取当前请求限制。排队中的请求遵循最新的共享/全局限制和更紧的上下文上限；调低限制不会取消活动流。更新已安装的插件包后，需要重启 DSH 才能加载新的 Host schema。

模型与推理

在 Settings 中选择 Orchestrator model、Worker model 和 Reviewer model，然后为每个模型选择推理级别并 Save。模型按注册的 LLM 服务商分组。级别来自 DSH 的模型目录；没有固定的 effort 列表，对未声明可调推理的模型也不提供推理控制。切换模型会清空之前的 effort。Model default 不写显式 effort，改用所选模型的服务商默认值。

| 角色 | 模型字段 | 推理字段 | 未分配模型时的继承行为 |
| Orchestrator | orchestratorProvider、orchestratorModel | orchestratorReasoningEffort | 沿用当前聊天选择和推理。 |
| Workers | subagentLlmProvider、subagentModel | subagentReasoningEffort | 继承父级的有效选择和推理。 |
| Reviewer | reviewerProvider、reviewerModel | reviewerReasoningEffort | 继承 worker 的选择和推理。 |

这些字段在配置档 YAML 中都是普通字符串。空字符串表示：模型/服务商字段走继承，显式分配的模型其 effort 走模型默认值。父级或 reviewer 的分配要求同时提供 provider 和 model。旧版 subagentModel 不带 subagentLlmProvider 仍然支持，会继承父级的 provider。subagentProvider: spawn 选择子任务执行服务，subagentLlmProvider 选择 LLM 路由。
新会话启动时，Web 父级使用 DSH 原生模型选择器，因此保存的模型和推理设置会立即出现在新聊天中。首次响应前手动选择的模型或推理设置会保持选中。保存的父级分配在其模型/effort 设置变更后同样生效。原生选择器把选择记录到会话中，并更新 DSH 的默认模型，供后续聊天使用。清除保存的分配会保留当前聊天的选择。无头配置档使用 DSH 的作用域模型选择辅助工具。两条路径都保持提示词中的模型信息与实际请求路由一致，包括异步组装期间所做的更改。

每次工具调用只捕获一次工作器和审查者选择，包括显式恢复。该调用中活跃的子代理和剩余排队任务沿用捕获的选择。显式分配不带 effort 时，即使指定的模型与父级相同，也会清除继承的推理设置。实际请求头记录服务商、模型和解析后的 effort。不可用或不支持的选项会经 DSH 的校验失败；插件不会静默替换模型。

刷新模型会重新加载原生目录。发现失败时保留已保存的选择和其他暂存编辑。已存储但不可用的分配仍然可见，可以清除；无关的队列设置仍可保存。表单会用成功加载的目录校验新编辑的分配。模型必须已在 DSH 配置档中配置；在此处分配并不会安装或加载本地模型服务器。

工具字段

task_orchestrate 需要 objective 和 plan。plan 包含 summary、risk（low、medium 或 high）、requiresConfirmation 和 tasks。可选工具字段有 planOnly、executeWrites、maxWorkers、runId 和 resumeContext。executeWrites 必须反映已有的人工授权，不能创建授权。参见完整的只读示例。

每个 plan 任务都需要 id、title、owner、role、prompt、dependsOn、readOnly 和 writeScopes。可选的 taskPackage 携带相关上下文、事实、文件、约束和预期输出。默认值为 contextBudget: 24576、outputReserveTokens: 2048、safetyReserveTokens: 1024。支持的角色：researcher、architect、backend、frontend、tester、documentation、reviewer。

用 resumeContext: { taskId: "new information" } 恢复返回的 runId。你也可以修改未完成任务的预算或数据包。分配、目标、依赖和写权限必须保持不变；已完成任务的输入在复用其证据时不能更改。仅因依赖而阻塞的任务，在依赖成功后变为就绪。出错和取消时，部分结果仍会记录。
原生 TODO 使用三种状态：queued/waiting/failed 任务保持 pending，并附带原因；active 任务正在进行；successful 任务已完成。完整任务状态和报告保存在同一个已保存事件里。面向父级的文本和完整依赖摘录受配置限制；完整检查点数据仍可在会话日志中获取。

开发与验证

corepack pnpm@12.4.1 install --frozen-lockfile
corepack pnpm@12.4.1 check
corepack pnpm@12.4.1 test
corepack pnpm@12.4.1 build
corepack pnpm@12.4.1 pack

开发和 CI 环境使用 Node.js 24 与 pnpm 12.4.1。运行时要求 Node.js 22.19 或更高版本。包不锁定配置档的包管理器；DSH 负责管理配置档安装。

测试用屏障控制子进程的结束时机，并跑通 DSH 实际生产循环、真实 spawn 服务商、原生 TODO 和脚本化模型适配器。测试验证以下内容：服务商/模型/effort 分别指定、路由记录、上下文隔离、两条 active 通道、队列补充、只读拒绝、输出限制、硬性任务预算拒绝、数据缺失时恢复、中断运行恢复、取消和审查者批准。脚本化适配器无法证明真实本地模型的可靠性或硬件吞吐。

宿主 JavaScript 和浏览器设置模块构建到 lib/；声明文件在 lib/types/。验证报告 记录各项检查及其局限。替换 1.0.x 安装前，请先阅读升级指南。

限制

Worker 共享同一个工作区；插件不创建工作树。声明的写入范围可防止已声明的写入者重叠，并引导提示词，而文件系统权限仍由配置档负责。并行写入默认关闭。只读约束依赖配置的读工具允许列表。词法检测器可能漏掉简短的困难请求；父级可以显式调用工具。报告压缩是有界文本，不是语义摘要。插件不监控 GPU 内存。