@oh-story/dsh 0.1.9 → 0.1.11

package/lib/drama/skills/short-drama-edit/assets/remotion/src/screen/SystemPanel.tsx

@@ -0,0 +1,44 @@
+import React from "react";
+import { AbsoluteFill, useCurrentFrame, useVideoConfig } from "remotion";
+import { Frame, Header, Reward, Typed } from "./chrome";
+import { COLOURS, StyleProps, TOP_U, entrance, exit, glitch, unit } from "./tokens";
+
+const TYPE_DELAY = 0.15;
+
+/**
+ * 【系统提示】: the first item types out as the status line, the rest arrive as
+ * rarity-coloured reward rows once it has finished.
+ */
+export const SystemPanel: React.FC<StyleProps> = ({ text }) => {
+  const frame = useCurrentFrame();
+  const { fps, height, width } = useVideoConfig();
+  const u = unit(height);
+  const shown = entrance(frame, fps, 0, 13);
+  const jitter = glitch(frame);
+  const leaving = exit(frame, fps, text);
+  const [status, ...rewards] = text.items;
+  const rewardsFrom = TYPE_DELAY + Array.from(status.text).length * 0.035 + 0.15;
+  return (
+    <AbsoluteFill style={{ alignItems: "center", paddingTop: u * TOP_U.system, opacity: leaving * jitter.opacity }}>
+      <div style={{ transform: `translate(${jitter.dx}px, ${(1 - leaving) * -u * 2}px) scale(${0.9 + 0.1 * shown})` }}>
+        <Frame colour={COLOURS.system} width={width * 0.82}>
+          <Header text="【系统提示】" colour={COLOURS.system} />
+          <Typed
+            text={status.text}
+            delay={TYPE_DELAY}
+            style={{
+              fontSize: u * 4.4,
+              fontWeight: 900,
+              letterSpacing: u * 0.3,
+              textShadow: `0 0 ${u * 1.4}px ${COLOURS.system}`,
+              margin: `${u * 0.4}px 0 ${rewards.length ? u * 1.2 : 0}px`,
+            }}
+          />
+          {rewards.map((item, index) => (
+            <Reward key={index} name={item.text} rarity={item.rarity} delay={rewardsFrom + index * 0.28} />
+          ))}
+        </Frame>
+      </div>
+    </AbsoluteFill>
+  );
+};

package/lib/drama/skills/short-drama-edit/assets/remotion/src/screen/TaskPanel.tsx

@@ -0,0 +1,100 @@
+import React from "react";
+import { AbsoluteFill, useCurrentFrame, useVideoConfig } from "remotion";
+import { formatCountdown, parseProgress, secondsLeft, sinceTick } from "../rules.mjs";
+import { Frame, Header, RewardTag, Typed } from "./chrome";
+import { COLOURS, MONO, StyleProps, TOP_U, entrance, exit, glitch, unit } from "./tokens";
+
+/**
+ * 【新任务】: title, the goal typed out, reward tags, an `N / M` item as the
+ * 进度 line with its bar, and the countdown pulsing on each second.
+ */
+export const TaskPanel: React.FC<StyleProps> = ({ text }) => {
+  const frame = useCurrentFrame();
+  const { fps, height, width } = useVideoConfig();
+  const u = unit(height);
+  const shown = entrance(frame, fps, 0, 13);
+  const jitter = glitch(frame);
+  const leaving = exit(frame, fps, text);
+  const [title, goal, ...rest] = text.items;
+  const progressItem = rest.find((item) => parseProgress(item.text));
+  const progress = progressItem ? parseProgress(progressItem.text) : null;
+  const rewards = rest.filter((item) => item !== progressItem);
+  const elapsed = frame / fps;
+  const beat =
+    text.countdown === null ? 1 : 1 + 0.05 * Math.max(0, 1 - sinceTick(text.countdown, elapsed) / 0.15);
+  return (
+    <AbsoluteFill style={{ alignItems: "center", paddingTop: u * TOP_U.task, opacity: leaving * jitter.opacity }}>
+      <div style={{ transform: `translate(${jitter.dx}px, ${(1 - leaving) * -u * 2}px) scale(${0.9 + 0.1 * shown})` }}>
+        <Frame colour={COLOURS.task} width={width * 0.86}>
+          <Header text="【新任务】" colour={COLOURS.task} />
+          <div
+            style={{
+              fontSize: u * 4.2,
+              fontWeight: 900,
+              letterSpacing: u * 0.3,
+              color: COLOURS.taskTitle,
+              textShadow: `0 0 ${u * 1.2}px ${COLOURS.task}`,
+              margin: `${u * 0.2}px 0 ${u * 0.8}px`,
+            }}
+          >
+            {title.text}
+          </div>
+          {goal ? (
+            <Typed text={goal.text} delay={0.25} style={{ fontSize: u * 2.35, fontWeight: 700, lineHeight: 1.45 }} />
+          ) : null}
+          {rewards.length ? (
+            <div style={{ marginTop: u * 1.2, display: "flex", flexWrap: "wrap", gap: `${u * 0.6}px ${u}px` }}>
+              {rewards.map((item, index) => (
+                <RewardTag key={index} name={item.text} rarity={item.rarity} delay={0.5 + index * 0.12} />
+              ))}
+            </div>
+          ) : null}
+          {progress && progressItem ? (
+            <>
+              <div
+                style={{
+                  marginTop: u * 1.4,
+                  fontSize: u * 1.7,
+                  fontWeight: 700,
+                  color: COLOURS.muted,
+                  display: "flex",
+                  justifyContent: "space-between",
+                }}
+              >
+                <span>进度</span>
+                <span style={{ fontFamily: MONO, fontWeight: 800 }}>{progressItem.text}</span>
+              </div>
+              <div style={{ height: u * 0.6, background: "#ffffff1c", marginTop: u * 0.4 }}>
+                <div
+                  style={{
+                    // A sliver stays visible at zero, so the bar reads as a bar.
+                    width: `${Math.max(1.2, progress.ratio * 100)}%`,
+                    height: "100%",
+                    background: COLOURS.alarm,
+                    boxShadow: `0 0 ${u * 0.6}px ${COLOURS.alarm}`,
+                  }}
+                />
+              </div>
+            </>
+          ) : null}
+          {text.countdown === null ? null : (
+            <div
+              style={{
+                marginTop: u * 1.3,
+                fontFamily: MONO,
+                fontWeight: 800,
+                fontSize: u * 4.2,
+                color: COLOURS.alarm,
+                textShadow: `0 0 ${u}px ${COLOURS.alarm}`,
+                transform: `scale(${beat})`,
+                transformOrigin: "left center",
+              }}
+            >
+              {formatCountdown(secondsLeft(text.countdown, elapsed))}
+            </div>
+          )}
+        </Frame>
+      </div>
+    </AbsoluteFill>
+  );
+};

package/lib/drama/skills/short-drama-edit/assets/remotion/src/screen/chrome.tsx

@@ -0,0 +1,197 @@
+import React from "react";
+import { interpolate, useCurrentFrame, useVideoConfig } from "remotion";
+import { typedLength } from "../rules.mjs";
+import { COLOURS, RARITY, SANS, entrance, rarityOf, unit } from "./tokens";
+import { Rarity } from "../schema";
+
+/** Pieces the system-style panels share: frame, header, typewriter, reward rows. */
+
+const useU = (): number => unit(useVideoConfig().height);
+
+const Corners: React.FC<{ colour: string }> = ({ colour }) => {
+  const u = useU();
+  const length = u * 2.2;
+  const weight = Math.max(3, u * 0.28);
+  const edge = `${weight}px solid ${colour}`;
+  const corner = (style: React.CSSProperties) => (
+    <div style={{ position: "absolute", width: length, height: length, ...style }} />
+  );
+  return (
+    <>
+      {corner({ top: -weight, left: -weight, borderTop: edge, borderLeft: edge })}
+      {corner({ top: -weight, right: -weight, borderTop: edge, borderRight: edge })}
+      {corner({ bottom: -weight, left: -weight, borderBottom: edge, borderLeft: edge })}
+      {corner({ bottom: -weight, right: -weight, borderBottom: edge, borderRight: edge })}
+    </>
+  );
+};
+
+/** Dark-navy glass with a glowing border, L-shaped corner brackets and moving scanlines. */
+export const Frame: React.FC<{
+  colour: string;
+  width: number;
+  children: React.ReactNode;
+  style?: React.CSSProperties;
+}> = ({ colour, width, children, style }) => {
+  const u = useU();
+  const frame = useCurrentFrame();
+  return (
+    <div
+      style={{
+        position: "relative",
+        width,
+        padding: `${u * 2.2}px ${u * 2.6}px`,
+        background: "linear-gradient(170deg, rgba(10,30,60,0.80), rgba(6,16,36,0.86))",
+        border: `${Math.max(2, u * 0.12)}px solid ${colour}aa`,
+        boxShadow: `0 0 ${u * 1.6}px ${colour}88, inset 0 0 ${u * 3}px ${colour}22`,
+        fontFamily: SANS,
+        color: COLOURS.panelInk,
+        ...style,
+      }}
+    >
+      <Corners colour={colour} />
+      <div
+        style={{
+          position: "absolute",
+          inset: 0,
+          pointerEvents: "none",
+          backgroundImage: `repeating-linear-gradient(0deg, ${colour}14 0px, ${colour}14 2px, transparent 2px, transparent 5px)`,
+          backgroundPositionY: `${frame * 1.5}px`,
+        }}
+      />
+      {children}
+    </div>
+  );
+};
+
+/** 【系统提示】-style header: a diamond, the label, and a rule fading out to the right. */
+export const Header: React.FC<{ text: string; colour: string }> = ({ text, colour }) => {
+  const u = useU();
+  return (
+    <div
+      style={{
+        display: "flex",
+        alignItems: "center",
+        gap: u * 0.8,
+        fontSize: u * 1.9,
+        fontWeight: 700,
+        color: colour,
+        letterSpacing: u * 0.35,
+        marginBottom: u * 0.8,
+      }}
+    >
+      <span
+        style={{
+          width: u * 0.9,
+          height: u * 0.9,
+          background: colour,
+          transform: "rotate(45deg)",
+          boxShadow: `0 0 ${u}px ${colour}`,
+        }}
+      />
+      {text}
+      <span style={{ flex: 1, height: 1, background: `linear-gradient(90deg, ${colour}aa, transparent)` }} />
+    </div>
+  );
+};
+
+/** Typewriter at 35 ms a character from `delay`, with a blinking bar while it types. */
+export const Typed: React.FC<{ text: string; delay?: number; style?: React.CSSProperties }> = ({
+  text,
+  delay = 0,
+  style,
+}) => {
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const chars = Array.from(text);
+  const shown = typedLength(frame / fps, delay);
+  const typing = shown < chars.length;
+  return (
+    <div style={style}>
+      {chars.slice(0, shown).join("")}
+      <span
+        style={{
+          display: "inline-block",
+          width: "0.12em",
+          height: "0.9em",
+          marginLeft: "0.08em",
+          background: "currentColor",
+          opacity: typing && Math.floor(frame / 6) % 2 === 0 ? 1 : 0,
+        }}
+      />
+    </div>
+  );
+};
+
+/** A reward row: rarity chip and name in the rarity's colour, flashing as it arrives. */
+export const Reward: React.FC<{ name: string; rarity: Rarity | null; delay: number }> = ({
+  name,
+  rarity,
+  delay,
+}) => {
+  const u = useU();
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const arrived = entrance(frame, fps, delay, 12);
+  const label = rarityOf(rarity);
+  const colour = RARITY[label];
+  const flash = interpolate(frame / fps - delay, [0, 0.12, 0.4], [0, 1, 0], {
+    extrapolateLeft: "clamp",
+    extrapolateRight: "clamp",
+  });
+  return (
+    <div
+      style={{
+        display: "flex",
+        alignItems: "center",
+        gap: u * 1.2,
+        margin: `${u * 0.7}px 0`,
+        opacity: arrived,
+        transform: `translateX(${(1 - arrived) * u * 5}px)`,
+      }}
+    >
+      <span
+        style={{
+          fontSize: u * 1.5,
+          fontWeight: 700,
+          color: COLOURS.ink,
+          background: colour,
+          padding: `${u * 0.15}px ${u * 0.7}px`,
+          boxShadow: `0 0 ${u * (0.6 + flash)}px ${colour}`,
+        }}
+      >
+        {label}
+      </span>
+      <span style={{ fontSize: u * 2.7, fontWeight: 900, color: colour, textShadow: `0 0 ${u * (0.5 + 1.5 * flash)}px ${colour}` }}>
+        {name}
+      </span>
+    </div>
+  );
+};
+
+/** A compact reward tag for the task panel. */
+export const RewardTag: React.FC<{ name: string; rarity: Rarity | null; delay: number }> = ({
+  name,
+  rarity,
+  delay,
+}) => {
+  const u = useU();
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const colour = RARITY[rarityOf(rarity)];
+  return (
+    <span
+      style={{
+        fontSize: u * 1.9,
+        fontWeight: 700,
+        color: colour,
+        opacity: entrance(frame, fps, delay),
+        border: `1px solid ${colour}88`,
+        padding: `${u * 0.2}px ${u * 0.7}px`,
+        background: `${colour}14`,
+      }}
+    >
+      {name}
+    </span>
+  );
+};

package/lib/drama/skills/short-drama-edit/assets/remotion/src/screen/tokens.ts

@@ -0,0 +1,62 @@
+import { interpolate, spring } from "remotion";
+import { CueKind, Rarity, ScreenText } from "../schema";
+
+/**
+ * Shared look for subtitles and every screen-text style. Sizes are in `u`, one
+ * hundredth of frame height, so the same numbers hold for 720×1280 and 1080×1920.
+ */
+export const unit = (height: number): number => height / 100;
+
+/** Every style component takes exactly this, so one can replace another. */
+export type StyleProps = { text: ScreenText };
+
+export const SANS = '"Noto Sans SC", sans-serif';
+export const MONO = '"JetBrains Mono", "Noto Sans SC", monospace';
+
+export const COLOURS = {
+  system: "#3FE0FF",
+  task: "#FF8A5B",
+  taskTitle: "#FFE3D6",
+  alarm: "#FF5A4E",
+  chipLabel: "#FFB39E",
+  panelInk: "#EAF7FF",
+  muted: "#9FB7CC",
+  ink: "#0B1020",
+  cardSurface: "rgba(255,255,255,0.97)",
+  cardName: "#1C2230",
+  cardUnit: "#9AA3B2",
+  cardRule: "#EEF0F4",
+  cardValue: "#E5322D",
+  cardDots: ["#FF4D4F", "#1FA2FF", "#111111", "#2BB673"],
+};
+
+/** Subtitle fill by who speaks; the same values are in edit_tool.py for the ASS route. */
+export const SUBTITLE: { fill: Record<CueKind, string>; keyword: string; rim: string } = {
+  fill: { line: "#FFFFFF", vo: "#9FE8FF", system: "#3FE0FF" },
+  keyword: "#FFD400",
+  rim: "#0B0D12",
+};
+
+/** Unmarked items read as 稀有. */
+export const RARITY: Record<Rarity, string> = { 传说: "#FFC940", 史诗: "#B26BFF", 稀有: "#3FA9FF" };
+export const rarityOf = (rarity: Rarity | null): Rarity => rarity ?? "稀有";
+
+/** Where each style sits, in `u` from the top. */
+export const TOP_U = { card: 16, system: 10, task: 9, corner: 5.5 };
+
+/** 0→1 entry, `delay` seconds after the piece's first frame. A pure function of the frame. */
+export const entrance = (frame: number, fps: number, delay = 0, damping = 14): number =>
+  spring({ frame: frame - delay * fps, fps, config: { damping, stiffness: 200, mass: 0.6 } });
+
+/** 1→0 over the piece's last `seconds`; the caller also lifts by (1 − value). */
+export const exit = (frame: number, fps: number, text: ScreenText, seconds = 0.22): number => {
+  const length = (text.end - text.start) * fps;
+  return interpolate(frame, [length - seconds * fps, length], [1, 0], {
+    extrapolateLeft: "clamp",
+    extrapolateRight: "clamp",
+  });
+};
+
+/** Two or three frames of glitch before a panel settles. */
+export const glitch = (frame: number): { opacity: number; dx: number } =>
+  frame > 3 ? { opacity: 1, dx: 0 } : { opacity: frame % 2 ? 0.35 : 1, dx: frame % 2 ? 6 : -4 };

package/lib/drama/skills/short-drama-edit/assets/remotion/tsconfig.json

@@ -5,6 +5,7 @@
     "jsx": "react-jsx",
     "module": "ESNext",
     "moduleResolution": "bundler",
+    "allowJs": true,
     "strict": true,
     "skipLibCheck": true,
     "noEmit": true

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

@@ -22,9 +22,11 @@
 - 入点：0.90
 - 出点：3.40
 - 时长：2.50
-- 取舍：入点=弹窗动画已经展开过半，起势的静止两帧删掉；出点=弹窗完全展开且文字可读的最后一帧，之后画面开始整体提亮
-- 声音：保留原声，与上一段做 0.15 秒交叉淡入（两段底噪水平差 4 dB）
+- 取舍：入点=弹窗动画已经展开过半，起势的静止两帧删掉；出点=弹窗完全展开、面板区仍是留白的最后一帧，之后画面开始整体提亮
+- 声音：保留原声；回听确认与上一段衔接
 - 字幕：无
+- 画面文字：0.40-2.50 系统面板 认证通过｜创作者认证（史诗）｜全站创作者榜 第 1 位（传说）
+- 音效：0.40-1.00 制作成果/音效/提示音.wav（增益：-10）
 
 ## CUT-EP001-003 · 他念出那句话
 
@@ -33,8 +35,8 @@
 - 出点：7.00
 - 时长：5.00
 - 取舍：入点=按发声区间前推 0.3 秒余量，开头 1.5 秒的凝视与上一段蓄势重复，整段去掉；出点=句尾收音之后 0.4 秒，人物姿态尚未回弹
-- 声音：保留原声；音乐在 4.20 秒进入，台词发声区间内压低 9 dB，句尾停顿处恢复
-- 字幕：这条路我自己走
+- 声音：保留原声
+- 字幕：这条路我自己走（重点：自己走）
 
 ---
 

package/lib/drama/skills/short-drama-edit/references/cut-craft.md

@@ -1,81 +1,40 @@
 # 入出点与镜序
 
-可用带划完之后，剪辑要回答两个问题：**这一段从哪一帧进、到哪一帧出**，以及**这些段落按
-什么顺序连起来**。两个问题都在带内解决；带外的帧不参与讨论。
+## 入出点
 
-## 入点
+在素材可用区间内，按信息、表演与节奏选入出点。
+动作镜可以从动作已经开始的位置进入；反应、等待、揭示前停顿可以保留静止。
+出点要让观众读到本镜的结果，并避开后续漂移或无意重复。
 
-入点取**动作已经在进行中**的那一帧，不取动作准备开始的那一帧。
-
-观众补得上开头，补不上结尾。一个人伸手去拿东西，从「手已经在移动」进，观众自动知道他要拿；
-从「手还放在桌上」进，前面那半秒只是在等。生成素材的起势帧几乎总是这半秒。
-
-具体判断：从候选入点往后放，如果前 0.3 秒删掉之后这一段的信息没有减少，就删掉。反复这样问，
-直到再删就丢信息为止。
-
-例外是**需要一个静止起点的镜头**：反应镜、揭示前的停顿、有意的空拍。这些镜头的静止不是起势帧，
-它本身就是内容。区别在于静止之后是否发生了它承诺的那件事——反应镜的静止之后有反应，
-起势帧之后只是动作终于开始了。
-
-## 出点
-
-出点取**信息完成之后、缺陷开始之前**。这两个条件经常冲突，冲突时以缺陷为准：把一段拖进
-漂移区，损失的不只是这一段，还有它后面那一刀的可信度。
-
-信息完成的判断：这一镜要让观众知道的那件事，最后一次可见是哪一帧。之后的帧要么在重复，
-要么在等下一件事。
-
-有台词时出点由声音决定，不由画面决定。见下一节。
-
-## 台词优先
-
-有台词的段落，边界顺序是：
-
-1. 先测这句话的实际发声区间（从第一个音到最后一个音收尾）。
-2. 入点不晚于发声起点，出点不早于发声收尾——两端各留出一点余量，让句尾不被切得发干。
-3. 在这个约束内，才轮到画面上的入出点判断。
-
-切在字中间是结构缺陷。半个字听起来像技术故障，观众不会理解成风格。转写工具只用来**定位**
-这句话在时间轴上的位置；字幕文字仍然逐字取自剧本原文。
-
-一句台词跨越两段素材时，它属于其中一段——不要在句中换镜。确实需要在这句话上换镜时，
-回上游把它拆成两句，或者接受这一镜承担完整的一句。
+对白先确定实际发声区间，保留完整的字音与需要的停顿。生成的对白镜常晚开口、句后拖尾：
+入点落在开口前约 0.25 秒，出点落在台词结束后留约 0.4 秒反应，整段不短于约 1.2 秒；
+只按属于本句台词的发声定位，不被杂音拖长。
+画面切换可以发生在一句台词中间，前提是音轨连续、说话人和叙事关系清楚。
+不要为了换画面把原台词改成两句。内置 render 只做同步切段；分离画面和声音的剪法
+需要先用外部剪辑工具完成，记录所用素材、声音区间和处理方式。
 
 ## 镜序与相邻关系
 
-镜序默认跟随分镜。改变它是本阶段的权限，但要说明理由。
-
-相邻两段检查三件事，不能三件同时相同：
-
-- **景别**（近 / 中 / 远）
-- **机位**（相对被摄主体的方位）
-- **运动方向**（推 / 拉 / 摇的方向，或静止）
-
-三者全同的两段接在一起会被看成同一个镜头出了问题，而不是两个镜头。改法优先级：删掉其中一段
-（通常它们本来就在重复信息），其次调整镜序把别的段落插进来，最后才是回上游重新设计镜头。
-
-## 重复信息
-
-两段承担同一条信息时，删一段，不要两段各留一半。
-
-各留一半是最容易做出的选择，因为它看起来两边都保住了。实际结果是两个都不完整的段落连在一起，
-观众第二次看到同一件事、而且两次都没看清。选出更好的那一段，整段留下；另一段整段去掉。
+默认沿用分镜镜序。调整时检查动作因果、视线、空间关系、信息揭示和声音衔接。
+相近景别与机位之间的切换容易暴露跳动，可比较改变角度、插入反应或有意跳切的效果。
+是否保留由观众需要看到的信息决定，不把景别、机位和运动方向的组合设为禁令。
 
-## 时长
+重复信息没有新增作用时可删；如果第二次增加反应、对照或重新解释，可以保留。
+拆取两段素材也可以，但要确认动作、台词和情绪仍连贯。
 
-**省下来的时间不要补到别处。**
+## 切点与转场
 
-缩短一段之后，成片比目标时长短了，这时候很自然会想把这两秒加到别的段落上去。不要这样做。
-其它段落的出点是按它们各自的信息和缺陷定的，加长它们只会把它们也推进重复区或漂移区。
-成片短于目标时长是一个结果，不是一个需要填平的缺口。
+动接动、声音桥和切到不同主体都可帮助衔接，按本场叙事选择。
+若相邻镜头有生成漂移，先判断能否通过取舍或接镜校正解决；叠化等转场不能替代缺失的内容。
 
-目标时长的作用是在**开始剪之前**约束镜头数量和信息密度。剪完之后它就只是一个用来对照的数字，
-差多少写进报告，由创作者决定要不要回上游加内容。
+剧本的 `[转场]` 可能交代时空变化，也可能明确指定声音或画面效果，先读具体要求。
+可通过新镜头中的环境信息、声音桥、黑场或其他已接受效果实现。
+内置 render 只做硬切；需要声音桥或画面转场时使用外部工具，并记录处理参数。
 
-## 什么时候停
+## 时长与完成
 
-再剪一版能不能更好，几乎总是「能」。判断该不该继续的标准不是「还有没有可改的地方」，
-而是**下一刀要动的是不是观众能看见的东西**。
+删短某段后，只有其他段落确实需要更多表演或阅读时间才延长，不机械补齐总秒数。
+目标时长若是创作参考，报告实际时长与差异；若是用户明确的交付限制，则继续调整或指出
+缺少哪些素材才能满足，不能把它自行降为参考值。
 
-在成片里看不见的地方反复重出和微调，是本阶段最容易发生的浪费：一段素材最终只用了两秒，
-却为它被丢掉的那四秒重出了三次。动手之前先确认，要修的这一帧到底在不在成片里。
+下一轮修改应针对成片里可见或可听的问题，优先修复影响理解、连续性和交付要求的部分。

package/lib/drama/skills/short-drama-edit/references/delivery-verify.md

@@ -1,58 +1,33 @@
 # 交付与验收
 
-本阶段的验收只回答**可测的事实**。「这条片子好不好看」不在这里回答，也不能用这里的任何一项
-数字去暗示它。
-
-## 可测项
-
-渲染完成后逐项测量并回报数字，不回报「通过」：
-
-| 项 | 怎么测 | 判据 |
-|---|---|---|
-| 成片时长 | 探测输出文件 | 等于各段时长之和；不等说明拼接或转码出了问题 |
-| 每一刀的位置 | 按剪辑单区间反查 | 与文档一致 |
-| 台词完整性 | 在成片上转写，逐句对剧本原文 | 每一句留下来的台词都能找到 |
-| 边界帧 | 抽剪辑点前后各一帧 | 没有黑场帧、白场帧或半渲染帧 |
-| 响度 | 测整片响度 | 落在交付规格声明的目标上 |
-| 字幕对齐 | 抽有字幕的段落的帧 | 字幕在发声区间内出现，位置没有压住画内文字 |
-| 画幅与帧率 | 探测输出文件 | 等于交付规格声明的值 |
-
-任何一项测不了（缺工具、缺原文、素材不可读）就如实写「未测」和原因。**不要用相邻的、
-测得到的那一项去替它作证**——渲染成功不能证明台词还在，时长对上不能证明没有黑场帧。
-
-最容易漏的是字幕那一行：`verify` 返回一整屏数字，看起来已经查完了，但它测不了字幕长
-什么样。本套件就这样发过一版字号被放大两倍的成片——改完样式只跑了 `verify`，没抽帧看。
-**改动只要影响画面，就必须抽帧看，不管数字多好看。**
-
-## 报告什么
-
-交付时给出四样东西：
-
-1. **成片文件路径**，以及每段切好的中间文件路径。
-2. **上表逐项的实测数字**，包括未测项和原因。
-3. **目标时长与实际时长的差**，以及为什么是这个差。
-4. **仍然存在的取舍选项**——还可以再剪的地方、可以回上游重出的地方，各自的代价。
-   列出来交给创作者选，不替他决定要不要再来一版。
-
-不要报告的：任何形式的质量结论、「已经可以发布了」、把技术成功写成创作成功。
-
-## 交回上游的东西
-
-剪辑是第一次同时看到成片和意图的位置，所以它必然会积累一批只有在这里才看得见的发现。
-这些发现不属于剪辑单，但属于本轮报告：
-
-- **某一镜的可用带远短于声明时长** → 视频提示词阶段的时长与动作负载不匹配。
-- **两镜信息重复** → 分镜阶段的切镜理由不成立。
-- **某句台词在成片上说不清** → 剧本层面的语速/字数问题，或声音生成的容量问题。
-- **成片整体缺少某种信息**（人物不立、地点没交代、转折没落地）→ 上游结构问题，
-  不是剪辑能补的。
-
-逐条点名，写清是在哪一段、哪个时间点观察到的，交给对应 owner。不在剪辑阶段自行修改上游文档。
-
-## 可继续精修的工程
-
-成片是一次交付，不是终点。创作者通常还要在自己的剪辑软件里继续改。因此除了成片，
-把切好的中间文件和剪辑单一起交出去——有了这两样，任何人都能在别的工具里复现这一版，
-并从这一版继续。
-
-只交一个成片文件，等于要求下一个人从头再剪一遍。
+检查实际交付文件，并区分实测结果、人工判断和未测项。
+
+| 项 | 怎么核对 |
+|---|---|
+| 时长与切点 | 对照实际渲染区间、帧边界和用户时长要求 |
+| 内容覆盖 | 对照分镜和视频提示词，必要内容有承载，未采用镜头有原因 |
+| 台词 | 在成片上回听，必要时转写辅助，逐句对照剧本 |
+| 边界帧 | 查看剪辑点前后，检查意外黑白帧、画面断裂和漂移；逐帧查看 `verify` 列出的疑似坏帧 |
+| 声音 | 回听接缝、对白清晰度与已声明静默；测量整片响度 |
+| 字幕 | 检查逐字内容、发声时间、字号、折行和画内文字避让 |
+| 画内文字 | 按剧本与视觉设定的文字政策检查载体、可读性和指定文字 |
+| 画幅与帧率 | 探测输出文件，对照交付规格 |
+| 接镜色彩 | 在同场景、同光态下比较可比区域，确认校正没有过冲；先看 `verify` 点名的切点 |
+
+`verify` 只提供部分技术测量，不能替代回听与画面检查。
+分段色彩观测按当前剪辑单读取中间分段，报告平均亮度和蓝减红像素值；它不代表成片局部区域的
+接镜残差，也不要求各场景接近同一均值。改动剪辑单后先重新渲染，再测量并查看实际切点。
+发现有意黑场、静默或光态变化时按创作意图判断，不因数值异常直接判错。
+
+`verify` 还逐帧读成片：「切点亮度变化」是每个切点前后两帧的平均亮度差（0–255），超过 20 的
+列进「请逐帧查看」；「疑似坏帧」是与前后两帧都明显不同、而前后两帧彼此相近的单帧，常见于解码
+错位，画面文字入场的一两帧故障效果也会被列出并标明。两项都只指出该看哪里，不阻断交付。
+
+## 交付
+
+给出成片、剪辑单、可继续编辑的中间文件，以及外部混音或字幕工程（如使用）。
+说明是否满足用户要求、仍有哪些内容缺口和取舍；测不了的必要项目写明原因。
+
+需要补素材、改台词或改分镜时，指出对应镜头与发生时间并交给负责阶段。
+渲染成功只证明工具完成执行，成片的内容判断需要观看和回听；正式审查由
+`$short-drama-review` 或创作者进行。