article-illustration-generator

用途

Article Illustration Generator 是一个为文字文章自动生成配图并输出为 HTML 文件的技能。它读取用户提供的文章文本，借助 Gemini Image API 生成与内容相关的插图，再将文字与图片组合成排版美观的 HTML 页面。

主要能力

• 自动分析文章文本，将其切分为逻辑段落（sections）。
• 识别需要配图的关键场景，目标约为每 2-3 段配一张图。
• 针对每个识别出的场景，基于文本上下文生成描述性提示词。
• 使用 google.genai SDK 生成图片，默认模型为 gemini-2.5-flash-image（也可由用户指定）。
• 图片配置支持 aspect_ratio="16:9" 或 4:3，适用于文章配图。
• 使用 assets/template.html（“故都的秋”风格）作为 HTML 模板，将文本与本地保存的生成图片插入 HTML 结构。

使用方式

技能被调用时，代理应执行以下流程：

1. 检查 API Key 配置：使用 Bash 检查 GOOGLE_API_KEY 环境变量是否已设置（Linux/Mac 用 echo $GOOGLE_API_KEY，Windows 用 echo %GOOGLE_API_KEY%）。若为空或未设置，使用 AskUserQuestion 询问：“您是否已经配置了 Google API Key？”选项一：“是，已配置为环境变量”——继续执行脚本；选项二：“否，我需要提供 API Key”——要求用户提供 API Key，并作为命令行参数传给脚本。若用户提供了 API Key，则临时存储以供本次执行使用。
2. 读取用户提供的目标文章。
3. 规划图片插入点。
4. 执行 Python 脚本（scripts/article_to_html.py），并传入适当参数：
   • 若 API Key 由用户提供：python scripts/article_to_html.py <article_file> <api_key>
   • 若使用环境变量：python scripts/article_to_html.py <article_file>
   • 可选参数：--images N、--model MODEL、--ratio RATIO、--size SIZE
5. 验证结果并告知用户输出位置。

附带资源

技能在 references/ 目录中包含以下参考文件：

• references/template.html：带衬线字体和简洁布局的 HTML/CSS 模板，作为输出文件的基础。
• references/api_guide.md：Nano Banana Pro（Gemini 3 Pro Image）API 的详细文档，可用于高级图片生成需求。
• references/script_template.py：包含 API 调用逻辑的 Python 脚本模板。

适用场景

适用于需要为文字文章批量生成配图并输出为 HTML 页面的场景，例如将文章内容转化为带插图的网页展示。

限制

• 依赖 Google API Key（GOOGLE_API_KEY 环境变量或用户提供），未配置时需用户提供。
• 图片生成依赖 Gemini Image API 及 google.genai SDK。
• 关于收费、价格、具体平台支持范围等信息，资料中暂未提供。