封面图像生成器

为文章生成优雅的封面图像，支持五维自定义。

使用方法

# 根据内容自动选择尺寸
/baoyu-cover-image path/to/article.md

# 快速模式：跳过确认
/baoyu-cover-image article.md --quick

# 指定尺寸
/baoyu-cover-image article.md --type conceptual --palette warm --rendering flat-vector

# 风格预设（快捷方式，用于设置调色板和渲染风格）
/baoyu-cover-image article.md --style blueprint

# 使用参考图像
/baoyu-cover-image article.md --ref style-ref.png

# 直接输入内容
/baoyu-cover-image --palette mono --aspect 1:1 --quick
[paste content]

参数说明

五维自定义

自动选择规则：[references/auto-selection.md](references/auto-selection.md)

图库展示

类型：hero、conceptual、typography、metaphor、scene、minimal

→ 详情：[references/types.md](references/types.md)

配色方案：warm、elegant、cool、dark、earth、vivid、pastel、mono、retro、duotone

→ 详情：[references/palettes/](references/palettes/)

渲染风格：flat-vector、hand-drawn、painterly、digital、pixel、chalk、screen-print

→ 详情：[references/renderings/](references/renderings/)

文字层级：none（纯视觉）｜title-only（默认）｜title-subtitle｜text-rich（含标签）

→ 详情：[references/dimensions/text.md](references/dimensions/text.md)

情绪基调：subtle（低对比）｜balanced（默认）｜bold（高对比）

→ 详情：[references/dimensions/mood.md](references/dimensions/mood.md)

字体类型：clean（无衬线）｜handwritten｜serif｜display（粗体装饰型）

→ 详情：[references/dimensions/font.md](references/dimensions/font.md)

文件结构

输出目录根据 default_output_dir 设置决定：

• same-dir：{article-dir}/
• imgs-subdir：{article-dir}/imgs/
• independent（默认）：cover-image/{topic-slug}/

<output-dir>/
├── source-{slug}.{ext}    # 原始文件
├── refs/                  # 参考图像（如提供）
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # 描述文件
├── prompts/cover.md       # 生成提示
└── cover.png              # 输出图像

Slug：2-4个单词，使用短横线连接。冲突时附加 -YYYYMMDD-HHMMSS

工作流程

进度检查清单

封面图像生成进度：
- [ ] 步骤 0：检查配置（EXTEND.md） ⛔ 阻塞项
- [ ] 步骤 1：分析内容 + 保存参考图 + 确定输出目录
- [ ] 步骤 2：确认选项（6个维度） ⚠️ 除非使用 --quick
- [ ] 步骤 3：创建提示
- [ ] 步骤 4：生成图像
- [ ] 步骤 5：完成报告

流程图

输入 → [步骤 0：加载配置] ─┬─ 找到 → 继续
                               └─ 未找到 → 首次设置 ⛔ 阻塞 → 保存 EXTEND.md → 继续
        ↓
分析 + 保存参考图 → [输出目录] → [确认：6个维度] → 提示 → 生成 → 完成
                                              ↓
                                     （若使用 --quick 或所有参数已指定则跳过）

步骤 0：加载配置 ⛔ 阻塞项

检查 EXTEND.md 是否存在（优先级：项目 → 用户）：

# macOS、Linux、WSL、Git Bash
test -f .baoyu-skills/baoyu-cover-image/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "xdg"
test -f "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md" && echo "user"

# PowerShell（Windows）
if (Test-Path .baoyu-skills/baoyu-cover-image/EXTEND.md) { "project" }
$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
if (Test-Path "$xdg/baoyu-skills/baoyu-cover-image/EXTEND.md") { "xdg" }
if (Test-Path "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md") { "user" }

重要提示：若未找到，请在执行其他步骤或提问前完成首次设置。

步骤 1：分析内容

1. 保存参考图像（如提供）→ [references/workflow/reference-images.md](references/workflow/reference-images.md)
2. 保存源内容（如直接粘贴，则保存至 source.md）
3. 分析内容：主题、语气、关键词、视觉隐喻
4. 深入分析参考图像 ⚠️：提取具体、明确的元素（参见 reference-images.md）
5. 检测语言：比较源内容、用户输入、EXTEND.md 中的配置偏好
6. 确定输出目录：依据文件结构规则

⚠️ 参考图像中的人物 —— 必须遵守以下三条规则：

技能：Baoyu 封面图像

版本：0.1.1

分块：2/2

如果参考图像中包含需要出现在封面中的人物：

1. **usage: direct** — 必须在参考描述文件中设置。当人物需要出现时，绝不能使用 style 或 palette
2. 按角色描述 — 必须在 refs/ref-NN-{slug}.md 中详细描述每个人的显著特征（发型、眼镜、肤色、服装）。模糊的描述如“一个男人”将导致失败
3. **--ref 标志** — 必须在第 4 步通过 --ref 传递参考图像，使模型能够看到真实人脸

有关描述格式，请参阅 [reference-images.md § 角色分析](references/workflow/reference-images.md)。

第二步：确认选项 ⚠️

**必须使用 AskUserQuestion 工具**，以交互式选择形式呈现选项 —— 不得使用纯文本表格。单次 AskUserQuestion 调用最多展示 4 个问题（类型、配色、渲染风格、字体 + 设置）。每个问题应首先列出推荐选项及理由，随后提供其他可选方案。

完整的确认流程与问题格式说明：[references/workflow/confirm-options.md](references/workflow/confirm-options.md)

第三步：生成提示词

保存至 prompts/cover.md。模板参考：[references/workflow/prompt-template.md](references/workflow/prompt-template.md)

关键 - 前置元数据中的参考信息：

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

正文中的参考元素必须详细描述，以 "MUST" / "REQUIRED" 开头，并注明整合方式。

第四步：生成图像

1. 重新生成时，先备份现有的 cover.png
2. 检查图像生成技能；若存在多个，需询问用户偏好
3. 处理提示词中的参考信息：

- direct 使用方式 → 通过 --ref 传递（使用支持参考图的后端）

- style / palette → 提取特征，附加至提示词

1. 执行生成：调用技能，传入提示词文件、输出路径、宽高比
2. 若失败：自动重试一次

第五步：完成报告

封面已生成！

主题：[topic]
类型：[type] | 配色：[palette] | 渲染风格：[rendering]
文字：[text] | 氛围：[mood] | 字体：[font] | 宽高比：[ratio]
标题：[title 或 "仅视觉"]
语言：[lang] | 水印：[启用/禁用]
参考图像：[N 张图片 或 "提取风格" 或 "无"]
位置：[目录路径]

文件：
✓ source-{slug}.{ext}
✓ prompts/cover.md
✓ cover.png

图像修改

构图原则

• 留白：保持 40-60% 的呼吸空间
• 视觉锚点：主体元素居中或偏左放置
• 人物表现：采用简化轮廓；禁止使用写实人类形象
• 标题：使用用户/源内容中的原始标题；不得自行编造

扩展支持

通过 EXTEND.md 实现自定义配置。详见 第 0 步 中的路径说明。

支持功能：水印 | 推荐尺寸 | 默认宽高比/输出 | 快速模式 | 自定义配色 | 语言

配置 Schema：[references/config/preferences-schema.md](references/config/preferences-schema.md)

参考资料

尺寸相关：[text.md](references/dimensions/text.md) | [mood.md](references/dimensions/mood.md) | [font.md](references/dimensions/font.md)

配色方案：[references/palettes/](references/palettes/)

渲染风格：[references/renderings/](references/renderings/)

类型：[references/types.md](references/types.md)

自动选择：[references/auto-selection.md](references/auto-selection.md)

风格预设：[references/style-presets.md](references/style-presets.md)

兼容性：[references/compatibility.md](references/compatibility.md)

视觉元素：[references/visual-elements.md](references/visual-elements.md)

工作流：[confirm-options.md](references/workflow/confirm-options.md) | [prompt-template.md](references/workflow/prompt-template.md) | [reference-images.md](references/workflow/reference-images.md)

配置：[preferences-schema.md](references/config/preferences-schema.md) | [first-time-setup.md](references/config/first-time-setup.md) | [watermark-guide.md](references/config/watermark-guide.md)