98 lines
59 KiB
Markdown
98 lines
59 KiB
Markdown
# 会话状态：Dungeon Sweeper（扫雷 × 自动战斗）——唯一状态源·状态文件（2026-10-09 立宪）
|
||
|
||
> **定性（2026-10-09 用户裁决）：状态文件，非历史档案**——本文件每一行都必须在当下为真；历史变更一律以 git 提交史为准（删除的条目可在 git 历史版本中完整复原）。
|
||
> 写入边界：只写快照、未决面、当前迭代工作条目。待办裁决归 `design/gdd/06-待办清单.md`，跨会话教训归记忆库；已完结批次条目（已入库+结论进快照+无未决项指向）在迭代收口时删除，超 30 条必须清。细则见 `design/dev/doc-conventions.md` §10。
|
||
> 并行会话禁止将本文件整体复原/回退。
|
||
|
||
|
||
- **阶段**：M3——Alpha 版本的完整实现（2026-10-09 立规：未明令宣布完成前停留 M3，迭代只排 M3 需求，M4 不排期；根目录 stage.txt 为旧阶段开关仅存档）
|
||
- **系统索引**：`design/gdd/02-系统清单.md`（2026-09-14 循环式新骨架根索引；旧 `systems-index.md` 已封存于 `design/archive/gdd-2026-09-14/`，只读参考）
|
||
- **概念文档**：`design/gdd/00-游戏概念.md`（新骨架顶层文档；旧版 game-concept/game-pillars 已随归档封存）
|
||
- **原型**：概念原型 demo 已删除（2026-09-12，垂直切片承接）；验证结论 PROCEED 载于 git 历史，原报告路径已散佚；原型已演进为 `game/` 工程
|
||
- **引擎**：Godot 4.7.2 + GDScript（2026-09-07 锁定；`.claude/docs/technical-preferences.md` + `docs/engine-reference/godot/`；**MEDIUM RISK**——2026-09-12 `/setup-engine refresh` 逐条核实 4.5–4.7 官方迁移指南，无破坏架构契约项，current-best-practices.md 已建）
|
||
- **架构**：`design/dev/architecture/architecture.md`（同目录含 ADR 系列） v1.0（2026-09-12 /create-architecture 产出，TD 自评 APPROVED WITH CONDITIONS；review-mode.txt = solo）
|
||
- **待办清单**：`design/gdd/06-待办清单.md`（2026-09-16 收编批起为全项目待拍板唯一登记处；系统文档只留指路存根，新增条目直接登记清单，裁决后改状态列留痕）
|
||
- **批次出口报告**：随批落 `design/qa/`（证据只留最新一轮，doc-conventions §11）
|
||
- **工程路线图**：根目录 `roadmap.md`（2026-09-17 建——里程碑时间线 + 路线图；实时状态看下方快照节）
|
||
|
||
|
||
## 当前状态快照（收口批先更新本节，再追加状态记录；≤10 行）
|
||
- **更新于**：2026-10-14（迭代 26 UI 交互与观感批总收口——单会话 /goal+iter U0 全量交付，合并 c8c3db1）。
|
||
- **批末闸全绿**：冒烟 1055/0（基线 987+本批 68 断言）+run_all 25 套+probe --click/--full+render_gate golden 0.00%（登记即结未重制）+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。
|
||
- **迭代 26 交付**：按钮五态矩阵（悬停 modulate 1.06 提亮/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环/危险钮本族按压态，逐实例 override 主题层零新增）；全局纹理过滤 Nearest+平滑渐变件三处 LINEAR 白名单；三处 <4.5:1 换墨（GOLD_BRIGHT/HERO_BLUE_BRIGHT/STONE_DEEP，6.47/5.88/5.98:1）；光柱连续 alpha；图标槽柔和档+商店居中+营地四栏等高；诊断转储钮迁调试浮窗；冒烟 +68 断言；06 四条销号/氛围层改记+反哺点新条；08 v1.4；07 ㉕；roadmap 行换代；实现报告=design/qa/iter26-实现报告-2026-10-14.md。
|
||
- **迭代 26 待用户**：实机目检五项（07 ㉕，登记不阻塞）+代拍板追认单十三项（报告 §四）+GDD 反哺点四条（报告 §五/06 新条）。
|
||
- **迭代 25 交付**：全局主题 `game/assets/theme/main_theme.tres` 挂 `gui/theme/custom`（15 类型全覆盖+预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层+`default_font` 中文字形防御）；`tooltip_theme()`/`styled_slider()` 两处局部做法同批退役（settings_overlay 几何内联+debug_overlay 双轨消隐）；冒烟 V1-V6 断言 38 条；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3；07 ㉔；roadmap 行换代；实现报告=design/qa/iter25-实现报告-2026-10-13.md。
|
||
- **迭代 25 待用户**：实机目检全屏巡检+专项观察点二（07 ㉔，登记不阻塞）+代拍板追认单八项（位图不入 git 政策口径/CheckButton 词条名订正/Slider 无 pressed 槽等=报告 §四）+GDD 反哺点五条（报告 §五）。
|
||
- **现行文档事实源**：秘宝.md v2.9+奇物.md v3.16+天赋树.md v0.10+锻造工坊.md v0.8+元进度.md v1.20+术语表 v1.10+**08-Alpha版本标准 v1.4**。
|
||
- **各批残留人闸不变**：迭代 20 实机目检五件+V20/V21/V22 人工核对半；21 营地四柜台〔07 ⑳〕+22 秘宝解锁装配〔07 ㉑〕+23 锻造工作间〔07 ㉒〕+24 敌人表三观测〔07 ㉓〕+25 全屏巡检〔07 ㉔〕+**26 逐屏巡检〔07 ㉕〕**。
|
||
- **已裁在册**：M4 数值批顺延迭代 27+ 未排期（各批 provisional 终值归其统一标定）。
|
||
- **界面美化三层已登记**（85e2d2a/08 v1.1）：第一层三条全部交付（全局主题=迭代 25；按钮状态矩阵+全局纹理过滤=迭代 26）；第三层四件已交付（<4.5:1 换墨/光柱半/元素细节余项=迭代 26，氛围层九宫格半存续待素材核对）；余第二层三件（贴图/字体/样张）＋第三层其余（九宫格切片/棋盘观感）待立项。
|
||
|
||
## 项目当前位置（2026-10-12 刷新；实时细节以根目录 `roadmap.md` 与 06-待办清单 为准）
|
||
- **里程碑**：M3=Alpha 版本的完整实现（2026-10-09 立规：用户未明令宣布 M3 完成前停留 M3，迭代只排 M3 需求，M4 一律不排期）
|
||
- **迭代**：迭代 19 五卡已入库（2026-10-08）；迭代 20 专长实装批已入库（2026-10-11 总收口）；迭代 21 天赋树实装批已入库（2026-10-12）；迭代 22 秘宝体系实现重构落地批已入库（2026-10-12）；迭代 23 锻造工坊实装批已入库（2026-10-12）；迭代 24 敌人表内容修批已入库（2026-10-13，单会话交付；迭代位预留追加卡）；**迭代 25 UI 全局主题批已入库（2026-10-13，单会话交付）**；**迭代 26 UI 交互与观感批已入库（2026-10-14，单会话 /goal+iter U0 总收口，合并 c8c3db1；迭代位预留追加卡）**；M4=迭代 27+ 未排期
|
||
- **近期主战场**：迭代 20/21/22/23/24/25/26 七批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕/ 敌人表三观测〔07 ㉓〕/ UI 全屏巡检〔07 ㉔〕/ **UI 逐屏巡检〔07 ㉕〕**）——各批追认单与反哺点全部出清；**下一前沿=待用户发令（迭代 26 位仍预留追加卡；M4 数值批殿后顺延 27+）**
|
||
|
||
## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`）
|
||
- 待用户裁决：美术审计两项 P0（art-bible 死样张指涉+主角像素管线重产；06 在册）；去毒残留词扫否（魔法道具约 30 处/罕见约 18 处，呈报在案）；喂雷流 R5 甲重启条件回落文（一句话件）；「通关 vs 通过第 N 关」全库口径统一 273 处（待裁是否补登记 06）；迭代 20 实机目检五件+V20/V21/V22 人工核对半（07 在册）
|
||
- 待发令：M4 数值批（迭代 27+，未排期——锻造工坊 provisional 终值/钥石产出重标/削弱档终值/元进度定价余面归其统一执行）；迭代 26 迭代位预留追加卡（同迭代 24 先例，待用户编入）
|
||
- 进行中：黑话清扫第二波（GDD 正文流程动词族约三千处，随时可派）
|
||
|
||
## 状态记录（滚动窗口：仅当前迭代；退役规则见 doc-conventions §10）
|
||
|
||
- **479（2026-10-12，迭代 23 锻造工坊实装批开工）**：/goal+iter 技能调用=U0 开工令（用户目标=总收口全绿：冒烟/单测/探针/读数对拍四闸全过+实现报告落档）。开工检查全过：卡片 v1.2 零阻塞待裁点（Q1=0 级起步+锻造第一级=首个 +1 已裁；Q2=provisional 沿锚表投值已裁）；V1-V14 验收清单三要素齐（V9 静态 grep 人工核对+V13 用户目检=纪律类人工项，余自动闸）。自洽扫描两处 L2 记录继续（不触红线）：①卡片 F8「meta 域 13 件」清单滞后——现行实态 15 键（迭代 22 T2 同批新增 vision_used 未及登卡），对 forge_routes 新域零影响；②06 条目①「forge_products 两行改造」系 v0.5 旧文——设计 v0.6/卡片 F1 已订正为「行族已退役、新建行族」，卡片优先，T7 机械面同步时订正 06 措辞。事实抽查全符（F1 三处退役登记在册/F3 FORGE_ROUTE_BONUS 与 hero_override 在役行号漂移至 :155/:157/F5 两轴在役/F8 v6+_default_data 15 键/F9 forge_workshop 钥匙节点+营地占位面板接缝在册/F7 敌方轴未开）。T0 实查结案：①基线复读=冒烟 898/0+run_all 22 套全绿+probe_gate --click 全绿残留 0（存量 fx_reveal 已随 iter21 修复，零存量红）；②buy_forge/forge_products 断言已随 iter21 T5 全摘（余件皆注释/退役登记——smoke:4398「MetaTable 行族规模 3/3/2」断言需随 T1 新行族换代）；③hero 两轴读取面全清单=运行时独一处 unit_container.gd:64（db.hero 两轴快照）+冒烟断言 smoke_all.gd:1901（_db.hero.attack_type）+battle_orchestrator.gd:1410（消费 hero_unit 快照非表直读）+README 文档面，测试层零直读；④meta.tres 现役三行族+boss_keystone/conversion/attune_refresh_upgrade，FORGE_ATTRS 常驻；⑤树钥匙+占位面板接缝在册（camp_overlay_view.gd:275-284 钥匙门）;⑥设计 v0.6 两节（裁决结果清单+工作间内容清单）复核无冲突。注入链已探明：main.build_adventure_params（:501）→ adventure params → _runner.set_* 族（:934-945 模式）→ level_runner enc（:480-494）→ begin_battle（battle_orchestrator.gd:344/:396 spawn）。代拍板立项（白名单内）：新表 meta_forge.tres（ForgeTable：默认两轴+六路线行族，落位选型=新表，访问器连续性沿 treasure_items 先例）；路线 id=sword/spear/staff/light/heavy/ward（甲路线 id=甲型值本身）；存档域 forge_routes={levels 六键+unlocked 直购清单+weapon/armor 选中}（初始持有+练满前一档=派生解锁、直购=入档）。定义面已入库（b9cca33，卡片单笔）；主区残留脏件全属他批遗产零碰（.zcode/active.md/锻造工坊.md v0.6 续裁行/playnote 等）。worktree g-plan2-iter23-forge 开工，T1 起。
|
||
|
||
- **478（2026-10-12，迭代 22 秘宝体系实现重构落地批总收口）**：T1-T7 八提交全量交付（worktree g-plan2-iter22-treasure；T1 12 行换代+schema 扩签/T2 解锁服务+工坊面退役+档位格约束/T3 效果引擎接入+扩签+常时参数面+试炼镐积点口+充能周期+修 use_treasure Rules.width 潜伏缺陷+新单测 treasure_effects_test/T4 呈现换代+呈现桥+HUD 兑换钮+修 BoardZoneView 缺转发挂死/T5 替换子交互拆除+库存保留注记+修 apply_node_curio 主体误删/T6 验收闸四断言+重闸/T7 文档四件+实现报告）。自洽扫描四处事实换代（卡片 F1/F2/F4 被迭代 20/21 推进）施工按现行实态。批末重闸全绿=冒烟 898/0+run_all 22 套+probe 含 click/full+render_gate golden 0.00%+doc 三闸对基线零新增+熵增 PASS；MC 零跑（零随机无概率面）。master 并行两笔（锻造 docs 6f56164）已并入分支解 roadmap 冲突（融合=我方 22 ✅ 行+23 锻造行+24+ M4 顺延行）。代拍板追认单十五条+GDD 反哺点七条待用户（design/qa/iter22-实现报告-2026-10-12.md）；残留人闸=实机目检秘宝解锁-装配正常流程（07 ㉑）。
|
||
|
||
- **477（2026-10-12，迭代 22 秘宝体系实现重构落地批开工）**：/goal+iter 技能调用=U0 开工令。开工检查全过：卡片 v1.3（C1-C6 全裁）零阻塞待裁点——三条回补待裁点按卡片自declared不阻塞口径处理：回补点 1 按推荐案执行（12 件全量落地、刷新练习归钥石购买=C1 普通档裁决直接应用）、回补点 2 已消解（迭代 20 已删 venom_edge/flag_burst，现行表 12 行旧件本批实删 12 行）、回补点 3 按「旧实现一律删除」既定纪律选拆除路线（treasure_inventory 拆除，追认单列明）；V1-V19 验收清单三要素齐。自洽扫描四处事实换代（均系迭代 20/21 前置批推进、方向对本批有利）：①现行表 12 行非 14 行；②attunement_growth.tres 谓词表已被迭代 21 删除、槽位判定源已切树点亮数（attunement.gd 现役 slots()=att_socket1..3）——卡片「谓词表槽位求值职责移除」已被迭代 21 完成、树接口接缝现成；③forge_products 行族已删；④V13 引用 smoke/tests 行号全漂移按内容定位。基线复读=冒烟 886/0+run_all 22 套+probe_gate --click 全绿（残留 0）。T0 四项核实结案：①X/Y 对表=临时账 X（_attune_refresh_x 每停点重置、装配集 bonus_refresh 行源——新 12 件无此行源恒 0 机制保留）+存量账 Y（_attune_refresh_y 升级行）+_refresh_stock（刷新练习件新加仓目标）；扣序 X→Y→stock=先临时后存量与秘宝.md 一致；②magic_vs_magic 行已被迭代 20 删除（grep 零命中）——锻造工坊批③作废结案维持；③效果引擎扩签清单=订阅行现役词可承载（晨操令/双管装填=round_start+grant_ap+round_index 条件；试炼镐=dig_reveal 计数+use_treasure 受理闸与掘进蓄能同构现役）；扩签三处=巢穴预告装板事件、天眼安全格开格 kind、真视使用计数键（UNLOCK_COUNTER_KEYS 扩签+存档生涯域新键）；常时参数面五点已定位（_adjacent_to_hero 挖/旗两分支=远程镐/信标网络、finish_round_stop 1:1 转存=储备罐、shop_refresh_free_left=刷新执照、set_fog_lantern 半径面=阔视野带、_refresh_stock=刷新练习）——注入模式沿 fog_lantern 呈现桥与 attune_has 契约化先例；④真视使用计数接入点=use_treasure 受理成功处（battle_orchestrator:865-883）；旧件硬编码一处在册（battle_orchestrator:882 dig_charge 随行换代）。定义面已入库（roadmap/06/卡片 v1.3 均在库零脏件）；主区残留脏件全属他批遗产零碰。worktree g-plan2-iter22-treasure 开工，T1 起。
|
||
|
||
- **469（2026-10-12，迭代 21 天赋树实装批开工）**：/goal+iter 技能调用=U0 开工令。开工检查全过：卡片 v1.7（73acee0 已入库）零阻塞待裁点——R1 按卡片既定默认=裁撤案执行（schema 只保留点亮前置），出口报告追认单列明；验收清单 V1-V23 三要素齐；自洽扫描 8 处事实抽查全符（33 行表/schema 词表/tree_buy 族/slots 谓词求值/存档 v6/_roll_gp_drop 挂点/:1116-1131 标错分支/结算=每轮末时序）。T0 四查结案：②聚乘算位=_roll_gp_drop() 返回表达式内（battle_orchestrator.gd:1461）；③锋=mine_hit 现成挂点零改、守=_flag_miss_seen 去重闸后（:1119-1121）grant_ap mode:queue 下轮 notify_round_start 兑现，末轮判出无下一轮=契约 12 作废态自动成立；④锻造工坊 v0.5 两节读取完成——本批预留 0 锻造加值位与「4a 前缓后陡/6 满级特效留扩展位」零冲突、钥匙 free 无前置一致；⑤基线复读=冒烟 864/0 但 run_smoke 判 FAIL（SCRIPT ERROR 51 行：_flush_pending_reveals 三处 _emit_row("fx_reveal","",...) 空 source_class 触发 :1592 行来源断言——a57489e9 迭代20 T1 落地件存量红，两轮确定性复现，本批内顺手修复+实现报告单列）+run_all 21 套全绿+probe_gate --click 全绿残留 0。定义面已入库（并行会话 73acee0 含 roadmap/06/卡片 v1.7）。主区残留脏件全属他批遗产零碰（.zcode hook 三件/锻造工坊.md v0.5 未提交/playnote/四 untracked）。worktree g-plan2-iter21-tree 开工，T1 起。
|
||
- **470（2026-10-12，filter-repo 计划书裁决——明示放弃销号批）**：用户裁「.git 60MB 可接受，没必要清理」→ 三选裁**明示放弃**。06 条目移除（去向=本条，git 史留痕）；active.md 未决面摘除该裁决项。计划书 `.zcode/plans/filter-repo-history-cleanup-plan-2026-10-02.md` 系 .zcode 未跟踪件、随裁作废但磁盘留存不删（永久删除不可逆；真要重启历史清理须重立计划）。零代码零他件触碰（worktree frdrop-20261012）。
|
||
|
||
- **471（2026-10-12，8a 连带 C/D 改名裁决 + 独立改名小批登记）**：用户最终命名——**C =「属性 + 祝福」**（局内商店货架三行 攻击锻升/生命锻升/护甲锻升 → **攻击祝福/生命祝福/护甲祝福**；后缀由用户自 D&D 调研候选选定〔Blessing〕，并裁定"参考书目有该词不构成禁用"；调研要点：D&D 超自然赠礼分 Blessing 祝福〔永久·神赐〕/ Charm 护咒〔有时限·用完消失〕，按语义后者更贴局内临时层，用户仍取祝福）；**D = 棋盘格 defense 正向行 + `ac_up` 状态的同名「护甲强化」→「盾牌加护」**（用户提案，理由=它是临时叠层状态、不是护甲本体；附带约定「加护=AC 判定层，护盾=保险丝那种吸收层，两者不得混用」）。机制分类名「属性值提升」保留不动，只换玩家向显示名。**执行面已核到行号**：C=`shop.tres` 六行（pool_shelf 现役 70/74/78 + products 遗留 38/45/52）——全库"锻升"命中恰此六行、`display_name` 非查找键（货架以 kind_id 为键，`config_db.gd:328`）、`smoke_all.gd:4415` 为"标签文本==表值"自洽式断言 ⇒ **C 零代码零测试连带**；**D 必须连带改 `smoke_all.gd:1199` 一条硬编码 `== "护甲强化"` 断言，否则冒烟红**（修正上一轮"C/D 皆零连带"的判断）。**按本会话"禁动 game/ 代码与数据表"纪律未代执行**——06 新增「玩家向显示名改名小批」条目，内附逐行替换表 + 近义词占用登记（石肤已被奇物占用）。落文：锻造工坊.md（边界节 + v0.5 版本行⑥）、06 新条目；启动=用户发令或并入锻造工坊实装批。附：本会话早先写入的 468/469 两条已被并行会话的"状态记录清理批"清档（完结条目清理，符合 §10），本条为补登。
|
||
|
||
- **472（2026-10-12，奇物呈现条过期检查批——档位三路消解+僵尸呈现定性，条目换代不删除）**：用户令检查 2026-10-04「奇物呈现三处违规+档位三路」条是否过期。取证结论三条：①**档位三路裁点被事件超越**——丙（机制退役）经重设计路线实现（奇物.md v2.9+追认单术语澄清「流派标签作玩法机制作废」+迭代 20 `battle_orchestrator.gd:330` rider_tier 注入拆除），甲/乙不再待裁；②**三处违规未消解且恶化=僵尸呈现**——迭代 20 零触碰四个呈现文件（git 末次 10-05~07），新 29 行无 archetype 字段 ⇒ C 区/关卡页实显「流派 ×N · 档一」兜底行（`hud_presenter.gd:111`+`feats_engine.gd:13`）、卡面「件名 · 流派」（`battle_narrator.gd:146-149`），违反 10-12 重申对外永不显示铁律+展示已退役机制；③条目换代不删除（迭代 20 反哺点⑤明文指向本条，删则指针悬空），剩余裁决面=呈现改法与反哺点⑤同面。连带发现（本批只记录不处置）：迭代 20 实现报告 §四.5/§五.5「逐件行降级态在役」与代码实态不符，失真处置待用户裁。**编号注记：471 已被并行锻造会话（主区脏件）占用，本条顺延 472。**06 条状态换代（worktree curiopres-20261012）。
|
||
|
||
- **472（2026-10-12，C/D 改名小批——C 已执行，D 阻塞）**：用户授权边界澄清=**可改配置（.tres）、禁改代码（.gd）**。据此执行 **C**：`shop.tres` 六行 display_name 全量替换——pool_shelf 现役 70/74/78 + products 遗留 38/45/52，攻击锻升/生命锻升/护甲锻升 → **攻击祝福/生命祝福/护甲祝福**；校验=全库"锻升"命中归零、行数与括号结构零变化、**零代码零测试连带**（display_name 非查找键，`smoke_all.gd:4415` 为自洽式断言）。**D 未执行**：`reward.tres:22` 与 `status_effects.tres:18` 属配置可改，但 `reward.tres` 改名会立刻使 `smoke_all.gd:1199` 硬编码断言（`== "护甲强化"`）**判红**，而该文件是代码、未经授权；只改 status 一侧会造成格子/状态两处不同名，不采纳 → D 整项挂起，待可改 .gd 的批次同批执行（06 在册，附逐行替换表）。落文：06 改名小批条更新（C 标已执行、D 标阻塞原因）、锻造工坊.md 边界节。→ **接续指针：用户追加授权（"可以简单地修改……一并改完"）后 D 已于同日解阻执行并合入 master，残留肃清同批完成，详见 474；本条「D 阻塞」状态已时过境迁。另：本条与上方奇物呈现批重号 472（并行会话撞号），474 为续篇。**
|
||
|
||
- **473（2026-10-12，迭代 20 报告失真勘误批——「逐件行降级态」失真五处换代）**：用户裁先修报告失真（与僵尸呈现分案——前者文档缺陷、后者代码缺陷，互不替代）。失真源=迭代 20 实现报告 §四.5「流派聚合行退役→逐件行降级态在役」与代码不符（逐件行未实装，472 已取证），扩散四处：报告 §五.5 目检项、07-体验验证清单 HUD 条、06 反哺点条⑤、game/README.md 换代面段。五处全部勘误换代（带日期勘误标记；目检项 5 改验僵尸呈现实况=修复批前对照取证，人闸「五件」计数不变）；零代码零他件触碰，僵尸呈现修复仍待呈现改法裁决（06 奇物呈现条）。（worktree repfix-20261012）
|
||
|
||
- **474（2026-10-12，C/D 改名小批执行+合入+残留肃清——worktree 两连批）**：用户追加授权（"可以简单地修改（smoke_all.gd 那一行断言），一并改完吧。但是注意我们的合入规则"）后，C/D 同批走 worktree 执行。**主批**（分支 rename-blessing-20261012，基于 master 18b6cbd）：`shop.tres` 六行 display_name 锻升→祝福（pool_shelf 现役 70/74/78 + products 遗留 38/45/52）；`reward.tres:22` / `status_effects.tres:18` 护甲强化→盾牌加护；`smoke_all.gd:1199` 硬编码断言同步（不改则冒烟红）。冒烟 864 项检查 0 项失败（FAIL 仅存量 fx_reveal SCRIPT ERROR——a57489e9 遗留、iter21 在册，与本批无关；已核 `_smoke_ac_swap_guard()` 调用先于 `_smoke_save()`，存量错误不吞本批断言）。`--no-ff` 合入 master `0c93a71`（ort 零冲突；主区脏件全为文档侧，与分支 game/ 四文件零重叠）。**残留肃清批**（分支 blessing-residue-sweep-20261012，基于合入后 master）：合入后全库复扫发现主改名未覆盖注记段 4 处——`reward.tres:219` / `status_effects.tres:99` 历史注记、`defense_scan.gd:24/:35` 打印标题与注释，更新为现名「盾牌加护」并括注"2026-10-12 由'护甲强化'改名"（历史动作部分保留）；冒烟 864/0 → 合入 `0144f60`。**game/ 全库现役旧名归零**（仅存两处为有意留痕括注）。worktree 与三分支已清理（`git worktree remove --force` + `branch -d/-D`）。**文档跟随**：地图战斗资源.md v0.23 版本行（九型字典表+设计意图句）、art-bible.md §4.6.1/§4.6.2 键名列（契约句"随其修订自动跟随"）、07 体验验证清单⑫目检行。**06 条目收口**：改名小批状态「已完成」，registry entities.yaml 登记「祝福」条目/旧名退役**未执行**——归锻造工坊实装批术语登记面（迁移面八项⑦同域）。**编号注记：473 已被并行会话（迭代 20 报告失真勘误批）占用，本条顺延 474；472 撞号（并行会话同写）已在彼条加接续指针。**
|
||
|
||
- **475（2026-10-12，奇物呈现修复批——僵尸呈现整改落地，呈现改法=甲逐件行）**：用户令「解决呈现问题」，按呈报推荐案甲落地（改乙/丙一句话另调）。代码两文件：`hud_presenter.gd` feat_holdings_lines 聚合行（新 29 行无 archetype 下空键兜底「流派 ×N · 档一」僵尸文案）→ 逐件行「件名 ×N」；`battle_narrator.gd` feat_card_text 摘「件名 · 流派」族名行（卡片=件名+效果摘要两行，兑付反馈行随之「件名 · 摘要」）+payload 死键 archetype 摘除；注释面五处换代（hud_presenter/hero_info_panel_view/level_map_screen）。断言面预查：smoke:982 只钉 desc 零族名断言，免改。文档同步：battle.md C 区两行（归 06 指针摘除改已整改事实）/07 HUD 条（验修复后逐件行）/报告 §五.5（同）/README 段（473 勘误句再换代为已修复）/06 奇物呈现条**收口移除**（三处违规+档位三路+呈现改法三面全清，去向=本条+git）/反哺点⑤✅销账（①-⑤全出清；反哺点条与追认单条随下次收口清理批一并移除）。FeatsEngine.tiers_for 呈现侧调用摘除后全仓零调用方（引擎库保留不动）。（worktree presentfix-20261012；**编号注记：474 已被并行改名批占用，本条顺延 475**）
|
||
|
||
- **481（2026-10-12，迭代 23 锻造工坊实装批总收口〔编号顺延——480 已被并行 06 清理批占用，主区未提交遗产撞号注记〕）**：T0-T7 八提交全量交付（worktree g-plan2-iter23-forge；T1 行族 df666dd/T2 两轴移交 00d98b6/T5 存档 v7 6def354〔序调先行——写口硬依赖〕/T3 写口族 a6270ba/T4 注入链 ed06292/T6 工作间 UI 2915f19/T7 收口笔）。T1 新表 forge.tres（ForgeTable 默认两轴+六路线行族，ConfigDB forge_* 六访问器）+单测 41 断言；T2 hero.tres 两字段删除+spawn 注入缝（空串=锻造配置默认值回退，行为逐位连续）；T5 SAVE_FORMAT_VERSION 6→7+forge_routes 域{levels/unlocked/weapon/armor}（无特效域）+v6→v7 空迁移缺键补齐=初始持有态；T3 写口族（forge_buy_level 几何价 20/30/45/67/101/forge_buy_unlock 一次性 200/forge_select_* 免费/forge_route_unlocked 派生单点）；T4 hero_override 公式换代（FORGE_ROUTE_BONUS 退役）+build_adventure_params 两键+参数面快照锁死+effective_ac 三层（甲型基础 AC+路线加值+局内）+enc→spawn 末端；T6 占位面板→两区六路线行板+三意图信号+presenter 处理器+新单测 12 断言。验证：冒烟 938/0（基线 898+40 锻造断言）+run_all 24 套+probe --click/--full 全绿残留 0+render_gate golden 0.00%+doc 三闸/熵增对基线零新增（3 个 gdd_lint 存量红同款；master 第 10 个扫描文件=并行会话未跟踪件 08-Alpha版本标准.md，禁碰）；**MC 同种子配对 80 局逐位零漂移**（na=40 seed0=9000 双画像：normal 0/40↔0/40、perfect 28/40↔28/40）+方向性补充（锻造满配档 atk+5/ac+5 同种子 30/80 局结局差：perfect 28→33/40）——默认态行为连续铁证+注入面生效证据。机械面文档七件同步（roadmap/entities.yaml 回填实态/06 状态+①② v0.6 措辞订正/存档序列化 v1.7/07 ㉒+game/README 批次段）；实现报告=design/qa/iter23-实现报告-2026-10-12.md（代拍板追认单九条+GDD 反哺点三条待用户）；残留人闸=实机目检工作间形态与购买交互（07 ㉒）。环境注记：render_gate 需 gamedev venv（PIL）。
|
||
|
||
|
||
- **476（2026-10-12，迭代 21 天赋树实装批总收口〔编号顺延——470-475 系并行批次占用，471/472 并行撞号已在彼条注记〕）**：T1-T7 全量交付（worktree g-plan2-iter21-tree 基于开工批 43f7230；master 并行十八笔已并入分支解 active 冲突后回合）。T1 schema 换代（FORK_GROUPS 4→3/RULE_KEYS 2→6/fork 单行双态 effects_a·b/row 退役门槛换轴/R1 裁撤案执行）+33→12 行重排（easter 摘攻防=契约 9）；T2 购买面（easter 拒购/Fork 解锁默认 A/零币切态/彩蛋特化判定）；T3 六键接线（EVENTS+flag_missed/FACTS+battle_index=L2 扩签两处/posture 每关首轮窗/sense 限次 counter 闸 domain:adventure 按关重置/守侧去重闸后发射=契约12/聚入账前×1.5/散双计价点×80%——数值全 provisional 归 M4）；T4 注入换代（树淬炼 flat+锻造加值位预留 0/槽位判定源切树点亮数/ks_refresh 同账路由）；T5 删除批（migrate_tree/buy_forge 家族/forge_products 行族/forge_levels 域/attunement_growth 谓词表/生涯三投影全删；tree_struct=2 标记废弃重置禁迁移）；T6 四柜台并排（树=主界面/两钥匙门+零交互占位面板/图鉴常开/暂停层锻造段连带删）。存量红修复=fx_reveal 三处空 source_class（a57489e9 落地件，基线 51 行脚本错误清零——474 条 FAIL 注记随之销账）。验证：冒烟 886/0（V1-V10/V16 断言随批）+run_all 22 套（新增 V11 六键闭集单测）+probe --click --full 八探针全绿+render_gate golden 0.00%+doc 三闸/熵增闸对基线零新增（worktree 缺 ignored 素材两坑照 463 先例拷 artwork+game/assets/art 后绿）+V19 MC 三组同种子配对×60 局 perfect+max 档全部 61.7%、配对差 0.0pp 在带（normal 档基率地板读数换档记验证记录）；守侧五场景=编排 rig 直注+引擎直构双承载。追认单十二条+反哺点六条+欠账三条落实现报告 design/qa/iter21-实现报告-2026-10-12.md 待用户；残留人闸=实机目检四柜台（V22）。
|
||
|
||
- **477（2026-10-12，迭代 22 秘宝批裁决与落文会话——A 单十五条收口+B 单七条反哺落文+⑤改自动兑付）**：裁决会话逐点呈报、用户逐条裁。**A 单**（实现报告 §二）：①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮ 追认；④ 追认+积点账生命周期裁**战斗级**（设计留白补记秘宝.md 代价轴）；⑤ **推翻·改自动兑付**（用户裁：满 8 安全格自动当轮 AP+1 无玩家入口；进度显示落位=C 区秘宝槽悬停浮窗〔用户点名〕）；⑮ 附报告提交号勘正（master 实际 T5=73db171，原记 7095505 系 amend 前被弃旧提交——merge-base 取证）。卡片 §11 三条回补待裁点随①②③收口。**⑤代码批**（worktree iter22-ruling 基点 79aac07，合入 8455b4a）：兑付迁移 `_on_cell_revealed` 揭示缓冲点（cell_revealed 批先于本格扣费→AP 归零恰逢满点先兑再扣、轮不结束——用户时序规格）；兑换钮整链退役（ap_bar/board_zone/main）；use_attune_convert 消解+attune_convert_state 改进度读数口；use_treasure 积点死分支与 _usable_now 死条件删；tres desc 换代+受理闸删；单测④段重写；07㉑ 观测点换代。**B 单七条全落文**（用户逐点裁「落文」）：秘宝.md v3.0（目录三表实态列/试炼镐自动兑付/代价轴战斗级重置+兑付时序/解锁条件实录/落地前句全换代）/元进度.md v1.17/camp.md v1.3（柜台呈现细则+暂停层 12 行）/存档序列化.md v1.6（vision_used 域+断点随件+bonus_aux_carry 退役）/行动经济.md v0.12（转存率参数化）/术语表 v1.2（自动兑付+真视使用计数两词条）。报告修正（提交号+十五条裁决标注+反哺已落文标注）+06 迭代 22 条收口（裁决小节落 06）。验证：冒烟 898/0+单测 22 套+probe_gate --click/--full 全绿（worktree 拷 .godot/字体与图标边车/assets/art 三坑照 463/476 先例）+合并后 master 冒烟 898/0 兜底；worktree 与分支已清理。残留人闸=07㉑ 实机目检（观测点已换代）。裁决依据文件=.zcode/plans/裁决记录-迭代22秘宝批追认与修改清单-2026-10-12.md。
|
||
|
||
- **478（2026-10-12，迭代 22 反哺⑤呈现集成补丁——用户令「忽略真人目检，查还有无需要修复」的主动排查产出）**：排查抓出追认批一个真缺陷+漏闸三件。**缺陷**：charges=0 件被 `_reseed_attune_charges` 注入循环跳过〔不入骑库存〕而 C 区槽投影遍历骑库存→试炼镐 C 区不可见、悬停浮窗进度无处承载（单测只测读数口未覆盖投影链、探针无此断言=两闸双盲区）。修复=C 区投影末段追加自动兑付件展示行（合成 handle=-1 非库存句柄+note 积点 N/8+槽点击走说明 toast 不进两步交互；四槽容量实证够用=装配≤3+展示行 1）；孤儿函数头注释清一；单测新增④b 两条（装配即入投影/开格后进度刷新）+StubAutoInvRunner 桩。**漏闸补跑**：render_gate（golden 3 屏 0.00% 全绿——golden 锚棋盘区域与 HUD 无涉）+doc 三闸（死链 3/拔旗 1/gdd_lint 三文件表格占比 FAIL 全部实证存量——79aac07 版本逐文件表格行对比零变化）+熵增闸 PASS。（worktree iter22-fix 基点 8455b4a；过程事故一笔=cff741e 首提交误入 .lintbase 临时对比目录，amend 剔除后干净；合入 0ef73d0，worktree 与分支已清理）。闸读数：冒烟 898/0+单测 22 套+probe --full+render_gate+doc 三闸+熵增闸全绿。
|
||
|
||
- **480（2026-10-13，06 待办清单清理批——A类六条+B类四条销号+天赋树欠账三条拆专条）**：用户令「A类已完成即清除+B类逐条核实是否还需开发」。A类六条移除（全部实证已了结）：迭代22追认单十五条+反哺七条（8455b4a/0ef73d0 已入库）/迭代20反哺五条（①-⑤全出清）/迭代20追认十条（落文奇物v3.16）/生命比例扩签（hp_ratio 已销号原条未删，本次物理移除）/active.md定性大裁（已入库）/秘宝体系实现重构落地批（迭代22入库，人闸目检07㉑按「登记不阻塞」规归07）。B类四条核实完成移除：X/Y语义倒置（消耗序X临时→Y→stock存量=先临时后存量，adventure_runner.gd:680-689 注释在案+iter22 T0「X/Y对表」结案）/魔法提灯（拆线随iter22 T1入库；board_view._fog_lantern 残留名已换代为阔视野带通用视野加成非提灯遗留）/冒险BD渠道分工（Boss直接给专长随iter20落地+heal/feat_ticket 行在 shop.tres 货架六行+档位阈值复裁与charge标签缺陷随流派标签集件档位 v2.9 框架级作废失效〔奇物.md v3.8①⑥〕）/资源两新种类（刷新练习/刷新券在秘宝12件表+凭证在货架，边界经三账实现落定）。B5天赋树批条销号（iter21 入库）但欠账三条代码复核全部仍在→拆专条「天赋树实装批登记欠账三条」：①AP上限clamp缺位（action_economy.gd:254 仅 maxi(0,..) 下限实证）；②三选一刷新软上限（原「另立待办」从未成条，本批首次落位成条）；③Y不入断点存档=可利用漏洞仍在（断点存 refresh_stock :236 不存 Y 余量、续玩 :225 自参数面整额重注入=用完退菜单再续玩满血复活）。①③待缺陷修批、②待调参批，均未排批。执行=worktree todocleanup-20261013（主区直改被守卫拦截；主区脏件 cp 随批保史=并行 playnote 五条 +70 行）→ 6406d16 → --no-ff 合回 master；doc 三闸对基线零新增（死链3/拔旗1/gdd_lint 3件FAIL均存量）；零游戏文件零数值。
|
||
|
||
- **481（2026-10-13，天赋树欠账三条裁决落文+③Y断点存档缺陷修批——C类14条用户令暂不做任何动作）**：两连批。**落裁批**（770fa56→663c0bf）：用户逐件裁——①AP clamp 暂不设上限（provisional 天花板亦不投）随 M4 数值批；②刷新软上限维持现状归 M4；③Y 断点存档须修（06 专条状态行换代记账条）。**修批**（用户令「C类先不做，把还没修的 bug 修了，按正常流程走」提前单独开修；worktree ybpfix-20261013 基于含并行 iter23 的最新 master，缓存三件套照 463/476 先例拷 .godot+import边车+assets/art）：adventure_runner 两处=断点字典扩列 "attune_refresh_y"+resume_adventure 优先读断点（缺键回退参数面=旧档零变化，堵「用完 Y 退菜单再续玩满血复活」可利用漏洞）；curio_refresh_paid_test 新增⑥段两断言（余量随断点还原/旧档回退）；文档三件随批=存档序列化.md v1.8（断点随件扩列 v7 域后不升版，v1.6 先例同款）/冒险结构.md v0.21（附随件清单扩 Y 随件——注：清单内 iter20/22 的 refresh_stock/battery_pending/feat_ticket_pity/adventure_counters/vision_counter_used 五键历史缺登，本批不做加法只登本件，缺口在案）/06 专条③销号转记账条。闸=基线冒烟 938/0+单测 24 套全绿→改后同绿（含新⑥段）+doc 三闸对基线零新增（worktree 扫描集曾缺未跟踪五文档致读数漂移，cp 补齐后对齐=死链3/lint 3件FAIL均存量）；8e04807→--no-ff 合回 master e0d931d，合并后主区冒烟复跑 938/0。worktree 与分支已清理。
|
||
|
||
- **482（2026-10-13，迭代 23 收尾批——追认单九项全追认+GDD 反哺三条落文+祝福 registry 漏项补登）**：用户令「追认清单目前看都没有问题；文档反哺点需要你在这里进行更新」。**追认**：报告 §四九项全数追认通过（报告头部标注收口）。**反哺三条落文**（报告 §五标注去向）：锻造工坊.md **v0.7**=①Q1「0 级=未练合法态」正文两处衔接（三件武器节+工作间内容清单·4）②效果类型闭集 24→**31** 两处订正（满级特效扩展位节+现役代码事实表，原记系 2026-10-07 旧快照=迭代20 T1 +7、迭代22 T3 +1，冒烟断言钉 31）③实装边界 1 实态回填（forge.tres/路线 id 六个/字段闭集 12/ConfigDB.forge_* 访问器）；元进度.md **v1.18**=①「跨局注入」节补 effective_ac 第一层终态句（甲型基础 AC=选中甲路线行 base_ac：轻10/重12/魔法护甲9 provisional）②属性锻造段落代（「待用户发令」过期态→已随迭代 23 入库）+登记钥石入口族三写口（forge_buy_level/forge_buy_unlock/forge_select_*，buy_forge 退役后新族）；术语表.md **v1.9**=锻造工坊节新增「路线 id/存档域键名」词条（sword/spear/staff/light/heavy/ward+forge_routes 四键，实现层词汇非玩家可见——报告 §五③「若需登记补登待裁」经本令解为登记）。**漏项补登（核对时抓出，06 改名小批条配套文档面②③「归锻造实装批一并做」但迭代 23 T7 未做）**：entities.yaml terminology 补「攻击祝福/生命祝福/护甲祝福」词条（旧名「X锻升」退役留检索别名）+「石肤（近义词占用）」备忘词条。**06 两处换代**：锻造实装批条状态行补收尾段（追认+反哺落文，本条义务全清）；改名小批条配套文档面②③标已执行。**active.md 同批**：删除并行合并产生的重复 479 开工条（同号双版本 union 遗留，保留 forge.tres 命名版）+快照/当前位置换代。主区脏件保史随批=锻造工坊.md v0.6 续裁行⑤⑥（Q1/Q2 落文，4b 批遗产）。零代码零数值零游戏文件。（worktree rulingfeed-20261013）
|
||
|
||
- **483（2026-10-13，术语表「道具」统称登记微批）**：用户立内部用语习惯落文=**道具=秘宝/奇物/地图战斗资源三类的内部开发统称**（单独说「道具」即指三类全体或其中任一，靠上下文分辨；组合用法=秘宝道具/奇物道具/专长道具/战斗资源道具），仅限开发内部交流、玩家可见面用各类正式名称；同批补登「地图战斗资源」词条（原「奖励道具经济」2026-09-16 更名后一直未入表）。术语表升 **v1.10**，快照事实源行随换代；UI 美化批快照残留行（85e2d2a 批留盘）随本批 sweep 入库。零代码零数值零游戏文件。（worktree term-item-20261013）
|
||
|
||
- **484（2026-10-13，状态面板改名批+迭代 21 GDD 反哺六条落文两连批）**：用户令「①状态 ②全套；反哺六条按呈报落文；两任务一起做完汇报」。**批一改名**（c5a09fd，用户令「暂停层/暂停角标→状态面板/状态角标」——用户 prompt 全量任务书）：文案 4 处（浮层标题/两屏角标/关闭钮 tooltip 按用户句式；副提示原文无暂停字眼零动）+标识符全套（PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族 _open_status_panel 等+探针快照键 status_title/_snap("status")）+game/ 内注释与探针消息 86 处清零（参照语括注来历放文档面，代码 rg 归零）；行为契约四件零动（只读 R4/模态遮罩 P2 甲/输入锁 R3/零动效 P4 甲）。**连带抓漏**：tools/render_gate.sh 截图键 shot_pause→shot_status（首跑 render_gate 红一根因=此，同步后绿）；.godot 类缓存含旧类名（worktree cp 缓存 Parse Error——sed 缓存修，主区合并后同法刷新）。**文档六面**：元进度 v1.19（解锁界面节+改名括注）/07/生涯/06 条（状态面板条目换代+改名批机检注）/architecture json+html（暂停浮层→状态面板）；camp.md 零命中；**08-Alpha版本标准.md untracked 禁碰留置**（内含暂停字样归该批）。html 残留「暂停」皆 archify 查看器自身播放控制文案非游戏面，保留。**批二反哺六条**（c767174，用户裁「按你的来回写」）：天赋树.md **v0.9**（①实装落地态七处换代〔状态行/范围表/总表前言与三行/schema 连带/依赖表/P0 段/验收实态注——「实装未落、现役 33 节点」过渡态终结〕③设计避让句按卡片 v1.7 ⑪②裁决改写为折扣定义边界（散=只覆盖商品购买价，键 gp_cost_mult）⑥机检读数+命中线契约 6 括注+已建未接面节换代〔两接一维持：槽位判定源已切树点亮数/刷新同账路由/命中线纪律维持〕）；元进度.md **v1.20**（②营地统一段落地终态）；锻造工坊.md **v0.8**（④树侧钥匙句 forge_workshop 在役、死指针终结）；HUD框架.md **v0.17**（⑤新增营地四柜台并排小节=登记缺口补齐）。**闸**：批一四件=冒烟 938/0+run_all 24 套+probe --click/--full+render_gate 全绿（golden 0.00%）；批二 doc 三闸对基线零新增（死链 3 逐条存量/term 5 组一致/lint 3 存量同款；worktree 缺 untracked 五文档致首跑漂移 9 链，主区绝对路径 cp 后对齐）+熵增 PASS；合并后主区冒烟兜底 938/0。合并=7d1e9cb（基点含并行术语表 v1.10 微批 187632f，ort 零冲突）。worktree 与分支已清理。**悬置**：A 组 #1（R1：a 维持裁撤/b 推翻补 requires_level 机制位——用户追问中）与 #10（状态面板改名已落地；暂停层锻造段删除异议本身待用户思考结论）。（worktree statuspanel-20261013；登记顺延 484——483 系并行术语表微批占用）
|
||
|
||
- **485（2026-10-13，R1 机制位批——requires_level 等级阈值前置随批重立）**：用户对迭代 21 追认单 #1 裁「b) 推翻，补机制位小批」并令当场做（不占迭代号——用户令小批模式）。落地=卡片 v1.7 留任案形态：meta_tree_table.gd KEY_WHITELIST+requires_level 字段（Dictionary{node_id: n}）+validate 三拒（键悬空/阈值<1/类型错）；meta_progression.gd tree_can_buy 等级阈值判定分支+tree_gate_text 门槛文案+tree_camp_rows 投影行 gate_text；camp_overlay_view.gd 行板未达标 🔒 标+悬停文案；新单测 tree_requires_level_test 八断言（schema 四拒一过+判定三态+投影两态——首跑抓出测试自身时序 bug〔零配置行断言跑在 cap 满状态后〕重排修正）入 run_all（24→25 套）；现役 12 行零配置=机制位空转零行为影响（配置归表行随需填）。闸=冒烟 938/0+run_all 25 套+probe --click/--full+render_gate 全绿（零漂移；MC 豁免=零数值零行为）+doc 三闸对基线零新增+熵增 PASS。文档=天赋树.md v0.10（六处 R1 表述换代：状态行/范围表/schema 连带/购买校验③/调参表/验收前置行）+iter21 报告 §四 #1 推翻标注+§八兑现注。合并 29b08d4（基点含并行 UI 主题卡片批 89b0008）；主区 run_all 25 套兜底绿；worktree 与分支已清理。**迭代 21 追认单终态：十二条全收口**（十条追认+#1 推翻重立+#4 追认带意向）；悬置仅剩 #10 锻造段异议结论（状态面板改名已落地）。（worktree r1mech-20261013；编号顺延 485——483 系并行术语表微批、484 系本会话改名批登记）
|
||
|
||
- **486（2026-10-13，迭代 21 追认单终清——#10 裁维持现状）**：用户裁「维持现状就行了，到时候效果有问题，我再让你做对应的优化更改。现在不用动」——状态面板不补锻造概览（原属性锻造三行的信息缺口：锻造工坊武器/护甲路线等级面板不可见，用户知悉并接受，将来实际游玩效果有问题时按需提优化）。iter21 报告 §四 #10 标注追认结果收口。**至此迭代 21 待用户事项全部出清**（追认单十二条+反哺六条+欠账三条全链闭环）；各批（20/21/22/23）追认与反哺全部出清，项目待用户面仅剩四批实机目检人闸+存量未决面（美术 P0 两项/去毒残留词/喂雷流 R5/通关口径 273 处）。快照/主战场换代。零代码零游戏文件。（worktree log486-20261013；编号顺延 486）
|
||
|
||
- **487（2026-10-13，迭代 24 敌人表内容修批（三关）开工——U0 单会话交付）**：定义入库 0c083bb（主区守卫拦 commit 坑再证——b89c3fe worktree 提交 --no-ff 合回舞步）；开工门=需求卡片 v1.1 零待裁点（Q1-Q9 全裁用户令「按推荐方式」）。基线复读：冒烟 938/0 + run_all **25 套**（卡片/roadmap 记 24 系 485 R1 批加套前旧基线，随批换代呈报）+ probe --click 全绿；改前 MC 锚落盘 sim-data/runsum_iter24_pre_n40both_20261013.jsonl（二档 N=20×both·seed0=9000 沿用迭代 23 配对种子：normal L1 通关 3/20·taken 中位 29.5；perfect L1 19/20·L2 8/20·全通 6/20·taken 中位 76.5）。T1 N1 落地=enemy.tres (1,2) hp 50→22·ac 3→2+表尾批注（阶名化解方案实机未达预期重裁沿革）+V1 两断言（降档锚定+相邻总量比≤2.5 护栏）；T2 N2 落地=skills.tres 12→14 行（venom_spit 毒吐 ×1.6/CD2·shield_bash 盾击 ×1.7/CD3 均无 rider）+六池投放（蜘蛛 (2,5)-(2,7)+毒吐 2、灰矮人 (3,0)/(3,5)/(3,7)+盾击 2、首遇位 (2,4) 不动）+expect_pools 六键同步+旧「技能表十二行」断言换代十四行+V3/V4 五断言（两行字段域/两投放面/逐池增益妨害纪律）。冒烟 945/0+probe 全绿。T3 N3 进行中。（worktree g-plan2-iter24-enemy）
|
||
|
||
- **488（2026-10-13，迭代 24 敌人表内容修批（三关）总收口——单会话 /goal+iter U0 全量交付）**：三提交全量入库（worktree g-plan2-iter24-enemy；26d669f N1+N2 / ab3ba4f N3 / 5f2ef77 文档同步面+收口笔）。**N1**：enemy.tres (1,2) hp 50→22·ac 3→2（敌种 bugbear/池/数量/atk 零动；表尾批注载 2026-09-24 阶名化解方案实机未达预期重裁沿革）+V1 两断言（锚定+相邻总量比≤2.5 护栏）。**N2**：skills.tres 12→14 行（venom_spit 毒吐 ×1.6/CD2、shield_bash 盾击 ×1.7/CD3 均无 rider——damage_floor 兜底与 0.75 档等效）+六池投放（蜘蛛 (2,5)-(2,7)/灰矮人 (3,0)(3,5)(3,7)；首遇位 (2,4) 不动）+expect_pools 六键同步+旧「十二行」断言换代+V3/V4 五断言。**N3**：20 行 attack_type 全填 normal+enemy_table ATTACK_TYPES 枚举校验（缺省 normal 向后兼容）+unit_container 敌方快照+battle_orchestrator 开单第 9 参传值+**damage_controller._resolve_enemy_skill 克制消费点补一行**（卡片 §2 事实漏项——敌方兑付路径原硬编码 delta 0，2026-09-24 批注释在案；不改则 V5 矩阵命中证词物理不可达，属验收闸强制最小补点待用户追认=报告 §四#6）+单据载荷 attack_type 键+V5 四断言（矩阵证词同种子三甲型实测 heavy 2==light 3−1·ward 4==light 3+1）。**读数**：MC 同种子配对 seed0=9000 N=20×both 改前/改后各 40 局（锚落 sim-data/runsum_iter24_{pre,post}_n40both_20261013.jsonl）；三组读数=N1 perfect L1 19→20/20、N2 perfect L2 8→13/20 全通 6→10/20（方向符合预期低于二档判读带，L2 记录不回调，倍率归 M4）、N3 单发恒 ±1（V5 钉死）全局中位位移系构成效应；二档会话累计 ~8 分钟。**文档同步面**：06 三条销号（第一关遭遇表数值异常/第二关技能池与投放/锻造迁移面⑥）+卡片条收口+反哺点五条专条；08 敌种池行注摘除升 v1.2（untracked 件随批转正入库）；07 ㉓ 三目检登记；registry 三处（enemy.attack_type 字段/skill 十四行/hero 甲轴休眠注退役）；Alpha未完成事项梳理三注订正（A2 已修+附.3 缺行疑云解销=L2/L3 缺 2/3/8 系奖励/休整/商店节正常缺省）。**闸**：冒烟 949/0+run_all 25 套+probe click/full+render_gate golden 0.00%（首跑 SKIP 抓出 worktree 漏拷 art 实体——初拷链因 .godot 路径错误短路，补拷后全绿）+doc 三闸/熵增对基线零新增（死链3/拔旗1/雾格1/lint 3件FAIL 均存量）。**待用户**：实机目检三观测（07 ㉓，登记不阻塞）+追认单三项（消费点补行/旧断言换代/两 untracked 件转正）+GDD 反哺五条。基线漂移记档=run_all 24→25（485 批）。合并=321e6c9（roadmap 与并行迭代 25 编入批 7e0f519d union 解——迭代 24 行已入库门列+迭代 25 UI 批行+26+ M4 行并存）；合并后主区 --import 重刷+冒烟 949/0+run_all 25 套+probe --click 兜底绿。（worktree g-plan2-iter24-enemy；编号顺延 488——487 系本会话开工条）
|
||
|
||
- **489（2026-10-13，迭代 25 UI 全局主题批开工——/goal+iter U0）**：开工检查全过：需求卡片 v1.2 零待裁点（三范围裁点+三 grilling 裁点+同日审核六点全落文）；验收清单 V1-V6 三要素齐（V1-V6 自动闸机+V6 中文字体防御 v1.2 新增）。自洽扫描事实抽查全符（project.godot 仅 custom_font 无 gui/theme/custom/ui_kit:735 styled_slider 与 :753 tooltip_theme 在役/ui_assembler:105 挂载行/consumers=settings_overlay:59+debug_overlay:277 裸 HSlider 双轨/HSeparator 15 处/tooltip_text 11 文件/theme 目录不存在/art/ui 无滚动条滑轨勾选贴图）；一处事实 drift 记录继续（有利方向）=卡片 §5 称 08-Alpha版本标准 系 git 未跟踪文件，实际已于 5f2ef77（迭代 24 文档批）转正入库——手工搬运条款 moot，worktree 直接可见。定义面四件（roadmap 迭代 25 行/需求卡片/06/08）均已跟踪且干净（迭代 24 收口批 7e0f519d union 解带入），T0 无需新定义入库提交；主区脏件全属他批遗产零碰（.gitignore/.zcode/02/playnote/四 untracked/三 .uid）。基线复读全绿=冒烟 949/0（V5 基线按卡片「开工日实测为准」口径订正为 949/0，卡片记 938/0 系迭代 23 时代数）+run_all 25 套+probe --click 全绿残留 0（ui_input 17 断言/ui_struct/ui_contrast 38 对/click 行为走查问题 0）。worktree g-plan2-iter25-theme（分支 iter25-theme-20261013，基点 5f8acd0）已建，冷检出三件套（art 主区绝对路径拷贝+字体 .import 拷贝+--import 刷导入件）完毕，T0 主题资源起。
|
||
|
||
- **490（2026-10-13，迭代 25 UI 全局主题批总收口——单会话 /goal+iter U0 全量交付）**：T0-T2 三卡全落（worktree g-plan2-iter25-theme，两提交）。**T0 主题资源**：`game/assets/theme/main_theme.tres`（15 类型=V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator+预盖 CheckBox/CheckButton/OptionButton/PopupMenu）挂 project.godot `gui/theme/custom`；位图生成脚本 `tools/gen_theme_icons.py`（PIL，幂等）产 9 张纯色/几何小位图落 `game/assets/art/ui/gen/`；色值溯源表 `game/assets/theme/README.md`；`default_font` 显式指现役同字体文件（V6 中文字形防御）。**T1 换代退役**：ui_kit.gd 删 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 整函数、ui_assembler.gd 删挂载行（旧实现同批删除）；settings_overlay 音量滑轨几何内联（裸 HSlider+200×24）、debug_overlay `_slider_row` 补注释（双轨消隐=两处均走全局主题）。**T2 断言与文档闸**：冒烟新增 `_smoke_global_theme()` 38 断言（V1 类型覆盖+Button/focus 双红线+V2 冻结值锚定+5.49:1+V3 预盖证词+V4 退役零残留+V6 字体防御双断言）；06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 v1.3（三·界面主题行→在役+五·表现细节修行注；余五行本批零触碰已逐行核对）；07 ㉔ 全屏巡检登记；roadmap 迭代 25 行换代。**引擎事实三证**（4.7.2 源码+默认主题链双查，探针实证）：①CheckButton 与 CheckBox 同套 checked/unchecked 图标名（卡片 v1.2 注③「on/off」不成立——按引擎事实落位否则预盖静默空转，订正随报告呈报）；②Slider 无 grabber_pressed 图标槽（冻结表「柄·按」GOLD_DEEP 留档未落位）；③ScrollBar 柄=StyleBox 非 Icon（滚动条无位图，increment/decrement 箭头默认主题未定义=无箭头按钮）；另证 4.7 导入参数无逐贴图 filter 标志（位图原生尺寸消费无滤波伪影，全局设置红线未触）。**位图不入 git**：.gitignore:52 `game/assets/art/**`（注释明文「运行时资源本地生成不入库」）——卡片 T0「.import 侧车随批入库」与政策冲突，按政策执行（脚本入库可再生+README 溯源+主区随批拷贝 gen/），例外强制入库与否呈报追认。**闸**：冒烟 987/0（基线 949+38）+run_all 25 套+probe click/full+render_gate golden 0.00%（3 屏）+doc 三闸/熵增对基线零新增（死链 3/词命中 2/lint 3 FAIL 均存量）；MC 零跑（零数值零行为=纯呈现）。**待用户**：实机目检全屏巡检+专项观察点二（07 ㉔）+代拍板追认单八项+GDD 反哺点五条（design/qa/iter25-实现报告-2026-10-13.md §四/§五）。合并=见 git（主区 merge --no-ff；合并后 --import 重刷+gen/ 位图拷贝+全量复跑留痕）。
|
||
|
||
- **491（2026-10-14，迭代 26 UI 交互与观感批开工——/goal+iter U0）**：开工检查全过＋两发现按用户裁诀执行。门=U0（本次会话 /iter 26 发令）；卡片 v1.2 零待裁点（grilling 两轮八裁全落）；V1-V7 验收清单三要素齐（V1-V6 自动闸机＋V7 对拍面）。自洽扫描事实抽查 20+ 处全符（_apply_button_skin hover=常态图/disabled=pressed 错配 ui_kit:541-555；primary/danger 无 focus 盒与 disabled 错配 :575/:591；BCard 图标槽 76×76 :659-663；顺位徽标 GOLD_DEEP standee:441；护甲徽标 ward=HERO_BLUE/heavy=GOLD_DEEP :492/:494；GOLD_DEEP 语义岗 standee:199 意图动画判据；RAP 行 STONE_FAINT ap_bar:77；beams 硬边 :263-277；vignette/gradient 无显式 filter；project.godot 无 default_texture_filter；诊断钮无条件挂载 main:333-334＋_on_diagnose_pressed :1290；冒烟双红线 smoke_all:5377/5385＋对比度 helper :29-37；商店纯文字行/三选一已居中/营地四栏不等高；裸 Button.new() 全库仅 uikit:446）。**发现①**（用户裁按建议改法）：卡片 §2.2 texture_filter 枚举漏登 board_world.gd:50（hero NEAREST），计 12 实测 13——已勘误落卡（NEAREST 10→11），该点与全局 Nearest 同向、零翻转风险、不进白名单。**发现②**（用户知会择机自理）：主区 game/project.godot 编辑器对调脏件（theme 两行换序语义等价）——合并点复检，受阻停机呈报不擅动；另主区 active.md 脏件系编入会话快照遗产，本批 active.md 台账一律走主区侧写、不入分支（避免合并互撞），收口后随批在主区单独落 docs 提交。定义面入库 04ec217（roadmap/06/需求卡片指名三件）。基线复读全绿=冒烟 987/0（与在册一致）＋run_all 25 套＋probe --click 全绿残留 0（ui_input 17 断言/ui_struct/ui_contrast 38 对/click 行为走查问题 0）。**枚举两份**（T0 交付）：①纹理过滤翻转面——显式 filter 13 处（NEAREST 11＝ui_assembler:188/battle_end:60,76/board_fx:150/board_view:310/board_world:50/hero_info:202/level_map:169/standee:222/uikit:234,508,671；LINEAR 2＝board_world:43 脚影/status_slot_row:127 状态图标）；无显式 filter 仅 3 处（ui_kit:253 vignette/:272 beams/:291 gradient_base）＝T2 白名单对象；StyleBoxTexture 九宫格（_tex_sb 产线 button_stone×2/panel_stone/border_stone）＋主题 OptionButton 石纹样式盒（SBTex_btn/SBTex_btnp，非 Button 类型、红线不破）/滑轨抓子/勾选/箭头图标翻 Nearest＝意图面；.tscn 零纹理节点（TextureRect/Sprite2D/TextureProgressBar/NinePatchRect/TextureButton/AnimatedSprite2D/TileMap 全零）。②按钮消费点 49 处（button 43＋verb 1＋primary 4＋danger 1）全经四工厂，T1 覆盖面闭合；禁用态实跑点=shop_overlay_view.gd:117 余额不足禁用。另核：ui_contrast_probe 测点表为静态常量对、不覆盖禁用态（disabled 幽灵化不踩该闸）；主题层 SBTex 两子资源归 OptionButton 名下。worktree g-plan2-iter26-ui（分支 iter26-ui-20261014，基点 04ec217）冷检出三件套（game/.godot 5.8M＋art 931K＋字体 .import）＋--import 刷新 EXIT=0，T1 起。
|
||
|
||
- **492（2026-10-14，迭代 26 UI 交互与观感批总收口——单会话 /goal+iter U0 全量交付）**：T0-T6 八提交全量入库（worktree g-plan2-iter26-ui，分支 iter26-ui-20261014：b6f0c66 T1 五态/9ddb571 T2 Nearest+白名单/7cac0dc T3 换墨/86e9aea T4 光柱/02c87fc T5 细节/260c9bb T5b 诊断钮/900dfe9 T6 文档闸）。**T1**：ui_kit 三厂五态统一管线（hover=常态图+modulate 1.06 提亮〔乙案〕/disabled=本族底+α0.45 幽灵化〔甲案，旧「=按压图」错配修正〕/focus=INK 2px 内缩 1px 环〔甲案，负 expand margin 实现，引擎 focus 叠加绘制不遮钮底〕/危险钮补本族 pressed 深档），逐实例 override 主题层零新增；冒烟 +35 断言。**T2**：project.godot default_texture_filter=0＋vignette/beams/gradient_base 显式 LINEAR 白名单；+6 断言。**T3**：立 GOLD_BRIGHT #E0B860/HERO_BLUE_BRIGHT #7EBAF0 两 token（语义岗冲撞走反哺点③），顺位/重甲/魔法护甲三徽标+RAP 行换墨（6.47/5.88/5.98:1）；+9 断言。**T4**：beams 带内 0→0.05→0 三角过渡+纵向衰减（连续 alpha，Q7 裁）；+3 断言。**T5**：SLOT_BACKDROP_SOFT #806A4E（白图标 5.14:1 ≥3:1）+商店 ALIGNMENT_CENTER+营地四栏等高（三 holder min 336+四面板 FILL+锁文居中）；+8 断言。**T5b**：诊断钮卸载点+build_diag_button 工厂同批删除，转储入口迁调试浮窗（diagnose_requested 信号+区块⑤钮，Q8 裁甲）；ui_tune_probe 只读巡检同批入册（白名单+_emit_diagnose_requested、连接数 10→11）；+7 断言。**闸**：冒烟 987→**1055/0**（+68）+run_all 25 套+probe click/full 全绿+render_gate 全绿（shot_checker A-D 过；golden 三屏 **0.00%**——T6 第4 步登记即结未重制基线；战斗屏 draw_calls 191=基线 270 的附带收益）+doc 三闸/熵增对基线零新增（lint FAIL 集=06/07/术语表基线三件；08 一度因新增表格单元格撞 R3「日期+裁决同括号」正则，改措辞回绿——教训=08 表格单元格注记禁载「日期+关键词」同括号）；MC 零跑。**文档同步面**：06 四条销号/氛围层改记「九宫格半存续」+反哺点四条新条+需求卡片条标已收口；08 v1.4；07 ㉕+v0.9；roadmap 迭代 26 行→已全批入库；实现报告=design/qa/iter26-实现报告-2026-10-14.md（代拍板追认单十三项+GDD 反哺点四条+目检五项）。**合并**：主区 game/project.godot 编辑器对调遗产脏件挡合（发现②预案场景）——用户裁「授权提交该对调」，落 no-op 提交 081ae3b 后 merge --no-ff **c8c3db1**（17 文件 +442/-48）；合并后主区 --import 重刷+冒烟 1055/0+run_all 25 套+probe --click 全绿残留 0。active.md 台账本批全程走主区侧写（不入分支，避合并互撞——编入会话的 active.md 遗产脏件同因）。**待用户**：实机目检五项（07 ㉕）+代拍板追认单十三项+GDD 反哺点四条。
|