多轮审查和修复

Assets/Scripts/Combat/StatusEffects/StatusEffect.cs

@@ -0,0 +1,91 @@
+using UnityEngine;
+
+namespace BaseGames.Combat.StatusEffects
+{
+    /// <summary>
+    /// 状态效果抽象基类（架构 06_CombatModule §11）。
+    /// ⚠️ 类名为 StatusEffect（非 StatusEffectBase）。
+    /// 
+    /// 生命周期：
+    ///   OnApply(owner) → Update(delta) × N [内部调用 OnTick()] → OnExpire()
+    /// 
+    /// 叠加规则：同类型再次施加时调用 OnStack()；Manager 保证每种类型只有一个实例。
+    /// </summary>
+    public abstract class StatusEffect
+    {
+        /// <summary>效果类型标识（用作 Dictionary key）。</summary>
+        public abstract StatusEffectType EffectType { get; }
+
+        /// <summary>最大叠加层数（1 = 不可叠加，重复施加只刷新持续时间）。</summary>
+        public abstract int MaxStacks { get; }
+
+        /// <summary>当前叠加层数。</summary>
+        public int   StackCount   { get; protected set; } = 1;
+
+        /// <summary>当前剩余持续时间（秒）。</summary>
+        public float Duration     { get; protected set; }
+
+        /// <summary>每次 Tick 的间隔（秒）。</summary>
+        public float TickInterval { get; protected set; }
+
+        /// <summary>是否已过期（由 Manager 每帧检查）。</summary>
+        public virtual bool IsExpired => Duration <= 0f;
+
+        private float _tickTimer;
+
+        /// <summary>宿主 Manager（OnApply 时注入，OnTick/OnExpire 中可访问）。</summary>
+        public StatusEffectManager Owner { get; protected set; }
+
+        // ── 生命周期回调（可重写）─────────────────────────────────────────
+
+        /// <summary>
+        /// 效果施加时调用（Owner 在此注入）。
+        /// ⚠️ 参数为 StatusEffectManager（非 IDamageable），架构 06 §11。
+        /// </summary>
+        public virtual void OnApply(StatusEffectManager owner)
+        {
+            Owner    = owner;
+            Duration = GetBaseDuration();
+        }
+
+        /// <summary>
+        /// 同类型效果再次施加时调用（叠层 / 刷新持续时间）。
+        /// 默认行为：刷新持续时间并叠加层数（若未达上限）。
+        /// </summary>
+        public virtual void OnStack()
+        {
+            Duration   = GetBaseDuration();
+            StackCount = Mathf.Min(StackCount + 1, MaxStacks);
+        }
+
+        /// <summary>每个 TickInterval 秒调用一次（DoT 等周期效果）。</summary>
+        public virtual void OnTick() { }
+
+        /// <summary>效果到期 / 被净化时调用。⚠️ 名称 OnExpire（非 OnRemove）。</summary>
+        public virtual void OnExpire() { }
+
+        // ── 框架驱动（由 Manager.Update 调用，每帧执行）──────────────────
+
+        /// <summary>递减持续时间并在到达 Tick 间隔时触发 OnTick。</summary>
+        public void Update(float delta)
+        {
+            Duration -= delta;
+            if (TickInterval <= 0f) return;
+
+            _tickTimer += delta;
+            if (_tickTimer >= TickInterval)
+            {
+                _tickTimer -= TickInterval;
+                OnTick();
+            }
+        }
+
+        // ── 子类必须实现 ──────────────────────────────────────────────────
+
+        /// <summary>返回本类型效果的基础持续时间（秒）。</summary>
+        protected abstract float GetBaseDuration();
+
+        /// <summary>返回本效果的本地化显示名称。</summary>
+        public abstract string GetDisplayName();
+    }
+}