QuickVibe MicStick V14

用语音与实体按键控制 AI 工作流。

MicStick V14 是与 QuickVibeHost for Mac 配合使用的语音与控制设备。它通过蓝牙接收会话、审批、应用列表与情景模式，并将语音和按键输入交给 Mac。

查看 A / B / C / D 按键更新固件 加载中

连接与待命

MicStick 必须先连接 QuickVibeHost。连接后的设备主页会显示会话列表；没有可用会话时，仍可使用自由语音输入。

1

打开 App

确认 QuickVibeHost 已安装，Mac 蓝牙已开启。

2

添加 MicStick

在 App“设备”页选择添加设备，按屏幕提示完成搜索和连接。

3

查看待命状态

已连接后，LED 为弱绿色常亮；设备屏幕显示会话列表或“无会话 · 语音就绪”。

主页与会话列表

主页是设备的工作中心：顶栏显示连接与设备状态，中部显示可用 AI 会话，旋钮用于框选和切换目标。

顶部状态栏

显示蓝牙连接、电量、时间和当前模式。它用于判断设备是否已准备接收语音和按键。

会话列表

显示来自 Mac App 的活跃会话；非活跃会话以可展开分组显示。旋转 D 框选条目；单击 D 可切换该会话的直通状态。框选停止操作约 5 秒后隐藏。

直通与自由模式

直通会话会稳定接收设备输入；没有选中直通会话时，识别结果会进入 Mac 当前光标位置。

弹窗优先级

录音、识别、应用切换、提示词、输入助理、审批、运输模式确认与固件升级都会显示对应页面。审批和运输模式确认属于高优先级交互，应先处理或退出。

A / B / C / D 按键说明

以下表格对应 正在加载按键版本。A 为全局语音键；B、C、D 会按照当前屏幕场景或 Mac App 下发的情景模式改变行为。

先记住默认操作

A：长按说话、松开结束；双击可开始 / 停止长语音；单击回车。B：删除。C：单击 Esc / 取消，长按切换 Mac 应用。D：旋转浏览，按下确认或切换，长按进入情景模式。

场景ABCD（旋钮 / 按压）
正在加载按键定义…

提示词、输入助理、应用切换和情景模式取决于 Mac App、MicStick 固件版本及当前设置。设备屏幕会显示当前模式可用的动作，不要以其他设备或旧版说明替代本表。

应用切换：不碰键盘也能回到目标 App

在设备主页长按 C，MicStick 会显示 Mac 当前可切换的运行中应用。这个功能独立于 AI 会话列表，可用于浏览器、编辑器、终端等普通 Mac 应用。

1

打开

长按 C，看到“切换应用”列表后即可松开。列表优先显示最近使用的应用。

2

选择

旋转 D 移动高亮；单击 D 激活所选应用，并尽量恢复之前的窗口和输入焦点。

3

取消

单击 C 返回主页。若约 15 秒没有操作，应用列表也会自动关闭。

旧版本兼容行为

新固件与新 App 配合时，应用名称直接显示在设备上；旧固件会退回 macOS 原生 Command-Tab 切换，松开 C 即完成选择。

自动省电、完全关机与运输模式

MicStick V14 会根据供电、连接与操作状态自动降低功耗。短时间无操作只会降亮度或息屏；长时间电池待机会进入完全关机。

电池供电时

  • 约 1 分钟无操作：降低背光与运行频率。
  • 约 10 分钟无操作：关闭屏幕并进入低功耗待命；按任意键即可唤醒，当前这次按键仍会生效。
  • 约 30 分钟无真实用户操作，或蓝牙持续断开约 5 分钟：自动进入完全关机。
  • 检测到持续低电压时，也会为保护电池而关机。

USB 供电时

连接 USB 时不会自动进入完全关机；约 15 分钟无操作会降低背光。设备处于 USB 供电时不能进入运输模式，请先拔掉 USB。

从自动关机恢复

自动完全关机后，按任意按键即可冷启动设备。重新启动后等待 QuickVibeHost 自动连接。

运输模式

在 Mac App“设备”页的设备卡片菜单中选择“运输模式”，再到 MicStick 确认页单击 B 确认；单击 C 取消。运输模式会断开电池，适合运输或长期存放。

从运输模式开机：先长按机身侧面的 SW1 约 1 秒，或插入 USB 充电，再按任意键。

运输模式会立即断电

确认前请结束录音与固件更新。设备确认页只接受 B 单击确认和 C 单击取消；其他按键与旋钮操作会被忽略。

状态灯：用颜色判断设备状态

LED 是 MicStick 的主要即时反馈。开机进行红、绿、蓝三色自检；这不是蜂鸣器提示。

未连接红色呼吸。打开 Mac App 的设备页重新连接。
已连接、待命弱绿色常亮。可以开始语音输入。
录音中橙色脉动。正在采集语音。
识别处理中蓝色跑马。等待识别结果或输入完成。
等待审批紫色慢闪。打开设备审批页或在 Mac 端处理。
轻度休眠、仍连接两端弱绿灯，表示设备仍在线。
轻度休眠、未连接单颗弱红灯，表示需要重新连接。

短时事件灯效

  • A 的普通确认：白色闪烁
  • B 删除：黄色闪烁
  • 识别成功：绿色闪烁
  • 识别失败或超时：红色闪烁
  • 新审批到达：紫色心跳三次

可调亮度

在 QuickVibeHost 的设备设置中调整 LED 亮度。设置会保存到设备，下次使用仍然有效。

蜂鸣器：只提示 AI 任务与审批

MicStick 当前固件不会在开机、低电量、开始或停止录音、识别成功或失败时播放提示音。这些状态请看屏幕与 LED。

事件声音含义
AI 任务开始短上行提示会话已从空闲进入执行。
AI 任务完成完成提示会话从执行状态回到完成或待命。
AI 任务出错 / 审批发送失败错误提示需要关注错误或重新同步。
新审批到达连续提示需要允许、拒绝或在 Mac 端处理。
等待用户输入输入提醒AI 正等待你的下一步输入。
审批允许 / 拒绝 / 超时 / 他处处理不同确认提示审批结果或状态已经变化。
App 内调整音量短试听音确认当前音量。

蜂鸣器音量可在 Mac App 的设备设置中调整，设为 0 后所有上述声音都会静音。

固件安装、更新与恢复

推荐先通过 Mac App 使用蓝牙 OTA 更新。USB-C 在线刷机用于首次刷写、无法 OTA 的旧版本，或更新失败后的恢复。

推荐：App 内 OTA

  1. 通过蓝牙连接 MicStick；设备卡片会自动检查可用更新。
  2. 出现“可更新至 …”后，点击设备卡片中的“更新固件”。
  3. 等待下载、传输、设备重启与校验完成。
  4. 更新期间不要断电、关闭 App 或断开蓝牙；设备会显示进度，且 A / B / C / D 暂不可用。

USB-C 在线刷机 / 恢复

  1. 使用支持数据传输的 USB-C 线连接设备。
  2. 用桌面版 Chrome 或 Edge 打开在线刷机页。
  3. 点击安装固件，并在浏览器弹窗中选择 ESP32-S3 / usbmodem 串口。
  4. 等待设备自动重启，再回到 App 重新连接。

打开 MicStick 在线刷机页 →

首次启用 OTA 的旧固件

不含 OTA 服务的早期 MicStick 固件无法由 App 直接升级。请先通过 USB-C 在线刷机完整安装支持 OTA 的稳定版，之后再使用 App 内更新。

MicStick 常见问题

设备显示未连接

确认 Mac App 已打开、蓝牙已开启，且 MicStick 没有被其他 Mac 连接；在 App 设备页重新扫描。

长按 A 没有开始录音

先确认设备已连接且没有固件更新进行中。若仍无反应，检查 App 的语音识别配置与设备页连接状态。

长按 C 没有显示应用列表

确认 QuickVibeHost 与 MicStick 固件已更新到本页显示的兼容版本，并保持设备在线。旧固件可能只显示 macOS 原生应用切换界面。

设备息屏后第一次按键是否会丢失

不会。按键会同时唤醒屏幕并执行本次操作；屏幕恢复显示可能稍晚于按键响应。

进入运输模式后无法开机

先长按机身侧面的 SW1 约 1 秒，或插入 USB 充电，再按任意键。仅按正面 A / B / C / D 不一定能解除运输模式的电池断开状态。

蜂鸣器没有声音

先确认当前是 AI 任务或审批事件，而不是开机、低电量或录音状态；再在 App 设备页确认蜂鸣器音量没有设为 0。

LED 不亮或状态不对

检查 LED 亮度是否被设为最低；重新连接设备。开机时应可看到短暂的红、绿、蓝自检。

固件更新失败

保持设备有电，重新连接后重试 OTA；若不能恢复，请用 USB-C 在线刷机重新安装完整固件。

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 的既有输入方式保持各自差异。

连接与权限指南