用途
该技能面向 Markdown 文章批量配图场景：分析文章结构，为每个段落或小节生成配图提示词，调用 Gemini API 批量生成图片，并自动保存到 Obsidian 图片目录、插入文档。当用户说“批量配图”“给文章配图”“生成文章插图”“为这篇文章配图”时触发。
主要能力
- 读取用户提供的文章内容（当前打开文件或指定路径）。
- 按 H2/H3 标题拆分段落，忽略 frontmatter、纯引用、脚注等辅助内容，提取每个段落的标题、核心观点（1 句话）、关键概念（3-5 个词）。
- 生成全局 STYLE INSTRUCTIONS 代码块，默认使用风格 1（简约手绘风），用户可选择风格 2（建筑蓝图编辑风）。
- 为每个段落生成图片提示词大纲，提示词主体用英文编写，图片中文字标签直接写中文原文，并在末尾追加中文为主指令。
- 展示所有提示词并等待用户确认或修改。
- 确认后调用 scripts/generate_image.py 逐个生成图片，保存到 obsidian/09image/MMDD-主题名称/ 目录，并在每个段落标题后插入 ![[图片路径]] 引用。
使用方式
工作流程分为两个阶段。
Phase 1：分析文章 → 生成提示词
- 读取文章。
- 结构分析，按 H2/H3 拆分段落，输出表格（#、段落标题、核心观点、关键概念）。
- 生成全局风格指令，读取 references/style-guide.md 获取风格模板。
- 为每个段落生成提示词，结构包括风格前缀、图表类型（概念图/流程图/对比图/层次图/关系图）、内容描述、中文标签（1-3 个）、中文为主指令、排除项（No photography, no realistic elements, no complex gradients）。
- 以列表形式展示所有提示词，询问用户是否满意、是否需要修改，确认后开始批量生成。
Phase 2：生成图片 → 插入文档
- 调用 API 生成图片，示例命令：
python3 scripts/generate_image.py
--prompt "提示词内容"
--output "/Users/ugreen/Documents/obsidian/09image/MMDD-主题名/01-段落名.png"
--api-key "REMOVED_GEMINI_KEY"
--api-url "https://generativelanguage.googleapis.com"
--model "gemini-3-pro-image-preview"
--aspect-ratio "16:9"
--resolution "2K"
注意事项：MMDD 取当天日期；主题名从文章 H1 标题提取并简化；图片编号两位数字（01、02、03…）；每张图生成后检查脚本输出确认成功；若某张图失败，记录并继续下一张，最后汇报失败项；图片间间隔 2-3 秒，避免 API 限流。
- 保存路径规范：
/Users/ugreen/Documents/obsidian/09image/MMDD-主题简称/ ├── 01-段落标题简称.png ├── 02-段落标题简称.png ├── 03-段落标题简称.png └── ...
- 插入文档：在文章对应段落标题下方插入图片引用，使用 Obsidian wikilink 格式：
段落标题
![[09image/MMDD-主题简称/01-段落标题简称.png]]
段落正文内容...
API 配置
- API URL：https://generativelanguage.googleapis.com
- API Key：REMOVED_GEMINI_KEY
- Model：gemini-3-pro-image-preview
- 默认比例：16:9
- 默认分辨率：2K
风格选择
- 风格 1（默认）：简约手绘，黑色线条，白底；适用于通用、概念解释、流程说明。
- 风格 2：建筑蓝图/技术期刊，精致极简；适用于系统架构、技术分析、专业内容。
用户可在确认阶段选择全局风格，也可为单个图指定不同风格。
常见用法
- “给这篇文章配图”：分析当前打开的文章并批量配图。
- “批量配图”：同上。
- “用风格2给文章配图”：使用建筑蓝图编辑风格。
- “修改第3张图的提示词”：重新生成指定图片。
- “重新生成第2张”：用修改后的提示词重新调用 API。
限制
资料未提供该技能的价格、收费方式、平台兼容范围、生成效果保证等信息，暂未提供。