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 迁移与旧代码地图
This commit is contained in:
2026-08-18 18:06:34 +08:00
parent 517c4cf46e
commit d74c2f08ca
240 changed files with 13647 additions and 545 deletions
+7 -3
View File
@@ -229,8 +229,10 @@ Unity 菜单:
生成内容分两部分:
- 模板提供:宿主、TCP / KCP 服务端传输、基础鉴权、代码扫描器
- 扫描生成:`Generated/*.g.cs` 项目专属消息合同、处理器模板自动模块
- 模板提供:宿主、TCP / KCP 服务端传输、基础鉴权与扩展点
- 语义扫描生成:从 Unity 已编译的 Player 程序集读取类型、特性、继承与属性元数据,产出 `Generated/*.g.cs` 项目专属消息合同、处理器模板自动模块
完整工程生成会用 SHA-256 清单保护模板托管文件。再次生成前先校验全部文件仍等于上次生成版本;检测到人工修改时不会写入或删除任何模板文件。`Generated/*.g.cs` 仍属于可重建区域。
当前生成器会优先识别三类高价值范式:
@@ -238,6 +240,8 @@ Unity 菜单:
- `[ShrinkNetworkEvent]` 标记的广播型 / 裁决型 / 增量型网络事件
- `[ShrinkNetworkSubscribe]` 标记的权限声明
扫描以编译后类型为准,因此支持 `partial` 和复杂泛型。导出合同会去掉命名空间;不同命名空间存在同名消息或同名依赖类型时,生成器会列出冲突来源并中止,而不是静默保留第一项。仅手写 `RegisterMessage<T>()` 不属于服务器生成输入。
这意味着即便不手写额外适配层,只要项目遵守同一套特性范式,独立服务器也能先生成出一套可编译、可注册、可继续补业务的骨架。
## 🔧 API 参考
@@ -294,7 +298,7 @@ new ShrinkMessagePackNetworkSerializer()
- `BindTransport(...)` 只负责绑定传输与启动监听,不会替你注册业务 handler
- `TriggerEvent` 类桥接若依赖可选程序集,当前通过运行时反射自动接入;未安装扩展包时会静默跳过
- `GeneratedServers/` 中的产物允许重建,不要把人工业务逻辑直接写进自动生成文件
- `GeneratedServers/*/Generated/` 中的产物允许重建,不要把人工业务逻辑直接写进自动生成文件;模板托管区虽有哈希保护,也应通过独立业务文件扩展
- 运行依赖中的 `Kcp-CSharp.dll``System.Runtime.CompilerServices.Unsafe.dll` 需要与 Unity 平台兼容
## ✅ 已验证