haoyiyin/mflux-cover

Quand l'utiliser

Utilisez quand l'utilisateur demande de générer une image de couverture, une miniature, une bannière, une affiche ou un en-tête à partir d'une description textuelle. Les déclencheurs incluent : "génère une couverture", "crée une miniature", "fais une bannière", "设计封面", "生成封面图", ou toute demande impliquant la création d'images à partir de prompts avec des dimensions spécifiées.

Cette compétence utilise un pipeline en deux étapes :

1. mflux (FLUX.2 4-bit, Apple MLX) génère l'image d'arrière-plan IA
2. HTML/CSS + Playwright Chromium rend la typographie nette par-dessus

Ne PAS utiliser pour : la génération d'images sans superposition de texte, l'édition d'images, l'upscaling, ou les cas d'utilisation non liés aux couvertures.

Prérequis

• macOS avec Apple Silicon (M1+)
• 16 Go+ de RAM recommandé (8 Go peut fonctionner avec une résolution réduite)
• mflux : brew install uv && uv tool install mflux
• Playwright : pip install playwright && playwright install chromium
• La première exécution télécharge le modèle FLUX.2 (~2-4 Go), puis entièrement hors ligne

Procédure

1. Vérifier les prérequis : python3 cover_generator.py --detect — mflux et Playwright+Chromium doivent tous deux afficher ✓
2. Déterminer les dimensions : Utilisez les préréglages ou des dimensions exactes L×H :
   • youtube-thumbnail (1280×720), twitter-header (1500×500), blog-cover (1200×630)
   • instagram-post (1080×1080), facebook-cover (1640×624), linkedin-banner (1584×396)
   • podcast-cover (3000×3000), github-social (1280×640), story (1080×1920)
3. Choisir la disposition : --layout bottom (par défaut), centered, hero, top
4. Choisir le dégradé : --gradient dark (par défaut), subtle, light, none
5. Générer : python3 cover_generator.py -p "description" --preset blog-cover
6. Optimiser les prompts : Utilisez l'anglais pour --prompt (arrière-plan IA), conservez la langue d'origine pour --title (texte visible)
7. Vérifier : Le fichier de sortie doit exister avec les bonnes dimensions

Pièges

• mflux nécessite Apple Silicon (M1+) — les Mac Intel ne peuvent pas l'exécuter
• Playwright installe Chromium séparément (~300 Mo de téléchargement)
• La première exécution de mflux télécharge le modèle FLUX.2 (~2-4 Go) ; les exécutions suivantes sont hors ligne
• Le texte chinois dans les prompts IA peut produire des arrière-plans de moindre qualité — traduisez en anglais pour --prompt, utilisez --title pour le texte chinois visible
• Les très grandes dimensions (>3840 px) peuvent être lentes. Pour l'impression A4 (3508 px), attendez 3 à 5 secondes de rendu
• La qualité du prompt impacte fortement l'arrière-plan : soyez précis sur le style (par ex., 'aquarelle minimaliste', 'cinématographique sombre', 'dégradé abstrait propre')
• mflux arrondit les dimensions à des multiples de 64 — l'image d'arrière-plan peut être légèrement plus petite que demandée ; l'étape de superposition finale corrige aux dimensions exactes

Vérification

1. python3 cover_generator.py --detect — mflux ✓, Playwright+Chromium ✓
2. Test du pipeline complet : python3 cover_generator.py -p 'Un lac de montagne serein à l\'aube' -o test.png
3. Vérifiez que les dimensions de sortie correspondent à l'entrée
4. Test en mode brut : python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png