74 lines
36 KiB
Markdown
74 lines
36 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-13（迭代 23 收尾批——追认单九项全数追认+GDD 反哺点三条落文+「祝福」registry 登记漏项补登；worktree rulingfeed-20261013）。
|
||
- **批末闸全绿**（迭代 23 实装批存证）：冒烟 938/0+run_all 24 套+probe --click/--full 八探针+render_gate（golden 0.00%）+doc 三闸对基线零新增+熵增 PASS；MC 同种子配对 80 局逐位零漂移。
|
||
- **现行文档事实源**：秘宝.md v2.9（目录 v1=12 件已实装）+奇物.md v3.16+天赋树.md v0.8+**锻造工坊.md v0.7**+**元进度.md v1.18**+**术语表 v1.9**。
|
||
- **迭代 23 待用户事项已全清**：追认单九项追认通过（报告 §四标注）+反哺三条落文（报告 §五标注）；残留人闸=实机目检锻造工坊工作间形态与购买交互（07 ㉒）。
|
||
- **迭代 21/22 残留人闸不变**：实机目检营地四柜台〔07 ⑳〕+秘宝解锁-装配流程〔07 ㉑〕；迭代 20 残留人闸=实机目检五件+V20/V21/V22 人工核对半（07 在册）。
|
||
- **已裁在册**：M4 数值批顺延迭代 24+ 未排期（锻造工坊 provisional 终值归其统一标定）。
|
||
|
||
## 项目当前位置（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，goal 会话 U0 开工总收口）**；**迭代 22 秘宝体系实现重构落地批已入库（2026-10-12，T1-T7 全量交付）**；**迭代 23 锻造工坊实装批已入库（2026-10-12，/goal+iter U0 开工单会话总收口）**；M4=迭代 24+ 未排期
|
||
- **近期主战场**：迭代 20/21/22/23 四批残留人闸（实机目检：专长五件 / 营地四柜台〔07 ⑳〕/ 秘宝解锁-装配〔07 ㉑〕/ 锻造工坊工作间〔07 ㉒〕）+ 迭代 21 实现报告追认单与反哺点待用户（迭代 20/22/23 三批已全出清）；**下一前沿=M4 数值批，待 U0 发令**
|
||
|
||
## 未决面（进行中/待人闸/待裁点指针；现行事实源登记处=`design/gdd/06-待办清单.md`）
|
||
- 待用户裁决：美术审计两项 P0（art-bible 死样张指涉+主角像素管线重产；06 在册）；去毒残留词扫否（魔法道具约 30 处/罕见约 18 处，呈报在案）；喂雷流 R5 甲重启条件回落文（一句话件）；「通关 vs 通过第 N 关」全库口径统一 273 处（待裁是否补登记 06）；迭代 20 实机目检五件+V20/V21/V22 人工核对半（07 在册）
|
||
- 待发令：M4 数值批（迭代 24+，未排期——锻造工坊 provisional 终值/钥石产出重标/削弱档终值/元进度定价余面归其统一执行）
|
||
- 进行中：黑话清扫第二波（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）
|