CoverPress

面向 AI Agent 的封面图生成 CLI，可将本地 HTML 按预设尺寸输出为高质量 PNG 图片。

特性

• 仅预设模式生成封面（不支持自定义尺寸）
• 仅支持本地 HTML（不支持远程 URL）
• 内置 8 种平台封面预设
• 基于 Playwright + Chromium 的稳定渲染
• 使用 #container 作为截图区域，输出更可控

安装

npm install -g @liustack/coverpress
npx playwright install chromium

或使用 npx：

npx @liustack/coverpress [options]

也可以作为 Agent Skill 安装 — 在任何支持 Agent Skill 的 AI 编程工具（Claude Code、Codex、OpenCode、Cursor、Antigravity 等）中输入：

帮我安装这个 skill：https://github.com/liustack/coverpress

或使用 skills CLI 直接安装：

npx skills add https://github.com/liustack/coverpress --skill coverpress

用法

# 生成 OG 卡片
coverpress -i card.html -o og.png --preset og

# 生成信息图
coverpress -i stats.html -o infographic.png --preset infographic

预设尺寸

| 预设 | 尺寸 | 示例 | |------|------|------| | og | 1200x630 | | | twitter | 1200x675 | | | banner | 1600x900 | | | youtube | 1280x720 | | | wechat | 900x383 | | | infographic | 1080x1350 | | | poster | 1200x1500 | | | xiaohongshu | 1080x1440 | |

更多样例

电影主题

时尚主题

其他风格

参数

• -i, --input <path> 输入 HTML 路径
• -o, --output <path> 输出 PNG 路径
• -p, --preset <name> 预设名称（必填）
• --scale <number> 设备缩放（默认 2）
• --wait-until <state> load | domcontentloaded | networkidle
• --timeout <ms> 超时时间（毫秒）
• --safe 禁用外部网络请求和 JavaScript 执行

PNG 渲染要求 HTML 中存在 #container 元素，否则会失败。

AI Agent Skill

• coverpress/SKILL.md

License

MIT