feat: integrate room framework and isolated subgame bundles

Complete room UI and protocol integration, move game definitions and resources behind bundle entries, publish authoritative version XML, and document single-game builds. Include all current resource changes and experiment artifacts.
2026-09-09 03:13:18 +08:00
parent a7ec8aa6a7
commit 35216f75e7
1028 changed files with 835556 additions and 21415 deletions
@@ -0,0 +1,11 @@
+# 子游戏静态依赖解除实施计划
+
+目标：公共框架与应用启动层不导入具体子游戏。沿用已经通过独立构建与导出网页验证的 Bundle 动态加载能力，不修改引擎或服务器。
+
+1. 为入口解析补充失败测试，覆盖未知入口、键不匹配、资源越界；新增公共代码不得静态引用 games 的边界检查。
+2. 将游戏定义、聊天和菜单策略放入各自目录。每个游戏通过 `GameEntry_<gameKey>` 导出定义；公共入口只依赖 SDK 契约。
+3. SubgameAssets 按 gameKey 加载 `game-<gameKey>`，完成入口解析、私有 prefab 加载后才允许启动平台。版本仍使用各自 `version-<gameKey>` Bundle，XML 保持唯一身份来源。
+4. 使用编辑器 API 将游戏根目录设为 Bundle，将模板创建房间 prefab 移到模板游戏目录；清除启动场景的私有 prefab 引用，保留公共房间场景。
+5. 更新静态资源检查、测试夹具与接入说明。测试所有既有行为及失败边界；编辑器导入后验证资源引用和真实 Web 构建运行。
+
+边界：本次解除运行时依赖；不更改房间协议、玩法与原生接口。构建选择器的自动化单独围绕现有 gameKey 实现，不引入第二份身份配置。