第一次配置

假設你已完成 安裝與權限。下面把「能打開 App」變成「任意文本框裡能語音輸入」。下圖由宣傳頁設定介面複刻自動擷取（public/screenshots/setup-*.webp）；安裝頁系統截圖仍可能為佔位。

總覽

步驟	在哪裡	目的
1	選單列 → 設定	打開主介面
2	通用	關閉示範模式（正式語音輸入）
3	輸入模型	選引擎並（如需）填 Key
4	快捷鍵	確認語音輸入 ⌃⌥Space、命令 ⌃⌥C（可改）
5	文字處理	間距 / 段落 / 潤色（可先預設）
6	備忘錄等	端到端試一次

1. 打開設定

1. 點按螢幕右上角 VoiceHotkey 選單列圖標。
2. 選擇 設定（Settings）。
3. 左側按分組瀏覽：
   • 應用：通用、關於、許可證
   • 語音：快捷鍵、輸入模型、文字處理、語音命令
   • 工具：檔案轉寫、歷史記錄

圖 1 · 設定視窗（UI 複刻 · setup-01-settings.webp）

Deeplink

也可在瀏覽器或啟動器中打開：voicehotkey://tab/settings。更多見 Deeplinks。

2. 示範模式

示範模式 不訪問麥克風，用固定示範文本幫你熟悉流程。正式語音輸入前請關閉。

1. 打開 設定 → 通用。
2. 找到 示範模式 開關。
3. 正式語音輸入：關閉示範模式。
4. 關閉後，選單列狀態應不再顯示「示範 · 不使用麥克風」一類文案；若提示缺麥克風或未配置引擎，按提示繼續下面步驟。

圖 2 · 通用 · 示範模式（UI 複刻 · setup-02-demo.webp）

何時保留示範模式

僅想點按介面、試選單、不錄音時保持開啟。試檔案轉寫時，示範模式也可能不實際上傳檔案。

3. 選擇輸入模型

1. 打開 設定 → 輸入模型。
2. 在目錄中點選一個引擎，例如：
   • Apple（本機，適合先跑通；macOS 26+ 可用新 SpeechAnalyzer）
   • 豆包 等（Free 可用範圍見 方案對比）
   • 百鍊 / MiMo / OpenAI Speech / Groq / Soniox / NVIDIA…（試用或 Pro 多引擎）
3. 雲端引擎：在引擎設定裡貼上 API Key。
   • 密鑰寫入 macOS 鑰匙串，不會發到 VoiceHotkey 自有伺服器。
4. 按需填寫：模型名、語言、區域、上下文詞表等（各引擎字段不同）。
5. 確認頁面上沒有「未配置 / 缺 Key」類錯誤提示。

圖 3 · 輸入模型（UI 複刻 · setup-03-models.webp）

只想最快成功

先選 Apple 本機 或已有 Key 的單一雲引擎，不要一次配齊所有提供商。引擎細節見 選擇輸入模型。

僅本機模式

若已開啟 僅本機模式，公網雲引擎會失敗。請改用 Apple、四個內建本機引擎（SenseVoice / Whisper Turbo / Fun-ASR-Nano / Parakeet），或 localhost 自建服務，或暫時關閉僅本機模式。

4. 確認快捷鍵

1. 打開 設定 → 快捷鍵。
2. 找到 語音輸入（Voice typing）綁定，預設為 ⌃⌥Space（Control + Option + 空格）；語音命令 預設 ⌃⌥C。
3. 瞭解觸發方式：
   • 短按：開始錄音 → 再短按結束
   • 長按：按住說話，鬆開結束
4. 若與系統或其它軟體衝突：點錄入區，按下新的組合鍵儲存。
5. （可選）為 語音命令、語音翻譯、直接語音輸入（跳過潤色，預設未綁定）綁定獨立熱鍵，初次可先不配。
6. 若頁頂提示需要輔助功能，先回到 安裝與權限 完成授權。

圖 4 · 快捷鍵（UI 複刻 · setup-04-hotkeys.webp）

錄音中的 快速發送、Esc 取消、音效等通常在 通用；詳見 快捷鍵與錄音。

5. 文字處理（可先預設）

第一次跑通不必改太多。打開 設定 → 文字處理 瞭解即可：

選項	建議
去除末尾句號	聊天場景可開
智慧間距 / 智慧段落	預設開通常更好
詞替換	有固定錯詞再加
大模型潤色	需另配 LLM Key；可後開
輸出動作	預設「插入到游標」
語音翻譯	需獨立熱鍵與模型

圖 5 · 文字處理（UI 複刻 · setup-05-postprocess.webp）

6. 端到端試一次

1. 打開 備忘錄、TextEdit 或任意可輸入文本框，點按輸入區 讓游標閃爍。
2. 按你的 語音輸入熱鍵 開始錄音（應出現錄音浮層 / 選單列狀態變化）。
3. 說一兩句簡單的話（例如：「測試 VoiceHotkey 語音輸入。」）。
4. 短按結束 或 鬆開長按。
5. 等待識別（及可選潤色）結束，文字應出現在游標處。
6. 可選：打開 歷史記錄，確認剛產生一條記錄。

圖 6 · 試語音輸入（UI 複刻 · setup-06-try.webp）

成功標準

• 有錄音反饋（浮層或狀態）
• 鬆手後出現文字（非空白、非一直轉圈）
• 文字落在 剛才聚焦的 輸入框

失敗時看哪

現象	去向
熱鍵完全沒反應	故障排查 · 熱鍵
有錄音無文字	故障排查 · 無文字
權限反覆丟	故障排查 · 權限

配置完成後可做

詞替換修正品牌名、口頭禪與固定錯詞。

僅本機模式阻斷外網，配合本機引擎。

語音命令指令觸發快捷鍵（可選）。