merge: roadmap 重整为批次执行制——里程碑补齐+当前位置+三里程碑九批序列+执行纪律(一批一loop)+loop 规范八件+维护纪律修路径

roadmap.md

@@ -1,34 +1,75 @@
-# 工程路线图（里程碑时间线 + 下一步顺序）
+# 工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范）
 
-> 一句话：项目级进度视图——走到哪了、接下来按什么顺序走。**实时状态以 `production/session-state/active.md` 顶部「当前状态快照」节为准**（会话级、高频更新）；本文件是批级视图，里程碑移动才更新。
-> 成文：2026-09-17。
+> 一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。**实时状态以仓库根 [active.md](active.md) 顶部「当前状态快照」节为准**（会话级、高频更新）；待办事项明细以 [06-待办清单](design/gdd/06-待办清单.md) 为唯一登记处（条目级）；本文件只管批级序列与门，里程碑移动才更新。
+> 成文 2026-09-17；**2026-09-27 重整为批次执行制**（用户立规：任务一律按本路线图批次统一执行、零散并行会话退场——冲突源与介入成本；详见「执行纪律」节）。
 
 ## 里程碑时间线
 
 | 时间 | 里程碑 |
 |---|---|
-| 2026-09-07 | 阶段锚定 Systems Design；数据配置、行动经济 GDD 收口 |
-| 2026-09-08 ~ 09 | 地形变异、增益状态、棋盘生成、排雷玩法、敌人系统、地图战斗资源 GDD 收口 |
-| 2026-09-10 | 战斗结算 GDD 收口 |
-| 2026-09-12 | 概念原型 v3 终验 PROCEED（垂直切片承接）；DND 敌种更名；试玩批次 1（基线满通关 → 数值上调批） |
-| 2026-09-13 | 切片封装收口批 + P2 收口批；art-bible §1–4 定稿；HUD框架 GDD 定稿（MVP 设计收口前夜） |
-| 2026-09-14 | GDD 体系重构（旧树封存、新骨架重建）；魔法道具、冒险结构 GDD 定稿；完美策略档测量批（100% 通关暴露完美档失真） |
-| 2026-09-15 | 命名清偿批；格面资源批（五段结算/极性路由/可选类删除）；攻击类型与奖励抽象分离；护甲等级登记批；伤害量值区间批 |
-| 2026-09-16 | 行动点压速批 8→6；护甲等级掷点批落地（smoke 233 全绿）；AP6+AC 验收判读口径 v1.0；06-待办清单建账改版；系统更名批；敌人技能池提案对答启动 |
-| 2026-09-17 | 敌人技能池提案定稿（1c63830）；技能池实施批落地（smoke 263 全绿，待收编）；魔法道具切片期空内容拍板；关卡节点地图定稿批解锁；跨会话状态持久化批（快照节 + 本文件 + 守卫文案升级） |
-| 2026-09-18 | 加法核数值语言拍板落地（台账 75）+ 80 遍模拟试玩基线（台账 76）；无伤通关根因批（行动点压速 8→6）；英雄双轴批（甲/攻类型可配置）；伤害道具批五型→七型；战斗数值盘问会话四收口；关卡节点地图 v1.0 定稿（分支节点图拍板）；元进度定名永久强化+营地三柜台 |
-| 2026-09-19 | 验收读数重测批落地（4708940）；掷点流种子偏置根因修复 A+B 案（R3 混淆派生 + MC unique 模式）；插旗不可逆批（台账 87，冒烟 331）；普通画像 v2 基础定式拍板（普通=基础定式/完美=上界仪）；技能池新效应词汇批（妨害技+必中附加分量，smoke 306）；清图支配性对账重跑（c8e5afd）；迭代闭环仪表盘落地（台账 78）；worktree 铁律立规 |
-| 2026-09-20 | 第三关内容批（灰矮人矿城行集 + 测试直入口，smoke 375 全绿）；GP+商店房实施批（九型格面+随机掉落+Boss前商店房+统一加算区，smoke 437 全绿）；八型批呈现层漏网修复（真人试玩卡断——行协议呈现层同步闸 11 断言）；第一层定名「地精洞窟」 |
-| 2026-09-21 | **冒险结构实现批：切片从三个单关 demo 升级为一局完整三关冒险**（AdventureRunner+LevelRunner 账本外置+AdventureTable 建表；三关正式序列生效；smoke 482 全绿）；存档序列化批（SaveManager 落地：单档 JSON 存档读写/版本迁移/损坏兜底 + 元进度四件与冒险摘要入档，smoke 518 全绿）；放弃入口界面呈现批（用户拍板「放弃接口也要有」——选路停点挂放弃按钮，台账 119）；元进度实现批（MetaTable 四行族+MetaProgression 账本+跨局注入+营地覆盖层与结算明细，smoke 549 全绿——跨局循环闭合，数值 provisional 归设计批标定） |
+| 2026-09-07 ~ 09-14 | Systems Design 阶段：玩法系统 GDD 全树收口；概念原型 v3 终验 PROCEED（09-12，垂直切片承接）；GDD 体系重构（09-14，旧树封存） |
+| 2026-09-15 ~ 09-16 | 切片数值语言定型：格面资源批、加法核数值语言拍板、护甲等级掷点批落地（smoke 233）、AP6+AC 验收判读口径 v1.0、06-待办清单建账改版 |
+| 2026-09-17 ~ 09-19 | 切片机制完备：敌人技能池批落地（smoke 263）、关卡节点地图 v1.0 定稿+分支图批、加法核 80 遍试玩基线、无伤通关根因批（AP 压速）、验收读数重测批、掷点流种子偏置修复 A+B、插旗不可逆批、worktree 铁律立规 |
+| 2026-09-20 ~ 09-21 | **一局完整冒险闭合**：冒险结构实现批（三关正式序列，smoke 482）、GP+商店房批（smoke 437）、存档序列化批（smoke 518）、元进度实现批（跨局循环闭合，smoke 549）、第三关内容批、八型批 |
+| 2026-09-22 | Package B 七轮数值批+成长对齿落籍（用户拍板接受 B 曲线）；美术圣经 §6–9 全章成文（v2.0）；balance-verifier 数值验证工具批；美术文档过期账清偿批 |
+| 2026-09-23 | 换算率标定批（6/9/1+护甲断链修复）；停点前移批实施（关卡开局即出图+三区化+LevelStripView 退役）；UI 复用候选批 |
+| 2026-09-24 | **垂直切片转正（prototypes/ → game/）**；棋盘 Node2D 迁移 Phase A（BoardView 五层叠序）；伤害管线单据化（DamageController 唯一管线）；棋盘立体中档定稿冻结；状态图标接入 |
+| 2026-09-25 | 棋盘小人贴图系列五批（1.5× 档+脚锚自底边+椭圆影）；AI 生图退出角色资产管线（定位=上游草稿引擎）；生图直出像素网格调研双报告 |
+| 2026-09-26 | **战斗舞台 Node2D 迁移 Phase B（循环 1 收口，MC 逐位对拍零漂移）**；高墙瓦片 v9.3 定稿+换肤批（格面瓦片/敌像槽/接触带微光接线）；封印紫批；UX 文档欠账处置（level-clear 建档）；GP 归属拍板对齐；目录三层收敛大重构（design/artwork/game+熵增闸前身） |
+| 2026-09-27 | 熵增闸落籍（repo_structure_audit 四查）；单元测试与契约层补建登记 P0；UX 文档面三 spec 齐（battle 欠账处置 / level-clear / level-map 三拍板收口）；关卡节点图生成 v0.1→v0.3 立项落文+ADR-0007 评估书；**roadmap 重整为批次执行制（本批，台账 208）** |
 
-## 路线图（主线路线与门）
+## 当前位置（2026-09-27）
 
-1. **技能池实施批（已落地，smoke 263 全绿；待一笔收编提交）**：批 1 核心机制 + 批 2 呈现替代 + 批 3 文档与 registry 已完成；收编提交后本站闭合。设计权威 = `docs/proposal-skill-pool.md`。
-2. **验收批**（门 = 技能池批收编 + 工作区净 + smoke 全绿）：按 `docs/acceptance-ap6-ac.md` v1.0 跑三数据源（蒙特卡洛双档 / 真人 3–5 局 / 日志分析器），无道具基线；产出判读结论与选档建议。
-3. **难度曲线阶段二调参批**（门 = 验收读数）：四级阶梯落档 + 三杠杆扫描（血量锚走廊 / 群战上探 / 注入衰减）+ 挖掘风险不等式与清图支配性两对账重跑 + AC 行值投值。
-4. **深度轴行值填充批（原第二关内容批的行值半边；门 = 调参行值）**：L2/L3 行集已落地、三关正式序列已生效（2026-09-21 冒险结构实现批）；剩深度轴行值 D1–D4 投值与新内容投放，归难度曲线阶段二调参批同窗。
-5. **并行 / 后置轨道**：存档序列化批（挂点 = 冒险状态与摘要——冒险结构实现批已就位）；元进度批（钥石消费方挂点 = 冒险摘要钥石合计——已就位）；魔法道具内容批（排切片收尾后）；真人通关率标定（挂 playtest 批，指引见切片 README）。
+- **阶段**：Vertical Slice Implementation（`stage.txt`）
+- **已达成**：一局完整三关冒险+存档+元进度+营地闭合（数值 provisional，归调参批标定）；表现层 Node2D 双阶段+换肤接线落籍（渲染架构到位、素材占位在役）；UX 文档面四 spec 齐（battle / level-map / level-clear / interaction-patterns）
+- **挂起待用户输入（批次解锁点）**：① 样张 v1 否决原因（解锁样张 v2 → 换皮/演出/数字终稿）② ADR-0007 三方案裁决（甲分栏/乙并流/丙并流+日志——解锁关卡节点图生成特性批或 rng 架构批）③ 真人试玩批次（解锁曲线调参读数）
+- **已知挂账**：曲线调参批（基线读数重测+杠杆扫描，段界结账口径）；魔法道具内容批（node-reward spec 随批出生）；反制批 Alpha
 
-## 维护纪律（收口批五步）
+## 主线路线（批次序列与门）
 
-① 改 active.md 顶部快照节 → ② 追加台账条目 → ③ 里程碑移动才更新本文件时间线 → ④ 阶段变更才改 production/stage.txt → ⑤ 重跑 `python tools/loop_dashboard.py` 刷新迭代闭环仪表盘（看验证失效面 / 待办透视 / 台账健康三个读数，落后项即下一批输入）。Stop 守卫钩子强制 ①②（拦截 + 提醒，不代笔）；⑤ 为软纪律不挂钩子（工具失败不挡收口）；快照节 ≤10 行，装不下的细节进台账。
+> **提案序，开工逐批点名**；每批 = 一个 loop（规范见下节）。批次内任务清单的事实源 = 06-待办清单对应条目 + 各 UX spec 的 AC。
+
+### M-1 切片表现收口（现行里程碑）
+
+**完成定义**：表现层与测试兜底全部落籍，切片期不再产生零散表现批。出口闸 = 真人目检清单全绿 + 冒烟/探针全绿 + doc 三闸 + 熵增闸 + MC 逐位对拍零漂移。
+
+| # | 批次 | 门（前置） | 内容概要 |
+|---|---|---|---|
+| B1 | 测试基建批（**P0**，2026-09-27 用户裁定先于表现批） | 无——可立即开工 | 单元测试与接口契约层补建（`game/tests/unit` 挂载：ConfigDB/伤害单据/池乘区纯函数覆盖 + 系统间接口契约测试）；06「单元测试与接口契约层补建」承载 |
+| B2 | 样张 v2 批 | **用户输入闸**：v1 否决原因（剩 2 roll 预算） | 按 §1.4 清单重出样张；过 = 四冻结（砖面形态/色板/动画方案/数字形制）——M-1 内换皮、演出、数字三项的解锁闸 |
+| B3 | 表现收口循环 2（计划书批） | 换皮/演出/数字部分 = 样张 v2 冻结；其余（关卡画面/接线）不等样张可先行 | ①换皮：界面环境与框材组 8 件（♻ 复用件审阅接线/✦ 背景横幅生图）②演出密度终稿（死亡碎裂/胜利纹章/失败掸灰/意图与结算动画）③棋盘数字呈现终稿 ④高墙感挑档落码（B 轮廓/C 立面/D 投影，推荐 D）⑤CJK 字体随包挑定（Fusion Pixel OFL / Kenney CC0）⑥C 区本关强化列表接线 ⑦关卡画面实装（[level-map](design/gdd/ux/level-map.md) 三拍板落地+停点标题+顶栏 GP 徽章+图上命中探针改造）⑧战斗胜利结算 GP 总量+增量接线；06「战斗画面表现收口（循环 2 输入清单）」承载 |
+
+### M-2 切片数值标定与 Alpha 验收
+
+| # | 批次 | 门 | 内容概要 |
+|---|---|---|---|
+| B4 | 验收读数重测批 | M-1 出口（表现定稿后读数才不被呈现改动扰动） | 段界结账口径基线重测（MC/verifier 全段）+ 真人 3–5 局并入；06「刷新经济性监控」阈值随批 |
+| B5 | 曲线调参批 | B4 读数 | 四级阶梯落档+三杠杆扫描+AC 行值投值+L2 池验证；**关卡节点图生成台阶一实施批同窗或随后**（前置 = ADR-0007 裁决） |
+| B6 | Alpha 验收批 | B5 | draw calls 真机测量（270→<200）+ 真人目检清单总清 + 07-体验验证清单总对账 + 真人通关率标定 |
+
+### M-3 内容与元进度深化（后置轨并轨）
+
+魔法道具内容批（node-reward spec 随批出生+C 区道具槽接线）· 元进度数值标定（换算率/柜台定价）· 反制批 Alpha · 关卡内容扩展。排序在 M-2 出口后按当时读数定。
+
+## 执行纪律（2026-09-27 用户立规）
+
+1. **一批一 loop**：所有任务（功能/文档/数值/素材接线）一律走本路线图批次，每批先立计划书再开工——**零散并行会话退场**（多会话并行 = 冲突源+介入成本；2026-09-27 起单批串行执行）。
+2. **例外 = 零碎 bug**：单独会话 mini-loop 修复（修→轻闸→台账登记），不立计划书、不占批次位；同屏同类 bug 攒够一笔可并入下一批次。
+3. **用户输入闸显式化**：批次门里所有需要用户表态的点（否决原因/裁决/试玩）在「当前位置」挂起清单可见，解一个开一个。
+
+## 批次 loop 规范（loop engineering）
+
+> 模板先例 = 循环 1 计划书（`.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md`，已完整跑通收口）。每批照此八件成文，缺件不开工：
+
+1. **计划书**（`.zcode/plans/<批名>-loop-plan-<日期>.md`）：批次目标与完成定义 / 现状事实（代码级，开工自行复核）/ 设计契约（违反即返工，标 🔴 触碰=L3 停机）/ 范围边界 / 任务卡 T0..Tn（逐卡估时）/ 验证闸 / 异常分级 / 代拍板白名单。
+2. **T0 开工**：建 worktree + 基线复读记档（冒烟/探针/三闸/MC 对拍基准）+ `git status` 归属核对（并行遗留只标旗不碰）。
+3. **循环骨架**：一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交（代拍板随 commit 记录）→ 台账追加（查撞号）→ 下一轮。单 worktree 多点提交一次合并；轮内禁开第二个 worktree；基线每轮开工时点重测；断点续跑 = `git log` 对任务卡定轮次 + 重跑当轮轻闸。
+4. **轻闸**（每轮必跑，headless）：run_smoke 全量 + ui_input_probe（十一断言）；触碰 presentation 加跑 ui_click_probe + ui_layout_probe。
+5. **重闸**（批末 Tn）：全量轻闸 + doc 三闸（doc_link / gdd_lint / doc_term，对基线零新增）+ 熵增闸 + MC 逐位对拍（涉核心）+ 素材批加机检断言。
+6. **人闸**（停机交付）：真人目检清单 + 代拍板追认清单 + 异步终审触点（样张类）——本循环内唯一必经人审。
+7. **异常分级**：L1 自救（一次重试）→ L2 记录继续（连续 3 次同红灯升级）→ L3 停机写报告等用户。
+8. **收口五步**：①active.md 快照 ②台账条目 ③里程碑移动更新本文件 ④阶段变更改 stage.txt ⑤批末闸序列全绿留痕（loop_dashboard 已随目录收敛退役，透视职责由 06+台账承接）。
+
+## 维护纪律
+
+同「批次 loop 规范」第 8 条收口五步；本文件由里程碑移动触发更新（批次开工/收口不强制改本文件，改的是 active.md 与 06）。快照节 ≤10 行，装不下的细节进台账。