Baoyu Article Illustrator

核心用法

baoyu-article-illustrator 是一款面向内容创作者的智能文章配图工具，通过结构化工作流将文本转化为视觉资产。用户触发指令（如 "为文章配图"）后，系统执行六步闭环：预检配置 → 内容分析 → 参数确认 → 大纲生成 → 批量出图 → 终稿插入。

三维创作体系是核心特色：

• Type（类型）：控制信息结构——infographic（数据图）、scene（场景叙事）、flowchart（流程）、comparison（对比）、framework（模型架构）、timeline（时间轴）
• Style（风格）：定义渲染美学——notion、minimal、blueprint、watercolor、elegant 等
• Palette（调色板）：覆盖配色方案——macaron、warm、neon 等

三者自由组合（如 --type infographic --style vector-illustration --palette macaron），也可一键调用预设（如 --preset edu-visual）。

显著优点

1. 结构化工作流：强制预检 EXTEND.md 配置文件，确保项目级风格一致性；批量生成时优先使用 baoyu-imagine 批处理模式，避免重复调参
2. 隐喻可视化：关键原则——将抽象概念转化为视觉隐喻，而非直译文字，提升信息密度与记忆点
3. 工程化管理：自动生成 outline.md、独立 prompt 文件、标准化命名（NN-{type}-{slug}.png），支持增删改查全生命周期
4. 多输出目录策略：支持 imgs-subdir、same-dir、independent 等四种组织方式，适配博客、论文、知识库等不同场景

潜在局限

• 前置配置门槛：首次使用需完成 first-time-setup，否则阻断执行（⛔ BLOCKING）
• 交互确认环节：Step 3 强制 AskUserQuestion（最少 2 题，最多 5 题），自动化程度受限
• 风格预设依赖：Type × Style 兼容性需查阅外部文档，无内置冲突检测
• 中文生态适配：palette 预设以西方审美为主（macaron、neon），中文内容可能需要手动覆盖

适合人群

技术博客作者、知识管理用户、教育内容创作者、产品文档维护者——尤其需要长文配图一致性、批量生成、版本可追溯的场景。

常规风险

• 文件路径污染：自动创建 imgs/illustrations 子目录，可能意外修改工作区结构
• 生成失败中断：单图失败需手动重试，批处理模式下失败图像需单独追踪
• 版权水印：EXTEND.md 可配置自动水印，但若忘记设置可能导致品牌素材外流

核心用法

baoyu-article-illustrator 是一套专为文章配图设计的结构化工作流系统。用户只需提供文章内容，系统即自动完成：内容分析（识别技术/教程/叙事等类型及核心论点）→ 插图位置判定 → 交互式配置确认（1-4 个问题确认风格预设、密度、配色等）→ 生成结构化大纲 → 批量生成配图 → 自动插入 Markdown 引用。

三维配置体系是其精髓：

• Type（类型）：信息图(infographic)、场景(scene)、流程图(flowchart)、对比图(comparison)、框架图(framework)、时间线(timeline)
• Style（风格）：notion、warm、minimal、blueprint、watercolor、elegant 等，支持向量插画、手绘、科幻等渲染方式
• Palette（调色板）：macaron、warm、neon 等可选配色，覆盖风格默认色彩

支持预设一键配置（如 --preset edu-visual），也支持自由组合（--type infographic --style vector-illustration --palette macaron）。

显著优点

1. 工作流闭环完整：从分析到插入全自动化，生成 outline.md、prompt 文件、最终图片及引用代码，无需手动管理路径
2. 配置层级清晰：全局偏好（EXTEND.md）→ 项目偏好 → 单次交互确认，兼顾效率与灵活性
3. 批量生成优化：多图任务优先使用 baoyu-imagine 批处理模式，避免重复创建子代理
4. 输出路径智能：支持 imgs-subdir、same-dir、illustrations-subdir、independent 四种模式，适配不同项目结构
5. 隐喻可视化能力强：明确强调将抽象概念转化为视觉隐喻，而非字面直译

潜在局限

• 首次配置门槛：必须完成 EXTEND.md 初始化才能使用，阻塞式设计对临时用户不够友好
• 外部依赖隐含：图片生成实际委托给 baoyu-imagine 等下游 skill，本 skill 不直接控制生成质量与 API 稳定性
• 中文生态适配：风格预设、调色板命名偏西方设计语境，中文内容场景可能需要额外调整
• 版本迭代风险：当前 1.57.0 版本较新（2026年），长期维护承诺待观察

适合人群

• 技术博客作者、教程写作者（需大量流程图/架构图）
• 内容运营团队（追求视觉风格统一）
• Notion/公众号/知乎等多平台发布者（需快速生成适配配图）
• 对 AI 绘图有基础认知、愿花时间配置偏好设置的用户

常规风险

• 版权合规：使用 --ref 参考图时需确保来源合法；生成图像的商用许可取决于下游 image generation skill
• 内容安全：生成图像可能涉及人物肖像、敏感场景，需人工审核
• 路径依赖：输出目录配置错误可能导致图片引用失效，建议统一使用 imgs-subdir 默认模式