Bildverarbeitung und -bearbeitung
Führt deterministische Operationen an vorhandenen Bildern durch: Skalieren, Zuschneiden, Auffüllen, Formatkonvertierung, Komprimieren, Wasserzeichen, abgerundete Ecken, Collagen, Thumbnails. Alle Operationen erfolgen über
skills/shared/scripts/image_ops.py(reines Pillow), keine ad-hoc Skripte.
Eingabe
- Ein oder mehrere Pfade zu vorhandenen Bilddateien (von Pillow unterstützte Formate wie PNG, JPG, WebP)
- Zieloperation und Parameter (Abmessungen, Seitenverhältnis, Qualität, Wasserzeichentext, Collage-Modus usw.)
Ausgabe
- Bearbeitete Bilddateien (Pfad vom Benutzer vorgegeben oder standardmäßig in
outputs/Thema/) - Jeder Befehl meldet
✅ Pfad (Breite x Höhe, Größe KB); der Befehlinfogibt JSON aus
Abgrenzung (zu card-*)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = Entwerfen und Rendern neuer Bilder (HTML → Screenshot)
- image-editing = Vorhandene Bilder bearbeiten, keine visuelle Gestaltung, keine Content-Erstellung, nur Pixelbearbeitung
- Wenn „aus Daten/Text ein Bild erzeugen“ gewünscht ist → chart / infographic / card-* verwenden; dieses SKILL verarbeitet nur vorhandene Bilddateien
Ausführungsschritte
- Prüfen, ob die Eingabebilder existieren und die Zieloperation und Parameter klar sind
- Den entsprechenden Unterbefehl von
image_ops.pyvom Stammverzeichnis des Projekts aus ausführen (siehe unten) - Bei Bedarf nach Plattformabmessungen die empfohlenen Seitenverhältnisse/Pixel aus
references/platform-sizes.mdnachschlagen - Ausgabepfad und -abmessungen melden; Mehrfachoperationen können verkettet werden (z. B. zuerst resize, dann compress)
Befehlsreferenz
Der Skriptpfad ist einheitlich skills/shared/scripts/image_ops.py, alle Befehle unterstützen -h für Parameterdetails.
# Skalieren: Nach Breite/Höhe/Prozent, --keep-ratio für proportionale Skalierung innerhalb der Box
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio
# Zuschneiden: Per Koordinatenbox oder mittig auf eine bestimmte Größe
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080
# Auffüllen auf Zielseitenverhältnis (Kernfunktion für Social Media): Beliebiges Bild auf 1:1 / 9:16 / 16:9 auffüllen
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"
# Formatkonvertierung png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# Komprimieren: Bestimmte Qualität oder Annäherung an maximalen Dateigrößen-Limit (jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200
# Wasserzeichen: Text (Position/Transparenz/Schriftgröße/-farbe, sucht automatisch nach chinesischen Systemschriften) oder Bild (unten rechts usw.)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@Kontoname" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8
# Abgerundete Ecken (Ausgabe als transparentes PNG); --radius-percent 50 ergibt einen Kreis
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50
# Collage: Horizontal/Vertikal/Raster NxM (Spalten x Zeilen), --cell-width/height für einheitliche Zellen
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540
# Thumbnail (längste Seite in Pixeln)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# Bildinformationen auslesen (JSON: Abmessungen/Format/Seitenverhältnis/Größe/Transparenzkanal)
python skills/shared/scripts/image_ops.py info -i in.jpg
Domänenwissen: Empfohlene Plattformabmessungen
Häufig empfohlene Plattformabmessungen finden Sie in references/platform-sizes.md. Kurzübersicht:
- Xiaohongshu Hochformat Bild+Text: 1080×1440 (3:4); Xiaohongshu Video/Hochformat Poster: 1080×1920 (9:16)
- WeChat Moments Einzelbild / Generisches Quadrat: 1:1 (z. B. 1080×1080)
- Querformat Zitat/Thumbnail: 16:9 (z. B. 1920×1080); WeChat Official Account Header: 900×383
- Weibo-Bild: 1:1 oder 4:3; Douyin/Video-Cover: 9:16 (1080×1920)
Anpassungsstrategie: Bevorzugt pad verwenden (füllt auf, ohne Bildinhalt zu beschneiden oder zu verzerren), um das Bild zu erhalten; für randloses Vollbild crop mittig auf das Zielseitenverhältnis zuschneiden; nur für Größenreduzierung resize/compress verwenden.
Profil-Erkennung
- Mit Profil: Wasserzeichentext verwendet standardmäßig den Kontonamen/Handle; Ausgabeseitenverhältnis passt sich standardmäßig der Hauptplattform des Kontos an (z. B. Xiaohongshu Konto standardmäßig 1080×1440)
- Ohne Profil: Ausführung nach expliziten Benutzerparametern, Seitenverhältnis bleibt standardmäßig original, Wasserzeichen erfordert Benutzereingabe
Abhängigkeiten und Fehlerbehandlung
- Abhängigkeit: Pillow (bereits installiert, überprüfbar mit
python -c "import PIL"), reine Standardbibliothek ohne weitere Drittanbieter - Integrierte Prüfungen im Skript: Datei existiert nicht / Zuschneidebox außerhalb des Bereichs / ungültiges Seitenverhältnis oder Farbe → Exit-Code 2 und Ausgabe von
ERROR: - Falls keine chinesische Systemschrift gefunden wird, erfolgt ein Fallback auf die PIL-Standardschrift und eine
WARNMeldung; mit--fontkann eine Schriftart angegeben werden - Selbsttest:
python skills/shared/scripts/image_ops.py --selftest