快速入門

在 macOS 上安裝 Pluely v1

Pluely v1 在 macOS 上原生執行，功能與 Windows 和 Linux 版完全相同。本指南會帶你下載並安裝 Pluely，並順利通過第一次開啟時的安全性提示，讓浮動視窗正常開啟。

1. 下載 Pluely

前往 pluely.com/downloads，下載 macOS 版本。瀏覽器會把磁碟映像檔儲存到你的「下載項目」檔案夾。

2. 開啟下載的檔案並安裝

從「下載項目」打開下載的檔案。
畫面會出現一個視窗，顯示 Pluely 圖示和「應用程式」檔案夾的捷徑。
把 Pluely 拖到「應用程式」檔案夾即可安裝。
拷貝完成後，退出已裝載的磁碟映像檔。

3. 第一次開啟 Pluely

打開「應用程式」，然後按兩下 Pluely。從 1.1.0 版起，安裝程式就是標準的 macOS 版本，所以會像其他 App 一樣直接打開：不會出現安全性提示、不需要按「強制打開」，也不用在「終端機」輸入指令。

如果 macOS 仍然顯示警告

只有在使用 1.1.0 以前的版本，或不是從 pluely.com 取得的拷貝時，才會看到「Apple 無法驗證 Pluely 是否不含惡意軟體」或「來自未識別的開發者」。解決方法是從下載頁面下載最新版本並取代原本的 App。如果你仍需要打開舊版拷貝：

前往「系統設定 > 隱私權與安全性」。
向下捲動到「安全性」區域，你會看到 Pluely 已被阻擋的訊息。
選擇「強制打開」。
在出現的對話框中確認。之後每次啟動，Pluely 都會正常開啟。

或者在「終端機」（應用程式 > 工具程式 > 終端機）中清除隔離標記：

xattr -cr /Applications/Pluely.app

如果「終端機」回應「Operation not permitted」（不允許此操作），請在「系統設定 > 隱私權與安全性 > 完整磁碟取用權限」中啟用「終端機」，重新打開「終端機」，然後執行：

sudo xattr -rd com.apple.quarantine /Applications/Pluely.app

這只會清除 macOS 為 App Store 以外安裝的 App 加上的「從網際網路下載」標記。完整說明請參閱修正：macOS 無法驗證 Pluely。

4. 授予權限

第一次啟動時，浮動視窗會以永遠在最上層的小面板出現。若要完整使用 Pluely，請在「系統設定 > 隱私權與安全性」中授予以下權限：

麥克風：聆聽模式和按住說話都需要。
螢幕錄影：擷取系統音訊（也就是通話另一方的聲音）和拍攝截圖都需要。
輔助使用：部分快速鍵和浮動視窗的行為可能會要求這項權限；出現提示時請授予。

授予「螢幕錄影」或「輔助使用」權限後，macOS 通常會請你結束並重新打開 Pluely，權限才會生效。

5. 啟用授權

在 Pluely 裡面購買的嗎？那你已經完成了：授權會在那台電腦上自動啟用。如果是在網站上購買，或先收到授權電子郵件，請開啟儀表板（浮動視窗左上角的首頁圖示，或儀表板標籤），把郵件中的金鑰貼到首頁的授權金鑰欄位，然後按一下啟用授權。使用自己金鑰的設定可以略過這一步，改為連接本機 CLI，例如 Claude Code、Gemini CLI、OpenAI Codex、Qwen Code 或 Ollama。

疑難排解

「無法打開 Pluely，因為它來自未識別的開發者」：你使用的是 1.1.0 以前的版本，或不是從 pluely.com 取得的拷貝；請下載最新版本，或依照上方「如果 macOS 仍然顯示警告」的步驟操作。
聆聽模式只聽得到我的聲音，聽不到對方：缺少「螢幕錄影」權限，或授權後沒有依要求重新啟動。請重新檢查「系統設定 > 隱私權與安全性 > 螢幕錄影」，把 Pluely 關閉再開啟，然後結束並重新打開 Pluely。
啟動後沒有出現浮動視窗：檢查 Pluely 是否已在背景執行（看看選單列或「活動監視器」），然後重新啟動。
鍵盤快速鍵沒有反應：可能需要「輔助使用」權限；請在「系統設定 > 隱私權與安全性 > 輔助使用」中授予，然後重新啟動 Pluely。