闪退与模型加载失败：故障排查清单

本地模型加载失败

按命中率排序：

1. 存储权限没给：第三方市场整理的安装经验里排在第一位的坑——系统设置里确认应用有存储权限，否则导入的模型读不出来；
2. 内存不足：模型加载需要连续大块内存，后台大型应用清一清；运存小的手机按模型选型降档到 3B 以下量化版；
3. 上下文开太大：上下文预算与模型大小共享内存，先把上下文调小验证，跑通再加；
4. 文件损坏：下载中断的 GGUF 会加载失败，重新下载完整文件；
5. 架构不匹配：应用为 arm64 构建（arm64-v8a），老设备注意兼容性。

应用闪退或黑屏

• 清理应用缓存后重试（系统设置 → 应用 → Agora → 清缓存；清缓存不影响对话数据）；
• 运存紧张时关掉后台大应用再开；
• 仍复现：记录版本号（关于页里的 v1.3.7 (25) 这类标识）与操作步骤，到官方问题追踪反馈——崩溃报告默认只存本地，发送与否由你确认。

云端对话异常

按密钥排错的通用三步法走一遍；多数「应用坏了」的观感其实是密钥、网络或模型选择问题。

数据看起来丢了

• 对话不见了：先查抽屉的归档区（可能被归档了），再查搜索；
• 重装后数据没了：数据在应用私有存储里，卸载即清——这就是为什么强调归档导出与自动备份要在出事之前做；
• 分支找不到了：树状对话的旧分支还在，沿分支切换找回来。

反馈问题的正确姿势

带上三样信息：版本号、渠道（F-Droid 或其他）、复现步骤。官方仓库的问题追踪入口在关于页就有链接。

相关页面

• 离线相关的能力边界，见没有网络时哪些功能还能用；
• 导入模型的完整流程回看，见导入 GGUF 模型。