PhotoCraft MCP 接入实操：让 AI 本地改 PSD 的 4 个关键点

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

PhotoCraft 是一个用纯 Rust 编写的 Photoshop 级图像编辑器，开源、本地运行，不依赖订阅也不依赖网络。它最有意思的地方在于，整个编辑引擎可以被做成一个 MCP 服务器：接上之后，AI 可以直接打开、查看、修改并保存 PSD 文件，全程本地修图，文件不出机器。这篇文章按「一份 PSD 文件的旅程」为主线，拆解 4 个关键点：软件怎么组织的、怎么接、接上之后 AI 能做什么、以及上手门槛和边界在哪。

一个纯 Rust 图像编辑器：本地运行，快捷键对齐 PS

PhotoCraft 是一个 clean-room 项目，基于公开规格从零重写 Photoshop 的功能面：图层、蒙版、调整图层、图层样式、文字层、矢量路径、完整的画笔引擎，直到 8/16/32 位色彩深度和 ICC 色彩管理。整个应用用 Rust 写成，原生运行，智能选择这类功能全部在本机计算。

操作逻辑刻意对齐 PS：菜单、面板、工具和快捷键的位置和 Photoshop 一致，用过 PS 的人不需要重新学习。渲染走 GPU 合成器，大半径模糊这类运算在多兆像素的图上也是秒级完成。

把每一步点击变成一条指令

PhotoCraft 的架构是「引擎优先」：底层是纯数据的文档模型加一个命令引擎，UI 只是薄薄的一层。每个菜单项、工具和对话框都执行同一个注册表里的命令，500 多条，核心实现在 crates/engine/。

这带来一个直接的好处：界面、命令行、JSON 控制通道和 MCP 服务器调用的都是同一套命令。也就是说，你能在界面上点到的东西，脚本和 AI 也能做到，不存在「功能只在界面上有、自动化够不着」的问题。软件长什么样，自动化的能力就长什么样，软件新增一个功能，AI 也就自动多了一条可用指令。

🔌 PhotoCraft MCP 连接步骤：只走 stdio，文件不出机器

PhotoCraft 的 MCP 服务只走 stdio，也就是本地进程的标准输入输出通道。AI 客户端把它作为子进程启动，通过管道对话，不开放任何网络端口，也不经过任何云端服务。你的 PSD 从头到尾待在你自己指定的文件夹里。

连接是一次性设置：在支持 MCP 的 AI 助手里注册 PhotoCraft 服务，启动时指定「读取根目录」和「写入根目录」。服务只能看见也只能触碰这两个目录内的文件，不指定写目录，AI 就完全没有写权限。发布版本自带命令行工具，无需自己构建。详细的连接参数和注册方法可以看仓库文档 docs/mcp.md。

Rust 图像编辑器批量处理 PSD 图层：先读、再试、后落盘

接上之后，AI 的能力就和上面那套命令注册表一一对应了。一个真实任务通常按四步走。

先读文档结构。doc_inspect命令让 AI 看到整棵图层树：哪些是文字层、哪些是调整层、哪些带像素蒙版或矢量蒙版、当前选中了什么。先「读」后「改」，这是它不乱来的前提。

先复制再动手。修改前 AI 可以先复制一份文档，在副本上试改，确认效果再对原文件执行同样的操作。这套「先存档、再动手」的策略在文档里有明确约定，批量场景下尤其让人放心。

批量执行、逐步验收。command_batch命令允许 AI 把一串操作（比如加曲线调整层、压暗高光、导出）打包按顺序执行，遇到错误默认就停下。每步完成之后还能渲染缩略图预览，你觉得不对，当场指出、重新下达指令，修改过程始终在你的掌控里。

保真保存回 PSD。改完按原格式存回 PSD。PhotoCraft 的 PSD 支持是依据 Adobe 公开规格写成的，测试数据显示 psd-tools 测试集的 309 个文件里有 307 个打开再存回去渲染一致，暂时没建模的部分会被原样保留而不是丢弃。文字层还是可编辑的文字，蒙版和图层样式也都在，不会压成一张位图。

进阶选项：桥接模式把操作从文件延伸到屏幕

除了文件级操作，还有一种桥接模式：桌面应用开着窗口运行时，AI 可以查看界面当前状态、截屏、模拟鼠标键盘事件，像个隐形助手坐在电脑前用你熟悉的界面干活。

这条通道只监听本机回环地址，并要求密钥验证，AI 没有乱来的余地。文档也明确提醒不要把它暴露给不可信的中间层。对大多数人来说，无头文件操作已经够用，桥接模式留给进阶需求。

上手：不用写代码；边界：仍是早期 alpha

上手不需要会写代码：装好桌面版，当普通修图软件用；想体验 AI 修图，就在 AI 助手里接上 MCP 服务开始下指令。整个引擎还能编译成 WebAssembly 网页版，打开浏览器就能用，连安装都省了。

坦率讲，项目还处于早期 alpha。官方 README 的表述也很直接：Photoshop 的大部分功能面已经以某种形式存在，但还不是日常专业工作的全面替代品——AI 生成功能、部分高级工具、排版深度和插件兼容都还在路上。

所以眼下比较合理的定位是：它已经是一个足够能打的本地修图软件，也是「AI 直接操作 PSD」这件事真正落地的少数工具之一。边界很明确，方向值得继续观察。

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