---
slug: "z-card-image-free"
name: "z-card-image-free"
version: "1.0.0"
displayName: "卡片图渲染免费版"
summary: "将短文案渲染为 PNG 海报,支持公众号配色与整行高亮,基础渲染能力。将用户提供的短文案渲染成 PNG 卡片图. 免费版仅支持 poster-3-4 文字海报模板, 内置公众号配色预设与整行"
summary_zh: "将短文案渲染为 PNG 海报,支持公众号配色与整行高亮,基础渲染能力。将用户提供的短文案渲染成 PNG 卡片图. 免费版仅支持 poster-3-4 文字海报模板, 内置公众号配色预设与整行"
license: "MIT"
description: |-
  将用户提供的短文案渲染成 PNG 卡片图.
  免费版仅支持 poster-3-4 文字海报模板,
  内置公众号配色预设与整行高亮能力,
  通过 Python 与 Chrome 完成本地渲染.
  不包含长文分页、X 风格长图、公众号封面与小红书配色.
tags:
  - 需求设计
  - Creative
  - 图像处理
  - AI绘图
  - 创意
  - 补充
  - 用户提供
  - 包含执行
  - 状态码
  - 结果数据
tools:
  - read
  - exec
  - write
homepage: ""
category: "Creative"
---
# z-card-image Free

将用户提供的短文案渲染成 PNG 卡片图.
免费版聚焦于 poster-3-4 文字海报场景,提供基础的渲染能力.
---

## 环境要求

- Python 3
- Google Chrome(macOS 位于 `/Applications/Google Chrome.app`;Linux 需调整脚本中的 chromium 路径)

---

## 渲染管线

### 环境检测

- `python3 --version` 失败则提示未检测到 Python 3,渲染可能失败
- 检查 Chrome 路径,失败则提示安装

### 场景识别

免费版仅处理短文案封面图场景,对应 poster-3-4 模板.
其他场景(长文分页、X 风格长图、公众号封面)不支持,需升级付费版.
### 渲染输出

执行 `render_card.py`,默认 --out 填 tmp/...png,
用户指定导出位置时直接传绝对路径或相对路径.
---

## 模板说明

| 模板名 | 比例 | 尺寸 | 用途 |
|---|---|---|---|
| poster-3-4 | 3:4 | 900x1200 | 文字海报(金句、封面) |

---

## 平台配色

免费版仅支持公众号配色预设:

- --footer:公众号 · 早早集市
- --bg:#e6f5ef
- --highlight:#22a854

---

## 高亮规则

免费版支持整行高亮:

- 用 --hl1、--hl2、--hl3 标记整行高亮
- 按词高亮(--highlight-words)属于付费版能力

---

## 输入校验

- 文案超出模板字数上限:先自动缩写后再渲染,不直接塞入
- 比例不存在:驳回请求,告知当前仅支持 3:4 比例

---

## 案例

### 案例:金句海报渲染

用户提供一句金句,希望生成公众号风格的海报.
识别为 poster-3-4 场景,使用公众号配色,
对核心句使用 --hl1 整行高亮,执行 render_card.py 输出 900x1200 的 PNG.
文案超长时先缩写再渲染.
---

## 异常处理

### Python 3 未安装

`python3 --version` 失败.
提示用户未检测到 Python 3,渲染可能失败,建议安装后检查网络连接和配置后重试.
### Chrome 路径不存在

渲染脚本依赖 Chrome 进行截图.
macOS 确认 `/Applications/Google Chrome.app` 存在,
Linux 调整脚本中的 chromium 路径.
### 文案超出字数上限

直接塞入会导致溢出。先自动缩写,再按缩写后的内容渲染.
### 渲染脚本执行失败

render_card.py 执行报错.
检查 Python 与 Chrome 是否就绪,
确认 --out 路径所在目录存在且有写权限.
### 仅支持 3:4 比例

用户请求其他比例时驳回,告知当前仅支持 3:4,
需要其他比例与模板需升级付费版.
---

## 常见问题

### 免费版支持哪些模板?

仅支持 poster-3-4 文字海报模板(3:4,900x1200).
长文分页、X 风格长图、公众号封面属于付费版能力.
### 支持小红书配色吗?

不支持。免费版仅提供公众号配色预设,小红书配色属于付费版.
### 按词高亮能用吗?

不能。免费版仅支持整行高亮(--hl1、--hl2、--hl3),
按词高亮(--highlight-words)属于付费版.
### 输出路径有什么要求?

默认 --out 填 tmp/...png,用户指定时可直接传绝对或相对路径,
避免写入系统 /tmp/.
---

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:-----|:-----|:-----|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 检查网络连接和配置后重试；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

- 依赖 Python 3 与 Google Chrome
- 仅支持 poster-3-4 文字海报模板
- 仅支持公众号配色,不含小红书配色
- 仅支持整行高亮,不含按词高亮
- 不处理动图与视频,仅输出静态 PNG
- 渲染为本地执行,不提供云端渲染

---

## 升级提示

需要长文分页、X 风格长图、公众号封面?
需要小红书配色与按词高亮?
升级到付费版 z-card-image,获得多模板、多平台配色与双模式高亮的完整渲染能力.
## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux

### 依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---:|---:|---:|---:|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
需要配置对应API Key，详见上文环境配置章节

### 可用性分类
- **分类**: MD+EXEC（）

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 核心能力

### 环境要求(补充)

---

**输入**: 用户提供环境要求相关的配置参数、输入数据和处理选项.
**处理**: 解析环境要求的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回环境要求的处理结果,包含执行状态码、结果数据和执行日志.
### 渲染管线(补充)

**输入**: 用户提供渲染管线所需的指令和必要参数.
**处理**: 解析渲染管线的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回渲染管线的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性
- 参考`渲染管线`的配置文档进行参数调优
### 环境检测(补充)
- `python3 --version` 失败则提示未检测到 Python 3,渲染可能失败
- 检查 Chrome 路径,失败则提示安装

**输入**: 用户提供环境检测所需的指令和必要参数.
**输出**: 返回环境检测的处理结果,包含执行状态码、结果数据和执行日志.
### 场景识别(补充)
免费版仅处理短文案封面图场景,对应 poster-3-4 模板.
其他场景(长文分页、X 风格长图、公众号封面)不支持,需升级付费版.
**输入**: 用户提供场景识别所需的指令和必要参数.
**输出**: 返回场景识别的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性
- 参考`场景识别`的配置文档进行参数调优
### 渲染输出(补充)
执行 `render_card.py`,默认 --out 

**输入**: 用户提供渲染管线相关的配置参数、输入数据和处理选项.
**输出**: 返回渲染输出的处理结果,包含执行状态码、结果数据和执行日志.
### 模板说明(补充)

| 模板名(续)| 比例 | 尺寸 | 用途 |
|:-----:|:-----:|:-----:|:-----:|
| poster-3-4 | 3:4 | 900x1200 | 文字海报(金句、封面) |

---

**输入**: 用户提供模板说明相关的配置参数、输入数据和处理选项.
**处理**: 解析模板说明的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回模板说明的处理结果,包含执行状态码、结果数据和执行日志.
### 平台配色(补充)

---

**输入**: 用户提供平台配色相关的配置参数、输入数据和处理选项.
**处理**: 解析平台配色的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回平台配色的处理结果,包含执行状态码、结果数据和执行日志.
### 高亮规则(补充)

---

**输入**: 用户提供高亮规则相关的配置参数、输入数据和处理选项.
**处理**: 解析高亮规则的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回高亮规则的处理结果,包含执行状态码、结果数据和执行日志.
### 输入校验(补充)

---

**处理**: 解析输入校验的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回输入校验的处理结果,包含执行状态码、结果数据和执行日志.
### 案例(补充)

**输入**: 用户提供案例所需的指令和必要参数.
**处理**: 解析案例的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回案例的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性
- 参考`案例`的配置文档进行参数调优
### 案例:金句海报渲染(补充)

---- 验证返回数据的完整性和格式正确性
- 参考`案例:金句海报渲染`的配置文档进行参数调优

#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 使用流程

1. **环境确认**: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. **指令输入**: 向Agent描述需要执行的任务，引用`z-card-image-free`的相关能力
3. **执行处理**: Agent按照核心能力章节的指令执行任务
4. **结果验证**: 检查输出结果是否符合预期，参考错误处理章节处理异常