96 KiB
96 KiB
工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范）
一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。实时状态以仓库根 active.md 顶部「当前状态快照」节为准（会话级、高频更新）；待办事项明细以 06-待办清单 为唯一登记处（条目级）；本文件只管批级序列与门，里程碑移动才更新。 成文 2026-09-17；2026-09-27 重整为批次执行制（用户立规：任务一律按本路线图批次统一执行、零散并行会话退场——冲突源与介入成本；同日二次修订：粒度对齐敏捷流程——里程碑=发布级目标、迭代=多任务增量交付单元，详见「执行纪律」与「迭代粒度界定」）；2026-09-28 里程碑重排（M-1 初步验收通过精简收档；关卡画面独立化立项 M-2 高优先级——用户裁决独立屏为最终形态；原数值/内容里程碑顺延为 M-3/M-4，迭代号随里程碑重排：原迭代 3/4 → 迭代 5/6）；2026-09-29 迭代重排（用户裁决：Alpha 验收=对「大部分游戏内容逻辑闭环」版本的验收，内容闭环前验收无意义——战斗演出前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8；M-3 更名「数值标定与 Alpha 创建」，M-4 转 Alpha 后深化）；同日二批（全流程闭环审计+四裁：审计六件归属落表——四件入迭代 6/两件原裁迭代 7；冒险续玩断点立项（用户裁「中断可续玩、退出即结算」两口径分离）→迭代 7 超 3-8 卡上限,拆出新迭代 8「续玩断点+设置面+打磨包」,设置面/打磨包随移,Alpha 验收顺延迭代 9；美术素材不入 git 维持（生产资产目录 game/assets/art 同样豁免,补 .gitignore 归迭代 6 T0）；营地 2D 画面缓 M-4 再议）。
里程碑时间线
| 时间 | 里程碑 |
|---|---|
| 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.4 立项落文+ADR-0007 评估→用户裁丙→统一随机流批落地（七流并一+全事件日志，329c7a2，状态记录 210）；roadmap 重整为批次执行制（本批，状态记录 208） |
| 2026-09-28 | M-1 切片表现收口完成（迭代 1+2 已入库，初步验收通过）：样张 v2 机检 16/16 四冻结（art-bible v2.13）/框材组 8 件换皮/演出密度终稿/棋盘数字终稿/关卡画面三拍板实装/单元九套件/瓦片换色两套；同日关卡画面独立化立项 M-2 高优先级（用户裁决独立屏为最终形态，本批） |
| 2026-09-28 | M-2 关卡画面独立化完成（迭代 3+4 已入库，出口闸目检通过）：独立屏 LevelMapScreen+独立性断言（状态记录 224）/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点（art-bible v2.14，状态记录 225）；出口检查单 design/qa/m2-exit-gate-checklist-2026-09-28.md 用户八项目检通过（状态记录 227） |
| 2026-09-29 | 迭代重排（用户裁决「内容逻辑闭环先于验收」）：M-3 更名「数值标定与 Alpha 创建」——战斗演出完善前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8；M-4 转 Alpha 后深化与内容扩展（本批，状态记录 242） |
当前位置（2026-10-11 刷新）
- 里程碑语义（2026-10-09 立规换代，详见下方里程碑表的换代注）：现行里程碑 = M3「Alpha 版本的完整实现」——用户未明令宣布完成前停留 M3，迭代只排 M3 需求；M4=Beta 版本的完整实现，一律不排期。下文里程碑表的旧编号（M-3/M-4）保留作历史序列，语义以本节为准。
- 迭代进度：迭代 19 五卡全部已入库（2026-10-08，批末闸全绿）；迭代 20 已编入=专长实装批（2026-10-11 用户令，卡片零待裁点成立）待开工 U0；迭代 21 已编入=天赋树实装批（2026-10-11 用户令，整卡不切分，卡片 v1.1 零待裁点成立）待开工 U0；迭代 22 规划冻结维持；迭代 22 已编入=秘宝体系实现重构落地批（2026-10-11 用户令，卡片 v1.2 零待裁）待开工 U0。
- 近期主战场：文档治理与设计换代连续批（秘宝/奇物正文换代、件表扩容、全库术语统一、天赋树 v0.4、武器锻造成文），批次详情见 git 提交史；下一前沿=专长与秘宝实装批写卡、迭代 20 卡A，均待用户发令。
- 实时状态：以根目录 active.md 顶部「当前状态快照」节为准（
stage.txt已定性为旧阶段开关，仅存档）。
主线路线（里程碑 × 迭代序列）
提案序，开工逐迭代点名；每个迭代 = 一个 loop（规范与粒度界定见下节）。迭代内任务卡的事实源 = 06-待办清单对应条目 + 各 UX spec 的 AC。
M-1 切片表现收口（Release 1）
✅ 完成（2026-09-28 初步验收通过）——迭代 1「测试兜底与表现先行」（六卡）+ 迭代 2「样张冻结与表现定稿」（五批次）已入库，出口检查真人目检过。明细归 git 历史 + 出口检查单 design/qa/m1-exit-gate-checklist-2026-09-28.md + active.md 状态记录 215-222。
M-2 关卡画面独立化（Release 2）
✅ 完成（2026-09-28 出口闸通过）——迭代 3「独立屏架构」（四批次）+ 迭代 4「关卡画面视觉终稿」（五批次）已入库，出口检查真人目检八项全过。明细归 git 历史 + 出口检查单 design/qa/m2-exit-gate-checklist-2026-09-28.md + active.md 状态记录 224-225。
M-3 数值标定与 Alpha 创建（Release 3，已关闭 2026-10-03——迭代 9 出口闸过、Alpha 到手；2026-10-09 口径换代注：「已关闭」系旧口径=Alpha 验收到手，新口径 M3=Alpha 完整实现仍在进行——见 M-4 节头立规注）
2026-09-29 用户重裁：Alpha=大部分游戏内容逻辑闭环的可玩版本，验收只对该状态有意义——原迭代 6「Alpha 验收」排在战斗演出/魔法道具之前属倒置，后移为迭代 8；战斗演出完善前移迭代 6（原 M-4 迭代 7），魔法道具+元进度标定编入迭代 7。原「读数不被呈现改动扰动」的顾虑只约束模拟读数（走逻辑层，呈现改动本就不触），真人读数（目检/通关率/07 对账）必须等内容闭环后采集才有效。同日二批补充：审计追加卡落表后，续玩断点（新需求）使迭代 7 超 3-8 卡上限——拆出新迭代 8「冒险续玩断点+设置面+打磨包」（代排待追认），Alpha 验收顺延迭代 9。
| # | 迭代 | 门（进入条件） | 更改任务 |
|---|---|---|---|
| 迭代 5 | 读数重测与调参（原迭代 3） | M-2 出口闸；⑤号卡另需 ADR-0007 裁决（已裁丙落地） | ——✅ 完成（2026-09-28 五卡已入库）：基线重测〔三越带初判〕+杠杆扫描〔C3 组合锁值：岩浆1/plb0/percent4/卓尔100〕+AC 投值〔Boss-only 台阶 8/9/12〕+节点图生成特性批〔15 骨架+node_map 扩签+首次冒险脚本，冒烟 557→576〕；读数挂账〔完美 L1 丙·普通 L2 17.1% AC〕归出口人闸追认；明细=迭代 5 状态记录 230-241+design/qa 三报告。2026-09-29 返工批（U2 人闸三推翻两追认+目检 15/15 不过，状态记录 246/247）：C1 两刀终态+AC v1 硬梯度重投+节点图池两规则重生成〔L1 前三位纯战斗/L2L3 层宽 4-5，模板 0 随重排〕——终态双窗读数〔普通 L1 ✓·普通 L2 10.6/13.6% ✗·完美 L1 84% 甲挂账→荆棘外延提案待批·完美 L2 22/32% ✗〕，缺口数字待批点丙追认；二轮目检=返工批出口人闸；2026-09-30 出口三件全闭（收口批 fe520af/合并 3933723+补丁批，状态记录 290）——①二轮目检 15/15 过（T-C 过闸）②普通 L2 带改 [10,15]+批点丙追认成立（10.6/13.6% 落带，组合基线转正；完美 L2 22/32% 越带用户整体表态知情接受、带不动）③荆棘外延提案否决→根因改判「战斗阶段数值问题」06 待讨论——迭代 5 返工出口成立 |
| 迭代 6 | 战斗演出完善（原 M-4 迭代 7，2026-09-29 前移；2026-09-28 用户立项，收编历史登记「战斗表现批」——状态记录 106「真实立绘/动画密度终稿归战斗表现批」,前置 P0 样张已随 M-1 解除） | 迭代 5 出口（已解） | ①资产管线正式化：pixelfixer 网格段+封闭灰袋清除并入 tools/pixelize_candidates.py（--fixer）+九张 48px 站桩槽位档生成（8 敌种+主角 normal,底中锚/NEAREST）②敌种立绘落位：按 ui_kit.gd TEX_ENEMY_* 常量名入 game/assets/art/character/,字形「敌」回退退役,目检 ③主角 portrait 替换（新 normal 态）+attack/hit 两态素材入包（命名/路径随计划书定）④主角三态切换挂事件：攻击演出→attack 态/受击→hit 态/回 idle,槽位 2× 整数放大适配 ⑤命中特效密度终稿：命中瞬间打击特效（状态记录 106 动画密度欠账清偿）⑥受击白光/演出链复核：弹道→闪白→血条→灰化全链+flash_hit 强度时长 ⑦fx_probe 断言扩充+轻闸接线 ⑧用户实机目检清单（战斗演出专项,本迭代人闸）；2026-09-29 全流程审计追加四件（用户裁定归本迭代,状态记录 243）：⑨终局面板「明细回看」z 序修复（main.gd:361 绕模态栈直开,回看层登记序在终局层下、被全屏遮罩压死——改走 _open_modal+ui_click_probe 补终局入口断言）⑩GP 冒险收束呈现（adventure_runner.gd:231 清零前,冒险终局面板补「本局 GP 入账」行,兑现 ui_assembler.gd:52 双展示位承诺）⑪主角受击反馈+死亡演出（敌→主角伤害弹道 main.gd:505 直接 return、无白光——补弹道+flash_hit,死亡补专属演出,与敌方演出密度对等）⑫flat_damage 变异格视觉标记（tex_mutation 槽恒空、数字照常显示——接变异纹理或角标,可归因）。T0 注（2026-09-29 裁定）：美术素材不入 git 维持,game/assets/art/ 目录补 .gitignore（现行素材在盘不入库,缺位走字形回退;素材移交方式=用户放盘,打包发布方案随 Alpha 前另议）；2026-09-29 落地：T0-T8 十轮全落（worktree m3-iter6-20260929,状态记录 247-255）——卡①-⑫全兑现+审计四件;重闸全绿（冒烟 576/0+五探针+doc 三闸/熵增零新增+素材机检 11/11+MC 对拍 400/400 逐位一致〔锚已重锚 HEAD,原迭代 5 锚过期〕）；出口人闸=T9 目检进行中（检查单+代拍板追认五项=git 提交 8e74483（检查单已按生命周期条款退役）,素材移交口径更新=八敌+主角三态已管线自产落盘用户无需放盘）；已完成（2026-09-29 用户 U2 目检过闸，状态记录 256）——迭代 6 出口成立，迭代 7 门解 |
| 迭代 7 | 魔法道具内容+元进度数值标定（原迭代 8+ 前两项编入） | 迭代 6 出口 | node-reward spec 随批出生+C 区道具槽接线+魔法道具内容（奖励节点空占位 node_overlay.gd:36 由本迭代兑现,营地工坊六件死解锁同批接局内效果）；换算率复核/柜台定价标定；批末复跑 verifier 关键带（新力量源入局读数漂移属预期，破带才回调）；2026-09-29 落地：T0-T8 八卡全落（worktree m3-iter7-20260929，状态记录 259-263）——八拍板点裁决落锁（①乙罗盘退役/②丙三选一/③甲解锁进投放池/④甲封存呈现/⑤甲两步交互/⑥甲三件 10/池 88/⑦⑧读数后裁与只测不判）；重闸=冒烟 577/0+五探针+单测 12 套（含 aux 三新套件）+doc 三闸/熵增零新增+素材机检 11/11+MC 剥 additive 字段 0/400 逐位（门控空集=夹具态零投放零扰动）；verifier 换算率复核读数出讫（生命 6→实测 1.7/攻击 9→4.1/护甲 1→0.0——U1 呈报待裁）；已完成（2026-09-29 用户 U2 目检过闸——七项目检过+追认五项全认+T5-hotfix 实机复验；状态记录 267）——迭代 7 出口成立，迭代 8 门解 |
| 迭代 8 | 冒险续玩断点+设置面+打磨包（2026-09-29 立项：用户裁「中断可续玩/退出即结算」两口径分离+审计 #5#6 随移；同日二批：真人试玩反馈三件编入+排布与选型已追认〔2026-09-29 用户拍板：雷当量甲·直伤当量抬升／胜利总结结算接线按既有拍板面／轮间节奏甲·演出层排播队列，三件全编本迭代——计划书 .zcode/plans/m3-iter8-loop-plan-2026-09-29.md〕） |
迭代 7 出口 | ①run 快照序列化：停点粒度断点（关卡序号/节点位/生命/本关加成区/GP 钱包/商店已购档/已抽模板），入 save.json 新域+schema 版本迁移；战斗中中断不存棋盘中局，续玩恢复至最近停点、当场战斗从头打 ②开始菜单「继续上局」按钮（存在断点才亮起；续玩与新冒险互斥确认）③中断/退出口径分离：中断=关游戏留断点可续；退出冒险=现行放弃流程（失败结算+清除断点）④最小设置面（音量/全屏/退出按钮/减动效开关从测试调整板转正+调试入口门控）⑤打磨包（RAP 与九徽章图例解码入 legend、封印旗纹理落位退役文字占位、放弃按钮文案收敛至 level-map 4 字上限、判定文案两处措辞统一）⑥战斗胜利总结结算接线（冒险模式普通战斗胜利挂 BattleEndOverlay 胜利形态：金蜡封+GP 增量+总量+判定行+「下一节点」——battle.md OQ14 已拍板面接线，Boss/失败分支不动；06「战斗胜利总结结算接线」条目）⑦轮间结算节奏化（演出层排播队列：结算行按段分组阶梯延迟进明细带+轮切换「第 N 轮」横幅驻留——核心层零 await 契约与 MC 对拍不破、减动效开=延迟归零横幅静态化，与卡④减动效开关联动；06「轮间结算节奏化」条目）⑧危险格负向当量抬升（直伤三行 power 抬档投值+挖掘风险不等式对账复跑+通关率双窗复测；前置=普通 L2 缺口数字批点丙追认；06「危险格负向当量抬升」条目）⑨冒烟/探针断言：断点写读往返、续玩幂等、退出清断点、无断点时按钮隐藏+卡⑥结算框呈现断言+卡⑦节奏断言（减动效双态）⑩实机目检人闸（中断重开续玩全流程+战后结算框+轮间节奏）；2026-09-29 落地（T0-T10 全落，worktree m3-iter8-20260929 六批次，状态记录 274-277+280，合并 77cc727）：断点域 save v2（七字段+附随件，续玩确定性 400 局对拍零扰动）+继续上局/互斥确认/退出口径分离+最小设置面（减动效转正/DS_DEBUG 门控）+打磨包三件一降级（旗纹理缺盘 06 债务）+战斗胜利总结结算框+轮间排播队列与轮横幅（核心层零 await 零触碰，pacing_queue_test 第 15 套）+雷当量 4/5/5 provisional（MC 完美档读数逐位不动=只打踩雷轴反证；普通 L2 7.9% 缺口加深四选一待裁）+人闸三件交付=git 提交 d70f6c3（检查单已按生命周期条款退役）；已完成（2026-09-29 用户三轮目检过闸，状态记录 287）——迭代 8 出口成立，迭代 9 门解（T7 数值四选一用户裁决挂起自行探讨，表值维持 4/5/5） |
| 迭代 9 | 视觉规格落码 + Alpha 验收（2026-09-29 用户验收样张新 v3.5 并立项插入：美术圣经 v3.0 中修+方向稿收敛后的落码批为 Alpha 验收前置——验收对象应是视觉完整版本；需求卡片已退役（git 710f9b7 出口批）；2026-09-30 用户扩编：呈现欠账四件+样张闸同窗件全编入〔06 在册欠账清偿，状态记录 288〕） |
迭代 8 出口 | 前置卡组·视觉落码（需求卡片批 A+批 B）：⓪批 A 机检冻结（断言定值+产物转正+圣经 v3.1 记录，人闸已由 2026-09-29 方向稿验收豁免）①棋盘渲染落码（E 格高墙 30%/连接无边框/地板归一 L0.10）②数字承载切换（亮墨三档直画+色牌后备）③ui_kit 对比度修复（现行 4 处不达标+字号 16/14）④B 区舞台（暗背景+地台落影+顶光柱）⑤整屏样张闸首跑（四屏断言；随闸三裁决=1920 档缩放策略对照/动画帧数规格/资产升档与否〔06「美术资产规格两项」「资产升档重产批」两欠账随闸呈，裁升档→主角三态+八敌种重产转加卡〕）⑥探针与冒烟重闸；扩编卡组·呈现欠账（2026-09-30 用户拍板第一/二档全编）：⑪关卡画面 GP 常驻徽章接线（level-map spec 顶栏徽章，纯呈现欠账——06「GP/钥石迁出展示面接线」剩余面）⑫C 区「本关强化列表」数据接线（壳已落，set_level_bonuses→runner 加算区投影）⑬封印旗纹理自产+tex_flag 接线（迭代 8 卡⑤降级债务清偿，程序槽位零改码）⑭营地界面视觉终稿（解锁界面剩余面，前置=本迭代样张闸过审）⑮分辨率档位与格边长落码+HUD 框架「两档定值 36/45px」条款修订（1280×800/1920×1080 已定案）⑯art-bible §8.2 缩放纪律分级修订落文（甲文本/乙角色两类，圣经 v3.0 入库窗口已开）⑰B 档视口截图像素断言试点+C 档黄金图基准建立（测试分级批同窗件，C 档后置于⑤冻结）；Alpha 验收（原卡组不变）：⑦draw calls 真机测量（270→<200）⑧真人目检清单总清 ⑨07-体验验证清单总对账 ⑩真人通关率标定（真人 k 补跑并入）。代排待追认：卡数超 8 卡上限，计划书按「视觉落码段（⓪-⑥+⑪-⑰）→ Alpha 验收段（⑦-⑩）」两段组织、一次合并，段排布随计划书 U0 追认；呈现/文档卡全不扰卡⑩真人读数（数值/内容面不编入本迭代，归 M-4）。⚠ 2026-10-01 用户否决迭代 9 标完成（数值轴）：真人实证推翻模拟尺（旧普通档=新手画像弱真人 20 倍/完美档非元游戏上界）——数值修复批已入库（数字可读甲案+模拟档位重构+数值三刀，报告 design/qa/numfix-newruler-readings-2026-10-01.md）后迭代 9 维持未过闸，卡用户实机验收新数值+新带值拍板；全旧带读数作废待新尺重锚；✅ 完成（2026-10-03 出口闸过，状态记录 315）：9B Alpha 验收段收口——T17 36 项全判（13✅/35 两处修复/32 环境限制）+T16 修复批 11 件全落（硬锁 v3.1/演播后排窗/出度≤2/掉落渠道退役等）+T19 真人批佐证级收口（有效局 2 用户裁+k=0.60 落 >0.5 带内）+带值四带甲案落现行事实源（A[0,10]/B[50,85]/C[30,60] 预立/D 响应曲线 ≤15pp·S 形，旧三带作废）+81000 锚（非数值验证——k 源+出度重建位移存档）+06 draw calls 销号（504→196）+stage.txt 换代；批末闸=冒烟 636/0+run_all 15 套+探针 4/5 绿（click_probe 已知红挂 06 专项）。出口检查单=design/qa/m3-iter9-exit-checklist-2026-10-03.md——迭代 9 出口成立、M-3 关闭、Alpha 到手、M-4 门解 |
| 迭代 10 | 奖励结构重构——通关三选一 + 钥石掉落挪转 + 精英怪立项预留 + 通关部分回血（2026-09-30 用户拍板案丙+P-A~P-E，计划书=.zcode/plans/m3-iter10-loop-plan-2026-09-30.md；2026-10-01 用户提前开工拍板：不合入 master、渲染层验证冻结——T0 开工门改规随批追认） |
迭代 9 出口（改规注记：Alpha 验收未过闸，用户拍板提前并行开工——并行安全性由「不合入」保证，master 读数面零污染） | T0-T10+追加批全落（worktree m3-iter10-20261001，10 提交 34dd8de→7f5caa3）：①大奖励三件套退役改三层框架——部分回血 20%（clear_heal_pct）+提升三选一（池六种加权洗牌 E-S 不放回/reward_pick 扩签/属性件上限 3·AP 件上限 2 达上限剔牌库/选择停点零自动推进可中断）②加算区四轴+行动点（AP 件每战首轮 +1，排队通道兑现；行动经济.md 失同步清偿 AP 6→8）③钥石退役出大奖励改 Boss/精英逐杀掉落（boss_keystone 重锚首杀 3/复杀 2/2/3——a 裁备选；末关照常入账；收束无二次派生）④同调位过渡承载（transitional_sync_slots=1；三选一面替换子交互两路/战斗内沉没；现行事实源归同调实施批）⑤奖励节点共享池（追加批用户拍板——与通关三选一同池同权重同上限，node-reward.md v2.1 掷定前置卡片直显具体道具）⑥断点 save v3（奖励选择态+件计数+aux_detail；v1/v2→v3 semver 兼容断言——g 裁）⑦BonusPickOverlay 共用面+目检修复批（候选一致降级为现状注记）；裁决面：七项代拍板全裁（a 用备选/b-f 认同/g semver）+e 白话追认；实机目检一轮：1/3/4/5/6/9/14 PASS（8 项根因=减动效开关遗留已翻回；2/12 延后同调批；逐行结算演出定性迭代 8 事项不追）；合并 master 数值修复批（bc737fb 解 2 冲突——autoplay 注释双留/smoke_all 取新断言+模拟档购血容差窗）后冒烟 628/0+run_all 15 套+五探针+三闸零新增（死链 4=存量；master 新引 1 条环境死链已修）+熵增 PASS；MC 四代锚 77000/78000/79000/80000 各 400 局（普通 L1 41.8%/L2 10.2% 带内、完美 L1 86.5%/L2 15.6%、钥石 1.38/3.01——报告 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md）；人工参与项入 07 清单⑩；已完成（2026-10-01 开发闭合）——迭代 11 门解（M-3 内顺延），Alpha 总闸仍卡迭代 9 数值实机验收 |
M-4 Alpha 后深化与内容扩展（Release 4）
里程碑语义换代（2026-10-09 用户立规）：M3=Alpha 版本的完整实现；M4=Beta 版本的完整实现。用户未明令宣布 M3 完成前，项目停留在 M3 阶段——迭代规划只编排 M3（Alpha 完整实现）相关需求，M4 内容一律不排期、不进迭代。按新口径：本节迭代 11 起各行皆属 M3（Alpha 完整实现面）；2026-10-03「M-3 关闭、Alpha 到手」为验收史记录保留；M4（Beta）未开启，门=用户明令 M3 完成；本节旧状态句「现行里程碑（2026-10-03 M-3 关闭升现行）」由本注取代。
| # | 迭代 | 门（进入条件） | 更改任务 |
|---|---|---|---|
| 迭代 11+ | ✅ 三批已入库（2026-10-03，状态记录 323-325）：①魔法道具同调实施批 bc17b66（冒烟 645/0→671/0 基线演进）→ ②GP 商店房重构批 395b2ab（共享池账本+抽 3 买 1 全重抽+A=1.8/b=1.1 provisional+MC off 对拍逐位 PASS+on 新锚 N=60）→ ④视野迷雾实施批 e6260a5（菱形灯光区 R8+区外全黑+暗淡记忆态+探针 case⑮；纯呈现 MC 零跑）——各批合并后主区全量冒烟复跑全绿；迭代 11 门=待出口人闸关闭（人闸材料包=design/qa/m4-iter11-exit-package-2026-10-03.md：三批检查单+追认清单 18 项+迷雾目检指引+读数报告）。原登记：2026-10-03 用户裁迭代 11 范围（三批，推荐序）：①魔法道具同调实施批 → ②GP 商店房重构批 → ④视野迷雾实施批（各批独立出口闸；同调批先行——商店批共享池账本与通关率复测建在 aux 卡退役后的终局池上，读数只锚一次；迷雾批纯呈现不扰读数，序位可穿插）；反制批移迭代 12（前置=双层 BD 外部调研+仲裁后重新立项；2026-10-03 用户终裁=同调位反制道具层级错配失败设计废弃，「每变异≥1反制道具」契约作废——地形变异.md v0.6/魔法道具.md v0.8 同批落文（06 条目已收口移除））；Beta 方向立项撤出本窗口（待 Alpha 内容填充+试玩轮次后再议）；关卡内容扩展留讨论位（世界观设定待用户补权威定义——摩索不达城 repo 无载）。↓ 原登记：反制批 Alpha · 魔法道具同调实施批（需求卡片 v1.1 全裁 P1-P8（需求卡片已退役，已入库=①bc17b66），2026-10-02 用户裁 P7 乙归本窗口，发令即开工——需求卡片含 T0-T10 可升 loop 计划书）· GP 商店房重构批（2026-10-02 用户裁三选一同构化：买一全重抽/重抽绑购买/价格=基价×b^(关序−1)×A^(进店已购次数)〔系数归 game-balancer 研究〕，取代 09-20 无刷新裁决——06「GP 商店房重构」条在册待立项）· 关卡内容扩展 · Beta 方向立项（原迭代 10+ 三主题顺延——迭代 10 位已由奖励结构重构批占用，2026-09-30 用户拍板 P-E；各批顺序按 Alpha 读数定；含营地 2D 画面议题——2026-09-29 裁缓至此再议） | M-3 出口闸（已解——2026-10-03 迭代 9 出口闸收官：M-3 关闭、Alpha 到手） | 立项时按「迭代粒度界定」拆任务卡 |
| 迭代 12 | 双层 BD 实施批（反制批位移承接——变异应对局内化在本批落地）：2026-10-03 用户五裁全落=R1 甲（树形态融合案：主干脊柱 row-gating+三脉+彩蛋 ≤3+A/B 集中同调脉）/R2 乙（两层全入本迭代：批次一 T0-T7=机制件基建+七流派全量铺〔R3 乙〕+地形转化件+商店保底+MC 锚；批次二 T8-T10=天赋树+存档 v4+营地 UI 重构；超软时间盒切 12/12b，切分点=批次一出口）/R3 乙（七流派批次一全量铺）/R4 甲（信息型永不对冲+复查闸=T10 呈报信息型真人读数仅呈报不提案；净化工兵仅限伤害型、清除工具件族不做、深挖钻头改非信息税设计）/R5 甲（喂雷流不做，06 留正式待办+kill-switch 判据）。未落地备选内容已自包含迁 06「双层 BD 延期与备选内容总登记」。设计事实源=design/research/双层BD体系-整合定稿-2026-10-03.md（双模型并行调研仲裁版），需求卡片已退役（已入库=e780063）。✅ 已全批入库（2026-10-04，状态记录 328-333）：TP0 令牌池先行（normal 重锚）→批次一 T0-T7（27 件七流派+MC 成型锚 L1 5%→75% 分岔+红线自检①过）→批次二 T8-T10（天赋树 33 节点+存档 v5+营地树 UI+A/B 面 0.0pp）一次合并 e780063；试玩反馈四连修复（钻头 AP 锁死/v2 收益重投/流派件呈现双界面/清图奖励 toast）至 c43276d；批末冒烟 718/0+run_all 15+探针绿+doc 三闸基线同款+熵增 PASS；出口人闸待用户（人工检查清单=状态记录 328-333+design/qa/m4iter12 两报告）；前置=迭代 11 三批出口+M-4 数值批令牌池落地+商店批共享池 |
迭代 11 出口 | T0-T10 两段式（需求卡片 §四） |
| 迭代 13 | 工程债与测试基建批（含 D6 爆破工兵包实施）：六条目=ui_click_probe 完整局适配（D1——分派链序修正+停点/锁期/重放三态断言）/探针只读出口（D2——六出口 26 直入清零）/ArmedTimer helper（D3——P4 乙三处计时收口缝零动）/main.gd 二期瘦身（D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119，家族②契约3绑定面留置；~900±50 锚差=族级清单上限不自洽已归因）/aux 二期合并（T5 判不合收口）/杂项尾差四件（D5）/爆破工兵包中立移除危险格（D6——P1 甲邻接冻结/P2 甲退色降档，判定逻辑零改动，充能表驱动零新码）。✅ 已入库（2026-10-04，状态记录 342）：worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8；闸=冒烟 718/0（断言数持平基线）+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑（静态零漂移证明）；合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d（知情超限单批，实际单会话） |
| 迭代 14 | 初始展开收窄批（2026-10-04 用户拍板甲乙混合立项）：甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环（参数化半径，现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成）+乙=生成重掷闸 R₀≤cap（合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口）；玩法侧零改动路线（排雷玩法「初始展开恰等」验收原样为真，minesweeper_rules.gd 零 diff）；裸数字截断路否决退役（可见 0 格+未开邻居=扫雷不可能态）。可行性报告=design/research/研究-初始展开收窄可行性-2026-10-04.md，需求卡片=design/research/需求卡片-初始展开收窄批-2026-10-04.md（T0-T8≈5.25d，读数批 T5-T6 可切独立后批；拍板点 P1-P3 全读数后置；停机点 S1 相变警戒/S2 带越界回调）。✅ 实施批落地（2026-10-05，worktree m4iter14-narrow-20261005 状态记录 357；S1 停机呈报已裁=用户方案A）：T0-T4+T7+T8 全落（T5 结构读数随批出讫；T6 MC 四带复算读数批按切分预案后置，跑批待用户批准挂 07 现行义务）——甲=剃雷域收窄（shave_ring_radius 参数化，r=1→出生 5×5，全域 flood 剃雷退役，零 RNG 消费变化）+乙=R₀≤cap 重掷闸（合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标）+参数面两列（schema 域校验加载期致命+19 行投值）+断言面 +12（R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位）+夹具复核 3 处（relic 候选身份按 TP0 v2.2=kind |
tier | relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈）；S1 停机实录=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂（94% 拒绝/inf 0.976→0.719/常态非法板）→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕，12×12/13×13 健康侧维持；改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6（收窄自 68.6/83.2——10×10 −42%、12×12 −54%）/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标；玩法侧零改动（minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真）；闸=冒烟 767/0（+12）；registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组；06 视野条目已于 745b92ea 清账批退役（收窄立项即现行事实源）。②挖掘风险不等式判式换代批（2026-10-04 用户裁编入本迭代，作为迭代内需求）：判式三层换代（条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价）+β 比值带判读 [1.2,2.5]（u=3 登记态）+标中兑付溢价 δ=1.25（形态 a 兑付公式一处·危险格与安全格同池冻结不动）+runsum 旗行为五字段+audit 工具常量刷新（池 77/直伤 6-8-8/AP 8）；裁决全落零新拍板点（方案报告 §九（已退役，git 1da9a41）），需求卡片=.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md（T0-T5≈2.5d；条件二 T3 落文按登记已知破·T4 机制转绿；契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案；开工门=U0）。✅ 实施批落地（2026-10-05，worktree m4iter14-mineq-20261005 状态记录 356）：T0-T5 全落——audit 工具常量刷新（改前静态锚与方案报告 §四 逐位吻合）+runsum 五字段（行侧判据考证=授予行专带 highlight，87行==87插旗1:1）+F1 条款3 重立三层口径（v0.8）+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条（改前锚+P7 修正注记）+06 破线条收口+T4 标中兑付溢价机制（settlement.flag_hit_premium=125 provisional，grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现，标空/挖格不乘，DamageController 零改/同池冻结）+smoke 750/0（+3 断言；max 路径种子 42→43 重采）；判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感（η 位移 <1.4pp<5pp，保留+登记）/条件二判式口径等号压线转绿（整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面）；改后锚换代 runsum_m4iter14mineq_post_n200_20261005（perfect 冒险通关 65.3%→72.0% 增强向位移，四带判读归 M-4）；出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md（provisional 追认单 8 项+07⑫ 人工项）；damage_probe A1 红灯=改前既有非本批新增（在册）。③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=案A 资源面·微贫向偏斜（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；替换制（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=design/research/调研-全局作用域变异设计空间-2026-10-04.md，需求卡片已退役（git 01bfc15 批；裁决全录另见调研报告 §7）（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 状态记录 345）：T1-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七现行事实源落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；③出口成立——⑥A4 开工门解一半（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。④技能池执行批（2026-10-04 用户点名入列——调研+四裁+需求卡片全齐，06 Alpha 验证条目随之收口）：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+新机制一件=Boss 半血解锁新独占伤害技（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；需求卡片=design/research/需求卡片-技能池执行批-2026-10-04.md（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。✅ 实施批落地（2026-10-05，worktree m4iter14-skillpool-20261005 状态记录 358；goal 开工令 U0）：T0-T6+⑤ 全落（T7 读数批后置挂 07 现行义务，跑批待用户批准）——T0 表盘点零漂移；T1 敌人系统.md v0.13 五件全落；T2 skills.tres 有效倍率表批注〔D4 整数基线半点矩阵〕+enemy.tres EV 锚整数口径重登记+巨蜘蛛 1.11 消歧〔=atk1 口径非混用〕+registry enemy/skill 条目换代；T3-T4 机制件=unlock_hp_pct〔1,99] 可选键（schema 域校验，缺省无=无门槛）+容器闩 check_skill_unlocks（单向闩零随机）+双面过滤（保底不逼锁定）+编排归因行「XX 解锁了 YY」〔type=highlight 高光键 skill_unlock 零行型新增〕+呈现一次性技能名 toast〔排除 perfect_sweep 误触〕；T5 三 Boss 解锁技落表（震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4 案甲 provisional+池尾 weight2/unlock50）+断言基线换代 3 处〔技能表 12 行/池模板+门控条目/酋长 EV 锚重锚 1.10-1.30 实测 1.1948〕；T6 单测 skill_unlock_test 22 断言（run_all 15 套）+smoke +5 集成（半血→次轮解锁行恰一次/文本/行型零新增）；闸=冒烟 772/0+run_all 15+探针绿+doc 三闸零新增（reward_overlay_test 红=master 既有在册）。⑤✅ 提灯 +2 接线落地（同批顺路）：board_view.set_fog_lantern 公共接线面（半径算式迷雾批已在位；载体道具仍归 Alpha 信息件重定批=接缝就绪态）+ui_input_probe case⑮ 接线断言+HUD框架 注记⑤魔法提灯 +2 效果接线（小卡）：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、需求卡片冻结保留=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已合并进 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）。 |
| 迭代 15 | ①调试功能整合批（2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡，落地事实与验证读数零变化，只改编号归属）：主菜单三调试散件（随机种子输入框/角色数值调整板/两层调试入口）收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标（与主按钮组非平级，DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径）；浮窗=悬浮菜单之上 Dialog（不隐藏开始层，同确认弹窗形态；旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid）；可扩展滚动列表页四区块（随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探）。四拍板全落（2026-10-04 用户裁）=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达（_show_debug_overlay 门禁护栏+对局发起随开随收）/P4 可扩展列表。✅ 已全批入库（2026-10-05，worktree iter145-debug-hub 两提交 48c0b34/46dadbb，主区 merge --no-ff d0a3c6b/10c301b，状态记录 352）：闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿（worktree+主区双跑，主区跑前 --import 重刷类名缓存在册坑）；遗留=实机目检归用户（DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口） | 卡①门：迭代 14 出口（注：本卡先于迭代 14 出口已入库——编入时点迭代 14 ③已闭/①②④⑤进行中/⑥挂起，门列仅记编入时点状态，不构成追溯闸） | 单批已落地（原估 0.5d，实际一次会话）；后续扩调试项=debug_overlay.gd _build() 列表区追加区块（P4 扩展口径） |
| 迭代 15 | ②奇物概念收口与词族对齐批（2026-10-05 用户令编入本迭代）：概念层已由用户逐轮裁定定稿（《奇物》v1.0→v2.7，7 轮），本批只做落地对齐、不做二次设计。三批内容：①三套旧词族全面对齐（顶层已改名「奇物」而代码仍叫旧名＝用户最初抱怨的"文档与代码分开"）：feature_*→curio_*（103 处/7 文件）、relic_*→feat_*（162 处/12 文件）、运行层 bonus_*→curio_*（160 处/8 文件）。硬约束：reward_* 已被 reward_pick/reward_node/reward_preview 占用，统一词族不得使用；relic_table.gd 与两个控制器类改名须同步 Godot .uid/.tscn（非文本层无法自证）。②三条渠道按分类分离（现行三渠道共用同一个 98 张池、三类混编）：关底 Boss 击败＝通过这一关→只出专长；奖励节点/商店→属性值提升+资源、专长在此只以凭证形式出现。兑付频率红线：奇物不是打一场战斗给一份，关内普通战斗节点打完不给任何奇物，一关之内只兑付一次（用户 2026-10-05 纠错）。③两个新种类入池＝刷新次数（须先与"商店独立刷新机制"划清边界）+ 专长获取凭证（拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底：连续 5 次三选一展示未出→第 6 次必出，刷新重展计入、奖励节点与商店共享计数）；附带 shop.tres 补回复（默认原则要求分类内成员都在该出现的渠道池里）与 charge 标签补至 ≥4 件（现仅 3 件，档二永远达不到——数据缺陷）。设计事实源=design/gdd/systems/冒险循环/奇物.md v2.7，需求卡片=design/research/需求卡片-奇物词族对齐与渠道分离批-2026-10-05.md（T0-T8≈4.5d，两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕，切分点=T3 出口；11 条设计契约含 6 条 🔴 停机级；12 条批末验收断言；代拍板白名单 5 项；待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/凭证四参数终值/存档键正式迁移〕）。开工门：与在途 M-4 各批（判式换代/全局变异/配比预设）撞同一批文件（adventure_table.gd/level_runner.gd/adventure.tres），须确认不并行或用户明示插队 |
卡②门：迭代 14 出口 | 卡①已入库（原估 0.5d）；卡② ✅ 已全批入库（2026-10-05，worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5，主区 merge 见状态记录；出口报告=iter15-2-curio-exit-report）：三套词族代码层全换（feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名）；渠道白名单分离（总池-渠道子集多级缓存形=用户裁）；凭证入表（四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数）；refresh 入池（B 案 heal 5→3 挤占）+shop.tres 补 heal 行+凭证行；T2 裁点甲案=六存档键禁改（含需求卡片漏登记的 "relics" 键）；charge 缺陷登记不硬补；autoplay 凭证分支缺陷批内实测修复（MC timeout 形态）；闸=冒烟 782/0（+10）+run_all 16 套历史首次全绿（reward_overlay 红转绿=M7 bcard 成因修复）+五探针绿+doc 三闸零新增+MC n200 只测不判（normal 0.5%/perfect 77.5%）；遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d（实际一次会话）；迭代 15 三卡全已入库（①352/②本批/③8944dca 前身③批+本批） |
| 迭代 15 | ③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）：设计侧已完成（消歧更名批 430419c+06e94b7，26 个设计文档「魔法道具」→「秘宝」，同调位机制名保留不变），本批只做代码侧对齐、不做二次设计。内容：aux_*/AuxItem* 词族全族换词 358 处 / 36 文件（重灾 adventure_runner.gd79 / level_runner.gd27 / bonus_interact_controller.gd19 / battle_orchestrator.gd18 / config_db.gd14 / main.gd13），分五组落：A 玩家可见文案（P0，5 处）=battle_narrator.gd:117-118 + bonus_interact_controller.gd:76 + hero_info_panel_view.gd:56（槽位标题 UiKit.label）+ :178（tooltip）· B schema 与数据表（aux_item_table.gd/aux_items.tres/aux_items.gd 文件名+类名+ConfigDB 持有变量与访问器全链跟改，须同步 Godot .uid/.tscn + --import 重刷类名缓存——迭代 14.5 实证在册坑）· C 文档链接修复（含 architecture.md 两处既有断债顺带清偿）· D 中文注释层（须分色：魔法矢/魔法反噬/魔法族/魔法护甲 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。用户三项拍板：全族彻底改（含数据表）· 断点存档键一律保留（bonus_aux_carry/aux_detail/aux_cleared/aux_cleared_last/aux_items 断点数组/attunement_charges 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 aux_items 不改（数据契约键）。设计事实源=design/gdd/systems/跨局循环/秘宝.md v0.9，需求卡片=design/research/需求卡片-秘宝代码词族对齐批-2026-10-05.md（T0-T9≈5.0d，超软盒 3 日上限·知情预挂：T7 段末闸后 L3 呈报切点不擅切；三档降级面 G1/G2/G3 在册〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 5 项；C1/C2 已裁关闭·全改保一致·待裁点 0 项）。撞批已消解：② 奇物批 2026-10-05 收口落库（合并 c571af2），并行风险解除，本批为迭代 15 唯一在途需求；T0 须重取基线（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。✅ 裁决（用户 2026-10-05「全改保一致」）：C1 "aux_item" 域串照改（实测连锁面收窄——reward.tres 已零 aux_item 数据行，池种随迭代 11 T7 退役；16 处字面量全在代码内闭合无存档依赖；唯一连锁项=smoke_all.gd:3932 断言须同步）· C2 aux_items 一名两义拆分（ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——「键名禁改」与「变量名禁改」是两回事，禁改的只是落盘字面量）。新增组 F（分派语汇与域串 16 处），任务卡扩为 T0-T10≈5.5d。开工门：✅ 已无待裁点，可直接发 T0 |
卡③门：迭代 14 出口（裁点已全决·可开工） | 卡①已入库（原估 0.5d）；卡② ✅ 已全批入库（2026-10-05 merge 3c6f2c9，状态记录 362——c571af2 文档+数据层之上的实施段全量补完）；卡③ ✅ 已全批入库（2026-10-05，worktree m4iter15-mibao 九提交 b4b8bb3..收口笔，主区 merge --no-ff 哈希见状态记录/active.md 快照行；出口报告=iter15-3-mibao-exit-report）：词族实数 364 处/36 文件全换尽（例外 43+2 处=存档键引号字面量+夹具，穷举在报告 §五）；闸=冒烟 755/0+run_all 14/15（唯一红=②批遗留基线红 reward_overlay，对照零新增）+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免（静态零漂移证明代）；渲染像素五闸屏蔽挂账 07⑮；遗留=实机目检归用户（07⑮）+reward_overlay 基线红归②批处置 |
| 迭代 16 | UI 设计对齐批（2026-10-05 用户令：迭代 16 改编为 UI 优化需求实现，原四卡全数顺延迭代 17；美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动）：三路改进整合轴的代码侧落地——事实源=design/research/UI预览demo三路改进整合对照-2026-10-04.md（A 落码差异对照+OPT-A 机检+WB 变体三路整合，基线原型 v2.1）。红线=不修改美术资源：game/assets/art 与 artwork/ 均不动、不生新素材不重烘，只改 UI 设计代码（ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等）。无分歧可直接收项=对比度 7 处 FAIL 修法（血数 2.09→12.29 垫底等已复算）/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。前置待裁=六分歧点（①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法，对照表 §三）+开放项（抖动范围/色板唯一来源，§五）。需求卡片=design/research/需求卡片-UI设计对齐批-2026-10-05.md（T0-T11≈7.25d，超软盒 3d 预挂，三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕；🔴 契约 7 条 R1-R7；无分歧收项 N1-N6 已逐处 file:line 考证；待用户裁点 11 项=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免；六分歧与开放项一律呈全备选案含淘汰依据）。事实校正（实查，2026-10-05）：9 处色板漂移实测 4 已收 5 未收；tg-* 五族在 ui_kit 并不存在（以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view，缺第五族）；panel_skinned 消费面实测 8 处+工厂 1 处；棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等；手绘图标十枚 20×20 已入库，真问题转为 64×64 柜台四枚显示倍率；站桩溢出实机存在 1px 余量同型写法（standee_body.gd:476）；demo 基线 md5 已再次漂移（实测 78ebbee0…）。状态=需求卡片已起草（2026-10-05）+ 取向已定（2026-10-06）：✅ P1=甲（维持暖化零改动）/ P2=丁（棋盘格边长零改动，46/45/44 不一致登记为已知偏差）；✅ 其余八项取向已定（用户采纳推荐）——跟 demo：P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩；按条款解：P3 字号立 FS_* 档（demo 34 处<14、54 处<16 不可跟）/ P6 图标显示档（demo 自身 0.3125× 违规）/ P8 抖动只做卡顶色带（demo 渐变+blur 违反像素纪律）/ P11 装饰 caption 12px 豁免；P5 两路同结论。「以 demo 为准」三层优先级栈=需求卡片 §8.3（①用户终裁＞②冻结条款＞③demo）；三条结构级差异（卡片 232×352 / 商店全屏化 / 地图底栏合并）不入本批、已登记 06 待立项。估时 T0-T11≈6.9d（段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d；三段同属一迭代、只在段三末合并一次）；拷打轮一 9 问已全部落地（Q1 panel_skinned content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源）。✅ 已全批入库（2026-10-06 单会话，worktree g-plan2-iter16ui 分支 iter16-ui-20261005 十二提交 85ea024..T11 收口笔，主区 merge --no-ff 哈希见 active.md 快照行；出口报告=iter16-ui-exit-report）：T0-T10 全落（T10 人闸材料包=iter16-ui-human-gate-checklist——实机目检+代拍板追认八项归用户）；闸=冒烟 782/0（断言数持平基线）+run_all 16 套全绿+探针五件全绿（新增 ui_contrast_probe 11 对测点+ui_struct⑥standee 断言族入默认段）+doc 三闸/熵增零新增+MC 零跑（纯呈现批——核心/数据层 diff=0 实证）+素材零触碰；T0 实机复算三处修法改向（意图徽标垫牌/槽位字深化/RAP 零改动——demo 口径在实机反向）+N4a 裸色实数 25 处/10 文件全收 ui_kit（需求卡片 5 处系漏记）+字号 107 位点归档 FS_* 六档；偏差八条在出口报告§汇总；遗留=06 新登记「呈现层残余 <4.5:1 文字位」一条（名行四墨/顺位徽标/RAP 反馈——批外邻接发现） |
迭代 15 出口 | 预算 T0-T11≈6.9d（三段切分）——实际单会话一次跑完（2026-10-06） |
| 迭代 17 | ⓪内容数据驱动扩展批（2026-10-06 用户令插队为头卡——①-④卡顺延，其需求卡片与裁点状态原样保留）：把内容效果行为从结算代码硬编码搬进数据行「订阅事件（on）+条件（when）+效果类型（do）」，通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 .tres 零代码。裁决八条全落（R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律：事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则，禁 hook/合并律等自造词）。词汇表定稿=实施 16 事件+效果类型 19 行 23（v1.1 扩 damage_mult/open_ticket 两型装下减半/开单现状）+组合规则 6；存档零改动；文案表值化随批（现有实现判据）；luck_coin 经 reward_roll 迁移随批。需求卡片=design/research/需求卡片-内容数据驱动扩展批-2026-10-06.md（v1.1 2026-10-06 联审修订：level_clear 归登记不实施/对拍判据两套〔确定性复放与冒烟=逐位、MC 统计量=成型画像同带 m4iter12 口径〕/映射表五处语义修正/断言面随迁与订阅重建时机补列；T0-T7≈4.5d，零待裁点，🔴 契约 5 条含行为等价两套判据+护栏保留+确定性；停机点 S1 首流派对拍/S2 批末闸；开工门=U0） |
迭代 15 出口（已解） | T0-T7≈4.5d |
| 迭代 17 | ①敌人表行集多行批（2026-10-05 用户令编入本迭代，纯功能与数值轴四卡之一）：放开敌人表「同一（关卡序号 × 节点深度）行集恰一敌种」加载期校验（enemy_table.gd:108-112 考证在册），允许同场遭遇混编多种敌人——生成（unit_container spawn 行集受理）/编排（battle_orchestrator/narrator）/断言面全链接通 + GDD 结构冻结面修订先行（敌人系统.md:75/:263）。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面（前半已由关卡节点地图 v1.0 消解）；前置=技能池实施批已入库（d3fa887）开工门已解。需求卡片=design/research/需求卡片-敌人表行集多行批-2026-10-05.md（v1.1 2026-10-06 联审修订：F7 勘误 19 行 9 敌种/P1 补遭遇骰交互〔每行一骰·RNG 扩签先报批〕与实例总数≤4 消歧/P3 改裁丙撤投放/新增契约 R6 混编行行序纪律/expect_pools 断言换代入组 D；T0-T8≈3.75d〔T5 撤投后，超软盒预挂，T4 末切分点〕；🔴 契约 6 条；✅ 裁点全裁（2026-10-06 用户令：P1甲〔Q8/Q9 二裁补全〕/P2甲/P3丙〔Q3 二裁撤投放——一裁乙与首遇教学位纪律三面冲突〕/P4乙 Boss 行亦放开·知情代价六面在册）；开工=U0） |
迭代 15 出口 | ✅ 已全批落码入库（2026-10-07，主区 merge --no-ff 9cc4b8b，闸全绿+主区复跑全绿〔合并后冒烟 811/0〕，worktree g-plan2-iter17-enemy 分支 iter17-enemy-20261007 基点 e535436，批内提交 a0b06b4(L3 报告)/5b9cf59(甲案裁决)/18cdcb0(T0)/ab5ddad(T1)/8690230(T2)/bc73fa3(T3)/c583940(T4)+收口批；一次 L3 停机=卡⓪改前锚随 worktree 删除丢失不可恢复→用户裁甲案补采改前锚 40 局·总量 80 局明示批准；出口报告=iter17-enemy-exit-report）：行集构成纪律三条落码（同坐标多行混编放开含 Boss 行集 P4乙+行序相邻加载校验 R6+实例总数≤4 spawn 守卫 P1甲）+floor 版解析退役全仓统走 ceil 行集数组（P2 甲，状态记录 312 销号）+spawn 行集受理逐行实例化+遭遇骰逐行各掷（Q8——单行行集消费序/次数逐位一致=零内容期随机流零变化）+断言面换代（expect_pools 三元键/双表精确行集契约/L2L3 定点行集口径）+混编正反断言十一条（冒烟六+单测五）；文档=敌人系统 v0.15/难度曲线与Boss v0.24/registry/06 状态行；闸=冒烟 811/0（基线 805/0，+6 混编断言）+run_all 17 套+probe_gate 含 click 全绿+doc 三闸/熵增存量红零新增+MC 改前改后 40 局同种子全字段零差异（零漂移铁证；补采锚 L1 口径读数 off 4/20·formed 16/20 与卡⓪出口报告逐位同值=等价旁证）；人闸=实机目检四项+代拍板追认九项（design/qa/iter17-enemy-人闸材料-2026-10-07.md。原估 T0-T8≈3.75d） |
| 迭代 17 | ③暂停层只读入口批（2026-10-05 用户令编入本迭代）：新增局内暂停层，承载钥石余额与解锁态（营地三柜台进度）只读查看——事实源=06「解锁界面与钥石呈现的交互形态（残余：暂停层只读入口）」条。考证在册：现行无暂停层；模态栈/设置面/调试浮窗三先例齐；UiKit 公共件（modal_shell/bcard/verb_button/徽章形制）与色板 token 单点现成；MetaProgression 只读访问器面齐全；战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。美术红线：复用现行公共件与色板，零新素材零新色值（2026-10-05 用户立规）。需求卡片=design/research/需求卡片-暂停层只读入口批-2026-10-05.md（T0-T5≈3.0d；🔴 契约 5 条含公共件单点/模态登记纪律；✅ 裁点全裁（2026-10-06 用户令全按推荐：P1丁/P2甲/P3甲/P4甲）；开工=U0） |
迭代 15 出口 | ✅ 已全批落码入库（2026-10-06/07，主区 merge --no-ff c8beaa2，闸全绿，worktree g-plan2-iter17-pause 分支 iter17-pause-20261006 两会话接力完成，提交 c08a901/fc9eb1e/d44fdd5+收口笔；出口报告=iter17-pause-exit-report）：暂停层本体+badge 工厂件收编（Q10 甲，营地钥石徽同步迁移观感零变化）+两屏常驻角标入口与 has_open 守卫+四探针断言（结构/点击/输入锁 case⑯/只读巡检/零动效契约/对比度对）+冒烟投影一致性 5 断言；闸=冒烟 788/0（基线 783/0）+run_all 17 套+probe_gate --click 全绿+doc 三闸零新增+MC 零跑（纯呈现零数值）；存量移交=熵增闸 design/diagrams 越界（00712d5 总图批已入库漏步，主区同红）+06/07 gdd_lint 存量注记红（本批零触碰）；人闸=用户实机目检（design/qa/iter17-pause-human-gate-checklist-2026-10-06.md，重点含排播排空副作用确认项 D2。原估 T0-T5≈3.0d 贴软盒内） |
| 迭代 17 | ④生涯界面设计立项（2026-10-05 用户令编入本迭代；只做设计提纲不做实装）：事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条（P-C7 裁：M9 已退役局内结算明细回看，历史数据现无承接面=用户知情裁决）。考证在册：回看退役已落码（battle_end_overlay/battle_log_view/ui_assembler 三处注记）+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+recent_summaries 现役逐局留痕（cap=10，save_manager.gd SUMMARY_CAP——2026-10-06 联审勘误：原记「无历史冒险记录面」系事实错误；真实缺口=cap 扩容+用时埋点+总局数/通关局数 lifetime 计数域〔涉存档 schema〕+营地既有最近冒险清单的去留设计）。需求卡片形态=设计提纲版：信息架构+承载内容清单（跨局汇总/历史冒险回看/图鉴承接）+与既有界面关系+三期实装建议+待裁点，标注「实装批另行立项」。需求卡片=design/research/需求卡片-生涯界面设计立项-2026-10-05.md（v1.1 2026-10-06 联审修订：F4 改正 recent_summaries 现役/P2 甲口径重述=扩容+用时埋点/总局数通关局数标注涉 schema/营地清单去列入设计稿必答项/N 候选补「维持 10」；T0-T2≈1.25d 纯文档零测试；✅ 裁点全裁（2026-10-06 用户令全按推荐：P0甲/P1甲/P2甲〔N 实装期定〕/P3甲/P4甲/P5甲）；开工=U0） |
迭代 15 出口 | ✅ 设计提纲已成文待用户评审（2026-10-06 卡④设计批完成，worktree iter17-career-20261006，纯文档零代码零测试）：提纲=design/gdd/systems/跨局循环/生涯.md v0.1（范围草案——信息架构/承载内容清单/界面关系/分期建议/待裁点五节，P0-P5 已裁结论落文，新发现待裁点 P6 营地最近冒险条带去留随评审一并裁）；02 根索引补行+06 状态行换代「设计提纲已成文待评审」。人闸=用户评审提纲；评审通过后期一/二/三实装批另行立项（不预占排期。原估 T0-T2≈1.25d 软盒内） |
| 迭代 18 | ③武器锻造系统设计提案批（2026-10-06 用户令入迭代 18；纯文档零代码——提案源=playnote 2026-10-06）：用户提案=攻击力提升改造为「武器锻造」——剑（普攻）锻造升级加攻击、满级附带额外效果；后续增列长枪/法杖，攻击类型分别走穿刺/魔法；护甲由轻甲起级（先只提 AC）→解锁重甲/魔法甲（基础 AC 各异、可续升、满级各带额外效果）——武器/护甲差异化。产出=系统设计提案文档（与奇物属性值提升分类/护甲克制轴/营地柜台/锻造经济边界对齐，数值框架 provisional 终值归 Alpha 收官 M4 数值批统一调整〔未排期〕），裁点呈用户裁决；实装批另行立项。06 已登记专条。需求卡片=design/research/需求卡片-武器锻造系统设计提案批-2026-10-07.md（提纲版 v1.0——设计裁点在提案产物内全备选呈裁，需求卡片零待裁点；开工=U0） |
🔨 提案已成文交付（2026-10-07）待盘问裁决（异步不阻塞） | T0-T2≈1.5d（一轮呈裁基线，盘问轮次扩展另计） |
| 迭代 18 | ④生涯界面实装批（2026-10-06 用户令入迭代 18）：按迭代 17 卡④设计提纲（design/gdd/systems/跨局循环/生涯.md v0.1，master 44328b1）实装「生涯」界面——跨局汇总/历史冒险回看/图鉴承接；提纲在册要点=recent_summaries 现役 cap10 扩容+用时埋点/总局数与通关局数（涉存档 schema）/营地最近冒险清单去留（P6 必答项随评审定）；分期建议随提纲。需求卡片=design/research/需求卡片-生涯界面实装批-2026-10-07.md（v1.0——范围=提纲期一〔汇总页+主菜单入口+终身计数域存档 v6〕，期二/期三零触碰；裁点 P1 通关局数口径/P2 汇总条目集/P3 模态登记序待裁；提纲评审若改期一范围则需求卡片升版） |
✅ 已落地（2026-10-07 worktree iter18-career：提纲期一追认+裁点全裁〔2026-10-07 用户令代解/全甲；P6 随期二〕后 T0-T5 全落——生涯页六类九项+主菜单入口+终身计数域存档 v6；批末重闸全绿=冒烟 834/0〔基线 814/0，+20〕+run_all 17 套+四探针+ui_contrast 15 对+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔⑲目检条目随 07〕；出口报告=iter18-career-exit-report） | T0-T5≈2.5d |
| 迭代 18 | ⑤混编遭遇首批投放批（2026-10-06 用户令入迭代 18；纯内容批——机制前置=迭代 17 卡①敌人表行集多行批）：07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放（敌种候选与坐标=本批裁点）；首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）；难度带读数义务随批登记 07，MC 取证跑批顺延 Alpha 收官 M4 数值批统一执行〔未排期，届时另令——2026-10-06 用户令：数值统一调整殿后；投放本身不阻塞〕。需求卡片=design/research/需求卡片-混编遭遇首批投放批-2026-10-07.md（v1.0——纯内容批零代码，机制面全由卡①承载，机制缺口=L3 停机；裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁） |
迭代 17 卡①已入库（✅ 已满足 9cc4b8b）+✅ 裁点全裁（P1-P4 甲，2026-10-07）——开工=U0 | T0-T5≈1.75d（MC 取证顺延另计）——✅ 已全批落表（2026-10-07，worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56，批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批；出口报告=iter18-mixenc-exit-report）：(2,5) 双行混编落表〔重击手+巨蜘蛛巢群（行值复制 (2,6)，P4 甲零数值新增），R6 行序=重击手在前〕；d5/d7 候选与行值来源全案留痕（d5 案选定）；断言面随迁（expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言）；首遇教学位 (2,4)/(3,0)/(3,1) 零触碰；07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正；闸=冒烟 814/0（基线 811/0，+3）+run_all+doc 三闸/熵增零新增（批末重闸数字见出口报告）；实机目检三项归用户（同场两敌种/行序/总数 ≤4）；MC 零跑（顺延 Alpha 收官 M4 数值批在案） |
| 迭代 18 | ⑦新冒险种子随机化+调试浮窗升级（2026-10-07 用户令入迭代 18，同日两裁点全裁+浮窗目标态已定）：(a) 种子随机化——现状考证 main.gd:1210 _seed_value() 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现；改法=玩家界面入口（主菜单开新冒险）默认分支随机生成；✅ 裁点全裁（2026-10-07 用户令）：①首次冒险维持固定种子（教学态可复现）/②测试脚本与调试接口维持显式指定种子（冒烟·MC·探针全链显式传种子零影响，锚零作废）/③种子不进玩家 UI；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；与⑥收官批零耦合、排序自由。(b) 调试浮窗升级（承载「调试浮窗可查当局数据」裁点=种子的唯一查看位；本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决）——目标态三件：独立于整体界面的最高层浮窗（对局中也可开）/DS_DEBUG=1 调试态下默认打开/新增当局数据只读区块（当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查）。考证在册（2026-10-07 实查）：现行=开始覆盖层角标入口〔main.gd:292-293，DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块（胜利演出/种子输入/数值滑条/批量模拟/两层调试）无当局数据面。需求卡片待裁点：最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态（角标宿主迁移或热键）。需求卡片=design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md（v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁；估时勘误 1d→2.0d 含探针换代与收口） |
✅ 已落地（2026-10-07 worktree iter18-seed：C1 种子三分+浮窗升级 P1-P6 甲全落；批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔不阻塞已入库与后续卡④〕） | T0-T5≈2.0d |
| 迭代 19 | 卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）：①主菜单开新冒险+继续上局两入口补传同调三键（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②关卡开场行攻血改传当前生效值（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）：三件主内容——①渲染闸自动化：新增 tools/render_gate.sh 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 game/tests/golden/（测试资产入库先例，.gitignore 已核只挡 artwork/）；probe_gate 头注释「渲染闸归真人目检」纪律句删除改写（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②探针收编：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate --full 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③账务修正：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代，本卡改称卡①，新增卡②③④见后〕。需求卡片=design/research/需求卡片-自动化验收补齐批-2026-10-07.md（v1.1——待裁点 0 项，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；需求卡片=design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）〔2026-10-08 施工已入库·S1 停机态——T1+T2 测点对 15→38 对（+23：battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1，全 UiKit 常量实时求值）；新对首跑暴露存量对比度违例 7 项（结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1）——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁，处置权归用户、批内零修（红线）；违例对在册=闸红登记存量形态，修复批落后自然转绿；T3 struct 13→15 根（legend/node 全真路径开合）首跑全绿 S2 未命中、WL 零新增；冒烟 840/0+run_all 17 套件持平；出口报告=design/qa/iter19-uibackfill-exit-report-2026-10-08.md；settlement_review 遗留件已在 06 登记落位〕。卡③CI 预接线批（B6，2026-10-07 用户令立项）：tests.yml 场景探针段解封——轻 CI 段=input/struct/contrast 三探针（示例引用的 ui_probe/ui_click 归 --full 重闸不进轻 CI）、Linux 独立命令形态（probe_gate.sh 系 Windows 专用）、窗口化四件禁入 headless CI；本地无远端端到端验证不可能=验收全静态核验，「首次 push 后人工盯首跑」入移交清单；远端仓库计划两文档零登记=待裁呈报项；需求卡片=design/research/需求卡片-CI预接线批-2026-10-07.md（v1.2——触发分支死角已并入修正范围=tests.yml push/pull_request 两处 [main]→[master]〔实查：实际分支 master、main 不存在，不修则远端建好后 CI 仍永不触发〕+冷检出导入步前置 smoke 步骤之前；裁点①远端仓库=✅ 2026-10-08 裁暂不建维持待命〔预接线待命=终态〕/裁点② ui_layout 入 CI 候卡①后裁；T0-T3≈0.25d，worktree iter19-ciwire）。✅ 卡③已入库（2026-10-08，B6 闭环——出处=自动化验收补齐批 §一明示不收件，随本批销账）：注释探针段解封=正式轻闸三探针段（input/struct/contrast，timeout 120s 外壳+退出码 124/137 超时判+PASS 串判定=probe_gate 判定逻辑 Linux 独立镜像，三探针全跑不短路汇总定红绿）+冷检出 --import 导入步 300s 前置冒烟之前（job 级基础设施步同覆盖冒烟与探针 .godot 依赖）+触发分支两处 [main]→[master] 修死角+头注释追加「远端仓库建好后无需改本文件即自动生效」；探针日志落 logs/probe_ci/ 顺现有 upload-artifact 段零改并入；验收全静态过（pyyaml 解析/CI 段 res:// 引用逐一实存/timeout 外壳清单齐/轻闸术语与 probe_gate 口径对齐/diff 面=tests.yml 单文件+roadmap 本行）；⚠ S1 呈报项（该段冻结未代修，处置待用户裁）=tests.yml setup-godot 步 nikeee/godot-actions/setup-godot@v2 指向不存在仓库（2026-10-08 实查：GitHub API 404+nikeee 全部 159 公共仓 grep godot 零命中+marketplace 同名件=Vitorgus/Setup-Godot v1 系 Godot3 旧件；现存活跃替代=chickensoft-games/setup-godot v2.4.3）——远端建好首跑前必须先裁此段，否则 smoke job 必红；首跑盯梢清单随需求卡片 §七 待远端立项之日激活。卡④提灯载体道具批（B4，2026-10-07 用户令立项；原登记去向「Alpha 信息件重定批」就此改道入本迭代）：board_view.set_fog_lantern 死接口（迭代 14⑤ 接线+case⑮ 断言在位，载体始终未造=完成度 0）补载体道具；备选案五件全列（案 A 秘宝同调位新行=原登记指向·推荐/案 B 专长新行·撞重设计冻结不推荐/案 C 商店货架·分类判据需新裁/案 D 显影尘行激活合并·与改道相逆/案 E 元进度树·破坏读数归因不推荐）+淘汰案六件各附依据，设计权全归用户；需求卡片=design/research/需求卡片-提灯载体道具批-2026-10-07.md（v1.2——✅ 裁点全裁：2026-10-08 载体=案A秘宝同调位新行〔行字段推荐值=执行中一次秒答，「按推荐」即全收〕；缺陷处置=卡⓪随同 goal 先行入库=本卡 T1 前置门〔缺陷实查定案影响全部开局入口；原记迭代 20 缺陷批，2026-10-08 并入本迭代为卡⓪〕；呈现桥=只读访问器/复原语义=begin_battle 显式重算/MC=静态论证/测试三形态等工程面全钉死，T0-T5≈2.5d，worktree iter19-lantern）。✅ 卡④已入库（2026-10-08）：T1=treasure_items.tres 表尾追加 fog_lantern「魔法提灯」行（行字段=用户「按推荐」全收——display_name 魔法提灯/desc 灯光区半径+2/id fog_lantern/slot_cost 1/稀有度不设字段/unlock_requires 键省略=已解锁；form=passive+triggers 显式空数组〔活行空 effect_kinds 豁免以 row.has(triggers) 为条件〕+effect_kinds=[]/target=none/magnitude=0/use_phase=active_dig/dimension_tags=[info]；表尾追加保 MC 自动档装配画像逐位不变=零漂移）；T2=接线生产路径贯通——orchestrator 装配集公共只读出口 attune_has（_attune_has 契约化）+组合根呈现桥 main._sync_fog_lantern 挂每战首轮装配链显式重算含否（round_started 首轮发射位在 begin_battle 尾 attunement 注入后=时序安全；board_changed 先发后注入故不挂）；T3=测试三形态（case⑮ 内载体级段不开新 case+smoke 现有套件加断言〔冒烟 840→844〕+存档回归 breakpoint Part 6+新单测 fog_lantern_wiring〔run_all 17→18 套〕，case⑮ 既有断言零删减）；T4=改道指路句实查六处全换代（board_view.gd :139/:145+art-bible.md:387〔顺手对齐常量实名 FOG_LANTERN_BONUS〕+HUD框架.md :168/:170〔:170 同句 2 处整段换代〕；qa 历史成文零触碰）+06 缺陷条已入库回写+秘宝.md 目录九件→十件（v1.1 行）；T5=重闸三件全绿（冒烟 844/0+probe_gate 含 --click 全绿+run_all 18 套，残留 Godot=0）；MC=静态论证零实跑（纯呈现层 off 态零生产路径变化）。出口报告=design/qa/iter19-lantern-exit-report-2026-10-08.md |
迭代 18 出口（✅ 已解——2026-10-07 四卡总收口已入库）——开工=goal 一次跑完（2026-10-08 裁：卡⓪缺陷卡先行+卡①-④打包，全绿前禁停；subagent 并发 ≤3；唯一预期交互=卡④行字段推荐值秒答；卡⓪原迭代 20 头卡A 同日用户令并入本迭代） | 卡⓪≈1.0-1.5d（随计划书定稿）+卡①T0-T6≈4.25d（超软盒预挂；天然切分点 T2 末——段一 T0-T2 渲染闸≈2.25d / 段二 T3-T6 收编退役账务≈2d，两段同属一迭代一次合并）+卡②T0-T4≈1.0d+卡③T0-T3≈0.25d+卡④T0-T5≈2.5-3.0d（切分点 S0：考证呈报 0.25d/实装收口 2.25-2.75d）——五卡合计≈9.0-10.0d |
| 迭代 20 | 专长实装批（奇物）——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（v1.1）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）。候选 B-F 留档不变。✅ 已入库（2026-10-11 goal 会话 U0 开工——A/B/C 三段 T0-T10 全落 master：T1 词表扩签 a57489e/T2 案D 池 0640b0c/T3 29 行换代 54ab330/T4 凭证五件 1387aed/V4 补齐 5ebd05d/C 段收尾 3333187；冒烟 864/0+run_all 21 套+MC 同种子重放逐位复现；29 行件数口径+四级配额 104+疼痛记忆同战消费放宽+时沙/弃图兑换落法映射系代拍板追认单待用户） | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | T0-T10 ✅ |
| 迭代 21 | 天赋树实装批（2026-10-11 用户令编入——整卡不切分，迭代容量放宽容纳全卡）：按 天赋树 v0.4 设计权威文档实装——29 节点结构换代（schema 等级阈值前置新形态/Fork 词表 4→3 组/规则键词表 2→6 键）+三组 Fork 真效果（开局姿态每关首轮窗/危险直觉与财富之道·限次计数随冒险持久按关重置）+营地统一案甲（树=营地主界面/属性升级唯一入口/工作间钥匙模型/图鉴常开/占位面板零副作用硬要求）+注入公式换代（基础值+树淬炼+锻造路线加值位预留+局内加算）+旧属性柜台退役+旧档废弃与旧逻辑删除（开发阶段无迁移，Q3 裁决）+同调位槽位判定源切树节点（旧条件删除随批清扫）+树上刷新升级接线（双入口并存写同账）。需求卡片=design/research/需求卡片-天赋树实装批-2026-10-11.md（v1.1，grilling 五裁+歧义扫描六裁全落，零开放待裁点成立）；并行在外=武器锻造 17 裁点会话（不阻塞，Q5 默认本批先行）；T0 含标错机制存在性实查（查无则守侧换案经用户裁） | 卡片成立（2026-10-11 用户令编入） | T0-T7≈7.0-8.5d（整卡单迭代） |
| 迭代 22 | 秘宝体系实现重构落地批——需求卡片=design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md（v1.2 零待裁点已成立）；2026-10-11 用户令编入：新目录 12 件实装+解锁混合制（逐件分配锁定表在卡）+装配不可变（冒险中零更换）+旧 14 行数据清理+效果引擎接入；槽位来源不在本批（树接口接缝、无槽位不能带、测试走调试注入——C4 裁）；估时 6d（区间 5-7d）；开工门=U0 | ||
| 迭代 23+ | M4 数值批（原 22+；迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批，均 2026-10-11 用户令——Alpha 收官位·未排期〔2026-10-09 语义换代：M4=Beta 阶段、非 Alpha 收官位，M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次）：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，需求卡片 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）。需求卡片=design/research/需求卡片-M4数值批-2026-10-05.md（v1.2 2026-10-06 案C 增补+联审修订：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0） |
迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+用户发令（未排期）——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d） |
执行纪律（2026-09-27 用户立规）
- 一迭代一 loop：所有更改任务（功能/文档/数值/素材接线）一律进本路线图的迭代，每迭代先立计划书再开工，一个迭代一次合并登记——零散并行会话退场（多会话并行 = 冲突源+介入成本；2026-09-27 起单迭代串行执行）。状态记录记「批」= 本文件记「迭代」，同物异名。
- 例外 = 零碎 bug：单独会话 mini-loop 修复（修→轻闸→状态记录登记），不立计划书、不占迭代位；同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。
- 用户输入闸显式化：迭代门里所有需要用户表态的点（否决原因/裁决/试玩）在「当前位置」挂起清单可见，解一个开一个。
批次 loop 规范（loop engineering）
模板先例 = 循环 1 计划书（
.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md，已完整跑通收口）。每迭代照此八件成文，缺件不开工。迭代粒度界定（对齐敏捷迭代/Sprint）：一个迭代 = 一句迭代目标 + 3–8 个更改任务 + 一份计划书 loop + 一次合并登记，交付一个可验证增量（≈一次迭代交付）。单交付物不成迭代——并入相邻迭代当任务卡；用户输入闸未解的任务不进迭代（留 06 当 backlog，解闸后编入下一个迭代）；迭代周期 ≈ 一周左右（2026-10-11 用户裁定——原「软时间盒 ≤3 个工作日，超限即切迭代」系
3abb3bd2成文时自造、用户从未立过此规，就此废弃）。里程碑 = 2–4 个迭代的发布级目标 + 出口验收闸（≈Release）。
- 计划书（
.zcode/plans/<迭代名>-loop-plan-<日期>.md）：迭代目标与完成定义 / 现状事实（代码级，开工自行复核）/ 设计契约（违反即返工，标 🔴 触碰=L3 停机）/ 范围边界 / 任务卡 T0..Tn（逐卡估时）/ 验证闸 / 异常分级 / 代拍板白名单。 - T0 开工：建 worktree + 基线复读记档（冒烟/探针/三闸/MC 对拍基准）+
git status归属核对（并行遗留只标旗不碰）。 - 循环骨架：一轮 = 一个任务卡——读卡 → 对事实源 → 实装 → 轻闸全绿 → 提交（代拍板随 commit 记录）→ 状态记录追加（查撞号）→ 下一轮。单 worktree 多点提交一次合并；轮内禁开第二个 worktree；基线每轮开工时点重测；断点续跑 =
git log对任务卡定轮次 + 重跑当轮轻闸。 - 轻闸（每轮必跑，headless）：run_smoke 全量 + ui_input_probe（十一断言）；触碰 presentation 加跑 ui_click_probe + ui_layout_probe。
- 重闸（批末 Tn）：全量轻闸 + doc 三闸（doc_link / gdd_lint / doc_term，对基线零新增）+ 熵增闸 + MC 逐位对拍（涉核心）+ 素材批加机检断言。
- 人闸（停机交付）：真人目检清单 + 代拍板追认清单 + 异步终审触点（样张类）——本循环内唯一必经人审。
- 异常分级：L1 自救（一次重试）→ L2 记录继续（连续 3 次同红灯升级）→ L3 停机写报告等用户。
- 收口五步：①active.md 快照 ②状态记录条目 ③里程碑移动更新本文件 ④阶段变更改 stage.txt ⑤批末闸序列全绿留痕（loop_dashboard 已随目录收敛退役，透视职责由 06+状态记录承接）。
维护纪律
同「批次 loop 规范」第 8 条收口五步；本文件由里程碑移动触发更新（批次开工/收口不强制改本文件，改的是 active.md 与 06）。快照节 ≤10 行，装不下的细节进状态记录。