游戏 AI / 系统课时

自定义节点如何保持单一职责

自定义节点如何保持单一职责

自定义节点最容易从“小功能”长成难测试的万能类:它既查目标,又改黑板,还播放动画、扣血和发事件。本节用条件、查询、动作与副作用四类职责重新切边界,让节点更容易单测、复用,也更容易替换底层引擎实现。

学习目标

  • 区分条件、查询、动作和副作用节点各自应该负责什么。
  • 用小接口隔离感知、战斗等外部系统,避免节点直接依赖全局对象。
  • 用可测试性判断一个节点是否承担了过多职责。

先让每类节点只回答一个问题

单一职责不是要求“一个节点只能写一行代码”,而是要求它只有一个清晰的变化原因。条件节点回答“现在是否允许继续”;查询节点回答“外部世界当前是什么”;动作节点回答“这个行为执行到什么状态”;副作用则负责“把结果写到哪里或通知谁”。

条件查询动作与副作用节点的职责边界

这种划分会让问题定位更直接。攻击失败时,你可以先判断是条件拒绝、查询没有目标、动作执行失败,还是结果没有正确写回,而不是进入一个数百行节点逐段猜测。

用小接口隔开外部系统

下面的 JavaScript 示例把四类职责拆成独立对象,并通过构造参数注入感知与战斗能力。示例不依赖游戏引擎,可以直接用 Node.js 运行。

js
const Status = Object.freeze({
  SUCCESS: 'SUCCESS',
  FAILURE: 'FAILURE',
  RUNNING: 'RUNNING'
});

class NearestTargetQuery {
  constructor(perception) {
    this.perception = perception;
  }

  query() {
    return this.perception.findNearestEnemy();
  }
}

class WriteTargetEffect {
  apply(context, target) {
    context.blackboard.target = target;
  }
}

class HasTargetCondition {
  test(context) {
    return context.blackboard.target != null;
  }
}

class AttackAction {
  constructor(combat) {
    this.combat = combat;
  }

  tick(context) {
    const target = context.blackboard.target;
    return this.combat.attack(target) ? Status.SUCCESS : Status.FAILURE;
  }
}

const perception = {
  findNearestEnemy() {
    return { id: 'enemy-17' };
  }
};

const events = [];
const combat = {
  attack(target) {
    events.push(`attack:${target.id}`);
    return true;
  }
};

const context = { blackboard: { target: null } };
const query = new NearestTargetQuery(perception);
const writeTarget = new WriteTargetEffect();
const hasTarget = new HasTargetCondition();
const attack = new AttackAction(combat);

const target = query.query();
writeTarget.apply(context, target);

console.log(`Target acquired: ${context.blackboard.target.id}`);
console.log(`Has target: ${hasTarget.test(context)}`);
console.log(`Attack status: ${attack.tick(context)}`);
console.log(`Events: ${events.join(',')}`);

预期输出:

text
Target acquired: enemy-17
Has target: true
Attack status: SUCCESS
Events: attack:enemy-17

这个结构里,HasTargetCondition 不知道目标怎么被发现,NearestTargetQuery 不负责写黑板,AttackAction 也不负责重新选目标。任何一块都可以单独替换成测试桩,而不需要初始化整套游戏世界。

节点不该偷偷承担别人的工作

最常见的问题是条件节点出现副作用。例如 CanAttack 在检查距离时顺便启动寻路,或者 HasAmmo 在发现弹药不足时顺便触发换弹。这会让一次“只读判断”改变世界状态,父节点重复 Tick 时还可能把动作启动多次。

动作节点也容易越界。AttackAction 可以负责一次攻击的开始、持续轮询和取消,因为这些都属于同一个动作生命周期;但它不应该同时搜索最近敌人、选择武器、修改仇恨列表和统计战斗数据。

用可测试性验收接口设计

好的自定义节点应该可以在没有完整场景、动画系统和真实导航网格时验证。条件节点给一个黑板即可测试;查询节点注入假的感知接口即可测试;动作节点则注入假的战斗或导航接口,检查它如何映射底层结果到节点状态。

测试困难往往不是“测试框架不够强”,而是依赖边界不清。若一个节点必须先创建角色、加载动画、注册事件总线、初始化导航和生成敌人才能验证一个布尔条件,节点本身通常就太重了。

因此接口也应尽量传入它真正需要的能力,而不是一个可以访问全部系统的全局 GameManager。依赖越窄,替换成本越低,测试覆盖也越容易建立。

单一职责不等于机械拆碎

不要把每一次赋值都拆成独立节点。像 MoveTo 的“发起导航请求、后续 Tick 查询状态、收到打断时取消请求”虽然包含多个步骤,但它们共同维护一个移动动作的生命周期,放在同一个动作节点里更合理。

真正需要拆的是变化原因不同的逻辑:条件规则、世界查询、动作执行和外部副作用。节点边界稳定后,行为树本身会更像一张清晰的决策图,而不是把业务代码换一种方式塞进树节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

自定义节点如何保持单一职责

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

登录哪都通