关于 baoyu-xhs-images
baoyu-xhs-images 是将复杂内容拆解为多张图文卡片的生成技能,面向制作系列视觉内容的用户。它支持独立选择风格、信息布局和配色,并按批次生成图片。
主要功能
- 01将内容拆解为系列图片卡片
- 02提供 12 种视觉风格
- 03支持 8 种信息布局
- 04可选配色方案与预设
- 05按批次生成并支持参考图
适用场景
- 01把复杂主题整理成知识卡片
- 02制作清单、对比或流程图卡
- 03为社交分享内容生成图片系列
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jimliu/ baoyu-skills --skill baoyu-xhs-images安装后在 Claude Code 中输入/baoyu-xhs-images确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/codex-imagegen.mdconfirmation.mdstyle-presets.mdreferences/config/first-time-setup.mdpreferences-schema.mdwatermark-guide.mdreferences/elements/canvas.mddecorations.mdimage-effects.mdtypography.mdreferences/palettes/macaron.mdneon.mdwarm.mdreferences/presets/bold.mdchalkboard.mdcute.mdfresh.mdminimal.mdnotion.mdpop.mdretro.mdscreen-print.mdsketch-notes.mdstudy-notes.mdwarm.mdreferences/workflows/analysis-framework.mdoutline-template.mdprompt-assembly.md详细介绍
图片卡片系列生成器
将复杂内容拆解为引人注目的图片卡片系列,并提供多种风格选项。
用户输入工具
当此技能向用户提问时,请遵循以下工具选择规则(按优先级排序):
- 优先使用当前 Agent 运行时提供的内置用户输入工具,例如
AskUserQuestion、request_user_input、clarify、ask_user或任何等效工具。 - 回退方案:如果没有此类工具,则发送带编号的纯文本消息,并请用户针对每个问题回复所选编号或答案。
- 批量提问:如果工具支持每次调用提出多个问题,请将所有适用问题合并到一次调用中;如果每次只能提出一个问题,则按优先级逐一提问。
以下 AskUserQuestion 示例仅供参考;在其他运行时中,请替换为本地等效工具。
图像生成工具
当此技能需要渲染图像时,请按以下顺序确定后端:
- 当前请求指定——如果用户在当前消息中指定了某个后端,则使用该后端。
- 已保存的偏好设置——如果
EXTEND.md将preferred_image_backend设置为当前可用的后端,则使用该后端。 - 自动选择(偏好设置为
auto、未设置或指定的后端不可用时):- Codex(
imagegen)——首先检查可用技能/工具清单。如果列出了名为imagegen的技能,则表示你正在 Codex 中运行,必须使用该技能:通过Skill工具调用,并设置skill: "imagegen",传入已保存提示词文件的内容(以及 Codeximagegen自身参数要求的输出路径和宽高比)。Codeximagegen是该运行时中的官方光栅图像后端,优先级高于任何非原生技能(例如baoyu-image-gen),除非用户明确指定了其他preferred_image_backend。 - 通过
codex exec使用 Codex(codex-imagegen)——如果当前运行时未提供原生imagegen技能,但codexCLI 位于PATH中且已通过有效的codex login登录,则通过baoyu-image-gen --provider codex-cli路由(优先),或者——如果baoyu-image-gen不可用——直接调用捆绑的包装程序。详情、参数和运行时发现流程请参阅 references/codex-imagegen.md——仅在选择此分支时加载该文件。 - Cursor(
GenerateImage)——如果运行时提供原生GenerateImage工具,则表示你正在 Cursor 中运行,其优先级高于任何非原生技能,与 Codeximagegen相同。注意两个重要限制:(a) 它没有宽高比参数——请在传入description的提示文本中明确说明目标宽高比/尺寸;(b) 它不接受输出目录——文件会保存到工具管理的位置,因此生成后请将文件复制/移动到技能预期的输出路径(例如outputs/.../NN-xxx.png)。参考图像应放在reference_image_paths中。 - 其他运行时原生工具——如果运行时提供其他原生图像工具(例如 Hermes
image_generate),则以相同方式使用。 - 否则,如果恰好安装了一个非原生后端(例如
baoyu-image-gen),则使用该后端。 - 否则(有多个非原生后端,且没有运行时原生工具),请向用户提问一次——并将此问题与其他初始问题合并。
- Codex(
- 如果没有可用后端,请告知用户,并询问如何继续。
⛔ 切勿使用 SVG、HTML、canvas 或其他基于代码的渲染方式替代光栅图像生成。 Codex imagegen 自身的描述指出,当“输出应为位图素材,而非仓库原生代码或矢量图”时,应使用它。如果无法通过步骤 3 确定光栅图像后端,请转到步骤 4 并询问用户——不要悄悄生成 SVG、编写内联 <svg> 标记,或用 HTML/CSS 绘图替代。即使文章/章节看起来“像图表”,也同样适用:调用此规则的使用方技能已经确定需要的是光栅图像。
⛔ 绝不要通过在生成的位图上覆盖绘制来修复渲染后的文本。 不要使用 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR 脚本或任何其他程序化叠加方式,遮盖、改写、擦除、描边或替换已生成图卡中的标题、正文、标签或任何其他文本。如果文本有误或不清晰,请使用修正后的提示词重新生成,改用卡片上文字较少的布局,或询问用户要保留哪个不完美的候选版本。
无论后端是否可用,将 preferred_image_backend: ask 设为首选后端都会在每次运行时强制显示第 3 步提示。用户可通过下方的 ## Changing Preferences 部分更改固定的后端。
提示词文件要求(硬性):调用任何后端之前,必须将每张图完整、最终版的提示词写入 prompts/ 下的独立文件(命名格式:NN-{type}-[slug].md)。该文件是可复现记录,也可让你切换后端而无需重新生成提示词。
上方提到的具体工具名称(imagegen、GenerateImage、image_generate、baoyu-image-gen)仅为示例——请在遵循相同规则的前提下,替换为本地对应工具。
批量生成策略
当前生成组的所有提示词文件均已保存并验证后,默认应批量生成图片。
优先顺序:
- 如果所选后端支持原生批处理/多任务接口,请使用该接口。每项任务必须保留各自的提示词文件、输出路径、宽高比、会话 ID 和直接参考图片。
- 如果没有原生批处理接口,但运行时可以并行调用工具,则每批最多调度
generation_batch_size张图片。默认值:4。当前消息中的明确用户请求(例如--batch-size 4或“并行 4 张一起生成”)优先于 EXTEND.md。 - 如果原生批处理和并行工具调用都不可用,则按顺序生成。
规则:
- 遵循图 1 锚点链:先生成图 1,再批量生成图 2 及后续图片,并将图 1 作为参考。
- 在某批次的所有已选提示词文件都存在于磁盘上之前,绝不要启动该批次。
- 仅重试失败项一次,不要重新生成已成功的项目。
- 不要仅为并行渲染图片而使用子 Agent。仅在需要单独迭代提示词或进行创意探索时使用子 Agent。
确认策略
默认行为:生成前确认。
- 将明确的技能调用、文件路径、匹配的信号/预设和
EXTEND.md默认值视为推荐输入。它们都不能授权跳过确认。 - 用户完成第 2 步之前,不要开始第 3 步。
- 只有当前请求明确要求跳过确认时才跳过,例如:
--yes、“直接生成”、“不用确认”、“跳过确认”、“按默认出图”或意思相同的表述。 - 如果明确跳过确认,则在下一条面向用户的进度更新中,说明所采用的策略/风格/布局/配色/数量/后端,然后再开始生成。
语言
问题、进度、错误和完成摘要均使用用户的语言。技术标记(风格名称、文件路径、代码)保留英文。
选项
| 选项 | 描述 |
|---|---|
--style <name> | 视觉风格(见下方“风格”) |
--layout <name> | 信息布局(见下方“布局”) |
--palette <name> | 覆盖配色:macaron / warm / neon |
--preset <name> | 风格 + 布局 + 可选配色的简写(见下方“预设”;各预设的提示词片段见 references/style-presets.md) |
--ref <files...> | 应用于图 1、作为系列锚点的参考图片 |
--batch-size <n> | 本次运行的临时生成批次大小。默认值:EXTEND.md 中的 generation_batch_size,否则为 4。限制在 1-8。 |
--yes | 非交互模式:跳过所有确认,使用 EXTEND.md 或内置默认值,并自动确认推荐方案(路径 A) |
维度
三个独立选项可自由组合:
| 维度 | 控制内容 | 选项 |
|---|---|---|
| 风格 | 视觉美感(线条、装饰、渲染) | 12 种风格(见下文「风格」) |
| 布局 | 信息结构(密度、排列) | 8 种布局(见下文「布局」) |
| 调色板(可选) | 覆盖颜色,替换风格的默认颜色 | macaron / warm / neon(见下文「调色板」) |
例如:--style notion --layout dense 会生成一张富有知性气息的知识卡片;添加 --palette macaron 可让色彩更柔和,同时不改变 notion 的渲染规则。--preset 是风格 + 布局(+ 可选调色板)的简写。
调色板行为:不使用 --palette → 使用风格内置颜色;--palette <name> → 仅覆盖颜色,渲染规则保持不变。部分风格声明了 default_palette(例如,sketch-notes 的默认调色板为 macaron)。
风格(12 种)
| 风格 | 描述 |
|---|---|
cute(默认) | 甜美、可爱、少女风格 |
fresh | 清爽、自然 |
warm | 温馨、友好、亲切 |
bold | 强烈醒目、引人注目 |
minimal | 极简、精致 |
retro | 复古、怀旧、时髦 |
pop | 鲜艳、活力十足、吸睛 |
notion | 极简手绘线稿,富有知性气息 |
chalkboard | 黑板上的彩色粉笔画,富有教育意义 |
study-notes | 逼真的手写照片风格,蓝色笔迹 + 红色批注 + 黄色荧光笔 |
screen-print | 大胆的海报艺术、半色调纹理、有限配色、象征性叙事 |
sketch-notes | 手绘教育信息图,暖奶油色背景上的马卡龙柔色调,线条略带抖动 |
各风格规格:references/presets/<style>.md。
布局(8 种)
| 布局 | 描述 |
|---|---|
sparse(默认) | 1–2 个要点,冲击力最大 |
balanced | 3–4 个要点,标准布局 |
dense | 5–8 个要点,知识卡片风格 |
list | 枚举 / 排名(4–7 项) |
comparison | 并排对比 |
flow | 流程 / 时间线(3–6 个步骤) |
mindmap | 中心放射式(4–8 个分支) |
quadrant | 四象限 / 圆形分区 |
布局规格:references/elements/canvas.md。
调色板(可选覆盖)
替换风格的颜色,同时保留渲染规则(线条处理、纹理)。
| 调色板 | 背景 | 区域颜色 | 强调色 | 风格感受 |
|---|---|---|---|---|
macaron | 暖奶油色 #F5F0E8 | 蓝色 #A8D8EA、薰衣草紫 #D5C6E0、薄荷绿 #B5E5CF、蜜桃色 #F8D5C4 | 珊瑚色 #E8655A | 柔和、富有教育感 |
warm | 柔和蜜桃色 #FFECD2 | 橙色 #ED8936、赤陶色 #C05621、金色 #F6AD55、玫瑰色 #D4A09A | 赭色 #A0522D | 大地色系、温馨 |
neon | 深紫色 #1A1025 | 青色 #00F5FF、洋红色 #FF00FF、绿色 #39FF14、粉色 #FF6EC7 | 黄色 #FFFF00 | 活力十足、未来感 |
调色板规格:references/palettes/<palette>.md。
预设(风格 + 布局快捷组合)
按场景分组的快速入门组合。使用 --preset <name>,或在步骤 2 中推荐。
知识与学习:
| 预设 | 风格 | 布局 | 适用场景 |
|---|---|---|---|
knowledge-card | notion | dense | 干货知识卡、概念科普 |
checklist | notion | list | 清单、排行榜 |
concept-map | notion | mindmap | 概念图、知识脉络 |
swot | notion | quadrant | SWOT 分析、四象限 |
tutorial | chalkboard | flow | 教程步骤、操作流程 |
classroom | chalkboard | balanced | 课堂笔记、知识讲解 |
study-guide | study-notes | dense | 学习笔记、考试重点 |
hand-drawn-edu | sketch-notes | flow | 手绘教程、流程图解 |
sketch-card | sketch-notes | dense | 手绘知识卡 |
sketch-summary | sketch-notes | balanced | 手绘总结、图文笔记 |
生活方式与分享:
| 预设 | 风格 | 布局 | 适用场景 |
|---|---|---|---|
cute-share | cute | balanced | 少女风分享、日常种草 |
girly | cute | sparse | 甜美封面、氛围感 |
cozy-story | warm | balanced | 生活故事、情感分享 |
product-review | fresh | comparison | 产品对比、测评 |
nature-flow | fresh | flow | 健康流程、自然主题 |
影响力与观点:
| 预设 | 风格 | 布局 | 适用场景 |
|---|---|---|---|
warning | bold | list | 避坑指南、重要提醒 |
versus | bold | comparison | 正反对比 |
clean-quote | minimal | sparse | 金句、极简封面 |
pro-summary | minimal | balanced | 专业总结、商务内容 |
潮流与娱乐:
| 预设 | 风格 | 布局 | 适用场景 |
|---|---|---|---|
retro-ranking | retro | list | 复古排行、经典盘点 |
throwback | retro | balanced | 怀旧分享 |
pop-facts | pop | list | 趣味冷知识 |
hype | pop | sparse | 炸裂封面、惊叹分享 |
海报与编辑风格:
| 预设 | 风格 | 布局 | 适用场景 |
|---|---|---|---|
poster | screen-print | sparse | 海报风封面、影评书评 |
editorial | screen-print | balanced | 观点文章、文化评论 |
cinematic | screen-print | comparison | 电影对比、戏剧张力 |
完整的提示词片段定义:references/style-presets.md。
自动选择
根据内容信号匹配最佳组合。匹配到关键词的第一行优先;若均未匹配,则使用 cute-share。
| 源内容中的信号 | 风格 | 布局 | 推荐预设 |
|---|---|---|---|
| 美妆、时尚、可爱、女孩、粉色 | cute | sparse/balanced | cute-share、girly |
| 健康、自然、清新、有机 | fresh | balanced/flow | product-review、nature-flow |
| 生活、故事、情感、温暖 | warm | balanced | cozy-story |
| 警告、重要、必须、关键 | bold | list/comparison | warning、versus |
| 专业、商务、优雅 | minimal | sparse/balanced | clean-quote、pro-summary |
| 经典、复古、传统 | retro | balanced | throwback、retro-ranking |
| 有趣、刺激、哇、惊人 | pop | sparse/list | hype、pop-facts |
| 知识、概念、生产力、SaaS | notion | dense/list | knowledge-card、checklist |
| 教育、教程、学习、课堂 | chalkboard | balanced/dense | tutorial、classroom |
| 笔记、手写、学习指南、写实 | study-notes | dense/list/mindmap | study-guide |
| 电影、海报、观点、编辑风格、电影感 | screen-print | sparse/comparison | poster、editorial、cinematic |
| 手绘、信息图、工作流、手绘、图解 | sketch-notes | flow/balanced/dense | hand-drawn-edu、sketch-card、sketch-summary |
风格 × 布局矩阵
兼容性评分(✓✓ 强烈推荐,✓ 效果良好,✗ 避免使用)。当用户选择非默认组合,且你想指出其匹配效果不佳时使用。
| sparse | balanced | dense | list | comparison | flow | mindmap | quadrant | |
|---|---|---|---|---|---|---|---|---|
| cute | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
| fresh | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ |
| bold | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ |
| minimal | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| retro | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
| pop | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ |
| notion | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ |
| chalkboard | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
| study-notes | ✗ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ |
| screen-print | ✓✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ |
| sketch-notes | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
大纲策略
三种各有侧重的方法——每种都会生成结构不同的大纲。工作流会推荐一种;路径 C 会生成全部三种供用户选择。
| 策略 | 概念 | 适用场景 | 结构 |
|---|---|---|---|
| A — 故事驱动 | 以个人经历为线索,优先营造情感共鸣 | 评测、个人分享、转变历程 | 引子 → 问题 → 发现 → 体验 → 结论 |
| B — 信息密集 | 价值优先,高效传递信息 | 教程、比较、清单 | 核心结论 → 信息卡片 → 优缺点 → 建议 |
| C — 视觉优先 | 以视觉冲击为核心,尽量减少文字 | 高审美产品、生活方式、氛围内容 | 主视觉图 → 细节图 → 生活场景 → 行动号召 |
参考图片
用户提供的参考图独立于内部的“image-1 作为锚点”链路(步骤 3)——它们会叠加在该链路之上。
收集方式:通过 --ref <files...> 或在对话中粘贴路径。
- 文件路径 → 复制到
refs/NN-ref-{slug}.{ext} - 粘贴的内容没有路径 → 询问路径,或提取风格特征作为文本替代方案
使用模式(每张参考图):
| 用途 | 效果 |
|---|---|
direct | 将文件传给后端(通常仅用于图片 1,以便锚点沿链路传递) |
style | 提取风格特征,并附加到每张卡片的提示词正文中 |
palette | 提取十六进制颜色,并附加到每张卡片的提示词正文中 |
在每张受影响卡片的提示词 frontmatter 中记录参考图:
references:
- ref_id: 01
filename: 01-ref-brand.png
usage: direct
生成时:确认文件存在。图片 1 使用 usage: direct,且后端接受参考图时 → 通过后端的参考图参数传入(成为链路锚点)。图片 2 及之后仍按步骤 3 使用 image-1 作为 --ref——不要再叠加用户参考图(以免信号冲突)。对于 style/palette,将提取的特征嵌入每条提示词。
文件布局
image-cards/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── outline-strategy-{a,b,c}.md # Path C only
├── outline.md
├── prompts/NN-{type}-{slug}.md
├── NN-{type}-{slug}.png
└── refs/ # only if --ref used
Slug:2-4 个词,使用 kebab-case。“AI 工具推荐” → ai-tools-recommend。若发生冲突,则追加 -YYYYMMDD-HHMMSS。
备份规则(全程适用):覆盖任何文件之前——源文件、大纲、提示词或图片——将现有文件重命名为 <name>-backup-YYYYMMDD-HHMMSS.<ext>。这样可以保护用户的编辑内容。
工作流
- [ ] 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 report
步骤 0:加载 EXTEND.md ⛔ 阻塞
按顺序检查以下路径;命中第一个即停止:
| 路径 | 范围 |
|---|---|
.baoyu-skills/baoyu-xhs-images/EXTEND.md | 项目 |
${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-xhs-images/EXTEND.md | XDG |
$HOME/.baoyu-skills/baoyu-xhs-images/EXTEND.md | 用户主目录 |
- 找到 → 读取、解析并打印摘要(风格 / 布局 / 水印 / 语言),然后继续。
- 未找到 + 交互模式 → 运行首次设置(参见
references/config/first-time-setup.md),并在执行其他操作前保存。偏好设置存在之前,不要分析内容或询问风格问题——这样可确保首次运行行为可预测。 - 未找到 +
--yes→ 跳过设置,使用内置默认值(无水印、自动选择风格 / 布局、根据内容确定语言)。不要提示,也不要创建 EXTEND.md。
EXTEND.md 键:水印、首选风格 / 布局、自定义风格定义、语言偏好、首选图像后端、生成批次大小。架构:references/config/preferences-schema.md。
步骤 1:分析内容 → analysis.md
- 保存源内容(如果存在
source.md,则遵循备份规则)。 - 按照
references/workflows/analysis-framework.md进行深入分析:内容类型、吸引力潜力、受众、互动信号、视觉机会图、滑动浏览流程。 - 检测源语言,并选择建议的图片数量(2-10)。
- 使用上方的 自动选择 表自动推荐策略 + 风格 + 布局 + 调色板。
- 将所有内容写入
analysis.md。
步骤 2:智能确认 ⚠️ 必须执行
硬性门槛:根据确认政策,此步骤为必需步骤——在用户于此处确认(或在当前请求中使用 --yes / 等效措辞明确选择跳过)之前,不得开始步骤 3。
目标:展示自动推荐的方案,让用户确认或调整。在 --yes 模式下完全跳过此步骤——根据分析结果和任何 CLI 覆盖项,通过路径 A 继续。
提问前显示摘要:
📋 内容分析
主题:[topic] | 类型:[content_type]
要点:[key points]
受众:[audience]
🎨 推荐方案(自动匹配)
策略:[A/B/C] [name]([reason])
风格:[style] · 布局:[layout] · 配色:[palette or 默认] · 预设:[preset]
图片:[N]张(封面+[N-2]内容+结尾)
元素:[background] / [decorations] / [emphasis]
然后只问一个问题——提供三条路径。选项文本必须逐字使用:references/confirmation.md。
路径 A — 快速确认(采用自动推荐):使用建议的策略 + 风格生成一份大纲 → 保存到 outline.md → 步骤 3。
路径 B — 自定义:询问五个问题(策略 / 风格、布局、调色板、数量、可选备注),并预填推荐内容——留空则保留推荐。根据用户选择生成一份大纲 → outline.md → 步骤 3。参见 references/confirmation.md。
路径 C — 详细模式:包含两个子确认步骤。
- 步骤 2a — 内容理解:询问卖点(多选)、受众、风格偏好(真实 / 专业 / 美感 / 自动)、可选背景信息。更新
analysis.md。 - 步骤 2b — 三种大纲方案:生成
outline-strategy-a.md、outline-strategy-b.md、outline-strategy-c.md。每种方案都必须采用不同的结构和不同的建议风格——在 frontmatter 中加入style_reason。页面数量启发式建议:A 约 4-6 页,B 约 3-5 页,C 约 3-4 页。模板:references/workflows/outline-template.md;frontmatter 示例见references/confirmation.md。 - 步骤 2c — 选择:询问三个问题(大纲 A/B/C/组合、风格、视觉元素)。将选定或合并后的大纲保存到
outline.md→ 步骤 3。
第 3 步:生成图像
确定大纲、风格、布局和配色方案后:
视觉一致性——image-1 锚定链:除非进行锚定,否则角色/吉祥物/色彩渲染会在多次调用间发生漂移。先生成图像 1(封面),不要使用 --ref,然后将图像 1 作为 --ref 传递给之后生成的每张图像。这是本技能中最重要的一致性技巧——即使后端也支持会话 ID,也不要跳过这一步。
生成流程:
- 使用用户偏好的语言(适用备用规则)将每张图像的完整提示词写入
prompts/NN-{type}-{slug}.md,然后确认所有选定的提示词文件均已存在。 - 首先生成图像 1,不使用
--ref;PNG 文件适用备用规则。此图将作为锚点。 - 使用图像 1 作为
--ref <path-to-image-01.png>,为图像 2 及之后的图像构建任务列表。 - 按照
## Batch Generation Policy分批派发图像 2 及之后的图像:优先使用后端原生批处理,其次使用运行时并行工具调用,只有在无法采用前两种方式时才依次处理。 - 每完成一张图像后报告进度。如果失败,只从同一提示词文件重试失败项一次。
水印(如果在 EXTEND.md 中启用):将以下内容附加到生成提示词中:
Include a subtle watermark "[content]" positioned at [position].
The watermark should be legible but not distracting.
参见 references/config/watermark-guide.md。
后端选择:遵循顶部的图像生成工具规则——使用任何可用的后端;如果有多个可选项,须在生成前询问一次。在 --yes 模式下,使用 EXTEND.md 中的偏好设置,并在不可用时回退到第一个可用后端。调用任何后端之前,提示词文件必须已存在。
codex-imagegen 调用:如果根据规则选择了 codex-imagegen,请参阅 references/codex-imagegen.md 中的调用规范(首选 baoyu-image-gen --provider codex-cli 路径、运行时封装程序发现、参数说明、标准输出架构、批处理语义——每次调用的 n=1,因此卡片批次必须为每张卡片派发一次封装程序调用;封装程序不接受 --sessionId,因此必须按照上述第 3 步,通过 --ref 链保证一致性)。
会话 ID(如果后端支持 --sessionId):为每张图像使用 cards-{topic-slug}-{timestamp};结合引用链,可实现最大程度的一致性。
第 4 步:完成报告
Image Card Series Complete!
Topic: [topic]
Mode: [Quick / Custom / Detailed]
Strategy: [A/B/C/Combined]
Style: [name]
Palette: [name or "default"]
Layout: [name or "varies"]
Location: [directory]
Images: N total
✓ analysis.md
✓ outline.md
✓ outline-strategy-a/b/c.md (detailed mode only)
- 01-cover-[slug].png ✓ Cover (sparse)
- 02-content-[slug].png ✓ Content (balanced)
- ...
- NN-ending-[slug].png ✓ Ending (sparse)
内容拆分原则
| 位置 | 目的 | 典型布局 |
|---|---|---|
| 封面(图像 1) | 吸引注意 + 视觉冲击 | sparse |
| 内容(中间部分) | 每张图像传达核心价值 | balanced / dense / list / comparison / flow |
| 结尾(最后一张) | CTA / 总结 | sparse 或 balanced |
风格 × 布局兼容性矩阵请参见上文的 Style × Layout Matrix。
图像修改
| 操作 | 方法 |
|---|---|
| 编辑 | 先更新 prompts/NN-{type}-{slug}.md,然后使用相同的会话 ID 重新生成 |
| 添加 | 指定位置,创建提示词,生成图像,将后续文件重新编号为 NN+1,并更新大纲 |
| 删除 | 移除文件,将后续文件重新编号为 NN-1,并更新大纲 |
重新生成前,务必先更新提示词文件——它是唯一可信来源,可确保更改能够复现。
文字修正政策:
- 如果卡片标题、正文、标签或任何其他渲染文字出现拼写错误、乱码、难以辨认或视觉效果欠佳,不要使用代码修补位图。
- 重新生成以修正文字时,请编写新的提示词文件并指定新的输出路径,以保留有缺陷的候选版本供比较。
- 后期处理仅限裁剪、调整大小、压缩或格式转换,且不得更改文字或主要构图。
参考资料
| 文件 | 内容 |
|---|---|
references/confirmation.md | 所有确认路径的 AskUserQuestion 文案原文 |
references/style-presets.md | 完整的预设快捷定义 |
references/presets/<style>.md | 各样式的元素定义 |
references/palettes/<name>.md | 各调色板的颜色定义 |
references/elements/canvas.md | 宽高比、安全区域、网格布局 |
references/elements/image-effects.md | 抠图、描边、滤镜 |
references/elements/typography.md | 装饰文字、标签、文字方向 |
references/elements/decorations.md | 强调标记、背景、涂鸦、边框 |
references/workflows/analysis-framework.md | 内容分析框架 |
references/workflows/outline-template.md | 含布局指南的大纲模板 |
references/workflows/prompt-assembly.md | 提示词组装指南 |
references/config/preferences-schema.md | EXTEND.md 架构 |
references/config/first-time-setup.md | 首次设置流程 |
references/config/watermark-guide.md | 水印配置 |
备注
- 生成失败时自动重试一次,然后再报告错误。
- 对敏感的公众人物,使用风格化的卡通替代形象。
- 智能确认(步骤 2)为必需步骤;详细模式会增加第二次确认(2a + 2c)。
更改偏好设置
EXTEND.md 位于步骤 0 中列出的第一个匹配路径。可以通过以下三种方式更改:
- 直接编辑 — 打开 EXTEND.md 并修改字段。完整架构见:
references/config/preferences-schema.md。 - 交互式重新配置 — 删除 EXTEND.md(或询问「重新配置 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: true+watermark.content: "@handle"— 添加水印。