1# ohmsha
2 
3Ohmsha预设 - Educational manga with visual metaphors
4 
5## Base Configuration
6 
7| Dimension | Value |
8|-----------|-------|
9| Art Style | manga |
10| Tone | neutral |
11| Layout | webtoon (default) |
12 
13Equivalent to: `--art manga --tone neutral`
14 
15## Unique Rules
16 
17This preset includes special rules beyond the art+tone combination. When `--style ohmsha` is used, ALL rules below must be applied.
18 
19### Visual Metaphor Requirements (CRITICAL)
20 
21Every technical concept MUST be visualized as a metaphor:
22 
23| Concept Type | Visualization Approach |
24|-------------|----------------------|
25| Algorithm | Gadget/machine that demonstrates the process |
26| Data structure | Physical space characters can enter/explore |
27| Mathematical formula | Transformation visible in environment |
28| Abstract process | Tangible flow of particles/objects |
29 
30**Wrong approach**: Character points at blackboard explaining
31**Right approach**: Character uses "Concept Visualizer" gadget, steps into metaphorical space
32 
33### Visual Metaphor Examples
34 
35| Concept | Wrong (Talking Head) | Right (Visual Metaphor) |
36|---------|---------------------|------------------------|
37| Attention mechanism | Character points at formula on blackboard | "Attention Flashlight" gadget illuminates key words in dark room |
38| Gradient descent | "The algorithm minimizes loss" | Character rides ball rolling down mountain valley |
39| Neural network | Diagram with arrows | Living network of glowing creatures passing messages |
40| Overfitting | "The model memorized the data" | Character wearing clothes that fit only one specific pose |
41 
42### Character Roles (Required)
43 
44**DEFAULT: Use Doraemon characters** unless user explicitly specifies `--characters` or has character presets in EXTEND.md.
45 
46| Role | Default Character | Visual | Traits |
47|------|-------------------|--------|--------|
48| Student (Role A) | 大雄 (Nobita) | Boy, 10yo, round glasses, black hair, yellow shirt, navy shorts | Confused, asks basic but crucial questions, represents reader |
49| Mentor (Role B) | 哆啦A梦 (Doraemon) | Blue robot cat, white belly, 4D pocket, red nose, golden bell | Knowledgeable, patient, uses gadgets as technical metaphors |
50| Challenge (Role C) | 胖虎 (Gian) | Stocky boy, small eyes, orange shirt | Represents misunderstanding, or "noise" in the data |
51| Support (Role D) | 静香 (Shizuka) | Cute girl, black short hair, pink dress | Asks clarifying questions, provides alternative perspectives |
52 
53**IMPORTANT**: These Doraemon characters ARE the default for ohmsha preset. Generate character definitions using these exact characters unless user requests otherwise.
54 
55To use custom characters: `--characters "Student:小明,Mentor:教授"` or define in EXTEND.md.
56 
57### Page Title Convention
58 
59Every page MUST have a narrative title (not section header):
60 
61**Wrong**: "Chapter 1: Introduction to Transformers"
62**Right**: "The Day Nobita Couldn't Understand Anyone"
63 
64### Gadget Reveal Pattern
65 
66When introducing a concept:
67 
681. Student expresses confusion with visual indicator (？, spiral eyes)
692. Mentor dramatically produces gadget with sparkle effects
703. Gadget name announced in bold with explanation
714. Demonstration begins - student enters metaphorical space
72 
73### Ending Requirements
74 
75Final page MUST include:
76 
771. Student demonstrating understanding (applying the concept)
782. Callback to opening problem (now resolved)
793. Mentor's satisfied expression
804. Optional: hint at next topic
81 
82### NO Talking Heads Rule
83 
84**Critical**: Characters must DO things, not just explain.
85 
86Every panel should show:
87- Action being performed
88- Metaphor being demonstrated
89- Character interaction with concept-space
90- NOT: two characters facing each other talking
91 
92### Special Visual Elements
93 
94| Element | Usage |
95|---------|-------|
96| Gadget reveals | Dramatic unveiling with sparkle effects |
97| Concept spaces | Rounded borders, glowing edges for "imagination mode" |
98| Information displays | Holographic UI style for technical details |
99| Aha moments | Radial lines, light burst effects |
100| Confusion | Spiral eyes, question marks floating above head |
101 
102## Quality Markers
103 
104- ✓ Every concept is a visual metaphor
105- ✓ Characters are DOING things, not just talking
106- ✓ Clear student/mentor dynamic
107- ✓ Gadgets and props drive the explanation
108- ✓ Expressive manga-style emotions
109- ✓ Information density through visual design, not text walls
110- ✓ Narrative page titles
111 
112## Reference
113 
114For complete guidelines, see `references/ohmsha-guide.md`
115