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 v1.6（2026-09-12 /create-architecture 产出；2026-10-15 确立为架构唯一事实源——历史决策文档体系已废除、沿革归 git commit log；review-mode.txt = solo）
• 待办清单：design/gdd/06-待办清单.md（2026-09-16 收编批起为全项目待拍板唯一登记处；系统文档只留指路存根，新增条目直接登记清单，裁决后改状态列留痕）
• 批次产出物：迭代批的实现报告、代拍板追认单、GDD 反哺点清单落根目录 reports/（2026-10-17 用户裁：迭代批禁止写 design/，reports/ 是其唯一可写目录）；证据只留最新一轮，细则见 design/dev/doc-conventions.md §11
• 工程路线图：根目录 roadmap.md（里程碑时间线的权威；实时状态看下方快照节）

当前状态快照（收口批先更新本节，再追加状态记录；≤10 行）

• 更新于：2026-10-17（在途线头收编批已合并——art-standee-20261006 立绘定档批合入＋doc-adr-fixes-20261014 判废删除，两 worktree 与分支已清（用户令）：立绘机检三件工具与 2026-10-07 三处文档修正（溢出甲案×2／参考核验废路径更正）＋06 新登「战斗区背景图替换」条落 master，13 件未跟踪立绘抢救至 artwork/archive/standee-tier-20261007/（素材不入 git）；立绘批引擎实装与人闸两段仍未跑、roadmap 迭代位归属仍待裁。此前同日已合并迭代 30 卡① 7ffd1dc0、迭代 29 批 fff4f120、闸按域分跑批 60c25ca3、GDD 反哺写入批 bd6ab32e，M4 数值批已废归 06 待裁）。同日文档批（iter30-fb-20261017）：卡①代拍板七项追认通过（用户令「追认没有问题」）、反哺点七条全部回写（06/HUD框架/08/art-bible/roadmap/07 六文件＋两份 reports 批注），--docs 域闸零新增红。
• 最新闸态：重闸唯一入口 tools/run_all_gates.sh 按改动域分跑（代码域 01 冒烟／02 单元／03-04 探针／05 渲染／09 静态扫描／10 熵增／11 对拍，文档域 06 gdd_lint／07 doc_link／08 doc_term／08b active.md 体量／10 熵增；域划分只在该脚本定义一处，文档禁止另列闸清单）。文档域末次回执 commit=分支尖（2026-10-17 线头收编批，见合并说明），零新增红。代码域末次实测读数（2026-10-17 迭代 30 卡①合并态，回执 commit=7ffd1dc0）：冒烟 1151/0、单元 34 套件（type_glow_test 51 检查）、探针十八断言、渲染 golden 棋盘×3（0.13/0.11/0.10%）与菜单（0.14%）均在容差内、static_scan 相对基线「改善」（基线红→现绿）；11 号闸 parity 是条件闸件，本批判未触面（diff 未触数值/存档/RNG/结算面）SKIP，迭代 29 批判为触面、须 PARITY_APPROVED=1 才发起，MC 未跑。
• 迭代 28 交付：修好启动时菜单被冒险层盖住的装配顺序，层序收敛为唯一装配合同（散落的两处 move_child 删除）；boot 链路、九阶段生命周期、启动态菜单 golden 三组验收补全；本批新立硬规则「验收函数无变异红记录不算验收成立」，三处规约落文。
• 迭代 27 交付：三屏壳场景与局态物化、结算五段拆分、RunLedger 单类持四账、模态编排类、类型闸、死代码退役，编排器由 1725 行降到 1325 行。
• 规约体系现状：规则文件按领域拆为 7 份、单文件上限 150 行，CLAUDE.md 只留元信息、命令、目录、规范导航与一行一条红线；动手前按规范导航表查对应细则。2026-10-17 增两条硬边界：迭代批（/iter 发射的代码实现）对 design/ 只读、禁止在其中新增/修改/删除任何文件，产出物只准落 reports/，批末只跑代码域闸；非迭代批（工具/规则/文档改动）不占 roadmap 迭代号，按改动域跑闸。
• 人闸在册两件：迭代 27 全流程走查〔07 ㉖〕与迭代 28 启动态菜单〔07 ㉗〕，均登记不阻塞；贫矿脉目检项〔07 ⑪〕已随 2026-10-16 屏蔽令转记失效；迭代 19~26 的目检已于 2026-10-14 全部核销。
• 簿记出清：迭代 19~26 的代拍板追认单与 GDD 反哺点已全部裁决落文，对应 14 份迭代实现报告按「证据只留最新」删除（git 历史可考）。
• 已裁在册：M4 数值批已废（2026-10-16 用户删卡令——禁止再以该名义立批/规划/引用已删卡，四项数值欠账归 06 在册、重新归属待裁）；迭代 29=测试分层与门禁语义修正批已合并（fff4f120，十提交）；迭代 30=UI 呈现三卡批·卡①未开格类型徽章批已合并（7ffd1dc0，2026-10-17；卡片 v1.4＋开工前预授权 U1 四项已用完；迭代内串行剩 ②战斗一屏样张→③二三关棋盘观感，各须 /iter 发令，禁并行）；迭代 27/28 位预留追加卡。
• 界面美化三层：第一层三件全部交付；余第二层三件（贴图/字体/样张）与第三层其余（九宫格切片/棋盘观感）待立项。

未决面（进行中/待人闸/待裁点指针；现行事实源登记处=design/gdd/06-待办清单.md）

• 待用户裁决（06 在册）：美术审计两项 P0（art-bible 死样张指涉、主角像素管线重产）；去毒残留词是否清扫（「魔法道具」约 30 处、「罕见」约 18 处）；喂雷流 R5 甲重启条件回落文；「通关」与「通过第 N 关」全库口径统一（约 273 处）；贫矿脉屏蔽的设计语义面反哺五处（地形变异.md §全局作用域型／HUD 框架三层预告／教学引导手册行／难度曲线与Boss 两行／art-bible §4.6.3 括注——均描述已撤回功能，待裁是否改写，机械面已同步）。
• 待登记 06：需求卡片入库纪律一条（502 批遗留，2026-10-17 在 06 清单内查无该条，属悬空待办）。
• 待用户追认：仅剩 req-card 技能的 WorkBuddy 与 ZCode 两份副本是否取齐一项。迭代 27 代拍板十五项、迭代 28 十三项（含四条白名单外）、迭代 29 十二项、迭代 30 卡① 七项已于 2026-10-17 用户令全部同意（iter30 追认令原文「追认没有问题」）——iter27/28/29 三份实现报告（2026-10-17 文档批已迁位 reports/）的追认单节已就地标注追认结果，iter30 卡① 追认单（独立文件）文末已加追认结果行；迭代 29 第四节「经你裁决的四项」不在追认范围（当时已问过已答）。
• 待发令：迭代 30 UI 呈现三卡批·卡②战斗一屏样张批与卡③二三关棋盘观感批（卡①已合并 7ffd1dc0；②③卡片=design/research/需求卡片-战斗一屏样张批-2026-10-16.md／design/research/需求卡片-二三关棋盘观感批-2026-10-16.md，v1.2 零待裁残留，②不适用卡①的 U1 预授权并留分类结论注，③有 Q2 判据自动裁/目标带批内自定/L3 分类预授权；两批合计 ≈7.5–10.5d，逐个 /iter 发令）；迭代 27/28 预留追加卡；黑话清扫第二波（GDD 正文流程动词族约三千处）；规则文件编写 skill（按规则文件审计与目录划分批的工作流提炼，见提交 81c0ee2b）。
• 待批准发起：11 号闸 parity 回放确定性对拍（迭代 29 把它收编为重闸里的条件闸件，每次跑批只做触面判定、不自动跑；迭代 29 批已判触面并挂 NEED-APPROVAL，批准方式＝带 PARITY_APPROVED=1 发起，MC 须用户批准才跑）。
• 在途分支未合并 master（读现状时勿当已入库）：无。线头清理（2026-10-17 用户令）：art-standee-20261006 已合并入 master（立绘定档批机检三件＋文档修正，见状态记录 511）、doc-adr-fixes-20261014 判废删除（ADR 体系已废、内容 git 历史可考），两 worktree 与分支同删。已合并的 worktree/分支清理（2026-10-17 用户令执行）：g-plan2-iter29-testlayers、g-plan2-menusub-20261016 两工作区与分支 adr-purge-20261015、adr-leak-fix-20261016 已删；ci-removal-20261015 已按 2026-10-16 既裁重做（只删 .github/workflows/tests.yml、撤 ADR 两条）合并 db032fb5 后工作区与分支同删；在盘待删：g-plan2-carddoc-20261017（分支 carddoc-20261017 已合并 480d8118）、g-plan2-iter30-glow（分支 iter30-glow-20261017 已合并 7ffd1dc0）、g-plan2-iter30-fb（分支 iter30-fb-20261017 已提交 34f3cdb3，合回 master 后删）三工作区，删除待令。
• 在册观察（06 登记，非阻塞）：迭代 27 卡片义务补登两项——长函数余量 17 个中的装配/校验函数、lambda 连接防回归。

状态记录（滚动窗口：仅当前迭代；退役规则见 doc-conventions §10）

• 496（2026-10-15，迭代 28 启动装配与生命周期验收补全批总收口）：单会话交付七提交并合并 5b958ff6，冒烟 1086→1125/0（新增 42 条断言，退役 3 条把错误顺序写成期望值的裸下标断言）。四条结论：①启动装配顺序错误（菜单被冒险层盖住）已修，层序判定收进单一合同 LAYER_CONTRACT，散落的两处手工 move_child 删除；②boot 链路十断言与九阶段×五引用面生命周期矩阵入库；③渲染面补两件探针自检、墨色判据与启动态菜单 golden；④六次变异注入全部见红并精确还原，拦截能力已证。变异 3 顺带证明墨色占比判据自身不可靠——菜单被藏时底层棋盘仍给高反差像素，该强弱分层写进 code-conventions §3.6。批内类型闸自纠一笔（main.gd:453 缺元素类型，改 Array[Variant] 后 S9 归零）。存档面风险已核实：全部 worktree 共享同一份 user://save.json，定位过程中临时移开的真实档已逐字节校验还原。

• 499（2026-10-15，active.md 收口机制批）：用户裁定收口检查的触发时机不能挂在"一轮答话结束"上——旧的 Stop 钩子判的是「active.md 内容有没有变」，追加新条目就算变，结构上永远抓不到"没删旧条目"；且它比对的还是已废弃路径 production/session-state/active.md。实测三份 harness 副本现已全部失效：Qoder 侧快照零份、ZCode 侧没接 Stop 事件、Claude 侧配置为空。改法分两层：机械层 = tools/audit_active_state.py 判五条膨胀签名（状态记录条目数超 30、快照行数超 10、条目编号重复、快照整行自我重复、指向 design/qa|design/research 的死指针），并入 tools/run_all_gates.sh 为 08b，由既有合回闸回执强制，不另立第二份闸清单；语义层 = active-closing 技能，规定用户问「任务是否结束」时先跑闸、按 §10 三判据逐条核对并删除、报删除清单，然后才回答。变异验证：对换代前的 34 条版本报 5 项红（连 472/477/481/494 撞号与 6 处报告死指针一并抓出），对退役后的 3 条版本报绿。钩子副本收敛为单一事实源：.qoder/settings.json 改指 .zcode/hooks/worktree-guard.sh，该脚本加 QODER_PROJECT_DIR 兼容并把 .qoder/ 纳入豁免面（gitignored 配置走 worktree 带不进去），.qoder/hooks/ 三份副本删除。脚本层守卫五例实测（stdin 直喂）：主区改 tracked 文档拦、改 active.md 放行、改 .qoder 放行、主区 commit 拦、无全量回执的 merge 拦。待核：hooks 属各 harness 私有配置、不随仓库传播——ZCode 侧确认在跑，Qoder 侧本会话活体探针未被执行（.claude/settings.json 仍为空），故拦截力目前只在 ZCode 生效，成因待诊断。全量闸由用户自跑，本批按令合回 master（分支 active-gate-20261015，合并见提交史）。

• 500（2026-10-15，决策文档体系废除 + architecture.md 确立架构唯一事实源，文档批）：用户裁「ADR 不需要保存，任何决策记录在 git commit log 里记好，不需要工作日志文档存在」——七份 adr-0001~0007 全删（内容留 git 历史），architecture.md 删「ADR 审计」「ADR 立项清单」两节、文档状态立「事实源地位」条（唯一事实源），未决表关闭 QQ-01/02/03、立项清单在途事项转登记 QQ-11~14，补 A1 生成姿态与 autoload 四件（ConfigDB/RngService/SaveManager/MetaProgression）事实；CLAUDE.md 新增「架构事实唯一源」红线并恢复 RNG 单点红线；doc-conventions §5/§11 落架构唯一事实源条文；registry 删 18 处 adr 字段；game/ 约 60 处代码注释与 GDD/qa/research/roadmap/tests README 引用全清，豁免标记 ADR-0007-exempt→rng-seed-exempt 五处同步（main.gd/static_scan.sh/architecture.md/06/iter27）；主区 4 个未跟踪今日产物（测试审计报告/两张需求卡片/自造短语清单）就地清除。走 worktree adr-purge-20261015 合并 4ed48b86；死链校验 1206 链接 0 死链、gdd_lint 0 不通过；按用户令未跑测试闸（本会话合回闸未触发、receipt 未生成）。代码中 adr/adr5 等为 AdventureRunner 既有局部变量名（smoke/单测 5 文件约 60 处），非文档引用、未动。遗留呈报待用户裁：ci-removal-20261015 worktree 的 ADR 两条改动已被本批取代（仅 CI 清除部分对迭代 29 有效）、doc-adr-fixes-20261014 分支方向已废，两个 worktree/分支的去留待裁（2026-10-17 核：ci-removal-20261015 已合并 master、worktree 仍在盘；doc-adr-fixes-20261014 仍未合并，两条的现状与清理待令都记在未决面。同日再核：两线头已随状态记录 511 收编清偿——ci-removal 合并删净，doc-adr-fixes 判废删除）。

• 501（2026-10-15~16，简明技术中文用语规范批总收口）：用户令对 design/gdd 全 45 文件做三层语言规范并融合词表——词面约 250 处按术语表「用语规范」A 表替换（不得→禁止/收口→完成/随批→顺带等 12 行，五子代理分四波执行+逐处语境裁决）、术语表 v1.12 新立「用语规范」节（STC 词表为权威+豁免三类+注销词义限定注）、词条五组（总线/抽屉、机能件/机制件、装板/摇号、坍塌显形、增益归一）+死链全库清零（3 处：config_fatal_probe 去向双证落 v0.4 行注、武器锻造漏改 2 处）+doc_term_audit 吸收 A 表 10 词与随批/台账补扫通道。本批两教训：①合回闸与「文档批零测试」铁规冲突时助手机械服从、擅跑全量测试两轮（含渲染闸），用户暴怒——正解=改闸的判断条件，现守卫已加「纯文档合入豁免」（merge diff 不触 game/ 直接放行，代码合入仍全量闸）；②坑册新增：守卫按命令文本解析分支名（cd 前缀/环境变量前缀连坐误拦）、.import 边车被全局忽略致 worktree 冷检出探针 texture=null 假红。合并 af321c03（九提交，纯文档合入未跑测试，同日 4ed48b86 前例）。

• 502（2026-10-16，迭代 29 编入批——roadmap 门牌登记）：用户令「把需求卡片写进 roadmap 的迭代 29」——此前需求卡片只存在于中间文档，roadmap 仍写「下一前沿=迭代 29+ M4 数值批」，致别的会话启动迭代 29 时跑去做 M4（该卡同日已被用户删除＝死引用）。本批三改：①roadmap 迭代 29 行改写为「测试分层与门禁语义修正批」（需求卡片=design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md，v1.4，T0–T8≈5.5–7d，开工门 U0＝Q3–Q7 裁点＋卡片 v2.0 重核＋/iter 发令），新增「迭代 30+ 位空」行记录 M4 废除（禁止再以该名义立批/规划/引用已删卡；四项欠账归 06 在册待裁），迭代 23+ 原始泊位行加作废注仅作排期史保留；②需求卡片升 v1.5（排期行与 §5 同步行更新；登记 v2.0 重核遗留＝残留 CI 措辞四处＋事实基线换代〔冒烟 1086→1125/0、门禁五闸→run_all_gates.sh 编排、architecture.md 测试域节已成文、Q3 的 CI timeout 前提消失〕；订正 v1.3 版本条目尾部重复段）；③本文件快照与未决面三行同步换代。文档三闸全绿（gdd_lint 0 不通过／死链 0／疑似现行 0）。提交 21c83f5。遗留待用户裁：06 待办清单登记一条（卡片入库纪律）；ci-removal-20261015 分支重做（撤 ADR 两条、只保留删 .github/、rebase 现行 master）。（2026-10-17 核：该分支已按现状合并、重做令失效；「06 登记一条」至今在 06 清单内查无，已改记在未决面的待登记项。）

• 503（2026-10-16，贫矿脉屏蔽＋DS_DEBUG 写死批总收口）：用户令两项一波走完（worktree g-plan2-shielddebug-20261016，五提交，合并 d3356985，合并后主区冒烟 1126/0 兜底）。①贫矿脉屏蔽：variation.tres 删 skewed_veins 行（用户裁「地形变异特异关卡后续重新做设计，先屏蔽」）——Boss/精英图全局池空→_resolve_global_variant 空行回落→region 布置原路兜底，玩家面零横幅零角标零资源偏斜；冒烟 7 处断言换代为「全局池空→region 兜底回落」路径（行数 7→6／boss 池去 global 行／L2 boss+elite 全局决议空行／格子级恰一行且在 {magma,ash}／快照空态一致／同种子确定性含 variants 字典逐位）；resource_face 机制代码（RewardEconomy 偏斜投影／schema 互锁／负样本）零触碰，重建设计直接加行即可；删行依据与首发批裁决记录改写为屏蔽注记（git 历史可溯）。②DS_DEBUG 写死：main.gd:219 环境变量读取退役、_debug_entry 恒 true（用户令「直接写死，不读环境变量，太麻烦」）——全库 DS_DEBUG 引用清零（含浮窗内用户可见工具提示文案）；闸断言三处换代（smoke V2f 改恒开／click_probe 原「未设时不得默认开」反转为「未恒开即失守」并挪至 boot 段、设置面关闭段补 ModalStack 遮挡恢复断言／tune_probe 删自设环境变量死代码）；发布前删除事项＝main.gd:219 一行（无 CI，两道恒开断言会红兜底；该行现行位置与行号见 507 条＝game/presentation/main.gd:196）。闸面三修（首跑抓出）：冒烟跨块引用 bb/crng 出作用域 Parse Error（hoist 为 boss1_ids/variants/calls）；shot_probe 截图前走 _close_modal 真实单口归一浮窗（写死后 boot 即开压菜单——boot 顶层检查／golden 19%／文字占比 0.00% 三处受扰；视觉契约与调试模式解耦，发布前删写死时基线不受影响）；click_probe 恒开断言归位。基线 09 指纹刷新：静态扫描红项清单与基线不符，经主区与分支 audit_file_headers 输出逐行一致（128 行）证明非本批引入（漂移源于 20f4a7dc 之后主区 .gd 头注变动），按「人工确认后重生成」条款对齐指纹，红项仍为存量 127 处。验收：全量闸通过（存量红零新增，回执 commit＝HEAD）；worktree 与分支已清理。读数义务归 M4：Boss 图资源面分布与 region 布置读数（本批 MC 零跑，内容回落既有 region 行为）。反哺点待裁：设计语义面五处描述已撤回功能（地形变异.md §全局作用域型／HUD 框架三层预告／教学引导手册行／难度曲线与Boss 两行／art-bible §4.6.3 括注）；机械面四件已随批同步（07 ⑪ 转记失效／architecture 行数 7→6／数据配置清单／06 战斗节点地图类型差异化条）。

• 506（2026-10-16，迭代 29 测试分层与门禁语义修正批总收口）：用户 /iter 29 发令，单会话八提交交付（worktree g-plan2-iter29-testlayers，分支 iter29-testlayers-20261016）。核心是把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸每条都有反例实证：改前「探针打印 PASS 后 quit(1)」判全绿、「零断言套件」判 all green (0 checks)、「子套件中途报 SCRIPT ERROR」判 PASS；改后三条全部见红。本机两个坑写进注释防复发：①OS.execute 的输出管道恒空（子套件输出须交命令解释器重定向落盘再读）；②OS.get_executable_path() 返回 GUI 子系统 exe，其子进程 stdout/stderr 句柄无效，必须换 *_console.exe。断言下限用专用退出码 2（不是 1——致命类套件期望 1，返回 1 会被 expect 协议放过）。三层承载：L1 补六套（board_generator／minesweeper_rules／config_db_resolver／config_db_cross_validator／hud_presenter／battle_narrator，27→33 套），三屏壳归 L3 探针；L2 建 tests/integration/ 首个用例（存档⇄RNG 往返，含旧档经迁移链后仍可续玩这条真实路径）；L3 新建 screen_flow_probe（六步主流程＋两条回退，每步判屏级互斥）入轻闸。parity 收编为重闸 11 号条件闸件（每次跑批做触面判定，触面也不自动跑——MC 须用户批准），本批即判触面，挂 NEED-APPROVAL 待裁。扫描域：S3 路径由裸 core 修正为 game/core（此前恒零命中恒绿、什么都不扫），补 S5，并给每条规则加零命中自检（扫描面为空即判红，路径写歪时自检跟着一起红）。四处经用户裁决的改动：fx_grant_gp 补行来源豁免（每局 7 次断言失败被闸长期漏过）／manifest 增 negative 字段（负面套件的错误是测试目标）／config_db_test 的 rows 定型数组赋值改 assign（10 条敌人表行集纪律断言从未执行过，修后两条正向见红＝夹具缺 depth-0 锚行，补锚行全绿）／system_contracts 空桩换真实实例。台账与时效：15 个游离脚本逐个定性成表（存疑按在役）；golden 先判再动，实测 changed 0.00%／0.15% 判有效不重制。架构事实源回写：三硬闸矩阵「缺失」→「在位」、S 表 S3/S5 更新、新增「三层承载与判定原则」小节。验收：重闸 exit=0（存量红零新增，回执 commit＝HEAD），冒烟 1127/0 持平，轻闸墙钟 363→405s。遗留待裁：11 号闸 parity 是否批准发起、GDD 反哺三条、06 在册七项。

• 507（2026-10-16，调试入口全局浮层角标批——屏内三枚角标合并为最顶层浮层）：用户看完上一批（屏内角标形态）交付态后定稿：不做置顶钮式按需出现，要「UI 最顶层浮层、不被任何 UI 遮挡」（调研 Material FAB 与 NN/g 置顶钮规范后用户给出的修正——位置惯例一致但浮层语义不同）。实现（worktree g-plan2-dbgfloat-20261016，两提交，合并 746c1bb4，主区冒烟 1127/0 兜底）：三枚屏内角标（菜单右下/战斗 HUD 右下/地图顶栏）合并为一枚全局浮层角标——LAYER_CONTRACT 末位新增 {"key":"debug_badge","kind":"float"}（只落树序＝最顶绘制序、不注册 ModalStack：open() 遮挡记账只隐藏登记层，故任何模态/覆盖层开都不遮它＝用户需求的机制根因）；main 直接子层，构建走 ui_assembler.build_debug_badge（右下角 16px＋FS_HINT＋豁免宽度基准＋grow BEGIN）；地图屏底栏 85px 常驻→_sync_status_entry 按 map_on 抬 offset_bottom 至底栏上方 16px；战斗屏状态角标经 MarginContainer 让位（right 16/bottom 52）不再被压；屏内三处 debug_badge 全删（menu_screen/board_zone_view/level_map_screen），main 两处接线与 sync 四条可见性/置灰行清除（浮层常显不置灰）。断言换代：smoke V2f 查 main.debug_badge boot 可见；click_probe 遮挡判据移至设置面开中段（浮层角标此时仍应可见＝直接验「不遮挡」）；tune_probe ①点击路径与⑨对局中角标全改 main.debug_badge（T2 防线三断言不动——non_locking×遮挡复活×has_open 组合回归）。过程两处：①一处替换误写成重复状态角标接线（指向不存在方法）——提交前 grep 自纠；②基线 06 刷新：01-核心循环.md 表格占比 43% 越线为今日 9846a29f（删副标题行）引入的存量，主区实测同红、本批零 design/ 改动，按人工确认条款对齐指纹（该条红灯与 R5 缺流程图均已由提交 fcb8c3f8＋8c18b52b 结案，基线 06 已改回绿）；09 静态扫描本批转绿（并行会话 R0 文件头锁批清偿 127 处存量）。发布前删除事项：game/presentation/main.gd:196 一行（2026-10-17 核实行号，原记 main.gd:219 已漂移）——删该行后角标可见性（同函数下一行 :197）随门控失效自动隐藏，无第二删除点。

• 508（2026-10-17，代拍板追认单落状态批）：用户令「追认单的所有我都是同意的」——迭代 27 十五项／28 十三项（含四条白名单外）／29 十二项共 40 项代拍板全部同意，三份实现报告的追认单节各加一行追认结果。两处保留：①iter28 第 14 项只认「本批动作」（只补 ZCode 副本、未擅自取齐），「req-card 两副本是否取齐」仍是待裁问题，留在未决面；②iter29 第四节「经你裁决的四项」当时已问过已答，不属追认范围，原文不动。连带改 06「闸按改动域分跑批的两处代拍板」条①②为已追认，③迁位欠账补计 iter29-实现报告（该条登记时只列两份，漏计第三份）。roadmap 迭代进度行三处「代拍板追认单…待用户」换代为已追认。worktree g-plan2-ratify-20261017，文档域闸 --docs 零新增红（回执 commit=9a7dfcf6），合并 eabaeee0。本文件三行改动（待追认行／在途分支行／本条）留在主区工作副本未提交——主区另有并行会话的未提交件（game/project.godot／M4 卡片删除／五份未跟踪文档），按「只合本批自有改动」令不代为提交，等下一次动 active.md 的批一起入库。GDD 反哺点八条（27 两条／28 三条／29 三条）未随本批处理，属设计权威文档改动、需逐点裁决另批写入。

• 509（2026-10-17，GDD 反哺点写入批——迭代 27/28/29 八条＋一条建议逐点裁决）：用户裁「全部按推荐案执行」（文档批，不占迭代号，worktree g-plan2-gddfb-20261017）。写入面：①architecture.md v1.7→v1.8——新增「战斗域装配现状」（结算五段 授予→增益/减益→战斗→衰减→判定，段序骨架冻结于 SettlementTable.segment_order；RunLedger 单类四账所有权 AdventureRunner 独占）与「呈现层装配与会话生命周期」（三屏壳+组合根句柄面／视觉层装配合同立条款、合同表不摘录——唯一事实源=main.gd LAYER_CONTRACT 现行 17 项五类 kind，登记时 16 层按代码实态订正／RunScope _begin_session 换会话整节点释放、无独立收束函数／九阶段×五引用面存活性矩阵认账入册／ModalFlow 互斥域 tags）两节；「初始化顺序」补启动后置条件六条（登记时「十断言」现为六组 11 条——2026-10-16 角标令 V2f 拆两条）；呈现层 D1 行与实现实证读数换代。②code-conventions.md §4 第 7–12 条——S9 类型闸三规则与扫描面口径／:= {} 推断形态不算债／# type-hint: ignore 行级白名单／# rng-seed-exempt 豁免通道／--script 模式禁裸 autoload 标识符／Variant 参数化现行口径（元素精化不入硬纪律）。③④⑨test-conventions.md 新增 §7 判定三硬闸（闸承载三闸齐备义务＋负面套件仅豁免错误扫描一闸＋新写测试件全类型标注写法纪律，暂不机器闸——S9 扫描面产品码）与 §8 判定可靠性优先于覆盖率（§六第 4 项建议随此反映：脚本错误静默中断所在函数剩余断言的机制事实＋三处实证＋写验收函数自证断言全数执行义务；覆盖率度量是否引入仍 06 在册待裁）。⑤07 v1.4——㉖① 全流程走查保留不注销，节首加 screen_flow_probe 机检承接注记。三笔旧账清零：iter27/28/29 三份实现报告 git mv 往 reports/（06 条③迁位账清零，全库引用改指新路径、死链复验零死链；roadmap 九处 iter21–26 已删报告死指针改「已退役（git 历史可考）」、iter27/28/29 改指新位）；iter29 报告 §六第 0 项按合并现实改写（fff4f120 已合回，两红各自结案：菜单 golden 重采 dac9a94b、01 篇 R5 流程图 fcb8c3f8＋8c18b52b）；06 补登迭代 29 反哺专条（该批漏登）且 27/28 反哺条按「吸收即死」退役为已写入。06 :687 死引用「code-conventions.md §3.6」顺带订正（该内容现独立成文于 test-conventions.md §6）。本批并把 508 批自述「等下一次动 active.md 的批一起入库」的主区未提交行改动随本批提交入库；主区其他并行未提交件（game/project.godot／M4 卡片删除／五份未跟踪文档／layout_probe.gd.uid）仍零触碰。文档域 --docs 零新增红（回执 commit=分支尖，见合并说明）。

• 510（2026-10-17，迭代 30 卡① 未开格类型徽章批总收口）：用户「完成迭代30的开发」——三卡串行只做卡①（代码实现批，worktree g-plan2-iter30-glow，分支 iter30-glow-20261017，合回前 merge master 2aa7e8fd 后重闸，快进合并 7ffd1dc0）。实现：Q1 丙案主路径 shader 距离场（cell_type_glow.gdshader＋cell_type_glow_layer.gd 承载件，与 _desat_mat 共存实测未撞墙、a 案程序绘制兜底未启用）；五组微光色板与九型归组单点 ui_kit.gd（TG_GLOW_*＋glow_group_for_cell_type，呈现参数 α170／带宽 cell÷8）；board_view 作用集＝_diggable ∩ 身份可查 ∩ 灯光区 − r0，相位门控与接触带同源，Q4 丙案默认开。唯一停机呈报：群伤组初版 #FF1A31 与冻结绯红 #FF2D55 的 ΔH 5.40°（触 art-bible §4.2 既裁冻结面）→ 用户裁「换更暗档 #A61D37」（冻结值 V=0.65 档、色相零移动）；五组现全数「只动明度不动色相」（ΔH ≤0.13°）。断言三件：冒烟八相 24 项（1127→1151，含契约 1 同板同序列 on/off 双实例 12 步 digest 对照）／单测 type_glow_test 五段 51 检查（33→34 套件）／ui_input_probe case⑰ 活板面（十八断言）。渲染取证：board_shot 双帧（motion_scale=0.5 停格隔离）三关 glow=2/4/4、带外零变化、生效格实绘非空；判据源探针（夹具面五组齐现）相邻组 CR 最弱对 1.232；off 帧对 2026-09-30 代 golden 三基线漂移 0.13/0.11/0.10%（≤2%，基线未重制）。变异验证 M1–M5 五组反例实证（归组错映／清单外静默／相位切换不重算／α=0 不绘／派生路径误触玩法 API，红输出与还原实录见实现报告 §四）。验收：--code 重闸零新增红（09 由基线红转绿判「改善」；11 号 parity 判未触面 SKIP），回执 commit=7ffd1dc0＝分支尖。坑档两条入注释：探针裸视图必须接生产同源身份解析（否则作用集恒空、PASS 假绿——实跑两次 glow=0）；Callable.bind() 动态派发对类型化参数做 Object 硬校验，回调传参改成员现值＋直接方法引用。产出物：reports/iter30-实现报告-2026-10-17.md（含实机目检总清单 V10 人闸五项，登记不阻塞）／iter30-代拍板追认单-2026-10-17.md（§9 白名单 7 项待追认）／iter30-反哺点-2026-10-17.md（§5 七条待用户裁决归文档批）。遗留：反哺点七条待裁（06 条目状态＋措辞、HUD框架 :140/:269、08 表现表、art-bible 明度档修订条目、roadmap 批内状态、Q3 两带分工＋06 新待办、07 目检人闸条）；实机目检人闸待用户过目（「很丑」终审位）；群伤暗档 provisional 待样张批转正；阔视野带 desc「微光范围 8→12 格」与卡 §4「不扩微光」冲突属数据文本批（treasure_items.tres:47，实现报告 §六登记，不占反哺点条数）；g-plan2-iter30-glow 工作区在盘待删（同 carddoc）。

• 511（2026-10-17，在途线头收编批——立绘定档分支合入＋两条老线头清理）：用户令「art-standee-20261006 合入；完成之后把两个工作区删除」。①**art-standee-20261006 合入**（worktree g-plan2-standee-tier，2026-10-06/07 立绘定档与站桩重排实装批，领先 5 笔、落后曾达 478 笔；先 merge master 解一处冲突——art-bible 定档行取 master 用语规范版、排版行取分支「允许向上溢出盒顶 N px」甲案版）。落 master 内容：10-07 三处文档修正（art-bible §8.2 站桩排版③大体档溢出甲案与光柱脱钩／§8.3 参考核验废路径 production/mockups/→artwork/mockups/／battle.md 敌方站桩行同款甲案措辞——三处 master 实查均仍为旧措辞即从未落库）＋06 新登「战斗区背景图替换——B 区舞台插画＋临时光柱退役」条（2026-10-07 用户点名登记）＋机检三件工具（tools/standee_asset_check.py 逐键档高升级版、tools/palette_check.py、tools/path_check.py；依赖 STANDEE_TIER_H master 已有）＋四份过程文档归档（实装批任务书／交接说明／artwork 独立仓 dry-run 清单／立绘读数 txt）。该批止于 B 段工具闸，C 段引擎实装、D 段人闸未跑，roadmap 迭代位归属仍待用户裁。②13 件未跟踪立绘先抢救再删区：_tmp_standee_new/（八敌＋主角三态＋九人对照总图＋读数，149K，素材不入 git）已拷至主区 artwork/archive/standee-tier-20261007/（gitignore 豁免面零状态噪音）；该批 AI 生成像素立绘在 2026-10-14「精细手绘像素」方向裁定下的去留归用户后裁。③**doc-adr-fixes-20261014 判废删除、不合入**（worktree g-plan2-doc-adr-fixes）：五笔提交改的 10 文件全数失效——7 份 adr-*.md 已被废除批删除（modify/delete 冲突面）、architecture.md v1.4 被 v1.8 超越、02 清单与 registry 实查零 ADR 字样；分支内 ADR 审查报告已被分支自身第三笔删除，git 历史 302b5b2c 可考（Qoder 会话「报告仍在分支」系误报，已核）。两 worktree 与分支（-d／-D）均删，merge 说明载 --docs 闸回执。

• 512（2026-10-17，迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写）：用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，不占迭代号，worktree g-plan2-iter30-fb，分支 iter30-fb-20261017，基于 master 0a164958、合回前 merge master 解 active.md 一处冲突——本批状态记录原编 511 与 master 线头收编批 511 撞号，按 iter29 先例改 512）。追认：卡①代拍板白名单 7 项全部同意，追认结果行加在 reports/iter30-代拍板追认单-2026-10-17.md 文末（用户令原文「追认没有问题」）。反哺点七条全部回写：①06-待办清单——条目状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、单测 34 套、探针 case⑰、07 ㉘ 人闸五项）＋色相措辞修正为「样张 v2 冻结既裁值」＋2026-10-05 实查读数刷新（bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族在役 ui_kit.gd:49-53）＋新增「卡顶色带与格面微光两带统一」待办条（Q3 甲案）；②HUD框架——实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，合并 7ffd1dc0）」、验收行转正式验收（去「待实施批落地后验收」括注）、版本历史 v0.19、口径史注记后补两带分工注记；③08-Alpha版本标准——「五 · 表现」表新增「未开格类型微光（五组色相＋明度档）」行（在役；明度档 provisional 值，样张批复核转正）＋版本历史 v1.9＋文头状态行 v1.8→v1.9；④art-bible——五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／青 #30A6A6／紫罗兰 #7B5BD6／绯红 #A61D37＝冻结 #FF2D55 的 V=0.65 档；五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对 1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15 漏更订正；⑤roadmap——迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已入库（②③待 /iter 发令）；⑥Q3 甲案两带分工——注记落 HUD框架 微光节、06 新待办条（见①）；⑦07-体验验证清单——新增 ㉘ 节五项人闸（五组一眼可分／不遮数字〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感〔provisional，读数归样张批〕）＋版本历史 v1.5。反哺点清单批注：reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。验收：文档域闸 tools/run_all_gates.sh --docs 零新增红（回执 commit=34f3cdb3）。遗留：卡②③待 /iter 发令（未决面在册）；实机目检人闸五项（07 ㉘）待用户过目；群伤暗档 provisional 待样张批转正；g-plan2-iter30-fb 工作区待合回后清理。