命令参考
当前版本的本地命令词典只包含你创建的条目与自动学习条目，没有随应用启用的内置命令包、起步预设或 108 条内置口令目录。下表是可自行添加的映射示例，首次安装后不会自动识别为这些动作。
添加用户口令
Section titled “添加用户口令”- 打开 设置 → 语音命令，保持 启用语音命令 打开。
- 在 执行能力 中允许所需动作类型。
- 打开 自定义命令词典，输入短语并选择动作、目标和可选 App 范围。
- 保存后，用命令热键（默认
鼠标中键）说出短语。在目标 App 中先确认它的快捷键和实际效果。
可直接配置的动作示例
Section titled “可直接配置的动作示例”| 示例短语 | 编辑器中的动作 | 内容 / 目标 | 范围示例 |
|---|---|---|---|
复制, copy |
快捷键 | ⌘C |
留空：全局 |
插入邮箱 |
插入文本 | you@example.com |
全局 |
打开 GitHub |
打开应用 / URL | https://github.com |
全局 |
打开备忘录 |
打开应用 / URL | Notes |
全局 |
打开周报 |
打开文件 | ~/Documents/report.pdf |
全局；替换为实际文件 |
运行日报 |
快捷指令 | Daily report |
全局；名称须与已有快捷指令一致 |
新标签 |
快捷键 | ⌘T |
com.apple.Safari |
地址栏 |
快捷键 | ⌘L |
com.apple.Safari |
命令面板 |
快捷键 | ⌘⇧P |
com.microsoft.VSCode |
快捷键由当前前台 App 处理，不同 App 或自定义绑定可能产生不同效果。App 范围留空表示全局，填写 Bundle ID 后只在该 App 前台时匹配。执行能力关闭时，相应词典动作不会执行。
意图模型可解析的动作
Section titled “意图模型可解析的动作”试用 / Pro 可开启意图模型，使用已配置的云端或本地大模型解析自由口令。它可以返回快捷键、插入文本、悬浮回答、选区改写、打开目标、快捷指令与系统控制。悬浮回答、选区改写和系统控制没有手动词典动作选项；系统控制可在成功执行后形成符合条件的自动学习条目。
系统控制包括音量 / 亮度、媒体播控、锁屏 / 休眠、计时器、窗口排列、提醒事项和日历日程。具体效果仍取决于模型解析、所启用的执行能力、macOS 权限和目标环境；这些示例不是固定保证命中的内置口令。
倒计时、系统闹钟与提醒事项
Section titled “倒计时、系统闹钟与提醒事项”倒计时 / 番茄钟目前暂由 VoiceHotkey 内部运行，不会加入 macOS 的“时钟”。同时只能运行一个，新建会替换旧的；退出 VoiceHotkey 后停止，Mac 睡眠期间可能延迟提醒。
“取消倒计时”只取消 VoiceHotkey 内部计时；没有正在运行的计时器时会提示失败。
系统闹钟使用 macOS“时钟”。先在 设置 → 语音命令 → 系统闹钟 导入 VoiceHotkey Alarms v1，允许首次出现的“时钟”及自动化授权，再点“检查连接”。保留辅助指令的名称；同名辅助指令只能有一个。系统操作能力必须开启。
目前使用中文或英文明确说：
- “设置一个7:30的闹钟” / “Set an alarm for 7:30 AM”
- “列出闹钟” / “List alarms”
- “关闭7:30的闹钟” / “Disable the alarm at 7:30 AM”
- “删除7:30的闹钟” / “Delete the alarm at 7:30 AM”
7:30 按24小时制解释；“七点”要注明早上或晚上。“取消”表示关闭；删除会先展示目标并确认，系统也可能要求确认。没有匹配或同一时间匹配多个闹钟时不会操作，请在“时钟”中进一步选择。执行后会重新查询结果；未确认的操作不会自动重试，以免重复创建。
日期、重复规则、系统计时器及其他闹钟语法请在“时钟”中设置。尚未验证真正睡眠、合盖和锁屏时响铃。闹钟请求不会替换成内部倒计时或提醒事项。
“明天下午提醒我交材料”等提醒事项仍写入系统“提醒事项”，与倒计时和闹钟分开。