# 调试区域参考

# 区域

区域	用途	不能证明什么
预览	操作当前工程的玩家界面	不能证明正式发布数据一致
控制区	刷新、重新加载和选择预览目标	不会自动清空全部状态
日志	查看脚本输出、警告和错误	无错误不代表规则正确
属性/对象监控	观察状态变化	只读显示不是持久化记录
事件/消息记录	跟踪触发顺序	不替代幂等测试
测试存档	保存、读取复现场景	与玩家正式云存档隔离

# 排错顺序

1. 用最小测试存档复现。
2. 执行一次操作并记录操作前状态。
3. 检查第一条错误，而不是最后一条连锁报错。
4. 对照日志确认挂载点与返回值。
5. 刷新或重新读取存档，确认结果可恢复。

# 分清四层状态

状态层	常见证据	重置/重载方式
工程项目	编辑器字段、ID、引用	重载项目或项目版本
运行时会话	当前场景、延迟回调、临时脚本 session	重载预览/运行时
测试玩家存档	属性、对象、表格、动态字符串	读取或重建目标测试存档
平台状态	登录、积分、聊天、排行、弱联网	使用对应测试账号/后台入口

只重置一层可能保留其他层。例如重载预览会清空临时脚本 session，但可能再次读入同一存档属性；重建测试存档也不会改变已发布项目版本。

# 把异步失败读成时间线

调试弹窗、AI、弱联网、云存档、特效或音频时，记录：

1. 触发器及其稳定资源 ID；
2. 提交锁或幂等标记；
3. Promise 的开始、完成或拒绝；
4. 只允许在成功后发生的状态写入；
5. 取消、超时、切场景和重载时的清理。

界面上看到的错误可能只是首个 Promise 拒绝后的连锁结果。确认原操作是否被接受前不要直接加重试，否则恢复路径可能重复扣费或发奖。

# 移动端

窄屏调试区会折叠。切换面板不会停止所有运行时任务；长脚本、AI 或网络请求仍需观察完成/失败状态。

# 验收

至少覆盖成功、需求不足、重复点击、刷新、离线或网络失败、移动端布局。修复脚本后重新加载运行时，避免把旧会话状态误当成新结果。

发布前，用非作者测试账号从正式玩家入口重复关键联网流程。预览只能证明当前工程构建，不能证明发布路由、生产权限、计费或跨玩家数据。

下一步：模块。