Card Image Builder

企业级卡片图生成平台，支持全模板批量生成、自定义模板管理、品牌定制、X/Twitter长图分享及水印版权嵌入。

卡片图生成器-专业版

核心能力

1. X风格帖子分享长图(x-like-posts)

PRO版独有功能,将帖子类型数据渲染为X/Twitter风格的分享长图。

bash

python3 render_x_like_posts.py \
  --input posts.json \
  --out tmp/x_posts.png

python3 render_x_like_posts.py \
  --input posts.json \
  --platform twitter \
  --out tmp/x_posts_twitter.png

输入数据格式(posts.json):

json

{
  "posts": [
    {
      "author": {"name": "张三", "handle": "@zhangsan", "avatar": "https://example.com/avatar1.jpg"},
      "text": "今天分享一个关于AI的最新思考:未来的竞争不是技术竞争,而是认知竞争。",
      "createdAt": "2026-07-18T10:30:00+08:00",
      "metrics": {"replies": 15, "retweets": 42, "likes": 128}
    },
    {
      "author": {"name": "李四", "handle": "@lisi", "avatar": "https://example.com/avatar2.jpg"},
      "text": "完全同意。认知决定了我们能看到什么机会,而技术只是实现手段。",
      "createdAt": "2026-07-18T10:35:00+08:00",
      "metrics": {"replies": 3, "retweets": 8, "likes": 35}
    }
  ]
}

帖子长图特性:

• 自适应长度(根据帖子数量自动调整图片高度)
• 固定宽度900px
• 支持头像、用户名、时间戳显示
• 支持互动数据(回复/转发/点赞)
• Twitter风格蓝白灰配色(默认)
• 帖子过多时自动分页(Part 1 / Part 2)

处理: 按照skill规范执行X风格帖子分享长图(x-like-posts)操作,遵循单一意图原则。

2. 自定义模板创建

PRO版支持创建和管理自定义模板,满足品牌个性化需求。

详细代码示例已移至 references/detail.md

输入: 用户提供自定义模板创建所需的指令和必要参数。 处理: 按照skill规范执行自定义模板创建操作,遵循单一意图原则。

3. 批量生成

支持从数据文件批量生成卡片图,大幅提升内容生产效率。

详细代码示例已移至 references/detail.md

输入: 用户提供批量生成所需的指令和必要参数。 处理: 按照skill规范执行批量生成操作,遵循单一意图原则。

4. 高级高亮功能

PRO版支持整行高亮、按词高亮和组合高亮三种模式。

bash

python3 render_card.py \
  --template poster-3-4 \
  --text "优秀行内容\n第二行内容\n第三行内容" \
  --hl1 "优秀行内容" \
  --hl2 "第三行内容" \
  --out tmp/highlight_lines.png

python3 render_card.py \
  --template poster-3-4 \
  --text "AI正在改变世界,从医疗到教育,从交通到娱乐" \
  --highlight-words "AI,医疗,教育,交通,娱乐" \
  --out tmp/highlight_words.png

python3 render_card.py \
  --template poster-3-4 \
  --text "重要通知:本周五举行产品发布会\n主题:AI驱动的未来\n地点:线上直播" \
  --hl1 "重要通知:本周五举行产品发布会" \
  --highlight-words "AI,未来,线上直播" \
  --out tmp/highlight_combined.png

输入: 用户提供高级高亮功能所需的指令和必要参数。 处理: 按照skill规范执行高级高亮功能操作,遵循单一意图原则。 输出: 返回高级高亮功能的执行结果,包含操作状态和输出数据。

• 执行高级高亮功能操作,处理输入数据并返回结果
• 验证执行结果,确认输出符合预期格式
• 异常时参考错误处理章节进行恢复
• 关键参数: 高级高亮功能 选项

5. 全平台配色预设与品牌定制

详细代码示例已移至 references/detail.md

输入: 用户提供全平台配色预设与品牌定制所需的指令和必要参数。 处理: 按照skill规范执行全平台配色预设与品牌定制操作,遵循单一意图原则。 输出: 返回全平台配色预设与品牌定制的执行结果,包含操作状态和输出数据。

6. 水印与版权信息

bash

python3 render_card.py \
  --template poster-3-4 \
  --text "优质内容值得分享" \
  --watermark "© 2026 优品科技" \
  --watermark-position "bottom-right" \
  --watermark-opacity 0.3 \
  --out tmp/with_watermark.png

python3 render_card.py \
  --template poster-3-4 \
  --text "原创文章,转载请注明出处" \
  --footer "© 2026 优品科技 | All Rights Reserved" \
  --out tmp/with_copyright.png

输入: 用户提供水印与版权信息所需的指令和必要参数。 处理: 按照skill规范执行水印与版权信息操作,遵循单一意图原则。 输出: 返回水印与版权信息的执行结果,包含操作状态和输出数据。

• 执行水印与版权信息操作,处理输入数据并返回结果
• 验证执行结果,确认输出符合预期格式
• 异常时参考错误处理章节进行恢复
• 关键参数: 水印与版权信息 选项

能力覆盖范围

本skill还覆盖以下能力场景: 企业级卡片图生成、支持全模板、卡片图生成器专业、面向企业和专业内、容团队的全功能卡、片图片生成平台、核心能力、全模板支持、长文卡片、风格长图、公众号封面、批量生成与目录递、归处理、自定义模板创建与、水印与版权信息嵌、模板版本管理与团、队共享。这些能力在上述核心功能中均有对应处理逻辑。

适用场景

场景一:企业社交媒体内容矩阵

企业内容团队使用PRO版批量生成多个平台的配图,统一品牌视觉风格。

python

brand = BrandPresetManager("优品科技")
content = "2026年AI技术趋势报告:大模型、多模态、Agent三大方向"
for platform in ["公众号", "小红书", "微博", "知乎"]:
    preset = brand.get_preset(platform)
    subprocess.run(["python3", "render_card.py", "--template", "poster-3-4",
        "--text", content, "--footer", preset["footer"],
        "--bg", preset["bg"], "--highlight", preset["highlight"],
        "--out", f"tmp/matrix/{platform}.png"])
    print(f"[{platform}] 已生成")

场景二:X/Twitter帖子长图分享

将有趣的Twitter对话或帖子串制作为分享长图。

bash

python3 render_x_like_posts.py \
  --input twitter_thread.json \
  --platform twitter \
  --out tmp/twitter_thread.png

场景三:批量金句海报生成

从文案库批量生成金句海报,用于日常社交媒体运营。

bash

python3 batch_generate.py \
  --template poster-3-4 \
  --input quotes_library.json \
  --output-dir tmp/quotes_batch/ \
  --platform 公众号

使用流程

从免费版升级

bash

skill-platform skills install card-image-builder-pro
skill-platform gateway restart

全新安装

bash

python3 --version
ls "/Applications/Google Chrome.app"  # macOS
skill-platform skills install card-image-builder-pro

python3 init_brand.py --name "你的品牌名"

python3 render_x_like_posts.py --input sample.json --out tmp/test.png

命令参数说明

1. -right: 命令参数,用于指定操作选项
2. --watermark: 命令参数,用于指定操作选项
3. --footer: 命令参数,用于指定操作选项
4. --watermark-opacity: 命令参数,用于指定操作选项
5. --bg: 命令参数,用于指定操作选项

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,参考错误处理章节获取恢复步骤。

命令参数说明

• --highlight-words: 命令参数,用于指定操作选项
• -image-builder-pro: 命令参数,用于指定操作选项
• --hl1: 命令参数,用于指定操作选项
• -platform: 命令参数,用于指定操作选项
• --platform: 命令参数,用于指定操作选项

命令参数说明

• --hl2: 命令参数,用于指定操作选项
• --input: 命令参数,用于指定操作选项
• --output-dir: 命令参数,用于指定操作选项
• --watermark-position: 命令参数,用于指定操作选项

输入格式

参数名	类型	必填	说明
content	string	是	相关说明
content	string	否	相关说明, 默认: 默认值
content	string	否	相关说明, 可选值: json/text/markdown
style	string	否	输出风格, 参考 references/style.md

输出格式

json

{
  "success": true,
  "data": {
    result: "相关说明",
    result: "相关说明",
    result: "相关说明",
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

异常处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Python: 3.8+
• 浏览器: Google Chrome(渲染引擎依赖)

第三方依赖

依赖项	类型	是否必需	获取方式
Python 3.8+	运行时	必需	python.org 下载
Google Chrome	浏览器	必需	google.com/chrome 下载
LLM API	API	必需	由Agent内置LLM提供
Pillow	Python库	推荐	pip install Pillow
Jinja2	Python库	可选	pip install jinja2(模板渲染)

API Key 配置

• 本Skill为本地渲染工具,无需额外API Key
• 所有图片渲染在本地通过Chrome完成
• 不依赖外部图片生成服务
• 自定义模板的HTML/CSS在本地解析渲染

可用性分类

• 分类: MD+EXEC()
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行卡片图渲染和批量生成任务
• 运行模式: 本地渲染,依赖Python和Chrome;支持批量处理和自定义模板
• 安全等级: 本地处理,不涉及网络请求;水印支持版权保护;模板版本可追溯
• 兼容性: 与免费版(card-image-builder-free)完全兼容,支持无缝升级

案例展示

示例1: 基础用法

输入:

json

{
  "content": "示例数据",
  "content": "示例数据",
  "style": "示例数据"
}

输出:

text

示例数据

示例2: 进阶用法

输入:

json

{
  "content": "示例数据",
  "content": "示例数据",
  "style": "示例数据"
}

输出:

text

示例数据

示例3: 边界情况 - 边界情况

输入:

json

{
  "content": "示例数据"
}

输出:

text

示例数据

常见问题

Q1: PRO版可以创建多少个自定义模板?

A: 没有数量限制。每个模板包含HTML文件和JSON配置文件,存储在 assets/templates/ 目录下。

Q2: X风格长图支持多少条帖子?

A: 单张建议3-10条。超过10条自动分页(Part 1 / Part 2),宽度固定900px,高度自适应。

Q3: 批量生成时如何处理失败?

A: 批量生成器记录每张图状态,失败项可在统计中查看并重试。常见原因:文案过长、Chrome未就绪、路径不可写。

Q4: 自定义模板需要什么技术能力?

A: 需要基本HTML+CSS知识。模板用HTML编写,通过JSON配置参数,渲染器自动注入。

Q5: 水印支持哪些样式?

A: 支持文字水印,可配置位置、透明度和字体大小。暂不支持图片水印。

Q6: 如何与免费版用户协作?

A: PRO版与免费版完全兼容。免费版用户可使用PRO版创建的自定义模板(需共享文件),免费版三个基础模板在PRO版中继续可用。

错误处理

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

已知限制