103 lines
78 KiB
Markdown
103 lines
78 KiB
Markdown
# 工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范）
|
||
|
||
> 一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。**实时状态以仓库根 [active.md](active.md) 顶部「当前状态快照」节为准**（会话级、高频更新）；待办事项明细以 [06-待办清单](design/gdd/06-待办清单.md) 为唯一登记处（条目级）；本文件只管批级序列与门，里程碑移动才更新。
|
||
> 成文 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-09-29）
|
||
|
||
- **阶段**：Vertical Slice Implementation（`stage.txt`）
|
||
- **已达成**：一局完整三关冒险+存档+元进度+营地闭合（数值 provisional，归 M-3 调参批标定）；**M-1 切片表现收口关闭**（初步验收 2026-09-28，出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md`）；**M-2 关卡画面独立化关闭**（出口闸 2026-09-28 通过，出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md`）；UX 文档面四 spec 齐（battle / level-map / level-clear / interaction-patterns）
|
||
- **挂起待用户输入（批次解锁点）**：① 真人试玩批次（并入 M-3 迭代 5 读数）——已解闸存档：M-1 出口闸目检（2026-09-28 通过）；**M-2 出口闸目检（2026-09-28 通过，八项全过）**；ADR-0007 裁决（裁丙，台账 210）；高墙档=D 投影+字体=Fusion Pixel OFL；样张 v1 否决原因四条（已断言化，样张 v2 冻结）；关卡画面独立形态（2026-09-28 用户裁决——M-2 立项依据）
|
||
- **已知挂账**：魔法道具内容批（迭代 7 承接，node-reward spec 随批出生）；元进度柜台定价标定（迭代 7）；反制批 Alpha（M-4）；迭代 5 出口三件**已全闭**（2026-09-30 收口批台账 290——目检 15/15 过/带改普通 L2 [10,15]+丙追认/荆棘外延否决根因改判）；完美 L1 越带处置已并入带换代承接（难度曲线与Boss.md 带换代节：落带收敛归全局难度批、M-4 排序——先带 D 悬崖修复后带值收敛；原「战斗阶段数值问题」06 条目随四带换代收口移除）
|
||
|
||
## 主线路线（里程碑 × 迭代序列）
|
||
|
||
> **提案序，开工逐迭代点名**；每个迭代 = 一个 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-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-03 M-3 关闭升现行）；2026-09-29 起内容闭环迭代（战斗演出/魔法道具/元进度标定）上移 M-3，本里程碑=Alpha 验收通过后的深化批）
|
||
|
||
| # | 迭代 | 门（进入条件） | 更改任务 |
|
||
|---|---|---|---|
|
||
| 迭代 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 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 |**③全局作用域变异首发批（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，切分预案在册）——开工=用户发令升计划书。**⑤魔法提灯 +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 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 |
|
||
| 迭代 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](design/qa/iter15-2-curio-exit-report-2026-10-05.md)）**：三套词族代码层全换（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.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**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](design/qa/iter15-3-mibao-exit-report-2026-10-05.md)）**：词族实数 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](design/qa/iter16-ui-exit-report-2026-10-06.md)）**：T0-T10 全落（T10 人闸材料包=[iter16-ui-human-gate-checklist](design/qa/iter16-ui-human-gate-checklist-2026-10-06.md)——实机目检+代拍板追认八项归用户）；闸=冒烟 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 出口 | T0-T8≈3.75d（超软盒预挂，T4 末切分点） |
|
||
| 迭代 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，worktree g-plan2-iter17-pause 分支 iter17-pause-20261006 两会话接力完成，提交 c08a901/fc9eb1e/d44fdd5+收口笔；出口报告=[iter17-pause-exit-report](design/qa/iter17-pause-exit-report-2026-10-06.md)）**：暂停层本体+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 用户令立项——先文档后落地，数值只设计不调、终值归⑥M4 收官批统一调整）**：两件——(a) charge 标签件数补足（06 在册数据缺陷：feats.tres 现恰 3 件〔整备军备/铁壁整备/厚积薄发，表注释 "dig 4/charge 3/devour 4" 自证〕、档二需同标签 ≥4，charge 流派永远达不到档二；迭代 15② 批登记不硬补）：本卡设计补足件清单=名称/效果〔限现有效果 hook〕/标签/稀有度/配额占比/卡面文案，呈用户裁决后落地；(b) 06「资源两个新种类入池」条收口核对（实查 2026-10-06：刷新次数〔treasure_items.tres 三选一刷新件〕与专长获取门票〔shop.tres+adventure_table.gd 门票行〕均已随迭代 15②/三选一刷新批入池——该条现状文本滞后，残余=边界核对与条目收口，随本卡文档一并处置）。本卡=纯文档零代码；落地批（feats.tres 数据行）估 0.5d 内，门=本文档出口+用户裁件+迭代 17 卡⓪落籍〔卡⓪在飞改表结构避撞车；新件限现有效果 hook 则纯 .tres 数据行零代码〕 | 无硬门（可先行） | 估时随任务书 |
|
||
| 迭代 18 | **②呈现优化批（2026-10-06 用户令立项；与迭代 16 语义零重合——16=样式对齐〔色/字号/形制 token 化、观感原值搬运、P2 棋盘零改动〕，本批=内容与观感改版，动的正是 16 落好的 token 单点=其下游）**：六件——(a) 奇物内部分类禁写入玩家可见面三处违规清除〔06 在册：battle_narrator 卡面流派名/C 区聚合行/关卡选择页〕+档位呈现三路〔甲纯隐藏/乙一次性风味反馈/丙机制退役——仍待裁，随任务书呈报〕；(b) L1 亮墨数字直画观感重设计〔06 在册 T17 目检体感〕；(c) 高墙墙底阴线形制〔06 在册；色值已收 ui_kit token 单点〕；(d) 呈现层残余 <4.5:1 文字位三处〔06 在册，迭代 16 批外邻接漏出面〕；(e) L2/L3 棋盘观感「看着累」〔playnote 2026-10-06；开工先定性：素材缺位程序化回退=美术轴归用户自理，UI 代码轴才入本批〕；(f) 关卡节点图展示改版〔playnote 2026-10-06「参考哥布林弹珠的方式去移动」——先出参考调研+改版方案人闸后动手，结构级改版非样式对齐〕。随批义务=07⑮ 渲染像素五闸补跑挂账（golden/shot 等基线按换代流程重锚） | 无硬门；(f) 方案人闸随任务书 | 估时随任务书 |
|
||
| 迭代 18 | **③武器锻造系统设计提案批（2026-10-06 用户令入迭代 18；纯文档零代码——提案源=playnote 2026-10-06）**：用户提案=攻击力提升改造为「武器锻造」——剑（普攻）锻造升级加攻击、满级附带额外效果；后续增列长枪/法杖，攻击类型分别走穿刺/魔法；护甲由轻甲起级（先只提 AC）→解锁重甲/魔法甲（基础 AC 各异、可续升、满级各带额外效果）——武器/护甲差异化。产出=系统设计提案文档（与奇物属性值提升分类/护甲克制轴/营地柜台/锻造经济边界对齐，数值框架 provisional 终值归⑥统一调整），裁点呈用户裁决；实装批另行立项。06 已登记专条 | 无硬门 | 估时随任务书 |
|
||
| 迭代 18 | **④生涯界面实装批（2026-10-06 用户令入迭代 18）**：按迭代 17 卡④设计提纲（design/gdd/systems/跨局循环/生涯.md v0.1，master 44328b1）实装「生涯」界面——跨局汇总/历史冒险回看/图鉴承接；提纲在册要点=recent_summaries 现役 cap10 扩容+用时埋点/总局数与通关局数（涉存档 schema）/营地最近冒险清单去留（P6 必答项随评审定）；分期建议随提纲 | 用户评审卡④提纲+设计定稿（人闸） | 估时随任务书 |
|
||
| 迭代 18 | **⑤混编遭遇首批投放批（2026-10-06 用户令入迭代 18；纯内容批——机制前置=迭代 17 卡①敌人表行集多行批）**：07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放（敌种候选与坐标=本批裁点）；首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）；难度带读数义务随批登记 07，MC 取证跑批**顺延⑥M4 收官批统一执行**〔2026-10-06 用户令：数值统一调整殿后；投放本身不阻塞〕 | 迭代 17 卡①落籍 | 估时随任务书 |
|
||
| 迭代 18 | **⑦新冒险种子随机化（2026-10-07 用户令入迭代 18——现状考证：main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现）**：新冒险开局主种子改随机生成（默认分支），调试浮窗种子输入框保留=手动指定覆盖（迭代 15 卡①既有读取面 `_seed_value` 唯一消费点不变）；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；冒烟/MC/探针全链显式传种子零影响——单种子内行为不变、只是每局种子不同，**锚零作废，与⑥收官批零耦合、排序自由**。裁点随任务书：① 首次冒险是否也随机〔现行 42+固定模板 0=首次冒险全程可复现的教学态；A6 首遇教学位纪律系节点模板面不受种子影响，但板面雷位/资源摇号会随种子变〕② 种子是否进 UI 展示〔局摘要已携带 master_seed；展示=分享/日后每日挑战位候选〕 | 无硬门 | 小卡≈0.5d 内 |
|
||
| 迭代 18 | **⑥M4 数值批（2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批——不影响迭代 17 在飞开发，17 卡号 ③④ 维持原号不重排；同日用户令二次调整：移至 Alpha 阶段最后=本迭代收官卡——内容补全先行、统一数值调整殿后〔内容卡若溢出后续迭代则本批随之顺延〕）**：四件数值欠账合一批——①削弱档位终值（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 内容卡①-⑤⑦出口（**Alpha 收官位**——2026-10-06 用户令；重锚窗口须收尽全部内容批行为变更，故排一切内容批之后） | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d） |
|
||
|
||
## 执行纪律（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`，已完整跑通收口）。每迭代照此八件成文，缺件不开工。
|
||
>
|
||
> **迭代粒度界定（对齐敏捷迭代/Sprint）**：一个迭代 = 一句迭代目标 + **3–8 个更改任务** + 一份计划书 loop + 一次合并登记，交付一个可验证增量（≈一次迭代交付）。单交付物不成迭代——并入相邻迭代当任务卡；用户输入闸未解的任务不进迭代（留 06 当 backlog，解闸后编入下一个迭代）；软时间盒 ≤3 个工作日，超限即切迭代（L3 汇报）。**里程碑 = 2–4 个迭代的发布级目标 + 出口验收闸（≈Release）**。
|
||
>
|
||
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 行，装不下的细节进台账。
|