qwen_agent/skills_developing/z-card-image/references/wechat-cover-split.md
2026-03-17 21:55:10 +08:00

82 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
python3 skills/z-card-image/scripts/render_card.py \
--template wechat-cover-split \
--out tmp/wechat-cover.png \
--line1 "OpenAI 收购 Promptfoo" \
--line2 "意味着什么" \
--highlight "#22a854" \
--bg "#eef7f2" \
--footer "公众号 · 你的名字" \
--icon {agent_dir}/dataset/icon.[png|jpg]
```
## 参数说明
| 参数 | 默认值 | 说明 |
|------|--------|------|
| `--line1` | 空 | 第一行标题 |
| `--line2` | 空 | 第二行标题 |
| `--line3` | 空 | 预留;该模板会自动并入第二行,不单独显示 |
| `--hl1/hl2/hl3` | 关闭 | 整行高亮 |
| `--highlight-words` | 空 | 按词高亮 |
| `--highlight` | `#22a854` | 强调色 |
| `--bg` | `#e6f5ef` | 背景色 |
| `--footer` | `公众号 · 你的名字` | 公众号名称 |
| `--icon` | 默认 logo | 右侧 1:1 区域 icon |
## icon
默认使用:
`{agent_dir}/dataset/icon.[png/jpg]`
显式传 `--icon {agent_dir}/dataset/icon.[png/jpg]`
## 字数限制
这个模板本质上仍是"大字报"风格,文案不能长:
| 位置 | 建议字数 | 说明 |
|------|---------|------|
| 单行 | 12~18 个汉字 | 优先单行呈现 |
| 总行数 | ≤ 2 行 | 超出会明显破坏长条图视觉 |
| 总字数 | ≤ 28 个汉字 | 再长应先缩写或拆标题 |
优先做法:
1. 先抽标题主干
2. 优先单行,必要时拆成 2 行
3. 关键词可用整行或按词高亮
## 使用规则
- 用户明确说"公众号文章封面图"时,优先用本模板
- 用户只是要常规封面 / 金句图,仍使用 `poster-3-4`
- **强规则:公众号文章封面图必须至少有一个高亮词**`--highlight-words` 或 `--hl1/hl2/hl3`),不可省略