用途：为任意 Markdown 文章规划并生成配图，采用高完成度编辑视觉作为质量基线，先建立整篇统一的 visual bible，再为每张图生成结构化提示词，使同篇配图共享统一风格，并按章节调整构图与信息重点。默认兼容 Gemini Nano Banana 工作流与 Xiaomi Gemini 兼容接口，也支持 Gemini 原生代理和官方接口。
主要能力与流程：Step 1 分析文章结构，识别信息点，按 density（minimal/balanced/rich）确定配图数量与位置。Step 2 生成 visual-bible.md 与 outline.md，并为每张图生成提示词保存到 prompts/。Step 3 调用内置脚本生图：scripts/image-gen.ts，参数含 --prompt、--output、--ar，可选 --provider、--model、--base-url、--api-key、--image-size、--ref；也可用 node scripts/illustrate-article.ts --article <article.md> 一键完成规划、出图与插入。Step 4 可选上传七牛云：bun run scripts/qiniu-upload.ts --file <本地路径> --key <远程路径>，远程 key 格式为 illustrations/{slug}/{filename}。Step 5 复制原文为 article.illustrated.md，插入图片引用或占位注释，不修改原文。另有 bun run scripts/plan-illustrations.ts --article <article.md> 可仅生成规划。
前提与配置：文章 Markdown 需存在；生图通道需配置 Gemini 官方直连 GEMINI_API_KEY 或 GOOGLE_API_KEY，或 Gemini 代理 IMAGE_PROVIDER=gemini、IMAGE_API_KEY、可选 IMAGE_BASE_URL，或 Xiaomi 兼容接口 IMAGE_PROVIDER=xiaomi 或 XIAOMI_API_KEY，可选 XIAOMI_BASE_URL；上传需七牛云 QINIU_ACCESS_KEY、QINIU_SECRET_KEY、QINIU_BUCKET、QINIU_DOMAIN。
限制：默认可见文字为简体中文，仅白名单术语保留英文；单张失败重试一次后跳过；配置缺失或上传失败时提示或回退，不中断整体流程。其余细节暂未提供。