bl/docs/effect-refactor-summary-2026-03-28.md

Effect 重构会话总结（2026-03-28）

1. 本次会话完成内容

1.1 注释与说明统一

• 已将 logic/service/fight/effect 下效果注释统一为：
  • // Effect <id>: <desc>
• 说明来源：
  • public/config/effectInfo.json

1.2 结构整理与公共能力抽取

• 新增并使用了子效果统一挂载 helper：
  • addSubEffect(...)
• 已清理 effect 目录中的 GenSub(...) 直接调用残留，统一走 helper。

1.3 回合类基类（组合继承）已落地

• 当前已引入的 base（位于 logic/service/fight/effect/sub_effect_helper.go）：

  • RoundEffectArg0Base
  • RoundEffectSideArg0Base
  • FixedDuration1Base
  • FixedDurationNeg1Base
  • FixedDuration2Base
  • RoundEffectArg1Base
  • RoundEffectSideArg1Base
  • RoundEffectSideArg0Minus1Base
  • RoundEffectSideArg0Minus1CanStackBase

• 已有大量效果结构体改为嵌入上述 base，删除重复 SetArgs 模板代码。

1.4 编译状态

• 已多轮执行并通过：
  • go test ./logic/service/fight/effect

1.5 本轮新增 effect 实现

• 新增缺失效果实现：

  • 400 若和对手属性相同，则技能威力翻倍
  • 480 {0}回合内自身所有攻击威力为两倍
  • 586 {0}回合内自己的属性攻击必中
  • 599 {0}回合内受到{1}伤害减少{2}%
  • 610 遇到天敌时先制+{0}
  • 611 下{0}回合自身使用攻击技能则附加{1}点固定伤害
  • 613 {0}回合内自身令对手使用的{1}系攻击技能无效

• 已同步更新：

  • logic/service/fight/effect/effect_info_map.go

1.6 本轮新增文件

• logic/service/fight/effect/400_480_586_599_610_611_613.go
• logic/service/fight/effect/effect_info_map.go

1.7 本轮验证

• 已执行：
  • go test ./service/fight/effect
• 结果：
  • 通过

1.8 本轮结论

• 当前这轮更适合按“低风险、可复用现有模式”的 effect 小批次推进，而不是一次性追求 effectInfo.json 全量覆盖。
• 现有 effect 目录里已经有不少“共享实现 + 批量注册”的写法，后续判断缺失项时不能只靠 grep InitEffect(...)。
• 文档第 3 节里的“未实现”列表目前仍是历史扫描快照，只能作为候选列表，不能直接当最终事实使用。

---

2. 当前仍保留自定义 SetArgs 的效果（建议下一轮重点）

以下属于“非纯模板”或“仍待抽象”的 SetArgs：

• Effect570（570.go）
• Effect123（effect_119_123.go）
• Effect41（effect_41.go）
• Effect42（effect_42.go）
• Effect46（effect_46.go）
• Effect47（effect_47.go）
• Effect48（effect_48.go）
• Effect60（effect_60.go）
• EffectPropSyncReverse（effect_attr.go）
• SelfKill（selfkill.go）

建议分三类继续抽 base：

• 随机回合/随机次数类（如 41、42）
• 次数型常驻类（如 46、47、48、SelfKill、570）
• “SetArgs + 额外上下文初始化”类（如 Effect123、EffectPropSyncReverse）

---

3. 未实现（或疑似未实现）效果清单

3.0 从 effectInfo.json 提取的“未实现”总览（自动扫描）

• JSON 配置总效果数：2112
• 代码已注册效果数（Skill）：338
• JSON 中存在但代码未注册：1779
• 代码中注册但 JSON 无对应条目：5（21, 31, 41, 42, 174）

说明：

• 这个口径是“配置覆盖率”，不是“bug 数量”。
• 其中大量属于未来版本/未迁移内容，不建议一次性全补；建议按战斗系统实际启用范围分批实现。
• 以下列表为上一轮扫描快照，未随本轮新增实现实时回算。
• 此外，扫描脚本若未把“共享实现中的批量注册”统计进去，也会把已实现效果误判成缺失。

JSON 中存在但代码未注册（示例前 60 项）：

• 2, 10, 11, 12, 14, 15, 16, 17, 22, 30
• 38, 40, 45, 51, 55, 56, 61, 64, 66, 67
• 70, 78, 84, 86, 92, 94, 96, 97, 99, 102
• 103, 104, 106, 108, 109, 114, 118, 132, 133, 139
• 141, 158, 162, 167, 168, 185, 401, 421, 431, 529
• 543, 554, 569, 573, 581, 582, 583, 584, 585, 586

3.1 明确标记未实装

• 文件存在明确标记：
  • logic/service/fight/effect/529.go未实装

3.2 已注册但缺少同名 Effect{id} 结构体（需人工确认是否由合并实现覆盖）

• 53
• 74
• 75
• 186
• 402
• 433
• 446
• 451
• 463
• 497
• 564
• 588

说明：

• 这类通常可能是“多个 id 共用一个结构体实现”或“命名与 id 不一致”，需要逐个确认是否真正缺失行为。

3.3 疑似未实现（扫描规则：存在 Effect{id} 类型，但没有核心战斗 Hook）

• 519（effect_519.go）
• 532（532.go）
• 552（552.go）
• 560（560.go）
• 576（576.go）

说明：

• 这批是“高优先级人工复查项”，不一定真的没实现，可能通过组合/间接机制生效。

3.4 当前更可信的“下一批候选”

这一组是结合本轮人工核对后，仍然值得优先继续补的缺失 effect 候选：

• 401
• 573
• 585
• 587
• 589
• 590
• 591
• 592
• 593
• 594
• 595
• 596
• 597
• 598

说明：

• 这批大多是 58x/59x 段的新效果，和当前目录中已有实现重叠较少。
• 相比继续深挖旧扫描误差，这批更适合直接新增文件推进。

---

4. 下次继续的建议顺序

建议严格按下面顺序继续，不要重新从全量扫描开始：

1. 先复核文档 3.4 里的候选项是否仍未实现。
2. 优先补“单次触发、命中附加、固定伤害、恢复、概率状态”这类低风险逻辑。
3. 再处理“复制对手状态 / 多分支条件 / 触发链式子效果”的 58x/59x 复杂效果。
4. 最后再回头处理文档 2 中那些仍保留自定义 SetArgs 的结构整理。

本轮更推荐的下一批实现顺序：

• 第一组：587 / 591 / 592 / 597 / 598
• 第二组：573 / 585 / 594 / 595 / 596
• 第三组：589 / 590 / 593

---

5. 下一次继续让我实现时可直接复制的指令

可直接用下面这句发起：

继续处理 effect，按 docs/effect-refactor-summary-2026-03-28.md 的 3.4 和 4 执行：先补 587/591/592/597/598，再补 573/585/594/595/596，每实现一批就更新同一文档和 effect_info_map.go，并跑 go test ./service/fight/effect。

如果你希望按 JSON 覆盖率推进，可用这句：

继续处理 effect，按 docs/effect-refactor-summary-2026-03-28.md 的 3.0 从低风险效果开始补实现：先补状态附加类（10/11/12/14/15/16/94/99/103/114），每实现一批就更新文档中的“已实现列表”和“剩余列表”。

---

6. 扫描口径说明（供后续排查）

• 已注册效果 ID 扫描来源：
  • InitEffect(input.EffectType.Skill, <id>, ...)
  • initskill(<id>, ...)
• 但这还不够，后续扫描必须额外统计这些“共享实现/批量注册”文件：
  • sterStatusEffects.go
  • effect_power_doblue.go
  • EffectAttackMiss.go
  • EffectPhysicalAttackAddStatus.go
  • EffectDefeatTrigger.go
  • effect_attr.go
  • effect_EffectConditionalAddDamage.go
  • effect_74_75.go
  • effect_104_109.go
• Effect{id} 结构体与方法扫描来源：
  • logic/service/fight/effect/*.go
• “疑似未实现”判断是启发式，不是最终结论，仍需代码级确认。

---

7. 这次改动涉及的关键文件

• public/config/effectInfo.json
• logic/service/fight/effect/400_480_586_599_610_611_613.go
• logic/service/fight/effect/effect_info_map.go
• logic/service/fight/effect/sub_effect_helper.go
• docs/effect-refactor-summary-2026-03-28.md