文档 / 指南

剪辑一集

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

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

在你认可视频环节之后再开始,见生成并选定视频版本。这里的每条命令都要求这台电脑已经登录。修改或渲染剪辑稿的命令在这一集的文件夹里运行,所以先运行:

Terminal
cd rain-shop/episodes/ep01

打开剪辑稿

  1. 在 MiniCut 应用里打开这一集,进剪辑标签页。项目是 rain-shop:
Terminal
minicut open rain-shop --episode ep01 --tab editor
  1. 打开它打印的地址。剪辑器里显示剪辑稿。
  2. 如果应用没有启动,运行 minicut edit rain-shop --episode ep01。见剪辑器。

修改剪辑稿

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

  1. 列出剪辑稿:每条轨道和每个片段,带它的开始和结束时间。
Terminal
minicut timeline
  1. 改字幕、标题或卡片上的文字:
Terminal
minicut timeline set '#cap-c05-l01' --text "I never left."
  1. 改过文字或时间之后,修好字幕。它保留文字,重新拆分,并按配音对好时间:
Terminal
minicut captions
  1. 如果一个版本比它的镜头短,剪辑稿会把版本的最后一帧定住。把镜头裁短到和版本一样长。先看方案,再执行:
Terminal
minicut timeline fit --plan
minicut timeline fit
  1. 想撤销这次裁短,运行 minicut timeline fit --undo。想撤销其他修改,运行 minicut timeline undo RECEIPT。RECEIPT 是那次修改打印的撤销凭据。
  2. 想不渲染就看剪辑稿,存几张静帧:
Terminal
minicut snapshot --at 1,3,5 -o snapshots

运行剪辑环节

  1. 你的 Agent 运行:
Terminal
minicut loop run edit
  1. 命令把剪辑稿渲染到这一集文件夹里的 renders/edit-r1.mp4。数字是第几轮。然后它检查剪辑稿和渲染结果。
  2. 每个失败都打印成 FAIL,带一个标签和修法:
标签意思
hand editindex.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

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

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

渲染成片

  1. 在这一集的文件夹里渲染最终文件:
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,并把结果存在视频文件旁边。

认可剪辑稿

  1. 用 minicut open rain-shop --episode ep01 --tab editor 打开剪辑稿并观看。
  2. 没问题就说好。你的 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.登录。见账号

下一步