遇到问题？先按症状找解法。
把声忆出过的常见问题按 用户看到的症状 整理成速查表。看你具体是哪种情况，往下找对应解法。
症状 1 · 按住快捷键完全没反应
这是最高频问题。99% 的情况是 三个权限 没全部开。
排查顺序
- 菜单栏有声忆图标吗？没有 → App 没启动，打开
/Applications/VoiceInput.app - 系统设置 → 隐私与安全性，依次检查：
- 输入监控（最容易忘）— 找到 VoiceInput → 开关打开
- 麦克风 — 同上
- 辅助功能 — 同上
- 三个都开了仍不响应 → 把 VoiceInput 从 输入监控 列表删掉再加（点
-再+），常见 macOS bug - 还是不行 → 见下面「修复权限错位」
详细教程：权限设置。
症状 2 · 按快捷键触发了别的 App
说明快捷键被别的 App 抢了。看 快捷键文档 的「冲突排查」部分，三步定位冲突源 + 改成不冲突的组合。
症状 3 · 录到声音了但文字没插进去
三种常见原因：
3a · 辅助功能权限失效
声忆插入文字依赖辅助功能权限。检查 系统设置 → 隐私与安全性 → 辅助功能 是否打开。
3b · 你切了窗口
说话过程中你切到别的 App 了，识别完成时光标已经不在原来的输入框 — 文字会插到当前光标处。声忆 v0.10+ 加了「目标窗口锁定」防这种情况，但极个别 App（如全屏游戏）能逃过。
3c · 当前 App 不接受外部输入
极少数 App（受保护输入框，如银行 App 的密码栏、某些虚拟机的全屏窗口）拒绝接受合成的键盘事件。这时声忆会自动 fallback 到 剪贴板 + toast 提示「按 ⌘V 粘贴」。
症状 4 · 识别完没出任何文字
识别本身失败了。可能：
- 麦克风没声音：检查系统输入设备是否选对了（系统设置 → 声音 → 输入）
- 录音太短：录音 < 0.5 秒会被判定为误触不识别（防止误按）
- 云引擎网络错误：切到本地引擎试试 — 还能识别说明是云端故障
- 本地引擎模型未下载：选了「本地流式」但模型缺失 → 设置 → 引擎 → 重新下载
症状 5 · 买了 Pro 但侧边栏还显示「未配置」
License 没绑到当前账号。检查：
- 设置 → 账号 — 是否登录了支付时用的邮箱？没登录 → 用支付邮箱登录
- 到 网页版我的账号 看 license 状态 — 如果状态是 active 但客户端没识别到，关 App 重开一次（License 会重新拉）
- 如果网页也看不到 license → 邮件 [email protected] 附支付邮箱，我们查
详见 License 文档。
症状 6 · AI 整理一直显示「整理超时」
- 偶发超时：网络抖动或云端拥堵，v0.61+ 起会自动重试 1 次。如果连续 2 次都超时，是真的网络有问题 — 切回 Wi-Fi、关代理。
- 持续超时：可能你的 IP 被云端限流。考虑切到 BYOK 模式（用自己的 OpenAI / Kimi API Key）— 直接调 API 不走我们代理。
- 录音太长：90 秒以上的整理超时概率明显高。建议长录音切短录入。
症状 7 · 启动闪退
极少见，但出现过几次根因：
7a · macOS 26（开发预览版）兼容
macOS 26 改了部分 SwiftUI / NSPanel API 行为。声忆 v0.32+ 已修主要兼容问题，确保你的版本 ≥ v0.32.0。从 下载页 拿最新版。
7b · 数据库损坏
很罕见。手动备份 + 重置数据库：
- 退出声忆
- Finder → ⌘+⇧+G → 输入
~/Library/Application Support/VoiceInput/ - 把整个文件夹移到桌面备份（包含所有历史录音和设置）
- 重启声忆 — 它会重建空数据库
- 如果稳了，说明老数据库有问题；联系我们能帮你尝试恢复历史记录
7c · 输入法 / 输入助手冲突
极个别情况下，搜狗输入法、QuickCursor 等会跟声忆的全局 hotkey tap 冲突导致崩溃。临时退出那些 App 测试 — 是它们冲突的话联系作者反馈，或换成不冲突的工具。
修复权限错位（终极方案）
三个权限都开了但仍然不工作 — 通常是 macOS 通过证书指纹识别授权失效（你装过开发版 / 旧版可能挂在错的版本上）。
- 系统设置 → 隐私与安全性 → 把 VoiceInput 从 三个 权限列表里全部移除
- 退出声忆（菜单栏 → 退出，或 ⌘+Q）
- 重新打开
/Applications/VoiceInput.app - 按一次快捷键说话 — macOS 会重新弹三次权限请求，依次授权
升级后突然不工作
macOS 大版本升级（如 14 → 15）经常导致部分 App 的输入监控权限失效。修法跟「修复权限错位」一致 — 把 VoiceInput 从输入监控列表删掉再加。
查看日志（高级用户）
如果以上都不行，反馈时附上日志能加快诊断：
~/Library/Application Support/VoiceInput/logs/
把最近一次崩溃 / 故障当天的 .log 文件附在邮件里发到 [email protected] 即可。
还是没解决？
把以下信息发到 [email protected]：
- 具体症状（最好录屏）
- 声忆版本（菜单栏 → 关于 / 设置）
- macOS 版本（关于本机）
- 以上排查到哪一步还不行
24 小时内必回。