Blurt：macOS 语音听写工具

项目简介

Blurt 是一款免费、开源的 macOS 语音听写应用。轻点一个按键、开口说话，整理好的文字就会出现在当前获得焦点的 Mac 应用里。整个应用完全原生实现（AppKit + SwiftUI，没有 Electron、没有 WebView），核心管线放在无外部依赖的 Swift 6 包 BlurtEngine 中：麦克风采集 → 一次同步 POST 到 AssemblyAI 听写 API → 通过剪贴板粘贴到焦点应用。没有本地模型，没有上传后轮询的任务队列，也没有后台常驻进程，每句话只发一次 HTTP 请求。

音频直接从你的 Mac 发往 AssemblyAI，使用你自己的 API key，没有订阅、没有中间账号。

主要功能

• 在任何能打字的地方工作：转写结果通过合成的 ⌘V 粘贴到焦点应用，粘贴前会保存原剪贴板内容并在之后恢复；若目标应用在说话期间退出，文字会留在剪贴板里而不是丢失。
• 单键触发，无需组合键：默认用单独的右 ⌘ 触发，也可选右 ⌥ 或 fn，每种按键可各自绑定风格。轻点开/关，按住说话（push-to-talk），也可在设置中限定为只轻点或只按住。事件监听不吞掉任何输入，⌘C 等组合键照常通过。
• 一步润色：每句话连同少量上下文一起发到 AssemblyAI 听写 API，同一次调用在服务端用 LLM 清理口头语、修正标点，返回时已是打磨好的文本，不需要第二次请求。
• Styles：最多保存四种自定义风格，每种是一小段自由文本指令（例如「全部小写」），在主窗口的 Style 菜单切换。在设置 → Styles 关闭 Enhanced transcripts 可改为粘贴逐字转写。
• 你的词汇表：关键术语可影响人名和专业名词的拼写；文本快捷方式会在粘贴前于本机把口述短语替换成预设文本（说「personal email」得到邮箱地址）。两者都在设置 → Vocabulary 中。
• 快：转写与清理共用一次往返，通常约一秒完成；说话时已预热 HTTPS 连接，松键即进入「transcribing」状态。
• 准确：据 AssemblyAI 公布的基准，幻觉比 Whisper 少 30%。
• 多语言：支持 18 种语言，自动检测，可在句中切换语言。
• 实时反馈：悬浮胶囊显示实时麦克风电平与管线阶段，菜单栏也有同步指示。
• 合成器提示音：开始和结束提示音可用真实的 Yamaha DX7 或 Roland Juno-106 音色，也可关闭。
• 引导式设置：首次启动通过单一设置页填入 API key，并引导完成麦克风与辅助功能权限。设置 → Advanced 中的 Reset 会删除 key、设置和权限授权，然后重启进入首次运行向导。
• 原地更新：通过 Sparkle 每天检查一次新版本（也可手动检查），确认后安装，更新在安装前会校验签名；可关闭每日检查或允许自动安装。没有任何遥测。

安装与使用

要求：Mac（Intel 或 Apple Silicon）、macOS 15+（推荐 macOS 26，可启用 Liquid Glass 界面），以及一个 AssemblyAI API key（提供免费额度）。

1. 下载 Blurt.dmg，打开磁盘映像，把 Blurt.app 拖入 Applications。
2. 启动 Blurt，按向导授予麦克风与辅助功能权限，并填入 AssemblyAI API key。
3. 点击任意文本框（文档、聊天框、终端），轻点右 ⌘ 开始说话，悬浮胶囊会显示实时电平；再点一次停止，或按住说话、松开结束。
4. 润色后的转写会粘贴在光标处。之后可在主窗口的 Style 菜单选风格，或进设置修改触发键、麦克风、提示音包。

从源码构建需要完整 Xcode 26+（不能只有 Command Line Tools）、Homebrew 和 Apple 开发证书（在 Xcode → Settings → Accounts 里添加任意 Apple ID 即可免费获得）：

scripts/bootstrap.sh   # 一次性安装 Brewfile 中的工具链
scripts/dev-build.sh   # 构建并把 "Blurt Dev" 安装到 /Applications

dev-build.sh 故意安装到 /Applications：macOS 不会为住在构建目录里的应用注册辅助功能/输入监控权限。它以 Blurt Dev.app 和独立 bundle id 安装，可与正式版 Blurt 并存。

注意事项

• API key 存放在 macOS 钥匙串中。音频只在听写时采集，然后通过 HTTPS 发给 AssemblyAI，其隐私政策与服务条款适用于这些音频。
• 请求会携带上下文让转写自然衔接：本次会话中最近的听写内容，以及光标前的一小段文本；密码框的内容永远不会被读取，往密码框中听写的文字也不会作为上下文保存。设置中的关键术语和所选风格的指令会随请求发送以影响结果，文本快捷方式则在本机展开、不发送。不会发送所在应用、窗口标题、输入框或选中内容。
• 最近的听写历史只存在内存中，不写磁盘，退出 Blurt 即清空；上限为 100 条、每次请求约 4096 字符，超出的从最旧的开始丢弃。注意：Blurt 运行期间，在某个应用里听写过的文字，可能作为后续另一个应用听写的上下文被发送；退出重开即可清除。
• Blurt 不保存音频和转写文本，唯一例外是设置 → Advanced 中默认关闭的 Developer mode，开启后会在本机保留每次听写的日志。不发送任何遥测：没有崩溃上报、分析或使用追踪。
• 每次调用 AssemblyAI 都带一个 User-Agent，说明 Blurt、版本号和 macOS 版本，用于定位问题；其中不含任何可识别你或这台 Mac 的信息，也没有按安装生成的 id 或计数。

本作品整理自 GitHub 开源项目 AssemblyAI/blurt，原作者 @AssemblyAI，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。