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

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

@@ -45,6 +45,50 @@ import sys
 # ============================================================================
 
 
+def hsv_to_rgb(h, s, v):
+    """HSV(0..360, 0..1, 0..1) -> (r,g,b) 整数 0..255。
+
+    技术原语：让"配色"可以是一个**连续空间**而不是一份命名清单。
+    有了它，第 9 种外观 = 把色相转到 200°，不需要有人先写一个模板文件。
+    """
+    h = float(h) % 360.0
+    s = max(0.0, min(1.0, float(s)))
+    v = max(0.0, min(1.0, float(v)))
+    c = v * s
+    x = c * (1.0 - abs((h / 60.0) % 2.0 - 1.0))
+    m = v - c
+    if h < 60:
+        rgb = (c, x, 0.0)
+    elif h < 120:
+        rgb = (x, c, 0.0)
+    elif h < 180:
+        rgb = (0.0, c, x)
+    elif h < 240:
+        rgb = (0.0, x, c)
+    elif h < 300:
+        rgb = (x, 0.0, c)
+    else:
+        rgb = (c, 0.0, x)
+    return tuple(int(round(max(0.0, min(1.0, ch + m)) * 255.0)) for ch in rgb)
+
+
+def rgb_to_hsv(rgb):
+    """(r,g,b) 0..255 -> (h 0..360, s 0..1, v 0..1)。与 hsv_to_rgb 互逆。"""
+    r, g, b = (max(0.0, min(1.0, float(c) / 255.0)) for c in tuple(rgb)[:3])
+    mx, mn = max(r, g, b), min(r, g, b)
+    d = mx - mn
+    if d < 1e-12:
+        return 0.0, 0.0, mx
+    if mx == r:
+        h = (60.0 * ((g - b) / d)) % 360.0
+    elif mx == g:
+        h = 60.0 * ((b - r) / d) + 120.0
+    else:
+        h = 60.0 * ((r - g) / d) + 240.0
+    s = 0.0 if mx < 1e-12 else d / mx
+    return h, s, mx
+
+
 def _srgb_to_lin(v):
     """sRGB 通道（0..255）-> 线性光。"""
     c = float(v) / 255.0
@@ -206,172 +250,24 @@ def _theme(style_id, label, keywords, palette, material, typ, layout, motion, hu
     }
 
 
-THEMES = {}
-
-THEMES["tech-deep"] = _theme(
-    "tech-deep", "科技深蓝",
-    ("AI", "算法", "代码", "模型", "系统", "数据", "架构", "开源", "编程", "大模型"),
-    dict(bg=(7, 14, 26), bg2=(17, 33, 54), surface=(26, 42, 64),
-         ink=(240, 245, 252), muted=(150, 174, 200), dim=(120, 142, 168),
-         accent=(243, 132, 60), accent2=(86, 170, 232),
-         good=(108, 178, 110), bad=(226, 96, 92), rule=(255, 255, 255)),
-    dict(vignette=0.40, vignette_tint=(0, 0, 0), grain=5.0, grain_freq=0.31,
-         texture="dots", texture_alpha=0.045),
-    dict(family="sans", scale={"display": (96, "bold"), "heading": (64, "bold"),
-                               "sub": (38, "light"), "body": (34, "reg"),
-                               "kicker": (28, "bold"), "chip": (27, "reg"),
-                               "brand": (23, "reg")}),
-    dict(layout="left-stack",
-         card={"radius": 14, "fill_a": 16, "outline_a": 28, "pad": 34, "h": 96, "gap": 118}),
-    dict(ease="out3", entrance_dx=0, entrance_dy=26, push=0.04, item_stagger=0.32, transition="black"),
-    dict(style="chip-left"),
-    dict(luma_max=0.030, flicker_thresh=6.0, dark=True),
-)
-
-THEMES["magazine"] = _theme(
-    "magazine", "杂志暖白",
-    ("报告", "复盘", "年度", "总结", "研究", "分析", "调研", "白皮书", "趋势", "发布"),
-    dict(bg=(250, 246, 238), bg2=(236, 228, 214), surface=(255, 252, 246),
-         ink=(28, 26, 24), muted=(88, 82, 74), dim=(112, 104, 94),
-         accent=(176, 48, 40), accent2=(38, 86, 128),
-         good=(30, 110, 72), bad=(160, 36, 32), rule=(28, 26, 24)),
-    dict(vignette=0.10, vignette_tint=(214, 204, 186), grain=3.0, grain_freq=0.27,
-         texture="paper", texture_alpha=0.030),
-    dict(family="serif", scale={"display": (92, "bold"), "heading": (60, "bold"),
-                                "sub": (36, "light"), "body": (33, "reg"),
-                                "kicker": (27, "bold"), "chip": (26, "reg"),
-                                "brand": (22, "reg")}, line_gap=1.34, tracking=2.0),
-    dict(layout="split-right",
-         card={"radius": 8, "fill_a": 26, "outline_a": 40, "pad": 30, "h": 92, "gap": 112},
-         safe_bias=-8),
-    dict(ease="out5", entrance_dx=18, entrance_dy=20, push=0.06, item_stagger=0.38, transition="wash"),
-    dict(style="corner-line"),
-    dict(luma_max=0.045, flicker_thresh=6.0, dark=False),
-)
-
-THEMES["paper"] = _theme(
-    "paper", "手绘纸感",
-    ("手工", "自然", "历史", "传统", "木", "田野", "匠", "古", "茶", "手艺", "山河"),
-    dict(bg=(240, 232, 212), bg2=(222, 210, 186), surface=(249, 244, 232),
-         ink=(46, 38, 30), muted=(92, 80, 64), dim=(112, 98, 80),
-         accent=(42, 72, 116), accent2=(124, 72, 32),
-         good=(48, 98, 60), bad=(150, 48, 40), rule=(46, 38, 30)),
-    dict(vignette=0.14, vignette_tint=(198, 184, 158), grain=9.0, grain_freq=0.22,
-         texture="paper", texture_alpha=0.055),
-    dict(family="kai", scale={"display": (92, "bold"), "heading": (60, "bold"),
-                              "sub": (36, "light"), "body": (33, "reg"),
-                              "kicker": (27, "bold"), "chip": (26, "reg"),
-                              "brand": (22, "reg")}, line_gap=1.36, tracking=1.0),
-    dict(layout="left-stack",
-         card={"radius": 4, "fill_a": 30, "outline_a": 52, "pad": 32, "h": 94, "gap": 116}),
-    dict(ease="inOut3", entrance_dx=0, entrance_dy=18, push=0.03, item_stagger=0.42, transition="wash"),
-    dict(style="corner-line"),
-    dict(luma_max=0.045, flicker_thresh=6.0, dark=False),
-)
-
-THEMES["vivid"] = _theme(
-    "vivid", "活力撞色",
-    ("活动", "上新", "招募", "挑战", "年轻", "潮流", "种草", "福利", "开箱", "限量"),
-    dict(bg=(20, 18, 34), bg2=(38, 26, 58), surface=(46, 34, 70),
-         ink=(255, 252, 246), muted=(206, 196, 224), dim=(168, 158, 190),
-         accent=(255, 214, 64), accent2=(120, 224, 255),
-         good=(120, 230, 150), bad=(255, 120, 150), rule=(255, 255, 255)),
-    dict(vignette=0.24, vignette_tint=(12, 10, 22), grain=4.0, grain_freq=0.35,
-         texture="grid", texture_alpha=0.060),
-    dict(family="sans", scale={"display": (104, "bold"), "heading": (68, "bold"),
-                               "sub": (39, "reg"), "body": (35, "reg"),
-                               "kicker": (30, "bold"), "chip": (27, "reg"),
-                               "brand": (23, "reg")}, line_gap=1.26, tracking=1.0),
-    dict(layout="center-stack",
-         card={"radius": 22, "fill_a": 30, "outline_a": 56, "pad": 32, "h": 100, "gap": 122}),
-    dict(ease="outBack", entrance_dx=0, entrance_dy=34, push=0.10, item_stagger=0.26, transition="black"),
-    dict(style="chip-left"),
-    dict(luma_max=0.030, flicker_thresh=8.0, dark=True),
-)
-
-THEMES["mono"] = _theme(
-    "mono", "极简黑白",
-    ("观点", "为什么", "本质", "真相", "极简", "反思", "边界", "定义", "取舍"),
-    dict(bg=(246, 246, 244), bg2=(222, 222, 220), surface=(255, 255, 255),
-         ink=(16, 16, 16), muted=(68, 68, 68), dim=(104, 104, 104),
-         accent=(16, 16, 16), accent2=(80, 80, 80),
-         good=(38, 92, 52), bad=(150, 36, 36), rule=(16, 16, 16)),
-    dict(vignette=0.06, vignette_tint=(214, 214, 212), grain=0.0, grain_freq=0.30,
-         texture="none", texture_alpha=0.0),
-    dict(family="sans", scale={"display": (104, "bold"), "heading": (66, "bold"),
-                               "sub": (36, "light"), "body": (33, "reg"),
-                               "kicker": (26, "bold"), "chip": (25, "reg"),
-                               "brand": (21, "reg")}, line_gap=1.40, tracking=6.0),
-    dict(layout="center-stack",
-         card={"radius": 0, "fill_a": 0, "outline_a": 70, "pad": 28, "h": 90, "gap": 108}),
-    dict(ease="inOut3", entrance_dx=0, entrance_dy=12, push=0.02, item_stagger=0.55, transition="none"),
-    dict(style="corner-line"),
-    dict(luma_max=0.045, flicker_thresh=6.0, dark=False),
-)
-
-THEMES["cinema"] = _theme(
-    "cinema", "电影青橙",
-    ("故事", "记忆", "城市", "深夜", "旅行", "纪实", "情绪", "时代", "变迁", "命运"),
-    dict(bg=(8, 14, 16), bg2=(20, 32, 34), surface=(26, 40, 42),
-         ink=(238, 234, 226), muted=(164, 176, 170), dim=(128, 140, 136),
-         accent=(232, 126, 58), accent2=(104, 196, 190),
-         good=(116, 196, 140), bad=(214, 92, 84), rule=(255, 255, 255)),
-    dict(vignette=0.55, vignette_tint=(0, 0, 0), grain=6.0, grain_freq=0.29,
-         texture="scanlines", texture_alpha=0.035),
-    dict(family="sans", scale={"display": (94, "bold"), "heading": (58, "bold"),
-                               "sub": (36, "light"), "body": (33, "reg"),
-                               "kicker": (27, "bold"), "chip": (26, "reg"),
-                               "brand": (22, "reg")}, line_gap=1.38, tracking=3.0),
-    dict(layout="center-stack",
-         card={"radius": 2, "fill_a": 14, "outline_a": 30, "pad": 30, "h": 92, "gap": 114}),
-    dict(ease="inOut3", entrance_dx=0, entrance_dy=16, push=0.12, item_stagger=0.46, transition="black"),
-    dict(style="corner-line"),
-    dict(luma_max=0.020, flicker_thresh=6.0, dark=True),
-)
-
-THEMES["lo-fi"] = _theme(
-    "lo-fi", "暖灰薄荷",
-    ("深夜", "学习", "效率", "专注", "写作", "整理", "笔记", "书", "日常", "房间"),
-    # 冷调灰绿：和 paper（暖牛皮纸）在色相上分开，不靠"亮度差不多"硬撑
-    dict(bg=(232, 238, 236), bg2=(210, 220, 216), surface=(244, 248, 246),
-         ink=(44, 52, 50), muted=(84, 98, 94), dim=(112, 126, 122),
-         accent=(20, 86, 84), accent2=(104, 72, 96),
-         good=(40, 100, 72), bad=(146, 52, 50), rule=(44, 52, 50)),
-    dict(vignette=0.12, vignette_tint=(206, 200, 190), grain=7.0, grain_freq=0.24,
-         texture="paper", texture_alpha=0.048),
-    dict(family="sans", scale={"display": (86, "bold"), "heading": (58, "bold"),
-                               "sub": (35, "light"), "body": (32, "reg"),
-                               "kicker": (26, "bold"), "chip": (25, "reg"),
-                               "brand": (21, "reg")}, line_gap=1.36, tracking=1.0),
-    dict(layout="left-stack",
-         card={"radius": 18, "fill_a": 40, "outline_a": 26, "pad": 34, "h": 98, "gap": 120},
-         safe_bias=6),
-    dict(ease="out3", entrance_dx=0, entrance_dy=22, push=0.05, item_stagger=0.44, transition="wash"),
-    dict(style="chip-left"),
-    dict(luma_max=0.045, flicker_thresh=6.0, dark=False),
-)
-
-THEMES["epic"] = _theme(
-    "epic", "深黑鎏金",
-    ("史诗", "爆发", "冲击", "巅峰", "决战", "荣耀", "震撼", "传奇", "极限", "突破"),
-    dict(bg=(9, 9, 12), bg2=(24, 20, 16), surface=(32, 28, 22),
-         ink=(248, 242, 228), muted=(186, 176, 158), dim=(142, 134, 120),
-         accent=(222, 178, 84), accent2=(206, 116, 92),
-         good=(140, 200, 140), bad=(222, 96, 84), rule=(255, 255, 255)),
-    dict(vignette=0.62, vignette_tint=(0, 0, 0), grain=5.0, grain_freq=0.26,
-         texture="scanlines", texture_alpha=0.028),
-    dict(family="serif", scale={"display": (108, "bold"), "heading": (70, "bold"),
-                                "sub": (38, "light"), "body": (34, "reg"),
-                                "kicker": (29, "bold"), "chip": (27, "reg"),
-                                "brand": (23, "reg")}, line_gap=1.32, tracking=4.0),
-    dict(layout="center-stack",
-         card={"radius": 6, "fill_a": 20, "outline_a": 44, "pad": 32, "h": 98, "gap": 120}),
-    dict(ease="out5", entrance_dx=0, entrance_dy=24, push=0.14, item_stagger=0.34, transition="black"),
-    dict(style="corner-line"),
-    dict(luma_max=0.018, flicker_thresh=6.0, dark=True),
-)
-
 # ============================================================================
+# 二、主题（已删除：v1.0.1 起本技能不提供任何模板）
+# ============================================================================
+#
+# 这里曾有 8 套命名主题（THEMES：科技深蓝 / 近黑金 / 冷薄荷 / 暖砂金 / 石青灰 /
+# 深林绿 / 暖纸白 / 墨纸白）。它们是**模板**：用户只能在这 8 种外观里选，
+# 第 9 种永远不会出现。
+#
+# 现在主题由 designkit 从连续空间现场构造：
+#   · 底色 = (色相 h∈[0,360), 饱和 s, 明度 v) 连续取值，经 _palette_from_hue 算出三段底色；
+#   · 其余 8 个语义色由对比度网格求解（每套都必须过 theme_lint）；
+#   · 产出仍是同形的 35 字段主题字典，scenes.py 不需要知道它从哪来。
+#
+# 保留的**技术原语**（这些不是模板，是造东西的工具）：
+#   luminance / contrast / midpoint / _rgb / _color_of / apply_theme_overrides /
+#   _theme(构造器) / hsv_to_rgb / rgb_to_hsv / LINT_LIMITS / theme_lint / is_dark /
+#   blend_theme / family_compatible / LAYOUTS(几何参数，不是外观目录)
+THEMES = {}
 # 三、版式骨架（LAYOUTS）：3 种，scenes.py 按名字取几何参数
 # ============================================================================
 #
@@ -419,142 +315,158 @@ def layout(name):
 # music 字段只放「策展层」（BPM 梯度 / 调池 / 情绪 / 音色组偏好），
 # 具体的和弦进行、鼓型、乐器合成在 scorekit 里（合成层）。两边用同一个 style id 对齐。
 
-STYLE_IDS = ("tech-deep", "magazine", "paper", "vivid", "mono", "cinema", "lo-fi", "epic")
-DEFAULT_STYLE = "tech-deep"
-LEGACY_STYLE = "legacy"          # 显式老行为：v0.4 的画风 + 配乐 + 单一旁白
-
+# ============================================================================
+# 四、风格包（已删除：v1.0.1 起不提供任何模板）
+# ============================================================================
+#
+# 这里曾有 STYLES：一个 style id = 主题 + 配乐 + 旁白 + 节奏的整套模板，
+# 外加 pick_style 按关键词/指纹**自动挑一套**。那是本技能最像"模板库"的部分。
+#
+# 现在没有任何 style id：一个设计从哪来只有一条路——work/design.json，
+# 由 propose.py 按 brief 现场采样、人确认后冻结。
+#
+# 保留的：LEGACY_STYLE 常量（只为了让"写 style=legacy"能被明确拒绝并给迁移指引，
+# 而不是抛 AttributeError）。
+STYLE_IDS = ()
+DEFAULT_STYLE = None
+LEGACY_STYLE = "legacy"          # 只为让老剧本被**明确拒绝**时能报出可读的迁移信息
+STYLES = {}
+
+# ---- 调式池：技术原语，不是模板 ----
+# 项目只支持中文口播常见的 4 个小调主音与 6 个大调主音。列出来是**约束**
+# （musicgen 与 designkit 都按它校验"调性是否可实现"），不是"给你 10 套现成配色"。
 MINOR_KEYS = ("Dm", "Am", "Em", "Cm")
 MAJOR_KEYS = ("C", "G", "D", "F", "A", "Bb")
 
-STYLES = {
-    "tech-deep": {
-        "name": "科技深蓝",
-        "tags": ("AI", "工程", "数据", "科普"),
-        "theme": "tech-deep",
-        "layouts": ("left-stack", "split-right"),
-        "music": {"keys": ("Dm", "Am", "Em", "Cm"), "scale": "minor",
-                  "bpm_ladder": (100, 108, 116, 124), "mood": "steady"},
-        "voice": {"body": "narrator_male", "hook": "young_male",
-                  "quote": "narrator_female", "outro": "narrator_male"},
-        "pacing": {"lead": 0.58, "tail": 0.88, "min_dur": 3.0, "hold": 0.0},
-    },
-    "magazine": {
-        "name": "杂志暖白",
-        "tags": ("报告", "复盘", "研究", "出版物"),
-        "theme": "magazine",
-        "layouts": ("left-stack", "split-right"),
-        "music": {"keys": ("C", "G", "D", "F"), "scale": "major",
-                  "bpm_ladder": (88, 92, 96, 100), "mood": "reflective"},
-        "voice": {"body": "narrator_female", "hook": "narrator_female",
-                  "quote": "authority_male", "outro": "narrator_female"},
-        "pacing": {"lead": 0.64, "tail": 0.94, "min_dur": 3.2, "hold": 0.2},
-    },
-    "paper": {
-        "name": "手绘纸感",
-        "tags": ("手工", "自然", "历史", "人文"),
-        "theme": "paper",
-        "layouts": ("left-stack", "center-stack"),
-        "music": {"keys": ("G", "D", "C"), "scale": "major",
-                  "bpm_ladder": (84, 88, 92), "mood": "hopeful"},
-        "voice": {"body": "warm_female", "hook": "narrator_female",
-                  "quote": "narrator_male", "outro": "warm_female"},
-        "pacing": {"lead": 0.68, "tail": 1.00, "min_dur": 3.4, "hold": 0.3},
-    },
-    "vivid": {
-        "name": "活力撞色",
-        "tags": ("活动", "营销", "年轻", "上新"),
-        "theme": "vivid",
-        "layouts": ("center-stack", "left-stack"),
-        "music": {"keys": ("D", "G", "A"), "scale": "major",
-                  "bpm_ladder": (120, 126, 132), "mood": "uplifting"},
-        "voice": {"body": "narrator_female", "hook": "bright_female",
-                  "quote": "young_male", "outro": "bright_female"},
-        "pacing": {"lead": 0.46, "tail": 0.76, "min_dur": 2.8, "hold": 0.0},
-    },
-    "mono": {
-        "name": "极简黑白",
-        "tags": ("观点", "演讲", "思辨", "极简"),
-        "theme": "mono",
-        "layouts": ("center-stack",),
-        "music": {"keys": ("C", "F", "Am"), "scale": "major",
-                  "bpm_ladder": (60, 64, 68), "mood": "calm"},
-        "voice": {"body": "narrator_male", "hook": "authority_male",
-                  "quote": "narrator_female", "outro": "authority_male"},
-        "pacing": {"lead": 0.86, "tail": 1.24, "min_dur": 4.0, "hold": 0.6},
-    },
-    "cinema": {
-        "name": "电影青橙",
-        "tags": ("纪录", "叙事", "散文", "城市"),
-        "theme": "cinema",
-        "layouts": ("center-stack", "left-stack"),
-        "music": {"keys": ("Dm", "Am"), "scale": "minor",
-                  "bpm_ladder": (76, 80, 84), "mood": "reflective"},
-        "voice": {"body": "narrator_male", "hook": "authority_male",
-                  "quote": "narrator_female", "outro": "narrator_male"},
-        "pacing": {"lead": 0.76, "tail": 1.10, "min_dur": 3.6, "hold": 0.4},
-    },
-    "lo-fi": {
-        "name": "暖灰薄荷",
-        "tags": ("日常", "学习", "专注", "深夜"),
-        "theme": "lo-fi",
-        "layouts": ("left-stack", "split-right"),
-        "music": {"keys": ("C", "F", "G"), "scale": "major",
-                  "bpm_ladder": (72, 78, 84), "mood": "calm"},
-        "voice": {"body": "narrator_female", "hook": "warm_female",
-                  "quote": "narrator_male", "outro": "narrator_female"},
-        "pacing": {"lead": 0.72, "tail": 1.06, "min_dur": 3.4, "hold": 0.4},
-    },
-    "epic": {
-        "name": "深黑鎏金",
-        "tags": ("史诗", "宣传", "高潮", "荣耀"),
-        "theme": "epic",
-        "layouts": ("center-stack",),
-        "music": {"keys": ("Cm", "Dm"), "scale": "minor",
-                  "bpm_ladder": (88, 92, 96), "mood": "driving"},
-        "voice": {"body": "authority_male", "hook": "narrator_male",
-                  "quote": "narrator_female", "outro": "authority_male"},
-        "pacing": {"lead": 0.62, "tail": 0.96, "min_dur": 3.2, "hold": 0.2},
-    },
-}
-
-# 老行为（不写 style 时）：画风 = v0.4 的深蓝橙，配乐 = v0.4 的 Dm/120/seed7，旁白 = script.voice
-STYLES[LEGACY_STYLE] = {
-    "name": "v0.4 兼容",
-    "tags": ("兼容", "老项目"),
-    "theme": "tech-deep",
-    "layouts": ("left-stack",),
-    "music": {"keys": ("Dm", "Am", "Cm", "Em"), "scale": "minor",
-              "bpm_ladder": (120,), "mood": "steady", "legacy": True},
-    "voice": {"body": None, "hook": None, "quote": None, "outro": None},
-    # 必须是 render.py v0.4 的函数默认值（lead=0.55 / tail=0.85 / min_dur=3.0），
-    # 否则"没写 lead 字段的老剧本"会悄悄换掉节奏 —— legacy 的含义就是一个字节都不变。
-    "pacing": {"lead": 0.55, "tail": 0.85, "min_dur": 3.0, "hold": 0.0},
-}
-
-ALL_STYLE_IDS = (LEGACY_STYLE,) + STYLE_IDS
-
 
+# ---- 兼容壳：模板表删掉后，老调用点不该 AttributeError ----
+# 这些函数在 v1.0.1 之前用于"按 style id 取模板"。现在没有模板，它们**必须明确报错**，
+# 而不是返回一个假的默认值（那等于偷偷恢复模板）。
 def style_ids(include_legacy=True):
-    return list(ALL_STYLE_IDS) if include_legacy else list(STYLE_IDS)
+    return []
 
 
 def get(style_id):
-    """取风格包；未知 id 报错并列出可用值（不静默回落，v0.4 的教训）。"""
-    sid = str(style_id or "").strip()
-    if sid not in STYLES:
-        raise KeyError("未知风格 %r；可用：%s" % (style_id, " / ".join(ALL_STYLE_IDS)))
-    return STYLES[sid]
+    raise KeyError(
+        "没有风格 %r：v1.0.1 起本技能不提供内置风格（模板已删除）。\n"
+        "  每一版外观都必须现场生成：python propose.py --brief \"题材\" --script film.json\n"
+        "  再用 --confirm 冻结 design.json" % (style_id,))
 
 
 def theme_of(style_id):
-    """取风格对应的主题字典（元组颜色原样返回，给 PIL 直接下标）。"""
-    return THEMES[get(style_id)["theme"]]
+    raise KeyError(
+        "没有主题 %r：v1.0.1 起没有内置主题表（模板已删除）。\n"
+        "  主题由 designkit 从 (色相,饱和,明度) 连续空间现场构造，见 work/design.json"
+        % (style_id,))
 
 
 def is_legacy(style_id):
-    return str(style_id or LEGACY_STYLE) == LEGACY_STYLE
+    return str(style_id or "") == LEGACY_STYLE
+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")
+
+# ============================================================================
+# 五、视觉语言包（已删除：v1.0.1 起不提供任何模板）
+# ============================================================================
+#
+# 这里曾有 VISUAL_LANGUAGES：8 套命名结构签名（母题/转场/字距/缓动/重心/layout_cycle）。
+# 它们是另一种模板——换风格时用户只能在这 8 组里挑。
+#
+# 现在视觉语言由 designkit._language_of(design) 从设计字段直接拼出来（同形五组），
+# 再交给 _visual_lint_language 做同一条体检。
+#
+# 保留的：VISUAL_MOTIFS / VISUAL_TRANSITIONS / NUMBER_STYLES（**绘制原语的名字**，
+# scenes.py 按名字分发到具体画法；这是"能画什么"，不是"长什么样"）、
+# visual_lint_language(lang)（对任意 language 字典做体检的纯函数）。
+VISUAL_LANGUAGES = {}
 
 
+def visual_language(lang=None):
+    """兼容壳：v1.0.1 起没有命名视觉语言，传什么返回什么；传 None 返回空壳。
+
+    保留这个函数只是为了让 `plan["language"] = ST.visual_language(...)` 这类老调用点
+    不至于 AttributeError —— 真正的语言包由 designkit 提供。"""
+    return lang if isinstance(lang, dict) else {}
+
+
+def visual_lint_language(vl):
+    """结构签名体检：对**任意** language 字典，不要求它属于某个命名风格。
+
+    这是从 v0.9 的 visual_lint(style_id) 里抽出来的核心——原来它先查
+    VISUAL_LANGUAGES[style_id] 再体检，模板删掉后没有 style_id 可查了，
+    但仍然需要"这套语言参数越界没有"的检查（否则转场 1 秒、push 0.3 这类
+    会让整片观感崩掉的错误要等渲完 300 帧才发现）。
+    """
+    bad = []
+    if not isinstance(vl, dict) or not vl:
+        return ["视觉语言包缺失或不是字典"]
+    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)))
+    try:
+        _d = float(tr.get("dur") or 0.0)
+    except (TypeError, ValueError):
+        _d = -1.0
+    if not 0.0 <= _d <= 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)))
+    for key, lo, hi in (("ratio", 1.0, 3.6), ("tracking", 0.0, 8.0),
+                        ("line_gap", 1.15, 1.55), ("push", 0.0, 0.16)):
+        try:
+            v = float((ty if key != "push" else mo).get(key) or 0.0)
+        except (TypeError, ValueError):
+            bad.append("typography/motion.%s=%r 不是数字" % (key, (ty if key != "push" else mo).get(key)))
+            continue
+        if key == "ratio" and not lo <= v <= hi:
+            bad.append("typography.ratio=%r 必须在 1.0~3.6（display:body 字号比）" % v)
+        elif key == "tracking" and not lo <= v <= hi:
+            bad.append("typography.tracking=%r 必须在 0~8px" % v)
+        elif key == "line_gap" and not lo <= v <= hi:
+            bad.append("typography.line_gap=%r 必须在 1.15~1.55" % v)
+        elif key == "push" and not lo <= v <= hi:
+            # push > 0.16 时背景层放大后内容会被推出 SAFE（_bg_plate 只裁不缩）
+            bad.append("motion.push=%r 必须在 0~0.16（超过会把内容推出安全区）" % v)
+    try:
+        dens = float(mf.get("density") or 0.0)
+    except (TypeError, ValueError):
+        dens = -1.0
+    if not 0.0 <= dens <= 1.0:
+        bad.append("motif.density=%r 必须在 0~1" % mf.get("density"))
+    elif dens <= 0.0 and str(mf.get("kind")) != "minimal":
+        bad.append("motif.density=0 只允许用于 minimal（否则等于没有装饰语言）")
+    enter = mo.get("enter") or (0.45, 0.85)
+    try:
+        ok_enter = (isinstance(enter, (list, tuple)) and len(enter) == 2
+                    and 0.0 < float(enter[0]) <= float(enter[1]) <= 1.6)
+    except (TypeError, ValueError):
+        ok_enter = False
+    if not ok_enter:
+        bad.append("motion.enter=%r 必须是 (起, 止) 且 0 < 起 <= 止 <= 1.6 秒" % (enter,))
+    return bad
+
+
+def visual_lint(lang=None):
+    """对**任意** language 字典做体检（不再是"某个 style id 的体检"）。"""
+    if isinstance(lang, str):
+        # 老的 visual_lint("cinema") 调用：没有命名语言了，明确报错而不是静默通过
+        return ["没有命名视觉语言 %r（v1.0.1 起视觉语言由 design 现场生成）" % lang]
+    return visual_lint_language(lang or {})
+
+
+def visual_lint_all():
+    """v1.0.1 起没有内置语言可逐一检查，保留空实现只为兼容。"""
+    return {}
 # ============================================================================
 # 五、内容指纹与自动选风格
 # ============================================================================
@@ -599,67 +511,15 @@ def fingerprint(script):
     }
 
 
-def _kind_profile(script):
-    """kind 分布画像：用于给风格打分（题材相近的片子 kind 结构也像）。"""
-    kinds = [str(ln.get("kind") or "body") for ln in script.get("lines") or []]
-    n = max(1, len(kinds))
-    return {
-        "hook": kinds.count("hook") / n,
-        "body": kinds.count("body") / n,
-        "outro": kinds.count("outro") / n,
-        "items": sum(1 for ln in script.get("lines") or [] if ln.get("items")) / n,
-        "avg_len": sum(len(str(ln.get("text") or "")) for ln in script.get("lines") or []) / n,
-    }
-
-
-def score_styles(script):
-    """给所有风格打分，返回 [(style_id, score, hits)]，按分数降序（同分按 STYLE_IDS 顺序）。"""
-    text = _text_of(script)
-    prof = _kind_profile(script)
-    fp = fingerprint(script)
-    rows = []
-    for sid in STYLE_IDS:
-        th = THEMES[STYLES[sid]["theme"]]
-        hits = []
-        score = 0.0
-        for kw in th["keywords"]:
-            c = text.count(str(kw))
-            if c:
-                score += 3.0 * c
-                hits.append(str(kw))
-        if prof["items"] >= 0.5:
-            score += 1.5 if sid in ("tech-deep", "magazine", "vivid") else 0.0
-        if prof["avg_len"] >= 28:
-            score += 1.0 if sid in ("cinema", "paper", "mono") else 0.0
-        if prof["hook"] > 0 and prof["outro"] > 0:
-            score += 0.5 if sid in ("tech-deep", "vivid", "epic") else 0.0
-        # 指纹破平：必须把**风格 id** 混进哈希，否则这一项对所有行是同一个常数，
-        # 等于没破平（v0.8 深审实测：旧写法在"AI 报告"上 tech-deep / magazine 同分 12.0，
-        # 永远按 STYLE_IDS 顺序选 tech-deep）。幅度上限 0.0006 << 最小真实分差 0.5，
-        # 只在精确同分时起作用，且不改变"改错别字不换风格"（指纹只吃标题）。
-        score += (_digest("tiebreak", fp["style"], sid) % 7) * 0.0001
-        rows.append((sid, round(score, 4), hits))
-    rows.sort(key=lambda r: (-r[1], STYLE_IDS.index(r[0])))
-    return rows
-
-
-def pick_style(script):
-    """内容驱动选风格。返回 (style_id, reason[list[str], 给用户看的理由])。"""
-    rows = score_styles(script)
-    best_id, best_score, best_hits = rows[0]
-    fp = fingerprint(script)
-    if best_score >= 1.0:
-        if best_hits:
-            reason = ["关键词命中：%s" % "、".join(dict.fromkeys(best_hits))[:80]]
-        else:
-            # 分数可以只由结构加分（items / 长句 / hook+outro）凑到 1.0 以上，
-            # 这时旧文案会写"关键词命中："后面空一截 —— 等于向用户报告没发生的事。
-            reason = ["无关键词命中，按题材结构加分选中（items / 长句 / hook+outro）"]
-    else:
-        pool = list(STYLE_IDS)
-        best_id = pool[int(fp["tempo"], 16) % len(pool)]
-        reason = ["无关键词命中，按内容指纹落桶（%s）" % fp["tempo"][:8]]
-    return best_id, reason
+# —— 自动选风格（score_styles / pick_style / _kind_profile）已删除 ——
+#
+# 这三个函数是"机器替你挑一套内置风格"的实现：按关键词给 8 套 STYLES 打分、同分用指纹破平。
+# v1.0.1 把 STYLES/THEMES 清空后它们必然崩（`THEMES[STYLES[sid]["theme"]]` -> KeyError），
+# 而且留着也没有意义 —— 没有"可选集合"就没有"选"这件事。
+#
+# 为什么必须**删掉**而不是留着报错：留下一个"看起来还能调用"的入口，
+# 下一个维护者会以为它是活的，调通了才发现整个语义已经不成立。
+# 现在的唯一路径是 propose.py 现场采样。
 
 
 # ============================================================================
@@ -691,182 +551,72 @@ def _as_bool(v, default=False):
     return bool(v)
 
 
-def resolve_script_style(script):
-    """解析整份剧本的最终风格计划（纯函数、确定性、可直接 json.dump）。
+# persona 名 -> edge voice id 的**兼容映射**（v1.0 / D3）。
+# 这不是"身份表"：它不带语速/音高/响度补偿，只是把老 STYLES 表里的字符串翻译成
+# voicekit 现在要求的 edge voice id。真正的声音参数在 design.audio.voice 里。
+_PERSONA_VOICE = {
+    "narrator_male": "zh-CN-YunyangNeural",
+    "narrator_female": "zh-CN-XiaoxiaoNeural",
+    "warm_female": "zh-TW-HsiaoChenNeural",
+    "bright_female": "zh-CN-XiaoyiNeural",
+    "authority_male": "zh-CN-YunjianNeural",
+    "young_male": "zh-CN-YunxiNeural",
+    "teen_male": "zh-CN-YunxiaNeural",
+    "dialect_ne_female": "zh-CN-liaoning-XiaobeiNeural",
+    "dialect_sx_female": "zh-CN-shaanxi-XiaoniNeural",
+}
 
-    优先级（从高到低）：
-      1. script["style"]                全片锁定（不是 "auto" 就生效）
-      2. script["visual"]["theme"]      等价于锁 style（主题与风格 1:1）
-      3. 自动：关键词 + 指纹
-    配乐 BPM / 调性 / 情绪、旁白声线映射、节奏都能被 film.json 单独覆盖。
-    """
-    fp = fingerprint(script)
-    vis = script.get("visual") if isinstance(script.get("visual"), dict) else {}
-    mus = script.get("music") if isinstance(script.get("music"), dict) else {}
-    voce = script.get("voice") if isinstance(script.get("voice"), dict) else {}
-
-    has_style_field = "style" in script
-    raw = script.get("style")
-    raw_s = str(raw).strip().lower() if raw is not None else ""
-    if not has_style_field and not vis.get("theme") and not mus.get("style"):
-        # 老项目（film.json 里根本没有 style 字段）-> legacy：配乐逐样本一致，v0.4 原路径
-        sid, source, reason = LEGACY_STYLE, "legacy", ["film.json 没有 style 字段，走 v0.4 兼容路径"]
-    elif raw_s in ("", "auto", "default"):
-        if vis.get("theme"):
-            sid = str(vis["theme"])
-            source = "visual.theme"
-            reason = ["film.json visual.theme 指定"]
-        else:
-            sid, reason = pick_style(script)
-            source = "auto"
-    else:
-        sid = str(raw).strip()
-        source = "explicit"
-        reason = ["film.json style 指定"]
-    get(sid)                       # 未知 id 在这里就炸，不要等到渲染 300 帧后
-    pack = STYLES[sid]
-
-    # ---- 配乐：风格 / BPM / 调性 / 情绪 ----
-    music_style = str(mus.get("style") or "").strip().lower()
-    if music_style in ("", "auto", "default"):
-        music_style = sid if not is_legacy(sid) else LEGACY_STYLE
-    mpack = pack["music"]
-    ladder = tuple(mpack["bpm_ladder"])
-    bpm_raw = mus.get("bpm", script.get("bpm"))
-    if isinstance(bpm_raw, str) and bpm_raw.strip().lower() == "auto":
-        bpm_raw = "auto"
-    if bpm_raw in (None, "", "auto"):
-        if is_legacy(sid):
-            bpm, bpm_source = 120.0, "legacy"          # v0.4 的缺省值，必须是 120
-        else:
-            bpm = float(_pick_from_pool(ladder, fp["tempo"], salt="bpm:" + sid))
-            bpm_source = "style_ladder"
-    else:
-        bpm, bpm_source = float(bpm_raw), "explicit"
-
-    key_raw = mus.get("key")
-    if key_raw in (None, "", "auto"):
-        if is_legacy(sid):
-            key, key_source = "Dm", "legacy"           # v0.4 的缺省值，必须是 Dm
-        else:
-            key = _pick_from_pool(mpack["keys"], fp["tempo"], salt="key:" + sid) or "Dm"
-            key_source = "style_pool"
-    else:
-        key, key_source = str(key_raw), "explicit"
 
-    mood = str(mus.get("mood") or "").strip().lower()
-    if mood in ("", "auto", "default"):
-        mood, mood_source = str(mpack.get("mood") or "steady"), "style"
-    else:
-        mood_source = "explicit"
+def _persona_to_voice_id(name):
+    """老 persona 名 -> edge voice id；已经是 voice id 就原样返回。"""
+    s = str(name or "").strip()
+    if not s:
+        return s
+    return _PERSONA_VOICE.get(s, s)
 
-    seed_raw = mus.get("seed", script.get("seed", 7))
-    try:
-        seed = abs(int(seed_raw if seed_raw is not None else 7))
-    except (TypeError, ValueError):
-        seed = 7
-    seed_from_content = _as_bool(mus.get("seed_from_content"), default=(not is_legacy(sid)))
-    if seed_from_content:
-        seed_effective = (seed * 1000003 + int(fp["full"], 16)) % (2 ** 31 - 1)
-    else:
-        seed_effective = seed
-
-    # ---- 旁白：声线映射 + 策略 ----
-    style_voice = pack["voice"]
-    voice_map = {}
-    if not is_legacy(sid):
-        for kind in ("hook", "body", "quote", "outro"):
-            dv = style_voice.get(kind)
-            if dv:
-                voice_map[kind] = dv
-    explicit_map = voce.get("map") if isinstance(voce.get("map"), dict) else {}
-    voice_map.update({str(k): str(v) for k, v in explicit_map.items() if v})
-    policy = {
-        "auto": _as_bool(voce.get("auto"), default=(not is_legacy(sid))),
-        "jitter": float(voce.get("jitter", 0.0 if is_legacy(sid) else 0.35)),
-        "max_distinct": int(voce.get("max_distinct", 2 if is_legacy(sid) else 3)),
-        "rate_range": (-15, 12),
-        "pitch_range": (-8, 8),
-        "cps_band": (3.6, 5.6),
-    }
-    if isinstance(voce.get("rate_range"), (list, tuple)) and len(voce["rate_range"]) == 2:
-        policy["rate_range"] = (int(voce["rate_range"][0]), int(voce["rate_range"][1]))
-    if isinstance(voce.get("cps_band"), (list, tuple)) and len(voce["cps_band"]) == 2:
-        policy["cps_band"] = (float(voce["cps_band"][0]), float(voce["cps_band"][1]))
-
-    # ---- 节奏 ----
-    sp = pack["pacing"]
-    pacing = {
-        "lead": float(script.get("lead", sp["lead"])),
-        "tail": float(script.get("tail", sp["tail"])),
-        "min_dur": float(script.get("min_dur", sp["min_dur"])),
-        "hold": float(script.get("hold", sp["hold"])),
-        "item_stagger": float(THEMES[pack["theme"]]["item_stagger"]),
-    }
-    explicit_pace = script.get("pacing") if isinstance(script.get("pacing"), dict) else {}
-    for k in ("lead", "tail", "min_dur", "hold", "item_stagger"):
-        if explicit_pace.get(k) is not None:
-            pacing[k] = float(explicit_pace[k])
-
-    # ---- 版式轮换：按 chapter 轮换骨架（同一章节内不变，避免每句都跳） ----
-    layouts = list(pack["layouts"]) or ["left-stack"]
-    chapters = []
-    for ln in script.get("lines") or []:
-        ch = str(ln.get("chapter") or "")
-        if ch not in chapters:
-            chapters.append(ch)
-    explicit_layout = str(vis.get("layout") or "").strip()
-    if explicit_layout:
-        layout(explicit_layout)
-        chap_layout = {ch: explicit_layout for ch in chapters}
-    else:
-        chap_layout = {ch: layouts[i % len(layouts)] for i, ch in enumerate(chapters)}
-
-    # theme_overrides 走带校验的合并（颜色支持 "#rrggbb"，非法值在这里就报错，
-    # 不要等到 scenes.py 渲到第 300 帧才 int("#") 崩——见 apply_theme_overrides）
-    theme = apply_theme_overrides(THEMES[pack["theme"]], vis.get("theme_overrides"))
-    # visual.layout 是"显式换整片版式"：旧的实现只把它写进 chapter_layout，而
-    # PIL 路线渲染读的是 theme["layout"]、web 路线读 layout_default —— 两条路线都不看
-    # chapter_layout，于是这条文档化的覆盖等于没写（v0.8 深审实测：visual.layout=
-    # split-right 的帧与默认帧 sha256 完全相同）。这里补写 theme["layout"] 与 layout_default，
-    # 让两条路线都跟着走；theme_overrides 更具体，它显式写了 layout 时以它为准。
-    if explicit_layout and "layout" not in (vis.get("theme_overrides") or {}):
-        theme["layout"] = explicit_layout
-    if explicit_layout:
-        chap_layout = {ch: str(theme["layout"]) for ch in chapters}
 
-    return {
-        "version": 1,
-        "generator": "stylekit 0.5.0",
-        "style": sid,
-        "style_name": pack["name"],
-        "style_source": source,
-        "style_reason": list(reason),
-        "legacy": bool(is_legacy(sid)),
-        "fingerprint": fp,
-        "theme_id": pack["theme"],
-        "theme_label": THEMES[pack["theme"]]["label"],
-        # 主题字典随计划一起返回：scenes.py 的 _scene_theme 优先用它（含 theme_overrides），
-        # 也方便 render.py 直接传给 draw_subtitle/write_ass，不必再按 id 查一次。
-        "theme": theme,
-        "layout_default": str(theme["layout"]) if explicit_layout else layouts[0],
-        "chapter_layout": chap_layout,
-        "music": {
-            "style": music_style,
-            "bpm": bpm, "bpm_source": bpm_source,
-            "key": key, "key_source": key_source,
-            "mood": mood, "mood_source": mood_source,
-            "seed": int(seed), "seed_effective": int(seed_effective),
-            "seed_from_content": bool(seed_from_content),
-        },
-        "voice": {
-            "map": voice_map,
-            "default": voce.get("default"),
-            "policy": policy,
-        },
-        "pacing": pacing,
-    }
+_AUTO_WARNED = []
+
 
+def _warn_auto_style_once():
+    """每天每进程只喊一次：自动选型已经不该再用了。"""
+    if _AUTO_WARNED:
+        return
+    _AUTO_WARNED.append(1)
+    import sys as _sys
+    print("[stylekit][deprecated] style=auto 的自动选型已停用（v1.0 / D3）。"
+          "\n  现在的主路径是 work/design.json：先 python propose.py --brief \"...\" 出方案，"
+          "\n  再 python propose.py --confirm --candidate A 冻结设计。"
+          "\n  想以出厂预设为起点：python propose.py --preset tech-deep ...",
+          file=_sys.stderr)
+
+
+def resolve_script_style(script):
+    """已删除：v1.0.1 起本技能没有内置风格表，这里只剩「明确报错 + 迁移指引」。
+
+    历史：v1.0.1 之前本函数按 8 套内置 STYLES 解析出一份风格计划
+    （主题 + 配乐 + 声线 + 节奏 + 版式轮换）。模板删掉后它已经没有可解析的对象——
+    但 v1.0.1 只删了表，没删这条函数，于是留下三个死分支：
+    `pick_style` / `STYLES[sid]` / `THEMES[...]`，任何一个被调用都是 NameError/KeyError，
+    连 `style="auto"` 都直接崩（v1.0.2 实测）。
+
+    为什么保留函数而不是删掉：`filmkit.style_plan` / `scenes.py` / `preflight` /
+    `qavmaf` 里还有「拿不到 plan 时回退到这里」的调用点。保留一个明确报错的入口，
+    那些点会得到一句能照着做的指引；删掉函数只会得到 AttributeError。
+    真正的计划只有两个来源：designkit.design_to_plan（work/design.json）或
+    render.resolve_style（已解析好的 script["_style"]）。
+    """
+    raw = script.get("style") if isinstance(script, dict) else None
+    extra = ("（收到 style=%r）" % (raw,)) if raw not in (None, "") else ""
+    raise ValueError(
+        "这个剧本没有可解析的设计%s：v1.0.1 起本技能不提供任何内置风格/模板，\n"
+        "  「写 style 走内置外观」与「不写 style 走老外观」两条路都已删除。\n"
+        "  正确做法（两步）：\n"
+        "    1) python propose.py --brief \"题材/要求\" --script <film.json> --n 3\n"
+        "    2) python propose.py --confirm --candidate A    # 冻结成 work/design.json\n"
+        "  然后 python render.py --script <film.json> --stage all\n"
+        "  （设计也可以手写 work/design.json，字段契约见 schemas/design.schema.json）"
+        % extra)
 
 # ============================================================================
 # 七、门禁：主题体检（对比度 / 明暗 / 结构）
@@ -971,71 +721,44 @@ def blend_theme(a, b, p):
 
 
 # ============================================================================
-# 九、CLI：看风格、看主题、跑门禁
+# 九、CLI：v1.0.1 起没有可列/可看的风格（模板已删）
 # ============================================================================
+#
+# 这个 CLI 以前有 --list / --show / --lint 三个动作，列的是内置 STYLES 表。
+# v1.0.1 删表时漏掉了这里，于是：--list/--show 直接 NameError: ALL_STYLE_IDS，
+# --lint 在空表上一条都不检查却 exit 0 —— 后者是最坏的一种：**假通过**。
+# 本版把三个动作改成「明确说明能力已迁移 + 非零退出码」，并把 lint_all / _describe
+# 一并删掉（留着就是死代码，下一个人会以为它还能用）。
 
 
-def _describe(sid):
-    pack = STYLES[sid]
-    th = THEMES[pack["theme"]]
-    lines = [
-        "[%s] %s  （theme=%s / layouts=%s）" % (sid, pack["name"], pack["theme"],
-                                                ",".join(pack["layouts"])),
-        "  tags      : %s" % "、".join(pack["tags"]),
-        "  keywords  : %s" % "、".join(th["keywords"]),
-        "  music     : %s 调池=%s  BPM 梯度=%s  mood=%s"
-        % (pack["music"]["scale"], ",".join(pack["music"]["keys"]),
-           ",".join(str(b) for b in pack["music"]["bpm_ladder"]), pack["music"]["mood"]),
-        "  voice     : %s" % ", ".join("%s=%s" % (k, v) for k, v in pack["voice"].items() if v),
-        "  pacing    : lead=%.2f tail=%.2f min_dur=%.1f"
-        % (pack["pacing"]["lead"], pack["pacing"]["tail"], pack["pacing"]["min_dur"]),
-        "  palette   : bg=%s bg2=%s ink=%s accent=%s"
-        % (th["bg"], th["bg2"], th["ink"], th["accent"]),
-        # 与 theme_lint 同口径：bg/bg2 两端取最差（旧版打中点值，会掩盖端点不达标）
-        "  contrast  : ink %.2f / muted %.2f / dim %.2f / accent %.2f（bg/bg2 最差端）"
-        % (bg_contrast(th, "ink"), bg_contrast(th, "muted"),
-           bg_contrast(th, "dim"), bg_contrast(th, "accent")),
-        "  font      : family=%s display=%spx hud=%s"
-        % (th["family"], th["scale"]["display"][0], th["hud"]),
-    ]
-    bad = theme_lint(th)
-    lines.append("  lint      : %s" % ("PASS" if not bad else "FAIL -> " + "；".join(bad)))
-    return "\n".join(lines)
+def _explain_removed(what):
+    print("[stylekit] %s 已随内置风格表一起删除（v1.0.1：本技能不提供任何模板）。" % what,
+          file=sys.stderr)
+    print("  现在没有「可选外观清单」，每一版外观都是现场生成的：", file=sys.stderr)
+    print("    python propose.py --brief \"题材/要求\" --script <film.json> --n 3", file=sys.stderr)
+    print("    python propose.py --confirm --candidate A      # 冻结 work/design.json", file=sys.stderr)
+    print("  想看某个设计长什么样 / 是否合规：", file=sys.stderr)
+    print("    python designkit.py --lint <design.json>", file=sys.stderr)
+    print("    python propose.py --show A", file=sys.stderr)
 
 
 def main(argv=None):
-    ap = argparse.ArgumentParser(description="风格包：列出 / 查看 / 体检")
-    ap.add_argument("--list", action="store_true", help="列出所有风格")
-    ap.add_argument("--show", metavar="ID", help="查看某个风格的完整字段")
-    ap.add_argument("--lint", action="store_true", help="全部内置主题走对比度门禁")
+    ap = argparse.ArgumentParser(
+        description="风格包工具（v1.0.1 起无内置风格：本命令只解释迁移，不再列外观清单）")
+    ap.add_argument("--list", action="store_true", help="（已移除）列出内置风格")
+    ap.add_argument("--show", metavar="ID", help="（已移除）查看某个内置风格")
+    ap.add_argument("--lint", action="store_true", help="（已移除）批量体检内置主题")
     ap.add_argument("--json", action="store_true", help="配合 --show 输出 JSON")
     a = ap.parse_args(argv)
     try:
         sys.stdout.reconfigure(encoding="utf-8", errors="replace")
     except Exception:                                   # noqa: BLE001
         pass
-    if a.show:
-        # 未知 id 以前是 KeyError traceback，现在给可用清单 + exit 2（与 render.py 的口径一致）
-        if a.show not in STYLES:
-            print("[未知风格] %r；可用：%s" % (a.show, " / ".join(ALL_STYLE_IDS)), file=sys.stderr)
-            return 2
-        if a.json:
-            import json
-            print(json.dumps({"style": STYLES[a.show],
-                              "theme": THEMES[STYLES[a.show]["theme"]]},
-                             ensure_ascii=False, indent=1, default=str))
-        else:
-            print(_describe(a.show))
-        return 0
-    if a.lint:
-        bad = lint_all()
-        for sid in STYLE_IDS:
-            print(("FAIL " if sid in bad else "PASS ") + sid
-                  + ("" if sid not in bad else "  " + "；".join(bad[sid])))
-        return 1 if bad else 0
-    for sid in ALL_STYLE_IDS:
-        print(_describe(sid))
-        print("")
+    if a.show or a.list or a.lint:
+        _explain_removed("--list / --show / --lint")
+        # 退出码 2：与 render.py 的「未知取值」口径一致（不是 1 的「跑失败」）。
+        return 2
+    ap.print_help()
     return 0