feat: Implement Room Streaming System

- Add RoomStreamingManager to manage room loading and unloading based on player proximity. - Create StreamingBudgetConfigSO for memory and performance budgeting of the streaming system. - Introduce TransitionDirector to handle seamless and atmospheric fade transitions between rooms. - Develop WorldGraph to represent room connectivity and facilitate neighbor queries and distance calculations. - Implement RoomNode and RoomEdge classes to structure room data and connections.
2026-05-23 19:10:29 +08:00
parent 81c326af53
commit a1b4e629aa
165 changed files with 7904 additions and 313 deletions
--- a/Assets/_Game/Scripts/Enemies/AI/BDTaskAttributes.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BDTaskAttributes.cs
@@ -0,0 +1,37 @@
+#if GRAPH_DESIGNER
+using System;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 指定 BD Task 在编辑器任务面板中显示的名称。
+    /// 本版本 BehaviorDesigner 不内置此特性，由项目自行定义以保持代码可读性与前向兼容性。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+    public sealed class TaskNameAttribute : Attribute
+    {
+        public string Name { get; }
+        public TaskNameAttribute(string name) => Name = name;
+    }
+
+    /// <summary>
+    /// 指定 BD Task 在编辑器任务面板中所属分类（路径形式，如 "BaseGames/Enemy/Combat"）。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+    public sealed class TaskCategoryAttribute : Attribute
+    {
+        public string Category { get; }
+        public TaskCategoryAttribute(string category) => Category = category;
+    }
+
+    /// <summary>
+    /// 为 BD Task 提供编辑器 Tooltip 描述文本。
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+    public sealed class TaskDescriptionAttribute : Attribute
+    {
+        public string Description { get; }
+        public TaskDescriptionAttribute(string description) => Description = description;
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_Attack.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_Attack.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
@@ -9,14 +9,14 @@ namespace BaseGames.Enemies.AI
    /// BD Action：发动攻击。
    /// CanAttack() 检查通过后调用 BeginAttack，立即返回 Success。
    /// </summary>
+    [TaskName("Attack")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("执行近战攻击（单段或连击序列）")]
    public class BD_Attack : Action
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_BossPhaseTransition.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_BossPhaseTransition.cs
@@ -0,0 +1,54 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：启动 Boss 阶段过渡演出（无敌帧 + 可选定格），等待过渡完成后返回 Success。
+    ///
+    /// 返回 Running：过渡演出进行中（BossBase.IsPhaseTransitioning = true）。
+    /// 返回 Success：过渡完成，已切换到目标阶段。
+    /// 返回 Failure：BossBase 组件不存在。
+    ///
+    /// 典型 BT 用法：
+    ///   Sequence [ BD_IsHPBelow(0.5) → BD_BossPhaseTransition(Phase=1, Duration=1.5) → ... ]
+    /// </summary>
+    [TaskName("Boss Phase Transition")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("触发 Boss 阶段过渡演出（无敌 + 动画 + 广播事件）")]
+    public class BD_BossPhaseTransition : Action
+    {
+        [Tooltip("切换到的目标阶段索引")]
+        [SerializeField] private int m_TargetPhase = 1;
+
+        [Tooltip("无敌帧 + 过渡演出持续时间（秒）")]
+        [SerializeField, Min(0f)] private float m_InvincibleDuration = 1.5f;
+
+        private BossBase _boss;
+        private bool     _started;
+
+        public override void OnAwake() => _boss = GetComponent<BossBase>();
+
+        public override void OnStart()
+        {
+            _started = false;
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_boss == null) return TaskStatus.Failure;
+
+            if (!_started)
+            {
+                _boss.BeginPhaseTransition(m_TargetPhase, m_InvincibleDuration);
+                _started = true;
+            }
+
+            return _boss.IsPhaseTransitioning ? TaskStatus.Running : TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_BossPhaseTransition.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_BossPhaseTransition.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e86991de79acdb3498c9187ea96a8c3c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_BroadcastAlert.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_BroadcastAlert.cs
@@ -0,0 +1,39 @@
+#if GRAPH_DESIGNER
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using UnityEngine;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：向半径内其他敌人广播警戒（Group Alert）。
+    ///
+    /// 返回 Success：广播完成（不保证命中任何敌人）。
+    ///
+    /// 典型用法：在 BD_SetAiPhase(Chase) 之后立即调用此节点，
+    /// 使发现玩家的敌人将警报传播给周围同伴，实现群体索敌效果。
+    ///
+    /// 半径优先使用 m_OverrideRadius；若为 0 则读取 EnemyStatsSO.AlertBroadcastRadius。
+    /// </summary>
+    [TaskName("Broadcast Alert")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("向附近的友方广播警报，使其进入 Alert 状态")]
+    public class BD_BroadcastAlert : Action
+    {
+        [Tooltip("广播半径（m）；0 = 使用 EnemyStatsSO.AlertBroadcastRadius")]
+        [SerializeField, Min(0f)] private float m_OverrideRadius = 0f;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            float r = m_OverrideRadius > 0f ? m_OverrideRadius : (_enemy.StatsSO?.AlertBroadcastRadius ?? 0f);
+            _enemy.AlertNearby(r);
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_BroadcastAlert.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_BroadcastAlert.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 93ffcd4596213bf4d8499aa565712213
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanAttack.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanAttack.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -8,14 +8,14 @@ namespace BaseGames.Enemies.AI
    /// <summary>
    /// BD Conditional：攻击冷却是否完毕（可以发动攻击）。
    /// </summary>
+    [TaskName("Can Attack?")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("检查当前是否满足近战攻击条件（距离 + 视线）")]
    public class BD_CanAttack : Conditional
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanReachTarget.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanReachTarget.cs
@@ -0,0 +1,35 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 条件：目标坐标从当前位置是否可到达（调用 NavAgent.CanReach，无法寻路时 Failure）。
+    /// 用于 Boss 阶段切换或小怪决策能否追击到跨平台目标。
+    /// </summary>
+    [TaskName("Can Reach Target?")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("检查 NavAgent 是否可以规划到目标的有效路径")]
+    public sealed class BD_CanReachTarget : Conditional
+    {
+        [Tooltip("检查目标（留空则使用玩家位置）")]
+        [SerializeField] private Transform m_Target;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy?.Nav == null) return TaskStatus.Failure;
+            Vector2 pos = m_Target != null
+                ? (Vector2)m_Target.position
+                : _enemy.PlayerTransform != null ? (Vector2)_enemy.PlayerTransform.position : Vector2.zero;
+            return _enemy.Nav.CanReach(pos) ? TaskStatus.Success : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanReachTarget.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanReachTarget.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 436d3fd564880ae46a899b347f9a3494
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanUseAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanUseAbility.cs
@@ -0,0 +1,71 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 条件：abilityId 当前可用（冷却完毕且未在运行）。
+    /// 可选开启范围、视线、脚踏地面等调度提示检查；
+    /// 仅当所有启用的条件均满足时才返回 Success。
+    /// </summary>
+    [TaskName("Can Use Ability?")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("检查能力是否存在且冷却就绪，支持范围/视线/地面等调度提示检查")]
+    public sealed class BD_CanUseAbility : Conditional
+    {
+        [Tooltip("能力 ScriptableObject（优先级高于下方字符串 ID）")]
+        [SerializeField] private EnemyAbilitySO m_AbilitySO;
+
+        [Tooltip("能力 ID（当 AbilitySO 未赋值时使用）")]
+        [SerializeField] private string m_AbilityId = "";
+
+        [Header("调度提示（可选）")]
+        [Tooltip("启用后，检查玩家是否在 AbilitySO.preferredRange 范围内")]
+        [SerializeField] private bool m_CheckRange = false;
+
+        [Tooltip("启用后，检查 AbilitySO.requiresLineOfSight 是否满足视线条件")]
+        [SerializeField] private bool m_CheckLineOfSight = false;
+
+        [Tooltip("启用后，检查 AbilitySO.requiresGrounded 是否满足落地条件")]
+        [SerializeField] private bool m_CheckGrounded = false;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+
+            string id = m_AbilitySO != null ? m_AbilitySO.abilityId : m_AbilityId;
+            var ab = _enemy.Abilities.Get(id);
+            if (ab == null || !ab.CanUse) return TaskStatus.Failure;
+
+            // ── 调度提示检查（均可在 Inspector 独立开关）──────────────────────────
+            var config = ab.Config;
+            if (config != null)
+            {
+                if (m_CheckGrounded && config.requiresGrounded && !(_enemy.Movement?.IsGrounded ?? false))
+                    return TaskStatus.Failure;
+
+                if (m_CheckLineOfSight && config.requiresLineOfSight && !_enemy.IsPlayerVisible())
+                    return TaskStatus.Failure;
+
+                if (m_CheckRange && _enemy.Stats != null)
+                {
+                    float sqrDist = _enemy.Stats.SqrDistanceToPlayer;
+                    float minSqr  = config.preferredMinRange * config.preferredMinRange;
+                    float maxSqr  = config.preferredMaxRange * config.preferredMaxRange;
+                    if (sqrDist < minSqr || sqrDist > maxSqr)
+                        return TaskStatus.Failure;
+                }
+            }
+
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanUseAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanUseAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3fbc6b3634e77bf40bfeb918c7e45e5f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanUseBossSkill.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanUseBossSkill.cs
@@ -0,0 +1,41 @@
+#if GRAPH_DESIGNER
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using UnityEngine;
+using BaseGames.Boss;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Conditional：检查 Boss 技能是否冷却就绪。
+    /// 支持拖拽 BossSkillSO 或直接填写 skillId 字符串（SO 优先）。
+    /// </summary>
+    [TaskName("Can Use Boss Skill?")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("检查指定 Boss 技能是否在当前阶段可用且冷却就绪")]
+    public class BD_CanUseBossSkill : Conditional
+    {
+        [SerializeField] private BossSkillSO m_SkillSO;
+        [SerializeField] private string      m_SkillId;
+
+        private BossBase          _boss;
+        private BossSkillExecutor _executor;
+
+        public override void OnAwake()
+        {
+            _boss     = GetComponent<BossBase>();
+            _executor = GetComponentInChildren<BossSkillExecutor>();
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_executor == null) return TaskStatus.Failure;
+
+            string id = m_SkillSO != null ? m_SkillSO.skillId : m_SkillId;
+            if (string.IsNullOrEmpty(id)) return TaskStatus.Failure;
+
+            return _executor.CanUseSkill(id) ? TaskStatus.Success : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_CanUseBossSkill.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_CanUseBossSkill.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: bb7c971f5193f174189337814487bd7d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_ChasePlayer.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_ChasePlayer.cs
@@ -0,0 +1,140 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：追击玩家（三阶段视线丢失模型）。
+    ///
+    /// <list type="bullet">
+    ///   <item><b>Tracking</b>：持有视线，以奔跑速度追击并更新 LastKnownPlayerPosition。</item>
+    ///   <item><b>Searching</b>：视线丢失超过 LostSightBuffer（~0.3s）后进入。速度降低，向最后可见位置行进；若恢复视线即回到 Tracking。</item>
+    ///   <item><b>Lost</b>：Searching 持续超过 LoseLinkTimeout → 返回 Failure，让 BD 树切入 BD_InvestigateLastKnown。</item>
+    /// </list>
+    ///
+    /// 短暂遮挡（如绕过柱子）在 LostSightBuffer 内不会改变速度，避免追击手感割裂。
+    /// </summary>
+    [TaskName("Chase Player")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("三段式追击（Tracking→Searching→Lost）；丢失视线后进入缓冲期")]
+    public sealed class BD_ChasePlayer : Action
+    {
+        [Header("距离限制")]
+        [Tooltip("追击距离上限（m）；0 = 使用 EnemyStatsSO.MaxChaseDistance")]
+        [SerializeField] [Min(0f)] private float m_MaxChaseDistance = 0f;
+
+        [Header("视线丢失")]
+        [Tooltip("视线丢失判定超时（s）；0 = 使用 EnemyStatsSO.LoseLinkTimeout")]
+        [SerializeField] [Min(0f)] private float m_LoseLinkTimeout = 0f;
+
+        [Tooltip("视线刚丢失后的缓冲期（s）：此期间保持追击速度，短暂遮挡不触发搜索模式")]
+        [SerializeField] [Min(0f)] private float m_LostSightBuffer = 0.3f;
+
+        [Header("路径规划")]
+        [Tooltip("路径重规划阈值（m）：玩家移动超过此距离后才重新规划，避免每帧请求")]
+        [SerializeField] [Min(0.1f)] private float m_ReplanThreshold = 1.5f;
+
+        [Header("搜索阶段")]
+        [Tooltip("Searching 阶段速度倍率（相对于行走速度；<1 = 减速搜索）")]
+        [SerializeField] [UnityEngine.Range(0.3f, 1.5f)] private float m_SearchSpeedMultiplier = 0.7f;
+
+        private enum ChaseSubState { Tracking, Searching }
+
+        private EnemyBase     _enemy;
+        private float         _losTimer;
+        private Vector2       _lastReplanPos;
+        private ChaseSubState _subState;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _enemy.SetAiPhase(AiPhase.Chase);
+            _losTimer      = 0f;
+            _lastReplanPos = Vector2.positiveInfinity;
+            _subState      = ChaseSubState.Tracking;
+
+            float runSpeed = _enemy.Stats?.RunSpeed ?? 4f;
+            _enemy.Nav?.SetSpeed(runSpeed);
+
+            var ac = _enemy.AnimConfig;
+            if (_enemy.Animancer != null && ac?.Run != null)
+                _enemy.Animancer.Play(ac.Run);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null || _enemy.PlayerTransform == null)
+                return TaskStatus.Failure;
+
+            float maxDist  = m_MaxChaseDistance > 0f ? m_MaxChaseDistance : (_enemy.Stats?.MaxChaseDistance ?? 15f);
+            float loseTime = m_LoseLinkTimeout  > 0f ? m_LoseLinkTimeout  : (_enemy.Stats?.LoseLinkTimeout  ?? 2f);
+
+            // 超出最大追击距离 → 放弃追击
+            if (_enemy.Stats != null && _enemy.Stats.SqrDistanceToPlayer > maxDist * maxDist)
+                return TaskStatus.Failure;
+
+            Vector2 playerPos = _enemy.PlayerTransform.position;
+
+            if (_enemy.IsPlayerVisible())
+            {
+                // 视线恢复：Searching → Tracking，恢复奔跑速度
+                if (_subState == ChaseSubState.Searching)
+                {
+                    _subState = ChaseSubState.Tracking;
+                    _enemy.Nav?.SetSpeed(_enemy.Stats?.RunSpeed ?? 4f);
+                }
+                _losTimer = 0f;
+                _enemy.LastKnownPlayerPosition = playerPos;
+            }
+            else
+            {
+                _losTimer += Time.deltaTime;
+
+                if (_subState == ChaseSubState.Tracking)
+                {
+                    // 缓冲期结束 → 切入 Searching：减速并向最后可见位置行进
+                    if (_losTimer >= m_LostSightBuffer)
+                    {
+                        _subState = ChaseSubState.Searching;
+                        float searchSpeed = (_enemy.Stats?.WalkSpeed ?? 2f) * m_SearchSpeedMultiplier;
+                        _enemy.Nav?.SetSpeed(searchSpeed);
+                        _enemy.MoveTo(_enemy.LastKnownPlayerPosition);
+                        _lastReplanPos = _enemy.LastKnownPlayerPosition;
+                    }
+                }
+                else // Searching
+                {
+                    if (_losTimer >= loseTime)
+                        return TaskStatus.Failure; // 搜索超时 → 进入 BD_InvestigateLastKnown
+                }
+            }
+
+            // Tracking 阶段按阈值重规划路径
+            if (_subState == ChaseSubState.Tracking)
+            {
+                float sqrReplan = m_ReplanThreshold * m_ReplanThreshold;
+                if ((playerPos - _lastReplanPos).sqrMagnitude > sqrReplan)
+                {
+                    _enemy.MoveTo(playerPos);
+                    _lastReplanPos = playerPos;
+                }
+            }
+
+            _enemy.FacePlayer();
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd()
+        {
+            float walkSpeed = _enemy?.Stats?.WalkSpeed ?? 2f;
+            _enemy?.Nav?.SetSpeed(walkSpeed);
+            _enemy?.StopMovement();
+            _subState = ChaseSubState.Tracking; // 重置子状态，防止下次激活时以错误状态重入
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_ChasePlayer.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_ChasePlayer.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a7ecfbdf1fee6a141a18c72d36fcfbf2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_EnterPhase.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_EnterPhase.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
@@ -9,22 +9,26 @@ namespace BaseGames.Enemies.AI
    /// BD Action：Boss 切换阶段（Phase）。
    /// 调用 BossBase.EnterPhase(PhaseIndex)，单帧完成，返回 Success。
    /// </summary>
+    [TaskName("Enter Boss Phase")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("立即切换 Boss 到目标阶段序号（单帧完成）")]
    public class BD_EnterPhase : Action
    {
        [UnityEngine.SerializeField] private int m_PhaseIndex = 1;

        private BossBase _boss;

+        public override void OnAwake() => _boss = GetComponent<BossBase>();
+
        public override void OnStart()
        {
-            _boss = GetComponent<BossBase>();
+            // 阶段切换是单帧操作，在 OnStart 完成；OnUpdate 仅汇报结果
+            _boss?.EnterPhase(m_PhaseIndex);
        }

        public override TaskStatus OnUpdate()
        {
-            if (_boss == null) return TaskStatus.Failure;
-            _boss.EnterPhase(m_PhaseIndex);
-            return TaskStatus.Success;
+            return _boss == null ? TaskStatus.Failure : TaskStatus.Success;
        }
    }
 }
--- a/Assets/_Game/Scripts/Enemies/AI/BD_FaceTarget.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_FaceTarget.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -9,21 +9,18 @@ namespace BaseGames.Enemies.AI
    /// <summary>
    /// BD Action：立即朝向玩家，单帧完成，返回 Success。
    /// </summary>
+    [TaskName("Face Target")]
+    [TaskCategory("BaseGames/Enemy/Animation")]
+    [TaskDescription("立即朝向目标 Transform 或玩家，单帧返回 Success")]
    public class BD_FaceTarget : Action
    {
-        private EnemyBase  _enemy;
-        private Transform  _player;
+        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy  = GetComponent<EnemyBase>();
-            var go  = GameObject.FindWithTag("Player");
-            _player = go != null ? go.transform : null;
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
-            if (_enemy == null || _player == null) return TaskStatus.Failure;
+            if (_enemy == null) return TaskStatus.Failure;
            _enemy.FacePlayer();
            return TaskStatus.Success;
        }
--- a/Assets/_Game/Scripts/Enemies/AI/BD_InterruptAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_InterruptAbility.cs
@@ -0,0 +1,32 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>动作：中断指定能力。</summary>
+    [TaskName("Interrupt Ability")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("立即中断指定能力或全部能力")]
+    public sealed class BD_InterruptAbility : Action
+    {
+        [SerializeField] private string          m_AbilityId = "";
+        [SerializeField] private InterruptReason m_Reason    = InterruptReason.ExternalRequest;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            var ab = _enemy.Abilities.Get(m_AbilityId);
+            if (ab == null) return TaskStatus.Failure;
+            ab.Interrupt(m_Reason);
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_InterruptAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_InterruptAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 3db7ca634cc20574dba7f11ab018b23a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_InvestigateLastKnown.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_InvestigateLastKnown.cs
@@ -0,0 +1,184 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：多步搜查（Navigate → LookAround → RandomWalk × N）。
+    ///
+    /// <list type="bullet">
+    ///   <item><b>Navigate</b>：导航至最后可见位置。</item>
+    ///   <item><b>LookAround</b>：到达后原地环顾（播放 Look 动画，持续 LookAroundDuration）。</item>
+    ///   <item><b>WalkRandom</b>：向搜查半径内的随机点移动，重复 RandomStepCount 次。</item>
+    ///   <item>任意阶段重新发现玩家 → 返回 Failure，BD 树重入追击。</item>
+    ///   <item>所有步骤完成仍未发现 → 返回 Success，BD 树归位/恢复巡逻。</item>
+    /// </list>
+    /// </summary>
+    [TaskName("Investigate Last Known Pos")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("多步搜查：导航到最后已知位置 → 环顾四周 → 随机游走 N 次")]
+    public sealed class BD_InvestigateLastKnown : Action
+    {
+        [Tooltip("到达搜查点后环顾的时长（s）")]
+        [SerializeField] private float m_LookAroundDuration = 0.8f;
+
+        [Tooltip("随机行走步数（完成环顾后随机游荡的次数）")]
+        [SerializeField] [Min(0)] private int m_RandomStepCount = 2;
+
+        [Tooltip("随机行走半径（m）")]
+        [SerializeField] private float m_SearchRadius = 2.5f;
+
+        [Tooltip("到达目标点的判定半径（m）")]
+        [SerializeField] private float m_ArriveRadius = 0.6f;
+
+        private enum InvestigateSubStep { Navigate, LookAround, WalkRandom }
+
+        private EnemyBase          _enemy;
+        private InvestigateSubStep _step;
+        private float              _stepTimer;
+        private int                _stepsRemaining;
+        private Vector2            _randomTarget;
+        private bool               _pathFailed;
+        private bool               _subscribed;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _enemy.SetAiPhase(AiPhase.Investigate);
+            _step           = InvestigateSubStep.Navigate;
+            _stepTimer      = 0f;
+            _stepsRemaining = m_RandomStepCount;
+            _pathFailed     = false;
+
+            var ac = _enemy.AnimConfig;
+            if (_enemy.Animancer != null)
+            {
+                var clip = ac?.Investigate ?? ac?.Walk;
+                if (clip != null) _enemy.Animancer.Play(clip);
+            }
+
+            if (!_subscribed && _enemy.Nav != null)
+            {
+                _enemy.Nav.OnNavPathFailed += HandlePathFailed;
+                _subscribed = true;
+            }
+
+            _enemy.MoveTo(_enemy.LastKnownPlayerPosition);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+
+            if (_enemy.IsPlayerVisible()) return TaskStatus.Failure;
+
+            switch (_step)
+            {
+                case InvestigateSubStep.Navigate:    return UpdateNavigate();
+                case InvestigateSubStep.LookAround:  return UpdateLookAround();
+                case InvestigateSubStep.WalkRandom:  return UpdateWalkRandom();
+                default: return TaskStatus.Success;
+            }
+        }
+
+        public override void OnEnd()
+        {
+            if (_subscribed && _enemy?.Nav != null)
+            {
+                _enemy.Nav.OnNavPathFailed -= HandlePathFailed;
+                _subscribed = false;
+            }
+            _enemy?.StopMovement();
+        }
+
+        // ── 阶段逻辑 ────────────────────────────────────────────────────
+        private TaskStatus UpdateNavigate()
+        {
+            Vector2 self = _enemy.transform.position;
+            bool arrived = _pathFailed ||
+                (self - _enemy.LastKnownPlayerPosition).sqrMagnitude <= m_ArriveRadius * m_ArriveRadius;
+
+            if (!arrived) return TaskStatus.Running;
+
+            _enemy.StopMovement();
+            EnterLookAround();
+            return TaskStatus.Running;
+        }
+
+        private TaskStatus UpdateLookAround()
+        {
+            _stepTimer += Time.deltaTime;
+            if (_stepTimer < m_LookAroundDuration) return TaskStatus.Running;
+
+            if (_stepsRemaining > 0)
+                EnterRandomWalk();
+            else
+                return TaskStatus.Success;
+
+            return TaskStatus.Running;
+        }
+
+        private TaskStatus UpdateWalkRandom()
+        {
+            Vector2 self    = _enemy.transform.position;
+            bool    arrived = _pathFailed ||
+                (self - _randomTarget).sqrMagnitude <= m_ArriveRadius * m_ArriveRadius;
+
+            if (!arrived) return TaskStatus.Running;
+
+            _enemy.StopMovement();
+            _stepsRemaining--;
+            _pathFailed = false;
+
+            if (_stepsRemaining > 0)
+                EnterRandomWalk();
+            else
+                return TaskStatus.Success;
+
+            return TaskStatus.Running;
+        }
+
+        // ── 辅助方法 ────────────────────────────────────────────────────
+        private void EnterLookAround()
+        {
+            _step      = InvestigateSubStep.LookAround;
+            _stepTimer = 0f;
+
+            var ac = _enemy.AnimConfig;
+            if (_enemy.Animancer != null)
+            {
+                var clip = ac?.Investigate ?? ac?.Idle;
+                if (clip != null) _enemy.Animancer.Play(clip);
+            }
+        }
+
+        private void EnterRandomWalk()
+        {
+            _step       = InvestigateSubStep.WalkRandom;
+            _pathFailed = false;
+
+            Vector2 origin = _enemy.LastKnownPlayerPosition;
+            // 横板地形中只在水平方向随机偏移，保留 origin.y；
+            // PathBerserker2d 寻路负责处理跨平台的纵向路径规划。
+            float dir  = Random.value > 0.5f ? 1f : -1f;
+            float dist = Random.Range(0.5f, m_SearchRadius);
+            _randomTarget = new Vector2(origin.x + dir * dist, origin.y);
+
+            _enemy.MoveTo(_randomTarget);
+
+            var ac = _enemy.AnimConfig;
+            if (_enemy.Animancer != null)
+            {
+                var clip = ac?.Walk;
+                if (clip != null) _enemy.Animancer.Play(clip);
+            }
+        }
+
+        private void HandlePathFailed() => _pathFailed = true;
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_InvestigateLastKnown.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_InvestigateLastKnown.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 2e43db9982a49864e95812919b0efd10
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsAbilityRunning.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsAbilityRunning.cs
@@ -0,0 +1,34 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>条件：abilityId 当前是否正在运行。</summary>
+    [TaskName("Is Ability Running?")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("检查指定能力当前是否正在执行中")]
+    public sealed class BD_IsAbilityRunning : Conditional
+    {
+        [Tooltip("能力 ScriptableObject（优先级高于下方字符串 ID）")]
+        [SerializeField] private EnemyAbilitySO m_AbilitySO;
+
+        [Tooltip("能力 ID（当 AbilitySO 未赋值时使用）")]
+        [SerializeField] private string m_AbilityId = "";
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            string id = m_AbilitySO != null ? m_AbilitySO.abilityId : m_AbilityId;
+            var ab = _enemy.Abilities.Get(id);
+            return ab != null && ab.IsRunning ? TaskStatus.Success : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsAbilityRunning.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsAbilityRunning.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 254e8e3d6b56229498e94e24e7e53393
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsAiPhase.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsAiPhase.cs
@@ -0,0 +1,36 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Conditional：当前 AI 行为阶段是否与目标匹配。
+    ///
+    /// 常用于 Decorator Conditional Abort 或 Sequence 头部保护子树，
+    /// 例如只有在 <see cref="AiPhase.Patrol"/> 阶段时才执行巡逻序列。
+    /// </summary>
+    [TaskName("Is Ai Phase?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查当前 AI 行为阶段是否与目标枚举值匹配")]
+    public sealed class BD_IsAiPhase : Conditional
+    {
+        [Tooltip("目标 AI 行为阶段")]
+        [SerializeField] private AiPhase m_Phase = AiPhase.Patrol;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            return _enemy.CurrentAiPhase == m_Phase
+                ? TaskStatus.Success
+                : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsAiPhase.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsAiPhase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c5d65c8544c21a146a5f30140acdb5ce
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsGrounded.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsGrounded.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -8,14 +8,14 @@ namespace BaseGames.Enemies.AI
    /// <summary>
    /// BD Conditional：敌人是否处于地面。
    /// </summary>
+    [TaskName("Is Grounded?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查敌人是否接地（适用于触发跳跃或落地逻辑的条件保护）")]
    public class BD_IsGrounded : Conditional
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsHPBelow.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsHPBelow.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -9,22 +9,24 @@ namespace BaseGames.Enemies.AI
    /// BD Conditional：Boss HP 是否低于阈值（用于触发阶段切换）。
    /// HPThreshold 为 0~1 归一化比例（如 0.5 = HP ≤ 50%）。
    /// </summary>
+    [TaskName("Is HP Below Threshold?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查当前 HP 是否低于指定百分比阈值")]
    public class BD_IsHPBelow : Conditional
    {
+        [UnityEngine.Range(0f, 1f)]
        [UnityEngine.SerializeField] private float m_HPThreshold = 0.5f;

        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
            if (_enemy == null || _enemy.Stats == null) return TaskStatus.Failure;

-            float ratio = (float)_enemy.Stats.CurrentHP / _enemy.Stats.MaxHP;
+            float maxHP = UnityEngine.Mathf.Max(1f, _enemy.Stats.MaxHP);
+            float ratio = (float)_enemy.Stats.CurrentHP / maxHP;
            return ratio <= m_HPThreshold ? TaskStatus.Success : TaskStatus.Failure;
        }
    }
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsNearEdge.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsNearEdge.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -9,14 +9,14 @@ namespace BaseGames.Enemies.AI
    /// BD Conditional：敌人是否靠近平台边缘。
    /// 通过 EnemyNavAgent.IsNearEdge() 检测（双射线检测脚下/前方地面）。
    /// </summary>
+    [TaskName("Is Near Edge?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查前方是否有悬崖边缘（基于 SensorToolkit 或 Raycast）")]
    public class BD_IsNearEdge : Conditional
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsOnNavLink.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsOnNavLink.cs
@@ -0,0 +1,35 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 条件：NavAgent 当前是否正在穿越连接段（跳跃/下落/爬梯/传送等）。
+    /// 可选过滤具体连接类型（填 None = 任意类型均匹配）。
+    /// </summary>
+    [TaskName("Is On NavLink?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查 NavAgent 当前是否正在穿越 NavLink（如跳跃传送门）")]
+    public sealed class BD_IsOnNavLink : Conditional
+    {
+        [Tooltip("填 None 匹配任意类型；填具体类型则只在该类型时 Success。")]
+        [SerializeField] private NavLinkType m_FilterType = NavLinkType.None;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy?.Nav == null) return TaskStatus.Failure;
+            if (!_enemy.Nav.IsOnLink) return TaskStatus.Failure;
+            if (m_FilterType != NavLinkType.None && _enemy.Nav.CurrentLinkType != m_FilterType)
+                return TaskStatus.Failure;
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsOnNavLink.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsOnNavLink.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 44406bb7e06320746950682adf59f59c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsPlayerInRange.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsPlayerInRange.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -9,6 +9,9 @@ namespace BaseGames.Enemies.AI
    /// BD Conditional：检查玩家是否在指定范围内。
    /// 成功/失败直接驱动 BT 分支选择（Selector / Sequence 节点）。
    /// </summary>
+    [TaskName("Is Player In Range?")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("检查玩家是否在指定距离内")]
    public class BD_IsPlayerInRange : Conditional
    {
        /// <summary>检测范围（Inspector 可配置，默认 6 米）。</summary>
@@ -16,10 +19,7 @@ namespace BaseGames.Enemies.AI

        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsPlayerVisible.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsPlayerVisible.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
 using BaseGames.Enemies;
@@ -9,14 +9,14 @@ namespace BaseGames.Enemies.AI
    /// BD Conditional：玩家是否可见（LOS 检测）。
    /// 读取 EnemyBase._losResult 字段（由 BatchLOSSystem 每帧写入，或降级 3 帧节流 Raycast）。
    /// </summary>
+    [TaskName("Is Player Visible?")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("检查是否有视线到达玩家（通过 EnemyBase.HasLineOfSight）")]
    public class BD_IsPlayerVisible : Conditional
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsSensorDetecting.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsSensorDetecting.cs
@@ -0,0 +1,41 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies.Perception;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 条件：EnemySensorHub 中名为 slotName 的 Sensor 是否检测到目标。
+    /// 若 m_Target 为空则使用 EnemyBase.PlayerTransform。
+    /// </summary>
+    [TaskName("Is Sensor Detecting?")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("检查 EnemySensorHub 中指定 Sensor 槽是否检测到目标")]
+    public sealed class BD_IsSensorDetecting : Conditional
+    {
+        [SerializeField] private string m_SlotName = "aggro";
+        [SerializeField] private bool   m_AnyTarget = false;
+
+        private EnemySensorHub _hub;
+        private EnemyBase      _enemy;
+
+        public override void OnAwake()
+        {
+            _hub   = gameObject.GetComponent<EnemySensorHub>();
+            _enemy = gameObject.GetComponent<EnemyBase>();
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_hub == null) return TaskStatus.Failure;
+            if (m_AnyTarget)
+                return _hub.HasAnyDetection(m_SlotName) ? TaskStatus.Success : TaskStatus.Failure;
+            var tgt = _enemy != null ? _enemy.PlayerTransform : null;
+            if (tgt == null) return TaskStatus.Failure;
+            return _hub.IsDetecting(m_SlotName, tgt.gameObject) ? TaskStatus.Success : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsSensorDetecting.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsSensorDetecting.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5a1015b63dbb3da4aa877d7e898b394a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_IsStateMatch.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_IsStateMatch.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
@@ -7,36 +7,23 @@ using BaseGames.Enemies;
 namespace BaseGames.Enemies.AI
 {
    /// <summary>
-    /// BD Conditional：敌人当前 EnemyStateType 是否与目标状态名称匹配。
-    /// TargetStateName 直接输入枚举名称字符串（Controlled / Hurt / Stagger / Dead），
-    /// 枚举值顺序变化时 BD 图不会静默失效。
+    /// BD Conditional：敌人当前 EnemyStateType 是否与目标状态匹配。
    /// </summary>
+    [TaskName("Is State Match?")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("检查当前物理/战斗状态是否与目标枚举值匹配")]
    public class BD_IsStateMatch : Conditional
    {
-        /// <summary>目标状态名称（Controlled / Hurt / Stagger / Dead）。</summary>
-        [SerializeField] private string m_TargetStateName = "Controlled";
+        [SerializeField] private EnemyStateType m_TargetState = EnemyStateType.Controlled;

        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
            if (_enemy == null) return TaskStatus.Failure;
-
-            if (!System.Enum.TryParse<EnemyStateType>(m_TargetStateName, out var target))
-            {
-                Debug.LogError($"[BD_IsStateMatch] 未知状态名: '{m_TargetStateName}'，" +
-                               "有效值为 Controlled / Hurt / Stagger / Dead", gameObject);
-                return TaskStatus.Failure;
-            }
-
-            return _enemy.CurrentState == target
-                ? TaskStatus.Success
-                : TaskStatus.Failure;
+            return _enemy.CurrentState == m_TargetState ? TaskStatus.Success : TaskStatus.Failure;
        }
    }
 }
--- a/Assets/_Game/Scripts/Enemies/AI/BD_JumpTo.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_JumpTo.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -10,6 +10,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：跳跃至目标坐标（抛物线跳跃）。
    /// 调用 EnemyBase.JumpTo，待落地（IsGrounded）后返回 Success。
    /// </summary>
+    [TaskName("Jump To")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("执行跳跃动作到达目标高度或 NavLink 对接点")]
    public class BD_JumpTo : Action
    {
        [SerializeField] private Vector2 m_Target;
@@ -17,9 +20,10 @@ namespace BaseGames.Enemies.AI
        private EnemyBase _enemy;
        private bool      _jumped;

+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
        public override void OnStart()
        {
-            _enemy  = GetComponent<EnemyBase>();
            _jumped = false;
        }

--- a/Assets/_Game/Scripts/Enemies/AI/BD_MaintainCombatDistance.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MaintainCombatDistance.cs
@@ -0,0 +1,96 @@
+#if GRAPH_DESIGNER
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using UnityEngine;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：战斗站位控制。
+    /// 在 [m_PreferredMinDist, m_PreferredMaxDist] 范围内保持与玩家的水平距离：
+    ///   - 距离过近 → 后退
+    ///   - 距离过远 → 靠近
+    ///   - 在范围内 → 停止移动，持续朝向玩家
+    /// 始终返回 Running，上层 BT 通过 Abort 或条件终止该 Task。
+    /// </summary>
+    [TaskName("Maintain Combat Distance")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("在战斗中维持与目标的理想距离范围")]
+    public class BD_MaintainCombatDistance : Action
+    {
+        [Tooltip("期望最小距离（m）；小于此值开始后退")]
+        [SerializeField] private float m_PreferredMinDist = 2f;
+
+        [Tooltip("期望最大距离（m）；大于此值开始靠近")]
+        [SerializeField] private float m_PreferredMaxDist = 4f;
+
+        [Tooltip("后退速度（m/s），默认使用 WalkSpeed")]
+        [SerializeField] private float m_BackpedaleSpeed = 0f;
+
+        [Tooltip("每帧重新规划路径的阈值（m）；玩家移动超过此距离才重规划，降低频率")]
+        [SerializeField] private float m_ReplanThreshold = 0.5f;
+
+        private EnemyBase _enemy;
+        private Vector2   _lastPlayerPos;
+        private float     _sqrMin;
+        private float     _sqrMax;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _sqrMin        = m_PreferredMinDist * m_PreferredMinDist;
+            _sqrMax        = m_PreferredMaxDist * m_PreferredMaxDist;
+            _lastPlayerPos = Vector2.positiveInfinity;
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null || _enemy.PlayerTransform == null)
+                return TaskStatus.Failure;
+
+            if (_enemy.Stats == null)
+                return TaskStatus.Failure;
+
+            _enemy.FacePlayer();
+
+            float sqrDist = _enemy.Stats.SqrDistanceToPlayer;
+
+            if (sqrDist < _sqrMin)
+            {
+                // 距离过近 → 后退（向远离玩家方向移动）
+                _enemy.Nav?.StopNavigation();
+                Vector2 toPlayer  = ((Vector2)_enemy.PlayerTransform.position - (Vector2)_enemy.transform.position).normalized;
+                float   backDir   = -Mathf.Sign(toPlayer.x);
+                float   speed     = m_BackpedaleSpeed > 0f ? m_BackpedaleSpeed : _enemy.Stats.WalkSpeed;
+                _enemy.Movement?.MoveWithSpeed(backDir, speed);
+            }
+            else if (sqrDist > _sqrMax)
+            {
+                // 距离过远 → 靠近
+                Vector2 playerPos = _enemy.PlayerTransform.position;
+                float   moved     = ((Vector2)playerPos - _lastPlayerPos).sqrMagnitude;
+                if (moved > m_ReplanThreshold * m_ReplanThreshold)
+                {
+                    _lastPlayerPos = playerPos;
+                    _enemy.MoveTo(playerPos);
+                }
+            }
+            else
+            {
+                // 在最优范围内 → 停止导航，原地保持朝向
+                _enemy.Nav?.StopNavigation();
+                _enemy.Movement?.StopHorizontal();
+            }
+
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd()
+        {
+            _enemy?.Movement?.StopHorizontal();
+            _enemy?.Nav?.StopNavigation();
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_MaintainCombatDistance.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MaintainCombatDistance.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 480875a7bad333140a3c46e637eb7bc6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_MoveTo.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MoveTo.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -10,16 +10,16 @@ namespace BaseGames.Enemies.AI
    /// BD Action：移动到指定世界坐标 Target。
    /// 到达目标（IsAtDestination）后返回 Success。
    /// </summary>
+    [TaskName("Move To")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("导航到目标 Transform 或世界坐标点；到达返回 Success")]
    public class BD_MoveTo : Action
    {
        [SerializeField] private Vector2 m_Target;

        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_MoveToAndWait.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MoveToAndWait.cs
@@ -0,0 +1,58 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 动作：移动到目标并等待 OnGoalReached 事件（事件驱动，替代轮询版 BD_MoveTo）。
+    /// OnGoalReached 触发后返回 Success；路径失败返回 Failure。
+    /// </summary>
+    [TaskName("Move To And Wait")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("导航到目标点，到达后原地等待指定时长，然后返回 Success")]
+    public sealed class BD_MoveToAndWait : Action
+    {
+        [SerializeField] private Transform m_Target;
+
+        private EnemyBase _enemy;
+        private bool      _reached;
+        private bool      _failed;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _reached = _failed = false;
+            if (_enemy?.Nav == null) { _failed = true; return; }
+            _enemy.Nav.OnGoalReached    += HandleReached;
+            _enemy.Nav.OnNavPathFailed  += HandleFailed;
+            var pos = m_Target != null ? (Vector2)m_Target.position
+                     : _enemy.PlayerTransform != null ? (Vector2)_enemy.PlayerTransform.position
+                     : (Vector2)transform.position;
+            _enemy.Nav.RequestMoveTo(pos);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_failed)  return TaskStatus.Failure;
+            if (_reached) return TaskStatus.Success;
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd()
+        {
+            if (_enemy?.Nav != null)
+            {
+                _enemy.Nav.OnGoalReached   -= HandleReached;
+                _enemy.Nav.OnNavPathFailed -= HandleFailed;
+            }
+        }
+
+        private void HandleReached() => _reached = true;
+        private void HandleFailed()  => _failed  = true;
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_MoveToAndWait.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MoveToAndWait.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: df51ca671ebccea47a45c1e1bca3caa3
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_MoveToPlayer.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_MoveToPlayer.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
@@ -10,14 +10,14 @@ namespace BaseGames.Enemies.AI
    /// OnStart 从 EnemyBase.PlayerTransform 获取玩家引用（由 _onPlayerSpawned 事件缓存，
    /// 避免 FindWithTag 全场景扫描）。OnUpdate 每帧更新导航目标。
    /// </summary>
+    [TaskName("Move To Player")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("持续向玩家方向移动，失去视线或超出追踪距离返回 Failure")]
    public class BD_MoveToPlayer : Action
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_OnParried.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_OnParried.cs
@@ -0,0 +1,30 @@
+#if GRAPH_DESIGNER
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Conditionals;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Conditional Task：检查敌人本次 BT Tick 内是否发生了弹反事件。
+    ///
+    /// 返回 <c>Success</c> 时同时清除标志（每次弹反只触发一次响应分支）。
+    /// 典型用法：在 BD 树根部优先分支放置此条件，触发时执行受击硬直 / 反制动画等子树。
+    /// </summary>
+    [TaskName("On Parried?")]
+    [TaskCategory("BaseGames/Enemy/Utility")]
+    [TaskDescription("检查上一次攻击是否被玩家格挡（用于 Boss 反制逻辑）")]
+    public class BD_OnParried : Conditional
+    {
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            return _enemy.ConsumeParryEvent() ? TaskStatus.Success : TaskStatus.Failure;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_OnParried.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_OnParried.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: fdae429711fc46d41a7b025eed43784f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_Patrol.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_Patrol.cs
@@ -1,32 +1,57 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
+using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
-using UnityEngine;
+using BaseGames.Enemies.Perception;

 namespace BaseGames.Enemies.AI
 {
    /// <summary>
-    /// BD Action：敌人巡逻行为。
-    /// 持续令敌人向当前朝向移动，遇墙/边缘时自动转向。
+    /// BD Action：来回踱步巡逻——持续向当前方向移动，遇墙或悬崖时自动翻转方向。
+    ///
+    /// 若需要按预设路点顺序巡逻，请使用 <see cref="BD_PatrolWaypoints"/>（支持 Transform 引用和内联坐标）。
+    ///
+    /// 转向检测优先级：
+    /// <list type="number">
+    ///   <item>EnemySensorHub "wall_ahead" / "ledge" 槽（SensorToolkit，已配置时使用）</item>
+    ///   <item>Physics2D Raycast 兜底（Prefab 未配置 Sensor 时自动启用）</item>
+    /// </list>
    /// </summary>
+    [TaskName("Patrol (Pace)")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("来回踱步巡逻：遇墙或悬崖自动翻转方向（SensorToolkit 优先）")]
    public class BD_Patrol : Action
    {
-        [Tooltip("检测地面边缘的向下射线长度")]
+        [Tooltip("（兜底）检测地面边缘的向下射线长度（m）")]
        public float edgeCheckLength = 1.2f;
-        [Tooltip("检测障碍物的水平射线长度")]
+        [Tooltip("（兜底）检测障碍物的水平射线长度（m）")]
        public float wallCheckLength = 0.4f;
-        [Tooltip("地面/墙壁 LayerMask")]
+        [Tooltip("（兜底）边缘检测射线起点相对角色的前向偏移（m）")]
+        public float edgeCheckFwdOffset  = 0.3f;
+        [Tooltip("（兜底）边缘检测射线起点相对角色的向下偏移（m）")]
+        public float edgeCheckDownOffset = 0.1f;
+        [Tooltip("（兜底）地面/墙壁 LayerMask")]
        public LayerMask groundLayer;

-        private EnemyBase _enemy;
-        private float     _dir = 1f;
+        private EnemyBase      _enemy;
+        private EnemySensorHub _hub;
+        private float          _dir = 1f;

-        public override void OnStart()
+        // 缓存：SensorHub 中对应槽位是否已配置（Awake 时查询一次，避免每帧 Dictionary 查找）
+        private bool _hasWallSensor;
+        private bool _hasEdgeSensor;
+
+        public override void OnAwake()
        {
-            _enemy = GetComponent<EnemyBase>();
+            _enemy         = GetComponent<EnemyBase>();
+            _hub           = GetComponent<EnemySensorHub>();
+            _hasWallSensor = _hub != null && _hub.Get(SensorSlotNames.WallAhead) != null;
+            _hasEdgeSensor = _hub != null && _hub.Get(SensorSlotNames.Ledge)     != null;
        }

+        public override void OnStart() => _enemy?.SetAiPhase(AiPhase.Patrol);
+
        public override TaskStatus OnUpdate()
        {
            if (_enemy == null) return TaskStatus.Failure;
@@ -38,27 +63,33 @@ namespace BaseGames.Enemies.AI
            return TaskStatus.Running;
        }

-        public override void OnEnd()
-        {
-            _enemy?.StopMovement();
-        }
+        public override void OnEnd() => _enemy?.StopMovement();

        private bool ShouldFlip()
        {
-            Transform t = _enemy.transform;
-            Vector2 pos = t.position;
+            if (_hub != null)
+            {
+                // 有传感器配置：用传感器结果，完全跳过 Raycast
+                if (_hasWallSensor || _hasEdgeSensor)
+                {
+                    bool wallHit = _hasWallSensor && _hub.HasAnyDetection(SensorSlotNames.WallAhead);
+                    bool edgeHit = _hasEdgeSensor && _hub.HasAnyDetection(SensorSlotNames.Ledge);
+                    return wallHit || edgeHit;
+                }
+            }

-            // 前方边缘检测：在脚前方向下射线，若无地面则转向
-            Vector2 edgeOrigin = pos + Vector2.right * (_dir * 0.3f) + Vector2.down * 0.1f;
+            // Raycast 兜底：仅在未配置 Sensor 时执行
+            Transform t   = _enemy.transform;
+            Vector2   pos = t.position;
+
+            Vector2 edgeOrigin = pos + Vector2.right * (_dir * edgeCheckFwdOffset) + Vector2.down * edgeCheckDownOffset;
            bool hasGround = Physics2D.Raycast(edgeOrigin, Vector2.down, edgeCheckLength, groundLayer);
            if (!hasGround) return true;

-            // 前方障碍检测：水平射线，若撞墙则转向
            bool hitWall = Physics2D.Raycast(pos, Vector2.right * _dir, wallCheckLength, groundLayer);
-            if (hitWall) return true;
-
-            return false;
+            return hitWall;
        }
    }
 }
 #endif
+
--- a/Assets/_Game/Scripts/Enemies/AI/BD_PatrolWaypoints.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_PatrolWaypoints.cs
@@ -0,0 +1,185 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：按预设路点顺序巡逻（支持 Transform 引用或内联 Vector2 坐标两种模式）。
+    ///
+    /// <list type="bullet">
+    ///   <item><b>m_Waypoints（Transform[]）</b>：拖入场景中的路点对象；适合动态路点（可在运行时移动）。</item>
+    ///   <item><b>m_InlineWaypoints（Vector2[]）</b>：直接填写世界坐标；无需在场景中放置对象，编辑器中以 Gizmo 可视化路径。</item>
+    ///   <item>两者同时设置时 m_Waypoints 优先。</item>
+    /// </list>
+    ///
+    /// 到达最后一个路点后可循环（Loop）或往返（PingPong）。
+    /// 与 PathBerserker2d 集成：通过 IPathAgent.RequestMoveTo 导航，支持跨平台跳跃 NavLink。
+    /// </summary>
+    [TaskName("Patrol (Waypoints)")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("按预设路点顺序巡逻；支持 Transform 引用或内联 Vector2 坐标，可循环或折返")]
+    public sealed class BD_PatrolWaypoints : Action
+    {
+        [Tooltip("路点列表（世界空间 Transform）；与 m_InlineWaypoints 同时设置时此项优先")]
+        [SerializeField] private Transform[] m_Waypoints;
+
+        [Tooltip("内联路点坐标（世界空间 Vector2）；m_Waypoints 为空时使用；在 Scene 视图中以绿色 Gizmo 可视化")]
+        [SerializeField] private Vector2[] m_InlineWaypoints;
+
+        [Tooltip("到达路点的判定半径（m）")]
+        [SerializeField] private float m_ArriveRadius = 0.3f;
+
+        [Tooltip("true = 往返; false = 循环")]
+        [SerializeField] private bool m_PingPong = false;
+
+        [Tooltip("每个路点到达后等待时长（s）")]
+        [SerializeField] private float m_WaitAtWaypoint = 0f;
+
+        private EnemyBase _enemy;
+        private int       _index     = 0;
+        private int       _dir       = 1;
+        private float     _waitTimer = 0f;
+        private bool      _waiting   = false;
+
+        // ── 统一路点访问 ────────────────────────────────────────────────────
+        private int WaypointCount =>
+            m_Waypoints != null && m_Waypoints.Length > 0
+                ? m_Waypoints.Length
+                : m_InlineWaypoints?.Length ?? 0;
+
+        private Vector2 GetWaypoint(int index)
+        {
+            if (m_Waypoints != null && m_Waypoints.Length > 0)
+            {
+                var t = m_Waypoints[index];
+                return t != null ? (Vector2)t.position : (Vector2)transform.position;
+            }
+            return m_InlineWaypoints != null && index < m_InlineWaypoints.Length
+                ? m_InlineWaypoints[index]
+                : (Vector2)transform.position;
+        }
+
+        // ── BD 生命周期 ─────────────────────────────────────────────────────
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            if (WaypointCount == 0) return;
+            _waiting   = false;
+            _waitTimer = 0f;
+            _enemy?.SetAiPhase(AiPhase.Patrol);
+            RequestCurrent();
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null || WaypointCount == 0)
+                return TaskStatus.Failure;
+
+            if (_waiting)
+            {
+                _waitTimer -= Time.deltaTime;
+                if (_waitTimer > 0f) return TaskStatus.Running;
+                _waiting = false;
+                Advance();
+                RequestCurrent();
+            }
+            else
+            {
+                Vector2 wp      = GetWaypoint(_index);
+                float   sqrDist = ((Vector2)_enemy.transform.position - wp).sqrMagnitude;
+
+                if (sqrDist <= m_ArriveRadius * m_ArriveRadius)
+                {
+                    if (m_WaitAtWaypoint > 0f)
+                    {
+                        _waiting   = true;
+                        _waitTimer = m_WaitAtWaypoint;
+                        _enemy.StopMovement();
+                    }
+                    else
+                    {
+                        Advance();
+                        RequestCurrent();
+                    }
+                }
+                else
+                {
+                    _enemy.MoveTo(wp);
+                    _enemy.Movement?.FaceTarget(wp);
+                }
+            }
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd() => _enemy?.StopMovement();
+
+        // ── 内部辅助 ────────────────────────────────────────────────────────
+        private void RequestCurrent()
+        {
+            if (WaypointCount == 0) return;
+            _enemy.MoveTo(GetWaypoint(_index));
+        }
+
+        private void Advance()
+        {
+            if (WaypointCount <= 1) return;
+            if (m_PingPong)
+            {
+                _index += _dir;
+                if (_index >= WaypointCount) { _index = WaypointCount - 2; _dir = -1; }
+                else if (_index < 0)         { _index = 1;                 _dir =  1; }
+            }
+            else
+            {
+                _index = (_index + 1) % WaypointCount;
+            }
+        }
+
+        // ── Gizmo 可视化（仅 m_InlineWaypoints 模式）────────────────────────
+#if UNITY_EDITOR
+        private new void OnDrawGizmos()
+        {
+            if (m_InlineWaypoints == null || m_InlineWaypoints.Length < 1) return;
+            // m_Waypoints 存在时不绘制，避免与场景路点重叠
+            if (m_Waypoints != null && m_Waypoints.Length > 0) return;
+
+            Gizmos.color = new Color(0.2f, 0.85f, 0.2f, 0.8f);
+            for (int i = 0; i < m_InlineWaypoints.Length; i++)
+            {
+                Gizmos.DrawWireSphere(m_InlineWaypoints[i], m_ArriveRadius);
+
+                if (i < m_InlineWaypoints.Length - 1)
+                    Gizmos.DrawLine(m_InlineWaypoints[i], m_InlineWaypoints[i + 1]);
+            }
+
+            // PingPong 时也画返回线；Loop 时画首尾连接线
+            if (m_InlineWaypoints.Length >= 2)
+            {
+                if (m_PingPong)
+                {
+                    // 往返：虚线效果（半透明线）
+                    Gizmos.color = new Color(0.2f, 0.85f, 0.2f, 0.35f);
+                    Gizmos.DrawLine(m_InlineWaypoints[m_InlineWaypoints.Length - 1], m_InlineWaypoints[0]);
+                }
+                else
+                {
+                    // 循环：画首尾连接
+                    Gizmos.color = new Color(0.2f, 0.85f, 0.2f, 0.5f);
+                    Gizmos.DrawLine(m_InlineWaypoints[m_InlineWaypoints.Length - 1], m_InlineWaypoints[0]);
+                }
+            }
+
+            // 编辑器标签（路点序号）
+            UnityEditor.Handles.color = new Color(0.2f, 0.85f, 0.2f, 1f);
+            for (int i = 0; i < m_InlineWaypoints.Length; i++)
+                UnityEditor.Handles.Label(m_InlineWaypoints[i] + Vector2.up * 0.25f, $"WP{i}");
+        }
+#endif
+    }
+}
+#endif
+
--- a/Assets/_Game/Scripts/Enemies/AI/BD_PatrolWaypoints.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_PatrolWaypoints.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e7a2cb1e940ff92499a0ebb9d3063e21
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_PlayAnimation.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_PlayAnimation.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -10,6 +10,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：通过 AnimationClip 名称播放 Animancer 动画，立即返回 Success。
    /// ClipName 需与 EnemyAnimationConfigSO 中字段名一致。
    /// </summary>
+    [TaskName("Play Animation")]
+    [TaskCategory("BaseGames/Enemy/Animation")]
+    [TaskDescription("通过 Animancer 播放指定动画 Clip；支持等待动画结束后返回")]
    public class BD_PlayAnimation : Action
    {
        /// <summary>EnemyAnimationConfigSO 中的 AnimationClip 字段名（如 "Attack_Melee"）。</summary>
@@ -17,10 +20,7 @@ namespace BaseGames.Enemies.AI

        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_ReturnToHome.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_ReturnToHome.cs
@@ -0,0 +1,103 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：归位到出生点（<see cref="EnemyBase.HomePosition"/>）。
+    ///
+    /// <list type="bullet">
+    ///   <item>切换 <see cref="AiPhase.ReturnHome"/>，使用行走速度导航回初始位置。</item>
+    ///   <item>到达（距离 ≤ homeRadius）或路径失败时：切换 <see cref="AiPhase.Idle"/>，返回 Success。</item>
+    ///   <item>路径失败也返回 Success，避免 BD 树卡死；上层节点继续恢复巡逻。</item>
+    /// </list>
+    ///
+    /// 典型 BD 用法：
+    /// <code>
+    /// Sequence
+    ///   BD_InvestigateLastKnown → Success
+    ///   BD_ReturnToHome         → Success
+    ///   BD_SetAiPhase(Patrol)
+    /// </code>
+    /// </summary>
+    [TaskName("Return To Home")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("导航回出生点；到达后切换 Idle 并返回 Success")]
+    public sealed class BD_ReturnToHome : Action
+    {
+        [Tooltip("到达判定半径（m）；0 = 使用 EnemyStatsSO.HomeRadius")]
+        [SerializeField] private float m_ArriveRadius = 0f;
+
+        private EnemyBase _enemy;
+        private bool      _reached;
+        private bool      _pathFailed;
+        private bool      _subscribed;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _enemy.SetAiPhase(AiPhase.ReturnHome);
+            _reached    = false;
+            _pathFailed = false;
+
+            if (!_subscribed && _enemy.Nav != null)
+            {
+                _enemy.Nav.OnGoalReached   += HandleReached;
+                _enemy.Nav.OnNavPathFailed += HandleFailed;
+                _subscribed = true;
+            }
+
+            // 切换为行走速度
+            float walkSpeed = _enemy.Stats?.WalkSpeed ?? 2f;
+            _enemy.Nav?.SetSpeed(walkSpeed);
+
+            // 播放行走动画
+            var ac = _enemy.AnimConfig;
+            if (_enemy.Animancer != null && ac?.Walk != null)
+                _enemy.Animancer.Play(ac.Walk);
+
+            _enemy.MoveTo(_enemy.HomePosition);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+
+            if (_pathFailed) return CompleteReturn();
+            if (_reached)    return CompleteReturn();
+
+            // 兜底距离判断（事件可能因帧序问题延迟一帧）
+            float radius = m_ArriveRadius > 0f ? m_ArriveRadius : (_enemy.Stats?.HomeRadius ?? 0.5f);
+            float sqr    = ((Vector2)_enemy.transform.position - _enemy.HomePosition).sqrMagnitude;
+            if (sqr <= radius * radius)
+                return CompleteReturn();
+
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd()
+        {
+            if (_subscribed && _enemy?.Nav != null)
+            {
+                _enemy.Nav.OnGoalReached   -= HandleReached;
+                _enemy.Nav.OnNavPathFailed -= HandleFailed;
+                _subscribed = false;
+            }
+        }
+
+        private TaskStatus CompleteReturn()
+        {
+            _enemy.StopMovement();
+            _enemy.SetAiPhase(AiPhase.Idle);
+            return TaskStatus.Success;
+        }
+
+        private void HandleReached() => _reached    = true;
+        private void HandleFailed()  => _pathFailed = true;
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_ReturnToHome.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_ReturnToHome.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 0555fce4edd236847b580a2b436bd22f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SetAiPhase.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SetAiPhase.cs
@@ -0,0 +1,34 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：设置 AI 行为阶段（<see cref="AiPhase"/>）。
+    /// 单帧完成，返回 Success。常用于行为树中作为阶段过渡的标记节点，
+    /// 例如在 Selector 分支开头标记当前进入了哪个阶段。
+    /// </summary>
+    [TaskName("Set Ai Phase")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("立即切换 AI 行为阶段（AiPhase），单帧返回 Success")]
+    public sealed class BD_SetAiPhase : Action
+    {
+        [Tooltip("目标 AI 行为阶段")]
+        [SerializeField] private AiPhase m_Phase = AiPhase.Idle;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            _enemy.SetAiPhase(m_Phase);
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SetAiPhase.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SetAiPhase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6f70a0ea7dc70bb4cbf300d19eacfba0
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SetAlert.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SetAlert.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
@@ -8,14 +8,14 @@ namespace BaseGames.Enemies.AI
    /// <summary>
    /// BD Action：设置警觉状态，并通知 EnemyBase 调整 BT Tick 频率。
    /// </summary>
+    [TaskName("Set Alert Tick Rate")]
+    [TaskCategory("BaseGames/Enemy/Perception")]
+    [TaskDescription("切换行为树 Tick 频率：警觉时高频，巡逻时低频")]
    public class BD_SetAlert : Action
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SetState.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SetState.cs
@@ -0,0 +1,45 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：强制切换敌人到指定 EnemyStateType，并中断所有正在执行的能力。
+    /// 单帧完成，立即返回 Success。
+    ///
+    /// 典型用法：
+    ///   - 进入 Stagger 状态后重置为 Idle（替代手动停止动画）
+    ///   - 技能打断后显式回到 Controlled 状态
+    /// </summary>
+    [TaskName("Set State")]
+    [TaskCategory("BaseGames/Enemy/State")]
+    [TaskDescription("强制切换敌人物理/战斗状态（ForceState）")]
+    public class BD_SetState : Action
+    {
+        [Tooltip("切换到的目标状态")]
+        [SerializeField] private EnemyStateType m_TargetState = EnemyStateType.Controlled;
+
+        [Tooltip("切换状态时同时中断所有正在执行的能力")]
+        [SerializeField] private bool m_InterruptAbilities = true;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+
+            if (m_InterruptAbilities)
+                _enemy.Abilities?.InterruptAll(InterruptReason.ExternalRequest);
+
+            _enemy.ForceState(m_TargetState);
+            return TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SetState.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SetState.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d3406f00433d44e449c24b4340b0c49a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SpawnProjectile.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SpawnProjectile.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -11,6 +11,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：在敌人当前位置生成弹射物。
    /// ProjectileKey 为 Addressable 键，通过 GlobalObjectPool 实例化。
    /// </summary>
+    [TaskName("Spawn Projectile")]
+    [TaskCategory("BaseGames/Enemy/Utility")]
+    [TaskDescription("在指定位置生成投射物并赋予初速度")]
    public class BD_SpawnProjectile : Action
    {
        [SerializeField] private Vector2 m_Direction     = Vector2.right;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_StopMovement.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_StopMovement.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
 using BaseGames.Enemies;
@@ -8,14 +8,14 @@ namespace BaseGames.Enemies.AI
    /// <summary>
    /// BD Action：立即停止移动，单帧完成，返回 Success。
    /// </summary>
+    [TaskName("Stop Movement")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("立即停止 NavAgent 移动，单帧返回 Success")]
    public class BD_StopMovement : Action
    {
        private EnemyBase _enemy;

-        public override void OnStart()
-        {
-            _enemy = GetComponent<EnemyBase>();
-        }
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override TaskStatus OnUpdate()
        {
--- a/Assets/_Game/Scripts/Enemies/AI/BD_SummonMinions.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_SummonMinions.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -12,28 +12,40 @@ namespace BaseGames.Enemies.AI
    /// BD Action：Boss 专用召唤小兵。
    /// 通过 GlobalObjectPool 在 Boss 周围生成 MinionPrefabKey 对应的敌人。
    /// </summary>
+    [TaskName("Summon Minions")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("在指定位置生成小怪预制体（支持延迟和数量配置）")]
    public class BD_SummonMinions : Action
    {
+        [Header("召唤配置")]
+        [Tooltip("对象池 Key，对应 PoolRegistry 中注册的小怪预制体。")]
        [SerializeField] private string m_MinionPrefabKey = "";
+        [Tooltip("单次召唤的小兵数量。")]
+        [Min(1)]
        [SerializeField] private int    m_Count           = 2;
+        [Tooltip("小兵生成位置距 Boss 中心的横向散开半径（m）。")]
+        [Min(0.1f)]
        [SerializeField] private float  m_SpawnRadius     = 3f;

+        // 延迟缓存：首次调用时解析，避免每帧服务定位开销
+        private IObjectPoolService _pool;
+
        public override TaskStatus OnUpdate()
        {
            if (string.IsNullOrEmpty(m_MinionPrefabKey)) return TaskStatus.Failure;

-            var pool = ServiceLocator.GetOrDefault<IObjectPoolService>();
-            if (pool == null) return TaskStatus.Failure;
+            _pool ??= ServiceLocator.GetOrDefault<IObjectPoolService>();
+            if (_pool == null) return TaskStatus.Failure;

            for (int i = 0; i < m_Count; i++)
            {
-                var angle    = Random.Range(0f, 360f) * Mathf.Deg2Rad;
-                var offset   = new Vector2(Mathf.Cos(angle), 0f) * m_SpawnRadius;
-                var spawnPos = new Vector3(
+                float angleRad = (i / (float)m_Count) * Mathf.PI * 2f;
+                var   offset   = new Vector2(Mathf.Cos(angleRad), 0f) * m_SpawnRadius;
+                var   spawnPos = new Vector3(
                    transform.position.x + offset.x,
-                    transform.position.y + offset.y,
+                    transform.position.y,
                    0f);
-                pool.Spawn(m_MinionPrefabKey, spawnPos, Quaternion.identity);
+                _pool.Spawn(m_MinionPrefabKey, spawnPos, Quaternion.identity);
            }

            return TaskStatus.Success;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_TelegraphAttack.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_TelegraphAttack.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -10,6 +10,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：触发攻击预警（TelegraphSystem），等待 Duration 秒后返回 Success。
    /// 对应架构 07_EnemyModule §8 BD_TelegraphAttack；与 TelegraphSystem 协作。
    /// </summary>
+    [TaskName("Telegraph Attack")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("播放攻击前摇动画并等待结束后返回 Success")]
    public class BD_TelegraphAttack : Action
    {
        [SerializeField] private float  m_Duration = 1f;
@@ -17,15 +20,18 @@ namespace BaseGames.Enemies.AI

        private TelegraphSystem _telegraph;
        private float           _elapsed;
+        private Coroutine       _telegraphCoroutine;
+
+        public override void OnAwake() => _telegraph = GetComponent<TelegraphSystem>();

        public override void OnStart()
        {
-            _telegraph = GetComponent<TelegraphSystem>();
-            _elapsed   = 0f;
+            _elapsed            = 0f;
+            _telegraphCoroutine = null;

            if (_telegraph != null && !string.IsNullOrEmpty(m_VfxKey))
            {
-                _telegraph.StartCoroutine(
+                _telegraphCoroutine = _telegraph.StartCoroutine(
                    _telegraph.ShowTelegraph(m_VfxKey, m_Duration, transform.position));
            }
        }
@@ -35,6 +41,16 @@ namespace BaseGames.Enemies.AI
            _elapsed += Time.deltaTime;
            return _elapsed >= m_Duration ? TaskStatus.Success : TaskStatus.Running;
        }
+
+        public override void OnEnd()
+        {
+            // BD 任务被 Abort 时停止仍在播放的预警协程，避免孤立 VFX
+            if (_telegraphCoroutine != null)
+            {
+                _telegraph?.StopCoroutine(_telegraphCoroutine);
+                _telegraphCoroutine = null;
+            }
+        }
    }
 }
 #endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_TeleportTo.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_TeleportTo.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -9,6 +9,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：瞬移（传送）到目标坐标，Boss 专用。
    /// 单帧直接修改 transform.position，不使用导航。
    /// </summary>
+    [TaskName("Teleport To")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("瞬移到目标位置（配合粒子/闪烁能力）")]
    public class BD_TeleportTo : Action
    {
        [SerializeField] private Vector2 m_Target;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseAbility.cs
@@ -0,0 +1,58 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 通用：触发能力。OnStart 调用 ability.Execute()，OnUpdate 等待结束。
+    /// 失败条件：能力不存在、能力 CanUse=false 或 Execute 返回 false。
+    /// </summary>
+    [TaskName("Use Ability")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("触发指定能力（拖拽 EnemyAbilitySO 或填写 ID），等待执行结束")]
+    public sealed class BD_UseAbility : Action
+    {
+        [Tooltip("可直接拖拽 EnemyAbilitySO 资产（推荐），或填写裸字符串 ID 作为兜底")]
+        [SerializeField] private EnemyAbilitySO m_AbilitySO;
+        [SerializeField] private string         m_AbilityId = "";
+
+        private EnemyBase           _enemy;
+        private EnemyAbilityBase    _ability;
+        private bool                _startedSuccessfully;
+
+        public override void OnAwake()
+        {
+            _enemy = gameObject.GetComponent<EnemyBase>();
+        }
+
+        public override void OnStart()
+        {
+            _startedSuccessfully = false;
+            if (_enemy == null) return;
+
+            // SO 拖拽优先；裸字符串兜底
+            string id = m_AbilitySO != null ? m_AbilitySO.abilityId : m_AbilityId;
+            if (string.IsNullOrEmpty(id)) return;
+
+            _ability = _enemy.Abilities.Get(id);
+            if (_ability == null) return;
+            _startedSuccessfully = _ability.Execute();
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (!_startedSuccessfully || _ability == null) return TaskStatus.Failure;
+            return _ability.IsRunning ? TaskStatus.Running : TaskStatus.Success;
+        }
+
+        public override void OnEnd()
+        {
+            _ability = null;
+            _startedSuccessfully = false;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 4865a86627f84a54292736e6dc2b9e15
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkill.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkill.cs
@@ -0,0 +1,53 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Boss;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 触发 Boss 技能。OnStart 调用 BossBase.UseBossSkill(skillId)，OnUpdate 等待技能结束。
+    /// 失败条件：非 Boss 敌人、技能 ID 无效、BossSkillExecutor 未就绪或技能执行中。
+    /// </summary>
+    [TaskName("Use Boss Skill")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("通过技能 ID 执行 Boss 指定技能")]
+    public sealed class BD_UseBossSkill : Action
+    {
+        [SerializeField] private string      m_SkillId  = "";
+        [Tooltip("可选：直接拖拽 BossSkillSO 资产以替代裸字符串（优先于 m_SkillId）")]
+        [SerializeField] private BossSkillSO m_SkillSO;
+
+        private BossBase _boss;
+        private bool     _startedSuccessfully;
+
+        public override void OnAwake()
+        {
+            _boss = gameObject.GetComponent<BossBase>();
+        }
+
+        public override void OnStart()
+        {
+            _startedSuccessfully = false;
+            if (_boss == null) return;
+
+            string id = m_SkillSO != null ? m_SkillSO.skillId : m_SkillId;
+            if (string.IsNullOrEmpty(id)) return;
+
+            _startedSuccessfully = _boss.UseBossSkill(id);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (!_startedSuccessfully || _boss == null) return TaskStatus.Failure;
+            return _boss.IsBossSkillExecuting ? TaskStatus.Running : TaskStatus.Success;
+        }
+
+        public override void OnEnd()
+        {
+            _startedSuccessfully = false;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkill.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkill.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8f86542f8dede80438ab28ec682758b6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkillWeighted.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkillWeighted.cs
@@ -0,0 +1,54 @@
+#if GRAPH_DESIGNER
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using UnityEngine;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：在当前阶段可用且冷却就绪的技能中，按 weight 加权随机选择一个技能并执行。
+    ///
+    /// 返回 Running：技能正在执行。
+    /// 返回 Success：技能执行完成。
+    /// 返回 Failure：无可用技能，或执行器忙。
+    ///
+    /// 用法：在 Boss BT 的 Combat 阶段，替代 BD_UseBossSkill（固定 ID）实现随机化技能组合。
+    /// 每个 BossSkillSO 设置 weight 字段控制出现概率：越大越常见。
+    /// </summary>
+    [TaskName("Use Boss Skill (Weighted)")]
+    [TaskCategory("BaseGames/Enemy/Boss")]
+    [TaskDescription("加权随机选择并执行可用技能；对上一次使用的技能施加权重惩罚")]
+    public class BD_UseBossSkillWeighted : Action
+    {
+        [Tooltip("等待技能执行完成后才返回 Success。关闭后执行开始即返回 Success，BT 继续运行其他节点。")]
+        [SerializeField] private bool m_WaitForCompletion = true;
+
+        private BossBase _boss;
+        private bool     _started;
+
+        public override void OnAwake() => _boss = GetComponent<BossBase>();
+
+        public override void OnStart()
+        {
+            _started = false;
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_boss == null) return TaskStatus.Failure;
+
+            if (!_started)
+            {
+                bool ok = _boss.UseBossSkillWeighted();
+                if (!ok) return TaskStatus.Failure;
+                _started = true;
+
+                if (!m_WaitForCompletion) return TaskStatus.Success;
+            }
+
+            // 等待技能执行完成
+            return _boss.IsBossSkillExecuting ? TaskStatus.Running : TaskStatus.Success;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkillWeighted.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_UseBossSkillWeighted.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5cf18a1d81f80c646947ea0475c31108
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_Wait.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_Wait.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -9,6 +9,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：等待固定 Duration 秒后返回 Success。
    /// 适用于攻击前摇、冷却间隔等固定等待。
    /// </summary>
+    [TaskName("Wait")]
+    [TaskCategory("BaseGames/Enemy/Utility")]
+    [TaskDescription("等待固定 Duration 秒后返回 Success")]
    public class BD_Wait : Action
    {
        [UnityEngine.SerializeField] private float m_Duration = 1f;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WaitForAnimation.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WaitForAnimation.cs
@@ -1,4 +1,5 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
+using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -8,23 +9,36 @@ namespace BaseGames.Enemies.AI
 {
    /// <summary>
    /// BD Action：等待当前 Animancer 动画播放完毕再返回 Success。
-    /// 通过 EnemyBase.IsAnimationComplete 轮询（Animancer CurrentState.NormalizedTime >= 1）。
+    /// 通过 Animancer CurrentState.NormalizedTime >= 1 轮询；
+    /// 若动画为循环动画（NormalizedTime 每帧 wrap 到 0），超时后强制返回 Success，防止永久挂死。
    /// </summary>
+    [TaskName("Wait For Animation")]
+    [TaskCategory("BaseGames/Enemy/Animation")]
+    [TaskDescription("等待 Animancer 当前动画播放完毕后返回 Success。循环动画请设置超时时间。")]
    public class BD_WaitForAnimation : Action
    {
+        [Tooltip("安全超时（秒）。若动画是循环型，超时后自动返回 Success。0 = 不启用超时（仅适合非循环动画）。")]
+        [SerializeField, Min(0f)] private float m_Timeout = 5f;
+
        private EnemyBase _enemy;
+        private float     _deadline;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();

        public override void OnStart()
        {
-            _enemy = GetComponent<EnemyBase>();
+            _deadline = m_Timeout > 0f ? Time.time + m_Timeout : float.MaxValue;
        }

        public override TaskStatus OnUpdate()
        {
            if (_enemy == null) return TaskStatus.Failure;

+            // 超时保护：防止循环动画导致永久阻塞
+            if (Time.time >= _deadline) return TaskStatus.Success;
+
            var state = _enemy.Animancer?.States?.Current;
-            if (state == null) return TaskStatus.Success;          // 无动画直接继续
+            if (state == null) return TaskStatus.Success;   // 无动画直接继续
            if (state.NormalizedTime >= 1f) return TaskStatus.Success;

            return TaskStatus.Running;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WaitRandom.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WaitRandom.cs
@@ -1,4 +1,4 @@
-#if GRAPH_DESIGNER
+#if GRAPH_DESIGNER
 using UnityEngine;
 using Opsive.BehaviorDesigner.Runtime.Tasks;
 using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
@@ -9,6 +9,9 @@ namespace BaseGames.Enemies.AI
    /// BD Action：在 [Min, Max] 范围内随机等待后返回 Success。
    /// 适用于巡逻间隔、随机攻击延迟等自然行为。
    /// </summary>
+    [TaskName("Wait (Random)")]
+    [TaskCategory("BaseGames/Enemy/Utility")]
+    [TaskDescription("在 Min~Max 范围内随机等待后返回 Success")]
    public class BD_WaitRandom : Action
    {
        [UnityEngine.SerializeField] private float m_Min = 0.5f;
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WaitUntilAbilityEnd.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WaitUntilAbilityEnd.cs
@@ -0,0 +1,68 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+using BaseGames.Enemies.Abilities;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// BD Action：等待指定能力执行结束后返回 Success。
+    /// 适用于需要同步等待某个由外部触发的能力（而非本节点触发）的场景。
+    ///
+    /// 返回 Running：能力正在执行。
+    /// 返回 Success：能力执行完毕（IsRunning = false）。
+    /// 返回 Failure：能力不存在，或超时保护触发。
+    ///
+    /// 典型用法：Sequence [ BD_UseAbility(A) → BD_WaitUntilAbilityEnd(B) ] 等待 B 被 A 内部链式触发后结束。
+    /// </summary>
+    [TaskName("Wait Until Ability End")]
+    [TaskCategory("BaseGames/Enemy/Combat")]
+    [TaskDescription("等待指定能力执行完成后返回 Success")]
+    public sealed class BD_WaitUntilAbilityEnd : Action
+    {
+        [Tooltip("可直接拖拽 EnemyAbilitySO 资产（推荐），或填写裸字符串 ID 作为兜底")]
+        [SerializeField] private EnemyAbilitySO m_AbilitySO;
+        [SerializeField] private string         m_AbilityId = "";
+
+        [Tooltip("超时保护（秒）；0 = 永不超时")]
+        [SerializeField, Min(0f)] private float m_Timeout = 5f;
+
+        private EnemyBase        _enemy;
+        private EnemyAbilityBase _ability;
+        private float            _deadline;
+
+        public override void OnAwake() => _enemy = GetComponent<EnemyBase>();
+
+        public override void OnStart()
+        {
+            _ability  = null;
+            _deadline = m_Timeout > 0f ? Time.time + m_Timeout : float.MaxValue;
+
+            if (_enemy == null) return;
+            string id = m_AbilitySO != null ? m_AbilitySO.abilityId : m_AbilityId;
+            if (!string.IsNullOrEmpty(id))
+                _ability = _enemy.Abilities?.Get(id);
+        }
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_ability == null) return TaskStatus.Failure;
+
+            if (Time.time >= _deadline)
+            {
+                Debug.LogWarning($"[BD_WaitUntilAbilityEnd] 能力 '{_ability.Config?.abilityId}' 超时，强制中断", gameObject);
+                // 强制中断仍在运行的能力，防止 HitBox/动画协程泄漏
+                if (_ability.IsRunning)
+                    _ability.Interrupt(InterruptReason.ExternalRequest);
+                return TaskStatus.Failure;
+            }
+
+            return _ability.IsRunning ? TaskStatus.Running : TaskStatus.Success;
+        }
+
+        public override void OnEnd() => _ability = null;
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WaitUntilAbilityEnd.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WaitUntilAbilityEnd.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9311a809097042f4b8b5de9681d51d0d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WalkRandom.cs
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WalkRandom.cs
@@ -0,0 +1,44 @@
+#if GRAPH_DESIGNER
+using UnityEngine;
+using Opsive.BehaviorDesigner.Runtime.Tasks;
+using Opsive.BehaviorDesigner.Runtime.Tasks.Actions;
+using BaseGames.Enemies;
+
+namespace BaseGames.Enemies.AI
+{
+    /// <summary>
+    /// 动作：随机游走（调用 NavAgent.SetRandomDestination）。
+    /// 到达目的地后立即选下一个随机点，持续 Running。
+    /// 常用于巡逻 fallback 或无路点的小怪。
+    /// </summary>
+    [TaskName("Walk Random")]
+    [TaskCategory("BaseGames/Enemy/Movement")]
+    [TaskDescription("随机游走：持续选取随机目的地导航（常用于待机巡逻兜底）")]
+    public sealed class BD_WalkRandom : Action
+    {
+        [Tooltip("尝试选取随机点的次数")]
+        [SerializeField] private int m_RetryCount = 5;
+
+        private EnemyBase _enemy;
+
+        public override void OnAwake() => _enemy = gameObject.GetComponent<EnemyBase>();
+
+        public override void OnStart() => TryWalk();
+
+        public override TaskStatus OnUpdate()
+        {
+            if (_enemy == null) return TaskStatus.Failure;
+            if (_enemy.Nav.IsAtDestination()) TryWalk();
+            return TaskStatus.Running;
+        }
+
+        public override void OnEnd() => _enemy?.StopMovement();
+
+        private void TryWalk()
+        {
+            for (int i = 0; i < m_RetryCount; i++)
+                if (_enemy.Nav.WalkToRandom()) break;
+        }
+    }
+}
+#endif
--- a/Assets/_Game/Scripts/Enemies/AI/BD_WalkRandom.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/AI/BD_WalkRandom.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a55d2b270a2c1d34a9b08771feedba62
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AI/BaseGames.Enemies.AI.asmdef
+++ b/Assets/_Game/Scripts/Enemies/AI/BaseGames.Enemies.AI.asmdef
@@ -7,13 +7,14 @@
  "noEngineReferences": false,
  "versionDefines": [],
  "rootNamespace": "BaseGames.Enemies.AI",
-  "references": [
+    "references": [
    "BaseGames.Core",
    "BaseGames.Core.Events",
    "BaseGames.Enemies",
    "BaseGames.Enemies.Boss.Patterns",
    "Opsive.BehaviorDesigner.Runtime",
-    "Kybernetik.Animancer"
+    "Kybernetik.Animancer",
+    "Micosmo.SensorToolkit"
  ],
  "autoReferenced": true,
  "overrideReferences": false,
--- a/Assets/_Game/Scripts/Enemies/Abilities.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d5d161f28bc68404ead8b5d52e9ad335
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/AbilityRunState.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRunState.cs
@@ -0,0 +1,26 @@
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 能力执行的阶段枚举（架构 07_EnemyModule §8）。
+    /// 用于 BD/Animator/UI 查询能力当前在哪个阶段（telegraph/出招/恢复）。
+    /// </summary>
+    public enum AbilityRunState
+    {
+        Idle,
+        Telegraph,
+        Windup,
+        Active,
+        Recovery,
+        Interrupted
+    }
+
+    /// <summary>能力中断原因。供 BD 判断是否需要重新调度。</summary>
+    public enum InterruptReason
+    {
+        ExternalRequest,
+        Hurt,
+        Stagger,
+        KnockUp,
+        Dead
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/AbilityRunState.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/AbilityRunState.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 82020b408d70f45448de169667bc80a9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/BlinkStrikeAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/BlinkStrikeAbility.cs
@@ -0,0 +1,193 @@
+using System;
+using System.Collections;
+using UnityEngine;
+using BaseGames.Core;
+using BaseGames.Core.Pool;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 闪烁突袭能力：消失后瞬移到目标侧后方/上方/侧翼，现身后衔接出手。
+    ///
+    /// 流程：
+    /// 1. 选择闪烁目标点（玩家侧后 / 上方 / 侧翼，依 <see cref="BlinkPosition"/>）
+    /// 2. 隐身（隐藏 SpriteRenderer、关闭碰撞、播放消失 VFX）
+    /// 3. 等待 disappearDuration 营造"消失"感
+    /// 4. 瞬移到目标点
+    /// 5. 现身 + 出现 VFX + 预警闪光（reappearTelegraph）
+    /// 6. 调用 followUpAbilityId 指定的能力作为出手（若为空则播放 attackSequence[0]）
+    ///
+    /// 同时实现 <see cref="INavLinkHandler"/> for <see cref="NavLinkType.Teleport"/>：
+    /// 当 PathBerserker2d 路径包含 teleport NavLink 时，本能力接管穿越逻辑，
+    /// 播放消失/出现动画后告知 NavAgent 继续路径，而不触发战斗出手。
+    /// </summary>
+    public sealed class BlinkStrikeAbility : EnemyAbilityBase, INavLinkHandler
+    {
+        public enum BlinkPosition { BehindTarget, FrontTarget, AboveTarget, FlankTarget }
+
+        [Header("闪烁参数")]
+        [SerializeField] private BlinkPosition _blinkPosition  = BlinkPosition.BehindTarget;
+        [SerializeField] private float _offsetDistance         = 1.8f;
+        [SerializeField] private float _verticalOffsetAbove    = 3.0f;
+        [SerializeField] private float _disappearDuration      = 0.25f;
+        [SerializeField] private float _reappearTelegraph      = 0.20f;
+        [SerializeField] private LayerMask _groundMask;
+        [SerializeField] private float _groundSnapMaxDistance  = 3f;
+
+        [Header("视觉")]
+        [SerializeField] private SpriteRenderer[] _renderers;
+        [SerializeField] private Collider2D[]     _disableDuringBlink;
+        [SerializeField] private string _disappearVfxKey       = "";
+        [SerializeField] private string _appearVfxKey          = "";
+
+        [Header("出手能力（在现身后触发，若为空则播放第一段攻击动画）")]
+        [SerializeField] private string _followUpAbilityId     = "";
+
+        private Rigidbody2D _rb;
+        private IObjectPoolService _pool;
+        private Coroutine _navLinkCoroutine;
+
+        // ── INavLinkHandler（Teleport 连接段穿越）─────────────────────
+        private static readonly NavLinkType[] _handledTypes = new[] { NavLinkType.Teleport };
+        public NavLinkType[] HandledLinkTypes => _handledTypes;
+
+        public bool CanHandleLink(NavLinkType type, Vector2 linkStart, Vector2 linkEnd) => true;
+
+        public void BeginLinkTraversal(NavLinkType type, Vector2 linkStart, Vector2 linkEnd, Action onComplete)
+        {
+            if (_navLinkCoroutine != null) StopCoroutine(_navLinkCoroutine);
+            _navLinkCoroutine = StartCoroutine(TeleportNavLinkCoroutine(linkEnd, onComplete));
+        }
+
+        public void AbortLinkTraversal()
+        {
+            if (_navLinkCoroutine != null) { StopCoroutine(_navLinkCoroutine); _navLinkCoroutine = null; }
+            SetVisible(true);
+        }
+
+        /// <summary>纯导航用传送：消失 → 移动到连接终点 → 出现，不触发战斗出手。</summary>
+        private IEnumerator TeleportNavLinkCoroutine(Vector2 destination, Action onComplete)
+        {
+            _pool ??= ServiceLocator.GetOrDefault<IObjectPoolService>();
+
+            if (!string.IsNullOrEmpty(_disappearVfxKey))
+                _pool?.Spawn(_disappearVfxKey, _transform.position, Quaternion.identity);
+            SetVisible(false);
+            if (_rb != null) _rb.velocity = Vector2.zero;
+            yield return EnemyAbilityWaits.Get(_disappearDuration);
+
+            if (_rb != null) _rb.position = destination;
+            else _transform.position     = destination;
+
+            SetVisible(true);
+            if (!string.IsNullOrEmpty(_appearVfxKey))
+                _pool?.Spawn(_appearVfxKey, _transform.position, Quaternion.identity);
+
+            _navLinkCoroutine = null;
+            onComplete?.Invoke(); // 通知 EnemyNavAgent → CompleteLinkTraversal
+        }
+
+        protected override void Awake()
+        {
+            base.Awake();
+            _rb = GetComponentInParent<Rigidbody2D>();
+            if (_renderers == null || _renderers.Length == 0)
+                _renderers = GetComponentsInChildren<SpriteRenderer>(true);
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            _pool ??= ServiceLocator.GetOrDefault<IObjectPoolService>();
+            var target = _enemy != null ? _enemy.PlayerTransform : null;
+            if (target == null) yield break;
+
+            // 1. 消失
+            if (!string.IsNullOrEmpty(_disappearVfxKey))
+                _pool?.Spawn(_disappearVfxKey, _transform.position, Quaternion.identity);
+            SetVisible(false);
+            if (_rb != null) _rb.velocity = Vector2.zero;
+            yield return EnemyAbilityWaits.Get(_disappearDuration);
+
+            // 2. 选目标点 + 瞬移
+            Vector2 dest = ComputeBlinkPosition(target);
+            if (_rb != null) _rb.position = dest;
+            else _transform.position = dest;
+            FaceTarget(target);
+
+            // 3. 现身 + 预警
+            SetVisible(true);
+            if (!string.IsNullOrEmpty(_appearVfxKey))
+                _pool?.Spawn(_appearVfxKey, _transform.position, Quaternion.identity);
+            Phase = AbilityRunState.Telegraph;
+            yield return EnemyAbilityWaits.Get(_reappearTelegraph);
+
+            // 4. 出手
+            Phase = AbilityRunState.Active;
+            if (!string.IsNullOrEmpty(_followUpAbilityId) && _enemy != null)
+            {
+                var follow = _enemy.Abilities.Get(_followUpAbilityId);
+                if (follow != null)
+                {
+                    follow.Execute();
+                    while (follow.IsRunning) yield return null;
+                    yield break;
+                }
+            }
+            // 退化路径：播放第一段动画
+            var seq = _config != null ? _config.attackSequence : null;
+            if (seq != null && seq.Length > 0)
+            {
+                var atk = seq[0];
+                float dur = atk.fallbackDuration;
+                if (atk.clip != null && _animancer != null)
+                {
+                    var st = _animancer.Play(atk.clip);
+                    if (st != null && st.Length > 0f) dur = st.Length;
+                }
+                yield return EnemyAbilityWaits.Get(dur);
+            }
+        }
+
+        protected override void OnInterrupted(InterruptReason reason)
+        {
+            // 中断时同时终止 NavLink 穿越协程（若正在进行），防止 onComplete 回调污染导航状态
+            AbortLinkTraversal();
+        }
+
+        private Vector2 ComputeBlinkPosition(Transform target)
+        {
+            Vector2 t = target.position;
+            Vector2 selfDir = (t - (Vector2)_transform.position);
+            float facing = selfDir.x >= 0f ? 1f : -1f;
+            Vector2 raw;
+            switch (_blinkPosition)
+            {
+                case BlinkPosition.FrontTarget: raw = t + new Vector2(facing * _offsetDistance, 0f); break;
+                case BlinkPosition.AboveTarget: raw = t + new Vector2(0f, _verticalOffsetAbove);     break;
+                case BlinkPosition.FlankTarget:
+                    raw = t + new Vector2((UnityEngine.Random.value < 0.5f ? -1f : 1f) * _offsetDistance, 0f);
+                    break;
+                case BlinkPosition.BehindTarget:
+                default:
+                    float tFacing = target.localScale.x >= 0f ? 1f : -1f;
+                    raw = t - new Vector2(tFacing * _offsetDistance, 0f);
+                    break;
+            }
+            // 贴地（避免悬空）
+            var hit = Physics2D.Raycast(raw + Vector2.up * 0.5f, Vector2.down,
+                                        _groundSnapMaxDistance + 0.5f, _groundMask);
+            if (hit.collider != null) raw.y = hit.point.y + 0.05f;
+            return raw;
+        }
+
+        private void SetVisible(bool visible)
+        {
+            if (_renderers != null)
+                for (int i = 0; i < _renderers.Length; i++)
+                    if (_renderers[i] != null) _renderers[i].enabled = visible;
+            if (_disableDuringBlink != null)
+                for (int i = 0; i < _disableDuringBlink.Length; i++)
+                    if (_disableDuringBlink[i] != null) _disableDuringBlink[i].enabled = visible;
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/BlinkStrikeAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/BlinkStrikeAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8fca68990cbd3b1428ba2c45bbf87d86
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/CeilingDropAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/CeilingDropAbility.cs
@@ -0,0 +1,91 @@
+using System.Collections;
+using UnityEngine;
+using BaseGames.Combat;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 挂顶下落能力：怪物初始挂在天花板（kinematic，重力 0）。能力触发后：
+    /// 1. 切换为 dynamic + 恢复重力
+    /// 2. 自由落体到接触地面
+    /// 3. 落地播放 AoE HitBox + 砸地反馈
+    /// </summary>
+    [RequireComponent(typeof(Rigidbody2D))]
+    public sealed class CeilingDropAbility : EnemyAbilityBase
+    {
+        [Header("下落")]
+        [SerializeField] private float _fallGravityScale = 3.5f;
+        [SerializeField] private float _maxFallTime      = 3f;
+        [SerializeField] private LayerMask _groundMask;
+
+        [Header("落地")]
+        [SerializeField] private HitBox _landingHitBox;
+        [SerializeField] private float  _hitBoxActiveTime = 0.2f;
+        [SerializeField] private float  _recoveryTime     = 0.4f;
+
+        private Rigidbody2D _rb;
+        private RigidbodyType2D _origBodyType;
+        private float           _origGravityScale;
+
+        protected override void Awake()
+        {
+            base.Awake();
+            _rb = GetComponentInParent<Rigidbody2D>();
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            if (_rb == null) yield break;
+            var atk = (_config.attackSequence != null && _config.attackSequence.Length > 0)
+                ? _config.attackSequence[0] : null;
+
+            Phase = AbilityRunState.Active;
+
+            // 切换到动态 + 恢复重力
+            _origBodyType    = _rb.bodyType;
+            _origGravityScale = _rb.gravityScale;
+            _rb.bodyType    = RigidbodyType2D.Dynamic;
+            _rb.gravityScale = _fallGravityScale;
+            _rb.velocity    = Vector2.zero;
+
+            float t = 0f;
+            while (t < _maxFallTime)
+            {
+                t += Time.fixedDeltaTime;
+                yield return new WaitForFixedUpdate();
+                if (t > 0.05f && IsGrounded()) break;
+            }
+
+            _rb.velocity = Vector2.zero;
+
+            if (_landingHitBox != null)
+            {
+                _landingHitBox.Activate(atk != null ? atk.damageSource : null, _transform);
+                yield return EnemyAbilityWaits.Get(_hitBoxActiveTime);
+                _landingHitBox.Deactivate();
+            }
+
+            yield return EnemyAbilityWaits.Get(_recoveryTime);
+
+            // 落地后不恢复挂顶状态（一般转为地面行为），保持动态 Rigidbody
+        }
+
+        private bool IsGrounded()
+        {
+            var hit = Physics2D.Raycast(_rb.position, Vector2.down, 0.6f, _groundMask);
+            return hit.collider != null;
+        }
+
+        protected override void OnInterrupted(InterruptReason reason)
+        {
+            if (_landingHitBox != null && _landingHitBox.IsActive) _landingHitBox.Deactivate();
+            // 中断时恢复 Rigidbody 原始状态，防止物理参数泄漏
+            if (_rb != null)
+            {
+                _rb.velocity     = Vector2.zero;
+                _rb.bodyType     = _origBodyType;
+                _rb.gravityScale = _origGravityScale;
+            }
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/CeilingDropAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/CeilingDropAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e91a8a04726e4144ab7c4d87064ec2f8
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/ChargeAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/ChargeAbility.cs
@@ -0,0 +1,95 @@
+using System.Collections;
+using UnityEngine;
+using BaseGames.Combat;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 直线冲锋能力：朝目标方向高速直线冲锋，撞墙时进入硬直恢复。
+    /// 流程：朝向目标 → 蓄力 → 高速直线冲锋直到撞墙或超距 → 恢复。
+    /// 冲锋期间 HitBox 持续激活；可选撞墙时硬直。
+    /// </summary>
+    [RequireComponent(typeof(Rigidbody2D))]
+    public sealed class ChargeAbility : EnemyAbilityBase
+    {
+        [Header("冲锋参数")]
+        [SerializeField] [Min(0.1f)] private float   _chargeSpeed     = 14f;
+        [SerializeField] [Min(0.1f)] private float   _maxDistance     = 12f;
+        [SerializeField] private float   _windupTime      = 0.4f;
+        [SerializeField] private float   _recoveryTime    = 0.6f;
+        [SerializeField] private float   _wallCheckDist   = 0.4f;
+        [SerializeField] private LayerMask _wallMask;
+        [SerializeField] private bool    _stunOnWallHit   = true;
+        [SerializeField] private float   _wallStunTime    = 0.8f;
+
+        [Header("HitBox")]
+        [SerializeField] private HitBox  _chargeHitBox;
+
+        [Header("动画 Key")]
+        [SerializeField] private string _windupAnimSlot  = "";
+        [SerializeField] private string _chargeAnimSlot  = "";
+
+        private Rigidbody2D _rb;
+        private float       _direction;
+
+        protected override void Awake()
+        {
+            base.Awake();
+            _rb = GetComponentInParent<Rigidbody2D>();
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            if (_rb == null) yield break;
+
+            FaceTarget(_enemy != null ? _enemy.PlayerTransform : null);
+            _direction = _transform.localScale.x >= 0f ? 1f : -1f;
+
+            var seq = _config != null ? _config.attackSequence : null;
+            var windupAtk = (seq != null && seq.Length > 0) ? seq[0] : null;
+            var chargeAtk = (seq != null && seq.Length > 1) ? seq[1] : windupAtk;
+
+            // Windup
+            if (windupAtk != null && windupAtk.clip != null && _animancer != null)
+                _animancer.Play(windupAtk.clip);
+            _rb.velocity = new Vector2(0f, _rb.velocity.y);
+            yield return EnemyAbilityWaits.Get(_windupTime);
+
+            // Charge
+            Phase = AbilityRunState.Active;
+            if (chargeAtk != null && chargeAtk.clip != null && _animancer != null)
+                _animancer.Play(chargeAtk.clip);
+            if (_chargeHitBox != null)
+                _chargeHitBox.Activate(chargeAtk != null ? chargeAtk.damageSource : null, _transform);
+
+            Vector2 start = _rb.position;
+            bool wallHit = false;
+            float maxTime = (_maxDistance / _chargeSpeed) * 3f; // 3 倍容差兜底，防止极端物理情况下死循环
+            float elapsed = 0f;
+            while (true)
+            {
+                _rb.velocity = new Vector2(_chargeSpeed * _direction, _rb.velocity.y);
+                yield return new WaitForFixedUpdate();
+                elapsed += Time.fixedDeltaTime;
+                if (elapsed >= maxTime) break; // 超时保护
+                float traveled = Mathf.Abs(_rb.position.x - start.x);
+                if (traveled >= _maxDistance) break;
+                var hit = Physics2D.Raycast(_rb.position, new Vector2(_direction, 0f), _wallCheckDist, _wallMask);
+                if (hit.collider != null) { wallHit = true; break; }
+            }
+
+            _rb.velocity = new Vector2(0f, _rb.velocity.y);
+            if (_chargeHitBox != null && _chargeHitBox.IsActive) _chargeHitBox.Deactivate();
+
+            // Recovery
+            float recover = wallHit && _stunOnWallHit ? _wallStunTime : _recoveryTime;
+            yield return EnemyAbilityWaits.Get(recover);
+        }
+
+        protected override void OnInterrupted(InterruptReason reason)
+        {
+            if (_chargeHitBox != null && _chargeHitBox.IsActive) _chargeHitBox.Deactivate();
+            if (_rb != null) _rb.velocity = Vector2.zero; // 完整清零速度，包含 y 轴
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/ChargeAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/ChargeAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 66784dd946e412049ad4425aa7be8a47
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityBase.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityBase.cs
@@ -0,0 +1,189 @@
+using System.Collections;
+using UnityEngine;
+using Animancer;
+using BaseGames.Core;
+using BaseGames.Core.Pool;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 敌人能力抽象基类（架构 07_EnemyModule §8.4）。
+    /// 责任：生命周期管理、冷却计时、中断分发。子类只实现 <see cref="ExecuteCoroutine"/>。
+    ///
+    /// 设计要点：
+    /// - 单一执行实例：同一能力同时只有一个协程在跑。
+    /// - 协程内 yield WaitForSeconds 复用 <see cref="EnemyAbilityWaits"/>（无 GC）。
+    /// - 受击/死亡时由 <see cref="EnemyBase"/> 调用 <see cref="Interrupt"/>。
+    /// </summary>
+    [DisallowMultipleComponent]
+    public abstract class EnemyAbilityBase : MonoBehaviour
+    {
+        [Header("配置 SO")]
+        [SerializeField] protected EnemyAbilitySO _config;
+
+        // 缓存依赖（Awake 填入，热路径无 GetComponent）
+        protected EnemyBase           _enemy;
+        protected AnimancerComponent  _animancer;
+        protected Transform           _transform;
+
+        private Coroutine _runner;
+        private float     _cooldownEndTime = -1f;
+        private bool      _isRunning;
+
+        // ── 公共状态 ─────────────────────────────────────────────────────
+        public EnemyAbilitySO Config            => _config;
+        public bool           IsRunning         => _isRunning;
+        public AbilityRunState Phase            { get; protected set; } = AbilityRunState.Idle;
+        public float          CooldownRemaining => Mathf.Max(0f, _cooldownEndTime - Time.time);
+        public bool           IsOnCooldown      => CooldownRemaining > 0f;
+
+        /// <summary>能力被外部中断时触发（BD Task / 状态机订阅用）。</summary>
+        public event System.Action<InterruptReason> Interrupted;
+
+        /// <summary>BD 任务统一查询入口：当前是否可用（冷却完毕且未执行中）。</summary>
+        public virtual bool CanUse => !_isRunning && !IsOnCooldown && _enemy != null && _enemy.IsAlive;
+
+        protected virtual void Awake()
+        {
+            _enemy     = GetComponentInParent<EnemyBase>();
+            _animancer = _enemy != null ? _enemy.Animancer : GetComponentInParent<AnimancerComponent>();
+            _transform = transform;
+            if (_enemy == null)
+                Debug.LogError($"[EnemyAbilityBase] {GetType().Name} 找不到 EnemyBase。", this);
+            if (_animancer == null)
+                Debug.LogWarning($"[EnemyAbilityBase] {GetType().Name} 找不到 AnimancerComponent，动画能力将无法播放动画。", this);
+        }
+
+        protected virtual void OnDisable()
+        {
+            if (_isRunning) Interrupt(InterruptReason.ExternalRequest);
+        }
+
+        // ── 执行 ─────────────────────────────────────────────────────────
+        /// <summary>
+        /// 启动能力。重复调用、冷却中或已运行将返回 false。
+        /// 若 <see cref="EnemyAbilitySO.exclusionGroup"/> 非空，会先中断同组其他能力（互斥）。
+        /// </summary>
+        public bool Execute()
+        {
+            if (!CanUse) return false;
+
+            // 互斥组：启动前中断同组正在运行的其他能力
+            if (_config != null && !string.IsNullOrEmpty(_config.exclusionGroup))
+                _enemy?.Abilities.InterruptGroup(_config.exclusionGroup, InterruptReason.ExternalRequest);
+
+            _runner    = StartCoroutine(RunInternal());
+            return true;
+        }
+
+        /// <summary>
+        /// 强制启动能力，忽略冷却检查（连段语义：外部组合技调用子能力时使用）。
+        /// 若能力正在运行则先中断再重启。
+        /// </summary>
+        public bool ForceExecute()
+        {
+            if (_enemy == null || !_enemy.IsAlive) return false;
+            if (_isRunning) Interrupt(InterruptReason.ExternalRequest);
+            _runner = StartCoroutine(RunInternal());
+            return true;
+        }
+
+        private IEnumerator RunInternal()
+        {
+            _isRunning = true;
+            Phase      = AbilityRunState.Telegraph;
+            try
+            {
+                if (_config != null && _config.telegraphDuration > 0f)
+                    yield return TelegraphRoutine();
+
+                Phase = AbilityRunState.Windup;
+                yield return ExecuteCoroutine();
+                Phase = AbilityRunState.Recovery;
+            }
+            finally
+            {
+                _isRunning       = false;
+                _runner          = null;
+                _cooldownEndTime = Time.time + (_config != null ? _config.cooldown : 0f);
+                if (Phase != AbilityRunState.Interrupted) Phase = AbilityRunState.Idle;
+                OnAbilityEnded();
+            }
+        }
+
+        /// <summary>子类实现：能力主体。可分多段、含 HitBox 激活/弹幕生成/物理推进等。</summary>
+        protected abstract IEnumerator ExecuteCoroutine();
+
+        /// <summary>预警阶段（默认生成 VFX 后等待 telegraphDuration）。子类可重写。</summary>
+        protected virtual IEnumerator TelegraphRoutine()
+        {
+            if (!string.IsNullOrEmpty(_config.telegraphVfxKey))
+            {
+                var pool = ServiceLocator.GetOrDefault<IObjectPoolService>();
+                pool?.Spawn(_config.telegraphVfxKey, _transform.position, Quaternion.identity);
+            }
+            yield return EnemyAbilityWaits.Get(_config.telegraphDuration);
+        }
+
+        /// <summary>能力结束钩子（被中断或正常结束都会调用）。</summary>
+        protected virtual void OnAbilityEnded() { }
+
+        /// <summary>中断当前执行。冷却仍会按配置计入。</summary>
+        public void Interrupt(InterruptReason reason)
+        {
+            if (!_isRunning) return;
+            if (_config != null)
+            {
+                if (reason == InterruptReason.Hurt    && !_config.interruptOnHurt)    return;
+                if (reason == InterruptReason.Stagger && !_config.interruptOnStagger) return;
+            }
+            if (_runner != null) StopCoroutine(_runner);
+            _runner    = null;
+            _isRunning = false;
+            Phase      = AbilityRunState.Interrupted;
+            OnInterrupted(reason);
+            Interrupted?.Invoke(reason);
+            OnAbilityEnded();
+            _cooldownEndTime = Time.time + (_config != null ? _config.cooldown * 0.5f : 0f);
+        }
+
+        protected virtual void OnInterrupted(InterruptReason reason) { }
+
+        /// <summary>子类辅助：朝向目标。</summary>
+        protected void FaceTarget(Transform target)
+        {
+            if (target == null || _enemy == null) return;
+            float dx = target.position.x - _transform.position.x;
+            if (Mathf.Abs(dx) < 0.001f) return;
+            var s = _transform.localScale;
+            s.x = Mathf.Abs(s.x) * Mathf.Sign(dx);
+            _transform.localScale = s;
+        }
+    }
+
+    /// <summary>WaitForSeconds 池（架构 §10 GC 优化）。能力协程统一通过此获取等待指令。</summary>
+    internal static class EnemyAbilityWaits
+    {
+        private const int MaxCacheSize = 64;
+
+        private static readonly System.Collections.Generic.Dictionary<float, WaitForSeconds> _cache
+            = new System.Collections.Generic.Dictionary<float, WaitForSeconds>(32);
+        public static WaitForSeconds Get(float seconds)
+        {
+            if (seconds <= 0f) return null;
+            if (!_cache.TryGetValue(seconds, out var w))
+            {
+                if (_cache.Count < MaxCacheSize)
+                {
+                    w = new WaitForSeconds(seconds);
+                    _cache[seconds] = w;
+                }
+                else
+                {
+                    return new WaitForSeconds(seconds);
+                }
+            }
+            return w;
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityBase.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityBase.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: d701244b04517a34d8f9214a606ba46e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityRegistry.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityRegistry.cs
@@ -0,0 +1,79 @@
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 能力注册表（架构 07_EnemyModule §8.3）。
+    /// EnemyBase.Awake 时调用 <see cref="CollectFrom"/> 自动扫描子物体上所有
+    /// <see cref="EnemyAbilityBase"/> 组件，按 abilityId 建立 O(1) 查询字典。
+    /// </summary>
+    public sealed class EnemyAbilityRegistry
+    {
+        private readonly Dictionary<string, EnemyAbilityBase> _byId
+            = new Dictionary<string, EnemyAbilityBase>(8);
+        private readonly List<EnemyAbilityBase> _all = new List<EnemyAbilityBase>(8);
+
+        /// <summary>所有已注册能力（只读）。</summary>
+        public IReadOnlyList<EnemyAbilityBase> All => _all;
+
+        public void CollectFrom(GameObject root)
+        {
+            _byId.Clear();
+            _all.Clear();
+            root.GetComponentsInChildren(true, _all);
+            for (int i = 0; i < _all.Count; i++)
+            {
+                var ab = _all[i];
+                if (ab == null || ab.Config == null || string.IsNullOrEmpty(ab.Config.abilityId))
+                    continue;
+                if (_byId.ContainsKey(ab.Config.abilityId))
+                {
+                    Debug.LogError($"[EnemyAbilityRegistry] 重复 abilityId='{ab.Config.abilityId}' 于 {ab.gameObject.name}，后注册者被忽略。请检查配置。", ab);
+                    continue;
+                }
+                _byId.Add(ab.Config.abilityId, ab);
+            }
+        }
+
+        public EnemyAbilityBase Get(string abilityId)
+        {
+            if (string.IsNullOrEmpty(abilityId)) return null;
+            _byId.TryGetValue(abilityId, out var ab);
+            return ab;
+        }
+
+        public T Get<T>() where T : EnemyAbilityBase
+        {
+            for (int i = 0; i < _all.Count; i++)
+                if (_all[i] is T t) return t;
+            return null;
+        }
+
+        public bool Has(string abilityId) => _byId.ContainsKey(abilityId);
+
+        public void InterruptAll(InterruptReason reason)
+        {
+            for (int i = 0; i < _all.Count; i++)
+            {
+                var ab = _all[i];
+                if (ab != null && ab.IsRunning) ab.Interrupt(reason);
+            }
+        }
+
+        /// <summary>
+        /// 中断指定互斥组内所有正在执行的能力。
+        /// 由 <see cref="EnemyAbilityBase"/> 在 Execute 开始时调用，确保同组互斥。
+        /// </summary>
+        public void InterruptGroup(string group, InterruptReason reason = InterruptReason.ExternalRequest)
+        {
+            if (string.IsNullOrEmpty(group)) return;
+            for (int i = 0; i < _all.Count; i++)
+            {
+                var ab = _all[i];
+                if (ab != null && ab.IsRunning && ab.Config?.exclusionGroup == group)
+                    ab.Interrupt(reason);
+            }
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityRegistry.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilityRegistry.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 7542012f25c120f4aad1914db8852b59
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilitySO.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilitySO.cs
@@ -0,0 +1,46 @@
+using UnityEngine;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 能力配置包（架构 07_EnemyModule §8.2）。
+    /// 一个能力 = 一组攻击段 + 公共参数（冷却/预警/中断规则）。
+    /// 由对应 EnemyAbilityBase 子类组件读取并执行。
+    /// </summary>
+    [CreateAssetMenu(menuName = "BaseGames/Enemies/Enemy Ability", fileName = "EAB_")]
+    public class EnemyAbilitySO : ScriptableObject
+    {
+        [Header("标识")]
+        [Tooltip("BD 任务通过此 Id 调用能力（如 \"melee_combo\" / \"blink_strike\"）")]
+        public string abilityId = "ability_id";
+
+        [Header("攻击序列")]
+        public EnemyAttackSO[] attackSequence;
+
+        [Header("冷却（秒，从能力执行结束开始计）")]
+        [Min(0f)] public float cooldown = 1.5f;
+
+        [Header("预警（Telegraph）")]
+        [Tooltip("预警 VFX key（IObjectPoolService.Spawn 的池 key），为空则跳过")]
+        public string telegraphVfxKey = "";
+        [Min(0f)] public float telegraphDuration = 0f;
+
+        [Header("中断规则")]
+        [Tooltip("受击时是否打断能力（false=能力具霸体）")]
+        public bool interruptOnHurt    = true;
+        [Tooltip("Stagger 时是否打断（一般为 true）")]
+        public bool interruptOnStagger = true;
+
+        [Header("调度提示（供 AI 选择参考，不强制）")]
+        [Min(0f)] public float preferredMinRange = 0f;
+        [Min(0f)] public float preferredMaxRange = 5f;
+        public bool requiresLineOfSight = true;
+        public bool requiresGrounded   = true;
+
+        [Header("互斥组与调度优先级")]
+        [Tooltip("互斥组名：同组能力只能有一个同时执行，执行时自动中断同组其他能力；为空 = 无互斥")]
+        public string exclusionGroup = "";
+        [Tooltip("AI 调度优先级（值越高越优先被选择，冷却就绪时对比）")]
+        [Min(0)] public int priority = 0;
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilitySO.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAbilitySO.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9050afa76362dff469c64fbb48c9ff8d
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAttackSO.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAttackSO.cs
@@ -0,0 +1,48 @@
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 单段攻击数据（架构 07_EnemyModule §8.1）。
+    /// 描述"一次攻击"的所有要素：动画、HitBox 时机、伤害源、可选射弹。
+    /// EnemyAbilitySO.attackSequence 按顺序组合多段为完整能力。
+    /// </summary>
+    [UnityEngine.CreateAssetMenu(menuName = "BaseGames/Enemies/Enemy Attack", fileName = "EATK_")]
+    public class EnemyAttackSO : UnityEngine.ScriptableObject
+    {
+        [UnityEngine.Header("标识（仅调试用）")]
+        public string attackName = "Attack";
+
+        [UnityEngine.Header("动画")]
+        [UnityEngine.Tooltip("动画片段。若为空则跳过动画，按 fallbackDuration 推进。")]
+        public Animancer.ClipTransition clip;
+        [UnityEngine.Tooltip("clip 为空时本段总时长（秒）")]
+        public float fallbackDuration = 0.6f;
+
+        [UnityEngine.Header("HitBox 时机（归一化 0-1，相对动画长度）")]
+        [UnityEngine.Tooltip("HitBox 槽位名（在 MeleeAttackAbility 的 hitBoxSlots 中索引），为空表示无近战 HitBox")]
+        public string hitBoxSlot = "";
+        [UnityEngine.Range(0f, 1f)] public float hitBoxEnterT = 0.30f;
+        [UnityEngine.Range(0f, 1f)] public float hitBoxExitT  = 0.55f;
+
+        [UnityEngine.Header("伤害源")]
+        public BaseGames.Combat.DamageSourceSO damageSource;
+
+        [UnityEngine.Header("射弹（远程能力使用）")]
+        public BaseGames.Combat.ProjectileConfigSO projectileConfig;
+        [UnityEngine.Min(1)] public int projectileCount = 1;
+        [UnityEngine.Range(0f, 180f)] public float spreadAngleDeg = 0f;
+        [UnityEngine.Tooltip("射弹生成时机（归一化）")]
+        [UnityEngine.Range(0f, 1f)] public float projectileFireT = 0.40f;
+
+        [UnityEngine.Header("段间衔接")]
+        [UnityEngine.Tooltip("本段结束后到下一段开始的延迟（秒）")]
+        public float postDelay = 0f;
+        [UnityEngine.Tooltip("本段是否锁定移动（设速度为0）")]
+        public bool lockMovement = true;
+
+        [UnityEngine.Header("可选霸体窗口")]
+        public bool                  hasPoiseWindow = false;
+        public BaseGames.Combat.PoiseLevel poiseLevel = BaseGames.Combat.PoiseLevel.Light;
+        [UnityEngine.Range(0f, 1f)] public float poiseStartT = 0.10f;
+        [UnityEngine.Range(0f, 1f)] public float poiseEndT   = 0.55f;
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/EnemyAttackSO.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/EnemyAttackSO.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 33dae93853f55b34c95cb12fb235c8b6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/LeapAttackAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/LeapAttackAbility.cs
@@ -0,0 +1,98 @@
+using System.Collections;
+using UnityEngine;
+using BaseGames.Combat;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 跳跃俯冲能力：起跳后以抛物线轨迹扑向目标，落地触发 AoE。
+    /// 流程：起跳预备 → 抛物线移动到目标 → 落地 AoE。
+    /// 使用 Rigidbody2D 直接物理推动；NavAgent 在执行期间被禁用以避免冲突。
+    /// </summary>
+    [RequireComponent(typeof(Rigidbody2D))]
+    public sealed class LeapAttackAbility : EnemyAbilityBase
+    {
+        [Header("跳跃参数")]
+        [SerializeField] private float   _jumpHeight       = 4f;
+        [SerializeField] private float   _maxRange         = 8f;
+        [SerializeField] private float   _windupTime       = 0.35f;
+        [SerializeField] private float   _recoveryTime     = 0.4f;
+        [SerializeField] private LayerMask _groundMask;
+
+        [Header("落地 AoE")]
+        [SerializeField] private HitBox  _landingHitBox;
+        [SerializeField] private float   _hitBoxActiveTime = 0.15f;
+
+        private Rigidbody2D _rb;
+        private float       _origGravity;
+
+        protected override void Awake()
+        {
+            base.Awake();
+            _rb = GetComponentInParent<Rigidbody2D>();
+            if (_rb != null) _origGravity = _rb.gravityScale;
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            if (_rb == null || _enemy == null || _enemy.PlayerTransform == null) yield break;
+            var atk = _config.attackSequence != null && _config.attackSequence.Length > 0
+                ? _config.attackSequence[0] : null;
+
+            FaceTarget(_enemy.PlayerTransform);
+
+            // Windup（可选动画）
+            if (atk != null && atk.clip != null && _animancer != null)
+                _animancer.Play(atk.clip);
+            yield return EnemyAbilityWaits.Get(_windupTime);
+
+            // 计算抛物线初速度
+            Vector2 from = _rb.position;
+            Vector2 to   = _enemy.PlayerTransform.position;
+            float dx = Mathf.Clamp(to.x - from.x, -_maxRange, _maxRange);
+            float g  = Mathf.Abs(Physics2D.gravity.y) * _origGravity;
+            float vy = Mathf.Sqrt(2f * g * Mathf.Max(0.1f, _jumpHeight));
+            float tUp   = vy / g;
+            float dyDown = (from.y + _jumpHeight) - to.y;
+            float tDown = Mathf.Sqrt(2f * Mathf.Max(0.01f, dyDown) / g);
+            float total = tUp + tDown;
+            float vx = dx / Mathf.Max(0.1f, total);
+
+            Phase = AbilityRunState.Active;
+            _rb.velocity = new Vector2(vx, vy);
+
+            // 空中飞行直到接触地面
+            yield return null;
+            float airTimer = 0f;
+            while (airTimer < total + 0.5f)
+            {
+                airTimer += Time.fixedDeltaTime;
+                yield return new WaitForFixedUpdate();
+                if (airTimer > 0.1f && IsGrounded()) break;
+            }
+            _rb.velocity = new Vector2(0f, _rb.velocity.y);
+
+            // 落地 AoE
+            if (_landingHitBox != null)
+            {
+                var src = atk != null ? atk.damageSource : null;
+                _landingHitBox.Activate(src, _transform);
+                yield return EnemyAbilityWaits.Get(_hitBoxActiveTime);
+                _landingHitBox.Deactivate();
+            }
+
+            yield return EnemyAbilityWaits.Get(_recoveryTime);
+        }
+
+        private bool IsGrounded()
+        {
+            var hit = Physics2D.Raycast(_rb.position, Vector2.down, 0.6f, _groundMask);
+            return hit.collider != null;
+        }
+
+        protected override void OnInterrupted(InterruptReason reason)
+        {
+            if (_landingHitBox != null && _landingHitBox.IsActive) _landingHitBox.Deactivate();
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/LeapAttackAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/LeapAttackAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 1f6cb37d9690ce647ae1e3385d86eb96
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/MeleeAttackAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/MeleeAttackAbility.cs
@@ -0,0 +1,119 @@
+using System.Collections;
+using System.Collections.Generic;
+using UnityEngine;
+using BaseGames.Combat;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 近战连击能力。
+    /// 按 EnemyAbilitySO.attackSequence 顺序播放动画段，每段在 hitBoxEnterT~hitBoxExitT
+    /// 之间激活对应槽位的 HitBox。
+    ///
+    /// 设计：HitBox 通过命名槽位绑定，避免对 EnemyCombat 的硬依赖；同一敌人多个近战
+    /// 能力可共享同一 HitBox 槽位（如不同段使用同一把武器）。
+    /// </summary>
+    public sealed class MeleeAttackAbility : EnemyAbilityBase
+    {
+        [System.Serializable]
+        public struct HitBoxSlot
+        {
+            public string slotName;
+            public HitBox hitBox;
+        }
+
+        [Header("HitBox 槽位（按名字索引）")]
+        [SerializeField] private HitBoxSlot[] _hitBoxSlots;
+
+        [Header("行为")]
+        [SerializeField] private bool _faceTargetOnStart = true;
+
+        private Dictionary<string, HitBox> _slotMap;
+
+        protected override void Awake()
+        {
+            base.Awake();
+            _slotMap = new Dictionary<string, HitBox>(_hitBoxSlots?.Length ?? 0);
+            if (_hitBoxSlots != null)
+            {
+                for (int i = 0; i < _hitBoxSlots.Length; i++)
+                {
+                    var s = _hitBoxSlots[i];
+                    if (s.hitBox != null && !string.IsNullOrEmpty(s.slotName))
+                        _slotMap[s.slotName] = s.hitBox;
+                }
+            }
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            var seq = _config != null ? _config.attackSequence : null;
+            if (seq == null || seq.Length == 0) yield break;
+
+            if (_faceTargetOnStart && _enemy != null && _enemy.PlayerTransform != null)
+                FaceTarget(_enemy.PlayerTransform);
+
+            for (int i = 0; i < seq.Length; i++)
+            {
+                var atk = seq[i];
+                if (atk == null) continue;
+                yield return PlayAttackStep(atk);
+                if (atk.postDelay > 0f)
+                    yield return EnemyAbilityWaits.Get(atk.postDelay);
+            }
+        }
+
+        private IEnumerator PlayAttackStep(EnemyAttackSO atk)
+        {
+            Phase = AbilityRunState.Active;
+
+            float duration = atk.fallbackDuration;
+            if (atk.clip != null && _animancer != null)
+            {
+                var state = _animancer.Play(atk.clip);
+                if (state != null && state.Length > 0f) duration = state.Length;
+            }
+
+            HitBox hb = null;
+            if (!string.IsNullOrEmpty(atk.hitBoxSlot))
+                _slotMap.TryGetValue(atk.hitBoxSlot, out hb);
+
+            float enterAbs = atk.hitBoxEnterT * duration;
+            float exitAbs  = atk.hitBoxExitT  * duration;
+            float t = 0f;
+            bool active = false;
+
+            while (t < duration)
+            {
+                t += Time.deltaTime;
+                if (hb != null)
+                {
+                    if (!active && t >= enterAbs)
+                    {
+                        hb.Activate(atk.damageSource, _transform);
+                        active = true;
+                    }
+                    else if (active && t >= exitAbs)
+                    {
+                        hb.Deactivate();
+                        active = false;
+                    }
+                }
+                yield return null;
+            }
+
+            if (active && hb != null) hb.Deactivate();
+        }
+
+        protected override void OnInterrupted(InterruptReason reason)
+        {
+            // 确保 HitBox 被关闭，防止中断时残留激活
+            if (_hitBoxSlots == null) return;
+            for (int i = 0; i < _hitBoxSlots.Length; i++)
+            {
+                var hb = _hitBoxSlots[i].hitBox;
+                if (hb != null && hb.IsActive) hb.Deactivate();
+            }
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/MeleeAttackAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/MeleeAttackAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 971ba82e05d87234e8b944760542e47c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/MultiDashAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/MultiDashAbility.cs
@@ -0,0 +1,49 @@
+using System.Collections;
+using UnityEngine;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 连续冲刺能力：将另一个 ChargeAbility 作为单次冲刺单元顺序触发 dashCount 次。
+    /// 每次冲刺之间间隔 pauseBetweenDashes 秒，每次冲刺前可重新朝向目标。
+    /// </summary>
+    public sealed class MultiDashAbility : EnemyAbilityBase
+    {
+        [Header("冲刺单元")]
+        [Tooltip("作为冲刺单元的 ChargeAbility 的 abilityId")]
+        [SerializeField] private string _dashAbilityId = "charge";
+
+        [Header("节奏")]
+        [SerializeField, Min(1)] private int _dashCount = 3;
+        [SerializeField, Min(0f)] private float _pauseBetweenDashes = 0.25f;
+        [SerializeField] private bool _refaceTargetEachDash = true;
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            if (_enemy == null) yield break;
+            var dash = _enemy.Abilities.Get(_dashAbilityId);
+            if (dash == null)
+            {
+                Debug.LogWarning($"[MultiDashAbility] 找不到冲刺单元 abilityId='{_dashAbilityId}'", this);
+                yield break;
+            }
+
+            for (int i = 0; i < _dashCount; i++)
+            {
+                if (_refaceTargetEachDash && _enemy.PlayerTransform != null)
+                    FaceTarget(_enemy.PlayerTransform);
+
+                // 强制执行子冲刺（连段语义，忽略冷却）
+                if (!dash.ForceExecute())
+                {
+                    Debug.LogWarning($"[MultiDashAbility] ForceExecute 失败（第 {i + 1} 次）", this);
+                    yield break;
+                }
+                while (dash.IsRunning) yield return null;
+
+                if (i < _dashCount - 1 && _pauseBetweenDashes > 0f)
+                    yield return EnemyAbilityWaits.Get(_pauseBetweenDashes);
+            }
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/MultiDashAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/MultiDashAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 10880cfeb05429946854cce4b0e24626
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/Abilities/ProjectileAttackAbility.cs
+++ b/Assets/_Game/Scripts/Enemies/Abilities/ProjectileAttackAbility.cs
@@ -0,0 +1,126 @@
+using System.Collections;
+using UnityEngine;
+using BaseGames.Combat;
+using BaseGames.Core;
+using BaseGames.Core.Pool;
+
+namespace BaseGames.Enemies.Abilities
+{
+    /// <summary>
+    /// 远程射弹能力（扇形 / 弹幕）。
+    /// 每段攻击按 projectileFireT 触发，从池中生成 projectileCount 个抛射物，
+    /// 按 spreadAngleDeg 均布角度。
+    /// </summary>
+    public sealed class ProjectileAttackAbility : EnemyAbilityBase
+    {
+        [Header("发射点（为空则使用本物体位置）")]
+        [SerializeField] private Transform _muzzle;
+
+        [Header("行为")]
+        [SerializeField] private bool _faceTargetOnStart = true;
+
+        private IObjectPoolService _pool;
+
+        protected override void Awake()
+        {
+            base.Awake();
+            if (_muzzle == null) _muzzle = _transform;
+        }
+
+        protected override IEnumerator ExecuteCoroutine()
+        {
+            _pool ??= ServiceLocator.GetOrDefault<IObjectPoolService>();
+            var seq = _config != null ? _config.attackSequence : null;
+            if (seq == null || seq.Length == 0) yield break;
+
+            if (_faceTargetOnStart && _enemy != null && _enemy.PlayerTransform != null)
+                FaceTarget(_enemy.PlayerTransform);
+
+            for (int i = 0; i < seq.Length; i++)
+            {
+                var atk = seq[i];
+                if (atk == null) continue;
+                yield return PlayShot(atk);
+                if (atk.postDelay > 0f) yield return EnemyAbilityWaits.Get(atk.postDelay);
+            }
+        }
+
+        private IEnumerator PlayShot(EnemyAttackSO atk)
+        {
+            Phase = AbilityRunState.Active;
+            float duration = atk.fallbackDuration;
+            if (atk.clip != null && _animancer != null)
+            {
+                var state = _animancer.Play(atk.clip);
+                if (state != null && state.Length > 0f) duration = state.Length;
+            }
+
+            float fireAbs = atk.projectileFireT * duration;
+            float t = 0f;
+            bool fired = false;
+
+            while (t < duration)
+            {
+                t += Time.deltaTime;
+                if (!fired && t >= fireAbs)
+                {
+                    SpawnVolley(atk);
+                    fired = true;
+                }
+                yield return null;
+            }
+            if (!fired) SpawnVolley(atk);
+        }
+
+        private void SpawnVolley(EnemyAttackSO atk)
+        {
+            if (_pool == null || atk.projectileConfig == null) return;
+            var cfg = atk.projectileConfig;
+            if (string.IsNullOrEmpty(cfg.PoolKey)) return;
+
+            Vector2 baseDir = GetAimDirection();
+            int count = Mathf.Max(1, atk.projectileCount);
+            float spread = atk.spreadAngleDeg;
+            float startAngle = -spread * 0.5f;
+            float step = count > 1 ? spread / (count - 1) : 0f;
+
+            var src    = atk.damageSource != null ? atk.damageSource : cfg.DamageSource;
+            int layer  = gameObject.layer;
+
+            for (int i = 0; i < count; i++)
+            {
+                float angle = startAngle + step * i;
+                Vector2 dir = Rotate(baseDir, angle);
+
+                var go = _pool.Spawn(cfg.PoolKey, _muzzle.position, Quaternion.identity);
+                if (go == null)
+                {
+                    Debug.LogWarning($"[ProjectileAttackAbility] 对象池 '{cfg.PoolKey}' 无法获取弹体，请检查池配置或容量。", this);
+                    continue;
+                }
+                var proj = go.GetComponent<Projectile>();
+                if (proj == null)
+                {
+                    Debug.LogWarning($"[ProjectileAttackAbility] 弹体 '{go.name}' 缺少 Projectile 组件，请检查 Prefab 配置。", this);
+                    continue;
+                }
+                var info = DamageInfo.From(src, dir, _muzzle.position, layer, proj);
+                proj.Initialize(cfg, info, dir, layer);
+            }
+        }
+
+        private Vector2 GetAimDirection()
+        {
+            if (_enemy != null && _enemy.PlayerTransform != null)
+                return ((Vector2)_enemy.PlayerTransform.position - (Vector2)_muzzle.position).normalized;
+            return _transform.localScale.x >= 0f ? Vector2.right : Vector2.left;
+        }
+
+        private static Vector2 Rotate(Vector2 v, float degrees)
+        {
+            float rad = degrees * Mathf.Deg2Rad;
+            float c = Mathf.Cos(rad), s = Mathf.Sin(rad);
+            return new Vector2(v.x * c - v.y * s, v.x * s + v.y * c);
+        }
+    }
+}
--- a/Assets/_Game/Scripts/Enemies/Abilities/ProjectileAttackAbility.cs.meta
+++ b/Assets/_Game/Scripts/Enemies/Abilities/ProjectileAttackAbility.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a80eb7827a2ec3b44bc7ad651e86dbce
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/_Game/Scripts/Enemies/AiPhase.cs
+++ b/Assets/_Game/Scripts/Enemies/AiPhase.cs
@@ -0,0 +1,45 @@
+namespace BaseGames.Enemies
+{
+    /// <summary>
+    /// 敌人 AI 行为阶段枚举（独立于 EnemyStateType 的物理/战斗状态）。
+    ///
+    /// 两套状态正交关系：
+    /// - <see cref="EnemyStateType"/>：受击/击飞/死亡等物理事件驱动的瞬时状态。
+    /// - <see cref="AiPhase"/>：行为树主动切换的持续阶段，反映 AI 当前的战术意图。
+    ///
+    /// 典型切换路径：
+    /// <code>
+    /// Idle / Patrol
+    ///   → [感知触发] → Alert（短暂警觉动作）
+    ///   → Chase（追击）
+    ///   → Combat（攻击范围内）
+    ///     ↓ 丢失视线超时
+    ///   → Investigate（前往最后可见位置搜查）
+    ///     ↓ 搜查完成或超出范围
+    ///   → ReturnHome（归位）→ Patrol
+    /// </code>
+    /// </summary>
+    public enum AiPhase
+    {
+        /// <summary>未激活，静止或播放待机循环动画。</summary>
+        Idle,
+
+        /// <summary>沿路点或随机目的地正常巡逻，无感知威胁。</summary>
+        Patrol,
+
+        /// <summary>感知到威胁后的短暂警觉过渡阶段，通常播放抬头/发现动作后进入 Chase。</summary>
+        Alert,
+
+        /// <summary>全力追击玩家，使用奔跑速度。</summary>
+        Chase,
+
+        /// <summary>玩家在攻击距离内，准备或正在执行攻击。</summary>
+        Combat,
+
+        /// <summary>丢失目标后前往最后可见坐标搜查，若无发现则切 ReturnHome 或 Patrol。</summary>
+        Investigate,
+
+        /// <summary>超出追击范围或搜查结束后归位到初始位置。</summary>
+        ReturnHome,
+    }
+}
--- a/Show More
+++ b/Show More