article-illustrator

name	article-illustrator
description	为文章自动生成封面图和各章节配图, 配图
license	Complete terms in LICENSE.txt

article-illustrator

功能说明

此技能用于为 Markdown 格式的文章自动生成：

1. 封面题图：基于文章主题和标题
2. 章节配图：为每个主要章节生成对应的配图

所有图片采用统一的卡通手绘风格，16:9 横版构图，2K 分辨率。

配图风格规范

核心风格要求

• 手绘风格：所有图像和文字必须使用手绘风格，没有写实风格图画元素
• 横版构图：16:9 比例，适合各种显示设备和文档排版
• 简洁卡通：加入少量简洁的卡通元素、图标或人物画像，增强趣味性和视觉记忆
• 相似替代：如果有敏感人物或版权内容，画一个相似替代，但不要拒绝生成

内容组织原则

• 语言一致：除非特别要求，否则语言与输入内容语言一致（中文文章用中文，英文文章用英文）
• 信息精简：突出关键词与核心概念
• 多留白：保持画面简洁，易于一眼抓住重点
• 层次清晰：主次分明，重要元素突出

工作流程

1. 读取文章：解析 Markdown 文件结构，识别标题层级
2. 分析内容：理解各章节的核心内容和主题
3. 生成提示词：为封面和每个章节生成符合风格规范的中文提示词
4. 批量生成：调用 Gemini 图像生成 API 生成所有图片
5. 插入图片：自动将图片引用插入到文章的合适位置

提示词模板

通用结构

[风格要求] + [主题描述] + [构图说明] + [技术参数]

封面图模板

卡通手绘风格，横版16:9构图。[文章标题]题图。画面中央显示[核心元素]，周围展示[相关元素]。采用手绘风格，所有图像和文字必须使用手绘风格，没有写实风格。信息精简，突出关键词，多留白，易于一眼抓住重点。除非特别要求，否则使用中文。16:9横版构图，简约清爽，手绘线条，留白充足

章节配图模板

卡通手绘风格，横版16:9构图。[章节名称][图类型]。[核心内容描述]。加入少量简洁的卡通元素、图标增强趣味性。采用手绘风格，没有写实风格图画元素。信息精简，突出关键词与核心概念，多留白。除非特别要求，否则使用中文。16:9横版，手绘线条，[风格描述]

图类型映射

根据章节内容和类型，自动选择合适的图类型：

章节类型	图类型	风格描述	典型元素
起源/背景	概念图	简约风格，突出核心概念	笔记本、灯泡、盾牌等象征性图标
功能/特性	展示图	信息图表风格，多元素展示	中心主题+分支，图标环绕
架构/设计	架构图	层次清晰，模块分明	堆叠的方块、箭头连接
原理/实现	流程图	步骤清晰，逻辑连贯	垂直/水平流程，箭头导向
代码/技术	技术图	突出技术元素，专业感	代码符号、齿轮、终端图标
数据/流程	流程图	垂直或水平流程，箭头连接	漏斗、管道、步骤框
部署/使用	场景图	实际场景，操作示意	电脑、容器、云朵图标

使用方法

基本用法

请为文章 [文章路径] 生成封面图和各章节配图

指定图片保存位置

请为文章 [文章路径] 生成配图，保存到 [目录路径]

自定义风格

请为文章 [文章路径] 生成配图，使用 [风格描述] 风格

命令行工具

# 基本用法
python3 scripts/generate.py 文章.md

# 指定输出目录
python3 scripts/generate.py 文章.md -o images/

# 指定图片尺寸（1K/2K/4K）
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 环境变量

最佳实践

提示词设计

1. 风格前置：始终以"卡通手绘风格，横版16:9构图"开头
2. 核心突出：每个提示词只突出 3-5 个核心元素
3. 避免写实：明确要求"没有写实风格图画元素"
4. 保持简洁：信息精简，多留白

视觉设计

1. 色彩和谐：使用相近色系，保持视觉统一
2. 元素精简：每张图突出核心概念，避免过度装饰
3. 留白充足：便于后续添加标题或文字说明
4. 图标统一：使用相同风格的图标和元素

内容适配

1. 中文优先：中文内容使用中文提示词和标签
2. 技术准确：技术类图标要符合行业惯例
3. 隐喻恰当：使用直观的视觉隐喻帮助理解

注意事项

• 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横版，手绘线条，垂直流程图