故障排查

按遇到的现象检查，保留错误信息后再决定是否重试。

本页内容

应用打不开或更新失败

确认安装包来自官网下载页；macOS v1 需要 Apple Silicon（arm64），不支持 Intel Mac。下载不完整时重新下载。更新检查失败时，检查网络或使用官网下载页；不要删除应用数据来修复安装问题。

在“模型”页点击 OpenRouter 旁的设置图标，核对 API Key。更换密钥后点击“保存”，或用“测试连接”检查已保存的密钥。测试失败时按错误提示检查网络和账号权限。确认模型卡片的开关已打开；节点只显示能力匹配的已启用模型，图片节点不会列出纯文本模型。

先打开节点的“失败详情”。余额、限流和权限错误按服务商提示处理；缺少输入时检查连线和节点内容。超时可在“设置 → 模型调用”调整，范围 1–60 分钟，默认 10 分钟，对新请求生效。网络连接仍可能提前中断。

先核对服务商日志中的时间和请求 ID。本地超时不能证明服务商没有生成；同步请求中断后也不保证能取回图片。保留本地失败详情和诊断信息，再决定是否重新运行，避免重复生成和计费。

确认邮箱与购买时一致，检查垃圾邮件中的 License 邮件。达到设备上限时，在旧设备解除激活；短期离线验证到期时联网校验。旧设备不可用或仍激活失败时联系支持。

在“设置 → 数据与存储”查看并复制诊断信息，连同应用版本、系统版本和问题发生时间提供给支持。发送前检查内容，去掉 API Key、完整 License Key、签名链接和私人创作内容。