# Cocos 平台框架与子游戏开发文档

本目录是 Cocos 前端开发文档入口。说明按框架与子游戏分类，文档链接只指向本目录内部；源码文件名或工程路径只用于说明操作位置，不作为外部阅读依赖。

## 框架

- [框架总览与维护边界](framework/README.md)
- [如何构建目标游戏](framework/build/README.md)
- [单游戏构建步骤与产物验收](framework/build/single-game-build.md)
- [如何接入子游戏](framework/integration/README.md)
- [创建房间接入](framework/integration/create-room.md)
- [当前架构与实施状态](framework/architecture/current-status.md)
- [房间平台架构设计](framework/architecture/room-platform.md)
- [SDK 接口说明](framework/sdk/contracts.md)
- [原工程接口迁移说明](framework/sdk/legacy-api-migration.md)
- [网络协议目录](framework/protocol/README.md)
- [身份、版本与构建](framework/build/version-and-build.md)
- [旧目录作用与迁移记录](framework/build/legacy-project-layout.md)

## 子游戏

- [子游戏专项资料目录](subgames/README.md)：按具体游戏归档设计、协议与接入状态。
- [二七王资料](subgames/erqiwang/README.md)：设计、玩法协议和当前接入状态。

## 使用原则

服务器与原生接口零改动；子游戏接入不修改框架代码或资源；配置单一来源，下游不猜测。场景、prefab、anim、meta 通过编辑器维护。Layer612_Tips 只承载玩家业务提示，不显示程序错误。

本目录整合了原先分散的协议与二七王文档，迁移日期 2026-09-08。历史设计、原工程协议、当前实现能力必须区分；以各章节的实施状态说明为准，不能把设计中的接口等同于已上线能力。