@oh-story/dsh 0.1.8 → 0.1.10

package/lib/drama/skills/short-drama-edit/scripts/selftest.py

@@ -0,0 +1,520 @@
+#!/usr/bin/env python3
+"""Offline self-test for cut-list parsing and mechanical checks.
+
+Runs without ffmpeg: every assertion here is about the document, not the media.
+The media-dependent paths are exercised by the suite's tests instead.
+"""
+
+from __future__ import annotations
+
+import re
+import sys
+import tempfile
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+from edit_tool import (  # noqa: E402
+    _unaccounted_shots,
+    DEFAULT_REMOTION_CONCURRENCY,
+    REMOTION_SOURCE,
+    REMOTION_SOURCE_FILES,
+    EditError,
+    _ass_text,
+    _build_ass,
+    _shot_match_filter,
+    _subtitle_cues,
+    check_cuts,
+    parse_cut_list,
+)
+
+MINIMUM_PYTHON = (3, 9)
+if sys.version_info < MINIMUM_PYTHON:
+    raise SystemExit("selftest.py requires Python 3.9 or newer")
+
+MOTION = """# EP001 视频提示词
+
+## MOTION-EP001-010 · 手指停在发布键上
+
+## MOTION-EP001-011 · 认证弹窗展开
+"""
+
+SCREENPLAY = """# EP001
+
+## EP001-SC003 内 · 房间 · 夜
+
+角色甲：这条路我自己走。
+"""
+
+CUT_LIST = """# EP001 剪辑单
+
+- 成片目标时长：5.00 秒
+- 交付响度：-16 LUFS
+- 未采用镜头：MOTION-EP001-009（理由：文件缺失——尚未生产）
+
+## CUT-EP001-001 · 手指停在发布键上
+
+- 来源：MOTION-EP001-010 · media/010.mp4
+- 入点：0.60
+- 出点：3.60
+- 时长：3.00
+- 取舍：入点=手指已经在下压；出点=界面开始响应
+- 声音：保留原声
+- 字幕：无
+
+## CUT-EP001-002 · 那句话
+
+- 来源：MOTION-EP001-011 · media/011.mp4
+- 入点：0.00
+- 出点：2.00
+- 时长：2.00
+- 取舍：入点=文件起点；出点=句尾收音后
+- 声音：保留原声
+- 字幕：这条路我自己走
+"""
+
+
+def require(condition: bool, message: str) -> None:
+    if not condition:
+        raise AssertionError(message)
+
+
+def build(root: Path, cut_list: str) -> Path:
+    episode = root / "剧集" / "EP001"
+    (episode / "media").mkdir(parents=True)
+    (episode / "视频提示词.md").write_text(MOTION, encoding="utf-8")
+    (episode / "剧本.md").write_text(SCREENPLAY, encoding="utf-8")
+    (episode / "剪辑单.md").write_text(cut_list, encoding="utf-8")
+    for name in ("010.mp4", "011.mp4"):
+        (episode / "media" / name).write_bytes(b"")
+    return episode
+
+
+def check_subtitle_geometry() -> None:
+    """FontSize is already in PlayRes units; scaling it by the frame twice ruins it.
+
+    Letting ffmpeg convert an SRT hands libass a 384-high canvas and every size
+    is then multiplied by height/384 on the way to the frame. Computing the size
+    from the real height on top of that produced type a third of the frame wide,
+    sitting in the middle of the picture with both ends of the line cut off — and
+    it shipped, because the render after the style change was checked with
+    numbers instead of a frame.
+    """
+
+    width, height = 768, 1344
+    ass = _build_ass([(1.0, 2.0, "这条路我自己走")], width, height)
+    require(f"PlayResX: {width}" in ass, "PlayResX 必须等于画面宽")
+    require(f"PlayResY: {height}" in ass, "PlayResY 必须等于画面高")
+    style = next(line for line in ass.splitlines() if line.startswith("Style:"))
+    fields = style.split(":", 1)[1].split(",")
+    font_size = float(fields[2])
+    require(
+        height * 0.02 <= font_size <= height * 0.06,
+        f"字号 {font_size} 不在画面高度的 2%–6% 之间",
+    )
+    margin_v = float(fields[21])
+    require(margin_v < height * 0.2, f"底边距 {margin_v} 会把字幕推离安全区")
+    margin_h = float(fields[19])
+    require(margin_h > 0, "左右边距为 0 时长句会顶到画面边缘")
+    require("这条路我自己走" in ass, "台词原文必须原样进 ASS")
+
+
+def check_subtitle_timing() -> None:
+    """Cues follow the segments that were written, not the numbers in the document.
+
+    Each segment lands on a frame boundary, so it runs a few milliseconds past
+    its declared length. Accumulating the declared numbers drifts, and the
+    subtitle leaves before the actor stops speaking.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        declared = [cut.end - cut.start for cut in cuts]
+        measured = [span + 0.04 for span in declared]
+
+        drifting = _subtitle_cues(cuts, declared)
+        真实 = _subtitle_cues(cuts, measured)
+        require(len(真实) == 1, f"应有一条字幕，实际 {len(真实)}")
+        require(
+            真实[0][0] > drifting[0][0],
+            "分段比声明更长时，后面的字幕必须相应后移",
+        )
+        require(
+            abs(真实[0][0] - (drifting[0][0] + 0.04)) < 1e-6,
+            "位移必须等于前面各段的实测差之和",
+        )
+
+
+def check_shot_match() -> None:
+    """A declared correction is applied; an undeclared one never is.
+
+    Generated shots drift a stop apart, so the join reads as a mistake. The
+    correction has to be visible in the document — a tool that measured clips
+    and adjusted them on its own would be changing pictures nobody could review.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(_shot_match_filter(cuts[0]) == "", "没写画面的段不得被改动")
+
+        listed = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：亮度 +0.06；色温 -6\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(listed, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        chain = _shot_match_filter(cuts[0])
+        require("brightness=0.06" in chain, f"亮度没进滤镜链: {chain}")
+        require("colorbalance" in chain and "rm=-0.06" in chain, f"色温没进滤镜链: {chain}")
+
+        # ffmpeg 的 eq 只接受 0..3 的饱和度；负数在文档里通过、渲染时才炸。
+        negative = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：饱和 -1.5\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(negative, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("超出允许范围" in str(error), f"负饱和度报错不对: {error}")
+        else:
+            raise AssertionError("饱和 -1.5 应当被拒绝——ffmpeg 不接受负饱和度")
+
+        # 超出范围是重新调色，不是接镜，必须挡住。
+        wild = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：亮度 +0.9\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(wild, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("超出允许范围" in str(error), f"越界报错不对: {error}")
+        else:
+            raise AssertionError("亮度 +0.9 应当被拒绝")
+
+        # 写了内容却没有可执行项，是写错了，不能静默当成不校正。
+        vague = CUT_LIST.replace(
+            "- 声音：保留原声\n- 字幕：无",
+            "- 声音：保留原声\n- 画面：调暖一点\n- 字幕：无", 1)
+        (episode / "剪辑单.md").write_text(vague, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("没有可执行的项" in str(error), f"含混报错不对: {error}")
+        else:
+            raise AssertionError("「调暖一点」应当被拒绝")
+
+
+def check_multi_subtitle() -> None:
+    """A shot can carry several lines, and all of them must reach the screen.
+
+    The exchange "就是什么 / 就是少了点东西 / 少了什么" is one over-shoulder shot.
+    A cut list that holds only one subtitle per cut silently drops the other
+    two: the film plays lines that never appear, and nothing reports it.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        (episode / "剧本.md").write_text(
+            SCREENPLAY + "\n江晨：就是什么。\n江晨：就是少了点东西。\n江晨：少了什么。\n",
+            encoding="utf-8",
+        )
+        multi = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-0.60 就是什么\n"
+            "- 字幕 2：0.80-1.40 就是少了点东西\n"
+            "- 字幕 3：1.50-1.90 少了什么",
+        )
+        (episode / "剪辑单.md").write_text(multi, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(len(cuts[1].subtitles) == 3, f"三句应全部解析，实际 {len(cuts[1].subtitles)}")
+        require(cuts[1].subtitles[2][2] == "少了什么", "字幕顺序错了")
+        require(not check_cuts(episode, cuts, root, probe=False), "三句合法字幕不该报错")
+        cues = _subtitle_cues(cuts, [cut.end - cut.start for cut in cuts])
+        require(len(cues) == 3, f"三句应各自成为一条 cue，实际 {len(cues)}")
+
+        # 编号必须连续：跳号意味着有一句被漏掉了。
+        gap = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-0.60 就是什么\n- 字幕 3：1.50-1.90 少了什么",
+        )
+        (episode / "剪辑单.md").write_text(gap, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("连续" in str(error), f"跳号报错不对: {error}")
+        else:
+            raise AssertionError("字幕编号跳号应当被拒绝")
+
+        # 两句不能同时在屏上。
+        overlap = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：0.10-1.00 就是什么\n- 字幕 2：0.80-1.40 就是少了点东西",
+        )
+        (episode / "剪辑单.md").write_text(overlap, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("重叠" in str(error), f"重叠报错不对: {error}")
+        else:
+            raise AssertionError("字幕时间重叠应当被拒绝")
+
+        # 多句时每句必须自带时间，否则无从摆放。
+        untimed = CUT_LIST.replace(
+            "- 字幕：这条路我自己走",
+            "- 字幕 1：就是什么\n- 字幕 2：0.80-1.40 就是少了点东西",
+        )
+        (episode / "剪辑单.md").write_text(untimed, encoding="utf-8")
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("各自带时间" in str(error), f"缺时间报错不对: {error}")
+        else:
+            raise AssertionError("多句字幕缺时间应当被拒绝")
+
+
+def check_stale_window() -> None:
+    """Regenerating a shot invalidates every subtitle window bound to it.
+
+    The windows were reverse-engineered from the old take's audio. Nothing else
+    notices the change: the numbers stay in range, the render still succeeds,
+    and the subtitle appears at a moment when nobody is speaking.
+    """
+
+    import os
+    import time
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        # Anchored on the field, not on the line's wording: the fixture's dialogue
+        # is illustrative and gets rewritten, and a test that breaks when an
+        # example changes is a test nobody trusts.
+        timed = re.sub(
+            r"^(- 字幕：(?!无).+)$",
+            r"\1\n- 字幕时间：0.30-1.60",
+            CUT_LIST,
+            count=1,
+            flags=re.MULTILINE,
+        )
+        require(timed != CUT_LIST, "夹具里应当有一条带台词的字幕")
+        episode = build(root, timed)
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        require(
+            not check_cuts(episode, cuts, root, probe=False),
+            "素材不比剪辑单新时不该报陈旧",
+        )
+
+        media = episode / "media" / "011.mp4"
+        listing = episode / "剪辑单.md"
+        newer = listing.stat().st_mtime + 60
+        os.utime(media, (newer, newer))
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(
+            any("素材比剪辑单新" in item for item in findings),
+            f"重出后的陈旧字幕时间没抓到: {findings}",
+        )
+
+        # 改过剪辑单之后就不再报——那正是「重测并改」的动作。
+        time.sleep(0.01)
+        listing.write_text(timed, encoding="utf-8")
+        later = newer + 60
+        os.utime(listing, (later, later))
+        _, cuts, _ = parse_cut_list(listing)
+        require(
+            not any("素材比剪辑单新" in item for item in check_cuts(episode, cuts, root, probe=False)),
+            "改过剪辑单之后不该继续报陈旧",
+        )
+
+
+def check_ass_escaping() -> None:
+    """A quoted line keeps every character it had in 剧本.md.
+
+    `{`…`}` is an override block in ASS: unescaped, libass drops the braces and
+    everything between them, on screen, with no error anywhere. EDT-05 exists to
+    keep the burned text equal to the screenplay's character for character.
+    """
+
+    line = "他念出来：{姓名}，请签字。"
+    escaped = _ass_text(line)
+    require("\\{" in escaped and "\\}" in escaped, f"花括号没有转义: {escaped}")
+    require("姓名" in escaped, "转义把字弄丢了")
+    ass = _build_ass([(1.0, 2.0, line)], 1080, 1920)
+    dialogue = [row for row in ass.splitlines() if row.startswith("Dialogue")][0]
+    require(dialogue.endswith(escaped), f"Dialogue 行没有用转义后的正文: {dialogue}")
+    require(
+        _ass_text("反斜杠 \\N 不是换行").count("\\\\") == 1,
+        "反斜杠没有转义，\\N 会被当成换行",
+    )
+
+
+def check_remotion_sources_all_shipped() -> None:
+    """The sync list is a whitelist; a file left out of it is missing at render.
+
+    Nothing else notices until someone has already paid for that render.
+    """
+
+    # `as_posix`, because the whitelist is written with forward slashes and
+    # `relative_to` yields backslashes on Windows.
+    on_disk = {
+        path.relative_to(REMOTION_SOURCE).as_posix()
+        for path in REMOTION_SOURCE.rglob("*")
+        if path.is_file()
+        and path.suffix in {".ts", ".tsx", ".json"}
+        and "node_modules" not in path.parts
+    }
+    listed = set(REMOTION_SOURCE_FILES)
+    require(not (on_disk - listed), f"Remotion 源文件没进同步清单: {sorted(on_disk - listed)}")
+    require(not (listed - on_disk), f"同步清单里有不存在的文件: {sorted(listed - on_disk)}")
+
+
+def check_remotion_concurrency_is_capped() -> None:
+    """Remotion defaults to one browser per core, each holding a full frame."""
+
+    require(DEFAULT_REMOTION_CONCURRENCY >= 1, "并发上限必须是正数")
+    source = Path(__file__).resolve().with_name("edit_tool.py").read_text(encoding="utf-8")
+    require("--concurrency=" in source, "render 必须显式传 --concurrency，不能用 Remotion 的默认值")
+
+
+def check_grain_is_a_delivery_wide_decision() -> None:
+    """Grain is declared once for the film, and refused when it is not grain.
+
+    Per cut it would become one more thing that differs between segments, which
+    is the defect it exists to cover.
+    """
+
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        path = episode / "剪辑单.md"
+        baseline = path.read_text(encoding="utf-8")
+
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain is None, "没声明颗粒时应当是 None")
+
+        anchor = "- 交付响度："
+        require(anchor in baseline, "夹具里应当有交付响度那一行")
+        path.write_text(baseline.replace(anchor, "- 颗粒：6\n" + anchor, 1), encoding="utf-8")
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain == 6.0, f"颗粒没有解析出来: {delivery.grain}")
+
+        path.write_text(baseline.replace(anchor, "- 颗粒：无\n" + anchor, 1), encoding="utf-8")
+        delivery, _, _ = parse_cut_list(path)
+        require(delivery.grain is None, "「无」应当解析成不加颗粒")
+
+        path.write_text(baseline.replace(anchor, "- 颗粒：80\n" + anchor, 1), encoding="utf-8")
+        try:
+            parse_cut_list(path)
+        except EditError as error:
+            require("超出" in str(error), f"越界报错没说清: {error}")
+        else:
+            raise AssertionError("颗粒 80 应当被拒绝")
+
+
+def check_missing_shots_are_reported() -> None:
+    """A shot absent from the film must be absent on purpose.
+
+    Absence is invisible in a finished film — nobody watching can tell that an
+    episode's opening seven shots were never made. The only place it can be
+    caught is here, against the document that lists them.
+    """
+
+    known = {f"MOTION-EP006-{i:03d}" for i in range(1, 5)}
+
+    class Stub:
+        def __init__(self, motion): self.motion = motion
+
+    used = [Stub("MOTION-EP006-003"), Stub("MOTION-EP006-004")]
+    findings = _unaccounted_shots(known, used, [])
+    require(findings, "少了两镜却没有任何 finding")
+    require("001" in findings[0] and "002" in findings[0], f"没点名缺的镜头: {findings}")
+
+    excused = _unaccounted_shots(
+        known, used, ["MOTION-EP006-001（理由：质量不可用）", "MOTION-EP006-002（理由：文件缺失）"]
+    )
+    require(not excused, f"写进未采用的镜头不该再报: {excused}")
+
+    require(not _unaccounted_shots(known, [Stub(m) for m in known], []), "全采用时不该报")
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as scratch:
+        root = Path(scratch)
+        episode = build(root, CUT_LIST)
+        delivery, cuts, unused = parse_cut_list(episode / "剪辑单.md")
+        require(delivery.target_seconds == 5.0, "目标时长没有解析出来")
+        require(delivery.loudness_lufs == -16.0, "交付响度没有解析出来")
+        require(len(cuts) == 2, f"应解析出 2 段，实际 {len(cuts)}")
+        require(len(unused) == 1, "未采用镜头没有解析出来")
+        require(cuts[1].subtitles[0][2] == "这条路我自己走", "字幕文字没有解析出来")
+
+        clean = check_cuts(episode, cuts, root, probe=False)
+        require(not clean, f"完好的剪辑单不该有 findings: {clean}")
+
+        # 出点 - 入点 与声明时长不符必须抓到。
+        drifted = CUT_LIST.replace("- 时长：3.00", "- 时长：2.50")
+        (episode / "剪辑单.md").write_text(drifted, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("与「时长" in item for item in findings), f"时长漂移没抓到: {findings}")
+
+        # 字幕必须能在剧本里找到原文；转写猜出来的字不行。
+        invented = CUT_LIST.replace("字幕：这条路我自己走", "字幕：这条陆我自己走")
+        (episode / "剪辑单.md").write_text(invented, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("找不到原文" in item for item in findings), f"编造的字幕没抓到: {findings}")
+
+        # 未知 MOTION 必须抓到。
+        unknown = CUT_LIST.replace("MOTION-EP001-011", "MOTION-EP001-099")
+        (episode / "剪辑单.md").write_text(unknown, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("不在《视频提示词.md》中" in item for item in findings), f"未知 MOTION 没抓到: {findings}")
+
+        # 素材缺失必须抓到。
+        (episode / "media" / "011.mp4").unlink()
+        (episode / "剪辑单.md").write_text(CUT_LIST, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("素材不存在" in item for item in findings), f"缺素材没抓到: {findings}")
+
+        # 同一素材上的两段不得重叠。
+        overlapping = CUT_LIST.replace(
+            "- 来源：MOTION-EP001-011 · media/011.mp4", "- 来源：MOTION-EP001-011 · media/010.mp4"
+        ).replace("- 入点：0.00", "- 入点：1.00").replace("- 出点：2.00", "- 出点：3.00")
+        (episode / "media" / "011.mp4").write_bytes(b"")
+        (episode / "剪辑单.md").write_text(overlapping, encoding="utf-8")
+        _, cuts, _ = parse_cut_list(episode / "剪辑单.md")
+        findings = check_cuts(episode, cuts, root, probe=False)
+        require(any("区间重叠" in item for item in findings), f"同源重叠没抓到: {findings}")
+
+        # 缺字段是文档缺陷，报出来而不是崩掉。
+        (episode / "剪辑单.md").write_text(
+            CUT_LIST.replace("- 出点：3.60\n", ""), encoding="utf-8"
+        )
+        try:
+            parse_cut_list(episode / "剪辑单.md")
+        except EditError as error:
+            require("出点" in str(error), f"缺字段的报错没点名字段: {error}")
+        else:
+            raise AssertionError("缺「出点」应当报错")
+
+    check_subtitle_geometry()
+    check_subtitle_timing()
+    check_shot_match()
+    check_ass_escaping()
+    check_multi_subtitle()
+    check_stale_window()
+    check_missing_shots_are_reported()
+    check_grain_is_a_delivery_wide_decision()
+    check_remotion_sources_all_shipped()
+    check_remotion_concurrency_is_capped()
+    print("short-drama-edit self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/lib/drama/skills/short-drama-image-prompts/SKILL.md

@@ -20,6 +20,8 @@ license: MIT
 
 有当前视觉设定即可直接开始；剧本只在提示词需要确认剧情状态时读取。Look Development 是可选分支。
 先确认用途：身份板、造型/状态变体、地点板、道具板、组合 production sheet 或比较风格帧。
+分镜需要生产尾帧时，可把已接受的「收尾关键帧提示词」落实为独立 `IMG-...` 状态图条目：
+说明来源 SHOT 与终点，沿用视觉事实和参考范围，不重新设计动作。实际生成以该 IMG 条目为来源。
 
 创作者可读说明跟随项目语言；可复制正文跟随 `short-drama.json#/format/prompt_language`。没有
 `short-drama.json` 时正文默认

package/lib/drama/skills/short-drama-image-prompts/assets/image-prompts.md

@@ -2,6 +2,11 @@
 
 此文件由已接受规格生成。元信息用于核对来源；只复制引用块内的通用提示词。不要手写供应商参数。
 
+**这份模板属于结构化管线**（`image-prompt-specs.jsonl` 一路）。creator-first 项目的《图片提示词.md》骨架以 `SKILL.md` 为准：`## IMG-... · 中文名`，字段写成不加粗的
+`- 参考：`（取「无外部参考」或完整 `REF-...` 语法），正文标题是 `### 可复制提示词`。
+不要把这里的加粗字段名、`参考图用途`、`本次呈现` 或 `### 可复制通用提示词` 搬进 creator-first 文档——
+`creator_markdown_check.py` 按 `SKILL.md` 的骨架校验，照本模板写会被判「缺少参考字段」。
+
 ```markdown
 # EP<编号> · 资产图片提示词
 

package/lib/drama/skills/short-drama-image-prompts/assets/lookdev-prompts.md

@@ -4,6 +4,9 @@
 只复制引用块内的自然语言提示词；本文件不触发图片或媒体服务，实际生产交
 `$short-drama-produce` 并单独确认。
 
+**这是项目级文件，不是某一集的创作文档。** 它不参与 `creator_markdown_check.py` 的
+五文档校验；某一集要用的资产提示词写进该集的《图片提示词.md》，骨架以 `SKILL.md` 为准。
+
 ```markdown
 # 项目 Look Development 提示词
 

package/lib/drama/skills/short-drama-image-prompts/references/common-recipe.md

@@ -203,6 +203,17 @@
 - **`taste_option`**：写实度、媒介、颗粒、色调和镜头感由视觉风格或创作者决定。
 - 禁止用固定词表或形容词比例阻断交付；描述是否空泛，由审查者指出具体缺了什么。
 
+### 光学与表面描述
+
+**`craft_default`**：对需要明确透视或写实质感的画面，写明机位、取景距离和可见表面特征。
+焦段可辅助表达，但不能据此承诺模型会精确模拟光学。
+
+根据画面尺度选择毛孔、布料折痕或金属使用痕迹；「干净」不必等同于没有任何纹理和折痕。
+不要给每张图添加相同的相机参数、瑕疵清单或排除词。
+
+**`taste_option`**：表面是否平滑、是否修饰，以及写实程度由已接受的视觉风格决定。
+结果用对照图检查；像素纹理指标只作辅助，不能代替人物与材质的视觉判断。
+
 ## 5. 输出、常见问题与检查
 
 ### 输出

package/lib/drama/skills/short-drama-novel-analyze/references/aggregation-and-entities.md

@@ -69,13 +69,13 @@
 | 指标 | 参考值 | 算法 | 不达标怎么办 |
 |---|---|---|---|
 | 归属置信 | ≥ 0.85 | 有明确归属的情节点 / 单元内情节点总数 | 低于线的单元标「待复核」，不删 |
+| 覆盖率 | 85%–95% | 已归类情节点 / 总情节点数 | < 85% 走散落兜底；> 95% 复核是否过度归并 |
+| 重叠率 | ≤ 35% | 跨单元共享的情节点 / 总情节点数 | > 35% 说明两个单元其实是一个，考虑合并 |
 
 「有明确归属」指这条情节点服务于本单元的戏剧目标或对抗力量，而不只是恰好落在本单元的
 章节范围内。按连续章节切分时，若把「落在范围内」当作归属，这个比值恒等于 1，指标失去
 意义——所以逐条判的是**它推动的是不是这个单元的那件事**，跨单元共享的情节点计入重叠率
 而不计入本单元的分子。
-| 覆盖率 | 85%–95% | 已归类情节点 / 总情节点数 | < 85% 走散落兜底；> 95% 复核是否过度归并 |
-| 重叠率 | ≤ 35% | 跨单元共享的情节点 / 总情节点数 | > 35% 说明两个单元其实是一个，考虑合并 |
 
 **小体量素材的例外**：不足 30 章、单主线连续叙事的材料按时序切分时，覆盖率天然接近
 100%、散落接近 0，这是线性结构的正常结果，不是过度归并。此时复核的重点是

package/lib/drama/skills/short-drama-novel-analyze/references/chapter-extraction.md

@@ -103,9 +103,12 @@ P=$(grep -cE '^P[0-9]+ ' "$F")
 grep -cE '^P[0-9]+ [^|]+\|[^|]*[^|[:space:]][^|]*\|[^|]*涉及' "$F"   # 必须 == $P
 grep -cE '^P[0-9]+ .*\|.*\|.*\|[^|]*功能：' "$F"                     # 必须 == $P
 grep -hoE '^P[0-9]+ [^|]+' "$F" | awk '{print $2}' | sort -u        # 必须 ⊆ 类型表
-grep -cE '^\|[^|]*\|[^|]*\|' "$F"                                  # 必须 >= 2
+awk '/^## 载体记录/{f=1;next} /^## /{f=0} f&&/^\|/{n++} END{print n+0}' "$F"  # 必须 >= 3
 ```
 
+- 载体表计数少于 3：该章只写了表头没写内容。阈值是 3 不是 2，因为表头行与 `|---|` 分隔行
+  本身就占 2 行——按 2 计的话，一张空表照样过闸。**这一条也必须只数「载体记录」小节内的
+  表格行**：数全文的 `|` 行会把「出场人物」表算进来，同样让空载体表蒙混过关。
 - 白描段计数少于 `$P`：有情节点缺白描，或字段顺序、分隔符不对。
 - 功能段计数少于 `$P`：有情节点没回答改变了什么。注意全角冒号——半角会漏。
   这一条只数情节点行第四段里的 `功能：`：早先的写法数的是全文任何位置的这四个字符，