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,76 @@
+#nullable enable
+using System;
+
+namespace ShrinkEventBus
+{
+    public sealed class ShrinkEventBusBuilder
+    {
+        internal IShrinkEventExceptionHandler? ExceptionHandler { get; private set; }
+        internal ShrinkEventExceptionHandlingMode ExceptionHandlingMode { get; private set; } =
+            ShrinkEventExceptionHandlingMode.LogAndContinue;
+        internal Action<Type>? EventClassChecker { get; private set; }
+        internal bool StartShutdownEnabled { get; private set; }
+        internal bool CheckTypesOnDispatchEnabled { get; private set; }
+        internal bool AllowPerPhaseDispatchEnabled { get; private set; }
+
+        public ShrinkEventBusBuilder SetExceptionHandler(IShrinkEventExceptionHandler handler)
+        {
+            ExceptionHandler = handler ?? throw new ArgumentNullException(nameof(handler));
+            return this;
+        }
+
+        public ShrinkEventBusBuilder SetExceptionHandlingMode(ShrinkEventExceptionHandlingMode mode)
+        {
+            ExceptionHandlingMode = mode;
+            return this;
+        }
+
+        public ShrinkEventBusBuilder StartShutdown()
+        {
+            StartShutdownEnabled = true;
+            return this;
+        }
+
+        public ShrinkEventBusBuilder CheckTypesOnDispatch()
+        {
+            CheckTypesOnDispatchEnabled = true;
+            return this;
+        }
+
+        public ShrinkEventBusBuilder AllowPerPhaseDispatch()
+        {
+            AllowPerPhaseDispatchEnabled = true;
+            return this;
+        }
+
+        public ShrinkEventBusBuilder ClassChecker(Action<Type> checker)
+        {
+            if (checker == null)
+                throw new ArgumentNullException(nameof(checker));
+
+            EventClassChecker = EventClassChecker == null
+                ? checker
+                : EventClassChecker + checker;
+            return this;
+        }
+
+        public ShrinkEventBusBuilder MarkerInterface<TMarker>() where TMarker : class
+        {
+            var markerType = typeof(TMarker);
+            if (!markerType.IsInterface)
+                throw new InvalidOperationException($"Marker type {markerType.FullName} must be an interface.");
+
+            return ClassChecker(eventType =>
+            {
+                if (!markerType.IsAssignableFrom(eventType))
+                    throw new ArgumentException(
+                        $"This bus only accepts events assignable to {markerType.FullName}, but got {eventType.FullName}.");
+            });
+        }
+
+        public IShrinkEventBus Build()
+        {
+            return new ShrinkEventBusInstance(this);
+        }
+    }
+}