article-to-cards

将原始文字、文章等转换成多张 3:4 比例的高清精美文字卡片，卡片可用来发小红书图文笔记、微信公众号贴图、朋友圈等。

使用场景

• 用户想把一段文字、一篇文章转换成图片，发布成小红书图文笔记
• 用户想把一段文字、一篇文章转换成图片，发布成微信公众号贴图
• 用户想把原始文字、读书笔记、文章制作成精美卡片图

前置条件：API KEY 检查

在开始任何处理之前，必须先检查 API KEY：

1. 读取本技能目录下的 config.json 文件，格式如下：

```json

{

"peituyi": {

"api_base_url": "https://peituyi.aihowto.cn",

"api_key": "nb-sk-*",

"timeout": 180

}

}

```

1. 检查 api_key 字段是否有值（非空字符串）
2. 如果 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

}

}

```

1. 在没有收到有效的 API KEY 之前，不要进行任何后续处理，一直等待

处理流程

第一步：生成封面图片

1. 提取文章标题：
• 分析用户输入，如果用户明确指定了文章标题，使用该标题
• 如果用户没有明确指定标题，根据文章内容自动生成一个具有强烈吸引力的标题
• 将确认的标题保存为内部变量 ATitle

1. 生成封面提示词：
• 读取模板文件 templates/cover-1.md
• 用 ATitle 的值替换模板中的 {{title}} 占位符
• 将生成的提示词保存为文件 cover-prompt.md（放在用户当前工作目录下）

1. 调用脚本生成封面图片：
• 执行 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 服务生成图片

1. 展示结果：
• 图片生成成功后，展示图片给用户
• 告知用户图片文件的保存路径

第二步：将文章转换成内容卡片图片

1. 提取签名信息：
• 从用户输入中提取签名信息
• 如果用户没有提供签名，提醒用户提供
• 如果用户仍不提供，使用默认签名："powered by AI 图卡工坊 @ 安晓辉"
• 将确认的签名保存为内部变量 ASignature

1. 拆分文章：
• 统计文章字数
• 将文章拆分成多个约 220 字的片段
• 重要：拆分时必须分析内容含义，每个片段的末尾要自然分句、分段
• 优先保证意思完整性，字数可适当浮动
• 不能为保证字数而不顾句子含义强行拆分

1. 为每个片段生成提示词：
• 读取模板文件 templates/content-card-1.md
• 模板中有三个占位符需要替换：
• {{title}} 替换为 ATitle 的值
• {{index}} 替换为文章片段的序号（阿拉伯数字，从 1 开始）
• {{signature}} 替换为 ASignature 的值
• 将每个片段的实际文章内容替换模板中的示例文章内容（即 """ 之间的部分）
• 将所有片段对应的提示词保存为文件（命名如 content-prompt-1.md、content-prompt-2.md 等）

1. 逐个生成内容卡片图片：
• 按顺序为每个文章片段生成图片
• 调用 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

```

• 必须在一个片段的图片生成成功后，再生成下一个片段的图片
• 不要并行生成多张图片

1. 展示结果：
• 每张图片生成成功后，展示给用户
• 告知用户图片文件的保存路径

文件结构

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 必须验证有效后才能进行图片生成