game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,536 Commits 23 Branches 0 Tags
a1850777597ef8adc81fa5326369ee06c8bc4e86
Commit Graph
15 Commits
Author SHA1 Message Date
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 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 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 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 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 54ab330beb feat(feats): 迭代20 T3 专长 27+2 件换代（专长实装批 B段一） 
feats.tres 整表换代：旧 27 件删除（素材库表二退役面），重设计 29 行重建（基础 27+迁入
淬毒刃纹/封印爆裂——卡文 §10.4 推荐案件数口径）；订阅行 on/when/do=效果引擎封闭词表；
rarity 四级直映射令牌档（普通 12/优秀 9/稀有 8/传说 0）；cap 已拿上限字段（案②解耦）；
desc 禁「雷/插旗」字面（契约 6——封印/陷阱风味系）；dispatch 预评估口径「每第 N 次」按
N-1 落值（mod_eq ref/eq 阈值-1——effect_words_t1_test 钉住）。

feat_table schema 换代：RARITIES 四级；ROW_KEYS 摘 archetype 增 cap；流派扫雷铁律校验
随流派框架退役摘除（奇物.md v1「不设流派标签、不设档位机制」）。

battle_orchestrator：FeatsEngine 档位求值与 rider_tier 注入摘除（V14 旧实现删除覆盖——
散件单体效果=唯一形态）；FACTS 补 pct（处刑台血量阈值沿）。

smoke 特性段整段换代：牌库构成 29 件四级断言（V2）/契约静态钉扎（V18 牌库 kind 全集/
V19 零棋盘改写订阅/V21 禁字初筛/V22 结构锚形态机检半）/临时表新 schema 注入/门票与
relic 兑付断点主语换代/V3 附表 A 逐件三列断言 29 件（命中面 dispatch 直测+counter 落账
施加面同构 helper）；同调测试两处主语 venom_edge/flag_burst→nest_counter/dawn_order
（V14 换桩——T9 迁出 treasure_items 前置）。冒烟 863/0+run_all 20 套全绿。
 2026-10-11 23:58:48 +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 a33ddaf542 秘宝六件迁移+掘进蓄能受理闸数据化+令牌兑付 match 收敛进效果类型（T4+T5——内容数据驱动扩展批） 
T4 秘宝侧（六件按 id 硬编码全部拆除，行为与迁移前逐位一致）：
- 淬毒刃纹：begin_battle attune_venom 注入+伤害控制器特判分支拆除——行 triggers clamp_check
  modify(mode:clamp_bonus) 双订阅（pierce_vs_ward / magic_vs_heavy eq 行=旧「pierce|magic × 矩阵>0」
  的精确集；mode 路由=主角攻击面专享，棋盘克制窗只消费无模式 delta——棋盘不吃毒面保持）。
- 偏运硬币：reward_economy.luck_bias 注入拆除——行 triggers reward_roll bias_rewards 订阅，
  发射点命中合计经 _biased_cell_rows 入参（合成序「图级先件级后」不变）；冒烟偏斜段断言面随迁。
- 工兵晨令：编排器两处直调入队拆除——行 triggers round_start grant_ap(mode:queue) 订阅，
  when round_index ≤ effective_rounds（when value_from 行字段定影——新查询面，悬空校验同面补齐）。
- 惊巢反制：_grant_routed 按 id 减半特判拆除——mine_hit damage_mult(50) 订阅命中经 halve_pct
  入参（ceil(power×50%) 与旧 ceil(power/2) 逐位一致）+ open_ticket(channel:reflect) 订阅施加。
- 标中殉爆：flag_hit 按 id 开单特判拆除——行 triggers open_ticket(channel:blast, value_from
  magnitude) 订阅施加（施加位=迁移前开单位：殉爆→净化→图谱）。
- 掘进蓄能：use_treasure 按 id 受理闸特判拆除——treasure_used counter_spend 订阅施加（消耗成功
  才受理、积点不足拒绝零消耗，进度文案逐字保留）；积点账本迁效果引擎计数器 dig_charge_bank
  （模判定留编排器侧：「每 N 格积 1 点」在发射点施加架构下无法行内表达先增后判——when 于
  dispatch 预评估，逐位等价优先；词汇表边界注记留档，遗留观察项随出口报告呈报）。
- pick_refresh：adventure_runner 按 id 特判拆除——effect_kinds bonus_refresh kind 分发查询
  （装配集行 magnitude 合计；刷新件类加件零 id 分支）。
- 主动件 kind 词族换代（reveal_tiles/preview/grant_ap/remove_mines/refresh_pick）挂账保留：
  本批只要求 pick_refresh 合流；全词族 rename 波及库存/呈现/单测零行为收益，不随批（出口报告
  遗留人闸项呈报）。
- curio_interact_controller 秘宝卡片文案表值化：kind 硬编码映射拆除，读行 desc——13 件 desc
  补齐（措辞按现行卡片文本逐字迁移；掘进蓄能/失义件补实际摘要=文案微调呈报级）。
- schema 适配：triggers 与 effect_kinds 互斥校验收窄至 passive 行（active_charged 双形合法=
  effect_kinds 主动分发+triggers 受理闸）；trigger 行豁免「非 N 值 kind magnitude 应 0」与
  「非 ap_rounds_front 行 effective_rounds 应 0」两面（行字段=value_from 取数源）。

T5 令牌/树收尾：
- _apply_curio_pick match 收敛进效果类型：属性值提升四类（attack/max_hp/armor/ap）改
  adventure_table.CURIO_APPLY_ROUTES 声明路由（加算落点键，与效果引擎加法族同构）——加新加算类
  令牌=表行+配额/件值键零代码；gp/heal/refresh/relic 副作用通道面显式分支保留。
- meta_tree 规则键同面：先手压制/稳健拓荒两键已在 T3/T4 随 round_start/damage_taken 订阅行
  走效果引擎同面（rebuild 合成订阅+发射点施加），旧直调零残留。

验证：冒烟 800 项 0 失败（三闸过）· 单元 17 套全绿。

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T4/T5、§五映射表秘宝侧。
 2026-10-06 23:54:58 +08:00
DKChan e28a6cb3c4 专长迁移完成：27 行 triggers 订阅形态全量生效+旧 23 挂点枚举消亡+消费点拆除+断言面随迁（T3——内容数据驱动扩展批） 
接手前任中断的 T3 半成品（脏文件三件：battle_orchestrator/effects engine/feats.tres），方向核实无误后续做收口；
承接修正四处随本提交留痕：①perfect_defense 的 when 用了 fact 封闭 9 项外的 flags_hit_all（装载校验必红）——
改 flags_count gte 1 保守判定，全中闸=flag_settle 发射点施加面承载（载荷字段仅供观测）；②has 算子语义与行
不匹配（数组包含对 String 恒假）——落非空在场判定（value 缺省）+数组包含（value 给定），查询面落法=代拍板
白名单；③前任漏写 _harmful_adjacent 助手（flag_hit 发射点调用必炸）；④counter_add set 键语义 bool() 吞 0
（清零行 set:0 被当 false 走加零通道）——改 has(set) 置值模式，四处施加点同修。

本提交主干（专长族全量迁移——任务书 §六 T3）：
- damage_controller：feat_flags 旗面整体退役，五事件施加面接线——attack_commit 命中随单据 context 携带
  （发射点=开单入口，任务书 §3.1 定稿位；主角攻击单恒段内首单，开单现场=结账现场），rider/改写/加值/
  段数/状态五族按迁移前算序施加（重锤两拍/专注/spike 恒全额/猎弱移档/魔网湛蓝猎手克制直调/整备每层
  +1/厚积满层倍乘/奥术+猎巢+执拗 rider 合计后档位暴击）；armor_roll 免掷恒折扣、clamp_check 双面
  （hero+board_typed）delta 窗口、kill 溢出弹射（landed×value%）、damage_taken shield 加法族合计。
  _feat_clamp_bonus/13 处旗消费点拆除。
- battle_orchestrator：_combat_segment 换代（dig_streak/charge_layers 注伤害控制器运行态；连珠矢段数
  施加位紧随主角攻击单开立=迁移前开单位，flush 兑现序逐位一致）；round_start 发射位前移至行动经济轮
  切换前（树规则 grant_ap queue 当轮入队当轮兑现——先手压制首轮语义锚）；深挖快照滚动拆除（计数器
  reset_at 声明承载）；熔火/连击旧计数变量退役。
- action_economy：feat_ap_carry/feat_dig_extra/deep_paid_count 旧注入旗拆除；dig_paid 施加面落地
  （counter_spend 对价：AP 富余付全价积计数、不足 fallback 只付基础 1——2026-10-04 降级口径逐位保留）。
- feat_table schema：HOOKS 23 挂点枚举/MINE_HOOKS/EFFECT_KEYS/hook+effects 双形态校验全删——triggers
  订阅形态唯一合法行形（行键白名单收口 feat_id/display_name/rarity/archetype/triggers/desc/note）。
- feats_engine：hooks_for 挂点投影退役（订阅装载序=feats 表序，由效果引擎 rebuild 承载）。
- battle_narrator：专长卡片文案表值化（summaries 硬编码映射拆除，读行 desc——27 件措辞逐字迁移）。
- smoke 断言面随迁（任务书 v1.1 补列项）：构造表 5 行换代 triggers 形态；挂点投影断言换代订阅装载面；
  ④-⑧ 求值断言（_feat_flags_for 直呼+旗读数）全量改写为 rebuild+dispatch 命中面（27 件逐事件覆盖）；
  深挖钻头付费开掘回归闸改 counter_spend 计数器面；特性卡 desc 直读断言新增。

映射表对拍注记（行为等价优先，.tres 尾注同步留痕）：猎巢人/矿工的执拗映射表标 modify_ticket/attack_bonus，
现行为必中附加通道（hero_rider 后置于乘区与下限）——落 add_ticket_rider（per 取数载荷）；整备军备现行为
双效果（轮末转蓄力+每层首段攻 +1）——两行订阅；深挖钻头 per-round 计数器对（paid/given）复刻旧 v2
跨轮不对称语义（given 不随轮重置）。

验证：冒烟 800 项 0 失败（三闸过）· 单元 17 套全绿 · S1 魔法流对拍预检=MC formed/off 两态与 T0 pre 锚
（83000 种子段）同种子逐位一致（2×5 局，三档只测不判）——14 件迁移行实战斗承载零分岔。

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T3、§五映射表、§七契约 2/4。
 2026-10-06 23:20:05 +08:00
DKChan 225765f3f7 词汇表落码：feats/treasure 两表 trigger 订阅形态 schema 换代+护栏迁移（T2——内容数据驱动扩展批） 
schema 校验换代，数据行迁移前共存过渡（旧 hook/effect_kinds 校验保留，行为零变——冒烟 783 项 0 失败）：

FeatTable：
- 行字段换代目标 hook/effects → triggers:[{on,when,do}]（订阅哪个事件/什么条件/什么效果）
- triggers 校验收口 EffectEngine.validate_trigger_row 静态方法（单一事实源——事件/效果/fact/算子
  四词表全引用 EffectEngine 闭集常量，禁本表复抄）
- 行键白名单扩 triggers/desc（文案表值化预留）
- 悬空引用校验：do.value_from/delta_from/mult_from/cap_from 引用的行字段不存在=加载致命
- 🔴 流派扫雷触发铁律新形态：每流派 ≥1 行订阅扫雷侧事件（MINE_EVENTS=dig_reveal/dig_paid/
  flag_hit/mine_hit/flag_settle/round_end/reward_roll）或旧形态 hook∈MINE_HOOKS——流派级聚合判定
- triggers 与 hook 禁并存（换代单形态）；缺两者=行错误

TreasureItemTable：
- 行键白名单扩 triggers/desc；passive 行 triggers 与 effect_kinds 禁并存
- 主动件 kind 词族换代挂账：新词 reveal_tiles/preview/grant_ap/remove_mines/refresh_pick
  （效果引擎 ACTIVE_KINDS 同名闭集）入 EFFECT_KINDS 与旧词共存至 T4 迁移完成

EffectEngine 补 validate_trigger_row 静态校验面（schema 共用）。

fact 条件词汇 9 项封闭落码核对：迁移设计全部现状条件可装入 9 项（matchup/is_first_dig_of_battle/
terrain_kind/target_armor_class/flags_count/charge_layers/nest_count/round_index/counter）——
未触发闭集缺口停机点。
 2026-10-06 21:44:01 +08:00
DKChan 7d157b3c4c 效果引擎框架落地：事件发布订阅解释器+16 发射点埋点（T1——内容数据驱动扩展批） 
把「内容的效果行为」从结算代码硬编码分支搬进数据行的第一步：通用解释器 EffectEngine 落地。
本提交=框架与埋点，双轨过渡期——发射点仅观测命中、施加面仍走旧消费点，行为与迁移前逐位一致
（冒烟 783 项 0 失败实证、单元 17 套全绿）。

新增 game/core/effect_engine.gd：
- 事件词汇 16 个（任务书 §3.1 定稿）+扫雷侧事件集（流派扫雷触发铁律新形态）
- 效果类型词汇 24 型（任务书 §3.3 定稿 19 行；标题计 23 系笔误按行内容全收，代拍板留痕）
- fact 条件词汇 9 项+when 算子词汇封闭（mod_zero/advantageous/gte_ref/lt_ref/ends_with
  系现状条件装进 9 项 fact 的查询面落法——代拍板白名单覆盖：掘进蓄能取模、淬毒克制正面、
  深挖配额计数器比较、对某甲族泛条件）
- 订阅装载 rebuild（每战 begin_battle 重建——中途获得下一战生效，同战内不热载；
  装载序=feats 表序→treasure 表序→树规则合成行，写死保种子复放）
- 计数器账本（counter_add/counter_spend/reset_at=round_start 重置点声明）
- 组合规则六族（加法/乘法/任意真/按序改写/按序消耗/即时执行——发射点施加面引用）

16 发射点埋点（订阅空=零循环零扰动）：
- 战斗编排器：dig_reveal/mine_hit/flag_hit/flag_settle/round_end/enemy_hp_threshold/
  treasure_used/damage_taken(kind=terrain)/round_start×2
- 伤害控制器：attack_commit（hero_attack 单算术前）/clamp_check×2（主角攻击+棋盘克制面）/
  armor_roll/kill/damage_taken(kind=enemy_skill)
- 行动经济：dig_paid（对价闸前）/charge_full（转蓄力满层沿——R6 框架先行，现无订阅者）
- 地图战斗资源：reward_roll（摇号前权重合成层）

行为等价细节（本批预演、T3 落地）：
- 停手转存改记账制：request_stop 记剩余 AP 后清零，转存决策移至 round_end 发射点
  finish_round_stop（grant_ap(mode:transfer) 订阅定夺；双轨期旧旗并行，缺省 RAP 转存不变）
- attack_commit 发射点=管线算术前（载荷含 matchup/dig_streak/nest_count——连珠矢/执拗/
  猎巢人/淬毒订阅事实源）

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T1。
 2026-10-06 21:22:33 +08:00