91 lines
4.3 KiB
Markdown
91 lines
4.3 KiB
Markdown
# 关键物件图生成
|
||
|
||
## 目标
|
||
|
||
基于脚本中标注的关键物件，为需要跨镜头保持视觉一致的非人物元素生成统一参考图。
|
||
|
||
## 物件类别
|
||
|
||
- **道具**：武器、信物、乐器、书信等手持/随身物品
|
||
- **载具**：马、车、船、摩托等交通工具
|
||
- **场景地标**：反复出现的特定建筑、标志性场所、门牌等
|
||
- **动物/宠物**：有辨识度的伴随动物
|
||
|
||
## 流程
|
||
|
||
### 1. 自动提取
|
||
|
||
读取 `script.md` 中所有 `**关键物件：**` 字段，汇总并去重。列出在 **2 幕及以上** 重复出现的物件，附带每个物件的出场幕列表和外观描述摘要。
|
||
|
||
### 2. 用户确认
|
||
|
||
通过 `AskUserQuestion` 让用户确认/增删物件列表（选项：确认当前列表 / 我要增减物件）。
|
||
|
||
如果最终列表为空（脚本中无跨镜头物件），通过 `AskUserQuestion` 确认后跳过此阶段。
|
||
|
||
### 3. 生成参考图
|
||
|
||
为每个物件生成 2～3 张候选图。宽高比根据物件类型选择：
|
||
|
||
| 物件类型 | 宽高比 | 说明 |
|
||
|----------|--------|------|
|
||
| 道具/小物件 | **1:1** | 正方形，突出物件细节 |
|
||
| 载具/动物 | **3:2** 横版 | 展示整体形态和比例 |
|
||
| 场景地标 | **16:9** 宽屏 | 展示建筑/场所全貌 |
|
||
|
||
使用 `all_in_one_image_generation`（model_name: `all_in_one_pro`）或 `nano_banana_image_generation`（model_name: `nano_banana_2`）生成候选图。提示词融合：物件外观描述（从 script.md 汇总）+ 美术风格关键词 + `art_style.md` 的 `风格JSON：` 内容（如在提示词末尾附加 `Art style: {JSON 内容}`）。
|
||
|
||
### 4. 用户选图
|
||
|
||
启动预览，展示物件卡片和候选图网格，用户为每个物件选定最终参考图。调用 MCP 工具 `preview_and_collect_feedback`：
|
||
- **script**: `.opencode/skills/mv-creator/scripts/render_preview.py`
|
||
- **args**: `[".mv/{song_name}/{theme}", "--type", "props", "--lang", "{lang}"]`
|
||
- **feedback_path**: `.mv/{song_name}/{theme}/feedback.md`
|
||
|
||
预览页面展示各物件信息卡片和候选图。
|
||
每个物件默认选中第一张候选图作为兜底，用户点击图片切换选定。
|
||
反馈处理逻辑同人设图阶段：
|
||
- 以 `LGTM` 开头 → 将各物件的选定候选图复制为 `selected.jpg`，更新 `design.md`，进入下一阶段
|
||
- 包含 `修改建议：` → 解析建议，调整 prompt 重新生成候选图，更新后重新校验和预览
|
||
|
||
## 输出格式
|
||
|
||
每个物件独立一个目录和设计文件。**严格按用户语言选择对应的 example 和字段名**（参见 SKILL.md「输出控制」和「Markdown 字段名中英对照表」）：
|
||
- 中文用户：参考 `references/props-design-example.md`，字段用中文（`外观描述`、`叙事作用`、`生图设定`、`候选图`、`选定图`），内容用中文
|
||
- 非中文用户：参考 `references/props-design-example-en.md`，字段用英文（`Appearance`、`Narrative Role`、`Image Settings`、`Candidates`、`Selected`），内容用对应语言
|
||
|
||
关键要点：
|
||
- 一级标题 `#` 用于物件名
|
||
- 外观描述/Appearance 用列表逐项描述（类型、形态、颜色/材质、尺寸/比例、细节特征）
|
||
- 生图设定/Image Settings 包含三个子字段：`提示词/Prompt`（英文）、`模型/Model`、`参考图/Reference`
|
||
|
||
## 格式校验
|
||
|
||
design.md 写入后，**必须**运行校验脚本：
|
||
|
||
```bash
|
||
# 校验单个物件
|
||
python3 .opencode/skills/mv-creator/scripts/validate_props_design.py .mv/{song_name}/{theme}/props/{item_name}/design.md
|
||
|
||
# 校验所有物件
|
||
python3 .opencode/skills/mv-creator/scripts/validate_props_design.py .mv/{song_name}/{theme}/props/
|
||
```
|
||
|
||
校验规则：必需分区完整性、外观描述列表项、生图设定子字段、候选图非空且文件存在。
|
||
|
||
- **通过** → 启动预览供用户选图
|
||
- **未通过** → 由 LLM 根据校验错误信息自动修正，修复后重新校验
|
||
|
||
## 文件存储
|
||
|
||
**目录名规则**：`{item_name}` 统一使用英文小写 + 下划线（如 `guitar`、`pickup_truck`），不使用中文或显示名。该目录名是分镜阶段引用物件的唯一标识。
|
||
|
||
```
|
||
./.mv/{song_name}/{theme}/props/
|
||
├── {item_name}/
|
||
│ ├── design.md # 物件设计说明
|
||
│ ├── candidate_01.jpg # 候选图
|
||
│ ├── candidate_02.jpg
|
||
│ └── selected.jpg # 最终选定图（用户挑选）
|
||
```
|