# 分镜表

分镜表是一张表，列出一集里的每个镜头。图片、提示词和视频版本都从它做出来。

分镜表是这一集文件夹里 `shots.md` 里的一张表。一行是一个镜头，一个镜头是视频模型一次调用做出的一个视频。你的 Agent 在分镜表环节里，根据这一集的剧本写出它。

你可以在应用的 **分镜表** 标签页里改任何一格。用 `minicut open PROJECT --episode EPISODE --tab shots` 打开它，或者用 [minicut script](/zh-cn/docs/cli/projects#minicut-script) 编辑这张表。在 `minicut script` 编辑器里每次保存，都会运行检查 4 到 6。

## 一个镜头

一个镜头有一个 id，比如 `C01`。同一个 id 也是它的文件夹名，`clips/c01`。表里每一列对应镜头里的一样东西：

| 列 | 内容 |
|---|---|
| `Clip` | 镜头的 id，比如 `C01` |
| `Sec` | 镜头长度，单位是秒，是一个数字 |
| `Size` | 景别 |
| `Angle/move` | 机位角度和运镜 |
| `Action` | 镜头里发生什么 |
| `Line (speaker)` | 台词，以及谁说的 |
| `Sound` | 镜头的声音 |
| `Who` | 镜头里的角色，写成 `@name` 标签，或 `-` |
| `Where` | 镜头的场景，写成一个 `@name` 标签，或 `-` |
| `Props` | 镜头里的道具，写成 `@name` 标签，或 `-` |
| `On-screen text` | 写在画面里的字，比如招牌 |
| `Cut` | |

一个视频里的镜头切换，写在它的 `Action` 格里，不加额外的行。剪辑器做的卡片，比如片尾卡，是 id 像 `E01` 的一行。

表的上方，计划单独用一行写出这一集的目标长度。表的下方，一行 `Screen order:` 把每个镜头列出一次，按播放顺序。

`Sec` 要符合你选的视频模型，因为每个模型都有自己最短和最长的镜头。见 [minicut check STEP](/zh-cn/docs/cli/checks-and-loops#minicut-check-step)。

## 镜头状态

一个镜头同一时间只有一个状态。应用和 `minicut shots` 显示同样的词。状态每次都由镜头的文件算出来，所以应用和 CLI 总是一致。

| 状态 | 显示为 | 含义 |
|---|---|---|
| `sheet` | 待写提示词 | 镜头在分镜表上，还没有提示词 |
| `writing` | 写提示词 | 你的 Agent 正在写提示词 |
| `promptFail` | 提示词未通过 | 提示词没有通过检查 |
| `ready` | 生成 | 提示词写好了，镜头可以生成 |
| `queued` | 排队中 | 这个镜头的一个任务在等待开始 |
| `running` | 生成中 | 这个镜头的一个任务正在运行 |
| `saving` | 保存中 | 结果正在存成一个版本 |
| `failed` | 生成失败 | 任务失败了，这一行会显示原因 |
| `stopped` | 已停止 | 任务被停止了 |
| `unchecked` | 待检查 | 镜头有一个还没检查的版本 |
| `fail` | 未通过 | 版本没有通过某项检查，这一行显示第一个原因 |
| `done` | 已生成 | 版本已做好，并通过了检查 |

`minicut shots` 列出每个镜头和它的状态。见 [minicut shots](/zh-cn/docs/cli/projects#minicut-shots)。

## 下一步

[步骤和环节](/zh-cn/docs/cli/steps-and-loops) [项目目录](/zh-cn/docs/cli/project-directory) [项目文件](/zh-cn/docs/cli/project-files)