chore: release v1.16.0

2026-08-07 09:23:04 +08:00 · 2026-01-23 12:15:56 -06:00
parent 8d04b71700
commit 658c5dee71
9 changed files with 783 additions and 347 deletions
@@ -0,0 +1,113 @@
+---
+name: first-time-setup
+description: First-time setup flow for baoyu-article-illustrator preferences
+---
+
+# First-Time Setup
+
+## Overview
+
+When no EXTEND.md is found, guide user through preference setup.
+
+## Setup Flow
+
+```
+No EXTEND.md found
+        │
+        ▼
+┌─────────────────────┐
+│ AskUserQuestion     │
+│ (all questions)     │
+└─────────────────────┘
+        │
+        ▼
+┌─────────────────────┐
+│ Create EXTEND.md    │
+└─────────────────────┘
+        │
+        ▼
+    Continue to Step 1
+```
+
+## Questions
+
+**Language**: Use user's input language or preferred language for all questions. Do not always use English.
+
+Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
+
+### Question 1: Watermark
+
+```
+header: "Watermark"
+question: "Watermark text for generated illustrations? Type your watermark content (e.g., name, @handle)"
+options:
+  - label: "No watermark (Recommended)"
+    description: "No watermark, can enable later in EXTEND.md"
+```
+
+Position defaults to bottom-right.
+
+### Question 2: Preferred Style
+
+```
+header: "Style"
+question: "Default illustration style preference? Or type another style name or your custom style"
+options:
+  - label: "None (Recommended)"
+    description: "Auto-select based on content analysis"
+  - label: "notion"
+    description: "Minimalist hand-drawn line art"
+  - label: "warm"
+    description: "Friendly, approachable, personal"
+```
+
+### Question 3: Save Location
+
+```
+header: "Save"
+question: "Where to save preferences?"
+options:
+  - label: "Project"
+    description: ".baoyu-skills/ (this project only)"
+  - label: "User"
+    description: "~/.baoyu-skills/ (all projects)"
+```
+
+## Save Locations
+
+| Choice | Path | Scope |
+|--------|------|-------|
+| Project | `.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | Current project |
+| User | `~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | All projects |
+
+## After Setup
+
+1. Create directory if needed
+2. Write EXTEND.md with frontmatter
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1
+
+## EXTEND.md Template
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: [true/false]
+  content: "[user input or empty]"
+  position: bottom-right
+  opacity: 0.7
+preferred_style:
+  name: [selected style or null]
+  description: ""
+language: null
+custom_styles: []
+---
+```
+
+## Modifying Preferences Later
+
+Users can edit EXTEND.md directly or run setup again:
+- Delete EXTEND.md to trigger setup
+- Edit YAML frontmatter for quick changes
+- Full schema: `config/preferences-schema.md`
@@ -0,0 +1,116 @@
+---
+name: preferences-schema
+description: EXTEND.md YAML schema for baoyu-article-illustrator user preferences
+---
+
+# Preferences Schema
+
+## Full Schema
+
+```yaml
+---
+version: 1
+
+watermark:
+  enabled: false
+  content: ""
+  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
+  opacity: 0.7            # 0.1-1.0
+
+preferred_style:
+  name: null              # Built-in or custom style name
+  description: ""         # Override/notes
+
+language: null            # zh|en|ja|ko|auto
+
+custom_styles:
+  - name: my-style
+    description: "Style description"
+    color_palette:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    visual_elements: "Clean lines, geometric shapes"
+    typography: "Modern sans-serif"
+    best_for: "Business, education"
+---
+```
+
+## Field Reference
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `version` | int | 1 | 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_style.name` | string | null | Style name or null |
+| `preferred_style.description` | string | "" | Custom notes/override |
+| `language` | string | null | Output language (null = auto-detect) |
+| `custom_styles` | array | [] | User-defined styles |
+
+## Position Options
+
+| Value | Description |
+|-------|-------------|
+| `bottom-right` | Lower right corner (default, most common) |
+| `bottom-left` | Lower left corner |
+| `bottom-center` | Bottom center |
+| `top-right` | Upper right corner |
+
+## Custom Style Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Unique style identifier (kebab-case) |
+| `description` | Yes | What the style conveys |
+| `color_palette.primary` | No | Main colors (array) |
+| `color_palette.background` | No | Background color |
+| `color_palette.accents` | No | Accent colors (array) |
+| `visual_elements` | No | Decorative elements |
+| `typography` | No | Font/lettering style |
+| `best_for` | No | Recommended content types |
+
+## Example: Minimal Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myusername"
+preferred_style:
+  name: notion
+---
+```
+
+## Example: Full Preferences
+
+```yaml
+---
+version: 1
+watermark:
+  enabled: true
+  content: "@myaccount"
+  position: bottom-right
+  opacity: 0.5
+
+preferred_style:
+  name: notion
+  description: "Clean illustrations for tech articles"
+
+language: zh
+
+custom_styles:
+  - name: corporate
+    description: "Professional B2B style"
+    color_palette:
+      primary: ["#1E3A5F", "#4A90D9"]
+      background: "#F5F7FA"
+      accents: ["#00B4D8", "#48CAE4"]
+    visual_elements: "Clean lines, subtle gradients, geometric shapes"
+    typography: "Modern sans-serif, professional"
+    best_for: "Business, SaaS, enterprise"
+---
+```
@@ -0,0 +1,117 @@
+# Style Reference
+
+## Style Gallery
+
+| Style | Description | Best For |
+|-------|-------------|----------|
+| `notion` (Default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity |
+| `elegant` | Refined, sophisticated | Business, thought leadership |
+| `warm` | Friendly, approachable | Personal growth, lifestyle, education |
+| `minimal` | Ultra-clean, zen-like | Philosophy, minimalism, core concepts |
+| `blueprint` | Technical schematics | Architecture, system design, engineering |
+| `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative |
+| `editorial` | Magazine-style infographic | Tech explainers, journalism |
+| `scientific` | Academic precise diagrams | Biology, chemistry, technical research |
+
+Full specifications: `references/styles/<style>.md`
+
+## Type × Style Compatibility Matrix
+
+| | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| infographic | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
+| scene | ✓ | ✓✓ | ✓ | ✗ | ✓✓ | ✓ | ✓ | ✗ |
+| flowchart | ✓✓ | ✓ | ✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ |
+| comparison | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ |
+| framework | ✓✓ | ✓ | ✓✓ | ✓✓ | ✗ | ✓✓ | ✓ | ✓✓ |
+| timeline | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
+
+✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended
+
+## Auto Selection by Type
+
+| Type | Primary Style | Secondary Styles |
+|------|---------------|------------------|
+| infographic | blueprint | notion, editorial, scientific |
+| scene | warm | watercolor, elegant |
+| flowchart | notion | blueprint, editorial |
+| comparison | notion | elegant, editorial |
+| framework | blueprint | notion, scientific |
+| timeline | elegant | warm, editorial |
+
+## Auto Selection by Content Signals
+
+| Content Signals | Recommended Type | Recommended Style |
+|-----------------|------------------|-------------------|
+| API, metrics, data, comparison, numbers | infographic | blueprint, notion |
+| Story, emotion, journey, experience, personal | scene | warm, watercolor |
+| How-to, steps, workflow, process, tutorial | flowchart | notion, minimal |
+| vs, pros/cons, before/after, alternatives | comparison | notion, elegant |
+| Framework, model, architecture, principles | framework | blueprint, notion |
+| History, timeline, progress, evolution | timeline | elegant, warm |
+| Knowledge, concept, productivity, SaaS, tool | infographic | notion |
+| Business, professional, strategy, corporate | framework | elegant |
+| Biology, chemistry, medical, scientific | infographic | scientific |
+| Explainer, journalism, magazine, investigation | infographic | editorial |
+
+## Style Characteristics by Type
+
+### infographic + blueprint
+- Technical precision, schematic lines
+- Grid-based layout, clear zones
+- Monospace labels, data-focused
+- Blue/white color scheme
+
+### infographic + notion
+- Hand-drawn feel, approachable
+- Soft icons, rounded elements
+- Neutral palette, clean backgrounds
+- Perfect for SaaS/productivity
+
+### scene + warm
+- Golden hour lighting, cozy atmosphere
+- Soft gradients, natural textures
+- Inviting, personal feeling
+- Great for storytelling
+
+### scene + watercolor
+- Artistic, painterly effect
+- Soft edges, color bleeding
+- Dreamy, creative mood
+- Best for lifestyle/travel
+
+### flowchart + notion
+- Clear step indicators
+- Simple arrow connections
+- Minimal decoration
+- Focus on process clarity
+
+### flowchart + blueprint
+- Technical precision
+- Detailed connection points
+- Engineering aesthetic
+- For complex systems
+
+### comparison + elegant
+- Refined dividers
+- Balanced typography
+- Professional appearance
+- Business comparisons
+
+### framework + blueprint
+- Precise node connections
+- Hierarchical clarity
+- System architecture feel
+- Technical frameworks
+
+### timeline + elegant
+- Sophisticated markers
+- Refined typography
+- Historical gravitas
+- Professional presentations
+
+### timeline + warm
+- Friendly progression
+- Organic flow
+- Personal journey feel
+- Growth narratives