技能监听器

同一句「监听技能」在项目里是两套独立体系： 任务侧的 SkillListen 条件（监听全队玩家技能的 释放/命中/完成三态，监听目标用「技能集合」间接描述，服务器权威判定）； 战斗侧的 SkillGroupObject 结束监听 （技能组 Casting 状态靠 CastSkill/BuffEnd 条件收尾， 三个 Set 聚合 + 目标级订阅 + 回调四重防御）。

1. 工作清单

2. 理论：两层监听架构与防御性回调

2.1 两层监听：判定方不同，写法就不同

2.2 技能集合：监听目标的间接引用

任务配置里不直接写技能 ID 数组，而是写一个行名， 指向 DT_SkillCollectionForLevel 的一行， 行内含技能 ID、技能类型、技能 Tag 三个维度：

2.3 战斗侧订阅纪律：聚合 → 按需注册 → 成对反注册

2.4 回调四重防御：每层拦截不同来源的脏事件

3. 代码片段

3.1 任务侧配置结构：三态 + 技能集合 + 可选目标

Src\UniverseEditor\Interface\IQuest.ts:1286-1307

/** 技能监听的技能状态 */
export const enum ESkillListenState {
    /** 释放 */
    Cast = 'Cast',
    /** 命中 */
    Hit = 'Hit',
    /** 完成，技能取消视为完成 */
    Finish = 'Finish',
}

/**
 * 技能监听：监听全队玩家技能的释放/命中/完成事件。
 * 监听目标由「技能集合」描述，即 DT_SkillCollectionForLevel 的一行，行内含技能Id、技能类型、技能Tag。
 */
export interface ISkillListenCondition extends IQuestCondition<EChildQuest.SkillListen> {
    /** 技能集合行名，对应 DT_SkillCollectionForLevel */
    SkillCollection: string;
    /** 技能状态 */
    SkillState: ESkillListenState;
    /** 目标实体，可置空；仅「命中」时判定监听目标与技能目标是否一致 */
    TargetEntityId?: int;
}

3.2 运行时归属：SkillListen 挂服务器达成型节点

Src\Game\Module\GeneralLogicTree\Define\NodeTypeDefine.ts:104-108（节选）

[EChildQuest.CheckGeneralMoveMoving]: new NodeTypeData(ServerAchieveChildQuestNode),
[EChildQuest.CheckGeneralMoveArrive]: new NodeTypeData(ServerAchieveChildQuestNode),
[EChildQuest.CheckGeneralMoveSectionFinished]: new NodeTypeData(ServerAchieveChildQuestNode),
[EChildQuest.SkillListen]: new NodeTypeData(ServerAchieveChildQuestNode),

3.3 战斗侧聚合与按需注册

Src\Game\World\Entity\Skill\SkillGroup\SkillGroupObject.ts:144-193（节选）

private InitCtStateListeners(): void {
    this.StateInternal = ESkillGroupState.Ready;
    this.ListenSkillIds.clear();
    this.ListenBuffIds.clear();
    this.ListenTags.clear();

    const catcher = EntityInterfaceHelper.GetEntityHandleByLocalEntityId(this.EntityId);
    if (!catcher) {
        Log.Error(ELogModule.Battle, ELogAuthor.CZL,
            'SkillGroupObject::InitCtStateListeners Entity不存在，无法注册监听',
            ['EntityId', this.EntityId],
        );
        return;
    }

    this.ConfigInternal!.StateLogic.EndConditions.forEach((endCondition) => {
        switch (endCondition.ConditionType) {
            case UE.ESkillGroupEndStateConditionType.CastSkill:
                for (const skillId of endCondition.CastSkill.SkillIds) {
                    this.ListenSkillIds.add(skillId);
                }
                break;
            case UE.ESkillGroupEndStateConditionType.BuffEnd:
                for (const buffId of endCondition.BuffEnd.BuffIds) {
                    this.ListenBuffIds.add(buffId);
                }
                break;
        }
    });

    if (this.ListenSkillIds.size > 0) {
        EventSystem.AddWithTarget(catcher, EEventName.CharUseSkill, this.OnCatcherUseSkill);
    }
    if (this.ListenBuffIds.size > 0) {
        EventSystem.AddWithTarget(catcher, EEventName.RemoveBuff, this.OnRemoveBuff);
    }
}

3.4 回调四重防御：三个处理器一个模子

Src\Game\World\Entity\Skill\SkillGroup\SkillGroupObject.ts:435-484

private readonly OnCatcherUseSkill = (
    entityId: number,
    skillId: number,
    skillGroupId: number,
    isAutonomousProxy: boolean,
): void => {
    if (this.StateInternal !== ESkillGroupState.Casting) { return; }
    if (entityId !== this.EntityId) { return; }
    if (!this.ListenSkillIds.has(skillId)) { return; }

    this.CompleteSkillGroup();
};

private readonly OnRemoveBuff = (
    charId: number | undefined,
    buffId: TBuffIdType,
    buffUid: bigint | undefined,
    eReason: Game.Protocol.BuffRemoveReason | undefined,
): void => {
    if (this.StateInternal !== ESkillGroupState.Casting) { return; }
    if (charId !== this.EntityId) { return; }
    if (eReason !== Game.Protocol.BuffRemoveReason.BUFF_REMOVE_REASON_DURATION) { return; }
    if (!buffId || !this.ListenBuffIds.has(buffId)) { return; }

    this.CompleteSkillGroup();
};

private readonly OnTagChange = (tagId: number, tagExist: boolean): void => {
    if (this.StateInternal !== ESkillGroupState.Casting) { return; }

    if (!tagExist) {
        this.CompleteSkillGroup();
    }
};

4. 面试怎么讲