安装应用
- 下载并双击打开 DMG。
- 将 QuickVibeHost 拖入“应用程序”。
- 首次被 macOS 拦截时，右键应用并选择“打开”。
QuickVibeHost for Mac
连接设备，管理语音与 AI 会话。
QuickVibeHost 负责连接 MicStick、处理语音识别、显示 Claude Code 与 Codex 会话，并将设备输入送到当前光标或指定会话。
安装与首次设置
首次使用建议按以下顺序完成。安装完成后再连接 MicStick，能减少权限或输入失败的排查成本。
开启辅助功能
辅助功能用于向当前光标输入识别文字和发送按键，是语音转文字输入的必要权限。麦克风等其他权限只会在使用对应功能时申请。
设置语音识别
选择本地或云端识别。Apple Silicon Mac 可下载离线模型；云端识别需要对应服务凭据。
可选 AI 增强
可以填写 DeepSeek API Key。保存后自动开启识别校对；Prompt 智能推荐和输入助理仍需在“高级功能”中主动开启。
添加设备
添加 MicStick 后即可显示主页或会话列表；没有设备时也可以先完成其他设置。
状态页与会话列表
状态页汇总已检测到的 Claude Code 与 Codex 会话。选中会话后，可查看它的工作状态，并在可用时直接跳转或设为直通输入目标。
会话卡片
显示项目名称、工作目录、当前阶段、最近工具、上下文或用量，以及后台任务。不同 Agent 的可用信息取决于其宿主能力。
状态含义
- 空闲：会话等待输入。
- 工作中 / 思考中：Agent 正在执行任务。
- 等待审批：需要允许、拒绝或前往原生界面处理。
- 错误：本轮因 API 或运行问题结束。
会话跳转
使用会话卡片的跳转入口，可回到相应的 Claude Code、Codex CLI、Codex Desktop 或 VS Code 宿主界面。
用量与隐私
状态页可展示支持的会话用量。关闭会话监控后，App 会停止记录相应状态信息。
从 MicStick 切换 Mac 应用
在设备主页长按 C，可把 Mac 当前正在运行、可切换的应用列表发送到 MicStick 屏幕。无需先回到键盘或触控板。
长按 C 打开列表
QuickVibeHost 会按最近使用顺序整理运行中的应用，设备显示“切换应用”。QuickVibeHost 自身不会出现在列表中。
旋转 D 选择
旋转 D 浏览应用；每次操作都会延长选择页的停留时间。若长时间不操作，列表约 15 秒后自动关闭。
单击 D 切换
按下 D 后，Mac 激活所选应用，并尽量恢复该应用原先的窗口与输入焦点。按 C 可取消并返回设备主页。
兼容说明
完整的设备端应用列表需要本页显示的兼容版 QuickVibeHost 与 MicStick 固件。较旧固件会退回系统原生的 Command-Tab 切换方式。
两种输入方式
自由输入
未选择直通会话时，MicStick 识别出的文字会输入 Mac 当前光标位置，适用于编辑器、聊天工具和普通应用。
直通输入
将会话设为直通后，设备语音与按键会稳定发送到该会话，不依赖当前窗口焦点，也不会抢占剪贴板。
Claude Code 与 Codex CLI 需要按设备页引导安装直通组件；Codex Desktop 不支持直通输入。
设备、历史与设置
需要逐项了解设置作用时，请阅读独立的设置参考页。
设备页
添加或断开 MicStick；查看连接、版本和电量；调整 LED、提示音、语言、麦克风与情景模式；更新固件，或让 V14 进入运输模式。
历史页
查看识别结果和失败原因，复制或再次使用已识别的文本。
设置页
设置 ASR 引擎、热词、标点、数字格式、快速 LLM、启动项、语言和诊断选项。
Mac App 常见问题
辅助功能已开启，但不能输入文字
在“系统设置 → 隐私与安全性 → 辅助功能”中移除 QuickVibeHost，再重新添加并启用，然后重启 App。
找不到 MicStick
确认 Mac 蓝牙已开启，设备没有连接到另一台 Mac；在设备页重新扫描，必要时重启设备和 Mac 蓝牙。
无法选择直通会话
确认 Claude Code 或 Codex CLI 已通过 App 引导安装并使用直通组件启动。Codex Desktop 会话只能跳转，不支持直通。
识别没有结果
检查“设置 → 语音”中的本地模型是否下载完成，或云端凭据是否有效；再到“历史”页查看具体失败原因。
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 的既有输入方式保持各自差异。