遇到問題

這篇能完成什麼

照你看到的症狀，找到可以先試的做法。如果都試過還是不行，最後一段有回報問題的方式。

一個先講在前面的好消息：錄音在文字成功放進剪貼簿之前不會被刪掉。所以大部分失敗，你都不用重講，按「重新辨識」或「重新辨識保留錄音」就好。

按了快捷鍵沒反應

1. 確認選單列有小黑貓圖示，代表 App 正在執行。沒有的話，到個人的「應用程式」資料夾打開 AI語音輸入.app。
2. 可能有別的 App 也用了同一組快捷鍵。小黑貓選單 →「設定快捷鍵…」換一組試試。
3. 也可以直接從小黑貓選單點「開始／停止錄音」，確認是不是快捷鍵的問題。

錄到沒有聲音，或結果是空的

• 錄音時看一下浮窗的音量條，有沒有跟著你的聲音跳動。
• 「系統設定」→「隱私權與安全性」→「麥克風」，確認 What's up my neighbor 是打開的。
• 用外接麥克風或 AirPods 的話，小黑貓選單 →「iPhone 接力與麥克風設定…」可以固定要用的麥克風。
• App 錄音時會刻意排除 iPhone 的「連續互通麥克風」，避免錄到遠處手機的靜音。這是預期中的行為。

文字沒有貼上

先按 ⌘V。如果能貼出來，代表辨識成功了，只是自動貼上沒有完成。小黑貓浮窗會顯示「文字已複製」，App 也會告訴你原因：

有些網頁或特殊 App 的輸入框無法被驗證，也會走到「只複製」，一樣用 ⌘V 手動貼上就好。

更新 App 之後如果突然不能自動貼上，macOS 有時會需要重新確認輔助使用權限。到設定裡把 What's up my neighbor 關掉再打開，通常就會恢復。

辨識失敗或網路錯誤

App 會保留錄音，並問你要「重新辨識」還是「捨棄錄音」。網路恢復後按重新辨識就好。

保留的錄音最多放兩分鐘，關閉 App 也會刪除。超過時間的話，就需要重新說一次。

出現奇怪的語言

錄音太短或沒出聲時，辨識模型偶爾會憑空產生其他語言的字。App 偵測到不在你「語言設定」裡的文字時，不會直接貼出來，會先用主要語言自動重試一次；還是不對，就讓你選擇重新辨識或捨棄。

常常發生的話，確認「語言設定…」的主要語言是你最常說的那一個。

金鑰錯誤或額度用完

詳細說明在 設定 Groq API Key。

更新相關

• 沒收到新版通知：確認小黑貓選單的「自動偵測新版本」有勾選，或直接按「檢查更新…」。
• 專注模式開著：通知可能被隱藏，App 內的選單仍會顯示有新版。
• 很舊的版本：v1.3.0 以前沒有自動更新功能，需要照 安裝 Mac 版 手動裝一次新版。之後就會自己檢查了。
• 不管哪一種，不要先執行移除工具再安裝。直接安裝新版會保留你的金鑰與設定。

想移除 App

執行安裝包資料夾裡的 移除.command（同樣用右鍵「打開」）。它會：

• 結束 App，移除登入自動啟動。
• 刪除 App 本體（個人「應用程式」資料夾裡的 AI語音輸入.app）、快捷鍵等偏好設定。
• 刪除鑰匙圈裡的 Groq API Key。

很早期就開始用的人，App 可能裝在別的地方（例如 Mac 的「應用程式」資料夾 /Applications），之後升級會沿用原位置。移除工具只會刪個人「應用程式」資料夾裡的那一份，所以移除後如果還在別處看到 AI語音輸入.app，把它丟到垃圾桶就好。

目前版本的移除工具不會刪除剪貼簿歷史與貓咪設定。想完全清乾淨的話，建議在執行移除工具之前先做這兩件事：

1. 剪貼簿歷史：小黑貓選單 →「剪貼簿設定」清除全部紀錄。想連資料夾一起刪，可以在 Finder 用「前往」→「前往資料夾…」輸入下面這行，把打開的資料夾丟到垃圾桶：

   ~/Library/Application Support/AI語音輸入
   

2. 貓咪設定：小黑貓選單 →「開啟貓咪設定資料夾…」，把打開的那個資料夾整個丟到垃圾桶。

移除 App 不會刪掉你在 Groq 的帳號或金鑰本身。不再使用的話，可以到 Groq Console 把金鑰刪掉。

都試過還是不行

可以到 GitHub Issues 開一個問題，寫下：

• macOS 版本，以及小黑貓選單裡顯示的 App 版本。
• 你做了什麼、預期會發生什麼、實際發生什麼。
• 畫面上的錯誤訊息原文。

請不要在 Issue、截圖或記錄檔裡貼出 API Key。如果是安全性問題（例如可能讓別人取得資料的漏洞），請改用 GitHub 的 私密回報表單（需要先登入 GitHub，內容只有維護者看得到），詳見 安全政策。