文章插图生成技能

核心功能

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 environment variable is not set"：
- 告知用户需要在设置面板配置豆包 API Key
- 提供配置指导：打开应用 → 设置 → API 配置 → 豆包 API Key
如果提示 "No such file or directory"：
- 使用 run_command 创建目录：mkdir -p assets/images
- 然后重新执行生图命令
如果提示其他错误：
- 记录完整错误信息
- 提供备选方案（使用 cover-generator 或在线工具）

环境变量注入：

DOUBAO_API_KEY：从 ConfigStore 自动读取
Agent 运行时会自动处理环境变量注入
无需手动设置

步骤 5：更新文章

在文章的指定位置插入图片引用：

## 微服务架构概述

微服务是一种架构风格...

![微服务三层架构图](assets/images/01-microservices-architecture.png)

如上图所示，微服务架构分为三层...

步骤 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：成长感悟文章配图