---
name: character-scene-storyboard
display-name-zh: 角色场景分镜板
summary-cn: 角色参考图加剧本生成角色场景分镜综合设定图
summary-en: Turn character reference images and a script into a comprehensive design sheet with character sheets, scene concept art, and a storyboard grid
description: |
  角色场景分镜板生成助手。输入角色参考图（1-4 人）和剧本/场景描述，
  自动生成一张专业的预制作综合设定图，包含：
  ① 主要角色设定（三视图 + 半身立绘 + 表情差分 + 道具细节）
  ② 主场景概念图（氛围 + 色彩参考 + 光影说明）
  ③ 分镜故事板（默认 12 格，按镜头数自适应）
  布局根据角色数量、分镜多少灵活调整——内容决定结构，不固定四象限。
  支持 6 种视觉风格可选（复古彩铅速写 / 写实电影感 / 黑白速写 / 水墨古风 /
  欧美动漫 / 二次元动漫），用户在第1阶段确认，默认"写实电影感"(照片级电影帧)。
  整张图风格统一，使用 g-image-2 一次生成，输出为单张专业设计文档图。
  触发词：角色场景分镜、角色场景故事板、角色分镜、设定图、故事板设定、分镜设定图、角色故事板、
  character scene storyboard、character sheet storyboard、design sheet、concept sheet、
  角色设定加分镜、人物设定分镜图、综合设定图。
  不适用于：纯分镜视频（用 director-storyboard）、纯海报（用 poster-design）、
  纯角色立绘（用 film-shot）。
version: 1.4.1
tags: [Storyboard, Character-Design, Concept-Art]
tags-cn: [分镜, 角色设计, 概念图]
allowed-tools: hub_read, hub_save_file_to_session
exported-by: MiniMax-hub
---

# 角色场景分镜板生成助手

接收角色参考图和剧本，生成一张包含角色设定、场景概念、分镜故事板的专业预制作综合设定图。

## 核心约定

- **生图模型**：g-image-2（强制，不可替换）
- **输出形式**：单张综合设定图（single image document），禁止输出多张分离图
- **Prompt 语言**：始终使用英文向 g-image-2 发送 prompt
- **风格基准**：由用户在第 1 阶段从 6 种预设风格中选择（详见 `references/style-dictionary.md`）；未选择时询问，仍不确定则默认「S2 写实电影感」(照片级电影帧)
- **布局原则**：不固定四象限——根据角色数量、分镜多少、场景复杂度灵活排布；g-image-2 自行决定文档整体比例和分区形状，只需把所有内容模块都塞进去
- **分镜格数**：默认 3 行 × 4 列 = 12 格；可按实际镜头数自适应（≤6 格用 2×3；≥16 格拆两张）

## 全局约定

- 所有中间文件存储在 `./.character-storyboard-sheet/{project_name}/`
- 每个阶段完成后在对话中展示结果，用户确认后继续
- 用户可在任意阶段要求修改
- Prompt 始终使用英文

## 工作流程

```
输入解析 & 确认 → 信息提取（角色/场景/分镜）→ 综合设定图生成（g-image-2）→ 质量自检 → 交付
```

## 参考资料

按需读取(避免一次性把全部装入上下文)：

| 文件 | 用途 | 何时读 |
|------|------|--------|
| `references/style-dictionary.md` | 6 种预设风格的完整画面规则与关键词 | 第 1 阶段用户确认风格之后 |
| `references/brief-template.md` | brief.md 输出模板 | 第 1 阶段写 brief 时 |
| `references/prompt-template.md` | g-image-2 prompt 模板 + 景别表 + 12 格节奏建议 | 第 2 阶段构建 prompt 时 |

---

## 第 1 阶段：输入解析 & 确认

### 必需输入

| 输入 | 是否必须 | 说明 |
|------|---------|------|
| 角色参考图 | ✅ 是 | 1-4 张，每张对应一个主要角色；全身/半身均可 |
| 剧本 / 场景描述 | ✅ 是 | 可以是自然语言、镜头列表、台词+动作描述均可 |
| 风格倾向 | 可选 | 如"电影感""古风""彩铅速写"；不提供则从参考图自动推断 |
| 目标画面比例 | 可选 | 分镜格内的画面比例（16:9 / 9:16 / 1:1），默认 16:9 |

### 流程

1. 用 `hub_read`（media 模式）逐张读取角色参考图，提取每个角色的：
   - 姓名（若用户未提供则命名为"角色A/B/C"）
   - 性别、年龄段、发型发色
   - 面部特征（眼镜/胡须/妆容等）
   - 服装款式与颜色
   - 体型与站姿
   - 表情神态基调

2. 解析剧本，提取：
   - 场景环境（室内/室外、时代背景、光线氛围）
   - 镜头数量与景别（ECU / CU / MS / WS 等）
   - 每个镜头的核心动作与情绪
   - 人物关系和心理冲突核心

3. 将解析结果写入 `./.character-storyboard-sheet/{project_name}/brief.md`（见格式模板）

4. 在对话中向用户确认以下信息（**不得假定，必须确认**）：
   - **整体视觉风格**：从 `references/style-dictionary.md` 列出的 6 种预设中选 1,若用户未指定则列出选项让用户选
   - **分镜格内画面比例**（16:9 横版 / 9:16 竖版 / 1:1 方形），默认 16:9
   - **风格关键词补充**（可选，在预设风格基础上叠加个人偏好描述）
   - **是否需要将场景概念图单独扩展**（默认含在场景模块内）

### 风格选择

6 种预设风格(S1 复古彩铅速写 / S2 写实电影感(默认) / S3 黑白速写 / S4 水墨古风 / S5 欧美动漫 / S6 二次元动漫)的完整画面规则、关键词、叠加用法见 **`references/style-dictionary.md`**。

确认风格后,从该文件抄取对应行的 `文档底色 / 角色立绘 / 场景概念 / 分镜格 / 关键词` 五项,填入 `references/prompt-template.md` 的占位符。

### Brief 文件格式

完整模板见 **`references/brief-template.md`**。把第 1 阶段提取的项目信息、角色档案、场景档案、分镜列表按该模板写入 `./.character-storyboard-sheet/{project_name}/brief.md`。

---

## 第 2 阶段：综合设定图生成（g-image-2）

### 文档布局策略（自适应，不固定四象限）

布局的核心原则：**内容决定结构，不是结构框死内容。** 根据实际输入（角色数 N、镜头数 S、是否有复杂场景）动态选择最合适的分区方式，并在 prompt 里明确告知 g-image-2。

#### 布局决策流程

**Step 1：统计内容模块数量**

| 模块 | 条件 | 占用空间估算 |
|------|------|------------|
| 角色设定区 × N | 每个角色一个区 | 各占 1 份 |
| 场景概念区 | 有场景描述时 | 占 1-1.5 份（场景复杂时给更大） |
| 分镜故事板区 | 始终存在 | 格数多时占 1.5-2 份 |

**Step 2：根据总模块数选择大框架**

| 总模块 | 推荐大框架 | 典型例子 |
|--------|-----------|---------|
| 3 个（1角色+场景+分镜） | 横向三栏 或 L形 | 角色宽栏在左，场景+分镜叠在右 |
| 4 个（2角色+场景+分镜） | 2×2 田字 | 最经典，各占一格 |
| 5 个（3角色+场景+分镜） | 顶部三栏 + 底部两栏 | 三角色横排占顶，场景+分镜占底 |
| 6 个（4角色+场景+分镜） | 顶部四栏 + 底部两栏 | 四角色横排占顶，场景+分镜占底 |
| 分镜 ≥ 16 格 | 角色+场景占上半，分镜独占下半大块 | 分镜区域需要更多竖向空间 |
| 场景极复杂（多场景/多时间线） | 场景区独占一整行 | 场景区横跨全宽，上下各放角色和分镜 |

**Step 3：给 g-image-2 的布局指令写法**

- **不要**在 prompt 里画死格子（❌ "put A in top-left, B in top-right"）
- **要**描述每个模块的相对权重和内容优先级，让模型自己安排（✅ "Character sheets for A, B, C should each have roughly equal space; the storyboard grid needs the most vertical space since it has 15 panels; the scene concept gets a medium-sized area"）
- 明确告知**哪个模块内容最多**，让它获得更大区域

#### 各场景布局参考示例

**1角色 + 简单场景 + ≤8镜：**
```
建议告知模型：角色设定区需要充裕空间展示三视图+立绘+表情；
场景区中等大小；分镜区中等大小。三区可横排或L形排列。
```

**2角色 + 场景 + 12镜（本次甄别室案例）：**
```
建议告知模型：两个角色设定区各占上方左右；
场景概念和分镜各占下方左右；经典田字形。
```

**3角色 + 场景 + 15镜：**
```
建议告知模型：三个角色设定区横排占顶部1/3；
场景概念占底部左侧；分镜占底部右侧且需要更多纵向空间（15格）。
顶部三栏 + 底部两栏的五区布局。
```

**4角色 + 多场景 + 20镜（需拆两张）：**
```
第一张：四个角色设定区 + 场景概念（4+1共五区）
第二张：独立高清分镜故事板（20格，4×5网格）
两张分开生成，告知用户。
```

### 各象限内容规范

#### 角色设定区（每个角色）

每个角色设定区必须包含以下元素：

1. **象限标题栏**（黑底白字）：`{角色名} {ROLE NAME} · 角色设定 CHARACTER SHEET`

2. **三视图**（顶部横排，小尺寸全身）：
   - 正面（FRONT 正面）
   - 侧面（SIDE 侧面）
   - 背面（BACK 背面）
   - 每个视图下标注朝向文字

3. **主立绘**（中心大图，胸部以上 3/4 角度半身像）：
   - 面部特征清晰可见
   - 服装细节可读
   - 表情为角色基础神态

4. **表情差分**（4个圆形图标，竖排或横排）：
   - 根据剧本情绪设计（如冷静/警觉/震惊/愤怒等）
   - 每个图标下方有中文情绪标注

5. **细节区**（道具/特征放大图）：
   - 标注"拆解细节 / DETAILS"
   - 角色专属道具或服装局部特写（如武器/配件/标志性细节）

6. **人物关系标注**（可选，底部小字）：
   - 与其他角色的关系一句话描述

#### 场景概念区（左下）

1. **象限标题栏**（黑底白字）：`主场景概念 SCENE CONCEPT · {场景名称}`

2. **氛围概念插图**（占象限主体）：
   - 按剧本设定的环境绘制
   - 光影处理与整体风格一致
   - 可包含剧本人物的大致剪影位置
   - 尽量展示纵深感和空间张力

3. **色彩参考条**（底部5色条）：
   - 5个色块，每个标注 hex 色值
   - 从左到右由暗到亮排列

4. **光影方案文字说明**（底部小字标注）：
   - 一行描述光源方向、对比度、氛围

#### 分镜故事板区（右下）

1. **象限标题栏**（黑底白字）：`分镜设定板 STORYBOARD · {场景标题}`

2. **分镜格网格**：
   - 每格由上到下：**镜号标签** + **插图** + **说明文字**
   - 镜号标签：左上角白字小标签，格式 `镜01 | 景别 | 时段`
   - 插图：按 {panel_ratio} 比例构图,**渲染方式与第 1 阶段确认的风格一致**(见 `references/style-dictionary.md` 对应行的「分镜格」字段,如 S2 用照片级电影帧、S5 用半调网点、S6 用动漫粗边框、S1 用彩铅速写、S3 用 gesture lines、S4 用淡墨晕染)
   - 说明文字：底部小字描述,字号样式跟随选定风格的标题栏配色

3. **分镜画风要求**(画风具体细节由选定风格决定,这里只规定**通用构图原则**)：
   - 高对比度,阴影/明暗关系清晰
   - 景别变化丰富(全景/中景/特写交替)
   - 关键帧突出心理张力(特写眼神、手部动作、光线反射)
   - **不得擅自改成黑白素描**——若选 S2 写实电影感就用照片级彩色电影帧,选 S6 二次元就用 cel-shading + 鲜艳平涂,选 S5 欧美动漫就用半调网点 + 粗边框,选 S4 水墨古风就用淡墨晕染,选 S1 复古彩铅就用彩铅笔触,只有 S3 才用纯黑白速写

### Prompt 构建模板

完整的 g-image-2 prompt 模板、占位符填写规则、按选定风格调整 NEGATIVE 段的注意事项,见 **`references/prompt-template.md`**。

构建前必读：
- 风格相关字段(`{STYLE_*}`)从 `references/style-dictionary.md` 选定的那一行抄写,五项必须配套使用,不得跨风格混搭
- 布局指令 `{LAYOUT_INSTRUCTION}` 描述各模块**相对权重**,不写固定坐标
- NEGATIVE 段必须按风格调整(选 S6 二次元时不能再禁 `color anime style`,选 S5 欧美动漫时不能再禁 `halftone`,选 S2 写实电影感时不能再禁 `photorealistic`)
- `{panel_ratio}` 是分镜格内画面比例,与文档整体比例无关——文档比例交给 g-image-2 自行决定

### 分镜格描述构建规则

每个分镜格描述需包含：镜号(PANEL 01)、景别(WS/MS/CU/ECU 等)、画面内容(主体+动作+方向+位置)、情绪标注、Caption 文字(中文,≤ 15 字)。

完整的景别速查表(EWS/WS/MWS/MS/MCS/CU/ECU 中英对照)和 12 格分镜节奏建议见 **`references/prompt-template.md`** 的"分镜格描述构建规则"段。

### 生成调用

- 使用 image agent（g-image-2）
- `image_paths` 传入所有角色参考图路径
- 单次生成，不拆分

### 质量自检

生成后使用 `hub_read` 对设定图进行自检，question 设为：

```
Check this comprehensive design sheet for:
1. LAYOUT: Are all expected content modules present and clearly divided with title bars? Is there a document header? Does the layout make efficient use of space (no huge blank areas, no cramped sections)?
2. CHARACTER SHEETS: Does each character module have — three-view lineup, a large portrait bust, 4 expression badges, and a details/props section?
3. CHARACTER CONSISTENCY: Do all character illustrations across the document match the appearance described (hair, glasses, outfit, facial features)?
4. SCENE CONCEPT: Is there an atmospheric scene illustration with a color palette strip and lighting notes?
5. STORYBOARD: Are ALL expected panels present (count them) with shot number labels, illustrations, and caption text? Are panels composed for the specified aspect ratio?
6. STYLE CONSISTENCY: Is the selected visual style ({STYLE_NAME}) applied consistently across ALL modules — character drawings, scene concept, storyboard panels, document background, title bars? Are there any areas where the style feels inconsistent or defaults to a different aesthetic?
7. DOCUMENT STYLE: Does the overall look match a professional pre-production design sheet with the correct background color, title bar colors, and divider style for the chosen style?
8. SPACE EFFICIENCY: Does the storyboard region have enough space for all its panels? Do character regions feel appropriately sized — not too cramped, not wastefully large?
Report any missing elements, style inconsistencies, cramped areas, or quality issues.
```

不满足任一项 → 针对问题调整 prompt 重新生成（最多 2 次）。

### 文件存储

```
./.character-storyboard-sheet/{project_name}/
├── brief.md          # 解析摘要
└── design-sheet.png  # 综合设定图（主输出）
```

---

## 第 3 阶段：交付 & 迭代

### 用户确认

展示设定图后询问：
- 哪个部分需要调整？（角色相似度 / 分镜格内容 / 场景氛围 / 整体风格）
- 是否需要单独扩展某个部分（如独立生成高清角色立绘或场景概念图）

### 常见迭代方向

| 用户反馈 | 处理方式 |
|---------|---------|
| 角色脸不像参考图 | 在 prompt 中加强面部特征描述，增加 `strictly match face from reference image(8).png` 等字样 |
| 分镜格太小看不清 | 提示用户：可单独生成高清版某几格，用 g-image-2 + 参考该格的描述 |
| 场景氛围不对 | 细化场景 prompt 中的光源方向、色调、建筑元素描述 |
| 表情差分不准确 | 在 prompt 中逐个描述表情（如"eyebrows furrowed, eyes wide, mouth slightly open in shock"） |
| 文字太小/乱码 | 减少每格 caption 字数至 ≤ 10 字，使用更粗字体描述 |
| 想要第4个象限改成别的内容 | 灵活调整：如替换成角色关系图、武器道具一览、色彩参考页等 |

### 延伸能力（用户要求时）

- **生成视频**：将设定图交给 `director-storyboard` skill 继续制作视频
- **高清单格导出**：单独用 g-image-2 放大某一分镜格
- **角色立绘扩展**：将角色设定区单独生成为高精度立绘（交给 `film-shot` skill）

---

## 完成输出

```
--- 角色分镜综合设定图完成 ---

项目：{project_name}
角色数：{N}
分镜格数：{shot_count} 格
画面比例：{panel_ratio}

主输出：./.character-storyboard-sheet/{project_name}/design-sheet.png
```

---

## 错误处理

| 错误 | 处理方式 |
|------|---------|
| g-image-2 不可用 | 告知用户，等待恢复，不降级到其他图片模型 |
| 角色参考图读取失败 | 检查路径，使用 `hub_save_file_to_session` 复制到 session 目录后重试 |
| 某个内容模块缺失 | 在 prompt 中逐模块加粗强调，标注"DO NOT omit this section" |
| 中文文字乱码/不可读 | 简化 caption 至纯英文或极短中文（≤ 6 字）；标题改用更大标注 |
| 角色脸与参考图差异大 | 在 prompt 中逐条列出面部关键特征，加入 `must strictly resemble reference` 约束 |
| 分镜格数不足 | 在 prompt 中明确标注 `{N} panels total, numbered 01 to {N}, none can be missing` |
| 某个模块空间太小/被压缩 | 在布局指令里明确指出该模块的优先级和相对权重，如 `the storyboard region must be the largest area` |
| 角色多导致单张塞不下 | 拆两张：第一张放所有角色设定+场景，第二张放完整分镜故事板 |

## 反模式警告

- ❌ 不得输出多张分离图——必须是单张综合文档图（内容实在太多时例外，需告知用户）
- ❌ 不得在没有角色参考图的情况下随意编造角色外貌
- ❌ 不得跳过 `hub_read` 角色提取直接拼 prompt——会丢失关键细节
- ❌ 不得在未确认分镜画面比例的情况下假定比例
- ❌ 不得在用户未指定风格时直接生成——必须先呈现 6 种风格选项让用户选择（或用户已明确描述风格时自动匹配最近的预设）
- ❌ 不得在同一张设定图里混用两种不同的视觉风格——角色区/场景区/分镜区必须使用同一套风格关键词
- ❌ g-image-2 失败时不得降级到其他图片模型
- ❌ 不得把"分镜格内画面比例"和"整张设定图文档比例"混淆——前者在 prompt 里显式指定，后者交给 g-image-2 自行决定
- ❌ 不得省略质量自检步骤——缺模块、缺格、角色变形、风格漂移等问题必须通过自检发现并修正
- ❌ 不得在 prompt 里用"put X in top-left / bottom-right"等固定坐标描述布局——应描述各模块的相对权重和内容需求，让模型自行安排
- ❌ 不得为了强塞所有内容进一张图而让某个模块严重压缩到不可读——宁可拆两张，也不要牺牲可读性