用途:为博客或社交平台生成品牌化的特色图(featured image)。核心思路是“HTML 先行,再转 PNG”:先编写一张 1280×720 的 HTML 卡片,用无头 Chromium 渲染为 2× PNG,PNG 是用户最终上传的交付物。HTML 方式可获得完整排版控制与像素级品牌还原度。
使用方式(工作流):
- 定位项目图片目录,默认为仓库根目录下的 infographics/,需确认或检测。
- 检查项目是否已配置:目录中需含 export.mjs、featured-image.json 和 brand-template.html。未配置时按 references/setup.md 一次性配置,之后继续。
- 制作卡片:把 brand-template.html 复制为图片目录下的 <post-slug>-featured.html,然后编辑标题(尽量短,最多两行)、可选的单行副标题、一张能说明文章核心概念的配图,并且只给一个关键短语上品牌强调色。
- 渲染前务必在浏览器中预览:打开该 HTML 让用户看到实时卡片并提修改意见,等用户确认或按意见修改后重新打开,绝不可跳过直接渲染。
- 渲染:在图片目录执行 node export.mjs <post-slug>-featured,输出 2× 的 <post-slug>-featured.png(1280×720 → 2560×1440)。
- 审查与交付:查看 PNG 确认字体加载、版式清晰,修改后重新渲染;把 PNG 路径给用户,若需手动上传可复制到 ~/Desktop。
设计要点:标题约不超过 8 个词、最多两行,因为图片是被扫视而非阅读;只用一种强调色且仅用于一个关键短语;只用一个视觉隐喻(前后对比、单个 UI mock 或图标三件套),避免拥挤;默认 1280×720(16:9),尺寸写在模板 CSS 而非脚本中;留足边距,层级清晰(大标题+小号大写标签)。
限制与备注:渲染依赖 Playwright 的 Chromium,配置时会把浏览器安装在图片目录(node_modules 会被 gitignore,浏览器二进制全局缓存并可跨项目复用)。WordPress 的 MCP/abilities 插件无法上传媒体,特色图与正文内截图需在编辑器中手动添加——应交付 PNG 路径,不要尝试通过 API 推送。品牌配置为每个项目一次性设置,见 references/setup.md。