opennookorg/betterwispr

BetterWispr – macOS 离线语音听写工具

简介 – BetterWispr 是一款免费、开源的 macOS 应用程序，您可以通过按住键盘快捷键（默认 ⌥ Space）将文本听写到任何窗口中。它完全在您的计算机上运行，使用设备端语音模型（Apple 内置识别器、NVIDIA Parakeet 或 OpenAI 的 Whisper），因此除非您主动连接外部 API，否则您的语音永远不会离开设备。

主要功能

• 按住说话或切换说话 – 按下快捷键，说话，松开后，转录的文本会粘贴到光标所在位置。
• 设备端模型 – Apple Speech（无需下载）、Parakeet v2/v3（支持 25 种欧洲语言）、Whisper large-v3 turbo。一次性下载后即可离线运行。
• 自定义词汇 – 为姓名、行话等添加拼写提示和短语替换。
• 从修正中学习 – 修正一次听错的单词（通过历史记录或粘贴后立即修正），应用会在下次正确拼写。
• 语音命令 – 在听写时说出“逗号”、“换行”、“划掉”、“对不起，删除那个”或“at the rate KV”（→ “@KV”）来插入标点或符号。
• 会议模式 – 对对话双方进行实时转录，并使用 Apple Intelligence 或本地 Ollama 模型提供可选的设备端标题、摘要和行动项提取。
• 历史记录 – 原始和修正后的转录存储在本地（可禁用），供查看或重用。
• 自带模型 – 连接任何兼容 OpenAI 的端点（例如 Sarvam AI、Smallest AI、自托管服务器）。密钥存储在 macOS 钥匙串中，音频仅发送到所选端点。

隐私与数据处理

• 设置、自定义词汇和转录历史存储在 ~/Library/Application Support/BetterWispr/workspace.json（纯 JSON，未加密）中。
• 模型文件存储在同级 Models 文件夹中。
• 音频录制写入临时文件，并在每次听写后立即删除。
• 内置模型不会在您明确下载前连接互联网；外部模型连接仅在您启用时使用。

快速开始

1. 从最新版本下载 DMG，并将 BetterWispr 拖到应用程序文件夹。
2. 打开应用，按照欢迎指南操作，并在模型下选择模型。
3. 授予麦克风和辅助功能权限（后者允许应用为您粘贴文本）。
4. 点击任意文本字段，按住 ⌥ Space，说话，然后松开。
   • 如果粘贴失败，文本将作为后备方案复制到剪贴板。
   • 录音会在两分钟后自动停止。

系统要求 – macOS 14 或更高版本（建议使用 Apple Silicon）。

贡献 – 构建说明、项目结构和贡献指南请参阅 CONTRIBUTING.md。

许可证 – Apache-2.0（第三方模型权重保留各自许可证）。