From 7b6bbea9cf92fd67cd629f5ac3bb7ac57c0a5267 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 8 Nov 2026 00:45:41 +0800 Subject: [PATCH] =?UTF-8?q?=E6=99=AE=E6=9F=A5(=E6=95=88=E6=9E=9C=E9=80=9A?= =?UTF-8?q?=E9=81=93=E4=B8=8E=E4=BA=8B=E4=BB=B6=E8=AF=8D=E9=9B=B6=E7=8E=B0?= =?UTF-8?q?=E5=BD=B9=C2=B7=E9=87=8D=E6=A0=B8):=20=E6=8C=89=2011-06=20?= =?UTF-8?q?=E4=BC=9A=E8=AF=9D=E7=BA=A0=E6=AD=A3=E5=8F=A3=E5=BE=84=E9=87=8D?= =?UTF-8?q?=E8=B7=91=E2=80=94=E2=80=94=E5=8F=AA=E6=A0=B8=E6=9C=AA=E6=8C=82?= =?UTF-8?q?=E8=BD=BD=E5=A4=84=E7=90=86=E9=80=BB=E8=BE=91=E3=80=81=E8=AF=8D?= =?UTF-8?q?=E9=9D=A2=E5=85=88=E7=BB=99=E4=BE=9D=E6=8D=AE=E7=BB=93=E8=AE=BA?= =?UTF-8?q?=E3=80=81=E7=A7=98=E5=AE=9D=E6=97=A7=E8=AF=8D=E6=8C=89=E5=85=B3?= =?UTF-8?q?=E8=81=94=E7=A7=98=E5=AE=9D=E4=B8=8E=E6=95=88=E6=9E=9C=E9=80=90?= =?UTF-8?q?=E4=B8=AA=E4=BB=8B=E7=BB=8D=E3=80=81=E6=8A=A5=E5=91=8A=E5=8F=AA?= =?UTF-8?q?=E5=88=86=E9=9C=80=E8=A3=81=E6=96=AD/=E6=97=A0=E9=9C=80?= =?UTF-8?q?=E5=A4=84=E7=90=86=E4=B8=A4=E6=AE=B5;=20=E7=BB=93=E8=AE=BA=3D?= =?UTF-8?q?=E9=9B=B6=E4=B8=AA=E6=9C=AA=E6=8C=82=E8=BD=BD=E9=80=9A=E8=B7=AF?= =?UTF-8?q?=E3=80=81=E5=9B=9B=E7=BB=84=E5=B0=81=E9=97=AD=E8=AF=8D=E8=A1=A8?= =?UTF-8?q?=E9=9B=B6=E8=AE=A2=E9=98=85=E9=A1=B9=E5=85=A8=E5=B1=9E=E9=A2=84?= =?UTF-8?q?=E7=95=99=E6=88=96=E5=9C=A8=E5=BD=B9=E8=90=BD=E7=82=B9=E3=80=81?= =?UTF-8?q?=E5=94=AF=E4=B8=80=E9=9B=B6=E4=BE=9D=E6=8D=AE=E8=AF=8D=E9=9D=A2?= =?UTF-8?q?=20bias=5Fwallet=20=E5=91=88=E6=8A=A5=E5=BE=85=E8=A3=81;=20?= =?UTF-8?q?=E7=A7=98=E5=AE=9D=E8=A1=A89=E6=97=A7=E8=AF=8D=E5=BD=A2?= =?UTF-8?q?=E7=8E=B0=E8=A1=8C=E6=95=B0=E6=8D=AE=E8=A1=8C=E9=9B=B6=E5=BC=95?= =?UTF-8?q?=E7=94=A8+=E6=B5=8B=E8=AF=95=E5=A4=B9=E5=85=B7=E8=BF=9E?= =?UTF-8?q?=E5=B8=A6=E9=9D=A2=E5=9C=A8=E6=A1=88;=20=E6=97=A7=E7=89=88?= =?UTF-8?q?=E3=80=8E=E4=B8=89=E6=97=A7=E8=AF=8D=E5=BD=A2=E5=9D=87=E6=9C=89?= =?UTF-8?q?=E7=8E=B0=E5=BD=B9=E6=89=BF=E8=BD=BD=E3=80=8F=E4=B8=80=E5=8F=A5?= =?UTF-8?q?=E6=8C=89=20preview=20=E5=B1=9E=E4=B8=BB=E5=8A=A8=E4=BB=B6?= =?UTF-8?q?=E9=80=9A=E9=81=93=E4=BF=AE=E6=AD=A3;=20=E8=AF=8D=E9=9D=A2/?= =?UTF-8?q?=E6=B3=A8=E9=87=8A/=E5=BE=85=E5=8A=9E=E6=B8=85=E5=8D=95/roadmap?= =?UTF-8?q?=20=E6=9C=AC=E6=AD=A5=E9=9B=B6=E6=94=B9=E5=8A=A8=E3=80=82?= =?UTF-8?q?=E6=9C=AC=E6=AD=A5=E5=87=AD=E6=8D=AE:=20run=5Fall=5Fgates.sh=20?= =?UTF-8?q?--docs=E3=80=90=E9=AA=8C=E6=94=B6=E9=80=9A=E8=BF=87=E3=80=91?= =?UTF-8?q?=E9=97=B8=E5=86=B5=E4=B8=8E=E5=9F=BA=E7=BA=BF=E4=B8=80=E8=87=B4?= =?UTF-8?q?=E6=97=A0=E6=96=B0=E5=A2=9E=E7=BA=A2(=E5=8F=98=E6=9B=B4?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E8=8A=82/doc=5Flink/doc=5Fterm/=E6=B5=81?= =?UTF-8?q?=E6=B0=B4=E7=BA=BF=E9=97=B8/=E5=BC=95=E7=94=A8=E5=8F=AF?= =?UTF-8?q?=E6=A0=B8/=E8=83=BD=E5=8A=9B=E5=AE=A1=E8=AE=A1/=E7=86=B5?= =?UTF-8?q?=E5=A2=9E=E9=97=B8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...-效果通道与事件词零现役-重核-2026-11-08.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 reports/普查-效果通道与事件词零现役-重核-2026-11-08.md diff --git a/reports/普查-效果通道与事件词零现役-重核-2026-11-08.md b/reports/普查-效果通道与事件词零现役-重核-2026-11-08.md new file mode 100644 index 00000000..42ef0f75 --- /dev/null +++ b/reports/普查-效果通道与事件词零现役-重核-2026-11-08.md @@ -0,0 +1,52 @@ +# 普查：效果通道与事件词零现役（重核 2026-11-08） + +> 接收方：待办清单「效果通道与事件词的零现役普查」条。本报告取代 11-06 版结论；旧报告只作历史取证。 +> 本次口径（取自 11-06 会话中你的纠正）：不把「零使用的预留埋点」列成待删候选；只核「定义了处理逻辑却没有挂载、没人消费」的通路；词面先给「有依据／无依据」的事实结论；秘宝表旧词按关联的秘宝与效果介绍；报告只分「需你裁断」与「无需处理」两段。 +> 结论坐实前词表一字未动。本次只写报告，未改注释、词面、待办清单与路线图。 + +## 一、需要你裁断的两件事 + +### 1. 秘宝表 9 个旧词面的「迁移完成」收尾——请你裁动哪些 + +收尾这件事本批要做；这里只请你定范围，不代裁。词面现在仍在 `game/data/schemas/treasure_item_table.gd:25-28`，第 24 行仍写着「旧词保留共存至迁移完成」。9 个旧词形在 `game/data/tables/*.tres` 现行数据行里全部零引用；`ap_charge_safe` 有 1 行在役，不在这 9 个里。 + +| 词面 | 关联的旧秘宝 | 旧效果（玩家看得懂的说法） | 现在谁还在用 | +|---|---|---|---| +| mine_reveal | 探巢摆钟、爆破工兵包 | 真视 3×3（揭示一小片格子） | 现行数据行 0；测试假数据行 5 处 | +| reward_preview | 探宝罗盘 | 预读 3×3（提前看一小片奖励） | 现行数据行 0；测试假数据行 2 处 | +| ap_grant | 工兵令、爆破工兵包 | 一次给 2 点或 4 点行动点 | 现行数据行 0；测试假数据行 1 处 | +| mine_hit_halve | 惊巢反制 | 踩到危险格时伤害减半 | 零引用 | +| reflect_damage | 惊巢反制 | 受击时反弹 2 点伤害 | 零引用 | +| ap_rounds_front | 工兵晨令 | 开局前 3 轮每轮多 1 点行动点 | 零引用 | +| cell_removal | 爆破工兵包 | 中立移除危险格（不引爆、不揭示） | 现行数据行 0；测试假数据行 1 处 | +| reward_weight_bias | 偏运硬币 | 稀有资源在摇号里权重 +2 | 零引用 | +| bonus_refresh | 三选一刷新件 | 三选一多一次刷新 | 零引用 | + +**旧版结论里要修正的一句**：11-06 报告说前三个旧词形「现役等价能力已由新词形承载」。本次核对：`reveal_tiles` 有 6 行数据、`grant_ap` 有 5 行，`preview` 现行数据行 0，但 `preview` 属主动件通道、不经事件订阅（`game/core/effect_engine.gd:85-88`）。所以「三个都有现役承载」不成立，第三个只能算通道位在册。 + +**收尾的连带面**：摘除旧词形后，测试里的假数据行要改用现役词形，否则单元测试会红（`game/tests/unit/core/treasure_items_test.gd:34/36/85-90`、`treasure_effects_test.gd:173/259`）。摘除本身对现行游戏行为零影响（现行数据行零引用），且误写旧词会在加载期被判出域，比留着死词面安全。 + +### 2. 效果类型词里一项「零依据」的事实结论——请你裁是否处理 + +9 个零订阅效果词逐个核过，结论如下（词面现在都不动）： + +- 有在役落点：`add_ticket_rider`（`game/core/damage_controller.gd:361`）、`yield_mult`（`game/core/settlement/grant_segment.gd:118`）、`apply_status`（`game/core/damage_controller.gd:391`）、`counter_spend`（`game/core/action_economy.gd:115`）、`bias_rewards`（`game/core/battle_fx_host.gd:131`）、`spawn_spell`（`game/core/settlement/grant_segment.gd:138`）。 +- 通道位在册、不经订阅：`refresh_pick`、`preview`（`game/core/effect_engine.gd:85-88` 主动件分发）；`spawn_spell` 另有设计在册（`design/gdd/systems/跨局循环/锻造工坊.md:115` 法杖）。 +- `bias_wallet`：本次全库核对零实现消费点、零数据行订阅、零设计文档句；出处只到效果引擎框架落地提交 `7d157b3c` 的「任务书 §3.3 定稿 24 型」（`game/core/effect_engine.gd:26/30` 词表与头注）。 + +按你 11-06 00:16 的口径「有依据的保留、乱写的不能保留」，这一项是本次唯一查不到落点的词面。是否处理、怎么处理归你裁；本报告不提删，也不把它列成待办。 + +## 二、无需处理项（只留计数，不列清单） + +- 事件词 4 个零订阅、事实词 5 个、算子词 7 个：属引擎预留埋点与条件查询面，发射点、实现函数、头注都在役；按你 11-06 00:16 的纠正，不列成候选、不提删。 +- 效果词里 8 个零订阅项：全部有在役落点或设计在册，见第一节第 2 项。 +- **本次未发现「定义了处理逻辑却没实际挂载、也没人消费」的通路。** + +## 三、取证与方法（存档） + +- 四组封闭词表：`game/core/effect_engine.gd:12-18`（事件 21）／`:28-51`（效果 31）／`:58-62`（事实 18）／`:69-70`（算子 13）。 +- 订阅面：`game/data/tables/*.tres` 全域的 `on`／`kind`／`fact`／`op` 行，加 `game/core/effect_engine.gd:145-174` 天赋树规则合成行。 +- 发射面：`game/core/battle_fx_host.gd:71-79`（统一分发入口）、`:128-133`（偏运权重查询）。 +- 旧秘宝目录行：迭代 22 提交 `48b06961` 的父版 `game/data/tables/treasure_items.tres:12-166`；退役去向与效果一句话另见 `design/content-archive/道具退役素材库.md:12-25`。 +- 注释叙述节：现行 `game/` 下「掘进蓄能／深挖钻头／爆破工兵包」零命中（旧报告第一节仍把它们写成现行叙述，合入提交 `7bbde052` 已注明待订正）。 +- 错判修正留痕：`yield_mult`、`spawn_spell` 初判「零消费点」，全库复核（含 `game/core/settlement/` 子目录）后改判为在役落点，未把初判写进结论。