QuickVibeHost for Mac

下载语音棒桌面助手

连接 AI 语音指挥棒，把语音、按键、审批和会话状态同步到 Mac。

QuickVibeHost v2.6.7 发布于 2026-08-06 macOS 14+ · Apple Silicon
下载 Mac App

下载后如何打开

下载后按下面步骤安装。首次打开时，macOS 可能会要求你确认一次。

1
下载并打开 DMG

双击下载的 DMG 文件，打开磁盘镜像

2
拖拽安装

将 QuickVibeHost 拖到“应用程序”（Applications）文件夹

3
首次打开

如果 macOS 提示无法验证开发者，用下面任一方法打开。

  • 方法一 右键点击 App → 选择「打开」→ 在弹窗中点击「打开」
  • 方法二 打开终端，执行下面这行命令
xattr -cr /Applications/QuickVibeHost.app

然后双击 App 即可正常打开

4
授予权限

请参考下方「权限配置」完成授权

支持的 AI 工具

支持 Claude Code 与 Codex。检测到安装后会自动出现，无需手动配置；会话状态、用量和审批会同步到 App 与设备屏幕。

Claude Code 会话状态 · 直通输入 · 审批处理 · 用量统计

在 App 内开启集成后，可查看每条会话的状态、模型、轮数、费用和上下文余量。

Codex CLI 会话状态 · 直通输入 · 审批处理 · 用量统计

可自动识别终端里的 Codex 会话；直通输入和审批处理会在 App 内引导开启。

Codex Desktop 会话状态 · 用量统计 · 审批跳转

可识别 Codex.app / ChatGPT.app 内的会话；有审批时，可从 App 一键前往处理。

直通输入

选中某个会话为直通后，设备语音与按键输入会始终进入该会话，与 Mac 当前焦点无关。不会模拟键盘、不会激活窗口、不会抢剪贴板。

首次使用前，在 App 设备页按提示完成一次直通组件安装；Codex CLI 也会在 App 内提供引导。

未选中任何会话时为自由模式：识别文字注入当前光标处。全局快捷键（默认 Option+1）始终走光标注入，方便在普通应用里录入。

设备按键速查

AI 语音指挥棒 QuickVibeMicStick
  • A 长按：按住说话，松开上屏（可在 App 中切换为「单击启停」长语音模式）
  • A 单击：回车
  • B 单击 / 长按 / 双击：ESC / 加速连删 / 调出自定义 Prompt 列表
  • 旋钮旋转 / 单击：框选会话 / 切换直通输入
  • 旋钮长按：进入文字编辑模式（光标移动、语音插入、删词）
  • 审批到达时：单击 A 允许，单击 B 拒绝

语音操作模式（PTT / 长语音）与自定义 Prompt（最多 8 条）在 App 设备页配置。

权限配置

必须 辅助功能 (Accessibility)

用于键盘模拟（语音转文字自动输入）和全局快捷键

  1. 打开 系统设置 → 隐私与安全性 → 辅助功能
  2. 点击左下角 + 按钮
  3. 在应用程序中找到并添加 QuickVibeHost
  4. 确保开关为 开启 状态

如果权限不生效，尝试先移除 App 再重新添加

自动 麦克风

用于语音采集，首次使用时系统会自动弹窗请求

自动 蓝牙

用于连接 AI 语音指挥棒，首次连接时系统会自动弹窗请求

可选 通知

用于用量告警等提醒

语音识别配置

本地引擎（Paraformer）默认

完全离线，语音不离开本机，识别速度快。原生热词（毫秒级生效）、自动标点、中文数字转阿拉伯数字。

  1. 打开 App 设置 → 语音，点击下载离线模型（逐文件校验，自动安装）
  2. 可选：追加下载 2-pass 流式模型包（约 525MB），按住说话即实时出字

本地引擎需 Apple Silicon（M 系列芯片）。

豆包云端引擎（火山引擎）可选

流式识别，支持热词表与对话上下文（自动携带近 5 条识别结果提升准确率）。识别失败自动本地兜底。

  1. 访问 火山引擎语音控制台 注册并创建应用
  2. 获取 App Key 与 Access Key
  3. 在 App 设置 → 语音 中填入并切换引擎

常见问题

提示「已损坏，无法打开」怎么办？

打开终端，执行下面这行命令后重新打开 App。

xattr -cr /Applications/QuickVibeHost.app
从 v2.6.0 或更早版本升级后，语音无法输入 / 辅助功能失效？

新版 App 已使用固定签名。首次从旧版升级时，macOS 可能会把它视为新 App。请在 系统设置 → 隐私与安全性 → 辅助功能 中移除 QuickVibeHost，再重新添加并开启。之后继续升级通常会保留授权。

辅助功能权限已开启但快捷键不生效？

在系统设置 → 隐私与安全性 → 辅助功能中，先移除 QuickVibeHost，然后重新添加并开启。重启 App 后生效。

无法连接设备？
  • 确认设备已开机且未被其他 Mac 连接
  • 确认 Mac 蓝牙已开启
  • 在 App 设备页点击「添加设备」重新扫描
  • 仍然无法连接时，重启设备和 Mac 蓝牙
语音识别没有反应？
  • 本地引擎：确认已在 设置 → 语音 中下载完离线模型（需 Apple Silicon）
  • 豆包引擎：确认 App Key / Access Key 有效
  • 确认设备处于录音状态（屏幕显示录音浮层）
  • 在「历史」页查看该次识别的失败原因，可一键重试
直通输入选不中会话？
  • 确认已安装 vibepty alias（设备页「输入模式介绍」内一键安装）
  • Claude Code / Codex CLI 需要通过 vibepty 启动后才能被直通
  • Codex Desktop 不支持直通输入