/short-drama-edit

name: short-drama-edit
description: 将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。
license: MIT

短剧剪辑与成片

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

Quick Start

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

入口与边界

• **前置条件**：`剧集/<EP>/制作成果/` 中存在可读的视频文件（静态漫剧为已接受的关键帧与配音文件），且 `ffmpeg` / `ffprobe` 在 PATH 上（缺失时 `edit_tool.py` 直接报错退出，不近似或伪造通过）。内置渲染直接拼接分段，输入素材的画幅与帧率须一致；不一致时先用外部工具统一并记录裁切或留边。
• **只取舍、不改写**：镜序与镜头职责继承自 `分镜.md` 与 `视频提示词.md`，对白、VO、OS 与 `[画面文字]` 继承自 `剧本.md`。本阶段可删减、缩短或重排片段，但不得改写台词、镜头职责或起终状态，也不自行增补解说。
• **跨阶段路由**：需补拍、重出或换参考图回 `$short-drama-produce`；改提示词回 `$short-drama-video-prompts` 或 `$short-drama-image-prompts`；改台词或叙事回 `$short-drama-write`；成片质量判断交 `$short-drama-review` 或创作者（不把渲染成功或时长匹配写成质量结论）。

工作流

1. **标定可用带**：从头到尾播放每段素材，记录可用时间区间及区间外的缺陷（起势静止、结尾漂移、发白、回弹、重复表演），见 [生成素材的可用带](references/generated-footage.md)。 2. **定位发声与入出点**：有台词的镜头先定位完整字音与停顿；在可用带内按动作、反应或停顿选入点，在信息完成且缺陷出现前选出点，逐段写清理由，见 [入出点与镜序](references/cut-craft.md)。 3. **排镜序与接镜校正**：检查相邻镜头的动作、空间与揭示连贯性；`render` 默认在同场景内自动接镜，需手动覆盖或关闭的段写 `画面`，见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。 4. **处理声音、字幕与叠层**：配置 `音效`、`配音`、`环境声`、`字幕` 与 `画面文字`（见 [声音、字幕与音乐](references/sound-and-subtitles.md) 與 [静帧段](references/still-cuts.md)）。 5. **落盘、渲染与验收**：先写出或更新 `剧集/<EP>/剪辑单.md`（保留未受影响的 `CUT-...` ID），再运行 `check`、`render`、`verify`，按 [交付与验收](references/delivery-verify.md) 抽帧回听后交付。

剪辑单要求

• **开头交付规格**：写明 `成片目标时长`、`画幅与帧率`（含静帧段时必填）、`交付响度`、`字幕`（可选加 `接镜匹配：无`、`颗粒：<0–20|无>`）。未进入成片的镜头写 `- 未采用镜头：<MOTION-...或SHOT-...>（理由：文件缺失｜质量不可用｜叙事取舍——说明）`，多项用 `；` 连接（下落规则见 [静帧段](references/still-cuts.md#每一镜的下落)）。
• **分段条目**：每段一个 `## CUT-<EP>-<序号> · <中文名称>`，同一 `MOTION-...` 拆成多段时源时间区间不得重叠（确需闪回或强调重复时须写明第二次的作用；同一静帧可复用）：
• `- 来源：<MOTION-...> · <项目相对路径>`（对应 `视频提示词.md`），或静帧段 `- 来源：<SHOT-...或IMG-...> · <图片路径>`（png/jpg/jpeg/webp，入点 `0.00`，出点等于时长且 `≥ 0.50` 秒）。
• `- 入点：<秒>` / `- 出点：<秒>` / `- 时长：<秒>`：两位小数秒数（不写时间码或帧号），满足 `出点 - 入点 == 时长`。
• `- 取舍：入点=<理由>；出点=<理由>`：写明入出点处的具体画面变化与叙事作用，不写空泛的「节奏需要」。
• `- 声音：<处理说明>`：记录保留原声或外部混音方案（此行仅作记录，不驱动 `render` 混音）。
• `- 画面：<接镜校正|无|不校>`：`无` 使用默认自动接镜，`不校` 跳过自动接镜，或写手动校正项（参数范围见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)）。
• `- 字幕：<逐字台词原文|无>`：逐字照抄 `剧本.md` 台词与标点（转写仅用于定位时间）。一镜多句时用连续编号并带相对本段入点的时间（不重叠，止可跨切点）：`- 字幕 1：0.20-1.50 请进`。句末可加 `（重点：<词>｜<词>）` 标黄；字色由工具按剧本角色自动区分（对白白、`[VO] 系统：` 青、其余 `[VO]` 浅青）。
• `- 画面文字 N：<起>-<止> <样式> <项>｜<项>…`：每一项须在 `剧本.md` 的 `[画面文字]` 行中有原文（面板自带的 `【系统提示】` `【新任务】` `进度` 不写进剪辑单；单条可不编号；同位置不得重叠）：

| 样式 | 各项结构 | |---|---| | `卡片` | 每项一行：首词名称、末词数值、中间为单位（如 `本月 订单 128｜退货 3`） | | `系统面板` | 首项为打字机状态行，其余为奖励行 | | `任务面板` | 标题、目标（打字机）；`<数> / <数>` 项为进度，其余为奖励标签 | | `角标` | 右上角单行标签（相邻两段写同一角标且首尾相接时不重新入场） |

奖励项末可标 `（传说）` `（史诗）` `（稀有）`（默认稀有，不参与原文核对）。`任务面板` 与 `角标` 末可加 `（倒计时：<秒>）` 或 `（倒计时：接续）`。

• `- 音效 N：<起>-<止> <项目相对路径>（起点：<秒>；增益：<dB>）`：落在本段内，增益 `-40` 到 `+6`，括号项可省。
• `- 运镜：<固定|推近 n%|推近 r%/秒|…>`：仅用于静帧段，方向含推近、拉远、左移、右移、上移、下移（幅度 `n` 为 `1–30`，速度 `r` 为 `0.1–10`），见 [静帧段](references/still-cuts.md#运镜)。
• `- 配音 N：<起> <项目相对路径>（起点：<秒>；增益：<dB>）`：`起` 可为负，声音可跨切点，见 [静帧段](references/still-cuts.md#配音)。
• `- 环境声：[<起>] <项目相对路径>（起点：<秒>；增益：<dB>）` 或 `- 环境声：[<起>] 无`：循环铺底直至下一条 `环境声`，见 [静帧段](references/still-cuts.md#环境声)。

命令

命令由 [edit_tool.py](scripts/edit_tool.py) 提供：

python3 <本技能目录>/scripts/edit_tool.py check <剧集/EP001> --project-root <project>
python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> [--no-subtitles] [--subtitles ffmpeg|remotion] [--remotion-concurrency N]
python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-root <project>

• `check`：核对素材时间戳是否比剪辑单新、区间自洽、来源 ID 与每镜下落、文件存在、区间不越界（需 `ffprobe`）、同源不重叠、字幕与画面文字原文匹配、倒计时接续合法、音效落在本段内、字幕与配音不越过片尾且同轨不重叠（配音需 `ffmpeg`；缺工具时显式报「未测」）。
• `render`：切段、静帧运镜、同场景自动接镜、拼接、混入音效/配音/环境声、烧录字幕与画面文字、统一响度，输出至 `剧集/<EP>/制作成果/成片/` 并保留中间文件。字幕默认走 `ffmpeg`（libass）；`--subtitles remotion` 或含 `画面文字` 时需使用 [Remotion 叠层](assets/remotion/README.md)（默认并发 2）。
• `verify`：测量成片时长、响度、真峰，并列出画面文字/音效/配音成片起止秒、切点亮度变化、切点音量变化与疑似坏帧供抽帧和回听。

按需知识与维护

除上文「工作流」与「剪辑单要求」已链接的专项指南外，可按需读取：[阶段契约](references/stage-contract.md)（阶段边界与 `EDT-*` 规则表）、[剪辑单样例](assets/剪辑单.md)。安装、升级或排障时运行 `python3 {技能目录}/scripts/selftest.py`。