short-drama-edit

短剧剪辑与成片

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

根据实际素材选择可用片段，按剧本与分镜核对叙事。素材与意图不一致时，记录取舍和缺口。

Quick Start

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

入口

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

素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。 在「未采用镜头」说明缺文件、质量不可用或叙事取舍。

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

内置渲染直接拼接编码后的分段，输入素材的画幅与帧率须一致。check 在可探测媒体时核对； 不同规格先通过外部工具按交付要求统一，保留构图并记录裁切或留边，再更新剪辑单的路径与时间。

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

工作流

1. 逐段看完整素材，先标可用带，再谈剪辑。 每个文件从头到尾看一遍，写下它实际能用的时间 区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。 这一步的产出是事实，不是决定。做法见 生成素材的可用带。
2. 有台词的镜先定位发声区间。 保留完整字音和所需停顿。内置工具同步切画面与声音； 需要在连续对白上换画面时，使用外部剪辑工具分开处理。
3. 在可用区间内选叙事入出点。 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷 开始之前。逐段写清入点理由和出点理由。做法见 入出点与镜序。
4. 排镜序并检查相邻关系。 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
5. 比较相邻段的画面。 按同场景、同光态比较可比区域；有可见偏差时在对应段写 画面。 做法见 接镜与色彩一致性。
6. 处理声音接缝与响度。 拼接后回听；需要混音时通过外部工具执行并记录。 做法见 声音、字幕与音乐。
7. 写字幕。 字幕的每一个字都取自 剧本.md 的台词原文，不取自转写结果；标点可按字幕惯例调整， 字不能改。转写只用来定位时间。
8. 写出 剪辑单.md，再渲染。 先有文档后有成片：文档是可审查、可修订、可复现的那一份， 成片是它的产物。
9. 按可测项验收成片，再交付。 见 交付与验收。

剪辑单要求

• 正文开头写交付规格：成片目标时长、画幅与帧率、交付响度、字幕。目标时长是意图， 实际时长与目标的差写在报告里。用户明确要求固定时长时，应满足要求或报告缺少的素材。

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

  • - 来源：<MOTION-...> · <项目相对路径>——MOTION-... 必须是 视频提示词.md 里真实存在 的条目，路径必须是当前可读的文件。
  • - 入点：<秒> / - 出点：<秒> / - 时长：<秒>——三者必须自洽，出点 - 入点 == 时长。 全部用秒，保留两位小数，不写时间码，不写帧号。
  • - 取舍：入点=<理由>；出点=<理由>——理由写画面上发生了什么，不写「节奏需要」。 理由应能对应实际素材与本镜叙事需要。
  • - 声音：<本段声音怎么处理>——记录保留原声或外部处理。此行不驱动内置 render 的混音。
  • - 画面：<接镜校正> 或 - 画面：无——只在这一段与相邻段明显对不上时写， 格式是「亮度 <数>」「饱和 <数>」「色温 <数>」三项的任意组合，用 ； 分隔。 详见 接镜与色彩一致性。
  • - 字幕：<逐字台词原文> 或 - 字幕：无。本段有多句台词时改用编号写法， 每句自带时间：- 字幕 1：0.20-1.50 请进、- 字幕 2：2.30-4.30 门没有锁。 编号从 1 连续，时间相对本 CUT 入点，且不得重叠。

• 素材里没有被采用的镜头，在正文开头写一行 - 未采用镜头：<MOTION-...>（理由：……）， 多项用 ； 连接。理由区分两类：文件缺失（还没生产 / 生产失败）和质量不可用 （生成结果不能用），也可说明叙事取舍。补素材前先判断需要重出还是修订上游。

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

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