自动开发调度器 AngleZhang-ZhangJiao/dsh-orchestrator2

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

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

当前版本：v2.10.1（2026-10-13 发布）　|　相对上版 v2.10.0 的差异：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 修复包前置／收尾门禁 ⓪ 步）＋验收结论模板同步；原子升版（五处版本载体 + 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.1 实测于 DSH web 版与桌面版（Electron，desktop profile）　|　规范：项目目录及协同开发规范 v2.1（六区结构，本文档 v2.1.6）

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

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

| 版本 | 日期 | 更新摘要 |
| v2.0.0 | 2026-09-11 | 首个 2.0 插件包：协同开发规范 v2.0（五区结构）+ 模板 23 件；orchestrator2 预设四角色（调度员/研究员/审核员/开发员）钉模型；phase-gate v2（24 轮上限 + 四句开工校验）；budget.mjs token 纯统计；使用手册 |
| v2.1.0 | 2026-09-14 | 规范 v2.1（六区 + 历史归档区）+ 模板 39 件；新增两大场景：修改已有系统（场景1：现状研究中+目标代码区）与技术调研储备（场景2：独立终态不进开发） |
| v2.1.1 | 2026-09-15 | 可靠性加固：状态头「规范版本」fail-closed；dispatch_begin/end/status 派工原子半步（预算派工前拒绝 + 写锁 + 台账预登记/回填 + 悬空识别）；enter_auto_mode 幂等守卫（预设层）；设计冻结哈希清单（设计基线.json 篡改即拒） |
| v2.1.2 | 2026-09-15 | 默认模型配置：三子代理钉 {provider, model, reasoningEffort}（研究员 deepseek-flash·max / 审核员 k3-256k·max / 开发员 kimi-for-coding·high）；调度员推荐 kimi-coding/k3·max（preset 层不声明会话模型）；lib 源化 |
| v2.2.0 | 2026-09-16 | 计划质量（SP-TP-A1）：任务包改动点「消费/产出」接口契约（含修复包变体）；计划审核第 4 项 = 跨改动点冲突扫描；派工材料分层（prompt 五要素、权威材料入库）；授权合并——设计确认即开发授权、测过自动放行下一包；#32 三角色模型配置提示移至定稿时 |
| v2.3.0 | 2026-09-16 | 修复质量 + 调度可靠性（SP-TP-A2/TP-B）：修复包 T0 根因→T1 RED→T2 GREEN→T3 回归证据链；验收「无证或不可证伪驳回」；代码审查 loadBearing 承重标注；P1-8 审核纪律。机器层：台账 schema v2（身份行+六新列）、runId 精确结算、派工返回六态、dispatch_status 恢复建议、旧台账 v1→v2 迁移、故障注入五项入回归 |
| v2.4.0 | 2026-09-17 | 运行安全（TP-C）：派工三问裁定（写不出不点火）+ 三条强原则 + 尺度感锚点；开发员五条刹车纪律 + 心跳（「上报是合格交付，死磕是失败」）；审核员计划审核第 5 项判断题；看门狗（B/C 后台派工 + 轮内 tick + 两指纹 + L0~L3 纠偏）；孤儿接管；02 模板判断式引导（不甩手册、先裁决后部署）。机器层零改动（同日被 v2.4.1 取代） |
| v2.4.1 | 2026-09-17 | 验收期清偿（TP-C-修复1）：banner 与规范口径如实化（后台派工+看门狗轮内 tick）；M3 三字段=预留不回写、幂等接线另立项（去虚假机器承诺）；三问裁定补来源约束（答案出自任务包 02 与既有材料，不得现场读码勘察）；规范 v2.1 两处句改（行 256/§4 行 291）。机器层零改动 |
| v2.5.0 | 2026-09-25 | 跨项目复盘文本层沉淀（TP-D1）：persona 瘦身重组（prefix 41,651→39,074B）；小包 B 档位 4→6（规范 §4.1 经生成器升 v2.1.1）+ 触顶放弃驳回简报条款；开发员证据采集三义务；审核员驳回修复边界默认条款；任务包环境前置核查（02 模板「环境事实清单」节 + 审核第 5 项「未验证」核查）。机器层零改动 |
| v2.6.0 | 2026-09-27 | TP-D2 合并测试正式语义与宿主 0.1.7 适配：快速通道与欠账四形态口径、规范 v2.1.2 §4.5、模板四件同步、workflow-ptc 引擎配对护栏、声明式预设生成件与 dump-config 更新前体检；移除已下线的 workflow-worker-thread 条目。机器层行为不变。 |
| v2.6.1 | 2026-09-28 | TP2-SpecKit 证据裁决口径落地：AC 证据等级/逐项状态列、修复包澄清与根因/扩围/上游指针、场景2裁决与反证门槛、版本护栏与声明件同步；安装包、zip、注册和 web --dump-config 体检完成。 |
| v2.7.0 | 2026-10-02 | T3 子代理模型路由与会话覆盖：三角色默认/降级持久路由（DSH_HOME JSON 现读）、429/额度自动降级（G1 独占/一次切换/终局传播/不吞取消）、会话临时改模与显式永久配置（set/reset/inspect 嵌套 route）；官方钉模型注册行替换为插件自持派工（先绑定后派工）；同日被 v2.7.1 取代 |
| v2.7.1 | 2026-10-03 | T3-TP1-修复1：组合树挂载被拒修复（两纯库模块补空 apply 空载——cordis registry.plugin() 拒绝无 apply 模块 → never started → 预设挂载被拒）；config-check 新增 T3h 本地模块行 apply 导出断言（含检红夹具）防回归；注册与更新前体检双 profile（web+desktop）覆盖 |
| v2.8.0 | 2026-10-08 | T4 对话形态纪律（i-have-adhd 深化）：persona 新增【对话形态纪律】——人读消息 answer-first/结尾唯一下一步/首尾双问/分组 ≤5 证据全保留/时间具体单位+错误三件套；提问纪律与过程消息一行制；不采用项成文；套件 524→529/0；源码侧声明件漂移（D-J1）清偿。机器层零改动 |
| v2.9.0 | 2026-10-08 | 引导 首次使用引导：persona 新增【首次使用引导】（新会话首消息探查后告知缺项）＋ enter_auto_mode 开发准备门禁（fail-closed 五条件）＋ 开发准备.md 模板（规范 v2.1.4，§4.6＋§十索引 40 件）＋手册首次使用节；套件 529→540/0；D-J1 随升版清偿 |
| v2.10.0 | 2026-10-11 | 归集/TP1-模板目录归集：四区 21 件按任务复制模板归集入各区 _模板/ 子目录，区根只留正式文件；三级复制源回退成文（老项目不强制整改）；规范 v2.1.5（生成器 31 op，§2.2 树 + §10 索引 + 散文面指针同步）；测试六套件同步 + 21 条旧平铺位防回归断言；原子升版（五载体+常量族同 commit）；套件 540→561/0。机器层零改动 |
| v2.10.1 | 2026-10-13 | codegraph 闭环强制同步（用户指令）：任何任务包（含修复包）置「已完成」前调度员机械执行 codegraph sync——无条件、不分内外层、改了什么更新什么；验收结论增「codegraph 同步」记录行；收尾门禁 ⓪ 步兜底；不可用时降级如实标注。规范 v2.1.6（生成器 CG-A~F 六 op）；persona 四处同源 + 验收结论模板同步；套件 561→561/0；机器层零改动，不新增状态/环节/角色 |

安装

本仓库为发布镜像（只含最新版本）。安装包：05-交付/安装包/dsh-orchestrator2-v2.10.1/（或同名 zip 解压到本地目录后按目录安装）。

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

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

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

1. 打开桌面版插件管理界面（设置 → 插件），添加/更新插件，方式选「本地目录（link）」，指向 …/dsh-orchestrator2-v2.10.1 包目录；
2. 若界面不可用或需脚本化，可用手工三件套（操作前备份原文件）：① 改 profiles/desktop/package.json 的 link 依赖行指向新包目录；② 同步 pnpm-lock.yaml 对应两行；③ 把 node_modules/dsh-orchestrator2 junction 重指到新包目录。

两端通用：装完完全退出并重启（桌面版注意先退出托盘进程，避免旧实例占端口）；新建会话在预设选择器选「自动开发调度器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 移除，勿再用。

仓库结构（发布镜像：源码 + 最新交付物 + 安装位子包）

| 路径 | 内容 |
| 02-代码/orchestrator2/ | 2.0 预设工程源码：persona（agent.cordis.yml）/ 规范 v2.1 与 40 件模板（四区按任务模板收 _模板/ 子目录）/ dispatch.mjs 机器层 / model-routes 等路由四模块 / tests 回归套件（561 断言） |
| 05-交付/安装包/dsh-orchestrator2-v2.10.1/ | 当前安装包（61 件：presets/spec/lib/docs + 测试入口说明 + LICENSE + package.json） |
| 05-交付/安装包/dsh-orchestrator2-v2.10.1.zip | 同名压缩包（下载即用） |
| plugins/dsh-orchestrator2/ | 安装位子包（不带版本号，随发版原地刷新）：dsh plugin add 源码安装与插件市场（dsh-market）从这里装，内容为当前安装包镜像 |

设计文档、开发过程记录、历史版本安装包与本地开发历史不在本镜像（发布口径）。规范 v2.1 六区结构中的其余各区（00 项目管理/01 设计/03 开发协同/04 测试）属开发侧材料，不公开发布。

文档入口

- 使用手册（最新）：05-交付/安装包/dsh-orchestrator2-v2.10.1/presets/orchestrator2/docs/使用手册.md
- 协同开发规范 v2.1：02-代码/orchestrator2/spec/项目目录及协同开发规范-v2.1.md
- 插件工程说明：02-代码/orchestrator2/README.md
- 安装后实测指引：05-交付/安装包/dsh-orchestrator2-v2.10.1/测试入口说明.md

License

MIT（许可文本见 plugins/dsh-orchestrator2/LICENSE）。本插件 persona 含两处外部形状借鉴并已注明出处：ponytail（MIT, © 2026 DietrichGebert，最小实现七档阶梯）、i-have-adhd（MIT, © 2026 Ayoub Ghriss，对话形态纪律）。