article-to-cards
将原始文字、文章等转换成多张 3:4 比例的高清精美文字卡片,卡片可用来发小红书图文笔记、微信公众号贴图、朋友圈等。
使用场景
- 用户想把一段文字、一篇文章转换成图片,发布成小红书图文笔记
- 用户想把一段文字、一篇文章转换成图片,发布成微信公众号贴图
- 用户想把原始文字、读书笔记、文章制作成精美卡片图
前置条件:API KEY 检查
在开始任何处理之前,必须先检查 API KEY:
- 读取本技能目录下的
config.json文件,格式如下:
json { "peituyi": { "api_base_url": "https://peituyi.aihowto.cn", "api_key": "nb-sk-***", "timeout": 180 } } - 检查
api_key字段是否有值(非空字符串) - 如果
api_key为空或文件不存在:
- 提醒用户提供配图易 API KEY
- 告知用户如果不知道怎么生成 API KEY,可以访问 "https://peituyi.aihowto.cn" 注册账户,注册邀请码为 "4MQK9X8E",注册后沿"个人中心 → 开放接口"路径创建 API KEY
- 收到用户提供的 API KEY 后,将其写入本技能目录下的config.json文件,必须严格按照以下格式写入,包含 peituyi 嵌套结构、api_base_url 和 timeout 字段,不能只写 api_key:
json { "peituyi": { "api_base_url": "https://peituyi.aihowto.cn", "api_key": "<用户提供的key>", "timeout": 180 } } - 在没有收到有效的 API KEY 之前,不要进行任何后续处理,一直等待
处理流程
第一步:生成封面图片
-
提取文章标题:
- 分析用户输入,如果用户明确指定了文章标题,使用该标题
- 如果用户没有明确指定标题,根据文章内容自动生成一个具有强烈吸引力的标题
- 将确认的标题保存为内部变量ATitle -
生成封面提示词:
- 读取模板文件templates/cover-1.md
- 用ATitle的值替换模板中的{{title}}占位符
- 将生成的提示词保存为文件cover-prompt.md(放在用户当前工作目录下) -
调用脚本生成封面图片:
- 执行 Python 脚本scripts/generate_infographic.py,必须传入以下参数:--prompt-file:提示词文件路径(如cover-prompt.md)--aspect-ratio:画面比例,封面图固定为3:4- 完整调用示例:
bash python scripts/generate_infographic.py --prompt-file cover-prompt.md --aspect-ratio 3:4 - 脚本会调用后端 AI 服务生成图片
-
展示结果:
- 图片生成成功后,展示图片给用户
- 告知用户图片文件的保存路径
第二步:将文章转换成内容卡片图片
-
提取签名信息:
- 从用户输入中提取签名信息
- 如果用户没有提供签名,提醒用户提供
- 如果用户仍不提供,使用默认签名:"powered by AI 图卡工坊 @ 安晓辉"
- 将确认的签名保存为内部变量ASignature -
拆分文章:
- 统计文章字数
- 将文章拆分成多个约 220 字的片段
- 重要:拆分时必须分析内容含义,每个片段的末尾要自然分句、分段
- 优先保证意思完整性,字数可适当浮动
- 不能为保证字数而不顾句子含义强行拆分 -
为每个片段生成提示词:
- 读取模板文件templates/content-card-1.md
- 模板中有三个占位符需要替换:{{title}}替换为ATitle的值{{index}}替换为文章片段的序号(阿拉伯数字,从 1 开始){{signature}}替换为ASignature的值- 将每个片段的实际文章内容替换模板中的示例文章内容(即 """ 之间的部分)
- 将所有片段对应的提示词保存为文件(命名如
content-prompt-1.md、content-prompt-2.md等)
-
逐个生成内容卡片图片:
- 按顺序为每个文章片段生成图片
- 调用 Python 脚本scripts/generate_infographic.py,必须传入以下参数:--prompt-file:提示词文件路径(如content-prompt-1.md、content-prompt-2.md等)--aspect-ratio:画面比例,内容卡片图固定为3:4- 完整调用示例:
bash python scripts/generate_infographic.py --prompt-file content-prompt-1.md --aspect-ratio 3:4 - 必须在一个片段的图片生成成功后,再生成下一个片段的图片
- 不要并行生成多张图片
-
展示结果:
- 每张图片生成成功后,展示给用户
- 告知用户图片文件的保存路径
文件结构
article-to-cards/
├── SKILL.md # 本文件,技能定义
├── config.json # 配置文件,存储 API KEY
├── templates/
│ ├── cover-1.md # 封面图片提示词模板
│ └── content-card-1.md # 内容卡片提示词模板
└── scripts/
└── generate_infographic.py # 图片生成脚本
注意事项
- 所有图片比例为 3:4
- 封面图和内容卡片图都使用 AI 生成
- 文章拆分时必须保证语义完整性
- 内容卡片图片必须按顺序逐个生成,不可并行
- API KEY 必须验证有效后才能进行图片生成