快速入门

在 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。