1---
2name: preferences-schema
3description: EXTEND.md YAML schema for baoyu-xhs-images 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_layout: null    # sparse|balanced|dense|list|comparison|flow
24 
25language: null            # zh|en|ja|ko|auto
26 
27preferred_image_backend: auto  # auto|ask|<backend-id>
28 
29custom_styles:
30  - name: my-style
31    description: "Style description"
32    color_palette:
33      primary: ["#FED7E2", "#FEEBC8"]
34      background: "#FFFAF0"
35      accents: ["#FF69B4", "#FF6B6B"]
36    visual_elements: "Hearts, stars, sparkles"
37    typography: "Rounded, bubbly hand lettering"
38    best_for: "Lifestyle, beauty"
39---
40```
41 
42## Field Reference
43 
44| Field | Type | Default | Description |
45|-------|------|---------|-------------|
46| `version` | int | 1 | Schema version |
47| `watermark.enabled` | bool | false | Enable watermark |
48| `watermark.content` | string | "" | Watermark text (@username or custom) |
49| `watermark.position` | enum | bottom-right | Position on image |
50| `preferred_style.name` | string | null | Style name or null |
51| `preferred_style.description` | string | "" | Custom notes/override |
52| `preferred_layout` | string | null | Layout preference or null |
53| `language` | string | null | Output language (null = auto-detect) |
54| `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-imagine`, `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. |
55| `custom_styles` | array | [] | User-defined styles |
56 
57## Position Options
58 
59| Value | Description |
60|-------|-------------|
61| `bottom-right` | Lower right corner (default, most common) |
62| `bottom-left` | Lower left corner |
63| `bottom-center` | Bottom center |
64| `top-right` | Upper right corner |
65 
66## Custom Style Fields
67 
68| Field | Required | Description |
69|-------|----------|-------------|
70| `name` | Yes | Unique style identifier (kebab-case) |
71| `description` | Yes | What the style conveys |
72| `color_palette.primary` | No | Main colors (array) |
73| `color_palette.background` | No | Background color |
74| `color_palette.accents` | No | Accent colors (array) |
75| `visual_elements` | No | Decorative elements |
76| `typography` | No | Font/lettering style |
77| `best_for` | No | Recommended content types |
78 
79## Example: Minimal Preferences
80 
81```yaml
82---
83version: 1
84watermark:
85  enabled: true
86  content: "@myusername"
87preferred_style:
88  name: notion
89---
90```
91 
92## Example: Full Preferences
93 
94```yaml
95---
96version: 1
97watermark:
98  enabled: true
99  content: "@myxhsaccount"
100  position: bottom-right
101 
102preferred_style:
103  name: notion
104  description: "Clean knowledge cards for tech content"
105 
106preferred_layout: dense
107 
108language: zh
109 
110preferred_image_backend: codex-imagegen
111 
112custom_styles:
113  - name: corporate
114    description: "Professional B2B style"
115    color_palette:
116      primary: ["#1E3A5F", "#4A90D9"]
117      background: "#F5F7FA"
118      accents: ["#00B4D8", "#48CAE4"]
119    visual_elements: "Clean lines, subtle gradients, geometric shapes"
120    typography: "Modern sans-serif, professional"
121    best_for: "Business, SaaS, enterprise"
122---
123```
124