game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,472 Commits 23 Branches 0 Tags
c5a433b1d3c3147aa326c0fcdf91abbb64cdb57b
Commit Graph
86 Commits
Author SHA1 Message Date
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 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 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 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 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 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 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 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 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 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 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 df666ddf30 feat(迭代23-T1): 锻造工坊配置表落位——ForgeTable 新表（默认两轴常驻持有+六路线行族）+ConfigDB 访问器+V1/V11 单测 41 断言 
- 新表 forge.tres（schema forge_table.gd）：default_attack_type/armor_type 默认值（契约 2 所有权移交——hero.tres 两轴随后批删除）+routes 六行（sword/spear/staff/light/heavy/ward）
- provisional 沿需求卡片 T1 锚表：cap 5/每级增量 +1/基础价 20×150%^n（20/30/45/67/101）/解锁价 200/甲型基础 AC 10-12-9/初始持有 sword+light/并联双通道前置 spear·staff←sword、heavy·ward←light
- schema validate 22 类正反（行 id 唯一/类型轴分族枚举/恰六行/初始持有恰一武器一甲/默认轴=初始路线类型轴/前置类型相符…）
- ConfigDB：TABLE_MANIFEST 登 forge+类型化持用+forge_route/forge_routes/forge_default_*/forge_weapon_route_by_type/forge_armor_route_by_type 访问器
- 新单测 forge_table_test 41 断言（V1 生产面+22 类负向/V11 行字段闭集+效果类型词表 31 钉现/V2 价格梯）；run_all 22→23 套
- 事实订正（L2）：卡片 F11「效果类型闭集 24」系 2026-10-07 旧快照——现行 31（iter20 +7/iter22 +1），本批零扩签钉 31
- 轻闸：冒烟 898/0 零扰动
 2026-10-12 23:23:16 +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 31a8d2b19d test(迭代21收口补强): tree_rules_v11_test 六键覆盖缺口修复——宣称六键实只验四键（聚散两键空夹具静默跳过=假绿），判据换 rebuild 实装面行数对照：四键逐键对夹具行数（rebuild 分支被删/漂移转红）+聚散两键断零行（将来加合成行即转红提示复核效果闭集），行数对上才进原 validate_trigger_row 闭集校验；头部注释+green 打印文案换代（消费点=battle_orchestrator._roll_gp_drop / level_runner._spend_discounted 成员判定不入事件面）。纯测试零产品代码；故障注入两例验证断言咬合（夹具键摘除→红／economy 假行→红）；run_all 22 套全绿+冒烟 898/0 2026-10-12 20:53:43 +08:00
DKChan 9f20ca236a T6(迭代22秘宝批): 验收闸断言——V9静态词表(新12行do.kind/effect_kinds零棋盘改写类词)+V10覆盖检查(三方向dimension_tags投影)+V18装配面空目录合法态(白板档12件全未解锁mode分派,独立档[12])+V6装配不可变运行断言(单测⑭战斗运行态与冒险装配集三面同源快照)。冒烟898/0+单测全绿〔秘宝批 V6/V9/V10/V18〕 2026-10-12 19:36:31 +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 c813b2b042 T3(迭代22秘宝批): 效果引擎接入与常时参数面——board_installed事件发射(巢穴预告读数口nest_preview_count=装板报危险格数量,呈现归呈现桥); 天眼safe_dig=fx_reveal通道复用(C5全额兑付免AP连锁资源同链,危险格仅真视,旗格跳过); reveal_tiles入真视叠加层(mine_reveal同通道); 试炼镐use_attune_convert积点受理口(charges=0零骑库存,counter_spend受理闸+grant_ap,积点计数通用化=装配集ap_charge_safe行扫描替dig_charge硬编码); 充能重置周期_reseed_attune_charges(battle每战/level每关首战battle_index==1,骑库存差额补注); 常时参数面注入(远程镐dig_range_bonus切比雪夫≤1+1/信标网络flag_range_free旗可达豁免——_within_dig_range拆谓词,mine_total只读口); 储备罐finish_round_stop转存率入参(125%=1.25:1整除floor); 刷新练习refresh_stock_grant开局一次性加仓; 刷新执照shop_refresh_free_left装配叠加; 真视使用计数链(vision_counter共享dict→受理+1→summary→settle聚合入档+断点随件); validate_use扩cell档与新空间kind; 修现役潜伏缺陷=use_treasure板维度读Rules不存在的width(旧目录期零直呼掩盖); 新单测treasure_effects_test 22套(V7附属表12件逐件正常/边界/反例+计数链)。冒烟895/0+run_all 22套+探针全绿〔秘宝批 V7/V8/V10/V13〕 2026-10-12 17:01:12 +08:00
DKChan 48b0696158 T1(迭代22秘宝批): 新目录12行全量换代+schema扩签——treasure_items.tres 旧12行删除新12行落表(晨操令/阔视野带/试炼镐/刷新练习/储备罐/巢穴预告/线香/双管装填/远程镐/刷新执照/天眼/信标网络; 三档7/3/2; 契约8逐件解锁分配=钥石8+条件4); schema扩 tier/charge_reset/unlock_keystone_cost 三键+TIERS/CHARGE_RESETS 词表+TARGETS扩cell+参数面kind六型+REVEAL_KINDS护栏扩面+charges=0积点制合法态+解锁互斥校验+UNLOCK_COUNTER_KEYS换代(adventure_cleared对齐C6通关口径/vision_used新增); 引擎EVENTS+board_installed/ACTIVE_KINDS+safe_dig/EFFECT_KINDS+mine_count_preview; V13旧断言摘除换代(fog_lantern_wiring_test全文件退役+run_all注册摘除/violation护栏主语换sky_eye/feat_vouchers电池主语换incense_stick/smoke提灯段换V1V2新目录断言段+装配充能刷新段换主语)。冒烟887/0+单元21套+探针全绿〔秘宝批 V1/V2/V12/V13/V14部分〕 2026-10-12 15:21:22 +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 95b9241a0c docs(active): 迭代20 收口快照换代+状态记录 463（T0-T10 全落 merge 34c1564/批末闸全绿/追认单十条+反哺点五条+目检五件待人闸）+三套新测试 .uid 件补齐 2026-10-12 00:55:15 +08:00
DKChan 3333187351 feat(close): 迭代20 T5+T8+T9+T10 C段收尾（专长实装批） 
T5 Boss 兑付面换代：通关渠道三选一改按档配比加权抽取（无放回加权抽 boss_feat_weight
100/45/15/5 provisional 归调参批——奇物.md v3.1 rarity 语义约束兑付面）；信号注释换代
「提升三选一」→「专长三选一」（V11 正名）；V12 频带断言（300 停点档位频率出带±15pp）。

T8 MC 对账适配：formed 画像 14 旧件→五事件族 14 新件（开格 4/插旗 3/踩雷 4/节奏 2/战斗 1）；
新基线取证：normal/off 100 局 71000 档 通关 0%（master 对照同为 0%=零配基线本相），
止步分布 90/10→93/7 可归因曝光槽候选构成；同种子重放 30 局逐位复现 ✓（V15）。

T9 迁出收尾：treasure_items 删 venom_edge/flag_burst 两行（同调目录收窄）；schema 词面
venom_rider/flag_burst 摘除（EFFECT_KINDS/MAGNITUDE_KINDS）；rewrite_board 效果类型除名
（净化工兵退役——V14 连带清理闭环）；V13 断言入 smoke。

T10 空配置验收闸：三选一池空 skip_empty_curio 消化+非空拒绝反例+商店空货架合法态断言。

测试：pool_case_d 17 checks（+V12/T10）/feat_vouchers 23 checks（+V16 断点往返）；
冒烟 864/0+run_all 21 套全绿。
 2026-10-12 00:28:22 +08:00
DKChan 5ebd05d4b4 test(fx): 迭代20 V4 验收断言补齐——跨事件计数累积/counter_spend 消耗/reset_at 声明制两态（effect_words_t1 17 checks） 2026-10-12 00:09:32 +08:00
DKChan 1387aedc94 feat(vouchers): 迭代20 T4 凭证件五件实装+F-1 刷新写错账修复（专长实装批 B段二） 
五件路由（_apply_curio_pick 通道面）：刷新券→刷新存量账 _refresh_stock（**F-1 修复**：
退役 _attune_refresh_x 写口——X 每停点重置吞存量=写错账缺陷正主；消耗序 X→Y→存量，
attune_refresh_left 扩第三源；旧早退路径零摘牌缺陷同批修正=选中即消尽）/储备金袋→
_pending_rap 战首 RAP 注入（action_economy.grant_reserve_ap 新口）/同调电池→
_battery_pending+choose_battery_target 玩家点选跨层写 attune_charges（禁自动替选——
装配集/主动充能件双校验拒绝）/时沙→_time_sand_queue 战首首轮 AP 队列（池增量不改上限，
hero_ap_bonus 同通道）/完美保险→_pending_insurance 战首豁免次数（flag_miss 首见判定
_perfect_hit_false 回退=完美谓词无痕，节点级未用即过期）。

注入链：runner set_voucher_grants 三账→enc voucher_*→编排器消费，节点级一次性注入即清零。
配额投放：凭证四件入稀有档（rap 2/battery 1/时沙 2/保险 1）→结构锚 rare 9/总量 104
（已裁换代授权内 provisional——偏离 GDD 占位记录随代拍板追认单）。
断点扩列（T7 前置）：refresh_stock/battery_pending 随档+resume 回填（旧档缺键缺省 0）。

测试：feat_vouchers_test 新套 20 checks（V9 逐件路由+F-1 反例钉面/V10 留任路由+AP 属性轴）
入 run_all 21 套全绿；冒烟 863/0；smoke 牌库数 98→104 系换代。
 2026-10-12 00:08:00 +08:00
DKChan 0640b0c06d feat(pool): 迭代20 T2 池结构案D 换代（专长实装批 A段二） 
四级档位：TIERS common/excellent/rare/legendary（跨层框架档名映射承袭）——TIER_QUOTAS
70/25/3/0=98 直映射零偏离已裁结构锚（传说=头奖位留空）；配额/件值字段物理改名
（旧 rare→excellent、旧 rarest→rare）+凭证四 kind 占位（rap/attune_battery/time_sand/
perfect_insurance，配额暂 0=T4 落路由同批投放）。

概率与上限解耦（案②令牌池+提前退役）：curio_cap_* 每 kind 独立字段（99=无上限占位，
实数归调参批）+专长 cap 行字段面；taken 身份维计数（relic:<feat_id>）拿了才计刷出不计；
cap 满在候选视图剔除（牌库本体不动=概率位独立存活）；断点 bonus_taken 身份维键随档还原。

曝光槽：三选一=2 格全池+1 格优秀档以上子池（子池独立洗牌同 stream 续消费；子池空回退
全池；池空直通同族兜底）；凭证（feat_ticket）不进抽签池只经保底注入；商店货架同 cap 过滤。

潜伏缺陷修正：效果引擎 has 算子 null 安全（敌技伤害载荷无 terrain_kind 事实回落 null 时
判「不在场」而非 String(null) 抛错——候选流变化后 devour 件首次被持有而暴露）。

测试：pool_case_d_test 新套（V6 令牌三态/V7 曝光槽回退/V8 解耦提前退役）入 run_all 20 套；
smoke 三档锚/数值对/池构成/上限带四处断言换代（V14），冒烟 848/0+probe_gate --click 全绿。
 2026-10-11 23:18:35 +08:00
DKChan a57489e970 feat(fx): 迭代20 T1 效果引擎词表扩签+发射点施加面（专长实装批 A段一） 
词表：EVENTS 16→18（+dig_stop/battle_won）、FACTS 9→17（8 新事实含 hp_ratio 生命比例前置兑付）、
EFFECT_KINDS +7 新类型（heal/ac_bonus/damage_reduce/bonus_delta/blast_scaled/preview_area/
target_attack_bonus）、OPS +mod_eq；DO_KEYS +4 键（value_event/value_counter/domain/axis）。
rewrite_board 暂留至 T3 删行同批除名（purge_sapper 仍在表），消费分支已摘除。

施加面：battle_orchestrator（dig_reveal 三事实/mine_hit 五新施加/terrain 减伤前置/flag_hit 四新/
round_end GP+AP 队列/battle_won 发射/bonus_delta 战末汇入/ac_bonus 累积器/揭示队列_.flush_pending_reveals）
+damage_controller（attack value_counter rider/敌技 damage_reduce/hp_ratio fact/kill 揭示回调）
+action_economy（dig_paid 返还/dig_stop 发射/上轮耗尽旗标）+minesweeper fx_reveal 效果通道
（只揭真格信息红线）+rng fx_reveal 分签。

T6 承载：EffectEngine adventure 域计数器（domain 键/counters_export/counters_seed）+
AdventureRunner.adventure_counters 共享引用（attune_charges 先例）+断点随档。

测试：effect_words_t1_test 新套（V1：新词在册/出域四路被拒/seed-export 往返/mod_eq 预评估口径）
入 run_all 19 套全绿；冒烟 846/0 持平基线零破坏。
 2026-10-11 22:42:51 +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 62d2f76ffa 修复: 卡①T6——熵增闸图像白名单收编 game/tests/golden/（本卡 T2 落库 golden 基线三张系机检测试资产非美术素材，T1 落库时漏改白名单致熵增闸红——同批修订 commit 留痕=CLAUDE.md 结构审计闸既有规则；修后复跑 golden 三张出违例清单）+tests/README 运行时口径数订正（分支基点实测 840 项 0 失败——此前误写 846 系 master 合并卡②④后口径，T0 基线复读与本批批末实跑均为 840/0）。批末闸实证：run_smoke 840 项 0 失败三闸过 EXIT=0/run_all 17 套全绿 EXIT=0/doc_link_audit 绿/doc_term_audit 绿 2026-10-08 19:21:23 +08:00
DKChan aa3c89566c 修复: 卡①T4账务——tests/README.md 漂移订正：套件数十五→18（第 18 套=卡④提灯载体批 unit/core/fog_lantern_wiring_test 注名——本分支基点早于卡④合并实测 17 套全绿，合并后 18）+断言数「752+」改双口径说明（运行时=run_smoke 打印通过项数〔卡①基线 846 项 0 失败〕/静态=smoke 源码 check( 调用点计数 764 处——循环内断言按执行次数计，两口径数值不同且各自浮动，禁互相换算或写死）+「十场景探针」陈旧计数句去数化。integration 空壳目录删除（Q8 代拍板白名单——仅有章程 README 无实体），章程句并入 tests/README（将来跨系统测试落地随批建目录迁入），Story Type 表 Integration 行同步改指 2026-10-08 19:21:09 +08:00
DKChan a7861aec5a 修复: 卡①S2 观察项根因修复——board_shot_probe 抓帧时序改时间制等入场涟漪完结+golden 三张基线换代。基线换代触发原因（强制记载）：非视觉回归非素材换代——render_gate 清障后首跑 golden L2_underdark changed=2.53% 越限（基线入库时首对比 0.00%），停机诊断实证=波动性越限（L2 四跑 0.00/2.53/2.29/1.17%、L3 0.89/1.78/1.59%、L1 恒 0.00%）：board_view rebuild 入场动画（全板淡入 motion(0.2)+R0 涟漪 motion(0.04×距离)+motion(0.12)，最远格 ≈0.56s）未完时抓帧，原制 6 个 process_frame 热机后 ≈0.1s 恒捕在中途态、逐跑帧时序抖动使揭示 alpha 漂移；基线生成跑恰逢冷机慢帧捕到完结态故入库时全过。修复=抓帧前 create_timer(1.2)s（2×余量）锚定动画完结态（探针侧零运行时 diff）；换代后三连跑稳定性实证全 0.00%/0.00%/0.00%；render_gate 修复后全绿（EXIT=0）；容差 2%/16 用户冻结口径未动（S2 呈报在案）；素材齐盘守卫走 golden_baseline_refresh.sh（S3/Q5/Q2 口径全随） 2026-10-08 19:20:54 +08:00
DKChan 91c9ec69bf 修复: 卡①T2——棋盘 golden 三张基线入库 game/tests/golden/（L1_dungeon/L2_underdark/L3_deep_underdark，900x760 棋盘区裁剪帧）。基线换代触发原因（强制记载）：首次建基——迭代 15③ 挂账五闸归宿落地，素材齐盘态（字体/瓦片/英雄/旗纹理全在盘实测）2026-10-08 窗口化抓帧生成，非回退态；容差 provisional 差≤16/changed≤2%（S2 口径），首对比实测 0.00%/0.00%/0.89% 全过 2026-10-08 19:19:27 +08:00
DKChan 510cdab506 修复: 卡④T3——测试三形态落位（契约 9）：①probe=ui_input_probe case⑮ 内载体级段不开新 case——装配 fog_lantern→开局参数面（build_adventure_params=卡⓪①修复面回归）+settlement.attunement 注入→呈现桥 _sync_fog_lantern→lantern=2 且 dist==R+1 格转可见+卸装显式重算复原 0；case⑮ 既有断言零删减（实查 17 断言面原样）②smoke=现有套件 _smoke_adventure_table 加断言不新开套件——行字段逐键裁值+同调目录投影 display_name（九件→十件）+装配→战斗贯通 enc 注入→attune_has=true+空装配基线 false③存档回归=breakpoint_resume_test 新增 Part 6——装配(params.attunement)→停点→续玩受理→回局首战 attune_has 仍 true④呈现桥判定 stub 单测+行加载单测=新件 fog_lantern_wiring_test.gd（run_all manifest 17→18 套）。闸：冒烟 840→844/0+ui_input_probe PASS+breakpoint PASS+新套件 PASS 2026-10-08 17:01:55 +08:00
DKChan c583940400 T4组D·断言与探针换代(敌人表行集多行批): smoke_all expect_pools断言换(L,D,enemy_id)三元键逐行精确比对[十九行九种池模板文案随F7换代]；L2/L3定点行集断言改行集构成口径({敌种集}恰一行集+首行甲型)；双表精确行契约断言改精确行集口径(294-311主段+3518/3555两复述段)；新增混编运行面正反断言六条(注入(1,5)/(1,6)避开全部扫描面·断言后还原零污染)：混编spawn受理正向+各行数量求和+生成序=文件行序+各行行值独立投影+总数守卫>4拒绝fail-fast+表还原19行复核；config_db_test新增行集纪律套五条(EnemyTable资源直构validate正反：混编相邻合法+Boss坐标混编合法P4乙+同坐标行隔断rowset_rule定位到坐标R6+同敌种第二行dup_key拦+单行数量域[1,3]不回归)；skill_rhythm_probe/damage_probe取数面T2已适配本轮直跑验证(rhythm正常输出；damage 7项1失败=A1攻击链健康·stash对照实证基线既有与本批零相关·探针非闸门工具如实登记)；L2记录=池模板键值换代连续3轮红(坐标敌种映射臆断错4键+3_7池值手抄错·第4轮以离线tres对账法收敛)——教训=三元键换代先离线全量对账再落码；断言数805→811净增6随批追认；轻闸=冒烟811/0三闸全过+run_all 17套全绿 2026-10-07 02:36:23 +08:00
DKChan 8690230573 T2组B·schema与解析换代(敌人表行集多行批——P1甲/P2甲落码): enemy_table.gd 恰一敌种校验退役改行集构成纪律②行序相邻校验(同坐标行不相邻即rowset_rule报错,类别沿用定位面不变;同敌种第二行仍dup_key拦)+UNIT_COUNT_MAX语义注释改单种数(单行域[1,3]不变,行集总数≤4归spawn守卫·骰后值加载期不可判)+floor版resolve_rowset退役(双算法销号,工作日志312)；config_db_resolver.gd resolve_enemy_rowset改返回行集数组Array[Dictionary](ceil命中坐标全部行,文件序=契约序,空集=空数组;_resolve_progress加return_all参数board_gen单行通道不动)；config_db.gd门面签名同步；全仓消费点机械适配取首行(T2行为零变化:spawn/orchestrator/narrator/smoke七处/config_db_test/skill_rhythm_probe/damage_probe两处;floor四调用点迁ceil坐标全精确命中零行为差)；轻闸=冒烟805/0三闸全过+run_all 17套全绿——零内容期断言逐位零漂移 2026-10-07 02:05:30 +08:00
DKChan 12807298eb feat: 三选一刷新对齐商店（2026-10-06 用户令）——免费双源 X/Y 用尽后 GP 付费档（同 shop_refresh_* 旋钮/同冒险钱包 spend_gp 单口/同 reward_pick 池重抽），付费刷计数每停点清零；CurioPickOverlay.set_refresh_display 与商店同构（钮常驻选择态/两源皆穷禁用/角标免费余量/价签行 GP 价）；通关停点刷新重发带 refreshed 标直落选择面不再重开胜利总结；店内门票专长三选一维持无刷新；单测 curio_refresh_paid_test+覆盖层刷新面断言；落文=秘宝.md 双源节 GP 付费档+冒险结构 v0.16+06 商店刷新条目换代（机制已落码态） 2026-10-06 07:03:57 +08:00