yb2460/cli-anything-photoshop

CLI-Anything Photoshop

Outil en ligne de commande pour contrôler Adobe Photoshop via l'interface d'automatisation COM Windows.

Prérequis

• Windows 10/11
• Adobe Photoshop 2023+ (l'interface COM doit être enregistrée)
• Python 3.10+ et le module pywin32

Installation

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

Après installation, la commande cli-anything-photoshop est disponible.

Structure des commandes

cli-anything-photoshop [--json] [--project <chemin>] [--dry-run] <groupe-commande> <commande> [options]

Options globales

Option	Description
--json	Sortie au format JSON (pour interprétation par un agent IA)
--project <chemin>	Ouvrir ou créer automatiquement un fichier PSD
--dry-run	Exécuter la commande sans sauvegarder sur le disque

Groupes de commandes

project — Gestion de projet

Commande	Options	Description
new <chemin>	-w largeur, -h hauteur, -r résolution, -m mode, -b couleur-fond	Créer un nouveau PSD
open <chemin>		Ouvrir un fichier PSD
save [chemin]		Sauvegarder le document
close	--no-save	Fermer le document

document — Opérations sur le document

Commande	Options	Description
info		Informations sur le document
resize	-w largeur, -h hauteur, -r résolution	Redimensionner
canvas	-w largeur, -h hauteur, -a ancrage	Ajuster la zone de travail
crop	--left --top --right --bottom	Rogner
rotate	-a angle	Rotation de la zone de travail
flip	-d direction	Retourner la zone de travail
mode	-m mode	Modifier le mode colorimétrique
trim	-t type	Rogner les bords

layer — Manipulation des calques

Commande	Options	Description
add	-n nom, -t type, -o opacité, -b fusion	Ajouter un calque
delete	-n nom	Supprimer un calque
duplicate	-n nom, --new-name nom	Dupliquer un calque
rename	--old ancien-nom, --new nouveau-nom	Renommer
show / hide	-n nom	Afficher/Masquer
opacity	-n nom, -o opacité	Définir l'opacité
blend	-n nom, -m mode	Définir le mode de fusion
list		Lister tous les calques
reorder	-n nom, -p position	Réorganiser l'ordre
merge	-n nom, --with-layer calque-cible	Fusionner les calques

selection — Opérations sur les sélections

Commande	Options	Description
all		Tout sélectionner
none		Désélectionner
invert		Inverser la sélection
feather	-r rayon	Adoucir (plume)
expand	-p pixels	Étendre
contract	-p pixels	Contracter
border	-w largeur	Sélection en bordure
rect	--left --top --right --bottom	Sélection rectangulaire
fill	-c couleur, -o opacité	Remplir la sélection

text — Opérations textuelles

Commande	Options	Description
add	-t texte, -f police, -s taille, -c couleur	Ajouter du texte
edit	-n nom, -t texte, -f police, -s taille, -c couleur	Modifier le texte
info	-n nom	Informations sur le texte

export — Exportation

Commande	Options	Description
save <chemin>	-f format, -q qualité, -w largeur, -h hauteur	Exporter un fichier

repl

Commande	Description
repl	Lancer le mode interactif REPL

Exemples d'utilisation

Utilisation avec un agent IA (mode --json)

# Créer un nouveau projet avec sortie JSON
cli-anything-photoshop --json project new -w 800 -h 600 poster.psd

# Ajouter un calque de texte
cli-anything-photoshop --json --project poster.psd text add -t "Bonjour le monde" -f Arial -s 48 -c "#FF0000"

# Lister tous les calques (format JSON)
cli-anything-photoshop --json --project poster.psd layer list

# Exporter en PNG
cli-anything-photoshop --json --project poster.psd export save -f png output.png

# Aperçu (sans sauvegarde)
cli-anything-photoshop --dry-run --project poster.psd layer add -n "brouillon" --type text

Utilisation manuelle

# Ouvrir un PSD, éditer interactivement
cli-anything-photoshop --project travail.psd layer list

# Lancer le mode REPL
cli-anything-photoshop repl

Guide d'utilisation pour les agents

1. Toujours utiliser le flag --json pour obtenir une sortie structurée
2. Utiliser --dry-run pour un aperçu, puis valider avant de sauvegarder définitivement
3. Gestion des erreurs : si le code de sortie est non nul, vérifier l'objet d'erreur JSON dans stderr
4. État du projet : utiliser --project pour gérer automatiquement l'ouverture et la sauvegarde des fichiers
5. Mode REPL : idéal pour les opérations interactives en plusieurs étapes, réduisant les surcoûts de démarrage de Photoshop

Architecture COM de Photoshop

Commande CLI → Click CLI → Module Core → ComBridge (singleton) → Photoshop.Application COM → Moteur Photoshop

Photoshop expose toutes ses capacités d'édition via l'interface COM Windows. Ce harness encapsule les opérations les plus courantes. Pour l'étendre, référez-vous à la documentation Adobe Photoshop COM et ajoutez de nouvelles méthodes dans utils/com_bridge.py.