feat(ai): AiRuntime 条件转换+IsControllable让位门+状态计时+trace+Reset

Assets/_Game/Scripts/AI/AiRuntime.cs

@@ -0,0 +1,107 @@
+using System.Collections.Generic;
+
+namespace BaseGames.AI
+{
+    /// <summary>
+    /// 每敌人实例一份的轻量执行器。持有当前状态、状态计时器、trace。
+    /// 共享的 AiGraph 不持有任何实例态。
+    /// </summary>
+    public sealed class AiRuntime
+    {
+        readonly AiGraph _graph;
+        readonly IAiContext _ctx;
+        AiState _current;
+        float _timeInState;
+
+        readonly Queue<AiSignal> _pending = new Queue<AiSignal>();
+        readonly List<TransitionRecord> _trace = new List<TransitionRecord>();
+        const int TraceCap = 16;
+
+        public AiRuntime(AiGraph graph, IAiContext ctx)
+        {
+            _graph = graph;
+            _ctx = ctx;
+            EnterInitial();
+        }
+
+        public string CurrentStateName => _current.Name;
+        public bool IsSuspended { get; private set; }
+        public IReadOnlyList<TransitionRecord> Trace => _trace;
+        public float TimeInStateValue => _timeInState;
+
+        void EnterInitial()
+        {
+            _current = _graph.GetState(_graph.EntryState);
+            _timeInState = 0f;
+            _current.OnEnter?.Invoke(_ctx);
+        }
+
+        /// <summary>供 BrainBuilder.After() 通过 context 读取当前 runtime 的状态计时器。</summary>
+        static readonly System.Runtime.CompilerServices.ConditionalWeakTable<IAiContext, AiRuntime> _byContext
+            = new System.Runtime.CompilerServices.ConditionalWeakTable<IAiContext, AiRuntime>();
+        internal static float TimeInState(IAiContext ctx)
+            => _byContext.TryGetValue(ctx, out var rt) ? rt._timeInState : 0f;
+
+        public void Tick(float dt)
+        {
+            _byContext.Remove(_ctx);
+            _byContext.Add(_ctx, this);
+
+            // IsControllable 让位门：受击/硬直/击飞时挂起，不推进决策也不跑 Tick。
+            if (!_ctx.Vitals.IsControllable)
+            {
+                IsSuspended = true;
+                return;
+            }
+            IsSuspended = false;
+
+            _timeInState += dt;
+
+            if (TryTransition())
+                return; // 本帧发生转换，新状态下一帧再 Tick
+
+            _current.OnTick?.Invoke(_ctx, dt);
+        }
+
+        bool TryTransition()
+        {
+            // 全局/父层转换优先（本任务只评估条件型；事件型在 Task 6 处理）
+            foreach (var t in _graph.GlobalTransitions)
+                if (!t.IsEvent && t.Condition(_ctx))
+                    return Switch(t);
+
+            foreach (var t in _current.Transitions)
+                if (!t.IsEvent && t.Condition(_ctx))
+                    return Switch(t);
+
+            return false;
+        }
+
+        bool Switch(Transition t)
+        {
+            var from = _current.Name;
+            _current.OnExit?.Invoke(_ctx);
+            _current = _graph.GetState(t.Target);
+            _timeInState = 0f;
+            RecordTrace(new TransitionRecord(from, t.Target, t.Label));
+            _current.OnEnter?.Invoke(_ctx);
+            return true;
+        }
+
+        void RecordTrace(TransitionRecord r)
+        {
+            _trace.Add(r);
+            if (_trace.Count > TraceCap) _trace.RemoveAt(0);
+        }
+
+        /// <summary>对象池复用时重置到初始态，清空所有实例态。</summary>
+        public void Reset()
+        {
+            _pending.Clear();
+            _trace.Clear();
+            _ctx.Blackboard.Clear();
+            IsSuspended = false;
+            EnterInitial();
+        }
+    }
+}

Assets/_Game/Scripts/AI/AiRuntime.cs.meta

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

Assets/_Game/Scripts/AI/BrainBuilder.cs

@@ -89,11 +89,12 @@ namespace BaseGames.AI
                 return _stateBuilder;
             }
 
-            /// <summary>在本状态停留 seconds 秒后转换（读 runtime 的状态计时器）。Task 5 回填实现。</summary>
+            /// <summary>在本状态停留 seconds 秒后转换（读 runtime 的状态计时器）。</summary>
             public StateBuilder After(float seconds)
             {
-                // 依赖 AiRuntime.TimeInState（Task 5 定义）。本任务先临时抛异常以通过编译，Task 5 回填正式实现。
-                throw new NotImplementedException("After 将在 Task 5 回填（依赖 AiRuntime 状态计时器）。");
+                _state.AddTransition(Transition.OnCondition(
+                    _target, c => AiRuntime.TimeInState(c) >= seconds, $"after {seconds}s"));
+                return _stateBuilder;
             }
         }