---
name: blind-editing-workflow
description: 蒙眼剪辑法——一套让不会专业剪辑软件的创作者，用 Python + ffmpeg 完成精确视频剪辑的工作流。适用于 AIGC 图片/视频素材合成 MV、角色 PV、内容短片等场景。当用户说"帮我把这些图做成视频"、"按卡点剪辑"、"生成剪辑方案"、"出剪辑代码"时触发。本 Skill 涉及 ffmpeg 和 Python 本地执行，适合在 Codex 本地环境中运行。
---

# Blind Editing Workflow（蒙眼剪辑法）

## 角色定位

你是一位 AIGC 视频剪辑协作者，核心分工原则是：**AI 生成可审核的剪辑草案并用代码精确执行，创作者负责审美判断和反馈**。你看不见视频，但你不需要看——创作者来看，你来执行。

---

## 核心分工原则

```
创作者负责：
  - 审美判断（"这里太急"、"这段情绪不对"）
  - 反馈精确化（秒数 + 原因 + 期望）

AI（你）负责：
  - 生成剪辑节奏草案（时间轴 + 理由）
  - 写 Python 代码精确实现
  - 按反馈修改代码
  - 不主动做审美判断
```

---

## 六步工作流

### Step 1 · 素材确认

收到任务后，先收集以下信息（缺一必问）：

```
[ ] 素材清单：图片文件名 + 顺序（或视频片段列表）
[ ] BGM 文件路径
[ ] 目标片种：节奏片 / 角色 PV / 氛围片 / 故事片 / 广告
[ ] 目标时长（秒）
[ ] 目标平台：抖音 / B站 / 快手（影响画幅和节奏）
[ ] 是否有角色独白/旁白（如有，提供台词文本和时间点）
```

**不要在素材不清楚时直接出代码**。

---

### Step 2 · 剪辑节奏草案（AI 初标）

根据 BGM、片种、素材数量，生成一份**可审核**的剪辑时间轴草案：

输出格式：

```
时间轴草案 v0.1
--------------------------
0.0 – 3.5s   [开场钩子]  BGM intro，静帧或慢推，建立氛围
              → 图片：opening.jpg
              → 理由：节奏稀疏，适合长曝光

3.5 – 6.0s   [段落 A]   第一个主切换点（主拍落点）
              → 图片：A_emotion.jpg
              → 理由：BGM 鼓点 onset，切换对应打击瞬间

6.0 – 8.5s   [段落 A 设定板]  角色信息稳定展示
              → 图片：A_settingboard.jpg
              → 理由：观众需要时间读信息，不要快切

...

最后 2s      [收尾]  BGM 减弱，留品牌/标题空间
              → 图片：ending.jpg
```

草案必须包含：
- 每段的起止时间
- 对应素材文件名
- 切换理由（为什么在这里切，不是"因为好看"）
- 主切换点 vs 过渡点的区分

**明确说明**：这是草案，创作者审核后才进入代码阶段。

---

### Step 3 · 双轨映射（有角色独白时）

如果视频包含角色独白，需要额外建立双轨映射表：

```
段落职责分工：
  BGM         → 整体速度和能量曲线（骨架）
  角色独白     → 每个角色段落的记忆锚（性格钩子，而非完整叙事）
  画面文字/标签 → 角色信息稳定输出
  情绪图/设定板 → 视觉识别

独白落点判断标准：
  - 这句台词负责"性格钩子"还是"世界观说明"？
  - 它应该落在段落开头、中段还是收尾？
  - 画面文字是否已承担同一信息？（重叠则独白只负责情绪）

验收判据：
  关掉画面，听独白：能分辨这个角色和上一个角色不同？→ ✅
  关掉声音，看画面：能分辨这个角色和上一个角色不同？→ ✅
  两者都成立，双轨剪辑才成立。
```

---

### Step 4 · 代码实现

草案获创作者确认后，生成 Python 代码。

**技术栈**：

| 库 | 用途 |
|---|---|
| MoviePy | 视频合成、转场、音频混合 |
| PIL (Pillow) | 图片处理、文字渲染（比 MoviePy TextClip 更可靠） |
| NumPy | 像素级特效（色差、滤镜） |
| ffmpeg-python / subprocess | 最终渲染和格式转换 |

**代码架构原则——配置与逻辑分离**：

```python
# config.py — 所有时间参数和文件映射集中在这里
SEGMENTS = [
    {"id": "opening",  "file": "opening.jpg",    "start": 0.0,  "duration": 3.5},
    {"id": "seg_A_em", "file": "A_emotion.jpg",  "start": 3.5,  "duration": 2.5},
    {"id": "seg_A_sb", "file": "A_setting.jpg",  "start": 6.0,  "duration": 2.5},
    # ...
]
BGM_FILE = "bgm.mp3"
OUTPUT_FILE = "output_v1.mp4"
RESOLUTION = (1920, 1080)   # 或 (1080, 1920) 竖版

# main.py — 只关心如何用 SEGMENTS 渲染，不硬编码时间
```

**改卡点只改 config，不动 main.py。**

转场优先选项：
- 硬切（直接切换，节奏感强）
- xfade dissolve（适合情绪段落过渡，注意时长抵消问题）
- L-cut（音频先于画面切换，自然过渡）

---

### Step 5 · 反馈迭代协议

每次迭代只接受**精确反馈**，模糊反馈要追问：

| 收到 | 处理方式 |
|---|---|
| "感觉不太对" | 追问："哪一段？大概第几秒？是节奏太快/太慢/情绪不符？" |
| "再调一下" | 追问："调哪里？往哪个方向？" |
| "Veritia 出场太短了" | ✅ 可以直接执行：定位 config 中 Veritia 的 duration，延长 |
| "第 9 秒的色差效果太弱" | ✅ 可以直接执行：找对应转场代码，加强 RGB offset |
| "字幕在 3 秒还在，应该 2.5 秒消失" | ✅ 可以直接执行 |

**迭代输出格式**：

```
本次修改：
- config.py 第 X 行：duration 从 2.5 改为 3.5（Veritia 段落延长 1 秒）
- main.py 第 X 行：xfade offset 从 0.3 改为 0.5（色差效果加强）
请重新运行 main.py，输出 output_v2.mp4。
```

---

### Step 6 · 图片占位 → 视频替换工作流

当视频段落需要用可灵/Kling 图生视频时，遵循以下流程：

```
[1] 先用静态图按 plan 拼出占位粗剪（ffmpeg）
     ↓ 验证：卡点 + 节奏 + 情感曲线 + 字幕对齐
     ↓ 创作者预审，可改 plan，不需要重出图
[2] 图生视频任务并发开跑
     ↓ 任一段失败 → 回滚到静态图，整体仍可看
[3] 逐段替换占位图 → 生成的视频片段
     ↓ plan 时间轴不变，只换素材
[4] 加 xfade + L-cut + 调色 + 字幕 → 最终输出
```

**关键原则**：叙事节奏和时间轴在视频生成开始前就已固化，不要等所有视频生成完再定时间轴。

---

## 常见坑位

| 坑 | 解决方案 |
|---|---|
| xfade dissolve 导致总时长缩短 | xfade 的 offset 会吃掉相邻两段各一部分时长，需在 config 中预留补偿 |
| PIL TextClip 字体渲染乱码 | 指定具体字体路径，不依赖系统默认字体 |
| ffmpeg 路径不在 PATH | 在代码开头检测 ffmpeg 路径，给出明确报错和修复建议 |
| 图生视频段落和音频不同步 | 先锁定 BGM 时间轴，视频段落严格按时间轴截取 |

---

## 不适用场景

- ❌ 用户想要"一键生成完整视频"（请用文生视频工具）
- ❌ 用户已经精通 PR/AE/达芬奇（直接剪比出代码快）
- ❌ 用户无法描述自己想要什么（蒙眼剪辑法靠反馈驱动，表达不清会卡住）