# 框架文档

返回[文档首页](../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。