chore: release v1.20.0

2026-08-01 06:39:49 +08:00 · 2026-01-24 02:30:28 -06:00
parent b15a95e73d
commit e7255efdd6
11 changed files with 649 additions and 69 deletions
@@ -13,14 +13,49 @@ Create a WeChat article cover image following these guidelines:
 - Ample whitespace, highlight core message, avoid cluttered layouts
 - Main visual elements centered or slightly left (leave right side for title area if title included)

+## Four Dimensions
+
+### Type (Visual Composition)
+- `hero`: Large focal visual (60-70% area), dramatic composition
+- `conceptual`: Abstract shapes, information hierarchy, clean zones
+- `typography`: Title as primary element (40%+ area), minimal visuals
+- `metaphor`: Concrete object representing abstract idea, symbolic elements
+- `scene`: Atmospheric environment, narrative elements, mood lighting
+- `minimal`: Single focal element, generous whitespace (60%+)
+
+### Style (Visual Aesthetics)
+Apply the specified style's color palette, visual elements, and typography characteristics.
+
+### Text (Density Level)
+- `none`: No text elements, full visual area
+- `title-only`: Single headline (≤8 characters), 85% visual area
+- `title-subtitle`: Title + context (≤15 chars), 75% visual area
+- `text-rich`: Title + subtitle + 2-4 keyword tags, 60% visual area
+
+### Mood (Emotional Intensity)
+- `subtle`: Low contrast, muted/desaturated colors, light visual weight, calm aesthetic
+- `balanced`: Medium contrast, normal saturation, balanced visual weight
+- `bold`: High contrast, vivid/saturated colors, heavy visual weight, dynamic energy
+
 ## Text Style (When Title Included)

 - **ALL text MUST be hand-drawn style**
 - Title text: Large, eye-catching, max 8 characters
- May include 1 line of subtitle or keyword tags
+- Subtitle: Secondary, max 15 characters (if title-subtitle or text-rich)
+- Tags: 2-4 keyword badges (if text-rich)
 - Font style harmonizes with illustration style
 - **DO NOT use realistic or computer-generated fonts**

+## Mood Application
+
+Apply mood adjustments to the base style:
+
+| Mood | Contrast | Saturation | Weight |
+|------|----------|------------|--------|
+| subtle | Reduce 20-30% | Desaturate 20-30% | Lighter strokes/fills |
+| balanced | Standard | Standard | Standard |
+| bold | Increase 20-30% | Increase 20-30% | Heavier strokes/fills |
+
 ## Language

 - Use the same language as the content provided below for any text elements
@@ -93,7 +93,19 @@ options:
    description: "Square, social media friendly"
 ```

-### Question 5: Save Location
+### Question 5: Quick Mode
+
+```
+header: "Quick"
+question: "Enable quick mode by default?"
+options:
+  - label: "No (Recommended)"
+    description: "Confirm dimension choices each time"
+  - label: "Yes"
+    description: "Skip confirmation, use auto-selection"
+```
+
+### Question 6: Save Location

 ```
 header: "Save"
@@ -123,7 +135,7 @@ options:

 ```yaml
 ---
-version: 1
+version: 2
 watermark:
  enabled: [true/false]
  content: "[user input or empty]"
@@ -131,12 +143,25 @@ watermark:
  opacity: 0.7
 preferred_type: [selected type or null]
 preferred_style: [selected style or null]
+preferred_text: title-only
+preferred_mood: balanced
 default_aspect: [2.35:1/16:9/1:1]
+quick_mode: [true/false]
 language: null
 custom_styles: []
 ---
 ```

+## New Fields in v2
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `preferred_text` | title-only | Text density (none, title-only, title-subtitle, text-rich) |
+| `preferred_mood` | balanced | Mood intensity (subtle, balanced, bold) |
+| `quick_mode` | false | Skip confirmation step when true |
+
+Note: Text and Mood preferences use sensible defaults (title-only, balanced) and don't require setup questions. Users can modify these in EXTEND.md directly.
+
 ## Modifying Preferences Later

 Users can edit EXTEND.md directly or run setup again:
@@ -9,7 +9,7 @@ description: EXTEND.md YAML schema for baoyu-cover-image user preferences

 ```yaml
 ---
-version: 1
+version: 2

 watermark:
  enabled: false
@@ -21,8 +21,14 @@ preferred_type: null      # hero|conceptual|typography|metaphor|scene|minimal or

 preferred_style: null     # Built-in style name or null for auto-select

+preferred_text: title-only  # none|title-only|title-subtitle|text-rich
+
+preferred_mood: balanced    # subtle|balanced|bold
+
 default_aspect: "2.35:1"  # 2.35:1|16:9|1:1

+quick_mode: false         # Skip confirmation when true
+
 language: null            # zh|en|ja|ko|auto (null = auto-detect)

 custom_styles:
@@ -42,14 +48,17 @@ custom_styles:

 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `version` | int | 1 | Schema version |
+| `version` | int | 2 | Schema version |
 | `watermark.enabled` | bool | false | Enable watermark |
 | `watermark.content` | string | "" | Watermark text (@username or custom) |
 | `watermark.position` | enum | bottom-right | Position on image |
 | `watermark.opacity` | float | 0.7 | Transparency (0.1-1.0) |
 | `preferred_type` | string | null | Type name or null for auto |
 | `preferred_style` | string | null | Style name or null for auto |
+| `preferred_text` | string | title-only | Text density level |
+| `preferred_mood` | string | balanced | Mood intensity level |
 | `default_aspect` | string | "2.35:1" | Default aspect ratio |
+| `quick_mode` | bool | false | Skip confirmation step |
 | `language` | string | null | Output language (null = auto-detect) |
 | `custom_styles` | array | [] | User-defined styles |

@@ -64,6 +73,23 @@ custom_styles:
 | `scene` | Atmospheric scene, narrative feel |
 | `minimal` | Minimalist composition, generous whitespace |

+## Text Options
+
+| Value | Description |
+|-------|-------------|
+| `none` | Pure visual, no text elements |
+| `title-only` | Single headline (≤8 characters) |
+| `title-subtitle` | Title + subtitle (≤15 characters) |
+| `text-rich` | Title + subtitle + keyword tags (2-4) |
+
+## Mood Options
+
+| Value | Description |
+|-------|-------------|
+| `subtle` | Low contrast, muted colors, calm aesthetic |
+| `balanced` | Medium contrast, normal saturation, versatile |
+| `bold` | High contrast, vivid colors, dynamic energy |
+
 ## Position Options

 | Value | Description |
@@ -98,12 +124,15 @@ custom_styles:

 ```yaml
 ---
-version: 1
+version: 2
 watermark:
  enabled: true
  content: "@myhandle"
 preferred_type: null
 preferred_style: elegant
+preferred_text: title-only
+preferred_mood: balanced
+quick_mode: false
 ---
 ```

@@ -111,7 +140,7 @@ preferred_style: elegant

 ```yaml
 ---
-version: 1
+version: 2
 watermark:
  enabled: true
  content: "myblog.com"
@@ -122,8 +151,14 @@ preferred_type: conceptual

 preferred_style: blueprint

+preferred_text: title-subtitle
+
+preferred_mood: subtle
+
 default_aspect: "16:9"

+quick_mode: true
+
 language: en

 custom_styles:
@@ -138,3 +173,16 @@ custom_styles:
    best_for: "SaaS, enterprise, technical"
 ---
 ```
+
+## Migration from v1
+
+When loading v1 schema, auto-upgrade:
+
+| v1 Field | v2 Field | Default Value |
+|----------|----------|---------------|
+| (missing) | `version` | 2 |
+| (missing) | `preferred_text` | title-only |
+| (missing) | `preferred_mood` | balanced |
+| (missing) | `quick_mode` | false |
+
+v1 `--no-title` flag maps to `preferred_text: none`.
@@ -0,0 +1,125 @@
+---
+name: mood-dimension
+description: Emotional intensity dimension for cover images
+---
+
+# Mood Dimension
+
+Controls emotional intensity and visual weight of cover images.
+
+## Values
+
+| Value | Contrast | Saturation | Weight | Energy |
+|-------|:--------:|:----------:|:------:|:------:|
+| `subtle` | Low | Muted | Light | Calm |
+| `balanced` | Medium | Normal | Medium | Moderate |
+| `bold` | High | Vivid | Heavy | Dynamic |
+
+## Detail
+
+### subtle
+
+Calm, understated visual presence.
+
+**Characteristics**:
+- Low contrast between elements
+- Muted, desaturated colors
+- Light visual weight
+- Gentle, refined aesthetic
+- Soft edges and transitions
+
+**Use Cases**:
+- Thought leadership content
+- Professional/corporate communications
+- Meditation, wellness topics
+- Academic or scholarly articles
+- Luxury brand aesthetics
+
+**Color Guidance**:
+- Pastels, earth tones, neutrals
+- Low saturation (30-50%)
+- Soft gradients
+- Minimal color variety (2-3 colors)
+
+### balanced
+
+Versatile, harmonious visual presence.
+
+**Characteristics**:
+- Medium contrast
+- Natural saturation levels
+- Balanced visual weight
+- Clear but not aggressive
+- Standard aesthetic approach
+
+**Use Cases**:
+- General articles (default)
+- Most blog content
+- Educational material
+- Product documentation
+- News and updates
+
+**Color Guidance**:
+- Standard saturation (50-70%)
+- Complementary color schemes
+- Clear foreground/background separation
+- Moderate color variety (3-4 colors)
+
+### bold
+
+Dynamic, high-impact visual presence.
+
+**Characteristics**:
+- High contrast between elements
+- Vivid, saturated colors
+- Heavy visual weight
+- Energetic, attention-grabbing
+- Sharp edges and strong shapes
+
+**Use Cases**:
+- Product launches
+- Promotional announcements
+- Event marketing
+- Call-to-action content
+- Entertainment/gaming topics
+
+**Color Guidance**:
+- High saturation (70-100%)
+- Vibrant, primary colors
+- Strong contrast ratios
+- Dynamic color combinations (4+ colors)
+
+## Type Compatibility
+
+| Type | subtle | balanced | bold |
+|------|:------:|:--------:|:----:|
+| hero | ✓ | ✓✓ | ✓✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ |
+| typography | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓✓ | ✓ |
+| scene | ✓✓ | ✓✓ | ✓ |
+| minimal | ✓✓ | ✓✓ | ✗ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Style Interaction
+
+Mood modifies the base style characteristics:
+
+| Style Category | subtle | balanced | bold |
+|----------------|--------|----------|------|
+| Technical (blueprint, notion) | Lighter lines, softer colors | Standard rendering | Stronger contrast, sharper edges |
+| Artistic (watercolor, sketch-notes) | More whitespace, lighter strokes | Standard rendering | Deeper colors, heavier strokes |
+| Editorial (bold-editorial, dark-atmospheric) | Reduced contrast, softer tones | Standard rendering | Maximum impact, vivid colors |
+
+## Auto Selection
+
+When `--mood` is omitted, select based on signals:
+
+| Signals | Mood Level |
+|---------|------------|
+| Professional, corporate, thought leadership, academic, luxury | `subtle` |
+| General, educational, standard, blog, documentation | `balanced` |
+| Launch, announcement, promotion, event, gaming, entertainment | `bold` |
+
+Default: `balanced`
@@ -0,0 +1,122 @@
+---
+name: text-dimension
+description: Text density dimension for cover images
+---
+
+# Text Dimension
+
+Controls text density and information hierarchy on cover images.
+
+## Values
+
+| Value | Title | Subtitle | Tags | Visual Area |
+|-------|:-----:|:--------:|:----:|:-----------:|
+| `none` | - | - | - | 100% |
+| `title-only` | ✓ (≤8字) | - | - | 85% |
+| `title-subtitle` | ✓ | ✓ (≤15字) | - | 75% |
+| `text-rich` | ✓ | ✓ | ✓ (2-4) | 60% |
+
+## Detail
+
+### none
+
+Pure visual cover with no text elements.
+
+**Use Cases**:
+- Photography-focused covers
+- Abstract art pieces
+- Visual-only social sharing
+- When title added externally
+
+**Composition**:
+- Full visual area available
+- No reserved text zones
+- Emphasis on visual metaphor
+
+### title-only
+
+Single headline, maximum impact.
+
+**Use Cases**:
+- Most article covers (default)
+- Clear single message
+- Strong brand recognition
+
+**Composition**:
+- Title: ≤8 characters, prominent
+- Reserved zone: top or bottom 15%
+- Visual supports title message
+
+**Title Guidelines**:
+- Punchy, action-oriented
+- Numbers, questions, contrasts work well
+- Match content language
+
+### title-subtitle
+
+Title with supporting context.
+
+**Use Cases**:
+- Technical articles needing clarification
+- Series with episode/part info
+- Content with dual messages
+
+**Composition**:
+- Title: ≤8 characters, primary
+- Subtitle: ≤15 characters, secondary
+- Reserved zone: 25%
+- Clear hierarchy between title/subtitle
+
+**Subtitle Guidelines**:
+- Clarify or contextualize title
+- Can include series name, author, date
+- Smaller, less prominent than title
+
+### text-rich
+
+Information-dense cover with multiple text elements.
+
+**Use Cases**:
+- Infographic-style covers
+- Event announcements with details
+- Promotional material with features
+- Content with multiple key points
+
+**Composition**:
+- Title: primary focus
+- Subtitle: supporting info
+- Tags: 2-4 keyword labels
+- Reserved zone: 40%
+- Clear visual hierarchy
+
+**Tag Guidelines**:
+- 2-4 tags maximum
+- Short keywords (1-2 words each)
+- Positioned as badges/labels
+- Can highlight: category, date, author, key features
+
+## Type Compatibility
+
+| Type | none | title-only | title-subtitle | text-rich |
+|------|:----:|:----------:|:--------------:|:---------:|
+| hero | ✓ | ✓✓ | ✓✓ | ✓ |
+| conceptual | ✓✓ | ✓✓ | ✓ | ✓ |
+| typography | ✗ | ✓ | ✓✓ | ✓✓ |
+| metaphor | ✓✓ | ✓ | ✓ | ✗ |
+| scene | ✓✓ | ✓ | ✓ | ✗ |
+| minimal | ✓✓ | ✓✓ | ✓ | ✗ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Auto Selection
+
+When `--text` is omitted, select based on signals:
+
+| Signals | Text Level |
+|---------|------------|
+| Visual-only, photography, abstract, art | `none` |
+| Article, blog, standard cover | `title-only` |
+| Series, tutorial, technical with context | `title-subtitle` |
+| Announcement, features, multiple points, infographic | `text-rich` |
+
+Default: `title-only`