# 剪辑一集

运行剪辑环节，用时间线命令修改剪辑稿，再把成片渲染成一个视频文件。

剪辑把选定的版本拼成一份剪辑稿：按顺序排好的镜头、台词配音、字幕和音乐。你的 Agent 运行剪辑环节。你看剪辑稿，说好。

在你认可视频环节之后再开始，见[生成并选定视频版本](/zh-cn/docs/cli/generate-and-pick-video-takes)。这里的每条命令都要求这台电脑已经登录。修改或渲染剪辑稿的命令在这一集的文件夹里运行，所以先运行：

```bash Terminal
cd rain-shop/episodes/ep01
```

## 打开剪辑稿

1. 在 MiniCut 应用里打开这一集，进剪辑标签页。项目是 `rain-shop`：

```bash Terminal
minicut open rain-shop --episode ep01 --tab editor
```

2. 打开它打印的地址。剪辑器里显示剪辑稿。
3. 如果应用没有启动，运行 `minicut edit rain-shop --episode ep01`。见[剪辑器](/zh-cn/docs/cli/editor)。

## 修改剪辑稿

在剪辑器里修改剪辑稿，或者用 `minicut timeline`。不要手写剪辑稿文件 `index.html`。剪辑环节会让手写的剪辑稿失败，在 Claude Code 和 Codex 里，有一个钩子会拒绝这次写入。

1. 列出剪辑稿：每条轨道和每个片段，带它的开始和结束时间。

```bash Terminal
minicut timeline
```

2. 改字幕、标题或卡片上的文字：

```bash Terminal
minicut timeline set '#cap-c05-l01' --text "I never left."
```

3. 改过文字或时间之后，修好字幕。它保留文字，重新拆分，并按配音对好时间：

```bash Terminal
minicut captions
```

4. 如果一个版本比它的镜头短，剪辑稿会把版本的最后一帧定住。把镜头裁短到和版本一样长。先看方案，再执行：

```bash Terminal
minicut timeline fit --plan
minicut timeline fit
```

5. 想撤销这次裁短，运行 `minicut timeline fit --undo`。想撤销其他修改，运行 `minicut timeline undo RECEIPT`。`RECEIPT` 是那次修改打印的撤销凭据。
6. 想不渲染就看剪辑稿，存几张静帧：

```bash Terminal
minicut snapshot --at 1,3,5 -o snapshots
```

## 运行剪辑环节

1. 你的 Agent 运行：

```bash Terminal
minicut loop run edit
```

2. 命令把剪辑稿渲染到这一集文件夹里的 `renders/edit-r1.mp4`。数字是第几轮。然后它检查剪辑稿和渲染结果。
3. 每个失败都打印成 `FAIL`，带一个标签和修法：

| 标签 | 意思 |
|---|---|
| `hand edit` | `index.html` 被手动改过。用 `minicut timeline` 或在剪辑器里修改剪辑稿 |
| `held frame` | 镜头比它的版本长。运行 `minicut timeline fit` |
| `music fit` | 音乐是按比这份剪辑稿长或短 1 秒以上的剪辑稿写的。运行 `minicut music cuts` 拿新的镜头时间，重新写歌，再运行 `minicut music render` |
| `repeat` | 同一张画面出现在两个镜头里。修法是 `minicut timeline trim` |
| `cut` | 画面在一个镜头里变了，而分镜表没有要求。修法是 `minicut timeline trim` |
| `read-back` | 渲染结果里的台词没有把某一句说出来 |
| `render` | 剪辑稿没有渲染成功。修法是 `minicut render lint` |

环节还会检查字幕和时间线本身。

4. 你的 Agent 照着每个修法改，再运行命令。3 轮之后，环节会打印 `CAP REACHED, stop and show the user what is still failing`，由你来决定。

## 渲染成片

1. 在这一集的文件夹里渲染最终文件：

```bash Terminal
minicut render -o renders/ep01.mp4 --quality delivery
```

`--quality` 可以是 `draft`、`looks` 或 `delivery`。
2. 在项目文件夹里检查做好的文件：

```bash Terminal
minicut check render episodes/ep01 episodes/ep01/renders/ep01.mp4
```

它会打印每个失败和它的修法，然后是 `RESULT: PASS` 或 `RESULT: FAIL`，并把结果存在视频文件旁边。

## 认可剪辑稿

1. 用 `minicut open rain-shop --episode ep01 --tab editor` 打开剪辑稿并观看。
2. 没问题就说好。你的 Agent 运行：

```bash Terminal
minicut loop approve edit
```

## 检查是否成功

在项目文件夹里运行 `minicut loop`。每个环节都显示为已通过或已完成。文件 `episodes/ep01/renders/ep01.mp4` 就是成片。

## 错误

| 信息 | 怎么做 |
|---|---|
| `no index.html yet` | 这一集还没有剪辑稿。你的 Agent 先排出第一份剪辑稿，再运行环节 |
| `index.html was changed by hand` | 用 `minicut timeline undo RECEIPT` 撤销，或者用 `minicut timeline` 或在剪辑器里重新做这次修改 |
| `minicut loop runs inside a project folder (the one with series.json, or any folder under it).` | 在项目文件夹里运行环节 |
| `You are not signed in. Ask your agent to run minicut login.` | 登录。见[账号](/zh-cn/docs/cli/account) |

## 下一步

[剪辑器](/zh-cn/docs/cli/editor) [检查和环节](/zh-cn/docs/cli/checks-and-loops) [概览](/zh-cn/docs/cli/overview)