game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,477 Commits 23 Branches 0 Tags
1c034f555fcc2daa2e6257fdd3a4d899f1d7054f
Commit Graph
373 Commits
Author SHA1 Message Date
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 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
DKChan 77075e6e7a feat(迭代28 T3): 生命周期存活性矩阵冒烟段（_smoke_lifecycle_matrix 九阶段×五引用面） 
驱动复用：V3 debug seed 开局路径+_auto_play_round 活战斗模式（phase/round 守卫+choose_dig）+ui_struct resume 夹具模式，不另起点击链。阶段=闲时/开局停点(地图选路停点态合并)/战斗中/结算后(胜利停点)/选路页/终局面/回菜单收束/各模态开合后(菜单域四模态)/两连局/续玩断点。五引用面=_treasure_ui 2/_bonus 6/_camp_pres 3/_modal_flow 4/_row_pacer 5 句柄+2 Callable+run_scope 13 成员；判据=恒活面有效+会话三面阶段存活态(alive/null/both)+现值回调与 run_scope 成员同源(回调链无悬挂)+收束/续玩换会话无真空窗+旧局 queue_free 消亡。三处判据订正实录：隔离后刷新续玩钮定基/战斗收场判 is_battle_live(胜利停点 settlement 陈旧有效非 null)/调试浮窗开不隐菜单。冒烟 1097→1125/0
 2026-10-15 07:18:54 +08:00
DKChan a35581e441 feat(迭代28 T2): boot 链路时序后置条件冒烟段（_smoke_boot_chain 六断言） 
挂 _split_tail（协程纪律 await）：V2a ConfigDB 就绪+表载/V2b 设置已应用（Master 总线 mute/volume_db+UiKit.motion_scale=settings_store 现值，一致性判据与真实设置文件内容无关）/V2c 启动态菜单可见/V2d 续玩钮态==断点在档态（boot 路径关系判据+隔离新档双向：无断点隐/合成断点显/清断点回隐）/V2e 闲时会话在树/V2f 调试浮窗态==DS_DEBUG 门控（两侧同判据）。存档隔离 attach_path 禁碰真实档。冒烟 1087→1097/0
 2026-10-15 07:07:44 +08:00
DKChan 6f71509421 feat(迭代28 T1): 装配语义合同单点化+装配序修复+V2 断言重写 
合同常量 LAYER_CONTRACT（16 层全视觉层序唯一事实源：屏壳/两全屏态/12 模态，level_screen 宿主/camp_screen 同槽/curio 对位三特例数据化）；_apply_layer_contract 统一落位单口（add_child 后排序+登记同源派生，两处散落 move_child 删除）；装配序修复=冒险屏先挂菜单屏后挂（F5 见战斗界面坏事实）；V2 断言重写=V1a 启动态顶层可见层=start_overlay（内容层遍历，屏壳容器不当候选——camp 壳透明实证）/V1b 菜单壳在冒险壳之上/V1c 合同树序链逐对保序/V1d 落位单口源码断言；ui_struct_probe career 专属登记序契约推广为全模态 _modal_registry_contract（旧件同批退役）。红→绿记录：修复前 1086 项 3 失败（V1a/b/c），修复后 1087/0。代拍板=合同数据形态（有序数组+host/shell/tags 特例字段）
 2026-10-15 07:04:02 +08:00
DKChan a2d6e03df2 feat(规约): 文件头≤8行白名单制第二轮立规+头注机器闸S10（2026-10-15 用户令） 
code-conventions §1.4.1 换代：## 文档注释载体+8行上限+五类白名单+黑名单+写法权威参照（Google Python Style Guide §3.8 + PEP 257，GDScript 官方指南无文件头条款不自造标准）；§2.1 信号契约改入发送方 ## 文档注释每信号一行、计入上限；CLAUDE.md 硬性红线同步换代；新建 tools/audit_file_headers.py（R1行数/R2日期/R3变更叙事，正例反例边界例盲测通过：恰好8行过/机制词结算批不误伤/无头注过），static_scan.sh 挂 S10。纯规则与工具零行为变更；实测存量 125 处约 90 文件，清偿批在册待发令
 2026-10-15 04:45:00 +08:00
DKChan 5f9d8e7b77 chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令） 
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例）
- 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为
  现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行）
- 纯注释改动零行为变更，按用户令免测试免冒烟
 2026-10-15 04:08:38 +08:00
DKChan 9a9fa7e8be fix(迭代27收口补遗): 卡片核对缺口三项+resolver 幽灵通道断根 
- V8 卫生 grep 断言落地 smoke（字符串 Callable 产品码零命中/FeatsEngine 退役/死代码抽查/GP 影子账零残留）
- 06 补登卡片两条义务（长函数余量 14 件+lambda 连接 76 处防回归）
- 漏网字符串 Callable×2 补装+validator 头注/main 死注记清理
- resolver 幽灵通道断根: reset_warn_dedup 门面参从未存在（字符串 Callable 零校验藏死引用，
  方法引用换装编译期暴露）——删参，注册表清空归 resolver 本类方法（门面 :115 直呼即正道）
- 实现报告补核对结案段

闸: 冒烟 1086/0（+V8×5）+类型闸归零
 2026-10-15 03:03:29 +08:00
DKChan eea345882b feat(迭代27 T6+T7): 波五b 卫生件包+文档同步闸——对拍全同 
T6 卫生件（P2 组收口）:
- 死代码 13 函数删除（审计 16 处复核=ui_kit:486 实读现役不删，追认单#14）+FeatsEngine
  整文件退役（class_name 注销）
- 字符串 Callable×10 位→方法引用形态（编译期方法存在性校验；语法实证 METHOD_REF=true）
- 状态机 enum 化: adventure State（外部 String 契约 getter 词表逐位一致+外部纯读实证）/
  standee HeroState（register/set String 形参零变化+probe 面恒等）
- ConfigDB _fatal 退出归根（核心层去 quit/crash→_fatal_flag，决策归组合根 fail-fast 通道）
  +resolver 诊断/数据通道全面 Callable 化（ConfigDb↔Resolver 类型环断根）

T7 文档同步闸:
- 实现报告 design/qa/iter27-实现报告-2026-10-14.md（五波+闸表+追认单十五项+反哺点两条+目检五件）
- 06 迭代 27 条销号+GDD 反哺点两条新条；07 ㉖ 目检节+v1.0 版本行；roadmap ✅ 换代
- 审计报告本体按退役规则 git rm（吸收即死；修正计数由卡片承载）；卡片来源行改指路

闸: 对拍三变体全同（第五跑）+冒烟 1081/0+run_all 27 套+probe click+render golden+static_scan 全绿
 2026-10-15 01:41:37 +08:00
DKChan b605022001 feat(迭代27 T5): 波五a 类型闸拉起+存量收口——审计器 0 存量+warning 配置在位 
P1-6 类型闸（须 T1-T4 全落后——本波按执行顺序锁殿后）:
- tools/audit_type_hints.py 新机器闸（V7）: R1 无类型容器注解/R2 有值返回缺返回类型/
  R3 参数缺类型三规则+行级 # type-hint: ignore 显式白名单通道；产品码 core/data/presentation
- 存量收口: 368 处显式 Array/Dictionary 非参数化注解→机械参数化（Array[Variant]/
  Dictionary[Variant, Variant] 零行为面）；13 处参数真类型（SaveManagerCore/ConfigDb/
  BattleOrchestrator/MinesweeperRules/LevelRunner/SettingsStore 等）
- 白名单豁免四处: board_generator generate/_attempt/legality/_finalize 的 db 参——
  测量面 _BoardRowStub 冒烟夹具鸭子型注入（typed 参拒 stub）
- project.godot 拉起 gdscript/warnings/untyped_declaration=1（V7 源码断言在 smoke _smoke_type_gate）
- static_scan 新 S9 类型闸规则；顺修历史 cd 错位（9-24 布局迁移后 /.. 落 game/ 致守卫
  恒跳过静默空转——修复后 S1-S4/S9 首次实跑全绿）+S1/S2 增 ADR-0007-exempt 标记豁免通道
  （main _seed_value 引擎熵源=文档化豁免面）

验收: 冒烟 1081/0（+V7×2）+run_all 27 套+static_scan 全绿+probe click+render golden+对拍三变体全同
 2026-10-15 01:05:17 +08:00
DKChan 8b9e55673f refactor(迭代27 T4): 波四 ModalFlow 抽取+互斥域 tags 化+双 context——对拍全同 
P1-5/P2-7 组合根可测化+模态协议内聚（场景拆分后重估结论=抽取面收敛为模态编排域）:
- modal_flow.gd 新纯逻辑类: 依赖仅 ModalStack+查询 Callable（审计处方）——开合编排
  （挂起兜底/排播排空/遮挡记账/开合同步）/棋盘输入锁谓词（三例外注入）/双形制角标谓词；
  V6 modal_flow_test 19 断言直接 new() 进 run_all（26→27 套）——测试抓出并修正
  挂起兜底 divergent return 一处（原 main 语义=先结挂起后继续开本层不短路）
- ModalStack 互斥域随层登记: register(m, tags) + TAG_NON_LOCKING/TAG_SCREEN_STATE
  封闭词表 + has_open_excluding_tags 组查询；原 has_open_excluding/_any 调用点拼装退役
  （main 五处判据迁移）；main._modals=flow.stack（ui_struct _list 登记序断言缝保留）
- P1-5 控制器构造收拢 context: curio 16 参→CurioFlowContext/camp 13 参→CampFlowContext
  （字段逐一同名迁移，控制器可独立实例化）

验收: 对拍三变体全同；冒烟 1079/0+run_all 27 套+probe click+render golden 全绿
 2026-10-15 00:31:36 +08:00
DKChan 6fd7d782cc refactor(迭代27 T3): 波三 账本收口——RunLedger 单类持四账+刷新双账删副本+gp_final 键删影子账——逐位一致对拍全同 
P1-4 共享账本 Ledger 类化（裁点②甲 单类持四账）:
- game/core/run_ledger.gd: attune_charges/vision_counter/adventure_counters/bonus 四账
  单类承载；战斗侧只拿 read/append 原语（attune_charge_has/set/consume、vision_count_add、
  counters_seed_snapshot/merge_export、bonus_add_axis）——战末 export/开局 seed 时点语义不变
- AdventureRunner 持账（run_ledger）→ LevelRunner set_run_ledger+sync_attune_inventory
  （原四散 setter 收口）→ enc 单键 ledger 下传；编排器三裸引用成员退役为 _ledger 原语调用
- 调试/单场缺省新账=零扰动面（vision_counter 缺省空=不计，原 enc 缺键守卫语义保留）

P1-2 刷新双账收口:
- main 刷新计数副本（run_scope.refresh_used_round）删除；单一事实源=编排器受理计数
- presentation_snapshot 成文面升键 refresh_used（can_refresh 邻位）——HUD 余量/遥测
  round_refresh_index 单源读快照；V5 快照一致性断言×3（smoke+ui_click HUD 文本比对）

P1-3 GP 影子账收口:
- adventure_runner summary 增 gp_final 键（close_wallet 清账前快照）
- gp_shadow_ledger.gd 全件退役删除；main 委托缝/会话账本成员删除；终局面板 GP 行
  取数=summary 键；ui_probe 影子账断言换代为 summary 键断言

验收: 逐位一致对拍三变体全同；冒烟 1079/0+run_all 26 套+probe click+render golden 0.00%
 2026-10-14 23:25:45 +08:00
DKChan 26301baa9c refactor(迭代27 T2): 波二 _settle 五段拆 Segment+_resolve_hero_attack 拆步——逐位一致对拍全同 
P1-1 结算巨函数拆段（裁点③甲 审计五段）:
- game/core/settlement/ 五段类: GrantSegment(授予段体+旗判随段迁入+counter_add 五位/
  grant_material 三位分支单点化)/AuraSegment/CombatSegment(原 _combat_segment 体)/
  DecaySegment/VerdictSegment(返回裁定，终局早退语义留宿主)
- 编排器 1725→1325 行退为段序编排+行发射/开单原语单点；_judge_flag/_combat_segment
  旧实现同批删除；smoke 白盒 rig 随段迁址(orch._grant_seg._judge_flag)

姊妹病灶（同批）:
- damage_controller _resolve_hero_attack 148 行拆四步: _hero_attack_ctx(命中面/按序改写
  族四拍)→_hero_attack_base_value(加法族/计数器施加/倍乘)→_hero_attack_redeem(掷点/池乘/
  rider/落地/击杀)→_hero_attack_deliver(状态/交付行)；ctx/redemption 字典穿线算序逐字保留

验收:
- V4 settle_segments_test 16 断言进 run_all(25→26 套)
- 逐位一致对拍三变体全同(RUNSUM+JSONL 双面零漂移)；冒烟 1077/0+run_all 26 套
  +probe click+render golden 0.00%
 2026-10-14 22:09:29 +08:00
DKChan 7a0d57ddb0 feat(迭代27 T1): 波一 场景拆分+局生命周期物化——逐位一致对拍全同 
P0-1 三屏场景化（契约2 只拆不重写）:
- menu_screen/camp_screen/adventure_screen 三 .tscn 屏壳+壳脚本（视图代码原样构建，
  40+ views 零 .tscn 化）；adventure 屏壳内含 level_map/battle 两容器
- main.gd _build_ui 解体=三屏实例化+模态装配+接线；组合根句柄全部保留（探针挂载
  假设 main.X 一级路径零迁移）；树序=屏壳在前全模态之下（视觉共存对逐对验算）
- 屏壳根 mouse_filter=IGNORE（ui_input 实证：全屏 STOP 壳吃下层模态鼠标输入）

P0-2 会话物化（裁点①甲 autoload+手工清单消亡）:
- run_scope.gd 节点持全部局态（adventure/runner/settlement/7+ 局态旗/账本）；
  _begin_session 建会话、终局整节点 queue_free()——_reset_run_scope 三项+
  _on_battle_end_continue 置空四件手工清单删除
- SaveManager/MetaProgression 升格 autoload 3/4 号位（类名加 Core 后缀沿 RngService
  先例；--script 模式编译器不解析裸 autoload 标识符——组合根留读视图属性 get_node 形态）
- 探针隔离改 attach_path 原地重置（set_master_seed 先例）；10 探针+pacing 测试迁移

验收（V1 核心=逐位一致对拍）:
- parity_anchor 三变体 base/attune/shop×40 局 RUNSUM+JSONL 双面逐位全同（零行为漂移）
- 冒烟 1055→1077/0（+V2 屏壳独立实例化 11 断言+V3 两连局复位 11 断言）
- run_all 25 套+probe click 全绿+render_gate golden 0.00%×3
 2026-10-14 20:28:53 +08:00
DKChan fc7fee03bd chore(迭代27 T0): 逐位一致对拍锚冻结+探针迁移对照表 
- tools/parity_anchor.py: 三变体(base/attune/shop)×40局 RUNSUM+JSONL 双面哈希对拍（V1 核心验收载体）
- anchor.json: 重构前锚（种子面 71000/72000/73000 错开，覆盖 base/同调账/商店-GP 账三类重构面）
- 探针迁移对照表: 11 挂载面逐一列成员依赖与迁移方向（卡片 T0.3）
 2026-10-14 19:15:05 +08:00
DKChan c8c3db1052 merge: 迭代26 UI交互与观感批全量入库(七提交, worktree g-plan2-iter26-ui) 2026-10-14 06:34:41 +08:00
DKChan 081ae3b88f chore: project.godot 主题两行顺序归一（编辑器保存产物，语义等价 no-op——为迭代26合并清道，用户 2026-10-14 授权） 2026-10-14 06:34:23 +08:00
DKChan 260c9bbd9e feat(迭代26 T5b): 诊断转储钮退出玩家画面——入口迁调试浮窗（grilling Q8 裁甲） 
- main.gd 卸载点删除（build_diag_button 挂载+连接）；build_diag_button 工厂退役（ui_assembler）；
  连接随迁=debug_overlay.diagnose_requested→_on_diagnose_pressed（dump_diagnosis 卡死取证保留，
  删除案否/门控隐藏案否——浮窗本就可全局可开，双轨无意义）
- debug_overlay 新增 diagnose_requested 信号+区块⑤转储钮（_emit_diagnose_requested 外发，纯视图边界）
- 探针同批入册：ui_tune_probe 只读巡检白名单+_emit_diagnose_requested、连接数 10→11（七钮），
  confirm_dialog/main 树序注释订正（诊断钮引用清除）
- 冒烟新增 _smoke_diag_button_retired() 7 断言（V6：主区零残留+工厂退役+连接随迁+浮窗可达）；
  冒烟 1048→1055/0；probe --click/--full 全绿残留 0
 2026-10-14 05:57:16 +08:00
DKChan 02c87fc281 feat(迭代26 T5): 元素细节余②③——BCard 图标槽明度差降档+商店居中+营地四栏等高 
- ②立 SLOT_BACKDROP_SOFT #806A4E 柔和档（代拍板6：对米色卡面 3.69:1〔旧 8.53:1 过硬〕，
  白图标 5.14:1 ≥3:1 硬约束在役）；仅 BCard 图标槽换档，B 区状态槽仍用深档（诊断订正③范围）
- ③商店 _cards_box ALIGNMENT_CENTER 垂直居中（三选一同款形制）；营地四栏等高=三 holder 统一
  min 高 336（与树/秘宝匣 scroll 对齐，锁定态仅锁文也撑栏高）+四面板纵向 SIZE_FILL 同步拉伸
  +三处锁文 SHRINK_CENTER（代拍板7 两选项组合落）
- 冒烟新增 _smoke_element_details() 8 断言（②白图标硬约束+降档方向+两消费点档位；③三处布局锚）；
  冒烟 1040→1048/0；probe --click 全绿残留 0
 2026-10-14 05:47:50 +08:00
DKChan 86e9aea176 feat(迭代26 T4): 光柱连续 alpha 修边（带内渐变+纵向衰减） 
- beams_rect 重写：带内 alpha 0→0.05→0 三角过渡（旧匀净零过渡硬边梯形退役）+纵向衰减上亮下暗；
  连续 alpha 方案（grilling Q7 裁，与暗角/地图渐变保平滑同血统）；filter=LINEAR 白名单随 T2 已落
- 冒烟 T4 结构断言 3 条（带心峰值≈0.05 按 8bit 截断量化校验/连续过渡像素 41373 个/纵向衰减
  上半>下半 2 倍）；冒烟 1037→1040/0；probe --click 全绿残留 0
- 引擎事实备忘：Godot Image 8bit 量化为截断（非四舍五入）——0.04977×255=12.69 存 12
 2026-10-14 05:39:56 +08:00
DKChan 7cac0dc1ab feat(迭代26 T3): 三处 <4.5:1 文字位换墨+机检锚定 
- 立新 token 两枚（代拍板4·Q6 裁后落值，语义岗冲撞走反哺点③）：GOLD_BRIGHT #E0B860（金族亮档，
  敌顺位徽标①②③+重甲徽标，对舞台底 6.47:1）；HERO_BLUE_BRIGHT #7EBAF0（小人蓝亮档，
  魔法护甲徽标，5.88:1）；GOLD_DEEP/HERO_BLUE 常量本尊不动（standee:199 意图判据等在役）
- ap_bar_view.gd:77 RAP 反馈行 STONE_FAINT→STONE_DEEP（对 PANEL_DATA 5.98:1，旧 2.9:1 越带）
- 冒烟新增 _smoke_contrast_inks() 9 断言（V4：三处对比≥4.5:1+消费点原位锚+语义岗不动+旧墨清零）；
  冒烟 1031→1037/0；probe --click 全绿残留 0
 2026-10-14 05:31:26 +08:00
DKChan 9ddb571d87 feat(迭代26 T2): 全局纹理过滤设邻近采样+平滑渐变件 LINEAR 白名单 
- project.godot [rendering] 增 textures/canvas_textures/default_texture_filter=0（Nearest——
  翻转面=立绘/瓦片/格面/图标/九宫格 UI 皮 crisp，即本批意图；T0 枚举闭合无漏枚举面）
- ui_kit.gd 白名单三件显式 LINEAR：vignette_rect 暗角/beams_rect 光柱（Q7 裁，连续 alpha 同血统）/
  gradient_base 地图渐变；既有脚影/状态图标 LINEAR 不动
- 冒烟新增 _smoke_texture_filter() 6 断言（V3：工程设置=0+白名单三件在位+既有两处不丢）；
  冒烟 1022→1028/0；probe --click 全绿残留 0
 2026-10-14 05:15:32 +08:00
DKChan b6f0c66183 feat(迭代26 T1): 按钮五态矩阵——悬停乙案/禁用甲案/焦点甲案+危险钮本族按压态 
- ui_kit.gd _apply_button_skin 五态统一管线：hover=常态图+modulate 1.06 提亮（乙案·代拍板1·零新素材）；
  disabled=本族底+α0.45 幽灵化（甲案·代拍板2，取代旧「disabled=按压图」错配）；
  focus=INK 2px 内缩 1px 环（甲案·代拍板3，负 expand margin 实现，叠加绘制不遮钮底，主题层零新增）
- primary_button 补 disabled（烛光黄族 α0.45）+focus 环+font_disabled_color（本族墨 α0.45）
- danger_button 补本族 pressed（深红 darkened(0.18) 深档）+disabled 幽灵化+focus 环+font_focus/disabled 色
- 冒烟新增 _smoke_button_five_states() 35 断言（V1 五态非空/hover≠normal/disabled≠pressed/危险钮非石纹/
  焦点环参数锚定+V2 双红线维持）；冒烟 987→1022/0；probe --click 全绿残留 0
 2026-10-14 05:08:42 +08:00
DKChan af2d834e78 feat(迭代25): UI 全局主题批 T0-T2——全局主题资源挂载+两处局部做法退役+冒烟 V1-V6 断言 
- T0: game/assets/theme/main_theme.tres 挂 project.godot gui/theme/custom——
  15 类型全覆盖（V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·
  LineEdit·SpinBox·H/VSeparator）+预盖 CheckBox/CheckButton/OptionButton/
  PopupMenu 弹层；default_font 显式指现役同字体（V6 中文字形防御）；
  位图生成脚本 tools/gen_theme_icons.py（9 张纯色/几何小位图→assets/art/ui/gen/，
  按 .gitignore 政策本地生成不入库）；色值溯源表 game/assets/theme/README.md
- T1: ui_kit.gd 删 tooltip_theme()/_tip_theme 与 styled_slider()、ui_assembler.gd
  删挂载行（旧实现同批删除）；settings_overlay 几何内联、debug_overlay 双轨消隐
- T2: 冒烟 _smoke_global_theme() 38 断言（V1 类型覆盖+Button/focus 双红线+
  V2 冻结值 5.49:1+V3 预盖证词+V4 退役零残留+V6 字体防御）
- 引擎事实（4.7.2 源码+默认主题链双查）：CheckButton 与 CheckBox 同套
  checked/unchecked 图标名；Slider 无 grabber_pressed 槽；ScrollBar 柄=StyleBox
 2026-10-13 21:39:01 +08:00
DKChan ab3ba4f4a0 feat(迭代24): N3 敌方attack_type轴开列——20行全填normal+schema枚举校验+单位快照+开单传值+敌方结算克制消费点(卡片§2漏项,V5矩阵证词强制)+V5四断言(冒烟949/0) 2026-10-13 07:14:58 +08:00
DKChan 26d669f83d feat(迭代24): N1 (1,2)降档hp22/ac2 + N2 毒吐盾击两行六池投放——expect_pools六键同步+V1/V3/V4断言随批(冒烟945/0) 2026-10-13 07:03:37 +08:00
DKChan 6e1b52a450 feat(R1机制位): requires_level等级阈值前置随批重立——用户推翻迭代21追认单#1裁撤案(裁「b)推翻,补机制位小批」)=schema字段Dictionary{node_id:n}+validate悬空/阈值<1/类型错加载即拒+tree_can_buy判定分支+行板门槛呈现(未达标🔒+悬停gate_text)+新单测tree_requires_level_test八断言(run_all 24→25套;首跑抓出测试自身时序bug:零配置行断言跑在cap满状态后,重排修正)+现役12行零配置空转零行为影响(冒烟938/0+probe --click/--full+render_gate全绿零漂移;MC豁免=零数值零行为变化)+天赋树v0.10六处R1表述换代+iter21报告§四#1推翻标注与§八兑现注——doc三闸对基线零新增+熵增PASS 2026-10-13 06:13:10 +08:00
DKChan c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan 8e04807d4a fix(缺陷修批): Y断点随存——attune_refresh_y 入断点快照+续玩优先读断点（堵「用完 Y 退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面=旧档行为零变化）——06「天赋树实装批登记欠账三条」③，2026-10-13 用户令提前单独开修（按正常流程走） 
代码两处（adventure_runner.gd）：①_snapshot_breakpoint 断点字典扩列 "attune_refresh_y"（refresh_stock/battery_pending 同款六先例，扩列向后兼容）；②resume_adventure Y 注入行改 bp.get("attune_refresh_y", params 回退)——花掉不回血，续玩保持已消耗态。

单测：curio_refresh_paid_test 新增⑥段两断言（断点有键=余量随断点还原花1剩2／旧断点缺键=回退参数面整额注入旧档零变化）。

文档三件随批（机械面同步）：①存档序列化.md v1.8——断点随件键 attune_refresh_y 登记，v7 域后扩列不升版（v1.6 vision_used 先例同款，SAVE_FORMAT_VERSION 仍 7 无迁移分支）；②冒险结构.md v0.21——「冒险断点」节附随件清单扩 Y 刷新池余量（断点字段口径 owner）；③06-待办清单——欠账三条专条③✅销号注记+状态行换代（①②维持归 M4，本条转记账条无待裁点）。

批末闸：冒烟 938/0+单测 24 套全绿（含新⑥段）+doc 三闸对基线零新增（死链 3/term 旗与 gdd_lint 3 件 FAIL 均存量——迭代 23 并入后基线，本批三文档零新增旗）；零数值零表值改动。
 2026-10-13 02:05:17 +08:00
DKChan 3392ea7e2d Merge branch 'master' into iter23-forge-20261012 
# Conflicts:
#	design/gdd/systems/表现与支撑/存档序列化.md
 2026-10-13 01:34:15 +08:00
DKChan 31e12c8813 docs(迭代23-T7): 总收口——四闸全绿留痕+机械面文档七件+实现报告落档 
- 批末重闸全绿：冒烟 938/0+run_all 24 套+probe --click/--full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 同种子配对 80 局逐位零漂移+锻造满配档方向性补充（30/80 局差）
- 机械面同步：roadmap 迭代 23 行入库态/entities.yaml forge_workshop 回填实态（impl+save_domain+currency）/06 状态+①② v0.6 措势订正/存档序列化 v1.6（forge_routes 落地态+v7 沿革）/07 ㉒ 目检节+版本行/game/README 批次段
- 实现报告=design/qa/iter23-实现报告-2026-10-12.md（代拍板追认单九条+GDD 反哺点三条+残留人闸）
- active.md 快照换代+状态记录 479/480
 2026-10-13 01:21:56 +08:00
DKChan 2915f19c4b feat(迭代23-T6): 营地锻造工坊工作间——两区六路线行板实装（占位面板替换）+三意图信号接线 
- MetaProgression.forge_shop_status()：只读投影（等级/cap/解锁态/选中态/下级几何价/解锁价/前置通道进度——纯结构面，余额禁用归视图）
- CampOverlay：_forge_workbench 占位面板→武器锻造区/护甲锻造区两区六路线行板（件名+Lv+解锁态文案+锻造/解锁/选中钮）；_rebuild_forge 随 open/refresh 重建；默认不可见+门控重建=锁定态零行板零购买路径（占位纪律延续）；三信号 forge_buy/unlock/select_requested（契约 9 UI 只发意图）
- camp_shop_presenter：camp_data +forge 投影；on_camp_forge_buy/unlock/select 三处理器（写口唯一归 MetaProgression 锻造写口族；拒绝可见 pattern 1 toast）
- main.gd：三信号接 presenter
- 新单测 forge_workbench_test 12 断言（锁定态纪律/两区结构/钮态/余额禁用/满级/派生解锁出钮/三意图外发）；run_all 23→24 套
- 轻闸：冒烟 938/0+run_all 24 套+probe --click 全绿（presentation 触碰加跑）
 2026-10-13 00:21:41 +08:00
DKChan ed0629236a feat(迭代23-T4): 注入接线——hero_override 公式换代（FORGE_ROUTE_BONUS 退役）+两轴参数面全链+入战 AC 三层 
- meta_progression.hero_override：atk=forge_weapon_atk_bonus+树 flat / armor_class=forge_armor_ac_bonus+树 flat / max_hp=树 flat；FORGE_ROUTE_BONUS 预留常量退役（公式不再出现，注释留痕）
- main.build_adventure_params：+attack_type/armor_type 两键（meta.hero_attack_type/hero_armor_type——存档选中路线类型轴，异常回退锻造配置默认值）
- adventure_runner：params 两键快照入公有 hero_attack_type/hero_armor_type（契约 8 锁死可断言面；start/resume 双路同），_start_current_level 经 set_hero_axes 下传
- level_runner：set_hero_axes 注入+effective_ac 换代=甲型基础 AC（forge_armor_route_by_type.base_ac）+路线加值（base_override）+局内加算区（bonus）三层；enc 携带两键
- battle_orchestrator：spawn 传 enc 两轴（空串=锻造配置默认值回退——行为连续）
- 冒烟 V5 后半/V6 锁死/V7 公式对拍+V10 树零攻防复核共 15 断言（含 enc 末端 hero_attack 行 pierce 键+spawn 显式注入）
- 轻闸：冒烟 938/0（923 基线 +15）+run_all 23 套全绿；删除标识符 live 引用零残留（FORGE_ROUTE_BONUS/hero 两轴仅存退役注记与 README 文档面=归 T7）
 2026-10-13 00:09:17 +08:00
DKChan a6270bac54 feat(迭代23-T3): 锻造写口族——路线购买（几何价）+并联双通道解锁+选中切换（免费）+类型轴读数（MetaProgression 单点） 
契约 9 写口唯一（UI 只发意图——意图信号接线随 T6 UI 同批落）：
- forge_route_unlocked：解锁态派生单点（初始持有∨直购清单∨练满前一档 levels[prereq]≥cap——不落档）
- forge_buy_level：几何价=ForgeTable.level_price（20/30/45/67/101），扣钥石+等级+1+即时写盘；未解锁/满级/余额不足=拒绝零副作用
- forge_buy_unlock：一次性解锁价 200 直购；已解锁（含派生）=拒绝零收费——两通道互不影响、不设串联
- forge_select_weapon/armor：免费切换只受理已解锁路线（冒险锁死归参数面快照，契约 8）
- forge_weapon_atk_bonus/forge_armor_ac_bonus/hero_attack_type/hero_armor_type：T4 注入面取数单点（异常选中态防御回退 0/默认值）
- 冒烟 V2/V3/V4/V6 共 15 断言（隔离档 forge/forge2/forge3——add_keystone 置余额+直写存档域注入口径）
- 轻闸：冒烟 923/0（908 基线 +15）
 2026-10-12 23:50:55 +08:00