選單列聽寫圖示:水豚,以及牠想告訴你的事
作者 Ryleigh Newman · 發佈於
Mac 選單列上的水豚是 YapToText 的狀態燈,按一下牠就會開啟一個小面板,不必開啟視窗就能控制聽寫。從第一次開啟 App 起牠就在那裡,Home 頁面的 Icons 卡片可以把牠換成比較簡單的圖示,或是把牠隱藏。當你的手已經放在滑鼠上,或是想一眼看出 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, 简体中文

看懂每種顏色的意思
只有對話框會變色。水豚本身維持選單列自己的顏色。紅色代表正在聽,轉圈圈代表處理中,綠色代表文字已經輸入。
- 素色,沒有顏色。 閒置。圖示和選單列上的其他項目一樣,會配合淺色或深色選單列,牠每隔幾秒眨一次眼。
- 紅色,像在呼吸。 錄音中。對話框在亮紅色和深紅色之間變化,牠聽著的時候,三個圓點會跳動。
- 原本對話框的位置變成轉圈圈。 正在轉寫,或整理模型正在處理。1.4 版讓它在淺色選單列上看得見,1.3.1 版則修正了它倒著轉的問題。
- 綠色。 你的文字剛剛輸入完成。
- 橘色。 那次聽寫發生了錯誤,浮動面板會顯示哪裡出了問題。
使用面板
按一下水豚就會開啟面板。由上到下:
- Start Dictation。 作用和輕按聽寫鍵一樣,預設是 Right Command。錄音時它會變成三個圓形按鈕:取消、暫停或繼續,以及停止並輸入。App 還在處理你的話時,只剩下取消。
- Mode。 左邊的膠囊顯示目前的模式。它的選單把你的模式編為 1 到 9 號,和聽寫中可以按的數字相同,超過九個的放在 More modes 底下。Post-transcription analysis 關閉時,膠囊會變灰,因為這時模式不會有任何作用,按一下它會說明原因,並提供重新開啟分析的選項。
- Input。 右邊的膠囊選擇 YapToText 聽哪一支麥克風。System Default 會跟著 macOS,下面是 Mac 上的每一個輸入裝置。
- Transcribe file。 開啟檔案選擇器,選任何音訊或影片檔案,用目前的模式轉寫。文字會進到剪貼板和 History,而在 Insert text automatically 開啟時(這是預設值),文字會輸入到你選檔案時所在的 App。
- Regenerate。 把你最近一次的聽寫或你選取的文字,改用另一個模式重寫。下一節有詳細說明。
- Insert last。 把你最近一次的聽寫輸入到你剛才使用的 App。History 裡還沒有內容之前,它會維持灰色。
- Recent。 你最近三次的聽寫,每則兩行,旁邊各有一個拷貝按鈕。See all 會開啟 History。

最下面一列可以結束 App、開啟小費罐、開啟主視窗和開啟設定。聽寫需要的一切都只要按一下,主視窗可以一直關著。
從選單列使用 Regenerate
Regenerate 會重寫你已經有的文字。按下去之後,面板會問你要重寫什麼。Most recent dictation 會重做你的上一次聽寫,Selected text 會重寫你選取的任何文字。
- Most recent dictation。 把你的上一次聽寫改用任何有開啟 AI 整理的模式重做:口述的訊息變成郵件,雜亂的筆記變成整潔的筆記。如果原文在過去五分鐘內還顯示在畫面上,新的文字就會直接換進去。否則會放到剪貼板。History 會保存新的版本。
- Selected text。 用任何有開啟 AI 整理的模式,重寫你剛才使用的 App 中選取的內容,並把結果貼到選取範圍上。這份清單也提供你的 AI Actions 當作一次性的編輯,例如 Summarize 或 Translate to English。
Raw Transcription 不會出現,因為它沒有任何東西可以用來重寫。選好之後,面板會顯示 Regenerating as,停一下,然後淡出,好讓 App 切換回去並貼上。想用說的方式來重寫選取的內容,Quick Edit 一個鍵就能做到。
選擇圖示樣式
預設是水豚,但另外四種比較簡單的樣式也有同樣的作用。Menu bar icon 選單在 Home 頁面的 Icons 卡片,以及 Settings, General, System 裡。

- Capybara。 吉祥物,用對話框當狀態燈。
- Microphone。 標準的麥克風符號:閒置時是外框,錄音時填滿,App 處理時角落有轉圈圈。
- Mini waveform。 九根小長條,閒置時是靜止的波形,錄音時顯示你真實的聲音。它沒有轉圈圈,也沒有綠色閃光,所以你只看長條就好。
- Speech bubble。 單純的對話框,閒置時是外框,錄音時填滿。
- Minimal dot。 一個小圓點,錄音時隨著每次呼吸脹大。
面板最上面的圖示也會跟著改變,所以你按下的東西和打開的東西看起來是同一個 App。
開啟或關閉彩色狀態
選單列的彩色狀態是 Settings, General, System 裡的一個開關,預設開啟。開啟時,除了 Mini waveform 之外,每一種樣式都會隨著聽寫狀態變色:錄音時是紅色,輸入時是綠色,出錯時是橘色。關閉時,圖示在每種狀態下都維持單色,並配合選單列,轉圈圈和外框變成填滿,仍然能顯示發生了什麼事。
Mini waveform 的運作不同。彩色狀態開啟時,它的長條只在聽寫進行中亮起,使用你的自訂強調色,或你在開關下方挑選的 Visualizer 顏色,閒置時再回到單色。Match accent 會把你挑選的顏色換回去。
隱藏圖示,或在重新啟動後保留它
Home 頁面 Icons 卡片裡的 Menu bar icon 開關,會把水豚從選單列移除。其他一切照常運作:聽寫鍵仍然能開始聽寫,浮動面板仍然會出現。Dock 圖示在同一張卡片裡有自己的開關。如果兩個都隱藏了,從 Applications 資料夾再次開啟 YapToText,它的視窗就會回來。
水豚只會在 YapToText 執行時出現。想要每次重新啟動後牠都在那裡,請在 Settings, General, System 開啟 Launch YapToText at login。預設是關閉的。
限制
- Regenerate 需要整理模型。 App Store 版本裡已經內建一個。Homebrew 版本要先在 AI Models 頁面下載 Phi-3.5 Mini Instruct 或其他整理模型。
- 選取的文字需要輔助使用權限。 沒有這項權限,聽寫仍然可以用,並會拷貝到剪貼板,但 Regenerate 看不到你選取了什麼。
- 密碼欄位維持私密。 在 Secure Input 開啟時,通常代表在密碼欄位,沒有任何選取範圍能被讀取,Regenerate 也會這麼告訴你。
出了狀況時
如果水豚不見了,依序檢查這份清單:
- 開啟 YapToText。 牠只會在 App 執行時出現。
- 把圖示開回來。 在 Home 頁面的 Icons 卡片裡,開啟 Menu bar icon。
- 讓選單列騰出空間。 在有瀏海的 MacBook 上,選單列太擠時,macOS 會隱藏放不下的項目。YapToText 會試著一次把牠移到看得見的位置。移除幾個其他項目就能給牠空間。
其他看起來不對的情況:
- 模式膠囊是灰色的。 Post-transcription analysis 關閉了。按一下膠囊,App 會提供把它開回來的選項。
- Regenerate 說要先選取一些文字。 先在另一個 App 裡選取文字,再開啟面板。
- Insert last 是灰色的。 History 是空的,Settings, Advanced, History & audio 裡的 Save dictation history 關閉時就會這樣。
- 圖示從來不變色。 選單列的彩色狀態關閉了,或是你選了 Mini waveform,卻沒有自訂強調色或 Visualizer 顏色。
聽寫本身有問題的話,疑難排解頁面有逐步的說明。
簡短整理
- 看懂顏色。 紅色是錄音,轉圈圈是處理中,綠色是已輸入,橘色是錯誤。
- 按一下牠就有控制項。 Start Dictation、模式、麥克風、Transcribe file、Regenerate、Insert last,以及你最近的聽寫。
- 更換或隱藏牠。 Home 頁面的 Icons 卡片有這兩個開關。
看一眼就知道 App 在做什麼,按一下就能取得其他一切。 如果牠顯示了這一頁沒有說明的東西,請在 GitHub 上告訴我。每一則 issue 我都會看。
免費下載。不需要帳號,沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。
指南
更多指南(英文)
常見問題
為什麼水豚的對話框是紅色的?
紅色代表 YapToText 正在錄音。對話框像在呼吸,圓點會跳動,直到你停止。接著它會變成轉圈圈,等你的話轉寫完成,文字輸入後會閃一下綠色。
選單列圖示變成橘色是什麼意思?
橘色表示上一次聽寫發生了錯誤,浮動面板會顯示哪裡出了問題。疑難排解頁面說明了常見的原因。
可以把選單列圖示換成比水豚更簡單的嗎?
可以。Menu bar icon 選單位於 Home 頁面的 Icons 卡片,以及 Settings, General, System,提供 Capybara、Microphone、Mini waveform、Speech bubble 和 Minimal dot。
可以隱藏 YapToText 的選單列圖示嗎?
可以。在 Home 頁面的 Icons 卡片裡關閉 Menu bar icon 開關。沒有它,你的聽寫鍵、浮動面板和其他所有功能都照常運作。
Insert last 是做什麼的?
它會把你最近一次的聽寫輸入到你上次使用的 App。History 裡至少有一次聽寫之前,它會是灰色的。
可以從選單列用另一個模式重新產生聽寫嗎?
可以。Regenerate 提供你最近一次的聽寫,或你上一個 App 裡選取的文字,然後列出每個有開啟 AI 整理的模式。對選取的文字來說,重寫的內容會就地取代選取範圍。