Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From content-creation
Reads a document, plans all image insertion points globally, generates all images in parallel, and asynchronously inserts them back into the original file. Supports cover images, custom aspect ratios, and three visual styles. Activate when users request illustrations for documents, articles, or notes.
npx claudepluginhub lovstudio/skills --plugin generalHow this skill is triggered — by the user, by Claude, or both
Slash command
/content-creation:document-illustratorclaude-opus-4-5-20251101This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
基于 AI 智能分析的文档配图生成工具。全局规划、并行生成、异步插入，高效为文档添加配图。
Analyzes article structure, identifies positions needing illustrations, and generates images with Type × Style × Palette consistency.
Generates AI illustrations for docs: hero images, covers, conceptual art, and infographics. Redirects precise diagrams and charts to specialized skills.
Creates p5.js generative art with seeded randomness, noise fields, and interactive parameter exploration. Use for algorithmic art, flow fields, or particle systems.
Share bugs, ideas, or general feedback.
基于 AI 智能分析的文档配图生成工具。全局规划、并行生成、异步插入，高效为文档添加配图。
备份 → 全局规划插入点 → 并行生成图片 → 异步插入原文 → 清理备份
在修改前先创建备份，确保安全回滚：
import shutil
backup_path = f"{doc_path}.illustrator-backup"
shutil.copy2(doc_path, backup_path)
所有后续操作直接在原文件上进行。
读取完整文档，一次性规划所有图片的插入位置：
插入计划：
[1] 行 15 后 | 锚点: "## Rules 的诞生" | 主题: Rules 演化历程
[2] 行 42 后 | 锚点: "## Commands 打包" | 主题: 工作流打包
[3] 行 78 后 | 锚点: "## MCP 动态能力" | 主题: 第三方集成
...
[cover] 行 1 前 | 封面图 | 主题: 全文概要
关键：插入锚点使用上下文文本（而非纯行号），这样即使前面的插入导致行号偏移，后续插入仍可通过锚点定位。
用 Agent 工具并行启动所有图片生成子任务：
对每个插入计划项，同时启动一个 Agent：
Agent 1: generate_single_image.py --title "..." --content "..." --output images/illustration-01.png
Agent 2: generate_single_image.py --title "..." --content "..." --output images/illustration-02.png
Agent 3: generate_single_image.py --title "..." --content "..." --output images/illustration-03.png
...
每个 Agent 完成后立即插入，不等待其他 Agent：
位置偏移处理：
## Rules 的诞生）而非行号来定位所有图片插入完成后：
![...]() 引用都已插入images/ 目录{doc_path}.illustrator-backup完成: 6/6 张配图已插入原文档
已清理备份文件
执行前 Claude 会询问（或从用户消息中推断）：
| 选项 | 值 | 默认 |
|---|---|---|
| 图片比例 | 16:9 / 3:4 | 16:9 |
| 是否封面图 | 是/否 | 否 |
| 内容配图数量 | 3-10 | 根据文档长度推荐 |
| 风格 | gradient-glass / ticket / vector-illustration | gradient-glass |
如果用户在请求中已指定（如"竖屏、票据风格、8张"），直接使用，不再询问。
| 风格 | 关键词 | 适合 |
|---|---|---|
| gradient-glass | 玻璃拟态、极光渐变、科技感 | 技术文档、产品介绍 |
| ticket | 黑白对比、票券结构、极简 | 数据报告、信息图表 |
| vector-illustration | 扁平插画、复古配色、几何化 | 教程、故事、品牌 |
风格文件位于 styles/ 目录。
| 项目 | 值 |
|---|---|
| API 模型 | Gemini 2.0 Flash Image Preview |
| 16:9 分辨率 | 2560x1440 (2K) / 3840x2160 (4K) |
| 3:4 分辨率 | 1920x2560 (2K) / 2880x3840 (4K) |
| 单张耗时 | ~10-20s |
| 并行耗时 | ~10-20s（总，不乘 N） |
| 依赖 | pip install google-genai pillow python-dotenv |
| API Key | .env 中 GEMINI_API_KEY 或环境变量 |
scripts/generate_single_image.py — 单张图片生成（供 Agent 并行调用）scripts/generate_illustrations.py — 旧版批量顺序生成（保留兼容）