feat(packages): 内置 SDK 包并完善 ContextLoader 集成

- 将 ShrinkEventBus、ShrinkDataSaver 及其 EventBus 集成从 gitlink 转为仓库直接维护的完整 UPM 包，补齐运行时、编辑器工具、测试与文档 - 新增 Command 和 Network 的 App 集成组件，支持 ContextLoader 服务发布、可逆注销及 Network Loopback 生命周期管理 - 更新 Starter 与演示组合逻辑，缺失模块时可注册、已有兼容安装器时可覆盖，并补充宿主启动断言 - 升级内部包依赖与 Shared CodeGen 包定义，放宽 Integration.App 包的 Git 忽略规则 - 将独立服务器生成器改为基于已编译程序集的语义扫描，支持 partial、复杂泛型、命名冲突检测及模板 SHA-256 覆写保护 - 新增 Network 语义扫描、模板保护和 App 组件生命周期测试 - 新增真实 UPM 消费工程验证脚本，校验内部版本一致性、程序集加载及 EditMode 测试 - 重构当前架构文档并归档已完成的 Cordis 迁移与旧代码地图
2026-08-18 18:06:34 +08:00
parent 517c4cf46e
commit d74c2f08ca
240 changed files with 13647 additions and 545 deletions
@@ -0,0 +1,120 @@
+using System.Collections.Generic;
+using NUnit.Framework;
+
+namespace ShrinkEventBus.Tests
+{
+    [TestFixture]
+    public sealed class EventBusPriorityTests
+    {
+        private class BaseEvent : EventBase
+        {
+        }
+
+        private sealed class DerivedEvent : BaseEvent
+        {
+        }
+
+        [Test]
+        public void EnumPriority_ExecutesPhasesInOrder()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("LOW"), EventPriority.LOW);
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("MONITOR"), EventPriority.MONITOR);
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("HIGHEST"), EventPriority.HIGHEST);
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("NORMAL"), EventPriority.NORMAL);
+
+            bus.TriggerEvent(new BaseEvent());
+
+            CollectionAssert.AreEqual(new[] { "HIGHEST", "NORMAL", "LOW", "MONITOR" }, order);
+        }
+
+        [Test]
+        public void NumericPriority_HigherNumberRunsFirstWithinPhase()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            // 5 与 10 都映射到 NORMAL 档
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("p5"), 5);
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("p10"), 10);
+
+            bus.TriggerEvent(new BaseEvent());
+
+            CollectionAssert.AreEqual(new[] { "p10", "p5" }, order);
+        }
+
+        [Test]
+        public void NumericPriority_TieKeepsRegistrationOrder()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("first"), 0);
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("second"), 0);
+
+            bus.TriggerEvent(new BaseEvent());
+
+            CollectionAssert.AreEqual(new[] { "first", "second" }, order);
+        }
+
+        [Test]
+        public void NumericPriorityZero_MapsToNormalPhase()
+        {
+            var bus = EventBus.CreateBus();
+            bus.RegisterEvent<BaseEvent>(_ => { }, 0);
+
+            var subscribers = bus.GetEventSubscribers<BaseEvent>();
+
+            Assert.AreEqual(1, subscribers.Length);
+            Assert.AreEqual(EventPriority.NORMAL, subscribers[0].Priority);
+        }
+
+        [Test]
+        public void RegisterEvent_WithoutPriority_ResolvesToNormal()
+        {
+            var bus = EventBus.CreateBus();
+
+            void Handler(BaseEvent evt)
+            {
+            }
+
+            // 不带优先级的调用应唯一解析到枚举重载（NORMAL），不再有重载二义性
+            bus.RegisterEvent<BaseEvent>(Handler);
+
+            var subscribers = bus.GetEventSubscribers<BaseEvent>();
+            Assert.AreEqual(1, subscribers.Length);
+            Assert.AreEqual(EventPriority.NORMAL, subscribers[0].Priority);
+        }
+
+        [Test]
+        public void ParentAndChildHandlers_MergeByNumericPriorityWithinPhase()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("parent10"), 10);
+            bus.RegisterEvent<DerivedEvent>(_ => order.Add("child5"), 5);
+            bus.RegisterEvent<DerivedEvent>(_ => order.Add("child1"), 1);
+
+            bus.TriggerEvent(new DerivedEvent());
+
+            CollectionAssert.AreEqual(new[] { "parent10", "child5", "child1" }, order);
+        }
+
+        [Test]
+        public void ParentAndChildHandlers_TiePrefersChild()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            bus.RegisterEvent<BaseEvent>(_ => order.Add("parent0"), 0);
+            bus.RegisterEvent<DerivedEvent>(_ => order.Add("child0"), 0);
+
+            bus.TriggerEvent(new DerivedEvent());
+
+            CollectionAssert.AreEqual(new[] { "child0", "parent0" }, order);
+        }
+    }
+}