@rongyan/cover-generator

基于内置 cover_bg.png 和「阿里妈妈东方大楷」字体生成标题封面图。实现使用 sharp 合成 PNG，不依赖浏览器、Playwright、Puppeteer 或截图流程。标题使用纯色填充，不添加阴影、描边等文字效果。

安装

npm install @rongyan/cover-generator

CLI

npx @rongyan/cover-generator "把复杂问题讲清楚" --output-dir ./covers

CLI 会在 stdout 输出 JSON：

{
  "ok": true,
  "title": "把复杂问题讲清楚",
  "outputPath": "/absolute/path/covers/cover-20260506150000-xxxx.png",
  "width": 1923,
  "height": 817,
  "format": "png",
  "size": 123456,
  "lines": ["把复杂问题讲清楚"],
  "fontFamily": "阿里妈妈东方大楷",
  "backgroundPath": "/absolute/path/assets/cover_bg.png"
}

常用参数：

cover-generator "标题" -o ./covers
cover-generator --title "标题" --output ./covers/custom.png
cover-generator "标题" --max-lines 1 --font-size 120

程序调用

const { generateCover } = require('@rongyan/cover-generator');

const result = await generateCover('把复杂问题讲清楚', {
  outputDir: './covers'
});

console.log(result);

也可以传对象：

const result = await generateCover({
  title: '把复杂问题讲清楚',
  outputDir: './covers',
  maxLines: 2
});

API

generateCover(title, options)

generateCover(options)

主要 options：

• outputDir: 输出目录，默认当前目录
• outputPath: 指定完整输出 PNG 路径，优先级高于 outputDir
• fileName: 指定输出文件名
• backgroundPath: 自定义背景 PNG
• fontPath: 自定义 TTF/OTF 字体
• color: 标题颜色
• maxLines: 1 或 2，默认 2
• fontSize: 最大字号
• minFontSize: 最小字号
• y: 标题垂直中心位置，单位 px

标题会自动居中，并根据宽度选择一行或两行排版。