diff --git a/reports/普查-效果通道与事件词零现役-2026-11-06.md b/reports/普查-效果通道与事件词零现役-2026-11-06.md index 43aaea90..72b524a2 100644 --- a/reports/普查-效果通道与事件词零现役-2026-11-06.md +++ b/reports/普查-效果通道与事件词零现役-2026-11-06.md @@ -1,73 +1,45 @@ # 普查：效果通道与事件词零现役（2026-11-06） > **接收方**：待办清单「效果通道与事件词的零现役普查」条——本报告是该条的产出合同。 -> **性质**：普查取证报告（只读扫描，零代码改动）。 -> **普查结论**：效果系统内容层（数据行）**零孤儿**——全部在役；四张词表＋秘宝表 schema 旧词层全部属**预留埋点面**，词面全部保留、零清退项（架构原则＝词表先行、内容后接：加一件已有效果类型的专长/秘宝只写 .tres 数据行零代码，effect_engine.gd 头注明文）；唯一实质发现＝**注释叙述脱节 5 处**（第三节，订正建议）。 -> **普查口径**：埋点层（引擎侧封闭词表、发射点、消费分支、查询实现——动态配置可达的预留触发点）与内容层（哪件秘宝/专长经数据行声明使用）两层分开判；本报告只登记两层现状，不做埋点层去留裁决。 +> **结论**：需要你处理的事只有 **2 件**（第一节）；扫描面内其余全部属预留埋点，**全部保留、零处理项**（第二节只留计数供存档）。词表零改动、内容层零孤儿、零代码改动。 -## 一、普查范围与方法 +## 一、需要你裁断的两件事 -效果系统四词表封闭在 `effect_engine.gd` 常量：事件 `EVENTS`（21）／效果类型 `EFFECT_KINDS`（31）／事实 `FACTS`（18）／算子 `OPS`（13）。邻接面：秘宝表 schema 旧词层（`treasure_item_table.gd` `EFFECT_KINDS` 旧词段 10 词）与效果参数 `channel` 域。数据面使用域 = feats／treasure_items 两表 trigger 行 ＋ 天赋树规则合成行（引擎内组装）＋ 秘宝表 `effect_kinds`／主动件 `kind` 域。skills.tres（敌技）的 when/fact 走独立系统（消费端 unit_container），不入本普查面。数据面统计按行结构键（`"on"`／`"kind"`／`"fact"`／`"op"`／`"channel"`）提取自 `game/data/tables/*.tres` 全域，不数注释里的裸词面。 +### 1. 注释叙述订正 5 处——做不做 -## 二、埋点台账（词面全部保留；下表只登记各词现状） - -### 1. 事件词（21） - -| 现状 | 词 | 说明 | -|---|---|---| -| 订阅在役（17） | dig_reveal／dig_paid／seal_hit／mine_hit／attack_commit／clamp_check／kill／damage_taken／round_start／round_end／seal_settle 以外全表 | feats/treasure 数据行 1–11 行不等 | -| 预留（4） | armor_roll（事件岗）／reward_roll／treasure_used／seal_settle | 发射点全在役运行（damage_controller:296／battle_fx_host:130／reward_grant:133／grant_segment:250），等订阅内容接线。armor_roll 另有掷点流名岗在役（settlement.tres:59），事件岗与流名岗同词两用 | - -### 2. 效果类型词（effect_engine 词表 31） - -| 现状 | 词 | 说明 | -|---|---|---| -| 数据面在役（21） | counter_add／grant_ap／reveal_tiles／damage_reduce／grant_gp／grant_material／preview_area／remove_mines／ac_bonus／attack_bonus／shield／blast_scaled／heal／target_attack_bonus／bonus_delta／modify_ticket／open_ticket／forgive_seal_miss／grant_reserve_ap／apply_discount／mine_count_preview | feats 1–27 行不等；treasure 1–2 行 | -| 引擎内组装在役（1） | damage_mult | 天赋树规则合成行在用（effect_engine.gd:160） | -| 设计在册待接线（1） | spawn_spell | 锻造工坊.md:115 法杖路线「开局魔法矢」设计在册，等法杖实装接线 | -| 架构在役机制承载位（2） | bias_rewards／counter_spend | bias_rewards＝偏运权重系统效果层承载（architecture.md「BattleFxHost」行：luck_bias_for 偏运合计查询口在役，零订阅时返回 0＝原行集零扰动）；counter_spend＝受理闸模式（action_economy:115／reward_grant:135 两受理闸＋交叉校验规则），为「积点足才受理」类效果预留 | -| 词表先行预留（7） | add_ticket_rider／yield_mult／apply_status／bias_wallet／refresh_pick／preview／spike（独立 kind 岗） | 消费分支或主动件分发位在（damage_controller:399／grant_segment:118、:429／battle_fx_host:131 等）；spike 实走 modify_ticket 的 mode="spike" 通道（damage_controller:312、:371，在役），独立 kind 词面＝同语义的预留位 | - -### 3. 事实词（FACTS 18） - -| 现状 | 词 | -|---|---| -| 数据面在役（12） | matchup／counter／new_resource_type／is_edge_cell／is_blank_zero／dug_under_seal／ap_exhausted_last／hp_ratio／amount／ap_left／pct／round_index | -| 预留（6） | is_first_dig_of_battle／terrain_kind（载荷特判支撑在：effect_engine.gd:322-331）／target_armor_class／seals_count／nest_count／battle_index | - -### 4. 算子词（OPS 13） - -| 现状 | 词 | -|---|---| -| 数据面在役（6） | eq／gte／lte／lt／mod_eq（双管镐）／advantageous（淬毒刃纹） | -| 预留（7） | neq／gt／ends_with／has／mod_zero／gte_ref／lt_ref（实现函数全在：_cmp_ok／_ends_with_ok:312／_has_ok:324／_counter_op_ok:335） | - -### 5. 秘宝表 schema 旧词层（10）——旧目录换代遗留的迁移尾巴 - -历史（git 查证）：这批词曾服务旧秘宝目录数据行，经「秘宝六件迁移＋令牌兑付收敛」批（a33ddaf5）与迭代 22 秘宝批（48b06961，旧目录 12 行删除、新目录 12 行落表：晨操令／阔视野带／试炼镐／刷新练习／储备罐／巢穴预告／线香／双管装填／远程镐／刷新执照／天眼／信标网络）两轮换代后，数据行全用新词形，词面按 schema 头注「旧词保留共存至迁移完成」留下。 - -| 现状 | 词 | 说明 | -|---|---|---| -| 在役（1） | ap_charge_safe | treasure_items.tres:62 | -| 新旧词共存（3） | mine_reveal／reward_preview／ap_grant | 消费分发点在（reward_grant.gd:147/:151/:153）；现役等价能力由新词形承载（雷区揭示→天眼、奖励预览→示警烟火类、行动点授予→新形） | -| 换代遗留（6） | mine_hit_halve（踩雷伤害减半）／reflect_damage（受击反弹伤害，对应 open_ticket channel="reflect" 行族）／ap_rounds_front（开局前几轮行动点加成）／cell_removal（爆破工兵包中立移除格——消费点在 reward_grant.gd:160-161）／reward_weight_bias（奖励摇号权重偏置）／bonus_refresh（换图刷新冒险加算区——消费面在 adventure_runner／battle_orchestrator／refresh_bank） | 旧内容已裁、通道位预留；「迁移完成」收尾是否执行＝用户另行发令，本普查不动 | - -### 6. channel 域 - -数据面现值仅 `blast`（feats 2 行）；`open_ticket` 反弹行族零行（预留）。channel 值域未单点封闭（各消费分支自判值）——是否收词表＝日后的独立设计决定，本普查不动。 - -## 三、叙述脱节（唯一实质发现——注释把未入表的内容写成在役叙述） - -订正方向：注释注明「预留、未设计入表」，不动任何代码逻辑与词表。执行通道与是否执行由用户发令。 +代码注释把三件**未设计入表**的专长（掘进蓄能／深挖钻头／爆破工兵包）写成了在役叙述，后来读代码或写卡的人会被误导（迭代 53 已发生过一次：spike 承接句按注释误判「零新代码」）。订正方式＝把注释改成「预留、未设计入表」，不改任何逻辑。 | 位置 | 现行叙述 | 事实 | |---|---|---| -| effect_engine.gd OPS 头注 | mod_zero「掘进蓄能」、gte_ref/lt_ref「深挖钻头配额」 | 两专长 feats/treasure 零在表（专名 grep 零命中） | -| effect_engine.gd EFFECT_KINDS 头注 | spike 独立 kind 在词表 | 实走 modify_ticket mode="spike" 通道 | +| effect_engine.gd OPS 头注 | mod_zero「掘进蓄能」、gte_ref/lt_ref「深挖钻头配额」 | 两专长零在表 | +| effect_engine.gd EFFECT_KINDS 头注 | spike 独立 kind 在词表 | 实走 modify_ticket 的 mode 通道 | | reward_grant.gd:130 | 「counter_spend 订阅=掘进蓄能积点账本」 | 掘进蓄能零在表 | -| action_economy.gd:82 | 「深挖钻头付费开掘（dig_paid counter_spend 订阅施加面）」 | 深挖钻头零在表 | +| action_economy.gd:82 | 「深挖钻头付费开掘」 | 深挖钻头零在表 | | treasure_item_table.gd:20 | 「cell_removal = 爆破工兵包中立移除格」 | 爆破工兵包零在表 | -## 四、义务出口 +### 2. 秘宝表旧词「迁移完成」收尾——做不做、何时做 -本普查为待办清单该条的产出：内容层零孤儿、词面零清退项、零代码改动——该条不产生写卡需求；叙述订正 5 处是否执行由用户发令（执行时属注释修订，不改行为）。 +秘宝表 schema 词表里留着 9 个旧目录时代的词面（git 查证：迭代 22 秘宝批把旧目录 12 行全量换代成现役 12 件后，旧词面按 schema 自己注的「旧词保留共存至迁移完成」留下）。按关联效果列名： + +| 旧词承载的效果 | 类型 | +|---|---| +| 雷区揭示／奖励预览／行动点授予（3 个旧词形） | 新旧词共存——现役等价能力已由新词形承载 | +| 踩雷伤害减半／受击反弹伤害／开局前几轮行动点加成／爆破工兵包中立移除格／奖励摇号权重偏置／换图刷新加算区（6 个） | 旧内容已裁、通道位预留 | + +裁断点：这批「迁移完成」收尾要不要做、什么时候做。**词面现在不动**；收尾属于单独一批改动，做的时候再设计。 + +## 二、无需处理项汇总（零裁决点，计数存档） + +扫描面内以下词面全部判定**保留**（预留埋点——引擎架构＝词表先行、内容后接，加一件已有效果类型的专长/秘宝只写数据行零代码）： + +- **事件词预留 4**：armor_roll（事件岗）／reward_roll／treasure_used／seal_settle——发射点全在役运行，等订阅内容；armor_roll 另有掷点流名岗在役，同词两用。 +- **效果类型词预留 10**：spawn_spell（锻造工坊法杖设计在册待接线）；bias_rewards／counter_spend（架构在役机制承载位——偏运合计查询口／受理闸模式）；add_ticket_rider／yield_mult／apply_status／bias_wallet／refresh_pick／preview／spike 词面（预留位）。 +- **事实词预留 6**：is_first_dig_of_battle／terrain_kind（载荷特判支撑在）／target_armor_class／seals_count／nest_count／battle_index。 +- **算子词预留 7**：neq／gt／ends_with／has／mod_zero／gte_ref／lt_ref（实现函数全在）。 +- **channel 反弹行族**：open_ticket 反弹域零数据行（预留）。 + +其余全部事件词／效果词／事实词／算子词的数据面订阅行在役（feats/treasure 数据行＋天赋树规则合成行），零孤儿。 + +## 三、普查方法（存档） + +四张词表封闭在 effect_engine.gd 常量：事件 21／效果类型 31／事实 18／算子 13；邻接面＝秘宝表 schema 旧词层 10 词＋channel 域。数据面使用按行结构键（`"on"`／`"kind"`／`"fact"`／`"op"`／`"channel"`）统计自 `game/data/tables/*.tres` 全域＋天赋树规则合成行＋秘宝表主动件域；注释裸词面不计。skills.tres（敌技）的 when/fact 走独立系统，不入本普查面。