gplan-2/active.md

会话状态：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-12（迭代 23 锻造工坊实装批总收口——worktree g-plan2-iter23-forge 八提交，T0-T7 全量交付）。
• 批末闸全绿：冒烟 938/0+run_all 24 套（含 forge_table_test/forge_workbench_test 两新套件）+probe --click/--full 八探针+render_gate（golden 0.00%）+doc 三闸对基线零新增+熵增 PASS；MC 同种子配对 80 局逐位零漂移（锻造满配档方向性补充 30/80 局差）。
• 现行文档事实源：秘宝.md v2.9（目录 v1=12 件已实装）+奇物.md v3.16+天赋树.md v0.8+锻造工坊.md v0.6+术语表 v1.8。
• 代拍板追认单九条+GDD 反哺点三条待用户（design/qa/iter23-实现报告-2026-10-12.md）；残留人闸=实机目检锻造工坊工作间形态与购买交互（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 ㉒〕）+ 各批实现报告代拍板追认单与 GDD 反哺点待用户；下一前沿=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）

• 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）

• 480（2026-10-12，迭代 23 锻造工坊实装批总收口）：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.6/07 ㉒+game/README 批次段）；实现报告=design/qa/iter23-实现报告-2026-10-12.md（代拍板追认单九条+GDD 反哺点三条待用户）；残留人闸=实机目检工作间形态与购买交互（07 ㉒）。环境注记：render_gate 需 gamedev venv（PIL）。

• 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」断言不受影响：新行族落新表）；③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）。代拍板立项（白名单内）：新表 forge.tres（ForgeTable：默认两轴+六路线行族）；路线 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 起。

• 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）。