使用文件 / 平台

macOS 版

macOS 版 ZeroType 的選單列操作、三種權限、預設快捷鍵、Apple 裝置端轉錄與解除安裝方式。

最後更新

常駐在選單列

macOS 版是選單列 App。啟動後沒有主視窗,圖示固定在上方選單列;點一下就會展開選單,常用項目右側會直接顯示按鍵,例如 ⌘E 編輯提示詞、⌘H 歷史記錄、⌘, 偏好設定。

快捷鍵

動作 預設值
按住錄音 Right Option
長錄音 Fn + Right Option
錄音中切換提示詞 Right Option + 0–9、←、→
取消處理 處理中再按一次錄音鍵

長錄音是「按一下開始、再按一下結束」。錄音時畫面上會有半透明的波形卡片,顯示目前選到的提示詞名稱、音量波形與錄音秒數。

想換鍵的話,首次設定精靈提供 Right Option、Right Command、Caps Lock、F18 四種選項;偏好設定裡也可以按「錄製」自訂單鍵。短錄音與長錄音可以共用主鍵(例如 Right Option 與 Fn + Right Option 並存)。

細節見 快捷鍵與長錄音。

為什麼需要三種權限

權限 用途
麥克風 錄音,並把音訊送去轉錄
輔助使用 攔截鍵盤事件、模擬鍵盤輸入、把文字貼進前景 App
輸入監控 當其他 App 在前景時,仍能收到你的錄音鍵按下與放開

沒有麥克風權限,錄音會在開始前被擋下。沒有輔助使用或輸入監控,全域錄音快捷鍵不會可靠運作,Smart Paste 與模擬輸入也會失效。即使把輸入模式改成只放進剪貼簿,只要你還用全域快捷鍵錄音,這兩個權限仍然是必要的。

第一次啟動

第一次開啟 ZeroType 會自動進入「首次設定精靈」,依序帶你完成:

  1. 是否登入時啟動。
  2. 麥克風、輔助使用、輸入監控三項權限。
  3. 選擇 AI 服務(預設 Groq)並輸入金鑰。
  4. 連線測試(建議完成,可明確略過)。
  5. 試錄一次,並確認或更換錄音快捷鍵。

輸入監控是必須完成的條件。如果是在精靈進行中才授權,macOS 需要重新啟動 ZeroType 才會生效,精靈會提供重新啟動按鈕;重新開啟後會直接回到下一步,不必從頭再走一次。

完整流程見 第一次設定。

文字怎麼進到前景 App

預設使用 Smart Paste:把整理好的文字寫進系統剪貼簿,送出一次 Command + V,再把剪貼簿還原成原本的內容。Word 或終端機等不接受貼上的情境,會自動改用模擬鍵盤輸入。

檔案放在哪裡

內容 路徑
設定資料夾 ~/Library/Application Support/ZeroType
本機設定 ~/Library/Application Support/ZeroType/appsettings.Local.json
預設提示詞 ~/Library/Application Support/ZeroType/USER.md
自訂詞彙 ~/Library/Application Support/ZeroType/global_replacements.json

AI 服務金鑰存在鑰匙圈。請透過首次設定精靈或偏好設定輸入,不要把金鑰寫進設定檔、提示詞檔或 shell 啟動腳本。

Apple 裝置端轉錄

macOS 26 以上、硬體也支援的 Mac,可以在偏好設定的「模型設定」把「轉錄方式」改成「Apple 內建(裝置端)」。

  • 只取代語音轉錄這一步,AI 校正仍需要原本的 provider、模型與金鑰。
  • 不需要轉錄端點、模型或金鑰,也不需要「語音辨識」權限;麥克風權限仍然必要。
  • 第一次使用某個語系時需要下載 Apple 的語系模型(需要網路),下載後語音分析留在裝置端。
  • 不能和即時轉錄同時使用。
  • 不會默默退回雲端;選了 Apple 模式就是用 Apple 模式。

系統需求

項目 需求
作業系統 macOS 13 以上
處理器 Apple Silicon 與 Intel 皆支援
網路 需要;改用 Apple 裝置端轉錄時,轉錄階段不需要
權限 麥克風、輔助使用;部分情境需要輸入監控

自動更新

啟動後會在背景檢查新版,有新版時詢問是否更新。確認後會下載更新檔、在背景替換目前執行的 ZeroType.app,然後重新啟動。只有自動安裝不可行時,才會在 Finder 顯示下載好的更新檔讓你手動完成。

解除安裝與權限重設

  1. 結束 ZeroType。
  2. 把「應用程式」裡的 ZeroType 移到垃圾桶。
  3. 設定、提示詞與歷史記錄仍留在 ~/Library/Application Support/ZeroType,需要時自行刪除。

若更新後按了快捷鍵沒反應,通常是 macOS 的權限快取還指向舊版本:

  1. 關閉 ZeroType。
  2. 把新版 ZeroType.app 拖到「應用程式」覆蓋舊版。
  3. 從「應用程式」開啟,不要直接從 DMG 視窗執行。
  4. 到「系統設定 → 隱私權與安全性」,把「輔助使用」與「輸入監控」裡的 ZeroType 開關關閉再打開;必要時移除後重新加入。

麥克風權限若一直顯示未授權,可在終端機執行 tccutil reset Microphone com.doggy8088.ZeroType 重置,再從「應用程式」重新開啟 ZeroType。

兩個常見狀況

  • 藍牙耳機收不到聲音:到「系統設定 → 聲音 → 輸入」,把預設輸入裝置改成 MacBook 內建麥克風。
  • 權限清單看不到 ZeroType:通常是同一台 Mac 上存在多份 ZeroType(DMG 掛載版、其他資料夾的舊版)。只保留「應用程式」裡的那一份,其他刪除後再開。

其他排查見 權限問題 與 macOS 版安裝。

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