game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,640 Commits 23 Branches 0 Tags
dafc5540934fdaf47263c8a9957edb31cdf97a5f
Commit Graph
405 Commits
Author SHA1 Message Date
DKChan e8b6751b6a chore(闸壳): 06b 变更记录节入存量基线（绿档）——同 08c 流水线闸先例 2026-10-20 05:49:03 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1（卡片落位 reports/＋dev→engineering 改名批）——四处版本历史节冲突取本批删除侧，reports 卡片重放禁写变更记录清理，06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan 55cdf683da docs(卡片): 退役 11 张失归属需求卡片（迭代 20–30 已完成批）＋清偿全部指路与死链 
按 doc-conventions §11「吸收即死」「删除不留死链」执行：
- 删 11 张：迭代 20–30 各批卡片（含迭代 28 启动装配卡——roadmap 卡片列早已写「已退役」、文件却仍在盘，属漏删）
- roadmap 卡片列 10 行改「已退役（git 历史可考）」（流水线闸对保留字豁免，pipeline_gate.py:303-309）
- reports/iter27–30 四份报告头部卡片路径改保留字，不留指向已删文件的路径
- 保留卡（战斗一屏样张批／二三关棋盘观感批）对已删卡的 6 处指路改结论内联＋提交号
  （徽章卡 7ffd1dc0／测试分层卡 fff4f120），各加一行「指路订正（2026-10-20）」
- 顺带清偿 2 处既存死链：07-体验验证清单 ㉑ 节、HUD框架 视野迷雾注记（两卡早已退役，历史删卡未做引用面清理）
- 顺带清偿 3 处 game//tools/ 下遗漏引用：theme/README、forge.tres T1 注、parity_anchor.py 头注

保留 10 张未开工卡（迭代 31 两张、06 在册营地五卡＋资源配比、被剔除回待设计的样张/观感两张）。
零设计裁决变更、零数值变更。
 2026-10-20 03:37:31 +08:00
DKChan 066a9f7e31 docs(active残留): active.md 废除补刀——10-18 五张待执行卡摘「唯一例外=active.md」假指令15处＋baseline.json 08b 死记录再删＋recolor_terrain_tiles.py 头注出处注记摘除 
08b 复活成因：roadmap 压缩批 8f66ae15 与废除提交 27812167 同日、worktree 分叉早于废除，
合回时旧 baseline 被原样带回（该批自记「其余条目原样保留」）——再删并留此记录防三犯。
历史文档约 19 处过去时引用按 registry 注销批（d54cbed7）先例保留不动；
在途分支合回时 diff 再见 08b/active.md 一律就地拒收。
 2026-10-20 00:39:26 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan 1deaa55341 chore(rules): 根规则文件改名 CLAUDE.md→AGENTS.md＋全库旧名引用同步 
- 结构闸白名单 ROOT_FILES 收编 AGENTS.md（改名后主区曾判「根文件越界」红）
- 流水线闸禁写根规则文件标志名只留 AGENTS.md（用户裁：旧名不留双保险）
- design/dev 五份规约＋architecture、roadmap、registry、06、三个 README、
  在役需求卡与 QA 标准的引用逐处换代；历史 reports/ 与 .workbuddy 留痕不动
- 顺修三处换名后会误导的行号引用（:56→:59、:63→:68、71 行计数加注）
- 三份主区未跟踪文档（测试审计标准／启动装配卡／营地会话提示）随批搬入并登记
 2026-10-19 06:04:09 +08:00
DKChan 0170071da7 test(凭证件裁削): 卡② 对拍锚重锚（删件后牌库与豁免语义变化随批换代） 
三变体各 N=20×2 策略重跑；差异面=稀有档候选集少两件（attune_battery/perfect_insurance 零出现）
＋完美保险改订阅式后的完美判定面，与用户裁断一致（差异归类见 reports/iter31 实现报告）。
 2026-10-19 04:54:17 +08:00
DKChan 072c19b4a5 feat(凭证件裁削): 卡② 同调电池删除＋完美保险迁专长＋配额净删落地（迭代 31 卡②） 
用户 2026-10-18 逐裁四项落码：
- T1/T2 同调电池整件删除：CURIO_KINDS 摘 kind、三字段与三处分发表分支删净、
  runner 侧 _battery_pending/断点键/getter/choose_battery_target 全清（呈现层零接线=有账本无入口）。
- T3 完美保险出池：kind/字段/分发摘除，_pending_insurance 与 level_runner 注入通道
  （voucher_insurance 键、set_voucher_grants 第三参）整链拆除，battle_orchestrator._fx_insurance 删。
- T4 引擎扩签 forgive_seal_miss（EFFECT_KINDS 31→32）＋两账相减：新增 _perfect_forgiven 单向累加、
  谓词抽成 perfect_sweep_earned()（有效误标=误标总数−豁免数），_perfect_hit_false 保持纯净=契约 2；
  seal_missed 发射时机与消费点零改动=契约 3（危险直觉·守同事件订阅面在验收组里对拍）。
- T5 feats.tres 第 30 行完美保险专长：rarity rare／cap 省略／domain=battle 显式写出（战斗域首例）／
  desc「本场首次封印落空，不计入完美封印判定」；限次由行 when counter(insurance_used) lt 1 承载，
  do 自带 counter_id 记账由授予段消费点落账（代拍板 3 选型：单行落表，理由见实现报告）。
- T6 配额净删：TIER_QUOTAS rare 9→7、令牌池总量 104→102，validate() 硬断言过；smoke 配额锚/牌库
  构成/专长行数随批换代。
- T7 验收：feat_vouchers_test 39 项全绿（出池反例/断点缺键兼容/账本保留/配额锚/装载/限次一次/
  计数纯净/两账相减真值表/跨战清零/事件不吞）＋forge_table 词表闭集断言 31→32。
  变异验证 6 条：5 条证红；「domain battle→adventure」在本 rig 不可观测（未红），已如实登记。
- 存量缺陷顺带修：旧 _emit_row("insurance_used","",…) 空来源会触发行来源断言（旧路径无消费点故从未走红），
  新订阅面给出 source_class=seal_miss。

基线（卡① 合回后 master 4f953ce8）：冒烟 1151/0、单元 34 套全绿、探针 --click 全绿（user:// 存档移开态）。
 2026-10-19 04:45:49 +08:00
DKChan 2c5cece48d test(代码术语): 卡① 对拍锚重锚（seal_ 标签面，用户裁案甲随批） 
三变体 base/attune/shop 各 N=20×2 策略重跑，RUNSUM 面仅标签名换代、数值零差异（差异取证见 reports/iter31 实现报告）；jsonl 面 sha256 随新事件名重生。
 2026-10-19 03:04:59 +08:00
DKChan 26d182f845 docs(代码术语): 卡① 注记面禁字提及还原（被检查的禁字不是使用） 
feats.tres 头注 desc 禁字清单还原为「雷/旗」、命名纪律对照句改「旗〔旧称〕=封印」；
battle_orchestrator 注释双等号读顺。均为注释面，零数据零行为。
 2026-10-19 02:54:19 +08:00
DKChan 32fdf957fd refactor(代码术语): 卡① flag→seal 全族换代＋game/ 禁用词清扫（迭代 31 卡①） 
标识符面：flag_*→seal_ 族（含 Godot 信号 flag_judged→seal_judged 与连接/回调同名、
FACTS 两键 flags_count→seals_count／dug_under_flag→dug_under_seal 全链、
.tres 键名与 schema .gd 同批同步）；显式豁免零改动=size_flags_*（Godot 布局属性）＋_fatal_flag。
中文面：金币→GP（金币袋→GP 袋）／插旗→封印／雷格→危险格／惩罚格→危险格／旗→封印·封印印记族，
game/ 内 *.gd/.tres/.md/.json 四类禁用词与 flag 双双零命中（V1/V4）。
守卫字面量不动（被检查的禁字不是使用）：smoke_all V21 零「雷/旗」检查面、
ui_font_asset_test 字形集攻/雷/旗/封 保持原断言逻辑。
代拍板：板面单字槽 glyph「旗」→「封」（禁字纪律＋单字位宽，消费面四处同名随动）。
素材换代（2026-10-18 用户裁案甲）：assets/art/board/flag_seal.png→seal_mark.png（素材不入 git，
盘上改名＋导入重刷），代码两处 res:// 字符串＋COL_FLAG/CURSOR_FLAG 常量同步，
闸件四处随批（run_all_gates.sh/render_gate.sh/golden_baseline_refresh.sh/path_check.py）。
anchor.json 键名手改，重锚与改前改后 diff 随本卡收口（同裁案甲）。

基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click
存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。
改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
 2026-10-19 02:52:38 +08:00
DKChan b7b94d1163 chore(主区): 术语补扫批遗留两项入库——project.godot 为编辑器保存时段落重排（[debug] 段位与 default_texture_filter 行位，5 增 5 删内容零变化），playnote 为玩家试玩反馈原样追加 11 行 2026-10-19 01:32:54 +08:00
DKChan d659b065c1 chore(导入): 8 个 .uid 入库——迭代 30 期编辑器刷导入生成，此前一直未跟踪 2026-10-19 01:28:41 +08:00
DKChan 8f66ae1559 docs(roadmap): roadmap 压成「里程碑时间线＋迭代总表」＋流水线闸注册上电 08c——删除「当前位置」节与主路线表全部巨型行（各迭代过程叙述/T 段明细/读数/闸数字/裁决记录退役归 git 史，116→89 行），新建六列迭代总表 30 行一行一迭代（状态=已完成＋落地日期自「✅ 完成/已入库」句提取，迭代 17 任务书日期与文本冲突从文本=2026-10-07；需求卡片列 design/research 实存十卡写实路径、卡片已退役十一迭代写保留字、迭代 1~8/10 无卡片制填「—」；编入时间 9~12/14~30 从文本与编入提交可考取真、其余「—」；预计周期历史行全「—」不做 ≤2 周判；实现报告 iter27/28/29/30 写 reports/ 实存路径、其余二十六迭代写退役保留字），M3/M4 里程碑语义立规注（2026-10-09 用户立规）压缩三行后置于里程碑时间线表后语义全保留，执行纪律/批次 loop 规范/维护纪律三节原样保留（含未迁 process-conventions 的迭代粒度界定等立规），执行纪律第 3 条「当前位置挂起清单」指针随节删除改指 active.md 未决面；pipeline_gate.py 机检扩容对齐新表（需求卡片/编入时间/预计周期三列「—」合法=历史行豁免＋实现报告列已完成=存在路径或退役保留字、对「—」维持判红，头注旧格式声明换代），doc-conventions §12.2 四列规则同步补「历史迭代不可考填—」与已完成报告列严格句；run_all_gates.sh 文档域 08b 之后注册「08c 流水线闸」（照抄相邻行形态，闸序其余零改动）＋头注 --docs 闸清单补 08c＋域横幅 6–8c；baseline.json 手工加入 08c 绿记录（新闸件无基线记录必判闸况变化拦合回收执，其余条目原样保留）；06 修存量退役词四笔「随批呈报→顺带呈报」（b4671802 回填批带入、doc_term --strict 首次全量跑暴露，非本批引入）。自检：python tools/pipeline_gate.py=PASS（06 条目 51·总表数据行 30·交叉核 0 链全过）exit 0；bash tools/run_all_gates.sh --docs=六闸全绿无新增红 exit 0 2026-10-18 05:15:32 +08:00
DKChan 9a335cb305 docs(08): 混编遭遇第二批裁挂 Beta v1.10（2026-10-18 用户令「挂 beta 吧，不需要再进行讨论了」）——未决项六项减五项（第 4 行删除、5/6 重编号）、二·内容量混编行现状注改写（裁决细节入版本历史，单元格保持净态）、文头状态行 v1.9→v1.10；零代码零内容变更，Boss 多行投放连同 MC 取证与数值统标一系移交 Beta 阶段再议。三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0） 2026-10-18 01:33:36 +08:00
DKChan e5c03eb3ab test(render): 双帧像素取证＋判据源探针（迭代 30 卡① T2-④）——board_shot_probe 每关抓微光开（生产默认态）/关（golden 基线保护面）双帧：前置 UiKit.motion_scale=0.5 冻结接触带呼吸相位（静态带色，双帧差异唯一定位在类型微光开关），_check_dual_frames 逐格窗口矩形＋到格缘距离判据（de < cell÷8——带外含砖心零侵入＝禁整格染色／禁越圈）＋每生效格须有实绘像素（微光不空转）＋开关快照须在关开关前取；读数落 board_dual_frame_readings.json（报告读数表源）。身份解析接生产同源面（main.gd:251 同构：板在守卫＋Active 相位守卫＋query_reward_identity 只读代理——裸视图不接则作用集恒空、PASS 假绿，本批实跑两次 glow=0 的根因即此；附带排 Callable.bind 动态派发 Object 硬校验坑，改成员现值＋直接方法引用）。新建判据源探针 type_glow_shot_probe（夹具面五组齐现：glow_cells=5、groups=[1-5]、changed_outside=0、相邻组实测 CR 最弱对 1.232、组4/组5=1.423）——真实面随板摇号（双帧 glow=2/4/4），五组齐现互辨取证在夹具面承载，两面分工不混。off 帧对 2026-09-30 代 golden 三基线漂移 0.13/0.11/0.10%（≤2%，接触带静态化预期面，契约 6 未触发、基线未重制）；render_gate.sh 整闸全绿（含菜单 golden 0.14%）。 2026-10-17 10:18:55 +08:00
DKChan 80ac80ef1a test(断言三件): 未开格类型微光机检面（迭代 30 卡① T2-①②③）——①冒烟 smoke_all.gd 新增 _smoke_type_glow 八相 24 项（相0 作用集恒等＋默认开＋已开/r0 零微光／相1 八邻派八型五组逐格映射／相2 清单外"keystone"显式登记＋零微光／相3 封锁格零微光零登记／相4 解封复位／相5 off/on 两态＋关前快照逐位复现＋零玩法写入三面／相6 换图 rebuild 重算／相7 契约 1 同板同序列 on/off 双实例结算逐位一致 12 步 digest 对照）；夹具 = seed 4242 L1 板＋novice 驱动（初始展开覆盖 8 邻故必驱动）＋八邻派型＋哈希兜底九型全集；冒烟 1127→1151 项。②单测 type_glow_test.gd 五段 51 检查（归组封闭含清单外 6 负样本＋两带并存锚定／冻结色相面 HSV 稽核 ΔH≤0.2°·ΔS≤0.01＋群伤 V=0.65 专项／呈现参数锚定 α170·band 0.125·组号域 0-5／伽马合成空间阶梯单调＋相邻组模型 CR≥1.20／probe API 形状），登记 run_all.gd（33→34 套件）；extends SceneTree＋Kit/UiKitScript preload（--script 模式禁 class_name 裸引用）。③ui_input_probe case⑰ 活板面走查（生产身份面：作用集==diggable 键集／真实点击挖开即灭／移动复亮出圈灭／相位门控两态／开关两态零扰动），十八断言全绿。批末变异验证五组反例实证：M1 归组错映（单测+冒烟红）／M2 清单外静默（冒烟红）／M3 相位切换不重算（冒烟+探针红）／M4 α=0 不绘（渲染闸红）／M5 派生路径误触玩法 API（冒烟相7 分叉红）——红输出与还原结论实录见 reports/iter30-实现报告-2026-10-17.md §四。 2026-10-17 10:18:35 +08:00
DKChan bd44e658e8 feat(views): 未开格类型微光五组实装（迭代 30 卡①·Q1 丙案主路径）——色板与归组单点落 ui_kit（TG_GLOW_* 五组＋GLOW_* 组号＋glow_group_for_cell_type 九值封闭／glow_color_for_group；α170／带宽 cell÷8／软边 0.55／圆角 2 参数常量）；shader 面新建 cell_type_glow.gdshader（canvas_item 距离场内缘带柔光：SDF 圆角掩码＋mask_rect 豁免区，参数全经 ui_kit 注入守「呈现层裸 Color8=0」）＋承载件 cell_type_glow_layer.gd；board_cell_unit 微光子件生命周期（有组才建、组变即换、无组即撤——作用集 ≤8 格常驻、零节点零绘制成本）；board_view 作用集派生 _recompute_glow（= _diggable ∩ 身份可查 ∩ 灯光区 − r0，清单外 cell_type 显式登记禁静默空光）＋开关 set_type_glow_enabled（Q4 丙案默认开、生产写入面组合根单点）＋相位门控与接触带同源（set_dig_glow_enabled 尾链 _sync_glow_to_units 增量重绘）＋取证面 type_glow_probe/cell_rect_probe。群伤组色值 = 冻结绯红 #FF2D55 的 V=0.65 档 #A61D37（2026-10-17 契约 5 停机呈报用户裁定「换更暗档」，色相零移动——初版 #FF1A31 ΔH 5.40° 已废）；明度档 provisional 值按 Q2 甲案取、复核归样张批；五组 ΔH ≤0.13° 全数「只动明度不动色相」；生成口径 = 渲染合成空间（伽马）阶梯，相邻组模型 CR 1.245/1.234/1.239/1.270。静态无呼吸（Q5 甲案）。铁律：_glow 容器参数化 Dictionary[Vector2i, int]（R1A 无类型容器红线）；新文件头注 ≤8 行（S10）。 2026-10-17 10:18:14 +08:00
DKChan d3a616cf9e docs(口径): roadmap 与 tests/README 的闸口径随分域改造同步 
漏改即成第二份互相矛盾的清单（本批正是要消灭这种漂移）：
- roadmap.md 迭代循环骨架第 5 步「重闸＝全量档全绿」→ 按改动域选档；第 8 步收口五步③
  「里程碑移动更新本文件」加注：实现批禁写 roadmap，该步归文档批，实现批在 reports/ 反哺点
  列明该改哪一行。
- game/tests/README.md 门禁行与「本地闸」节的「（全量）唯一入口」→ 按域选档 + 回执含 domain
  + 合回闸按 diff 推域校验。

连带（仓库外本地配置，同批已改）：~/.zcode/skills/req-card/SKILL.md 六处——description 版本注、
§5 关联文档同步面（实现批禁写 design/、产出只落 reports/、07 入册转反哺点）、§6 末卡改「产出物
落位卡」、§7 闸口径改按域并禁卡内写死闸件名单、目检两分法落点、变异验证记录表落点。
 2026-10-17 00:56:58 +08:00
DKChan 8c18b52ba2 chore(基线): 06 gdd_lint 条目由存量红改回绿——R5 已修，人工确认后重生成 
af94ce97 把 06 记为存量红（指纹 454510f66168＝01 篇 R5 缺流程图），走的是「容忍存量」路线；
fcb8c3f8 已按 R5 意图补齐流程图把红因消掉，本批 --docs 域实测 06 exit=0（回执判「基线红→现绿（改善）」）。
基线按 baseline.json 自陈口径「人工确认后重生成」改回绿，禁让后续每次跑批都空报一条改善。
 2026-10-17 00:41:46 +08:00
DKChan fff4f120d3 merge: 迭代29测试分层与门禁语义修正批入库（十提交, worktree g-plan2-iter29-testlayers） 2026-10-17 00:13:57 +08:00
DKChan af94ce9750 fix(基线): gdd_lint 06 指纹刷新——01-核心循环.md 表格占比越线为存量（非本批引入） 
本批零 design/ 改动；主区实测 gdd_lint 同红（共 10 文件 1 不通过=01-核心循环.md 表格
占比 43%），来源=今日 9846a29f 删主菜单副标题行后散文量下降推高表格占比。按「人工确认
后重生成」条款对齐指纹（exit 0/green → 1/454510f66168）；文档修复归该文件属批，不在
本批范围。另 09 静态扫描本批转绿（并行会话文件头 R0 载体锁批清偿 127 处存量）——改善项
按规则不拦。
 2026-10-17 00:04:45 +08:00
DKChan 6b1e447d27 feat(调试入口): 全局浮层角标——UI 最顶层、任何 UI 不遮挡（2026-10-16 用户令） 
用户定稿：调试入口不做置顶钮式按需出现，要的是「UI 最顶层浮层、不被任何 UI 遮挡」。
实现=三枚屏内角标（菜单右下/战斗 HUD 右下/地图顶栏）合并为一枚全局浮层角标：

- LAYER_CONTRACT 末位新增 {"key": "debug_badge", "kind": "float"}——只落树序（最顶绘制序）、
  不注册 ModalStack：open() 遮挡记账只隐藏登记层，故任何模态/覆盖层开都不遮它（用户需求
  的机制根因）；_layer_node 补映射；main 直接子层、构建走 ui_assembler.build_debug_badge
- 位置：右下角 16px 惯例位；地图屏底栏 85px 常驻→_sync_status_entry 按 map_on 抬 offset
  至底栏上方 16px；战斗屏状态角标经 MarginContainer 让位（right 16/bottom 52）不再被压
- 屏内角标全退役：menu_screen/board_zone_view/level_map_screen 三处 debug_badge 删除，
  main 两处接线与 _sync_status_entry 四条可见性/置灰行清除（浮层常显不置灰——点它就是开浮窗）
- 浮窗 desc 文案改「UI 最顶层「调试」浮层角标随时可开——任何界面不遮挡」
- 断言/探针换代：smoke V2f 查 main.debug_badge boot 可见；click_probe 遮挡判据移至设置面
  开中段（浮层角标此时仍应可见=直接验「不遮挡」）；tune_probe ①点击路径与⑨对局中角标
  全改 main.debug_badge（T2 防线断言不动——浮窗 non_locking×遮挡复活×has_open 组合回归）

冒烟 1127/0 过；全量闸待跑。
 2026-10-16 23:53:57 +08:00
DKChan 9a72394652 chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体 
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
 2026-10-16 23:28:07 +08:00
DKChan 1c034f555f chore(冒烟): 菜单 golden 基线主区重采——旧基线锚在字体回退态，05 渲染闸判红消解 
触发原因（呈现类改动批换代强制说明项，双成因）：
① 字体回退态——入库基线 game/tests/golden/menu_boot.png（dac9a94b 于 menusub worktree 重采）
   的左侧标题与按钮文字是平滑比例字，即自定义像素字体未生效时的回退渲染；当前 master 渲染
   为 Fusion Pixel 像素字。基线锚在回退态违反 Q5「基线禁锚回退态」。
② 右侧世界预览层位置与缩放不同——基线整体偏右约 16px、怪物更淡；shot_probe 日志存
   「Can't change the size of a SubViewport with a SubViewportContainer parent that has
   stretch enabled」警告，该层尺寸随采集容器状态漂，是 worktree 采集与主区采集结果不同的成因。

判定依据：同环境连采两帧逐像素差 0.00%（排除采集抖动），基线 vs 当前 4.61%（47,187/1,024,000
像素，失败线 2%），差异 94.7% 集中在左侧文字区/右侧预览层/右下调试角标三处；差值分布含 14,783
个 129-255 硬翻转像素（两套字形签名）。经用户目检确认当前实现为正确画面。

处置：主区跑 tools/golden_baseline_refresh.sh --menu 重采（禁在 worktree 采，本次即该成因）；
render_gate 复验 menu_boot.png changed=0.00%、棋盘三张 0.00%、整闸全绿（exit 0）。

未结案（另一批处理，本提交不含）：① SubViewport stretch 警告根因与该预览层目标尺寸/位置的设计
口径；② 重采脚本只守卫字体文件在位、不守卫字体真生效，缺机检自检（整块区域中间灰阶占比方案实测
不区分，需改测标题字形墨点邻域）；③ 菜单 golden 整屏一比区的分区化判据。
 2026-10-16 23:16:28 +08:00
DKChan 3dc168cd3d merge: 同步 master（60449941 迭代 30 编入批 + 08 状态刷新批）并解决 roadmap 冲突 
roadmap 冲突面：本批改了迭代 29 行与「迭代进度／近期主战场」两处，master 同期编入了迭代 30
（UI 呈现三卡批）并把空位行顺延为「迭代 31+」。以 master 为基重新应用本批三处换代：
迭代 29 行（卡片 v1.4→v2.0、门列→实耗、状态→已入库）、迭代进度行、近期主战场行
（下一前沿改指迭代 30，迭代 29 收口遗留注明 11 号闸待批准）。
active.md 与 06 无冲突（自动合并）：状态记录 505 在册，快照三行换代保留。
 2026-10-16 16:33:15 +08:00
DKChan 7daa92f61f docs(迭代29 T7): 游离脚本台账 + golden 时效判定 
台账：game/smoke/ 15 个不带 .tscn、不入任何闸的手动入口件逐个定性成表（用途 + 触发方式 +
结果由谁判），判据＝头注自陈用途 + 有无外部引用（工具脚本/产品码/CLAUDE.md 在册入口）。
存疑一律按在役登记并标注（禁「没看见＝死件」式清理）：adventure_monte_carlo／verifier_batch／
reward_expectation 三项是 CLAUDE.md 在册入口，auto_player／battle_driver／level_autoplay 是被
preload 的库件，board_stat_probe／calibrate_boards 是工具脚本取数端，damage_probe／defense_scan／
skill_rhythm_probe／rhythm_batch／monte_carlo 是诊断与批量采集件，dump_battle／experiment_density
标注为一次性历史取数件。纪律写进表下：新增手动件必须同批登记，退役走 doc-conventions 第 10 节。

golden 时效判定：**先判再动**——跑渲染闸实测棋盘三图 changed 0.00%／0.00%／0.00%、菜单 0.15%，
均远低于 2% 阈值 ⇒ 判有效，基线留在位不重制（禁「重制一下就绿了」掩盖真实视觉回归）。
新建 game/tests/golden/README.md 记载判据纪律与本次判定记录，供后续换代面按同一把尺复核。
 2026-10-16 16:06:14 +08:00
DKChan c5a433b1d3 fix(迭代29 T6): 扫描域——S3 路径修正与零命中自检，补 S5 规则 
S3 此前扫的是裸路径 `core`（仓根无此目录，2026-09-24 布局迁移后实际为 game/core）⇒ 恒零命中恒绿、
什么都不扫，白守了「数值单一事实源」这条红线。修正为 game/core，并豁免注释行与 config_db.gd 自身
（数值单一事实源的正主，它的单点 load 是本规则的例外）。
补 S5（core 禁裸引用 autoload 全局标识符——--script 模式 parse error）：形态＝标识符后紧跟 `.`
的成员访问才算裸引用，排除注释行与被引号/斜杠包裹的字符串字面量（"[ConfigDB/%s]" 日志前缀、
"/root/ConfigDB" 取节点路径都属文案与路径，不是标识符引用）。core 层实测零命中。

新增零命中自检：每条规则的扫描路径收为单点变量（DIR_CORE/DIR_PRES），规则自己先数一遍扫描面
文件数——数为零一律判红，且规则体包进自检成立的分支（避免判红之后又打出「ok」的自相矛盾输出）。
这样路径写歪时自检会跟着一起歪、一起红，不会再出现「恒零命中恒绿」的静默空转。
变异验证：把 DIR_CORE 改回原错误值 `core` → S3/S4/S5 三条同时判红「扫描面为空」。
 2026-10-16 16:01:39 +08:00
DKChan d091c98163 feat(迭代29 T5): L1 覆盖补洞——4 个零指名 core 模块 + 呈现层两件直接单测 
新增六套（run_all 27 → 33 套），全部进 manifest，全绿：
· core/board_generator_test（9 条）：尺寸与 board_gen 表一致、每个安全格数字恒等于八邻雷数
  （全盘逐格复算）、同种子雷集/数字集逐位一致、可推理性度量与清图判定自洽。
· core/minesweeper_rules_test（12 条）：装板带初始扩张揭示且未铺满安全格、安全格余量＝总数−已揭示、
  挖已揭示格拒（target_revealed）、挖非相邻格拒（not_adjacent）、fx_reveal 推进揭示并递减余量、
  插旗落旗态与计数、目录外意图被拒。
· core/config_db_resolver_test（8 条）：ceil 进度键偏难语义（请求 (1,1) 命中 (1,3) 而非 (1,0)）、
  行集按表文件行序返回、ceil 行集、难度乘数 clamp 上下限、未登记坐标返回空修饰。
· core/config_db_cross_validator_test（4 条）：正向全对齿零错（防误伤）、悬空 skill_id 必报、
  buff 挂主角侧状态必报（cast_side）。
· presentation/hud_presenter_test（5 条）+ battle_narrator_test（9 条）：文案逐拒绝原因正确、
  兜底不吐空串、数值带入、胜负互异、关卡收束态恒定、Boss 名带入。
三屏壳的断言面由 T4 screen_flow_probe 承担（六步流程每步判屏级互斥），不另起第二载体。

变异验证：hud_presenter 的「AP 不足。」改漏句号 → hud_presenter_test 精确见红。
另有一批「写反的断言被实现抓出」的证据（首跑即红、逐条订正后转绿）：装板并非零揭示而是带初始扩张、
挖受英雄邻接约束、插旗需 flag_range_free 或相邻且要先给足 AP、技能 type 是 basic 不是 attack、
状态表 id 键是 effect_id 不是 status_id、battle_end_text 在 level_end=true 时恒为「关卡通关！」。

顺带实证本批核心命题：config_db_resolver_test 首跑因诊断回调的 lambda 形参类型写错
（首参是表 id 字符串而非 int）触发 Callable 调用失败——脚本错误不改退出码却让整个解析函数静默
返回 null，套件仍会报「全绿」。正是脚本错误扫描存在的原因。
 2026-10-16 15:55:33 +08:00
DKChan 1458d94b0e feat(迭代29 T4): L3 屏壳切换探针 screen_flow_probe，入轻闸默认段 
新建 game/smoke/screen_flow_probe.gd/.tscn：走 菜单→营地→菜单→冒险→（关卡屏⇄战斗屏）→放弃→终局→菜单
六步主流程与两条回退路径，每步断言屏级互斥 + 流程状态位。与 ui_click_probe 分工：那件走「点某个按钮
有没有反应」的行为走查（含战斗推进与结算数值面），本件只走屏壳与流程状态，不推进战斗不碰结算数值
——全库 change_scene 零命中、屏切换全靠 visible 互斥，这正是最容易被装配顺序改动悄悄破坏的面。

判据两处订正（首跑实测抓出，都写进注释防复发）：
① 屏标记不能裸看 visible——战斗容器 battle_root 在局外也 visible，会把 boot 态误判成「菜单与冒险
   同时在场」；冒险屏改取流程状态位 run_scope.is_adventure。
② 互斥不能用「可见屏计数 ≤1」——终局覆盖层合法叠在冒险内容之上（终局态 is_adventure 尚未收束，
   是设计如此）；改为冲突对判定，合法叠加仅「终局+冒险」这一对。
变异验证：boot 后强置 camp_overlay.visible=true → 精确命中「菜单与营地同时在场」两条断言见红。

run_all.gd：负面套件（negative=true）全文输出折叠、只回显结论行——它输出里的 Parse Error 是预期产物，
回显出去会让编排层的日志扫描把集成/负面用例的正常输出误判成真实脚本错误（首跑即撞）。

入轻闸默认段（ui_contrast 之后）；轻闸 --quick 墙钟 363s → 405s（新探针约 40s），轻闸上限内。
 2026-10-16 15:41:01 +08:00
DKChan c4fa65ef44 feat(迭代29 T3): L2 集成层建承载——integration/ 首个用例 + parity 收编为条件闸件 
建 game/tests/integration/（此前只有章程句无实体）：首个集成用例 save_rng_roundtrip_test.gd
＝存档 ⇄ RNG 快照往返，17 条断言，跨 SaveManager（落盘+版本迁移链）× AdventureRunner（断点消费）
× RngService（续跑零跳号）× 停点态确定性。与 unit/core/breakpoint_resume_test 的分工：那件是单测
只验首战开板一致，本件验跨系统闭环——含「旧版本档经迁移链后断点仍可续玩」这一真实玩家路径。
并入 run_all manifest（27 套，零新机制）。
变异验证：把断点 rng_counter 改坏 → 精确命中「续玩取数号位 = 断点号位」断言见红。

tools/run_all_gates.sh 新增 11 号「回放确定性对拍」**条件闸件**：每次跑批都对 merge-base 做一遍
触面判定（data/tables／rng_service／save_manager／meta_progression／settlement／damage_math／
damage_controller／battle_orchestrator／adventure_monte_carlo），未触面 SKIP；触面也**不自动跑**——
对拍调的是 MC 脚本，属「跑批发起前须用户批准」红线，闸只负责把触面判定做一遍并显式要求批准
（批准后 PARITY_APPROVED=1 重跑），杜绝「该跑却没人记得」。指纹逻辑把 SKIP/NEED-APPROVAL 同记 skip，
两种未跑状态互变不算闸况变化。baseline.json 登记 11 闸条目（新增闸件否则会判「无基线」而红）。

README：目录布局增 integration/；新增「测试三层与承载目录」节（L1/L2/L3 各自的判什么/承载/入闸方式
与分层判据）；integration 章程句由「将来落地」改为「已建承载」。
 2026-10-16 15:20:25 +08:00
DKChan 853bd12baa docs(迭代29 T2): 术语订正与 CI 残留清除（机械面） 
README：CI 残留 6 处全清——头注 CI 行改「门禁=本地闸」+无远端无 CI 声明、目录布局「CI 冒烟统一入口」
→「单元套件统一入口」、Running「CI 调用点」→「本地闸 02 闸调用点」、「CI 旁必须配外部超时」
→「本地闸必须配」、Static Scan「提交前双跑：本地+CI」→「提交前本地跑」、「## CI」整节（含 gdUnit4
安装说明）→ 改写为「## 本地闸（唯一验收门禁）」。
run_all.gd 头注 CI 残留 2 处清除（外部超时改本地闸、探针由 probe_gate.sh 调用）。
CLAUDE.md 单件直跑清单里 run_smoke.py 标注为「系统级断言面」并指路术语表。

术语：新增 README「术语（本项目内的唯一语义）」小节——冒烟=秒级存活检查／单元套件／场景探针／
集成用例四词各归其位，并显式点破两处历史遗留命名（run_smoke.py 与 game/smoke/ 名带 smoke，
实际承载的是系统级断言面与场景探针，判定看语义不看文件名）。「逻辑冒烟」全库清零。
README 套件计数按开工日读数订正为 26（example_test 退出生产 manifest）。
 2026-10-16 15:11:17 +08:00
DKChan 8c82d3bf56 feat(迭代29 T1): 本地闸三硬闸落地——退出码/脚本错误扫描/断言数下限 
①退出码为唯一权威判据：probe_gate.sh 八件探针（轻闸 4 + full 4）判定统一走 verdict 函数，
  退出码≠0 即红，PASS 串降级为附加判据（ui_click_probe 本就走退出码语义，签名标记传它自己的
  click_probe 串，不强加 PASS）。
②脚本错误扫描闸件 tools/error_scan.py（标记 import 自 run_smoke.py，禁第二份清单）：
  probe_gate 逐探针段扫日志；run_all 侧因 --script 子进程的 stdout 管道恒空（OS.execute 在本机
  Godot/Windows 组合下拿不到输出，且 GUI 子系统 exe 的 stdout/stderr 句柄无效），改为整条命令
  交给系统命令解释器重定向落盘再读，退出码原样回传——引擎二进制取 *_console 版（GODOT_BIN 优先）。
③断言数下限：Kit.finish 在 checks==0 时返回专用退出码 2（不是 1——致命类套件期望 1，返回 1 会被
  expect 协议放过）；run_all 汇总校验实跑套件数 == manifest 条目数。
④example_test.gd 退出生产 manifest（协议活样板，文件保留；同类先例 fog_lantern 摘除）。

变异验证（三反例 T0 判绿、T1 后全部判红）：零断言套件 exit=2 判红／脚本错误套件命中 SCRIPT ERROR
判红／探针打印 PASS 后 quit(1) 判红「PASS 串不抵」。

本卡附带裁决落地（均已用户裁准）：
· fx_grant_gp 补进行来源断言豁免表（grant_segment 的专长 GP 入账行无棋盘来源格，每局触发 7 次
  断言失败却因脚本错误不改退出码长期漏过；迭代 21 同款修过 fx_reveal）。
· manifest 增 negative 字段，仅 reward_dangling_treasure 一件（坏表是其测试目标，错误扫描误伤）。
· config_db_test 的 rows 定型数组赋值改 rows.assign——原写法触发 Invalid assignment 中断整个函数，
  敌人表行集三条纪律 10 条断言从未执行过（31 处 check 实跑 21 条）；修复后 26 条全跑，其中两条正向
  断言见红，根因是夹具缺 depth-0 锚行（validate 的 anchor 规则），补锚行后全绿。
· system_contracts_test 的 RngStub/UnitContainerStub 空桩换真实实例（定型成员赋值报 type 空）。
 2026-10-16 15:08:13 +08:00
DKChan dac9a94bd1 chore(冒烟): 菜单 golden 基线合并后重刷——并入 master 调试入口批（752c9a0a）后基线在合并代码上重采（画面含该批恢复的调试角标+本批副标题删除双成因），render_gate 复验 changed=0.00% 全绿 2026-10-16 04:37:06 +08:00
DKChan 5af5104437 Merge branch 'master' into menusub-20261016 
# Conflicts:
#	game/smoke/shot_probe.gd
 2026-10-16 04:35:22 +08:00
DKChan 9846a29f4c fix(呈现): 主菜单副标题「扫雷的因 · 逐行兑现的果」整个删除（2026-10-16 用户令——无意义标语，玩家可见面禁扫雷字眼） 
- ui_assembler.gd: 副标题 label 两行删除（标题与分隔线之间；局部变量无外部依赖，VBox 回流）
- shot_probe.gd: menu_sub 文字锚/自检腿退役（menu_title 保留）+ 菜单段头部历史注记换代
- shot_checker.py: 菜单·副标题 box/presence 两断言腿同撤（_meta 记录端随 pair 列表自断），不重锚
- golden: menu_boot.png 基线换代——触发原因=副标题件删除画面少一行字（呈现类批内换代，Q6 口径；提交说明强制成因即本条）
- 文档四面同步: 01-核心循环 节标题改「一场战斗的流程」（口号句无承载价值，正文已释流程）；HUD框架 双舞台段删口号句保留因果论点并句；教学引导 P0 最小集合候选删「归因提示」项；07 ㉗ 目检判据删副标题字样
- 验证: shot_probe 问题=0；render_gate 全绿（shot_checker PASS / 棋盘三屏 golden OK / 菜单 golden changed=0.00% / 残留 Godot=0）；改动面 7 文件（含基线 PNG）
 2026-10-16 04:33:17 +08:00
DKChan bf65b49331 fix(调试入口): boot 菜单优先+开始屏右下角调试角标恢复——用户实测否决「启动即开」 
用户 F5 实测：浮窗 boot 自动开把开始屏盖成调试面板（640×约700 居中面板盖掉大半个屏），
且菜单层没有任何浮窗入口（iter18 迁宿主两屏的理由＝启动即开，已不成立）——关掉浮窗后
菜单上无法再开。用户令查三问（入口在哪/何时触发/触发后效果）后修正：

- main.gd：_ready 删 boot 自动开浮窗（_debug_entry 门控保留）；恢复菜单角标接线
  （pressed→_on_debug_badge_pressed）；可见性赋值挪到门控落定之后（原在 _build_ui
  读到初始 false——首跑冒烟抓出）
- ui_assembler：恢复右下角「调试」角标（git 历史 40fb4a5c^ 原实现：PRESET_BOTTOM_RIGHT
  16px 角距+FS_HINT+豁免宽度基准）+ 返回键补 dbgbtn（首跑漏了返回键致 menu_screen
  句柄 null、_build_ui 中断、V1c 层序红——冒烟抓出）
- scenes/menu_screen.gd：暴露 dbgbtn 句柄
- debug_overlay.gd：desc 文案改三处入口说明（开始屏右下角/战斗屏 HUD/地图屏角标）
- 探针/断言四处换代：smoke V2f 改「boot 不开浮窗+菜单角标可见」、V1a 收回严格判据；
  click_probe boot 检查反转+角标检查翻转为缺失才红+删浮窗恢复断言；tune_probe ① 改
  角标真实点击开窗路径；shot_probe 删浮窗归一段（已成死代码）
 2026-10-16 04:21:49 +08:00
DKChan 15c64c3552 fix(冒烟): 屏蔽批两处断言语义订正 + 基线 09 刷新（并行会话头注漂移，非本批引入） 
- 变异断言语义订正：board_variant_ids 只装板级/全局型（region 变异在格子级 variants）——
  板级空断言 + 格子级恰一行且在 {magma,ash} 断言 + 确定性比对加 variants 字典逐位
- V1a boot 顶层断言容错调试浮窗（2026-10-16 写死后 boot 即开，浮窗悬浮于菜单之上=
  合法顶层；原守卫「菜单被冒险屏盖住」语义不变）
- baseline.json 09 项 fp 刷新：主区与分支 audit_file_headers 输出逐行一致（128 行），
  漂移源于 20f4a7dc 之后主区 .gd 头注变动（并行会话），本批零引入；红项仍为存量
  127 处，仅对齐指纹
 2026-10-16 03:43:35 +08:00
DKChan d468595a5a fix(闸): 本批闸面三修——冒烟作用域/shot_probe 浮窗归一/click_probe 断言归位 
- smoke_all.gd：确定性断言跨块引用 bb/crng 出作用域（Parse Error）——首跑结果
  hoist 为 boss1_ids/boss1_calls 函数级变量再比对
- shot_probe.gd：DS_DEBUG 写死后 boot 即开浮窗压在菜单上（boot 顶层检查/golden/文字
  占比三处受扰）——截图前走 _close_modal 真实单口归一，视觉契约与调试模式解耦
- ui_click_probe.gd：恒开断言原址在设置面开中段（ModalStack 遮挡语义下浮窗暂隐，
  误判）——挪至 boot 段断言即开，设置面关闭段补遮挡恢复断言
 2026-10-16 03:27:36 +08:00
DKChan d1b2e519ce feat(调试): DS_DEBUG 环境变量门控写死=true——用户令「直接写死，不读环境变量」（2026-10-16） 
- main.gd:219 原 OS.get_environment("DS_DEBUG")=="1" 读取退役，_debug_entry 恒 true
  （启动即开浮窗+两屏角标；var 注释与 6 处会话门控注释同步换代）
- 闸断言换代：smoke V2f 由「态==环境变量」改「恒开」断言；ui_click_probe 原
  「未设时浮窗不得默认开」反转为「未恒开即失守」；ui_tune_probe 删自设环境变量
  死代码（OS.set_environment 行）+三处消息/注释换代
- 其余 6 文件 10 处注释/文案清扫（ui_assembler/debug_overlay 含浮窗内用户可见
  工具提示/modal_stack/board_zone_view/level_map_screen/README）——全库 DS_DEBUG
  引用清零，无新旧并存
- 发布前删除事项：main.gd:219 一行（用户知悉；无 CI，两道恒开断言会红兜底）
 2026-10-16 03:08:31 +08:00
DKChan 9723c1524b feat(屏蔽): 贫矿脉地形变异删行——用户令「特异关卡后续重新设计，先屏蔽」（2026-10-16） 
- variation.tres 删 skewed_veins 行（scope=global/resource_face/effect_value=30）：
  Boss/精英图全局池空 → _resolve_global_variant 空行回落 → region 布置原路兜底，
  玩家面零横幅零角标零资源偏斜；删行依据与首发批裁决记录改写为屏蔽注记（git 历史可溯）
- smoke_all.gd 7 处断言换代为「全局池空→region 兜底回落」路径：
  行数 7→6 / boss 池去 skewed_veins / L2 boss+elite 全局决议改断言空行 /
  Boss 图改断言恰一行 region 变异+格子级布置恢复+取号恢复 / 快照投影与板载一致 /
  同种子确定性（region 路径）；节头与 print 同步换代
- resource_face 机制代码（RewardEconomy 偏斜投影/schema 互锁/负样本）零触碰，
  重建设计直接加行即可
 2026-10-16 03:05:26 +08:00
DKChan 19d036ce2c merge: 布局闸入库（layout_probe 补回分辨率几何断言·两档） 
档位表是数据、断言是一份函数据——测试代码量与档数无关，增删档只改数组一行。
档位按 battle.md 现登记的两档（1280×800 / 1920×1080），未新增。

修正旧探针的假断言：headless 下 get_window().size 不改变视口（实测），
正确接口是 content_scale_size。旧探针「1920 档恒定」永远为真。

变异验证两发：B区高度撑爆→5 条红✓；注入全幅兄弟控件→未见红✗（边界已如实标注）。
挂 probe_gate 默认必跑段。全量闸 9绿1存量红，回执 commit=5af6c8a8。
 2026-10-15 23:55:53 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan 5af6c8a8b4 feat(布局闸): layout_probe 补回分辨率几何断言（两档·一份断言函数据） 
背景：孤儿探针 ui_layout_probe 退役后1920 档布局几何无机器承载。重建但改形态——
「档位表（数据）+ 一份不变量断言（代码）+ 循环代入」，测试代码量与档数无关，
增删档位只改 VIEWPORTS 数组一行。这与业界 Playwright parametrize/projects 同构：
同一个 test body 跑多档，变的只是输入表与基线图张数（数据非代码）。

档位按 battle.md §验收现登记的两档：基座 1280×800、16:9 全屏 1920×1080。不新增档。

关键修正——旧探针那条「1920 档几何恒定」断言是假的：
  设get_window().size = 1920×1080 → 逻辑视口仍是 1280×800（headless 下不生效）
  设 content_scale_size = 1422×800 → 逻辑视口 = 1422×800（真生效）
Godot 文档指定的运行时改基座接口是 content_scale_size；旧探针用错了 API，
其断言永远为真、当年报 PASS 是假绿。本探针改用正确接口。

断言面（每档跑一遍）：三区非零/不越视口/两两不重叠/board_view ⊆ board_zone/
格子边长 ≥36px（battle.md §棋盘格尺寸公式 1280 档 12×12 → 36px）。

变异验证（CLAUDE.md 第9条）两发：
  ① battle_stage_view B区 252→700 → 5 条红（两档都中）✓ 还原后 PASS
  ② 注入全幅 ColorRect → 未见红 ✗ —— 判据只点名三区不覆盖第四个兄弟，
    该缺陷类不在拦截面内。已在代码注释标明边界，未过度设计补递归遍历
    （递归全子树查重叠极易误报容器父子关系）。

挂 probe_gate 默认必跑段（轻闸即跑）。S10 文件头闸本批零新增。
 2026-10-15 23:46:39 +08:00
DKChan 20f4a7dc01 feat(收口闸): active.md 体量闸并入全量闸清单——收口漏删旧条目在合回时被拦 
- tools/audit_active_state.py：判四条可机械测的膨胀签名（状态记录条目数>30、
  快照行数>10、条目编号重复含并行撞号、指向 design/qa|research 中间文档的死指针），
  另加快照整行自我重复一项（换代不彻底只往顶部 prepend 的签名）。
- 变异验证：对换代前的 34 条版本报 5 项红（A1/A2/A3/A4/A5 全见红），
  对退役后的 3 条版本报绿；两态实测 RC=1/0。
- 入 run_all_gates.sh 为 08b（脚本即清单，不另立第二份闸清单），baseline.json
  随批补 08b 绿项（本分支内实测绿，非臆造）。
- 规约挂指针两处：doc-conventions §10 机械闸句、process-conventions 批次清单 12。
- active.md 按 §10 退役：状态记录 34→3 条，快照 21 行自我重复压回 10 行，
  删「项目当前位置」整节（滞后且与 roadmap/快照重复），未决面按迭代 27/28 重列。
- 不动 Stop 钩子：回合末判收口时机错配（一轮答完≠任务完成），机械层交合回闸，
  语义层交收口技能。
 2026-10-15 22:23:53 +08:00
DKChan eb5e892456 fix(闸收敛批三): .gates/.gitignore 入库 + 脚本自愈重建 
合回 master 时发现：.gates/.gitignore 未入库，receipt.json 被纳入版本管理——
它是每跑批覆写的当次回执，属中间产物。

成因：重跑闸前用 rm -rf game/tests/.gates 清目录，把 .gitignore 一起带走了；
脚本自身不重建，跑得再多次也不会回来。

- .gates/.gitignore 入库（挡 receipt.json 与 *.log）。
- run_all_gates.sh 启动时自愈：.gitignore 缺失则重建，杜绝复发。
 2026-10-15 22:07:13 +08:00
DKChan 94f1bba840 fix(闸收敛批二): gdd_lint 分域豁免 + doc_term 语境豁免 + 孤儿探针退役 
用户令四条：清单类与术语表免 GDD 规范性检查、退役词统一处理、文件头另处解决、
无使用的探针全删。

- tools/gdd_lint.py：新增 RULE_EXEMPT（规则粒度分域豁免，**按规则不按文件**）——
  06 免 R3/R4/R7、07 免 R3/R5/R7、术语表免 R2/R5。
  理由逐条写进代码注释：R3 禁修订注记与「登记处条目要能回答谁在何时裁的」直接冲突；
  R4 版本历史节与 06「解决即移除」的状态登记体裁冲突；R5 是节名含「流程」即触发的误匹配
  （07 的「㉖全流程走查」是目检清单节、术语表「开发流程」是词条节）；
  R7 长括注在登记处是常态。
  **机械可判的完整性规则 R6/R8/R9/R10/R11 一律不豁免**，真缺陷不得藏起来。
- design/gdd/术语表.md：版本号撞号订正（10-12 那条 v1.2→v1.9，两条 10-13 顺延 v1.10/v1.11），
  按真实时序重排。原撞号源于 2026-10-11 与 10-12 两批各写一个 v1.2。
- tools/doc_term_audit.py：五组退役词按语境豁免而非改正文——
  充能（秘宝主动件现行机制，扩 exempt 信号）、可选类道具与雾格（否定式引用「现行池内无可选类」
  「不做清单」——替换会毁掉句意）、伏击/heavy_multiplier（battle.md 占位表里的退役敌人 id，
  现行规格在 敌人系统.md）、拔旗（06 待办「件派生动词白名单」是待评估设计意图非在用机制）。
  疑似现行 6 处 → 0。
- 孤儿探针退役：ui_layout_probe 与 ui_audit_probe 共 6 文件（.gd/.uid/.tscn）删除——
  两者均无任何闸脚本执行（全仓仅注释与历史报告提及）。
  连带清理 render_gate.sh 头注、board_view.gd cell_size 注释、game/README.md roster 行。
  **遗留**：ui_layout_probe 原承担 1920 档布局机检面，现无承载，已在 render_gate 头注标明待补。
- roadmap.md 迭代循环第 4/5 条：轻闸/重闸改指 run_all_gates.sh，闸清单不再散落第四处。

闸况：9 道绿（含 gdd_lint / doc_link / doc_term 三闸全绿）；static_scan S10 文件头 125 处
按用户令不在本批处理，已落 baseline.json 作为存量红。
 2026-10-15 21:42:35 +08:00
DKChan 1d4ac91e3b feat(闸收敛批): 验收闸唯一入口 run_all_gates.sh + 合回闸回执强制 + t17 探针隔离修复 + 文档闸清单单一事实源 
用户令「迭代完成前必须全量跑一遍所有测试」。起因是 iter27 台账只记 probe --click 未记
--full，t17_defer_probe 红了整个迭代无人发现——根因是闸清单散落 CLAUDE.md /
process-conventions.md / test-conventions.md 三处、彼此不一致、且无任何机器校验。

- tools/run_all_gates.sh（新）：全部验证闸的唯一入口与唯一清单，串跑冒烟/单元/探针
  --click/--full/渲染/doc 三闸/静态扫描/熵增闸共十道，写回执 game/tests/.gates/receipt.json。
  与 baseline.json 比对判定：基线红且红项清单未变＝存量红零新增（不判失败），
  基线绿转红或红项清单变化＝新增红（判红）。python 解释器自动解析带 PIL 的解释器
  并前置 PATH（渲染闸三个脚本依赖 PIL，用错解释器会假红）。
- .zcode/hooks/worktree-guard.sh：Bash 分支加合回闸——merge/rebase/cherry-pick 进
  master 前按目标分支反查 worktree 回执，校验 commit 匹配/非 quick/无新增红三态，
  任一不满足 exit 2 拦截（九态实测：匹配放行、commit 错/quick/含红/无回执/rebase 全拦）。
- game/smoke/t17_defer_probe.gd：隔离面从 main.save_manager = iso_c 改
  ProbeUiUtil.isolate_save（iter27 已确立口径）。原写法对 getter-only 属性赋值无效
  ——组合根 save_manager/meta 是 autoload 读视图，隔离必须落在单例上。修复后 --full 转绿。
- doc_link 三处死链归零：数据配置.md 已退役探针指路、元进度.md/天赋树.md 已改名文档链接。
- CLAUDE.md / process-conventions.md §3第10条 / test-conventions.md §4 三处
  「交付前跑什么」统一为一句话＝跑 run_all_gates.sh，删散落清单。

闸况：冒烟 0 / 单元 0 / --click 0 / --full 0 / 渲染 0 / doc_link 0 / doc_term 0 /
熵增 0；gdd_lint 与 static_scan 为存量红，已落 baseline.json 待判读清偿。
 2026-10-15 21:16:38 +08:00
DKChan 140e440896 fix(迭代28 T1 补): 类型闸 S9 归零（main.gd 合同装配容器注解） 
_apply_layer_contract 内 `var tags: Array` 未带元素类型，被 static_scan S9
（tools/audit_type_hints.py R1 无类型容器）判红——iter27 立的类型闸本批唯一
新增违规，随批修为 Array[Variant]（与项目机械参数化口径一致）。

S9 由 FAIL(存量 1 处) 归零；冒烟复跑 1125/0 不变。S10 文件头闸存量 125 处
系 2026-10-15 新立规的清偿批在册项，非本批引入，不动。
 2026-10-15 08:24:12 +08:00
DKChan 67342c690e feat(迭代28 T4): 渲染面内容断言三件（探针自检+墨色判据+启动态菜单 golden） 
①shot_probe.gd 两条自检进 _problems：boot 态顶层可见层=start_overlay（内容层树遍历——屏壳容器不当候选，camp 壳透明实证）；菜单标题/副标题 label is_visible_in_tree 且 rect 落屏内；隔离档 refresh_resume 开=菜单截图不依赖真实档断点态。②shot_checker.py 增 F 字在判据：菜单文字框与中位灰度差>60 像素占比带 [2%,55%]（极性无关——亮字暗底同判；实测标题 13.07%/副标题 11.47% 定 provisional 阈值；对比度只判反差不判字在的缺口由此补）。③启动态菜单 golden：帧差前置验 0.0000%/max_diff=0（光柱静态贴片零动画）；golden_baseline_refresh.sh 扩 --menu 模式（shot_probe 取材→game/tests/golden/menu_boot.png，字体+按钮石纹素材守卫）；render_gate.sh 补菜单 golden 对比段（素材缺位 SKIP 同 Q5 口径）。闸=render_gate 全绿（探针问题=0+checker A-D/F 全过+棋盘 golden 0.00%×3+菜单 golden 0.00%）。注：本机 render_gate 需 gamedev venv Python 前置 PATH（闸机脚本调 python(PIL)，本机默认 python 无 PIL——用户侧环境自带）
 2026-10-15 07:28:38 +08:00