排障手册

推荐排障顺序

模板是否已注册
open() 是否真的成功
初始状态是否已到达客户端
增量同步是否在持续更新
指令、事件、动作是否命中
页面是否进入了和预期一致的挂载模式

模板侧

templateId 写错
文件路径不对
模板结构不合法，注册阶段就失败

状态侧

期望自动同步，却写成了本地状态
sync: 和裸 key 混用，导致模板绑定不到
在 Query 里偷偷写状态

交互侧

事件名写错
绑定的组件不支持对应交互
服务端注册名和客户端动作名对不上
脚本报错后，后续逻辑没有继续执行

组合与渲染侧

视觉异常先看样式和组合属性，不要先猜“渲染器坏了”
opacity、overflow-clip、post-process、backdrop、blend 都已经有明确的 retained 组合语义
如果症状只在某个效果叠加后出现，先回退到最小组合，再逐项加回

拆解顺序

优先按这条链路拆：

模板注册 -> 打开 -> 初始状态 -> 增量状态 -> 交互 -> 回写 -> 最终组合结果