常见问题
本页整理说点啥使用过程中的常见问题与排查方向。
语音识别失败怎么办？
- 检查麦克风权限是否已授予。
- 如果使用云端 ASR，确认网络可用、API Key 正确且账户仍有额度。
- 如果使用本地模型，确认模型已下载或导入完成。
- 换一个短句测试，排除录音太短、环境太嘈杂或没有声音输入的情况。
如何导出诊断日志？
说点啥会记录必要的运行诊断信息，便于排查崩溃、录音失败、模型加载失败等问题。
- 打开
设置 → 关于 - 找到诊断日志相关入口
- 导出日志后，在反馈问题时一并提供
本地模型第一次识别很慢？
本地模型首次加载需要把模型文件读入内存，耗时取决于设备性能和模型大小。可以在对应本地模型设置中开启“首次显示时加载模型”或“模型保活时长”，让键盘或悬浮球出现时提前准备模型。
OpenAI Realtime 没有流式结果？
OpenAI 供应商需要在对应渠道中开启「启用流式识别（Realtime）」，并且端点必须支持 Realtime API。如果使用第三方兼容接口，请确认该服务不是只兼容 /v1/audio/transcriptions 文件转写。
悬浮球经常消失？
部分系统会回收后台服务或无障碍服务。可以先在 设置 → 其他设置 中开启前台服务保活，并申请电池优化白名单；如果设备管控仍然很严格，再考虑 Shizuku / Root 增强保活。