下载 PhotoCraft Linux 版：安装教程

PhotoCraft 的 Linux 版提供 AppImage、.deb、.rpm、Flatpak 单文件包和普通 tar.gz 五种格式，每种都有 x86_64 和 aarch64（ARM64）两个架构。Ubuntu / Debian 用户选 .deb 最省事，Fedora / openSUSE 选 .rpm，其他发行版用 AppImage，免安装、不需要 root。上方表格中的文件都直接链接到 GitHub 官方发布页。PhotoCraft 目前仍是早期 alpha 版本。

该下载哪个文件

先用 uname -m 确认架构：输出 x86_64 是普通 Intel / AMD 电脑，aarch64 是 64 位 ARM 设备。

格式	适合	说明
.deb	Debian、Ubuntu、Linux Mint、Pop!_OS、elementary	自动注册菜单、文件类型和图标，可干净卸载
.rpm	Fedora、RHEL 及其衍生版、openSUSE	同上
.AppImage	任意发行版，免安装、免 root	可通过 .zsync 增量更新
.flatpak	喜欢沙盒化 Flatpak 应用的用户	需要 Flathub 上的 freedesktop 运行时
.tar.gz	习惯自己管理 /opt 或 ~/.local 的用户	内含 bin/ 和 share/ 目录

系统要求： 所有 Linux 版本都在 Ubuntu 22.04 上编译，需要 glibc 2.35 或更新：Ubuntu 22.04+、Debian 12+、Fedora 36+、RHEL 10、openSUSE Tumbleweed。X11、Wayland、xkbcommon、Vulkan 和 EGL 在运行时从系统加载，显卡驱动也来自系统。.deb 和 .rpm 已把这些声明为依赖，Flatpak 由运行时提供；AppImage 和 tar.gz 无法声明依赖，所以 PhotoCraft 会在开窗口前检查所需的库，缺了就打印应该安装的包名并退出，而不是直接崩溃。画布通过 wgpu 在 Vulkan 上渲染，依次以 GL 和 CPU 渲染作为后备。

安装 .deb（Debian、Ubuntu）

sudo apt install ./photocraft-0.5.0-linux-x86_64.deb

注意前面的 ./，这样 apt 才会把它当作本地文件安装并自动补齐依赖。之后可以从应用菜单启动，或在终端运行 photocraft。软件包会安装 /usr/bin/photocraft 和 /usr/bin/photocraft-cli。

安装 .rpm（Fedora、openSUSE）

sudo dnf install ./photocraft-0.5.0-linux-x86_64.rpm      # Fedora、RHEL
sudo zypper install ./photocraft-0.5.0-linux-x86_64.rpm   # openSUSE

运行 AppImage

chmod +x photocraft-0.5.0-linux-x86_64.AppImage
./photocraft-0.5.0-linux-x86_64.AppImage

AppImage 使用静态运行时，不依赖 libfuse2。从 v0.5.0 开始，首次运行时会在 ~/.local/share 里注册启动器和图标，PhotoCraft 会出现在应用菜单里，Wayland 的程序坞也会显示正确的图标，而不是通用的 Wayland 图标。移动 AppImage 位置后，下次启动会自动更新这条记录。不想要这个行为的话，设置环境变量 PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1。

安装 Flatpak 单文件包

README 里的命令对 v0.5.0 仍然有效：

flatpak install --user photocraft-0.5.0-linux-x86_64.flatpak   # ARM 用 -linux-aarch64
flatpak run ai.storyteller.photocraft

如果缺少 org.freedesktop.Platform//26.08 运行时，flatpak 会提示从 Flathub 下载，必要时先按 Flathub 设置指南添加仓库。沙盒权限包括：Wayland（X11 作后备）、GPU、对“图片”和“文档”目录的读写；其他文件一律通过系统文件选择器（portal）访问；没有网络权限。

Flathub 上有吗？ 没有。项目里已经有可提交 Flathub 的清单，但维护者在 #173 中表示要等应用更成熟再说；#1411（未关闭）提到 Flathub 的 AI 政策有了变化。另有第三方仓库 FlatPark（#322）以相同的应用 ID 打包了 PhotoCraft，它并非 PhotoCraft 团队运营，本站不推荐非官方渠道。由于 ID 相同，两者切换前需要先卸载已装的那一个。

使用 tar.gz

压缩包里是一个文件夹，含 bin/photocraft、bin/photocraft-cli 和 share/ 目录（桌面入口、图标、MIME 类型）。可以就地运行：

tar -xzf photocraft-0.5.0-linux-x86_64.tar.gz
./photocraft-0.5.0-linux-x86_64/bin/photocraft

也可以解压到 ~/.local，让程序落在 ~/.local/bin：

tar -xzf photocraft-0.5.0-linux-x86_64.tar.gz --strip-components 1 -C ~/.local

校验下载文件（SHA256）

从同一个发布页下载 SHA256SUMS.txt 放到同一目录，然后运行：

sha256sum -c --ignore-missing SHA256SUMS.txt

你下载的每个文件都应显示校验通过。

命令行工具

photocraft-cli 已经打包在内：.deb、.rpm 和 tar.gz 里它就在 photocraft 旁边（软件包安装为 /usr/bin/photocraft-cli）。Flatpak 用户这样调用：

flatpak run --command=photocraft-cli ai.storyteller.photocraft --version

AppImage 只会启动图形界面，需要 CLI 时请改用其他格式。

更新

• AppImage： AppImageUpdate、AppImageLauncher 等工具会读取 AppImage 内置的更新信息，只下载变化的数据块；也可以直接下载新文件。
• .deb / .rpm： 用同样的 apt / dnf / zypper 命令安装新包。
• Flatpak： 用 flatpak install --user 安装新版单文件包。

截至 v0.5.0 还没有内置的检查更新功能，新版本信息见本站的版本更新。

卸载

sudo apt remove photocraft                         # .deb
sudo dnf remove photocraft                         # .rpm（openSUSE 用 zypper remove）
flatpak uninstall --user ai.storyteller.photocraft # Flatpak

AppImage 删除文件后，再清理桌面集成：

rm ~/.local/share/applications/ai.storyteller.photocraft.desktop
find ~/.local/share/icons/hicolor -name 'ai.storyteller.photocraft*' -delete

设置保存在 ~/.config/photocraft（或 $XDG_CONFIG_HOME/photocraft）。

Linux 上的已知问题

Flatpak 版中文菜单显示方框：#1152，已关闭。0.5.0 的 Flatpak 在沙盒里找不到宿主机的中文字体，部分菜单项会显示成“□□”。修复在 0.5.0 发布之后才合并，下个版本生效。在此之前，中文用户建议改用 .deb、.rpm 或 AppImage，并确保系统装有 Noto Sans CJK 等中文字体（非 Flatpak 版本使用系统的 CJK 字体）。

Wayland 下拖放文件没反应：#386，未关闭。PhotoCraft 使用的窗口库还不支持 Wayland 拖放。可以用 文件 › 打开（File › Open），或在文件管理器里复制图片后按 Ctrl+V 粘贴。想用拖放的话，让 PhotoCraft 在 XWayland 下运行：

WAYLAND_DISPLAY= photocraft
WAYLAND_DISPLAY= ./photocraft-0.5.0-linux-x86_64.AppImage
flatpak run --nosocket=wayland --socket=x11 ai.storyteller.photocraft

v0.5.0 会在提示条里给出适合你安装方式的命令。主分支已在 首选项 › 性能（Preferences › Performance）里新增改用 X11 的选项，预计随下个版本发布。

Wayland 下数位笔无响应、没有压感：0.5.0 在 Wayland 下部分数位板完全没有笔输入（#1781，未关闭；#639，已关闭：主分支的修复会在检测到数位板时改用 Xwayland 打开窗口，随下个版本发布）。0.5.0 在 Linux 上拿不到压力和倾斜数据，笔画按满压力绘制（#79，未关闭）。

升级后无法启动（Arch 等）：#1461，未关闭。部分用户升级后报 no graphics adapter found 或 Device(Lost)，报告者清掉旧设置后恢复正常。建议先改名备份而不是直接删除：

mv ~/.config/photocraft ~/.config/photocraft.bak

也可以用 WGPU_BACKEND=vulkan（或 gl）指定后端，或用 photocraft --safe-gpu 以 CPU 渲染启动一次。

v0.5.0 已修复：Wayland 下文本框按键无限重复（#585），以及 AppImage 在程序坞显示通用 Wayland 图标（#593）。更多问题见故障排除。

FreeBSD

发布页里还有 FreeBSD 14 x86_64 的 tar.gz，目录结构对应 /usr/local。它的程序没有签名，请用 SHA256SUMS.txt 校验。README 给出的步骤：

pkg install libxkbcommon wayland libX11 libXcursor libXrandr libXi libxcb mesa-libs vulkan-loader gtk3 fontconfig freetype2 alsa-lib
tar -xzf photocraft-0.5.0-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local
photocraft

只从 GitHub 官方下载

photocraft.im 是非官方的社区指南，本站所有下载链接都指向官方 storytold/photocraft GitHub 发布页，官方的 getartcraft.com PhotoCraft 页面也链接到这里。其他渠道重新打包的版本没有经过 PhotoCraft 团队测试和发布，请谨慎使用。

官方版本已经内置简体中文界面，语言设为“自动”时会跟随系统语言，不需要任何“汉化版”，切换方法见界面语言设置。