tuzi-cover-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cover Image Generator

封面图片生成器

Generate elegant cover images for articles with 5-dimensional customization.

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

Usage

使用方法

bash

undefined

bash

undefined

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]

undefined

/tuzi-cover-image --palette mono --aspect 1:1 --quick [paste content]

undefined

Options

选项

Option	Description
`--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>`	Preset shorthand (see Style Presets)
`--text <level>`	none, title-only, title-subtitle, text-rich
`--mood <level>`	subtle, balanced, bold
`--font <name>`	clean, handwritten, serif, display
`--aspect <ratio>`	16:9 (default), 2.35:1, 4:3, 3:2, 1:1, 3:4
`--lang <code>`	Title language (en, zh, ja, etc.)
`--no-title`	Alias for `--text none`
`--quick`	Skip confirmation, use auto-selection
`--ref <files...>`	Reference images for style/composition guidance

Option	描述
`--type <name>`	hero、概念风、排版风、隐喻风、场景风、极简风
`--palette <name>`	暖色调、优雅色调、冷色调、暗色调、大地色调、亮色、马卡龙色、单色、复古色
`--rendering <name>`	扁平矢量、手绘、油画风、数字风、像素风、粉笔风
`--style <name>`	预设快捷方式（见风格预设）
`--text <level>`	无文字、仅标题、标题+副标题、多文字
`--mood <level>`	柔和、均衡、浓烈
`--font <name>`	简约无衬线、手写、衬线、展示字体
`--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...>`	用于风格/构图参考的参考图片

Five Dimensions

五大维度

Dimension	Values	Default
Type	hero, conceptual, typography, metaphor, scene, minimal	auto
Palette	warm, elegant, cool, dark, earth, vivid, pastel, mono, retro	auto
Rendering	flat-vector, hand-drawn, painterly, digital, pixel, chalk	auto
Text	none, title-only, title-subtitle, text-rich	title-only
Mood	subtle, balanced, bold	balanced
Font	clean, handwritten, serif, display	clean

Auto-selection rules: references/auto-selection.md

维度	可选值	默认值
类型	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

Galleries

效果展示

Types: hero, conceptual, typography, metaphor, scene, minimal → Details: references/types.md

Palettes: warm, elegant, cool, dark, earth, vivid, pastel, mono, retro → Details: references/palettes/

Renderings: flat-vector, hand-drawn, painterly, digital, pixel, chalk → Details: references/renderings/

Text Levels: none (pure visual) | title-only (default) | title-subtitle | text-rich (with tags) → Details: references/dimensions/text.md

Mood Levels: subtle (low contrast) | balanced (default) | bold (high contrast) → Details: references/dimensions/mood.md

Fonts: clean (sans-serif) | handwritten | serif | display (bold decorative) → Details: references/dimensions/font.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

File Structure

文件结构

Output directory per

default_output_dir

preference:

```
same-dir
```
:
```
{article-dir}/
```
```
imgs-subdir
```
:
```
{article-dir}/imgs/
```
```
independent
```
(default):
```
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 words, kebab-case. Conflict: append

-YYYYMMDD-HHMMSS

输出目录遵循

default_output_dir

偏好设置：

```
same-dir
```
:
```
{article-dir}/
```
（和文章同目录）
```
imgs-subdir
```
:
```
{article-dir}/imgs/
```
（文章目录下的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

Workflow

工作流程

Progress Checklist

进度清单

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

封面生成进度:
- [ ] 第0步: 检查偏好设置（EXTEND.md）⛔ 阻塞项
- [ ] 第1步: 分析内容+保存参考资料+确定输出目录
- [ ] 第2步: 确认选项（6个维度）⚠️ 使用--quick则跳过
- [ ] 第3步: 生成提示词
- [ ] 第4步: 生成图片
- [ ] 第5步: 完成报告

Flow

流程

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 → 继续
        ↓
分析+保存参考资料 → [输出目录] → [确认: 6个维度] → 提示词 → 生成 → 完成
                                              ↓
                                     （使用--quick或所有参数已指定则跳过）

Step 0: Load Preferences ⛔ BLOCKING

第0步: 加载偏好设置 ⛔ 阻塞项

Check EXTEND.md existence (priority: project → user):

bash

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

Result	Action
Found	Load, display summary → Continue
Not found	⛔ Run first-time setup (references/config/first-time-setup.md) → Save → Continue

CRITICAL: If not found, complete setup BEFORE any other steps or questions.

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

bash

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) → 保存 → 继续

重要提示: 如果未找到配置文件，必须在执行其他步骤或回答问题前完成设置。

Step 1: Analyze Content

第1步: 分析内容

Save reference images (if provided) → references/workflow/reference-images.md
Save source content (if pasted, save to
```
source.md
```
)
Analyze content: topic, tone, keywords, visual metaphors
Deep analyze references ⚠️: Extract specific, concrete elements (see reference-images.md)
Detect language: Compare source, user input, EXTEND.md preference
Determine output directory: Per File Structure rules

保存参考图片（如果有提供）→ references/workflow/reference-images.md
保存源内容（如果是粘贴的内容，保存到
```
source.md
```
）
分析内容: 主题、基调、关键词、视觉隐喻
深度分析参考资料 ⚠️: 提取具体、明确的元素（见reference-images.md）
检测语言: 对比源内容、用户输入、EXTEND.md偏好设置
确定输出目录: 遵循文件结构规则

Step 2: Confirm Options ⚠️

第2步: 确认选项 ⚠️

Full confirmation flow: references/workflow/confirm-options.md

Condition	Skipped	Still Asked
`--quick` or `quick_mode: true`	6 dimensions	Aspect ratio (unless `--aspect` )
All 6 + `--aspect` specified	All	None

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

条件	跳过项	仍需确认项
`--quick` 或 `quick_mode: true`	6个维度确认	宽高比（除非已指定 `--aspect` ）
所有6个维度+ `--aspect` 已指定	所有确认	无

Step 3: Create Prompt

第3步: 生成提示词

Save to

prompts/cover.md

. Template: references/workflow/prompt-template.md

CRITICAL - References in Frontmatter:

Files saved to
```
refs/
```
→ Add to frontmatter
```
references
```
list
Style extracted verbally (no file) → Omit
```
references
```
, describe in body
Before writing → Verify:
```
test -f refs/ref-NN-{slug}.{ext}
```

Reference elements in body MUST be detailed, prefixed with "MUST"/"REQUIRED", with integration approach.

保存到

prompts/cover.md

。模板: references/workflow/prompt-template.md

重要提示 - Frontmatter中的参考资料:

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

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

Step 4: Generate Image

第4步: 生成图片

Backup existing
```
cover.png
```
if regenerating
Check image generation skills; if multiple, ask preference
Process references from prompt frontmatter:
- ```
direct
```
  usage → pass via
```
--ref
```
  (use ref-capable backend)
- ```
style
```
  /
```
palette
```
  → extract traits, append to prompt
Generate: Call skill with prompt file, output path, aspect ratio
On failure: auto-retry once

备份已存在的
```
cover.png
```
（如果是重新生成）
检查图片生成技能; 如果有多个，询问用户偏好
处理提示词frontmatter中的参考资料:
- ```
direct
```
  用途 → 通过
```
--ref
```
  传递（使用支持参考图的后端）
- ```
style
```
  /
```
palette
```
  用途 → 提取特征，追加到提示词
生成: 传入提示词文件、输出路径、宽高比调用生成技能
生成失败: 自动重试一次

Step 5: Completion Report

第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

封面生成完成!

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

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

Image Modification

图片修改

Action	Steps
Regenerate	Backup → Update prompt file FIRST → Regenerate
Change dimension	Backup → Confirm new value → Update prompt → Regenerate

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

Composition Principles

构图原则

Whitespace: 40-60% breathing room
Visual anchor: Main element centered or offset left
Characters: Simplified silhouettes; NO realistic humans
Title: Use exact title from user/source; never invent

留白: 保留40-60%的呼吸空间
视觉锚点: 主元素居中或偏左
人物: 使用简化轮廓; 禁止使用写实人像
标题: 使用用户/源内容中的准确标题; 禁止自行编造

Extension Support

扩展支持

Custom configurations via EXTEND.md. See Step 0 for paths.

Schema: references/config/preferences-schema.md

可通过EXTEND.md自定义配置。路径见第0步。

配置Schema: references/config/preferences-schema.md

References

参考资料

Dimensions: text.md | mood.md | font.md Palettes: references/palettes/ Renderings: references/renderings/ Types: references/types.md Auto-Selection: references/auto-selection.md Style Presets: references/style-presets.md Compatibility: references/compatibility.md Visual Elements: references/visual-elements.md Workflow: confirm-options.md | prompt-template.md | reference-images.md Config: preferences-schema.md | first-time-setup.md | watermark-guide.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