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,141 @@
+using System;
+using System.Reflection;
+using Cysharp.Threading.Tasks;
+#pragma warning disable CS8632 // 只能在 "#nullable" 注释上下文内的代码中使用可为 null 的引用类型的注释。
+
+
+namespace ShrinkEventBus
+{
+    public interface IMethodWrapper
+    {
+        MethodInfo OriginalMethod { get; }
+    }
+
+    public class EventHandlerInfo
+    {
+        public long SubscriptionId { get; }
+        public Delegate Handler { get; }
+        internal Action<EventBase>? SyncInvoker { get; }
+        internal Func<EventBase, UniTask>? AsyncInvoker { get; }
+        public EventPriority Priority { get; }
+        public int NumericPriority { get; }
+        public bool ReceiveCanceled { get; }
+        public object? Target { get; }
+        public MethodInfo Method { get; }
+        public string DebugInfo { get; }
+        public Type DeclaringType { get; }
+        public string MethodName { get; }
+        public MethodInfo? OriginalMethod { get; }
+        public string OriginalMethodName { get; }
+        public Type? OriginalDeclaringType { get; }
+        public DateTime RegisteredAtUtc { get; }
+
+        private EventHandlerInfo(long subscriptionId, Delegate handler, Action<EventBase>? syncInvoker,
+            Func<EventBase, UniTask>? asyncInvoker,
+            EventPriority priority, int numericPriority, bool receiveCanceled, string debugInfo = "",
+            MethodInfo? originalMethod = null)
+        {
+            SubscriptionId = subscriptionId;
+            Handler = handler;
+            SyncInvoker = syncInvoker;
+            AsyncInvoker = asyncInvoker;
+            Priority = priority;
+            NumericPriority = numericPriority;
+            ReceiveCanceled = receiveCanceled;
+            Target = handler.Target;
+            Method = handler.Method;
+            DebugInfo = debugInfo;
+            DeclaringType = Method.DeclaringType ?? typeof(object);
+            MethodName = Method.Name;
+
+            OriginalMethod = ExtractOriginalMethodFromWrapper(handler) ?? originalMethod;
+
+            if (OriginalMethod != null)
+            {
+                OriginalMethodName = OriginalMethod.Name;
+                OriginalDeclaringType = OriginalMethod.DeclaringType;
+            }
+            else
+            {
+                OriginalMethodName = MethodName;
+                OriginalDeclaringType = DeclaringType;
+            }
+
+            RegisteredAtUtc = DateTime.UtcNow;
+        }
+
+        private static MethodInfo? ExtractOriginalMethodFromWrapper(Delegate handler)
+        {
+            if (handler.Target is IMethodWrapper wrapper)
+            {
+                return wrapper.OriginalMethod;
+            }
+
+            return null;
+        }
+
+        public string DisplayMethodName => OriginalMethodName;
+        public Type DisplayDeclaringType => OriginalDeclaringType ?? DeclaringType;
+
+        public bool MatchesMethod(MethodInfo method)
+        {
+            return method != null && (ReferenceEquals(Method, method) || ReferenceEquals(OriginalMethod, method));
+        }
+
+        public bool MatchesDeclaringType(Type declaringType)
+        {
+            return declaringType != null &&
+                   (DeclaringType == declaringType || OriginalDeclaringType == declaringType);
+        }
+
+        public static EventHandlerInfo Create(long subscriptionId, Delegate handler, Type eventType,
+            EventPriority priority, int numericPriority, bool receiveCanceled, string debugInfo = "",
+            MethodInfo? originalMethod = null)
+        {
+            if (handler == null)
+                throw new System.ArgumentNullException(nameof(handler));
+            if (eventType == null)
+                throw new System.ArgumentNullException(nameof(eventType));
+
+            Action<EventBase>? syncInvoker = null;
+            Func<EventBase, UniTask>? asyncInvoker = null;
+            if (handler.Method.ReturnType == typeof(void))
+                syncInvoker = CreateSyncInvoker(eventType, handler);
+            else if (handler.Method.ReturnType == typeof(UniTask))
+                asyncInvoker = CreateAsyncInvoker(eventType, handler);
+            else
+                throw new System.ArgumentException(
+                    $"Unsupported event handler return type {handler.Method.ReturnType.FullName} for {handler.Method}.");
+
+            return new EventHandlerInfo(subscriptionId, handler, syncInvoker, asyncInvoker, priority, numericPriority,
+                receiveCanceled, debugInfo, originalMethod);
+        }
+
+        private static Action<EventBase> CreateSyncInvoker(Type eventType, Delegate handler)
+        {
+            var factory = typeof(EventHandlerInfo).GetMethod(nameof(CreateSyncInvokerGeneric),
+                BindingFlags.NonPublic | BindingFlags.Static)!.MakeGenericMethod(eventType);
+            return (Action<EventBase>)factory.Invoke(null, new object[] { handler })!;
+        }
+
+        private static Func<EventBase, UniTask> CreateAsyncInvoker(Type eventType, Delegate handler)
+        {
+            var factory = typeof(EventHandlerInfo).GetMethod(nameof(CreateAsyncInvokerGeneric),
+                BindingFlags.NonPublic | BindingFlags.Static)!.MakeGenericMethod(eventType);
+            return (Func<EventBase, UniTask>)factory.Invoke(null, new object[] { handler })!;
+        }
+
+        private static Action<EventBase> CreateSyncInvokerGeneric<TEvent>(Delegate handler) where TEvent : EventBase
+        {
+            var typedHandler = (Action<TEvent>)handler;
+            return eventArgs => typedHandler((TEvent)eventArgs);
+        }
+
+        private static Func<EventBase, UniTask> CreateAsyncInvokerGeneric<TEvent>(Delegate handler)
+            where TEvent : EventBase
+        {
+            var typedHandler = (Func<TEvent, UniTask>)handler;
+            return eventArgs => typedHandler((TEvent)eventArgs);
+        }
+    }
+}