refactor(hero system): 重构英雄升级与卡片展示逻辑

1. 重构英雄升级方法，移除外部传入所需碎片参数，改为从配置表自动读取 2. 简化CardLiteComp.setHeroByUuid，移除卡池等级参数，直接读取英雄静态配置 3. 新增ChipComp.setHeroIconByUuid，重构英雄图标渲染逻辑 4. 新增英雄详情面板的升级功能与碎片展示 5. 新增英雄成长变化的事件监听与面板刷新逻辑
2026-08-23 16:27:58 +08:00
parent 6eb51c8535
commit fb2c67ccab
6 changed files with 4752 additions and 1064 deletions
--- a/assets/script/game/map/CardLiteComp.ts
+++ b/assets/script/game/map/CardLiteComp.ts
@@ -112,29 +112,22 @@ export class CardLiteComp extends CCComp {
    }

    /**
-     * 便捷方法：通过英雄 UUID 和卡池等级直接设置英雄卡。
-     * 自动从 CardPoolList 查找匹配的卡牌配置。
+     * 通过英雄 UUID 直接设置英雄卡（纯展示场景）。
+     * 从 HeroInfo 读取静态配置，不再依赖 CardPoolList。
     * @param uuid 英雄 UUID
-     * @param cardLv 卡牌等级（默认 1）
     */
-    setHeroByUuid(uuid: number, cardLv: number = 1) {
-        const card = CardPoolList.find(c => c.uuid === uuid && c.card_lv === cardLv);
-        if (card) {
-            this.setData(card);
-            return;
-        }
+    setHeroByUuid(uuid: number) {
        const hero = HeroInfo[uuid];
-        if (hero) {
-            this.setData({
-                uuid: hero.uuid,
-                type: CardType.Hero,
-                cost: 5,
-                weight: 25,
-                card_lv: cardLv,
-                kind: CKind.Hero,
-                hero_lv: smc.getHeroOuterLv(hero.uuid)
-            });
-        }
+        if (!hero) return;
+        this.setData({
+            uuid: hero.uuid,
+            type: CardType.Hero,
+            cost: 0,
+            weight: 0,
+            card_lv: hero.card_lv ?? 1,
+            kind: CKind.Hero,
+            hero_lv: smc.getHeroOuterLv(hero.uuid)
+        });
    }

    /** 查询当前是否有卡牌数据 */
--- a/assets/script/game/map/ChipComp.ts
+++ b/assets/script/game/map/ChipComp.ts
@@ -79,39 +79,35 @@ export class ChipComp extends CCComp {
    }

    /**
-     * 便捷方法：通过英雄 UUID 和卡池等级直接设置英雄卡。
-     * 自动从 CardPoolList 查找匹配的卡牌配置。
+     * 通过英雄 UUID 直接渲染英雄图标（自动播放 idle 动画并应用背景）。
+     * 适用于碎片、头像、图鉴等纯展示场景。
     * @param uuid 英雄 UUID
-     * @param cardLv 卡牌等级（默认 1）
     */
-    setHeroByUuid(uuid: number, cardLv: number = 1) {
-        const card = CardPoolList.find(c => c.uuid === uuid && c.card_lv === cardLv);
-        if (card) {
-            this.setData(card);
-            return;
-        }
+    setHeroIconByUuid(uuid: number) {
        const hero = HeroInfo[uuid];
-        if (hero) {
-            this.setData({
-                uuid: hero.uuid,
-                type: CardType.Hero,
-                cost: 0,
-                weight: 0,
-                card_lv: cardLv,
-                kind: CKind.Hero,
-                hero_lv: smc.getHeroOuterLv(hero.uuid)
+        if (!hero) return;
+        this.cardData = null;
+        this.card_uuid = uuid;
+        this.card_type = CardType.Hero;
+        this.node.active = true;
+        this.iconVisualToken += 1;
+
+        // 背景：按 HeroInfo.card_lv 应用英雄底框样式
+        if (this.BG_node) {
+            const cardLv = hero.card_lv ?? 1;
+            const kindName = CKind[CKind.Hero];
+            this.BG_node.children.forEach(child => {
+                child.active = (child.name === kindName);
+                const bg = child.getComponent(CardBgComp);
+                if (bg) child.active ? bg.apply(cardLv) : bg.clear();
            });
        }
-    }

-    /** 查询当前是否有卡牌数据 */
-    hasCard(): boolean {
-        return !!this.cardData;
-    }
-
-    /** 获取当前卡牌数据 */
-    getCardData(): CardConfig | null {
-        return this.cardData;
+        // 图标：英雄 idle 动画（带镜像翻转）
+        if (this.icon_node) {
+            this.icon_node.setScale(new Vec3(-1.5, 1.5, 1));
+            this.updateHeroAnimation(this.icon_node, uuid, this.iconVisualToken);
+        }
    }

    /** 清空卡牌数据并重置 UI */
--- a/assets/script/game/map/ChipComp.ts.meta
+++ b/assets/script/game/map/ChipComp.ts.meta
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "dc823f36-51eb-405f-8361-7027eb49c8a6",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
--- a/assets/script/game/map/HerosListComp.ts
+++ b/assets/script/game/map/HerosListComp.ts
@@ -25,8 +25,12 @@ import { mLogger } from "../common/Logger";
 import { HeroInfo, HeroList } from "../common/config/heroSet";
 import { buildSkillDesc } from "../common/config/HeroSkillDesc";
 import { CKind } from "../common/config/CardSet";
+import { GameEvent } from "../common/config/GameEvent";
+import { HERO_UPGRADE_NEED_FRAGMENTS } from "../common/config/GameSet";
 import { CardBgComp } from "./CardBgComp";
 import { CardLiteComp } from "./CardLiteComp";
+import { ChipComp } from "./ChipComp";
+import { smc } from "../common/SingletonModuleComp";

 const { property, ccclass } = _decorator;

@@ -41,6 +45,9 @@ export class HerosListComp extends CCComp {
    @property(Node)
    ap_node = null!

+    @property(Node)
+    def_node = null!
+
    @property(Node)
    hp_node = null!

@@ -69,6 +76,18 @@ export class HerosListComp extends CCComp {
    @property(Node)
    type_node = null!

+    /** 升级按钮节点 */
+    @property(Node)
+    upgrade_btn = null!
+
+    /** 碎片数量显示节点（Label） */
+    @property(Node)
+    fragment_node = null!
+
+    /** 碎片图标节点（挂载 ChipComp 用于渲染碎片图标） */
+    @property(Node)
+    chip_node = null!
+
    // ======================== 运行时状态 ========================

    huuid: number = 0
@@ -84,15 +103,49 @@ export class HerosListComp extends CCComp {
    }

    protected onEnable(): void {
+        oops.message.on(GameEvent.HERO_GROWTH_UPDATE, this.onGrowthUpdate, this)
        if (this.cards_node && this.cards_node.children.length > 0) {
            this.onCardSelect(this.huuid || HeroList[0])
        }
    }

+    protected onDisable(): void {
+        oops.message.off(GameEvent.HERO_GROWTH_UPDATE, this.onGrowthUpdate, this)
+    }
+
+    private onGrowthUpdate() {
+        if (this.huuid) {
+            this.updateHeroDetail(this.huuid)
+        }
+    }
+
    closeHeros() {
        this.node.active = false
    }

+    /**
+     * 升级按钮点击回调
+     * 消耗碎片提升英雄局外等级，成功后刷新详情面板
+     */
+    onUpgradeClick() {
+        const uuid = this.huuid
+        if (!uuid) return
+
+        const success = smc.upgradeHero(uuid)
+        if (success) {
+            mLogger.log(this.debugMode, "HerosListComp", `英雄 ${uuid} 升级成功`)
+            this.updateHeroDetail(uuid)
+        } else {
+            const growth = smc.getHeroGrowth(uuid)
+            const need = HERO_UPGRADE_NEED_FRAGMENTS[growth.lv + 1]
+            mLogger.log(this.debugMode, "HerosListComp", `英雄 ${uuid} 升级失败`, {
+                currentLv: growth.lv,
+                fragments: growth.fragments,
+                needFragments: need ?? "MAX",
+            })
+        }
+    }
+
    // ======================== 卡片列表 ========================

    private initCardList() {
@@ -136,7 +189,7 @@ export class HerosListComp extends CCComp {
            })

            const comp = cardNode.getComponent(CardLiteComp) || cardNode.addComponent(CardLiteComp)
-            comp.setHeroByUuid(uuid, hero.card_lv ?? 1)
+            comp.setHeroByUuid(uuid)
            comp.onClickCallback = (cardComp: CardLiteComp) => {
                this.onCardSelect(uuid)
                this.highlightCard(cardNode)
@@ -197,6 +250,7 @@ export class HerosListComp extends CCComp {
        const suffix = heroLv >= 2 ? "★".repeat(heroLv - 1) : ""
        this.setLabelText(this.name_node, `${suffix}${hero.name || ""}${suffix}`)
        this.setLabelText(this.ap_node, `${(hero.ap ?? 0) * heroLv}`)
+        this.setLabelText(this.def_node, `${(hero.def ?? 0) * heroLv}`)
        this.setLabelText(this.hp_node, `${(hero.hp ?? 0) * heroLv}`)

        this.updateCdDisplay(hero)
@@ -213,6 +267,7 @@ export class HerosListComp extends CCComp {
        this.updateLvDisplay(hero)
        this.updateTypeDisplay(hero)
        this.updateHeroAnimation(uuid)
+        this.updateGrowthPanel(uuid)
    }

    private updatePoolLvBg(poolLv: number) {
@@ -261,6 +316,38 @@ export class HerosListComp extends CCComp {
        })
    }

+    /**
+     * 更新局外成长面板：碎片数量与升级按钮状态
+     * @param uuid 英雄模板 uuid
+     */
+    private updateGrowthPanel(uuid: number) {
+        const growth = smc.getHeroGrowth(uuid)
+        const needFragments = HERO_UPGRADE_NEED_FRAGMENTS[growth.lv + 1]
+        const isMaxLv = needFragments === undefined
+
+        // 碎片数量显示：当前拥有 / 下一级所需（满级时显示 MAX）
+        if (this.fragment_node) {
+            const fragmentText = isMaxLv
+                ? `${growth.fragments} / MAX`
+                : `${growth.fragments} / ${needFragments}`
+            this.setLabelText(this.fragment_node, fragmentText)
+        }
+
+        // 碎片图标：使用 ChipComp 渲染英雄图标（自动读取 HeroInfo 配置）
+        if (this.chip_node) {
+            const chipComp = this.chip_node.getComponent(ChipComp) || this.chip_node.addComponent(ChipComp)
+            chipComp.setHeroIconByUuid(uuid)
+        }
+
+        // 升级按钮状态：未满级且碎片足够时可用
+        if (this.upgrade_btn) {
+            const canUpgrade = !isMaxLv && growth.fragments >= needFragments
+            this.upgrade_btn.active = true
+            const btnComp = this.upgrade_btn.getComponent("cc.Button") as import("cc").Button | null
+            if (btnComp) btnComp.interactable = canUpgrade
+        }
+    }
+
    // ======================== 英雄动画 ========================

    private updateHeroAnimation(uuid: number) {