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,109 @@
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+using Cysharp.Threading.Tasks;
+
+namespace ShrinkEventBus
+{
+    public interface IShrinkEventSubscription : IDisposable
+    {
+        long SubscriptionId { get; }
+        bool IsDisposed { get; }
+    }
+
+    public readonly struct ShrinkEventSubscriptionSnapshot
+    {
+        public ShrinkEventSubscriptionSnapshot(long subscriptionId, Type eventType, EventPriority priority,
+            int numericPriority, bool receiveCanceled, object target, string targetTypeName, string methodName,
+            string debugInfo, DateTime registeredAtUtc)
+        {
+            SubscriptionId = subscriptionId;
+            EventType = eventType ?? throw new ArgumentNullException(nameof(eventType));
+            Priority = priority;
+            NumericPriority = numericPriority;
+            ReceiveCanceled = receiveCanceled;
+            Target = target;
+            TargetTypeName = targetTypeName ?? string.Empty;
+            MethodName = methodName ?? string.Empty;
+            DebugInfo = debugInfo ?? string.Empty;
+            RegisteredAtUtc = registeredAtUtc;
+        }
+
+        public long SubscriptionId { get; }
+        public Type EventType { get; }
+        public EventPriority Priority { get; }
+        public int NumericPriority { get; }
+        public bool ReceiveCanceled { get; }
+        public object Target { get; }
+        public string TargetTypeName { get; }
+        public string MethodName { get; }
+        public string DebugInfo { get; }
+        public DateTime RegisteredAtUtc { get; }
+        public bool IsStaticHandler => Target == null;
+    }
+
+    public interface IShrinkEventBus
+    {
+        event Action<EventBase, Type> OnEventTriggered;
+
+#if UNITY_EDITOR
+        event Action<EventBase, string, string, EventHandlerInfo[]> OnEventTriggeredForEditor;
+        bool EnableDebugRecord { get; set; }
+#endif
+
+        bool IsStarted { get; }
+
+        void Start();
+        void AutoRegister(object target);
+        void Register(object target);
+        void Unregister(object target);
+
+        void RegisterEvent<TEvent>(Action<TEvent> handler, EventPriority priority = EventPriority.NORMAL,
+            bool receiveCanceled = false) where TEvent : EventBase;
+        void RegisterEvent<TEvent>(Action<TEvent> handler, int priority) where TEvent : EventBase;
+        void RegisterEvent<TEvent>(Func<TEvent, UniTask> handler, EventPriority priority = EventPriority.NORMAL,
+            bool receiveCanceled = false) where TEvent : EventBase;
+        void RegisterEvent<TEvent>(Func<TEvent, UniTask> handler, int priority) where TEvent : EventBase;
+        IShrinkEventSubscription SubscribeEvent<TEvent>(Action<TEvent> handler,
+            EventPriority priority = EventPriority.NORMAL, bool receiveCanceled = false) where TEvent : EventBase;
+        IShrinkEventSubscription SubscribeEvent<TEvent>(Action<TEvent> handler, int priority)
+            where TEvent : EventBase;
+        IShrinkEventSubscription SubscribeEvent<TEvent>(Func<TEvent, UniTask> handler,
+            EventPriority priority = EventPriority.NORMAL, bool receiveCanceled = false) where TEvent : EventBase;
+        IShrinkEventSubscription SubscribeEvent<TEvent>(Func<TEvent, UniTask> handler, int priority)
+            where TEvent : EventBase;
+
+        void UnregisterEvent<TEvent>(Action<TEvent> handler) where TEvent : EventBase;
+        void UnregisterEvent<TEvent>(Func<TEvent, UniTask> handler) where TEvent : EventBase;
+        void ClearAllSubscribersForEvent<TEvent>() where TEvent : EventBase;
+        void UnregisterAllEventsForObject(object targetObject);
+        void UnregisterAllEvents();
+
+        bool TriggerEvent<TEvent>(TEvent eventArgs) where TEvent : EventBase;
+        bool TriggerEvent<TEvent>(EventPriority phase, TEvent eventArgs) where TEvent : EventBase;
+        UniTask<bool> TriggerEventAsync<TEvent>(TEvent eventArgs) where TEvent : EventBase;
+        UniTask<bool> TriggerEventAsync<TEvent>(EventPriority phase, TEvent eventArgs) where TEvent : EventBase;
+
+        EventHandlerInfo[] GetEventSubscribers<TEvent>() where TEvent : EventBase;
+        ListenerList GetListenerList<TEvent>() where TEvent : EventBase;
+        IReadOnlyDictionary<Type, EventHandlerInfo[]> GetAllSubscribersSnapshot();
+        IReadOnlyList<ShrinkEventSubscriptionSnapshot> GetActiveSubscriptionsSnapshot();
+
+        bool IsInstanceRegistered(object target);
+        int GetRegisteredInstanceCount();
+        int GetRegisteredEventTypeCount();
+    }
+
+    public interface IShrinkEventExceptionHandler
+    {
+        void HandleException(IShrinkEventBus bus, EventBase eventArgs, EventHandlerInfo[] listeners, int index,
+            Exception exception);
+    }
+
+    public enum ShrinkEventExceptionHandlingMode
+    {
+        LogAndContinue,
+        Throw,
+        LogAndThrow
+    }
+}