- 质量分：8
spark 评 Tom · 2026-09-28
被评对象：/shared/research-kb/organized/guides/zhangzhangny-omaphoto.md（作者 Tom，攻略）
原始选题：ZacharyZhang-NY/OmaPhoto（周增 +539 / Stars 177，趋势新近）
二、事实核查（对上游 README 逐条比对）
| 攻略声明 | 上游 README 实况 | 判定 |
|---|---|---|
| "Compositor（Wonder Assembly 出品），macOS 上 Swift 写的专业级图层编辑器" | "Compositor by Wonder Assembly, a macOS app written in Swift"（repo 链 roberttilton/Compositor） | ✅ 准确 |
| "Ctrl 替代 ⌘, Alt 替代 ⌥" | README 明示 | ✅ |
| ".comp 项目直读/写" | README 明示 | ✅ |
| 5 套安装脚本（Arch/Ubuntu/Fedora/NixOS/源码）路径 | 与 README 一一对应 | ✅ |
| "Ubuntu 安装脚本固定链接 Ubuntu 官方仓库的 Qt 依赖库版本" | README: "Each DEB names its Ubuntu release's libraries, so other Ubuntu releases and Debian build from source" | ✅ 措辞精准 |
| "Fedora 自身的 libheif 无法解码 HEVC/HEIC，需 RPM Fusion + libheif-freeworld" | README 原文印证 | ✅ |
| C++20 / Qt 6.4+ / CMake / Ninja / libheif / LibRaw / fontconfig / ONNX Runtime 依赖 | 与 README 原文完全一致 | ✅ |
DOMAPHOTO_MODEL 编译选项指向 U²-Net ONNX 模型 |
README 原文 | ✅ |
| 调整图层清单（Levels/Curves/Hue-Sat/Exposure/Gradient Map/Grain） | README 原文 | ✅ |
| 图层效果（描边/内阴影/颜色叠加/投影） | README 原文 | ✅ |
| 文件导入（JPEG/PNG/TIFF/HEIC/PSD/RAW），导出（PNG/JPEG） | README 原文 | ✅ |
| Apple Silicon / ARM 无官方包 | README: "Packages are built for x86_64" | ✅ |
| MIT 协议 + U²-Net(Apache-2.0) + ONNX Runtime(MIT) | README 末段 | ✅ |
结论：攻略未发现事实性错误；事实正确性表现优秀。
三、深度与覆盖评估
做得好的： - §0 速览、§2 安装、§3 用法（含快捷键对照表）、§4 典型场景、§5 坑点、§6 同类对比——结构与项目方提供的攻略模板一致。 - §5 坑点表把"模型需手动下载""Ubuntu 版本锁依赖""Fedora HEIC"都点出，对 Linux 用户非常实用。 - §6 同类对比表把 GIMP/Krita/Photoshop 都拉进来横向对比，"Compositor 互通" / "macOS↔Linux 互通" 这两条差异化卖点很清晰。 - 末尾"一句话结论"对读者画像做出分流建议（Compositor 用户 vs Linux 普通用户），避免一刀切。
深度不足的地方：
- 选题周增 +539/Stars 177，但攻略未给出趋势数据（Trending 周期、增长速度的解读），这是 Wave2 攻略的核心上下文，缺失使读者难以判断"为什么这个项目值得现在看"。
- 没提 Docker 构建路径（scripts/dev.sh build|test|run），这是 README 主推的"host 只需 Docker"的工作流，对不想手动装 Qt6.4+ 的用户更友好，应当作为前置推荐项。
- §3.1 的快捷键表只给了 6 条，建议补全 README "menus and its shortcuts" 的完整快捷键列表，或明确说明"完整列表见 README"。
- §3.4 提了"内容感知填充（Content-Aware Fill）"，但 README 上下文是该功能是相对新加入的；攻略没标注哪些滤镜是 1.0 / 早期就有的、哪些是近期新增，对"是否生产可用"的判断信息不全。
- §6 表格里"AI 抠图（离线）"一栏写 "✅ U²-Net"，对照 Photoshop 的 "✅（需云端）"——隐含对比立场，但攻略没交代二者精度差异；U²-Net 是 2020 年的小模型，对头发丝、复杂边缘的精度远不如 Adobe 的 Sensei/萤火，建议补一句精度提示避免误导。
四、可读性
- 标题层级、表格、警示块使用规范；中英术语对照（"剪贴蒙版""斑点修复""内容感知填充"）准确。
- 每节末尾有清晰的"是什么 / 解决什么 / 不是"或"适用场景"或"坑与注意"，便于 5 分钟读完。
- 没有发现错别字或断句问题。
五、与最新进展的差距
- README 提到 "scripts/dev.sh build|test|run" 是宿主侧 Docker 化的推荐开发流；攻略完全没提，对工程读者是显著缺口。
- README 提到 "SHA256SUMS" 校验；攻略只写了
curl | bash，对安全敏感的读者会皱眉。建议加一行 "安装脚本会自动校验 SHA256SUMS"，或至少在脚注提醒。 - 没引用任何 GitHub release、commit 或 issue 链接；项目仍在活跃开发中（如能给出最近 release tag / commit SHA），能让读者判断成熟度。
- 同期项目 robbietilton/Compositor（原生 macOS 端）当日 +0 stars（≈ 86 by evening）——上游实际上增速远低于 OmaPhoto 本体；攻略如果能在 §0 速览里点出"OmaPhoto 本体周增远超上游 Compositor"，能强化"独立项目、用户基础在快速迁移"的判断。
六、可执行修改建议（按优先级）
- （高优）补 Docker 流程：在 §2 末尾新增"如果不想装 Qt6.4+，推荐 Docker 构建流"小节，给出
scripts/dev.sh build/run三条命令。这是 README 重点强调的能力，缺失显著。 - （高优）补趋势数据：在 §0 加一句"该项目周增 +539 stars，Stars 177（截至 2026-09-28），增速远超上游 Compositor 本体同期 +0"。选题上下文是攻略价值的一部分。
- （中优）补精度提示：在 §3.4"移除背景"段落加一句"U²-Net 为 2020 年提出的轻量模型，对头发丝、半透明边缘的精度不如 Adobe Sensei / 萤火云端服务，生产场景建议人工复核"。
- （中优）补 release 链接与安全提示：在 §2 安装块顶部加一行"脚本会从 release 页下载并校验 SHA256SUMS，详见 https://github.com/ZacharyZhang-NY/OmaPhoto/releases"，既给链接又消解
curl|bash的安全顾虑。 - （低优）完善快捷键表：在 §3.1 末尾加一行"完整快捷键见 https://github.com/ZacharyZhang-NY/OmaPhoto#shortcuts"或 README 锚点。
- （低优）NixOS 示例微调：示例里
outputs = { self, nixpkgs, omaphoto }但并未使用nixpkgs，可改为{ self, omaphoto }，或显式nixpkgs.legacyPackages...的合并写法，避免误导。
七、总评
攻略结构工整、事实准确、坑点到位、对比表差异化卖点抓得准，对目标用户（Compositor 迁移者 / Omarchy 用户）的画像清晰。扣分点主要在：① 缺失选题趋势数据这一核心上下文；② 缺 Docker 这一上游重点推荐路径；③ 个别差异化对比（AI 抠图精度）未做精度提示。整体 8 分，属"可用、可发，补三处即可升 9 分"的水平。