haoyiyin/mflux-cover

Wann verwenden

Verwenden Sie diese Fähigkeit, wenn der Benutzer die Erstellung eines beliebigen Coverbildes, Thumbnails, Banners, Posters oder Headers aus einer Textbeschreibung wünscht. Auslöser sind unter anderem: „generiere ein Cover“, „erzeuge ein Thumbnail“, „mache ein Banner“, „设计封面“, „生成封面图“ oder jede Anfrage, die das Erstellen von Bildern aus Aufforderungen mit bestimmten Abmessungen beinhaltet.

Diese Fähigkeit verwendet eine zweistufige Pipeline:

1. mflux (FLUX.2 4-Bit, Apple MLX) erzeugt das KI-Hintergrundbild
2. HTML/CSS + Playwright Chromium rendert scharfe Typografie darüber

NICHT verwenden für: allgemeine Bilderzeugung ohne Textüberlagerung, Bildbearbeitung, Hochskalierung oder andere Anwendungsfälle als Cover.

Voraussetzungen

• macOS mit Apple Silicon (M1+)
• 16 GB+ RAM empfohlen (8 GB können mit reduzierter Auflösung funktionieren)
• mflux: brew install uv && uv tool install mflux
• Playwright: pip install playwright && playwright install chromium
• Erster Start lädt das FLUX.2-Modell herunter (~2-4 GB), danach vollständig offline

Vorgehen

1. Voraussetzungen prüfen: python3 cover_generator.py --detect – sowohl mflux als auch Playwright+Chromium sollten ✓ anzeigen
2. Abmessungen bestimmen: Verwenden Sie Voreinstellungen oder genaue B×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. Layout wählen: --layout bottom (Standard), centered, hero, top
4. Farbverlauf wählen: --gradient dark (Standard), subtle, light, none
5. Generieren: python3 cover_generator.py -p "Beschreibung" --preset blog-cover
6. Aufforderungen optimieren: Verwenden Sie Englisch für --prompt (KI-Hintergrund), behalten Sie die Originalsprache für --title (sichtbarer Text) bei
7. Überprüfen: Die Ausgabedatei sollte mit den korrekten Abmessungen vorhanden sein

Fallstricke

• mflux erfordert Apple Silicon (M1+) – Intel Macs können es nicht ausführen
• Playwright installiert Chromium separat (~300 MB Download)
• Der erste mflux-Start lädt das FLUX.2-Modell herunter (~2-4 GB); spätere Läufe sind offline
• Chinesischer Text in KI-Aufforderungen kann Hintergründe von geringerer Qualität erzeugen – übersetzen Sie für --prompt ins Englische, verwenden Sie --title für den sichtbaren chinesischen Text
• Sehr große Abmessungen (>3840 px) können langsam sein. Für A4-Druck (3508 px) ist mit einer Renderzeit von 3-5 s zu rechnen
• Die Qualität der Aufforderung beeinflusst den Hintergrund erheblich: Seien Sie spezifisch bezüglich des Stils (z. B. „minimalistisches Aquarell“, „dunkel cinematisch“, „sauberer abstrakter Farbverlauf“)
• mflux rundet Abmessungen auf Vielfache von 64 – das Hintergrundbild kann etwas kleiner als angefordert sein; der finale Überlagerungsschritt korrigiert auf genaue Abmessungen

Überprüfung

1. python3 cover_generator.py --detect – mflux ✓, Playwright+Chromium ✓
2. Vollständiger Pipeline-Test: python3 cover_generator.py -p 'Ein ruhiger Bergsee bei Morgendämmerung' -o test.png
3. Überprüfen, ob die Ausgabeabmessungen mit der Eingabe übereinstimmen
4. Rohmodus-Test: python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png