feat(enemy): 未发现层/交战层/死亡层三个模块契约

2026-07-29 11:47:29 +08:00
parent 2643f58b08
commit 17e71dac39
6 changed files with 110 additions and 0 deletions
@@ -0,0 +1,30 @@
+using System.Collections.Generic;
+using BaseGames.AI;
+
+namespace BaseGames.Enemies
+{
+    /// <summary>
+    /// 未发现层：玩家尚未被发现时的行为形状（单一站桩 / 单向降级 / 定时交替 …）。
+    ///
+    /// 刻意拆成两阶段：AiRuntime 按声明顺序评估条件边，若本模块的内部边（如巡逻计时）
+    /// 早于骨架的升级边声明，玩家进入追逐区那一帧若恰好计时到点，敌人会切去另一个待机态
+    /// 而不是扑上来。骨架的调用顺序固定为 Declare → 挂升级边 → Link。
+    /// </summary>
+    public interface IUnawareModule
+    {
+        /// <summary>只声明状态与行为回调，不挂任何转换。</summary>
+        void Declare(BrainBuilder b);
+
+        /// <summary>挂内部转换（如站立 ⇄ 巡逻的计时边）。没有内部边的模块留空实现。</summary>
+        void Link(BrainBuilder b);
+
+        /// <summary>图入口（出生态）。</summary>
+        string Entry { get; }
+
+        /// <summary>脱战 / 警觉丢失后回到的态。必须属于 States。</summary>
+        string Rest { get; }
+
+        /// <summary>需要挂升级边的所有未发现态。</summary>
+        IReadOnlyList<string> States { get; }
+    }
+}