references/config/preferences-schema.md
5.7 KB查看源码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-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 |
文件内容是平台检查时读出的文本,只供查看。平台不会运行包里的任何脚本或程序。

