Communitygithub.com

haoyiyin/mflux-cover

Agent技能 — 基于AI的封面图片生成,带有清晰的排版覆盖层。mflux(FLUX.2 MLX)生成背景;HTML/CSS + Playwright 渲染精美文字。100% 在 Apple Silicon 上本地运行。

mflux-cover 是什么?

这是一个专门为AI Agent设计的封面生成技能,采用两阶段流水线:首先使用 mflux(FLUX.2 4-bit 量化版本,基于 Apple MLX)在本地生成AI背景图像,然后利用 HTML/CSS + Playwright Chromium 在背景上叠加高清文字排版。该技能完全在 Apple Silicon(M1+)上本地运行,无需云端API,首次运行会下载 FLUX.2 模型(约 2-4 GB),之后可离线使用。它支持多种预设尺寸(YouTube 缩略图、Twitter 头图、博客封面、Instagram 帖子、LinkedIn 横幅等),并提供布局和渐变选项。用户只需用英文描述背景,用原语言指定可见标题文字即可生成高质量封面。主要平台为 macOS,推荐 16 GB 以上内存。技能通过 `python3 cover_generator.py` 命令行工具暴露,包含预备环境检测、完整流水线测试和原始背景输出等验证步骤。

兼容平台~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 px)可能较慢。对于 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

相关技能