命令模式专栏

场景加载那条主链、传送的每个阶段，都跑在它上面。 这套命令框架本身不吃业务，只解决一件事：把一堆异步步骤按顺序推进，并给出一个可 await 的最终结果。 它只有六个文件，看懂调用方怎么进来、六个件的依赖方向，就掌握了整条链的骨架。 本专栏先讲框架本身（六文件 + 关系总图），再落到两个真实案例： 场景加载的 loadwp 命令与传送的阶段命令。

1. 六个文件各是什么

2. 关系总图

先看全貌。三个横带分别是调用方 / 执行器与调度 / 命令与上下文； 中间那条带里，CommandExecutor<T> 是唯一的焦点。

2.1 六条主干怎么读

1. ① 造链 + 启动：调用方 new CommandExecutor<T>()，Init 后再 await Execute()。
2. ② 调度：CommandSystem 是全局单例，每帧按时间切片把运行中的 executor 推进一把（双向：Executor 把运行队列挂到 System，System 回过来 Tick 它）。
3. ③ 结算：执行结束时 Executor 调 CommandPromise.SetResult(result)（双向：Executor 持有 Promise，Promise 回过来兑现给 Flow）。
4. ④ 队列驱动：Executor 从队列里 PopCommandAndExecute，把命令一条条驱动起来。
5. ⑤ 结果回传：命令调 Succeed/Fail/Bail/Fatal，经 CommandSuccess/CommandFail/... 回到 Executor。（这条画成蓝色，因为它是「控制权回流」的关键。）
6. ⑥ 通道 / 预算：命令的 ThrottleControlGroupName 与 CommandBudgetGroup 对齐后，决定它进 System 的哪个时间切片通道。

另外三条紫色虚线是「泛型 T」与「await 结果」：CommandContextBase 同时被 CommandExecutor<T> 和 CommandBase<T> 约束（同一条 T）， 而 CommandPromise 兑现的结果最终回到调用方的 await 处。

3. 调用方怎么用

// 场景加载链的入口（简化）
const exec = new CommandExecutor<SceneLoadingCmdContext>();
exec.Init(context, expireTime, callbacks...);   // 绑定 context 与各类回调
exec.AddInitCommand(rootCmd);                // 构链期：InitCommand 在此展开子命令
const result = await exec.Execute();          // 交 CommandSystem 分片驱动
// result: ECommandExecutorResult（Success / Bail / Fail / Timeout / Fatal）

4. 一次执行的完整生命周期

5. 五种结果 & 七个命令状态

两个枚举别混：executor 结果是「整条链的终态」，命令状态是「一条命令的当下态」。

6. Bail 到底干了什么：终止整条链，不是跳过本条

这是最容易读错的一处。CommandBase.Bail() 的源码注释写得很清楚： 「会当即退出所有的命令执行流程，不算做失败」。它的实际路径是：

// CommandBase.ts
Bail(bailReason) → State = ECommandState.Bailed → ExecutorInternal!.CommandBail()

// CommandExecutor.ts
CommandBail() → DoExecutorBail()
DoExecutorBail():
    if (StateInternal >= Success) return;   // 已结束就不再处理
    StateInternal = Bail;
    RollbackExecutedCommands();              // 反向回滚已执行的命令
    FinishExecute(ECommandExecutorResult.Bail);

所以排查「某步好像没执行」时：看到 Succeeded 才是「被条件跳过、链继续」， 看到 Bailed 是「整条链被中止了」。这一点在 场景加载命令链 · 2.1 状态里有同款澄清。

7. TimeSlice 分片驱动

如果每条命令都同步跑完，一个重帧就能把画面卡住。框架的解法是预算化的时间切片。

• 用 RegisterTimeSliceChannel(channelName, budgetMsNormal, budgetMsLoading = 200) 注册通道；默认通道预算是 2ms（正常）/ 200ms（Loading）。
• CommandSystem.TickByTimeSlice 每帧按 IsLoading 选预算，先处理默认通道，再遍历 TimeSliceChannels。
• 每帧推进条数受 OneFrameMaxExecuteNum 限制（默认 1）。
• TickOneTimeSliceQueue 用队首 Front 取命令而非立刻 Pop——暂停的 Executor 留在队首，下一帧继续。

8. 泛型 T 与 CommandContextBase

CommandContextBase 是一次执行的共享数据 / 结果载体。 它作为泛型 T 同时约束执行器与命令：

export class CommandExecutor<T extends CommandContextBase> { ... }
export abstract class CommandBase<T extends CommandContextBase> { ... }

好处是：命令通过 context 读写共享状态时有完整类型提示，且不同链路（场景加载、传送、重连） 各有自己的 Context 子类，互不污染。Context.Dispose() 会在全部命令执行完后被调用并触发 OnDispose() 钩子。

9. CommandBudgetGroup 与限流

不是所有命令都需要限流，但大批量、单条轻、总量重的命令（实体初始化、UI 复制项）必须。 框架用「预算组」来表达这件事。

export const enum ECommandBudgetGroup {
    EntityComponentInit,     // 实体组件初始化
    EntityComponentStart,    // 实体组件 Start
    SceneInteractionShow,    // 场景交互显示
    UiCopyItem,              // UI 复制项
}

• 命令用 ThrottleControlGroupName（默认取类名）声明自己属于哪个通道。
• CanBeThrottled() 默认 false——只有同步重度逻辑才应开启。
• Cost 默认 NoneCost = 0：0 走无限制的 Round1，>0 才受预算限制（Round2）。
• CommandSystem.InitAllBudgetGroups() 目前只给 EntityComponentInit / EntityComponentStart 注册了 SetBudgetLimiter； SceneInteractionShow / UiCopyItem 是走独立通道注册的。

10. 两个案例：框架怎么落到业务链

框架只会「按序推进 + 给终态结果」，真正的复杂度在调用方怎么把业务步骤拼成一条链。 两个案例分别代表两种拼法：一个是构链期一次性展开（loadwp），一个是阶段化 + 轮次隔离（传送）。

11. 面试怎么讲