下載後如何打開

下載後請依照下面步驟安裝。首次打開時，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)

用於鍵盤模擬（語音轉文字自動輸入）和全域快捷鍵

打開 系統設定 → 隱私與安全性 → 輔助功能
點擊左下角 + 按鈕
在應用程式中找到並添加 QuickVibeHost
確保開關為開啟狀態

如果權限不生效，嘗試先移除 App 再重新加入

自動 麥克風

用於語音採集，首次使用時系統會自動彈窗請求

自動藍牙

用於連接 AI 語音指揮棒，首次連接時系統會自動彈窗請求

可選通知

用於用量告警等提醒

語音辨識配置

本地引擎（Paraformer）預設

完全離線，語音不離開本機，辨識速度快。原生熱詞（毫秒生效）、自動標點、中文數字轉阿拉伯數字。

打開 App 設定 → 語音，點擊下載離線模型（逐文件校驗，自動安裝）
可選：追加下載 2-pass 流式模型包（約 525MB），按住說話即即時出字

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

豆包雲端引擎（火山引擎）可選

串流識別，支援熱詞表與對話上下文（自動攜帶近 5 條狀辨識結果提升準確率）。辨識失敗自動本地兜底。

訪問火山引擎語音控制台註冊並創建應用
獲取 App Key 與 Access Key
在 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 不支援直通輸入

語音棒 Mac 應用

快速安裝