IPHONE
undervoice for iPhone
在 iPhone 打開 App Store，下載並安裝 undervoice。首次打開時，依引導允許相機、麥克風和區域網路。
需要 iOS 18 或更新版本在 App Store 下載01 / 下載兩端 APP
iPhone 負責近距離收音，Mac 負責辨識和輸入。
兩端都需要安裝。建議先準備 Mac，再打開 iPhone 版掃描。
MACOS
undervoice for Mac
從本站下載 DMG。打開後把 undervoice 拖到「應用程式」，再從「應用程式」資料夾開啟。
需要 macOS 14 或更新版本下載 Mac 版02 / 準備 MAC
第一次打開 Mac 版，完成這四件事。
語音辨識在 Mac 上執行，所以需要先準備模型和寫入文字的系統權限。
- 01
打開 undervoice
從「應用程式」啟動。關閉主視窗後，Mac 版仍會留在選單列繼續執行。
- 02
下載語言包
打開「設定」，選擇聽寫語言，確認並下載語言包。等狀態顯示準備完成後再繼續。
- 03
允許所需權限
允許區域網路和輔助使用。輔助使用只用來把結果寫入目前輸入框；只有使用 Mac 麥克風時才需要麥克風權限。
- 04
顯示配對碼
在左側選擇「裝置」。頁面會顯示供 iPhone 掃描的 QR code。
03 / 掃描配對
Mac 顯示 QR code，iPhone 來掃描。
首次配對時，兩台裝置使用同一個 Wi‑Fi 最簡單。
在 MAC 上
打開「裝置」
讓 QR code 保持顯示。如果看到「iPhone 已配對」而沒有 QR code，需要先重設配對。
在 IPHONE 上
掃描 Mac 配對碼
使用首次設定中的掃描器；若已進入 App，請打開「設定 → Mac 配對 → 掃描 Mac QR code」。允許區域網路後，連線會自動繼續。
兩端顯示已連線，就可以開始使用。
04 / 開始輸入
游標放好，按住說話，放開完成。
不需要從另一個 App 複製文字回來。
先在 Mac 放好游標
點選 Codex、Claude Code、Xcode、Terminal、瀏覽器或其他 App 的可編輯輸入框。
把 iPhone 拿到嘴邊
距離約 5–10 公分即可。近距離收音讓你不必對著整間辦公室大聲說話。
按住「按住說話」
說話時保持按住，說完放開。加密音訊會傳到已配對的 Mac，完成辨識後把最終文字寫到目前游標。
密碼欄位和系統安全輸入不會被寫入。如果焦點已移動，undervoice 會停止寫入，避免文字落到錯誤位置。
簡單了解運作方式
手機收音，Mac 在本機轉成文字。
整個流程可以用四步理解，不需要知道網路協定或模型細節。
01
→iPhone 麥克風近距離收音
02
→音訊在 iPhone 上加密
03M
→已配對的 Mac 使用本機語音辨識模型處理
04
結果寫入目前輸入框
這不是把聲音交給聊天機器人。Mac 上的語音辨識模型只負責把聲音轉成文字；undervoice 不營運語音中繼或雲端轉寫服務，錄音也不會儲存成音訊檔案。
常見問題
如果沒有一次成功，先檢查這裡。
01Mac 上沒有 QR code
Mac 已記住一台 iPhone 時會隱藏 QR code。在「裝置」中重設配對，再掃描新碼。
02掃描後一直無法連線
確認兩端允許區域網路並先連上同一個 Wi‑Fi。企業 Wi‑Fi 可能阻擋裝置互連，可改用 iPhone 個人熱點；跨網路可設定 Tailscale。
03iPhone 提示 Mac 模型未準備好
回到 Mac 的「設定 → 語音模型」，下載並等待語言包顯示準備完成。配對辨識需要 Apple Silicon。
04能辨識，但文字沒有進入 App
確認 Mac 已給 undervoice 輔助使用權限，並把游標放在一般可編輯輸入框。授權後回到 App 再檢查一次。
仍然需要協助？
告訴我們你卡在哪一步、兩端顯示什麼狀態即可。請不要傳送配對 QR code、錄音或私人轉寫內容。