卡片图生成器-专业版

付费版专享能力

核心能力

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

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

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):

{
  "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)

处理: 解析X风格帖子分享长图(x-like-posts)的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.

2. 自定义模板创建

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

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

输入: 用户提供自定义模板创建所需的指令和必要参数. 处理: 解析自定义模板创建的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.

3. 批量生成

支持从数据文件批量生成卡片图,大幅提升内容生产效率. 输入: 用户提供批量生成所需的指令和必要参数. 处理: 解析批量生成的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.

4. 高级高亮功能

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

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

输入: 用户提供高级高亮功能所需的指令和必要参数. 处理: 解析高级高亮功能的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. 输出: 返回高级高亮功能的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式

• 异常时参考错误处理章节进行恢复
• 关键参数: 高级高亮功能 选项

输入: 用户提供全平台配色预设与品牌定制所需的指令和必要参数. 处理: 解析全平台配色预设与品牌定制的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. 输出: 返回全平台配色预设与品牌定制的处理结果,包含执行状态码、结果数据和执行日志.

6. 水印与版权信息

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

输入: 用户提供水印与版权信息所需的指令和必要参数. 处理: 解析水印与版权信息的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. 输出: 返回水印与版权信息的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式

• 异常时参考错误处理章节进行恢复
• 关键参数: 水印与版权信息 选项

适用场景

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

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

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对话或帖子串制作为分享长图.

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

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

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

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

使用流程

从免费版升级

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

全新安装

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

输入格式

输出格式

{
  "success": true,
  "data": {
    result: "builder 相关配置参数",
    result: "builder 相关配置参数",
    result: "builder 相关配置参数",
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

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

异常处理

依赖说明

运行环境

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

第三方依赖

API Key 配置

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

可用性分类

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

案例展示

示例1: 基础用法

输入:

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

输出:

示例数据

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

输入:

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

输出:

示例数据

常见问题

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版中继续可用.

错误处理