用途：为任意 Markdown 文章自动规划并生成配图，默认以“高完成度编辑视觉”为全局质量基线，同一篇文章的多张配图共享统一视觉语言，适合公众号专题视觉场景，也可作为 zhy-wechat-writing 技能 Step 6 的调用环节。
工作流程：Step 1 读取 article_path，解析标题、章节、代码块，识别概念、对比、流程、架构、数据、叙事等信息点，并按 density（minimal / balanced / rich）确定配图数量与位置，输出目录为 {article_dir}/illustrations/{slug}/。Step 2 生成文章级 visual-bible.md（含视觉主题、色彩系统、图形语言、版式纪律、文字规则、禁止项）和 outline.md（每图的位置、目的、类型、核心信息、内容块、文字块、布局提示、文件名、alt 文本），并逐图生成提示词文件到 prompts/。Step 3 构建继承全局基线、visual bible 与单图规划的分层提示词，调用内置脚本 scripts/image-gen.ts 生图，支持 --prompt、--output、--ar，可选 --provider、--model、--base-url、--api-key、--image-size、--ref，建议最多 4 并发；单张失败重试一次，仍失败则记录跳过。Step 4（可选，upload=true）用 bun run scripts/qiniu-upload.ts --file <本地路径> --key <远程路径> 上传七牛云取 CDN URL，远程 key 格式为 illustrations/{slug}/{filename}。Step 5 复制原文为 article.illustrated.md 并插入图片引用，已上传用 CDN URL，未上传用相对路径，失败图插入 HTML 注释占位；不修改原文。
主要能力：统一视觉基线与结构化提示词、按章节内容调整构图与信息层级、支持 Gemini 官方直连/Gemini 原生代理或中转站/Xiaomi Gemini 兼容接口、可选七牛云上传、一键脚本 plan-illustrations.ts 与 illustrate-article.ts。
必要配置：至少一种生图通道，GEMINI_API_KEY 或 GOOGLE_API_KEY，或 IMAGE_PROVIDER=gemini 配合 IMAGE_API_KEY、可选 IMAGE_BASE_URL，或 IMAGE_PROVIDER=xiaomi 或 XIAOMI_API_KEY 配合可选 XIAOMI_BASE_URL；上传需在技能根目录 .env 配置 QINIU_ACCESS_KEY、QINIU_SECRET_KEY、QINIU_BUCKET、QINIU_DOMAIN。
限制：默认可见文字使用简体中文，仅白名单术语保留英文；提示词过长文字效果差时需精简后重试；文章文件不存在将立即报错退出；配置缺失会提示配置或跳过对应步骤；七牛云上传失败保留本地路径；slug 目录已存在时直接覆盖同名文件；开源仓库不预设任何私有中转地址。具体收费、价格与效果未提供。