refactor(hero): 优化护盾系统日志与显示逻辑

1. 新增多处护盾相关调试日志，方便追踪护盾数值变化 2. 重构HeroAttrsComp的add_shield方法，统一日志输出格式 3. 重写HeroTopBarComp的护盾显示逻辑，改为直接显示数值而非按上限比例 4. 为HeroViewComp新增护盾特效管理，实现护盾状态自动显隐 5. 清理hk1.prefab中冗余的预制体覆盖配置
2026-09-03 23:53:37 +08:00
parent a41ff479da
commit 0a3efafbd5
6 changed files with 85 additions and 206 deletions
--- a/assets/script/game/hero/HeroAtkSystem.ts
+++ b/assets/script/game/hero/HeroAtkSystem.ts
@@ -518,14 +518,16 @@ export class HeroAtkSystem extends ecs.ComblockSystem implements ecs.ISystemUpda
    }

    private absorbShield(TAttrsComp: HeroAttrsComp, damage: number): { remainingDamage: number, absorbedDamage: number } {
+        mLogger.log(this.debugMode, 'HeroAtkSystem', `absorbShield: ${TAttrsComp.hero_name}, shield=${TAttrsComp.shield}, damage=${damage}`);
        if (TAttrsComp.shield <= 0) {
-            mLogger.log(this.debugMode, 'HeroAtkSystem', " 护盾值小于等于0，无法吸收伤害");
+            mLogger.log(this.debugMode, 'HeroAtkSystem', `absorbShield: shield <= 0, no absorb`);
            return { remainingDamage: damage, absorbedDamage: 0 };
        }
        const absorbed = Math.min(TAttrsComp.shield, damage);
+        const oldShield = TAttrsComp.shield;
        TAttrsComp.shield = Math.max(0, TAttrsComp.shield - absorbed);
        TAttrsComp.dirty_shield = true;
-        mLogger.log(this.debugMode, 'HeroAtkSystem', ` 护盾减免 ${absorbed.toFixed(1)} 点伤害，剩余护盾 ${TAttrsComp.shield.toFixed(1)}`);
+        mLogger.log(this.debugMode, 'HeroAtkSystem', `absorbShield: ${TAttrsComp.hero_name}, absorbed=${absorbed}, shield ${Math.floor(oldShield)} -> ${Math.floor(TAttrsComp.shield)}, dirty_shield=true`);
        return { remainingDamage: damage - absorbed, absorbedDamage: absorbed };
    }

--- a/assets/script/game/hero/HeroAttrsComp.ts
+++ b/assets/script/game/hero/HeroAttrsComp.ts
@@ -154,14 +154,14 @@ export class HeroAttrsComp extends ecs.Comp {
    add_shield(value: number) {
        const oldShield = this.shield;
        const addValue = Math.max(0, Math.floor(value));
-        if (addValue <= 0) return;
+        if (addValue <= 0) {
+            mLogger.log(this.debugMode, 'HeroAttrs', `add_shield: addValue=${addValue} <= 0, skip`);
+            return;
+        }
        this.shield += addValue;
-        this.shield = Math.min(this.shield, FightSet.SHIELD_MAX); // 限制护盾值上限（数值减免型）
        if (this.shield < 0) this.shield = 0;
        this.dirty_shield = true;  // 标记护盾需要更新
-        if (this.debugMode) {
-            mLogger.log(this.debugMode, 'HeroAttrs', ` 护盾值变更: ${this.hero_name}, 变化=${addValue}, ${Math.floor(oldShield)} -> ${Math.floor(this.shield)}`);
-        }
+        mLogger.log(this.debugMode, 'HeroAttrs', `add_shield: ${this.hero_name}, old=${Math.floor(oldShield)}, add=${addValue}, new=${Math.floor(this.shield)}, dirty_shield=true`);
    }
    add_hp_max(value: number) {
        this.hp_max += value
--- a/assets/script/game/hero/HeroTopBarComp.ts
+++ b/assets/script/game/hero/HeroTopBarComp.ts
@@ -4,7 +4,7 @@ import { CCComp } from "../../../../extensions/oops-plugin-framework/assets/modu
 import { HeroAttrsComp } from "./HeroAttrsComp";
 import { BuffComp } from "./BuffComp";
 import { BuffList, BuffCategory, DEBUFF_ICON_MAP } from "../common/config/BuffSet";
-import { FacSet, FightSet } from "../common/config/GameSet";
+import { FacSet } from "../common/config/GameSet";

 const { ccclass, property } = _decorator;

@@ -135,13 +135,18 @@ export class HeroTopBarComp extends CCComp {
        }
    }

-    /** 更新护盾数值条（百分比 = shield / SHIELD_MAX） */
+    /** 更新护盾数值条（显示具体数值，无上限） */
    public shieldShow(shield: number = 0): void {
-        if (!this.shieldProgressBar) return;
-        const progress = FightSet.SHIELD_MAX > 0 ? shield / FightSet.SHIELD_MAX : 0;
-        this.shieldProgressBar.progress = clamp(progress, 0, 1);
+        if (!this.shieldProgressBar) {
+            console.log('[HeroTopBarComp] shieldShow: shieldProgressBar is null');
+            return;
+        }
+        // 护盾条直接显示具体数值，progress 固定为 1（满条显示）
+        this.shieldProgressBar.progress = 1;
        // 护盾节点显隐
-        this.shieldProgressBar.node.active = shield > 0;
+        const shouldActive = shield > 0;
+        console.log(`[HeroTopBarComp] shieldShow: shield=${shield}, active=${shouldActive}, node=${this.shieldProgressBar.node.name}`);
+        this.shieldProgressBar.node.active = shouldActive;
    }

    /**
--- a/assets/script/game/hero/HeroViewComp.ts
+++ b/assets/script/game/hero/HeroViewComp.ts
@@ -140,7 +140,13 @@ export class HeroViewComp extends CCComp {


        if (this.model.dirty_shield) {
+            mLogger.log(this.debugMode, 'HeroViewComp', `update dirty_shield: shield=${this.model.shield}, calling shieldShow`);
            this.topBar.shieldShow(this.model.shield);
+            // 护盾耗尽时隐藏护盾特效
+            if (this.model.shield <= 0) {
+                mLogger.log(this.debugMode, 'HeroViewComp', `update dirty_shield: shield <= 0, hiding shield fx`);
+                this.hideShieldFx();
+            }
            this.model.dirty_shield = false;
        }

@@ -309,9 +315,43 @@ export class HeroViewComp extends CCComp {
            this.as.move();
        }
    }
+    /** 护盾常驻特效节点，避免重复创建 */
+    private shieldFxNode: Node | null = null;
+
    add_shield(shield: number) {
+        mLogger.log(this.debugMode, 'HeroViewComp', `add_shield called, shield=${shield}, model.shield=${this.model?.shield}, model exists=${!!this.model}`);
        // 护盾数据更新由 Model 层处理，这里只负责视图表现
-        if (this.model && this.model.shield > 0) this.topBar.shieldShow(this.model.shield);
+        if (this.model && this.model.shield > 0) {
+            this.topBar.shieldShow(this.model.shield);
+            this.showShieldFx();
+            mLogger.log(this.debugMode, 'HeroViewComp', `add_shield: showing shield fx, model.shield=${this.model.shield}`);
+        } else {
+            mLogger.log(this.debugMode, 'HeroViewComp', `add_shield: skipped, model.shield=${this.model?.shield}`);
+        }
+    }
+
+    /** 显示护盾常驻特效（使用 this.node 下已放置的 shielded 节点） */
+    private showShieldFx() {
+        if (!this.shieldFxNode) {
+            this.shieldFxNode = this.node.getChildByName("shielded");
+            mLogger.log(this.debugMode, 'HeroViewComp', `showShieldFx: found shielded node=${!!this.shieldFxNode}`);
+        }
+        if (this.shieldFxNode && !this.shieldFxNode.active) {
+            this.shieldFxNode.active = true;
+            mLogger.log(this.debugMode, 'HeroViewComp', `showShieldFx: activated shielded node`);
+        } else {
+            mLogger.log(this.debugMode, 'HeroViewComp', `showShieldFx: shielded node already active or not found, active=${this.shieldFxNode?.active}`);
+        }
+    }
+
+    /** 隐藏护盾常驻特效 */
+    private hideShieldFx() {
+        if (this.shieldFxNode && this.shieldFxNode.active) {
+            this.shieldFxNode.active = false;
+            mLogger.log(this.debugMode, 'HeroViewComp', `hideShieldFx: deactivated shielded node`);
+        } else {
+            mLogger.log(this.debugMode, 'HeroViewComp', `hideShieldFx: shielded node not active or not found, active=${this.shieldFxNode?.active}`);
+        }
    }

    health(hp: number = 0) {
@@ -329,6 +369,7 @@ export class HeroViewComp extends CCComp {
        this.model.is_dead = false
        this.model.is_count_dead = false
        this.deadCD = 0;
+        this.hideShieldFx();

        // 恢复碰撞体
        const collider = this.node.getComponent(Collider2D);
@@ -493,6 +534,7 @@ export class HeroViewComp extends CCComp {
    }
    reset() {
        this.isCastingMax = false;
+        this.hideShieldFx();
        // 清理残留的定时器和缓动
        this.unscheduleAllCallbacks();
        Tween.stopAllByTarget(this.node);
--- a/assets/script/game/hero/SCastSystem.ts
+++ b/assets/script/game/hero/SCastSystem.ts
@@ -539,7 +539,9 @@ export class SCastSystem extends ecs.ComblockSystem implements ecs.ISystemUpdate
        } else if (kind === SkillKind.Shield && sAp !== 0) {
            // 护盾值 = ap% × 施法者最终最大生命（getFinalHpMax 含驻场光环与计时 buff 加成）
            const addShield = Math.max(0, Math.floor(_cAttrsComp.getFinalHpMax() * sAp / 100));
+            mLogger.log(this.debugMode, 'SCastSystem', `applyActualFriendlyEffect Shield: caster=${_cAttrsComp.hero_name}, target=${model.hero_name}, casterHpMax=${_cAttrsComp.getFinalHpMax()}, sAp=${sAp}, addShield=${addShield}, targetOldShield=${model.shield}`);
            model.add_shield(addShield);
+            mLogger.log(this.debugMode, 'SCastSystem', `applyActualFriendlyEffect Shield: after add_shield, targetNewShield=${model.shield}, dirty_shield=${model.dirty_shield}`);
        }

        if (config.buff_type !== undefined) {