开始之前
- x86_64 或 ARM64（aarch64）系统。另有 riscv64 的 tar 包，基于 Ubuntu 24.04 编译（需要 glibc 2.39 或更新）。
- 支持 Vulkan 的显卡驱动（Mesa 即可）。
最快的方法：AppImage
- 下载 AppImage. 从官方 GitHub Release 下载 photocraft-0.7.0-linux-x86_64.AppImage（ARM 设备下载 aarch64 的文件）。
- 加上可执行权限. 给文件加上可执行权限。命令
chmod +x photocraft-0.7.0-linux-x86_64.AppImage - 运行. 直接运行。第一次运行会在 ~/.local/share 下添加启动器和图标；不想要的话设置 PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1。命令
./photocraft-0.7.0-linux-x86_64.AppImage
其他安装包
Debian、Ubuntu、Linux Mint（.deb）
用 apt 安装，依赖会自动处理：
命令
sudo apt install ./photocraft-<version>-linux-x86_64.debFedora、RHEL、openSUSE（.rpm）
用 dnf 安装（openSUSE 用 zypper）：
命令
sudo dnf install ./photocraft-<version>-linux-x86_64.rpmFlatpak（沙盒）
需要 Flathub 的 freedesktop 运行时，flatpak 会提示一起安装：
命令
flatpak install --user photocraft-<version>-linux-x86_64.flatpak
flatpak run ai.storyteller.photocraftArch、Gentoo 等
用 AppImage，或者把 tar 包解压到任意位置，运行里面的 photocraft。
Wayland 下拖拽文件打不开
这是 PhotoCraft 用的窗口库的已知限制。可以用“文件 › 打开”，或者在文件管理器里复制图片后按 Ctrl+V 粘贴。想用拖拽的话，让 PhotoCraft 跑在 XWayland 下：
命令
WAYLAND_DISPLAY= photocraft
# Flatpak 版本
flatpak run --nosocket=wayland --socket=x11 ai.storyteller.photocraft更新 AppImage
每个版本都附带 .zsync 文件，用 AppImageUpdate 可以只下载变化的部分。
这个版本的官方文件 (0.7.0)
| 类型 | 架构 | 文件 | 大小 |
|---|---|---|---|
| AppImage | aarch64 | photocraft-0.7.0-linux-aarch64.AppImage | 66 MB |
| Flatpak | aarch64 | photocraft-0.7.0-linux-aarch64.flatpak | 51 MB |
| Debian/Ubuntu（.deb） | aarch64 | photocraft-0.7.0-linux-aarch64.deb | 71 MB |
| Fedora/RHEL（.rpm） | aarch64 | photocraft-0.7.0-linux-aarch64.rpm | 71 MB |
| tar 包 | aarch64 | photocraft-0.7.0-linux-aarch64.tar.gz | 69 MB |
| tar 包 | riscv64 | photocraft-0.7.0-linux-riscv64.tar.gz | 71 MB |
| AppImage | x86_64 | photocraft-0.7.0-linux-x86_64.AppImage | 69 MB |
| Flatpak | x86_64 | photocraft-0.7.0-linux-x86_64.flatpak | 55 MB |
| Debian/Ubuntu（.deb） | x86_64 | photocraft-0.7.0-linux-x86_64.deb | 74 MB |
| Fedora/RHEL（.rpm） | x86_64 | photocraft-0.7.0-linux-x86_64.rpm | 73 MB |
| tar 包 | x86_64 | photocraft-0.7.0-linux-x86_64.tar.gz | 73 MB |
常见问题
Flathub 或 Snap 商店里有 PhotoCraft 吗？
目前没有。Flatpak 是附在每个 GitHub Release 里的安装包文件，不是 Flathub 上架版本，也没有 Snap。
树莓派能跑吗？
官方有 aarch64 版本，树莓派 4 或 5 装 64 位系统、并且 Vulkan 驱动正常时应该能运行。我们还没实测，大文件也会比较慢。
装了 .deb 或 .rpm 后命令行工具在哪？
在 /usr/bin/photocraft-cli，已经在 PATH 里。