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://finish |
| 仅结束录音；处理中无操作 | voicehotkey://finish-recording |
| 切换录音 | 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。finish-recording 仅结束录音。
省略 mode 时默认语音输入。显式填写不支持的模式或设置页面时，VoiceHotkey 会在状态浮层提示错误，不会回退到默认页面或模式。
| 页面 | 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 会被忽略，并在状态浮层提示忙碌。录音时 stop 会结束并处理；已在识别 / 润色 / 执行时，stop 和它的旧别名 finish 会取消当前工作。finish-recording 仅结束录音，其他状态下不操作；cancel 明确取消当前工作。toggle 按当前会话状态切换。
命令模式需要同时开启 启用语音命令 和 允许 DeepLink 启动语音命令；后一个开关默认关闭。它只限制外部 DeepLink，键盘热键不受影响。见 语音命令。
快捷 host
Section titled “快捷 host”与 tab/… 等价，适合启动器：
| URL | 打开 |
|---|---|
voicehotkey://settings |
通用 |
voicehotkey://history |
历史 |
voicehotkey://word-replacements |
词替换 |
路径写法：voicehotkey:///start?mode=dictation。
若 App 尚未就绪，Deeplink 会排队，在管线启动后执行。等待队列最多保留 16 项；超出部分会丢弃，并在状态浮层提示。无效链接也会在状态浮层显示原因。