安裝與權限
完成安裝並正確授權後，全局熱鍵與聽寫才能穩定工作。本頁按真實安裝順序展開；虛線框圖為 截圖佔位，可用 App / 系統設置實拍替換 public/screenshots/ 下對應 SVG。
- macOS 14 或更高
- Apple Silicon 或 Intel
- 可選：聽寫 / 大模型 API Key（BYOK）
- 正式聽寫需要：麥克風 + 輔助功能
1. 下載安裝包
Section titled “1. 下載安裝包”-
打開 Releases
瀏覽器訪問
VoiceHotkey-releases · Latest。 -
下載 DMG
資源列表中選擇與當前架構匹配的.dmg（通常為通用 / 標明 macOS 的構建）。不要下載 Source code 壓縮包當作安裝包。 -
打開磁盤映像
雙擊下載好的 DMG，等待出現安裝窗口。
install-01-releases.svg）2. 安裝到固定路徑
Section titled “2. 安裝到固定路徑”-
拖入應用程序
將 VoiceHotkey.app 拖到 應用程序（Applications） 文件夾。
也可拖到用戶目錄下的應用程序：~/Applications。 -
彈出 DMG（可選）
安裝完成後可推出磁盤映像，下載的 DMG 可保留作備份。 -
記住啟動路徑
之後請 始終從同一路徑 啟動，例如：/Applications/VoiceHotkey.app- 或
~/Applications/VoiceHotkey.app
install-02-dmg.svg）
install-03-path.svg）3. 首次打開
Section titled “3. 首次打開”-
啟動 App
在 Launchpad / Finder 中打開 VoiceHotkey。若出現「無法驗證開發者」，按系統提示在 隱私與安全性 中允許打開（已公證構建通常更順暢）。 -
看菜單欄
屏幕右上角應出現麥克風樣式的菜單欄圖標。沒有圖標時：檢查是否被菜單欄摺疊，或 App 是否已退出。 -
走完引導（Onboarding）
首次啟動會彈出 快速設置（歡迎 → 權限 → 方案說明 → 完成）。
可在引導裡直接申請權限，也可稍後在系統設置中處理。
install-07-menubar.svg）
install-06-onboarding.svg）4. 授予輔助功能
Section titled “4. 授予輔助功能”輔助功能用於：全局熱鍵、把文字插入光標、注入快捷鍵。沒有它，按熱鍵通常完全沒反應。
- 打開 系統設置 → 隱私與安全性 → 輔助功能。
- 點擊列表左下角 +（或開關旁的鎖/編輯），添加 VoiceHotkey.app。
- 確認列表中的路徑是你正在運行的那個（
/Applications/...或~/Applications/...）。 - 打開開關為 開啟。
- 若列表裡有多個「VoiceHotkey」或灰色舊條目：刪掉舊項，只保留當前路徑下的一項，然後 完全退出 App 再打開。
install-04-accessibility.svg）5. 授予麥克風
Section titled “5. 授予麥克風”真實聽寫需要麥克風。演示模式下可不錄音，正式使用請授權。
- 打開 系統設置 → 隱私與安全性 → 麥克風。
- 找到 VoiceHotkey 並打開開關。
- 首次錄音時，系統也可能彈出授權對話框——請選 允許。
- 若使用外置麥 / 耳機麥，在 系統設置 → 聲音 → 輸入 中確認輸入設備正確；App 通用 頁若提供麥克風選擇，保持與系統一致或選自動。
install-05-microphone.svg）6. 權限核對清單
Section titled “6. 權限核對清單”授權完成後，在 App 內快速確認：
| 檢查項 | 期望 |
|---|---|
| 菜單欄圖標 | 可見且可點開菜單 |
| 設置 → 通用 · 權限區 | 輔助功能、麥克風均為已授權 |
| 熱鍵試按 | 出現錄音浮層 / 狀態變化（演示模式也會有反饋） |
| 安裝路徑 | 與輔助功能列表中的條目一致 |
仍異常時見 故障排查。
第一次配置關閉演示模式、選擇聽寫引擎、確認熱鍵並試打字。
熱鍵與錄音短按 / 長按、快速發送與取消。