游戏 AI / 系统课时

新增阶段时哪些接口不能变

新增阶段时哪些接口不能变

Boss AI 真正难以扩展的问题,往往不是新增状态本身,而是新阶段一加入就迫使事件、决策和执行代码一起修改。本文把阶段、决策和事件之间的稳定接口整理成明确边界,让同一套战斗框架可以复用到不同 Boss 和更多阶段。

学习目标

  • 能识别 Boss 阶段扩展时必须保持稳定的接口
  • 能设计阶段、决策与事件之间的最小输入输出契约
  • 能用一个新增阶段案例验证旧代码是否仍可复用

先固定边界,再增加阶段

新增阶段时,最容易失控的是直接给当前状态机增加一个特殊分支,例如“进入第三阶段后事件格式不同”或“第三阶段需要另一套决策函数”。这种做法短期有效,但每增加一个阶段都会扩大调用方的分支数量。

更稳定的做法是先约定三类接口。阶段状态只描述“现在处于什么阶段以及阶段相关状态”;决策器接收统一的战斗上下文并返回统一的动作选择;事件系统只负责提供可识别的战斗事实。阶段可以增加,接口形状尽量不要跟着变化。

Boss 阶段、事件与决策接口的稳定边界

阶段接口应该保持什么

阶段接口的核心是让外部系统只依赖稳定状态,而不是依赖某个具体阶段的内部规则。最小形式可以是 phaseId、阶段计时和必要的进入时间戳或标志位。阶段内部到底有几张攻击表、多少技能,不应该泄漏给事件生产者或执行器。

例如,决策器可以始终接受同一个 DecisionContext。无论当前是 phase_1、phase_2 还是 enraged,调用方都提供相同字段。这样测试代码、调试工具和战斗循环都不需要知道新阶段的细节。

决策接口不要随着阶段增加而分叉

决策接口最重要的稳定性来自输入和输出。输入应该描述“当前战斗事实”,例如生命比例、目标距离、冷却状态和当前阶段;输出则只描述“选中了哪个动作以及必要的决策信息”。阶段差异通过配置和规则体现,而不是通过不同函数名体现。

下面用 Python 展示一个最小接口。代码中的 DecisionContext 可以由任意阶段产生,但 decide() 的调用方式保持一致。

python
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))

预期输出

text
meteor

这里最关键的不是 Python 类型写法,而是接口关系:decide() 没有 if phase_id == "phase_3"。新增阶段后,旧调用方式仍然成立,测试也可以通过替换配置覆盖更多场景。

事件接口只表达事实

事件接口容易被阶段逻辑污染。例如不要让事件直接发送“切换到狂暴阶段”这种只对某个 Boss 有意义的命令,而应尽可能表达稳定事实,如 shield_broken、timer_elapsed 或某个带唯一标识的技能命中事件。阶段系统根据事实和当前规则决定是否发生迁移。

这样做可以避免事件生产者知道阶段拓扑。战斗系统只需要发布事实,新增阶段时由阶段规则决定如何解释这些事实,原有事件来源无需修改。

用新增阶段检查接口是否真的稳定

可以用四个问题做扩展验收:新增阶段是否只增加配置或状态定义;现有决策入口的参数是否保持不变;现有事件类型是否可以继续使用;执行器是否仍接受相同的动作结果格式。只要其中任意一项必须新增专用分支,就应检查是不是把阶段特例泄漏到了错误的层。

稳定接口并不意味着所有字段永远不能增加,而是调用方依赖的核心契约应该保持兼容。新增可选字段通常比修改已有字段语义更安全;改变字段含义、删除必需字段或让新阶段返回完全不同的动作类型,都会让扩展成本快速上升。

当阶段、决策和事件都围绕稳定契约协作时,增加一个新阶段就从“修改整套 Boss AI”变成“增加一种合法状态和它的数据”。这正是可扩展 Boss AI 的边界:内容可以快速增长,而基础调用关系保持可预测。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

新增阶段时哪些接口不能变

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通