references/config/preferences-schema.md
5.7 KB查看排版效果| 1 | --- |
| 2 | name: preferences-schema |
| 3 | description: EXTEND.md YAML schema for baoyu-comic user preferences |
| 4 | --- |
| 5 | |
| 6 | # Preferences Schema |
| 7 | |
| 8 | ## Full Schema |
| 9 | |
| 10 | ```yaml |
| 11 | --- |
| 12 | version: 2 |
| 13 | |
| 14 | watermark: |
| 15 | enabled: false |
| 16 | content: "" |
| 17 | position: bottom-right # bottom-right|bottom-left|bottom-center|top-right |
| 18 | |
| 19 | preferred_art: null # ligne-claire|manga|realistic|ink-brush|chalk|minimalist |
| 20 | preferred_tone: null # neutral|warm|dramatic|romantic|energetic|vintage|action |
| 21 | preferred_layout: null # standard|cinematic|dense|splash|mixed|webtoon|four-panel |
| 22 | preferred_aspect: null # 3:4|4:3|16:9 |
| 23 | |
| 24 | language: null # zh|en|ja|ko|auto |
| 25 | |
| 26 | preferred_image_backend: auto # auto|ask|<backend-id> |
| 27 | |
| 28 | generation_batch_size: 4 # 1-8, used when backend/runtime supports batch or parallel page generation |
| 29 | |
| 30 | character_presets: |
| 31 | - name: my-characters |
| 32 | roles: |
| 33 | learner: "Name" |
| 34 | mentor: "Name" |
| 35 | challenge: "Name" |
| 36 | support: "Name" |
| 37 | --- |
| 38 | ``` |
| 39 | |
| 40 | ## Field Reference |
| 41 | |
| 42 | | Field | Type | Default | Description | |
| 43 | |-------|------|---------|-------------| |
| 44 | | `version` | int | 2 | Schema version | |
| 45 | | `watermark.enabled` | bool | false | Enable watermark | |
| 46 | | `watermark.content` | string | "" | Watermark text (@username or custom) | |
| 47 | | `watermark.position` | enum | bottom-right | Position on image | |
| 48 | | `preferred_art` | string | null | Art style (ligne-claire, manga, realistic, ink-brush, chalk, minimalist) | |
| 49 | | `preferred_tone` | string | null | Tone (neutral, warm, dramatic, romantic, energetic, vintage, action) | |
| 50 | | `preferred_layout` | string | null | Layout preference or null | |
| 51 | | `preferred_aspect` | string | null | Aspect ratio (3:4, 4:3, 16:9) | |
| 52 | | `language` | string | null | Output language (null = auto-detect) | |
| 53 | | `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. | |
| 54 | | `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. | |
| 55 | | `character_presets` | array | [] | Preset character roles for styles like ohmsha | |
| 56 | |
| 57 | ## Art Style Options |
| 58 | |
| 59 | | Value | 中文 | Description | |
| 60 | |-------|------|-------------| |
| 61 | | `ligne-claire` | 清线 | Uniform lines, flat colors, European comic tradition | |
| 62 | | `manga` | 日漫 | Large eyes, manga conventions, expressive emotions | |
| 63 | | `realistic` | 写实 | Digital painting, realistic proportions | |
| 64 | | `ink-brush` | 水墨 | Chinese brush strokes, ink wash effects | |
| 65 | | `chalk` | 粉笔 | Chalkboard aesthetic, hand-drawn warmth | |
| 66 | | `minimalist` | 极简 | Clean black line art, limited spot color, stick-figure characters | |
| 67 | |
| 68 | ## Tone Options |
| 69 | |
| 70 | | Value | 中文 | Description | |
| 71 | |-------|------|-------------| |
| 72 | | `neutral` | 中性 | Balanced, rational, educational | |
| 73 | | `warm` | 温馨 | Nostalgic, personal, comforting | |
| 74 | | `dramatic` | 戏剧 | High contrast, intense, powerful | |
| 75 | | `romantic` | 浪漫 | Soft, beautiful, decorative elements | |
| 76 | | `energetic` | 活力 | Bright, dynamic, exciting | |
| 77 | | `vintage` | 复古 | Historical, aged, period authenticity | |
| 78 | | `action` | 动作 | Speed lines, impact effects, combat | |
| 79 | |
| 80 | ## Position Options |
| 81 | |
| 82 | | Value | Description | |
| 83 | |-------|-------------| |
| 84 | | `bottom-right` | Lower right corner (default, works with most panel layouts) | |
| 85 | | `bottom-left` | Lower left corner | |
| 86 | | `bottom-center` | Bottom center (good for webtoon vertical scroll) | |
| 87 | | `top-right` | Upper right corner (avoid - conflicts with page numbers) | |
| 88 | |
| 89 | ## Character Preset Fields |
| 90 | |
| 91 | | Field | Required | Description | |
| 92 | |-------|----------|-------------| |
| 93 | | `name` | Yes | Unique preset identifier | |
| 94 | | `roles.learner` | No | Character representing the learner/protagonist | |
| 95 | | `roles.mentor` | No | Character representing the teacher/guide | |
| 96 | | `roles.challenge` | No | Character representing obstacles/antagonist | |
| 97 | | `roles.support` | No | Character providing support/comic relief | |
| 98 | |
| 99 | ## Example: Minimal Preferences |
| 100 | |
| 101 | ```yaml |
| 102 | --- |
| 103 | version: 2 |
| 104 | watermark: |
| 105 | enabled: true |
| 106 | content: "@myusername" |
| 107 | preferred_art: ligne-claire |
| 108 | preferred_tone: neutral |
| 109 | --- |
| 110 | ``` |
| 111 | |
| 112 | ## Example: Full Preferences |
| 113 | |
| 114 | ```yaml |
| 115 | --- |
| 116 | version: 2 |
| 117 | watermark: |
| 118 | enabled: true |
| 119 | content: "@comicstudio" |
| 120 | position: bottom-right |
| 121 | |
| 122 | preferred_art: manga |
| 123 | preferred_tone: neutral |
| 124 | |
| 125 | preferred_layout: webtoon |
| 126 | |
| 127 | preferred_aspect: "3:4" |
| 128 | |
| 129 | language: zh |
| 130 | |
| 131 | preferred_image_backend: codex-imagegen |
| 132 | |
| 133 | generation_batch_size: 4 |
| 134 | |
| 135 | character_presets: |
| 136 | - name: tech-tutorial |
| 137 | roles: |
| 138 | learner: "小明" |
| 139 | mentor: "教授" |
| 140 | challenge: "难题怪" |
| 141 | support: "小助手" |
| 142 | - name: doraemon |
| 143 | roles: |
| 144 | learner: "大雄" |
| 145 | mentor: "哆啦A梦" |
| 146 | challenge: "胖虎" |
| 147 | support: "静香" |
| 148 | --- |
| 149 | ``` |
| 150 | |
| 151 | ## Migration from v1 |
| 152 | |
| 153 | If you have a v1 preferences file with `preferred_style`, migrate as follows: |
| 154 | |
| 155 | | Old `preferred_style.name` | New `preferred_art` | New `preferred_tone` | |
| 156 | |---------------------------|---------------------|---------------------| |
| 157 | | classic | ligne-claire | neutral | |
| 158 | | dramatic | ligne-claire | dramatic | |
| 159 | | warm | ligne-claire | warm | |
| 160 | | sepia | realistic | vintage | |
| 161 | | vibrant | manga | energetic | |
| 162 | | ohmsha | manga | neutral | |
| 163 | | realistic | realistic | neutral | |
| 164 | | wuxia | ink-brush | action | |
| 165 | | shoujo | manga | romantic | |
| 166 | | chalkboard | chalk | neutral | |
文件内容是平台检查时读出的文本，只供查看。平台不会运行包里的任何脚本或程序。
