baoyu-article-illustrator 使用指南:命令语法、参数详解与批量配图实战 AI 技能AI 插件【免费下载链接】baoyu-skills项目地址https://gitcode.com/gh_mirrors/ba/baoyu-skills点击查看免费下载baoyu-article-illustrator 是 baoyu-skills 仓库中负责为文章配图的技能它分析文章结构、识别需要视觉辅助的位置并按照Type × Style × Palette类型 × 风格 × 调色板三维度体系生成风格统一的信息图与插画。本文以 references/usage.md 为主线完整讲解该技能的命令语法、全部参数、输入模式与输出目录规则并结合仓库内的工作流、预设、提示词构建与偏好配置文档帮助你从会敲命令进阶到能稳定产出高质量配图。命令语法总览usage.md 定义了技能的完整调用形态。它既可以接收一个 Markdown 文章文件路径也可以直接接收粘贴的正文内容还可以通过一系列参数控制配图的类型、风格、密度与并发批量大小# 自动根据内容选择类型与风格最简用法 /baoyu-article-illustrator path/to/article.md # 指定配图类型 /baoyu-article-illustrator path/to/article.md --type infographic # 指定视觉风格 /baoyu-article-illustrator path/to/article.md --style blueprint # 同时指定类型与风格 /baoyu-article-illustrator path/to/article.md --type flowchart --style notion # 指定配图密度 /baoyu-article-illustrator path/to/article.md --density rich # 提示词保存后最多并行生成 4 张图 /baoyu-article-illustrator path/to/article.md --batch-size 4 # 直接内容输入粘贴模式 /baoyu-article-illustrator [paste content]需要说明的是这些命令由 Agent 运行时如 Claude Code、Codex、Cursor 等执行--batch-size等参数通过当前请求文本传给 Agent 解析属于当前请求覆盖级别的配置——它只影响本次运行不会写入持久化偏好文件详见下文 EXTEND.md 一节。参数Options详解参数说明--type name配图类型取值范围见 SKILL.md 中的 Type Galleryinfographic、scene、flowchart、comparison、framework、timeline等--style name视觉风格取值范围见 styles.mdsketch-notes、notion、blueprint、watercolor、vector-illustration等--preset name预设快捷方式一个 flag 同时决定 type style可含 palette见 style-presets.md--density level配图密度图片数量minimal/balanced/rich--batch-size n本次运行的临时生成批量大小。默认取 EXTEND.md 中的generation_batch_size未配置时为 4有效范围被限制在 1-8参数之间存在明确的优先级规则显式传入的--type/--style会覆盖 preset 中预设的对应维度preset 则是 type style可选 palette的组合快捷方式适合一键定位后再做局部微调。关于 --batch-size 的底层机制--batch-size并不只是多线程跑图的开关。在 workflow.md 的 Step 5.5 中定义了三级执行策略后端原生批量接口如果所选图像后端如 baoyu-image-gen提供原生 batch 接口优先使用每个任务保留独立的提示词文件、输出路径、宽高比与参考图运行时并行调用若后端无原生批量接口但运行时支持并行工具调用则按generation_batch_size默认 4逐批派发串行兜底两者皆无时才逐张顺序生成。同时有两条硬性约束第一批开始前本批所有提示词文件必须已经落盘失败项只重试一次且不会重新生成已成功的图片。这意味着--batch-size的上限 8 与 EXTEND.md 中generation_batch_size: 4的默认值共同定义了并发的安全边界。输入模式与输出目录两种输入模式模式触发方式输出目录文件路径传入path/to/article.md使用 EXTEND.md 中的default_output_dir偏好未配置则询问用户粘贴内容不传路径参数直接粘贴正文illustrations/{topic-slug}/文件路径模式下Agent 会执行完整的预检查 → 分析 → 确认 → 生成工作流粘贴模式下正文会先保存为source.md若目标目录已存在source.md则先重命名为source-backup-YYYYMMDD-HHMMSS.md输出目录固定为illustrations/{topic-slug}/其中{topic-slug}是 2-4 个单词的 kebab-case 主题标识冲突时追加-YYYYMMDD-HHMMSS后缀。输出目录default_output_dir的四种取值取值目录路径Markdown 插入路径same-dir{article-dir}/NN-{type}-{slug}.pngillustrations-subdir{article-dir}/illustrations/illustrations/NN-{type}-{slug}.pngimgs-subdir默认{article-dir}/imgs/imgs/NN-{type}-{slug}.pngindependentillustrations/{topic-slug}/illustrations/{topic-slug}/NN-{type}-{slug}.png相对当前工作目录在 EXTEND.md 中通过default_output_dir配置例如default_output_dir: illustrations-subdir。无论哪种取值所有辅助文件outline、prompts都会保存在输出目录内{output-dir}/ ├── outline.md ├── prompts/ │ └── NN-{type}-{slug}.md └── NN-{type}-{slug}.png注意 preferences-schema.md 中default_output_dir的枚举注释为same-dir|illustrations-subdir|independent而首次安装流程first-time-setup推荐的默认值是imgs-subdir无论选择哪一种Step 6 回插图片时使用的相对路径都会与之一一对应避免文章仓库中出现断链。典型实战示例usage.md 给出了 6 个覆盖不同文章类型的完整示例这里逐一拆解其意图带数据的技术文章——信息图 技术蓝图数据与指标最适用/baoyu-article-illustrator api-design.md --type infographic --style blueprint同样的需求改用预设——一个 flag 顶替两个/baoyu-article-illustrator api-design.md --preset tech-explainertech-explainer展开为infographic类型blueprint风格与上一命令等价。个人故事/baoyu-article-illustrator journey.md --preset storytellingstorytelling对应scenewarm适合叙事、情感类内容。带步骤的教程——流程 高密度覆盖/baoyu-article-illustrator how-to-deploy.md --preset tutorial --density richtutorial为flowchartvector-illustration配合--density rich可获得 6 张以上的完整图解覆盖。观点类文章配海报风/baoyu-article-illustrator opinion.md --preset opinion-pieceopinion-piece对应scenescreen-print丝网印刷海报风。预设基础上的局部覆盖——显式参数优先/baoyu-article-illustrator article.md --preset tech-explainer --style notion这等价于infographic 类型 notion 风格印证了 style-presets.md 的覆盖规则显式--type/--style永远覆盖 preset 值。为什么是三维度Type × Style × Palette理解了命令语法后需要理解其背后的设计骨架。SKILL.md 将一张配图拆成三个正交维度维度控制什么示例Type信息结构infographic、scene、flowchart、comparison、framework、timelineStyle渲染手法notion、warm、minimal、blueprint、watercolor、elegantPalette配色方案可选macaron、warm、neon——覆盖风格默认配色可以自由组合--type infographic --style vector-illustration --palette macaron也可以直接用预设一键完成三维组合。类型Type类型最佳场景infographic数据、指标、技术内容scene叙事、情感内容flowchart流程、工作流comparison对比、多选项framework模型、架构timeline历史、演进风格Style与风格图例styles.md 将风格分为两层Core Styles快速选择层覆盖绝大多数场景与完整 Style Gallery细粒度控制。Core Styles 中hand-drawn映射 sketch-notes是文档钦定的默认推荐当内容分析没有强信号时系统回退到sketch-notes。以下两张截图分别展示了blueprint技术蓝图与sketch-notes手绘笔记两种风格的典型成图其余常用风格包括vector-illustration扁平矢量、notion极简手绘线稿、elegant精致商务、warm友好温馨、minimal极简、watercolor水彩、editorial杂志式、scientific学术精确、screen-print海报丝印、ink-notes纯白底黑墨水手绘笔记等。每种风格的完整规格背景、色板、视觉元素、Do/Dont 规则存放在references/styles/style.md。风格与类型之间并非随意搭配styles.md 提供了一张 Type × Style 兼容矩阵✓✓ 高度推荐 / ✓ 兼容 / ✗ 不推荐。例如scene与blueprint不兼容✗而infographic与sketch-notes、vector-illustration、notion、blueprint、editorial均为高度推荐组合。同一维度还提供了按内容信号自动推荐的映射表例如出现 API, metrics, data, numbers 信号 → 推荐infographicblueprint/vector-illustration出现 manifesto, mindset shift → 推荐comparison/frameworkink-notes。调色板Palette调色板说明最佳场景macaron暖米色底上的柔和粉彩块蓝、薄荷、薰衣草、桃教育、知识、教程warm暖土色系橙、赤陶、金不含冷色品牌、产品、生活方式neon深紫底上的霓虹色粉、青、黄游戏、复古、流行文化mono-ink纯白底黑色墨水 稀疏语义点缀专业视觉笔记、前后对比、宣言调色板的覆盖规则很明确styles.md Palette Override Rulespalette 的 Colors 替换风格的默认 Color PaletteBackground 替换风格默认背景色但风格的纹理描述texture保留。例如 macaron 调色板在 macaron.md 中定义了 Warm Cream 背景#F5F0E8、四种马卡龙色块填充与 Coral Red#E8655A强调色并明确要求不要将颜色名、hex 码渲染成图中可见文字。预设Preset体系一键组合的速查表style-presets.md 将预设按内容类别组织成四组速查表--preset X展开为一个 type style 可选 palette 组合技术工程类tech-explainerinfographic blueprintAPI 文档/系统指标/技术深度文、system-designframework blueprint架构图、architectureframework vector-illustration组件关系/模块结构、science-paperinfographic scientific研究成果/学术。知识与教育类knowledge-base、saas-guide、tutorialflowchart vector-illustration步骤教程、process-flowflowchart notion、warm-knowledgeinfographic vector-illustration warm、edu-visualinfographic vector-illustration macaron、hand-drawn-eduinfographic sketch-notes macaron默认预设、hand-drawn-edu-flow、hand-drawn-edu-compare、ink-notes-comparecomparison ink-notes mono-inkBefore/After 类、ink-notes-flow、ink-notes-framework。数据与分析类data-reportinfographic editorial、versuscomparison vector-illustration、business-comparecomparison elegant。叙事与创意类storytellingscene warm、lifestylescene watercolor、historytimeline elegant、evolutiontimeline warm。观点与社论类opinion-piecescene screen-print、editorial-poster、cinematic。内容类型 → 预设推荐Step 3 确认环节正是依赖这张映射表来给出推荐项完整表格见 style-presets.md内容类型Step 2 分析结果首选预设备选一般 / 无明显信号hand-drawn-eduedu-visual、knowledge-base教育 / 知识hand-drawn-eduedu-visual、knowledge-base、tutorial教程hand-drawn-edu-flowtutorial、process-flow技术tech-explainersystem-design、architecture方法论 / 框架system-designarchitecture、process-flow数据 / 指标data-reportversus、tech-explainer对比 / 评测versusbusiness-compare、hand-drawn-edu-compare宣言 / 思维转变ink-notes-compareink-notes-framework、ink-notes-flow叙事 / 个人storytellinglifestyle、evolution观点 / 社论opinion-piececinematic、editorial-poster历史 / 时间线historyevolution学术 / 研究science-papertech-explainer、data-report当 Step 2 内容分析没有产出强信号时Step 3 Q1 的默认推荐必须是hand-drawn-eduinfographic sketch-notes macaron——这是技能面向通用文章的普适回退项也正是 usage.md 示例中预设替换双参数这一用法的前提。六步工作流与确认策略命令只是入口背后是 SKILL.md / workflow.md 定义的完整六步流水线- [ ] Step 1: 预检查EXTEND.md、参考资料、配置 - [ ] Step 2: 内容分析 - [ ] Step 3: 确认设置AskUserQuestion - [ ] Step 4: 生成大纲 - [ ] Step 5: 生成图片 - [ ] Step 6: 收尾Step 1预检查按优先级加载 EXTEND.md项目级.baoyu-skills/baoyu-article-illustrator/EXTEND.md→ XDG 级 → 用户级$HOME/.baoyu-skills/未找到则必须阻塞式执行 first-time-setup完成后才能继续同时检测用户提供的参考图--ref files...或对话中粘贴的图片保存到references/NN-ref-{slug}.{ext}。Step 2分析判定内容类型Technical / Tutorial / Methodology / Narrative、配图目的、提取 2-5 个核心论点、定位插图位置。关键规则比喻必须可视化其底层概念而不是字面形象workflow.md 以电锯切西瓜为例不画西瓜而画其背后的概念。Step 3确认硬门禁一次 AskUserQuestion 最多 4 个问题Q1Preset 或 Type与 Q2Density必答Q3Style在未选 preset 时必答Q4Palette可选。默认行为是生成前必须确认只有用户在当前请求中明确表达直接生成 / 不用确认 / 跳过确认 / 按默认出图等措辞时才可跳过且跳过后需在下一条用户可见消息中说明假定的 type / density / style / palette / language / backend。Density 的四档为minimal1-2 张、balanced3-5 张、per-section每节至少 1 张推荐、rich6 张。Step 4大纲保存outline.md带 YAML frontmattertype、density、style、palette、image_count每个插图条目记录 Position / Purpose / Visual Content / Filename文件名遵循NN-{type}-{slug}.png。Step 5生成为每张图创建提示词文件prompts/NN-{type}-{slug}.md硬性要求任何生成动作前必须落盘这是可复现性记录按 batch 策略执行处理参考图direct/style/palette三种用法按需应用水印失败重试一次。Step 6收尾按输出目录设定在对应段落后插入description并输出完成摘要。提示词文件可复现配图的关键prompt-construction.md 定义了提示词文件的格式与质量要求。每个提示词文件是YAML frontmatter 类型化模板正文--- illustration_id: 01 type: infographic style: blueprint references: # 仅当文件真实存在于 references/ 目录时才填写 - ref_id: 01 filename: 01-ref-diagram.png usage: direct # direct | style | palette ---类型化模板按 Type 区分infographic 用 ZONES / LABELS / COLORS / STYLE / ASPECT 结构scene 用 FOCAL POINT / ATMOSPHERE / MOODflowchart 用 STEPS / CONNECTIONScomparison 用左右分栏framework 用 NODES / RELATIONSHIPStimeline 用 EVENTS / MARKERS。prompt-construction.md 同时给出了各主流风格组合的完整示例模板例如默认的 Infographic sketch-notes macaron 长模板可直接照抄修改。六条通用质量规则同样构成硬性要求布局结构先行、使用文章中的真实数据/术语禁止占位符、描述元素间视觉关系、颜色语义化红警告、绿高效、体现风格特征、以宽高比收尾如16:9。另有三条普适性附加句干净构图留白、颜色 hex 仅供渲染参考禁止把色名/hex 画成文字、人物采用简化剪影而非写实面部。若启用水印则在提示词末尾追加Include a subtle watermark [content] positioned at [position].后端解析与批量生成策略图片渲染依赖具体后端SKILL.md 定义了严格的解析顺序当前请求显式指定 EXTEND.md 的preferred_image_backend固定值 自动选择运行时原生工具优先Codex 的imagegen、Cursor 的GenerateImage、Hermes 的image_generate等否则用唯一已安装的非原生后端多个时询问用户。文档特别强调绝不使用 SVG、HTML、canvas 等代码式渲染冒充位图生成且不允许用程序化方式在成品位图上覆盖、改写文字文字错了就改提示词重新生成。当解析结果为codex-imagegen时codex-imagegen.md 提供了两种调用形态优先经baoyu-image-gen --provider codex-cli路由兜底则直接 spawn 包装器packages/baoyu-codex-imagegen/src/main.ts其 stdout 约定为单行 JSON成功{status:ok,...}/ 失败{status:error,...}并定义了 11 种error_kind错误码。EXTEND.md 偏好配置所有持久化偏好集中在 EXTEND.md完整 schema 见 preferences-schema.md。核心字段字段默认值说明version1Schema 版本watermark.enabledfalse是否启用水印watermark.content水印文字如 用户名watermark.positionbottom-right水印位置bottom-right/bottom-left/bottom-center/top-rightpreferred_style.namenull首选风格preferred_palettenull调色板覆盖macaron/warm/neon/mono-inklanguagenull输出语言zh/en/ja/ko/autodefault_output_dirnull输出目录偏好same-dir/illustrations-subdir/independentfirst-time-setup 推荐 imgs-subdirpreferred_image_backendauto后端选择策略ask 每次确认backend-id 固定后端generation_batch_size4每批并发生成数1-8越界钳制custom_styles[]用户自定义风格含 name/description/color_palette/visual_elements/typography/best_for常用的一行式修改SKILL.md Changing Preferences 一节包括preferred_image_backend: codex-imagegen固定后端、generation_batch_size: 4调整并发、preferred_type/preferred_style/preferred_palette/language固定默认维度、default_output_dir: imgs-subdir指定输出位置。需要注意default_output_dir若设为 null则每次运行都会询问first-time-setup 的推荐值是imgs-subdir而 usage.md 示例中出现的illustrations-subdir只是可选项之一。修改偏好的三种途径是直接编辑 EXTEND.md、删除后触发交互式重配置、或使用上述一行式编辑。相关参考文档文件内容usage.md命令语法与参数速查SKILL.md技能主文档三维度、类型表、工作流、后端解析、修改偏好workflow.md六步详细流程参考图、确认门禁、大纲、批量执行、收尾styles.md风格画廊 调色板画廊 Type × Style 兼容矩阵 按内容信号自动选择style-presets.md预设速查表与内容类型 → 预设推荐prompt-construction.md提示词文件格式、类型化模板与质量规则first-time-setup.md首次安装流程与 EXTEND.md 模板preferences-schema.mdEXTEND.md 完整 YAML schemacodex-imagegen.mdcodex-imagegen 后端包装器调用契约赞分享AI 技能AI 插件【免费下载链接】baoyu-skills项目地址https://gitcode.com/gh_mirrors/ba/baoyu-skills点击查看免费下载相关推荐baoyu-article-illustrator 水彩风格watercolor完全指南配色、构图规则与实战调用baoyu article illustrator 水彩风格watercolor完全指南配色、构图规则与实战调用 水彩watercolor是 baoyAI 技能AI 插件baoyu-article-illustrator 调色板实战neon 霓虹暗色配色的完整解析与应用指南baoyu article illustrator 调色板实战neon 霓虹暗色配色的完整解析与应用指南 本文聚焦开源仓库 baoyu skills 中文章配AI 技能AI 插件终极指南如何在Windows上直接安装安卓应用APK安装器完整教程终极指南如何在Windows上直接安装安卓应用APK安装器完整教程 想在Windows电脑上直接运行安卓应用却厌倦了笨重缓慢的模拟器APK安装器为你提供AI 技能AI 插件上一篇NES.css字体兼容性测试报告下一篇深度剖析Llama 3模型架构从零构建高效推理引擎实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考