photo-kit

Was macht photo-kit?

Alle Pixel-Entscheidungen werden von scripts/photo_kit.py getroffen. Ihre Aufgabe ist es, das Skript auszuführen, den Bericht und die Review-Bögen zu lesen, Übersteuerungen für die wenigen Fotos zu schreiben, die sie benötigen, nur diese erneut auszuführen und dann den Ordner an den Menschen zu übergeben. Bearbeiten Sie Bilder auf keine andere Weise. Schreiben Sie das Skript nicht um, es sei denn, eine Prüfung schlägt zweimal fehl.

Einrichtung (einmal pro Projekt)

• Python 3.10+ und pip install -r requirements.txt (Pillow 10.1+, numpy, opencv-python-headless, fontTools, brotli).
• Eine Projektkonfiguration als JSON, die nur aufführt, was von config.default.json abweicht (Markenlogo, Schriftartdatei(en), Farben, URL, optionaler Materialfarbmuster). Webfonts sind oft in Untermengen aufgeteilt: Listen Sie jede Datei unter brand.font auf.

Ausführen

python <skill-folder>/scripts/photo_kit.py process IN_DIR OUT_DIR --config <project-config.json> [--overrides OUT_DIR/overrides.json] [--only stem1,stem2]
python <skill-folder>/scripts/photo_kit.py cards OUT_DIR cards.json --config <project-config.json>
python <skill-folder>/scripts/photo_kit.py verify OUT_DIR

Ausgabe pro Foto: OUT_DIR/<stem>/00_master.png (verlustfrei), plattformspezifische JPEGs, optionale brandierte Karten; plus manifest.csv, report.json und _review/before_after_NN.jpg. Schreiben Sie das Ausgabeverzeichnis niemals in den Eingabeordner oder in einen Website-Quellcodebaum.

Review-Schleife (zuerst Text, dann Bilder)

1. Lesen Sie die Konsolenzusammenfassung und die report.json. Handeln Sie nur bei klaren Signalen (große Neigung, die übersprungen wurde, TOO SMALL-Flags, offensichtlicher Farbstich, Menschen, die gestreckt aussehen, usw.).
2. Öffnen Sie die Review-Bögen einmal. Für einen schlechten Zuschnitt setzen Sie {"focus": [x, y]} (0–1 des Masters).
3. Schreiben Sie OUT_DIR/overrides.json und führen Sie erneut mit --only den/die betroffenen Stammnamen aus.
4. Karten: Schreiben Sie cards.json mit nur genehmigten Überschriften (maximal ~45 Zeichen). Verwenden Sie "fit": "whole" für Hochformatfotos auf Hochformatkarten.
5. Führen Sie verify aus (muss clean ausgeben), melden Sie dann den Ordnerpfad, die Plattformzwecke, verbleibende Flags und jedes Foto, das nicht behoben werden konnte. Der Mensch prüft alles vor dem Hochladen.

Ranking einer Fotobibliothek

Führen Sie process auf einem Ordner aus, der einen Unterordner pro Thema enthält. Bewerten Sie nach den quality-Punkten in report.json (sharpness × Auflösungsfaktor), bestrafen Sie TOO SMALL-Flags und prüfen Sie dann ein Kontaktblatt der besten Kandidaten.

Regeln, die sich nie ändern

• Google Ads-Bilder: nur reine Exporte (kein Logo, Text, Rahmen oder Rand).
• Business Profile: nur leichte Korrektur; standardmäßig reiner Export.
• Ändern Sie nie das Produkt: keine Neufärbung, keine hinzugefügte Textur, keine Fehlerentfernung, keine KI-Füllung. Zuschnitt von Unordnung ist in Ordnung.
• Nur die eigenen Fotos der Organisation. Keine Gesichter von Kunden, Hausnummern oder Credits von Drittanbieterfotografen.
• Behalten Sie Originale; Ausgaben sind immer neue Dateien.
• Kartenüberschriften stammen nur aus genehmigtem Text.

Optimierung

Passen Sie die correction-Stärken und card_formats in der Projektkonfiguration an (nicht im Skript). Übersteuerungen pro Foto behandeln Ausnahmen.