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 sign 或 slash 很少會變成符號。文件針對這一點建議了一組取代：
來自 superwhisper 的文件 Vocabulary，2026 年 10 月 10 日讀取。文件裡還列了 dash。
| 說出 | 得到 |
|---|---|
| at sign（@ 符號） | @ |
| dot com（點 com） | .com |
| dot net（點 net） | .net |
| dot org（點 org） | .org |
| hashtag（井字號） | # |
| slash（斜線） | / |
| underscore（底線） | _ |
這些是說英語的人會說的字，你可以設定自己習慣的說法。經常用到的地址，就各加一條取代，例如把 my work email（我的工作信箱）這類片語變成完整的地址。只用一次的地址，就依序說出名稱、at sign、網域、dot com，剩下的交給符號取代。
在哪裡找到它們
兩者都在 Mac App 的 Settings（設定）、Vocabulary 裡，放在同一份清單中。按一下項目旁邊的垃圾桶圖示就能移除。在終端機裡，superwhisper CLI 用 superwhisper vocab 處理詞彙，用 superwhisper snippets 處理取代，CLI 文件說它們和 App 裡的 From 與 To 配對是同一種東西。
要換新的 Mac？詞彙會和其他設定一起搬過去，備份頁面有說明，其他指令請看 CLI 頁面。
用詞彙改善語言偵測的一個小技巧
當語言設為 Automatic（自動），而聽寫的結果一直是英文時，superwhisper 的文件建議在詞彙清單裡加入一句你所用語言的片語當作提示，或是改成固定一種語言。這個提示是透過模型起作用的，所以效果依模型而不同。更改語言的頁面有操作步驟。
YapToText 怎麼處理同樣的事
superwhisper 的部分來自它的文件，2026 年 10 月 10 日讀取。YapToText 的部分來自它自己的設定。
| superwhisper | YapToText | |
|---|---|---|
| 給語音模型的提示 | 詞彙 | 你的字典詞彙會引導 Whisper 模型 |
| 事後固定的替換 | 取代 | Substitutions，附有 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 CLI 用 vocab 處理詞彙，用 snippets 處理取代。