--- slug: "card-image-builder" name: "card-image-builder" version: 1.0.1 displayName: "卡片图生成器-专业版" summary: "企业级卡片图生成平台,支持全模板/批量生成/自定义模板/品牌定制/X长图。卡片图生成器专业版,面向企业和专业内容团队的全功能卡片图片生成平台。核心能力: - 全模板支持(海报/长文卡片/X风" summary_zh: "企业级卡片图生成平台,支持全模板/批量生成/自定义模板/品牌定制/X长图。卡片图生成器专业版,面向企业和专业内容团队的全功能卡片图片生成平台。核心能力: - 全模板支持(海报/长文卡片/X风" license: "MIT" edition: "pro" description: |- 卡片图生成器专业版,面向企业和专业内容团队的全功能卡片图片生成平台。核心能力: - 全模板支持(海报/长文卡片/X风格长图/公众号封面/自定义模板) - X/Twitter风格帖子分享长图生成 - 批量生成与目录递归处理 - 自定义模板创建与管理 - 全平台配色预设与品牌定制 - 高级高亮(整行+按词+组合高亮) - 水印与版权信息嵌入 - 模板版本管理与团队共享 适用场景: - 企业社交媒体内容矩阵的配图生产 - 内容团队的批量卡片图生成 - X/Twitter帖子分享长图制作 - 品牌统一的... tags: - 沟通协作 - 图片生成 - 卡片图 - 企业级 - 批量生成 - 品牌定制 - 图像处理 - AI绘图 - 创意 - python3 - tmp - json - png - text tools: - read - exec - write homepage: "" category: "Creative" --- # 卡片图生成器-专业版 ## 付费版专享能力 | 能力 | 免费版 | 付费版 | |---|---|---| | 基础功能 | 支持 | 支持 | | 卡片图生成器-专业版企业级卡片图生成 | 不支持 | 支持 | | 卡片图生成器-专业版批量生成 | 不支持 | 支持 | | 高清分辨率与无损输出 | 不支持 | 支持 | | 批量生成与风格预设 | 不支持 | 支持 | | 自定义模型微调 | 不支持 | 支持 | ## 核心能力 ### 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) **处理**: 解析X风格帖子分享长图(x-like-posts)的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. ### 2. 自定义模板创建 PRO版支持创建和管理自定义模板,满足品牌个性化需求. > 详细代码示例已移至 `references/detail.md` **输入**: 用户提供自定义模板创建所需的指令和必要参数. **处理**: 解析自定义模板创建的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. ### 3. 批量生成 支持从数据文件批量生成卡片图,大幅提升内容生产效率. **输入**: 用户提供批量生成所需的指令和必要参数. **处理**: 解析批量生成的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. ### 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 ``` **输入**: 用户提供高级高亮功能所需的指令和必要参数. **处理**: 解析高级高亮功能的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回高级高亮功能的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式 - 异常时参考错误处理章节进行恢复 - 关键参数: `高级高亮功能` 选项 **输入**: 用户提供全平台配色预设与品牌定制所需的指令和必要参数. **处理**: 解析全平台配色预设与品牌定制的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回全平台配色预设与品牌定制的处理结果,包含执行状态码、结果数据和执行日志. ### 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 ``` **输入**: 用户提供水印与版权信息所需的指令和必要参数. **处理**: 解析水印与版权信息的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回水印与版权信息的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式 - 异常时参考错误处理章节进行恢复 - 关键参数: `水印与版权信息` 选项 # ## 快速开始 1. 确认运行环境满足依赖说明中的要求 2. 在AI Agent对话中调用本技能,提供必要的输入参数 3. 检查输出结果,根据需要进行后续处理 > 详细的输入输出格式请参考下方章节说明。 ## 适用场景 ### 场景一:企业社交媒体内容矩阵 企业内容团队使用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 ``` # ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |:-----|:-----|:-----|:-----| | content | string | 否 | card-image-builder处理的内容输入 |, | | content | string | 否 | card-image-builder处理的内容输入 |, 可选值: json/text/markdown | | style | string | 否 | 输出风格, 参考 `references/style.md` | ## 输出格式 ```json { "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(渲染引擎依赖) ### 第三方依赖 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:---:|:---:|:---:|:---:| | 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": "示例数据" } ``` **输出**: ``` 示例数据 ``` ### 示例3: 边界情况 - 边界情况 **输入**: ```json { "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版中继续可用. ## 错误处理 | 错误场景(续)| 原因 | 处理方式 | |:---------|---------:|:---------| | LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 | | 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 | | 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 | | 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |