常见问题与排障

当主流程已经清楚，但某一个环节仍然卡住时，先从这里查。

我应该安装哪个桌面端构建？

• 大多数用户应该安装最新发布版本，可以从 桌面端下载 或 GitHub Releases 选择，不要从源码构建开始。
• 按自己的操作系统、CPU 架构和安装格式选择对应构建。
• 源码构建和开发命令请看 项目 README。

Sona 一直提示我完成首次设置

• 打开提醒横幅，把模型和麦克风步骤完成。
• 如果之前跳过了引导，请确认 设置 > 模型设置 中已经配置好 实时录音模型 和 批量转录模型。
• 如果曾主动关闭提醒横幅，请在 Sona 再次提示时从相关入口重新进入引导。

下载推荐模型 失败，或者一直无法完成

• 保持 Sona 打开，并确保网络稳定；推荐模型包较大，下载和解压都需要时间。
• 检查剩余磁盘空间；如果引导被中断，可以之后到 设置 > 模型设置 重试或重新配置。
• 如果多次停住，先打开 诊断 查看模型下载或本地运行时提示，再重试。

模型已经下载，但 Sona 仍提示缺失

• 打开 设置 > 模型设置，确认对应槽位已经选中：实时转录用 实时录音模型，文件转录用 批量转录模型。
• 确认模型文件夹仍保留解压后的文件；下载后移动或重命名文件夹会让 Sona 找不到原路径。
• 如果模型是在 Sona 外部下载的，请在 设置 > 模型设置 手动选择，不要只依赖首次设置状态。

实时录音 无法开始

• 检查系统麦克风权限。
• 确认已经配置 实时录音模型。
• 确认当前输入源是否正确： 麦克风 或 桌面音频。

实时录音 能打开，但仍听不到麦克风

• 打开 设置 > 输入设备，选择你真正想让 Sona 使用的麦克风。
• 检查系统麦克风权限，并确认没有其他应用独占这个设备。
• 如果当前输入源是 桌面音频，先切回 麦克风 验证输入链路。
• 如果设备选择看起来正确但 Sona 仍提示没有输入，打开 诊断 查看本地音频和转录状态。

在哪里查看本地转录诊断？

• 打开 设置 > 常规，进入 诊断。
• 它可以帮助检查本地转录就绪状态、模型路径、输入设备状态和打包运行环境。
• 需要求助时，优先提供可见的诊断提示或错误信息，而不是只描述症状。

批量转录 无法开始

• 确认已经配置 批量转录模型。
• 确认文件扩展名属于支持格式。
• 如果 Sona 提示格式不支持，请先转换文件格式再重试。

LLM 润色 或 翻译 不可用，或者执行失败

• 确认 设置 > LLM 服务 中已经填写正确的 provider 凭据。
• 确认功能本身已经绑定模型：润色需要 润色模型，翻译需要 翻译模型。
• 先使用 测试连接 验证连通性。
• 如果你使用自定义接口地址或本地服务，例如 Ollama，请先确认那个服务本身可访问。

找不到 Auto-Polish

• 打开 LLM 润色 > 高级设置，在那里可以配置 Auto-Polish、频率、关键词、场景预设和自定义上下文。
• 如果你想先理解这些入口各自负责什么，继续看 词汇与高级设置。

导出时只有 原文

• 只有当当前转录已经包含翻译文本时，译文 和 双语 才会出现。

说话人校对 是空的，或者没有候选人

• 说话人校对 依赖当前转录已有的说话人元数据。如果这份转录没有说话人归属信息，列表可能为空。
• 候选建议取决于 设置 > 词汇 中的 说话人档案、已导入的参考样本、已配置的说话人模型，以及当前项目启用了哪些档案。
• 只要编辑器中已经显示说话人徽标，你仍然可以点击它并手动绑定档案。

找不到 版本快照

• 版本快照 只会出现在已经保存到工作区、且包含转录分段的条目上。
• 临时 current 转录和仍在进行中的实时录音草稿不会显示这个入口。
• Sona 会在 LLM 润色、翻译、重新转录 等批量改写前，以及从其他快照恢复前创建快照。

恢复备份后能看到文本，但没有音频播放

• 备份归档刻意保持轻量，只包含配置、工作区、轻量历史转录与摘要、自动化状态，以及仪表盘 LLM 使用记录。
• 原始音频文件不会进入备份，因此恢复后的条目可能可以阅读和编辑，但除非音频通过其他路径可用，否则不会显示播放能力。

为什么新内容会先进入 Inbox

• Inbox 是录音和导入内容的默认承接位置，专门用来存放尚未分配到项目的内容。
• 如果你希望新内容自动留在某个项目里，请先打开那个项目，再开始 实时录音 或 批量转录。
• 如果内容已经进入 Inbox，你之后仍然可以在 工作区、项目与 Inbox 中把它移动到目标项目。

删除项目后，里面的内容会怎样

• 删除项目只会移除项目本身，不会删除项目里的录音或导入内容。
• Sona 会把这些内容移回 Inbox，你之后仍然可以继续使用或重新分配它们。

为什么我还在录音时就看到了一个 草稿 条目

• 实时录音进行中时，Sona 可能会先创建一个可见的 草稿 条目，让这次会话提前在 工作区 里占好位置。
• 当你停止录音后，Sona 会直接完成这条草稿，而不是再额外创建第二条记录。
• 在采集中，请把这条草稿理解为当前实时会话；录音结束后，正式转录仍然会从同一入口继续使用。

实时字幕 没有显示出来

• 请先回到 实时录音 页面，确认已经打开 实时字幕；设置 > 字幕设置 只负责窗口行为和外观，不负责启动入口。
• 如果你只是想显示系统音频字幕，不必先开始录音，直接开启 实时字幕 即可。
• 实时字幕 依赖同一套离线实时转录能力，因此也需要先配置可用的 实时录音模型。
• 如果你想先理清 实时录音 页面开关和字幕设置之间的区别，继续看 实时字幕与语音输入法。

语音输入法 无法工作

• 先在 设置 > 语音输入法 中启用 语音输入法。
• 确认页面上的快捷键、模型、VAD、输入设备与就绪状态都符合预期。
• 语音输入法依赖同一套离线实时转录能力，因此也需要先配置可用的实时转录模型。
• 如果你还没决定该用 按住说话 还是 切换模式，继续看 实时字幕与语音输入法。

去哪里恢复中断的批处理或自动化任务

• 如果 Sona 提示有待恢复项目，请先打开顶部通知中心。
• 使用 恢复中心 继续或丢弃中断的批处理与自动化任务。
• 如果你实际要找的是诊断或备份入口，请前往 设置 > 常规。

看不到播放控件

• 只有当当前转录关联了音频来源时，底部播放器才会显示，例如已保存的录音条目或已处理完成的文件。

我想从源码构建或参与开发

• 请查看 项目 README 中的源码构建与开发命令说明。
• 如果只是正常使用 Sona，请优先安装发布版本；源码构建主要面向贡献者和开发调试。