PhotoCraft 源码视角：631 个菜单项背后，纯 Rust 版 Photoshop 的真实完成度

PhotoCraft 源码视角：631 个菜单项背后，纯 Rust 版 Photoshop 的真实完成度

【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft

PhotoCraft 是 ArtCraft 团队用纯 Rust 从零（clean-room，即只依据公开规范与观察行为实现、不复制任何专有代码）重写的开源图像编辑器：原生读写 PSD/PSB 分层文档、wgpu GPU 渲染管线、写时复制瓦片（copy-on-write tiles，一种让撤销变廉价的内存结构）、以及可整套编译成 WebAssembly 跑进浏览器的能力。要判断它"能用"到什么程度，不能只看 README 的功能清单，得看它自己维护的那套可复算度量。

定位与预期校准：early alpha，"wiring 不度量行为"

技术栈的选型逻辑在 ROADMAP.md 与 docs/scorecard.md 里都很直白：引擎层是纯数据的文档模型加命令引擎，UI 是薄薄一层 egui；24 个 crate 之间用编译期属性（never-crash lint）强制分层，30 个 crate 全部挂了 panic 防护。这套结构的收益在文档里被明确表述为：UI、CLI、JSON 控制通道、MCP 服务器全部调用同一个命令注册表，"任何你能点的，脚本也能做"。

边界声明直接引官方 README 的状态栏原文："PhotoCraft is in early alpha……it is not yet a Photoshop replacement for daily professional work"（尚不是日常专业工作的 Photoshop 替代品），最大的缺口是 AI/生成式功能、缺失的工具、排版与专业工作流深度、插件兼容；README 还特意补了一句——"每个 Photoshop 菜单项都接到了命令，但那度量的是 wiring（是否接上），不是 behaviour（行为是否一致）"。

建立第一印象的核心数字（口径：ROADMAP 最后更新 2026-10-17，PhotoCraft 0.6.0，对照对象为 Photoshop 2026 27.11.0）：

指标	数值	口径
功能表面积（feature breadth）	~76%	部分实测：菜单 628/628、工具 56/68、面板 30/35
真实工作就绪度（ready for real work）	~45%（40–50%）	官方加权估计，非实测
基础用户就绪度（essentials user）	~61%（55–67%）	官方估计
打开 issue 数	953	2026-10-13 口径
测试规模	1,700+ 测试	README，含语料往返与合成器 oracle

一个容易忽略的信号：进度日志里 2026-10-05（0.2.0）的自评是"ready 25–35%"，两周后的 0.6.0 重测才到 ~45%。数字在涨，但涨幅本身就是这个项目迭代速度的注脚——首次提交于 2026-09-30，到 2026-10-10 已有 1,004 个合并 PR。

能力维度拆解：声称、实测与差距归因

PSD 兼容性：结构往返很强，"重渲染 Photoshop 的效果"还很弱

声称：README 的 "PSD without compromise" 一节说，PSD 支持是独立 crate，依据 Adobe 公开规范编写，未修改文件的往返渲染一致率是 psd-tools 测试集 307/309；而脱离文档模型、纯解析-写回的photocraft-psdcrate 能做到字节级逐位复现。book/src/formats/psd-psb.md 同时写明了解析器的防御性上限：文档单边不超过 300,000 像素、单次解码数据不超过 2 GiB、ActionDescriptor 嵌套不超过 64 层、行数与解码长度全部用 checked 运算——文档自己承认这些是"降低风险，而非证明对一切恶意文件安全"。

实测：当前仓库的 CI 语料下限（corpus floors，docs/scorecard.md 由cargo xtask scorecard生成）是：

语料	文件数	Oracle 渲染通过下限	往返下限
io corpus（corpus/psd）	170	148	169
psd-tools corpus	309	249	308
Photoshop 自绘 oracle（corpus/photoshop）	256	190	258

差距归因：docs/gaps.md 的 G1 条目（"blocks beta" 级）写得很诚实——两个方向的缺口都存在：一是"Photoshop 拒收我们的文件"（#1281、#2469 用户报告，#2374 文本图层案例已于 2026-10-10 修复）；二是"我们用自家算法重渲染 Photoshop 的智能滤镜"只匹配 5/30。另外 FILE-216-4 一行直白地写着：目前没有任何测试把导出文件交给第三方编辑器打开验证——"round trip 只是我们的导出喂回我们的导入"。

双合成器架构：CPU 参考 oracle 与 GPU 路径互相测试，但 GPU 会崩

声称：README "Under the hood" 说有两个合成器——CPU 合成器充当参考 oracle，wgpu 合成器把画布放到 GPU（Metal/Vulkan/DX12/WebGPU），"二者互相测试"。这是同类 Rust 编辑器里少见的架构：CPU 路径不是降级方案，而是对 GPU 路径做正确性判据的角色。

实测：docs/scorecard.md 的 25 个性能预算场景里只有 3 个达标（22 个超标或失败）。最扎眼的两行：P12"150 层文档中用方向键微调"直接missing: panicked: wgpu error: Validation Error（GPU 路径崩溃）；P14"在 15000×10000 16-bit 文档上移动图层"p50 实测 2698 ms，预算 80 ms p95。

差距归因：ROADMAP.md 的 Upcoming 表把"22 个超标场景和 150 层 GPU 崩溃"列为里程碑 2（估计 200–350 小时）。工程上的补救是 apps/photocraft/src/gpu_startup.rs 里的回退链：驱动崩溃后，下一次启动自动回退到 CPU 渲染器；--safe-gpu参数可强制本次启动走 CPU（源码注释写明"for one launch"，即只作用于当次，不持久化）。

WASM 部署：23.9 MiB 的 Wasm 决定了托管策略

声称：整个引擎加 UI 编译到 WebAssembly，"runs in the browser"。

实测：packaging/web/README.md 给出了 2026-10-13（0.8.2）的实测数字：Wasm 原始 25,019,043 字节（23.9 MiB）。因为 Cloudflare Pages/Workers 对单个静态资源有 25 MiB 硬上限（0.2.0 之前发布的 25.8 MiB Wasm 被直接拒收，issue #198），官方打包脚本会把 Wasm 先 gzip、再切成不超过 20 MiB 的分片（part-aa、part-ab…），页面下载时拼回；并且package.sh会在任何站点文件超过 24 MiB 时直接让构建失败，防止再次越线。文档同时给了硬性清单：.wasm必须以application/wasm提供（否则浏览器拒绝流式编译）；index.html配no-cache，带 hash 的资产配max-age=31536000, immutable；不依赖SharedArrayBuffer，因此不需要COOP/COEP 头。

差距归因：文档没有回避代价——浏览器无 WebGPU 时静默回退 WebGL2，?webgl强制指定、?cpu强制最慢但最兼容的 CPU 画布路径；纯 HTTP 部署下 WebGPU 和剪贴板都不可用，必须走 HTTPS 或 localhost。好消息是public_url = "./"的相对路径设计让站点可以放在域名根、子路径或 CDN bucket 任意位置。

快捷键生态：.kys 导入是"按标签匹配"，且诚实列出边界

声称：README 说"从 ⌘J 到 ⇧⌘D，菜单、快捷键、面板位置都跟 Photoshop 对齐"。

实测：导入逻辑在引擎侧 crates/engine/src/kys.rs，.kys本质是 XML（<command kind="static" name="Gaussian Blur...">行加<shortcut>子节点）。源码注释写清了匹配规则：Photoshop 只按菜单文案命名命令，所以匹配靠标签近似；同名菜单项（比如两处都有的 "Levels..."）用"默认快捷键与导入键重合者优先"消歧；一条命令的多个快捷键里，第一个成为主键，其余进 alternates。测试样例（kys_import_tests.rs）里还特意覆盖了 Windows 保存的集合——那里的Ctrl对应 Mac 集合的Cmd，导入时会做映射。

差距归因：匹配不上的命令（Photoshop 脚本、Bridge、macOS 应用菜单等）不会静默丢弃，导入对话框会明确提示"N commands are not in PhotoCraft"。工具键（tool keys）当前版本可以导入（#5036：工具字母的改键成为 override，改回字母本身则清除）。另一条工程化的补救在 apps/photocraft/src/photoshop_settings.rs：首次启动时自动探测本机安装的 Photoshop，主动提出导入它正在使用的快捷键方案（Keyboard Shortcuts.psp，与.kys同构），但注释写得很清楚——"its live set is offered, never applied unasked"，必须用户确认。

上手路径与认知误区：文档里写了但极易被跳过的细节

误区一："打开成功"≈"渲染一致"。实际情况：Oracle 渲染通过下限只有 148/170（io corpus），智能滤镜重渲染 5/30——结构能保住，像素不保证。正确操作：cargo xtask corpus --all拉取官方语料库，跑cargo xtask test-corpus，看自己的文件落在哪个区间，而不是目测一张图就下结论。

误区二：默认在跑 GPU。实际情况：GPU 驱动崩溃后下次启动静默回退 CPU；Web 端无 WebGPU 静默降级 WebGL2。正确操作：桌面端查 Preferences › Performance 的 backend 设置（gpu_startup.rs的 plan 会给出 reason 字符串，--safe-gpu的 reason 是"CPU renderer for this launch"）；Web 端用?cpu/?webgl显式指定后端再复测。

误区三：菜单 100% 接通 = 功能 100% 可用。实际情况：docs/scorecard.md 在 Automation 一节自己标注了口径——"631 of 631 menu items live (100.0%). This counts dispatch, not behaviour."；同一张表的 Workspace 小节还列出 20/177 个偏好设置项"没有任何代码读取它们"（#204，目标 0），也就是说界面上能点的某些开关，什么都不做。正确操作：把docs/scorecard.md当检查清单用，遇到可疑开关先查它是否在那份"settings that do nothing"名单里。

误区四：官方说"往返一致"意味着 Photoshop 也认我们的文件。实际情况：G1 明确"PSDs we write are not always accepted by Photoshop"，且 FILE-216-4（导出用第三方编辑器复验）状态是 missing。正确操作：与 Photoshop 用户交换文件前，先在对方机器上实测重开；版本口径是 0.6.0/0.8.2（2026-10-10/13），之后的大量修复"通过了测试但还没经过用户验证"，跨版本行为可能变。

选型与收束：谁能现在用，谁该再等

基于以上证据，判断可以下得比较硬（版本口径 0.6.0，文档口径 2026-10-17）：

适合现在用：把 PSD 当作"读取与结构保留"对象的工作流——打开 Photoshop 存档、读图层/智能对象结构、导出 PNG/JPEG；以及任何想驱动自动化管线的人，因为 CLI、MCP、控制通道和 UI 共享同一命令注册表，这是文档里少数"做得比 Photoshop 还超前"的维度（.atn动作 112 个事件双向映射、批量命名模板、36 个 MCP 验收任务）。

不适合：需要把文件交回 Photoshop 继续编辑的专业管线（拒收风险未闭环）；重度依赖智能滤镜重渲染一致性的场景（5/30）；需要 AI/生成式功能或 .8BF 插件生态的场景（就绪度 10–15%，文档承认"需要 owner 决策"）。

什么条件下可以开始用：essentials 口径（基础用户 ~61%）意味着"开文件、常用工具、撤销、保存导出"这条链路官方已验证端到端可用（alpha gate 通过：六大核心工作流全部完成并可保存重开）——8-bit 常规文档、无智能滤镜、不要求与 Photoshop 往返的场景，现在就能认真用。

PhotoCraft 最值钱的不是"接近 Photoshop"的声称，而是它把 148/170、5/30、3/25 这些不够好看的数字公开在 CI 里，让每个缺口都可复算、可追踪。

【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft