# 超人三段飞行 · 官方工作流版 v2（真·参考图修复版）

- 生成日期：2026-09-05
- 人物素材：`/10-视频生成流水线/体操服练舞室22s/pic1_front.jpg`（正面身份锚定）+ `pic2_full.jpg`（三视图外观补充）
- 规格：544×960（竖屏 9:16），24 fps，H.264+AAC，三段各 8 秒，拼接后 24 秒
- 工作流：`ComfyUI_MiniMaxH3_Director` 官方节点（MiniMaxH3Director + CreateVideo + SaveVideo）
- **与旧版官方（`超人三段官方/`）的区别：本版修复了参考图未生效的问题，女主与素材 pic1 吻合**

## ⚠️ 重要：v1 官方版的缺陷与本修复

**用户指出 v1 官方版"没用人物的参考图"——核查属实，根因已定位并修复：**

1. **现象**：v1 官方版三段 R2V 任务在 ComfyUI 日志中均有
   `[WARNING] gen segment #1 task=r2v has no reference media — will behave like t2v/t2i`
   ——参考图被静默丢弃，退化为纯文本生成，人物自然不像素材。
2. **根因**（源码级确认 `director/gen_timeline.py`）：
   - r2v 属于 `PROMPT_BATCH_KEYS`，即便 timeline 写 `editMode: "global"` 也会被
     `is_prompt_batch_timeline()` 强制改成 `segment` 模式；
   - 在 segment 模式下，**全局参考图 `global.refs` 只在 `global.commonEnabled == true` 时
     才会合并进分段**（`merge_indexed_refs(global_refs, local_refs)`）；
   - 我们提交的 timeline 没有设置 `commonEnabled` → 分段 refs 为空 → 退化 t2v。
3. **修复**：timeline 的 `global` 块加入 `"commonEnabled": True`，并用官方节点函数
   `prepare_director_plan()` 实测验证：`seg 0 task: r2v refs: 2 ✅`。
4. **验证**：修复后日志后再无 "no reference media" 警告；修复版段1 实测女主为
   年轻亚洲女性、空气刘海+高马尾、米白→浅蓝渐变连体泳衣式（非两件套）；
   修复版段3 2.0s 帧识图确认"完全符合 pic1 参考图"。

## 三段成品（修复版）

| 段落 | 文件 | 内容 | 模式/参考图 | seed |
|---|---|---|---|---|
| 段1 | `seg1/seg1.mp4` | 天台起飞：女主（渐变连体泳衣+深红披风，**与pic1一致**）站立→下蹲→爆发腾空，尘土碎石爆炸状冲天，镜头低角度仰拍钉地只仰转 | 官方 R2V（ref2va，正面+三视图） | 1001 |
| 段2 | `seg2/seg2.mp4` | 战机驾驶舱：飞行员（白头盔+护目镜+氧气面罩+绿飞行服）握杆巡航、转头看窗外 | 官方 T2V（fl2va，纯文本） | 902（复用） |
| 段3 | `seg3/seg3.mp4` | 并排飞行：红披风女主（与pic1一致，齐刘海+高马尾+渐变紧身衣）出现在战机旁→飞行员震惊→并排同速→收尾 | 官方 R2V（ref2va，正面+三视图+段2末帧） | 1003 |

## 拼接成片

- `final/20260905_1135_超人三段_官方工作流版v2_真参考图_24s.mp4`（24.0s）
- 三段同规格直接 ffmpeg concat

## 目录结构

```
超人三段官方v2/
├── seg1/  修复版R2V段1（seed 1001）
├── seg2/  官方T2V段2（复用） + 末帧参考图
├── seg3/  修复版R2V段3（seed 1003）
├── final/ 拼接成片
└── 00-说明.md
```

## 与 DSW 加速版对照

| | 官方版 v2（本目录） | DSW V18 加速版（超人三段v2） |
|---|---|---|
| Director | `MiniMaxH3Director`（官方时间轴 v4） | `DaSiWaMiniMaxH3DirectorLegacy` |
| 权重 | 段1/3 ref2va + fp16 VAE | 统一 fl2va + int8 VAE |
| 采样 | 25 步 res_multistep+simple | 8 步 turbo |
| 参考图 | ✅ `commonEnabled` 修复后正常加载 | 正常 |
| 女主一致性 | ✅ 刘海+高马尾+渐变连体衣+红披风 | ✅ 同样 |