语音命令
语音命令与「语音输入」分开：走 命令热键（默认 ⌃⌥C）。识别后按优先级匹配 用户词典 → 内置词典，未命中再可选调用意图模型，然后执行快捷键 / 终端等动作。
setup-07-commands.webp）路径：设置 → 语音命令
- 启用语音命令（
voiceCommandsEnabled，默认开）
关闭后：命令热键、历史再执行与相关 deeplink 都不会启动语音命令；语音输入 / 翻译不受影响。
关闭时下方的执行能力、解析与服务商仍可预先配置，重新开启后立即生效。
路径：设置 → 语音命令 → 起步方案
一键套用执行能力与内置命令包，之后仍可单独改卡片。
| 方案 | 效果 |
|---|---|
| 安全 | 仅编辑热键；意图模型关闭；命令包只留「编辑」 |
| 问答 | 仅悬浮回答；试用 / Pro 会打开意图模型；内置命令包全关 |
| 全能 | 热键 + 输入 + 悬浮回答 + 改写 + 打开应用 + 快捷指令；全部命令包；终端仍关 |
路径：设置 → 语音命令 → 执行能力
点选卡片加入或去掉某类动作。去掉后，本地词典跳过该类条目，意图模型也不会返回该类动作。
| 卡片 | 说明 | 示例 | 默认 |
|---|---|---|---|
| 允许热键 | 注入键盘快捷键。加入后可展开「危险热键确认」 | “复制” → ⌘C（内置）；“书签栏” → ⌘⇧B（用户词典） |
开 |
| 允许文本输入 | 在光标处插入短语 | “插入邮箱” → 光标处插入预设地址（用户词典） | 开 |
| 允许悬浮回答 | 问答显示在悬浮窗 | “用一句话解释 DNS” → 悬浮窗给答案（意图模型） | 开 |
| 有选中文字时改写 | 试用 / Pro；加入后需配置意图模型 | 先选中文字，再说“改成正式语气”（意图模型） | 开 |
| 允许打开应用 / URL | 用系统打开应用名或 https / mailto，不走终端 | “打开终端”（内置）；“打开 GitHub” → https://github.com（用户词典） |
开 |
| 允许快捷指令 | 运行 Shortcuts.app 里已有的快捷指令 | “跑日报” → 运行名为「日报」的快捷指令（用户词典） | 开 |
| 允许终端命令 | 试用 / Pro；加入后可展开「终端命令执行前确认」。见 终端命令 | “现在几点” → 运行 date，执行前先确认 |
关 |
内置词典只覆盖热键与打开应用两类动作；其余五类的示例都要靠用户词典或意图模型补上。
点选卡片加入或去掉一整类内置口令。去掉后内置词典跳过该类；用户自定义词典不受影响。默认四包全开。
| 卡片 | 示例口令 |
|---|---|
| 编辑 | 复制、粘贴、撤销、保存 |
| 窗口与标签 | 关闭、新建、刷新、下一标签 |
| 打开应用 | 打开 Safari / Finder / 终端（需加入「允许打开应用 / URL」，不必开终端） |
| App 专属 | 当前前台 App 的后退、地址栏、侧边栏等 |
命令词典（解析）
Section titled “命令词典（解析）”先 精确 再 模糊；同一轮内顺序为：
- 用户 · 当前前台 App 限定（已启用）
- 用户 · 全局（已启用）
- 内置 · 当前前台 App（
CommandRegistry.json的apps） - 内置 · 全局
同一短语用户与内置同时存在时，用户条目优先。
用户自定义词典
Section titled “用户自定义词典”设置 → 语音命令 → 命令词典 打开编辑表单（数据存本机 UserDefaults，纯本地、不上传）：
- 短语：逗号 / 顿号 / 分号 / 换行分隔，例如
刷新, reload - 动作：快捷键、插入文本、打开应用 / URL、快捷指令，或 终端命令（需试用/Pro 且已允许终端）
- 范围：可选 Bundle ID；留空 = 全局
- 可 启用 / 停用、点击编辑、删除
五类动作各一个可直接照抄的样例：
| 短语 | 动作 | 范围 | 需加入的执行能力 |
|---|---|---|---|
插入邮箱 |
插入文本 you@example.com |
全局 | 允许文本输入 |
GitHub |
打开应用 / URL https://github.com |
全局 | 允许打开应用 / URL |
截屏识字 |
快捷指令 OCR |
全局 | 允许快捷指令 |
现在几点 |
终端命令 date |
全局 | 允许终端命令（试用 / Pro） |
书签栏 |
快捷键 ⌘⇧B |
com.apple.Safari |
允许热键 |
「悬浮回答」与「选中改写」不在用户词典的动作列表里——这两类只能由意图模型返回。
内置常见命令按 命令包 加入或去掉；用户词典用于覆盖或扩展。
随应用打包的 CommandRegistry.json（Bundle.module）。应用内 不能 直接改该 JSON 文件；扩展请用用户词典，或开启意图模型处理自由口令。
内置共 108 条口令：全局 41 条（多为快捷键，打开 App 走独立的 open 动作）＋ 9 个前台 App 的 67 条专属短语。完整清单见 内置命令参考。概览：
| 类别 | 示例口令（中 / 英） |
|---|---|
| 编辑 | 复制 / copy、粘贴 / paste、撤销 / undo、全选、保存、另存为 |
| 查找与刷新 | 查找、查找下一个、刷新、强制刷新（硬刷新） |
| 窗口 / 标签 | 新建、关闭、下一标签、上一标签、切换应用、全屏 |
| 格式与按键 | 粗体、斜体、下划线、回车、空格、Tab、Esc、删除… |
| 打开应用（open） | 打开终端 / Finder / 系统设置 / Safari / Chrome / 备忘录 |
打开应用口令需要加入 允许打开应用 / URL，不必开启终端命令。用户词典里的终端动作仍需 试用 / Pro 且打开 允许终端命令（见 终端命令）。
App 专属词典（apps）覆盖常见前台应用，例如 Safari、Chrome、Arc、Edge、VS Code、Cursor、Finder、Terminal、Slack 等（刷新、标签、地址栏、后退前进等因 App 而异）。
优先本地命令词典
Section titled “优先本地命令词典”开启后，命中命令词典（用户自定义 + 内置）时 跳过意图模型，减少延迟与 API 调用。
试用 / Pro 专属（LicenseFeature.intentModel）。Free 仅保留本地命令词典。
开启后，未命中词典的口令可发给大模型解析意图（BYOK）。仅用于命令意图；与语音输入润色可共用密钥、独立开关。选区改写使用同一套意图凭证，并受同一许可证门槛约束。
路径：设置 → 语音命令 中的「意图模型」区块。
与语音输入的区别
Section titled “与语音输入的区别”| 语音输入 | 语音命令 | |
|---|---|---|
| 默认热键 | ⌃⌥Space |
⌃⌥C |
| 结果 | 插入文字 | 执行快捷键 / shell 等 |
| 后处理 | 润色、词替换等 | 用户/内置词典 → 意图 |
历史中的解析来源
Section titled “历史中的解析来源”命令类历史可显示解析路径短标签：词典 / 意图模型 / 手动（对应 localRegistry / llm / manual）。