baoyu-cover-image

封面图生成器

生成优雅的文章封面图，并支持 5 个维度的自定义。

用法

# Auto-select dimensions based on content
/baoyu-cover-image path/to/article.md

# Quick mode: skip confirmation
/baoyu-cover-image article.md --quick

# Specify dimensions
/baoyu-cover-image article.md --type conceptual --palette warm --rendering flat-vector

# Style presets (shorthand for palette + rendering)
/baoyu-cover-image article.md --style blueprint

# With reference images
/baoyu-cover-image article.md --ref style-ref.png

# Direct content input
/baoyu-cover-image --palette mono --aspect 1:1 --quick
[paste content]

选项

选项	描述
--type <name>	hero、conceptual、typography、metaphor、scene、minimal
--palette <name>	warm、elegant、cool、dark、earth、vivid、pastel、mono、retro
--rendering <name>	flat-vector、hand-drawn、painterly、digital、pixel、chalk
--style <name>	预设简写（参见 样式预设）
--text <level>	none、title-only、title-subtitle、text-rich
--mood <level>	subtle、balanced、bold
--font <name>	clean、handwritten、serif、display
--aspect <ratio>	16:9（默认）、2.35:1、4:3、3:2、1:1、3:4
--lang <code>	标题语言（en、zh、ja 等）
--no-title	--text none 的别名
--quick	跳过确认，使用自动选择
--ref <files...>	用于风格／构图参考的图像

五个维度

维度	取值	默认值
类型	hero、conceptual、typography、metaphor、scene、minimal	auto
调色板	warm、elegant、cool、dark、earth、vivid、pastel、mono、retro	auto
渲染方式	flat-vector、hand-drawn、painterly、digital、pixel、chalk	auto
文本	none、title-only、title-subtitle、text-rich	title-only
氛围	subtle、balanced、bold	balanced
字体	clean、handwritten、serif、display	clean

自动选择规则：references/auto-selection.md

画廊

类型：hero、conceptual、typography、metaphor、scene、minimal
→ 详情：references/types.md

调色板：warm、elegant、cool、dark、earth、vivid、pastel、mono、retro
→ 详情：references/palettes/

渲染方式：flat-vector、hand-drawn、painterly、digital、pixel、chalk
→ 详情：references/renderings/

文本级别：none（纯视觉）| title-only（默认）| title-subtitle | text-rich（含标签）
→ 详情：references/dimensions/text.md

氛围级别：subtle（低对比度）| balanced（默认）| bold（高对比度）
→ 详情：references/dimensions/mood.md

字体：clean（无衬线）| handwritten（手写体）| serif（衬线体）| display（粗体装饰字体）
→ 详情：references/dimensions/font.md

文件结构

输出目录必须为：Assets/Cover-Images/{topic-slug}/
（由于此知识库用于文本和图像内容创作，所有生成的封面图及其资源都统一存放在此处，以便与文章解耦。）

Assets/Cover-Images/{topic-slug}/
├── source-{slug}.{ext}    # Source files
├── refs/                  # Reference images (if provided)
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # Description file
├── prompts/cover.md       # Generation prompt
└── cover.png              # Output image

Slug：2-4 个单词，使用 kebab-case。若发生冲突：追加 -YYYYMMDD-HHMMSS

工作流

进度清单

Cover Image Progress:
- [ ] Step 1: Analyze content + save refs + determine output dir
- [ ] Step 2: Confirm options (6 dimensions) ⚠️ unless --quick
- [ ] Step 3: Create prompt
- [ ] Step 4: Generate image
- [ ] Step 5: Completion report

流程

Input → Analyze + Save Refs → [Output Dir] → [Confirm: 6 Dimensions] → Prompt → Generate → Complete
                                             ↓
                               (skip if --quick or all specified)

1. 保存参考图像（如果提供）→ references/workflow/reference-images.md
2. 保存源内容（如果已粘贴，保存为 source.md）
3. 分析内容：主题、语气、关键词、视觉隐喻
4. 深入分析参考图像 ⚠️：提取具体、明确的元素（参见 reference-images.md）
5. 检测语言：比较源内容和用户输入
6. 确定输出目录：遵循文件结构规则

第 2 步：确认选项 ⚠️

完整确认流程：references/workflow/confirm-options.md

条件	跳过项	仍会询问
--quick	6 个维度	宽高比（除非指定了 --aspect）
已指定全部 6 个维度和 --aspect	全部	无

步骤 3：创建提示词

保存到 prompts/cover.md。模板：references/workflow/prompt-template.md

重要：Frontmatter 中的参考资料：

• 保存到 refs/ 的文件 → 添加到 frontmatter 的 references 列表
• 口头提取的风格（无文件）→ 省略 references，在正文中描述
• 写入前 → 验证：test -f refs/ref-NN-{slug}.{ext}

正文中的参考元素必须详细说明，以“MUST”/“REQUIRED”开头，并说明整合方式。

步骤 4：生成图像（使用 baoyu-image-gen）

1. 如果要重新生成，先备份现有的 cover.png
2. 处理提示词 frontmatter 中的参考资料：
   • direct 用法 → 通过 --ref 传入（使用支持参考图的后端）
   • style/palette → 提取特征并追加到提示词中
3. 环境：务必明确使用共享的 .env（位于 .agents/skills/.env）来配置模型。
4. 生成：通过统一命令执行 baoyu-image-gen：

   bun .agents/skills/baoyu-image-gen/scripts/main.ts --promptfiles <output-dir>/prompts/cover.md --image <output-dir>/cover.png --ar <aspect>
   

5. 失败时：自动重试一次

步骤 5：完成报告

Cover Generated!

Topic: [topic]
Type: [type] | Palette: [palette] | Rendering: [rendering]
Text: [text] | Mood: [mood] | Font: [font] | Aspect: [ratio]
Title: [title or "visual only"]
Language: [lang] | Watermark: [enabled/disabled]
References: [N images or "extracted style" or "none"]
Location: [directory path]

Files:
✓ source-{slug}.{ext}
✓ prompts/cover.md
✓ cover.png

图像修改

操作	步骤
重新生成	备份 → 先更新提示词文件 → 重新生成
更改尺寸	备份 → 确认新值 → 更新提示词 → 重新生成

构图原则

• 留白：40-60% 的空间
• 视觉焦点：主要元素居中或偏左
• 人物：采用简化的剪影；禁止出现写实人物
• 标题：使用用户/源内容中的准确标题；不得自行编造

配置

使用 .agents/skills/.env 配置模型/提供商设置。

参考资料

尺寸：text.md | mood.md | font.md 调色板：references/palettes/ 渲染效果：references/renderings/ 类型：references/types.md 自动选择：references/auto-selection.md 风格预设：references/style-presets.md 兼容性：references/compatibility.md 视觉元素：references/visual-elements.md 工作流：confirm-options.md | prompt-template.md | reference-images.md