2026 OpenClaw — contrôle qualité PNG en pratique : pixels transparents, seuils de volume et nommage par lot sur Mac distant

① Définition des métriques QA (volume, transparence, dimensions)

Traitez la QA comme un contrat entre l’export design et les systèmes aval. Rédigez-le une fois dans un petit fichier de config (YAML ou JSON) et comparez les mêmes chiffres à chaque exécution.

• Taille fichier (octets) : définissez max_bytes par classe d’asset. Exemples de seuils : icônes et glyphes ≤ 150 Ko, heroes web pleine largeur en 2× sous 1,5 Mo, splash sous 4 Mo. Journalisez à la fois la taille brute et les dimensions pour que le design voie si le problème vient de la résolution ou de la compression.
• Transparence / alpha : pour chaque classe, précisez si l’alpha doit être straight, si l’alpha est interdite (visuels marketing aplatis), ou si une zone transparente minimale est requise (ex. stickers découpés). Pour les contrôles de pixels transparents, règles typiques : pas plus de 0,1 % de pixels entièrement transparents à l’intérieur de la boîte englobante non masquée (trous parasites), pas de « poussière » semi-transparente sous opacité 8/255 sauf à moins de N px des bords, et présence obligatoire du canal alpha pour les calques UI.
• Dimensions : fixez min_w, max_w, min_h, max_h, et un modulo optionnel (ex. largeur divisible par 8 pour incrustation vidéo). Rejetez les hauteurs impaires pour certains emplacements pub. Le DPI n’intervient que pour l’impression ; pour le web, ce sont les pixels qui comptent.
• Nommage : une seule expression régulière, par ex. ^[a-z0-9]+(?:-[a-z0-9]+)*__w[0-9]+h[0-9]+\.png$ ou votre schéma interne projet_composant_etat.png. Rejetez espaces, doubles extensions et Unicode inattendu sauf accord explicite du CMS.

② Étapes d’orchestration des tâches OpenClaw

OpenClaw joue le rôle de coordinateur : il déclenche des compétences shell, analyse les journaux et sollicite l’humain seulement quand l’automatisation s’arrête. Sur un Mac distant, privilégiez des chemins absolus et évitez le Bureau synchronisé iCloud.

1. Stocker les entrées : le design ou la CI copie les PNG dans ~/qa_jobs/{job_id}/inbox/. Option dossier surveillé : avec fswatch sous macOS, enfiler un job lorsque le dossier se stabilise (aucun nouveau fichier pendant 30 s).
2. Normaliser : première étape — renommage brouillon canonique si besoin, vérification de l’extension, rejet si les octets magiques ne correspondent pas au PNG.
3. Exécuter les validateurs : un script par sujet (taille, alpha, dimensions, nom) ou un pilote unique lisant la config. Chaque contrôle se termine en échec avec une ligne machine : FAIL\talpha_dust\tfichier.png.
4. Agréger : OpenClaw (ou un wrapper) fusionne les résultats dans report.json et tranche pass/fail pour le lot.
5. Notifier : en cas d’échec, publier le chemin du manifeste (Slack, e-mail) ; en cas de succès, déplacer vers pass/ et éventuellement pousser vers le stockage.

Esquisse dossier surveillé : lancez un petit démon sous launchd ou dans une session tmux pour survivre aux déconnexions SSH. Le watcher doit débouncer les rafales — les outils d’export écrivent souvent des fichiers temporaires.

# Surveillance avec debounce (conceptuel) : quand inbox est calme, lancer le pilote QA une fois
WATCH="$HOME/qa_jobs/demo/inbox"
fswatch -o "$WATCH" | while read; do
  sleep 30
  ~/bin/openclaw-qa-run.sh --job demo --config ~/qa/rules.yaml
done

Combinez ce flux avec notre guide pipeline dossier surveillé et renommage PNG et l’article installation Mac et validation par lot si vous câblez encore l’hôte.

③ Gabarits de scripts et exemples de paramètres

Modèles prêts à adapter. Installez ImageMagick (brew install imagemagick) pour des stats alpha rapides ; utilisez Pillow pour des règles pixel-précises en Python.

Bash : garde-fous dimensions + taille fichier

#!/usr/bin/env bash
set -euo pipefail
MAX_BYTES=1500000
MIN_W=64 MAX_W=4096
MIN_H=64 MAX_H=4096
for f in "$@"; do
  read -r w h < <(magick identify -format "%w %h" "$f")
  sz=$(stat -f%z "$f")
  [[ "$sz" -le "$MAX_BYTES" ]] || { echo "FAIL\tsize_bytes\t$f"; continue; }
  (( w >= MIN_W && w <= MAX_W && h >= MIN_H && h <= MAX_H )) || echo "FAIL\tdimensions\t$f"
done

Bash : exiger le canal alpha (rejeter le RGB seul lorsque la superposition est attendue) :

for f in "$@"; do
  magick identify -format "%[channels]" "$f" | grep -q alpha \
    || echo "FAIL\tmissing_alpha\t$f"
done

Python : ratio approximatif de pixels transparents (ajuster THRESH ; nécessite pillow) :

#!/usr/bin/env python3
from PIL import Image
import sys
THRESH = 16  # alpha min (0-255) pour compter comme "visible"
MAX_FRAC = 0.002  # fraction max entièrement transparente
for path in sys.argv[1:]:
    im = Image.open(path).convert("RGBA")
    a = im.split()[-1]
    transparent = sum(1 for p in a.getdata() if p < THRESH)
    frac = transparent / (im.width * im.height)
    if frac > MAX_FRAC:
        print(f"FAIL\ttransparent_ratio\t{path}\t{frac:.4f}")

Exemples de paramètres à encoder dans rules.yaml :

• icons: max_bytes: 120000, square: true, must_have_alpha: true, max_transparent_fraction: 0.0005
• hero_web: max_bytes: 1800000, width: [1920, 3840], height: [1080, 2160], must_have_alpha: false

④ Reflux des échecs et relance

La montée en charge n’est viable que si la gestion des échecs est routinière. Automatisez la traçabilité.

• Déplacer, ne pas effacer : à chaque FAIL, mv le PNG vers failed/{job_id}/ et ajoutez une ligne JSON à failed/{job_id}/manifest.jsonl avec path, rule, detail et qa_rules_version.
• Boucle humaine : le design lit le manifeste, corrige dans Figma / Sketch / Affinity, réexporte et redépose dans inbox/. Gardez des noms stables pour des diffs lisibles.
• Relance : même job OpenClaw avec --only failed_manifest.jsonl (votre wrapper lit les chemins). Retirez du manifeste les entrées passées pour réduire la file.
• Garde régression : conservez un dossier golden/ avec une dizaine de PNG sûrs et lancez la QA à chaque déploiement du script. Si golden échoue, bloquez la mise en prod.

Dépannage express :

• Faux positifs transparence : export en alpha prémultiplié ou profil couleur incohérent — réexporter en alpha straight et embarquer sRGB si la charte l’exige.
• Pics de taille aberrants : miniatures embarquées ou métadonnées lourdes ; optionnellement magick mogrify -strip dans une étape séparée (si la marque l’autorise).
• Watcher trop nerveux : augmenter le debounce ou ignorer *.tmp et .DS_Store.
• Environnement SSH différent : sous shell non interactif, vérifier which magick et echo $PATH ; fixer des chemins absolus dans le plist ou l’équivalent launchd.

⑤ FAQ

Pour aller plus loin : nommage auto PNG et validation par lot, FAQ export PNG et transparence, automatisation PNG assistée par IA. Lorsque vous êtes prêt à enchaîner de longues passes QA sur du matériel dédié, ouvrez nos pages location Mac et tarifs sur le site : pour une durée limitée, vous pouvez consulter les forfaits et les nœuds sans connexion obligatoire, puis suivez le guide SSH/VNC pour rattacher votre Mac distant.