让AI直接操作你的PSD文件：PhotoCraft自动化接入完整指南（从零到批量导出）

让AI直接操作你的PSD文件PhotoCraft自动化接入完整指南从零到批量导出【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraftPhotoCraft 是一个用纯 Rust 从零写成的 Photoshop 级图像编辑器它能打开、编辑并保存真实的 PSD 文件——而更关键的是它可以被 AI 直接驱动AI 能读懂 PSD 的图层结构、逐条执行编辑命令、批量处理整目录的文档最后再原样存回 PSD。这篇文章把整条链路走一遍它为什么能被 AI 接管、怎么接上、接上之后能干多少活、边界在哪里。先说一个具体场景。周三晚上十点甲方发来消息四十张活动海报主标题文案要改品牌色换新明早十点前交。如果靠人工这就是一场打开—改—另存重复四十遍的持久战。而如果修图软件本身就能被程序调用这件事的形态就完全不同了让 AI 列出每张图的图层把文字层的内容换成新文案、把填充色改成新品牌色、逐个导出——你只需要在结尾验收一遍结果。AI 为什么能握住你的PSD藏在 PhotoCraft 里的命令化设计很多软件对 AI 是不透明的——界面能点但程序只能对着窗口瞎猜。PhotoCraft 的架构反过来它的文档模型是纯数据UI 只是一层薄壳底下是一个超过 500 条命令的注册表。每一个菜单项、每一个工具、每一个对话框背后都对应一条有 id、有参数文档的命令源码在 apps/photocraft-cli/ 与引擎的 command 层。这意味着 UI、命令行、JSON 控制通道和 MCP 服务器调用的是同一套命令。你在界面上能点出来的东西脚本和 AI 就能做到而 AI 能做到的也恰好是你自己手动能复现的——没有一套看不懂的黑盒魔法。这也是后面所有自动化玩法的地基AI 不是操作软件而是执行你也会执行的命令。顺带一提 PSD 这条腿本身它的 PSD 支持是独立 cratecrates/psd/按 Adobe 公开规范实现并对照真实文件语料测试——重存 psd-tools 测试集中 309 个文件里的 307 个渲染结果保持一致暂未建模的原始块会被原样携带而不是丢弃。图层、蒙版、文字这些灵魂在往返中是被保留的不会被压扁。把AI接进来的三条通道一次性命令、长驻会话与 MCPPhotoCraft 给自动化准备了三种入口详见 book/src/automation/ 的自动化文档对应三种工作习惯一次性命令。photocraft-cli run打开文档、执行一串命令、输出结果跑完即走适合打开、调曲线、导出这种边界清晰的活。batch子命令则能把一份动作清单应用到整个目录photocraft-cli batch --actions grade.json --in ./raw --out ./graded长驻会话。photocraft-cli serve在 stdio 或本机回环 TCP 上维持一个 headless 会话以 JSON 行协议连续对话——先看一眼图层再调一下参数再导出一张全程不用反复冷启动。MCP。把整个修图引擎包装成 MCP 服务器支持 MCP 的 AI 助手如 Claude 这类客户端把它当成自己的工具挂上去。它的传输走 stdio——可以理解为两个人在同一个房间里对耳语而不是拨一条对外的电话线MCP 的 stdio 模式不打开任何网络监听文件不出本机PSD 始终躺在你自己的磁盘上。接上之后AI到底能干什么从图层体检到批量导出的实操清单MCP 服务器暴露的核心工具不多但覆盖面很实用docs/mcp.md 有完整参数doc_inspect——图层体检。返回完整的图层树、历史状态和当前选中项每个图层含分组和嵌套子层都会报告是否带蒙版、是否带矢量蒙版。AI 先看懂文档再动手哪个是文字层、哪个是调整层、当前选中的是谁一目了然。command_list/command_run——命令发现与执行。前者列出可用命令及其参数文档后者按 id 执行任意命令参数就是普通的 JSON 对象。command_batch——批量执行。一串有序步骤一次跑完默认在第一个错误处停下避免错着错着跑飞了。render_preview——每步验收。任何一步改完都能要一张有尺寸上限的 PNG 缩略图回来看效果不满意当场指出来重来。先存档再动手。官方推荐的做法是用image.duplicate或history.newDocument先开一个副本在副本上试验确认没问题再落到原文件——AI 也被鼓励遵守这个流程。改完之后文档可以保存回 PSD 格式图层、蒙版、文字原样保留而不是压成一张平面图像。批量场景长这样一份grade.json写好转曲、压高光、统一的导出参数batch命令对着./raw目录跑一遍出来一个整齐的./graded目录。换文案、统一调色、批量出图都是这类清单式待办——AI 按顺序做完你只做验收。不满足于改文件Bridge模式让AI看着界面操作上面三条通道操作的都是文档本身。PhotoCraft 还留了一个更激进的入口Bridge 桥接模式。用法是把桌面版带着控制端口启动photocraft --control 7878 --control-token-file /private/path/control.token然后让 MCP 以 bridge 方式指向这个端口photocraft-cli mcp --bridge 127.0.0.1:7878 --control-token-file ...。此时 AI 除了能改文档还能看见软件界面本身查询完整 UI 状态当前工具、面板、打开的对话框、模拟指针和键盘事件、截屏回来看界面长什么样。整个体验像一个同事坐在你旁边用你熟悉的界面替你干活——不只是改文件而是用软件协议细节见 docs/control-protocol.md。安全设计是这套能力的入场券控制端口只绑定127.0.0.1本机回环每个 TCP 连接的第一帧必须先出示一个 256 位 bearer token认证通过之前任何方法都不会被派发。换句话说密钥不在手里连门都摸不到。安全与边界它把什么交给了AI又还没做完什么诚实地说清楚两面。已经做到的护栏stdio MCP 不开网络监听文件系统权限限定在启动时显式授予的读根/写根之内没给的权限就是没有且默认失败即拒绝控制通道强制本机回环加 token 认证批量步骤、响应体积、预览尺寸都有预算上限见 book/src/automation/security-model.md。官方自己也承认的短板token 只证明持有密钥并不提供工具级的细粒度授权——认证通过的客户端拿到的是文档级的完整访问权不要把这两条通道暴露给不受信任的代理或远程服务。同时整个项目还是early alpha官方明确写着它还不是日常专业工作的 Photoshop 替代品最大的缺口是 AI/生成式功能、若干尚未补齐的工具、排印深度与插件兼容性。菜单项都已接到命令上但接上了不等于行为完全一致——完整的诚实评估在 ROADMAP.md 和 parity 文档里。把它当成一个能力惊人但仍在长大的工具来用预期会健康得多。普通设计师的零代码上手路径装好、挂上、验收门槛比想象的低全程不需要会写代码装好桌面版macOS、Windows、Linux 都有安装包Linux 包自带photocraft-cli。在你的 MCP 客户端里注册一条命令以 Claude 为例把路径换成你的工作目录claude mcp add photocraft -- photocraft-cli mcp --automation-read-root dir --automation-write-root dir重启客户端AI 助手里就会出现command_run、doc_inspect、render_preview这些工具——直接开口指挥即可。日常手动修图时它照样是个正经的修图软件菜单、快捷键、面板布局都对齐 PS 的手感调整层、图层样式、智能对象、68 个工具都在盒子里。还有个附带福利整个引擎和 UI 能编译成 WebAssembly浏览器里直接就能跑静态站点往任何服务器一扔即可连安装都省了自托管方案见 packaging/web/README.md。从人手动修图到人指挥 AI 修图省下的不只是时间——批量生产、自动化工作流、AI 辅助设计这些玩法第一次有了能在本地、对真实 PSD 生效的落地工具。所以最后把问题抛给你如果今晚就让 AI 接手你的修图活你最想丢给它哪件事是给一整目录的旧图统一换新色板还是批量改海报文案并导出说说你的第一批待办清单顺便留意它验收时交上来的预览图——那才是这套流程真正开始好玩的地方。【免费下载链接】photocraftPhotoCraft: An open-source, photo editor written by scratch in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考