@dsh-gis/dsh-video-studio-skill 0.9.1 → 1.0.2

package/skills/video-studio/scripts/webengine.py

@@ -2160,10 +2160,15 @@ def _parse_frames(text: str) -> list:
 
 
 def _resolve_style_spec(text):
-    """解析 --style 的三种写法：内联 JSON / JSON 文件路径 / stylekit 风格 id。
+    """解析 --style 的**两种**写法：内联 JSON / JSON 文件路径。
 
     返回 normalize_style 能吃的 dict；空字符串返回 None（= 不注入，旧行为）。
     解析失败一律 SystemExit（CLI 场景，带可操作提示），不做静默回落。
+
+    v1.0.1：**不再接受"stylekit 风格 id"这种写法**。内置风格表已删除，
+    `--style magazine` 这种用法没有对象了。早先这里会调 ST.get()/ST.theme_of()，
+    而那两个函数现在只会抛 KeyError —— 与其让它抛一个"没有风格 X"的错，
+    不如直接把写法和替代方案说清楚。
     """
     s = str(text or "").strip()
     if not s:
@@ -2179,24 +2184,20 @@ def _resolve_style_spec(text):
             return json.loads(p.read_text(encoding="utf-8"))
         except json.JSONDecodeError as exc:
             raise SystemExit("[错误] --style 的 JSON 文件 %s 解析失败：%s" % (p, exc))
-    try:
-        import stylekit as ST
-    except Exception as exc:                # noqa: BLE001
-        raise SystemExit("[错误] --style %r 被当成风格 id，但 stylekit.py 不在同目录（%s）。"
-                         "要么用 --style work/style.json，要么把 stylekit.py 放在脚本旁边。"
-                         % (s, exc))
-    try:
-        pack = ST.get(s)
-    except KeyError as exc:
-        raise SystemExit("[错误] %s" % (exc.args[0] if exc.args else exc))
-    return {"style": s, "style_name": pack.get("name"), "legacy": ST.is_legacy(s),
-            "theme": ST.theme_of(s), "layout_default": (pack.get("layouts") or ("left-stack",))[0]}
+    raise SystemExit(
+        "[错误] --style %r 不是 JSON、也不是存在的文件——而**按内置风格 id 取外观这条路已经没有了**。\n"
+        "  v1.0.1 删除了全部内置风格/主题表（本技能不提供模板）。现在注入外观只有两种写法：\n"
+        "    ① --style '{\"theme\": {...}, \"canvas\": {...}}'        # 内联 JSON\n"
+        "    ② --style work/style.json                             # 由 render.py --stage style 落盘\n"
+        "  想生成一套新外观：python propose.py --brief \"题材\" --script film.json\n"
+        "  详细契约见 references/web-engine.md 的 __STYLE__ 段。" % (s,))
 
 
 def _add_style_args(p, *, fps=True):
     """给子命令加风格参数（缺省 = v0.7 旧行为：不注入、1920x1080）。"""
     p.add_argument("--style", default="",
-                   help="风格：stylekit 风格 id（如 magazine）/ work/style.json / 内联 JSON；缺省不注入")
+                   help="外观载荷：work/style.json / 内联 JSON；缺省不注入"
+                        "（v1.0.1 起不接受风格 id：内置风格表已删除）")
     p.add_argument("--width", type=int, default=W, help="画布宽（只收 16:9 横屏偶数，默认 %d）" % W)
     p.add_argument("--height", type=int, default=H, help="画布高（默认 %d）" % H)
     if fps:

package/tools/audio_similarity.py

@@ -9,8 +9,9 @@
 
 四组对照（阈值来自 skills/video-studio/references/audio-variation.md §5）：
 
-    A 跨片配乐（v0.7）：同风格/同 bpm/同调、只换内容指纹 -> 相关性（目标 <= 0.85）；
-                换风格 -> 相关性（目标 <= 0.52，且不能比改造前更接近）
+    A 跨片配乐（v1.0.1 起用 musicgen 参数化编排）：
+                同参数/同 bpm/同调、只换内容指纹 -> 相关性（目标 <= 0.85）；
+                换编排参数（mood + 音色） -> 相关性（目标 <= 0.52）
     B 跨片音效（v0.7）：同 cue 序列，legacy（不传 style/content_fp）必须逐样本相同；
                 不同 content_fp 必须不同（否则"跨片音效都一样"没被修掉）
     C 片内分离（v0.7）：duck 默认深度（目标 >= 3.5 dB）与配乐/音效的频谱质心对照
@@ -21,6 +22,7 @@
 from __future__ import annotations
 
 import argparse
+import hashlib
 import re
 import sys
 from pathlib import Path
@@ -32,12 +34,12 @@ SCRIPTS = HERE.parent / "skills" / "video-studio" / "scripts"
 sys.path.insert(0, str(SCRIPTS))
 
 # 契约 §5 的阈值（改契约时两边一起改）
-THRESH_A_SAME_STYLE_MAX = 0.85      # 同风格、只换内容指纹的相关性上限
-THRESH_A_CROSS_STYLE_MAX = 0.52     # 换风格的相关性上限（改造前 0.534）
-# 实测余量提示（v0.7.2）：本机稳定测到 0.514（连跑 3 次逐位相同），离阈值只剩 0.006。
-# 这个生成链是确定性的，所以换平台/换 numpy 若把 0.514 推到 0.52 以上，
-# 更可能是「风格差异化真的缩水了」而不是浮点噪声 —— 请先查 scorekit 的变奏参数，
-# 别第一反应去抬阈值（抬到 0.53 就离改造前 0.534 只剩 0.004，等于这条门禁白设）。
+THRESH_A_SAME_STYLE_MAX = 0.85      # 同参数、只换内容指纹的相关性上限
+THRESH_A_CROSS_STYLE_MAX = 0.52     # 换编排参数的相关性上限（v0.7 改造前的 0.534）
+# v1.0.1：配乐改由 musicgen 参数化编排（scorekit 的 9 套风格表已删除），这两条阈值
+# 仍是「跨片不能太像」的验收线：同参数换指纹要 <=0.85，换编排参数要 <=0.52。
+# 生成链是确定性的，换平台/换 numpy 若把实测值推过线，先查 musicgen 的参数有没有
+# 变成死旋钮，别第一反应去抬阈值。
 THRESH_C_DUCK_MIN = 3.5             # duck 默认深度下限（dB）
 THRESH_D_SNR_MIN = 12.0             # 人声段 旁白/背景 响度差下限（dB）
 
@@ -101,10 +103,35 @@ def _utf8_stdio():
             pass
 
 
-def _music(dur, style, fp):
-    import scorekit as SK
-    samples, _rep = SK.render_styled(dur, style=style, bpm=110, key="Dm",
-                                     mood="steady", seed=7, fingerprint=fp)
+def _music(dur, profile, fp):
+    """用参数化编排器现场生成一条配乐（v1.0.1：scorekit 的 9 套风格表已删除）。
+
+    profile 是「一套编排参数」，对应旧版的一个 style id —— 换成 mood + 音色 + 和弦进行：
+      * "steady"    -> 稳重：pad=saw / bass=sine / arp=pluck / lead=bell
+      * "magazine"  -> 换一套色调：triangle 铺底 + bell 琶音 + hopeful
+    fp 除了派生 seed，还决定**和弦进行走哪一档**（结构层）：旧版 scorekit 的指纹会换
+    进行档，这里用同一思路 —— 否则只换 seed 时两段配乐的相关性接近 1.0，A1 门禁
+    就成了「永远通过」的假门禁。
+    """
+    import musicgen as MG
+    # 指纹 -> 两个**互相独立**的派生量：seed（音色/细节）与进行档（结构）。
+    # 早先用同一个 8 位片段同时取模，content-a / content-b 正好撞在一起（seed 与档位
+    # 全同 -> corr 恒 1.0，A1 门禁变成永远通过）。分开取片段才是真的"同一内容同一首、
+    # 换内容不像同一首"。
+    digest = hashlib.sha1(str(fp or "").encode("utf-8")).hexdigest()
+    seed = 7 + (int(digest[:12], 16) % (2 ** 31 - 1))
+    prog_idx = int(digest[12:20], 16) % 2
+    voices = {"steady": {"pad": "saw", "bass": "sine", "arp": "pluck", "lead": "bell"},
+              "magazine": {"pad": "triangle", "bass": "sine", "arp": "bell", "lead": "pluck"}}[profile]
+    progressions = [
+        {"calm": ["i", "VI", "iv", "v"], "body": ["i", "VI", "III", "VII"],
+         "drive": ["i", "VII", "VI", "V"], "climax": ["i", "VII", "VI", "V"]},
+        {"calm": ["i", "iv", "VI", "i"], "body": ["i", "III", "VII", "VI"],
+         "drive": ["i", "VI", "VII", "V"], "climax": ["i", "VI", "VII", "V"]},
+    ][prog_idx]
+    samples, _rep = MG.render(float(dur), bpm=110.0, key="Dm", scale="minor",
+                              mood="steady" if profile == "steady" else "hopeful",
+                              seed=seed, voices=voices, progressions=progressions)
     return samples
 
 
@@ -120,7 +147,7 @@ def _cue_track(content_fp=None, style=None, key=None):
 
 
 def _voice_priority_snr(sr=48000, guard_snr_db=12.0):
-    """量"人声比背景响多少"：用真实 scorekit 配乐 + 类人声，按 st_audio 的默认参数混音。
+    """量"人声比背景响多少"：用真实 musicgen 配乐 + 类人声，按 st_audio 的默认参数混音。
 
     返回 (人声活跃区 SNR dB, 间隙背景 RMS, 人声处背景额外让位 dB)。
     口径与 `filmkit.voice_snr` 一致：只统计人声活跃区（含间隙会稀释问题）。
@@ -130,16 +157,16 @@ def _voice_priority_snr(sr=48000, guard_snr_db=12.0):
     """
     import filmkit as K
     import numpy as np
-    import scorekit as SK
+    import musicgen as MG
     n = int(6.0 * sr)
     t = np.arange(n) / float(sr)
     voice = np.zeros(n, dtype=np.float64)
     for a, b in ((0.2, 2.6), (3.4, 5.8)):        # 两段"说话"，中间留间隙
         i, j = int(a * sr), int(b * sr)
         voice[i:j] = 0.12 * np.sin(2 * np.pi * 220 * t[i:j])
-    # 真实配乐（scorekit 输出 RMS 约 0.15，比"类人声"响 —— 正是需要侧链/兜底的场景）
-    music, _ = SK.render_styled(6.0, style="tech-deep", bpm=110, key="Am",
-                                mood="steady", seed=7, fingerprint="d-group")
+    # 真实配乐（musicgen 输出峰值 -6 dBFS，比"类人声"响 —— 正是需要侧链/兜底的场景）
+    music, _ = MG.render(6.0, bpm=110.0, key="Am", scale="minor",
+                         mood="steady", seed=7)
     music = np.asarray(music, dtype=np.float32)
     out = K.mix_film(voice.astype(np.float32), music, None, total=6.0, fade=0.0,
                      music_gain_db=-12.0, voice_duck_db=6.0,
@@ -174,29 +201,29 @@ def main(argv=None):
     import sfxkit as SX
 
     print("=" * 72)
-    print("A. 跨片配乐（差异来源 = 风格 / bpm / 调 / 内容指纹 / seed）")
+    print("A. 跨片配乐（差异来源 = 编排参数 / bpm / 调 / 内容指纹 / seed）")
     print("=" * 72)
-    a1 = _music(args.dur, "tech-deep", "content-a")
-    a2 = _music(args.dur, "tech-deep", "content-b")
+    a1 = _music(args.dur, "steady", "content-a")
+    a2 = _music(args.dur, "steady", "content-b")
     a3 = _music(args.dur, "magazine", "content-a")
-    a4 = _music(args.dur, "tech-deep", "content-a")   # 同指纹复渲染，验证确定性
+    a4 = _music(args.dur, "steady", "content-a")   # 同指纹复渲染，验证确定性
     same_style = _corr(a1, a2)
     cross_style = _corr(a1, a3)
     rms_a1 = _rms(a1)
     print("  配乐非静音（RMS > -60 dBFS）    : %s  （rms=%.4f，静音时相关系数无定义）"
           % (rms_a1 > 0.001, rms_a1))
-    print("  同风格·同bpm·同调，只换内容指纹 : corr = %.3f  （目标 <= %.2f）"
+    print("  同参数·同bpm·同调，只换内容指纹 : corr = %.3f  （目标 <= %.2f）"
           % (same_style, THRESH_A_SAME_STYLE_MAX))
-    print("  换风格（tech-deep -> magazine） : corr = %.3f  （目标 <= %.2f）"
+    print("  换编排参数（steady -> magazine） : corr = %.3f  （目标 <= %.2f）"
           % (cross_style, THRESH_A_CROSS_STYLE_MAX))
     print("  同指纹两次渲染逐样本相同        : %s" % bool(np.array_equal(a1, a4)))
     if args.strict:
         # A0 是前置条件：若配乐渲染成静音/常量，A1/A2 的相关系数没有定义（NaN），
         # 必须显式判 FAIL，而不是让 NaN 比较悄悄变成 False 后只剩一句 corr=nan。
         _ok("A0 配乐非静音", rms_a1 > 0.001, "rms=%.4f" % rms_a1)
-        _ok("A1 同风格换指纹可区分", same_style <= THRESH_A_SAME_STYLE_MAX,
+        _ok("A1 同参数换指纹可区分", same_style <= THRESH_A_SAME_STYLE_MAX,
             "corr=%.3f" % same_style)
-        _ok("A2 换风格更不像", cross_style <= THRESH_A_CROSS_STYLE_MAX,
+        _ok("A2 换编排参数更不像", cross_style <= THRESH_A_CROSS_STYLE_MAX,
             "corr=%.3f" % cross_style)
         _ok("A3 配乐可复现", bool(np.array_equal(a1, a4)), "同指纹逐样本一致")
 
@@ -256,10 +283,10 @@ def main(argv=None):
     if args.out:
         out = Path(args.out)
         out.mkdir(parents=True, exist_ok=True)
-        from scorekit import save as music_save
-        music_save(out / "music_tech_deep_a.wav", a1)
-        music_save(out / "music_tech_deep_b.wav", a2)
-        music_save(out / "music_magazine.wav", a3)
+        import musicgen as MG
+        MG.save(out / "music_steady_a.wav", a1)
+        MG.save(out / "music_steady_b.wav", a2)
+        MG.save(out / "music_magazine.wav", a3)
         for t in ("whoosh", "riser", "impact"):
             SX.save(out / ("sfx_%s.wav" % t), SX.render(t, seed=1000))
         print("\n对照样本已写入: %s" % out)
@@ -276,4 +303,4 @@ def main(argv=None):
 
 
 if __name__ == "__main__":
-    raise SystemExit(main())
+    raise SystemExit(main())

package/tools/ci_check.py

@@ -59,7 +59,13 @@ LOCAL_MODULES = {"filmkit", "sfxkit", "scorekit", "webengine", "qa_frames", "ren
                  # v0.8.0：渲染前资源闸门、全片 VMAF/SSIM 门禁、ASR 回读门禁
                  "preflight", "qavmaf", "qaasr",
                  # v0.9.0：场景语法（内容 -> 构图选型）。纯标准库，可被 scenes.py 反向 import
-                 "grammar"}
+                 "grammar",
+                 # v1.0：设计 DSL / 离线预览 / 提案器（D3 改造的第一期）
+                 "designkit", "previewkit", "propose",
+                 # v1.0.1：presetkit 已删除（连同 presets/ 一起）；这里不能再列它，
+                 # 否则 ci_check 会去 import 一个不存在的模块
+                 # v1.0 / P2：参数化配乐编排器（替代 9 套 MUSIC_STYLES 表）
+                 "musicgen"}
 MAX_FILE_BYTES = 400 * 1024
 # 体积检查忽略的目录后缀：.team 是本地调研/自测工作区（gitignore），不随包发布；
 # 媒体文件本来就该大（样例片/参考视频），不该拿"能不能塞进上下文"的尺子量。

package/tools/estimate.py

@@ -50,9 +50,14 @@ WEB_SEC_PER_FRAME = (0.080, 0.130)  # web 引擎：Edge 无头 PNG 截图 80–1
 WEB_STARTUP_SEC = 6.0               # 浏览器冷启动 + CDP 连接（12 s 片 28–30 s 含启动）
 X264_FPS = 141.0                    # libx264 -preset medium -crf 17 ≈ 4.7× 实时（仅 reencode_video 用）
 TTS_SEC_PER_LINE = (2.0, 4.0)       # edge-tts：每句每 worker 的墙钟（联网，波动大）：实测 2.2 s，留到 4.0
-SCORE_REFS = ((29.0, 3.6, 6.5), (58.0, 4.5, 6.5), (389.0, 8.0, 18.0))
-#           ^ (片长 s, 耗时低, 耗时高)：前两个点是本机实测（29 s / 58 s 各 3 次），
-#             第三个点是片长外推锚点（不是本机实测），只用来保证长片不会被系统性算小
+# 配乐耗时锚点 (片长 s, 耗时低, 耗时高)。
+#
+# v1.0.1 换成 musicgen 实测值：30 s / 60 s / 120 s 分别 0.94 / 1.93 / 3.68 s（≈31× 实时），
+# 比 scorekit 时代快一个数量级。为什么现在敢改：以前配乐走 scorekit 的 9 套风格表，
+# 那个引擎要逐层展开事件并做多次 IIR，实测 29 s 片 3.6–6.5 s；现在的参数化编排器
+# 是单遍事件合成，实测抖动也小（同参数逐采样确定，耗时只随片长线性涨）。
+# 区间仍给 0.7–1.5 系数包络：CI 机器与共享 CPU 会慢，报小了会让人以为卡住。
+SCORE_REFS = ((29.0, 0.9, 1.6), (58.0, 1.8, 3.0), (389.0, 11.5, 19.0))
 SFX_SEC_PER_CUE = 0.20              # 单条短音效 合成+落位（24 配方单次 ≤1.5 s 是上限口径）
 SFX_MIN_SEC = 0.8                   # 实测 18 条 cue 的模板片 sfx 墙钟 0.8 s（含 ffmpeg 写盘）
 LAYOUT_BASE, LAYOUT_PER_LINE = 0.05, 0.01  # 排轴 + srt/ass + 安全区/字形自查（实测 29 s 片 <0.15 s）
@@ -81,7 +86,7 @@ CALIBRATION = dict(
              "（是否同一台未核实，只保证这些数字是在上述 24 逻辑核机器上测的）"),
     measured_at="2026-11-10",
     sdk="video-studio v0.7.1 scripts（ffmpeg 自带 x264）",
-    film="29.011 s / 870 帧 / 模板片（assets/film.json + assets/scenes.py）",
+    film="29.011 s / 870 帧 / 测试样片（assets/film.json + assets/scenes.py，仅用于基准校准）",
     method="render.py --stage all --jobs 2，逐 stage 取 [time] 行墙钟；同片重复 2 次",
     observed=dict(tts=2.2, layout=0.0, cues=0.0, score=6.3, sfx=0.8, audio=0.7,
                   frames=9.7, mux=1.9, qa=6.8, total=28.4),
@@ -152,8 +157,9 @@ def load_script(path, as_json=False):
     """读剧本；坏输入给一句话错误（退出码 2），不甩 traceback。"""
     p = Path(path).expanduser()
     if not p.exists():
-        _die("找不到剧本 %s（--script 指到 film.json；模板在 skills/video-studio/assets/film.json）"
-             % p, as_json)
+        _die("找不到剧本 %s（--script 指向你自己的 film.json；"
+             "仓库里只有一个用于测试的样例 skills/video-studio/assets/film.json，"
+             "它不是要抄的模板）" % p, as_json)
     try:
         raw = p.read_text(encoding="utf-8")
     except OSError as e:
@@ -479,7 +485,7 @@ def build_report(script_path, script, args):
     n_cues = len(sfx_cfg.get("cues") or [])
     sfx_on = bool(sfx_cfg.get("enabled", True)) and n_cues > 0
     # 配乐口径对齐 filmkit.music_plan：mode=off/none 或 enabled=false 才算关；
-    # 只有 mode=score（或没写 mode 但写了 bpm）才会真跑 scorekit。
+    # 只有 mode=score（或没写 mode 但写了 bpm）才会真跑配乐引擎（musicgen）。
     mode = str(mus.get("mode") or "").strip().lower()
     has_bpm = "bpm" in mus or "bpm" in script
     music_on = bool(mus.get("enabled", True)) and mode not in ("off", "none")
@@ -570,7 +576,7 @@ def build_report(script_path, script, args):
         dict(stage="score", lo=score_lo, hi=score_hi, measured=bool(score_on),
              note=("以实测点 29 s≈3.6–6.3 s / 58 s≈4.5–5.0 s 为锚（--stage all 里与其它阶段争 CPU 会更慢；389 s 只是外推锚点）"
                    if score_on else
-                   ("mode=%s：不跑 scorekit（%s）"
+                   ("mode=%s：不跑配乐引擎（%s）"
                     % (mode or "-", "外部配乐/和弦床/关掉配乐")))),
         dict(stage="sfx", lo=sfx_lo, hi=sfx_hi, measured=False,
              note=("%d 条音效（实测 18 条 0.8 s；单条上限口径 ≤1.5 s，长环境声 wind/rain 另计）"

package/tools/golden_frames.py

@@ -69,6 +69,11 @@ SCRIPTS = os.path.join(SKILL, "scripts")
 ASSETS = os.path.join(SKILL, "assets")
 
 DEFAULT_SCRIPT = os.path.join(ASSETS, "film.json")
+# v1.0 / D3：金帧基线绑"固定 fixture 设计"而不是内置风格。
+# 为什么：金帧要守的是"同一份设计 + 同一份场景代码，像素不许漂"，
+# 不是"某套内置风格长什么样"——后者会随风格表下沉到 presets 而失去意义。
+# 没有这个文件时回落到老口径（读 film.json 的 style），不阻塞老项目。
+DEFAULT_DESIGN = os.path.join(ASSETS, "design_fixture.json")
 DEFAULT_SCENES = os.path.join(ASSETS, "scenes.py")
 DEFAULT_GOLDEN = os.path.join(ASSETS, "golden_frames.json")
 
@@ -216,11 +221,39 @@ def build_timeline(K, script):
     return tl
 
 
-def resolve_plan(ST, script):
-    """解析风格计划并挂到 script["_style"]（与 render.resolve_style 同口径，含 theme_overrides）。
+def _design_plan(design_path):
+    """读 fixture 设计并转成计划；读不到返回 None（回落到 stylekit 老口径）。"""
+    if not design_path or not os.path.exists(str(design_path)):
+        return None
+    try:
+        with open(design_path, encoding="utf-8") as fh:
+            design = json.load(fh)
+    except (OSError, json.JSONDecodeError) as e:
+        raise RuntimeError("fixture 设计读不出来（%s）：%s" % (design_path, e)) from e
+    sys.path.insert(0, SCRIPTS)
+    import designkit as DK
+    bad = DK.validate_design(design)
+    if bad:
+        raise RuntimeError("fixture 设计没过校验（%s）：%s" % (design_path, "；".join(bad)))
+    return DK.design_to_plan(design)
+
+
+def resolve_plan(ST, script, design_path=None):
+    """解析计划并挂到 script["_style"]。
+
+    v1.0 / D3 起优先用 **fixture 设计**（design_path，默认 assets/design_fixture.json）：
+    金帧守的是"固定设计 + 固定场景代码 -> 像素不漂"，与"哪套内置风格"无关。
+    没有 fixture 时回落到 stylekit 老口径，不阻塞老项目。
 
     主题体检失败在这里就抛错（不要等渲到第 3 帧才炸）。
     """
+    plan = _design_plan(design_path)
+    if plan is not None:
+        script["_style"] = plan
+        bad = ST.theme_lint(plan.get("theme") or {})
+        if bad:
+            raise RuntimeError("fixture 设计主题体检失败：%s" % "；".join(bad))
+        return plan
     plan = ST.resolve_script_style(script)
     bad = ST.theme_lint(plan.get("theme") or ST.THEMES[plan["theme_id"]])
     if bad:
@@ -384,7 +417,7 @@ def default_frame_specs(tl):
 
 
 # ---------------------------------------------------------------- 基线读写
-def _golden_payload(script_path, scenes_path, K, plan, tl, rendered):
+def _golden_payload(script_path, scenes_path, K, plan, tl, rendered, design_path=None):
     font_fp, fonts = font_fingerprint(K, plan)
     env_fp, env = env_fingerprint()
     return {
@@ -398,6 +431,7 @@ def _golden_payload(script_path, scenes_path, K, plan, tl, rendered):
         "fps": int(tl["fps"]),
         "script": _rel(script_path),
         "scenes": _rel(scenes_path),
+        "design": _rel(design_path) if design_path else "",
         "font_fp": font_fp,
         "fonts": fonts,
         "env_fp": env_fp,
@@ -407,6 +441,9 @@ def _golden_payload(script_path, scenes_path, K, plan, tl, rendered):
             "scenes_sha1": _sha1_file(scenes_path),
             "filmkit_sha1": _sha1_file(os.path.join(SCRIPTS, "filmkit.py")),
             "stylekit_sha1": _sha1_file(os.path.join(SCRIPTS, "stylekit.py")),
+            # 设计 fixture 进指纹：改了基准设计却不重录基线 = "改了但基线不报警"
+            "design_sha1": _sha1_file(design_path) if design_path else "",
+            "designkit_sha1": _sha1_file(os.path.join(SCRIPTS, "designkit.py")),
             "golden_tool_sha1": _sha1_file(os.path.abspath(__file__)),
         },
         "frames": [dict(sp, sha256=sha, scene=scene_id, frame=int(f))
@@ -414,13 +451,13 @@ def _golden_payload(script_path, scenes_path, K, plan, tl, rendered):
     }
 
 
-def write_golden(script_path, scenes_path, golden_path, frames=None):
+def write_golden(script_path, scenes_path, golden_path, frames=None, design_path=None):
     """--write：渲染金帧并写基线。返回 result（status=pass，written=True）。"""
     K, ST = _modules()
     script = _load_script(script_path)
     scenes_mod = _load_scenes(scenes_path)
     tl = build_timeline(K, script)
-    plan = resolve_plan(ST, script)
+    plan = resolve_plan(ST, script, design_path=design_path)
     if frames:
         specs = [dict(frame=int(f), scene=str(_scene_at(tl, int(f) / float(tl["fps"]))[0]
                                        .get("id") or ""),
@@ -432,7 +469,8 @@ def write_golden(script_path, scenes_path, golden_path, frames=None):
         specs = default_frame_specs(tl)
     rendered = render_frames(script, scenes_mod, plan, tl, [sp["frame"] for sp in specs])
     plan = dict(plan, specs=specs)
-    data = _golden_payload(script_path, scenes_path, K, plan, tl, rendered)
+    data = _golden_payload(script_path, scenes_path, K, plan, tl, rendered,
+                           design_path=design_path)
     golden_path = os.path.abspath(str(golden_path))
     d = os.path.dirname(golden_path)
     if d:
@@ -475,7 +513,7 @@ def _fmt_fp_pair(actual, expect):
     return "%s… vs %s…" % (str(actual)[:12], str(expect)[:12])
 
 
-def check_golden(script_path, scenes_path, golden_path):
+def check_golden(script_path, scenes_path, golden_path, design_path=None):
     """--check：渲染基线里的帧号并与基线比对（默认命令）。"""
     golden, why = _load_golden(golden_path)
     if golden is None:
@@ -498,7 +536,7 @@ def check_golden(script_path, scenes_path, golden_path):
         script = _load_script(script_path)
         scenes_mod = _load_scenes(scenes_path)
         tl = build_timeline(K, script)
-        plan = resolve_plan(ST, script)
+        plan = resolve_plan(ST, script, design_path=design_path)
         font_fp, fonts = font_fingerprint(K, plan)
         env_fp, env = env_fingerprint()
         # 先做"能不能比"的判定，再渲（省得换机时白渲三帧）
@@ -551,7 +589,9 @@ def check_golden(script_path, scenes_path, golden_path):
     cur_inputs = dict(script_sha1=_sha1_file(script_path),
                       scenes_sha1=_sha1_file(scenes_path),
                       filmkit_sha1=_sha1_file(os.path.join(SCRIPTS, "filmkit.py")),
-                      stylekit_sha1=_sha1_file(os.path.join(SCRIPTS, "stylekit.py")))
+                      stylekit_sha1=_sha1_file(os.path.join(SCRIPTS, "stylekit.py")),
+                      design_sha1=(_sha1_file(design_path) if design_path else ""),
+                      designkit_sha1=_sha1_file(os.path.join(SCRIPTS, "designkit.py")))
     stale = [k for k, v in cur_inputs.items()
              if inputs.get(k) and inputs.get(k) != v]
     if changed:
@@ -608,6 +648,9 @@ def main(argv=None):
     g.add_argument("--check", action="store_true", help="校验（默认）")
     g.add_argument("--write", action="store_true", help="生成/更新基线")
     ap.add_argument("--script", default=DEFAULT_SCRIPT, help="film.json（默认模板片）")
+    ap.add_argument("--design", default=DEFAULT_DESIGN,
+                    help="固定 fixture 设计（默认 assets/design_fixture.json）；"
+                         "传空串回落到老的 stylekit 口径")
     ap.add_argument("--scenes", default=DEFAULT_SCENES, help="scenes.py（默认模板场景）")
     ap.add_argument("--golden", default=DEFAULT_GOLDEN,
                     help="基线 JSON（默认 skills/video-studio/assets/golden_frames.json）")
@@ -627,12 +670,14 @@ def main(argv=None):
                     raise SystemExit("--frames 必须是逗号分隔的整数帧号，收到 %r" % a.frames)
                 if not frames:
                     raise SystemExit("--frames 里没有有效帧号")
-            res = write_golden(a.script, a.scenes, a.golden, frames)
+            res = write_golden(a.script, a.scenes, a.golden, frames,
+                       design_path=(a.design or None))
         else:
             if a.frames:
                 raise SystemExit("--frames 只用于 --write；--check 的帧号由基线决定"
                                  "（要换帧号请 --write --frames ... 重录）")
-            res = check_golden(a.script, a.scenes, a.golden)
+            res = check_golden(a.script, a.scenes, a.golden,
+                       design_path=(a.design or None))
     except SystemExit:
         raise
     except Exception as e:                                  # noqa: BLE001