@lemoncat7/dsh-partner 2.4.2 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/selftest.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Offline self-test for multi-episode source intake."""
+
+from __future__ import annotations
+
+import tempfile
+import sys
+from pathlib import Path
+
+from episode_intake import build_index, slice_episode, verify_index, write_index
+
+MINIMUM_PYTHON = (3, 9)
+if sys.version_info < MINIMUM_PYTHON:
+    raise SystemExit("selftest.py requires Python 3.9 or newer")
+
+
+def require(condition: bool, message: str) -> None:
+    if not condition:
+        raise AssertionError(message)
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as directory:
+        root = Path(directory)
+        source = root / "episodes.md"
+        index = root / "index.json"
+        source.write_text("第1集 开端\n行动一。\n第2集 反转\n行动二。\n", encoding="utf-8")
+
+        document = build_index(source, source_ref="输入/episodes.md")
+        require(document["episode_count"] == 2, "episode count")
+        require(document["problems"] == [], "valid episode index")
+        write_index(index, document)
+        require(verify_index(index, source)["verified"] is True, "fresh index")
+        require(
+            slice_episode(index, source, "EP002").startswith("第2集".encode()),
+            "verified episode slice",
+        )
+
+        source.write_text(source.read_text(encoding="utf-8") + "变更。\n", encoding="utf-8")
+        require(verify_index(index, source)["verified"] is False, "source drift")
+
+    print("5 self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/resources/skills/drama-production/upstream/skills/short-drama-edit/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: short-drama-edit
+description: 将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。
+license: MIT
+---
+
+# 短剧剪辑与成片
+
+把 `剧集/<EP>/制作成果/` 里的逐镜素材装配成一条成片，取舍写进 `剧集/<EP>/剪辑单.md`。
+每段使用二级标题 `## CUT-...`，各自绑定一个 `MOTION-...` 和一个真实媒体文件。
+
+根据实际素材选择可用片段，按剧本与分镜核对叙事。素材与意图不一致时，记录取舍和缺口。
+
+## Quick Start
+
+```text
+用 $short-drama-edit 把 EP001 已生产的镜头剪成成片
+```
+
+## 入口
+
+进入条件是**素材已经存在且可读**：`剧集/<EP>/制作成果/` 里有本次要用的视频文件。
+提示词写完、job 确认过、adapter 返回成功，都不等于素材可用；本阶段只认当前能打开的文件字节。
+
+素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。
+在「未采用镜头」说明缺文件、质量不可用或叙事取舍。
+
+`剧集/<EP>/分镜.md` 与 `视频提示词.md` 是镜序和职责的来源。剪辑可以**取舍**它们，不能**改写**
+它们：删一镜、缩一镜、换顺序都属于本阶段；改台词、改镜头职责、改起终状态要回上游发修订请求。
+
+内置渲染直接拼接编码后的分段，输入素材的画幅与帧率须一致。`check` 在可探测媒体时核对；
+不同规格先通过外部工具按交付要求统一，保留构图并记录裁切或留边，再更新剪辑单的路径与时间。
+
+渲染与测量需要 `ffmpeg` / `ffprobe` 在 PATH 上。没有时 `edit_tool.py` 直接失败并说明，
+不用别的手段近似，也不把「没测」写成「通过」。
+
+## 工作流
+
+1. **逐段看完整素材，先标可用带，再谈剪辑。** 每个文件从头到尾看一遍，写下它实际能用的时间
+   区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。
+   这一步的产出是事实，不是决定。做法见 [生成素材的可用带](references/generated-footage.md)。
+2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。内置工具同步切画面与声音；
+   需要在连续对白上换画面时，使用外部剪辑工具分开处理。
+3. **在可用区间内选叙事入出点。** 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷
+   开始之前。逐段写清入点理由和出点理由。做法见 [入出点与镜序](references/cut-craft.md)。
+4. **排镜序并检查相邻关系。** 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
+5. **比较相邻段的画面。** 按同场景、同光态比较可比区域；有可见偏差时在对应段写 `画面`。
+   做法见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
+6. **处理声音接缝与响度。** 拼接后回听；需要混音时通过外部工具执行并记录。
+   做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
+7. **写字幕。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；标点可按字幕惯例调整，
+   字不能改。转写只用来定位时间。
+8. **写出 `剪辑单.md`，再渲染。** 先有文档后有成片：文档是可审查、可修订、可复现的那一份，
+   成片是它的产物。
+9. **按可测项验收成片，再交付。** 见 [交付与验收](references/delivery-verify.md)。
+
+## 剪辑单要求
+
+- 正文开头写交付规格：`成片目标时长`、`画幅与帧率`、`交付响度`、`字幕`。目标时长是意图，
+  实际时长与目标的差写在报告里。用户明确要求固定时长时，应满足要求或报告缺少的素材。
+- 每段一个 `## CUT-<EP>-<序号> · <中文名称>`，块内逐行写：
+
+  - `- 来源：<MOTION-...> · <项目相对路径>`——`MOTION-...` 必须是 `视频提示词.md` 里真实存在
+    的条目，路径必须是当前可读的文件。
+  - `- 入点：<秒>` / `- 出点：<秒>` / `- 时长：<秒>`——三者必须自洽，`出点 - 入点 == 时长`。
+    全部用秒，保留两位小数，不写时间码，不写帧号。
+  - `- 取舍：入点=<理由>；出点=<理由>`——理由写画面上发生了什么，不写「节奏需要」。
+    理由应能对应实际素材与本镜叙事需要。
+  - `- 声音：<本段声音怎么处理>`——记录保留原声或外部处理。此行不驱动内置 render 的混音。
+  - `- 画面：<接镜校正>` 或 `- 画面：无`——只在这一段与相邻段明显对不上时写，
+    格式是「亮度 <数>」「饱和 <数>」「色温 <数>」三项的任意组合，用 `；` 分隔。
+    详见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
+  - `- 字幕：<逐字台词原文>` 或 `- 字幕：无`。本段有多句台词时改用编号写法，
+    每句自带时间：`- 字幕 1：0.20-1.50 请进`、`- 字幕 2：2.30-4.30 门没有锁`。
+    编号从 1 连续，时间相对本 CUT 入点，且不得重叠。
+- 素材里没有被采用的镜头，在正文开头写一行 `- 未采用镜头：<MOTION-...>（理由：……）`，
+  多项用 `；` 连接。理由区分两类：**文件缺失**（还没生产 / 生产失败）和**质量不可用**
+  （生成结果不能用），也可说明叙事取舍。补素材前先判断需要重出还是修订上游。
+- 同一个 `MOTION-...` 可以拆成多个 `CUT-...`（同一段素材的两处分别使用），也可以整段不用。
+  不能凭空出现没有素材来源的 `CUT-...`。
+- 一段素材被用两次时，两个 `CUT-...` 的区间不得重叠：同一批帧在成片里出现两次是重复镜头，
+  不是复用。确需重复出现（闪回、强调）时写明它是有意重复，并说明第二次为什么仍然成立。
+
+## 边界
+
+- **不生成新素材。** 需要补拍、重出、换参考图，回 `$short-drama-produce`；需要改提示词，
+  回 `$short-drama-video-prompts` 或 `$short-drama-image-prompts`。
+- **不改上游语义。** 剪辑单可以让某句台词不出现在成片里（整镜未采用），不能改这句台词是什么。
+  发现剧本层面的问题就点名报告，交回 `$short-drama-write`。
+- **沿用剧本的声音设计。** 保留已有对白、VO 和 OS，不自行增加解说；需要新增叙述时回写作阶段。
+- **不把技术成功写成质量结论。** 渲染完成、时长对上、文件存在，都不是「这条片子能看」。
+  成片质量的判断交给 `$short-drama-review`，或交给创作者本人。
+- **按已授权目标完成。** 继续修复影响交付的问题；新增创作方向或补素材需求交给创作者决定。
+
+## 命令
+
+命令由 [edit_tool.py](scripts/edit_tool.py) 提供：
+
+```text
+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` 只核对不渲染：素材是否比剪辑单新（重出之后字幕时间必须重测）、区间自洽、`MOTION-...` 解析、文件存在、区间不越过素材时长、
+同源区间不重叠、字幕文字能在 `剧本.md` 里找到。其中「区间不越过素材时长」需要 `ffprobe`，
+没有时这一项报「未测」并说明原因，不静默跳过。`render` 按剪辑单切段、拼接、烧字幕、统一响度，
+输出 `剧集/<EP>/制作成果/成片/`。`verify` 只测量已经渲染出来的成片并回报数字，不改文件、
+不给质量结论。
+
+字幕默认由带 libass 的 ffmpeg 烧录。`--subtitles remotion` 换成一条排版可调的
+路线，代价是装一次 Node 依赖，而且叠层要**逐帧过无头浏览器**渲整部成片——慢且吃内存，
+并发默认压在 2（`--remotion-concurrency` 可调，调高前先量本机）。取舍见
+[声音、字幕与音乐](references/sound-and-subtitles.md)，装法见
+[Remotion 字幕叠层](assets/remotion/README.md)。
+
+`render` 保留切好的中间文件。它只切段、硬拼接、统一字幕样式、接镜校正和整片响度，
+不执行 `声音` 行中的混音方案，也不按交付规格自动缩放或改帧率。需要混音、逐镜字幕避让、
+转场或画幅转换时用外部工具完成并记录，验收实际交付文件。
+
+## 按需知识
+
+先读本 SKILL、当前分镜、视频提示词和素材；有字幕时读取剧本原文。按需要打开参考资料：
+
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 可用带、生成缺陷与逐镜取舍：[生成素材的可用带](references/generated-footage.md)
+- 入出点、镜序与节奏：[入出点与镜序](references/cut-craft.md)
+- 声音接缝、字幕与音乐落点：[声音、字幕与音乐](references/sound-and-subtitles.md)
+- 成片可测项与验收：[交付与验收](references/delivery-verify.md)
+- 剪辑单成稿样例：[剪辑单样例](assets/剪辑单.md)
+- 可选的 Remotion 字幕排版：[Remotion 字幕叠层](assets/remotion/README.md)
+
+## 修订
+
+保留未受影响的 `CUT-...` ID。改一段的入出点不触碰其它段；删一段时说明它承担的信息由哪一段
+接住，或明确说明这条信息在成片里不再出现。重新渲染前先更新剪辑单，不要让成片领先于文档。
+
+## 完成
+
+每个 `CUT-...` 都绑定真实素材与自洽区间，台词在成片里完整可听，字幕逐字等于剧本原文，
+剪辑点没有可听的音床硬切，成片响度落在交付目标上，未采用镜头都写明理由并区分了缺文件与缺质量，
+即完成。目标时长与实际时长的差、以及仍然值得再剪一版的地方，写在末尾报告里交给创作者判断。
+
+## 安装维护
+
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/resources/skills/drama-production/upstream/skills/short-drama-edit/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧剪辑"
+  short_description: "把逐镜生成的素材按分镜装配成有节奏、台词完整、可交付的短剧成片"
+  default_prompt: "使用 $short-drama-edit 把 EP001 已生产的镜头素材剪成成片。"

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/README.md

@@ -0,0 +1,60 @@
+# Remotion 字幕叠层
+
+`$short-drama-edit` 的**可选**字幕渲染路线。默认路线是 ffmpeg + libass，零依赖；这一条排版
+更好，但要装 Node 依赖，而且慢得多、吃内存——先看下面的「代价」。
+
+## 为什么会有第二条路
+
+ASS 的字号是相对 `PlayRes` 的单位，渲染时再缩放一次，这层间接每次都要重推一遍，推错了
+在数字上看不出来（见[声音、字幕与音乐](../../references/sound-and-subtitles.md)）。这里字号、
+描边、行距、安全区、折行都是 CSS，写的是画面像素，改完在 `npx remotion studio` 当场能看。
+
+## 装一次
+
+工作区在**项目之外**（默认 `~/.cache/short-drama-edit/remotion`）。`edit_tool.py` 每次运行都会
+把本目录的源码同步过去，所以要改排版就改这里的 `src/`，不要改工作区里的副本——它会被覆盖。
+
+```bash
+cd ~/.cache/short-drama-edit/remotion && npm install
+```
+
+`node_modules` 不进项目也不进本仓库。
+
+## 用
+
+```bash
+python3 <本技能目录>/scripts/edit_tool.py render <剧集/EP001> --project-root <project> --subtitles remotion
+```
+
+它渲染出一段**透明**的字幕层（VP8 + alpha），再由 ffmpeg 叠到未经改动的画面上。画面本身
+不经过浏览器重绘，所以不多一次画质损失。
+
+## 代价
+
+叠层**逐帧**渲，长度等于整部成片：一分钟竖屏片一千多帧 1080×1920，每帧一次无头浏览器
+截图，没字幕的帧照渲。透明还要求 PNG 抓帧加 VP8 编码，Remotion 的性能文档把这两样都列为
+慢环节。默认路线是一次滤镜的事，这条是分钟级。
+
+内存才是会出事的地方。Remotion 默认按 CPU 核数开浏览器实例，每个各持一整帧——10 核 8 GB
+的机器上内存打满，整机停止响应，本套件就这么卡死过一次。所以 `edit_tool.py` 固定传
+`--concurrency`，默认 2。要提高先量本机，别凭核数拍：
+
+```bash
+cd ~/.cache/short-drama-edit/remotion && npx remotion benchmark
+```
+
+## 许可证
+
+Remotion 个人与小团队免费，超出规模需商业授权，条款以 [remotion.dev](https://www.remotion.dev/)
+为准。本套件是 MIT，不包含也不代理这项授权，也不会替你安装它——缺依赖时只报错并给出命令。
+默认路线不涉及这件事。
+
+## 文件
+
+| 文件 | 作用 |
+|---|---|
+| `src/schema.ts` | 叠层的输入形状：cues、画幅、fps、字号与安全区比例 |
+| `src/Subtitles.tsx` | 排版本身。所有尺寸都是画面高度的比例，同一组数值对 768×1344 和 1080×1920 都成立 |
+| `src/Root.tsx` | 合成注册；画幅、帧率、时长由调用方通过 `--props` 传入 |
+| `src/font.ts` | 渲染前等字体就绪，并验证字体族真的存在——装不上时报错，而不是悄悄换一款字体出片 |
+| `remotion.config.ts` | 固定成带 alpha 的输出，叠层必须透明 |

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "short-drama-subtitles",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Remotion subtitle layer for short-drama-edit. Renders a transparent overlay from cues.json.",
+  "scripts": {
+    "render": "remotion render Subtitles"
+  },
+  "dependencies": {
+    "@remotion/cli": "4.0.418",
+    "react": "19.0.0",
+    "react-dom": "19.0.0",
+    "remotion": "4.0.418"
+  }
+}

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/remotion.config.ts

@@ -0,0 +1,6 @@
+import { Config } from "@remotion/cli/config";
+
+// The overlay is composited onto untouched picture, so it must carry alpha.
+Config.setVideoImageFormat("png");
+Config.setPixelFormat("yuva420p");
+Config.setCodec("vp8");

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Root.tsx

@@ -0,0 +1,26 @@
+import React from "react";
+import { Composition } from "remotion";
+import { Subtitles } from "./Subtitles";
+import { defaultProps, SubtitleProps } from "./schema";
+
+export const RemotionRoot: React.FC = () => {
+  return (
+    <Composition
+      id="Subtitles"
+      component={Subtitles}
+      defaultProps={defaultProps}
+      // The caller passes the real frame, fps and length through --props; these
+      // stand in only when the composition is opened in the studio by hand.
+      durationInFrames={Math.max(1, Math.round(defaultProps.durationInSeconds * defaultProps.fps))}
+      fps={defaultProps.fps}
+      width={defaultProps.width}
+      height={defaultProps.height}
+      calculateMetadata={({ props }: { props: SubtitleProps }) => ({
+        durationInFrames: Math.max(1, Math.round(props.durationInSeconds * props.fps)),
+        fps: props.fps,
+        width: props.width,
+        height: props.height,
+      })}
+    />
+  );
+};

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Subtitles.tsx

@@ -0,0 +1,88 @@
+import React, { useMemo } from "react";
+import { AbsoluteFill, useCurrentFrame, useVideoConfig } from "remotion";
+import { Cue, SubtitleProps } from "./schema";
+import { assertFamilyResolves, waitForFonts } from "./font";
+
+waitForFonts();
+
+/**
+ * A transparent subtitle layer, composited onto untouched picture.
+ *
+ * Everything here is expressed as a fraction of frame height, so the same
+ * numbers hold for 768×1344 and 1080×1920. That is the whole reason this file
+ * exists in pixels rather than in an ASS style: the subtitle renderer's own
+ * `PlayRes` scaling was applied twice once already, and type three times too
+ * large shipped in a sample film.
+ */
+export const Subtitles: React.FC<SubtitleProps> = ({
+  cues,
+  fontScale,
+  bottomScale,
+  fontFamily,
+}) => {
+  const frame = useCurrentFrame();
+  const { fps, height, width } = useVideoConfig();
+  const now = frame / fps;
+  const active = cues.find((cue: Cue) => now >= cue.start && now < cue.end);
+
+  const fontSize = height * fontScale;
+  // A dark rim on every side keeps white type legible over a bright frame
+  // without a caption box, which is what vertical drama expects. It depends
+  // only on the frame size, so it is built once — and it stays above the early
+  // return, because a hook may not be skipped on the frames with no line.
+  const shadow = useMemo(() => {
+    const rim = Math.max(2, height * 0.0024);
+    return [
+      `0 0 ${rim * 3}px rgba(0,0,0,0.85)`,
+      `${rim}px ${rim}px 0 rgba(0,0,0,0.92)`,
+      `-${rim}px ${rim}px 0 rgba(0,0,0,0.92)`,
+      `${rim}px -${rim}px 0 rgba(0,0,0,0.92)`,
+      `-${rim}px -${rim}px 0 rgba(0,0,0,0.92)`,
+    ].join(", ");
+  }, [height]);
+
+  // Checked against a line about to be filmed, so a missing font stops the
+  // render on the first subtitle frame rather than after the whole pass.
+  assertFamilyResolves(fontFamily, active?.text ?? "");
+  if (!active) return null;
+
+  // A short lift on entry reads as the line arriving with the delivery. It is
+  // over well before the first syllable ends, so it never delays reading.
+  const age = now - active.start;
+  const lift = Math.min(1, age / 0.12);
+  const eased = 1 - Math.pow(1 - lift, 3);
+
+  return (
+    <AbsoluteFill
+      style={{
+        justifyContent: "flex-end",
+        alignItems: "center",
+        paddingBottom: height * bottomScale,
+        paddingLeft: width * 0.06,
+        paddingRight: width * 0.06,
+      }}
+    >
+      <div
+        style={{
+          fontFamily,
+          fontSize,
+          fontWeight: 700,
+          color: "#ffffff",
+          textAlign: "center",
+          lineHeight: 1.28,
+          letterSpacing: fontSize * 0.02,
+          textShadow: shadow,
+          opacity: eased,
+          transform: `translateY(${(1 - eased) * fontSize * 0.25}px)`,
+          // A long line wraps rather than running off the frame — the failure
+          // that made the first shipped version unreadable.
+          maxWidth: "100%",
+          wordBreak: "break-word",
+          whiteSpace: "pre-wrap",
+        }}
+      >
+        {active.text}
+      </div>
+    </AbsoluteFill>
+  );
+};

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/font.ts

@@ -0,0 +1,46 @@
+import { continueRender, delayRender } from "remotion";
+
+/**
+ * Remotion captures a frame as soon as React has painted, so a font still being
+ * fetched is simply absent from it. Nothing downstream reports that: the film
+ * measures correct and reads wrong.
+ */
+export const waitForFonts = (): void => {
+  const handle = delayRender("等待字体就绪");
+  document.fonts.ready.then(
+    () => continueRender(handle),
+    () => continueRender(handle),
+  );
+};
+
+/**
+ * `document.fonts.ready` promises that loading finished, not that the requested
+ * family exists — a missing face raises nothing, the browser substitutes, and
+ * the film ships in the wrong typeface. Measuring is the only reliable test:
+ * identical widths against a family that cannot exist mean nothing resolved.
+ */
+let familyChecked = "";
+
+export const assertFamilyResolves = (fontFamily: string, sample: string): void => {
+  // Runs on every frame, so measure once per family.
+  if (!sample || familyChecked === fontFamily) return;
+  const canvas = document.createElement("canvas");
+  const context = canvas.getContext("2d");
+  if (!context) return;
+
+  const measure = (family: string): number => {
+    context.font = `700 64px ${family}`;
+    return context.measureText(sample).width;
+  };
+  // A name no font can carry, so it always lands on the browser's last resort.
+  const fallbackOnly = measure('"__no_such_family__"');
+  const requested = measure(`${fontFamily}, "__no_such_family__"`);
+  if (requested === fallbackOnly) {
+    throw new Error(
+      `字幕字体 ${fontFamily} 在渲染环境里一个都没装上，` +
+        "画面会落到浏览器的兜底字体。装一款其中的字体，" +
+        "或给 render 传一个本机确实有的字体族。",
+    );
+  }
+  familyChecked = fontFamily;
+};

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/index.ts

@@ -0,0 +1,4 @@
+import { registerRoot } from "remotion";
+import { RemotionRoot } from "./Root";
+
+registerRoot(RemotionRoot);

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/schema.ts

@@ -0,0 +1,32 @@
+export type Cue = {
+  /** Output-time seconds, measured from the rendered segments. */
+  start: number;
+  end: number;
+  /** The line as written in 剧本.md. Never a transcription. */
+  text: string;
+};
+
+export type SubtitleProps = {
+  cues: Cue[];
+  width: number;
+  height: number;
+  fps: number;
+  durationInSeconds: number;
+  /** Type size as a fraction of frame height, so one number survives any delivery. */
+  fontScale: number;
+  /** Distance from the bottom edge, also a fraction of frame height. */
+  bottomScale: number;
+  fontFamily: string;
+};
+
+export const defaultProps: SubtitleProps = {
+  cues: [],
+  width: 1080,
+  height: 1920,
+  fps: 24,
+  durationInSeconds: 1,
+  fontScale: 0.034,
+  bottomScale: 0.055,
+  fontFamily:
+    '"PingFang SC", "Noto Sans CJK SC", "Source Han Sans SC", "Microsoft YaHei", sans-serif',
+};

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}

package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets//345/211/252/350/276/221/345/215/225.md

@@ -0,0 +1,43 @@
+# EP001 剪辑单
+
+- 成片目标时长：25.00 秒
+- 画幅与帧率：9:16 · 1080×1920 · 24fps
+- 交付响度：-16 LUFS
+- 字幕：硬字幕，台词逐字取自《剧本.md》，底部安全区内，避开画内屏幕文字
+- 未采用镜头：MOTION-EP001-009（理由：质量不可用——全段人物身份漂移，可用带不足 0.5 秒）；MOTION-EP001-018（理由：文件缺失——尚未生产）
+
+## CUT-EP001-001 · 手指停在按钮上
+
+- 来源：MOTION-EP001-010 · 制作成果/videos/SHOT-EP001-010.mp4
+- 入点：0.60
+- 出点：3.60
+- 时长：3.00
+- 取舍：入点=手指已经悬在按钮上方、开始下压；出点=按钮按下、界面开始响应，再往后 0.4 秒手指位置回弹
+- 声音：保留原声（室内底噪与一次点击声）
+- 字幕：无
+
+## CUT-EP001-002 · 弹窗展开
+
+- 来源：MOTION-EP001-011 · 制作成果/videos/SHOT-EP001-011.mp4
+- 入点：0.90
+- 出点：3.40
+- 时长：2.50
+- 取舍：入点=弹窗动画已经展开过半，起势的静止两帧删掉；出点=弹窗完全展开且文字可读的最后一帧，之后画面开始整体提亮
+- 声音：保留原声；回听确认与上一段衔接
+- 字幕：无
+
+## CUT-EP001-003 · 他念出那句话
+
+- 来源：MOTION-EP001-017 · 制作成果/videos/SHOT-EP001-017.mp4
+- 入点：2.00
+- 出点：7.00
+- 时长：5.00
+- 取舍：入点=按发声区间前推 0.3 秒余量，开头 1.5 秒的凝视与上一段蓄势重复，整段去掉；出点=句尾收音之后 0.4 秒，人物姿态尚未回弹
+- 声音：保留原声
+- 字幕：这条路我自己走
+
+---
+
+说明：本文件是格式样例，`制作成果/videos/...` 是示意路径。真实项目里每个「来源」的路径都必须
+指向当前可读的文件，`check` 会逐条核对。「未采用镜头」的两条理由分别示范了必须区分的两类——
+文件缺失回生产，质量不可用回上游改提示词。

package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/cut-craft.md

@@ -0,0 +1,38 @@
+# 入出点与镜序
+
+## 入出点
+
+在素材可用区间内，按信息、表演与节奏选入出点。
+动作镜可以从动作已经开始的位置进入；反应、等待、揭示前停顿可以保留静止。
+出点要让观众读到本镜的结果，并避开后续漂移或无意重复。
+
+对白先确定实际发声区间，保留完整的字音与需要的停顿。
+画面切换可以发生在一句台词中间，前提是音轨连续、说话人和叙事关系清楚。
+不要为了换画面把原台词改成两句。内置 render 只做同步切段；分离画面和声音的剪法
+需要先用外部剪辑工具完成，记录所用素材、声音区间和处理方式。
+
+## 镜序与相邻关系
+
+默认沿用分镜镜序。调整时检查动作因果、视线、空间关系、信息揭示和声音衔接。
+相近景别与机位之间的切换容易暴露跳动，可比较改变角度、插入反应或有意跳切的效果。
+是否保留由观众需要看到的信息决定，不把景别、机位和运动方向的组合设为禁令。
+
+重复信息没有新增作用时可删；如果第二次增加反应、对照或重新解释，可以保留。
+拆取两段素材也可以，但要确认动作、台词和情绪仍连贯。
+
+## 切点与转场
+
+动接动、声音桥和切到不同主体都可帮助衔接，按本场叙事选择。
+若相邻镜头有生成漂移，先判断能否通过取舍或接镜校正解决；叠化等转场不能替代缺失的内容。
+
+剧本的 `[转场]` 可能交代时空变化，也可能明确指定声音或画面效果，先读具体要求。
+可通过新镜头中的环境信息、声音桥、黑场或其他已接受效果实现。
+内置 render 只做硬切；需要声音桥或画面转场时使用外部工具，并记录处理参数。
+
+## 时长与完成
+
+删短某段后，只有其他段落确实需要更多表演或阅读时间才延长，不机械补齐总秒数。
+目标时长若是创作参考，报告实际时长与差异；若是用户明确的交付限制，则继续调整或指出
+缺少哪些素材才能满足，不能把它自行降为参考值。
+
+下一轮修改应针对成片里可见或可听的问题，优先修复影响理解、连续性和交付要求的部分。

package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/delivery-verify.md

@@ -0,0 +1,29 @@
+# 交付与验收
+
+检查实际交付文件，并区分实测结果、人工判断和未测项。
+
+| 项 | 怎么核对 |
+|---|---|
+| 时长与切点 | 对照实际渲染区间、帧边界和用户时长要求 |
+| 内容覆盖 | 对照分镜和视频提示词，必要内容有承载，未采用镜头有原因 |
+| 台词 | 在成片上回听，必要时转写辅助，逐句对照剧本 |
+| 边界帧 | 查看剪辑点前后，检查意外黑白帧、画面断裂和漂移 |
+| 声音 | 回听接缝、对白清晰度与已声明静默；测量整片响度 |
+| 字幕 | 检查逐字内容、发声时间、字号、折行和画内文字避让 |
+| 画内文字 | 按剧本与视觉设定的文字政策检查载体、可读性和指定文字 |
+| 画幅与帧率 | 探测输出文件，对照交付规格 |
+| 接镜色彩 | 在同场景、同光态下比较可比区域，确认校正没有过冲 |
+
+`verify` 只提供部分技术测量，不能替代回听与画面检查。
+分段色彩观测按当前剪辑单读取中间分段，报告平均亮度和蓝减红像素值；它不代表成片局部区域的
+接镜残差，也不要求各场景接近同一均值。改动剪辑单后先重新渲染，再测量并查看实际切点。
+发现有意黑场、静默或光态变化时按创作意图判断，不因数值异常直接判错。
+
+## 交付
+
+给出成片、剪辑单、可继续编辑的中间文件，以及外部混音或字幕工程（如使用）。
+说明是否满足用户要求、仍有哪些内容缺口和取舍；测不了的必要项目写明原因。
+
+需要补素材、改台词或改分镜时，指出对应镜头与发生时间并交给负责阶段。
+渲染成功只证明工具完成执行，成片的内容判断需要观看和回听；正式审查由
+`$short-drama-review` 或创作者进行。