baoyu-skills/skills/baoyu-comic/references/config/preferences-schema.md

name, description

name	description
preferences-schema	EXTEND.md YAML schema for baoyu-comic user preferences

Preferences Schema

Full Schema

---
version: 2

watermark:
  enabled: false
  content: ""
  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right

preferred_art: null       # ligne-claire|manga|realistic|ink-brush|chalk|minimalist
preferred_tone: null      # neutral|warm|dramatic|romantic|energetic|vintage|action
preferred_layout: null    # standard|cinematic|dense|splash|mixed|webtoon|four-panel
preferred_aspect: null    # 3:4|4:3|16:9

language: null            # zh|en|ja|ko|auto

preferred_image_backend: auto  # auto|ask|<backend-id>

generation_batch_size: 4       # 1-8, used when backend/runtime supports batch or parallel page generation

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-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.
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