文档 / 指南
剪辑一集
运行剪辑环节,用时间线命令修改剪辑稿,再把成片渲染成一个视频文件。
剪辑把选定的版本拼成一份剪辑稿:按顺序排好的镜头、台词配音、字幕和音乐。你的 Agent 运行剪辑环节。你看剪辑稿,说好。
在你认可视频环节之后再开始,见生成并选定视频版本。这里的每条命令都要求这台电脑已经登录。修改或渲染剪辑稿的命令在这一集的文件夹里运行,所以先运行:
Terminal
cd rain-shop/episodes/ep01打开剪辑稿
- 在 MiniCut 应用里打开这一集,进剪辑标签页。项目是
rain-shop:
Terminal
minicut open rain-shop --episode ep01 --tab editor- 打开它打印的地址。剪辑器里显示剪辑稿。
- 如果应用没有启动,运行
minicut edit rain-shop --episode ep01。见剪辑器。
修改剪辑稿
在剪辑器里修改剪辑稿,或者用 minicut timeline。不要手写剪辑稿文件 index.html。剪辑环节会让手写的剪辑稿失败,在 Claude Code 和 Codex 里,有一个钩子会拒绝这次写入。
- 列出剪辑稿:每条轨道和每个片段,带它的开始和结束时间。
Terminal
minicut timeline- 改字幕、标题或卡片上的文字:
Terminal
minicut timeline set '#cap-c05-l01' --text "I never left."- 改过文字或时间之后,修好字幕。它保留文字,重新拆分,并按配音对好时间:
Terminal
minicut captions- 如果一个版本比它的镜头短,剪辑稿会把版本的最后一帧定住。把镜头裁短到和版本一样长。先看方案,再执行:
Terminal
minicut timeline fit --plan
minicut timeline fit- 想撤销这次裁短,运行
minicut timeline fit --undo。想撤销其他修改,运行minicut timeline undo RECEIPT。RECEIPT是那次修改打印的撤销凭据。 - 想不渲染就看剪辑稿,存几张静帧:
Terminal
minicut snapshot --at 1,3,5 -o snapshots运行剪辑环节
- 你的 Agent 运行:
Terminal
minicut loop run edit- 命令把剪辑稿渲染到这一集文件夹里的
renders/edit-r1.mp4。数字是第几轮。然后它检查剪辑稿和渲染结果。 - 每个失败都打印成
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 |
环节还会检查字幕和时间线本身。
- 你的 Agent 照着每个修法改,再运行命令。3 轮之后,环节会打印
CAP REACHED, stop and show the user what is still failing,由你来决定。
渲染成片
- 在这一集的文件夹里渲染最终文件:
Terminal
minicut render -o renders/ep01.mp4 --quality delivery--quality 可以是 draft、looks 或 delivery。
2. 在项目文件夹里检查做好的文件:
Terminal
minicut check render episodes/ep01 episodes/ep01/renders/ep01.mp4它会打印每个失败和它的修法,然后是 RESULT: PASS 或 RESULT: FAIL,并把结果存在视频文件旁边。
认可剪辑稿
- 用
minicut open rain-shop --episode ep01 --tab editor打开剪辑稿并观看。 - 没问题就说好。你的 Agent 运行:
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. | 登录。见账号 |