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,60 @@
+using System;
+using System.Collections.Generic;
+using Newtonsoft.Json.Linq;
+using UnityEngine;
+
+namespace ShrinkDataSaver
+{
+    public static class MigrationChain
+    {
+        private static readonly SortedDictionary<int, Migration> Migrations = new();
+
+        private struct Migration
+        {
+            public int ToVersion;
+            public Func<JObject, JObject> Migrate;
+        }
+
+        public static void Register(int fromVersion, int toVersion, Func<JObject, JObject> migrate)
+        {
+            if (fromVersion >= toVersion)
+                throw new ArgumentException(
+                    $"[ShrinkDataSaver] fromVersion({fromVersion}) 必须小于 toVersion({toVersion})");
+
+            Migrations[fromVersion] = new Migration { ToVersion = toVersion, Migrate = migrate };
+        }
+
+        internal static (JObject data, int finalVersion) Apply(JObject data, int currentVersion, int targetVersion)
+        {
+            var version = currentVersion;
+            var backup = (JObject)data.DeepClone();
+
+            while (version < targetVersion)
+            {
+                if (!Migrations.TryGetValue(version, out var migration))
+                {
+                    Debug.LogWarning($"[ShrinkDataSaver] 未找到 v{version} → v{version + 1} 的迁移逻辑，数据可能不完整。");
+                    break;
+                }
+
+                try
+                {
+                    var fromV = version;
+                    data = migration.Migrate(data) ?? data;
+                    version = migration.ToVersion;
+                    Debug.Log($"[ShrinkDataSaver] 存档已迁移 v{fromV} → v{version}");
+                }
+                catch (Exception e)
+                {
+                    Debug.LogError(
+                        $"[ShrinkDataSaver] 迁移 v{version} → v{migration.ToVersion} 失败: {e.Message}，已回滚至 v{currentVersion}");
+                    return (backup, currentVersion);
+                }
+            }
+
+            return (data, version);
+        }
+
+        internal static void Clear() => Migrations.Clear();
+    }
+}