game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,553 Commits 23 Branches 0 Tags
bbd49abfb012102cb288fa4031fee6ed83d78da2
Commit Graph
34 Commits
Author SHA1 Message Date
DKChan 80ac80ef1a test(断言三件): 未开格类型微光机检面（迭代 30 卡① T2-①②③）——①冒烟 smoke_all.gd 新增 _smoke_type_glow 八相 24 项（相0 作用集恒等＋默认开＋已开/r0 零微光／相1 八邻派八型五组逐格映射／相2 清单外"keystone"显式登记＋零微光／相3 封锁格零微光零登记／相4 解封复位／相5 off/on 两态＋关前快照逐位复现＋零玩法写入三面／相6 换图 rebuild 重算／相7 契约 1 同板同序列 on/off 双实例结算逐位一致 12 步 digest 对照）；夹具 = seed 4242 L1 板＋novice 驱动（初始展开覆盖 8 邻故必驱动）＋八邻派型＋哈希兜底九型全集；冒烟 1127→1151 项。②单测 type_glow_test.gd 五段 51 检查（归组封闭含清单外 6 负样本＋两带并存锚定／冻结色相面 HSV 稽核 ΔH≤0.2°·ΔS≤0.01＋群伤 V=0.65 专项／呈现参数锚定 α170·band 0.125·组号域 0-5／伽马合成空间阶梯单调＋相邻组模型 CR≥1.20／probe API 形状），登记 run_all.gd（33→34 套件）；extends SceneTree＋Kit/UiKitScript preload（--script 模式禁 class_name 裸引用）。③ui_input_probe case⑰ 活板面走查（生产身份面：作用集==diggable 键集／真实点击挖开即灭／移动复亮出圈灭／相位门控两态／开关两态零扰动），十八断言全绿。批末变异验证五组反例实证：M1 归组错映（单测+冒烟红）／M2 清单外静默（冒烟红）／M3 相位切换不重算（冒烟+探针红）／M4 α=0 不绘（渲染闸红）／M5 派生路径误触玩法 API（冒烟相7 分叉红）——红输出与还原结论实录见 reports/iter30-实现报告-2026-10-17.md §四。 2026-10-17 10:18:35 +08:00
DKChan 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 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 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 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 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 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 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 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 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 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 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 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
DKChan a9a2e25a0a merge master(d3fa887 技能池④+⑤提灯)入分支：07清单⑭双登冲突解（技能池⑭保留+秘宝目检改⑮）；四文件auto-merge带旧词族零带入（全查仅存档键合法例外） 2026-10-05 15:47:33 +08:00
DKChan 97b8589a4c 技能池执行批T0-T6+⑤提灯（迭代14④+⑤）：T0表盘点零漂移（19行池+9技能行+Boss三行对照报告§2）；T1敌人系统.md v0.13五件（池构成表8敌种/护甲列读表口径/三代错峰/半血解锁弹出规格）；T2 skills有效倍率表批注（D4整数基线半点矩阵）+enemy EV锚整数口径重登记+巨蜘蛛1.11消歧+registry enemy/skill换代；T3-T4机制件=unlock_hp_pct可选键（schema域校验缺省无=无门槛）+容器check_skill_unlocks单向闩（零随机）+rollable/special双面过滤（保底不逼锁定）+编排归因行「XX解锁了YY」（type=highlight高光键skill_unlock零行型新增）+row_pacer一次性技能名toast（排除perfect_sweep误触）；T5三Boss解锁技落表（震地怒击×2.5/CD4·遏毒×2.0/CD3·岩崩×2.5/CD4案甲provisional+池尾weight2/unlock50）+断言基线换代3处（技能表12行/池模板/酋长EV锚重锚1.10-1.30实测1.1948）；T6单测skill_unlock_test22断言（run_all注册15套）+smoke+5集成（半血→次轮解锁行恰一次/文本/行型零新增）；⑤提灯+2接线=board_view.set_fog_lantern公共面+case⑮接线断言+HUD框架注记（载体道具归信息件批=接缝就绪态）；T7读数后置挂07；闸=冒烟772/0+run_all15套+探针绿+doc三闸零新增；出口报告design/qa/m4iter14-skillpool-exit-report-2026-10-05.md 2026-10-05 09:26:25 +08:00
DKChan f8c6db49c6 秘宝批T6组E-1：三测试文件改名（treasure_items/treasure_target_violation/reward_dangling_treasure）+run_all登记+test_kit注释同步（run_all 14/15对照主区基线零新增，唯一红reward_overlay系②批遗留） 2026-10-05 08:36:21 +08:00
DKChan b4b8bb37e0 秘宝批T1组A+D：玩家可见文案5处+注释层「魔法道具」→「秘宝」全清（敌方语汇/道具工坊分色保全，冒烟755/0） 2026-10-05 08:27:04 +08:00
DKChan 4918bf3c67 iter8-T9 卡⑨ 断言批：pacing_queue_test 第 15 套入 run_all manifest（卡⑦ AC⑤ 逻辑先行断言=排空前后核心诊断快照逐位一致〔演出关停零分叉〕+零丢行结构判据〔排空后队列恒空+末信号行原文在带〕+段间延迟双态〔pace_delay_for 常态>0/减动效=0〕）；断点往返/续玩幂等/退出清断点=T1 第 14 套、无断点按钮隐藏/结算框呈现=T2/T5 click 探针段、节奏双态=T6 fx_probe ④b——卡⑨清单六件全数在册；坑册：多行 lambda sort 静默失效（普通循环替代）+轮末才 emit step_row 行族（stop 触发）——闸：run_all 15 套全绿 2026-09-29 20:40:02 +08:00
DKChan 04ef6a54ee iter8-T1 卡① run 快照序列化：断点域七字段+附随件入 save.json（schema v1→v2 生产迁移）+rng restore_adventure 号位回填+停点快照挂 choices_presented 转发+三结局清断点+续玩确定性单测（同种子同板逐位）入 run_all 第 14 套+冒烟断点段 16 断言（577→593）+存档序列化 v1.2/冒险结构 v0.11/registry 同批——代拍板：附随件超七字段面（恢复必需，追认清单呈报） 2026-09-29 17:57:28 +08:00
DKChan dbc6908bf6 test(t5-hotfix): 奖励节点 UI 直验套件转正——池空直通/全列呈现/强制选择/item_chosen 外发四断言（探针盲区补漏，run_all manifest+1）；hotfix 后冒烟 577/0+直验 PASS 2026-09-29 15:12:36 +08:00
DKChan dd5ed4a753 test(t7): AuxItems 类单测——结构冻结断言面十二断言全过 
①新套件 tests/unit/core/aux_items_test.gd（run_all manifest+1,expect 0）:授予归因/句柄受理序/Used 不可逆二次 consume 拒/真视恒可用/预读点击级零信息拒绝不消耗/3x3 边缘窗口∩板(角 4 格)/越板拒/叠加层两集/换图三清(retire 不动库存)/关卡末 reset/零随机重放两遍投影逐位
②桩表模式:StubDB/StubTable 内联类喂行定义(产品码零测试分支——C1 零特判守住);修三元语句取 void 返回值解析错
闸:aux_items_test PASS;run_all 12 套全过
 2026-09-29 07:52:04 +08:00
DKChan 63a08d1e01 feat(t1-t3): 魔法道具数据面+库存管线+授予路由生命周期（三卡一轮交付——文件交叉合并提交） 
T1 数据面:AuxItemTable schema(七字段+retired/deferred 两 additive 标记+真视窄域/board_wide 双承重护栏)+六行 tres(三有效+罗盘 retired 留痕+显影尘/全图卷 deferred)+ConfigDB 加载/访问器+RewardTable 十型扩值(aux_item)+三投放行 5/4/1+aux_none 负占位行(雷格极性字典兜底零兑付)+双表悬空校验(reward_dangling_aux,负占位豁免)+F2 投放维度覆盖(豁免面 plan/info/counter 登记)+两 fatal 夹具(expect=1 复制真表注入违规)+run_all manifest+2
T2 core 骨架:AuxItems 类(api 8 入口+probe 探针;零随机零特判;Used 不可逆;真视恒可用/预读点击级零信息拒绝;3x3 边缘窗口∩板)+action_economy.grant_ap 第 9 API(当轮加量,区别 queue_ap_delta 排队)
T3 授予路由+生命周期:_grant_routed aux 分支(正=入库存发「获得」行;负=零兑付 effect 型「道具随雷沉没」行)+use_aux 四步受理(相位 gate→validate→逐 kind 空间先 AP 后→consume;结算明细无道具行)+叠加层三清(装板点/战斗结束)+LevelRunner 关卡域库存持有注入+关卡末 reset+aux_cleared 快照计数扩签
冒烟锚随词表扩值更新:九型→十型封闭/字典 18→22 行;负向字典扫描三处稳健化(aux 不入五型轴+break 改 percent_map 三型齐备+rng 每板新实例——原第一板 break 掩盖 set_master_seed _counter 守卫违例)
闸:冒烟 577/0(净增 1)+单测 11 套全过(含两新夹具)+四探针 PASS
 2026-09-29 07:07:38 +08:00
DKChan f2642a87a6 feat(art): T6 underdark/deep_underdark 瓦片换色——程序换色产 L2/L3 两套入包+机检(台账164 换色遗留清偿) 
- tools/recolor_terrain_tiles.py: 槽位家族保持重映射(源唯一色→最近 dungeon 锚定家族→家族内亮度秩序线性映射目标色表);目标锚=归档生成器 PALETTES(圣经 §4.3 三关方向,三关换色证明条在案);确定性零随机;源=盘上 v9.3 定稿 21 枚(活件未动)
- 产物: game/assets/art/board/terrain_*_underdark|deep_underdark.png 各 21 枚(素材不入 git 与 dungeon 套一致,.import 编辑器刷)
- BoardView: 瓦片路径按 board_type 后缀参数化(词表名单单点 TILE_WALL_NAMES);rebuild 按板图型切换(_tiles_board_type 守卫零重载);套缺位→整批回落 dungeon(禁同板混渲染),dungeon 亦缺位→程序化平色原回退
- 机检: terrain_tile_sets_test 入 manifest(第 9 套件)——词表 3 型×套完整性(16 墙+5 地面)+墙顶色相域抽检(dungeon 0.089/underdark 0.625/deep 0.639 各落圣经方向带)+图底分离×3+deep 更暗方向;素材工作区缺位=SKIP 不红(不入 git 纪律)
- 轻闸: 冒烟 557/0+ui_input_probe(缺位回退断言保持)+ui_click_probe+9 套件全绿
 2026-09-28 03:42:15 +08:00
DKChan a0ed48fa88 feat(ui): T3 CJK 字体随包落码——Fusion Pixel OFL zh_hans 入包接线（2026-09-27 用户拍板） 
- 资产: game/assets/fonts/ui_font_fusion_pixel_zh_hans.ttf + OFL-fusion-pixel.txt 授权随包(授权干净定案);命名遵 art-bible §8.3 snake_case 域前缀
- project.godot gui/theme/custom_font=全 Control 默认主题字体单点
- SubViewport 两世界不继承 Control 主题: ui_assembler 装配点经 UiKit.load_font 守卫装载注入 set_world_font(C6 挂点链首次接线,缺位=null 回退引擎字体不炸)
- 单元断言: tests/unit/presentation/ui_font_asset_test.gd(装载非空/中文字形 has_char/采样宽度>0)入 run_all manifest(8 套件)
- 轻闸: 冒烟 557/0+ui_probe(hp='攻击 2 ' 中文渲染断言不减)+ui_input_probe+ui_click_probe 全绿
 2026-09-28 03:13:54 +08:00
DKChan 5f51a916d4 test(unit): T1 单元测试与契约层——七套件实跑入口落 tests/run_all.gd 
- data_config: ConfigDB 表加载+跨表护栏零诊断/进度坐标 ceil-clamp 解析与警告去重/变异池门控/shop·meta 消费面/manifest↔目录同步/越域 fatal 退出码(独立进程 expect=1,deferred 触发保 quit 通道)/统一随机流(派生确定性/计数器账本/标签不参与派生/负种子归一化)
- battle_settlement: DamageMath 四纯函数(池乘区/克制分量/掷点查档/吃掷点分量)+DamageController 伤害单据五配方+B/A 双结账模式+来源敌死作废+requires 前置门+主角倒下 halt+AC 合流三通道+池 clamp 与 refresh 政策
- contracts: 五配方/三目标/双政策词表封闭+掷点标签∈RNG 封闭词表(EC12)+单据九栏缺省+增益布尔受理口径(EC1/EC2)
- 红线: 期望值全由表读值推导(零玩法数值字面量)/零自建 RNG(夹具种子仅求复现)
- 轻闸: 冒烟 557/0 + ui_input_probe 十一断言全绿(基线零漂移)
 2026-09-28 02:52:19 +08:00
DKChan 7f24b640ea refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链 2026-09-27 04:56:27 +08:00