Paneflow 提供适用于 x86_64 和 ARM64（aarch64）的 Linux 安装包。
在下方选择适合发行版的格式。安装这些软件包不需要 Rust 或构建工具。
选择安装格式
| 发行版或安装方式 | 格式 | 更新方式 |
|---|---|---|
| Ubuntu、Debian | .deb | 首次安装后通过 apt 更新 |
| Fedora、openSUSE | .rpm | 首次安装后通过 dnf 或 zypper 更新 |
| 不安装系统软件包，直接运行下载的文件 | AppImage | 应用内更新 |
| Arch 或安装到主目录 | .tar.gz | 应用内更新或安装新版压缩包 |
Paneflow 需要图形会话和支持 Vulkan 的 GPU 驱动。.deb 和 .rpm 软件包会声明
所需的系统库依赖，但仍需要可用的 GPU 驱动。使用 AppImage 和 .tar.gz 时，
请检查是否已安装 Vulkan 加载器：Debian 和 Ubuntu 使用 libvulkan1，
Fedora 使用 vulkan-loader，Arch 使用 vulkan-icd-loader。
遇到图形错误时，参阅 Vulkan 故障排除指南。
确保已安装 curl，然后在要存放安装包的文件夹中，使用 Bash 执行下载和安装命令。
各下载命令块会检测处理器架构并获取最新发布版本。
选择一种格式即可，无需安装全部 4 种格式。
如何把 Paneflow 作为 AppImage 安装？
使用 AppImage 可以直接运行 Paneflow，无需安装系统软件包或使用 sudo。
下载文件、赋予执行权限，然后启动：
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.AppImage"
chmod +x "paneflow-${VERSION}-${ARCH}.AppImage"
./"paneflow-${VERSION}-${ARCH}.AppImage"如果启动时出现 dlopen(): error loading libfuse.so.2，请在不使用 FUSE 的情况下运行 AppImage：
./"paneflow-${VERSION}-${ARCH}.AppImage" --appimage-extract-and-run在 Ubuntu 24.04 上，可以用 sudo apt install libfuse2t64 安装 FUSE 2 库，
然后正常启动 AppImage。其他发行版请参阅
AppImage 的 FUSE 说明。
要使用 paneflow 命令，将 AppImage 移动到 ~/.local/bin，并重命名为 paneflow：
mkdir -p ~/.local/bin
mv "paneflow-${VERSION}-${ARCH}.AppImage" ~/.local/bin/paneflow
chmod +x ~/.local/bin/paneflow如果 shell 找不到命令，请按照下方的 PATH 说明操作。移动文件后，如果仍需在没有 FUSE 的情况下运行，
使用 ~/.local/bin/paneflow --appimage-extract-and-run。
Paneflow 默认将设置和工作区状态保存在 ~/.paneflow 中，与 AppImage 文件分开。
参阅配置指南。
如何在 Ubuntu 或 Debian 上安装 Paneflow？
下载适合处理器的 .deb，并用 apt 安装：
DEB_ARCH="$(dpkg --print-architecture)"
case "$DEB_ARCH" in
amd64) ARCH="x86_64" ;;
arm64) ARCH="aarch64" ;;
*) echo "Unsupported architecture: $DEB_ARCH" >&2; exit 1 ;;
esac
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.deb"
sudo apt install "./paneflow-${VERSION}-${ARCH}.deb"软件包将 paneflow 安装到 /usr/bin/paneflow，并注册 Paneflow 软件包仓库。
后续更新时，先运行 sudo apt update，再运行 sudo apt upgrade paneflow。
卸载时运行 sudo apt remove paneflow。如果还要删除 Paneflow 仓库配置和签名密钥，
使用 sudo apt purge paneflow。
如何在 Fedora 或 openSUSE 上安装 Paneflow？
下载适合处理器的 .rpm。在 Fedora 上，用 dnf 安装。
在 openSUSE 上，执行命令块前，先按下方说明替换最后一行安装命令：
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.rpm"
sudo dnf install "./paneflow-${VERSION}-${ARCH}.rpm"在 openSUSE 上，将最后一行 sudo dnf install 替换为：
sudo zypper install "./paneflow-${VERSION}-${ARCH}.rpm"软件包会注册 Paneflow RPM 仓库。后续更新时，在 Fedora 上使用
sudo dnf upgrade paneflow，在 openSUSE 上使用 sudo zypper update paneflow。
如何从 tarball 安装 Paneflow？
要安装到主目录（包括在 Arch 上），使用 .tar.gz 压缩包。
下载并解压，然后运行其中的安装脚本：
ARCH="$(uname -m)"
[ "$ARCH" = "arm64" ] && ARCH="aarch64"
VERSION="$(curl -fsSL https://api.github.com/repos/arthjean/paneflow/releases/latest | sed -nE 's/.*"tag_name": "v([^"]+)".*/\1/p')"
curl -fLO "https://github.com/arthjean/paneflow/releases/download/v${VERSION}/paneflow-${VERSION}-${ARCH}.tar.gz"
tar -xzf "paneflow-${VERSION}-${ARCH}.tar.gz"
cd paneflow.app
./install.sh安装脚本将应用复制到 ~/.local/paneflow.app，创建 ~/.local/bin/paneflow 符号链接，
并在 ~/.local/share 下添加应用启动器和图标。运行脚本时无需使用 sudo。
如何验证安装？
打开终端并运行：
paneflow --version
paneflow第一条命令应显示已安装的版本。第二条应打开 Paneflow 窗口。如果找不到命令， 请按照下方的 PATH 说明操作。如果窗口没有打开，参阅启动和图形故障排除指南。
Paneflow 打开后，按照入门指南启动第一个智能体。 CLI 智能体需要单独安装，并按照各自的说明登录。
如果 paneflow 不在我的 PATH 上怎么办？
以下步骤适用于 AppImage 和 .tar.gz。如果通过 .deb 或 .rpm 安装，
打开新终端并运行 /usr/bin/paneflow --version。如果文件不存在，重新安装软件包。
如果 shell 显示 command not found，先用 ls -l ~/.local/bin/paneflow 检查文件或符号链接是否存在。
如果不存在，重新执行上方移动 AppImage 的步骤或 .tar.gz 安装步骤。
如果文件存在但仍找不到命令，将 ~/.local/bin 添加到 shell 的 PATH。
仅执行适合所用 shell 的命令块，执行一次即可：
Bash（~/.bashrc）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcZsh（~/.zshrc）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcFish（~/.config/fish/config.fish）：
fish_add_path ~/.local/bin打开新终端，再次运行 paneflow --version。如果仍然失败，参阅
PATH 故障排除指南。