爬塔

一期从 0 建：塔内星级判定展示 + 局外记录/排行； 二期把配置全量表驱动化（configTowerClimb* 系列表）， 加塔、加层、加任务策划全部改表加行，客户端零代码。 星数数据用位掩码（starMask）传输，客户端自算 + 双源 OR 兜底。

1. 工作清单

2. 理论：位掩码星级模型与表驱动配置

2.1 starMask：一关 N 星压进一个数字

2.2 局内双协议 + 局外双源

2.3 二期表驱动：加内容不改代码

爬塔结构 = 塔（TowerId）→ 层（DungeonId 关卡）→ 星档任务（TaskType/TaskSubType）。 二期全部映射进配置索引：

3. 代码片段

3.1 CountStarsFromMask：位逐数星 + 上限防脏数据

Src\Game\Module\TowerClimb\TowerClimbModel.ts:299-338

/** 统计 starMask 已点亮星数，上限 TowerMaxStars 防服务器脏数据超配置档数 */
private CountStarsFromMask(starMask: number): number {
    let starCount = 0;
    for (let idx = 0; idx < this.TowerMaxStars; idx++) {
        if ((starMask & (1 << idx)) !== 0) {
            starCount++;
        }
    }
    return starCount;
}

public GetRoleOwnTowerStars(roleId: number, towerId: number): number {
    const roleRecordInfo = this.TowerClimbRecordInfoMap!.get(roleId);
    if (!roleRecordInfo) { return 0; }
    let ownTowerStars = 0;
    const detailList: string[] = [];
    for (const recordInfo of roleRecordInfo.bestRecords) {
        const towerInfoCfg = ConfigManager.TowerClimbConfig!.GetTowerClimbInfoConfigByDungeonId(recordInfo.dungeonId);
        if (towerInfoCfg && towerInfoCfg.TowerId === towerId) {
            // 按 starMask 逐档累计，不能按"打过即满星"算
            const dungeonStars = this.CountStarsFromMask(recordInfo.starMask);
            ownTowerStars += dungeonStars;
            detailList.push(`${recordInfo.dungeonId}=mask${recordInfo.starMask}/${dungeonStars}星`);
        }
    }
    Log.Debug(ELogModule.TowerClimb, ELogAuthor.ZZB, '爬塔星级-局外取塔已得星数GetRoleOwnTowerStars',
        ['roleId', roleId], ['towerId', towerId],
        ['ownTowerStars', ownTowerStars], ['明细', detailList.join(',')],
    );
    return ownTowerStars;
}

3.2 局内双协议收包：日志即数据还原

Src\Game\Module\Dungeon\DungeonController.ts:589-616

/** 副本开始爬塔星级监听：服务器全量下发星级初始数据 */
private readonly OnDungeonTowerStarStartNotify = (
    notify: Game.Protocol.WorldDungeonTowerStarStartSCNotify,
): void => {
    Log.Warn(ELogModule.TowerClimb, ELogAuthor.ZZB, '爬塔星级-局内收包20532 TowerStarStart',
        ['starCount', notify.info?.starList?.length ?? 0],
        ['starsMask', notify.info?.starsMask ?? 0],
        ['明细', (notify.info?.starList ?? []).map((s) => `idx${s.idx}=${s.isTrue}`).join(',')],
    );
    ModelManager.DungeonModel!.SetTowerStarInfo(notify.info);
};

/** 单档星级达成实时更新 */
private readonly OnDungeonTowerStarUpdateNotify = (
    notify: Game.Protocol.WorldDungeonTowerStarUpdateSCNotify,
): void => {
    Log.Warn(ELogModule.TowerClimb, ELogAuthor.ZZB, '爬塔星级-局内收包20533 TowerStarUpdate',
        ['idx', notify.starProgress?.idx],
        ['isTrue', notify.starProgress?.isTrue],
    );
    ModelManager.DungeonModel!.UpdateTowerStarProgress(notify.starProgress);
};

3.3 GetCurrentTowerStarMask：自算 + 双源 OR 兜底

Src\Game\Module\Dungeon\DungeonModel.ts:433-449

/** 当前副本已达成星级掩码：20533 只更新单档不刷 starsMask，故按 starList 自算，并 OR 通关下发的 towerStarInfo 兜底 */
public GetCurrentTowerStarMask(): number {
    let mask = 0;
    const sources = [this.TowerStarInfo, this.CurrentDungeonInfo?.towerStarInfo];
    for (const info of sources) {
        if (!info) { continue; }
        mask |= info.starsMask ?? 0;
        for (const star of info.starList ?? []) {
            if (star.isTrue) {
                mask |= 1 << star.idx;
            }
        }
    }
    return mask;
}

3.4 进本即判：不依赖服务器下发时机

Src\Game\Module\Dungeon\DungeonModel.ts:451-458

/** 当前是否爬塔副本：按副本配置查爬塔表，进副本即可判定，不依赖服务器星级下发时机 */
public IsInTowerClimbDungeon(): boolean {
    const dungeonConfigId = this.CurrentDungeonInfo?.dungeonConfigId;
    if (!dungeonConfigId) { return false; }
    return ConfigManager.TowerClimbConfig?.GetTowerClimbInfoConfigByDungeonId(dungeonConfigId) !== undefined;
}

3.5 二期表驱动：OnInit 构建倒排索引

Src\Game\Module\TowerClimb\TowerClimbConfig.ts:30-57（节选）

protected OnInit(): boolean {
    const rankBaseCfg = configRankBaseByRankType.GetConfig(ERankType.Tower);
    const topN = rankBaseCfg !== undefined ? rankBaseCfg.TopN : 0;
    TowerClimbConfig.MaxTopRank = topN > 0 ? topN : 100;
    this.BuildTowerTaskType2SunTypeMap();
    this.BuildTowerRankDisplayRuleList();
    return true;
}

private BuildTowerTaskType2SunTypeMap(): void {
    const taskCfgList = configTowerClimbTaskAll.GetConfigList();
    if (!taskCfgList) { return; }
    for (const taskCfg of taskCfgList) {
        let sunTypeSet = this.TowerTaskType2SunTypesMap.get(taskCfg.TaskType);
        if (!sunTypeSet) {
            sunTypeSet = new Set<number>();
            this.TowerTaskType2SunTypesMap.set(taskCfg.TaskType, sunTypeSet);
        }
        sunTypeSet.add(taskCfg.TaskSubType);
    }
}

4. 面试怎么讲