game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
1,930 Commits 23 Branches 0 Tags
5499eb9ca02ca95786b846871ca48fa9f9851264
Commit Graph
151 Commits
Author SHA1 Message Date
DKChan 678ad791da merge(同步 master): 迭代 35 卡② 分支合入 master 现态（12 笔他批改动，含 game/ 呈现层与测试工具手册批）——按 process-conventions §1「master 若被别批推进，先在分支里 merge master 解冲突、重跑本域闸再合回」执行 2026-10-24 23:08:08 +08:00
DKChan 78924fddbd style(迭代35卡②T3): 静态扫描 S9 类型闸归零——R1 无类型容器三处参数化（level_runner 参数档/生成图持有变量、level_table validate_graph 逐节点变量改 Dictionary[Variant, Variant]）；产品码类型闸与 node_map_templates 宿主同跑复验绿 2026-10-24 19:11:22 +08:00
DKChan 9ee3bea194 refactor(迭代35卡②T2·二口＋T3 S1/S2/S6/S8): 消费侧切源落定＋断言面换代主体——① level_runner 图源换代（_generator 取代模板解析，_assign_generated_graph 读 level_gen_params 参数档产图并过 LevelTable.validate_graph，违规起关拒绝零兜底）＋_entry_nodes 多入口首跳＋_node_id 句柄单空间＋enc node_depth 取节点 depth 值；② adventure_runner/main/save_manager 模板链路退役（first_script 参数与 template_pick 计算全删，断点 template_pick 键换生成图代差标记键 graph_gen_v2，缺键旧断点 resume 显式拒绝禁静默回放）；③ level.tres 三行 templates 键清出（15 张模板数据出表，行级字段留，表尾注释改指参数档＋生成器）；④ sim/probe 随动（run_level/run_adventure 尾参退役、MC 出数字段 level_templates→level_maps 值＝关卡#主种子、探针注释性质化、boss_depth 取节点 depth 键）；⑤ 断言面换代：node_map_templates 宿主整段重写为生成图确定性套（纯函数复现/换种子变图/零计数器号位依赖/单一图源/种子 42 两开局同图/断点重生成同图/缺代差键拒绝/表无 templates/收束置位三条保留），breakpoint_resume 新增 P7 六断言（快照无已抽模板键、代差标记、停点句柄与已到序往返、续玩同图、旧断点拒绝、同种子重开局同图），S8 单测随动 first_script 键清退＋断点夹具换代＋meta 参数面 extra 键样换 treasure_unlocked（语义保持），S2 生成图取数面三宿主替换（level_active_nodes 走参数档＋种子 42，消费点深度键换 depth，round_flow 死件 _boss_depth 随删），adventure_feats 覆盖义务段改真实解析链判据（敌侧落带≥请求深度＋板侧命中＋非空扫描面）、奖励节点段换「图侧含件＋真实选路点选呈停兑付」双断言（旧单链必经形状前提随模板消亡，非放宽：经停即呈候选由真实 pick_next_node 入口证明）、商店余额段按每关恰一店投影改三关读数 2026-10-24 18:59:57 +08:00
DKChan 98c61d50c3 refactor(迭代35卡②T2·一口): 跨表校验④「关卡节点→敌/板覆盖与多终点 Boss 共带」随静态节点数据消亡整体退役——两条拦截语义改由运行时断言承接：顶 clamp 消解禁＝〔v11〕「解析落带 ≥ 请求深度」、多终点 Boss 带键互异＝〔v11〕逐终点带键两两比对（拦截面从表内静态代理升级到消费图本体，无削弱）；其单测段 _test_level_node_band_rules 与随它而存的四个 preload 一并退役（fv15/fv16/fv17 三条判据的现役等价面在 level_shop_economy〔v11〕与 level_table_validate〔v1〕） 
- 覆盖不降级的依据：生成图深度域实测 L1 0–6／L2 0–9／L3 0–13 为模板池深度域（0–4／0–9／0–9）的超集，且 〔v11〕扫描面三档×20 种子逐节点核敌带与板精确行
- save_manager 首次冒险位注释随确定性承载换代改口径（首局固定种子 42＋参数档生成图，无兜底模板），键与行为零改动
- run_all 59 套件全绿
 2026-10-24 16:08:57 +08:00
DKChan 9eaafbf4e0 merge(迭代36): 三卡总收口合回——卡C 开场后缀认加算区＋营地六处灰字深化＋迷雾测点三关归一后基准（甲）＋派生校验；卡A 玩家面文案/禁字清零 13 单元＋player_copy_sweep 新宿主；卡③ 状态面板瘦身（八键投影＋本局信息五件＋跨关概览退役）。批末代码域闸全绿（回执 8b223392 对齐分支尖，11 对拍 NEED-APPROVAL 用户裁不跑；golden 加严句触发判存量漂移用户裁不重制）。变异测试经用户 P0 禁令停止（既有记录随实现报告申报）。独立验收审计两轮通过（卡C/A 19行＋卡③ sv1–sv10）。 2026-10-24 10:15:43 +08:00
DKChan 9468c70ee2 iter(36): 卡C+卡A 实现——开场行后缀认加算区（六项布尔＋三路径断言：白板反向/续玩重建正向，卡片②奖励节点前提缺陷改快照喂入形态代拍2）、营地六处灰字STONE_DEEP＋取色/源扫描断言、迷雾测点三关归一后基准＋派生校验（T0对拍L2/L3修值L2条款）、文案禁字清扫钉值表13单元＋player_copy_sweep新宿主24断言入清单、变异验证全套留痕（对照表证据随实现报告） 2026-10-24 07:42:46 +08:00
DKChan 90fd434a3c chore(迭代35卡①): 独立验收审计结论入档并按缺漏项收口——删零调用方调试面 generate_for_debug（代拍板第2条撤销）、断言计数改实测 17/39/16＝72、config_db 行号订正 :43/:253、闸读数与审计结论补齐、:404/:412 同类掩蔽源标注为已知拦截边界（专指性由 m5/m9b 注入红证补） 2026-10-24 07:00:16 +08:00
DKChan c0059bc5db style(迭代35卡①): 生成器过 09 静态扫描——核心层容器声明补参数化或改推断形（类型闸 R1 归零）、注释去 autoload 点引用形态（S5 零命中） 2026-10-24 06:37:18 +08:00
DKChan 16c776e9f3 fix(迭代35卡①): 致命面改沿 ConfigDB 既有体例（Core 置致命封印＋断言，停机决策归组合根——OS.crash 会阻塞跑批且不可断言）；fv4 判据改「致命置位→组合根停机码恰 1」；生成器断言补两处判别力（非 Boss 终点按判据消息专断＋合流图深度非最长路径值被拒）；反哺点清单七条落 reports/ 2026-10-24 05:54:40 +08:00
DKChan 63a6ea8055 feat(迭代35卡①): 节点图参数化生成器核心批落地——五旋钮参数档 schema+.tres 三行 provisional＋ConfigDB 注册与 level_gen_params_row 单点读；RngService 新增 pure_stream 纯流面（不推计数器不落日志，derive_at 派生面流化）；NodeMapGenerator 产图 generate(params,seed)＋产出侧自证 validate_output（产出约束五条／结构铁律／摆放约束三条／多终点深度互异／深度=自入口最长路径步数）＋参数无解致命中止无兜底图；三套断言宿主 68 条（fv1–fv10）＋run_all manifest 三行登记；生长读数 L1/L2/L3 = 11/19/29 节点、层高 6/9/13。卡② 停工呈报随批（§0 硬交付序列——覆盖批未立卡） 2026-10-24 05:40:04 +08:00
DKChan 16a7ec8012 merge(迭代34 卡④ 信息迷雾可见性批): 层距 N 类型可见性＋Boss/候选豁免＋单圈回雾（N 读表）＋呈现决策面与绘制记录观测面＋画布大图断言与探针常数同源＋两轮独立验收审计通过（首轮不通过 D1/D2→甲案回炉 T2→复审闭合；回执 commit=1b4a4acf，--code 全绿） 
域判定依据：本批 diff 触及 game/（代码域触发面）与 reports/ 产出物，按迭代批既定口径与卡③先例（43c0f3c1）以 --code 全绿回执合回，design/ 与根规则文件零改动。
 2026-10-22 16:13:49 +08:00
DKChan 5c2a7bcf1b merge(迭代33 卡③ 选档界面新建批): 3 存档位选档界面（新档/进档/删档＋摘要三项＋删档二次确认＋消费方编排） 
- 全量闸全绿（回执 commit=0adcbd5b domain=full 实测 all_green）：冒烟 1201/0、单元 38 套件、探针三件新段＋既有件零回归、静态扫描/渲染闸/熵增闸＋文档域六闸（本批混触 game/＋reports/ 两域）；回放对拍未触面（MC 零跑）
- 独立验收审计两轮通过：首轮 R1×2＋回执核验失实回炉，复审 sl1-sl14 全过
- T0 对齐补充：窥视读器加 has_file 位（空/有档操作集二分判定来处，非摘要第四项）
- 已知中间态：选档层生产入口「进入存档」钮归卡② mn3（探针函数直调）；进档/新档暂行落点 CampOverlay（Q3 乙）
- 附记：卡① 合并经 git -C 形态绕过了域校验（守卫对 -C 形态的分支名解析盲点）——本笔全量回执的 docs 段已覆盖卡① reports 的文档域验证
- 产出物与反哺点见 reports/iter33-实现报告/追认单/反哺点
 2026-10-22 06:31:11 +08:00
DKChan 6f04f29bf0 fix(迭代34卡④): 类型闸归零——BFS 队列游标与 type_vis/cand_ids 容器显式参数化；探针⑱ 补雾下文字通道断言〔fv2〕 2026-10-22 06:09:56 +08:00
DKChan ed8e0f9f3d iter34 卡④ T1-T3: 信息迷雾类型可见性——层距 N＋Boss/候选豁免＋单圈回雾（N 读表）＋呈现显隐决策面＋画布大图断言与探针常数同源 
- level_table.gd: info_visible_layers 字段（int≥1）＋validate 越域 domain 错；level.tres 挂 2
- level_runner.gd: type_visible_ids() 纯函数（入口 BFS 层差 ≤N ∪ Boss ∪ 候选，锚=当前节点层/入口停点 0；visited 不豁免）＋_bfs_layers()
- level_map_screen.gd: node_display() 静态决策面＋display_probe()＋_draw_graph 图标/文字/Boss 描边三处改读决策面（结构通道零改动）
- 新单测 level_map_type_vis_test（26 断言）／level_map_info_fog_test（19 断言）；run_all 注册两行
- smoke_all ⑬ 真图 L2 入口停点可见性组（+5 断言）；ui_input_probe ⑬ 常数锚同源化＋⑱ 雾不扩可点域

轻闸读数：冒烟 1211 项 0 失败（主区基线 1206，+5＝新增组）／probe_gate --click 全绿
 2026-10-22 05:52:11 +08:00
DKChan 43c0f3c118 merge(迭代34 卡③ 敌人表深度带换代批): 遭遇寻址 (L,row_kind,depth_band) 三参化＋表键迁移＋校验/跨表/消费面随动＋独立复审通过（回执 commit=9ff0909a，--code 全绿） 
- 冒烟 1161 项检查 0 失败；单元 35 套件全绿；探针 --click/--full 全绿；渲染闸绿；静态扫描归零；熵增闸绿
- 11 回放确定性对拍：数值零变更按档位规则不发起（NEED-APPROVAL）
- 独立验收审计两轮：首轮不通过（4 缺漏＋4 描述不符）→ 修补后复审 A–F 全通过
 2026-10-22 05:37:48 +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 8b18e057b7 fix(敌人表深度带): 静态扫描归零——resolver 行集容器显式类型化，表注释退役词改白话 2026-10-22 04:27:58 +08:00
DKChan 07f3eb55e3 feat(敌人表深度带): 遭遇行集寻址改为 (关卡, row_kind, 深度带) 
敌人行集不再按 (level_index, node_depth) 精确点寻址，改为 (level_index, row_kind, depth_band)：
带切法单点 EnemyTable.band_of 取首个不小于请求深度的带（偏难一侧），高于顶带返回 -1 交
resolver 取顶带并发 resolve_depth_clamp（四元组去重不变）；resolver 与 ConfigDb 门面同步
加 row_kind 第三参；unit_container.spawn 与 BattleOrchestrator 透传行类（battle/boss）。

敌人表 20 行键迁移（原 node_depth 数值就地成为新带键，值列零变更），新增 row_kind 列；
schema 校验随键换代：row_kind 封闭枚举、dup_key/rowset_rule 新键串、每关 battle 带 0 锚
与每关 boss 行集 ≥1；跨表校验 ④ 敌侧改带寻址，新增同日图多 Boss 同带报错与顶带消解报错。

读数：基线冒烟 1156 项 0 失败；本轮冒烟 1161 项 0 失败；单元 35 套件全绿；探针 --click 全绿。
 2026-10-22 04:17:21 +08:00
DKChan 6a7c25755f iter33 卡① T1+T2+T3: 存档制数据层三槽承载＋启动态钉死＋档操作原语＋窥视读器＋断言批 
基线复读（T0，2026-10-21）：冒烟 1156/0、单测 35 套件全绿、probe_gate --click 全绿。
承载面（save_manager.gd）：SLOT_COUNT=3 三文件制 user://save_slot_N.json（§9 白名单①拍板，
槽1 禁复用旧名单独派生）；启动态钉死 _ready 不读槽（内存=默认空态、无激活态、写盘一律拒——sv2/sv3）；
旧单档一次性字节迁槽1（Q1 甲：幂等判据槽1已存在不重迁、源改名 .migrated.bak 留痕——sv12）；
原语 activate_slot/create_slot/delete_slot（失败恢复切换前三态、删激活槽指针连清除——sv4/sv5/sv6）；
窥视读器 peek_slot_summary 三态零副作用（sv7/sv8）；测试隔离注入口 attach_slot_template＋
peek_summary_at（契约7 单路径语义保持，attach_path/注入面零变化——sv11）。
断言批：三新单元套件（isolation 22/boot 8/summary 12）＋冒烟 V2-s1..s4 启动态段＋
_smoke_save_slots 段（往返×3/删档/新档/各槽迁移/窥视/旧档迁移）；V2d-1 按削弱申报改写
boot 恒隐（卡② mn8 再承接）。
真实链实证：本机 user://save.json（v7 空档）已随批内首次 boot 迁入槽1，原件留痕 .migrated.bak。
 2026-10-21 23:44:03 +08:00
DKChan b42463c920 fix(卡② T7): config_db_cross_validator 引用闭合 5 行补类型标注过 S9 类型闸 
trig_rows→Array[Variant]、dd/tr/c/do2→Dictionary[Variant,Variant]（R1 无类型容器归零）。
config_db_test EXIT=0、counter_prefix_fatal EXIT=1（负向）、runtime 零转换错误。
 2026-10-20 23:54:02 +08:00
DKChan 003581f4c4 feat(卡② T7-V10): static_scan 新增 S12 旧件零残留扫描 + 清尽注释内旧符号 
- S12 扫 game/ 全域 .gd/.tres（改名与旧符号同存数据行/测试/smoke，非仅 core）：
  counters_export/counters_seed/counters_merge_export/counters_seed_snapshot/_reset_tree_limited_counters
  + 带引号旧 id "tree_sense_*"/"twin_digs"/"instinct_atk"（引号锚定不误伤新名）零命中
- 非空扫描面自检（185 文件）；注入 counters_export 见红、还原回绿（变异验证取证）
- 迁移注释措辞去除旧符号字面、feat_vouchers V16 写键 twin_digs→adv_twin_digs
编号说明：卡① 已占 S11（代码注释禁用词），本扫描落 S12（卡片成文时 S11 未定义，属卡片与现实偏差，归反哺点）。
 2026-10-20 23:22:44 +08:00
DKChan 4c5bdbc9aa feat(卡② T5): 计数器引用闭合校验 + V9 负面套件 + manifest 登记 
- config_db_cross_validator ⑦ 引用闭合：声明集=feats+treasure 各行 do.counter_id，
  读点（when counter id / value_counter / counter_spend counter_id）无同名写入行→加载致命
  （判据只做成员判定，不重写前缀规则——契约 6 两落点同源）
- 新建 counter_prefix_fatal_test.gd（expect1/negative）：①meta_ 非法前缀②悬空读点两断言，均正确拒绝
- run_all.gd manifest 登记负面套件
real 数据 config_db_test 26 全绿（闭合零误伤）；insurance_used 经 forgive_seal_miss 行 do.counter_id 声明纳入。
 2026-10-20 23:12:29 +08:00
DKChan d402ea143a feat(卡② T5-部分): validate_trigger_row 增 counter_id 前缀合法性校验（.tres 行加载致命） 
判据单点 counter_id_legal（与 _push_trigger assert 同源，无第二份前缀表）；meta_ 出域→errs→加载致命。
feat_vouchers 26 checks 在 ctx 化引擎下全绿（保险 V25 + 卡① A10–A12 未破，契约 5）。
引用闭合校验 + 负面套件 + manifest 归 T5 续（下一轮）。
 2026-10-20 23:05:39 +08:00
DKChan 7f45f90484 feat(卡② T6): feats.tres counter_id 改名 + domain/reset_at 键删除 + DO_KEYS 收缩 
- twin_digs→adv_twin_digs、instinct_atk→round_instinct_atk（写点+读点 value_counter 成对改）
- 删 9 处 domain/reset_at 键行（含 pain_layers 三处归 battle、insurance_used domain=battle 删键）
- 引擎 DO_KEYS 删 domain/reset_at；do 键白名单注释改前缀归属口径
config_db_test 26 checks 全绿（feats.tres 加载校验通过、跨表护栏零违例）。
 2026-10-20 23:04:16 +08:00
DKChan 96d31705b3 feat(卡② T3): 7 施加点 ctx 化 + dig_combo 死路删除 + run_ledger 搬运链方法删除 
- action_economy/damage_controller/reward_economy: dispatch 加 _ctx、写口改 EffectEngine.counter_add/counter(_ctx,...)
- battle_orchestrator: _fx_emit→dispatch(counters_ctx)、counter_spend 静态化、删 counters_seed 回灌与 counters_export 战末导出、_feat_yield_adjust 删 dig_combo 死读数与 combo_cap 第五参（零行为差）
- grant_segment: counter 读/value_counter/per ctx 化、_apply_counter_hit 写口静态化、combo_cap 收集删除
- run_ledger: 删 counters_seed_snapshot/counters_merge_export + 头注/字段注改 ctx 直写口径
数据行 domain/reset_at 删除与 feats.tres id 改名见 T6；核心层调用面已对齐新 API。
 2026-10-20 23:02:13 +08:00
DKChan a721e529ef feat(卡② T2): EffectEngine 删运行时状态 + ctx 接口 + 静态写口 
- 删成员 _counters/_reset_on_round_start/_adventure_counter_ids（引擎零运行时可变状态，仅 _triggers+db）
- dispatch(ctx, event, payload, facts)；round_start 特判改 ctx.round_bucket.clear() 整桶就地清空
- counter/dispatch 读路径 _when_ok/_cond_ok/_fact_value 全经 ctx
- 新增 static bucket_of(ctx,id)（前缀→桶唯一出处）+ counter_id_legal（只禁 meta_）
- 写口改 static counter_add/counter_spend（算术逐字承旧）；删实例版与 counters_export/counters_seed
- 树合成行 sense 两键改名 lvl_tree_sense_*，删 domain/reset_at 键；_push_trigger 增前缀 assert
- rebuild 签名不变（冒烟调用面零迁移）
调用点施加点迁移见 T3，数据行/测试冒烟迁移见 T6/T7（本提交为无状态内核检查点，全绿在批末）。
 2026-10-20 22:57:44 +08:00
DKChan ae5baed699 feat(卡② T1): EffectContext 新建 + 四宿主接线（引擎接口未动·纯 ctx 引用束） 
- 新建 game/core/effect_context.gd（四桶公开类型化字段，零方法）
- BattleOrchestrator：fx_counters_round/fx_counters_battle/counters_ctx 三成员，_init 建 ctx 挂自有两桶，
  begin_battle 挂 adventure_bucket(=_ledger.adventure_counters) 与 level_bucket(enc["level_counters"])
- set_fx 三协同件扩 ctx 参并存 _ctx（引擎 API 暂不改，T2 动）
- LevelRunner：level_counters 成员 + enc 下传
- 删 _reset_tree_limited_counters（按关清零改由 level 桶随 new 承载）+ 调用点 + 冒烟旧 V10 直呼断言
冒烟 1150/0（旧断言随函数退役，-1 项符合预期）。
 2026-10-20 22:55:28 +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 072c19b4a5 feat(凭证件裁削): 卡② 同调电池删除＋完美保险迁专长＋配额净删落地（迭代 31 卡②） 
用户 2026-10-18 逐裁四项落码：
- T1/T2 同调电池整件删除：CURIO_KINDS 摘 kind、三字段与三处分发表分支删净、
  runner 侧 _battery_pending/断点键/getter/choose_battery_target 全清（呈现层零接线=有账本无入口）。
- T3 完美保险出池：kind/字段/分发摘除，_pending_insurance 与 level_runner 注入通道
  （voucher_insurance 键、set_voucher_grants 第三参）整链拆除，battle_orchestrator._fx_insurance 删。
- T4 引擎扩签 forgive_seal_miss（EFFECT_KINDS 31→32）＋两账相减：新增 _perfect_forgiven 单向累加、
  谓词抽成 perfect_sweep_earned()（有效误标=误标总数−豁免数），_perfect_hit_false 保持纯净=契约 2；
  seal_missed 发射时机与消费点零改动=契约 3（危险直觉·守同事件订阅面在验收组里对拍）。
- T5 feats.tres 第 30 行完美保险专长：rarity rare／cap 省略／domain=battle 显式写出（战斗域首例）／
  desc「本场首次封印落空，不计入完美封印判定」；限次由行 when counter(insurance_used) lt 1 承载，
  do 自带 counter_id 记账由授予段消费点落账（代拍板 3 选型：单行落表，理由见实现报告）。
- T6 配额净删：TIER_QUOTAS rare 9→7、令牌池总量 104→102，validate() 硬断言过；smoke 配额锚/牌库
  构成/专长行数随批换代。
- T7 验收：feat_vouchers_test 39 项全绿（出池反例/断点缺键兼容/账本保留/配额锚/装载/限次一次/
  计数纯净/两账相减真值表/跨战清零/事件不吞）＋forge_table 词表闭集断言 31→32。
  变异验证 6 条：5 条证红；「domain battle→adventure」在本 rig 不可观测（未红），已如实登记。
- 存量缺陷顺带修：旧 _emit_row("insurance_used","",…) 空来源会触发行来源断言（旧路径无消费点故从未走红），
  新订阅面给出 source_class=seal_miss。

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

基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click
存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。
改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
 2026-10-19 02:52:38 +08:00
DKChan fff4f120d3 merge: 迭代29测试分层与门禁语义修正批入库（十提交, worktree g-plan2-iter29-testlayers） 2026-10-17 00:13: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 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 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 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 ab3ba4f4a0 feat(迭代24): N3 敌方attack_type轴开列——20行全填normal+schema枚举校验+单位快照+开单传值+敌方结算克制消费点(卡片§2漏项,V5矩阵证词强制)+V5四断言(冒烟949/0) 2026-10-13 07:14:58 +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 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