@remixmate/cli 0.9.1 → 0.9.2

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.1",
-  "generatedAt": "2026-06-13T02:35:04.526Z",
+  "version": "0.9.2",
+  "generatedAt": "2026-07-15T16:10:14.529Z",
   "skills": [
     {
       "id": "export-jianying",

package/package.json

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

package/skills/export-jianying/SKILL.md

@@ -65,15 +65,21 @@ python3 <SkillDir>/scripts/gen_jianying_draft.py \
 
 ### Read from a RenderPlan file (fallback, single-user / local debugging)
 
-When not using the database mode, read a local `render-plan.json`:
+When not using the database mode, read a local RenderPlan file:
 
 ```bash
 python3 <SkillDir>/scripts/gen_jianying_draft.py \
-  --from-render-plan output/render-plan.json \
+  --from-render-plan <path>.render-plan.json \
   --title "My Video"
 ```
 
-The script automatically extracts the following from `render-plan.json`:
+> ⚠️ Don't point `--from-render-plan` at a shared `output/render-plan.json`. That
+> file is NOT produced by the default token-present pipeline (the plan goes to the
+> DB under a jobId), so anything sitting there is likely a stale leftover from an
+> unrelated run. Prefer the `--from-job-id` DB mode, or render with an explicit
+> `--save-render-plan --render-plan-output <path>` first.
+
+The script automatically extracts the following from the RenderPlan:
 - Each scene's visual asset URL (image / video)
 - TTS audio URL and duration
 - Subtitle text

package/skills/export-jianying/version.json

@@ -2,6 +2,6 @@
   "skillName": "export-jianying",
   "repoName": "agent-skill-media-maker",
   "skillId": "554",
-  "version": "V2",
+  "version": "V3",
   "skillDescription": "剪映草稿生成技能，将素材URL打包为剪映可导入的草稿ZIP，支持从 RenderPlan 自动转换（调用 ab-api /file/generateJianYing）。\n\n当用户提到以下任何需求时，立即使用本 skill：\n- 导出剪映、剪映草稿、打包剪映、导入剪映\n- 将素材导出为剪映格式、生成剪映工程\n- 把视频/图片/音频打包成剪映草稿\n- 从 RenderPlan 导出剪映草稿\n\n即使用户没有明确说「剪映」，只要他们想要将素材打包为可在剪映中编辑的草稿格式，也要使用本 skill。"
 }

package/skills/render-video/SKILL.md

@@ -73,9 +73,28 @@ python3 <SkillDir>/scripts/render_video.py --job-id <jobId>
 When the DB is unavailable, the script accepts a pre-generated RenderPlan file:
 
 ```bash
-python3 <SkillDir>/scripts/render_video.py --render-plan output/render-plan.json
+python3 <SkillDir>/scripts/render_video.py --render-plan <path>.render-plan.json
 ```
 
+> ⚠️ **Do NOT blindly point `--render-plan` at a shared `output/render-plan.json`.**
+> Under the default token-present path, `prepare_video_assets` / `render_video`
+> persist the plan to the **database (jobId)** only — they do **not** write
+> `output/render-plan.json`. Any file sitting there is likely a leftover from a
+> previous, unrelated run (the `output/` dir is gitignored scratch), and rendering
+> it silently produces the wrong video.
+>
+> To get a RenderPlan file on disk, generate it explicitly:
+> ```bash
+> python3 <SkillDir>/scripts/render_video.py --dsl video.dsl.json --template-id <id> \
+>   --resolve-only --save-render-plan --render-plan-output video.render-plan.json
+> ```
+> Or skip the file entirely and render in one shot:
+> `render_video.py --dsl video.dsl.json --template-id <id>`.
+>
+> On load, the script now prints a `↳ plan: templateId=… composition=… duration=… title=…`
+> summary, and warns if the plan file is older than a `--dsl` you also passed —
+> check that line matches what you intend before the render proceeds.
+
 ### Render and upload to Alibaba Cloud OSS (default behavior)
 
 ```bash

package/skills/render-video/scripts/render_video.py

@@ -1856,6 +1856,35 @@ def auto_bind_template(dsl: dict, template_id: str) -> dict:
     return binding
 
 
+def _log_render_plan_summary(render_plan: dict) -> None:
+    """Print a one-line identity summary of a loaded RenderPlan.
+
+    The two ways to feed an existing plan (``--render-plan <file>`` and
+    ``--job-id <int>``) used to print only the *source* (path / id), never the
+    *content*. When a stale ``output/render-plan.json`` from a previous, unrelated
+    run got picked up, the mismatch was rendered silently. Surfacing
+    templateId / title / duration / scene count here makes a wrong plan obvious
+    at a glance before any render time is spent.
+    """
+    try:
+        template_id = render_plan.get("templateId", "?")
+        title = render_plan.get("title", "")
+        cfg = render_plan.get("renderConfig", {}) or {}
+        fps = cfg.get("fps") or 30
+        total_frames = cfg.get("totalFrames")
+        scenes = len(render_plan.get("timeline", []) or [])
+        comp = (render_plan.get("remotionProps", {}) or {}).get("compositionId", "?")
+        dur = f"{total_frames / fps:.1f}s/{total_frames}f" if total_frames else "?"
+        LogPrint(
+            f"   ↳ plan: templateId={template_id} composition={comp} "
+            f"duration={dur} scenes={scenes}" + (f' title=\"{title}\"' if title else ""),
+            file=sys.stderr,
+        )
+    except Exception:
+        # A summary is a convenience, never a hard dependency of rendering.
+        pass
+
+
 def main():
     parser = argparse.ArgumentParser(
         description="Video render tool — DSL + TemplateBinding → Remotion video.",
@@ -1944,12 +1973,30 @@ Examples:
             sys.exit(1)
         render_plan = json.loads(render_plan_str)
         LogPrint(f"✅ RenderPlan loaded (jobId={args.job_id})", file=sys.stderr)
+        _log_render_plan_summary(render_plan)
     elif args.render_plan:
         if not os.path.exists(args.render_plan):
             LogPrint(f"❌ file does not exist: {args.render_plan}", file=sys.stderr)
             sys.exit(1)
         render_plan = load_json(args.render_plan)
         LogPrint(f"📋 loaded existing RenderPlan: {args.render_plan}", file=sys.stderr)
+        _log_render_plan_summary(render_plan)
+        # 陈旧文件防护：output/render-plan.json 等共享文件名常被上一次别的项目
+        # 的运行残留覆盖（output/ 是 gitignored 调试目录）。当用户同时给了 --dsl
+        # 用以表明"我想渲这个 DSL"，但磁盘上的 plan 比 DSL 还旧时，几乎可以肯定
+        # 加载到的是过期 plan —— 明确警告而不是静默渲染错的东西。
+        if args.dsl and os.path.exists(args.dsl):
+            try:
+                if os.path.getmtime(args.render_plan) < os.path.getmtime(args.dsl):
+                    LogPrint(
+                        f"⚠️  STALE RenderPlan? '{args.render_plan}' is OLDER than the DSL "
+                        f"'{args.dsl}'. You may be rendering a leftover plan from a previous "
+                        "run. Regenerate with --dsl ... --template-id ... (drop --render-plan) "
+                        "if the summary above doesn't match what you expect.",
+                        file=sys.stderr,
+                    )
+            except OSError:
+                pass
     else:
         if not args.dsl and not args.dsl_json:
             LogPrint(

package/skills/render-video/version.json

@@ -2,6 +2,6 @@
   "skillName": "render-video",
   "repoName": "agent-skill-media-maker",
   "skillId": "473",
-  "version": "V18",
+  "version": "V19",
   "skillDescription": "Final-render skill (Phase 3 of the two-phase video pipeline). Loads a persisted RenderPlan by job_id and drives Remotion to produce the final video. Assets must already be generated via prepare_video_assets."
 }