故障排查
按安装、运行环境、模型、权限、执行和交付物分类定位问题。
遇到问题时，先判断故障发生在哪一层，再做最小测试。不要一开始就重装、清除数据或连续重试高影响任务。
快速判断
| 现象 | 先看哪里 |
|---|---|
| 无法安装或启动 | 安装与启动 |
| Runtime 检查失败 | 运行环境 |
| 模型不可用或认证失败 | 模型与 Provider |
| 屏幕、文件或浏览器无法访问 | 权限 |
| 任务卡住、重复或失败 | 任务执行 |
| 预览、导出或文件异常 | 交付物 |
| 更新后异常或需要恢复 | 更新与恢复 |
通用排查顺序
记录现象、发生时间、Raydo 版本和操作系统版本。
保存原任务和错误提示，不要先清除数据。
用无敏感内容的最小任务判断问题能否复现。
检查相关连接、权限和运行记录中的第一个错误。
一次只改一个条件，改完立即复测。
仍无法解决时，导出并脱敏诊断信息。
保留现场
重置应用、删除数据目录或手动修改内部文件可能让问题更难追踪，并造成数据丢失。先备份和导出诊断。
提交问题前
请准备：
- Raydo 版本和系统版本；
- 问题首次发生时间；
- 可安全分享的复现步骤；
- 脱敏后的错误信息；
- 是否在更新、改权限或更换 Provider 后出现；
- 诊断包中不含密钥、登录态和私有内容的确认。