short-drama-edit

短剧剪辑与成片

把 剧集/<EP>/制作成果/ 里的逐镜素材装配成一条成片，取舍写进 剧集/<EP>/剪辑单.md。 每段使用二级标题 ## CUT-...，各自绑定一个 MOTION-... 和一个真实媒体文件。

本阶段是套件里唯一同时看得见成片和创作意图的位置。上游每一份文档描述的都是「这一镜 应该是什么」；只有到这里，才第一次能回答「生成出来的这一段，哪一部分真的能用」。这两件事经常 不一致，而处理这个不一致正是剪辑的工作，不是缺陷。

Quick Start

用 $short-drama-edit 把 EP001 已生产的镜头剪成成片

入口

进入条件是素材已经存在且可读：剧集/<EP>/制作成果/ 里有本次要用的视频文件。 提示词写完、job 确认过、adapter 返回成功，都不等于素材可用；本阶段只认当前能打开的文件字节。

素材不全时不要等齐。已有素材能构成一段连续可看的内容就可以先剪，把缺口写进「未采用镜头」并 说明它缺的是文件还是质量。剪一版看得见的东西，比拿着完整清单空等更能暴露上游问题。

剧集/<EP>/分镜.md 与 视频提示词.md 是镜序和职责的来源。剪辑可以取舍它们，不能改写 它们：删一镜、缩一镜、换顺序都属于本阶段；改台词、改镜头职责、改起终状态要回上游发修订请求。

渲染与测量需要 ffmpeg / ffprobe 在 PATH 上。没有时 edit_tool.py 直接失败并说明， 不用别的手段近似，也不把「没测」写成「通过」。

工作流

1. 逐段看完整素材，先标可用带，再谈剪辑。 每个文件从头到尾看一遍，写下它实际能用的时间 区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。 这一步的产出是事实，不是决定。做法见 生成素材的可用带。
2. 有台词的镜先按发声定边界。 台词完整性优先于画面取舍：先确定这句话从哪一帧开始出声、 哪一帧收尾，再在这个约束内选画面入出点。切在字中间是结构缺陷，不是节奏选择。
3. 在可用带内选叙事入出点。 入点取动作已经在进行中的那一帧，出点取信息完成之后、缺陷 开始之前。逐段写清入点理由和出点理由。做法见 入出点与镜序。
4. 排镜序并检查相邻关系。 相邻两段不同时具备同景别、同机位、同运动方向；重复承担同一 信息的段落删掉一段，而不是两段各留一半。
5. 对一遍相邻段的画面。 逐镜生成的素材会漂移：同一个人、同一张桌子的两条， 回来可能差一档曝光、半步白平衡。差得看得出来时，在那一段写一行 画面。 做法见 接镜与色彩一致性。
6. 处理声音接缝与响度。 逐镜生成的素材各自带着自己的环境声或音乐，直接拼接会在每个剪辑 点留下音床硬切。做法见 声音、字幕与音乐。
7. 写字幕。 字幕的每一个字都取自 剧本.md 的台词原文，不取自转写结果；标点可按字幕惯例调整， 字不能改。转写只用来定位时间。
8. 写出 剪辑单.md，再渲染。 先有文档后有成片：文档是可审查、可修订、可复现的那一份， 成片是它的产物。
9. 按可测项验收成片，再交付。 见 交付与验收。

剪辑单要求

• 正文开头写交付规格：成片目标时长、画幅与帧率、交付响度、字幕。目标时长是意图， 实际时长可以不等于它；差多少、为什么，写在末尾报告里，不靠删内容硬凑。

• 每段一个 ## CUT-<EP>-<序号> · <中文名称>，块内逐行写：

  • - 来源：<MOTION-...> · <项目相对路径>——MOTION-... 必须是 视频提示词.md 里真实存在 的条目，路径必须是当前可读的文件。
  • - 入点：<秒> / - 出点：<秒> / - 时长：<秒>——三者必须自洽，出点 - 入点 == 时长。 全部用秒，保留两位小数，不写时间码，不写帧号。
  • - 取舍：入点=<理由>；出点=<理由>——理由写画面上发生了什么，不写「节奏需要」。 这一行是本阶段唯一的创作记录；它解释的是为什么丢掉了没被选中的那些帧。
  • - 声音：<本段声音怎么处理>——保留原声、压低、静音、交叉淡入、接住音乐落点，逐段说清。
  • - 画面：<接镜校正> 或 - 画面：无——只在这一段与相邻段明显对不上时写， 格式是「亮度 <数>」「饱和 <数>」「色温 <数>」三项的任意组合，用 ； 分隔。 详见 接镜与色彩一致性。
  • - 字幕：<逐字台词原文> 或 - 字幕：无。本段有多句台词时改用编号写法， 每句自带时间：- 字幕 1：0.20-1.50 就是什么、- 字幕 2：2.30-4.30 就是少了点东西…… 编号从 1 连续，时间不得重叠。一镜不等于一句——一次三个来回的对话是一个过肩镜头， 只写一条字幕会让另外两句在成片上无声地消失。

• 素材里没有被采用的镜头，在正文开头写一行 - 未采用镜头：<MOTION-...>（理由：……）， 多项用 ； 连接。理由区分两类：文件缺失（还没生产 / 生产失败）和质量不可用 （生成结果不能用）。两者在文档里长得一样，但一个要回生产、一个要回上游改提示词。

• 同一个 MOTION-... 可以拆成多个 CUT-...（同一段素材的两处分别使用），也可以整段不用。 不能凭空出现没有素材来源的 CUT-...。

• 一段素材被用两次时，两个 CUT-... 的区间不得重叠：同一批帧在成片里出现两次是重复镜头， 不是复用。确需重复出现（闪回、强调）时写明它是有意重复，并说明第二次为什么仍然成立。