article-illustrator

name	article-illustrator
version	1.2.0
description	Use when illustrating a Markdown article with high-finish editorial visuals, visual-bible planning, structured prompts, optional Qiniu upload, and inserted image references for article publishing workflows.
inputs	[{"name":"article_path","type":"string","required":true,"description":"文章 Markdown 文件路径（如 articles/my-topic/article.md）"},{"name":"slug","type":"string","required":false,"description":"输出目录标识（kebab-case）。若不提供，从文章标题自动推导","default":""},{"name":"density","type":"string","required":false,"description":"配图密度：minimal（1-2 张）| balanced（每主要章节一张）| rich（尽量多配）","default":"balanced"},{"name":"upload","type":"boolean","required":false,"description":"是否上传到七牛云图床并替换为 CDN URL","default":false},{"name":"aspect_ratio","type":"string","required":false,"description":"图片宽高比，如 16:9、4:3、1:1","default":"16:9"},{"name":"prompt_profile","type":"string","required":false,"description":"提示词配置档案。默认 `nano-banana`，强调高完成度编辑视觉与强风格统一","default":"nano-banana"},{"name":"text_language","type":"string","required":false,"description":"图片内默认文字语言。推荐 `zh-CN`","default":"zh-CN"},{"name":"english_terms_whitelist","type":"array","required":false,"description":"允许在图片中保留英文展示的术语白名单，如产品名、协议名、缩写","default":[]},{"name":"image_provider","type":"string","required":false,"description":"生图通道，默认 `xiaomi`。支持 Gemini 官方直连、Gemini 原生代理，或 Xiaomi Gemini 兼容接口","default":"xiaomi"},{"name":"image_model","type":"string","required":false,"description":"生图模型名称。默认使用接口调用时的 `gemini-3.1-flash-image-preview`","default":"gemini-3.1-flash-image-preview"},{"name":"image_base_url","type":"string","required":false,"description":"生图 API 基础地址。可传入 Xiaomi Gemini 兼容接口、官方 Gemini 地址或自建代理地址；未提供时由运行环境决定默认值"}]
outputs	[{"name":"illustrated_article_path","type":"string","description":"插入图片引用后的文章副本路径（article.illustrated.md）"},{"name":"illustrations_dir","type":"string","description":"生成图片所在的目录路径"},{"name":"outline_path","type":"string","description":"配图规划文件路径（outline.md）"},{"name":"visual_bible_path","type":"string","description":"文章级视觉基线文件路径（visual-bible.md）"},{"name":"image_count","type":"integer","description":"成功生成的图片数量"},{"name":"failed_count","type":"integer","description":"生成失败的图片数量"},{"name":"uploaded_urls","type":"array","description":"上传成功的 CDN URL 列表（仅 upload=true 时有值）"}]

article-illustrator

Purpose

为任意 Markdown 文章自动规划并生成配图。技能默认采用“高完成度编辑视觉”作为 全局质量基线：不是简单插画，不是装饰图标拼贴，也不是低信息密度草图。系统会先 为文章生成统一的 visual bible，再为每张图生成结构化提示词，使同一篇文章的配图 共享统一风格语言，同时根据章节内容调整构图、信息重点和版式。

默认优先兼容 Gemini Nano Banana 工作流，并默认走 Xiaomi Gemini 兼容接口；同时支持 Gemini 原生代理 / 中转站模式与官方 Gemini 接口。

When to Use

• 用户请求“为文章配图”、“illustrate article”、“add images to article”
• wechat-writing 技能的 Step 6 调用（with_illustrations=true）
• 用户希望生成更适合公众号场景的高完成度专题视觉
• 用户希望将本地图片上传到七牛云获取 CDN URL

Prerequisites

• 文章 Markdown 文件已存在
• 已配置至少一种可用生图通道：
  • Gemini 官方直连：GEMINI_API_KEY 或 GOOGLE_API_KEY
  • Gemini 原生代理 / 中转站：IMAGE_PROVIDER=gemini、IMAGE_API_KEY、可选 IMAGE_BASE_URL
  • Xiaomi Gemini 兼容接口：IMAGE_PROVIDER=xiaomi 或 XIAOMI_API_KEY，可选 XIAOMI_BASE_URL
  • 若启用上传：七牛云配置已就绪（技能根目录 .env 中的 QINIU_ACCESS_KEY / QINIU_SECRET_KEY / QINIU_BUCKET / QINIU_DOMAIN）

Workflow

Step 1: 分析文章

目标：理解文章结构，确定配图数量、位置与表达方式

操作：

1. 读取 article_path 的完整内容
2. 解析文章结构：标题、各章节标题（## / ###）、段落数、代码块位置
3. 识别核心信息点：
   • 关键概念 / 术语解释 -> 适合信息图
   • 对比 / 差异描述 -> 适合对比图
   • 步骤 / 流程描述 -> 适合流程图
   • 架构 / 框架描述 -> 适合架构图
   • 数据 / 统计 -> 适合数据可视化
   • 场景 / 叙事描述 -> 适合专题插画或编辑场景图
4. 根据 density 确定配图策略：
   • minimal：仅为最核心的 1-2 个信息点配图
   • balanced：每个 ## 级主要章节配一张图
   • rich：每 300 字左右或每个重要段落配一张图
5. 确定 slug：
   • 若用户提供 slug：直接使用
   • 否则从文章 H1 标题推导 kebab-case
6. 创建输出目录：{article_dir}/illustrations/{slug}/

输出：文章结构分析结果、配图位置列表

Step 2: 生成 visual bible 与配图规划