superwhisper 的词汇和替换：教它认识你的词，又不让结果变差
作者 Ryleigh Newman · 发布于
superwhisper 有两个工具，用来处理它听错的词，而且两者的工作方式正好相反。Vocabulary（词汇）里的词是随音频一起发送的提示，让模型更有可能听出某个名字或术语。Replacements（替换）在文字生成之后运行，把一段字符串换成另一段，完全按你设定的来。用错了工具，或者提示给得太多，是 superwhisper 越用越差的常见原因。
我做了 YapToText，一款不同的 Mac 听写 App，所以请带着这一点来看我对 superwhisper 的说法。这里关于 superwhisper 的每一个事实，都来自它自己的文档，我在2026年10月10日读过。
免费下载。无需账号，没有锁定的功能。需要搭载 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, 繁體中文
两个工具的对比
出自 superwhisper 的文档 Vocabulary，2026年10月10日查阅。
| 词汇 | 替换 | |
|---|---|---|
| 什么时候起作用 | 转写之前，作为提示随音频一起发送 | 转写之后，作用在生成好的文字上 |
| 它做什么 | 让模型更有可能识别出某个词 | 把一段字符串换成另一段，不涉及 AI |
| 有没有保证 | 没有。它只是引导模型，效果因模型而异 | 有。不管用哪个模型，每次结果都一样 |
| 适合用来处理 | 人名、缩写、公司名、行话、其他语言的词 | 反复出现的错误、符号、邮箱地址、需要展开的短语 |
| 风险 | 列表太长会让模型混乱，还会改变标点 | 很小。匹配时不区分大小写 |
词汇列表要短
文档在这一点上说得很直接。词汇太多会让转写模型混乱，其他语言的词会降低准确率和自动语言检测的效果，而且词汇影响的是标点和格式，不只是拼写。他们的建议是列表保持简短，需要保持一致的纠正则用替换。
如果你加了很多词汇之后，superwhisper 开始多出一些词或者重复文字，讲多出词和重复文字的页面说明了这种情况。
替换是怎么工作的
- 匹配时不区分大小写。针对 todo 的替换，也会匹配 ToDo、TODO 和 Todo。
- 输出时大小写有区别。输出的文字，和你在替换里键入的完全一样。
- 一个错词，多种拼法。如果一个词被听成了好几种样子，就为每一种各加一条替换，全部指向正确的拼写。
- 与模型无关。不管是哪个语音模型转写的文字，它们的作用方式都一样。
符号和邮箱地址
语音模型是针对说话调校的，所以 at 符号或斜杠很少会输出成符号。文档为此建议了一组替换：
出自 superwhisper 的文档 Vocabulary，2026年10月10日查阅。文档里还列了 dash。
| 你说 | 得到 |
|---|---|
| at sign | @ |
| dot com | .com |
| dot net | .net |
| dot org | .org |
| hashtag | # |
| slash | / |
| underscore | _ |
左边是说英语的人会说的词（at 符号、点 com、点 net、点 org、井号标签、斜杠、下划线）。你可以按自己的说法设置短语。常用的地址，可以各加一条替换，比如把 my work email（我的工作邮箱）这样的短语变成地址。偶尔用一次的地址，就按名字、at sign、域名、dot com 的顺序说出来，剩下的交给符号替换。
在哪里找到它们
两者都在 Mac 版 App 的 Settings，Vocabulary 里，在同一个列表中。点按条目旁边的垃圾桶图标就能删除。在终端里，superwhisper 命令行工具用 superwhisper vocab 处理词汇，用 superwhisper snippets 处理替换，命令行文档说它们和 App 里的 From 与 To 配对是同一回事。
要换新 Mac 吗？词汇会和你的其他设置一起迁移，备份页面有说明，其他命令见命令行页面。
关于语言检测的一个词汇小技巧
当语言设为 Automatic（自动），而听写结果总是变成英文时，superwhisper 的文档建议在词汇列表里加一个你所用语言的短语作为提示，或者设成固定的语言。提示是通过模型起作用的，所以效果因模型而异。讲怎么更改语言的页面有具体步骤。
YapToText 怎么处理同样的事
superwhisper 的内容出自它的文档，2026年10月10日查阅。YapToText 的内容出自它自己的设置。
| superwhisper | YapToText | |
|---|---|---|
| 给语音模型的提示 | Vocabulary 里的词 | 词典里的词会提示 Whisper 模型 |
| 事后固定替换 | Replacements | 替换项，有 Whole word 和 Case 选项 |
| 多个列表 | 文档里没有说明 | 可以有多个词典，每个都能关闭而不用删除 |
| 从你的修改中学习 | 文档里没有说明 | 同一个词改两次，它会问要不要把这个更正固定下来 |
| 按任务区分 | 文档里没有说明 | 每个模式可以使用所有已启用的词典，也可以只挑几个 |
YapToText 在 Mac 上还会根据你的听写给出更正建议，最快的办法是在任何地方选中正确的拼写，按 Quick Edit 键，然后说 add this to my dictionary。词典帮助页面有详细说明，自定义词汇指南则比较了 Mac 上的各种方案。
免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
小结
- 一个它始终听不对的名字。把它加成词汇。
- 一个它总是拼错的词。加替换，每种错误拼法各一条。
- 符号和邮箱。用替换，比如 at sign 和 dot com。
- 结果变差了。精简词汇列表。
- 终端。superwhisper vocab 和 superwhisper snippets。
如果 superwhisper 改了这些功能的工作方式，请在 GitHub 上提交 issue，我会更新这个页面。每一条我都会看。
免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
指南
更多指南（英文）
资料来源
- https://superwhisper.com/docs/get-started/interface-vocabulary (查阅于 2026年10月10日)
- https://superwhisper.com/docs/get-started/cli (查阅于 2026年10月10日)
- https://superwhisper.com/docs/common-issues/language-detection (查阅于 2026年10月10日)
- https://github.com/ryleighnewman/YapToText (查阅于 2026年10月10日)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (查阅于 2026年10月10日)
常见问题
superwhisper 的词汇和替换有什么区别？
词汇是随音频一起发送的提示，帮助模型识别某个术语。替换在转写之后运行，完全按你设定的方式替换文字。
为什么我加了词汇之后，superwhisper 反而变差了？
它的文档说，词汇太多会让模型混乱，并影响标点和语言检测。列表保持简短，需要固定的更正用替换。
superwhisper 的替换区分大小写吗？
匹配时不区分，所以 todo 也会匹配 TODO。输出则使用你在替换里键入的大小写。
在 superwhisper 里怎么听写邮箱地址？
加几条替换，比如用 at sign 替换成 @，用 dot com 替换成 .com，或者把整个地址加成一条独立的替换。
可以在终端里编辑 superwhisper 的词汇吗？
可以。superwhisper 命令行工具里，vocab 管词汇，snippets 管替换。