故障排查¶
排查问题时先缩小范围：确认是界面显示、蓝图数据、目标选择、资源引用，还是外部环境导致。不要同时改动多个设置，否则很难判断哪一步真正解决了问题。
推荐检查顺序¶
- 阅读界面通知和失败原因，记录具体节点、片段或资源名称。
- 确认当前自动化、蓝图和目标是否正确。
- 保存蓝图，再用最小范围 Debug 复现一次。
- 暂时断开无关分支，只保留发生问题的步骤。
- 检查资源、坐标、分辨率、录制范围和变量类型。
- 只有在界面已经无响应且无法安全等待时才考虑关闭软件。
保存需要较长时间¶
包含大图、视频、ONNX 模型或大量内嵌资源时，保存需要写入和整理资源数据。等待期间不要连续点击保存，也不要立即强制结束软件。
如果少量片段和一张普通图像仍长期重复出现保存卡顿：
- 查看是否有资源导入、视频编码或导出任务仍在进行；
- 检查通知区域是否显示具体资源错误；
- 导出或复制重要蓝图作为备份；
- 记录资源数量、文件大小和卡住阶段，再提交问题。
录制按钮没有开始录制¶
录制设置必须有有效目标：
- 屏幕模式需要有效屏幕。
- 范围模式需要完成矩形范围选择。
- ADB 模式需要安卓实例和操作范围。
目标缺失时保存设置不可用，或在点击后提示先设置范围。安卓实例或屏幕失效，或者所选范围不再位于可用显示区域时，下一次录制会要求重新选择。
录制期间时间线没有变化¶
录制准备和录制期间会锁定部分编辑交互，但时间指示器和增量片段应提供进度反馈。确认倒计时已经结束、录制状态已进入“正在录制”，并检查所选输入是否被录制规则过滤。
ADB 模式下，鼠标左键在操作范围内可作为自由触摸记录；其他按键仍依赖映射。“仅录制映射按键”开启时，没有映射的普通按键不会生成目标片段。
按键映射没有作用¶
依次检查：
- 录制或 Debug 目标是否为预期安卓实例。
- 组件是否设置了有效按键与坐标。
- 实时注入是否被
F7暂停。 - 当前按键是否正在等待双击编辑输入，或仍有其他键处于按下状态。
- 目标实例是否刚重启、断开或改变显示范围。
恢复实时注入后先用一个不会产生危险效果的按键验证。输入仍有明显延迟时，记录首次触点和后续触点是否表现不同。
预览图像过亮、偏色或出现断层¶
- HDR 显示环境下，确认软件 HDR 模式与当前显示器和捕获方式一致。
- 截图链路应保留原始 PNG 质量；导入资源才进入资源压缩处理。
- 横跨不同 HDR 状态显示器的范围可能得到不一致结果，建议把目标完整放在同一显示器。
- 黑色断层通常不是正常 PNG 压缩现象，应保留原始截图用于对比。
图像识别模板无法自动生成¶
自动模板只从主预览轨道取图。系统先查找坐标所在时间的画面，没有时向前寻找最近的可用图像或视频帧。
检查主轨道是否存在覆盖该时间或更早的素材。小眼睛隐藏只影响预览显示，不应阻止主轨道取图；主轨道完全没有可用画面时，模板无法生成。
内嵌资源显示为空¶
删除资源后，节点、变量或片段中的引用会变为空，不会在资源管理器里保留一个可右键“替换”的幽灵条目。请回到实际使用位置重新选择资源，或把另一项资源拖到对应预览区域。
未使用且未受保护的资源会在资源生命周期清理时移除；受保护资源不按使用状态清理。
Debug 启动较慢¶
Debug 前需要检查当前目标、资源和可执行数据。再次运行仍可能重新准备已修改的蓝图；部分 Debug 入口会显示当前阶段，失败时应按通知中的具体原因处理。
排查时记录：
- Debug 的目标类型；
- 蓝图是否刚修改或保存；
- 延迟发生在准备、连接还是第一条操作；
- 第二次运行是否与第一次同样慢；
- 失败通知是否指向某项资源或目标。
云盘或商品内容不可用¶
先确认账号已登录、网络可用、云盘配额足够，以及购买或分享状态仍然有效。删除云盘文件不会自动删除已经导入的本地副本，但可能影响与商品或更新入口的关联。
提交问题时提供什么¶
- 软件版本和操作系统版本；
- 发生问题的工作区；
- 最短复现步骤；
- 界面完整错误文字；
- 是否只在某个目标或显示器出现；
- 可脱敏的蓝图、截图或日志。
不要提交账号密码、访问令牌、个人隐私画面或包含敏感文件路径的原始截图。