156 lines
4.5 KiB
Markdown
156 lines
4.5 KiB
Markdown
---
|
|
name: preferences-schema
|
|
description: EXTEND.md YAML schema for baoyu-comic user preferences
|
|
---
|
|
|
|
# Preferences Schema
|
|
|
|
## Full Schema
|
|
|
|
```yaml
|
|
---
|
|
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
|
|
preferred_tone: null # neutral|warm|dramatic|romantic|energetic|vintage|action
|
|
preferred_layout: null # standard|cinematic|dense|splash|mixed|webtoon
|
|
preferred_aspect: null # 3:4|4:3|16:9
|
|
|
|
language: null # zh|en|ja|ko|auto
|
|
|
|
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) |
|
|
| `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) |
|
|
| `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 |
|
|
|
|
## 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
|
|
|
|
```yaml
|
|
---
|
|
version: 2
|
|
watermark:
|
|
enabled: true
|
|
content: "@myusername"
|
|
preferred_art: ligne-claire
|
|
preferred_tone: neutral
|
|
---
|
|
```
|
|
|
|
## Example: Full Preferences
|
|
|
|
```yaml
|
|
---
|
|
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
|
|
|
|
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 |
|