Paneflow 为 x86_64 和 aarch64 发布四种 Linux 格式。
如果想最快开始，用 AppImage；如果想走发行版包管理，用对应的系统包；
如果需要用户本地、可脚本化的安装，用 tarball。
| 发行版 | 推荐路径 | 更新方式 |
|---|---|---|
| 任何现代 Linux | AppImage | 应用内 AppImage 更新 |
| Ubuntu、Debian | .deb | 首次安装后使用 apt upgrade paneflow |
| Fedora、openSUSE | .rpm | 首次安装后使用 dnf upgrade paneflow 或 zypper update paneflow |
| Arch、自定义安装、CI 镜像 | .tar.gz | 替换为更新的 tarball |
Paneflow 需要 Vulkan。系统包会声明常见 GUI 依赖和 Vulkan loader，
但你的机器仍然需要可用的 GPU 驱动。使用 AppImage 和 tarball 时，
请确认发行版已经安装 Vulkan loader：Debian 系为 libvulkan1，
Fedora 为 vulkan-loader，Arch 为 vulkan-icd-loader。
如何把 Paneflow 作为 AppImage 安装？
AppImage 是 Linux 默认下载项：不需要 root，不需要包管理器，也不会在 你放置它的目录之外写入文件。
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"要从任意终端启动它，把它移动到 ~/.local/bin：
mkdir -p ~/.local/bin
mv "paneflow-${VERSION}-${ARCH}.AppImage" ~/.local/bin/paneflow
chmod +x ~/.local/bin/paneflowUbuntu 24.04 和其他较新的发行版默认不再安装 FUSE 2。如果 AppImage
因为 dlopen(): error loading libfuse.so.2 失败，请使用
extract-and-run 回退方式运行：
./"paneflow-${VERSION}-${ARCH}.AppImage" --appimage-extract-and-run在 Ubuntu 上，也可以一次性安装 FUSE 2：
sudo apt install libfuse2t64。
如何在 Ubuntu 或 Debian 上安装 Paneflow？
下载与你 CPU 架构匹配的最新 .deb，并用 apt 安装。首次安装也会
注册 Paneflow 软件包仓库，因此后续更新可以通过 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"二进制会安装到 /usr/bin/paneflow。
使用 sudo apt remove paneflow 移除 Paneflow。如果还想删除
Paneflow apt source 和 keyring，请使用 sudo apt purge paneflow。
如何在 Fedora 或 openSUSE 上安装 Paneflow？
下载最新 .rpm，并用你的发行版包管理器安装。首次安装也会注册
Paneflow RPM 仓库，供后续更新使用。
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 上，最后一行使用 zypper：
sudo zypper install "./paneflow-${VERSION}-${ARCH}.rpm"如何从 tarball 安装 Paneflow？
Arch、CI 镜像，或不想使用系统包的用户本地安装，可以使用 tarball。
tarball 会解压出 paneflow.app/ 文件夹，其中包含 bin/paneflow、
desktop 元数据、图标和安装脚本。
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 symlink，并把 desktop 文件安装到
~/.local/share。它不会使用 sudo。
如何验证安装？
运行：
paneflow --version
paneflow如果 paneflow --version 打印出版本，并且 paneflow 打开 workspace，
安装就成功了。首次运行会打开一个空 workspace，里面有一个 shell pane。
按 Ctrl+Shift+D 可以水平分屏，按 Ctrl+Shift+E 可以垂直分屏。
下一步：阅读功能导览，打开 配置指南，或使用 故障排除处理 Vulkan、Wayland 和 PATH 问题。
如果 paneflow 不在我的 PATH 上怎么办？
如果 paneflow --version 返回 command not found，说明二进制不在
shell 的 PATH 中。这通常发生在 AppImage 或 tarball 安装后，
因为 ~/.local/bin 没有在 shell 启动时加载。
为你的 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。如果仍然失败，用
ls -l ~/.local/bin/paneflow 确认 symlink 是否存在。