常见问题与故障排查
停止录音后，光标处没有出现文字
Section titled “停止录音后，光标处没有出现文字”个别应用会拦截模拟粘贴，导致注入失败。此时文字已放入剪贴板，VocalFlow 会给出提示——按 ⌘V 手动粘贴即可，内容不会丢。
另外请确认听写结束时光标确实在输入框内：文字注入的是当时光标所在的位置。
热键没有反应
Section titled “热键没有反应”- 看菜单栏图标。如果它处于警告态，说明必需权限缺失——点开菜单，首项会直达修复入口。最常见的原因是辅助功能权限被系统回收（应用更新后可能发生）。
- 权限看起来正常时，到系统设置 → 隐私与安全性 → 辅助功能里把 VocalFlow 关掉再打开，然后重启应用。
- VocalFlow 会自行心跳检测热键监听器，被系统禁用后自动重建——短暂等待有时会自行恢复。
上屏的是原始转录，不是润色后的文字
Section titled “上屏的是原始转录，不是润色后的文字”这是设计好的降级行为：润色超过超时时间（默认 15 秒）、服务端出错或连接断开时，VocalFlow 会注入已累积的原始实时转录，避免让你无限等待。该记录在历史中标记为「原始转录」——网络恢复后可以打开它重新转录。
误触了热键，怎么丢弃这次录音？
Section titled “误触了热键，怎么丢弃这次录音？”按 ESC，再按一次 ESC 确认。本次录音作废，不注入任何文字。
应用启动后第一次听写起步很慢
Section titled “应用启动后第一次听写起步很慢”首个会话包含引擎预热，之后的听写几乎没有启动延迟。
菜单栏图标显示警告态
Section titled “菜单栏图标显示警告态”必需权限（麦克风或辅助功能）缺失。点击菜单栏图标——首项「权限不足，去设置…」会带你到权限区域，并提供一键直达系统设置对应面板的入口。
授了权限还是不生效
Section titled “授了权限还是不生效”辅助功能与屏幕录制权限有时需要重启应用才生效。退出 VocalFlow（菜单栏图标 → 退出）再重新打开。
macOS 提示应用无法打开
Section titled “macOS 提示应用无法打开”见安装 → Gatekeeper：系统设置 → 隐私与安全性 → 仍要打开。
为什么 VocalFlow 不上架 Mac App Store？
Section titled “为什么 VocalFlow 不上架 Mac App Store？”全局热键监听与光标处文本注入和 App Store 沙箱不兼容。见认识 VocalFlow。
额度用完了会怎样？
Section titled “额度用完了会怎样？”用完之前，录音中就会出现余额将尽的提示。额度耗尽后，转录请求会被拒绝，直到下期发放或补充额度——见额度与订阅。录音本身仍会正常采集并存入本地，之后可以重新转录。
VocalFlow 能离线用吗？
Section titled “VocalFlow 能离线用吗？”转录需要联网。录音中途断网时采集继续，VocalFlow 注入已收到的原始转录；音频存入本地，供之后重新转录。完全离线时无法发起新的转录。
我的录音和转录存在哪里？
Section titled “我的录音和转录存在哪里？”存在你的 Mac 本地——用户资源库下的 SQLite 数据库中。服务端不保存你的转录文本。见隐私与数据。
更新应用会丢数据吗？
Section titled “更新应用会丢数据吗？”不会。录音、历史、设置与登录状态都存放在应用包之外，更新后保留——见安装 → 更新。