game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,768 Commits 23 Branches 0 Tags
0adcbd5b07cd94396af46be413d5da21c0c58bc0
Commit Graph
218 Commits
Author SHA1 Message Date
DKChan b673cedd24 iter33 卡③ 审计回炉: 静态扫描两处新增 R1 修除＋回执核验流程订正 
首轮审计实锤批末回执 all_green=false（09 静态扫描两处卡③新增 R1 裸容器注解）——
main.gd:1176 改推断形态（裸注解触 R1、参数化赋值运行期严格拒）、save_select_overlay.gd:58
改 Array[Variant]+assign()（typed 严格赋值纪律）；实现报告状态行与读数表更正（收口订正：
回执须核 verdict 非仅 commit）。audit_type_hints 复跑归零。
 2026-10-22 06:04:59 +08:00
DKChan a6614a3b8e iter33 卡③ T1+T2+T3: 选档界面新建（3 存档位 新档/进档/删档）＋组合根接线＋断言批 
视图 save_select_overlay.gd：页壳先例（career 同款）纵列三行槽卡；摘要三项（钥石徽/通关局/总局——
裁决 4 零断点读数）；操作集二分（空/坏槽=仅新档，有档=进档+删档——Q2 甲坏槽按空呈现）；删档只发
意图信号（二次确认归组合根）；零预选（Q1 甲零选中态字段）；零新素材零新色值（契约 7）。
组合根：LAYER_CONTRACT 加行（生涯同档）＋_open_save_select 开层＋_save_select_data 窥视取数
（occupied=has_file∧readable）＋三回调；暂行落点 CampOverlay（Q3 乙，动线序=先落点开层不关选档）；
ConfirmDialog 消费方编排（静态常驻接线→open 前设消费方按量分派——sl8，_start_adventure_from_menu
同步设消费方）。窥视读器补 has_file 位（T0 对齐结论：空/有档二分判定来处，非摘要第四项）。
断言批：struct 段（sl1 计数/禁滚动＋sl2 逐槽读数＋sl3 禁词＋sl4 二分＋sl9 不预选）；click 段
（sl5 新档链＋sl6 进档链＋sl7 确认双路径＋sl8 分派单口＋sl12 动线序逐帧采样）；flow 步（sl10
返回路径＋ESC 不响应）。开层探针=函数直调中间态（「进入存档」钮归卡② mn3）。
 2026-10-22 05:07:51 +08:00
DKChan 1bbbdba48a fix(T7/N7): 归因锚改用有效误标判据 + _emit_row 后移 + 两态文案 
- _emit_row("seal_miss") 后移到 _fx_emit("seal_missed") 循环之后，使 _perfect_forgiven 先就位
- 判据从 RAW（_perfect_hit_false==1）改为有效误标（hit_false - forgiven == 1）
- battle_log_view seal_miss 文案两态：已破态加金框、豁免态普通色
- "本板"→"本图" 概念对齐
- 修复 suffix 变量遮蔽（改名 miss_note）
 2026-10-20 20:48:59 +08:00
DKChan b6629d6848 feat(T2-T6): 五词注释换代——完美排雷→完美封印/板级→整图/门票→专长凭证/正主→现行事实源/落籍→已入库 
全局 sed 替换 89 处命中清零（S11 绿）。修复：
- 移交 3 处保留原词（shop.tres:86 display_name、curio_controller:165-166 玩家文案）
- 豁免 enemy.tres:653 历史注记保持"已落籍"
- static_scan.sh 词表追加行与头注恢复禁「」引举句式
- S11 规则文件自身不被自身规则误伤（闸门自指豁免生效）
 2026-10-20 20:41:50 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +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 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 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 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 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 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 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 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 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 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 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 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 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 3392ea7e2d Merge branch 'master' into iter23-forge-20261012 
# Conflicts:
#	design/gdd/systems/表现与支撑/存档序列化.md
 2026-10-13 01:34:15 +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 cff741ea2a fix(迭代22反哺⑤补): 试炼镐C区展示行——charges=0件被_reseed_attune_charges注入循环跳过不入骑库存,而C区槽投影遍历骑库存→试炼镐C区不可见/悬停浮窗进度无处承载(追认批集成缺口,单测只测读数口未覆盖投影链)。修复=inventory_projection末段追加自动兑付件展示行(合成handle=-1非库存句柄+note积点N/8+槽点击走说明toast不进两步交互); use_attune_convert删除遗留孤儿函数头注释清一; 单测新增④b展示行断言两条(装配即入投影handle=-1+note=积点0/8/开格后1/8组合根重查链)+StubAutoInvRunner空骑库存桩。重闸全绿: 冒烟898/0+单测22套+probe_gate --full+render_gate golden 3屏0.00%+doc三闸对基线零新增(死链3/拔旗1/gdd_lint三文件表格占比FAIL均实证存量=79aac07版本对比表格行零变化)+熵增闸PASS; 06裁决小节与实现报告⑤条补集成补丁注记 2026-10-12 23:43:38 +08:00
DKChan f22b2036a0 迭代22裁决落文批: A单十五条裁决收口+B单七条反哺全落文+⑤改自动兑付代码批——追认单(①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮追认/④追认+积点账裁战斗级/⑤推翻改自动兑付)收口; ⑤代码=满charge_n=8自动当轮grant_ap无玩家入口(_on_cell_revealed揭示缓冲点兑付=cell_revealed批先于本格扣费故AP归零恰逢满点先兑再扣轮不结束/授予段积点段迁除/use_attune_convert受理口消解/attune_convert_state改造进度读数口+item_id键/use_treasure的ap_charge_safe死分支与_usable_now死条件删/tres试炼镐desc换代+counter_spend受理闸删)——HUD兑换钮整链退役(ap_bar convert信号+钮/board_zone转发/main接线与_sync_convert_button/_on_convert_pressed)+C区秘宝槽悬停浮窗进度(controller投影note字段/hero_info_panel tooltip拼接/main _refresh_presentations加refresh_slots重查); 单测④段重写自动兑付断言(7格零兑付/第8格AP+1/读数口/未装配反例); B落文=秘宝.md v3.0(目录三表实态三列+试炼镐自动兑付换代+代价轴转化获取行含战斗级重置与兑付时序+解锁条件实录钥石10/25四条件件三计数键+实装批落地前句全换代+退役指针补代码旧行已删)/元进度.md v1.17/camp.md v1.3(柜台呈现细则节+暂停层12行)/存档序列化.md v1.6(vision_used域+断点随件+bonus_aux_carry退役+v6扩列不升版)/行动经济.md v0.12(finish_round_stop转存率参数化)+术语表v1.2(自动兑付/真视使用计数两词条)+07㉑观测点随⑤换代; 报告修正=⑮提交号勘正(master实际T5=73db171,原记7095505系amend前被弃旧提交——merge-base实证)+十五条裁决标注+反哺七条已落文标注; 06收口=状态行换代+裁决小节。冒烟898/0+单测22套+probe_gate --click --full全绿(worktree拷.godot/字体与图标边车/art素材后) 2026-10-12 23:23:01 +08:00
DKChan 73db171cb4 T5(迭代22秘宝批): 存档面+死通道拆除——treasure_inventory保留注记(主动件骑库存承载在役:线香/天眼handle+断点aux_items快照+set_attune_charges差额注入全链保留); 替换子交互整体拆除(CURIO_KINDS除名后不可达死通道=装配不可变契约1实现面保证): adventure_runner六函数删(_pick_treasure_item/resolve_treasure_replace/_resolve_node_replace/_replace_in_transit/_draw_pending_treasure/resolve_curio_replace)+_bonus_treasure_carry跨关携带/_last_draw_treasure掷定链/_roll_from/_bonus_treasure_pool/bonus_aux_carry断点键; level_runner.grant_treasure_item/treasure_items.holding_records删; 呈现面=controller替换子态三函数+aux_detail卡片直显链/curio_pick_overlay replace状态机(信号+面板+open_replace)/main两接线/level_autoplay替换策略; smoke与ui_click_probe替换分支摘除+reward_overlay_test替换段摘除; 修正则贪吃误删=apply_node_curio普通兑付主体补回。冒烟895/0+run_all 22套+探针全绿〔秘宝批 V15/V16拆除路线/V13〕 2026-10-12 19:32:29 +08:00
DKChan b7a2eadd2c T4(迭代22秘宝批): 呈现换代——秘宝匣柜台购买钮(buy_requested信号链→presenter buy_treasure_unlock分支,禁用态=余额不足)+分档呈现(名后缀·档位/装配行档位标签/悬停desc)+装配段未解锁禁装; 呈现桥换代(旧提灯布尔桥set_fog_lantern/FOG_LANTERN_BONUS随行退役→set_fog_glow_bonus参数面,main._sync_treasure_glow消费attune_param_sum,off态写0复原契约保持); 巢穴预告toast(nest_preview_count读数口消费); 试炼镐HUD入口(ap_bar兑换钮+convert_pressed转发链+attune_convert_state读数口,未装配隐藏); ui_input_probe case⑮换代主语wide_scout_band+4; V13功能残留换代(breakpoint_resume/ smoke剔牌库/reward_overlay夹具换新件id)+过时注释清理; 修呈现组装断裂=BoardZoneView补convert_pressed转发(挂死根因=main直连不存在的板区信号致_build_ui中断)。冒烟895/0+run_all 22套+探针含click全绿〔秘宝批 V12/V13/V19〕 2026-10-12 19:11:11 +08:00
DKChan a7bd4e4132 T2(迭代22秘宝批): 核心层解锁服务换代+槽位档位约束——工坊渠道面退役(_workshop_progress/workshop_status/refresh_workshop_unlocks/meta_workshop_items/WORKSHOP_ITEM_IDS/workshop_items行族全删)换解锁混合制(buy_treasure_unlock钥石购买=余额闸+重复购拒+条件件误购拒/refresh_treasure_unlocks条件刷新=AND谓词+幂等/treasure_shop_status柜台投影); 计数读数单点_treasure_unlock_progress(adventure_cleared/boss_kill_count/vision_used); save_manager新增vision_used生涯计数域(add_vision_used收束入账+缺键补零不升版本); toggle_attunement三重校验(未解锁拒+满位禁选+件档rank≤装入位序档位格——卸下恒可效果面只读装配集); pause/camp两视图秘宝匣呈现换代+UiKit计数键与档位标签单点; smoke工坊段换V3/V4/V5断言(独立档[11]防路径污染)+meta表段行族规模换代3/3/2。冒烟895/0+单元21套+探针全绿〔秘宝批 V3/V4/V5/V14/V19数据源〕 2026-10-12 15:52:04 +08:00
DKChan 5d254f7e11 merge: master 并入分支（并行十八笔——active 清理批/改名批/奇物呈现批；冲突=active 快照与记录块手工融合，469 弃用上游清档口径、收口条顺延 476） 2026-10-12 14:28:50 +08:00
DKChan 4688d09627 fix(presentation): 奇物呈现修复批——C 区/关卡页聚合行退役改逐件行「件名 ×N」+卡面摘族名（僵尸呈现整改，呈现改法=甲）+07/报告§五.5/battle.md/README/06 条收口移除+反哺点⑤销账+475 号状态记录 2026-10-12 08:04:16 +08:00
DKChan 96fc61c701 feat(tree): 迭代21天赋树实装批 T1-T6 主体——12节点换代+六键接线+营地四柜台（2026-10-12 U0） 
T1 schema 换代：MetaTreeTable FORK_GROUPS 4→3（fg_mastery 退役）/RULE_KEYS 2→6（sense/economy 四键扩签）/
  fork 单行双态（effects_a/b+name_a/b、每组恰一校验）/row 字段退役（行门槛主语=节点等级 level_gate）/
  requires 只留点亮前置（R1 裁撤案执行）；meta_tree.tres 33→12 行重排（脊柱2/锻造2含彩蛋/钥石2/同调6，
  att_socket1 改根节点无前置，easter_ley 摘 atk/armor_class 分量=契约9）
T2 购买与彩蛋面：tree_can_buy easter 拒购+行门槛换轴；tree_buy_fork=解锁默认A；tree_toggle_fork 零币切态；
  tree_rule_keys 按激活态 effects_a/b 投影；_check_easter_egg 特化判定（两线拉满+socket全解锁）；营地树行板双态钮
T3 六键接线：EVENTS+flag_missed/FACTS+battle_index（L2 扩签两处）；rebuild 六键合成订阅
  （posture 窗=battle_index&&round_index 双闸/sense 两组=counter 闸+记账双行 domain:adventure 限次2次 provisional）；
  level_runner battle_index 注入（visited battle 型计数）；_judge_flag 去重闸后 flag_missed 发射（契约12）；
  聚=_roll_gp_drop 入账前×1.5 provisional（escrow 不乘）；散=_spend_discounted ×80%（current_price/pool_price
  双计价点，刷新价不折=§11②定义边界）；_start_current_level 限次按关清零（_reset_tree_limited_counters 可测口）
T4 注入换代：hero_override=树淬炼flat+FORGE_ROUTE_BONUS预留0（命中不注入=契约6）；Attunement.slots 判定源切
  树点亮数（谓词表退役）；tree_buy(ks_refresh) 同账路由 buy_attune_refresh（V15 双入口）
T5 旧档废弃与删除：save_manager tree_struct=2 结构版本标记+_normalize 白名单重建+树域废弃重置（禁迁移折算）；
  migrate_tree/buy_forge/forge_flat/forge_level/forge_price/meta_forge_row/forge_products 行族/
  attunement_growth 表+访问器/生涯页三投影/career forge_total 全删；treasure_item_table UNLOCK_COUNTER_KEYS 内联；
  verifier_batch 花费策略换代树节点；MC slots 画像常量3
T6 营地统一：四柜台并排横滚（树淬炼主界面/锻造工坊钥匙门+零交互占位面板/秘宝匣钥匙门+内容迁入/图鉴常开）；
  暂停层锻造段连带删；camp data forge 投影删
存量红修复：_flush_pending_reveals 三处空 source_class 补 fx_reveal+类级豁免（a57489e9 落地件，冒烟51行）
测试随批：smoke 树段全重写（V1/V2/V3/V8/V9/V16）+_smoke_tree_rules V10 行为段（窗/限次/守侧五场景编排rig/聚散
  同种子对拍）+单元 tree_rules_v11_test（六键合成行闭集校验）+run_all 22 套；ui_probe/ui_click_probe 换代树点击路径
轻闸全绿：冒烟886/0+run_all 22套+probe --click 全绿
 2026-10-12 07:54:38 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍（2026-10-09 用户令） 
一、里程碑语义立规：M3=Alpha 完整实现/M4=Beta 完整实现，未明令关闭 M3 前只排 M3 需求（roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注）；迭代 20/21/22 规划冻结（roadmap 迭代 20 行注——先解决眼前问题，重启=用户直接发令）
二、文档正确性审查批三波：全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀（M-x+迭代N→迭代N，裸 M-4→Beta 阶段（未排期））/退役词退役件当现役清零/在役旧实现节加隔离横幅；重件=秘宝.md v1.7 老正文深层清算（横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正）+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份（battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map）
三、去毒批：奇物 v3.7（魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表）+秘宝 v1.6（速览旧目录退役标注/退役件示例换现役）
四、道具退役素材库新建（design/research/道具退役素材库.md，案乙已追认）：秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行；魔法提灯（fog_lantern）裁退役（06 条目已裁+秘宝.md 注记换代+素材库迁表一；拆线归实装批）
五、B2/B3/B4 裁决落文：元进度.md 道具工坊行删旧写新（v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级）；奇物.md P1「两项合成高阶项」注销（v3.9——用户定性脏信息）；§3 刷新句按最新口径换代（刷新券替代、不进持有集）
六、天赋树独立成文（B1 裁决）：新建 design/gdd/systems/跨局循环/天赋树.md v0.1（33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道）+元进度.md 定名节换代（v1.11）+02-系统清单跨局循环区加行（v1.17）
七、A 类卫生包：版本历史表理排四份（秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成，只调行序）+缺号注记三处（增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批）+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记（v0.27）+B5「现役 UI/文案两处自相冲突」登记 06 待办（battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修）
八、命名统一（用户令「任务书」全库改「需求卡片」）：167 文件约 800 处（design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注）；两文件改名（需求卡片-M4数值批/需求卡片-冒险前资源配比预设批）；残留=自造短语全量清单（黑话证据文档故意跳过）
九、CLAUDE.md：批次工作流标准清单收口段新增第 12 条「文档同步闸」（需求卡片必列关联文档同步面、合并前同步完毕方算收口，原 12/13 顺延）；呈报六问铁规适用范围补立（前序批随批落籍）
十、active.md 快照节+工作日志 414-421（并行会话 416 黑话清扫条目按共享工作日志惯例一并入库）；06 中并行会话「active.md 定性与裁剪」条目未提交，按零吞并纪律留在工作区未入库

零测试（文档批两入口铁规）；主区前序脏件（.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等）未带
 2026-10-09 19:12:46 +08:00
DKChan 8374c9caf1 修复: 卡④T4——账务落文：改道指路句实查 6 处全换代零旧口径残留（①board_view.gd:139 常量注释②:145 setter 注释=载体 fog_lantern 落籍+呈现桥实名指路③art-bible.md:387 预留不接→已接落籍+常量拟名 LIGHT_RADIUS_LANTERN_BONUS 顺手对齐落码实名 FOG_LANTERN_BONUS④HUD框架.md:168 配套拍板段改道注记⑤:170 实施状态段 2 处整段换代+卡④落籍注记+LIGHT_RADIUS_LANTERN_BONUS 同口径对齐；残留 Alpha 信息件字样三处均=销账声明/改道留痕叙事非活性指路，qa 历史成文零触碰）；06-待办清单 菜单开局同调传参缺陷条回写落籍态（卡⓪ merge 9160942+build_adventure_params 修复面+resume tree_rules 受理缺口披露）；秘宝.md 目录九件→十件（魔法提灯入册+被动六→七）+速览实现面文件名顺手订正 aux_items.tres→treasure_items.tres+投放态注记十件口径+v1.1 版本行；roadmap 迭代 19 行卡④段落籍登记（T1-T5 全记录+出口报告指路） 2026-10-08 17:02:51 +08:00
DKChan fd6c208b2e 修复: 卡④T2——提灯视野呈现桥接线（生产路径贯通=完成度 0→1）：①battle_orchestrator.gd 装配集公共只读访问器 attune_has(item_id)（_attune_has 契约化出口，save v6 只读访问器先例；private 面零改动）②main.gd 呈现桥 _sync_fog_lantern——settlement.attune_has(fog_lantern) 真值显式写给 board_view.set_fog_lantern（写入即 refresh 全板重算）；挂点=_on_round_started ri==1 每战首轮装配链显式重算含否〔🔴 契约 7 Q8.1 复原语义=禁战斗结束隐式复原；时序依据：round_started 首轮发射位在 begin_battle 尾 attunement 注入后——board_changed 在 _install_new_board 内先发装配集后注入，同帧直挂 _on_board_changed 会读到上一战旧集，故不挂〕；未装配=false 写 0=缺省零扰动基线逐位不变；冒烟 840/0 回归零破 2026-10-08 17:01:49 +08:00
DKChan 768e3665df 修复: 尾裁微批b——卡⓪resume tree_rules受理闭环（2026-10-08 用户裁甲：resume_adventure 参数面按 start_adventure :135 同式补收 tree_rules〔类型防御同款 is Array 三元〕，消费面 :938 set_tree_rules 下传现成零改；main.gd build_adventure_params「tree_rules 暂不消费」在册披露句同步退役改写；冒烟断言段追加续玩受理两查——resume_adventure 受理三键参数面+runner._tree_rules 与传入一致〔v2 旧断点夹具同式最小断点〕）——冒烟 840→842/0、run_all 17套全绿、probe_gate --click 全绿 2026-10-08 16:36:07 +08:00
DKChan 5891b5b314 修复: 尾裁微批a——对比度存量违例7项全修（2026-10-08 用户裁甲：GP账行/树分组头/工坊已解锁 GOLD_DEEP→GOLD_INK、货架价签 GOLD→GOLD_INK〔三选一价签恒空串隐藏零波及〕、行卡名显式传 WARM_SOFT 替 bold 缺省 INK_LABEL、铭牌副题/行价格/行进度 STONE→STONE_DEEP；只换文字墨零布局零文案，边框等非文字共用位甄别不动；测点表7对随代码同步改指新常量）——probe_gate 默认段全绿 ui_contrast 15→38对存量红清零（2.67/1.12/1.46/3.59/4.02/2.67/3.00→5.21/9.53/5.21/5.98/6.70/5.21/5.84） 2026-10-08 16:30:11 +08:00
DKChan 1d2894b555 修复: 卡⓪①②——主菜单开新/续玩两入口补传同调三键（build_adventure_params 统一构造，取值与营地投影同源）+关卡开场行改传 runner.effective_* 当前生效值、含面板加成后缀改认局外加成 2026-10-08 05:03:59 +08:00