Editmamei 是一个 Model Context Protocol（MCP）服务器，用于驱动桌面版 Adobe Photoshop 进行自然语言照片编辑。用户用自然语言描述编辑需求，AI 助手规划步骤，Photoshop 使用其标准的调整图层、蒙版、选区和滤镜执行。AI 负责指挥，Photoshop 负责像素编辑。没有生成模型接触像素，执行编辑时也不会上传图像。项目为独立项目，未获得 Adobe 的关联或认可。
主要能力
- 自然语言编辑：用日常语言描述编辑，AI 助手组合工具调用并迭代。
- 非破坏性默认：调整以调整图层进行，破坏性像素操作在自动创建的副本上运行，编辑在结构上可逆。
- 结构化结果：每个工具声明 outputSchema 并返回类型化 JSON，报告当前文档和图层状态。
- 测量而非目测：提供直方图、区域比较、图层边界差异、选区预览等验证工具进行数值检查。
- 设备端感知：使用本地 ONNX 计算机视觉检测人脸、物体和场景区域，返回真实文档坐标，图像不离开本机。
- 支持 Photoshop 2026（v27.x）和 GIMP（beta）。
使用方式
Editmamei 是一个纯 MCP stdio 服务器，使用 Node 编写。AI 客户端将其作为子进程启动，并通过 stdio 调用工具。每个工具构建小型 Photoshop 脚本，通过平台原生自动化通道在本地 Photoshop 中执行：Windows 通过 COM（Photoshop.Application 对象），macOS 通过 AppleScript / OSA。
安装后重启 AI 客户端，并询问“Is Photoshop connected?”。Claude Desktop 用户可安装一键 .mcpb 扩展（无需系统 Node）。
一个典型会话：先 ps_ping（存活检测），再 ps_overview（工作方法和能力图），然后 tools/list（完整模式类型清单）。之后可以直接对话，比如“打开我的度假照片”“让天空更有戏剧性但保持前景自然”“锐化眼睛、柔化皮肤、其余不动”“将主体隔离到带干净蒙版的图层”“导出 2048px 的网页 JPEG”。
设置位于 ~/.editmamei/settings.json，由 editmamei config CLI 管理。PHOTOSHOP_PATH 环境变量可覆盖 Photoshop 自动检测。
适用场景
适合摄影师和修图师通过对话进行编辑，也适合开发者将 Photoshop 接入 AI 流水线。可用于批量旅行照片调色等真实场景。
工具集
共 111 个工具。Photoshop 表面为 83 个工具，分 16 个能力组（62 个 Community，21 个 Pro）。Community 工具在两个版本中都提供；Pro 工具需许可证解锁。所有工具以 ps_* 命名空间，运行时通过 tools/list 发现。另外有独立的编辑器表面驱动无头 GIMP：28 个 gimp_* 工具，Community，目前为 beta。Pro 的添加仅限 Photoshop；GIMP 没有 Pro 层级。
- Community：免费，涵盖文档、图层、选区（包括 AI 选择主体和选择天空）、非破坏性调整、滤镜、蒙版、文字、修饰、设备端感知以及检查/验证原语。
- Pro：增加 Camera Raw 作为可重新编辑的滤镜、打开前显影原始文件、文件夹批处理、可复现模板系统、基于 ground 的精度工具（变形、命名对象蒙版、精确放置）、主体实例和人脸网格定位，以及 Photoshop Actions 和脚本逃生舱。
GIMP（beta）
当本机检测到 GIMP 3.2+ 时，gimp_* 工具集与 ps_* 一起注册；当要求使用 GIMP 或 Photoshop 不可用时使用。无可见窗口：编辑在后台 gimp-console 进程中发生，通过对话中的渲染预览跟进。beta 覆盖文档（打开、创建、保存 .xcf、导出）、图层和组、将一张照片置入另一张、13 种非破坏性调整类型和六种效果（暗角、黑白、运动模糊和镜头模糊、噪点、投影）、选区（形状、颜色范围、魔棒、渐变）可作为图层蒙版附加、实时文本图层、移动/缩放/旋转图层、裁剪/调整大小/旋转/翻转、画布扩展、颜色/灰度转换、可恢复的检查点，以及和 Photoshop 侧相同的预览/直方图/比较验证原语。尚不覆盖修复/克隆或 AI 主体和天空选择。
构建与测试
需要 Node.js 22+ 和 Go 1.21+（构建会编译 editmamei-core 二进制来生成 Photoshop 脚本；它需要 Go 1.27，Go 会从 1.21 起自动获取）。缺少 Go 时构建会警告而非失败，仍可运行测试套件；可设置 EDITMAMEI_CORE_BIN 指向预构建二进制。测试套件无需 Photoshop 即可运行，验证生成的 ExtendScript，而非 Photoshop 是否接受。
限制与要求
- 要求 Adobe Photoshop 2026（v27.x）、Windows 10/11 或 macOS 13+、Node.js 22+（npm 路径）以及兼容 MCP 的 AI 客户端（Claude Desktop、Cursor、Claude Code）。
- Editmamei 自身不含模型，运行在连接的客户端上，因此每次编辑消耗该客户端的 token。
- 每个工具在实时 Photoshop 会话中验证后才发布；新工具在通过实时验证前保持禁用。
隐私与许可
Editmamei 在您的计算机上运行并在桌面 Photoshop 中编辑。图像内容、文档数据或文件路径不会发送到 Editmamei 的服务器。它报告无内容的使用遥测（默认开启，可用 editmamei config set telemetry.usage false 关闭）。当 AI 助手需要查看结果时，Editmamei 发送缩小后的预览。
Editmamei CE 是 Fair Source 软件，采用 Functional Source License, v1.1, MIT Future License（FSL-1.1-MIT）。可阅读、运行、修改和再分发代码用于几乎任何用途，包括商业照片编辑、内部工具、教育、研究、安全审查。唯一限制是每个发布版本两年内不得将代码作为与 Editmamei CE 或 Pro 竞争的商业产品或服务提供给他人。再分发时保留许可证和版权声明。每个版本发布两年后自动变为纯 MIT。
Editmamei 不是 OSI 定义的开源软件，而是源码可用。Editmamei Pro 是单独商业许可模块，源代码不公开。第三方依赖保留其自己的许可证。
文档与支持
功能与定价：editmamei.com 安装：docs/installation.md 入门：docs/getting-started.md FAQ：docs/faq.md AI 客户端：docs/clients.md 故障排除：docs/troubleshooting.md GIMP（beta）：docs/gimp.md Pro 功能：docs/pro-features.md 路线图：docs/roadmap.md Bug 和功能请求：issue tracker。安全：见 SECURITY.md（不要公开提交安全问题）
