下载 Mac 版 YapToText
作者 Ryleigh Newman · 发布于 · 更新于
请从 Mac App Store 安装 YapToText。它是免费的，两个模型都内置在 App 里，所以第一次打开就能在关闭 Wi-Fi 的情况下听写。如果你更习惯用 Terminal，一条 Homebrew 命令也能安装同一个 App，只是不含模型，第一次听写之前要先下载一个语音模型。
不管用哪种方式，都需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本，还要两项权限：麦克风权限让 App 能听到你说话，辅助功能权限让它能在其他 App 里输入文字。
免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
用其他语言阅读： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文
步骤
- 从 Mac App Store 安装 YapToText，或者在 <span lang="en">Terminal</span> 里运行 brew install --cask ryleighnewman/yaptotext/yaptotext。
- 如果用的是 Homebrew，请打开 <span lang="en">AI Models</span> 页面，下载 Whisper Large v3 Turbo (Q5)，想用会整理文字的模式的话，再加上 Phi-3.5 Mini Instruct。
- 打开 YapToText，macOS 询问时允许访问麦克风。
- 在 Home 页面按辅助功能旁边的 <span lang="en">Grant</span>，然后在“系统设置”，“隐私与安全”，“辅助功能”里打开 YapToText。
- 点按文字要出现的位置，轻按 Right Command，说话，再轻按一次 Right Command。
先确认你的 Mac 能运行
YapToText 有三项要求。你需要搭载 Apple 芯片的 Mac、macOS 14 或更高版本，以及约 2.9 GB 的空间（App Store 版本）。
- 搭载 Apple 芯片的 Mac。 我没有在 Intel Mac 上测试过任何东西，所以不支持 Intel Mac。
- macOS 14（Sonoma）或更高版本。 Homebrew 的 cask 会拒绝更旧的系统。在 macOS 26 上，界面会采用 Liquid Glass 的外观。
- 麦克风。 Mac 自带的麦克风就可以用，而且比蓝牙耳机听得更清楚，因为蓝牙耳机传送的是电话音质的声音。
App Store 版本约需要 2.9 GB 的空间，其中大部分是两个模型。Homebrew 版本下载约 12 MB，解压后约 18 MB，另外还要加上你自己下载的模型。没有 iPhone、iPad、Windows 或 Linux 版本。
从 Mac App Store 安装
我推荐 Mac App Store 版本，因为不需要再设置别的东西。它不要钱，没有付费方案，也不用注册账号。“免费”在这里是什么意思，价格页面里有说明。App 里唯一要花钱的地方是一个可以不理会的打赏罐，没有任何功能被它锁住。两个模型都内置在 App Store 版本里，所以不需要另外下载任何东西。
- 操作: 打开 Mac App Store 里的 YapToText 并下载。
- macOS: 下载约 2.9 GB，大部分是两个模型：用于语音识别的 Whisper Large v3 Turbo (Q5)，574 MB，以及用于整理文字的 Phi-3.5 Mini Instruct，显示为 2.3 GB。
- 确认: YapToText 出现在你的Applications文件夹里，打开后，水豚会出现在菜单栏中。
更新和其他 App 一样通过 App Store 进行。YapToText 自己从不访问服务器检查更新。
或者用 Homebrew 安装
Homebrew 从同一份源代码安装同一个 App，只有三点不同。它用 Developer ID 签名并经过公证，而不是 App Store 签名，它不含模型，而且可能比 App Store 版本晚一个版本。What's new 页面列出了两个版本。装好之后，第一次听写之前要先下载一个语音模型。
Terminal：从我的 Homebrew tap 安装 YapToText。
brew install --cask ryleighnewman/yaptotext/yaptotext会发生什么：下载约 12 MB 之后，YapToText 出现在你的Applications文件夹里，Homebrew 会打印一条提示，让你打开 AI Models 并下载一个语音模型。装好一个模型之前，App 无法听写。
- 操作: 打开 YapToText，进入 AI Models 页面，下载 Whisper Large v3 Turbo (Q5)，574 MB。如果想用 Auto mode、Quick Edit 或其他会整理文字的模式，再加上 Phi-3.5 Mini Instruct，2.3 GB。
- YapToText: 通过 HTTPS 从 Hugging Face 获取文件，保存在它自己的容器里，更新后文件仍然保留。这次下载是 App 发起的唯一网络流量，而且只在你点按之后才会发生。
- 确认: 模型显示为已安装，试着听写一次，文字能输入出来。在那之前，听写会提示没有安装语音模型。
Raw Transcription 只需要语音模型。其他所有内置模式、Auto mode 的格式整理和 Quick Edit 还会用到整理模型。AI Models 帮助页面说明了模型库里的每个模型。
还有两点要知道。这个 cask 会把 YapToText 安装到 /Applications，所以如果那里已经有 App Store 的副本，就会被替换，请只选一种安装方式。模型不放进这个版本，原因很简单：带上模型的话，App 会超过 GitHub 对发布文件 2 GB 的限制，不带的话，解压后只有约 18 MB。
授予两项权限
第一次打开时，App 会带你依次完成两项权限，Home 页面上的 Get set up 卡片随时可以再次显示它们。麦克风权限是必需的。辅助功能权限让 YapToText 能在其他 App 里输入文字。没有它，每次听写仍然会被转写，但文字会拷贝到剪贴板，而不是输入出来。
第 1 步：让它听到你
- 操作: 在 Get set up 卡片里按麦克风旁边的 Continue，或者直接开始第一次听写。
- macOS: 询问一次是否允许 YapToText 使用麦克风。请选择允许。
- 确认: 麦克风那一行出现绿色对勾。如果你不小心拒绝了，请在“系统设置”，“隐私与安全”，“麦克风”里打开 YapToText。
第 2 步：让它替你输入
- 操作: 在同一张卡片里按辅助功能旁边的 Grant。
- macOS: 打开“系统设置”，“隐私与安全”，“辅助功能”。App 无法自己打开这项权限，所以要你自己拨动 YapToText 旁边的开关。
- 确认: 几秒钟之内，Get set up 卡片就会从 Home 页面消失，因为两项权限都已打开。如果开关一直打不开，请按 Show in Finder，把 App 拖进列表，然后按 Recheck。
辅助功能权限还用于 Right Command 键，以及读取你选中的文字。备用快捷键 Control Option Space 不需要这项权限。
完成第一次听写
第一次听写只要一个键，按两次。点按文字要出现的位置，轻按 Right Command，说话，再轻按一次。文字会出现在原来光标所在的位置。说话期间，空格键暂停，Esc 键取消，数字键用来选模式。
第一次听写指南有分步骤的版本，写明了每一步你会看到什么，按键和快捷键页面则说明怎样改成按住说话，或者换一个别的键。
如果什么都没有输入
- 先点按进目标 App。 YapToText 从不向自己的窗口里输入文字，所以在它位于最前面时开始的听写会进入剪贴板。按 Command V 粘贴。
- 打开辅助功能权限。 在“系统设置”，“隐私与安全”，“辅助功能”里，打开 YapToText 的开关。没有它，每次听写都会拷贝到剪贴板，而不是输入出来，Right Command 键也没有任何作用。
- 下载一个语音模型。 在 Homebrew 版本上，要先在 AI Models 页面安装 Whisper Large v3 Turbo (Q5) 或其他语音模型，才能转写。
- 检查麦克风。 如果面板提示没有听清，说明 App 听到的是静音。请在 Settings，General，Microphone 里选择你的麦克风，并在说话时看实时音量条。
故障排查页面讲得更深入，帮助索引列出了每一篇指南。如果出问题的是 Apple 自带的听写，请先看 Mac 听写没反应。
更新、删除，或者自己编译
App Store 版本通过 Mac App Store 更新。Homebrew 版本用一条命令更新。
Terminal：把 Homebrew 版本更新到我的 tap 里的最新版本。
brew upgrade --cask yaptotext会发生什么：Homebrew 用 cask 的最新版本替换 App。你的设置、历史记录和已下载的模型都会保留，因为它们存放在 App 自己的容器里。
第一个 Homebrew 版本 1.3.1 无法使用麦克风。1.4 修复了这个问题，所以如果你很早就安装了，请升级。
想把 Homebrew 版本连同它保存的内容一起删除，请使用 zap 选项。
Terminal：卸载 YapToText 及其数据。
brew uninstall --zap --cask yaptotext会发生什么：Homebrew 删除 App，并把它的容器和支持文件夹移到Trash，你的设置、历史记录、保存的音频和下载的模型也会一起带走。
对于 App Store 版本，Settings，Advanced 里的 Erase All Data 会删除你的设置、模式、词典、命令、AI 动作、历史记录和保存的音频，然后回到欢迎界面重新启动。之后，把 App 移到Trash。
从源代码编译
整个 App 都在 GitHub 上，采用 GPL-3.0 许可证。你需要 Xcode 26 或更高版本。克隆项目，打开 YapToText.xcodeproj，选择 YapToText 这个 scheme，按 Command R。它是沙盒应用，编译出来的就是上架的样子。GitHub 上的源代码可能比 App Store 版本晚一个版本。What's new 列出了两个版本。
简短总结
- 大多数人。 从 Mac App Store 安装。两个模型都在里面，所以第一次打开就能离线使用。
- Homebrew 用户。 运行那一条命令，然后在听写之前，先在 AI Models 页面下载 Whisper Large v3 Turbo (Q5)。
- 所有人。 授予麦克风和辅助功能权限，点按文字要出现的位置，轻按两次 Right Command。
- 价格。 免费。“免费”是什么意思，价格页面里有说明。
- 还在选。 对比页面把它和其他 Mac 听写 App 放在一起比较。
安装，授予两项权限，轻按 Right Command，说话。如果这里写的和你看到的不一样，请在 GitHub 上告诉我。每一条我都会看。
免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
指南
更多指南（英文）
资料来源
- https://apps.apple.com/us/app/yaptotext/id6786382289 (查阅于 2026年10月3日)
- https://github.com/ryleighnewman/YapToText (查阅于 2026年10月3日)
常见问题
Homebrew 版本的 YapToText 和 App Store 版本一样吗？
基本一样。两者由同一份源代码编译，但 Homebrew 版本用 Developer ID 签名并经过公证，不含语音和整理模型，而且可能比 App Store 版本晚一个版本。
用 Homebrew 安装 YapToText 之后，应该下载哪个模型？
Whisper Large v3 Turbo (Q5)，推荐的语音模型，574 MB。Raw Transcription 只需要它。如果想用 Auto mode、Quick Edit 和其他会整理文字的模式，再加上 Phi-3.5 Mini Instruct，约 2.3 GB。
YapToText 需要联网吗？
App Store 版本不需要。两个模型都在 App 里，所以第一次打开就能离线使用。Homebrew 版本需要联网一次，用来下载你自己发起的模型。
App Store 版本和 Homebrew 版本可以同时安装吗？
不可以。Homebrew 的 cask 会把 YapToText 安装到 /Applications，并替换那里已有的 App Store 副本。请只选一种安装方式。
怎样更新 YapToText？
App Store 版本通过 Mac App Store 更新。Homebrew 版本用 brew upgrade --cask yaptotext 更新。App 自己从不检查更新。