tuzi-cover-image

封面图片生成器

通过 5 个维度自定义，生成精美的文章封面图片。

用法

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

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

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

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

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

# Direct content input
/tuzi-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

文件结构

根据 default_output_dir 偏好设置输出目录：

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

<output-dir>/
├── 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 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] 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 → [Step 0: Preferences] ─┬─ Found → Continue
                               └─ Not found → First-Time Setup ⛔ BLOCKING → Save EXTEND.md → Continue
        ↓
Analyze + Save Refs → [Output Dir] → [Confirm: 6 Dimensions] → Prompt → Generate → Complete
                                              ↓
                                     (skip if --quick or all specified)

步骤 0：加载偏好设置 ⛔ 阻塞

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

test -f .tuzi-skills/tuzi-cover-image/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-cover-image/EXTEND.md" && echo "user"

结果	操作
找到	加载并显示摘要 → 继续
未找到	⛔ 运行首次设置（references/config/first-time-setup.md）→ 保存 → 继续

重要：如果未找到，必须先完成设置，然后才能执行其他步骤或提问。

步骤 1：分析内容

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

步骤 2：确认选项 ⚠️

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

条件	跳过的内容	仍需询问
--quick 或 quick_mode: true	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：生成图像

1. 备份现有的 cover.png（如果要重新生成）
2. 检查图像生成技能；如果有多个，请询问偏好
3. 处理提示词 frontmatter 中的参考资料：
   • direct 用法 → 通过 --ref 传入（使用支持参考图的后端）
   • style/palette → 提取特征并附加到提示词中
4. 生成：调用技能，提供提示词文件、输出路径和纵横比
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% 的呼吸空间
• 视觉锚点：主要元素居中或偏左
• 人物：简化的剪影；禁止使用逼真的人物
• 标题：使用用户/来源中的准确标题；切勿自行编造

扩展支持

通过 EXTEND.md 使用自定义配置。路径见步骤 0。

支持：水印 | 首选尺寸 | 默认纵横比/输出 | 快速模式 | 自定义调色板 | 语言

架构：references/config/preferences-schema.md

参考资料

尺寸：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 配置：preferences-schema.md | first-time-setup.md | watermark-guide.md