name: preferences-schema
description: EXTEND.md YAML schema for baoyu-comic user preferences
Preferences Schema
Full Schema
---
version: 2
watermark:
enabled: false
content: ""
position: bottom-right
preferred_art: null
preferred_tone: null
preferred_layout: null
preferred_aspect: null
language: null
preferred_image_backend: auto
generation_batch_size: 4
character_presets:
- name: my-characters
roles:
learner: "Name"
mentor: "Name"
challenge: "Name"
support: "Name"
---
Field Reference
| Field |
Type |
Default |
Description |
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 |
preferred_art |
string |
null |
Art style (ligne-claire, manga, realistic, ink-brush, chalk, minimalist) |
preferred_tone |
string |
null |
Tone (neutral, warm, dramatic, romantic, energetic, vintage, action) |
preferred_layout |
string |
null |
Layout preference or null |
preferred_aspect |
string |
null |
Aspect ratio (3:4, 4:3, 16:9) |
language |
string |
null |
Output language (null = auto-detect) |
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. |
generation_batch_size |
int |
4 |
Number of page 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. |
character_presets |
array |
[] |
Preset character roles for styles like ohmsha |
Art Style Options
| Value |
中文 |
Description |
ligne-claire |
清线 |
Uniform lines, flat colors, European comic tradition |
manga |
日漫 |
Large eyes, manga conventions, expressive emotions |
realistic |
写实 |
Digital painting, realistic proportions |
ink-brush |
水墨 |
Chinese brush strokes, ink wash effects |
chalk |
粉笔 |
Chalkboard aesthetic, hand-drawn warmth |
minimalist |
极简 |
Clean black line art, limited spot color, stick-figure characters |
Tone Options
| Value |
中文 |
Description |
neutral |
中性 |
Balanced, rational, educational |
warm |
温馨 |
Nostalgic, personal, comforting |
dramatic |
戏剧 |
High contrast, intense, powerful |
romantic |
浪漫 |
Soft, beautiful, decorative elements |
energetic |
活力 |
Bright, dynamic, exciting |
vintage |
复古 |
Historical, aged, period authenticity |
action |
动作 |
Speed lines, impact effects, combat |
Position Options
| Value |
Description |
bottom-right |
Lower right corner (default, works with most panel layouts) |
bottom-left |
Lower left corner |
bottom-center |
Bottom center (good for webtoon vertical scroll) |
top-right |
Upper right corner (avoid - conflicts with page numbers) |
Character Preset Fields
| Field |
Required |
Description |
name |
Yes |
Unique preset identifier |
roles.learner |
No |
Character representing the learner/protagonist |
roles.mentor |
No |
Character representing the teacher/guide |
roles.challenge |
No |
Character representing obstacles/antagonist |
roles.support |
No |
Character providing support/comic relief |
Example: Minimal Preferences
---
version: 2
watermark:
enabled: true
content: "@myusername"
preferred_art: ligne-claire
preferred_tone: neutral
---
Example: Full Preferences
---
version: 2
watermark:
enabled: true
content: "@comicstudio"
position: bottom-right
preferred_art: manga
preferred_tone: neutral
preferred_layout: webtoon
preferred_aspect: "3:4"
language: zh
preferred_image_backend: codex-imagegen
generation_batch_size: 4
character_presets:
- name: tech-tutorial
roles:
learner: "小明"
mentor: "教授"
challenge: "难题怪"
support: "小助手"
- name: doraemon
roles:
learner: "大雄"
mentor: "哆啦A梦"
challenge: "胖虎"
support: "静香"
---
Migration from v1
If you have a v1 preferences file with preferred_style, migrate as follows:
Old preferred_style.name |
New preferred_art |
New preferred_tone |
| classic |
ligne-claire |
neutral |
| dramatic |
ligne-claire |
dramatic |
| warm |
ligne-claire |
warm |
| sepia |
realistic |
vintage |
| vibrant |
manga |
energetic |
| ohmsha |
manga |
neutral |
| realistic |
realistic |
neutral |
| wuxia |
ink-brush |
action |
| shoujo |
manga |
romantic |
| chalkboard |
chalk |
neutral |