@remixmate/cli 0.9.57 → 0.9.59

package/skills/export-jianying/scripts/gen_jianying_draft.py

@@ -22,7 +22,9 @@ from __future__ import annotations
 import argparse
 import json
 import os
+import re
 import sys
+import tempfile
 import time
 import urllib.error
 import urllib.parse
@@ -75,30 +77,87 @@ PILL_SUBTITLE_POSITION_Y = -0.458
 # 剪映草稿根目录解析
 # ---------------------------------------------------------------------------
 
-DRAFT_ROOT_PRESETS = {
-    "mac": "~/Movies/JianyingPro/User Data/Projects/com.lveditor.draft",
-    # Windows 预设保留字面量 %LOCALAPPDATA%：在 Mac 上执行时不展开，
-    # 原样传给 API；用户在 Windows 解压时目录会自然匹配。
-    "windows": "%LOCALAPPDATA%/JianyingPro/User Data/Projects/com.lveditor.draft",
+# 剪映把 draftRootPath 原样写进 draft_meta_info.json（draft_root_path / draft_fold_path），
+# 所以它必须是**用户电脑上**的绝对路径。
+#
+# 2026-09-29 事故：agent 在服务器上跑本脚本，mac 预设 `~/...` 被 expanduser 成
+# `/root/Movies/...` 写进了草稿，用户 Mac 上根本没有这个目录。`~` / `%LOCALAPPDATA%`
+# 只能在「脚本就跑在那台目标电脑上」时展开，其余情况必须由调用方显式给出路径。
+DRAFT_ROOT_SUFFIX = ("JianyingPro", "User Data", "Projects", "com.lveditor.draft")
+
+# 报错时给调用方看的路径样例（<username> 要换成用户电脑上的真实用户名）。
+DRAFT_ROOT_TEMPLATES = {
+    "mac": "/Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft",
+    "windows": "C:/Users/<username>/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft",
 }
 
+_WINDOWS_ABS_PATH = re.compile(r"^[A-Za-z]:[\\/]")
+
+
+def draft_root_path_error(path: str) -> str:
+    """校验显式给出的草稿根目录；合法返回空串，否则返回原因。"""
+    if "<" in path or ">" in path:
+        return "still contains a placeholder such as <username>; replace it with the real value"
+    if path.startswith("~"):
+        return "'~' would expand on the machine running this script, not on the user's computer; pass an absolute path"
+    if "%" in path or "$" in path:
+        return "environment variables are not expanded; pass an absolute path"
+    if not (path.startswith("/") or _WINDOWS_ABS_PATH.match(path)):
+        return "must be an absolute path (/Users/... on macOS, C:/... on Windows)"
+    return ""
+
+
+def _local_draft_root(system: str) -> str:
+    """脚本恰好跑在目标系统上时，按本机环境推出草稿根目录；推不出返回空串。"""
+    if system == "mac" and sys.platform == "darwin":
+        return os.path.join(os.path.expanduser("~/Movies"), *DRAFT_ROOT_SUFFIX)
+    if system == "windows" and os.name == "nt":
+        local_app_data = os.environ.get("LOCALAPPDATA", "")
+        if local_app_data:
+            return os.path.join(local_app_data, *DRAFT_ROOT_SUFFIX)
+    return ""
+
 
 def resolve_draft_root_path(explicit: str, system: str) -> str:
     """
     解析剪映草稿根目录，按优先级：
-    1. 显式 --draft-root-path（做 expanduser）
-    2. --system 预设（mac → expanduser，windows → 字面量）
+    1. 显式 --draft-root-path：原样使用（不做 expanduser），但必须是绝对路径；
+    2. 未给路径且脚本就跑在 --system 指定的系统上：按本机 HOME / LOCALAPPDATA 推出；
+    3. 其余情况（典型是服务端 agent）：报错，要求调用方向用户要路径。
     返回值始终作为 draftRootPath 传给 API。
     """
-    if explicit:
-        return os.path.expanduser(explicit)
-    preset = DRAFT_ROOT_PRESETS.get(system)
-    if not preset:
+    if system not in DRAFT_ROOT_TEMPLATES:
         print(f"❌ unsupported --system value: {system} (supported: mac / windows)", file=sys.stderr)
         sys.exit(1)
-    if system == "mac":
-        return os.path.expanduser(preset)
-    return preset
+    template = DRAFT_ROOT_TEMPLATES[system]
+
+    if explicit:
+        path = explicit.strip()
+        # 去掉末尾分隔符，但保留 "C:/" 与 "/" 这种根本身。
+        while len(path) > 3 and path[-1] in "/\\":
+            path = path[:-1]
+        reason = draft_root_path_error(path)
+        if reason:
+            print(f"❌ invalid --draft-root-path {path!r}: {reason}", file=sys.stderr)
+            print(f"   expected shape on {system}: {template}", file=sys.stderr)
+            sys.exit(1)
+        return path
+
+    local = _local_draft_root(system)
+    if local:
+        return local
+
+    print(
+        f"❌ --draft-root-path is required: this script is not running on the user's {system} computer, "
+        f"so the Jianying draft directory cannot be derived here.",
+        file=sys.stderr,
+    )
+    print(f"   expected shape: {template}", file=sys.stderr)
+    print(
+        "   Ask the user for the real path (Jianying → Settings → Draft location) and pass it via --draft-root-path.",
+        file=sys.stderr,
+    )
+    sys.exit(1)
 
 
 def resolve_token() -> str:
@@ -456,6 +515,42 @@ def convert_render_plan_to_scenes(render_plan: dict) -> tuple:
     return scenes, width, height
 
 
+# --scenes 里认的字段。后端 JianYingSceneInput 只收前 8 个，textLayers 由本脚本后处理消费。
+SCENE_FIELDS = (
+    "videoUrl", "imageUrl", "duration", "width", "height",
+    "audioUrl", "audioDuration", "subtitleText", "textLayers",
+)
+# 纯标识、不影响草稿内容的字段：写了也无害，放行。
+SCENE_IGNORED_FIELDS = ("id", "sceneId")
+# 常见误写 → 正确字段名。
+#
+# 2026-09-29 线上会话：模型先写 image/audio 被拦，改成 imageUrl/audioUrl 后却把旁白
+# 写成了 text —— 这个字段以前被静默丢掉，草稿里没有字幕，模型还告诉用户「已包含字幕」。
+# 未知字段一律报错，比静默丢值强。
+SCENE_FIELD_ALIASES = {
+    "image": "imageUrl", "img": "imageUrl", "imageURL": "imageUrl", "image_url": "imageUrl",
+    "video": "videoUrl", "videoURL": "videoUrl", "video_url": "videoUrl",
+    "audio": "audioUrl", "audioURL": "audioUrl", "audio_url": "audioUrl",
+    "narration": "subtitleText", "text": "subtitleText", "subtitle": "subtitleText",
+    "caption": "subtitleText", "subtitle_text": "subtitleText",
+    "audio_duration": "audioDuration",
+}
+
+
+def unknown_field_error(index: int, scene: dict) -> None:
+    """scene 里出现不认识的字段就退出，并指出该用哪个字段名。"""
+    unknown = [k for k in scene if k not in SCENE_FIELDS and k not in SCENE_IGNORED_FIELDS]
+    if not unknown:
+        return
+    hints = []
+    for key in unknown:
+        target = SCENE_FIELD_ALIASES.get(key)
+        hints.append(f"'{key}' → use '{target}'" if target else f"'{key}' is not supported")
+    print(f"❌ scene {index + 1} has unsupported field(s): {'; '.join(hints)}", file=sys.stderr)
+    print(f"   supported fields: {', '.join(SCENE_FIELDS)}", file=sys.stderr)
+    sys.exit(1)
+
+
 def parse_scenes(scenes_arg: str) -> list:
     """解析 --scenes 参数：支持 inline JSON 字符串或文件路径"""
     # 尝试作为文件路径读取
@@ -489,6 +584,7 @@ def parse_scenes(scenes_arg: str) -> list:
         if not isinstance(scene, dict):
             print(f"❌ scene {i + 1} is malformed: must be an object", file=sys.stderr)
             sys.exit(1)
+        unknown_field_error(i, scene)
         if not scene.get("videoUrl") and not scene.get("imageUrl"):
             print(f"❌ scene {i + 1} is missing videoUrl or imageUrl", file=sys.stderr)
             sys.exit(1)
@@ -626,13 +722,77 @@ def poll_task_status(task_id: str, poll_interval: int = 5, max_wait: int = 300)
 def _encode_url(raw_url: str) -> str:
     """对 URL 中的非 ASCII 字符做 percent-encoding（保留已编码部分和合法字符）"""
     parsed = urllib.parse.urlparse(raw_url)
-    encoded_path = urllib.parse.quote(parsed.path, safe="/:@!$&'()*+,;=-._~")
+    # '%' 必须留在 safe 里：ab-api 返回的地址已经是编码过的（中文文件名 → %E9%A3…），
+    # 再编一次会变成 %25E9，对象 key 对不上；带签名的地址还会 SignatureDoesNotMatch。
+    encoded_path = urllib.parse.quote(parsed.path, safe="/:@!$&'()*+,;=-._~%")
     return urllib.parse.urlunparse(parsed._replace(path=encoded_path))
 
 
+def _url_without_query(raw_url: str) -> str:
+    """日志里只打对象地址：带签名的 query（Signature / OSSAccessKeyId）不进日志。"""
+    parsed = urllib.parse.urlparse(raw_url)
+    return urllib.parse.urlunparse(parsed._replace(query="", fragment=""))
+
+
+def upload_draft_zip(zip_path: str, file_name: str) -> str:
+    """
+    把后处理过的 ZIP 传回 ab-api（POST /file/uploadJianYingDraft），返回带签名的下载地址。
+
+    为什么必须传回：后处理（字幕样式 / textLayers）是在跑脚本的这台机器上做的。
+    服务端 agent 的本地文件用户拿不到，不传回的话用户下载到的仍是后端生成的原始 ZIP，
+    后处理等于白做。
+    """
+    boundary = "----RemixmateJianYing" + uuid.uuid4().hex
+    with open(zip_path, "rb") as f:
+        zip_data = f.read()
+    # filename 里放 ASCII 占位，真实（可能含中文的）文件名走独立的 fileName 字段，
+    # 避免 multipart 头部编码在不同服务端实现间的差异。
+    parts = [
+        f"--{boundary}".encode(),
+        b'Content-Disposition: form-data; name="fileName"',
+        b"",
+        file_name.encode("utf-8"),
+        f"--{boundary}".encode(),
+        b'Content-Disposition: form-data; name="file"; filename="draft.zip"',
+        b"Content-Type: application/zip",
+        b"",
+        zip_data,
+        f"--{boundary}--".encode(),
+        b"",
+    ]
+    body = b"\r\n".join(parts)
+
+    print(f"\n⬆️  Uploading post-processed draft ({len(zip_data) / 1024 / 1024:.1f} MB)...")
+    req = urllib.request.Request(
+        f"{API_BASE_URL}/file/uploadJianYingDraft",
+        data=body,
+        headers=_build_headers(f"multipart/form-data; boundary={boundary}"),
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=600) as resp:
+            result = json.loads(resp.read().decode("utf-8"))
+    except urllib.error.HTTPError as e:
+        print(f"❌ draft upload failed (HTTP {e.code})", file=sys.stderr)
+        sys.exit(1)
+    except (urllib.error.URLError, OSError, ConnectionError) as e:
+        print(f"❌ draft upload failed: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if result.get("code") != 0:
+        print(f"❌ draft upload failed: {result.get('msg', 'unknown error')}", file=sys.stderr)
+        sys.exit(1)
+    url = (result.get("data") or {}).get("downloadUrl", "")
+    if not url:
+        print("❌ draft upload succeeded but no download URL was returned", file=sys.stderr)
+        sys.exit(1)
+    print("   ✅ uploaded")
+    return url
+
+
 def download_zip(download_url: str, output_path: str) -> None:
     """下载 ZIP 文件到本地"""
-    print(f"\n⬇️  Downloading draft ZIP: {download_url[:80]}...")
+    print(f"\n⬇️  Downloading draft ZIP: {_url_without_query(download_url)}")
     safe_url = _encode_url(download_url)
     try:
         urllib.request.urlretrieve(safe_url, output_path)
@@ -906,6 +1066,39 @@ def has_text_layers(scenes: list) -> bool:
     return any(scene.get("textLayers") for scene in scenes)
 
 
+def _render_job_client():
+    """
+    导入共享的 render_job_client（在 skills/template-registry/scripts/，跨 skill 共享
+    Python 的约定位置，render-video 也是这么引的）。
+    """
+    shared = os.path.join(os.path.dirname(__file__), "..", "..", "template-registry", "scripts")
+    if shared not in sys.path:
+        sys.path.insert(0, shared)
+    import render_job_client  # noqa: PLC0415 — 路径注入之后才能导入
+
+    return render_job_client
+
+
+def print_draft_summary(scenes: list, width: int, height: int, draft_root_path: str) -> None:
+    """
+    打印草稿里**实际**装了什么。
+
+    调用方（agent）要据此向用户转述，而不是凭自己传了什么去猜——线上会话里模型把
+    被丢掉的字幕也说成「已包含」。
+    """
+    total = len(scenes)
+    video = sum(1 for s in scenes if s.get("videoUrl"))
+    image = sum(1 for s in scenes if s.get("imageUrl") and not s.get("videoUrl"))
+    audio = sum(1 for s in scenes if s.get("audioUrl"))
+    subtitle = sum(1 for s in scenes if s.get("subtitleText") or s.get("textLayers"))
+    duration = sum(float(s.get("duration") or 0) for s in scenes)
+    print("\n📦 Draft contents:")
+    print(f"   scenes: {total} (video {video}, image {image}), total {duration:.1f}s, canvas {width}x{height}")
+    print(f"   narration audio: {audio}/{total} scene(s)")
+    print(f"   subtitles / text layers: {subtitle}/{total} scene(s)")
+    print(f"   draft root written into the draft: {draft_root_path}")
+
+
 def main() -> None:
     parser = argparse.ArgumentParser(
         description="Jianying draft generator — packages asset URLs into a Jianying-importable draft ZIP",
@@ -941,7 +1134,10 @@ Scene fields:
         "--from-job-id",
         type=int,
         default=0,
-        help="Load the RenderPlan from the database (pass a jobId, replaces --from-render-plan; requires PRIV_TOKEN)",
+        help=(
+            "Load the RenderPlan from the database (pass a jobId; requires PRIV_TOKEN). When no source is given "
+            "and CONVERSATION_ID is set, the latest prepared job of that conversation is used automatically"
+        ),
     )
     parser.add_argument("--width", type=int, default=1080, help="Canvas width (default 1080)")
     parser.add_argument("--height", type=int, default=1920, help="Canvas height (default 1920)")
@@ -950,17 +1146,24 @@ Scene fields:
         "--system",
         choices=["mac", "windows"],
         default="mac",
-        help="Pick the draft-root preset by OS (default: mac)",
+        help="OS of the computer that will open the draft (default: mac)",
     )
     parser.add_argument(
         "--draft-root-path",
         default="",
-        help="Explicitly specify the Jianying draft root path (overrides the --system preset)",
+        help=(
+            "Absolute Jianying draft root on the user's computer, e.g. "
+            f"{DRAFT_ROOT_TEMPLATES['mac']} or {DRAFT_ROOT_TEMPLATES['windows']}. "
+            "Required unless this script runs on that computer itself; '~' and %%VARS%% are rejected"
+        ),
     )
     parser.add_argument(
         "--no-download",
         action="store_true",
-        help="Skip the ZIP download; only print the download URL (ignored when scenes include textLayers / subtitleText)",
+        help=(
+            "Do not keep a local copy of the ZIP; only print the download URL. When subtitles / textLayers "
+            "need post-processing the ZIP is fetched to a temp file, styled, uploaded back and the temp file removed"
+        ),
     )
     parser.add_argument("-o", "--output", default=None, help="Download path (default jianying_draft_{timestamp}.zip, prevents multi-user collisions)")
     parser.add_argument("--poll-interval", type=int, default=5, help="Polling interval (seconds, default 5)")
@@ -980,22 +1183,38 @@ Scene fields:
         print("❌ PrivToken not configured", file=sys.stderr)
         sys.exit(1)
 
+    conversation_id = os.environ.get("CONVERSATION_ID", "").strip()
+
+    # 没给任何素材来源、但处在一个会话里（ab-agent 会注入 CONVERSATION_ID）：
+    # 默认导出这个会话最近一版已准备好素材的任务。
+    if not (args.from_job_id or args.from_render_plan or args.scenes) and conversation_id:
+        rjc = _render_job_client()
+        try:
+            latest = rjc.latest_job(conversation_id, PRIVATE_TOKEN)
+        except RuntimeError as e:
+            print(f"❌ could not find the latest prepared render job of this conversation: {e}", file=sys.stderr)
+            print("   run prepare_video_assets first, or pass --from-job-id / --scenes", file=sys.stderr)
+            sys.exit(1)
+        args.from_job_id = int(latest["jobId"])
+        print(
+            f"📋 using the latest prepared render job of this conversation: "
+            f"jobId={args.from_job_id} (attempt {latest.get('attempt', '?')}, updated {latest.get('updateTime', '?')})"
+        )
+    elif args.scenes and conversation_id:
+        # 手写 scenes 时模型只能从聊天记录里拼素材 URL，而多轮之间它看不到之前的工具结果，
+        # 很容易拼出过期的旧版素材（线上会话里就是把用户改过的 v3 配音换回了 v1）。
+        print(
+            "⚠️  --scenes was hand-written; omit --scenes/--from-job-id to export the latest prepared "
+            "render job of this conversation instead of URLs copied from chat history",
+            file=sys.stderr,
+        )
+
     # --from-job-id 模式：从数据库加载 RenderPlan
     if args.from_job_id:
         print(f"📋 loading RenderPlan from database (jobId={args.from_job_id})...")
-        if not PRIVATE_TOKEN:
-            print("❌ --from-job-id mode requires PRIV_TOKEN", file=sys.stderr)
-            sys.exit(1)
-        # render_job_client lives in skills/template-registry/scripts/ — the
-        # shared location for cross-skill Python helpers (matches the pattern
-        # render-video uses for the same import).
-        _template_registry_scripts = os.path.join(
-            os.path.dirname(__file__), "..", "..", "template-registry", "scripts"
-        )
-        sys.path.insert(0, _template_registry_scripts)
-        from render_job_client import get_plan as rjc_get_plan
+        rjc = _render_job_client()
         try:
-            render_plan_str = rjc_get_plan(args.from_job_id, PRIVATE_TOKEN)
+            render_plan_str = rjc.get_plan(args.from_job_id, PRIVATE_TOKEN)
         except RuntimeError as e:
             print(f"❌ failed to fetch RenderPlan: {e}", file=sys.stderr)
             sys.exit(1)
@@ -1029,7 +1248,7 @@ Scene fields:
     else:
         # 传统模式：必须提供 --scenes 和 --title
         if not args.scenes:
-            print("❌ provide --scenes or --from-render-plan", file=sys.stderr)
+            print("❌ provide --from-job-id, --from-render-plan or --scenes", file=sys.stderr)
             parser.print_help()
             sys.exit(1)
         if not args.title:
@@ -1063,34 +1282,45 @@ Scene fields:
     result_data = poll_task_status(task_id, args.poll_interval, args.max_wait)
 
     download_url = result_data.get("downloadUrl", "")
-    file_name = result_data.get("fileName", "")
+    file_name = result_data.get("fileName", "") or "jianying_draft.zip"
 
     if not download_url:
         print("❌ generation finished but no download URL was returned", file=sys.stderr)
         sys.exit(1)
 
     print(f"\n🎉 Jianying draft generated successfully!")
-    if file_name:
-        print(f"   filename: {file_name}")
-    print(f"   download URL: {download_url}")
-
-    # 默认下载 ZIP；含 textLayers/subtitleText 时强制下载以便后处理
-    if args.no_download and not needs_postprocess:
-        print(f"\n💡 To download the ZIP, drop --no-download (or open the URL above)")
-        return
+    print(f"   filename: {file_name}")
 
-    if args.no_download and needs_postprocess:
-        print("⚠️  textLayers/subtitleText detected; --no-download is ignored (post-processing is local)")
-
-    output_path = args.output or f"jianying_draft_{int(time.time())}.zip"
-    download_zip(download_url, output_path)
-
-    # 后处理 textLayers / Pill 字幕样式
+    output_path = ""
     if needs_postprocess:
-        postprocess_draft_zip(output_path, scenes)
+        # 后处理必须先把 ZIP 拿到本地。--no-download 时落到临时文件，传回后删掉，
+        # 不在跑脚本的机器（常常是服务器）上留垃圾。
+        keep_local = not args.no_download
+        if keep_local:
+            output_path = args.output or f"jianying_draft_{int(time.time())}.zip"
+        else:
+            fd, output_path = tempfile.mkstemp(prefix="jianying_draft_", suffix=".zip")
+            os.close(fd)
+        try:
+            download_zip(download_url, output_path)
+            postprocess_draft_zip(output_path, scenes)
+            # 用户拿到的链接必须指向后处理之后的版本，否则字幕样式 / textLayers 全部丢失。
+            download_url = upload_draft_zip(output_path, file_name)
+        finally:
+            if not keep_local and os.path.exists(output_path):
+                os.remove(output_path)
+                output_path = ""
+    elif not args.no_download:
+        output_path = args.output or f"jianying_draft_{int(time.time())}.zip"
+        download_zip(download_url, output_path)
+
+    print_draft_summary(scenes, args.width, args.height, draft_root_path)
+    print(f"\n   download URL: {download_url}")
+    if output_path:
+        print(f"   local file: {output_path}")
 
     print(f"\n💡 How to import into Jianying:")
-    print(f"   1. Extract {output_path} into the Jianying draft directory:")
+    print(f"   1. Download and extract the ZIP into exactly this directory on the user's computer:")
     print(f"      {draft_root_path}")
     print(f"   2. Start or restart Jianying; the draft will appear in your project list")
 

package/skills/export-jianying/skill.json

@@ -4,7 +4,7 @@
   "tier": "orchestration",
   "category": "consuming",
   "title": "Jianying (CapCut) Draft Export",
-  "description": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. Supports automatic conversion from a RenderPlan.",
+  "description": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. By default exports the latest prepared render job of the current conversation (no scenes needed).",
   "auth": "required",
   "envVars": [
     "PRIV_TOKEN",
@@ -15,13 +15,17 @@
   "parameters": {
     "type": "object",
     "properties": {
+      "from_job_id": {
+        "type": "number",
+        "description": "Render job id to export (the `jobId` printed by prepare_video_assets). Omit it together with scenes to export the latest prepared job of the current conversation — preferred, because asset URLs copied from chat history go stale after re-renders"
+      },
       "from_render_plan": {
         "type": "string",
-        "description": "Build the draft from a RenderPlan JSON (replaces --scenes)"
+        "description": "Build the draft from a local RenderPlan JSON file (local debugging only)"
       },
       "scenes": {
         "type": "string",
-        "description": "Scene array as JSON (inline string or file path)"
+        "description": "Hand-written scene array as JSON — only for assets that never went through prepare_video_assets. Fields per scene: imageUrl | videoUrl (one required), duration (seconds, required), audioUrl, audioDuration, subtitleText, textLayers, width, height. Any other field (text, image, audio…) is rejected"
       },
       "title": {
         "type": "string",
@@ -41,15 +45,15 @@
           "mac",
           "windows"
         ],
-        "description": "Draft-root preset"
+        "description": "OS of the computer that will open the draft"
       },
       "draft_root_path": {
         "type": "string",
-        "description": "Explicit Jianying draft root path (overrides --system)"
+        "description": "Absolute Jianying draft root on the user's computer (Jianying → Settings → Draft location), e.g. /Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft or C:/Users/<username>/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft. Required when the agent runs on a server; never guess the username, ask the user"
       },
       "no_download": {
         "type": "boolean",
-        "description": "Do not download the ZIP; print the URL only"
+        "description": "Do not keep a local copy of the ZIP; print the download URL only"
       },
       "output": {
         "type": "string",
@@ -60,18 +64,18 @@
   },
   "ui": {
     "primary": [
-      "title"
-    ],
-    "advanced": [
       "system",
-      "width",
-      "height",
-      "output"
+      "draft_root_path"
     ],
+    "advanced": [],
     "hidden": [
+      "title",
+      "width",
+      "height",
+      "output",
+      "from_job_id",
       "from_render_plan",
       "scenes",
-      "draft_root_path",
       "no_download"
     ]
   }

package/skills/export-jianying/version.json

@@ -2,6 +2,6 @@
   "skillName": "export-jianying",
   "repoName": "agent-skill-media-maker",
   "skillId": "554",
-  "version": "V3",
+  "version": "V6",
   "skillDescription": "Jianying (CapCut) draft-generation skill. Packages asset URLs into a draft ZIP that Jianying can import; supports automatic conversion from a RenderPlan (calls ab-api /file/generateJianYing).\n\nUse this skill as soon as the user mentions any of these intents:\n- Export to Jianying, Jianying draft, package for Jianying, import into Jianying\n- Export materials to the Jianying format, generate a Jianying project\n- Bundle video / image / audio into a Jianying draft\n- Export a Jianying draft from a RenderPlan\n\nEven when the user does not say \"Jianying\" explicitly, use this skill whenever they want to package materials into a draft that can be edited in Jianying."
 }

package/skills/gen-digital-human/SKILL.md

@@ -29,7 +29,7 @@ Wraps ab-api's digital-human endpoints (the same ones the web studio uses), auth
 | Text-driven | avatar + text + voice → speech is synthesized, then drives the avatar | `POST /digital-human/video/generate` |
 | Audio-driven | avatar + existing audio URL → talking-head video | `POST /digital-human/video/generate` |
 | Check status | Poll a generation job | `POST /digital-human/video/status` |
-| Clone avatar | Custom avatar from a video (free) or portrait photo (costs HiFly credits) | `POST /digital-human/avatar/clone` |
+| Clone avatar | Custom avatar from a video (free) or portrait photo (charged per clone, refunded on failure) | `POST /digital-human/avatar/clone` |
 | Clone status | `cloning` / `done` / `failed` for a cloned avatar | `POST /digital-human/avatar/clone-status` |
 
 Avatar ids are opaque strings (e.g. `dh_xxx`) — always copy them from `--list-avatars`, never invent them.
@@ -88,7 +88,7 @@ The source must be a public http(s) URL (local files are not uploaded). Video: m
 # Video clone (free)
 remixmate gen-digital-human --clone --name "My presenter" --clone-url "https://example.com/me.mp4"
 
-# Portrait photo clone (costs HiFly credits)
+# Portrait photo clone (charged per clone)
 remixmate gen-digital-human --clone --clone-type image --name "My presenter" --clone-url "https://example.com/me.jpg"
 
 # Submit without waiting, then poll
@@ -119,7 +119,12 @@ remixmate gen-digital-human --clone-status --avatar-id dh_xxx
 
 ## Credits
 
-Every run charges credits. The CLI prints a footer on stdout when it does:
+Photo cloning and video generation charge credits (rates on https://www.remixmate.ai/pricing):
+
+- **Clone**: video clones are free. Photo clones cost a flat per-clone fee, charged at submission and refunded automatically if cloning fails.
+- **Video**: per second of output video (5 s minimum), charged when the video completes. The balance is checked before submission; too low → `insufficient_credits`, nothing is generated.
+
+The CLI prints a footer on stdout when a charge is reported in the response:
 
 ```
 💳 Charged 31 credits · balance 1,240

package/skills/gen-digital-human/skill.json

@@ -4,7 +4,7 @@
   "tier": "atomic",
   "category": "asset",
   "title": "Digital-Human Talking-Head",
-  "description": "Digital-human video (HiFly): list or clone avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL. Aspect ratio follows the avatar's cloned source and cannot be chosen.",
+  "description": "Digital-human video (HiFly): list or clone avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL. Aspect ratio follows the avatar's cloned source and cannot be chosen. Talking-head videos cost credits per second of output (5 s minimum); fails with insufficient_credits when the balance is too low.",
   "auth": "required",
   "joinsTake": true,
   "envVars": [
@@ -45,7 +45,7 @@
       },
       "clone": {
         "type": "boolean",
-        "description": "Clone mode: create a custom HiFly avatar from a video (free) or a portrait image (costs HiFly credits). Requires clone_url and name. Waits until cloning finishes unless wait=false."
+        "description": "Clone mode: create a custom HiFly avatar from a video (free) or a portrait image (costs credits per clone, refunded automatically if cloning fails; see the pricing page). Requires clone_url and name. Waits until cloning finishes unless wait=false."
       },
       "clone_url": {
         "type": "string",

package/skills/gen-digital-human/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-digital-human",
   "repoName": "agent-skill-media-maker",
   "skillId": "336",
-  "version": "V9",
+  "version": "V10",
   "skillDescription": "Digital-human (talking-head) skill backed by HiFly: list avatars, clone a custom avatar from a video or photo, drive an avatar with text (TTS) or an existing audio URL, and check the status of pending jobs.\n\nUse this skill immediately whenever the user asks for any of:\n- Digital human, talking-head video, AI presenter, virtual host\n- \"Make a talking-head video out of this script / this audio file\"\n- List or browse digital-human avatars\n- Clone / create a custom avatar from a video or photo\n\nEven without an explicit \"use AI\", any request that turns text or audio into a synthesized presenter video should route here."
 }

package/skills/prepare-video-assets/version.json

@@ -2,6 +2,6 @@
   "skillName": "prepare-video-assets",
   "repoName": "agent-skill-media-maker",
   "skillId": "476",
-  "version": "V5",
+  "version": "V6",
   "skillDescription": "Asset-preparation skill: resolves and generates every asset (image / audio / video) referenced by a Video DSL, persists a RenderPlan to the database, and returns a `job_id` for the subsequent `render_video` call.\n\nUse this skill as soon as the user mentions any of these intents:\n- Generate / prepare video assets, resolve assets, render-ready\n- \"Make me a video about X\" (the agent calls gen_script → prepare_video_assets → render_video)\n- Regenerate one asset (image / audio) for a specific scene\n\nNext step: after the user confirms the resolved assets, call `render_video` with the `job_id` returned by this skill.\n\n⚠️ Stop-and-confirm gate: this skill runs only after the user has confirmed the script, and after it returns you must show the resolved assets and wait for the user's explicit confirmation. Never call `render_video` in the same turn."
 }