快速入门

在 Linux 上安装 Pluely v1

Pluely v1 支持 Linux，功能与 macOS 和 Windows 版本相同：始终置顶的悬浮窗、聆听模式、截屏，以及 Pluely 托管模型。本指南介绍如何安装软件包，并开启 Pluely 所需的权限。

1. 下载 Pluely

前往 pluely.com/downloads，选择与你的发行版相匹配的 Linux 软件包。

2. 安装软件包

用发行版自带的软件包安装器打开下载的文件，或在终端中用包管理器安装。
按照屏幕上的提示完成安装。
安装完成后，在应用程序菜单中找到 Pluely，通常位于“工具”或“办公”等分类下。

3. 启动 Pluely

从应用程序菜单打开 Pluely。启动后，悬浮窗会以一个始终置顶的小面板出现。使用应用内显示的键盘快捷键来显示或隐藏它。

4. 授予权限

Linux 上的权限提示因发行版和桌面环境而异，但 Pluely 需要的访问权限与 macOS 和 Windows 上相同，分为两类：

麦克风：聆听模式和按键说话必需。如果你的桌面环境有隐私或声音设置面板，请在其中确认 Pluely 已被允许使用麦克风。
屏幕访问：用于系统音频捕获（听到通话中对方的声音）和截屏。在某些桌面环境中，这只是一次性提示；在另一些桌面环境中，你可能需要在系统的隐私或屏幕共享设置中手动开启。

如果你的发行版使用基于 portal 的权限系统，你可能会看到一个一次性对话框，询问是否允许 Pluely 共享你的屏幕或音频。请接受，以便聆听模式和截屏正常工作。

5. 激活许可证

如果你是在 Pluely 内购买的 Pro，许可证已经在这台电脑上激活。否则，请打开仪表板（悬浮窗左上角的首页图标，或仪表板按钮），将许可证邮件中的密钥粘贴到首页的许可证密钥字段，然后点击激活许可证。如果你更想使用自己的服务商密钥，或运行 Claude Code、Gemini CLI、OpenAI Codex、Qwen Code、Ollama 等本地 CLI，不激活许可证也能使用 Pluely。

故障排除

软件包无法安装：确认你从 pluely.com/downloads 下载了适合你发行版的软件包格式，并查看包管理器的错误输出，看是否缺少依赖。
没有出现麦克风或屏幕权限提示：有些桌面环境不会自动提示。请打开系统的隐私、声音或屏幕共享设置，手动允许 Pluely。
聆听模式只能收到我的声音：很可能缺少屏幕/音频共享权限。请检查桌面环境的屏幕共享或隐私设置，然后重新启动 Pluely。
启动时悬浮窗没有显示：检查 Pluely 是否已在后台运行，然后使用键盘快捷键把悬浮窗调到前台。
全局键盘快捷键没有反应：某些 Linux 桌面环境要求在系统设置中手动注册快捷键。请检查 Pluely 的快捷键设置以及桌面环境的键盘快捷键面板。