Flatten skill category directory structure

drama-production/character-scene-storyboard/SKILL.md

@@ -0,0 +1,355 @@
+---
+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"等固定坐标描述布局——应描述各模块的相对权重和内容需求，让模型自行安排
+- ❌ 不得为了强塞所有内容进一张图而让某个模块严重压缩到不可读——宁可拆两张，也不要牺牲可读性

drama-production/character-scene-storyboard/install.md

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

drama-production/character-scene-storyboard/references/brief-template.md

@@ -0,0 +1,45 @@
+# Brief 文件模板
+
+第 1 阶段输入解析的结果按此格式写入 `./.character-storyboard-sheet/{project_name}/brief.md`。
+
+```markdown
+# 综合设定图 Brief
+
+## 项目信息
+- 项目名：{project_name}
+- 角色数：{N}
+- 镜头数：{shot_count}
+- 分镜格布局：{rows} 行 × {cols} 列
+- 分镜画面比例：{panel_ratio}
+- **视觉风格**：{style_id} {style_name}（如 S1 写实电影感）
+- **风格叠加词**：{extra_style_modifiers}（若无则留空）
+
+## 角色档案
+
+### {角色名A}
+- 参考图：{path}
+- 性别/年龄：{gender}, ~{age}岁
+- 发型：{hair}
+- 面部特征：{face_features}
+- 服装：{outfit}
+- 体型：{build}
+- 情绪基调：{mood}
+
+### {角色名B}
+（同上）
+
+## 场景档案
+- 环境：{environment}
+- 时代背景：{era}
+- 光影方案：{lighting}
+- 氛围关键词：{mood_keywords}
+- 色调：{color_palette}
+
+## 分镜列表
+
+| 镜号 | 景别 | 核心动作 | 情绪 | 在场人物 |
+|------|------|---------|------|---------|
+| 01   | MS   | ...     | ...  | A, B    |
+| 02   | CU   | ...     | ...  | C       |
+...
+```

drama-production/character-scene-storyboard/references/prompt-template.md

@@ -0,0 +1,142 @@
+# g-image-2 Prompt 模板
+
+第 2 阶段调用 g-image-2 时使用此模板。所有 `{占位符}` 必须填实,`{STYLE_*}` 字段从 `references/style-dictionary.md` 选定的风格里取。
+
+## 关键填写规则
+
+- **风格字段全部基于第 1 阶段确认的 `{STYLE_NAME}`**,从风格词典对应行抄写
+- **`{LAYOUT_INSTRUCTION}` 描述各模块的相对权重**(不是固定坐标),让 g-image-2 自行排版
+- **`{panel_ratio}` 是分镜格内的画面比例**,与文档整体比例无关
+- **NEGATIVE 段必须按选定风格调整**——若选中 S6 二次元则不能再写 `color anime style`,若选中 S5 欧美动漫则不能再禁掉 `halftone`,若选中 S2 写实电影感则不能再禁 `photorealistic`
+- **`{STYLE_PANEL_RENDER}` 已在每种风格里定义**,storyboard 模块直接用占位符,不要再硬编码 "ink sketch / gray wash"
+
+## 模板正文
+
+```
+Generate a single comprehensive pre-production design sheet image using g-image-2.
+This must be ONE single image — a professional animation/film concept art document.
+Do NOT output separate images.
+
+⚠️ DOCUMENT STYLE — SELECTED VISUAL STYLE: {STYLE_NAME} (highest priority)
+Fill in the following from the Style Dictionary based on the user's chosen style:
+- Document background: {STYLE_BG_COLOR_DESC}
+  e.g. S2→ "deep charcoal black #1a1a1a cinematic" | S1→ "warm yellowed paper #f5ede0" | S4→ "xuan paper ivory #f5f0e8"
+- Section divider lines: {STYLE_DIVIDER_DESC}
+  e.g. S2→ "fine warm gold lines" | S3→ "hairline black sketch lines" | S6→ "thin blue lines"
+- Section title bars: {STYLE_TITLEBAR_DESC}
+  e.g. S2→ "dark bronze metallic bar, white text" | S4→ "vermillion red bar, white text" | S5→ "black-red bar, white text"
+- Character illustration rendering: {STYLE_CHARACTER_RENDER}
+  e.g. S2→ "photorealistic studio portrait, natural lighting, shallow DoF, color graded" | S6→ "anime cel-shading, clean outlines, flat color" | S1→ "vintage colored pencil sketch, warm desaturated palette, paper grain"
+- Scene concept rendering: {STYLE_SCENE_RENDER}
+  e.g. S2→ "real cinematic film still, color graded, 35mm anamorphic, volumetric lighting" | S4→ "ink splash landscape, ink wash, negative space" | S3→ "perspective sketch with light hatching, no flat color"
+- Storyboard panel rendering: {STYLE_PANEL_RENDER}
+  e.g. S2→ "color cinematic film still, color grading + shallow DoF + subtle film grain" | S5→ "halftone dot shading, bold outlines, comic panel borders" | S6→ "anime panels with speed lines, vibrant flat color, manga borders" | S3→ "black and white gestural sketch with cross-hatching, no color fills"
+- Additional style keywords: {STYLE_KEYWORDS} {EXTRA_STYLE_MODIFIERS}
+- The entire document — character drawings, scene art, storyboard panels, backgrounds — must use this single consistent style. No style mixing between modules.
+- Document header at very top spanning full width:
+  "{PROJECT_TITLE} | 角色设定与分镜设计 CHARACTER & STORYBOARD DESIGN SHEET"
+
+⚠️ LAYOUT — DO NOT use a fixed 4-quadrant grid. Arrange all content modules below
+based on their relative size needs. Let the layout emerge from the content:
+- {LAYOUT_INSTRUCTION}
+  (e.g. "Character sheets for A and B need equal space at the top half;
+   scene concept gets a medium region at bottom-left;
+   storyboard needs the largest area at bottom-right since it has 12 panels")
+- The overall document aspect ratio and exact region boundaries are YOUR choice —
+  optimize for readability of each module. Do NOT let any fixed ratio constraint
+  appear anywhere in this prompt.
+
+⚠️ REFERENCE IMAGES define character appearances:
+- {char_ref_path_A}: {CHARACTER_A_NAME} — {detailed_appearance_description}
+- {char_ref_path_B}: {CHARACTER_B_NAME} — {detailed_appearance_description}
+All character illustrations throughout the document must match these reference images exactly.
+
+⚠️ STORYBOARD PANELS: Each storyboard panel illustration must be composed for {panel_ratio} frame.
+
+═══ CONTENT MODULE: {CHARACTER_A_NAME} CHARACTER SHEET ═══
+Section label bar: "{角色名A} {ROLE_A} · 角色设定 CHARACTER SHEET"
+
+Contents:
+1. TOP ROW — Three-view character lineup: FRONT view (正面) | SIDE view (侧面) | BACK view (背面)
+   Full body, small scale, rendered per {STYLE_CHARACTER_RENDER}
+2. CENTER — Large 3/4 portrait bust (chest-up), detailed face clearly showing {face_features_A}
+3. EXPRESSION BADGES — 4 circular expression icons:
+   {emotion_1_zh} ({emotion_1_en}) | {emotion_2_zh} | {emotion_3_zh} | {emotion_4_zh}
+4. DETAILS SECTION — "拆解细节 / DETAILS": {prop_or_detail_description_A}
+
+CHARACTER A full appearance: {full_appearance_description_A}
+
+═══ CONTENT MODULE: {CHARACTER_B_NAME} CHARACTER SHEET ═══
+Section label bar: "{角色名B} {ROLE_B} · 角色设定 CHARACTER SHEET"
+
+[same sub-structure as above, adapted for Character B]
+
+CHARACTER B full appearance: {full_appearance_description_B}
+
+[Repeat MODULE block for each additional character C, D...]
+
+═══ CONTENT MODULE: SCENE CONCEPT ═══
+Section label bar: "主场景概念 SCENE CONCEPT · {SCENE_NAME}"
+
+Contents:
+1. MAIN ILLUSTRATION (occupies most of this module): {detailed_scene_description}
+   Lighting: {lighting_description} | Atmosphere: {mood_description}
+   Style: {STYLE_SCENE_RENDER}
+2. COLOR PALETTE STRIP (bottom of module): 5 color swatches — {hex1} | {hex2} | {hex3} | {hex4} | {hex5}
+3. LIGHTING NOTES (small text): "{lighting_scheme_note}"
+
+═══ CONTENT MODULE: STORYBOARD ═══
+Section label bar: "分镜设定板 STORYBOARD · {SCENE_TITLE}"
+
+{ROWS} rows × {COLS} columns grid = {TOTAL} panels. Render every panel using {STYLE_PANEL_RENDER}.
+Each panel: shot number label top-left corner | illustration ({panel_ratio} composition) | caption below.
+
+{PANEL_01_through_N_descriptions}
+
+Panel style: {STYLE_PANEL_RENDER}, expressive linework. Each panel clearly bordered. ALL {TOTAL} panels must be present and numbered.
+
+═══ CHARACTER CONSISTENCY (across entire document) ═══
+{CHARACTER_A_NAME}: always appears as {appearance_summary_A}
+{CHARACTER_B_NAME}: always appears as {appearance_summary_B}
+
+═══ NEGATIVE ═══
+Fixed 4-quadrant grid that wastes space, separate multiple images, watermarks,
+inconsistent character appearance, missing any content module, illegible text,
+missing section title bars, fewer storyboard panels than specified,
+{STYLE_NEGATIVE_EXTRA}
+
+(For {STYLE_NEGATIVE_EXTRA} — fill in style-conflicting items: e.g. for S2 写实电影感 add "anime style, hand-drawn sketch, flat color illustration, cartoon"; for S6 二次元 add "muddy realistic rendering, photographic"; for S5 欧美动漫 add "soft pastel tones, photorealistic"; for S3 黑白速写 add "color, photographic, fully rendered painting"; for S1 复古彩铅 add "harsh saturated colors, photorealistic, hard edge"; for S4 水墨古风 add "western style, photorealistic, neon colors".)
+```
+
+## 分镜格描述构建规则
+
+每个 `{PANEL_XX_description}` 需包含：
+- 镜号(PANEL 01)
+- 景别(Wide Shot / Medium Shot / Close-up / Extreme Close-up)
+- 画面内容(Who does what, where, how — 主体+动作+方向+位置)
+- 情绪标注
+- Caption 文字(中文,≤ 15 字)
+
+### 景别速查表
+
+| 中文 | 英文 | 缩写 |
+|------|------|------|
+| 大远景 | Extreme Wide Shot | EWS |
+| 全景 | Wide Shot | WS |
+| 中全景 | Medium Wide Shot | MWS |
+| 中景 | Medium Shot | MS |
+| 中近景 | Medium Close Shot | MCS |
+| 近景 | Close-up | CU |
+| 特写 | Extreme Close-up | ECU |
+
+### 12 格分镜节奏建议
+
+| 格号 | 建议景别 | 作用 |
+|------|---------|------|
+| 01 | WS / MWS | 建立空间与人物位置关系 |
+| 02-03 | MS | 主角行动开始,交代动机 |
+| 04-05 | CU | 关键道具/表情特写,强化情绪 |
+| 06-07 | MS | 对手角色反应,心理对比 |
+| 08-09 | ECU | 极致情绪特写(眼睛/手/道具) |
+| 10-11 | MS / MCS | 冲突升级或转折 |
+| 12 | WS | 终镜——空间确认,张力凝固 |

drama-production/character-scene-storyboard/references/style-dictionary.md

@@ -0,0 +1,97 @@
+# 风格词典(6 种预设)
+
+每种风格控制三层视觉语言:**文档底色 × 插图画风 × 分镜格渲染**。
+
+第 1 阶段从这里挑一种,把对应行的 `文档底色 / 角色立绘 / 场景概念 / 分镜格 / 关键词` 五个字段抄到 `references/prompt-template.md` 的 `{STYLE_*}` 占位符。**五项必须配套使用,不得跨风格混搭。**
+
+> 默认风格:S2 写实电影感(用户未指定时使用)
+
+---
+
+## 🎨 S1 复古彩铅速写
+> 适合:童话、绘本、温暖回忆、自然题材、文艺片、儿童/少年向
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 暖米白略泛黄 #f5ede0,手绘浅褐线不规则分区,棕褐色手写感标题栏(白字) |
+| 角色立绘 | 复古彩铅速写,温暖低饱和配色,可见纸纹与彩铅笔触,线条略带毛糙感 |
+| 场景概念 | 彩铅速写风景,淡水彩底色 + 彩铅细节叠加,暖色怀旧,留白多 |
+| 分镜格 | 彩铅速写 + 浅彩铅渲染,粗线勾勒主体,局部彩铅笔触表现明暗 |
+| 关键词 | vintage colored pencil sketch, hand-drawn pencil texture, warm desaturated palette, paper grain visible, sketchy gesture lines, light watercolor wash underneath, illustrated storybook feel |
+
+---
+
+## 🎬 S2 写实电影感(默认)
+> 适合:现代剧情、谍战、悬疑、剧情短片、广告片、电影预告、写实纪录
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 深炭黑 #1a1a1a,极细暖灰金线分区,深棕金属质感标题栏(白字)+ 暗角虚化 |
+| 角色立绘 | 照片级写实数字摄影,真实自然光照,浅景深半身肖像,皮肤毛发细节可见,电影色彩分级 |
+| 场景概念 | 真实电影帧场景照,电影色彩分级(略偏青/橘对比),35mm 镜头质感,环境光与体积光自然 |
+| 分镜格 | 彩色电影截图风,色彩分级 + 浅景深 + 轻微 film grain,接近真实影片定帧画面 |
+| 关键词 | cinematic photography, photorealistic, color graded film still, 35mm anamorphic lens, shallow depth of field, natural volumetric lighting, subtle film grain, teal-orange color grade, professional movie production |
+
+---
+
+## ✏️ S3 黑白速写
+> 适合:快速分镜提案、动作戏速记、剧情结构分析、手绘草稿、动画师 layout
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 纯白 #ffffff,极细黑色手绘线分区(略带速写抖动感),黑框白底黑字标题栏 |
+| 角色立绘 | 黑白速写,gesture lines 主结构 + cross-hatching 局部阴影,边缘随性,有手稿粗糙感 |
+| 场景概念 | 透视速写,主结构准但留白多,少量速写阴影线表达体量 |
+| 分镜格 | 黑白速写漫画风,gesture lines + cross-hatching 阴影,比纯线稿更有动势 |
+| 关键词 | quick black and white sketch, gestural pencil lines, cross-hatching shading, expressive sketchy linework, rough sketchbook feel, no flat color fills, animator layout style |
+
+---
+
+## 🖌️ S4 水墨古风
+> 适合:古装、仙侠、武侠、历史、东方美学、神话
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 宣纸米黄 #f5f0e8,淡墨线分区,朱砂红标题栏(红底白字) |
+| 角色立绘 | 中国传统工笔线描 + 淡彩水墨晕染,笔触飘逸,留白多 |
+| 场景概念 | 山水墨迹风,泼墨大写意,近实远虚,朦胧意境 |
+| 分镜格 | 淡墨勾线 + 水墨晕染,笔触可见,东方审美留白 |
+| 关键词 | Chinese ink wash painting, gongbi line art, xuan paper texture, red vermillion title bars, ink splatter, negative space |
+
+---
+
+## 💥 S5 欧美动漫
+> 适合:超英、暗黑奇幻、西部、美式动作、漫改电影
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 米黄旧纸 #f2ead8,粗黑线框分区,黑红标题栏(红底白字) |
+| 角色立绘 | 欧美动漫风格(超英漫画底子),粗轮廓线,强调肌肉体积,夸张透视 |
+| 场景概念 | 漫画背景速写,粗笔触,网点纹理,戏剧化透视 |
+| 分镜格 | 粗黑边框,半调网点阴影,文字框气泡感,动态线条 |
+| 关键词 | American comic book style, bold outlines, halftone dot shading, exaggerated perspective, dynamic action lines, aged paper texture |
+
+---
+
+## 🌸 S6 二次元动漫
+> 适合:动画、轻小说、游戏角色、青春故事、校园
+
+| 层 | 描述 |
+|----|------|
+| 文档底色 | 浅蓝灰 #eef2f7,细蓝色线分区,深蓝标题栏(白字) |
+| 角色立绘 | 日系动漫风格,大眼睛,流畅线稿,cel-shading 平涂 |
+| 场景概念 | 动漫背景画风,色彩明亮,透视夸张,细节丰富 |
+| 分镜格 | 动漫分镜格风,粗边框,速度线,动态感强 |
+| 关键词 | anime style, cel-shading, clean Japanese animation linework, expressive eyes, vibrant flat color, manga panel borders |
+
+---
+
+## 风格叠加规则
+
+用户可以在预设风格上叠加修饰词,例如:
+- `S2 写实电影感` + `"夜色赛博"` → 在 S2 关键词基础上加 `with neon city lights, rain-slicked streets, cyberpunk color palette`
+- `S4 水墨古风` + `"加金粉效果"` → 叠加 `with gold leaf accents, gilded ink details`
+- `S6 二次元` + `"暗黑风"` → 叠加 `dark fantasy, muted desaturated palette, heavy shadow`
+- `S1 复古彩铅` + `"加梦幻"` → 叠加 `with dreamy soft glow, pastel highlights, surreal atmosphere`
+
+叠加词直接追加到 Prompt 的 DOCUMENT STYLE 段末尾(`{EXTRA_STYLE_MODIFIERS}` 占位符)。