baoyu-xhs-images 偏好配置完全指南EXTEND.md YAML Schema 详解与实战【免费下载链接】baoyu-skills项目地址: https://gitcode.com/gh_mirrors/ba/baoyu-skills本文围绕 baoyu-skills 仓库中小红书图片卡片生成技能 baoyu-xhs-images 的用户偏好配置文件 EXTEND.md系统讲解其 YAML Schema 的完整字段、取值约束、解析顺序与生效机制并结合 SKILL.md 的工作流与源码级行为说明每个配置项如何影响实际的出图过程。读完本文你将能够独立编写、校验与维护自己的 EXTEND.md精准控制水印、风格、布局、语言、图片后端与批量生成行为让小红书图文卡片系列按你的固定偏好稳定产出。一、EXTEND.md 是什么偏好配置在技能中的角色baoyu-xhs-images 是 baoyu-skills 中面向小红书XHS内容场景的图像卡片系列生成技能它将复杂内容拆解为 110 张信息图卡片支持 12 种视觉风格、8 种布局与 3 套可选配色最终产出适合社交媒体传播的图片卡片序列。与一次性通过命令行参数指定选项不同技能允许用户通过EXTEND.md持久化一套长期偏好让每次运行自动遵循既定设置。该配置文件的作用在 SKILL.md 的工作流中体现得非常明确- [ ] Step 0: Load EXTEND.md ⛔ BLOCKING (interactive only) - [ ] Step 1: Analyze content → analysis.md - [ ] Step 2: Smart Confirm ⚠️ REQUIRED (Path A / B / C) - [ ] Step 3: Generate images - [ ] Step 4: Completion reportStep 0 是一个阻塞步骤交互式运行时必须先读取并解析 EXTEND.md输出偏好摘要风格 / 布局 / 水印 / 语言之后才能进入内容分析。若找不到 EXTEND.md 且处于交互模式则必须先执行首次配置流程见 first-time-setup.md在任何内容分析或风格提问之前完成偏好落盘——这保证了首次运行的路径完全可预测。EXTEND.md 的查找路径按顺序命中即用路径作用域.baoyu-skills/baoyu-xhs-images/EXTEND.md项目级仅当前项目${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-xhs-images/EXTEND.mdXDG 配置目录$HOME/.baoyu-skills/baoyu-xhs-images/EXTEND.md用户级所有项目关键行为若 EXTEND.md 不存在且使用--yes非交互模式则跳过配置流程使用内置默认值无水印、风格/布局自动选择、语言随内容既不提问也不创建 EXTEND.md。EXTEND.md 中可配置的键包括水印、首选风格/布局、自定义风格定义、语言偏好、首选图像后端、批量生成大小。其完整 Schema 正是本文核心记录于 preferences-schema.md。二、完整 Schema 与逐字段详解以下为 EXTEND.md 的完整 YAML 骨架来源preferences-schema.md--- version: 1 watermark: enabled: false content: position: bottom-right # bottom-right|bottom-left|bottom-center|top-right preferred_style: name: null # Built-in or custom style name description: # Override/notes preferred_layout: null # sparse|balanced|dense|list|comparison|flow language: null # zh|en|ja|ko|auto preferred_image_backend: auto # auto|ask|backend-id generation_batch_size: 4 # 1-8, used when backend/runtime supports batch or parallel generation custom_styles: - name: my-style description: Style description color_palette: primary: [#FED7E2, #FEEBC8] background: #FFFAF0 accents: [#FF69B4, #FF6B6B] visual_elements: Hearts, stars, sparkles typography: Rounded, bubbly hand lettering best_for: Lifestyle, beauty ---字段速查表字段类型默认值说明versionint1Schema 版本号watermark.enabledboolfalse是否启用水印watermark.contentstring水印文本如username或自定义文本watermark.positionenumbottom-right水印在图片上的位置preferred_style.namestringnull风格名称或 nullnull 表示自动选择preferred_style.descriptionstring自定义备注/覆盖说明preferred_layoutstringnull布局偏好或 nullnull 表示自动选择languagestringnull输出语言null 自动检测preferred_image_backendstringauto图像后端选择策略详见下节generation_batch_sizeint4每批派发的图片数量非法值钳制到 1-8当前请求可覆盖custom_stylesarray[]用户自定义风格定义列表versionSchema 版本当前取值为1。它是配置文件的元信息字段用于向后兼容与解析器版本判断升级 Schema 时可通过它区分不同版本的配置格式。watermark水印三件套子字段类型默认值说明watermark.enabledboolfalse是否在生成提示词中附加水印指令watermark.contentstring水印文字内容watermark.positionenumbottom-right水印位置水印启用后会在每个图像生成提示词末尾追加如下指令见 SKILL.md 的 Step 3 与 watermark-guide.mdInclude a subtle watermark [content] positioned at [position]. The watermark should be legible but not distracting.注意水印是通过生成提示词实现的而非生成后的程序化叠加。这一点与技能的另一条硬性规则一致——SKILL.md 明确禁止用 ImageMagick、Pillow、Canvas 等手段对已生成的位图做文字修补或覆盖如果文字渲染有误应修正提示词重新生成而不是对图片进行后期绘制。preferred_style首选风格子字段类型默认值说明preferred_style.namestringnull内置或自定义风格名称null 表示由内容分析自动选择preferred_style.descriptionstring备注或对自动选择的覆盖说明内置风格共 12 种来自 SKILL.md风格描述cute默认甜美、可爱、少女风fresh清爽、清新、自然warm温暖、亲切、易接近bold高冲击力、抓眼球minimal极简、精致retro复古、怀旧、流行pop鲜艳、活力、吸睛notion极简手绘线条艺术、知识感chalkboard黑板彩色粉笔、教育感study-notes写实手写照片风蓝笔 红批注 黄高亮screen-print大胆海报艺术、半调纹理、限量配色、符号化叙事sketch-notes手绘教育信息图奶油底 马卡龙粉彩 抖动线条每种风格的具体元素组合与最佳搭配参见 presets 目录例如notion风格定义了三档 canvasportrait-3-4、单/双栏网格、无描边或白实描边、黑白/药丸标签、手绘线条与曲线箭头装饰以及黑灰主色 纯白/米白背景 粉彩蓝黄粉点缀色的配色方案。preferred_layout首选布局取值为sparse|balanced|dense|list|comparison|flow之一或null自动选择。SKILL.md 定义了 8 种布局其中 Schema 注释中列出的 6 种对应信息密度类与结构类布局另有mindmap、quadrant两种也可在命令行使用布局信息密度留白每图要点数最佳场景sparse默认低60-70%1-2封面、金句、冲击力表达balanced中40-50%3-4标准内容、教程dense高20-30%5-8知识卡、速查表list——4-7 项排行、清单、步骤comparison——左右两栏前后对比、优缺点flow——3-6 步流程、时间线、工作流mindmap——4-8 分支概念图、头脑风暴quadrant——4 个区块SWOT、优先级矩阵、分类布局网格、安全区与视觉平衡规范详见 canvas.md。language输出语言取值为zh|en|ja|ko|auto或null。null等价于自动检测——技能在 Step 1 内容分析时检测源语言并据此确定输出语言。SKILL.md 同时规定在提问、进度、错误与完成摘要中始终使用用户的语言但风格名、文件路径、代码等技术性 token 保持英文。因此该配置只影响文案语言不影响风格与布局等英文标识符。preferred_image_backend图像后端选择策略这是 Schema 中最复杂、行为最丰富的字段。取值分三档取值行为auto默认优先运行时原生工具否则回退到唯一已安装的后端若存在多个非原生后端则询问用户ask每次运行都强制确认后端backend-id如codex-imagegen、baoyu-image-gen、image_generate固定使用该后端可用时不可用时回退到auto行为字段缺失时等价于auto。其完整解析逻辑记录于 SKILL.md 的## Image Generation Tools章节解析顺序为当前请求覆盖——用户在当前消息中显式指定了后端则优先已保存偏好——EXTEND.md 中preferred_image_backend指向当前可用后端则使用自动选择偏好为auto、未设置、或固定后端不可用时Codeximagegen若运行时可列出名为imagegen的技能说明正运行在 Codex 内必须通过Skill工具以skill: imagegen调用这是该运行时中官方位图后端优先级高于任何非原生技能如baoyu-image-gen除非用户显式固定了其他后端Codex viacodex execcodex-imagegen无原生imagegen技能但codexCLI 在 PATH 且已codex login时优先经baoyu-image-gen --provider codex-cli路由否则直接调用内置包装器详见 codex-imagegen.mdCursorGenerateImage暴露原生GenerateImage工具时使用注意该工具无宽高比参数须在description提示词文本中显式声明目标宽高比/尺寸且不接受输出目录生成后需将文件复制到预期输出路径其他运行时原生工具如 Hermesimage_generate同法使用否则若恰好安装一个非原生后端如baoyu-image-gen直接使用否则存在多个非原生后端且无运行时原生工具向用户询问一次并与其他初始问题合并批量提出。若均不可用告知用户并询问如何处理。需要特别强调的是两条禁止性规则第一绝不使用 SVG、HTML、Canvas 或其他基于代码的渲染替代位图生成若第 3 步无法解析到位图后端必须落到第 4 步询问用户不得静默产出svg或 HTML/CSS 图形第二绝不通过程序化覆盖ImageMagick、Pillow、Canvas、OCR 脚本等修复已生成位图中的文字文字有误必须从修正提示词重新生成。将preferred_image_backend设为ask会强制每次运行都出现第 3 步的询问与可用后端无关。generation_batch_size批量生成大小默认4表示在后端支持原生批量或运行时支持并行工具调用时每批最多派发多少张图片。非法值会被钳制到 1-8。当前用户请求如命令行--batch-size 4或消息中并行 4 张一起生成可覆盖该值仅对本次运行生效。该字段的消费逻辑见 SKILL.md 的## Batch Generation Policy优先使用所选后端的原生批量/多任务接口每个任务需独立保存提示词文件、输出路径、宽高比、会话 ID 与直接参考图若无原生批量接口但运行时支持并行工具调用则按generation_batch_size张一批派发默认 4两者皆无时退回顺序生成。批量规则还包括首图锚点链先单独生成 image 1再以 image 1 作为参考批量生成后续图每批开始前必须确保该批所有提示词文件已落盘失败项仅重试一次且不重新生成成功项不得仅为了并行渲染而使用子代理子代理只用于独立的提示词迭代或创意探索。以codex-imagegen为例其批量语义是每次调用只返回一张图n1且包装器不接受--sessionId因此多图任务必须每图一次调用系列一致性只能依靠--ref参考图链实现详见 codex-imagegen.md。custom_styles自定义风格custom_styles是一个对象数组允许用户在不修改内置风格的前提下定义自己的风格。每个元素包含以下字段字段必填说明name是唯一风格标识符kebab-case如my-styledescription是该风格传达的视觉语义color_palette.primary否主色数组color_palette.background否背景色color_palette.accents否强调色数组visual_elements否装饰元素描述typography否字体/手写风格描述best_for否推荐的内容类型自定义风格定义后会进入preferred_style.name的候选集合也可在后续会话中直接按名称引用。三、位置选项水印与关键内容的避让关系watermark.position支持四个枚举值值说明bottom-right右下角默认最常见bottom-left左下角bottom-center底部居中top-right右上角位置选择并非任意需要与画布安全区配合考虑。根据 canvas.md小红书图片存在三块应避让关键内容的区域安全区位置原因bottom-overlay底部 10%移动端标题栏悬浮层top-right右上角点赞/分享按钮悬浮层bottom-right右下角水印默认位置watermark-guide.md 进一步给出位置建议位置最佳场景应避免的情况bottom-right默认选择最通用关键信息位于右下时bottom-left右侧偏重的布局关键信息位于左下时bottom-center居中构图设计底部文字密集时top-right底部内容偏重时标题/头部位于右上时水印内容格式也直接影响观感与转化格式示例适用场景账号句柄username小红书最常见品牌文本MyBrand简单品牌露出中文标识小红书:用户名平台特定场景URLmyblog.com跨平台引流水印的最佳实践同一系列所有图片使用相同水印一致性在深色与浅色区域均保持可读清晰度尺寸克制、不喧宾夺主轻量感。常见问题与对策水印不可见时调整位置或对比度水印过于突出时更换位置或减小尺寸水印与内容重叠时更换位置系列内水印位置不一致时使用会话 ID 保证统一。四、配置示例从最小集到全量配置最小偏好示例仅启用水印并指定首选风格其余全部走默认--- version: 1 watermark: enabled: true content: myusername preferred_style: name: notion ---完整偏好示例--- version: 1 watermark: enabled: true content: myxhsaccount position: bottom-right preferred_style: name: notion description: Clean knowledge cards for tech content preferred_layout: dense language: zh preferred_image_backend: codex-imagegen generation_batch_size: 4 custom_styles: - name: corporate description: Professional B2B style color_palette: primary: [#1E3A5F, #4A90D9] background: #F5F7FA accents: [#00B4D8, #48CAE4] visual_elements: Clean lines, subtle gradients, geometric shapes typography: Modern sans-serif, professional best_for: Business, SaaS, enterprise ---首次配置生成的模板首次配置流程first-time-setup.md只会询问三个问题水印文本默认无、首选风格默认自动、保存位置项目级或用户级随后按如下模板落盘--- version: 1 watermark: enabled: [true/false] content: [user input or empty] position: bottom-right opacity: 0.7 preferred_style: name: [selected style or null] description: preferred_layout: null language: null preferred_image_backend: auto generation_batch_size: 4 custom_styles: [] ---注意两点preferred_image_backend: auto是内置默认值首次配置不会询问后端generation_batch_size: 4同样是内置默认。需要调整时通过## Changing Preferences提供的编辑方式手动修改。五、偏好的优先级配置如何被覆盖EXTEND.md 中的偏好并不是最终决定存在明确的优先级阶梯当前请求 已保存偏好 自动选择。以图像后端为例用户消息中显式指定的后端 preferred_image_backend指向的可用后端 auto解析逻辑见第二节。generation_batch_size同样可被当前请求覆盖命令行--batch-size 4或消息中的并行指令优先于 EXTEND.md 中的值且都钳制在 1-8。命令行显式标志覆盖预设preset在 style-presets.md 中--preset X是风格 布局 可选配色的快捷组合如hand-drawn-edu sketch-notes flow macaron但显式的--style/--layout/--palette标志总是覆盖预设中的对应维度例如--preset knowledge-card --style chalkboard等于 chalkboard 风格 dense 布局。--yes模式跳过所有确认使用 EXTEND.md 或内置默认值自动确认推荐方案Path A若 EXTEND.md 不存在则连配置流程也跳过全部使用内置默认。六、修改偏好的三种方式按 SKILL.md 的## Changing Preferences章节修改 EXTEND.md 有三种途径直接编辑打开对应路径的 EXTEND.md按 Schema 修改字段完整 Schema 见 preferences-schema.md。交互式重配删除 EXTEND.md或在对话中说reconfigure baoyu-xhs-images preferences / 重新配置下一次运行会重新触发首次配置流程。常用单行修改直接针对本文讲解的字段编辑内容效果preferred_image_backend: auto默认策略运行时原生工具优先回退到唯一已安装后端多个非原生后端时询问preferred_image_backend: codex-imagegen固定使用 Codex 内置后端preferred_image_backend: baoyu-image-gen固定使用 baoyu-image-gen 技能preferred_image_backend: ask每次运行都确认后端generation_batch_size: 4后端/运行时支持批量或并行时每批渲染的默认图片数preferred_style: notion、preferred_layout: dense、preferred_palette: macaron、language: zh风格、布局、配色、语言偏好watermark.enabled: truewatermark.content: handle追加水印注意EXTEND.md 中的键以watermark、preferred_style、preferred_layout、language、preferred_image_backend、generation_batch_size、custom_styles为准preferred_palette在上述说明中出现但 Schema 字段表中并未列出独立 palette 字段——配色可通过命令行--palette、预设或自定义风格中的color_palette表达。七、配置与出图流程的联动一个完整视角为了让偏好配置的价值落到实处最后梳理 EXTEND.md 各字段在 SKILL.md 全流程中的消费点Step 0加载配置按路径优先级读取 EXTEND.md解析后打印风格/布局/水印/语言摘要交互模式下缺失则先执行首次配置。Step 1内容分析language或 null 自动检测决定输出语言内容信号结合preferred_style/preferred_layout参与自动推荐Auto-Selection 表匹配未命中时回退到cute-share预设。Step 2智能确认Path A 直接采用推荐方案可被命令行--style/--layout/--palette/--preset覆盖Path B 批量询问五个问题策略风格、布局、配色、张数、备注留空即保留推荐值Path C 生成 A/B/C 三份不同结构、不同推荐风格的大纲变体供选择每份变体前端包含style_reason说明风格与策略的契合理由模板见 confirmation.md。Step 3生成图片preferred_image_backend决定后端解析generation_batch_size决定并行批次watermark三件套决定是否及如何附加水印指令图片 1 先以无--ref方式生成作为锚点后续图片以图片 1 为--ref批量生成以保证角色/吉祥物/色彩渲染的一致性若后端支持--sessionId统一使用cards-{topic-slug}-{timestamp}以获得最大一致性。Step 4完成报告汇总主题、模式、策略、风格、配色、布局、输出目录与图片清单。八、实践建议与常见误区基于上述机制总结几条实践建议把 EXTEND.md 视为全局默认值而非每次运行的硬约束风格、布局、张数等仍会在 Step 2 确认环节被展示与调整配置的作用是减少每次重复输入的摩擦而不是锁定输出。水印位置与内容排布联动考虑默认bottom-right与安全区规则有潜在重叠右下角既是水印位也常是关键内容区若封面右下有重要信息应改用bottom-left或top-right。固定后端前先确认运行时preferred_image_backend的固定值只在当前可用时生效不可用会自动回退到auto在混合运行时Codex / Cursor / Hermes / 通用 CLI环境下ask可能比固定某个后端更稳妥。批量大小不是越大越好generation_batch_size只在后端原生批量或运行时并行调用时生效且钳制在 1-8同时受首图锚点链约束——必须先单独生成图片 1再批量生成 2因此实际并行窗口与系列结构相关。自定义风格的name必须唯一且为 kebab-case它是后续preferred_style.name引用与命令行--style引用的标识符description必填因为它会进入提示词组装直接决定生成效果。提示词文件是先于一切后端的准入门槛无论偏好如何配置每个图片的完整最终提示词必须先行写入prompts/NN-{type}-{slug}.mdSKILL.md 称之为硬性要求这是可复现性的记录也让你能切换后端而无需重写提示词。EXTEND.md 的 Schema 设计体现了配置即偏好、请求即覆盖、提示词即真相的整体理念Schema 负责持久化命令行与当前消息负责覆盖而落盘的提示词文件负责保证生成过程可复现。理解这三层关系就能在 baoyu-xhs-images 上构建出高度个人化且稳定可靠的图片卡片流水线。【免费下载链接】baoyu-skills项目地址: https://gitcode.com/gh_mirrors/ba/baoyu-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
baoyu-xhs-images 偏好配置完全指南：EXTEND.md YAML Schema 详解与实战
baoyu-xhs-images 偏好配置完全指南EXTEND.md YAML Schema 详解与实战【免费下载链接】baoyu-skills项目地址: https://gitcode.com/gh_mirrors/ba/baoyu-skills本文围绕 baoyu-skills 仓库中小红书图片卡片生成技能 baoyu-xhs-images 的用户偏好配置文件 EXTEND.md系统讲解其 YAML Schema 的完整字段、取值约束、解析顺序与生效机制并结合 SKILL.md 的工作流与源码级行为说明每个配置项如何影响实际的出图过程。读完本文你将能够独立编写、校验与维护自己的 EXTEND.md精准控制水印、风格、布局、语言、图片后端与批量生成行为让小红书图文卡片系列按你的固定偏好稳定产出。一、EXTEND.md 是什么偏好配置在技能中的角色baoyu-xhs-images 是 baoyu-skills 中面向小红书XHS内容场景的图像卡片系列生成技能它将复杂内容拆解为 110 张信息图卡片支持 12 种视觉风格、8 种布局与 3 套可选配色最终产出适合社交媒体传播的图片卡片序列。与一次性通过命令行参数指定选项不同技能允许用户通过EXTEND.md持久化一套长期偏好让每次运行自动遵循既定设置。该配置文件的作用在 SKILL.md 的工作流中体现得非常明确- [ ] Step 0: Load EXTEND.md ⛔ BLOCKING (interactive only) - [ ] Step 1: Analyze content → analysis.md - [ ] Step 2: Smart Confirm ⚠️ REQUIRED (Path A / B / C) - [ ] Step 3: Generate images - [ ] Step 4: Completion reportStep 0 是一个阻塞步骤交互式运行时必须先读取并解析 EXTEND.md输出偏好摘要风格 / 布局 / 水印 / 语言之后才能进入内容分析。若找不到 EXTEND.md 且处于交互模式则必须先执行首次配置流程见 first-time-setup.md在任何内容分析或风格提问之前完成偏好落盘——这保证了首次运行的路径完全可预测。EXTEND.md 的查找路径按顺序命中即用路径作用域.baoyu-skills/baoyu-xhs-images/EXTEND.md项目级仅当前项目${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-xhs-images/EXTEND.mdXDG 配置目录$HOME/.baoyu-skills/baoyu-xhs-images/EXTEND.md用户级所有项目关键行为若 EXTEND.md 不存在且使用--yes非交互模式则跳过配置流程使用内置默认值无水印、风格/布局自动选择、语言随内容既不提问也不创建 EXTEND.md。EXTEND.md 中可配置的键包括水印、首选风格/布局、自定义风格定义、语言偏好、首选图像后端、批量生成大小。其完整 Schema 正是本文核心记录于 preferences-schema.md。二、完整 Schema 与逐字段详解以下为 EXTEND.md 的完整 YAML 骨架来源preferences-schema.md--- version: 1 watermark: enabled: false content: position: bottom-right # bottom-right|bottom-left|bottom-center|top-right preferred_style: name: null # Built-in or custom style name description: # Override/notes preferred_layout: null # sparse|balanced|dense|list|comparison|flow language: null # zh|en|ja|ko|auto preferred_image_backend: auto # auto|ask|backend-id generation_batch_size: 4 # 1-8, used when backend/runtime supports batch or parallel generation custom_styles: - name: my-style description: Style description color_palette: primary: [#FED7E2, #FEEBC8] background: #FFFAF0 accents: [#FF69B4, #FF6B6B] visual_elements: Hearts, stars, sparkles typography: Rounded, bubbly hand lettering best_for: Lifestyle, beauty ---字段速查表字段类型默认值说明versionint1Schema 版本号watermark.enabledboolfalse是否启用水印watermark.contentstring水印文本如username或自定义文本watermark.positionenumbottom-right水印在图片上的位置preferred_style.namestringnull风格名称或 nullnull 表示自动选择preferred_style.descriptionstring自定义备注/覆盖说明preferred_layoutstringnull布局偏好或 nullnull 表示自动选择languagestringnull输出语言null 自动检测preferred_image_backendstringauto图像后端选择策略详见下节generation_batch_sizeint4每批派发的图片数量非法值钳制到 1-8当前请求可覆盖custom_stylesarray[]用户自定义风格定义列表versionSchema 版本当前取值为1。它是配置文件的元信息字段用于向后兼容与解析器版本判断升级 Schema 时可通过它区分不同版本的配置格式。watermark水印三件套子字段类型默认值说明watermark.enabledboolfalse是否在生成提示词中附加水印指令watermark.contentstring水印文字内容watermark.positionenumbottom-right水印位置水印启用后会在每个图像生成提示词末尾追加如下指令见 SKILL.md 的 Step 3 与 watermark-guide.mdInclude a subtle watermark [content] positioned at [position]. The watermark should be legible but not distracting.注意水印是通过生成提示词实现的而非生成后的程序化叠加。这一点与技能的另一条硬性规则一致——SKILL.md 明确禁止用 ImageMagick、Pillow、Canvas 等手段对已生成的位图做文字修补或覆盖如果文字渲染有误应修正提示词重新生成而不是对图片进行后期绘制。preferred_style首选风格子字段类型默认值说明preferred_style.namestringnull内置或自定义风格名称null 表示由内容分析自动选择preferred_style.descriptionstring备注或对自动选择的覆盖说明内置风格共 12 种来自 SKILL.md风格描述cute默认甜美、可爱、少女风fresh清爽、清新、自然warm温暖、亲切、易接近bold高冲击力、抓眼球minimal极简、精致retro复古、怀旧、流行pop鲜艳、活力、吸睛notion极简手绘线条艺术、知识感chalkboard黑板彩色粉笔、教育感study-notes写实手写照片风蓝笔 红批注 黄高亮screen-print大胆海报艺术、半调纹理、限量配色、符号化叙事sketch-notes手绘教育信息图奶油底 马卡龙粉彩 抖动线条每种风格的具体元素组合与最佳搭配参见 presets 目录例如notion风格定义了三档 canvasportrait-3-4、单/双栏网格、无描边或白实描边、黑白/药丸标签、手绘线条与曲线箭头装饰以及黑灰主色 纯白/米白背景 粉彩蓝黄粉点缀色的配色方案。preferred_layout首选布局取值为sparse|balanced|dense|list|comparison|flow之一或null自动选择。SKILL.md 定义了 8 种布局其中 Schema 注释中列出的 6 种对应信息密度类与结构类布局另有mindmap、quadrant两种也可在命令行使用布局信息密度留白每图要点数最佳场景sparse默认低60-70%1-2封面、金句、冲击力表达balanced中40-50%3-4标准内容、教程dense高20-30%5-8知识卡、速查表list——4-7 项排行、清单、步骤comparison——左右两栏前后对比、优缺点flow——3-6 步流程、时间线、工作流mindmap——4-8 分支概念图、头脑风暴quadrant——4 个区块SWOT、优先级矩阵、分类布局网格、安全区与视觉平衡规范详见 canvas.md。language输出语言取值为zh|en|ja|ko|auto或null。null等价于自动检测——技能在 Step 1 内容分析时检测源语言并据此确定输出语言。SKILL.md 同时规定在提问、进度、错误与完成摘要中始终使用用户的语言但风格名、文件路径、代码等技术性 token 保持英文。因此该配置只影响文案语言不影响风格与布局等英文标识符。preferred_image_backend图像后端选择策略这是 Schema 中最复杂、行为最丰富的字段。取值分三档取值行为auto默认优先运行时原生工具否则回退到唯一已安装的后端若存在多个非原生后端则询问用户ask每次运行都强制确认后端backend-id如codex-imagegen、baoyu-image-gen、image_generate固定使用该后端可用时不可用时回退到auto行为字段缺失时等价于auto。其完整解析逻辑记录于 SKILL.md 的## Image Generation Tools章节解析顺序为当前请求覆盖——用户在当前消息中显式指定了后端则优先已保存偏好——EXTEND.md 中preferred_image_backend指向当前可用后端则使用自动选择偏好为auto、未设置、或固定后端不可用时Codeximagegen若运行时可列出名为imagegen的技能说明正运行在 Codex 内必须通过Skill工具以skill: imagegen调用这是该运行时中官方位图后端优先级高于任何非原生技能如baoyu-image-gen除非用户显式固定了其他后端Codex viacodex execcodex-imagegen无原生imagegen技能但codexCLI 在 PATH 且已codex login时优先经baoyu-image-gen --provider codex-cli路由否则直接调用内置包装器详见 codex-imagegen.mdCursorGenerateImage暴露原生GenerateImage工具时使用注意该工具无宽高比参数须在description提示词文本中显式声明目标宽高比/尺寸且不接受输出目录生成后需将文件复制到预期输出路径其他运行时原生工具如 Hermesimage_generate同法使用否则若恰好安装一个非原生后端如baoyu-image-gen直接使用否则存在多个非原生后端且无运行时原生工具向用户询问一次并与其他初始问题合并批量提出。若均不可用告知用户并询问如何处理。需要特别强调的是两条禁止性规则第一绝不使用 SVG、HTML、Canvas 或其他基于代码的渲染替代位图生成若第 3 步无法解析到位图后端必须落到第 4 步询问用户不得静默产出svg或 HTML/CSS 图形第二绝不通过程序化覆盖ImageMagick、Pillow、Canvas、OCR 脚本等修复已生成位图中的文字文字有误必须从修正提示词重新生成。将preferred_image_backend设为ask会强制每次运行都出现第 3 步的询问与可用后端无关。generation_batch_size批量生成大小默认4表示在后端支持原生批量或运行时支持并行工具调用时每批最多派发多少张图片。非法值会被钳制到 1-8。当前用户请求如命令行--batch-size 4或消息中并行 4 张一起生成可覆盖该值仅对本次运行生效。该字段的消费逻辑见 SKILL.md 的## Batch Generation Policy优先使用所选后端的原生批量/多任务接口每个任务需独立保存提示词文件、输出路径、宽高比、会话 ID 与直接参考图若无原生批量接口但运行时支持并行工具调用则按generation_batch_size张一批派发默认 4两者皆无时退回顺序生成。批量规则还包括首图锚点链先单独生成 image 1再以 image 1 作为参考批量生成后续图每批开始前必须确保该批所有提示词文件已落盘失败项仅重试一次且不重新生成成功项不得仅为了并行渲染而使用子代理子代理只用于独立的提示词迭代或创意探索。以codex-imagegen为例其批量语义是每次调用只返回一张图n1且包装器不接受--sessionId因此多图任务必须每图一次调用系列一致性只能依靠--ref参考图链实现详见 codex-imagegen.md。custom_styles自定义风格custom_styles是一个对象数组允许用户在不修改内置风格的前提下定义自己的风格。每个元素包含以下字段字段必填说明name是唯一风格标识符kebab-case如my-styledescription是该风格传达的视觉语义color_palette.primary否主色数组color_palette.background否背景色color_palette.accents否强调色数组visual_elements否装饰元素描述typography否字体/手写风格描述best_for否推荐的内容类型自定义风格定义后会进入preferred_style.name的候选集合也可在后续会话中直接按名称引用。三、位置选项水印与关键内容的避让关系watermark.position支持四个枚举值值说明bottom-right右下角默认最常见bottom-left左下角bottom-center底部居中top-right右上角位置选择并非任意需要与画布安全区配合考虑。根据 canvas.md小红书图片存在三块应避让关键内容的区域安全区位置原因bottom-overlay底部 10%移动端标题栏悬浮层top-right右上角点赞/分享按钮悬浮层bottom-right右下角水印默认位置watermark-guide.md 进一步给出位置建议位置最佳场景应避免的情况bottom-right默认选择最通用关键信息位于右下时bottom-left右侧偏重的布局关键信息位于左下时bottom-center居中构图设计底部文字密集时top-right底部内容偏重时标题/头部位于右上时水印内容格式也直接影响观感与转化格式示例适用场景账号句柄username小红书最常见品牌文本MyBrand简单品牌露出中文标识小红书:用户名平台特定场景URLmyblog.com跨平台引流水印的最佳实践同一系列所有图片使用相同水印一致性在深色与浅色区域均保持可读清晰度尺寸克制、不喧宾夺主轻量感。常见问题与对策水印不可见时调整位置或对比度水印过于突出时更换位置或减小尺寸水印与内容重叠时更换位置系列内水印位置不一致时使用会话 ID 保证统一。四、配置示例从最小集到全量配置最小偏好示例仅启用水印并指定首选风格其余全部走默认--- version: 1 watermark: enabled: true content: myusername preferred_style: name: notion ---完整偏好示例--- version: 1 watermark: enabled: true content: myxhsaccount position: bottom-right preferred_style: name: notion description: Clean knowledge cards for tech content preferred_layout: dense language: zh preferred_image_backend: codex-imagegen generation_batch_size: 4 custom_styles: - name: corporate description: Professional B2B style color_palette: primary: [#1E3A5F, #4A90D9] background: #F5F7FA accents: [#00B4D8, #48CAE4] visual_elements: Clean lines, subtle gradients, geometric shapes typography: Modern sans-serif, professional best_for: Business, SaaS, enterprise ---首次配置生成的模板首次配置流程first-time-setup.md只会询问三个问题水印文本默认无、首选风格默认自动、保存位置项目级或用户级随后按如下模板落盘--- version: 1 watermark: enabled: [true/false] content: [user input or empty] position: bottom-right opacity: 0.7 preferred_style: name: [selected style or null] description: preferred_layout: null language: null preferred_image_backend: auto generation_batch_size: 4 custom_styles: [] ---注意两点preferred_image_backend: auto是内置默认值首次配置不会询问后端generation_batch_size: 4同样是内置默认。需要调整时通过## Changing Preferences提供的编辑方式手动修改。五、偏好的优先级配置如何被覆盖EXTEND.md 中的偏好并不是最终决定存在明确的优先级阶梯当前请求 已保存偏好 自动选择。以图像后端为例用户消息中显式指定的后端 preferred_image_backend指向的可用后端 auto解析逻辑见第二节。generation_batch_size同样可被当前请求覆盖命令行--batch-size 4或消息中的并行指令优先于 EXTEND.md 中的值且都钳制在 1-8。命令行显式标志覆盖预设preset在 style-presets.md 中--preset X是风格 布局 可选配色的快捷组合如hand-drawn-edu sketch-notes flow macaron但显式的--style/--layout/--palette标志总是覆盖预设中的对应维度例如--preset knowledge-card --style chalkboard等于 chalkboard 风格 dense 布局。--yes模式跳过所有确认使用 EXTEND.md 或内置默认值自动确认推荐方案Path A若 EXTEND.md 不存在则连配置流程也跳过全部使用内置默认。六、修改偏好的三种方式按 SKILL.md 的## Changing Preferences章节修改 EXTEND.md 有三种途径直接编辑打开对应路径的 EXTEND.md按 Schema 修改字段完整 Schema 见 preferences-schema.md。交互式重配删除 EXTEND.md或在对话中说reconfigure baoyu-xhs-images preferences / 重新配置下一次运行会重新触发首次配置流程。常用单行修改直接针对本文讲解的字段编辑内容效果preferred_image_backend: auto默认策略运行时原生工具优先回退到唯一已安装后端多个非原生后端时询问preferred_image_backend: codex-imagegen固定使用 Codex 内置后端preferred_image_backend: baoyu-image-gen固定使用 baoyu-image-gen 技能preferred_image_backend: ask每次运行都确认后端generation_batch_size: 4后端/运行时支持批量或并行时每批渲染的默认图片数preferred_style: notion、preferred_layout: dense、preferred_palette: macaron、language: zh风格、布局、配色、语言偏好watermark.enabled: truewatermark.content: handle追加水印注意EXTEND.md 中的键以watermark、preferred_style、preferred_layout、language、preferred_image_backend、generation_batch_size、custom_styles为准preferred_palette在上述说明中出现但 Schema 字段表中并未列出独立 palette 字段——配色可通过命令行--palette、预设或自定义风格中的color_palette表达。七、配置与出图流程的联动一个完整视角为了让偏好配置的价值落到实处最后梳理 EXTEND.md 各字段在 SKILL.md 全流程中的消费点Step 0加载配置按路径优先级读取 EXTEND.md解析后打印风格/布局/水印/语言摘要交互模式下缺失则先执行首次配置。Step 1内容分析language或 null 自动检测决定输出语言内容信号结合preferred_style/preferred_layout参与自动推荐Auto-Selection 表匹配未命中时回退到cute-share预设。Step 2智能确认Path A 直接采用推荐方案可被命令行--style/--layout/--palette/--preset覆盖Path B 批量询问五个问题策略风格、布局、配色、张数、备注留空即保留推荐值Path C 生成 A/B/C 三份不同结构、不同推荐风格的大纲变体供选择每份变体前端包含style_reason说明风格与策略的契合理由模板见 confirmation.md。Step 3生成图片preferred_image_backend决定后端解析generation_batch_size决定并行批次watermark三件套决定是否及如何附加水印指令图片 1 先以无--ref方式生成作为锚点后续图片以图片 1 为--ref批量生成以保证角色/吉祥物/色彩渲染的一致性若后端支持--sessionId统一使用cards-{topic-slug}-{timestamp}以获得最大一致性。Step 4完成报告汇总主题、模式、策略、风格、配色、布局、输出目录与图片清单。八、实践建议与常见误区基于上述机制总结几条实践建议把 EXTEND.md 视为全局默认值而非每次运行的硬约束风格、布局、张数等仍会在 Step 2 确认环节被展示与调整配置的作用是减少每次重复输入的摩擦而不是锁定输出。水印位置与内容排布联动考虑默认bottom-right与安全区规则有潜在重叠右下角既是水印位也常是关键内容区若封面右下有重要信息应改用bottom-left或top-right。固定后端前先确认运行时preferred_image_backend的固定值只在当前可用时生效不可用会自动回退到auto在混合运行时Codex / Cursor / Hermes / 通用 CLI环境下ask可能比固定某个后端更稳妥。批量大小不是越大越好generation_batch_size只在后端原生批量或运行时并行调用时生效且钳制在 1-8同时受首图锚点链约束——必须先单独生成图片 1再批量生成 2因此实际并行窗口与系列结构相关。自定义风格的name必须唯一且为 kebab-case它是后续preferred_style.name引用与命令行--style引用的标识符description必填因为它会进入提示词组装直接决定生成效果。提示词文件是先于一切后端的准入门槛无论偏好如何配置每个图片的完整最终提示词必须先行写入prompts/NN-{type}-{slug}.mdSKILL.md 称之为硬性要求这是可复现性的记录也让你能切换后端而无需重写提示词。EXTEND.md 的 Schema 设计体现了配置即偏好、请求即覆盖、提示词即真相的整体理念Schema 负责持久化命令行与当前消息负责覆盖而落盘的提示词文件负责保证生成过程可复现。理解这三层关系就能在 baoyu-xhs-images 上构建出高度个人化且稳定可靠的图片卡片流水线。【免费下载链接】baoyu-skills项目地址: https://gitcode.com/gh_mirrors/ba/baoyu-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考