storytold/photocraft · 上手攻略

仓库：storytold/photocraft
链接：https://github.com/storytold/photocraft
分类：开源图像编辑 / Photoshop 替代品
作者：Tom
更新：2026-10-07

它是什么

PhotoCraft 是用纯 Rust 从零实现的开源 Adobe Photoshop 替代品，隶属于 ArtCraft 社区。与依赖 Electron/WebView 的方案不同，它使用 wgpu 作为 GPU 渲染后端，支持 Metal、Vulkan、DX12 和 WebGPU，覆盖 macOS、Windows、Linux、FreeBSD，并可通过 WebAssembly 在浏览器运行。⚠️ 当前状态为 early alpha（v0.3.0，2026-10 刚发布），生产环境使用需自行评估稳定性。

核心定位：一套完全离线、无需账号、可程序化驱动的专业级图像编辑器，同时保留 PSD 文件的完整读写能力。

解决什么问题

Adobe Photoshop 闭源、订阅制、对 AI 自动化不友好。PhotoCraft 试图填补这个空白：⚠️ 它并非简单滤镜工具，而是具备完整图层体系的专业编辑器，支持调整图层、图层样式、智能选区、矢量形状、文字和滤镜，并可通过 CLI、JSON 控制通道或 MCP 服务器被 AI Agent 驱动。

主要场景：

需要程序化控制图像编辑流水线的 AI 应用
不想订阅 Adobe 又需要处理 PSD 文件的自由开发者
对开源工作流有强需求的创意团队
⚠️ 依赖特定 PSD 特性（如 3D 图层、视频帧）的用户暂时不在支持范围内

快速安装

PhotoCraft 提供多种安装方式，文档指向 https://getartcraft.com/apps/photocraft。

方式一：预编译包（推荐尝鲜）

# macOS（Homebrew）
brew install --cask photocraft
# ⚠️ Homebrew Cask 名称待核实，以官方文档为准

# 或直接下载 AppImage（Linux）
# 参见 https://getartcraft.com/apps/photocraft

方式二：源码编译（Rust 1.75+）

git clone https://github.com/storytold/photocraft.git
cd photocraft
cargo build --release
# 编译产物在 target/release/photocraft

⚠️ 源码编译需要 Rust 工具链，macOS 上还需 Xcode Command Line Tools；首次编译耗时较长（15~30 分钟，视硬件而定）。

方式三：photocraft-cli（纯命令行，无需 GUI）

cargo install photocraft-cli
# 或从 GitHub Releases 下载二进制

CLI 模式无需图形界面，适合自动化脚本和 AI Agent 集成场景。

核心用法

图形界面基本操作

PhotoCraft 界面布局与 Photoshop 高度一致，⌘J（复制图层）、⇧⌘D（直接选择）等快捷键无需重新学习。核心面板包括图层、通道、路径、历史记录和属性栏。

# 启动 GUI
photocraft          # 或双击 App
# 快捷键（macOS 布局）
⌘O      打开文件
⌘S      保存
⌘Z      撤销
⌘⇧Z     重做
⌘J      复制图层
T        文字工具
M        选区工具
V        移动工具
B        画笔工具

PSD 文件读写

PhotoCraft 0.3.0 在 psd-tools 测试集上能正确解析 307/309 个文件，图层渲染像素与 Photoshop 基本一致。⚠️ 对 Photoshop 特有的 3D 图层支持仍不完整。

# 打开 PSD（GUI 内或 CLI）
photocraft your_file.psd

# CLI 导出
photocraft-cli export input.psd --format png --output ./output/

MCP 服务器（AI Agent 集成）

每一条 UI 操作背后都是一条命令，因此 PhotoCraft 可通过 MCP（Model Context Protocol）被大模型驱动：

# ⚠️ MCP 服务器配置方式请参见官方文档
# https://github.com/storytold/photocraft/blob/main/docs/mcp.md
# 以下为示意结构
photocraft --mcp-server --port 8765

⚠️ MCP 集成细节（认证、工具 schema、错误处理）在 v0.3.0 文档中仍较简略，配置生产级 Agent 流水线前建议先在测试环境验证。

调整图层

调整图层（Adjustment Layers）是非破坏性编辑的核心。PhotoCraft 支持 16 种调整图层：Levels、Curves（支持分通道编辑）、Vibrance、Hue/Saturation、Black & White、Channel Mixer、Gradient Map、Photo Filter、Selective Color、Color Lookup（.cube / .3dl / .look）、Shadows/Highlights、Replace Color、Match Color、HDR Toning、Desaturate、Equalize。

调整图层可叠加、遮罩、隐藏、重新排序，原始像素完全不改变。

典型适用场景

场景一：AI 图像处理流水线 通过 CLI 或 MCP 让 AI Agent 执行图层合成、尺寸调整、格式转换，无需人工介入 Photoshop。

场景二：跨平台 PSD 查看与轻编辑 在 Linux 或没有 Adobe 订阅的情况下打开、修改并保存 PSD 文件。⚠️ 复杂 PSD（混合模式、剪贴蒙版嵌套）建议仍用 Photoshop 最终确认。

场景三：批量图像处理脚本 利用 photocraft-cli 在服务端对图像施加滤镜、调整色阶或应用曲线，适合 CI/CD 场景。

场景四：开发者辅助设计工具 将 PhotoCraft 嵌入 Rust 应用作为图像编辑引擎，规避 Electron 的体积与性能问题。

坑与注意

⚠️ alpha 稳定性：v0.3.0 为首个带完整评分卡的版本，仍有 29 个 open bugs，部分设置项（settings that do nothing）约占 60/133。生产前务必看一遍 docs/scorecard.md。

⚠️ PSD 兼容性有取舍：支持 307/309 psd-tools 文件，但 Photoshop 特有的 3D 图层、智能对象嵌套、某些混合模式仍有缺失。官方评分卡标注了 io corpus oracle ≥ 146/170 和 Photoshop-authored oracles round-trip 258/258，后者是渲染精度而非编辑完整性。

⚠️ 矢量与 Photoshop 存在微小像素差：116/116 形状图层在像素级对比中通过，但 ⚠️ ⚠️ 这仅指其内部测试集，特殊渐变或复杂路径可能在其他 PSD 中出现偏差。

⚠️ MCP 文档不完整：MCP 集成是重点宣传特性，但 README 中仅一句话带过，docs/mcp.md 链接 404，实际配置需要参考 GitHub Issues 或 Discord 社区。

⚠️ GPU 性能依赖驱动：wgpu 在不同后端（Metal/Vulkan/DX12）上表现不同，部分 Linux 发行版可能遇到 GPU 加速失效，需查看 issues。

⚠️ 无中文界面：v0.3.0 新增了简体中文等 6 种语言界面翻译，但 ⚠️ ⚠️ 实际界面翻译完整度未经独立核实。

与同类对比

工具	语言	PSD 支持	AI/自动化	成熟度	许可证
PhotoCraft	Rust	307/309（只读较好）	MCP/CLI/JSON	early alpha	MIT/Apache-2.0
GIMP	C	有限（导入层会丢失）	脚本（Python/Fu）	成熟稳定	LGPL
Krita	C++	部分	Python 插件	成熟	GPL
RawTherapee	C++	不支持	无	成熟	BSD
Photoshop	C++	100%	ExtendScript/UXP	工业级	订阅制

⚠️ GIMP 和 Krita 成熟度远高于 PhotoCraft，但 PSD 兼容性和非破坏性编辑能力是 PhotoCraft 的差异化优势。Rust 实现使其在 CLI 嵌入和性能上优于 Electron 类方案。⚠️ 若需求是专业修图而非程序化编辑，GIMP/Krita 仍是最稳妥选择。

一句话推荐结论

PhotoCraft 是目前最接近 Photoshop 架构的开源替代品，Rust 实现带来 CLI 和 AI Agent 集成潜力，但 early alpha 状态意味着生产使用需谨慎验证具体功能是否满足需求——⚠️ 特别是 PSD 写入和 MCP 自动化部分，建议先用真实素材测试再上生产。