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

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

@@ -1407,6 +1407,211 @@ def t_golden_frames():
         status or "-", p.returncode, (d.get("reason") or "")[:120])
 
 
+# ============================================================================
+# v0.9：场景语法 + 视觉语言
+# ============================================================================
+
+def _load_grammar():
+    """加载 grammar.py（纯标准库）。找不到返回 None —— CI 里可能只拷了 scripts/ 的一部分。"""
+    try:
+        import grammar
+        return grammar
+    except Exception:                                       # noqa: BLE001
+        cand = os.path.join(HERE, "grammar.py")
+        if not os.path.exists(cand):
+            return None
+        import importlib.util
+        spec = importlib.util.spec_from_file_location("sc_grammar", cand)
+        mod = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(mod)
+        return mod
+
+
+def _fake_scenes(G, lines, per=6.0):
+    """按固定时长造 timeline 段（不跑 TTS），只用来测选型。"""
+    scenes, t = [], 0.0
+    for ln in lines:
+        row = dict(ln, start=round(t, 3), end=round(t + per, 3), dur=round(per, 3))
+        scenes.append(row)
+        t += per
+    return scenes
+
+
+def t_scene_grammar():
+    """52 场景语法：10 类都能被选中、选型确定、段长门会降级。
+
+    为什么要有这条：v0.9 之前 quote/emphasis/calm 三种 kind 全部落到 body 绘制器，
+    画面永远只有一套骨架。这条断言盯的是"内容 -> 构图"这条链路真的在分流，
+    而不是"代码里写了 10 个函数但没人调用"。
+    """
+    G = _load_grammar()
+    if G is None:
+        return "skip（没有 grammar.py）"
+    lines = [
+        {"id": "a", "kind": "hook", "chapter": "01", "text": "开场一句。", "big": "开场"},
+        {"id": "b", "kind": "body", "chapter": "02", "text": "我们每天被打断 47 次。", "big": "47 次"},
+        {"id": "c", "kind": "body", "chapter": "02", "text": "对比一下：深度工作四小时，产出是碎片时间的三倍。",
+         "big": "四小时 vs 碎片", "items": [{"text": "深度工作"}, {"text": "碎片时间"}]},
+        {"id": "d", "kind": "body", "chapter": "03", "text": "第一步清空收件箱，然后关掉通知，接着单线程，最后复盘。",
+         "big": "四步", "items": [{"text": "清空"}, {"text": "关通知"}, {"text": "单线程"}, {"text": "复盘"}]},
+        {"id": "e", "kind": "quote", "chapter": "03", "text": "他说：「深度工作稀缺。」", "quote": "深度工作稀缺"},
+        {"id": "f", "kind": "body", "chapter": "04", "text": "各行业占比差异明显。", "big": "各行业占比",
+         "items": [{"text": "A 62%"}, {"text": "B 51%"}, {"text": "C 38%"}]},
+        {"id": "g", "kind": "body", "chapter": "05", "text": "注意力是换来的。", "big": "注意力是换来的"},
+        {"id": "h", "kind": "body", "chapter": "06", "text": "第五章开始了。", "big": "第五章"},
+        {"id": "i", "kind": "body", "chapter": "06", "text": "这里有五条要点要讲清楚。", "big": "五条要点",
+         "items": [{"text": "一"}, {"text": "二"}, {"text": "三"}, {"text": "四"}, {"text": "五"}]},
+        {"id": "j", "kind": "outro", "chapter": "99", "text": "开始就好。", "big": "开始就好"},
+    ]
+    scenes = _fake_scenes(G, lines)
+    plan = {"chapter_layout": {}, "layout_default": "left-stack", "style": "tech-deep"}
+    sb1 = G.plan_scenes([dict(s) for s in scenes], {"title": "t"}, plan)
+    got = [r["type"] for r in sb1["scenes"]]
+    # ① 确定性：同一份输入两次结果完全一致（含变体号与理由）
+    sb2 = G.plan_scenes([dict(s) for s in scenes], {"title": "t"}, plan)
+    assert [r["type"] for r in sb2["scenes"]] == got, "同一份稿子两次选型不同（不确定性）"
+    assert [r["variant"] for r in sb2["scenes"]] == [r["variant"] for r in sb1["scenes"]], \
+        "同一份稿子两次变体不同（不确定性）"
+    # ② 分流：至少命中 5 种不同类型（不是全退化成 list/statement）
+    assert len(set(got)) >= 5, "10 段只分出 %d 种构图（%r）：选型逻辑没在分流" % (len(set(got)), got)
+    assert "stat" in got and "compare" in got and "quote" in got, \
+        "数字/对比/引语三种特征没有各自分流：%r" % (got,)
+    # ③ 段长门：把 chart 塞进 2 秒段必须降级，且理由里写明
+    short = [{"id": "x", "kind": "body", "chapter": "01", "text": "短。", "big": "短",
+              "type": "chart", "series": [{"label": "A", "value": 1}]}]
+    sb3 = G.plan_scenes([dict(s) for s in _fake_scenes(G, short, per=2.0)],
+                        {"title": "t"}, plan)
+    r3 = sb3["scenes"][0]
+    assert r3["type"] != "chart", "2 秒的段仍选了 chart（段长门失效）"
+    assert any("降级" in x or "排除" in x for x in r3["reason"]), \
+        "降级没有留下理由：%r" % (r3["reason"],)
+    # ④ 显式 type 优先
+    ex = [{"id": "y", "kind": "body", "chapter": "01", "text": "随便一句", "big": "随便",
+           "type": "hero"}]
+    sb4 = G.plan_scenes([dict(s) for s in _fake_scenes(G, ex)], {"title": "t"}, plan)
+    assert sb4["scenes"][0]["type"] == "hero", "显式 type=hero 没生效：%r" % (sb4["scenes"][0],)
+    return "10 段 -> %d 种构图；降级 chart->%s；显式 type 生效" % (len(set(got)), r3["type"])
+
+
+def t_visual_languages():
+    """53 视觉语言包：8 套结构签名齐全、过体检、且彼此不是同一套。
+
+    为什么要有这条：v0.5 的"风格"只改配色，8 套风格骨架完全一样（用户抱怨的根因）。
+    这条盯的是"结构签名真的存在且互不相同"——母题/转场/重心偏移任一维度相同不算问题，
+    但**五组签名全同**就说明这套语言只是复制粘贴。
+    """
+    import stylekit as ST
+    if not hasattr(ST, "VISUAL_LANGUAGES"):
+        return "skip（stylekit 没有 VISUAL_LANGUAGES）"
+    bad = ST.visual_lint_all()
+    assert not bad, "内置视觉语言没过体检: %s" % bad
+    sigs = {}
+    for sid in ST.STYLE_IDS:
+        vl = ST.VISUAL_LANGUAGES[sid]
+        key = (str((vl.get("motif") or {}).get("kind")),
+               str((vl.get("transition") or {}).get("kind")),
+               tuple(sorted((vl.get("bias") or {}).items())))
+        assert vl.get("motion") and vl.get("typography"), "%s 缺 motion/typography 签名" % sid
+        sigs.setdefault(key, []).append(sid)
+    dup = [v for v in sigs.values() if len(v) > 1]
+    assert not dup, "这些风格的母题/转场/重心完全相同（等于没做结构差异）: %s" % (dup,)
+    motifs = {str((ST.VISUAL_LANGUAGES[s].get("motif") or {}).get("kind")) for s in ST.STYLE_IDS}
+    assert len(motifs) >= 6, "8 套风格只用了 %d 种装饰母题：%r" % (len(motifs), sorted(motifs))
+    return "8 套 / %d 种母题 / %d 种转场 / 无重复签名" % (
+        len(motifs),
+        len({str((ST.VISUAL_LANGUAGES[s].get("transition") or {}).get("kind"))
+             for s in ST.STYLE_IDS}))
+
+
+def t_scene_types_single_truth():
+    """54 场景类型只有一份"真值集合"：4 处定义必须集合相等（顺序可以不同）。
+
+    为什么比集合不比顺序：grammar.SCENE_TYPES 的顺序是"平手取位顺序"，改它会改变同一份
+    稿子的选型结果，所以它有独立语义；filmcheck/schema/scenes 只关心"有哪些类型"。
+    顺序不同是设计，集合不同是 bug（写错一个字母 = 某个类型永远画不出来）。
+    """
+    G = _load_grammar()
+    if G is None:
+        return "skip（没有 grammar.py）"
+    here_scripts = HERE
+    got = {"grammar": set(G.SCENE_TYPES)}
+    # filmcheck.SCENE_TYPES
+    try:
+        import filmcheck as FC
+        got["filmcheck"] = set(FC.SCENE_TYPES)
+    except Exception:                                       # noqa: BLE001
+        pass
+    # assets/scenes.py 的 _DRAWERS 键
+    mod = _load_scenes_mod()
+    if mod is not None and hasattr(mod, "_DRAWERS"):
+        got["scenes"] = set(mod._DRAWERS.keys())
+    # schema 的 enum
+    schema = os.path.join(os.path.dirname(os.path.dirname(here_scripts)),
+                          "..", "..", "schemas", "film.schema.json")
+    schema = os.path.normpath(schema)
+    if os.path.exists(schema):
+        try:
+            data = json.load(open(schema, encoding="utf-8"))
+            enum = (data["properties"]["lines"]["items"]["properties"]["type"]["enum"])
+            got["schema"] = set(enum)
+        except Exception:                                   # noqa: BLE001
+            pass
+    if len(got) < 3:
+        return "skip（只找到 %d 处真值：%s）" % (len(got), sorted(got))
+    base_name, base = sorted(got.items())[0]
+    for name, s in got.items():
+        if s != base:
+            raise AssertionError("场景类型集合不一致：%s 与 %s 差 %r / %r"
+                                 % (name, base_name, sorted(s - base), sorted(base - s)))
+    return "%d 处真值集合一致（%d 类）：%s" % (len(got), len(base), "/".join(sorted(got)))
+
+
+def t_silhouette_gate():
+    """55 剪影可区分（G13）：8 套风格两两之间构图骨架必须能区分。
+
+    这是 v0.9 的核心验收：如果这条挂了，说明"换风格只是换色"的毛病回来了。
+    工具在 tools/silhouette_qa.py（可选）：缺了 skip，不阻塞 CI。
+    """
+    root = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
+    tool = os.path.join(root, "tools", "silhouette_qa.py")
+    if not os.path.exists(tool):
+        return "skip（没有 tools/silhouette_qa.py）"
+    p = subprocess.run([sys.executable, tool, "--json"],
+                       capture_output=True, text=True, encoding="utf-8", errors="replace",
+                       cwd=root)
+    out = (p.stdout or "").strip()
+    i = out.find("{")
+    if i < 0:
+        return "skip（silhouette_qa 没输出 JSON：%s）" % ((p.stderr or out) or "")[:120]
+    try:
+        d = json.loads(out[i:])
+    except json.JSONDecodeError as e:
+        return "skip（silhouette_qa JSON 解析失败：%s）" % e
+    pairs = d.get("pairs") or []
+    # 三档语义与工具对齐：status 只有 pass / fail / skip 三种。
+    # 只认 returncode 会把"工具没渲出帧"（skip）也记成 PASS —— 那正是本仓库反复踩的坑。
+    failed = [x for x in pairs if str(x.get("status")) == "fail"]
+    skipped = [x for x in pairs if str(x.get("status")) == "skip"]
+    if p.returncode != 0 or failed:
+        names = ["%s×%s" % (x.get("a"), x.get("b")) for x in failed[:4]]
+        raise AssertionError("剪影不可区分：%d/%d 对失败（%s）；换风格仍只是换色"
+                             % (len(failed), len(pairs), ", ".join(names)))
+    if skipped:
+        return "skip（%d/%d 对没渲出来：%s）" % (
+            len(skipped), len(pairs),
+            ", ".join("%s×%s" % (x.get("a"), x.get("b")) for x in skipped[:3]))
+    # 同明暗族是"保守下界"：跨族很多时候靠 ΔB（背景亮度差）就能过，那不是构图证据。
+    # 所以这条断言在报告里必须把同族数字单独说出来，别让 28/28 被读成"8 套风格结构全不同"。
+    same = ((d.get("summary") or {}).get("by_family") or {}).get("same") or {}
+    same_n = same.get("pairs")
+    same_ok = same.get("pass")
+    if same_n and same_ok is not None and int(same_ok) < int(same_n):
+        raise AssertionError("同明暗族只有 %s/%s 对可区分（保守下界不达标）"
+                             % (same_ok, same_n))
+    return "%d 对全部可区分（同明暗族 %s/%s，保守下界也过）" % (
+        len(pairs), same_ok if same_ok is not None else "?", same_n if same_n else "?")
+
+
 CASES = [
     ("1  TTS 缓存校验文本", t_cache_key),
     ("2  sub_window 覆盖长句", t_sub_window),
@@ -1459,6 +1664,10 @@ CASES = [
     ("49 TTS 后端可替换（接口契约）", t_tts_backend),
     ("50 web 风格载荷（legacy 必须回落）", t_web_style_payload),
     ("51 金帧回归（像素基线）", t_golden_frames),
+    ("52 场景语法（10 类分流/确定/段长门）", t_scene_grammar),
+    ("53 视觉语言包（结构签名互不相同）", t_visual_languages),
+    ("54 场景类型单真值（4 处集合一致）", t_scene_types_single_truth),
+    ("55 剪影可区分（G13：换风格不能只是换色）", t_silhouette_gate),
 ]
 
 

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

@@ -531,6 +531,205 @@ STYLES[LEGACY_STYLE] = {
     "pacing": {"lead": 0.55, "tail": 0.85, "min_dur": 3.0, "hold": 0.0},
 }
 
+# ============================================================================
+# 四、视觉语言包（VISUAL_LANGUAGES）：v0.9
+# ============================================================================
+#
+# 为什么还要一层
+# -------------
+# v0.5 的 THEMES 只管"皮肤"：配色、字体族、纹理、颗粒、字距、缓动、HUD、3 种版式几何。
+# 8 套风格共用同一批版式与同一套装饰（开场放射线 + 收尾光点环），所以换风格只是换色，
+# 构图骨架（剪影）没变 —— 这正是"每个视频都差不多"的根因。
+#
+# 这一层补的是**结构签名**，四组：
+#   motion     入场怎么进、镜头怎么推、呼吸元素多快
+#   motif      这套风格独有的装饰图形语言（直角括角 / 手绘内框 / letterbox / 信号条 …）
+#   transition 段与段之间怎么过（dip / wash / 纸卷 / 斜擦 / 硬切 / 放射环）
+#   typography 字距、行高、对齐、编号写法、display:body 字号比
+#
+# 设计原则（与 THEMES 一致）
+#   1. 纯数据：不 import PIL / filmkit，scenes.py 反过来读我，成环就炸。
+#   2. 只追加不改顺序：新风格往 STYLE_IDS 末尾追加，老风格的指纹映射不漂。
+#   3. 每条签名都必须"能被剪影看出差别"：只改颜色/字重的项不算签名。
+#   4. 全部受 PIL 预算约束：装饰要么预烘焙成静态层，要么是 O(几) 次 ImageDraw 调用；
+#      禁每帧全屏 GaussianBlur（实测 30–60ms）与全屏双线性 resize（29ms），预算 25ms。
+#
+# 剪影判据（tools/silhouette_qa.py 用的口径，也是 P1 的验收标准）
+#   同一段内容在两种风格下渲 3 帧 → 灰度 → 以四角亮度中位数为基准三值化 →
+#   比较 前景占比 F / 前景质心 (Cx,Cy) / 四边覆盖率 B / 左右对称度 S。
+#   五项里至少一项达标才算"这套风格真的不一样"：
+#     ΔF ≥ 6pp、|ΔCx| ≥ 8pp、|ΔCy| ≥ 8pp、ΔB ≥ 14pp、ΔS ≥ 0.20
+
+VISUAL_MOTIFS = ("brackets", "hairlines", "handdrawn", "slabs",
+                 "minimal", "letterbox", "signal", "rays")
+VISUAL_TRANSITIONS = ("dip", "wash", "paper", "wipe", "cut", "iris")
+NUMBER_STYLES = ("dim", "serif", "cn", "block", "roman", "timecode", "dot", "gilt")
+
+VISUAL_LANGUAGES = {}
+
+VISUAL_LANGUAGES["tech-deep"] = {
+    "motion": {"ease": "out3", "enter": (0.45, 0.85), "push": 0.04, "breathe_hz": 0.85},
+    "motif": {"kind": "brackets", "density": 1.0,
+              "detail": {"corner": 24, "rule_step": 120, "scan": True}},
+    "transition": {"kind": "dip", "dur": 0.28},
+    "typography": {"tracking": 0.0, "line_gap": 1.30, "align": "left",
+                   "number": "dim", "ratio": 1.50},
+    "bias": {"x": 0, "y": 0, "inset": 0},
+    "layout_cycle": ("left-stack", "split-right", "center-stack"),
+}
+
+VISUAL_LANGUAGES["magazine"] = {
+    "motion": {"ease": "out5", "enter": (0.60, 1.10), "push": 0.001, "breathe_hz": 0.50},
+    "motif": {"kind": "hairlines", "density": 0.85,
+              "detail": {"header_rule": True, "column_rule": True, "pageno": True}},
+    "transition": {"kind": "wash", "dur": 0.35},
+    "typography": {"tracking": 2.0, "line_gap": 1.34, "align": "right",
+                   "number": "serif", "ratio": 1.53},
+    "bias": {"x": 60, "y": -20, "inset": 0},
+    "layout_cycle": ("split-right", "left-stack", "center-stack"),
+}
+
+VISUAL_LANGUAGES["paper"] = {
+    "motion": {"ease": "inOut3", "enter": (0.55, 1.00), "push": 0.03, "breathe_hz": 0.42},
+    "motif": {"kind": "handdrawn", "density": 1.0,
+              "detail": {"wobble": 3.0, "seal": True, "tape": True}},
+    "transition": {"kind": "paper", "dur": 0.35},
+    "typography": {"tracking": 1.0, "line_gap": 1.36, "align": "left",
+                   "number": "cn", "ratio": 1.53},
+    # 重心偏移（px）：paper 是"手账"气质——内容整体压在左下、右侧留出大片空白给框与胶带；
+    # 这不是配色能表达的差异，是构图差异（剪影 Cx/Cy 直接反映它）。
+    "bias": {"x": -150, "y": 80, "inset": 40},
+    "layout_cycle": ("left-stack", "center-stack", "split-right"),
+}
+
+VISUAL_LANGUAGES["vivid"] = {
+    "motion": {"ease": "outBack", "enter": (0.35, 0.70), "push": 0.10, "breathe_hz": 1.10},
+    "motif": {"kind": "slabs", "density": 1.0,
+              "detail": {"bar_h": 24, "slant": 18, "sticker": True}},
+    "transition": {"kind": "wipe", "dur": 0.20},
+    "typography": {"tracking": 1.0, "line_gap": 1.26, "align": "center",
+                   "number": "block", "ratio": 2.97},
+    "bias": {"x": 0, "y": 40, "inset": 0},
+    "layout_cycle": ("center-stack", "left-stack", "split-right"),
+}
+
+VISUAL_LANGUAGES["mono"] = {
+    "motion": {"ease": "inOut3", "enter": (0.50, 0.90), "push": 0.02, "breathe_hz": 0.35},
+    "motif": {"kind": "minimal", "density": 0.55,
+              "detail": {"rule_h": 2, "box_radius": 0}},
+    "transition": {"kind": "cut", "dur": 0.0},
+    "typography": {"tracking": 6.0, "line_gap": 1.40, "align": "center",
+                   "number": "roman", "ratio": 3.15},
+    "bias": {"x": 0, "y": 0, "inset": 0},
+    "layout_cycle": ("center-stack", "center-stack", "center-stack"),
+}
+
+VISUAL_LANGUAGES["cinema"] = {
+    "motion": {"ease": "inOut3", "enter": (0.70, 1.20), "push": 0.12, "breathe_hz": 0.30},
+    "motif": {"kind": "letterbox", "density": 1.0,
+              "detail": {"top": 40, "bottom": 44, "flares": True}},
+    "transition": {"kind": "dip", "dur": 0.45},
+    "typography": {"tracking": 3.0, "line_gap": 1.38, "align": "center",
+                   "number": "timecode", "ratio": 1.62},
+    "bias": {"x": 0, "y": 30, "inset": 0},
+    "layout_cycle": ("center-stack", "left-stack", "split-right"),
+}
+
+VISUAL_LANGUAGES["lo-fi"] = {
+    "motion": {"ease": "out3", "enter": (0.45, 0.85), "push": 0.05, "breathe_hz": 0.60},
+    "motif": {"kind": "signal", "density": 0.90,
+              "detail": {"bars": 12, "radius": 18, "note": True}},
+    "transition": {"kind": "wash", "dur": 0.30},
+    "typography": {"tracking": 1.0, "line_gap": 1.36, "align": "left",
+                   "number": "dot", "ratio": 1.48},
+    # lo-fi 是"桌面便签"气质：整体右移、内容偏上，底部留给信号条与时间戳。
+    "bias": {"x": 60, "y": -70, "inset": 0},
+    "layout_cycle": ("left-stack", "split-right", "center-stack"),
+}
+
+VISUAL_LANGUAGES["epic"] = {
+    "motion": {"ease": "out5", "enter": (0.70, 1.20), "push": 0.14, "breathe_hz": 0.28},
+    "motif": {"kind": "rays", "density": 1.0,
+              "detail": {"rays": 18, "rule_gap": 26, "frame": True}},
+    "transition": {"kind": "iris", "dur": 0.40},
+    "typography": {"tracking": 4.0, "line_gap": 1.32, "align": "center",
+                   "number": "gilt", "ratio": 3.18},
+    "bias": {"x": 0, "y": -30, "inset": 0},
+    "layout_cycle": ("center-stack", "center-stack", "center-stack"),
+}
+
+# legacy：v0.4 行为，没有视觉语言（scenes.py 走 _LEGACY_DRAWERS，不会读到这张表）
+VISUAL_LANGUAGES[LEGACY_STYLE] = {
+    "motion": {"ease": "out3", "enter": (0.45, 0.85), "push": 0.04, "breathe_hz": 0.85},
+    "motif": {"kind": "brackets", "density": 1.0, "detail": {}},
+    "transition": {"kind": "cut", "dur": 0.0},
+    "typography": {"tracking": 0.0, "line_gap": 1.30, "align": "left",
+                   "number": "dim", "ratio": 1.50},
+    "layout_cycle": ("left-stack",),
+}
+
+
+def visual_language(style_id):
+    """取风格的结构签名；未知 id 退到默认风格（不让拼写错误炸掉渲染）。"""
+    sid = str(style_id or "").strip()
+    got = VISUAL_LANGUAGES.get(sid)
+    if got is not None:
+        return got
+    return VISUAL_LANGUAGES[DEFAULT_STYLE]
+
+
+def visual_lint(style_id):
+    """结构签名体检（--stage style 就拦，不等到渲完 300 帧）。返回问题列表，空 = 过。"""
+    bad = []
+    sid = str(style_id or "")
+    if sid not in VISUAL_LANGUAGES:
+        return ["风格 %r 没有视觉语言包" % sid]
+    vl = VISUAL_LANGUAGES[sid]
+    mo = vl.get("motion") or {}
+    mf = vl.get("motif") or {}          # 注意：mo = motion，mf = motif，别混用
+    tr = vl.get("transition") or {}
+    ty = vl.get("typography") or {}
+    if str(mf.get("kind")) not in VISUAL_MOTIFS:
+        bad.append("motif.kind=%r 不在 %s 里" % (mf.get("kind"), " / ".join(VISUAL_MOTIFS)))
+    if str(tr.get("kind")) not in VISUAL_TRANSITIONS:
+        bad.append("transition.kind=%r 不在 %s 里"
+                   % (tr.get("kind"), " / ".join(VISUAL_TRANSITIONS)))
+    if not 0.0 <= float(tr.get("dur") or 0.0) <= 0.60:
+        # 段界 veil 超过 0.6s 会吃掉 3–6s 节奏下限，也会把两段内容糊在一起
+        bad.append("transition.dur=%r 必须在 0~0.60s（段界 veil 上限）" % tr.get("dur"))
+    if str(ty.get("number")) not in NUMBER_STYLES:
+        bad.append("typography.number=%r 不在 %s 里"
+                   % (ty.get("number"), " / ".join(NUMBER_STYLES)))
+    if not 1.0 <= float(ty.get("ratio") or 0.0) <= 3.6:
+        bad.append("typography.ratio=%r 必须在 1.0~3.6（display:body 字号比）" % ty.get("ratio"))
+    if not 0.0 <= float(ty.get("tracking") or 0.0) <= 8.0:
+        bad.append("typography.tracking=%r 必须在 0~8px" % ty.get("tracking"))
+    if not 1.15 <= float(ty.get("line_gap") or 0.0) <= 1.55:
+        bad.append("typography.line_gap=%r 必须在 1.15~1.55" % ty.get("line_gap"))
+    if not 0.0 <= float(mf.get("density") or 0.0) <= 1.0:
+        bad.append("motif.density=%r 必须在 0~1" % mf.get("density"))
+    if float(mf.get("density") or 0.0) <= 0.0 and str(mf.get("kind")) != "minimal":
+        bad.append("motif.density=0 只允许用于 minimal（否则等于没有装饰语言）")
+    enter = mo.get("enter") or (0.45, 0.85)
+    if (not isinstance(enter, (list, tuple)) or len(enter) != 2
+            or not 0.0 < float(enter[0]) <= float(enter[1]) <= 1.6):
+        bad.append("motion.enter=%r 必须是 (起, 止) 且 0 < 起 <= 止 <= 1.6 秒" % (enter,))
+    if not 0.0 <= float(mo.get("push") or 0.0) <= 0.16:
+        # push > 0.16 时背景层放大后内容会被推出 SAFE（_bg_plate 只裁不缩）
+        bad.append("motion.push=%r 必须在 0~0.16（超过会把内容推出安全区）" % mo.get("push"))
+    return bad
+
+
+def visual_lint_all():
+    """全部内置风格的视觉语言体检，返回 {style_id: [问题]}（只有有问题的才在里面）。"""
+    out = {}
+    for sid in STYLE_IDS:
+        bad = visual_lint(sid)
+        if bad:
+            out[sid] = bad
+    return out
+
+
 ALL_STYLE_IDS = (LEGACY_STYLE,) + STYLE_IDS
 
 

package/tools/ci_check.py

@@ -57,7 +57,9 @@ LOCAL_MODULES = {"filmkit", "sfxkit", "scorekit", "webengine", "qa_frames", "ren
                  # v0.6.0：门禁账本 / 交付报告 / 签核、阶段新鲜度守卫、film.json 契约校验器
                  "gates", "stagewatch", "filmcheck",
                  # v0.8.0：渲染前资源闸门、全片 VMAF/SSIM 门禁、ASR 回读门禁
-                 "preflight", "qavmaf", "qaasr"}
+                 "preflight", "qavmaf", "qaasr",
+                 # v0.9.0：场景语法（内容 -> 构图选型）。纯标准库，可被 scenes.py 反向 import
+                 "grammar"}
 MAX_FILE_BYTES = 400 * 1024
 # 体积检查忽略的目录后缀：.team 是本地调研/自测工作区（gitignore），不随包发布；
 # 媒体文件本来就该大（样例片/参考视频），不该拿"能不能塞进上下文"的尺子量。