第一次配置
假设你已完成 安装与权限。下面把「能打开 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 “配置完成后可做”词替换修正品牌名、口头禅与固定错词。
仅本地模式阻断外网，配合本机引擎。
语音命令内置/用户词典与意图；设置里可自定义口令。