当主流程已经清楚，但某一个环节仍然卡住时，先从这里查。
我应该安装哪个桌面端构建？
- 大多数用户应该安装最新发布版本，可以从 桌面端下载 或 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，你之后仍然可以在 项目中心与收件箱 中把它移动到目标项目。
删除项目后，里面的内容会怎样
- 删除项目只会移除项目本身，不会删除项目里的录音或导入内容。
- Sona 会把这些内容移回
Inbox，你之后仍然可以继续使用或重新分配它们。
为什么我还在录音时就看到了一个 草稿 条目
- 实时录音进行中时，Sona 可能会先创建一个可见的
草稿条目，让这次会话提前在项目中心里占好位置。 - 当你停止录音后，Sona 会直接完成这条草稿，而不是再额外创建第二条记录。
- 在采集中，请把这条草稿理解为当前实时会话；录音结束后，正式转录仍然会从同一入口继续使用。
实时字幕 没有显示出来
- 请先回到 实时录音 页面，确认已经打开
实时字幕；设置 > 字幕设置只负责窗口行为和外观，不负责启动入口。 - 如果你只是想显示系统音频字幕，不必先开始录音，直接开启
实时字幕即可。 实时字幕依赖同一套离线实时转录能力，因此也需要先配置可用的实时录音模型。- 如果你想先理清
实时录音页面开关和字幕设置之间的区别，继续看 实时字幕与语音输入法。
语音输入法 无法工作
- 先在
设置 > 语音输入法中启用语音输入法。 - 确认页面上的快捷键、模型、VAD、输入设备与就绪状态都符合预期。
- 语音输入法依赖同一套离线实时转录能力，因此也需要先配置可用的实时转录模型。
- 如果你还没决定该用
按住说话还是切换模式，继续看 实时字幕与语音输入法。
去哪里恢复中断的批处理或自动化任务
- 如果 Sona 提示有待恢复项目，请先打开顶部通知中心。
- 使用
恢复中心继续或丢弃中断的批处理与自动化任务。 - 如果你实际要找的是诊断或备份入口，请前往
设置 > 常规。
看不到播放控件
- 只有当当前转录关联了音频来源时，底部播放器才会显示，例如已保存的录音条目或已处理完成的文件。
云同步（E2EE）忘记主密码怎么办？
- 如果你妥善保存了首次配对时生成的
应急恢复密钥（Emergency Recovery Key），可以使用它重置访问。 - 如果同时遗失了主密码和应急恢复密钥，由于采用端到端加密（E2EE），云端同步服务器上的加密数据无法被任何人（包括开发者）解密找回。但已保存在当前设备本地的文稿与音频仍然完整可用。
云同步会把我的录音音频上传到云端吗？
- 不会。云同步仅同步文稿分段、摘要、项目元数据与设置，所有原始录音音频文件始终保存在本地机器上，不会上传至 WebDAV 或 S3 兼容对象存储云端。
为什么云同步提示冲突？
- 当多台设备离线编辑了同一篇文稿，或在同步间隔内并发修改时，Sona 会检测到冲突并将其放入
设置 > 云同步 > 冲突中心。 - 你可以在冲突中心预览两边的改动差异，手动选择保留本机版本、远端版本或进行合并。
误删了转录文稿如何恢复？
- 删除的文稿不会立即彻底抹除，而是会移入
项目中心左侧的回收站。 - 切换到
废纸篓浏览范围，选中误删的项目并点击恢复，即可将其还原至原来的项目或 Inbox。 - 只有在废纸篓中点击
清空废纸篓或选择彻底删除时，数据才会从本地磁盘永久抹除。
批量转录执行中可以中途停止吗？
- 可以。点击顶部标题栏的
消息中心图标，可以查看正在执行的批量转录任务队列，并随时针对当前任务点击取消。
音视频导入失败或提示缺少解码器怎么办？
- Sona 默认使用内置媒体解码链路。如果遇到非常规音视频封装或缺少解码器，可以前往
设置 > 存储管理，在自定义 FFmpeg 路径中手动指定本机已安装的 FFmpeg 可执行文件路径。
我想从源码构建或参与开发
- 请查看 项目 README 中的源码构建与开发命令说明。
- 如果只是正常使用 Sona，请优先安装发布版本；源码构建主要面向贡献者和开发调试。