使用時機
當使用者要求從文字描述生成任何封面圖片、縮圖、橫幅、海報或頁首時使用。觸發詞包括:「產生封面」、「建立縮圖」、「製作橫幅」、「設計封面」、「生成封面圖」或任何涉及從提示詞建立指定尺寸圖片的請求。
此技能採用兩階段流水線:
- mflux (FLUX.2 4-bit, Apple MLX) 生成 AI 背景圖片
- HTML/CSS + Playwright Chromium 在背景上疊加銳利文字
請勿用於:不包含文字疊加的通用圖片生成、圖片編輯、放大或非封面用途。
需求
- macOS 搭配 Apple Silicon (M1+)
- 建議 16 GB+ 記憶體(8 GB 可能可在較低解析度下運作)
- mflux:
brew install uv && uv tool install mflux - Playwright:
pip install playwright && playwright install chromium - 首次執行會下載 FLUX.2 模型(約 2-4 GB),之後完全離線
程序
- 檢查先決條件:
python3 cover_generator.py --detect— mflux 和 Playwright+Chromium 都應顯示 ✓ - 決定尺寸:使用預設尺寸或指定精確的寬×高:
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)
- 選擇佈局:
--layout bottom(預設)、centered、hero、top - 選擇漸層:
--gradient dark(預設)、subtle、light、none - 生成:
python3 cover_generator.py -p "描述" --preset blog-cover - 優化提示詞:對
--prompt(AI 背景)使用英文,對--title(可見文字)保留原始語言 - 驗證:輸出檔案應存在且尺寸正確
常見陷阱
- mflux 需要 Apple Silicon (M1+) — Intel Mac 無法執行
- Playwright 會另外安裝 Chromium(約 300 MB 下載)
- 首次執行 mflux 會下載 FLUX.2 模型(約 2-4 GB);後續執行可離線
- AI 提示詞中使用中文可能導致背景品質較低 — 請對
--prompt使用英文翻譯,用--title設定可見的中文字 - 非常大的尺寸(>3840 像素)可能較慢。對於 A4 列印 (3508 px),預估渲染時間為 3-5 秒
- 提示詞品質對背景影響很大:請具體描述風格(例如「極簡水彩」、「暗黑電影感」、「乾淨抽象漸層」)
- mflux 會將尺寸調整為 64 的倍數 — 背景圖片可能略微小於要求大小;最終疊加步驟會修正為確切尺寸
驗證
python3 cover_generator.py --detect— mflux ✓、Playwright+Chromium ✓- 完整流水線測試:
python3 cover_generator.py -p 'A serene mountain lake at dawn' -o test.png - 確認輸出尺寸與輸入相符
- 原始模式測試:
python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png