剧本一键生条漫

---
name: webtoon_flow
description: 从剧本/脚本生成竖屏条漫（Webtoon风格）的完整工作流。当用户提供漫画剧本、分镜脚本、故事脚本并要求生成连续多张漫画图片时触发。支持中英文剧本输入。关键词：条漫、webtoon、漫画、分镜、漫画生成、comic、manga
---

# Webtoon Generator - 竖屏条漫生成

将文字剧本转化为风格统一的竖屏条漫系列图片。

```
配置确认 → 剧本输入 → 解析提取 → 规划分页 → 生成基准页 → 迭代生成 → 封面制作 → 打包交付
```

## 第0步：API配置和画风（必须首先完成）

生成 9:16 的 4K 图片。

### 画风要求

| 维度 | 规格 |
|------|------|
| 整体风格 | 竖屏条漫（Webtoon）风格，对话清晰的中文 |
| 人物绘制 | 写实比例，面部五官清晰，略带夸张的表情表演以增强喜剧效果 |
| 线条 | 干净利落的数字绘画线条，边缘清晰 |
| 上色 | 全彩赛璐璐风格，色块分明，有明确的光影层次 |
| 背景 | 细致画风注重环境氛围营造 |

### API 配置

使用 Gemini Image Generation API 生成图片，需要设置环境变量 `$GEMINI_API_KEY`。

```javascript
import { writeFile } from "fs/promises";
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const response = await ai.models.generateImages({
    model: "imagen-3.0-generate-002",
    prompt: "...",
    config: {
        numberOfImages: 1,
        aspectRatio: "9:16",
        outputMimeType: "image/png",
    },
});

const imageBytes = response.generatedImages[0].image.imageBytes;
await writeFile("output.png", Buffer.from(imageBytes, "base64"));
```

**支持的参数**：
- `prompt` (必填): 图片描述
- `aspect_ratio`: match_input_image / 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
- `resolution`: 1K / 2K / 4K
- `output_format`: jpg / png
- `image_input`: 参考图数组（最多14张），用于主体参考和风格融合
- `safety_filter_level`: block_low_and_above / block_medium_and_above / block_only_high

### 参考图支持检查

确认 API 是否支持参考图功能：
- **支持** -> 按标准流程，每页引用第一页
- **不支持** -> 在每个 prompt 中更详细地描述角色特征，并告知用户一致性可能受限

---

## 第1步：剧本解析与资产提取

从剧本中提取核心信息，询问用户是否有角色设定（角色名和参考图路径），创建 `project_brief.md`：

```markdown
# 项目概要
## 基本信息
- 标题/类型/总格数/画风/色调

## 角色设定
### [角色A]
- 外貌/服装/特征标签（英文关键词，如 "middle-aged Asian man, round face, balding"）

## 场景设定
- 主场景/场景标签（英文关键词）
```

角色标签需精确且独特，这是保持一致性的基础。

## 第2步：创建分页方案

将所有分格分配到多个页面，每页 3-5 格，创建 `page_plan.md`。

## 第3步：生成基准页（最关键）

第一页作为风格锚点，后续所有页面都将参考它。

### Prompt 结构模板

```
Vertical webtoon comic page, [画风描述], [光照/色调].

Panel layout: [N] panels arranged vertically.

Panel 1 (top, [景别]):
[详细画面描述，包含角色完整特征标签]
[对话气泡内容，用引号标注]

Panel 2 ([景别]):
[详细画面描述]

Panel 3 (bottom, [景别]):
[详细画面描述]

Style notes: [补充画风要求]
Text: All dialogue in Chinese characters, clear speech bubbles.
```

### Prompt 编写要点

| 要素 | 说明 | 示例 |
|------|------|------|
| 画风 | 放在最前面 | `Modern urban manga style` |
| 角色描述 | 每次都包含完整特征 | `middle-aged Asian vendor, round face, balding, wearing white apron` |
| 景别 | 明确指定 | `close-up`, `medium shot`, `wide shot`, `extreme close-up` |
| 情绪/表情 | 具体描述 | `hesitant expression`, `mischievous grin` |
| 光照 | 统一设定 | `warm yellow street lamp lighting` |
| 对话 | 用引号明确 | `Speech bubble: "老板，看上啦？"` |

保存第一页路径，后续所有页面都将引用它。

## 第4步：迭代生成后续页面

每一页都必须引用第一页作为参考图（如 API 支持）。

如果 API 不支持参考图：
- 在 prompt 开头添加更详细的画风锚定描述
- 复制第一页 prompt 中的所有风格关键词
- 角色描述必须 100% 一致，不可简化

### 一致性检查清单

每生成一页后核验：
- [ ] 角色外貌是否与基准页一致
- [ ] 服装颜色/样式是否统一
- [ ] 光照/色调是否匹配
- [ ] 线条风格是否协调

如发现偏差，调整 prompt 并重新生成。

## 第5步：封面制作

封面应具有视觉冲击力，概括故事核心。引用 page_01.png 保持角色一致。

### 封面 Prompt 模板

```
Eye-catching vertical webtoon cover.
Title: "[漫画标题]" in bold stylized Chinese text at top.
Main visual: [核心场景或角色特写，包含完整角色特征标签]
Mood: [情绪氛围]
Background: [背景设计]
Style: [与正文一致的画风描述]
```

## 最佳实践

### 保持一致性的三大法则

1. **参考图必用**：后续每一页都引用 page_01.png
2. **特征标签重申**：每个 prompt 都包含完整的角色特征描述
3. **画风锚定**：每个 prompt 开头都重复画风和光照设定

### 常见问题处理

| 问题 | 解决方案 |
|------|----------|
| 角色外貌漂移 | 增加角色特征描述的细节，强调独特标识 |
| 画风不统一 | 在 prompt 开头强化画风描述词 |
| 文字生成不清晰 | 简化对话，或标注文字需后期处理 |
| 构图混乱 | 明确指定景别和角色位置（left, right, center） |

## 参考文件

- `references/shot_types.md` - 景别说明与使用场景