@remixmate/cli 0.9.31 → 0.9.32

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.31",
-  "generatedAt": "2026-09-14T15:38:04.716Z",
+  "version": "0.9.32",
+  "generatedAt": "2026-09-15T01:33:27.056Z",
   "skills": [
     {
       "id": "export-jianying",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.9.31",
+  "version": "0.9.32",
   "description": "AI media generation skills for Claude Code / Codex — 12 skills covering image, video, voice, digital human, web screenshot, web recording, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",

package/skills/gen-script/SKILL.md

@@ -55,6 +55,7 @@ The intent is to avoid the failure mode where "the generic DSL looks compatible
 1. Read the requested template's full definition from the registry — `template_registry` with `template_id=<the id>` and `json_output=true` emits that one template whole. This is the shipping source of truth, and unlike the summary list it truncates nothing. Do **not** ask for every template's full definition (`list_templates=true` + `full=true`): the whole registry is far more JSON than one tool result can carry, and the call fails instead of returning the contract.
 2. Read its `llmHint` end to end — that is where the template states how its on-screen text and its layouts must be authored.
 3. Read its `customPayloadSchema`: every template-specific field lives there, including the enum of legal `customPayload.slideId` values for multi-layout templates.
+3b. If the template ships `slideSchemas` (multi-layout templates do), **author `templateData` straight from `slideSchemas[slideId]`** — it is the only place the per-layout field names exist. Do not infer them: the same concept is named `name` in one layout, `label` in another and `era` in a third, and a wrong name is dropped in silence (see below).
 4. Combine that with the template's `slotMapping`, `requiredProps`, `optionalProps`, `propExtractors`, `assetRequirements`, `supportedAspectRatios`, `supportedDurations`, `constraints`, and `scenePatterns`.
 5. Generate the DSL in the template's native shape — not the generic DSL shape.
 6. Make sure the DSL explicitly contains every template-specific field, e.g. `templateData.words`, `customPayload.slideId`, `visuals.avatar.assetRef`.
@@ -69,6 +70,14 @@ When a template's `customPayloadSchema.slideId.enum` holds more than one value (
 
 A missing `slideId` is the quietest failure in the pipeline: the renderer drops the entire `templateData` and draws a single centred title — no error, no log, exit code 0.
 
+### Multi-layout templates: field names are per-layout, never guessable
+
+Picking the layout is only half of it. Each layout reads its own field names out of `templateData`, and a field the layout does not read is **dropped without a word** — that slot renders empty, or shows the component's built-in placeholder text, and the render still reports success.
+
+This has shipped broken videos: a 7-scene deck wrote `items[].title` where `html-slide`'s `feature-grid` reads `name`, `items[].description` where `timeline-axis` reads `detail`, and `title` / `subtitle` / `ctaText` where `closing-cta` reads `headline` / `actionLine` / `ctaLabel` / `ctaUrl`. Five of seven scenes rendered as empty cards and placeholder copy — after paying for TTS and the render.
+
+So: **copy the field names out of `slideSchemas[slideId]`.** The DSL validator now rejects unknown field names before any asset is generated and tells you the declared ones, but that check only fires for templates that ship `slideSchemas` — reading the contract is still the primary move, not the fallback.
+
 ### On-screen text: the rules live in the template, not here
 
 How the on-screen text layers should be *written* — whether the headline is a hook or a product name, how many subheadline lines survive, whether `**emphasis**` is parsed, where a link is allowed to appear — is a property of each template's layout, and its single source of truth is that template's `llmHint` in `template.json`. This skill deliberately does not restate any of it: a copy here would drift from the registry, and the registry is what actually renders.
@@ -476,4 +485,4 @@ prefix and version — not a short alias:
 |------|---------|
 | `gen_script.py` | Core script — produces the Video DSL JSON from a topic. |
 
-The authoritative per-template contract is the registry's `template.json` (`llmHint` + `customPayloadSchema` + `slotMapping`). `template_registry list_examples=true` lists local reference DSLs when any exist, but that directory does not ship — see *DSL schema* above.
+The authoritative per-template contract is the registry's `template.json` (`llmHint` + `customPayloadSchema` + `slideSchemas` + `slotMapping`) — everything you need to author against is in there, so read it rather than inferring field names from the template's name or from another template. `template_registry list_examples=true` lists local reference DSLs when any exist, but that directory does not ship — see *DSL schema* above.

package/skills/template-registry/scripts/list_templates.py

@@ -119,7 +119,7 @@ def _summarize(tpl: dict) -> dict:
     """The "choose a template" view: identity + selection criteria only.
 
     Deliberately excludes the authoring contract (llmHint in full,
-    customPayloadSchema, slotMapping, compositions, variants' style bodies) —
+    customPayloadSchema, slideSchemas, slotMapping, compositions, variants' style bodies) —
     that is what ``--template-id`` returns, one template at a time.
     """
     variants = tpl.get("variants")
@@ -154,8 +154,8 @@ def _summarize(tpl: dict) -> dict:
 def _detail_hint(template_id: str = "<templateId>") -> str:
     return (
         f"Summaries only. Run --template-id {template_id} --json-output for one "
-        "template's full definition (llmHint / customPayloadSchema / slotMapping / "
-        "variants) — that is the per-template authoring contract."
+        "template's full definition (llmHint / customPayloadSchema / slideSchemas / "
+        "slotMapping / variants) — that is the per-template authoring contract."
     )
 
 
@@ -258,6 +258,7 @@ def main() -> None:
                 "contract that does ship is the registry's template.json:\n"
                 "     • llmHint            — how this template's on-screen text and layouts must be authored\n"
                 "     • customPayloadSchema — every template-specific field, incl. the legal slideId values\n"
+                "     • slideSchemas        — for multi-layout templates: what templateData each slideId eats\n"
                 "     • slotMapping        — propExtractors / requiredProps / optionalProps\n"
                 "   Read it with `--template-id <id> --json-output` (one template's full "
                 "definition). Run `--list-templates` first if you need the ids;\n"
@@ -394,7 +395,7 @@ def main() -> None:
     first_id = str(visible[0].get("templateId", "<templateId>"))
     print(
         f"Full definition of one template: --template-id {first_id} --json-output "
-        "(llmHint / customPayloadSchema / slotMapping / variants)",
+        "(llmHint / customPayloadSchema / slideSchemas / slotMapping / variants)",
     )
 
 

package/skills/template-registry/video_dsl/runtime/dsl_validator.py

@@ -20,6 +20,7 @@ DSL 校验器 - 对 Video DSL v1alpha1 做结构校验与标准化。
 处理的模板时**不需要再改 remixmate 代码**。
 """
 
+import difflib
 import re
 from typing import Iterable, Optional
 
@@ -32,6 +33,22 @@ VALID_LAYOUTS = {"full-visual", "split-left-right", "split-top-bottom", "picture
 VALID_ASSET_TYPES = {"image", "video", "audio", "avatar", "subtitle", "bgm"}
 VALID_ASSET_SOURCES = {"existing", "gen-image", "gen-video", "gen-voice", "gen-digital-human"}
 
+# 由 Composition 消费、而非 slide 组件消费的字段。前八个与模板侧
+# utils/slidePayload.ts 的 FRAME_LEVEL_KEYS 同源 ——「整包态」binder 会把它们混进
+# templateData，出现在那里是正当的，不该被当成未声明字段。highlightMap 同理（模板
+# 一般在 slideSchemas._shared 里声明它，这里兜底没声明的情况）。
+_SLIDE_FRAME_LEVEL_KEYS = frozenset({
+    "slideId",
+    "titleText",
+    "subtitleText",
+    "watermarkText",
+    "narrationAssetId",
+    "narrationSrc",
+    "background",
+    "templateData",
+    "highlightMap",
+})
+
 # CJK 汉字范围（简繁通用）+ 常见中文标点
 _CJK_PATTERN = re.compile(r"[一-鿿㐀-䶿＀-￯　-〿]")
 
@@ -438,6 +455,137 @@ def _check_slide_id_chosen(dsl: dict) -> list[ValidationError]:
     return errors
 
 
+def _check_slide_payload_fields(dsl: dict) -> list[ValidationError]:
+    """逐版式校验 ``customPayload.templateData`` 的字段名。
+
+    为什么需要这道门禁:多版式模板里「slideId 决定 templateData 吃哪些字段」这条
+    契约,此前只存在于模板的 React 源码里 —— 而写 DSL 的 agent 只能看到 registry
+    下发的 ``template.json``。字段名猜错(把 ``name`` 写成 ``title``、把 ``detail``
+    写成 ``description``)时组件读到 undefined,要么渲染出内置的占位文案、要么整块
+    空白,**渲染成功、零日志、退出码 0**。真实案例:一份 7 场景的 DSL 里 5 个场景
+    中招,TTS 和渲染的钱全花完才在成片里看出来。
+
+    契约现在写在 ``template.json`` 的 ``slideSchemas`` 里(键 = slideId,值 = 该版式
+    的 JSON Schema),由 template-library 的 ``check:slide-schemas`` 与组件源码双向
+    对账。本函数按它核对每个场景,**未声明的字段名带 "did you mean" 提示** ——
+    收到这条错误的多半正是那个猜错了名字的 agent,直接把正确的名字给它。
+
+    没有声明 ``slideSchemas`` 的模板(全部单版式模板)一律跳过,不产生噪音。
+    """
+    tpl = _get_template_cfg(_pick_template_id(dsl))
+    if not tpl:
+        return []
+    schemas = tpl.get("slideSchemas")
+    if not isinstance(schemas, dict):
+        return []
+
+    tid = tpl.get("templateId", "<unknown>")
+    shared = ((schemas.get("_shared") or {}).get("properties") or {})
+    known_slides = [k for k in schemas if not k.startswith("_")]
+
+    errors: list[ValidationError] = []
+
+    for idx, scene in enumerate(dsl.get("scenes", []) or []):
+        sid = scene.get("id", f"scenes[{idx}]")
+        custom = scene.get("customPayload") or {}
+        if not isinstance(custom, dict):
+            continue
+        data = custom.get("templateData")
+        if not isinstance(data, dict):
+            data = scene.get("templateData")
+        if not isinstance(data, dict):
+            continue
+
+        slide_id = custom.get("slideId") or data.get("slideId")
+        if not isinstance(slide_id, str) or not slide_id:
+            continue  # 「没选版式」由 _check_slide_id_chosen 负责报
+
+        schema = schemas.get(slide_id)
+        if not isinstance(schema, dict):
+            # 版式名写错 —— 同样静默回落到 DefaultSlide,和没写一样致命。
+            errors.append(ValidationError(
+                f"scenes[{idx}].customPayload.slideId",
+                f"scene '{sid}' uses slideId '{slide_id}', which template '{tid}' does not "
+                "register — the frame silently falls back to a single centred title.\n"
+                f"     Available layouts: {', '.join(sorted(known_slides))}",
+            ))
+            continue
+
+        base = f"scenes[{idx}].customPayload.templateData"
+        errors += _check_payload_object(
+            data,
+            schema,
+            path=base,
+            scene=sid,
+            extra_allowed=shared,
+            # frame 级字段由 Composition 消费,「整包态」binder 会把它们混进
+            # templateData —— 出现在这里是正当的,不算未声明字段。
+            skip_keys=_SLIDE_FRAME_LEVEL_KEYS,
+        )
+
+        # 卡片数组:用户真正会写错的地方在这一层(items[].title vs items[].name)。
+        for key, sub in (schema.get("properties") or {}).items():
+            if not isinstance(sub, dict) or sub.get("type") != "array":
+                continue
+            item_schema = sub.get("items")
+            if not isinstance(item_schema, dict) or not item_schema.get("properties"):
+                continue
+            value = data.get(key)
+            if not isinstance(value, list):
+                continue
+            for i, item in enumerate(value):
+                if not isinstance(item, dict):
+                    continue
+                errors += _check_payload_object(
+                    item, item_schema, path=f"{base}.{key}[{i}]", scene=sid,
+                )
+
+    return errors
+
+
+def _check_payload_object(
+    data: dict,
+    schema: dict,
+    *,
+    path: str,
+    scene: str,
+    extra_allowed: Optional[dict] = None,
+    skip_keys: frozenset = frozenset(),
+) -> list[ValidationError]:
+    """一层对象的「未声明字段 + 缺必填字段」核对。数组元素与顶层共用这一份。"""
+    props = schema.get("properties")
+    if not isinstance(props, dict):
+        return []
+    allowed = set(props) | set(extra_allowed or {})
+
+    errors: list[ValidationError] = []
+
+    for key in data:
+        if key in allowed or key in skip_keys:
+            continue
+        hint = difflib.get_close_matches(key, sorted(allowed), n=1, cutoff=0.6)
+        suggestion = (
+            f" Did you mean '{hint[0]}'?" if hint
+            else f" Declared fields: {', '.join(sorted(allowed))}."
+        )
+        errors.append(ValidationError(
+            f"{path}.{key}",
+            f"scene '{scene}': the slide does not read '{key}' — the value is silently "
+            f"dropped and that slot renders empty (or shows the component's placeholder)."
+            f"{suggestion}",
+        ))
+
+    for key in schema.get("required") or []:
+        if data.get(key) is None:
+            errors.append(ValidationError(
+                f"{path}.{key}",
+                f"scene '{scene}': required field '{key}' is missing — without it the slide "
+                "renders its built-in placeholder instead of your content.",
+            ))
+
+    return errors
+
+
 def _check_narration_language_strict(dsl: dict) -> list[ValidationError]:
     """完整版:模板若声明 ``capabilities.narrationLanguageStrict`` 则强约束旁白语言。
 
@@ -525,6 +673,9 @@ def validate_integrity(dsl: dict) -> list[ValidationError]:
     # render-video 与 prepare_video_assets 都走这条 —— 而"没选版式"正是要在烧掉渲染
     # 积分之前拦住的东西。单版式模板不受影响,见 _check_slide_id_chosen。
     errors += _check_slide_id_chosen(dsl)
+    # 同理:字段名写错同样是「渲染成功但画面是空壳」,必须在烧掉 TTS / 渲染积分
+    # 之前拦住。只对声明了 slideSchemas 的模板生效,见 _check_slide_payload_fields。
+    errors += _check_slide_payload_fields(dsl)
     return errors
 
 
@@ -553,6 +704,7 @@ def validate_dsl(dsl: dict) -> list[ValidationError]:
     errors += _check_narration_items_count(dsl)
     errors += _check_narration_language_strict(dsl)
     errors += _check_slide_id_chosen(dsl)
+    errors += _check_slide_payload_fields(dsl)
     return errors