@zzclub/pipeline 0.2.0 → 0.4.0

package/src/imgx/poster-recipe.ts

@@ -0,0 +1,81 @@
+export type PosterBlock = {
+  text: string;
+  highlight: boolean;
+};
+
+export type TipItem = {
+  title: string;
+  description: string;
+};
+
+export type PosterConfig = {
+  blocks: PosterBlock[];
+  highlightWords: string[];
+  highlightColor: string;
+  tips: TipItem[];
+};
+
+type PosterInput = {
+  text: string;
+  line1: string;
+  line2: string;
+  line3: string;
+  hl1: boolean;
+  hl2: boolean;
+  hl3: boolean;
+  highlightWords: string;
+  highlightColor: string;
+  tips: TipItem[];
+};
+
+function buildBlocksFromText(text: string, lineHighlights: boolean[]): PosterBlock[] {
+  return text
+    .split(/\r?\n/)
+    .map(part => part.trim())
+    .filter(Boolean)
+    .map((part, index) => ({
+      text: part,
+      highlight: lineHighlights[index] ?? false,
+    }));
+}
+
+export function buildPosterConfig(input: PosterInput): PosterConfig {
+  const lineHighlights = [input.hl1, input.hl2, input.hl3];
+  const blocks =
+    input.text.trim().length > 0
+      ? buildBlocksFromText(input.text, lineHighlights)
+      : [input.line1, input.line2, input.line3]
+          .map((part, index) => ({
+            text: part.trim(),
+            highlight: lineHighlights[index] ?? false,
+          }))
+          .filter(block => block.text.length > 0);
+
+  const fallbackBlocks =
+    blocks.length > 0
+      ? blocks
+      : [
+          {
+            text: "",
+            highlight: false,
+          },
+        ];
+
+  return {
+    blocks: fallbackBlocks,
+    highlightWords: input.highlightWords
+      .split(",")
+      .map(word => word.trim())
+      .filter(Boolean),
+    highlightColor: input.highlightColor,
+    tips: input.tips,
+  };
+}
+
+export function serializePosterConfig(config: PosterConfig): string {
+  return JSON.stringify(config)
+    .replaceAll("<", "\\u003c")
+    .replaceAll(">", "\\u003e")
+    .replaceAll("&", "\\u0026")
+    .replaceAll("</script", "<\\/script");
+}

package/src/imgx/pretext-adapter.ts

@@ -0,0 +1,14 @@
+export {
+  clearCache,
+  layout,
+  layoutNextLine,
+  layoutNextLineRange,
+  layoutWithLines,
+  materializeLineRange,
+  measureLineStats,
+  measureNaturalWidth,
+  prepare,
+  prepareWithSegments,
+  setLocale,
+  walkLineRanges,
+} from "@chenglou/pretext";

package/src/imgx/pretext-runtime.ts

@@ -0,0 +1,61 @@
+import type { Canvas } from "@napi-rs/canvas";
+import { FONTS_DIR } from "./runtime";
+
+let initialized = false;
+
+// Lazy-loaded canvas module — avoids crash at import time when @napi-rs/canvas is missing.
+let canvasMod: { Canvas: typeof Canvas; GlobalFonts: typeof import("@napi-rs/canvas").GlobalFonts; createCanvas: typeof import("@napi-rs/canvas").createCanvas } | null = null;
+
+function getCanvas() {
+  if (!canvasMod) {
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      canvasMod = require("@napi-rs/canvas");
+    } catch {
+      throw new Error(
+        "@napi-rs/canvas not installed. Required for image rendering.\n" +
+        "Install it with:\n" +
+        "  npm install @napi-rs/canvas\n" +
+        "  # or: bun add @napi-rs/canvas",
+      );
+    }
+  }
+  return canvasMod!;
+}
+
+class BunOffscreenCanvas {
+  width: number;
+  height: number;
+  #canvas: Canvas;
+
+  constructor(width: number, height: number) {
+    this.width = width;
+    this.height = height;
+    this.#canvas = getCanvas().createCanvas(width, height);
+  }
+
+  getContext(type: string): ReturnType<Canvas["getContext"]> | null {
+    if (type !== "2d") {
+      return null;
+    }
+    return this.#canvas.getContext("2d");
+  }
+}
+
+function registerLongformFonts(): void {
+  const { GlobalFonts } = getCanvas();
+  GlobalFonts.registerFromPath(`${FONTS_DIR}/AlimamaShuHeiTi-Bold.ttf`, "AlimamaShuHeiTi");
+  GlobalFonts.registerFromPath(`${FONTS_DIR}/LXGWNeoZhiSongPlus.ttf`, "LXGWNeoZhiSongPlus");
+  GlobalFonts.registerFromPath(`${FONTS_DIR}/LXGWWenKai-Regular.ttf`, "LXGWWenKai");
+}
+
+export function ensurePretextRuntime(): void {
+  if (initialized) {
+    return;
+  }
+  if (typeof globalThis.OffscreenCanvas === "undefined") {
+    globalThis.OffscreenCanvas = BunOffscreenCanvas as unknown as typeof OffscreenCanvas;
+  }
+  registerLongformFonts();
+  initialized = true;
+}

package/src/imgx/references/ascii-portrait-3-4.md

@@ -0,0 +1,59 @@
+# ascii-portrait-3-4 模板规范
+
+比例：3:4 | 尺寸：900×1200 | 用途：把任意头像转换成多字符亮度映射海报
+
+## 特点
+
+- 输入一张头像，自动采样颜色与亮度
+- 使用多字符集合重建轮廓，不是单一字符硬拼
+- 保留头像的综合色气质，而不是只做黑白 ASCII
+- 适合实验性头像海报、人物封面、账号视觉页
+
+## 适用场景
+
+- 用户要“字符头像海报”或“ASCII 人像海报”
+- 用户给出一张头像，希望转成更有风格的视觉页
+- 需要把头像做成独立海报，而不是插入长文正文
+
+## 推荐命令
+
+```bash
+bun ./scripts/render-ascii-portrait.ts \
+  --avatar /absolute/path/to/avatar.jpg \
+  --title "Character Portrait" \
+  --out tmp/ascii-portrait.png
+```
+
+需要更细腻的人像时：
+
+```bash
+bun ./scripts/render-ascii-portrait.ts \
+  --avatar /absolute/path/to/avatar.jpg \
+  --title "Character Portrait" \
+  --columns 88 \
+  --chars "@#X$%WM*+=-" \
+  --out tmp/ascii-portrait-detail.png
+```
+
+## 参数说明
+
+- `--avatar`：必填，输入头像
+-- `--title`：海报标题
+- `--out`：必填，输出 PNG 路径
+- `--chars`：字符梯度；`ascii-portrait-3-4` 默认 `@#X$%WM*+=-`，仅使用更厚实的大写字符和符号
+- `--columns`：横向采样列数，越大越细；默认 `auto`，按原图尺寸自动计算，并钳制在 `54–84`
+- `--font-size`：字符字号；默认 `auto`，根据列数自动推导
+- `--line-height`：字符行高；默认 `auto`，根据字号自动推导
+- `--bg`：背景色；默认 `auto`，会基于头像中心区与边缘区的亮度差，自动在深底/浅底之间选择
+
+- `--footer`：底部文字，默认 `公众号 · 早早集市`
+- `--icon`：底部图标路径
+- `--template`：模板名称，支持 `ascii-portrait-3-4`（默认）和 `ascii-portrait-tile`
+- `--width`：画布宽度，默认 `900`
+- `--height`：画布高度，默认 `1200`
+
+## 使用建议
+
+- 对比度强、人物和背景分离明显的头像效果最好
+- 想更抽象：减少 `--columns`
+- 想更还原：增加 `--columns` 并使用更长的 `--chars`

package/src/imgx/references/longform-3-4.md

@@ -0,0 +1,173 @@
+# longform-3-4 模板规范
+
+比例：3:4 | 尺寸：900×1200 | 用途：长文正文卡片，适合非封面页、长段落、阅读型内容
+
+## 特点
+
+- 复用 `poster-3-4` 的顶部 logo 和底部 watermark 结构
+- 正文使用 `LXGWNeoZhiSongPlus.ttf`
+- 行高更舒展，适合阅读，不追求封面式冲击力
+- 支持 markdown 正文
+- 支持正文中的正文插图（内容插图），文字会自动绕排
+- 障碍物流排逻辑来自共享浏览器模块 `assets/browser/obstacle-flow.js`
+- 分页基于真实排版高度，而不是字符数估算
+- 分页测量优先直接在进程内执行 `pretext`，Chrome 只负责最终截图
+- 最终截图阶段会补偿 headless Chrome 的 viewport inset，再裁回目标尺寸，避免 footer 在截图时被底部裁掉
+- 当存在显式 `page_specs` 时，支持 spec-driven 分页：固定页序列、按页图文占比近似求解
+- 样式层可切换主题，便于同模板服务不同账号
+
+## 适用场景
+
+- 用户要“文章分页图”或“阅读内页”
+- 用户给的是长文，而不是一句标题
+- 正文里需要插图、caption、ASCII 头像块这类正文插图
+- 同一模板要服务多个账号，只换主题和图文布局风格
+
+## 调用方式
+
+单页长文：
+
+```bash
+bun ./scripts/render-article.ts \
+  --template longform-3-4 \
+  --theme linen-news \
+  --title "文章标题" \
+  --text "这里是一页长文正文" \
+  --out tmp/longform.png
+```
+
+真实分页，多图导出：
+
+```bash
+bun ./scripts/render-article.ts \
+  --template longform-3-4 \
+  --theme paper-sage \
+  --title "文章标题" \
+  --text-file /absolute/path/to/article.md \
+  --out-dir tmp/longform-pages
+```
+
+图文混排，正文插图绕排：
+
+```bash
+bun ./scripts/render-article.ts \
+  --template longform-3-4 \
+  --theme linen-news \
+  --text-file /absolute/path/to/article.md \
+  --body-image /absolute/path/to/image.jpg \
+  --image-side right \
+  --image-layout editorial-float \
+  --image-caption "配图说明" \
+  --out tmp/longform-mixed.png
+```
+
+把 ASCII 头像块作为正文插图插入正文：
+
+```bash
+bun ./scripts/render-article.ts \
+  --template longform-3-4 \
+  --text-file /absolute/path/to/article.md \
+  --body-ascii-portrait /absolute/path/to/avatar.jpg \
+  --ascii-side left \
+  --ascii-layout mid-left \
+  --ascii-caption "作者头像 ASCII 版" \
+  --out tmp/longform-ascii.png
+```
+
+## 正文插图布局预设（`--image-layout`）
+
+| 预设值 | 别名 | 视觉效果 | 适用场景 |
+|--------|------|----------|----------|
+| `auto` | `default` | 按 `--image-side` 固定边，纵向等距排列 | 1 张插图，简单明确 |
+| `staggered` | `split-dual` | 奇数张靠指定边，偶数张自动翻转对侧，纵向拉开间距 | **多张插图首选**，左右交替有节奏感 |
+| `editorial` | `editorial-float` | 同侧排列但每张有额外竖向错位，版式感强 | 2–3 张，杂志排版风格 |
+| `corner-soft` | — | 靠近顶部角落，纵向紧凑叠放 | 插图作角落装饰，正文为主 |
+| `mid-left` | — | 页面中段靠左，纵向等距 | 明确放左侧中部 |
+| `mid-right` | — | 页面中段靠右，纵向等距 | 明确放右侧中部 |
+
+默认值：未指定时为 `auto`。pipeline 模式下 orchestrator 统一默认使用 `staggered`（适合 2 张及以上）。
+
+## 参数说明
+
+与 `render-article.ts` 的通用参数基本一致，额外约定如下：
+
+- `--template longform-3-4`：启用 LXGW 阅读版模板
+- `--theme`：主题名，默认 `paper-sage`，支持 `paper-sage` / `linen-news`
+- `--title`：当前模板不在正文区显示标题，但参数仍保留给脚本统一接口
+- `--text` / `--text-file`：正文内容，支持有限的块级 markdown 子集
+- `--out`：输出单张图；如果正文超长，会按指定 `--page-num` 或默认第 1 页导出
+- `--out-dir`：输出多张分页图，文件名形如 `article-01.png`
+- `--body-image`：可重复传入，多张正文插图路径
+- `--image-side`：可重复传入，支持 `left` / `right`
+- `--image-layout`：自动布局预设，默认 `auto`，支持 `auto` / `staggered` / `editorial`
+  也支持更偏风格名的别名：`corner-soft` / `mid-left` / `mid-right` / `split-dual` / `editorial-float`
+- `--image-x` / `--image-y` / `--image-width` / `--image-height`：可重复传入，覆盖每张图片的位置和尺寸
+  默认图片尺寸为 210×210
+- `--image-caption`：可重复传入，给对应图片添加 caption
+- `--body-ascii-portrait`：把 ASCII 头像块作为障碍物组合进正文
+- `--ascii-side` / `--ascii-layout` / `--ascii-width` / `--ascii-height` / `--ascii-caption`：控制 ASCII 障碍物的位置与尺寸
+- `--ascii-bg`：ASCII 块背景色
+- `--ascii-chars`：字符梯度，默认 `@#W$9876543210?!abc;:+=-,._ `
+- `--ascii-columns`：ASCII 横向采样列数，默认 `34`
+- `--ascii-x` / `--ascii-y`：覆盖 ASCII 障碍物位置坐标
+- `--page-width` / `--page-height`：覆盖页面尺寸
+- `--body-padding-x` / `--body-padding-y`：覆盖正文外边距
+- `--logo-size` / `--logo-gap`：覆盖 header 几何
+- `--footer-height` / `--footer-margin-top`：覆盖 footer 预留高度
+- `--content-width` / `--content-height`：显式指定正文内容区
+- `--content-bottom-gap`：控制内容区底部保留空间
+- `#` / `##` / `>` / `-`：会解析成小标题、引用、列表项，并进入同一套正文插图流排系统；当前不是完整 markdown 渲染器
+
+## 内容区几何
+
+`longform-3-4` 现在把内容区当成“可推导区域”而不是固定常量：
+
+- 默认内容宽度：`pageWidth - bodyPaddingX * 2`
+- 默认内容高度：`pageHeight - bodyPaddingY * 2 - (logoSize + logoGap) - (footerHeight + footerMarginTop)`
+- 如果调用方显式传了 `--content-width` / `--content-height`，会在可用范围内裁到该值
+
+这意味着同一个模板里，只要 header/footer/padding/page size 改了，分页算法也会跟着重算，不需要再去源码里找写死的内容区尺寸。
+
+## 分页图片消费逻辑
+
+## Spec 驱动分页
+
+当调用方传入 `--page-image-spec-file` 时，`longform-3-4` 不再只按“当前页塞满才翻页”处理，而是进入另一条版式路径：
+
+- 有正文页标记时：
+  `【第一页】` / `【第二页】` / `【Page 1】` / `【Page 2】` 会成为硬分页锚点
+- 没有正文页标记时：
+  会按段落 block 顺序，把正文自动分配到显式页序列里
+- 每页图片会做一轮页内缩放搜索，尽量让“文字 + 图片”占到内容区约 `target_fill_ratio`
+- 顶层 `target_fill_ratio` 默认 `0.8`
+- `page_specs[].target_fill_ratio` 可以覆盖单页目标
+
+这条路径适合：
+
+- 已经知道要分几页
+- 每页已经知道有哪些插图
+- 希望某些文字固定在指定页里，即使该页文字不算很多
+
+**分页图片消费逻辑（`--body-image` 在多页中的分配）：**
+
+当正文超过一页时，`render-article.ts` 通过 `obstacle-flow.js` 的 `paginateBlocks()` 将正文和图片分配到各页：
+
+- **消费方式**: 顺序切片（sequential slice），不是全局障碍物
+- **每页上限**: `pageImageLimit = 2`（当前硬编码）
+- **分配规则**: `bodyImages.slice(imageIndex, imageIndex + pageImageLimit)` — 第 1 页取前 2 张，第 2 页取接下来 2 张，依此类推
+- **图片顺序**: 与 `--body-image` 参数的传入顺序一致
+- **超出页数**: 若图片数 > 页数 × 2，多余图片不渲染（不报错）
+- **不足**: 若某页分配不到图片，该页无插图，只渲染文字
+
+> 这意味着传入 4 张 `--body-image`，前 2 张出现在第 1 页，后 2 张出现在第 2 页。
+> 若只有 1 页但传了 3 张图，只有前 2 张会渲染。
+
+## 注意事项
+
+- 正文中若含 `插图N` / `配图N` 占位标记，调用本脚本前必须先由 orchestrator 剔除，否则标记文字会直接渲染进卡片
+- 适合正文、随笔、文章分页内页、说明卡
+- 不适合大标题封面
+- 若是封面或强视觉标题，优先使用 `poster-3-4`
+- 需要图文混排时，优先使用 `--body-image` 配合 `--image-side left/right`
+- 多账号复用时，优先固定 `--theme` + `--image-layout` 的组合，而不是每次手调坐标
+- 真正的长文发布优先使用 `--out-dir`，让模板自动产出多张连续图片

package/src/imgx/references/poster-3-4.md

@@ -0,0 +1,87 @@
+# poster-3-4 模板规范
+
+比例：3:4 | 尺寸：900×1200 | 用途：小绿书 / 公众号 / 小红书通用封面
+
+ 
+## 渲染命令
+
+```bash
+bun ./scripts/render-card.ts \
+  --template poster-3-4 \
+  --out tmp/card.png \
+  --text "OpenClaw 有两层 model 配置" \
+  --highlight "#22a854" \
+  --highlight-words "OpenClaw,model" \
+  --bg "#e6f5ef" \
+  --footer "公众号 · 早早集市"
+```
+
+如果用户已经明确拆成三行，也可以直接按行控制：
+
+```bash
+bun ./scripts/render-card.ts \
+  --template poster-3-4 \
+  --line1 "OpenClaw 有两层" \
+  --line2 "model 配置" \
+  --hl2 \
+  --out tmp/card-lines.png
+```
+
+## 参数说明
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `--text` | 空 | 推荐入口。整段文案，自适应字号和自动断行 |
+| `--line1` | 空 | 第一行文字 |
+| `--line2` | 空 | 第二行文字（空则隐藏）|
+| `--line3` | 空 | 第三行文字（空则隐藏）|
+| `--hl1` | 关闭 | 整行高亮：第一行 |
+| `--hl2` | 关闭 | 整行高亮：第二行 |
+| `--hl3` | 关闭 | 整行高亮：第三行 |
+| `--highlight-words` | 空 | 按子串高亮，逗号分隔（子串匹配，非单词边界），如 `OpenClaw,GPT-5.4`（跨行生效）|
+| `--highlight` | `#22a854` | 高亮/强调色 |
+| `--bg` | `#e6f5ef` | 背景色 |
+| `--footer` | `公众号 · 早早集市` | 底部文字 |
+| `--icon` | 自动判断 | 顶部图标路径，不传则按内容自动选 |
+| `--template` | `poster-3-4` | 模板名称 |
+| `--out` | — | 必填，输出 PNG 路径 |
+| `--fallback-icon` | — | 备用图标路径，`--icon` 判空时使用 |
+
+## 高亮文字处理规则
+
+**两种高亮方式，按需选择：**
+
+当使用 `--text` 时，优先使用 `--highlight-words`。当使用 `--line1/2/3` 时，`--hl1/2/3` 仍然有效。
+
+### 1. 整行高亮（`--hl1` / `--hl2` / `--hl3`）
+整行文字渲染为高亮色。适合"某一行是关键句"的场景。
+
+> 示例：第二行要高亮
+> → `--line1 "GPT-5.4 发布了" --line2 "能控电脑" --hl2`
+
+### 2. 按词高亮（`--highlight-words`）
+在任意行中，将指定词语渲染为高亮色，其余文字保持黑色。适合"某几个关键词"的场景。
+
+> 示例：高亮 OpenClaw 和 GPT-5.4
+> → `--line1 "GPT-5.4 最适合" --line2 "OpenClaw 使用" --highlight-words "GPT-5.4,OpenClaw"`
+
+**优先级规则（有歧义时）：**
+- 用户说「高亮第X行」→ 用 `--hlX`
+- 用户说「高亮某个词/某几个词」→ 用 `--highlight-words`
+- 两者可以同时使用
+
+
+
+| 位置 | 最多字数 | 说明 |
+|------|---------|------|
+| 每行（line1/2/3） | **6~7 个汉字** / **10~12 个英文字符** | 字号 108px，可用宽 720px |
+| 三行合计 | **≤ 20 字** | 超出则横向溢出，无法使用 |
+
+> 用户文案超出时，先帮忙拆分/缩写到上限内，再渲染，不要直接塞入模板。
+
+## 配图选取原则
+
+| 条件 | 使用图标 | 文件 |
+|------|---------|------|
+| 默认 | 通用 logo | `assets/icons/logo.svg` |
+| 自定义 | 通过 `--icon` 参数指定 | 任意路径 |

package/src/imgx/references/tips-3-4.md

@@ -0,0 +1,69 @@
+# tips-3-4 模板规范
+
+比例：`3:4` | 尺寸：900×1200 | 用途：小红书风格结构化要点卡
+
+## 适用场景
+
+- 用户说"N 个方法 / 技巧 / 步骤 / 要点"
+- 用户说"小红书要点卡 / 干货清单"
+- 内容为 3–5 条有标题（可选副标明）的并列技巧
+
+## 渲染命令
+
+```bash
+bun ./scripts/render-card.ts \
+  --template tips-3-4 \
+  --text "写作变现的\n5 个核心技巧" \
+  --tip "选题精准::锁定高搜索量、低竞争度的细分话题" \
+  --tip "钩子开头::前 50 字决定是否被划走" \
+  --tip "结构清晰::小标题 + 短段落，移动端必须" \
+  --tip "引导互动::结尾提问或给出可执行行动" \
+  --tip "持续复盘::每月看数据，找爆文规律" \
+  --highlight "#22a854" \
+  --bg "#e6f5ef" \
+  --footer "公众号 · 早早集市" \
+  --out tmp/tips-card.png
+```
+
+如果 tip 只有标题，不带副标明，省略 `::` 后半部分：
+
+```bash
+  --tip "选题精准" \
+  --tip "钩子开头" \
+```
+
+## 参数说明
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `--template` | `tips-3-4` | 模板名称 |
+| `--out` | — | 必填，输出 PNG 路径 |
+| `--text` | 空 | **必填**。标题文案，支持 `\n` 手动换行，pretext 自适应字号 |
+| `--tip` | — | 可重复传入，每条格式 `标题::描述`，描述可省略 |
+| `--hl1/hl2/hl3` | 关闭 | 整行高亮（作用于 `--text` 对应行） |
+| `--highlight` | `#22a854` | 强调色，用于序号圆圈、badge 边框、高亮文字 |
+| `--bg` | `#e6f5ef` | 背景色 |
+| `--footer` | `公众号 · 早早集市` | 底部水印文字 |
+| `--icon` | 默认 logo | 左上角圆形 icon |
+
+## 内容建议
+
+| 位置 | 建议 |
+|------|------|
+| 标题 (`--text`) | 10–20 字，含数字最佳，如"5 个核心技巧" |
+| tips 条数 | 3–5 条；超过 5 条会压缩间距，视觉密度过高 |
+| 每条标题 | 4–10 字 |
+| 每条描述 | 10–25 字，超长会换行，撑高 tip 区域 |
+
+标题由 pretext 引擎根据可用空间自动选择最大可用字号，tip 区域高度固定，两者之间通过两步测量动态分配空间。
+
+## 默认 icon
+
+默认使用 `assets/icons/logo.svg`。可通过 `--icon` 参数覆盖。
+
+## 使用规则
+
+- 内容是「N 个 XX」列表型干货 → 用本模板
+- 内容是金句 / 单标题封面 → 用 `poster-3-4`
+- 内容是公众号文章封面图 → 用 `wechat-cover-split`
+- **强规则：tips 条数不足 3 条时，改用 `poster-3-4` 做多行标题更合适**

package/src/imgx/references/wechat-cover-split.md

@@ -0,0 +1,89 @@
+# wechat-cover-split 模板规范
+
+比例：`335:100`（左 `2.35:1` + 右 `1:1`） | 尺寸：1340×400 | 用途：公众号文章封面图
+
+> 该模板渲染时会额外调用 `ffmpeg` 做顶部精确裁切，以适配 Chrome 在短横幅截图下的视口偏差。
+
+## 适用场景
+
+- 用户说"公众号文章封面图"
+- 用户说"微信公众号头图 / 封面长图"
+- 需要一张图同时切出左侧横图和右侧方图
+
+## 切图规则
+
+整张图由两部分组成：
+
+- 左侧：`940×400`，比例 `2.35:1`，放标题文案
+- 右侧：`400×400`，比例 `1:1`，放 icon
+
+如果业务端需要拆图使用：
+
+- 左图：取左侧 `940×400`
+- 右图：取右侧 `400×400`
+
+## 渲染命令
+
+```bash
+bun ./scripts/render-card.ts \
+  --template wechat-cover-split \
+  --out tmp/wechat-cover.png \
+  --line1 "OpenAI 收购 Promptfoo" \
+  --line2 "意味着什么" \
+  --highlight "#22a854" \
+  --bg "#eef7f2" \
+  --footer "公众号 · 早早集市"
+```
+
+如果标题更长，优先继续走同一模板，而不是换模板：
+
+```bash
+bun ./scripts/render-card.ts \
+  --template wechat-cover-split \
+  --text "这是一篇公众号文章的长标题，需要自动切分并保留高亮重点" \
+  --highlight-words "高亮重点" \
+  --out tmp/wechat-cover-long.png
+```
+
+## 参数说明
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `--template` | `wechat-cover-split` | 模板名称 |
+| `--out` | — | 必填，输出 PNG 路径 |
+| `--text` | 空 | **推荐入口**。整段标题文案，自动切分为两行并自适应字号 |
+| `--line1` | 空 | 第一行标题（已有拆分结果时使用） |
+| `--line2` | 空 | 第二行标题（已有拆分结果时使用） |
+| `--line3` | 空 | 预留；自动并入第二行，不单独显示 |
+| `--hl1/hl2/hl3` | 关闭 | 整行高亮 |
+| `--highlight-words` | 空 | 按词高亮，逗号分隔，跨行生效 |
+| `--highlight` | `#22a854` | 强调色 |
+| `--bg` | `#e6f5ef` | 背景色 |
+| `--footer` | `公众号 · 早早集市` | 底部文字 |
+| `--icon` | 默认 logo | 右侧 1:1 区域 icon |
+
+## 默认 icon
+
+默认使用 `assets/icons/logo.svg`。如果用户指定其他品牌图标，再显式传 `--icon` 覆盖。
+
+## 字数建议
+
+模板使用 pretext 自适应字号，超长文案会自动缩小字体兜底，不会溢出。但视觉质量随字数增加而下降，建议控制在合理范围：
+
+| 位置 | 建议字数 | 说明 |
+|------|---------|------|
+| 单行 | 12~18 个汉字 | 优先单行呈现，视觉冲击力最强 |
+| 总行数 | ≤ 2 行 | 超出两行字号会明显缩小，横幅视觉受损 |
+| 总字数 | ≤ 28 个汉字 | 超出建议先缩写或拆标题，而不是硬塞 |
+
+优先做法：
+
+1. 先抽标题主干
+2. 优先单行，必要时拆成 2 行
+3. 关键词可用整行或按词高亮
+
+## 使用规则
+
+- 用户明确说"公众号文章封面图"时，优先用本模板
+- 用户只是要常规封面 / 金句图，仍使用 `poster-3-4`
+- **强规则：公众号文章封面图必须至少有一个高亮词**（`--highlight-words` 或 `--hl1/hl2/hl3`），不可省略