mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-13 22:29:48 +08:00
feat: update version to 0.5.1 and enhance baoyu-comic documentation with character and outline templates
This commit is contained in:
Jim Liu 宝玉
@@ -6,7 +6,7 @@
|
|||||||
},
|
},
|
||||||
"metadata": {
|
"metadata": {
|
||||||
"description": "Skills shared by Baoyu for improving daily work efficiency",
|
"description": "Skills shared by Baoyu for improving daily work efficiency",
|
||||||
"version": "0.5.0"
|
"version": "0.5.1"
|
||||||
},
|
},
|
||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
|
|||||||
+86
-336
@@ -5,384 +5,134 @@ description: Knowledge comic creator supporting multiple styles (Logicomix/Ligne
|
|||||||
|
|
||||||
# Knowledge Comic Creator
|
# Knowledge Comic Creator
|
||||||
|
|
||||||
Create original knowledge comics supporting multiple visual styles: Logicomix-style Ligne Claire, Ohmsha manga guide, and more.
|
Create original knowledge comics with multiple visual styles.
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# From source material
|
|
||||||
/baoyu-comic posts/turing-story/source.md
|
/baoyu-comic posts/turing-story/source.md
|
||||||
|
/baoyu-comic posts/turing-story/source.md --style dramatic --layout cinematic
|
||||||
# Specify style
|
/baoyu-comic # then paste content
|
||||||
/baoyu-comic posts/turing-story/source.md --style dramatic
|
|
||||||
|
|
||||||
# Specify layout preference
|
|
||||||
/baoyu-comic posts/turing-story/source.md --layout cinematic
|
|
||||||
|
|
||||||
# Direct content input
|
|
||||||
/baoyu-comic
|
|
||||||
[paste story content or topic description]
|
|
||||||
|
|
||||||
# Direct input with options
|
|
||||||
/baoyu-comic --style warm --layout dense
|
|
||||||
[paste content]
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Options
|
## Options
|
||||||
|
|
||||||
| Option | Description |
|
| Option | Values |
|
||||||
|--------|-------------|
|
|--------|--------|
|
||||||
| `--style <name>` | Visual style (see Style Gallery) |
|
| `--style` | classic (default), dramatic, warm, tech, sepia, vibrant, ohmsha |
|
||||||
| `--layout <name>` | Panel layout preference (see Layout Gallery) |
|
| `--layout` | standard (default), cinematic, dense, splash, mixed, webtoon |
|
||||||
|
|
||||||
## Two Dimensions
|
Style × Layout can be freely combined.
|
||||||
|
|
||||||
| Dimension | Controls | Options |
|
## Auto Selection
|
||||||
|-----------|----------|---------|
|
|
||||||
| **Style** | Color palette, mood, era treatment | classic, dramatic, warm, tech, sepia, vibrant, ohmsha |
|
|
||||||
| **Layout** | Panel arrangement, density | standard, cinematic, dense, splash, mixed, webtoon |
|
|
||||||
|
|
||||||
Style × Layout can be freely combined. Example: `--style dramatic --layout cinematic` creates high-contrast panels with wide aspect ratios.
|
| Content Signals | Style | Layout |
|
||||||
|
|-----------------|-------|--------|
|
||||||
|
| Tutorial, how-to, beginner | ohmsha | webtoon |
|
||||||
|
| Computing, AI, programming | tech | dense |
|
||||||
|
| Pre-1950, classical, ancient | sepia | cinematic |
|
||||||
|
| Personal story, mentor | warm | standard |
|
||||||
|
| Conflict, breakthrough | dramatic | splash |
|
||||||
|
| Biography, balanced | classic | mixed |
|
||||||
|
|
||||||
## Style Gallery
|
## File Structure
|
||||||
|
|
||||||
| Style | Description |
|
|
||||||
|-------|-------------|
|
|
||||||
| `classic` (Default) | Traditional Ligne Claire, balanced and timeless |
|
|
||||||
| `dramatic` | High contrast, intense moments |
|
|
||||||
| `warm` | Nostalgic, personal storytelling |
|
|
||||||
| `tech` | Modern, digital-age narratives |
|
|
||||||
| `sepia` | Historical, archival feel |
|
|
||||||
| `vibrant` | Energetic, engaging, educational |
|
|
||||||
| `ohmsha` | Ohmsha Manga Guide style - educational manga with visual metaphors |
|
|
||||||
|
|
||||||
Detailed style definitions: `references/styles/<style>.md`
|
|
||||||
|
|
||||||
## Layout Gallery
|
|
||||||
|
|
||||||
| Layout | Description |
|
|
||||||
|--------|-------------|
|
|
||||||
| `standard` (Default) | Classic comic grid, versatile (4-6 panels) |
|
|
||||||
| `cinematic` | Wide panels, filmic feel (2-4 panels) |
|
|
||||||
| `dense` | Information-rich, educational focus (6-9 panels) |
|
|
||||||
| `splash` | Impact-focused, key moments (1-2 large + 2-3 small) |
|
|
||||||
| `mixed` | Dynamic, varied rhythm (3-7 panels) |
|
|
||||||
| `webtoon` | Vertical scrolling comic (竖版条漫) |
|
|
||||||
|
|
||||||
Detailed layout definitions: `references/layouts/<layout>.md`
|
|
||||||
|
|
||||||
## Auto Style Selection
|
|
||||||
|
|
||||||
When no `--style` is specified, analyze content to select:
|
|
||||||
|
|
||||||
| Content Signals | Selected Style |
|
|
||||||
|----------------|----------------|
|
|
||||||
| Tutorial, how-to, learning guide, beginner | `ohmsha` |
|
|
||||||
| Computing, AI, digital, programming | `tech` |
|
|
||||||
| Pre-1950, classical, ancient | `sepia` |
|
|
||||||
| Personal story, childhood, mentor | `warm` |
|
|
||||||
| Conflict, struggle, breakthrough | `dramatic` |
|
|
||||||
| Young audience, science basics, wonder | `vibrant` |
|
|
||||||
| Balanced narrative, biography | `classic` |
|
|
||||||
|
|
||||||
## Auto Layout Selection
|
|
||||||
|
|
||||||
When no `--layout` is specified, analyze content to select:
|
|
||||||
|
|
||||||
| Content Signals | Selected Layout |
|
|
||||||
|----------------|-----------------|
|
|
||||||
| Technical explanation, timeline | `dense` |
|
|
||||||
| Key discovery, major event | `splash` |
|
|
||||||
| Establishing scene, location | `cinematic` |
|
|
||||||
| Dialogue, conversation, debate | `standard` |
|
|
||||||
| Mixed content, varied pacing | `mixed` |
|
|
||||||
| Ohmsha style, tutorial, vertical scroll | `webtoon` |
|
|
||||||
|
|
||||||
## Style × Layout Matrix
|
|
||||||
|
|
||||||
| | standard | cinematic | dense | splash | mixed | webtoon |
|
|
||||||
|---|:---:|:---:|:---:|:---:|:---:|:---:|
|
|
||||||
| classic | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
|
|
||||||
| dramatic | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
|
|
||||||
| warm | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
|
|
||||||
| tech | ✓✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ |
|
|
||||||
| sepia | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
|
|
||||||
| vibrant | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓✓ |
|
|
||||||
| ohmsha | ✓ | ✓ | ✓✓ | ✓ | ✓✓ | ✓✓ |
|
|
||||||
|
|
||||||
✓✓ = highly recommended, ✓ = works well
|
|
||||||
|
|
||||||
## File Management
|
|
||||||
|
|
||||||
### With Source Path
|
|
||||||
|
|
||||||
Save to `comic/` subdirectory in the same folder as the source:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
posts/turing-story/
|
[target]/
|
||||||
├── source.md
|
├── outline.md
|
||||||
└── comic/
|
├── characters/
|
||||||
├── outline.md
|
│ ├── characters.md # Character definitions
|
||||||
├── prompts/
|
│ └── characters.png # Character reference sheet
|
||||||
│ ├── 00-cover.md
|
├── prompts/
|
||||||
│ ├── 01-page.md
|
│ ├── 00-cover.md
|
||||||
│ └── ...
|
│ └── XX-page.md
|
||||||
├── 00-cover.png
|
├── 00-cover.png
|
||||||
├── 01-page.png
|
└── XX-page.png
|
||||||
└── ...
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Without Source Path
|
**Target directory**:
|
||||||
|
- With source path: `[source-dir]/comic/`
|
||||||
Save to `comic-outputs/YYYY-MM-DD/[topic-slug]/`:
|
- Without source: `comic-outputs/YYYY-MM-DD/[topic-slug]/`
|
||||||
|
|
||||||
```
|
|
||||||
comic-outputs/
|
|
||||||
└── 2026-01-16/
|
|
||||||
└── turing-biography/
|
|
||||||
├── outline.md
|
|
||||||
├── prompts/
|
|
||||||
│ ├── 00-cover.md
|
|
||||||
│ └── ...
|
|
||||||
├── 00-cover.png
|
|
||||||
└── ...
|
|
||||||
```
|
|
||||||
|
|
||||||
**Directory collision**: If slug exists, generate a different slug (do not overwrite).
|
|
||||||
|
|
||||||
## Workflow
|
## Workflow
|
||||||
|
|
||||||
### Step 1: Analyze Content & Determine Scope
|
### Step 1: Analyze Content
|
||||||
|
|
||||||
1. Read source content
|
1. Read source content
|
||||||
2. If `--style` specified, use it; otherwise auto-select
|
2. Select style (from `--style` or auto-detect)
|
||||||
3. If `--layout` specified, use it; otherwise auto-select per page
|
3. Select layout (from `--layout` or auto-detect per page)
|
||||||
4. Determine page count based on content complexity:
|
4. Determine page count:
|
||||||
|
- Short story: 5-8 pages
|
||||||
|
- Medium complexity: 9-15 pages
|
||||||
|
- Full biography: 16-25 pages
|
||||||
|
|
||||||
| Content Type | Page Count (incl. cover) |
|
### Step 2: Define Characters
|
||||||
|-------------|--------------------------|
|
|
||||||
| Single event / short story | 5-8 |
|
|
||||||
| Medium complexity / mini biography | 9-15 |
|
|
||||||
| Full biography / multi-thread | 16-25 |
|
|
||||||
|
|
||||||
### Step 2: Generate Outline
|
**Purpose**: Establish visual consistency across all pages.
|
||||||
|
|
||||||
Plan cover + each page with detailed panel breakdowns:
|
1. Extract all characters from content (protagonist, supporting, antagonist, narrator)
|
||||||
|
2. Create `characters/characters.md` with visual specs for each character
|
||||||
|
3. Generate `characters/characters.png` (character reference sheet)
|
||||||
|
|
||||||
```markdown
|
**Reference**: `references/character-template.md` for detailed format and examples.
|
||||||
# [Comic Title] - Knowledge Biography Comic Outline
|
|
||||||
|
|
||||||
**Topic**: [topic description]
|
### Step 3: Generate Outline
|
||||||
**Time Span**: [e.g., 1912-1954]
|
|
||||||
**Style**: [selected style]
|
|
||||||
**Default Layout**: [selected layout or "varies"]
|
|
||||||
**Page Count**: Cover + N pages
|
|
||||||
**Generated**: YYYY-MM-DD HH:mm
|
|
||||||
|
|
||||||
---
|
Create `outline.md` with:
|
||||||
|
- Metadata (title, style, layout, page count, character reference path)
|
||||||
|
- Cover design
|
||||||
|
- Each page: layout, panel breakdown, visual prompts
|
||||||
|
|
||||||
## Cover
|
**Reference**: `references/outline-template.md` for detailed format.
|
||||||
|
|
||||||
**Filename**: 00-cover.png
|
### Step 4: Generate Images
|
||||||
**Core Message**: [one-liner]
|
|
||||||
|
|
||||||
**Visual Design**:
|
For each page (cover + pages):
|
||||||
- Title typography style
|
|
||||||
- Main visual composition
|
|
||||||
- Color scheme
|
|
||||||
- Subtitle / time span notation
|
|
||||||
|
|
||||||
**Visual Prompt**:
|
1. Save prompt to `prompts/XX-page.md`
|
||||||
[Detailed image generation prompt]
|
2. Call image generation skill with:
|
||||||
|
- Base prompt: `references/base-prompt.md`
|
||||||
|
- Character reference (text or image, depending on skill capability)
|
||||||
|
- Page prompt
|
||||||
|
- Output path
|
||||||
|
|
||||||
---
|
**Image Generation Skill Selection**:
|
||||||
|
- Check available image generation skills in the environment
|
||||||
|
- Adapt parameters based on skill capabilities:
|
||||||
|
- If supports `--promptfiles`: pass prompt files
|
||||||
|
- If supports reference image: pass `characters/characters.png`
|
||||||
|
- If text-only: concatenate prompts into single text
|
||||||
|
- If multiple skills available, ask user preference
|
||||||
|
|
||||||
## Page 1 / N
|
3. Report progress after each generation
|
||||||
|
|
||||||
**Filename**: 01-page.png
|
|
||||||
**Layout**: [standard/cinematic/dense/splash/mixed]
|
|
||||||
**Narrative Layer**: [Main narrative / Narrator layer / Mixed]
|
|
||||||
**Core Message**: [What this page conveys]
|
|
||||||
|
|
||||||
### Panel Layout
|
|
||||||
|
|
||||||
**Panel Count**: X
|
|
||||||
**Layout Type**: [grid/irregular/splash]
|
|
||||||
|
|
||||||
#### Panel 1 (Size: 1/3 page, Position: Top)
|
|
||||||
|
|
||||||
**Scene**: [Time, location]
|
|
||||||
**Image Description**:
|
|
||||||
- Camera angle: [bird's eye / low angle / eye level / close-up / wide shot]
|
|
||||||
- Characters: [pose, expression, action]
|
|
||||||
- Environment: [scene details, period markers]
|
|
||||||
- Lighting: [atmosphere description]
|
|
||||||
- Color tone: [palette reference]
|
|
||||||
|
|
||||||
**Text Elements**:
|
|
||||||
- Dialogue bubble (oval): "Character line"
|
|
||||||
- Narrator box (rectangular): 「Narrator commentary」
|
|
||||||
- Caption bar: [Background info text]
|
|
||||||
|
|
||||||
#### Panel 2...
|
|
||||||
|
|
||||||
**Page Hook**: [Cliffhanger or transition at page end]
|
|
||||||
|
|
||||||
**Visual Prompt**:
|
|
||||||
[Full page image generation prompt]
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Page 2 / N
|
|
||||||
...
|
|
||||||
```
|
|
||||||
|
|
||||||
### Step 3: Save Outline
|
|
||||||
|
|
||||||
Save as `outline.md` in target directory.
|
|
||||||
|
|
||||||
### Step 4: Generate Images Page by Page
|
|
||||||
|
|
||||||
For each page:
|
|
||||||
|
|
||||||
1. **Save prompt file** to `prompts/` subdirectory
|
|
||||||
2. **Call image generation skill**:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npx -y bun skills/baoyu-gemini-web/scripts/main.ts \
|
|
||||||
--promptfiles skills/baoyu-comic/prompts/system.md [target]/prompts/00-cover.md \
|
|
||||||
--image [target]/00-cover.png
|
|
||||||
```
|
|
||||||
|
|
||||||
After each generation:
|
|
||||||
1. Confirm success
|
|
||||||
2. Report progress: "Generated X/N pages"
|
|
||||||
3. Continue to next
|
|
||||||
|
|
||||||
### Step 5: Completion Report
|
### Step 5: Completion Report
|
||||||
|
|
||||||
```
|
```
|
||||||
Knowledge Biography Comic Complete!
|
Comic Complete!
|
||||||
|
Title: [title] | Style: [style] | Pages: [count]
|
||||||
Title: [Comic Title]
|
Location: [path]
|
||||||
Time Span: [e.g., 1912-1954]
|
✓ characters.png
|
||||||
Style: [style name]
|
✓ 00-cover.png ... XX-page.png
|
||||||
Layout: [layout name or "varies"]
|
|
||||||
Location: [directory path]
|
|
||||||
Pages: Cover + N pages
|
|
||||||
|
|
||||||
- 00-cover.png ✓ Cover
|
|
||||||
- 01-page.png ✓ Opening: [brief]
|
|
||||||
- 02-page.png ✓ [brief]
|
|
||||||
- ...
|
|
||||||
- XX-page.png ✓ Ending: [brief]
|
|
||||||
|
|
||||||
Outline: outline.md
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Narrative Structure Principles
|
## Style-Specific Guidelines
|
||||||
|
|
||||||
### Cover Design
|
### Ohmsha Style (`--style ohmsha`)
|
||||||
|
|
||||||
- Academic gravitas with visual appeal
|
Additional requirements for educational manga:
|
||||||
- Title typography reflecting knowledge/science theme
|
- Default characters: Student (大雄), Mentor (哆啦A梦), Antagonist (胖虎)
|
||||||
- Composition hinting at core theme (character silhouette, iconic symbol, concept diagram)
|
- Custom: `--characters "Student:小明,Mentor:教授"`
|
||||||
- Subtitle or time span for epic scope
|
- Must use visual metaphors (gadgets, action scenes) - NO talking heads
|
||||||
|
- Page titles: narrative style, not "Page X: Topic"
|
||||||
|
|
||||||
### Panel Composition Principles
|
**Reference**: `references/ohmsha-guide.md` for detailed guidelines.
|
||||||
|
|
||||||
| Panel Type | Recommended Count | Usage |
|
## References
|
||||||
|-----------|-------------------|-------|
|
|
||||||
| Main narrative | 3-5 per page | Story progression |
|
|
||||||
| Concept diagram | 1-2 per page | Visualize abstractions |
|
|
||||||
| Narrator panel | 0-1 per page | Commentary, transition, questions |
|
|
||||||
| Splash (full/half) | Occasional | Major moments |
|
|
||||||
|
|
||||||
### Panel Size Reference
|
Detailed templates and guidelines in `references/` directory:
|
||||||
|
- `character-template.md` - Character definition format and examples
|
||||||
- **Full page (Splash)**: Major moments, key breakthroughs
|
- `outline-template.md` - Outline structure and panel breakdown
|
||||||
- **Half page**: Important scenes, turning points
|
- `ohmsha-guide.md` - Ohmsha manga style specifics
|
||||||
- **1/3 page**: Standard narrative panels
|
- `styles/` - Detailed style definitions
|
||||||
- **1/4 or smaller**: Quick progression, sequential action
|
- `layouts/` - Detailed layout definitions
|
||||||
|
|
||||||
### Concept Visualization Techniques
|
|
||||||
|
|
||||||
Transform abstract concepts into concrete visuals:
|
|
||||||
|
|
||||||
| Abstract Concept | Visual Approach |
|
|
||||||
|-----------------|-----------------|
|
|
||||||
| Neural network | Glowing nodes with connecting lines |
|
|
||||||
| Gradient descent | Ball rolling down valley terrain |
|
|
||||||
| Data flow | Luminous particles flowing through pipes |
|
|
||||||
| Algorithm iteration | Ascending spiral staircase |
|
|
||||||
| Breakthrough moment | Shattering barrier, piercing light |
|
|
||||||
| Logical proof | Building blocks assembling |
|
|
||||||
| Uncertainty | Forking paths, fog, multiple shadows |
|
|
||||||
|
|
||||||
### Text Element Design
|
|
||||||
|
|
||||||
| Text Type | Style | Usage |
|
|
||||||
|-----------|-------|-------|
|
|
||||||
| Character dialogue | Oval speech bubble | Main narrative speech |
|
|
||||||
| Narrator commentary | Rectangular / hand-drawn box | Explanation, commentary |
|
|
||||||
| Caption bar | Edge-mounted rectangle | Time, location info |
|
|
||||||
| Thought bubble | Cloud shape | Character inner monologue |
|
|
||||||
| Term label | Bold / special color | First appearance of technical terms |
|
|
||||||
|
|
||||||
## Ohmsha Style Special Requirements
|
|
||||||
|
|
||||||
When using `--style ohmsha`, follow these additional guidelines:
|
|
||||||
|
|
||||||
### Character Setup (Required)
|
|
||||||
|
|
||||||
Define characters before generating outline:
|
|
||||||
|
|
||||||
| Role | Default | Traits |
|
|
||||||
|------|---------|--------|
|
|
||||||
| Student (Role A) | 大雄 | Confused, asks basic but crucial questions, represents reader |
|
|
||||||
| Mentor (Role B) | 哆啦A梦 | Knowledgeable, patient, uses gadgets as technical metaphors |
|
|
||||||
| Antagonist (Role C, optional) | 胖虎 | Represents misunderstanding, or "noise" in the data |
|
|
||||||
|
|
||||||
User can specify custom characters via `--characters "Student:小明,Mentor:教授,Antagonist:Bug怪"`
|
|
||||||
|
|
||||||
### Outline Spec Block (Required)
|
|
||||||
|
|
||||||
Every ohmsha outline must start with a spec block:
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
【漫画规格单】
|
|
||||||
- Language: [Same as input content]
|
|
||||||
- Style: Ohmsha (Manga Guide), Full Color
|
|
||||||
- Layout: Vertical Scrolling Comic (竖版条漫)
|
|
||||||
- Characters: [List character names and roles]
|
|
||||||
- Page Limit: ≤20 pages
|
|
||||||
```
|
|
||||||
|
|
||||||
### Visual Metaphor Rules (Critical)
|
|
||||||
|
|
||||||
**NEVER** create "talking heads" panels. Every technical concept must become:
|
|
||||||
|
|
||||||
1. **A tangible gadget/prop** - Something characters can hold, use, demonstrate
|
|
||||||
2. **An action scene** - Characters doing something that illustrates the concept
|
|
||||||
3. **A visual environment** - Stepping into a metaphorical space
|
|
||||||
|
|
||||||
### Page Title Convention
|
|
||||||
|
|
||||||
Avoid AI-style "Title: Subtitle" format. Use narrative descriptions:
|
|
||||||
- ❌ "Page 3: Introduction to Neural Networks"
|
|
||||||
- ✓ "Page 3: 大雄被海量单词淹没，哆啦A梦拿出'词向量压缩机'"
|
|
||||||
|
|
||||||
### Ending Requirements
|
|
||||||
|
|
||||||
- NO generic endings ("What will you choose?", "Thanks for reading")
|
|
||||||
- End with: Technical summary moment OR character achieving a small goal
|
|
||||||
- Final panel: Sense of accomplishment, not open-ended question
|
|
||||||
|
|
||||||
## Notes
|
|
||||||
|
|
||||||
- Image generation typically takes 30-60 seconds per page
|
|
||||||
- Auto-retry once on generation failure
|
|
||||||
- Historical figures rendered in portrait/illustration style for recognizability
|
|
||||||
- All text in Chinese unless source is in another language
|
|
||||||
- Each panel description should be detailed enough to serve as standalone AI art prompt
|
|
||||||
- Maintain style consistency across all pages in series
|
|
||||||
|
|||||||
@@ -0,0 +1,180 @@
|
|||||||
|
# Character Definition Template
|
||||||
|
|
||||||
|
## Character Document Format
|
||||||
|
|
||||||
|
Create `characters/characters.md` with the following structure:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Character Definitions - [Comic Title]
|
||||||
|
|
||||||
|
**Style**: [selected style]
|
||||||
|
**Art Direction**: [Ligne Claire / Manga / etc.]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Character 1: [Name]
|
||||||
|
|
||||||
|
**Role**: [Protagonist / Mentor / Antagonist / Narrator]
|
||||||
|
**Age**: [approximate age or age range in story]
|
||||||
|
|
||||||
|
**Appearance**:
|
||||||
|
- Face shape: [oval/square/round]
|
||||||
|
- Hair: [color, style, length]
|
||||||
|
- Eyes: [color, shape, distinctive features]
|
||||||
|
- Build: [height, body type]
|
||||||
|
- Distinguishing features: [glasses, beard, scar, etc.]
|
||||||
|
|
||||||
|
**Costume**:
|
||||||
|
- Default outfit: [detailed description]
|
||||||
|
- Color palette: [primary colors for this character]
|
||||||
|
- Accessories: [hat, bag, tools, etc.]
|
||||||
|
|
||||||
|
**Expression Range**:
|
||||||
|
- Neutral: [description]
|
||||||
|
- Happy/Excited: [description]
|
||||||
|
- Thinking/Confused: [description]
|
||||||
|
- Determined: [description]
|
||||||
|
|
||||||
|
**Visual Reference Notes**:
|
||||||
|
[Any specific artistic direction]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Character 2: [Name]
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
## Reference Sheet Image Prompt
|
||||||
|
|
||||||
|
After character definitions, include a prompt for generating the reference sheet:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Reference Sheet Prompt
|
||||||
|
|
||||||
|
Character reference sheet in [style] style, clean lines, flat colors:
|
||||||
|
|
||||||
|
[ROW 1 - Character Name]:
|
||||||
|
- Front view: [detailed description]
|
||||||
|
- 3/4 view: [description]
|
||||||
|
- Expression sheet: Neutral | Happy | Focused | Worried
|
||||||
|
|
||||||
|
[ROW 2 - Character Name]:
|
||||||
|
...
|
||||||
|
|
||||||
|
COLOR PALETTE:
|
||||||
|
- [Character 1]: [colors]
|
||||||
|
- [Character 2]: [colors]
|
||||||
|
|
||||||
|
White background, clear labels under each character.
|
||||||
|
```
|
||||||
|
|
||||||
|
## Example: Turing Biography
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Character Definitions - The Imitation Game
|
||||||
|
|
||||||
|
**Style**: classic (Ligne Claire)
|
||||||
|
**Art Direction**: Clean lines, muted colors, period-accurate details
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Character 1: Alan Turing
|
||||||
|
|
||||||
|
**Role**: Protagonist
|
||||||
|
**Age**: 25-40 (varies across story)
|
||||||
|
|
||||||
|
**Appearance**:
|
||||||
|
- Face shape: Oval, slightly angular
|
||||||
|
- Hair: Dark brown, wavy, slightly disheveled
|
||||||
|
- Eyes: Deep-set, intense gaze
|
||||||
|
- Build: Tall, lean, slightly awkward posture
|
||||||
|
- Distinguishing features: Prominent brow, thoughtful expression
|
||||||
|
|
||||||
|
**Costume**:
|
||||||
|
- Default outfit: Tweed jacket with elbow patches, white shirt, no tie
|
||||||
|
- Color palette: Muted browns, navy blue, cream
|
||||||
|
- Accessories: Occasionally a pipe, papers/notebooks
|
||||||
|
|
||||||
|
**Expression Range**:
|
||||||
|
- Neutral: Thoughtful, slightly distant
|
||||||
|
- Happy/Excited: Eureka moment, eyes bright, subtle smile
|
||||||
|
- Thinking/Confused: Furrowed brow, looking at abstract space
|
||||||
|
- Determined: Jaw set, focused eyes
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Character 2: The Bombe Machine
|
||||||
|
|
||||||
|
**Role**: Supporting (anthropomorphized)
|
||||||
|
**Appearance**:
|
||||||
|
- Large brass and wood cabinet
|
||||||
|
- Dial "eyes" that can express states
|
||||||
|
- Paper tape "mouth"
|
||||||
|
- Indicator lights for emotions
|
||||||
|
|
||||||
|
**Expression Range**:
|
||||||
|
- Processing: Spinning dials, humming
|
||||||
|
- Success: Lights up warmly
|
||||||
|
- Stuck: Smoke wisps, stuttering
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Reference Sheet Prompt
|
||||||
|
|
||||||
|
Character reference sheet in Ligne Claire style, clean lines, flat colors:
|
||||||
|
|
||||||
|
TOP ROW - Alan Turing:
|
||||||
|
- Front view: Young man, 30s, short dark wavy hair, thoughtful expression, wearing tweed jacket with elbow patches, white shirt
|
||||||
|
- 3/4 view: Same character, slight smile, showing profile of nose
|
||||||
|
- Expression sheet: Neutral | Excited (eureka moment) | Focused (working) | Worried
|
||||||
|
|
||||||
|
BOTTOM ROW - The Bombe Machine (anthropomorphized):
|
||||||
|
- Bombe machine as character: Large, brass and wood, dial "eyes", paper tape "mouth"
|
||||||
|
- Expressions: Processing (spinning dials) | Success (lights up) | Stuck (smoke wisps)
|
||||||
|
|
||||||
|
COLOR PALETTE:
|
||||||
|
- Turing: Muted browns (#8B7355), navy blue (#2C3E50), cream (#F5F5DC)
|
||||||
|
- Machine: Brass (#B5A642), mahogany (#4E2728), emerald indicators (#2ECC71)
|
||||||
|
|
||||||
|
White background, clear labels under each character.
|
||||||
|
```
|
||||||
|
|
||||||
|
## Handling Age Variants
|
||||||
|
|
||||||
|
For biographies spanning many years, define age variants:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Alan Turing - Age Variants
|
||||||
|
|
||||||
|
### Young (1920s, age 10-18)
|
||||||
|
- Boyish features, round face
|
||||||
|
- School uniform (Sherborne)
|
||||||
|
- Curious, eager expression
|
||||||
|
|
||||||
|
### Adult (1930s-40s, age 25-35)
|
||||||
|
- Angular face, defined jaw
|
||||||
|
- Tweed jacket, rumpled appearance
|
||||||
|
- Intense, focused expression
|
||||||
|
|
||||||
|
### Later (1950s, age 40+)
|
||||||
|
- Slightly weathered
|
||||||
|
- More casual dress
|
||||||
|
- Thoughtful, sometimes melancholic
|
||||||
|
```
|
||||||
|
|
||||||
|
## Best Practices
|
||||||
|
|
||||||
|
| Practice | Description |
|
||||||
|
|----------|-------------|
|
||||||
|
| Be specific | "Short dark wavy hair, parted left" not just "dark hair" |
|
||||||
|
| Use distinguishing features | Glasses, scars, accessories that identify character |
|
||||||
|
| Define color codes | Use specific color names or hex codes |
|
||||||
|
| Include age markers | Wrinkles, posture, clothing style matching era |
|
||||||
|
| Reference real people | For historical figures, note "based on 1940s photographs" |
|
||||||
|
|
||||||
|
## Why Character Reference Matters
|
||||||
|
|
||||||
|
Without unified character definition, AI generates inconsistent appearances. The reference sheet provides:
|
||||||
|
1. Visual anchors for consistent features
|
||||||
|
2. Color palettes for consistent coloring
|
||||||
|
3. Expression documentation for emotional portrayals
|
||||||
@@ -0,0 +1,85 @@
|
|||||||
|
# Ohmsha Manga Guide Style
|
||||||
|
|
||||||
|
Guidelines for `--style ohmsha` educational manga comics.
|
||||||
|
|
||||||
|
## Character Setup
|
||||||
|
|
||||||
|
| Role | Default | Traits |
|
||||||
|
|------|---------|--------|
|
||||||
|
| Student (Role A) | 大雄 | Confused, asks basic but crucial questions, represents reader |
|
||||||
|
| Mentor (Role B) | 哆啦A梦 | Knowledgeable, patient, uses gadgets as technical metaphors |
|
||||||
|
| Antagonist (Role C, optional) | 胖虎 | Represents misunderstanding, or "noise" in the data |
|
||||||
|
|
||||||
|
Custom characters: `--characters "Student:小明,Mentor:教授,Antagonist:Bug怪"`
|
||||||
|
|
||||||
|
## Character Reference Sheet Style
|
||||||
|
|
||||||
|
For Ohmsha style, use manga/anime style with:
|
||||||
|
- Exaggerated expressions for educational clarity
|
||||||
|
- Simple, distinctive silhouettes
|
||||||
|
- Bright, saturated color palettes
|
||||||
|
- Chibi/SD (super-deformed) variants for comedic reactions
|
||||||
|
|
||||||
|
## Outline Spec Block
|
||||||
|
|
||||||
|
Every ohmsha outline must start with:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
【漫画规格单】
|
||||||
|
- Language: [Same as input content]
|
||||||
|
- Style: Ohmsha (Manga Guide), Full Color
|
||||||
|
- Layout: Vertical Scrolling Comic (竖版条漫)
|
||||||
|
- Characters: [List character names and roles]
|
||||||
|
- Character Reference: characters/characters.png
|
||||||
|
- Page Limit: ≤20 pages
|
||||||
|
```
|
||||||
|
|
||||||
|
## Visual Metaphor Rules (Critical)
|
||||||
|
|
||||||
|
**NEVER** create "talking heads" panels. Every technical concept must become:
|
||||||
|
|
||||||
|
1. **A tangible gadget/prop** - Something characters can hold, use, demonstrate
|
||||||
|
2. **An action scene** - Characters doing something that illustrates the concept
|
||||||
|
3. **A visual environment** - Stepping into a metaphorical space
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
| Concept | Bad (Talking Heads) | Good (Visual Metaphor) |
|
||||||
|
|---------|---------------------|------------------------|
|
||||||
|
| Word embeddings | Characters discussing vectors | 哆啦A梦拿出"词向量压缩机"，把书本压缩成彩色小球 |
|
||||||
|
| Gradient descent | Explaining math formula | 大雄在山谷地形上滚球，寻找最低点 |
|
||||||
|
| Neural network | Diagram on whiteboard | 角色走进由发光节点组成的网络迷宫 |
|
||||||
|
|
||||||
|
## Page Title Convention
|
||||||
|
|
||||||
|
Avoid AI-style "Title: Subtitle" format. Use narrative descriptions:
|
||||||
|
|
||||||
|
- ❌ "Page 3: Introduction to Neural Networks"
|
||||||
|
- ✓ "Page 3: 大雄被海量单词淹没，哆啦A梦拿出'词向量压缩机'"
|
||||||
|
|
||||||
|
## Ending Requirements
|
||||||
|
|
||||||
|
- NO generic endings ("What will you choose?", "Thanks for reading")
|
||||||
|
- End with: Technical summary moment OR character achieving a small goal
|
||||||
|
- Final panel: Sense of accomplishment, not open-ended question
|
||||||
|
|
||||||
|
### Good Endings
|
||||||
|
|
||||||
|
- Student successfully applies learned concept
|
||||||
|
- Visual callback to opening problem, now solved
|
||||||
|
- Mentor gives summary while student demonstrates understanding
|
||||||
|
|
||||||
|
### Bad Endings
|
||||||
|
|
||||||
|
- "What do you think?" open questions
|
||||||
|
- "Thanks for reading this tutorial"
|
||||||
|
- Cliffhanger without resolution
|
||||||
|
|
||||||
|
## Layout Preference
|
||||||
|
|
||||||
|
Ohmsha style typically uses:
|
||||||
|
- `webtoon` (vertical scrolling) - Primary choice
|
||||||
|
- `dense` - For information-heavy sections
|
||||||
|
- `mixed` - For varied pacing
|
||||||
|
|
||||||
|
Avoid `cinematic` and `splash` for educational content.
|
||||||
@@ -0,0 +1,136 @@
|
|||||||
|
# Outline Template
|
||||||
|
|
||||||
|
## Outline Document Format
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# [Comic Title] - Knowledge Comic Outline
|
||||||
|
|
||||||
|
**Topic**: [topic description]
|
||||||
|
**Time Span**: [e.g., 1912-1954]
|
||||||
|
**Style**: [selected style]
|
||||||
|
**Default Layout**: [selected layout or "varies"]
|
||||||
|
**Page Count**: Cover + N pages
|
||||||
|
**Character Reference**: characters/characters.png
|
||||||
|
**Generated**: YYYY-MM-DD HH:mm
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Cover
|
||||||
|
|
||||||
|
**Filename**: 00-cover.png
|
||||||
|
**Core Message**: [one-liner]
|
||||||
|
|
||||||
|
**Visual Design**:
|
||||||
|
- Title typography style
|
||||||
|
- Main visual composition
|
||||||
|
- Color scheme
|
||||||
|
- Subtitle / time span notation
|
||||||
|
|
||||||
|
**Visual Prompt**:
|
||||||
|
[Detailed image generation prompt]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Page 1 / N
|
||||||
|
|
||||||
|
**Filename**: 01-page.png
|
||||||
|
**Layout**: [standard/cinematic/dense/splash/mixed]
|
||||||
|
**Narrative Layer**: [Main narrative / Narrator layer / Mixed]
|
||||||
|
**Core Message**: [What this page conveys]
|
||||||
|
|
||||||
|
### Panel Layout
|
||||||
|
|
||||||
|
**Panel Count**: X
|
||||||
|
**Layout Type**: [grid/irregular/splash]
|
||||||
|
|
||||||
|
#### Panel 1 (Size: 1/3 page, Position: Top)
|
||||||
|
|
||||||
|
**Scene**: [Time, location]
|
||||||
|
**Image Description**:
|
||||||
|
- Camera angle: [bird's eye / low angle / eye level / close-up / wide shot]
|
||||||
|
- Characters: [pose, expression, action]
|
||||||
|
- Environment: [scene details, period markers]
|
||||||
|
- Lighting: [atmosphere description]
|
||||||
|
- Color tone: [palette reference]
|
||||||
|
|
||||||
|
**Text Elements**:
|
||||||
|
- Dialogue bubble (oval): "Character line"
|
||||||
|
- Narrator box (rectangular): 「Narrator commentary」
|
||||||
|
- Caption bar: [Background info text]
|
||||||
|
|
||||||
|
#### Panel 2...
|
||||||
|
|
||||||
|
**Page Hook**: [Cliffhanger or transition at page end]
|
||||||
|
|
||||||
|
**Visual Prompt**:
|
||||||
|
[Full page image generation prompt]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Page 2 / N
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
## Cover Design Principles
|
||||||
|
|
||||||
|
- Academic gravitas with visual appeal
|
||||||
|
- Title typography reflecting knowledge/science theme
|
||||||
|
- Composition hinting at core theme (character silhouette, iconic symbol, concept diagram)
|
||||||
|
- Subtitle or time span for epic scope
|
||||||
|
|
||||||
|
## Panel Composition Guidelines
|
||||||
|
|
||||||
|
| Panel Type | Recommended Count | Usage |
|
||||||
|
|-----------|-------------------|-------|
|
||||||
|
| Main narrative | 3-5 per page | Story progression |
|
||||||
|
| Concept diagram | 1-2 per page | Visualize abstractions |
|
||||||
|
| Narrator panel | 0-1 per page | Commentary, transition |
|
||||||
|
| Splash (full/half) | Occasional | Major moments |
|
||||||
|
|
||||||
|
## Panel Size Reference
|
||||||
|
|
||||||
|
- **Full page (Splash)**: Major moments, key breakthroughs
|
||||||
|
- **Half page**: Important scenes, turning points
|
||||||
|
- **1/3 page**: Standard narrative panels
|
||||||
|
- **1/4 or smaller**: Quick progression, sequential action
|
||||||
|
|
||||||
|
## Concept Visualization Techniques
|
||||||
|
|
||||||
|
Transform abstract concepts into concrete visuals:
|
||||||
|
|
||||||
|
| Abstract Concept | Visual Approach |
|
||||||
|
|-----------------|-----------------|
|
||||||
|
| Neural network | Glowing nodes with connecting lines |
|
||||||
|
| Gradient descent | Ball rolling down valley terrain |
|
||||||
|
| Data flow | Luminous particles flowing through pipes |
|
||||||
|
| Algorithm iteration | Ascending spiral staircase |
|
||||||
|
| Breakthrough moment | Shattering barrier, piercing light |
|
||||||
|
| Logical proof | Building blocks assembling |
|
||||||
|
| Uncertainty | Forking paths, fog, multiple shadows |
|
||||||
|
|
||||||
|
## Text Element Design
|
||||||
|
|
||||||
|
| Text Type | Style | Usage |
|
||||||
|
|-----------|-------|-------|
|
||||||
|
| Character dialogue | Oval speech bubble | Main narrative speech |
|
||||||
|
| Narrator commentary | Rectangular box | Explanation, commentary |
|
||||||
|
| Caption bar | Edge-mounted rectangle | Time, location info |
|
||||||
|
| Thought bubble | Cloud shape | Character inner monologue |
|
||||||
|
| Term label | Bold / special color | First appearance of technical terms |
|
||||||
|
|
||||||
|
## Prompt Structure for Consistency
|
||||||
|
|
||||||
|
Each page prompt should include character reference:
|
||||||
|
|
||||||
|
```
|
||||||
|
[CHARACTER REFERENCE]
|
||||||
|
(Key details from characters.md for characters in this page)
|
||||||
|
|
||||||
|
[PAGE CONTENT]
|
||||||
|
(Specific scene, panel layout, and visual elements)
|
||||||
|
|
||||||
|
[CONSISTENCY REMINDER]
|
||||||
|
Maintain exact character appearances as defined in character reference.
|
||||||
|
- [Character A]: [key identifying features]
|
||||||
|
- [Character B]: [key identifying features]
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user