游戏 AI / 系统课时
新增阶段时哪些接口不能变
新增阶段时哪些接口不能变
Boss AI 真正难以扩展的问题,往往不是新增状态本身,而是新阶段一加入就迫使事件、决策和执行代码一起修改。本文把阶段、决策和事件之间的稳定接口整理成明确边界,让同一套战斗框架可以复用到不同 Boss 和更多阶段。
学习目标
- 能识别 Boss 阶段扩展时必须保持稳定的接口
- 能设计阶段、决策与事件之间的最小输入输出契约
- 能用一个新增阶段案例验证旧代码是否仍可复用
先固定边界,再增加阶段
新增阶段时,最容易失控的是直接给当前状态机增加一个特殊分支,例如“进入第三阶段后事件格式不同”或“第三阶段需要另一套决策函数”。这种做法短期有效,但每增加一个阶段都会扩大调用方的分支数量。
更稳定的做法是先约定三类接口。阶段状态只描述“现在处于什么阶段以及阶段相关状态”;决策器接收统一的战斗上下文并返回统一的动作选择;事件系统只负责提供可识别的战斗事实。阶段可以增加,接口形状尽量不要跟着变化。

阶段接口应该保持什么
阶段接口的核心是让外部系统只依赖稳定状态,而不是依赖某个具体阶段的内部规则。最小形式可以是 phaseId、阶段计时和必要的进入时间戳或标志位。阶段内部到底有几张攻击表、多少技能,不应该泄漏给事件生产者或执行器。
例如,决策器可以始终接受同一个 DecisionContext。无论当前是 phase_1、phase_2 还是 enraged,调用方都提供相同字段。这样测试代码、调试工具和战斗循环都不需要知道新阶段的细节。
决策接口不要随着阶段增加而分叉
决策接口最重要的稳定性来自输入和输出。输入应该描述“当前战斗事实”,例如生命比例、目标距离、冷却状态和当前阶段;输出则只描述“选中了哪个动作以及必要的决策信息”。阶段差异通过配置和规则体现,而不是通过不同函数名体现。
下面用 Python 展示一个最小接口。代码中的 DecisionContext 可以由任意阶段产生,但 decide() 的调用方式保持一致。
from dataclasses import dataclass
@dataclass
class DecisionContext:
phase_id: str
health_ratio: float
target_distance: float
ready_skills: list[str]
def decide(context: DecisionContext, phase_config: dict) -> str | None:
# 决策器只依赖稳定上下文和阶段配置,不为具体阶段增加分支。
candidates = []
config = phase_config[context.phase_id]
for skill in config["skills"]:
if skill not in context.ready_skills:
continue
rule = config["distanceRules"].get(skill, {})
if "min" in rule and context.target_distance < rule["min"]:
continue
if "max" in rule and context.target_distance > rule["max"]:
continue
candidates.append(skill)
if not candidates:
return None
return max(candidates, key=lambda skill: config["weights"][skill])
CONFIG = {
"phase_1": {
"skills": ["slash"],
"weights": {"slash": 1},
"distanceRules": {"slash": {"max": 3.0}},
},
"phase_3": {
"skills": ["meteor"],
"weights": {"meteor": 5},
"distanceRules": {"meteor": {"min": 6.0}},
},
}
if __name__ == "__main__":
context = DecisionContext(
phase_id="phase_3",
health_ratio=0.2,
target_distance=8.0,
ready_skills=["meteor"],
)
print(decide(context, CONFIG))预期输出
meteor这里最关键的不是 Python 类型写法,而是接口关系:decide() 没有 if phase_id == "phase_3"。新增阶段后,旧调用方式仍然成立,测试也可以通过替换配置覆盖更多场景。
事件接口只表达事实
事件接口容易被阶段逻辑污染。例如不要让事件直接发送“切换到狂暴阶段”这种只对某个 Boss 有意义的命令,而应尽可能表达稳定事实,如 shield_broken、timer_elapsed 或某个带唯一标识的技能命中事件。阶段系统根据事实和当前规则决定是否发生迁移。
这样做可以避免事件生产者知道阶段拓扑。战斗系统只需要发布事实,新增阶段时由阶段规则决定如何解释这些事实,原有事件来源无需修改。
用新增阶段检查接口是否真的稳定
可以用四个问题做扩展验收:新增阶段是否只增加配置或状态定义;现有决策入口的参数是否保持不变;现有事件类型是否可以继续使用;执行器是否仍接受相同的动作结果格式。只要其中任意一项必须新增专用分支,就应检查是不是把阶段特例泄漏到了错误的层。
稳定接口并不意味着所有字段永远不能增加,而是调用方依赖的核心契约应该保持兼容。新增可选字段通常比修改已有字段语义更安全;改变字段含义、删除必需字段或让新阶段返回完全不同的动作类型,都会让扩展成本快速上升。
当阶段、决策和事件都围绕稳定契约协作时,增加一个新阶段就从“修改整套 Boss AI”变成“增加一种合法状态和它的数据”。这正是可扩展 Boss AI 的边界:内容可以快速增长,而基础调用关系保持可预测。