CLI-Anything Photoshop
Befehlszeilenwerkzeug zur Steuerung von Adobe Photoshop über die Windows COM-Automatisierungsschnittstelle.
Voraussetzungen
- Windows 10/11
- Adobe Photoshop 2023+ (COM-Schnittstelle muss registriert sein)
- Python 3.10+ und das Paket
pywin32
Installation
cd photoshop-harness/agent-harness
pip install -e .
Nach der Installation ist der Befehl cli-anything-photoshop verfügbar.
Befehlsstruktur
cli-anything-photoshop [--json] [--project <pfad>] [--dry-run] <befehlsgruppe> <befehl> [optionen]
Globale Optionen
| Option | Beschreibung |
|---|
--json | Ausgabe im JSON-Format (zur Analyse durch KI-Agenten) |
--project <pfad> | Öffnet oder erstellt automatisch eine PSD-Projektdatei |
--dry-run | Befehl ausführen, aber nicht auf die Festplatte speichern |
Befehlsgruppen
project – Projektverwaltung
| Befehl | Optionen | Beschreibung |
|---|
new <pfad> | -w Breite, -h Höhe, -r Auflösung, -m Modus, -b Hintergrundfarbe | Neue PSD erstellen |
open <pfad> | | PSD-Datei öffnen |
save [pfad] | | Dokument speichern |
close | --no-save | Dokument schließen |
document – Dokumentoperationen
| Befehl | Optionen | Beschreibung |
|---|
info | | Dokumentinformationen |
resize | -w Breite, -h Höhe, -r Auflösung | Größe anpassen |
canvas | -w Breite, -h Höhe, -a Anker | Arbeitsfläche anpassen |
crop | --left --top --right --bottom | Zuschneiden |
rotate | -a Winkel | Arbeitsfläche drehen |
flip | -d Richtung | Arbeitsfläche spiegeln |
mode | -m Modus | Farbmodus ändern |
trim | -t Typ | Kanten zuschneiden |
layer – Ebenenoperationen
| Befehl | Optionen | Beschreibung |
|---|
add | -n Name, -t Typ, -o Deckkraft, -b Mischmodus | Ebene hinzufügen |
delete | -n Name | Ebene löschen |
duplicate | -n Name, --new-name Name | Ebene duplizieren |
rename | --old Name, --new Name | Umbenennen |
show / hide | -n Name | Ein-/Ausblenden |
opacity | -n Name, -o Deckkraft | Deckkraft einstellen |
blend | -n Name, -m Modus | Mischmodus einstellen |
list | | Alle Ebenen auflisten |
reorder | -n Name, -p Position | Reihenfolge ändern |
merge | -n Name, --with-layer Name | Ebenen zusammenführen |
selection – Auswahloperationen
| Befehl | Optionen | Beschreibung |
|---|
all | | Alles auswählen |
none | | Auswahl aufheben |
invert | | Auswahl umkehren |
feather | -r Radius | Weiche Kante |
expand | -p Pixel | Erweitern |
contract | -p Pixel | Verkleinern |
border | -w Breite | Rahmenauswahl |
rect | --left --top --right --bottom | Rechteckige Auswahl |
fill | -c Farbe, -o Deckkraft | Auswahl füllen |
text – Textoperationen
| Befehl | Optionen | Beschreibung |
|---|
add | -t Text, -f Schriftart, -s Größe, -c Farbe | Text hinzufügen |
edit | -n Name, -t Text, -f Schriftart, -s Größe, -c Farbe | Text bearbeiten |
info | -n Name | Textinformationen |
export – Export
| Befehl | Optionen | Beschreibung |
|---|
save <pfad> | -f Format, -q Qualität, -w Breite, -h Höhe | Datei exportieren |
repl
| Befehl | Beschreibung |
|---|
repl | Interaktiven REPL-Modus starten |
Verwendungsbeispiele
Verwendung mit KI-Agenten (--json-Modus)
cli-anything-photoshop --json project new -w 800 -h 600 poster.psd
cli-anything-photoshop --json --project poster.psd text add -t "Hallo Welt" -f Arial -s 48 -c "#FF0000"
cli-anything-photoshop --json --project poster.psd layer list
cli-anything-photoshop --json --project poster.psd export save -f png ausgabe.png
cli-anything-photoshop --dry-run --project poster.psd layer add -n "entwurf" --type text
Manuelle Verwendung
cli-anything-photoshop --project arbeit.psd layer list
cli-anything-photoshop repl
Leitfaden für Agenten
- Verwenden Sie immer das
--json-Flag für strukturierte Ausgaben
- Nutzen Sie
--dry-run für Vorschauen, bevor Sie endgültig speichern
- Fehlerbehandlung: Prüfen Sie bei Exit-Code ungleich Null das JSON-Fehlerobjekt in
stderr
- Projektstatus: Verwenden Sie
--project zur automatischen Dateiverwaltung (Öffnen/Speichern)
- REPL-Modus: Geeignet für mehrschrittige interaktive Operationen; reduziert Overhead durch Photoshop-Prozessstarts
Photoshop COM-Architektur
CLI-Befehl → Click CLI → Core-Modul → ComBridge (Singleton) → Photoshop.Application COM → Photoshop-Engine
Photoshop stellt über die Windows COM-Schnittstelle alle Bearbeitungsfähigkeiten zur Verfügung. Dieses Harness kapselt die wichtigsten Operationen. Für Erweiterungen siehe die Adobe Photoshop COM-Dokumentation und fügen Sie neue Methoden in utils/com_bridge.py hinzu.