M1 回合制战斗架构收敛与 1v1 攻击闭环：BattleRuntime 内核、组件唯一入口、UI 数据驱动与 EditMode 测试

- 删除中间契约（BattleStartRequest/BattlePlayerInput/BattleReturnPlan/桥接与策略接口/FlowState），收敛为 BattleViewState/BattleStep/一层 BattleEvent - 新增内部 BattleRuntime/BattleUnit/BattleStatus 共享上下文；TurnBattleComponent 成为唯一外部入口，吸收启动/暂停/回写职责 - 内核支持 1v1 攻击闭环：效果公式、HP/MP 钳制、阵亡、Victory/TotalDefeat、敌人随机决策；敌人行动间歇 0.6s 由组件协程编排并经 StepListener 推送 - UI：玩家卡片/敌人槽/回合槽按战局重建，图标配置驱动（含新增 EnemyConfig.Icon），每轮刷新一次 TurnSlots 且轮内只移动高亮 - 新增 Tests 程序集 + InternalsVisibleTo，25 个 BattleRuntime 纯逻辑用例全部通过
2026-09-02 08:42:04 +08:00
parent 8413c2688b
commit 7dcac0ac87
65 changed files with 3067 additions and 1225 deletions
@@ -0,0 +1,188 @@
+using System.Collections.Generic;
+using SepCore.Definition;
+
+namespace SepCore.Battle
+{
+    /// <summary>
+    /// 单个战斗状态的只读视图。
+    /// </summary>
+    public sealed class BattleStatusView
+    {
+        /// <summary>
+        /// 状态类型。
+        /// </summary>
+        public readonly BattleStatusType StatusType;
+
+        /// <summary>
+        /// 剩余持续次数（行动机会）；重复施加取较大值，移除后为 0。
+        /// </summary>
+        public readonly int RemainingRounds;
+
+        public BattleStatusView(BattleStatusType statusType, int remainingRounds)
+        {
+            StatusType = statusType;
+            RemainingRounds = remainingRounds;
+        }
+    }
+
+    /// <summary>
+    /// 单个战斗单位的只读视图。
+    /// 内部调度与效果结算不得读取本视图；视图只在外部边界按需生成。
+    /// </summary>
+    public sealed class BattleUnitView
+    {
+        /// <summary>
+        /// 本场战斗单位的唯一运行时标识；重复配置的敌人拥有不同 ID。
+        /// </summary>
+        public readonly int BattleUnitId;
+
+        /// <summary>
+        /// 阵营。
+        /// </summary>
+        public readonly BattleFaction Faction;
+
+        /// <summary>
+        /// 配置标识：玩家为 CharacterId，敌人为 EnemyConfigId。
+        /// </summary>
+        public readonly int ConfigId;
+
+        /// <summary>
+        /// 同阵营同速度的最终并列规则顺序，也是显示顺序。
+        /// </summary>
+        public readonly int PartyOrder;
+
+        /// <summary>
+        /// 当前 HP。
+        /// </summary>
+        public readonly int CurrentHp;
+
+        /// <summary>
+        /// HP 上限。
+        /// </summary>
+        public readonly int MaxHp;
+
+        /// <summary>
+        /// 当前 MP。
+        /// </summary>
+        public readonly int CurrentMp;
+
+        /// <summary>
+        /// MP 上限。
+        /// </summary>
+        public readonly int MaxMp;
+
+        /// <summary>
+        /// 当前速度。
+        /// </summary>
+        public readonly int Speed;
+
+        /// <summary>
+        /// 是否阵亡。
+        /// </summary>
+        public readonly bool IsDefeated;
+
+        /// <summary>
+        /// 是否已逃跑。
+        /// </summary>
+        public readonly bool IsEscaped;
+
+        /// <summary>
+        /// 当前剩余状态列表。
+        /// </summary>
+        public readonly IReadOnlyList<BattleStatusView> Statuses;
+
+        public BattleUnitView(int battleUnitId, BattleFaction faction, int configId, int partyOrder,
+            int currentHp, int maxHp, int currentMp, int maxMp, int speed,
+            bool isDefeated, bool isEscaped, IReadOnlyList<BattleStatusView> statuses)
+        {
+            BattleUnitId = battleUnitId;
+            Faction = faction;
+            ConfigId = configId;
+            PartyOrder = partyOrder;
+            CurrentHp = currentHp;
+            MaxHp = maxHp;
+            CurrentMp = currentMp;
+            MaxMp = maxMp;
+            Speed = speed;
+            IsDefeated = isDefeated;
+            IsEscaped = isEscaped;
+            Statuses = statuses != null ? Copy(statuses) : new BattleStatusView[0];
+        }
+
+        private static BattleStatusView[] Copy(IReadOnlyList<BattleStatusView> source)
+        {
+            BattleStatusView[] copy = new BattleStatusView[source.Count];
+            for (int i = 0; i < source.Count; i++)
+            {
+                copy[i] = source[i];
+            }
+
+            return copy;
+        }
+    }
+
+    /// <summary>
+    /// 当前战斗的只读视图，是 UI 唯一允许读取的战斗状态。
+    /// 每次推进后在外部边界生成，不把内部可变对象暴露给 UI 或探索层。
+    /// </summary>
+    public sealed class BattleViewState
+    {
+        /// <summary>
+        /// 当前轮次，从 1 开始。
+        /// </summary>
+        public readonly int RoundNumber;
+
+        /// <summary>
+        /// 当前行动者；战斗完成时为 0。
+        /// </summary>
+        public readonly int CurrentActorUnitId;
+
+        /// <summary>
+        /// 全部单位的只读视图，保持稳定显示顺序。
+        /// </summary>
+        public readonly IReadOnlyList<BattleUnitView> Units;
+
+        /// <summary>
+        /// 本轮从当前行动者开始的剩余运行时单位 ID；速度变化后重建。
+        /// </summary>
+        public readonly IReadOnlyList<int> RemainingTurnOrder;
+
+        /// <summary>
+        /// 当前玩家可用的行动配置 ID；当前行动者不是玩家或战斗完成时为空。
+        /// </summary>
+        public readonly IReadOnlyList<int> AvailableActionIds;
+
+        public BattleViewState(int roundNumber, int currentActorUnitId,
+            IReadOnlyList<BattleUnitView> units, IReadOnlyList<int> remainingTurnOrder,
+            IReadOnlyList<int> availableActionIds)
+        {
+            RoundNumber = roundNumber;
+            CurrentActorUnitId = currentActorUnitId;
+            Units = units != null ? Copy(units) : new BattleUnitView[0];
+            RemainingTurnOrder = remainingTurnOrder != null ? Copy(remainingTurnOrder) : new int[0];
+            AvailableActionIds = availableActionIds != null ? Copy(availableActionIds) : new int[0];
+        }
+
+        private static BattleUnitView[] Copy(IReadOnlyList<BattleUnitView> source)
+        {
+            BattleUnitView[] copy = new BattleUnitView[source.Count];
+            for (int i = 0; i < source.Count; i++)
+            {
+                copy[i] = source[i];
+            }
+
+            return copy;
+        }
+
+        private static int[] Copy(IReadOnlyList<int> source)
+        {
+            int[] copy = new int[source.Count];
+            for (int i = 0; i < source.Count; i++)
+            {
+                copy[i] = source[i];
+            }
+
+            return copy;
+        }
+    }
+}