| name | article-illustrator |
| description | 为文章自动生成封面图和各章节配图, 配图 |
| license | Complete terms in LICENSE.txt |
article-illustrator
功能说明
此技能用于为 Markdown 格式的文章自动生成:
- 封面题图:基于文章主题和标题
- 章节配图:为每个主要章节生成对应的配图
所有图片采用统一的卡通手绘风格,16:9 横版构图,2K 分辨率。
配图风格规范
核心风格要求
- 手绘风格:所有图像和文字必须使用手绘风格,没有写实风格图画元素
- 横版构图:16:9 比例,适合各种显示设备和文档排版
- 简洁卡通:加入少量简洁的卡通元素、图标或人物画像,增强趣味性和视觉记忆
- 相似替代:如果有敏感人物或版权内容,画一个相似替代,但不要拒绝生成
内容组织原则
- 语言一致:除非特别要求,否则语言与输入内容语言一致(中文文章用中文,英文文章用英文)
- 信息精简:突出关键词与核心概念
- 多留白:保持画面简洁,易于一眼抓住重点
- 层次清晰:主次分明,重要元素突出
工作流程
- 读取文章:解析 Markdown 文件结构,识别标题层级
- 分析内容:理解各章节的核心内容和主题
- 生成提示词:为封面和每个章节生成符合风格规范的中文提示词
- 批量生成:调用 Gemini 图像生成 API 生成所有图片
- 插入图片:自动将图片引用插入到文章的合适位置
提示词模板
通用结构
[风格要求] + [主题描述] + [构图说明] + [技术参数]
封面图模板
卡通手绘风格,横版16:9构图。[文章标题]题图。画面中央显示[核心元素],周围展示[相关元素]。采用手绘风格,所有图像和文字必须使用手绘风格,没有写实风格。信息精简,突出关键词,多留白,易于一眼抓住重点。除非特别要求,否则使用中文。16:9横版构图,简约清爽,手绘线条,留白充足
章节配图模板
卡通手绘风格,横版16:9构图。[章节名称][图类型]。[核心内容描述]。加入少量简洁的卡通元素、图标增强趣味性。采用手绘风格,没有写实风格图画元素。信息精简,突出关键词与核心概念,多留白。除非特别要求,否则使用中文。16:9横版,手绘线条,[风格描述]
图类型映射
根据章节内容和类型,自动选择合适的图类型:
| 章节类型 | 图类型 | 风格描述 | 典型元素 |
|---|
| 起源/背景 | 概念图 | 简约风格,突出核心概念 | 笔记本、灯泡、盾牌等象征性图标 |
| 功能/特性 | 展示图 | 信息图表风格,多元素展示 | 中心主题+分支,图标环绕 |
| 架构/设计 | 架构图 | 层次清晰,模块分明 | 堆叠的方块、箭头连接 |
| 原理/实现 | 流程图 | 步骤清晰,逻辑连贯 | 垂直/水平流程,箭头导向 |
| 代码/技术 | 技术图 | 突出技术元素,专业感 | 代码符号、齿轮、终端图标 |
| 数据/流程 | 流程图 | 垂直或水平流程,箭头连接 | 漏斗、管道、步骤框 |
| 部署/使用 | 场景图 | 实际场景,操作示意 | 电脑、容器、云朵图标 |
使用方法
基本用法
请为文章 [文章路径] 生成封面图和各章节配图
指定图片保存位置
请为文章 [文章路径] 生成配图,保存到 [目录路径]
自定义风格
请为文章 [文章路径] 生成配图,使用 [风格描述] 风格
命令行工具
python3 scripts/generate.py 文章.md
python3 scripts/generate.py 文章.md -o images/
python3 scripts/generate.py 文章.md --size 2K
python3 scripts/generate.py 文章.md --no-insert
输出文件命名
- 封面图:
cover.png
- 章节配图:
[序号]-[章节名称].png
示例:
cover.png
01-起源.png
02-功能概览.png
03-整体架构.png
...
技术要求
- 图像生成模型:gemini-3.1-flash-image-preview
- 分辨率:2K (2048x1152)
- 宽高比:16:9
- 风格:卡通手绘风格
- API Key:需要设置 GOOGLE_API_KEY 或 GEMINI_API_KEY 环境变量
最佳实践
提示词设计
- 风格前置:始终以"卡通手绘风格,横版16:9构图"开头
- 核心突出:每个提示词只突出 3-5 个核心元素
- 避免写实:明确要求"没有写实风格图画元素"
- 保持简洁:信息精简,多留白
视觉设计
- 色彩和谐:使用相近色系,保持视觉统一
- 元素精简:每张图突出核心概念,避免过度装饰
- 留白充足:便于后续添加标题或文字说明
- 图标统一:使用相同风格的图标和元素
内容适配
- 中文优先:中文内容使用中文提示词和标签
- 技术准确:技术类图标要符合行业惯例
- 隐喻恰当:使用直观的视觉隐喻帮助理解
注意事项
- API 配额:生成图片消耗 API 配额,建议一次性生成所有需要的图片
- 生成时间:图片生成约 5-15 秒/张,请耐心等待
- 章节过滤:纯代码列表、参考链接等章节会自动跳过
- 原文保留:生成的图片引用会插入文章,但保留原文内容
- 风格检查:检查生成图片是否符合手绘风格要求,必要时可重新生成
示例
技术文章封面
卡通手绘风格,横版16:9构图。Notex开源项目题图。画面中央显示笔记本图标,旁边有AI机器人助手,周围飘浮着文档、思维导图、PPT幻灯片等图标。采用手绘风格,没有写实风格。信息精简,突出关键词,多留白。16:9横版构图,简约清爽,手绘线条
架构图
卡通手绘风格,横版16:9构图。技术架构图。三层结构展示:前端层(HTML/JS图标)、后端层(Go语言Logo+Gin框架)、AI层(OpenAI/Ollama/Gemini图标)。底部是SQLite数据库图标。加入简洁的图标元素增强趣味性。手绘风格,没有写实风格。16:9横版,手绘线条,架构图风格
流程图
卡通手绘风格,横版16:9构图。完整数据流图。从上到下:用户上传→markitdown转换→文本分块索引→SQLite存储→用户选择转换类型→构建prompt→调用LLM→生成图片→保存Note→前端渲染。加入箭头图标增强视觉引导。手绘风格,没有写实风格。16:9横版,手绘线条,垂直流程图