feat(ai): 新增 IBossControl facet——Boss 阶段状态经 IAiContext 供图读取

非 Boss 敌人访问 IAiContext.Boss 显式抛 InvalidOperationException，
不返回空对象掩盖小怪图误挂 Boss 边的错误。BossResource 补 IsFull 供图条件边判定。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Assets/Tests/EditMode/AI/Fakes/FakeAiContext.cs

@@ -51,10 +51,12 @@ namespace BaseGames.Tests.EditMode.AI
         public FakeCombat C = new FakeCombat();
         public FakeVitals V = new FakeVitals();
         public Blackboard BB = new Blackboard();
+        public FakeBossControl B = new FakeBossControl();
         public ISensor Sensor => S;
         public IEnemyLocomotion Locomotion => L;
         public ICombatant Combat => C;
         public IActorVitals Vitals => V;
         public Blackboard Blackboard => BB;
+        public IBossControl Boss => B;
     }
 }

Assets/Tests/EditMode/AI/Fakes/FakeBossControl.cs

@@ -0,0 +1,35 @@
+using BaseGames.AI;
+
+namespace BaseGames.Tests.EditMode.AI
+{
+    public sealed class FakeBossControl : IBossControl
+    {
+        public int   Phase;
+        public bool  Transitioning;
+        public bool  Full;
+
+        // 记录最近一次过渡请求，供断言"图确实发起了过渡"
+        public int   LastTargetPhase = -1;
+        public float LastDuration    = -1f;
+        public int   BeginCallCount;
+
+        // 锚点：测试按下标直给坐标；距离由测试直接设定
+        public UnityEngine.Vector2[] Anchors = new UnityEngine.Vector2[0];
+        public float DistanceToAnchorValue;
+
+        public int  CurrentPhase         => Phase;
+        public bool IsPhaseTransitioning => Transitioning;
+        public bool ResourceFull         => Full;
+
+        public void BeginPhaseTransition(int targetPhase, float invincibleDuration)
+        {
+            LastTargetPhase = targetPhase;
+            LastDuration    = invincibleDuration;
+            BeginCallCount++;
+            Transitioning   = true;   // 由测试手工置回 false 模拟过渡结束
+        }
+
+        public UnityEngine.Vector2 AnchorAt(int index) => Anchors[index];
+        public float DistanceToAnchor(int index)       => DistanceToAnchorValue;
+    }
+}

Assets/Tests/EditMode/AI/Fakes/FakeBossControl.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: dc93ec3a62b58c24da5b420bdeeed029
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/Tests/EditMode/AI/PerceptionRecipeSoTests.cs

@@ -14,11 +14,13 @@ namespace BaseGames.Tests.EditMode.AI
             public FakeCombat C = new FakeCombat();
             public FakeVitals V = new FakeVitals();
             public Blackboard BB = new Blackboard();
+            public FakeBossControl B = new FakeBossControl();
             public ISensor Sensor => S;
             public IEnemyLocomotion Locomotion => L;
             public ICombatant Combat => C;
             public IActorVitals Vitals => V;
             public Blackboard Blackboard => BB;
+            public IBossControl Boss => B;
             public bool HasAlertState => true;
         }
 

Assets/Tests/EditMode/AI/PerceptionSkeletonTests.cs

@@ -14,6 +14,7 @@ namespace BaseGames.Tests.EditMode.AI
             public FakeCombat C = new FakeCombat();
             public FakeVitals V = new FakeVitals();
             public Blackboard BB = new Blackboard();
+            public FakeBossControl B = new FakeBossControl();
             public bool HasAlert = true;
 
             public ISensor Sensor => S;
@@ -21,6 +22,7 @@ namespace BaseGames.Tests.EditMode.AI
             public ICombatant Combat => C;
             public IActorVitals Vitals => V;
             public Blackboard Blackboard => BB;
+            public IBossControl Boss => B;
             public bool HasAlertState => HasAlert;
         }
 

Assets/Tests/EditMode/Enemies/EnemyBrainContextBossFacetTests.cs

@@ -0,0 +1,46 @@
+using System;
+using NUnit.Framework;
+using UnityEngine;
+using UnityEngine.TestTools;
+using BaseGames.Enemies;
+
+namespace BaseGames.Tests.EditMode.Enemies
+{
+    public class EnemyBrainContextBossFacetTests
+    {
+        // EnemyBase.Awake 会对缺失的碰撞体/引用报错，这些与本测试无关。
+        [SetUp]    public void SetUp()    => LogAssert.ignoreFailingMessages = true;
+        [TearDown] public void TearDown() => LogAssert.ignoreFailingMessages = false;
+
+        static T MakeEnemy<T>(string name) where T : EnemyBase
+        {
+            var go = new GameObject(name);
+            return go.AddComponent<T>();
+        }
+
+        [Test]
+        public void NonBoss_AccessingBossFacet_Throws()
+        {
+            var enemy = MakeEnemy<EnemyBase>("plain-enemy");
+            var ctx   = new EnemyBrainContext(enemy);
+
+            Assert.Throws<InvalidOperationException>(() => { var _ = ctx.Boss; });
+
+            UnityEngine.Object.DestroyImmediate(enemy.gameObject);
+        }
+
+        [Test]
+        public void Boss_AccessingBossFacet_ReturnsTheBoss()
+        {
+            var boss = MakeEnemy<BossBase>("boss");
+            var ctx  = new EnemyBrainContext(boss);
+
+            Assert.AreSame(boss, ctx.Boss);
+            Assert.AreEqual(0, ctx.Boss.CurrentPhase);
+            Assert.IsFalse(ctx.Boss.IsPhaseTransitioning);
+            Assert.IsFalse(ctx.Boss.ResourceFull);   // 未挂 BossResource
+
+            UnityEngine.Object.DestroyImmediate(boss.gameObject);
+        }
+    }
+}

Assets/Tests/EditMode/Enemies/EnemyBrainContextBossFacetTests.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 90d0535e362d3b9469d2c91a70c4c8ca
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: