第一次配置
假設你已完成 安裝與權限。下面把「能打開 App」變成「任意文本框裡能語音輸入」。虛線框為截圖佔位，實拍請覆蓋 public/screenshots/setup-*.svg。
| 步驟 | 在哪裡 | 目的 |
|---|---|---|
| 1 | 菜單欄 → 設置 | 打開主界面 |
| 2 | 通用 | 關閉演示模式（正式聽寫） |
| 3 | 聽寫模型 | 選引擎並（如需）填 Key |
| 4 | 熱鍵 | 確認聽寫 ⌃⌥Space、命令 ⌥Space（可改） |
| 5 | 文本後處理 | 間距 / 段落 / 潤色（可先默認） |
| 6 | 備忘錄等 | 端到端試一次 |
1. 打開設置
Section titled “1. 打開設置”- 點擊屏幕右上角 VoiceHotkey 菜單欄圖標。
- 選擇 設置（Settings）。
- 左側按分組瀏覽：
- 應用：通用、關於、許可證
- 語音：熱鍵、聽寫模型、文本後處理、語音命令
- 工具：轉錄文件、歷史記錄
setup-01-settings.svg）2. 演示模式
Section titled “2. 演示模式”演示模式 不訪問麥克風，用固定演示文本幫你熟悉流程。正式聽寫前請關閉。
- 打開 設置 → 通用。
- 找到 演示模式 開關。
- 正式聽寫：關閉演示模式。
- 關閉後，菜單欄狀態應不再顯示「演示 · 不使用麥克風」一類文案；若提示缺麥克風或未配置引擎，按提示繼續下面步驟。
setup-02-demo.svg）3. 選擇聽寫模型
Section titled “3. 選擇聽寫模型”- 打開 設置 → 聽寫模型。
- 在目錄中點選一個引擎，例如：
- Apple（本機，適合先跑通；macOS 26+ 可用新 SpeechAnalyzer）
- 豆包 等（Free 可用範圍見 方案對比）
- Whisper / Groq / Soniox / NVIDIA…（試用或 Pro 多引擎）
- 雲端引擎：在引擎設置裡粘貼 API Key。
- 密鑰寫入 macOS 鑰匙串，不會發到 VoiceHotkey 自有服務器。
- 按需填寫：模型名、語言、區域、上下文詞表等（各引擎字段不同）。
- 確認頁面上沒有「未配置 / 缺 Key」類錯誤提示。
setup-03-models.svg）4. 確認熱鍵
Section titled “4. 確認熱鍵”- 打開 設置 → 熱鍵。
- 找到 語音輸入（Voice typing）綁定，默認為
⌃⌥Space（Control + Option + 空格）；語音命令 預設⌥Space。 - 瞭解觸發方式：
- 短按：開始錄音 → 再短按結束
- 長按：按住說話，鬆開結束
- 若與系統或其它軟件衝突：點錄入區，按下新的組合鍵保存。
- （可選）為 語音命令、語音翻譯 綁定獨立熱鍵，初次可先不配。
- 若頁頂提示需要輔助功能，先回到 安裝與權限 完成授權。
setup-04-hotkeys.svg）錄音中的 快速發送、Esc 取消、音效等通常在 通用；詳見 熱鍵與錄音。
5. 文本後處理（可先默認）
Section titled “5. 文本後處理（可先默認）”第一次跑通不必改太多。打開 設置 → 文本後處理 瞭解即可：
| 選項 | 建議 |
|---|---|
| 去除末尾句號 | 聊天場景可開 |
| 智能間距 / 智能段落 | 默認開通常更好 |
| 詞替換 | 有固定錯詞再加 |
| 大模型潤色 | 需另配 LLM Key；可後開 |
| 輸出動作 | 默認「插入到光標」 |
| 語音翻譯 | 需獨立熱鍵與模型 |
setup-05-postprocess.svg）6. 端到端試一次
Section titled “6. 端到端試一次”- 打開 備忘錄、TextEdit 或任意可輸入文本框，點擊輸入區 讓光標閃爍。
- 按你的 語音輸入熱鍵 開始錄音（應出現錄音浮層 / 菜單欄狀態變化）。
- 說一兩句簡單的話（例如：「測試 VoiceHotkey 聽寫。」）。
- 短按結束 或 鬆開長按。
- 等待識別（及可選潤色）結束，文字應出現在光標處。
- 可選：打開 歷史記錄，確認剛產生一條記錄。
setup-06-try.svg）- 有錄音反饋（浮層或狀態）
- 鬆手後出現文字（非空白、非一直轉圈）
- 文字落在 剛才聚焦的 輸入框
| 現象 | 去向 |
|---|---|
| 熱鍵完全沒反應 | 故障排查 · 熱鍵 |
| 有錄音無文字 | 故障排查 · 無文字 |
| 權限反覆丟 | 故障排查 · 權限 |
配置完成後可做
Section titled “配置完成後可做”詞替換修正品牌名、口頭禪與固定錯詞。
僅本地模式阻斷外網，配合本機引擎。
語音命令口令觸發快捷鍵（可選）。