Communitygithub.com

haoyiyin/mflux-cover

智慧型封面圖片生成工具:使用 mflux (FLUX.2 MLX) 繪製背景,搭配 HTML/CSS + Playwright 精確疊加文字。完全在 Apple Silicon 上本地運行。

mflux-cover 是什麼?

這是一個 AI 代理技能,專門用於根據文字描述生成精美的封面圖片、縮圖、橫幅或海報。它採用兩階段流水線:首先透過 mflux (FLUX.2 4-bit, Apple MLX) 在本地 Apple Silicon 上生成 AI 背景圖,接著使用 HTML/CSS 搭配 Playwright Chromium 在背景上疊加銳利的排版文字,確保最終輸出兼具藝術性與可讀性。支援多種常見尺寸預設(如 YouTube 縮圖、Instagram 貼文、Podcast 封面),並提供佈局與漸層選項。此技能完全離線運作,對注重隱私與快速迭代的開發者特別有價值。支援平台包括 Claude Code、Codex 等能以自然語言觸發封面生成的工作環境。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add haoyiyin/mflux-cover

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

使用時機

當使用者要求從文字描述生成任何封面圖片、縮圖、橫幅、海報或頁首時使用。觸發詞包括:「產生封面」、「建立縮圖」、「製作橫幅」、「設計封面」、「生成封面圖」或任何涉及從提示詞建立指定尺寸圖片的請求。

此技能採用兩階段流水線:

  1. mflux (FLUX.2 4-bit, Apple MLX) 生成 AI 背景圖片
  2. 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),之後完全離線

程序

  1. 檢查先決條件:python3 cover_generator.py --detect — mflux 和 Playwright+Chromium 都應顯示 ✓
  2. 決定尺寸:使用預設尺寸或指定精確的寬×高:
    • 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 bottom(預設)、centered、hero、top
  4. 選擇漸層:--gradient dark(預設)、subtle、light、none
  5. 生成:python3 cover_generator.py -p "描述" --preset blog-cover
  6. 優化提示詞:對 --prompt(AI 背景)使用英文,對 --title(可見文字)保留原始語言
  7. 驗證:輸出檔案應存在且尺寸正確

常見陷阱

  • 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 的倍數 — 背景圖片可能略微小於要求大小;最終疊加步驟會修正為確切尺寸

驗證

  1. python3 cover_generator.py --detect — mflux ✓、Playwright+Chromium ✓
  2. 完整流水線測試:python3 cover_generator.py -p 'A serene mountain lake at dawn' -o test.png
  3. 確認輸出尺寸與輸入相符
  4. 原始模式測試:python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png

相關技能