# 美术风格

## 目标

在人设图和分镜图生成之前，确定 MV 的整体美术风格，为后续视觉生成提供统一的风格基准。

## 内置风格预设

内置风格的预览图首次预览时由 `scripts/download_style_presets.py` 自动下载到 `.mv/{song_name}/{theme}/style_cache/{style}/` 本地目录，后续直接复用本地缓存。下游 `art_style.md` 的 `参考图：` 字段统一记录本地路径，确保生图工具的 `image_paths` 可直接读取。

| 目录 | 风格 | 说明 |
|------|------|------|
| `cinematic/` | 电影质感写实 | 35mm胶片颗粒、暖琥珀色调、自然光、宽银幕 |
| `oil-painting/` | 油画风格 | 厚重笔触、印象派色彩、painterly 质感 |
| `noir-illustration/` | 黑色插画 | 高对比剪影、图像小说风、琥珀色点缀 |

## 流程

调用 MCP 工具 `preview_and_collect_feedback` 启动美术风格选择页面：
- **script**: `.opencode/skills/mv-creator/scripts/render_preview.py`
- **args**: `[".mv/{song_name}/{theme}", "--type", "art_style", "--lang", "{lang}"]`
- **feedback_path**: `.mv/{song_name}/{theme}/feedback.md`

页面是一个交互式选择界面，包含：

- **内置风格展示区**：脚本首次启动时通过 `download_style_presets.py` 把内置风格预设图缓存到 `.mv/{song_name}/{theme}/style_cache/{style}/`，按分类展示，附风格关键词标签
- **自定义风格区**：允许输入 **风格描述文字**、上传 **1 张** 自定义参考图，或两者兼用（上传后保存到项目 `style_references/` 目录）
- **选择提交区**：用户选定风格方向后提交

工具返回反馈内容后：

- **选择内置预设** → 直接结合预设信息生成 `art_style.md`
- **选择自定义风格** → 根据用户提供的内容生成 `art_style.md`：
  - 仅文字描述 → 基于描述提取风格关键词，生成 `art_style.md`
  - 仅参考图 → 用 `read_media` MCP 工具分析参考图的美术风格特征（线条、色彩、构图、质感等），再基于分析结果生成
  - 文字 + 参考图 → 结合文字描述和参考图分析结果，综合生成

**确保参考图可用**：`art_style.md` 的 `参考图：` 列表必须包含至少一张图片。
如果用户选择的是纯文本自定义风格（无内置预设图、无上传参考图），则在生成 `art_style.md` 之前，先用 Midjourney 根据风格关键词生成一张风格参考图，保存到 `style_references/` 目录，并写入 `参考图：` 列表。这确保后续人设图和分镜图生成阶段始终有可用的风格参考图。**此处 MJ 生成的四宫格不需要裁切**，仅需一张完整图作为风格参考即可。

生成的 `art_style.md` 记录：

- 风格名称和描述
- 选定的参考图路径（**至少一张**）
- 色调、光影、质感等关键词
- 适用的生图模型推荐

**风格 JSON 提取**：`art_style.md` 生成后，**必须**从参考图中提取结构化的风格 JSON。调用 `read_media` MCP 工具，传入参考图路径和以下提示词：

```
请以专业的艺术品鉴观角，深度分析这张图片的视觉风格。请忽略画面具体内容（比如人物、剧情），色彩风格、色彩调色板（hex代码）、构图风格、纹理质感、材质效果、线条风格、艺术风格关键词。请将分析结果输出为一段精简的 JSON 格式或描述，不要任何解读，就只要 JSON 结构。
```

将返回的 JSON 结果写入 `art_style.md` 的 `风格JSON：` 字段中。此 JSON 将在后续人设图、背景图和关键物件图生成时作为风格描述注入提示词，替代直接传入参考图。

## 输出格式

完整格式示例见 `references/art-style-example.md`（非中文用户参考 `references/art-style-example-en.md`）。关键要点：

- 首行 `美术风格：` + 风格名称
- 包含字段：`风格描述：`、`关键词：`、`色调：`、`光影：`、`推荐生图模型：`、`参考图：`、`风格JSON：`
- 关键词使用英文，用于后续生图 prompt
- 参考图路径相对项目目录，每行一个
- 风格JSON 为 `read_media` 分析参考图返回的结构化风格数据

## 文件存储

```
./.mv/{song_name}/{theme}/art_style.md                     # 美术风格说明
./.mv/{song_name}/{theme}/style_cache/                     # 内置风格预设 CDN 缓存（首次预览自动下载）
./.mv/{song_name}/{theme}/style_references/                # 用户上传的参考图（如有）
```

## 风格路由

美术风格确定后，判断风格是否属于**写实类**，决定后续工作流：

**写实类判定**：以下情况视为写实风格：
- 用户选择了内置预设「电影质感写实（cinematic）」
- 用户自定义风格的描述或关键词偏向写实（如包含 photorealistic / realistic / cinematic / 写实 / 真人 / 实拍 等特征）

**路由规则**：
- **写实风格** → 停止 mv-creator 主流程，告知用户写实风格将使用写实分支流程（支持口型同步等写实 MV 能力）。读取 `phases/realistic-pipeline.md`，从 STEP 0 开始执行，将已有的音频文件路径和歌词数据（`.mv/{song_name}/lyric.md`）传递过去，跳过已完成的音频获取和歌词提取步骤
- **非写实风格（油画、插画、动画、自定义非写实等）** → 继续 mv-creator 的下一阶段（脚本生成）