用途:在 macOS 上通过命令行控制 Wispr Flow(AI 语音听写应用)。它使用应用注册的 wispr-flow:// URL scheme,无需按键模拟、无需辅助功能权限、无需 API 密钥,只需 open 命令。主要场景是让 AI 编程智能体(如 Claude Code 或任何能执行 shell 命令的工具)替用户开关 Wispr Flow 听写,例如用户说“开始听写”,智能体触发启动深链,用户即可免手动输入下一段提示。
前提:需已安装并运行 Wispr Flow 桌面应用,且已授予麦克风权限。
主要命令: 开始免手动听写:open "wispr-flow://start-hands-free"。Flow 会持续监听直到停止,与按住说话的按键模式不同。听写文本会输入到当前拥有键盘焦点的窗口,因此触发前需先把光标放到目标位置。 停止听写:open "wispr-flow://stop-hands-free"。 切换麦克风:open "wispr-flow://switch-mic?mic_name=<PREFIX>",切换到名称以该前缀开头的第一个输入设备(不区分大小写),例如 open "wispr-flow://switch-mic?mic_name=MacBook"。
行为与注意事项:start-hands-free 仅在 Flow 空闲时启动,若听写已激活会被静默忽略;要确保干净启动,可先发送 stop-hands-free。stop-hands-free 仅在免手动(锁定)监听模式下生效,不会取消按键说话会话。从终端触发时,Flow 会把文本输入到终端,需先切换焦点到目标应用。
限制:这些深链操作未在 Wispr Flow 公开文档中记载,属于非官方用法,经验证于应用版本 1.5.980(Apple Silicon、macOS),未来版本可能变化。官方支持的激活方式是应用内热键(默认 Fn 为按键说话,Fn+Space 为免手动),可在设置 → 通用 → 快捷键中配置。