Deeplinks
VoiceHotkey 支持 URL Scheme，便于 Raycast、Keyboard Maestro、快捷指令等调用。
Scheme
Section titled “Scheme”- 主：
voicehotkey:// - 短：
vh://（等价）
| 作用 | URL |
|---|---|
| 开始语音输入 | voicehotkey://start 或 …/start?mode=dictation |
| 开始翻译 | voicehotkey://start?mode=translation |
| 开始命令 | voicehotkey://start?mode=command |
| 结束并处理 | voicehotkey://stop |
| 切换录音 | voicehotkey://toggle（可带 mode=） |
| 取消 | voicehotkey://cancel |
查询参数别名：mode / mode_id / voice_mode 均可。语音输入模式可用 dictation / typing / type / voice / input / d。
录音动作别名（host）：start≈record≈listen，stop≈end≈finish，cancel≈escape≈abort。
| 页面 | URL |
|---|---|
| 通用设置 | voicehotkey://tab/settings 或 …/general |
| 快捷键 | voicehotkey://tab/hotkey |
| 输入模型 | voicehotkey://tab/models |
| 文本处理 | voicehotkey://tab/post-process |
| 语音命令 | voicehotkey://tab/commands |
| 文件转写 | voicehotkey://tab/transcribe |
| 历史 | voicehotkey://tab/history |
| 许可证 | voicehotkey://tab/license |
| 关于 | voicehotkey://tab/about |
| 词替换 | voicehotkey://word-replacements |
若已在录音，或识别 / 润色 / 执行尚未结束，再发 start 会被忽略，并在状态浮层提示忙碌（先结束当前会话或按 Esc / voicehotkey://cancel）。stop / toggle / cancel 仍可按语义结束或切换。
命令模式还受 启用语音命令 总开关约束：关闭时 mode=command 不会启动命令管线。见 语音命令。
快捷 host
Section titled “快捷 host”与 tab/… 等价，适合启动器：
| URL | 打开 |
|---|---|
voicehotkey://settings |
通用 |
voicehotkey://history |
历史 |
voicehotkey://word-replacements |
词替换 |
路径写法：voicehotkey:///start?mode=dictation。
若 App 尚未就绪，Deeplink 会排队，在管线启动后执行。