short-drama-edit

短剧剪辑与成片

把 剧集/<EP>/制作成果/ 里的逐镜素材装配成一条成片，取舍写进 剧集/<EP>/剪辑单.md。 每段使用二级标题 ## CUT-...，各自绑定一个来源 ID 和一个真实媒体文件：视频段是 MOTION-...， 静态漫剧的关键帧段是 SHOT-... 或 IMG-...。

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

Quick Start

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

入口

进入条件是素材已经存在且可读：剧集/<EP>/制作成果/ 里有本次要用的视频文件； 静态漫剧是已接受的关键帧和配音文件。 先确认本次素材文件可打开，不能仅凭提示词、生产确认或 adapter 成功回执开始剪辑。

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

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

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

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

工作流

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

剪辑单要求

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

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

  • - 来源：<MOTION-...> · <项目相对路径>——MOTION-... 必须是 视频提示词.md 里真实存在 的条目，路径必须是当前可读的文件。静帧段写 - 来源：<SHOT-...> · <图片路径>（分镜.md 的镜头） 或 <IMG-...> · <图片路径>（图片提示词.md 的条目），图片为 png / jpg / jpeg / webp； 入点写 0.00，出点等于时长，至少 0.50 秒。静帧按交付规格的画幅与帧率铺满出画， 有静帧时交付规格必须写 画幅与帧率。
  • - 入点：<秒> / - 出点：<秒> / - 时长：<秒>——三者必须自洽，出点 - 入点 == 时长。 全部用秒，保留两位小数，不写时间码，不写帧号。
  • - 取舍：入点=<理由>；出点=<理由>——说明画面上的具体变化及其叙事作用，不只写「节奏需要」。
  • - 声音：<本段声音怎么处理>——记录保留原声或外部处理。此行不驱动内置 render 的混音。
  • - 画面：<接镜校正>、- 画面：无 或 - 画面：不校——校正是「亮度 <数>」「饱和 <数>」「色温 <数>」 三项的任意组合，用 ； 分隔，写了就替代这一段的自动接镜；无 表示不另写校正；不校 表示连自动接镜 也不做。详见 接镜与色彩一致性。
  • - 字幕：<逐字台词原文> 或 - 字幕：无。本段有多句台词时改用编号写法， 每句自带时间：- 字幕 1：0.20-1.50 请进、- 字幕 2：2.30-4.30 门没有锁。 编号从 1 连续，时间相对本 CUT 入点，且不得重叠；止可以超过本段时长（跨切点见 静帧段）。句末可加 （重点：<词>｜<词>）， 这些词须出现在本句里，烧录时标黄。字色按 剧本.md 里这句的来源决定：对白白色， [VO] 系统： 青色，其他 [VO] 浅青，剪辑单里不另写。
  • - 画面文字 N：<起>-<止> <样式> <项>｜<项>…——视频模型写不对字，系统面板、倒计时、屏幕上的 粉丝数在画面里留白，由 render 叠上去。每一项都要能在 剧本.md 的 [画面文字] 行里找到。 单条可不编号；编号与时间规则同字幕。三种面板共用画面顶部，角标在右上角，同一位置不得重叠。