Yap：macOS 语音听写工具

项目简介

Yap 是一款面向 macOS 的免费开源语音听写工具。它常驻菜单栏，按下快捷键开始说话，再按一次，识别出的文字就会粘贴到你刚才正在使用的应用输入框里。

转录完全通过 Apple 系统的 Speech 框架在设备本地完成，不上传音频、不需要账号、不需要 API Key，也没有遥测。整个应用约三千行原生 Swift 代码，体积约 4 MB，空闲内存占用约 60 MB，内部不包含任何语音模型，也不调用网络。

主要功能

• 基于 Apple SpeechAnalyzer 的端侧流式转录，说话时即时出字
• 全局快捷键，可自定义，也支持单个修饰键（例如只用右 Shift）
• 识别结果直接粘贴到当前聚焦的输入框，适用于任意可输入文字的应用
• 转录历史保存在本地，支持搜索、复制与删除
• 说话过程中显示实时波形与部分转录预览
• 连按两次 Escape 可放弃本次听写
• 跟随系统默认麦克风，中途切换设备也能继续
• 可选开机自启动（默认关闭）
• 可只保留菜单栏图标、只保留 Dock 图标，或两者都隐藏，仅靠快捷键使用
• 无账号、无网络请求、无遥测

安装与使用

最快的方式是从官网 frigade.com/yap 下载，或使用 Homebrew：

brew install --cask frigadehq/tap/yap

后续更新：

brew upgrade --cask yap

也可以直接从 Releases 下载 .dmg，拖进「应用程序」文件夹。官方发布的版本已签名并公证。

默认快捷键是 ⌘⇧D，可在设置中修改。首次启动会依次申请四个权限并解释用途：

权限	用途
麦克风	听到你说话
语音识别	在设备上完成转录
辅助功能	判断你正在哪个应用中输入
自动化	把结果粘贴进去

其中「辅助功能」必须到系统设置里手动打开，macOS 不允许应用以编程方式获取该权限。

从源码构建可以一行完成克隆、编译、安装到 /Applications 并启动：

git clone https://github.com/FrigadeHQ/yap.git && cd yap && ./install.sh

注意事项

• 需要 macOS 26（Tahoe）或更高版本，且仅支持 Apple Silicon 机型，Intel Mac 不受支持。构建源码需要 Xcode 26。
• 之所以放弃 Intel，是因为 SpeechAnalyzer 只在 Apple Silicon 上本地运行；旧接口 SFSpeechRecognizer 在缺少本地模型的语言下会把音频发往 Apple 服务器，这与项目的隐私承诺冲突，因此被移除。若 SpeechAnalyzer 无法在本地处理你的语言，听写会直接停止，而不是把音频送出去。
• 本地自行编译的版本采用 ad-hoc 签名，每次重新编译都会被系统视为新应用而遗忘已授予的权限，表现为设置里开关仍开着但粘贴失效。设置中提供了「Reset and re-grant」按钮处理这种情况；正式发布的版本没有该问题。
• 粘贴的实现方式是写入剪贴板、通过 System Events 触发 ⌘V，再恢复原有剪贴板内容；恢复前会有等待，以兼容异步读取剪贴板的 Chromium 类应用。
• 目前跟随系统语言设置，尚未提供语言选择器。
• 项目以 MIT 许可证开源。

---

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