template/docs/dev/map/trigger-impl.md

需求综述

触发器系统主体已经完成，下一步开始逐步补充内置触发器类型。当前第一批只先设计两个最基础的内置触发器：战斗触发器与开门触发器。

本文只确认这两个类型的职责、使用频率预期与当前待补充的设计边界，不展开实现思路，也不列涉及文件。后续如果继续新增对话、商店、自定义事件等内置触发器，再在此文档上继续补充即可。

---

共通约束

这两个内置触发器都只是 ITrigger 的内置实现。当前阶段不建议先给它们增加额外公共配置成员，怪物信息、门信息原则上应跟随当前触发位置上的图块或运行时载体，而不是在触发器实例里重复保存一份。

• type：预期频率低频。由注册表和类型定义决定，通常只在注册、调试或排查问题时关注。
• priority：预期频率低频。大多数情况下使用固定默认值即可，只有极少数“同格混合触发”场景才需要显式调整。
• trigger(handler)：预期频率中频。平时更多通过 ITriggerCollection.trigger(...) 间接触发，直接持有某个内置触发器并手动调用的场景相对有限。
• collection()：预期频率中频。继承 ITrigger 的统一包装能力，使用方式与其他触发器一致，这里不做额外语义扩展。

---

类型设计与预期

战斗触发器（暂定 IBattleTrigger）

• 核心职责：在当前触发位置执行一次与怪物的战斗。
• IBattleTrigger.trigger(handler)：预期频率中频。典型使用场景：玩家移动到怪物格后，移动系统收集到该触发器并交给集合统一触发；或脚本手动触发某个战斗事件。
• 校验要求：触发前必须确认当前指定图块或对应的运行时载体确实是怪物。若不是怪物，发出警告并终止本次触发，不进入战斗流程。
• 数据要求：需要能从当前触发位置解析出“这是怪物”这一事实，以及后续进入战斗流程所需的怪物信息。
• 职责边界：该触发器当前只先负责“确认目标是怪物并进入战斗分支”。战斗后怪物移除、地图更新、事件派发等后续职责，先不在本文中拍死。

开门触发器（暂定 IOpenDoorTrigger）

• 核心职责：在当前触发位置执行一次开门行为。
• IOpenDoorTrigger.trigger(handler)：预期频率中频。典型使用场景：玩家撞到门格或主动交互门格后，系统收集到该触发器并尝试开门；或脚本在演出中手动触发某扇门的开启。
• 校验要求：触发前必须确认当前指定图块或对应的运行时载体包含门相关信息。若不包含，发出警告并终止本次触发，不执行开门行为。
• 数据要求：需要能从当前触发位置读取门相关信息，并定位到既有的 openDoor 流程。
• 职责边界：该触发器当前只先负责“确认目标是门并进入开门分支”。钥匙校验、动画等待、图块替换、开门后事件等具体流程，先依附既有开门系统，不在本文中提前拆开。

---

当前待补充设计

1. 运行时需要一条统一路径，让触发器能从 handler 提供的上下文中读取当前位置对应的怪物信息或门信息；这一层目前还没有最终定稿。
2. 这两个内置触发器原则上都不应在实例上重复保存业务对象；更合理的方向是由当前位置的图块或运行时载体提供数据。若后续发现这条路线不够用，再单独讨论是否为内置触发器补配置成员。
3. 这两个触发器当前都只先定义“校验 + 进入对应系统”的第一层职责。后续如果需要细分成更多内置类型，例如强制战斗、免钥匙开门、条件开门等，再在这个基础上继续扩展。