z-card-image

# z-card-image

将用户提供的文案渲染成单张 PNG 卡片图，通过 message 工具发图。
长文多图请使用 `z-article-card` skill。

## 环境要求

- Python 3
- Google Chrome（macOS：`/Applications/Google Chrome.app`；Linux：`chromium` 需修改脚本路径）

## 执行流程

0. **环境提示**（用户触发时检测一次，有问题给提示，不中止流程）：
   - `python3 --version` → 失败则告知：「⚠️ 未检测到 Python 3，渲染可能失败」
   - 检查 Chrome 路径 → 失败则提示安装

1. **识别比例**：从用户描述中提取目标比例（如 3:4、16:9）
2. **查模板规则**：根据比例在「模板索引」中找到对应规范文档，读取后按其规则处理文案和参数。**如用户要求高亮：整行用 `--hl1/hl2/hl3`，按词用 `--highlight-words`（逗号分隔），两者可同时使用，不能忽略**
3. **识别平台**：按「平台预设」自动设置配色
4. **渲染输出**：执行 `render_card.py`，`--out` 填 `tmp/card.png`（相对于当前 workspace 根目录，先确保 tmp/ 目录存在）
5. **发图**：用 message 工具，`filePath` 指向输出 PNG，不能用 `/tmp/`（飞书无法上传）

## 输入校验

- **比例不存在**：驳回请求，告知当前支持的比例列表，询问是否新增模板
- **文案超出模板字数上限**：先自动拆分/缩写后再渲染，不要直接塞入

## 平台预设

| 平台 | `--footer` | `--bg` | `--highlight` |
|------|-----------|--------|--------------|
| 公众号（默认） | `公众号 · 早早集市` | `#e6f5ef` | `#22a854` |
| 小红书 | `小红书 · 阿康` | `#fdecea` | `#e53935` |

> 用户提到"小红书配图"时使用小红书预设；"小绿书"= 公众号配图，使用公众号预设；否则默认公众号。

## 模板索引

| 模板名 | 比例 | 尺寸 | 用途 | 规范文档 |
|--------|------|------|------|---------|
| `poster-3-4` | 3:4 | 900×1200 | 文字海报（金句/大字报/封面） | [references/poster-3-4.md](references/poster-3-4.md) |

## 新增模板

1. 新建 `assets/templates/<name>.html`
2. 在 `render_card.py` 的 `size_map` 里注册尺寸
3. 在上方模板索引中添加一行
4. 创建对应 `references/<name>.md`，记录该模板的参数、字数上限、配图选取规则

# z-card-image

文字卡片图片生成器，把文案渲染成 PNG，支持公众号、小红书等多种配色风格。

## 效果

- 输入一段文字，自动排版成精美卡片图
- 支持多行文字 + 高亮、品牌 footer、顶部图标
- 默认模板：3:4 竖版（900×1200）

## 依赖

- Python 3
- Google Chrome（macOS：`/Applications/Google Chrome.app`）

## 自定义品牌信息

默认配色和 footer 是「早早集市」的风格，改成你自己的只需修改 `SKILL.md` 里的**平台预设**表格：

```markdown
## 平台预设

| 平台 | `--footer` | `--bg` | `--highlight` |
|------|-----------|--------|--------------|
| 公众号（默认） | `公众号 · 你的名字` | `#e6f5ef` | `#22a854` |
| 小红书 | `小红书 · 你的名字` | `#fdecea` | `#e53935` |
```

`render_card.py` 支持的所有参数：

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--footer` | 底部署名文字 | `公众号 · 早早集市` |
| `--bg` | 背景色（hex） | `#e6f5ef` |
| `--highlight` | 高亮色（hex） | `#22a854` |
| `--icon` | 顶部图标路径 | 自动判断 |
| `--template` | 模板名 | `xiaolvs-cover` |

把 `--footer` 改成你的公众号名，`--bg` / `--highlight` 改成你的品牌色，就是你的专属风格了。

## 替换 Logo

顶部图标在 `assets/icons/` 目录，替换对应 SVG/JPG 文件即可，文件名保持一致。

## 新增模板

1. 新建 `assets/templates/<name>.html`
2. 在 `scripts/render_card.py` 的 `size_map` 里注册尺寸
3. 在 `SKILL.md` 模板索引中添加一行
4. 创建 `references/<name>.md` 记录参数和字数上限