dsh-orchestrator2

自动开发调度器（dsh-orchestrator 系列）

DSH agent preset 插件：单会话双态——先以调度员身份与你交互完成产品设计（并行研究员调研 → 方案 → 决策清点 → 定稿），一句确认后切换为调度引擎，goal 驱动自动推进开发流水线（审核员计划审核 → 开发员执行自测 → 审核员 AC 证据核验+代码审查 → 调度员构建），推进到「待人工测试」硬停止等你实测；验收阶段走修复循环（T0~T3 证据链）。

当前版本：v2.10.3（2026-10-21 发布，DSH 版；Codex 版 v2.9.0 于 2026-10-10 首发，见「安装」节 Codex 版段）　|　相对上次发布 v2.10.2 的差异：派工持久化——v2.10.2 紧急适配（单向硬切 startActivation）的三个遗留洞补齐：① role-tools.mjs 改双 API 能力探测（导出纯函数 resolveStartApi：startActivation 优先、0.2.0 旧宿主自动回退 startContinuable，皆无则报错列出宿主实际能力键），插件在 0.2.0/0.2.1 两种宿主下都能点火；② inspect_role_models 输出头部新增「宿主派工能力」探测行（DSH 升级后两分钟可自查，异常降级不阻断主输出）；③ 清除死配置 backgroundMode: continuable（0.2.1 下本不生效的休眠配置，两 yml 全文零残留+套件防回潮断言）；④ 手册新增「DSH 升级后两分钟冒烟」节；⑤ 原子升版 v2.10.3（七件）。套件 565→574/0（+9 断言，T9 双变异打红验证）；机器层零改动（dispatch/phase-gate/budget 一行未动）。0.2.0 回退路径为套件保障、未真机实测（手册如实标注）。此前 v2.10.2 为 DSH 0.2.1 兼容适配——宿主把子代理启动 API 由 ctx.subagents.startContinuable 重构为 startActivation，0.2.1 下三角色派工「点火即挂」；该版把 role-tools.mjs 内部启动调用适配到新 API（spec 顶层 delivery:'parent'、request 去重复 label、signal 留在顶层），三角色工具名/参数/返回契约（{kind:'continuable', subagentId}）与「先 bindChild 再启动」全部不变；测试 mock 同步并为运行期 spec 参数语义新增 4 条断言（附四项失败反例取证），套件 561→565/0；原子升版 v2.10.2（五载体 + pkg-consistency 常量族 + 生成镜像）；机器层零改动。此前 v2.10.1 为 codegraph 闭环强制同步——每次任务完结必须更新代码图谱成硬规则：任何任务包（含修复包）置「已完成」前，调度员在项目根机械执行 codegraph sync，无条件、不分内外层、改了什么就更新什么；未同步不得关闭，验收结论.md 增「codegraph 同步」记录行，关卡3 收尾兜底再同步一次（用户指令 2026-10-13）；规范升 v2.1.6（§六 新增第 7 条闭环门禁 + §六 第 4/6 条与 §2.4 挂引用，经生成器 CG-A~F 六个 op 落地、--check 逐字节校验）；persona 四处同源（A1 连跑前置 sync／新增闭环段／P2-1 修复包前置／收尾门禁 ⓪ 步）＋验收结论模板同步；t2-persona 字节预算 48→49 KiB 显式抬升；原子升版（五处版本载体 + pkg-consistency 常量族同候选 commit 切换）。套件 561→561/0（断言数不变）；机器层零改动（dispatch/phase-gate/budget 零改动，不新增状态/环节/角色）。 宿主要求：建议 DSH 0.1.7-rc.2 起（0.1.7 声明式预设机制：包内 presets/agent-preset.patch.yml 自动生成预设声明层，无需手工处理）；v2.10.3 实测于 DSH 0.2.1（web 版与桌面版，Electron，desktop profile）　|　规范：项目目录及协同开发规范 v2.1（六区结构，本文档 v2.1.6）

版本与能力速览（v2.10.3）

• 派工持久化（v2.10.3 新增）：子代理派工跨宿主健壮性——resolveStartApi 双 API 能力探测（startActivation 优先、0.2.0 旧宿主回退 startContinuable，皆无报错列实际能力键）；inspect_role_models 首行「宿主派工能力」自查行；死配置 backgroundMode: continuable 清除+防回潮断言；手册「DSH 升级后两分钟冒烟」节；套件 565→574/0
• DSH 0.2.1 适配（v2.10.2）：宿主把子代理启动 API 由 ctx.subagents.startContinuable 重构为 startActivation——本版适配该调用（spec 顶层 delivery:'parent'、request 去重复 label、signal 留顶层），0.2.1 下三角色派工恢复；三角色工具名/参数/返回契约与「先 bindChild 再启动」不变；测试增 4 条运行期 spec 语义断言（附四项失败反例），套件 561→565/0
• codegraph 闭环强制同步（v2.10.1 新增）：任何任务包（含修复包）置「已完成」前，调度员机械执行 codegraph sync（不分内外层、改了什么更新什么）；未同步不得关闭，验收结论留同步记录行；收尾兜底再同步；codegraph 不可用按降级口径如实标注，不伪造——图谱始终是最新单一事实源
• 模板目录归集（v2.10.0）：脚手架四区「按任务复制用」模板 21 件收进各区 _模板/ 子文件夹，区根不再平铺混杂；三级复制源回退（项目内 _模板/ → 旧平铺位 → 预设包 spec/templates）老项目无损；规范 v2.1.5
• 三阶段工作流：交互态设计（grill-me 决策清点开场问档）→ goal 驱动单包开发（一次授权多包连跑，五态流水线）→ 验收修复循环（含审核员修复审查）
• 两类任务场景：新产品全流程 / 修改已有系统（场景1：现状研究中+目标代码区约束）；另有技术调研储备（场景2，独立终态不进开发）
• 首次使用引导与开工门禁（v2.9.0 新增）：新会话首次对话先探查后告知（插件级 3 项＋项目级 6 项，只列缺失/未验证项，零副作用）；按需授权逐项补齐；enter_auto_mode 开发准备门禁 fail-closed（00-项目管理/开发准备.md 记录不齐即拒并列缺项）；远程仓库/测试服务器允许「不适用」须写理由，codegraph 不自动降级
• 对话形态纪律（v2.8.0 新增）：全部人读消息 answer-first + 结尾唯一下一步 + 首尾双问自检 + 分组 ≤5（证据优先于简洁）；提问纪律（一次一决策点/选项 ≤4 推荐置顶/优先卡片提问）；过程消息一行制；不采用项成文（状态.md 唯一真源不散文重述／不删限定词／证据·债务清单不设条数上限／输出更短非目标）
• 子代理模型路由与会话覆盖（v2.7.0 新增）：每角色默认+降级双槽路由（持久配置现读、原子写、不落在预设同步树）；429/额度类错误自动切降级（G1 硬闸门：插件独占先于宿主重试，不消耗默认模型重试预算；降级失败即停不循环；非适用错误不误降级）；会话临时改模（缺省仅当次主会话、epoch 隔离、在跑 child 快照不受影响、压缩不丢）与显式永久改默认/降级（原子保存、新派工即生效）；「仅下一次」一次性语义明确拒绝不落状态
• 挂载防回归（v2.7.1）：delegation 组本地模块行必须导出 apply 的装配断言（config-check T3h，含缺 apply 夹具检红演算）；注册与更新前体检双 profile 覆盖（web 走 CLI、desktop 走 Electron 管理）
• SpecKit 证据裁决口径（v2.6.1 起）：AC 证据核验表「证据等级/逐项状态」列；修复包未决澄清闸门、根因初判、正当扩围第三态、上游指针；场景2 裁决三态、反证强制与 ASSUMPTION 标记
• 运行安全三层机制（v2.4.x）：派工生成三问裁定；开发员五条刹车纪律 + 心跳；看门狗（B/C 后台派工、调度员轮内 tick 值班，L0 观察→L1 steer→L2 中断→L3 停机）；恢复轮孤儿接管；审核员计划审核第 5 项判断题
• 调度可靠性机器层：预算台账 = 环节级 WAL/结算账本（schema v2 身份行 + runId/attempt/派工前阶段/结算后阶段/candidateCommit/evidencePath 六列）、runId 精确结算、派工返回六态（DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED/FAILED/INTERRUPTED）、dispatch_status 四方一致检查+续跑建议、旧台账 v1→v2 迁移、故障注入五项回归套件
• 质量闸门：任务包改动点「消费/产出」接口契约 + 计划审核跨改动点冲突扫描；验收「无证或不可证伪即驳回」；修复包 T0 根因→T1 RED→T2 GREEN→T3 回归证据链；代码审查 loadBearing 承重标注；P1-8 审核纪律（不机械重跑/选择性复验/证据缺失驳回）
• 预算纪律：按包分档三硬上限（小包 4/6/24、大包 8/8/48，派工即计次），token 纯统计、无费用概念
• 与 1.0（orchestrator）并存不替代：两插件各自独立，按会话独占加载

版本沿革（自 v2.0.0）

安装

本仓库含两个宿主版本（同一套调度器方法学的两套实现，各自独立安装、互不影响）：

DSH 版（装到 DSH）

远程仓库为发布快照（只含最新版本）。

web 版（dsh web，profile=web，CLI 一条命令）：

dsh plugin --profile web add link:/路径/dsh-orchestrator2-v2.10.3

桌面版（Electron，profile=desktop，由应用专属管理，CLI 写入会被拒 managed exclusively by the Electron application）：

1. 打开桌面版插件管理界面（设置 → 插件），添加/更新插件，方式选「本地目录（link）」，指向 …/dsh-orchestrator2-v2.10.3 包目录；
2. 若界面不可用或需脚本化：参照 05-交付/T3-TP1-子代理模型路由与会话覆盖/构建记录-20261002.md §八 的手工三件套——改 profiles/desktop/package.json 的 link 依赖行 + pnpm-lock.yaml 两行 + node_modules/dsh-orchestrator2 junction 重指（操作前备份原文件；本仓库 v2.10.0/v2.10.1/v2.10.2/v2.10.3 桌面版即以此方式装机）。

两端通用：装完完全退出并重启（桌面版注意先退出托盘进程，避免旧实例占端口）；新建会话在预设选择器选「自动开发调度器2.0」。重启前建议体检：node "$env:APPDATA\npm\node_modules\@deepseek-ai\dsh\lib\bin.js" web --dump-config——① 组合树含 preset-orchestrator2；② 零死引用；③ 注册指向新包。详见包根 测试入口说明.md 与 presets/orchestrator2/docs/使用手册.md。

注：0.1.7 起预设走声明式机制（包内 presets/agent-preset.patch.yml 在宿主启动时自动把预设声明进组合树）；旧版「裸目录拷贝到 ~/.dsh/.agent-presets」方式已随 0.1.7 移除，勿再用。

Codex 版（装到 Codex）

1. 把交付包内层目录 codex-auto-development-orchestrator2-v2.9.0/codex-auto-development-orchestrator2/（或 zip 解压后的同名目录）复制为个人插件目录 %USERPROFILE%\plugins\codex-auto-development-orchestrator2\；
2. 在 Codex 桌面版插件管理中启用（UI 名「自动开发调度器 · Codex 版」，插件 ID codex-auto-development-orchestrator2@personal）；与旧插件 codex-auto-development-flow 不互相覆盖，试用期只启用一个 Codex 调度器；
3. 重启 Codex，新会话输入 $codex-auto-development 触发；用法见包内 skills/codex-auto-development/SKILL.md 与 docs/人工测试指南.md；可选角色模板在 templates/agents/（复制到项目 .codex/agents/ 使用，勿整目录覆盖）。

Codex 版 2.9.0 于 2026-10-10 首发（同步 DSH v2.9.0 能力：派工可靠性/质量证据/运行安全/预算/模型路由/首次使用与文档纪律），当前待用户实测验收——版本号不表示验收已通过（验收状态见 03-开发协同/CDX2-Codex自动开发调度器2.0/状态.md）。

仓库结构（规范 v2.1 六区）

历史资料与旧版本不在本远程仓库（发布口径：不含历史版本/原型/内部文档）；本地开发历史同理不推。

文档入口

• 使用手册（最新）：05-交付/安装包/dsh-orchestrator2-v2.10.3/presets/orchestrator2/docs/使用手册.md
• 协同开发规范 v2.1：00-项目管理/项目目录及协同开发规范.md
• 项目看板（任务全景）：项目看板.md
• 最新构建与体检：05-交付/TP2-派工持久化/构建记录-20261020.md（v2.10.3 构建：套件 574/0、全树 diff 恰 9 件预期差异、AC4 手册三副本哈希一致、pkg-consistency 12/0、双 profile 三处同改）；上一构建：05-交付/TP1-适配DSH0.2.1/构建记录-20261020.md（v2.10.2，套件 565/0）