ZacharyZhang-NY/OmaPhoto · 上手攻略
- 仓库：ZacharyZhang-NY/OmaPhoto
- 链接：https://github.com/ZacharyZhang-NY/OmaPhoto
- 分类：图像编辑 / Linux 桌面工具
- 作者：Tom
- 更新：2026-09-28
§0 速览
OmaPhoto 是 macOS 上的专业图层图像编辑软件 Compositor 的 Linux 移植版，优先面向 Omarchy 桌面环境。采用 Qt 6.4+ / C++20 构建，支持完整的图层、蒙版、选区、滤镜体系，可读写 Compositor 的 .comp 项目文件，设计师可以在 macOS 和 Linux 之间无缝迁移工作流。
§1 是什么 / 解决什么问题
Compositor（Wonder Assembly 出品）是 macOS 上的专业级图层编辑器，其源码是 OmaPhoto 的规格定义。OmaPhoto 完整移植了其工具集、菜单和快捷键（Ctrl 替代 ⌘，Alt 替代 ⌥），直接读取和写入 Compositor 的 .comp 项目文件——这意味着一个设计师在 macOS 上开的项目，可以直接在 Linux 上继续编辑，反之亦然。
解决的核心问题： - Linux 生态缺少专业级图层编辑器（对标 Photoshop / Affinity Photo 级别） - Compositor 用户想迁移到 Linux 但不想放弃已有项目 - Omarchy 桌面用户需要与系统主题深度整合的图像编辑工具
不是：轻量图片查看器、RAW 处理工作流（LibRaw 支持但非主业）、AI 生成工具。
§2 快速安装
⚠️ 以下安装方式针对 x86_64 架构，Apple Silicon / ARM 暂无官方包。
Arch Linux / Omarchy
curl -fsSLO https://raw.githubusercontent.com/ZacharyZhang-NY/OmaPhoto/main/scripts/install/arch.sh && bash arch.sh
Ubuntu 24.04 / 26.04 LTS（含 Linux Mint 22、Pop!_OS 24.04 等衍生版）
curl -fsSLO https://raw.githubusercontent.com/ZacharyZhang-NY/OmaPhoto/main/scripts/install/ubuntu.sh && bash ubuntu.sh
⚠️ 注意：Ubuntu 安装脚本固定链接 Ubuntu 官方仓库的 Qt 依赖库版本。如果你在用其他 Ubuntu 版本或 Debian，建议从源码构建（见下方"源码构建"）。
Fedora
curl -fsSLO https://raw.githubusercontent.com/ZacharyZhang-NY/OmaPhoto/main/scripts/install/fedora.sh && bash fedora.sh
⚠️ Fedora 自身的 libheif 无法解码 HEVC/HEIC。若需导入 HEIC 格式照片，需先添加 RPM Fusion 仓库并安装
libheif-freeworld，安装脚本会有提示。
NixOS
curl -fsSLO https://raw.githubusercontent.com/ZacharyZhang-NY/OmaPhoto/main/scripts/install/nixos.sh && bash nixos.sh
或直接在 configuration.nix 中添加为 flake input：
{
inputs.omaphoto.url = "github:ZacharyZhang-NY/OmaPhoto/<tag>";
outputs = { self, nixpkgs, omaphoto }: {
packages.x86_64-linux.default = omaphoto.packages.x86_64-linux.default;
};
}
源码构建（通用 Linux，依赖 Qt 6.4+）
# 依赖：CMake, Ninja, Qt 6.4+ (Widgets, Concurrent, image formats),
# libheif, LibRaw, fontconfig, ONNX Runtime
git clone https://github.com/ZacharyZhang-NY/OmaPhoto.git
cd OmaPhoto
mkdir build && cd build
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
ninja
若要启用"移除背景"功能（基于 U²-Net ONNX 模型），额外指定模型路径：
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DOMAPHOTO_MODEL=/path/to/u2net.onnx ..
§3 核心用法
3.1 基本操作
| 操作 | 快捷键（macOS 风格） | Linux 对应 |
|---|---|---|
| 新建图层 | ⌘ + N | Ctrl + N |
| 合并图层 | ⌘ + E | Ctrl + E |
| 填充 | ⌘ + F | Ctrl + F |
| 自由变换 | ⌘ + T | Ctrl + T |
| 撤销 | ⌘ + Z | Ctrl + Z |
| 重做 | ⌘ + ⇧ + Z | Ctrl + Shift + Z |
⚠️ 快捷键对照：macOS 的 ⌘ 对应 Linux 的 Ctrl，⌥ 对应 Alt。
3.2 图层与蒙版
- 图层类型：普通图层、图层文件夹、调整图层（Levels、Curves、Hue/Saturation、Exposure、Gradient Map、Grain）
- 蒙版：图层蒙版、剪贴蒙版、图层效果（描边、内阴影、颜色叠加、投影）
- 选区工具：矩形/椭圆选取框、套索、魔棒、从图层加载选区、扩展/收缩选区
3.3 画笔与修饰工具
| 工具 | 说明 |
|---|---|
| 画笔 / 橡皮擦 | 可调大小、硬度、流量 |
| 斑点修复 | 去除污点、杂物 |
| 克隆图章 | 按源区域仿制 |
| 涂抹 / 液化 | 推拉像素 |
| 模糊 / 锐化 | 高斯模糊、运动模糊 |
| 渐变 / 形状 / 文字 | 矢量+像素混合 |
3.4 滤镜
- 高斯模糊 / 运动模糊
- 噪点（添加/去除）
- 镜头校正
- 内容感知填充（Content-Aware Fill）
- 移除背景（U²-Net on ONNX Runtime，离线运行，无需联网）
⚠️ "移除背景"功能需要提前下载 U²-Net ONNX 模型文件，并在编译时通过
-DOMAPHOTO_MODEL指定路径。模型文件不在安装包内，需自行准备。
3.5 文件导入导出
支持导入：JPEG、PNG、TIFF、HEIC（需 HEVC 解码器）、Photoshop 文件（.psd）、相机 RAW（LibRaw）
支持导出：PNG、JPEG（质量可调）
§4 典型适用场景
- Compositor 用户跨平台迁移：macOS 项目直接 Linux 继续编辑，不用重做
- Omarchy 桌面用户：与系统主题深度整合，编辑器界面随桌面主题切换
- Linux 专业图像编辑：缺少 Affinity Photo / Photoshop for Linux 的替代方案
- 离线 AI 抠图：U²-Net 模型本地运行，不上传图片到云端，适合隐私敏感场景
- 图层密集型 UI 设计：支持图层文件夹、蒙版、调整图层，适合做 App UI 或游戏资源
§5 坑与注意
| 坑点 | 说明 |
|---|---|
| 无 x86_64 以外架构包 | Apple Silicon (M1-M4)、ARM、RISC-V 均无官方包，需自行交叉编译 |
| HEIC 导入依赖 HEVC 解码 | Fedora 需装 libheif-freeworld，Ubuntu 24.04+ 通常自带，其他发行版需自查 |
| U²-Net 模型需手动下载 | 安装包不包含模型文件；移除背景功能开箱不可用，需自行准备 .onnx 文件 |
| Ubuntu 版本锁定依赖 | 安装脚本写死 Ubuntu 24.04/26.04 的 Qt 库版本，其他版本建议源码编译 |
| 不包含 AI 生成能力 | 这是编辑器，不是 Midjourney / DALL-E 的替代品；滤镜只是传统图像处理 |
项目文件 .comp 兼容性 |
仅与 Compositor（macOS）互通，与 Photoshop .psd 虽然可导入但图层结构未必完全对应 |
| 仍处于活跃开发 | 非成熟商业软件，部分工具链和滤镜可能偶有崩溃，建议重要项目勤保存 |
§6 与同类对比
| 维度 | OmaPhoto | GIMP | Krita | Photoshop (macOS/Win) |
|---|---|---|---|---|
| 授权 | MIT | GPL | GPL | 订阅付费 |
| 平台 | Linux | 全平台 | 全平台 | macOS/Windows |
| Compositor 互通 | ✅ .comp 直读/写 |
❌ | ❌ | ❌ |
| 图层文件夹 | ✅ | ✅ | ✅ | ✅ |
| 调整图层 | ✅ | 有限 | ✅ | ✅ |
| AI 抠图（离线） | ✅ U²-Net | ❌ | ❌ | ✅（需云端） |
| 蒙版/剪贴蒙版 | ✅ | ✅ | ✅ | ✅ |
| RAW 支持 | ✅ | ✅ | ✅ | ✅ |
| macOS/Linux 互通 | ✅（via Compositor） | ❌ | ❌ | ❌ |
| 成熟度 | 早期项目 | 非常成熟 | 成熟 | 非常成熟 |
一句话结论： 如果你是 Compositor 用户想转到 Linux，OmaPhoto 是唯一选择；如果你是 Linux 用户在找专业图像编辑器，OmaPhoto 功能比 GIMP 更接近 Photoshop 但成熟度远不及 Krita——适合作为补充工具，而非主力。
§7 一句话推荐结论
Compositor 用户的 Linux 唯一出口，或 Omarchy 爱好者的专业图层编辑器，但对普通 Linux 用户而言成熟度尚需观望——建议先用 AppImage / 二进制包试水，重要项目保留 .comp 格式备份。