使用文件 / 疑難排解

錄音後沒有文字

從 HUD、歷史記錄與錄音留底回推失敗在哪一步,依序檢查麥克風、音量門檻、轉錄與貼上。

最後更新

先把症狀分類

「沒有文字」其實是好幾種不同的失敗。先確認你遇到哪一種,再往下查:

症狀 通常卡在哪一步
按住錄音鍵完全沒反應,HUD 沒出現 快捷鍵沒收到,或 ZeroType 沒在跑
HUD 有波形,放開後什麼都沒貼上 音訊被忽略、轉錄空結果,或貼上失敗
HUD 跑完,貼上的內容只有一部分 貼上時序或焦點問題
有錯誤通知,或歷史記錄出現「轉錄失敗」 provider 連線或金鑰問題
歷史記錄完全沒有這一筆 錄音在建立留底前就被忽略(太短或太小聲)

依序檢查

1. ZeroType 還在跑嗎

  • Windows:看系統匣有沒有 ZeroType 圖示。圖示不在,快捷鍵也不會運作。
  • macOS:看選單列。選單列空間不夠時圖示會被擠掉,切到選單較短的 App(例如 Finder)就看得到。

2. 麥克風權限

macOS 沒給麥克風權限,錄音根本收不到音;Windows 則要確認系統設定裡「允許桌面應用程式存取您的麥克風」是開的。完整步驟見 權限與安裝被攔截。

3. 錄音鍵真的被收到了嗎

  • 短錄音是按住說話、放開結束;長錄音快捷鍵是按一下開始,再按一下結束。按錯方式會看起來像沒反應。
  • 有些工具會佔用同一個鍵(例如 Right Alt、Right Option 被其他 App 當成快捷鍵),換一個鍵測一次就知道。
  • macOS 若在背景收不到快捷鍵,通常是輸入監控權限。

4. 游標在可以輸入文字的位置嗎

ZeroType 是把文字送進「目前有焦點的地方」。如果焦點在桌面、在圖片上、在沒有輸入框的視窗,文字就沒有地方去。

先開一個純文字編輯器(記事本、TextEdit)測一次,這是排除法最快的一步。

5. 錄音是不是太短或太小聲

ZeroType 在送出轉錄前會先判斷音訊夠不夠:

情況 預設行為
去掉前後靜音後短於 0.15 秒 直接忽略,不送轉錄
短於 0.5 秒,且音量很低(增益前 peak ≤ 800 且 RMS ≤ 0.006) 忽略,不送轉錄
0.15 到 0.5 秒之間但講得夠清楚 正常送出

被忽略的錄音不會建立錄音資料夾,也不會出現在歷史記錄。所以「歷史記錄完全沒有這一筆」通常就是這個原因。

HUD 的波形只反映麥克風收到的音量大小,用來給你看有沒有在收音,不代表內容夠清楚。波形有跳動但仍然沒有文字時,先講長一點、離麥克風近一點再測。

這幾個門檻可以在 appsettings.Local.json 的 Audio 區塊調整(MinimumTranscriptionDurationSeconds、ShortLowVolumeDurationSeconds、LowVolumeInputPeakThreshold、LowVolumeInputRmsThreshold),目前沒有放進偏好設定畫面。

6. 轉錄回來是空的嗎

有時候音訊送了、provider 也回 200,但轉錄結果是空字串。這代表模型沒聽到可辨識的語音,屬於正常結果,不會進入 AI 校正,也不會有輸出。

這種情況歷史記錄看不到(歷史只列有輸出文字的紀錄),但錄音資料夾裡會有內容空白的 transcription_text.txt,沒有後續的校正與輸出檔案。

7. 是不是被你的替換規則吃掉了

如果你設定了 Transcription 階段的字串或 Regex 規則,而規則把文字刪成空字串,ZeroType 就不會呼叫 AI 校正,也不會有輸出。錄音留底的 transcription_text.txt 有內容、transcription_processed_text.txt 是空的,就是這個情況。

8. provider 或 AI 校正出錯

  • 轉錄失敗(金鑰、網路、端點錯誤):錄音會留下來,歷史記錄顯示「轉錄失敗」,可以直接用「重新轉錄」把文字取回來。
  • 轉錄成功但 AI 校正失敗:ZeroType 會用處理後的轉錄文字當備援輸出,通常還是會有文字,只是沒有經過改寫。

金鑰相關的判讀見 金鑰錯誤。

9. 貼上這一步失敗

文字產生了但沒進到 App,通常是焦點或剪貼簿問題:

  • 錄音期間切換視窗,放開後貼到別的視窗。
  • 剪貼簿被其他程式(同步工具、密碼管理器)改寫,ZeroType 跳過還原或貼上被攔。
  • Word、Outlook 這類 App 對貼上的處理和其他 App 不同,偶爾需要改用模擬鍵盤模式。做法見 輸出模式。

這種情況歷史記錄會有那筆文字,標示輸入失敗,你還是可以從歷史記錄複製。

從歷史記錄回推

打開歷史記錄(Windows 系統匣按 H,macOS 選單列按 ⌘H),看最近幾筆的狀態:

  • 有文字、狀態正常:問題只在貼上,檢查焦點。
  • 有文字、標示輸入失敗:同上,先複製文字救回來。
  • 標示轉錄失敗:重新轉錄。
  • 標示已取消:處理中你又按了錄音鍵。
  • 完全沒有這筆:回去看第 5 點,錄音被忽略了。

還是沒解決時要提供什麼資訊

請提供這幾項,足以判斷卡在哪一步:

  1. 平台與版本(Windows 或 macOS,版本號可在偏好設定或關於畫面看到)。
  2. 發生時間,以及當時使用的提示詞名稱。
  3. 症狀屬於上面哪一類,有沒有錯誤通知文字。
  4. 歷史記錄裡那一筆的狀態。
  5. 該筆錄音資料夾的 recording_summary.json(看 inputPeak、inputRms、trimmedSampleCount)與 foreground_injection_diagnostics.json。

資料位置與怎麼安全地提供見 診斷資料與 log。不要把整包錄音資料夾直接貼到公開的地方。

這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。