1. 匹配架构与安装包格式
运行 uname -m 查看架构。x86_64 与 aarch64 需要不同发布文件，然后按习惯选择软件包：
| 格式 | 常见用途 |
|---|---|
| AppImage | 允许执行后运行单独的应用文件。 |
| DEB | 适用于 Debian / Ubuntu 的包管理。 |
| RPM | 适用于 Fedora 及兼容的 RPM 发行版。 |
| Flatpak | 通过 Flatpak 及对应运行时、沙盒安装。 |
请阅读所选版本的兼容说明。包格式本身不能保证适用于所有发行版和 GPU。
2. 验证安装包
将下载文件的校验结果与对应版本清单中的条目比较，替换下面的示例文件名：
sha256sum ~/Downloads/photocraft-file.AppImage安装包与校验清单应来自同一官方发布。若不一致，重新下载后再继续。
3. 运行 AppImage
在文件管理器的文件属性中，允许作为程序执行。也可在终端中使用实际文件路径：
chmod +x ~/Downloads/photocraft-file.AppImage
~/Downloads/photocraft-file.AppImage以普通用户运行。失败时从终端启动以收集错误信息。不要把所有失败都归因于缺少依赖，架构与图形初始化也需要检查。
4. 安装 Flatpak 包
如果已配置 Flatpak，可以安装官方提供的包，将示例文件名替换为实际下载文件：
flatpak install --user ~/Downloads/photocraft-file.flatpak
flatpak run ai.storyteller.photocraft按 Flatpak 的提示处理运行时。对于 DEB 或 RPM，使用发行版的包管理器正常处理依赖。
5. Wayland 下无法拖放文件时
官方 README 记录了 Wayland 文件拖放限制。优先使用 File → Open，而不是拖入文件。反馈问题时记录会话是 Wayland 还是 X11。
打开文件的问题与启动失败、GPU 失败并不相同。先通过菜单打开小 PNG，再决定是否需要调整显示会话或图形设置。
来源与适用范围
依据官方文档与本站编辑建议整理，不是全面兼容性实测。菜单名称和行为可能随版本变化。