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.
This commit is contained in:
2026-09-09 03:13:18 +08:00
parent a7ec8aa6a7
commit 35216f75e7
1028 changed files with 835556 additions and 21415 deletions
@@ -0,0 +1,29 @@
# 框架文档
返回[文档首页](../README.md)。
框架提供网络、配置解析、会话状态、公共房间流程、UI 能力与构建校验。具体游戏负责玩法编码、创建页面、牌局状态和玩法渲染。应用层负责注册与装配。
## 两条开发操作指南
- [如何构建](build/README.md):构建文档导航。
- [单游戏构建操作](build/single-game-build.md):gameKey、Bundle 勾选、切换游戏、导出与产物检查。
- [如何接入子游戏](integration/README.md):注册、目录约定、生命周期与资源绑定;包含[创建房间接入](integration/create-room.md)。
## 分类
- architecture:总体设计、房间生命周期、实施边界。
- sdk:子游戏可用契约、旧接口迁移、资源释放约定。
- protocol:传输、平台 agent/room RPC、数据结构、游戏消息桥接。
- build:专门的构建指南目录,包含 XML 身份来源、预览、打包与旧脚手架说明。
- integration:专门的子游戏接入指南目录,包含通用接入和创建房间流程。
## 入口
1. [当前架构与实施状态](architecture/current-status.md)
2. [房间架构设计](architecture/room-platform.md)
3. [SDK 契约](sdk/contracts.md)
4. [协议目录](protocol/README.md)
5. [单游戏构建](build/single-game-build.md)与[版本身份配置](build/version-and-build.md)
框架维护者增加公共能力时应使用注入的能力契约,不增加具体 gameKey/gameid 分支;子游戏开发者使用这些能力,不访问框架内部 Store、Runtime、WebSocket。