安装 Mac App
安装 QuickVibeHost，完成蓝牙与辅助功能授权；首次可在设置里下载本地语音识别模型。
QuickVibeHost + MicStick
让语音、按键与 AI 会话在同一套工作流里协作。
这份说明书覆盖 QuickVibeHost for Mac 和 QuickVibe MicStick：从安装、连接到语音输入、会话与应用切换、情景模式、电源管理和固件更新。
5 分钟开始
先让 Mac App 和 MicStick 成功协作。之后再按你的工作方式配置识别、会话和按键模式。
两个独立的使用部分
Mac App 管理连接、识别、AI 会话、运行中应用和更新；MicStick 则专注于语音、实体控制、状态反馈和电源管理。两者可以独立更新，但应保持兼容版本匹配。
版本兼容
使用稳定版 Mac App 与稳定版 MicStick 固件是推荐组合。设备新增能力可能要求 App 升级；旧固件则可能不会显示新功能。
| 组件 | 当前版本 | 关系 | 下一步 |
|---|---|---|---|
| QuickVibeHost for Mac | 加载中 | 管理设备、语音、会话、应用切换与情景模式。 | 下载 Mac App |
| QuickVibe MicStick | 加载中 | 需要 Mac App 加载中 或更高版本。 | 更新固件 |
WorkBuddy 支持与连接
完整 WorkBuddy 体验需要 QuickVibeHost 2.8.0 与 MicStick V14 1.2.3。App 检测本机 WorkBuddy，读取本地会话、活动和积分记录，区分执行与等待状态；积分不是实时账户余额或 Token 配额，也不使用官方云端 API。
先安装并打开 WorkBuddy，在 App 选择会话跳转后确认输入框焦点，再使用普通语音输入。WorkBuddy 不支持 vibepty 直通输入。
设备审批默认关闭。在 App 设置启用本地插件后，必须完全退出并重启 WorkBuddy。插件处理 Bash 的 PreToolUse 和 PermissionRequest；设备仅支持单次允许或拒绝，不支持本会话始终允许。断连、超时或不可用时回退原生审批，不会自动批准。
WorkBuddy 场景支持上一/下一任务、新任务、快速提问、切换成果面板和停止任务，依赖 WorkBuddy 快捷键及 macOS 辅助功能权限；旧设备按能力降级。Claude Code、Codex CLI 与 Codex Desktop 的既有输入方式保持各自差异。