@lemoncat7/dsh-partner 2.5.0 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/generated-footage.md

@@ -0,0 +1,54 @@
+# 生成素材的可用区间
+
+## 先检查素材
+
+逐段播放素材，记录实际时长、可用区间，以及不能使用的部分及原因。
+重点检查起始等待、动作回弹、身份或道具漂移、异常提亮、重复表演和口型错位。
+静止、暗部和停顿是否可用，取决于它们是否符合镜头职责。
+
+需要比较画面变化时，可每 0.25–0.5 秒抽帧；在疑似缺陷附近加密到逐帧查看。
+亮度测量可以辅助发现缓慢漂移，身份、动作和局部细节仍需看画面。
+
+可用区间短于计划时长时：
+
+- 已完整承载信息和表演，可以缩短。
+- 其他素材能够承接缺失信息，可以换镜或调整镜序。
+- 必要动作、台词或反应仍缺失，列出缺口并请求补素材。
+
+不要只为避开画面缺陷而丢掉故事所需的信息。若画面不可用而对白完整，可评估保留声音、
+另配画面的剪法；外部混音与画面处理须记录在剪辑单中。
+
+## 把缺陷反馈给上游
+
+描述缺陷发生的时间和画面，再给出希望保留的状态，例如「结尾高光过曝，需保持桌面纹理可辨」。
+正面描述通常更容易说明目标；确有必要的排除条件可以保留，不按否定词数量判错。
+重出后比较同一处是否改善，不把某次生成结果当作所有模型的规律。
+
+## 接镜与色彩一致性
+
+先按同一场景、同一光态分组，再选择可比较的脸、衣物或中性表面作基准。
+全画面平均 RGB 会受景别、服装面积和背景影响，只用于筛查，不能单独决定校正量。
+夜景、日景和有意的冷暖对比不需要拉到全片同一均值。
+
+相邻镜头有可见的曝光或白平衡偏差时，在对应 CUT 写：
+
+```text
+- 画面：亮度 +0.06；色温 -6
+```
+
+- `亮度`：加法偏移，工具支持 −0.25…+0.25。
+- `饱和`：倍数，工具支持 0…2。
+- `色温`：工具的冷暖校正量，支持 −30…+30，正数提红压蓝；不是开尔文值。
+
+这些范围是内置工具的处理范围，不是画面质量标准。需要更大或更精细的校正时使用调色工具。
+先试小幅校正，再看渲染结果和相同区域的测量；不要用固定系数把整片均值差直接换算成校正量。
+人物身份漂移、错误光源或缺失动作应交回上游。
+
+生成阶段仍应保持已接受的光线和色调；已有素材只差可校正的曝光或白平衡时，优先评估后期修正。
+
+## 颗粒
+
+项目需要时，在交付规格写 `- 颗粒：6`；不写或写「无」就不加。
+内置工具支持 0–20 的动态噪点强度，在拼接后对整片统一应用。
+这是一种可选质感处理，不保证产生胶片效果，也不能修复身份、动作和光线错误。
+需要按场景区别处理时，使用外部调色工具并记录决定。

package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/sound-and-subtitles.md

@@ -0,0 +1,60 @@
+# 声音、字幕与音乐
+
+## 声音接缝
+
+在相邻镜头拼接后回听底噪、混响、环境声和音乐是否突然变化。
+可按需要采用音轨交叉淡入、连续环境底、对白与画面分离或补充音乐。
+保留有叙事作用的静默、音效和相对响度。
+
+**内置工具范围**：`edit_tool.py render` 保留素材原声并可做整片响度标准化；
+CUT 的 `声音` 行是剪辑说明，工具不解析它，不执行静音、交叉淡入、配乐进入或 ducking。
+需要这些处理时用 ffmpeg 或剪辑软件另行完成，记录命令或工程及实际输出；完成后再验收。
+不能把写下声音方案或 render 成功当成已经混音。
+
+## 响度
+
+两遍测量不保证归一化后恰好达到目标。线性增益会超过峰值或动态范围目标时，
+`loudnorm` 会退回动态处理；短片和稀疏音效仍需测量编码后的实际 LUFS 与真峰。
+内置归一化输出使用 48 kHz，避免动态处理的内部升采样直接决定 AAC 采样率。
+不达标时按声音设计通过外部工具处理瞬态、限幅或混音，再核对成片；不要把目标值当实测值。
+
+## 台词与时间
+
+先在源素材上定位发声区间，再在成片上逐句回听，核对留下的台词完整、可辨。
+转写可以辅助查漏和定位，最终文字按剧本核对，识别有出入时回听确认。
+
+重出素材会改变发声位置，应重测相关字幕时间并更新剪辑单。
+`check` 会提示素材比剪辑单新；这个时间戳检查不能证明字幕已经重新对齐。
+
+## 字幕
+
+竖屏短剧默认硬字幕，服从用户的字幕选择。
+字幕文字逐字取自《剧本.md》，标点可按字幕惯例调整。转写仅辅助定位，不覆盖原文。
+
+- 一句过长时可拆成多个先后显示的字幕条。
+- 一镜有多句时使用 `字幕 1`、`字幕 2` 等编号，每句给出时间。
+- 字幕时间相对本 CUT 的入点，不相对源素材起点；落在该段使用区间内。
+- 累计成片位置使用渲染后各段的实际时长，避免帧边界取整产生漂移。
+- 抽帧检查字号、折行、安全区和画内文字遮挡。
+
+内置 ffmpeg 路线用实际画幅作为 ASS PlayRes，字号按该画幅像素计算。
+它采用全片统一样式，CUT 的字幕行不支持位置指令；需要逐镜避让或更复杂排版时，
+用外部字幕编辑器或修改 Remotion 字幕层，并对输出抽帧检查。
+
+### 渲染路线
+
+| 路线 | 适用范围 | 开销 |
+|---|---|---|
+| `ffmpeg`（默认） | 统一的白字黑描边样式 | 需要带 libass 的 ffmpeg |
+| `remotion` | 需要修改 CSS、字重、折行或入场动画 | Node 依赖，逐帧浏览器渲染；并发默认 2 |
+
+Remotion 安装与样式调整见 [字幕叠层](../assets/remotion/README.md)。
+两条路线都要在实际成片上检查字幕。
+
+## 响度与时间线音乐
+
+在剪辑单写交付响度；混音完成后对整片标准化并测量输出。
+同时回听对白与环境的相对关系，整片响度达标不代表各句都清楚。
+
+时间线音乐按已接受意图选择进入、退出、循环与对白压低区间。
+素材不足时回生产阶段补齐；具体混音通过外部工具执行，并在剪辑单留下可复现记录。

package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/stage-contract.md

@@ -0,0 +1,51 @@
+# 剪辑阶段契约
+
+本阶段只拥有 `剧集/<EP>/剪辑单.md` 中的 `CUT-...` 项、交付规格章节，以及渲染到
+`剧集/<EP>/制作成果/成片/` 的成片与中间文件。它继承镜序、镜头职责、台词原文和已生产的素材
+字节，不回写剧本、视觉设定、分镜或视频提示词。
+
+剪辑单记录素材取舍、时间与后期处理。可以缩短、重排或省略素材，但不回写上游的台词、
+镜头职责和状态；确需改变故事内容时交由上游修订。
+
+## 本阶段规则
+
+### `EDT`
+
+| ID | Class | Knowledge |
+|---|---|---|
+| EDT-01 | structural_invariant | Every `CUT-...` binds one existing `MOTION-...` and one currently readable media file; a cut with no material source cannot exist. |
+| EDT-02 | structural_invariant | 入点, 出点 and 时长 are self-consistent (`出点 - 入点 == 时长`), non-negative, and the 出点 does not exceed the source file's measured duration. |
+| EDT-03 | structural_invariant | Editing selects and orders existing frames. It never rewrites dialogue, shot purpose, start/end state, or any upstream declared duration; a needed semantic change is reported to the owning document instead. |
+| EDT-04 | reviewed_invariant | Dialogue retained in the film remains audibly complete. Picture may cut during a line if the sound remains continuous and the narrative is clear. Separate picture and audio editing requires an external tool; the built-in renderer trims them together. |
+| EDT-05 | structural_invariant | When subtitles are requested, every retained spoken line has a cue derived verbatim from the screenplay; punctuation may follow subtitle convention. Transcription locates speech but does not replace the source text. |
+| EDT-06 | structural_invariant | Two cuts drawn from the same source file do not overlap in source time. Deliberate repetition is declared as repetition and states why the second appearance still earns its place. |
+| EDT-07 | reviewed_invariant | Each cut's in-point and out-point land inside that material's usable band, and 取舍 names what is visible at each boundary rather than citing an abstract need for pace. |
+| EDT-08 | craft_default | Check adjacent cuts for unintended visual jumps and duplicated information. Similar framing, deliberate repetition and jump cuts are valid when they serve the accepted narrative. |
+| EDT-09 | craft_default | Do not mechanically redistribute trimmed time. Extend another beat only when its performance or readability benefits, and preserve explicit delivery-duration requirements. |
+| EDT-10 | reviewed_invariant | Listen to joins for unintended changes in ambience or music. Use an appropriate documented audio treatment when needed; the built-in renderer does not execute prose mixing instructions. |
+| EDT-11 | reviewed_invariant | Record unused shots with a reason: missing material, unusable quality, or an intentional narrative omission. |
+| EDT-12 | craft_default | The delivered film is loudness-normalized to one declared target, and burned subtitles are the default for vertical short drama. |
+| EDT-13 | craft_default | Distinguish a reference target from a required delivery duration. Report the gap and satisfy a fixed requirement or identify the material needed to do so. |
+| EDT-14 | taste_option | Cut rhythm, whether a beat is held or clipped, and whether a moment repeats are creator choices; the suite records them and does not treat any of them as defects. |
+| EDT-15 | structural_invariant | Rendering, duration match and file existence are technical outcomes. None of them may be reported as a statement about whether the film is good; quality goes to review or to the creator. |
+| EDT-16 | reviewed_invariant | Compare shots within the same scene and lighting state using comparable image regions. Record corrections, then inspect the output. Whole-frame averages alone do not establish a mismatch; intentional lighting changes are valid. |
+| EDT-17 | structural_invariant | After material is regenerated, re-measure the spoken spans and update its subtitle windows before rendering. The material-mtime warning is a prompt to check, not proof of alignment. |
+| EDT-18 | taste_option | Optional grain is declared once in the delivery spec and applied dynamically after assembly by the built-in renderer. Its supported range is a tool limit, not a quality standard; other treatments may use external grading tools. |
+
+规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
+`reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、
+`taste_option`（创作者选择，不作缺陷）。创作者已接受的事实优先于本表。
+
+## 与上游阶段的分工
+
+| 问题 | 归属 |
+|---|---|
+| 这句台词该怎么说 | `剧本.md` |
+| 这一镜承担什么、起终状态是什么 | `分镜.md` |
+| 这一镜怎么动、生成时说什么 | `视频提示词.md` |
+| 这一段素材怎么来的、花了多少钱 | 生产运行记录 |
+| **这一段素材哪几帧进成片** | **`剪辑单.md`** |
+| 成片好不好看 | 审查，或创作者本人 |
+
+生成结果与上游声明不符时，剪辑记录事实并取舍，同时把不符点名报告；不在剪辑单里修改上游声明
+来让它们看起来一致。