PhotoCraft Linux：安装前提与排错

PhotoCraft 能在 Linux 上运行吗？

官方发布提供 Linux x86_64 和 aarch64 的多种桌面文件。有安装包是上游事实，不代表你的发行版、GPU 和桌面会话已经验证可用。本页说明前提和已记录的失败，完整文件表在下载页。

先核对 CPU 与运行环境

64 位 Intel / AMD 选择 x86_64，ARM64 选择 aarch64。发布文档写明主要原生 Linux 构建需要 glibc 2.35 或更新版本，RISC-V 压缩包另需 glibc 2.39。X11 / Wayland、图形与字体库也属于运行前提。Flatpak 通过 freedesktop 运行时提供库，但仍需要可用的主机图形会话。AppImage 并不独立于所有系统库。

按发行版选择文件，包括 Arch

无需发行版专用包时，可选官方 AppImage、压缩包或 Flatpak。官方 .deb 面向 Debian / Ubuntu 系包管理器，.rpm 面向列出的 RPM 发行版。Arch 用户在本指南中使用官方便携格式或 Flatpak，不推荐未经核对的 AUR 或第三方构建。在下载页同时核对 CPU 与版本；遵循发行版的包管理说明，不强行把 .deb 或 .rpm 安装到 Arch。

安装官方 Flatpak 包

按发行版说明安装 Flatpak 后，从官方发布获取 photocraft-0.8.2-linux-x86_64.flatpak。以下示例用于 x86_64，并假设终端位于文件所在文件夹；ARM64 请换成实际的 aarch64 文件名。Flatpak 可能提示安装 freedesktop 运行时，请核对提示。这些命令依据上游文档，本站未执行。

flatpak install --user photocraft-0.8.2-linux-x86_64.flatpak
flatpak run ai.storyteller.photocraft

Wayland 拖放失败时

README 记录了原生 Wayland 文件拖放缺失。可用 File > Open，或在文件管理器复制图像后按 Ctrl+V 粘贴。如果已有 XWayland 且确实需要拖放，下方上游 Flatpak 命令改用 X11。这是针对拖放的办法，不是所有启动或渲染错误的通用修复。

flatpak run --nosocket=wayland --socket=x11 ai.storyteller.photocraft

了解 AppImage 的桌面集成

根据 README，AppImage 首次运行会在 ~/.local/share 注册启动项和图标。若希望跳过注册，可在启动时设置 PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1；具体文件和撤销方法见官方发布文档。它会改变本地用户目录，免安装不代表完全不写入文件。

用小型非敏感文档核对

确认预期版本能在当前桌面会话启动，打开非敏感副本，核对字体与基本编辑，另存输出后重新打开。记录发行版、CPU、包格式、会话和 GPU。仅启动成功不证明 PSD 兼容或适合正式生产。

停止并记录具体失败

如果架构不符、运行时缺失、应用崩溃或渲染异常，停止处理工作文档。保留错误文字和环境信息，核对官方 README 与发布说明。不为绕过错误替换系统 glibc、关闭平台保护或安装来源不明的库包。发行版专属依赖问题需要单独诊断。