行为树工具链

入职以来覆盖面最大的工作线：行为树 Action 从十余项扩到生态 （发射子弹/毒圈/QTE/传送/集合等全在这套体系上配置）， 外加数据结构升级（OnFix 字段迁移）、事件对象池、Repeater 边界完备化、 传送阵型编辑器（方形螺旋自动排点）。 一句话定位：策划在编辑器配关卡逻辑，我维护这条生产线的每个环节。

1. 工作清单

2. 理论：四层 Action 管线

2.1 一个 Action 从配置到执行的完整链路

2.2 OnFix：配置数据的自动迁移

结构升级时老关卡数据的兼容问题。Scheme 提供 OnFix 钩子：保存旧关卡时自动把旧字段迁移到新结构。

2.3 事件对象池：GetEvent 的 pop/push 语义

3. 代码片段

3.1 OnFix：ScatterRadius → LandingConfig 自动迁移

Src\UniverseEditor\EditorCommon\Scheme\Action\LevelPlay.ts:879-891

OnFix: (value): TFixResult => {
    if (value.ScatterRadius === undefined) {
        return 'nothing';
    }
    if (value.ScatterRadius > 0 && value.LandingConfig === undefined) {
        value.LandingConfig = {
            Type: ETeleportLandingMode.RandomInRadius,
            Radius: value.ScatterRadius,
        };
    }
    delete value.ScatterRadius;
    return 'fixed';
},

3.2 GetEvent：事件对象池 + 动态扩容

Src\Game\LevelGamePlay\LevelEvents\LevelEventCenter.ts:171-213

public static GetEvent(type: string): LevelEventBase | undefined {
    const eventList = this.EventsMap.get(type);
    if (eventList) {
        if (eventList.length > 0) {
            if (this.TickEventDefines.has(type)) {
                // Tick事件组才需要pop和push操作
                const event = eventList.pop()!;
                event.Reset();
                return event;
            }
            return eventList[0];
        } else if (this.ExpendCapacityEvents.has(type)) {
            // 支持动态扩容
            const ctor = this.ExpendCapacityEvents.get(type)!;
            for (let i = 0; i < LevelEventCenterConstants.Level1; i++) {
                const event = new ctor(i);
                event.Type = type;
                eventList.push(event);
            }
            ...
            return eventList.pop();
        }
        Log.Warn(ELogModule.Level, ELogAuthor.YF, '事件组容量不足，建议扩容，请检查！！！', ['Type', type]);
    }
    return undefined;
}

3.3 Repeater：循环节点的全边界字段

Src\UniverseEditor\Interface\IBtPlan.ts:60-71

/** Repeater 的最大重复次数 */
MaxRepeatTimes?: int;
/** Repeater 的循环tick间隔(ms), 0为默认1000, 最小500 */
TickIntervalMs?: int;
/** Repeater 的无限循环开关, 勾选后忽略 MaxRepeatTimes */
IsInfiniteLoop?: boolean;
/** Repeater 的无限循环超时时间(ms), <=0为不超时, 仅无限循环生效 */
InfiniteLoopTimeoutMs?: int;
/** Repeater 的无限循环超时结果。true=节点失败。false=节点成功。默认成功 */
IsTimeoutFail?: boolean;
/** Repeater 的退出条件 */
ExitCondition?: unknown;

3.4 方形螺旋：阵型自动排点算法

Src\UniverseEditor\Editor\Common\SchemeComponent\Extend\TeleportLanding.tsx:74-103

/** 生成方形螺旋候选点偏移。 */
function GetSpiralOffset(index: number): IVectorInfo {
    if (index <= 0) {
        return { X: 0, Y: 0, Z: 0 };
    }
    const layer = Math.ceil((Math.sqrt(index + 1) - 1) / 2);
    const sideLength = layer * 2;
    const maxIndex = (layer * 2 + 1) ** 2 - 1;
    const offset = maxIndex - index;
    let gridX: number;
    let gridY: number;
    if (offset < sideLength) {
        gridX = layer - offset;
        gridY = -layer;
    } else if (offset < sideLength * 2) {
        gridX = -layer;
        gridY = -layer + (offset - sideLength);
    } else if (offset < sideLength * 3) {
        gridX = -layer + (offset - sideLength * 2);
        gridY = layer;
    } else {
        gridX = layer;
        gridY = layer - (offset - sideLength * 3);
    }
    return {
        X: gridX * TeleportLandingConstants.PointSpacingCm,
        Y: gridY * TeleportLandingConstants.PointSpacingCm,
        Z: 0,
    };
}

3.5 只补齐不截断：策划数据优先原则

Src\UniverseEditor\Editor\Common\SchemeComponent\Extend\TeleportLanding.tsx:116-144

/** 判断候选点间距。 */
function IsPointFarEnough(candidate: IVectorInfo, points: IVectorInfo[]): boolean {
    const minDistanceSquared = TeleportLandingConstants.PointSpacingCm ** 2;
    return points.every((point) => {
        const deltaX = (candidate.X ?? 0) - (point.X ?? 0);
        const deltaY = (candidate.Y ?? 0) - (point.Y ?? 0);
        const deltaZ = (candidate.Z ?? 0) - (point.Z ?? 0);
        return deltaX * deltaX + deltaY * deltaY + deltaZ * deltaZ >= minDistanceSquared;
    });
}

/** 仅补齐阵型点，不截断用户已配置的点。 */
function AdjustFormationPoints(existing: IVectorInfo[], count: number, anchor: IPosA): IVectorInfo[] {
    const result = existing.slice();
    while (result.length < count) {
        result.push(PickFormationPoint(result, anchor));
    }
    return result;
}

4. 面试怎么讲