使用文件 / 平台
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 會自動進入「首次設定精靈」,依序帶你完成:
- 是否登入時啟動。
- 麥克風、輔助使用、輸入監控三項權限。
- 選擇 AI 服務(預設 Groq)並輸入金鑰。
- 連線測試(建議完成,可明確略過)。
- 試錄一次,並確認或更換錄音快捷鍵。
輸入監控是必須完成的條件。如果是在精靈進行中才授權,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 顯示下載好的更新檔讓你手動完成。
解除安裝與權限重設
- 結束 ZeroType。
- 把「應用程式」裡的 ZeroType 移到垃圾桶。
- 設定、提示詞與歷史記錄仍留在
~/Library/Application Support/ZeroType,需要時自行刪除。
若更新後按了快捷鍵沒反應,通常是 macOS 的權限快取還指向舊版本:
- 關閉 ZeroType。
- 把新版
ZeroType.app拖到「應用程式」覆蓋舊版。 - 從「應用程式」開啟,不要直接從 DMG 視窗執行。
- 到「系統設定 → 隱私權與安全性」,把「輔助使用」與「輸入監控」裡的 ZeroType 開關關閉再打開;必要時移除後重新加入。
麥克風權限若一直顯示未授權,可在終端機執行 tccutil reset Microphone com.doggy8088.ZeroType 重置,再從「應用程式」重新開啟 ZeroType。
兩個常見狀況
- 藍牙耳機收不到聲音:到「系統設定 → 聲音 → 輸入」,把預設輸入裝置改成 MacBook 內建麥克風。
- 權限清單看不到 ZeroType:通常是同一台 Mac 上存在多份 ZeroType(DMG 掛載版、其他資料夾的舊版)。只保留「應用程式」裡的那一份,其他刪除後再開。
這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。