cli-anything-photoshop について
CLI-Anything Photoshop は、Windows COM を通じて Adobe Photoshop を操作するコマンドラインツールです。スクリプトによる画像編集やエージェントのワークフローに使え、JSON 出力とドライランにも対応しています。
主な機能
- 01COM による Photoshop の自動操作
- 02PSD プロジェクトとドキュメント寸法の管理
- 03レイヤー、選択範囲、テキストの編集
- 04画像ファイルのエクスポート
- 05JSON 出力とドライラン
活用シーン
- 01PSD プロジェクトの作成と調整
- 02レイヤー属性や順序の変更
- 03テキストレイヤーの追加や編集
- 04変更を保存する前にコマンドをプレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/cli-anything-photoshopを入力して読み込まれたか確認します。
詳細
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 エージェントによる解析用） |
--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 エージェントでの使用（--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
エージェント向け使用ガイド
- 構造化出力を取得するには、常に
--jsonフラグを使用します --dry-runを使ってプレビューし、確認してから正式に保存します- エラー処理：終了コードがゼロ以外の場合は、
stderr内の JSON エラーオブジェクトを確認します - プロジェクトの状態：
--projectを使用して、ファイルの開閉と保存を自動管理します - REPL モード：複数ステップのインタラクティブな操作に適しており、Photoshop プロセスの起動コストを削減できます
Photoshop COM アーキテクチャ
CLI 命令 → Click CLI → Core 模块 → ComBridge (单例) → Photoshop.Application COM → Photoshop 引擎
Photoshop は Windows COM インターフェースを通じて、すべての編集機能を公開しています。このハーネスは、最もよく使われる操作をラップしています。拡張する場合は、Adobe Photoshop COM のドキュメントを参照し、utils/com_bridge.py に新しいメソッドを追加してください。
コメント
Markdown 対応