← 返回资源库

Compositor 1.3 怎么让 Codex 实时改图?`.comp` 项目格式、AI 协作工作流与限制

Compositor 1.3 的更新重点,不是又加了一个“输入提示词自动生图”的按钮,而是把图像项目格式开放给能写文件的 AI Agent 和脚本。开发者 Robbie Tilton 在 X 上演示:当 Agent 修改一个已打开的 Compositor 项目时,画布会实时更新,人可以继续用图层、蒙版、混合模式和传统修图工具做最后控制。

这个方向很值得关注。过去 AI 常常只交付一张扁平图片;Compositor 1.3 试图让 AI 交付一份仍可继续编辑的分层项目。

先给结论:

  • Compositor 1.3 没有内置生成模型,也不是云端 AI 绘图服务;
  • 它让外部 Agent、脚本或程序直接写 .comp 项目目录;
  • .comp 由 manifest.json 与 PNG 图层组成,不是 PSD;
  • Agent 完成写入后,已打开的画布通常会在约半秒内重载;
  • 重载会保留缩放、滚动和选择状态,但会清空 Undo 历史;
  • macOS 26.5+ 和 Apple silicon 是当前官方要求;
  • 原帖中的下载量、Star 数、启动速度和 App 体积应视为开发者披露,而不是独立审计数据;
  • 截至 2026 年 9 月 29 日,最新版本已经到 v1.4.1,本文解释的是 v1.3 的文件协作工作流,下载应以最新 Release 为准。

Compositor 1.3 真正新增了什么?

Compositor 一直定位为 Mac 上免费、开源、面向合成和后期处理的图像编辑器。图层、蒙版、混合模式、选区、修图、调整图层、PSD 导入、背景移除等能力并不是 v1.3 才出现的功能。

v1.3 真正确认的新重点是:

  • Agent 或脚本可以直接创建和修改 Compositor 项目文件;
  • 一个打开的 .comp 项目会监听文件写入,在写入结束后重新载入;
  • 保存过程在后台进行,工具保持可用;
  • 修复替换保存文件后可能重新读取旧图像的问题。

因此这篇文章不讨论“Compositor 能不能代替 Photoshop”的老问题,而是讨论:AI 与人如何修改同一份分层设计稿。

.comp 是什么?

Compositor 的官方格式文档说明,.comp 是一个目录包,核心结构类似:

campaign.comp/
  manifest.json
  images/
    background.png
    product.png
    headline.png
    shadow.png

其中:

  • PNG 文件保存各个图层的像素;
  • manifest.json 描述图层顺序、位置、尺寸、不透明度、混合模式和项目状态;
  • Agent 可以新增图层、替换图层像素或调整图层属性;
  • Compositor 读取这些普通文件,在画布中恢复可编辑图层。

它不是 Photoshop PSD,也不是云端协作文档。它的好处是格式更适合脚本和 Agent 读写;代价是 Agent 必须严格遵守文件格式和写入顺序。

AI Agent 如何实时改图?

一个安全、可审查的流程可以是:

  1. 在 Compositor 新建并保存 .comp 项目;
  2. 保持该项目在 Compositor 中打开;
  3. 让 Codex、Claude Code 或本地脚本先阅读官方格式文档;
  4. Agent 先写入新的 PNG 图层;
  5. Agent 将完整 manifest.json 写到临时文件;
  6. 通过原子重命名覆盖正式 manifest;
  7. Compositor 发现写入停止后重载项目;
  8. 人工检查画面,并在 Compositor 中微调蒙版、位置、混合模式和文字。

为什么要“先 PNG,后 manifest”?因为 manifest 如果先引用不存在的资源,应用会保持旧画布;格式无效时也可能没有明显报错。用临时文件写完整 manifest,再原子替换,可以避免画布读到半成品。

一个适合 Agent 的工作提示词

下面是用于授权素材和本地项目的安全模板,不要求 Agent 生成、下载或复制未经许可的内容:

你正在修改一个已经打开的 Compositor `.comp` 项目。

目标:为现有产品海报新增两个可编辑图层:
1. 一张由品牌提供的授权背景图;
2. 一个只包含产品卖点的文字图层。

规则:
- 先阅读官方 `.comp` 格式文档和当前 manifest;
- 不删除或覆盖现有图层;
- 所有新增素材必须来自项目的 approved-assets/ 目录;
- 先写入 PNG 图层,再用临时 manifest 文件完成完整更新后原子替换;
- 图层命名清楚,并保留每个图层的来源说明;
- 每次只新增 1–2 个图层,写入后等待画布重载;
- 输出变更日志、文件清单和回滚说明;
- 不处理没有授权的人像、Logo、字体或产品素材。

这种提示词的重点不是“让 AI 一次完成一张海报”,而是把改动限制在可检查、可撤销的范围内。

适合哪些任务?

营销素材变体

从同一份产品主图生成不同尺寸、语言、背景、利益点和 CTA 的分层草稿。人可以在 Compositor 中检查版式,而不是只拿到一张不可修改的输出图。

产品场景合成

将品牌拥有权利的产品图、场景图、阴影和文字拆成独立图层。Agent 负责初步摆放,人负责视觉真实感和最终审美。

批量尺寸适配

把 1:1、4:5、16:9 和 9:16 版本编排为同一项目的可审查变体,减少手工重复移动图层。

设计系统的可执行化

如果字体、色板、Logo、安全边距和图层命名都有规则,Agent 可以先按规则生产初稿,设计师把时间留给取舍和质量控制。

AI 生成“可继续修改”的草稿

无论素材来自本地模型、外部图像模型还是摄影师,最终都可以被拆成明确图层进入 .comp。这比只拿到一张平面图更适合反复修改。

这套工作流有哪些限制?

它不内置 AI 模型

Compositor 的官方表述是“任何能写文件的 Agent 或脚本都可使用该格式”。外部 Agent 是否收费、是否上传素材、使用什么模型,取决于你自己选择的服务。

Reload 会清空 Undo 历史

文件重载后,画布保留视图与选择状态,但 Undo 历史会被清空。本地有未保存修改时,应用会要求选择保留本地版本还是回退到写入版本。实验前应复制项目,而不是直接对唯一源文件运行 Agent。

不是所有 Mac 都能运行

v1.3 官方要求 macOS 26.5+ 和 Apple silicon;从源码构建需要 Xcode 26+。官方没有提供 Windows 或 Linux 路径,也不应擅自承诺 Intel Mac 兼容性。

PSD 兼容仍有边界

Compositor 可以导入 8-bit RGB PSD 和 PSB,但 CMYK 不支持,部分矢量和竖排文字会栅格化。复杂印刷和团队 PSD 项目应先用副本测试。

文件权限和素材来源仍需管理

Agent 能写项目文件,也可能误覆盖。使用独立项目目录、版本控制、只读素材目录和可回滚备份,是比提示词更可靠的保护措施。

Compositor 1.3 能替代 Photoshop 吗?

对 AI 图片精修、营销合成、透明素材、图层调整和个人创作,Compositor 已经覆盖很多高频工作。它还提供相对少见的“Agent 改文件、画布实时更新”协作路径。

但它不等于完整 Photoshop:

  • 只支持 Mac;
  • PSD 与 CMYK 兼容有明确边界;
  • 没有 Adobe 级插件生态和团队协作标准;
  • Agent 写入工作流仍新,适合在副本上逐步建立信任;
  • AI 素材质量、授权与服务费用不由 Compositor 解决。

正确的定位是:传统分层合成工具,加上一个对 Agent 友好的项目格式。

关于原帖中的一周数据

开发者在 X 上披露了“上线一周 27k 下载、GitHub 5.5k Stars、0.6 秒启动、16.5MB App 体积”等数据。这些可以反映作者的发布信息,但没有公开完整测量方法、设备、统计窗口和历史数据,不应写成独立审计或通用性能结论。

当前 appcast 版本提供的 v1.3.4 DMG 文件大小约为 9.08MB(十进制),而“16.5MB App size”可能采用的是安装后应用体积或另一种口径。下载包、应用包和内存占用不能混为一谈。

常见问题

Compositor 1.3 有内置 AI 生图模型吗?

没有。它让外部能写文件的 Agent 或脚本修改 .comp 项目;模型与 API 由用户自己选择。

.comp 是 PSD 吗?

不是。它是由 manifest.json 与 PNG 图层组成的目录包,方便程序和 Agent 写入。

Agent 写入会覆盖我正在做的图吗?

本地存在未保存修改时,应用会要求选择;但仍建议先复制项目,在专门的 Agent 工作目录中实验。

需要 API Key 吗?

Compositor 的文件工作流本身不要求 API Key。你使用的外部 Agent、图像模型或云存储服务可能需要。

可以在 Windows 上运行吗?

官方当前只提供 Mac 路径,基于 AppKit 与 Metal。没有官方 Windows 或 Linux 构建。

v1.3 是最新版本吗?

不是。截至 2026 年 9 月 29 日,GitHub 最新版本已到 v1.4.1。本文解释 v1.3 引入的 Agent 文件协作方式,下载请以最新 Release 为准。

总结

Compositor 1.3 的关键创新,是把“AI 改图”从生成一张平面图片,转向与人共享一份可编辑的分层项目。Agent 写 PNG 和 manifest,人实时查看、继续微调、保留来源和版本,这种协作方式更接近真正的设计生产。

它并不会自动解决画质、版权或审美问题,却给了个人创作者和小团队一个可审查、可回滚、可扩展的接口。对需要批量营销素材、产品合成和 AI 辅助设计的人来说,这比“又一个生图按钮”更值得关注。

参考资料

文章灵感来源