SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场baoyu-article-illustrator

baoyu-article-illustrator

写作与研究

查看项目

更新于 10-16 04:47

技能介绍

用途

baoyu-article-illustrator 是一个为文章自动生成插图的技能。它分析文章结构，找出需要视觉辅助的位置，并生成风格统一的插图，最终把图片以 Markdown 图片语法插入到文章对应段落之后。

主要能力

  • 内容分析：判断内容类型（技术 / 教程 / 方法论 / 叙事）、目的（信息 / 可视化 / 想象）、核心论点（2-5 个要点），并定位插图位置。对隐喻的处理原则是：可视化其底层概念，而非字面图像。
  • 三维度控制：
    • Type（信息结构）：infographic、scene、flowchart、comparison、framework、timeline。
    • Style（渲染方式）：notion、warm、minimal、blueprint、watercolor、elegant 等。
    • Palette（配色，可选）：macaron、warm、neon，会覆盖风格默认配色。
    • 可自由组合，例如 --type infographic --style vector-illustration --palette macaron；也可用预设，例如 --preset edu-visual 一次指定类型、风格与配色。
  • 参考图：用户可通过 --ref <files...> 或直接提供文件路径 / 粘贴图片，参考图用于引导风格、配色、构图或特定插图的主体。
  • 批量生成：优先使用后端原生批量接口；否则在支持并行工具调用的运行时中并行生成，默认每批 4 张；都不支持时顺序生成。失败项重试一次，不重新生成已成功的项。
  • 输出目录布局：由 EXTEND.md 中的 default_output_dir 决定，可选 imgs-subdir（默认，{article-dir}/imgs/）、same-dir、illustrations-subdir、independent（illustrations/{topic-slug}/）。辅助文件（outline、prompts）保存在输出目录内。

使用方式

工作流程共六步：

  1. 预检查：按优先级查找 EXTEND.md（项目级 .baoyu-skills/baoyu-article-illustrator/EXTEND.md → XDG 配置目录 → 用户主目录）。找到则读取并显示摘要；未找到则运行首次设置。
  2. 分析内容：输出内容类型、目的、核心论点与插图位置。
  3. 确认设置：通过一次 AskUserQuestion 询问，最多 4 个问题。Q1（预设或类型）与 Q2（密度：minimal 1-2 / balanced 3-5 / per-section 推荐 / rich 6+）为必填；Q3（风格）在未选预设时必填；Q4（配色）在预设已含配色或已设 preferred_palette 时可跳过；Q5（语言）在文章语言与 EXTEND.md 设置不一致时询问。默认在生成前确认，除非当前请求明确表示跳过（如「直接生成」「不用確認」「跳過確認」「按默認出圖」）。
  4. 生成大纲：保存 outline.md，含 frontmatter（type、density、style、palette、image_count）与每条插图条目（位置、目的、视觉内容、文件名）。
  5. 生成图片：在调用任何后端之前，必须先把每张图的完整最终提示词保存为独立文件 prompts/NN-{type}-{slug}.md（含 YAML frontmatter），提示词需使用类型专属模板并包含结构化区块（ZONES / LABELS / COLORS / STYLE / ASPECT），LABELS 必须包含文章实际数据（数字、术语、指标、引语）。后端选择顺序：当前请求指定 → EXTEND.md 保存的偏好 → 自动选择（Codex imagegen、codex exec、Cursor GenerateImage、其他运行时原生工具、唯一已安装的非原生后端，多个非原生后端时询问用户一次）。禁止用 SVG、HTML、canvas 等代码渲染替代位图生成；禁止用程序化叠加修补已生成位图中的文字，文字有误应重新生成。
  6. 收尾：在段落之后插入 ![description]({relative-path}/NN-{type}-{slug}.png)，路径根据输出目录设置相对文章文件计算。

适用场景

适合需要为技术文章、教程、方法论或叙事类文章批量配图，并希望插图在信息结构、渲染风格与配色上保持一致的场景。

限制

  • 生成前默认需要用户确认，除非明确跳过。
  • 提示词文件必须先于图片生成保存，这是硬性要求。
  • 不支持用代码渲染（SVG/HTML/canvas）替代位图，也不支持对已生成位图做文字修补；后处理仅限裁剪、缩放、压缩或格式转换等不改变文字与主体构图的操作。
  • 若无法解析出位图后端，需告知用户并询问如何处理。
  • 具体收费、价格、平台支持范围等资料未提供。

偏好修改

EXTEND.md 位于预检查中第一个匹配的路径。修改方式：直接编辑文件；或删除 EXTEND.md（或要求「重新配置」）后下次运行重新触发首次设置。常见单行修改包括 preferred_image_backend（auto / codex-imagegen / baoyu-image-gen / ask）、generation_batch_size（默认 4）、preferred_type、preferred_style、preferred_palette、language、default_output_dir。