CLI-Anything Photoshop
通过 Windows COM 自动化接口操控 Adobe Photoshop 的命令行工具。
本地来源：/Users/hanyueyang/.codex/vendor/harness-anything-mac/photoshop-harness
注意：上游 README 提到 macOS AppleScript/JXA 支持，但当前代码仍直接依赖 win32com.client 和 Windows COM。macOS 上只将本 skill 作为能力参考，不要声称已经可以执行 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
使用示例
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 使用指南
- 始终使用
--json 标志 获取结构化输出
- 使用
--dry-run 预览，确认后再正式保存
- 错误处理：退出码非零时检查
stderr 中的 JSON 错误对象
- 项目状态：使用
--project 自动管理文件打开/保存
- REPL 模式：适合多步骤交互式操作，减少 Photoshop 进程启动开销
Photoshop COM 架构
CLI 命令 → Click CLI → Core 模块 → ComBridge (单例) → Photoshop.Application COM → Photoshop 引擎
Photoshop 通过 Windows COM 接口暴露全部编辑能力。本 harness 封装了最常用的操作。如需扩展，参考 Adobe Photoshop COM 文档添加新方法到 utils/com_bridge.py。
1---2name: cli-anything-photoshop3description: 通过 COM 自动化操控 Adobe Photoshop 的 CLI harness。支持项目管理、图层操作、选区控制、文字编辑、图像调整和多格式导出。4---56# CLI-Anything Photoshop78通过 Windows COM 自动化接口操控 Adobe Photoshop 的命令行工具。910本地来源：`/Users/hanyueyang/.codex/vendor/harness-anything-mac/photoshop-harness`1112注意：上游 README 提到 macOS AppleScript/JXA 支持，但当前代码仍直接依赖 `win32com.client` 和 Windows COM。macOS 上只将本 skill 作为能力参考，不要声称已经可以执行 Photoshop 自动化。1314## 前置条件1516- **Windows 10/11**17- **Adobe Photoshop 2023+** (需注册 COM 接口)18- **Python 3.10+** 及 `pywin32` 包1920## 安装2122```bash23cd photoshop-harness/agent-harness24pip install -e .25```2627安装后可使用 `cli-anything-photoshop` 命令。2829## 命令结构3031```32cli-anything-photoshop [--json] [--project <path>] [--dry-run] <command-group> <command> [options]33```3435### 全局选项3637| 选项 | 描述 |38|------|------|39| `--json` | 以 JSON 格式输出（供 AI Agent 解析） |40| `--project <path>` | 自动打开或创建 PSD 项目文件 |41| `--dry-run` | 执行命令但不保存到磁盘 |4243## 命令组4445### project — 项目管理46| 命令 | 选项 | 描述 |47|------|------|------|48| `new <path>` | `-w` width, `-h` height, `-r` resolution, `-m` mode, `-b` bg-color | 创建新 PSD |49| `open <path>` | | 打开 PSD 文件 |50| `save [path]` | | 保存文档 |51| `close` | `--no-save` | 关闭文档 |5253### document — 文档操作54| 命令 | 选项 | 描述 |55|------|------|------|56| `info` | | 文档信息 |57| `resize` | `-w` width, `-h` height, `-r` resolution | 调整尺寸 |58| `canvas` | `-w` width, `-h` height, `-a` anchor | 调整画布 |59| `crop` | `--left --top --right --bottom` | 裁切 |60| `rotate` | `-a` angle | 旋转画布 |61| `flip` | `-d` direction | 翻转画布 |62| `mode` | `-m` mode | 更改色彩模式 |63| `trim` | `-t` type | 裁切边缘 |6465### layer — 图层操作66| 命令 | 选项 | 描述 |67|------|------|------|68| `add` | `-n` name, `-t` type, `-o` opacity, `-b` blend | 添加图层 |69| `delete` | `-n` name | 删除图层 |70| `duplicate` | `-n` name, `--new-name` name | 复制图层 |71| `rename` | `--old` name, `--new` name | 重命名 |72| `show` / `hide` | `-n` name | 显示/隐藏 |73| `opacity` | `-n` name, `-o` opacity | 设置透明度 |74| `blend` | `-n` name, `-m` mode | 设置混合模式 |75| `list` | | 列出所有图层 |76| `reorder` | `-n` name, `-p` position | 调整顺序 |77| `merge` | `-n` name, `--with-layer` name | 合并图层 |7879### selection — 选区操作80| 命令 | 选项 | 描述 |81|------|------|------|82| `all` | | 全选 |83| `none` | | 取消选区 |84| `invert` | | 反转选区 |85| `feather` | `-r` radius | 羽化 |86| `expand` | `-p` pixels | 扩展 |87| `contract` | `-p` pixels | 收缩 |88| `border` | `-w` width | 边框选区 |89| `rect` | `--left --top --right --bottom` | 矩形选区 |90| `fill` | `-c` color, `-o` opacity | 填充选区 |9192### text — 文字操作93| 命令 | 选项 | 描述 |94|------|------|------|95| `add` | `-t` text, `-f` font, `-s` size, `-c` color | 添加文字 |96| `edit` | `-n` name, `-t` text, `-f` font, `-s` size, `-c` color | 编辑文字 |97| `info` | `-n` name | 文字信息 |9899### export — 导出100| 命令 | 选项 | 描述 |101|------|------|------|102| `save <path>` | `-f` format, `-q` quality, `-w` width, `-h` height | 导出文件 |103104### repl105| 命令 | 描述 |106|------|------|107| `repl` | 启动交互式 REPL 模式 |108109## 使用示例110111### AI Agent 用法（--json 模式）112113```bash114# 创建新项目并获取 JSON 输出115cli-anything-photoshop --json project new -w 800 -h 600 poster.psd116117# 添加文字图层118cli-anything-photoshop --json --project poster.psd text add -t "Hello World" -f Arial -s 48 -c "#FF0000"119120# 列出所有图层（JSON 格式）121cli-anything-photoshop --json --project poster.psd layer list122123# 导出为 PNG124cli-anything-photoshop --json --project poster.psd export save -f png output.png125126# 预览（不保存）127cli-anything-photoshop --dry-run --project poster.psd layer add -n "draft" --type text128```129130### 人工使用131132```bash133# 打开 PSD，交互编辑134cli-anything-photoshop --project work.psd layer list135136# 启动 REPL137cli-anything-photoshop repl138```139140## Agent 使用指南1411421. **始终使用 `--json` 标志** 获取结构化输出1432. **使用 `--dry-run` 预览**，确认后再正式保存1443. **错误处理**：退出码非零时检查 `stderr` 中的 JSON 错误对象1454. **项目状态**：使用 `--project` 自动管理文件打开/保存1465. **REPL 模式**：适合多步骤交互式操作，减少 Photoshop 进程启动开销147148## Photoshop COM 架构149150```151CLI 命令 → Click CLI → Core 模块 → ComBridge (单例) → Photoshop.Application COM → Photoshop 引擎152```153154Photoshop 通过 Windows COM 接口暴露全部编辑能力。本 harness 封装了最常用的操作。如需扩展，参考 Adobe Photoshop COM 文档添加新方法到 `utils/com_bridge.py`。
halseyyang