macOS 应用支持两种语音输入模式：唤醒词模式（默认）和按键通话（PTT）。
两种模式
- 唤醒词模式：始终开启的语音识别器等待触发词（
swabbleTriggerWords）。匹配后开始捕获，显示覆盖层，静默后自动发送 - 按键通话（右 Option 键）：按住右 Option 键立即捕获，无需触发词；释放后发送
唤醒词运行时行为
| 参数 | 值 |
|---|---|
| 触发间隔（有意义停顿） | ~0.55s |
| 静默窗口（语音流动中） | 2.0s |
| 静默窗口（仅触发词） | 5.0s |
| 硬停止 | 120s |
| 会话间防抖 | 350ms |
生命周期不变量
- 语音唤醒启用且权限已授予时，唤醒词识别器应始终处于监听状态（PTT 捕获期间除外）
- 覆盖层可见性（包括手动关闭 X 按钮）不得阻止识别器恢复
PTT 细节
- 热键检测使用全局
.flagsChanged监听器（keyCode 61+.option），仅观察不拦截 - PTT 开始时暂停唤醒词运行时，释放后自动重启
- 需要麦克风 + 语音识别权限；监听事件需要辅助功能/输入监控权限
用户设置
- Voice Wake 开关：启用唤醒词运行时
- Hold Cmd+Fn to talk：启用 PTT 监听器（macOS < 26 禁用）
- 语言和麦克风选择器、实时电平表、触发词表、测试器
- 声音：触发检测和发送时的提示音，默认 macOS “Glass” 系统声音
转发行为
- 转录发送到活跃的 Gateway/Agent（与应用其他部分使用相同的本地/远程模式）
- 回复发送到最后使用的主 provider（WhatsApp/Telegram/Discord/WebChat）
相关链接
- platform-mac-voice-overlay — 语音覆盖层生命周期
- platform-macos — macOS 平台总览