何时使用
当用户要求基于文字描述生成任何封面图、缩略图、横幅、海报或页头时使用。触发词包括:“生成封面”、“创建缩略图”、“制作横幅”、“设计封面”、“生成封面图”,或任何涉及通过提示词生成指定尺寸图片的请求。
此技能采用两阶段流水线:
- 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 px)可能较慢。对于 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