1---
2name: preferences-schema
3description: EXTEND.md YAML schema for baoyu-article-illustrator user preferences
4---
5 
6# Preferences Schema
7 
8## Full Schema
9 
10```yaml
11---
12version: 1
13 
14watermark:
15  enabled: false
16  content: ""
17  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
18 
19preferred_style:
20  name: null              # Built-in or custom style name
21  description: ""         # Override/notes
22 
23preferred_palette: null   # Built-in palette name (macaron|warm|neon) or null
24 
25language: null            # zh|en|ja|ko|auto
26 
27default_output_dir: null  # same-dir|illustrations-subdir|independent
28 
29preferred_image_backend: auto  # auto|ask|<backend-id>
30 
31generation_batch_size: 4       # 1-8, used when backend/runtime supports batch or parallel generation
32 
33custom_styles:
34  - name: my-style
35    description: "Style description"
36    color_palette:
37      primary: ["#1E3A5F", "#4A90D9"]
38      background: "#F5F7FA"
39      accents: ["#00B4D8", "#48CAE4"]
40    visual_elements: "Clean lines, geometric shapes"
41    typography: "Modern sans-serif"
42    best_for: "Business, education"
43---
44```
45 
46## Field Reference
47 
48| Field | Type | Default | Description |
49|-------|------|---------|-------------|
50| `version` | int | 1 | Schema version |
51| `watermark.enabled` | bool | false | Enable watermark |
52| `watermark.content` | string | "" | Watermark text (@username or custom) |
53| `watermark.position` | enum | bottom-right | Position on image |
54| `preferred_style.name` | string | null | Style name or null |
55| `preferred_style.description` | string | "" | Custom notes/override |
56| `preferred_palette` | string | null | Palette override (macaron, warm, neon, or null) |
57| `language` | string | null | Output language (null = auto-detect) |
58| `default_output_dir` | enum | null | Output directory preference (null = ask each time) |
59| `preferred_image_backend` | string | `auto` | Image backend selection. `auto` = prefer runtime-native tool, fall back to the only installed backend, ask if multiple non-native are present. `ask` = always confirm on every run. `<backend-id>` (e.g., `codex-imagegen`, `baoyu-image-gen`, `image_generate`) = pin this backend when available; fall back to `auto` when it isn't. Absent = `auto`. Resolution logic is documented in `SKILL.md`'s `## Image Generation Tools` section. |
60| `generation_batch_size` | int | 4 | Number of images to dispatch per batch when the backend has native batch support or the runtime can issue parallel generation calls. Clamp invalid values to 1-8. Current user request overrides this value. |
61| `custom_styles` | array | [] | User-defined styles |
62 
63## Position Options
64 
65| Value | Description |
66|-------|-------------|
67| `bottom-right` | Lower right corner (default, most common) |
68| `bottom-left` | Lower left corner |
69| `bottom-center` | Bottom center |
70| `top-right` | Upper right corner |
71 
72## Output Directory Options
73 
74| Value | Description |
75|-------|-------------|
76| `same-dir` | Same directory as article |
77| `illustrations-subdir` | `{article-dir}/illustrations/` subdirectory |
78| `independent` | `illustrations/{topic-slug}/` in working directory |
79 
80## Custom Style Fields
81 
82| Field | Required | Description |
83|-------|----------|-------------|
84| `name` | Yes | Unique style identifier (kebab-case) |
85| `description` | Yes | What the style conveys |
86| `color_palette.primary` | No | Main colors (array) |
87| `color_palette.background` | No | Background color |
88| `color_palette.accents` | No | Accent colors (array) |
89| `visual_elements` | No | Decorative elements |
90| `typography` | No | Font/lettering style |
91| `best_for` | No | Recommended content types |
92 
93## Example: Minimal Preferences
94 
95```yaml
96---
97version: 1
98watermark:
99  enabled: true
100  content: "@myusername"
101preferred_style:
102  name: notion
103---
104```
105 
106## Example: Full Preferences
107 
108```yaml
109---
110version: 1
111watermark:
112  enabled: true
113  content: "@myaccount"
114  position: bottom-right
115 
116preferred_style:
117  name: notion
118  description: "Clean illustrations for tech articles"
119 
120language: zh
121 
122preferred_image_backend: codex-imagegen
123 
124generation_batch_size: 4
125 
126custom_styles:
127  - name: corporate
128    description: "Professional B2B style"
129    color_palette:
130      primary: ["#1E3A5F", "#4A90D9"]
131      background: "#F5F7FA"
132      accents: ["#00B4D8", "#48CAE4"]
133    visual_elements: "Clean lines, subtle gradients, geometric shapes"
134    typography: "Modern sans-serif, professional"
135    best_for: "Business, SaaS, enterprise"
136---
137```
138