Que fait photo-kit ?
Toutes les décisions pixel sont prises par scripts/photo_kit.py. Votre travail consiste à l'exécuter, lire le rapport et les fiches de revue, écrire des surcharges pour les quelques photos qui en ont besoin, relancer uniquement celles-ci, puis remettre le dossier à un humain.
Ne modifiez pas les images d'une autre manière. Ne réécrivez pas le script sauf si une vérification échoue deux fois.
Configuration (une fois par projet)
- Python 3.10+ et
pip install -r requirements.txt(Pillow 10.1+, numpy, opencv-python-headless, fontTools, brotli). - Un fichier JSON de configuration projet qui liste seulement ce qui diffère de
config.default.json(logo de la marque, fichier(s) de police, couleurs, URL, nuancier de matériau optionnel).
Les polices web sont souvent divisées en sous-ensembles : listez chaque fichier dansbrand.font.
Exécution
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
Sortie par photo : OUT_DIR/<stem>/00_master.png (sans perte), JPEGs pour chaque plateforme, cartes personnalisées optionnelles ; plus manifest.csv, report.json et _review/before_after_NN.jpg.
N'écrivez jamais le répertoire de sortie à l'intérieur du dossier d'entrée ou d'une arborescence source de site web.
Boucle de révision (texte d'abord, images ensuite)
- Lisez le résumé dans la console et
report.json. N'agissez que sur des signaux clairs (forte inclinaison ignorée, drapeauxTOO SMALL, dominante de couleur évidente, personnes qui semblent étirées, etc.). - Ouvrez une fois les fiches de revue. Pour un mauvais recadrage, définissez
{"focus": [x, y]}(0–1 du master). - Écrivez
OUT_DIR/overrides.jsonet relancez avec--onlyles stems concernés. - Cartes : écrivez
cards.jsonavec uniquement les titres approuvés (max ~45 caractères). Utilisez"fit": "whole"pour les photos portrait sur des cartes portrait. - Exécutez
verify(doit afficherclean), puis signalez le chemin du dossier, les finalités des plateformes, les drapeaux restants et toute photo qui n'a pas pu être corrigée. L'humain vérifie tout avant téléchargement.
Classement d'une bibliothèque de photos
Exécutez process sur un dossier contenant un sous-dossier par sujet. Classez selon les scores de quality dans report.json (sharpness × facteur de résolution), pénalisez les drapeaux TOO SMALL, puis examinez une planche-contact des meilleurs candidats.
Règles qui ne changent jamais
- Images Google Ads : exportations brutes uniquement (pas de logo, texte, cadre ou bordure).
- Business Profile : correction légère uniquement ; exportation brute par défaut.
- Ne jamais modifier le produit : pas de recoloration, pas d'ajout de texture, pas de suppression de défauts, pas de remplissage IA. Recadrer l'encombrement est acceptable.
- Uniquement les photos propres à l'organisation. Pas de visages de clients, de numéros de maison, ni de crédits de photographe tiers.
- Conservez les originaux ; les sorties sont toujours de nouveaux fichiers.
- Les titres des cartes proviennent uniquement du texte approuvé.
Réglage
Ajustez les forces de correction et les card_formats dans la configuration du projet (pas dans le script). Les surcharges par photo gèrent les exceptions.