| name | content-illustrator |
| description | 内容插图规划工具。当用户说"给文章配图"、"为文章生成插图"、"文章配图"、
"分析文章并配图"、"自动插图"、"为文章生成配图"时触发此技能。
工作流程：
1. 读取文章内容（read_file）
2. 分析需要插图的位置
3. 选择合适的风格（14种风格可选）
4. 调用 image-generation 技能生成图片
5. 更新文章，插入图片引用
支持风格：tech、fresh、minimal、warm、business、elegant、bold、
playful、nature、sketch、notion（默认）
|
文章插图生成技能
核心功能
AI 驱动的插图规划系统，自动分析文章结构，识别需要视觉辅助的位置，并调用项目内置的豆包 Seedream 4.5 API 生成高质量插图。
风格系统
支持 14 种精细风格：
现有风格（5种）
- tech - 专业科技（AI、编程、技术文档）
- fresh - 清新活泼（生活分享、学习笔记）
- minimal - 简约极简（哲学思考、深度观点）
- warm - 温暖治愈（情感文章、成长感悟）
- business - 商务专业（数据报告、市场分析）
新增风格（9种，来自宝玉）
- elegant - 优雅精致（商业分析、领导力内容）
- bold - 高对比冲击（观点文章、重要提醒）
- playful - 活泼趣味（教程指南、轻松内容）
- nature - 自然有机（环保健康、自然主题）
- sketch - 手绘草图（头脑风暴、创意过程）
- notion - Notion 极简（知识分享、概念解释）[默认]
工作流程
步骤 1：分析内容与选择风格
-
读取文章内容
- 使用
read_file 工具读取文章文件
- 提取标题、章节结构和核心主题
-
自动风格匹配
- 分析文章标题和内容关键词
- 匹配最佳风格（基于风格关键词库）
- 如未指定，默认使用 notion 风格
-
内容类型识别
- 技术文章 → tech/elegant
- 成长感悟 → warm/nature
- 教程指南 → playful/fresh
- 观点文章 → bold
- 知识分享 → notion/minimal
步骤 2：识别插图位置
插图三大目的：
- 信息补充：帮助理解抽象概念
- 概念可视化：将抽象想法转化为具体视觉
- 想象力引导：创造氛围，增强阅读体验
适合插图的内容：
- ✅ 需要可视化的抽象概念（如"微服务架构"、"递归算法"）
- ✅ 需要图解的流程/步骤（如"部署流程"、"操作步骤"）
- ✅ 需要视觉化对比的内容（如"方案A vs 方案B"）
- ✅ 需要强化的核心论点（如"3个关键原因"）
- ❌ 已有图片或代码截图
- ❌ 纯文字段落
插图数量原则：
- 每个主要章节至少 1 张
- 多于少好，避免过度
- 建议：3-5张（对于中等长度文章）
步骤 3：生成插图计划
创建结构化的插图计划（markdown 格式）：
# 插图计划
## 元信息
- 文章路径：`{{article_path}}`
- 风格：{{matched_style}}
- 插图数量：{{count}} 张
- 生成时间：{{timestamp}}
## 插图列表
### 插图 1：{{illustration_title}}
- **插入位置**：{{chapter_name}} 章节，第 X 段落后
- **用途**：{{purpose}}（如：解释微服务的三层架构）
- **视觉内容**：{{visual_description}}（如：从上到下依次是API网关、业务服务、数据层，箭头表示数据流向）
- **尺寸**：1792x1024（16:9横版）
- **文件名**：`assets/images/01-{{slug}}.png`
- **提示词草稿**：{{prompt_draft}}
---
### 插图 2：...
步骤 4：调用 image-generation 技能
对于每一张需要生成的图片：
重要：必须使用 run_command 工具执行命令，不能只生成脚本。
- 构建完整的命令：
python resources/skills/image-generation/scripts/doubao_image_gen.py \
--prompt "{{从插图计划提取的提示词}}" \
--size "1792x1024" \
--quality "hd" \
--output "assets/images/01-{{slug}}.png"
- 使用 run_command 工具执行：
调用格式：
使用 run_command 工具执行上述命令
- 确认生成成功：
- 检查返回信息中是否包含 "Successfully wrote to"
- 确认文件已创建到指定路径
- 处理错误：
环境变量注入：
DOUBAO_API_KEY：从 ConfigStore 自动读取- Agent 运行时会自动处理环境变量注入
- 无需手动设置
步骤 5：更新文章
在文章的指定位置插入图片引用：
## 微服务架构概述
微服务是一种架构风格...
如上图所示，微服务架构分为三层...
步骤 6：输出总结
生成完成后的总结报告：
✅ 插图生成完成
**文章**：{{article_path}}
**风格**：{{matched_style}}
**生成数量**：{{count}} 张
**生成清单**：
1. ✅ {{illustration_1}} - assets/images/01-xxx.png
2. ✅ {{illustration_2}} - assets/images/02-xxx.png
...
**插图计划**：`assets/illustration-plan.md`
**文章已更新**：图片已插入到指定位置
错误处理
图片生成失败
- 提供详细错误信息
- 建议使用备选方案（cover-generator、Canva等）
- 保存已成功生成的图片
文件写入失败
风格匹配失败
- 默认使用 notion 风格
- 提示用户可手动指定风格
最佳实践
- 先分析后生成：确保插图位置合理，避免盲目生成
- 批量生成限制：每次最多生成 5 张，避免超时
- 文件组织：所有图片保存在文章项目的
assets/images/ 目录
- 命名规范：
{序号}-{slug}.png，便于管理
示例场景
示例 1：技术文章自动配图
用户输入：
为我的文章《深入理解微服务架构》生成配图
AI 执行流程：
- 读取文章内容，识别为技术文章
- 自动匹配 tech 风格
- 分析文章结构，识别需要插图的位置：
- "微服务架构概述" → 需要架构图
- "服务间通信" → 需要通信流程图
- "数据一致性" → 需要对比图
- 生成 3 张插图并插入文章
- 输出总结报告
示例 2：成长感悟文章配图
用户输入：
给文章《我的2023年成长总结》配图，使用温暖治愈风格
AI 执行流程：
- 读取文章，用户指定 warm 风格
- 识别关键成长节点，需要 2 张配图：
- "年初迷茫期" → 温暖的启程图
- "年末收获" → 充满希望的成果图
- 生成配图并插入
- 完成总结
参考文档
