核心用法
baoyu-article-illustrator 是一个为长文章自动生成配图的专业工具。其工作流程遵循严格的六步规范：预检查（加载 EXTEND.md 配置）→ 内容分析 → 参数确认 → 生成配图大纲 → 批量出图 → 最终插入。
核心创新在于 Type × Style × Palette 三维方法论：
- Type（类型）：决定信息结构——infographic（数据/技术）、scene（叙事/情感）、flowchart（流程）、comparison（对比）、framework（架构）、timeline（时间线）
- Style（风格）：控制渲染方式——notion、warm、minimal、blueprint、watercolor、elegant 等
- Palette（配色）：可选覆盖默认色系——macaron、warm、neon 等
用户可通过 --preset 一键调用预设组合，或自由混搭三维度参数。
显著优点
1. 工程化严谨：强制要求先保存 prompt 文件再生成图片，确保可复现性；禁止用代码修补已生成图片中的文字错误，必须重跑流程
2. 智能批量策略：优先使用后端原生批量接口，次选运行时并行调用，默认批次为4张，支持失败重试
3. 配置分层管理：支持项目级、XDG目录、用户主目录三级 EXTEND.md 配置，兼顾团队协作与个人偏好
4. 后端中立设计：自动检测并优先使用运行时原生工具（如 Codex 的 imagegen），支持用户强制指定或每次询问
潜在局限
- 硬性依赖配置：首次运行必须完成 first-time-setup，无配置则阻断流程，对临时用户不够友好
- 确认门槛较高：默认强制 Step 3 用户确认，虽可跳过但需显式指令，批量自动化场景下可能增加交互负担
- 多后端冲突解决：当存在多个非原生后端且无运行时原生工具时，仍需人工选择一次
- 中文生态依赖：部分文档、预设名称及交互提示以中文为主，国际化支持有限
适合人群
- 技术写作者：需要为技术博客、教程、白皮书生成统一风格的数据图表与架构图
- 内容运营团队：批量处理公众号、知乎专栏等长文配图，追求视觉一致性
- 独立开发者：维护个人知识库或开源文档，希望减少配图时间成本
常规风险
- 生成成本不可控：批量生成可能触发高额 API 费用，建议通过
generation_batch_size限制并发 - 风格漂移风险：跨批次生成时若未锁定 seed 或参考图，可能出现风格不一致
- 文字渲染失败：AI 生图常见文字错乱问题，该工具虽禁止后期修补，但重跑仍需额外成本与时间