feat(ai): Build() 校验「非终态必须有出口」，堵住零报错的永久卡死

BrainBuilder.Build() 此前只做正向校验——边指向的态是否已声明（RequireState
的同款关切）；反向从不检查。一个已声明却没有任何出边的非终态，会让敌人进去
就永久停在那里，且全程零报错。计划里点名的风险点是 BossFragments.PhaseTransition：
它按设计不自带出边，出口全靠调用方补挂，漏一条就把 Boss 锁死。

做法：AiState 加 IsTerminal，StateBuilder 加 .Terminal() 显式标记，
AiStateFragments.Terminal() 自带该标记；Build() 对「非终态且无出口」抛异常。

「有出口」的判定比计划原话严一档，两点都是照 AiRuntime 的实际行为定的：
- 自转换不算——Switch 对 Target == 当前态直接 return false，根本出不去；
- 全局转换不算——全局事件边要外部推信号才触发，不是自主出口。把它算作出口，
  等于让「只有死了才出得去」的死角通过校验，而那恰是本校验要暴露的东西。

校验放在 Build() 而非各生产入口：生产的完整图装配点是 AiScript.GetOrBuildGraph
与 AiRecipeSO 两处，放 Build() 能让将来新增的入口默认受保护。代价是模块单测
需要一条别的路——单个 IUnawareModule / IEngagementModule 按设计只声明自己的态，
升级边由 PerceptionSkeleton 事后挂，单独构建时的死角是正常中间态而非缺陷。
为此加 BuildPartial()：跳过本项校验，其余照旧。

测试侧按语义分两类处理，没有一刀切：
- 概念上确实是终态的（Dead）标 .Terminal()，保留 Build() 的全量校验；
- 隔离验证单个模块/片段的部分图改用 BuildPartial()；
- AiScriptTests / AiDefinitionRegistryTests 的夹具经 GetOrBuildGraph 走生产
  Build()，给桩汇态补了回边——这两条本就该验完整图。
- 断言 Build() 因别的原因抛异常的用例原样保留。
PerceptionSkeleton 与嘲风图建的都是完整图，无需改动即通过——这本身就是覆盖。

验证：编译 0 错；EditMode 269/269（264 + 新增 5）。
加校验后曾有 49 条既有测试变红，全部为上述两类夹具，逐条按语义修正后转绿。

变异验证：注释掉 ChaoFengAi 里 PhaseTx 的 txDone 出边后，ChaoFengAiTests
8 条全部变红，报错精确点名 'PhaseTransition'；还原后复验 269/269。
本改动之前，同样的删除是零报错的——Boss 会静默锁死在过渡态，
这正是本校验存在的理由。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Assets/_Game/Scripts/AI/AiState.cs

@@ -14,6 +14,12 @@ namespace BaseGames.AI
         public Action<IAiContext> OnExit { get; internal set; }
         public IReadOnlyList<Transition> Transitions => _transitions;
 
+        /// <summary>
+        /// 是否为终态：进入后不再离开是设计意图，而非漏挂出边。
+        /// 由 <see cref="BrainBuilder.StateBuilder.Terminal"/> 标记，供 Build() 的死角校验放行。
+        /// </summary>
+        public bool IsTerminal { get; internal set; }
+
         internal void AddTransition(Transition t) => _transitions.Add(t);
 
         public AiState(string name) => Name = name;

Assets/_Game/Scripts/AI/BrainBuilder.cs

@@ -59,7 +59,22 @@ namespace BaseGames.AI
 
         internal void AddGlobal(Transition t) => _globals.Add(t);
 
-        public AiGraph Build()
+        /// <summary>
+        /// 构建**完整**图。除了引用完整性，还校验「非终态必须有出口」。
+        /// 生产的两个装配点（AiScript.GetOrBuildGraph / AiRecipeSO）都走这里，
+        /// 将来新增的入口默认即受保护——这正是校验放在 Build() 而非各入口的理由。
+        /// </summary>
+        public AiGraph Build() => BuildInternal(checkDeadEnds: true);
+
+        /// <summary>
+        /// 构建**部分**图：跳过「非终态必须有出口」校验，其余校验照旧。
+        /// 单个模块（IUnawareModule / IEngagementModule）按设计只声明自己的态，
+        /// 升级边由 PerceptionSkeleton 事后挂上——单独构建时的死角是正常中间态，不是缺陷。
+        /// 仅用于隔离验证单个模块或片段；装配真实敌人图一律用 <see cref="Build"/>。
+        /// </summary>
+        public AiGraph BuildPartial() => BuildInternal(checkDeadEnds: false);
+
+        AiGraph BuildInternal(bool checkDeadEnds)
         {
             if (string.IsNullOrEmpty(_entry))
                 throw new InvalidOperationException("BrainBuilder: 未设置 Entry 状态。");
@@ -76,9 +91,35 @@ namespace BaseGames.AI
                     throw new InvalidOperationException(
                         $"BrainBuilder: 全局转换指向未声明状态 '{t.Target}'。");
 
+            if (checkDeadEnds)
+            {
+                foreach (var s in _states.Values)
+                    if (!s.IsTerminal && !HasEscape(s))
+                        throw new InvalidOperationException(
+                            $"BrainBuilder: 状态 '{s.Name}' 不是终态，却没有任何指向其他状态的出边。" +
+                            "进入后会永久停在这里，且全程零报错。请给它挂出边；" +
+                            "若「进去就不出来」本就是设计意图（如死亡态），" +
+                            "请用 AiStateFragments.Terminal() 声明，或对已有 builder 调 .Terminal() 标记；" +
+                            "若这是隔离测试单个模块的部分图，请改用 BuildPartial()。");
+            }
+
             return new AiGraph(_entry, _states, _globals);
         }
 
+        /// <summary>
+        /// 该状态是否有真正的出口。两点刻意的判定：
+        /// 1. 自转换不算——AiRuntime.Switch 对 Target == 当前态直接 return false，出不去；
+        /// 2. 全局转换不算——全局事件边要外部推信号才触发，不是自主出口。把它算作出口，
+        ///    等于让「只有死了才出得去」的死角通过校验，而那正是本校验要暴露的东西。
+        /// </summary>
+        static bool HasEscape(AiState s)
+        {
+            var ts = s.Transitions;
+            for (int i = 0; i < ts.Count; i++)
+                if (ts[i].Target != s.Name) return true;
+            return false;
+        }
+
         public sealed class StateBuilder
         {
             readonly AiState _state;
@@ -89,6 +130,13 @@ namespace BaseGames.AI
             public StateBuilder Tick(Action<IAiContext, float> fn) { _state.OnTick = fn; return this; }
             public StateBuilder OnExit(Action<IAiContext> fn) { _state.OnExit = fn; return this; }
 
+            /// <summary>
+            /// 标记为终态：声明"进入后不再离开"是设计意图。
+            /// Build() 会对非终态且无出口的态抛异常，本标记是唯一的豁免方式——
+            /// 用它而不是随手挂一条永假的边，意图才留在代码里。
+            /// </summary>
+            public StateBuilder Terminal() { _state.IsTerminal = true; return this; }
+
             public TransitionBuilder To(string target) => new TransitionBuilder(this, _state, target);
         }
 

Assets/_Game/Scripts/Enemies/AIBrain/Modules/AiStateFragments.cs

@@ -46,9 +46,10 @@ namespace BaseGames.Enemies
         /// <summary>
         /// 无行为的终态。不需要在这里停移动——转入本态时，上一个态的 OnExit 已经收尾。
         /// 用于"死亡演出交给物理状态机（EnemyBase.PerformDeath）"的敌人。
+        /// 自带终态标记，因此能通过 Build() 的"非终态必须有出口"校验。
         /// </summary>
         public static BrainBuilder.StateBuilder Terminal(BrainBuilder b, string state)
-            => b.DeclareState(state);
+            => b.DeclareState(state).Terminal();
 
         static void ApplyLocomotion(IAiContext x, LocomotionMode mode)
         {