mcpField
C
cli-anything-photoshop

cli-anything-photoshop

github.com/yb2460创意与媒体2.7k319 次安装3 周前更新
代码仓库

关于 cli-anything-photoshop

CLI-Anything Photoshop 是通过 Windows COM 接口操控 Adobe Photoshop 的命令行工具，适用于脚本化图像编辑和 Agent 工作流。它提供项目、文档、图层、选区、文字及导出操作，并支持 JSON 输出和试运行。

主要功能

  1. 01通过 COM 自动化操控 Photoshop
  2. 02管理 PSD 项目与文档尺寸
  3. 03编辑图层、选区和文字
  4. 04导出图像文件
  5. 05支持 JSON 输出与试运行

适用场景

  1. 01创建和调整 PSD 项目
  2. 02批量修改图层属性与顺序
  3. 03添加或编辑文字图层
  4. 04预览命令后再保存更改

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yb2460/harness-anything --skill cli-anything-photoshop

安装后在 Claude Code 中输入/cli-anything-photoshop确认已加载。

详细介绍

来自项目 README

CLI-Anything Photoshop

通过 Windows COM 自动化接口操控 Adobe Photoshop 的命令行工具。

前置条件

  • Windows 10/11
  • Adobe Photoshop 2023+ (需注册 COM 接口)
  • Python 3.10+ 及 pywin32 包

安装

cd photoshop-harness/agent-harness
pip install -e .

安装后可使用 cli-anything-photoshop 命令。

命令结构

cli-anything-photoshop [--json] [--project <path>] [--dry-run] <command-group> <command> [options]
全局选项
选项描述
--json以 JSON 格式输出（供 AI Agent 解析）
--project <path>自动打开或创建 PSD 项目文件
--dry-run执行命令但不保存到磁盘

命令组

project — 项目管理
命令选项描述
new <path>-w width, -h height, -r resolution, -m mode, -b bg-color创建新 PSD
open <path>打开 PSD 文件
save [path]保存文档
close--no-save关闭文档
document — 文档操作
命令选项描述
info文档信息
resize-w width, -h height, -r resolution调整尺寸
canvas-w width, -h height, -a anchor调整画布
crop--left --top --right --bottom裁切
rotate-a angle旋转画布
flip-d direction翻转画布
mode-m mode更改色彩模式
trim-t type裁切边缘
layer — 图层操作
命令选项描述
add-n name, -t type, -o opacity, -b blend添加图层
delete-n name删除图层
duplicate-n name, --new-name name复制图层
rename--old name, --new name重命名
show / hide-n name显示/隐藏
opacity-n name, -o opacity设置透明度
blend-n name, -m mode设置混合模式
list列出所有图层
reorder-n name, -p position调整顺序
merge-n name, --with-layer name合并图层
selection — 选区操作
命令选项描述
all全选
none取消选区
invert反转选区
feather-r radius羽化
expand-p pixels扩展
contract-p pixels收缩
border-w width边框选区
rect--left --top --right --bottom矩形选区
fill-c color, -o opacity填充选区
text — 文字操作
命令选项描述
add-t text, -f font, -s size, -c color添加文字
edit-n name, -t text, -f font, -s size, -c color编辑文字
info-n name文字信息
export — 导出
命令选项描述
save <path>-f format, -q quality, -w width, -h height导出文件
repl
命令描述
repl启动交互式 REPL 模式

使用示例

AI Agent 用法（--json 模式）
# 创建新项目并获取 JSON 输出
cli-anything-photoshop --json project new -w 800 -h 600 poster.psd

# 添加文字图层
cli-anything-photoshop --json --project poster.psd text add -t "Hello World" -f Arial -s 48 -c "#FF0000"

# 列出所有图层（JSON 格式）
cli-anything-photoshop --json --project poster.psd layer list

# 导出为 PNG
cli-anything-photoshop --json --project poster.psd export save -f png output.png

# 预览（不保存）
cli-anything-photoshop --dry-run --project poster.psd layer add -n "draft" --type text
人工使用
# 打开 PSD，交互编辑
cli-anything-photoshop --project work.psd layer list

# 启动 REPL
cli-anything-photoshop repl

Agent 使用指南

  1. 始终使用 --json 标志 获取结构化输出
  2. 使用 --dry-run 预览，确认后再正式保存
  3. 错误处理：退出码非零时检查 stderr 中的 JSON 错误对象
  4. 项目状态：使用 --project 自动管理文件打开/保存
  5. REPL 模式：适合多步骤交互式操作，减少 Photoshop 进程启动开销

Photoshop COM 架构

CLI 命令 → Click CLI → Core 模块 → ComBridge (单例) → Photoshop.Application COM → Photoshop 引擎

Photoshop 通过 Windows COM 接口暴露全部编辑能力。本 harness 封装了最常用的操作。如需扩展，参考 Adobe Photoshop COM 文档添加新方法到 utils/com_bridge.py。

评论

支持 Markdown