来源、版本与验证边界
本指南以 Cocos Creator 3.8.8、TypeScript、2D 微信小游戏为教学基线，资料核对日期为 2026-10-31（Asia/Shanghai）。这表示教程固定版本，不表示它永远是最新版本。
来源怎么选择
优先使用 Cocos 3.8 官方手册、3.8.8 类型声明与引擎源码；微信能力使用官方 API 页面与腾讯官方小游戏类型仓库；站点工具使用 Docusaurus 官方资料。
| 内容 | 官方来源 |
|---|---|
| 引擎能力与编辑器 | 3.8 LTS 手册 |
| API 与版本 | API 参考、3.8.8 官方类型 |
| 实现细节 | cocos-engine v3.8.8 |
| 微信运行环境 | Creator 微信发布说明 |
| 微信 API | 官方开发入口、腾讯小游戏类型仓库 |
| 文档工具 | Docusaurus 3.10.2、Mermaid 支持 |
本次浏览工具无法直接读取部分 developers.weixin.qq.com 页面。登录、激励视频的核心语义通过腾讯官方小游戏类型注释交叉核对；账号资格、基础库条件、包体额度和审核政策需要发布时再核实，不凭历史数字猜测。
不同验证代表什么
| 验证层 | 本站交付中的含义 | 不能推出 |
|---|---|---|
| 文档构建与类型检查 | Docusaurus 可构建，站点代码类型正确 | Creator 游戏已经可运行 |
| 示例静态类型检查 | 下载区脚本通过官方 3.8.8 引擎声明检查 | 节点已经绑定，玩法运行正确 |
| 站点浏览器检查 | 导航、搜索、图、GIF、Mermaid 与布局可用 | 微信端的游戏功能已验证 |
| Creator 编辑器预览 | 需要按文档装配并运行游戏 | 本次未交付完整游戏工程，未声称通过 |
| 微信开发者工具与真机 | 需要你的 AppID、配置与真实设备 | 本次未运行微信登录、广告或真实关系链榜 |
正文中的代码块会区分完整组件与概念片段。下载区完整脚本由检查脚本使用真实引擎类型检查；平台章节主要提供协议、步骤和验收，不假装完成实际平台接入。
图片与 GIF 是什么
本站有 12 张原创 SVG 教学图、6 段原创 GIF 与静态封面。它们由生成脚本绘制，解释概念，不是编辑器截图、引擎录屏或性能测量。动画默认静止，由读者主动播放，可以随时停止。
Mermaid 表示逻辑关系；例如“一帧的流程”是概念简图，不是引擎所有内部任务的严格时序。后端类比也会说明边界。
更新时如何保持可信
升级 Creator 时重新检查 API 与示例；改变玩法时更新状态图和验收；更新平台政策时记录核对日期与官方依据；不要删除未验证标记后就声称验证通过。
站点实际发布与维护步骤见站点维护。