tag
本附录速查 Cocos Creator 3.8.8 工程结构：assets、library、temp、build、settings 的职责，.scene、.prefab、.meta 与 settings/v2/packages/*.json 的角色，并给出接入 @cocos/creator-types 做离线类型检查、用 cc.d.ts 反查 API 的方法，以及哪些需编辑器、哪些可命令行复现。
本附录是全书 mini2d 运行时的 API 速查表：按模块列出 TimeSource、realTime、FakeTime、Clock、Color、rgba、DrawCommand、Renderer、RecordingRenderer、CanvasRenderer 与 Game 的真实类型签名，并给出「假时钟推进固定步数 + 记录式渲染器断言绘制指令序列」的确定性测试写法，方便随手回查。
画 100 个精灵不等于 100 次 Draw Call。本节讲透批处理的三个条件——同纹理、同材质、命令连续，用记录式渲染器把 Draw Call 数下来，量化纹理切换的代价，说明图集为何是合批的前提，并给出 mini2d 实现、vitest 测试与 Cocos Creator 3.8 的 Sprite、SpriteAtlas 与动态合图对照。
本节把碰撞检测闭环成碰撞响应：推导 AABB 的最小平移向量（MTV），让重叠的物体沿最短方向被推出；讲清穿透与隧道效应的成因及扫掠检测解法；定义 isTrigger「只报事件、不推物体」的语义；再用位运算实现碰撞层与掩码过滤；末段对照 Cocos Creator 3.8 的 Collider2D、RigidBody2D、Contact2DType 与 IPhysics2DContact。
场景图只解决了位置，没解决「谁盖住谁」。本节为《方块冲刺》实现绘制顺序：用 layer + zIndex + 遍历序组成稳定排序键，按屏幕空间裁剪框实现滚动视窗与遮罩，并给出 mini2d 的渲染列表、裁剪栈、vitest 测试与 Cocos Creator 3.8 中 Mask、UIOpacity 的对照。
暂停面板、设置面板、确认框可能同时出现，谁盖在谁上面、点击落在谁身上、返回键该关哪个？本节给 mini2d 实现弹窗栈：用 push/pop/replace 管理层级，用遮罩与命中测试决定点击归属，用界面状态机约束屏幕跳转，并统一处理返回键。末节对照 Cocos Creator 3.8 的 BlockInputEvents、PageView 与输入系统。
暂停不是把循环停掉，而是让 dt 归零。本节给《方块冲刺》引入 timeScale：讲清它作用在缩放后的 dt 上、为什么 UI 计时必须不受缩放影响，并用慢动作与命中停顿两个玩法验证整套时间管线，最后对照 Cocos Creator 3.8 的暂停与时间缩放 API。
本节解决《方块冲刺》里「怎么找出该检测哪些物体」的问题：先看清宽相与窄相的分工，算清 O(n²) 逐对比较的代价，再从零实现均匀网格与四叉树两套空间划分，讲清静态层只插一次、动态层每帧重建的分层策略，最后用基准数据对比取舍，并对照 Cocos Creator 3.8 的 PhysicsSystem2D 调试绘制。
《方块冲刺》的排行榜有一千条记录，屏幕只放得下十几条。本节给 mini2d 实现虚拟列表：用前缀和与二分查找算出可视区，只渲染可见项；用节点池复用实例避免反复创建；再补上滚动惯性与越界回弹。末节对照 Cocos Creator 3.8 的 ScrollView、Layout 与 PageView。
可变 dt 会让物理抖、会穿墙。本节用累加器把真实时间切成固定步长：讲清 maxSubSteps 如何防死亡螺旋、渲染插值 alpha 怎么把画面抹平，并把 mini2d 的 Clock 类完整写出来，包括「对增量取整而非绝对时间戳取整」这个关键点，最后给出 Cocos 3.8 对照。
本节把《方块冲刺》的碰撞检测从零写起：先用中心加半宽的 AABB、圆形、OBB 三套结构定下形状，再逐个实现 AABB 区间重叠、圆与圆的免开方判定、圆与 AABB 的最近点法，以及 OBB 的分离轴定理；最后用一张代价表说明各自适用场景，配 vitest 用例与 Cocos Creator 3.8 的 Collider2D 家族对照。
本节从《方块冲刺》里一个真实 bug 出发：不乘 dt 的移动在不同帧率下速度完全不同。我们推导为什么乘 dt 就帧率无关、dt 从哪里来、为什么要钳制，分清先乘后加与先加后乘，踩一遍跳跃用 dt 的坑，最后给出 Cocos Creator 3.8 的对照写法。
本节给《方块冲刺》搭起场景图：用 2×3 仿射矩阵合成父子变换，讲清局部矩阵与世界矩阵的差别，用脏标记做惰性重算，并按深度优先遍历节点树；同时给出 mini2d 的 Node 实现、vitest 验证，以及 Cocos Creator 3.8 中 Node 与 UITransform 的对照。
本节给 mini2d 补上 UI 布局层：用归一化锚点把控件钉在父容器的任意相对位置，做出百分比布局与横竖排列；再处理设计分辨率、等比缩放与刘海屏安全区。末节对照 Cocos Creator 3.8 的 Widget、Layout、UITransform、Canvas、view、ResolutionPolicy 与 SafeArea。
对象能组装、能跑了，但关卡数值还写死在代码里。本节为 mini2d 引入组件字段描述符（类型与默认值），实现 serializeComponent / deserializeGameObject 双向管线，用 JSON 配置驱动《方块冲刺》的敌人实例化；末节给出 Cocos Creator 3.8 的 _decorator、Prefab 与 JsonAsset 完整对照。
组件挂上去之后还什么都不会发生，本节把 mini2d 的组件系统接进主循环，定义 onLoad/onEnable/start/update/lateUpdate/onDisable/onDestroy 七个回调的固定顺序，用状态位保证只调用一次，讲清启用状态如何向子节点传播，并实现一套带订阅与退订的事件总线，末节给出 Cocos Creator 3.8 的生命周期与 EventTarget 对照。
前五章的渲染、时间、输入能力还散在几个类里，要让《方块冲刺》的玩家、敌人、金币各自动起来，还缺一层组织方式。本节从深继承的三个硬伤讲起，亲手为 mini2d 写出 GameObject 持有 Component 的实体-组件结构，实现 addComponent/getComponent 与组件注册表，最后给出 Cocos Creator 3.8 的 Component 对照。
系统覆盖 Defold 手游变现工程：应用内购（IAP）商品设计、购买流程（发起/支付/回调/发货）、Store 验证与防刷单、订阅与返还商品、广告变现（激励视频/插屏/Banner）、广告 SDK 接入与瀑布流、以及营收设计与合规（年龄分级/隐私/退款）。
系统覆盖 Defold 关卡设计与编辑：Tilemap 关卡编辑（图块、图层、碰撞数据）、Collection 复用与预制关卡、关卡数据驱动（配置/JSON 描述关卡）、运行时动态构建关卡（程序生成、拼接）、玩家自制关卡（UGC）与导入导出、以及关卡编辑器的工程化（版本管理、批量编辑、热重载）。
系统覆盖 Defold 游戏存档系统：存档数据建模（存档状态/进度/设置分层）、序列化方案（JSON/msgpack/二进制）对比、Defold 文件系统（sys.save/load）与存储、存档加密与完整性校验（HMAC/版本戳）、存档版本迁移（字段演进/向后兼容）、自动存档与检查点、以及云存档与跨设备同步的工程实践。