聽寫模式:同樣的話,依去向整理成合適的樣子
作者 Ryleigh Newman · 發佈於
聽寫模式決定 Whisper 在你的 Mac 上聽完你的話之後,YapToText 要怎麼處理:Raw Transcription 完全照原樣輸入,Clean Up、Note、Email、Message 和 Code Comment 則會依該類文字改寫,同時保留你的用詞。Auto 模式預設是開啟的,每次都會替你挑一個。
這些模式都在 Modes 頁面。每一個都可以編輯,內建的也一樣。你可以用平常的句子寫出自己的模式,每個 App 也都可以有自己的模式。一切都在你的 Mac 上執行,所以模式不會把你的話傳到任何地方。
免費下載。不需要帳號,沒有鎖住的功能。需要搭載 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, 简体中文
每個模式做什麼
App 內建六個模式,另外還有 Auto:
- Auto。 讀取每一次聽寫,自己決定怎麼處理。它有專屬的指南:Auto 模式。
- Raw Transcription。 快速、逐字的語音轉文字,只有基本標點,不用 AI。只要 Auto 關閉,它就是選取的模式,直到你選別的為止。
- Clean Up。 去掉口頭禪和說到一半重來的部分,修正文法、大小寫和標點,也會修正麥克風明顯聽錯的字。它會保留你的用詞、語氣和口吻,直率或粗話也一樣,不會刪除、縮短或摘要任何一句話,會把口說的網址和電子郵件地址寫成正確的格式,並把口說的數字轉成阿拉伯數字,不會自己加單位。App 把它稱為建議的預設值。
- Note。 簡短的標題和項目符號,待辦事項會整理成一份列表,不會加入你沒說過的東西。
- Email。 輸出郵件內文,絕不會有主旨行。只有你說出某人的名字時才會加問候語,署名用的是 Settings、Advanced、Your name 裡的名字,絕不會用 [Your Name] 這類預留文字。
- Message。 為聊天做輕量整理:去掉口頭禪,修正明顯的文法錯誤,保留隨意的語氣。
- Code Comment。 為程式碼註解和 commit 訊息寫出簡潔的技術用語,識別字和大小寫完全照你說的保留,不加引號,也不加程式碼區塊標記。
除了 Raw Transcription,每個模式都會用自己的指示,把逐字稿交給整理模型,預設是 Phi-3.5 Mini Instruct。如果結果讀起來像助理的回覆,比你說的內容長很多,或重複了參考文字,App 就會丟掉它,改為輸入原始逐字稿。Raw Transcription 完全不碰 AI 模型。其他每個模式都保留你的話,只修正其餘部分。

選一個模式,或在途中切換
選模式有四種方法:
- 從選單列。 按一下水豚,使用 Mode 選單。在那裡選一個模式會關閉 Auto,而 Auto 會從選單中消失,直到你在 Home 頁面或 Modes 頁面的 Auto 列把它重新開啟。
- 說話的時候。 按 1 到 9,或按一下展開面板上的模式標籤。Auto 開啟時,這個選擇只用於這一次聽寫。Auto 關閉時,它會成為你選取的模式。
- 從 Modes 頁面。 在模式上按右鍵,選擇 Use This Mode。目前使用的模式會有 Current 標籤。
- 用快速鍵。 Settings、General、Shortcuts 裡的 Cycle mode 會依序走過列表,任何模式也都可以有自己的 Activation shortcut,用該模式開始聽寫。

數字依 Modes 列表的順序排列,所以把模式往上或往下拖,它的數字也跟著變。關閉 Show in the quick switcher 的模式沒有數字。模式上的數字,就是選它的按鍵。所有按鍵都列在 YapToText 的按鍵裡。
編輯模式,或建立自己的
在 Modes 頁面按一下任何模式,就能打開它的編輯器。卡片有 Basics(名稱、圖示、說明、Show in the quick switcher、Activation shortcut)、Apps that use this mode、帶有 On battery 選項的 Speech model、Recording & language、AI cleanup、Dictionaries、Where the text goes 和 Try it out。

步驟 1:從接近的模式開始
- 操作: 在模式上按右鍵,選擇 Duplicate,或按加號按鈕,再選 New Mode。
- YapToText: 打開新模式的編輯器。
- 確認: 新模式出現在 Modes 頁面的列表裡。
步驟 2:寫下它的指示
- 操作: 在 AI cleanup 卡片裡,保持 Rewrite the transcript with AI 開啟,在 Instructions 方塊裡寫下你要的內容,或按一個 Start from 按鈕,從內建模式的指示開始。
- YapToText: 邊打字邊儲存。這個模式下的每一次聽寫,整理模型都會照這些指示做。
- 確認: 指示裡除了要改什麼,也寫了要保留什麼。
模式指示: 聊天 App 裡簡短回覆的範例。
把我的聽寫整理成簡短、親切的回覆。保留我的用詞和我的意思。不要加入我沒說過的內容。結果: 整理模型會在你的 Mac 上,把這個模式下的每一次聽寫往這個方向改寫。
步驟 3:試用
- 操作: 在 Try it out 卡片裡輸入一段範例,按 Preview with AI。
- YapToText: 對這段範例執行該模式,不需要聽寫。
- 確認: Result 讀起來是你想要的樣子。如果不是,就編輯指示再預覽一次。
在 AI cleanup 底下,你也可以選 Cleanup model,三個開關則決定模型可以看到哪些上下文。內建模式的右鍵選單有 Reset to Default,Restore Built-in Modes 在加號按鈕底下,Undo 按鈕可以退回上一次的模式更改。Export Mode 和 Import Mode 以檔案的形式移動模式。模式只是你能讀、也能改寫的指示。
讓 App 有自己的模式
任何 App 都可以有自己的模式,這樣在那個 App 裡聽寫就會自動使用它,不用你去選。把 Mail 設為 Email,把 Messages 設為 Message,把你的編輯器設為 Code Comment。
- 操作: 在模式的編輯器裡,於 Apps that use this mode 底下按 Add app,選一個正在執行的 App,其他的 App 則用 Choose App。Settings、Advanced、Per-app modes 編輯的是同一份列表。
- YapToText: 開始聽寫時,只要那個 App 在最前面,就切換到該模式。這不需要輔助使用權限。
- 確認: Auto 模式關閉時,在那個 App 裡的聽寫,會依它的模式整理後輸出。
Auto 模式開啟時,由 Auto 決定每次聽寫怎麼寫,所以各 App 的模式只有在 Auto 關閉時才會影響文字。如果你會在很多 App 裡聽寫,在 Mac 上對任何 App 聽寫的指南會一個 App 一個 App 說明。
對已有的文字執行模式
有三個地方可以對已經寫好的文字執行模式:
- 選單列的 Regenerate。 按一下水豚,再選 Regenerate:Redo it as 會用任何模式重跑你上一次的聽寫,Rewrite it as 會用任何模式改寫你選取的文字,單次編輯則套用一個 AI action。
- History。 每筆紀錄都保留原始逐字稿,所以 Regenerate with AI 可以用不同的模式重跑舊的聽寫。細節請見 History 指南。
- Utility。 Transform text 卡片接受貼上的文字,並用任何模式重新整理格式,例如把筆記變成郵件。該頁面的其他部分請見 Utility 指南。

改寫選取的文字需要輔助使用權限,也就是讓 App 能夠輸入文字的同一項權限。模式可以用在任何文字上,包括你上星期聽寫的內容。
限制
- 需要整理模型。 除了 Raw Transcription,每個模式都需要。Homebrew 版本不內附模型,所以在使用 AI 模式之前,請先在 AI Models 頁面下載 Phi-3.5 Mini Instruct,大小 2.3 GB。
- Post-transcription analysis。 Home 頁面上的這個總開關關閉時,任何模式都不會執行:每一次聽寫都完全照說的內容輸入,Modes 頁面也會這樣告訴你。
- 小型模型。 整理模型在你的 Mac 上執行,所以在依賴新模式之前,先在 Try it out 預覽。
- 聽寫途中切換。 新模式的整理會套用到正在進行的聽寫,但它的語音模型和語言要從下一次才生效。
- 只有九個數字。 數字鍵只能選到切換器裡的前九個模式。
模式做了奇怪的事時
- 看是哪個模式執行的。 在 History 裡,按一下那次聽寫的 Show pipeline details。Mode 那一行會寫出模式名稱,Auto detected 則說明 Auto 選了什麼。
- 檢查總開關。 在 Home 頁面的 After transcription 卡片裡,Post-transcription analysis 必須是開啟的。
- 預覽同樣的話。 把你說的內容貼到模式編輯器的 Try it out 裡,比較結果。
- 修改指示。 除了要改什麼,也寫出要保留什麼,或對內建模式使用 Reset to Default。
- 換一個模型。 在模式的編輯器裡選不同的 Cleanup model,或這類文字改用 Raw Transcription。
- 告訴我。 提交一個 GitHub issue,寫上模式、你說的內容和輸出的結果。
重點整理
- Raw Transcription。 完全照你說的輸入,不用 AI。
- Clean Up 和其他模式。 把你的話整理成適合郵件、筆記、聊天或程式註解的樣子。
- Auto。 預設開啟,替你挑選。
依文字的去向選模式,或讓 Auto 去選。如果你是從 superwhisper 換過來,superwhisper 替代方案頁面比較了兩者。如果某個模式的表現讓你意外,請在 GitHub 上提交 issue。每一則我都會看。
免費下載。不需要帳號,沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。
指南
更多指南(英文)
常見問題
我該用 YapToText 的哪個模式?
預設開啟的 Auto 會替你挑選。如果你自己選,Clean Up 會去掉語助詞並修正文法,不改變你的意思,Raw Transcription 則完全照你說的輸入。
Raw Transcription 會用 AI 嗎?
不會。它是快速、逐字的語音轉文字,只有基本標點:Whisper 聽你說話,沒有任何東西改寫這些字。
可以建立自己的聽寫模式嗎?
可以。複製一個接近的模式,或在 Modes 頁面的加號按鈕底下選 New Mode,然後用平常的句子寫下指示,並在 Try it out 裡測試。
為什麼 Email 模式不寫主旨行?
它的指示只寫郵件內文。每個內建模式都可以編輯,所以你可以改掉這一點。
每個 App 可以用不同的模式嗎?
可以。在模式的編輯器裡把 App 加到 Apps that use this mode 底下,或到 Settings、Advanced、Per-app modes 設定。Auto 模式開啟時,則由 Auto 決定怎麼寫。
模式會把我的文字傳到別的地方嗎?
不會。語音模型和整理模型都在你的 Mac 上執行,你的話和指示都留在那裡。