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

2026-07-03 14:13:36 +08:00
parent 0253fd15ca
commit cdd1053bec
8 changed files with 302 additions and 3 deletions
@@ -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();
+        }
+    }
+}