haoyiyin/mflux-cover

Cuándo usarlo

Úsalo cuando el usuario solicite generar cualquier imagen de portada, miniatura, banner, póster o encabezado a partir de una descripción textual. Los disparadores incluyen: "generar una portada", "crear una miniatura", "hacer un banner", "设计封面", "生成封面图" o cualquier petición que implique crear imágenes a partir de indicaciones con dimensiones especificadas.

Este skill utiliza un pipeline de dos pasos:

1. mflux (FLUX.2 4-bit, Apple MLX) genera la imagen de fondo con IA
2. HTML/CSS + Playwright Chromium renderiza la tipografía nítida sobre la imagen

NO lo uses para: generación general de imágenes sin superposición de texto, edición de imágenes, escalado o casos que no sean de portada.

Requisitos

• macOS con Apple Silicon (M1+)
• 16 GB+ de RAM recomendado (8 GB puede funcionar con resolución reducida)
• mflux: brew install uv && uv tool install mflux
• Playwright: pip install playwright && playwright install chromium
• La primera ejecución descarga el modelo FLUX.2 (~2-4 GB), luego funciona completamente sin conexión

Procedimiento

1. Verificar requisitos previos: python3 cover_generator.py --detect — tanto mflux como Playwright+Chromium deberían mostrar ✓
2. Determinar dimensiones: Usa valores predefinidos o W×H exactos:
   • 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. Elegir diseño: --layout bottom (predeterminado), centered, hero, top
4. Elegir degradado: --gradient dark (predeterminado), subtle, light, none
5. Generar: python3 cover_generator.py -p "descripción" --preset blog-cover
6. Optimizar indicaciones: Usa inglés para --prompt (fondo de IA), mantén el idioma original para --title (texto visible)
7. Verificar: El archivo de salida debe existir con las dimensiones correctas

Errores comunes

• mflux requiere Apple Silicon (M1+) — las Mac con Intel no pueden ejecutarlo
• Playwright instala Chromium por separado (~300 MB de descarga)
• La primera ejecución de mflux descarga el modelo FLUX.2 (~2-4 GB); las ejecuciones posteriores son sin conexión
• El texto chino en las indicaciones de IA puede producir fondos de menor calidad: traduce al inglés para --prompt, usa --title para el texto chino visible
• Las dimensiones muy grandes (>3840 px) pueden ser lentas. Para impresión A4 (3508 px), espera un tiempo de renderizado de 3-5 s
• La calidad de la indicación afecta mucho al fondo: sé específico sobre el estilo (p. ej., 'minimalist watercolor', 'dark cinematic', 'clean abstract gradient')
• mflux redondea las dimensiones a múltiplos de 64 — la imagen de fondo puede ser ligeramente más pequeña de lo solicitado; el paso final de superposición corrige las dimensiones exactas

Verificación

1. python3 cover_generator.py --detect — mflux ✓, Playwright+Chromium ✓
2. Prueba del pipeline completo: python3 cover_generator.py -p 'Un lago de montaña sereno al amanecer' -o test.png
3. Verifica que las dimensiones de salida coincidan con las de entrada
4. Prueba en modo bruto: python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png