@remixmate/cli 0.1.2 → 0.9.2

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

@@ -1607,26 +1607,73 @@ def render_with_remote_api(
         template_id = render_plan.get("templateId", "")
         cover_composition_id = resolve_cover_composition_id(template_id)
 
-    payload = {
-        "compositionId": composition_id,
-        "renderConfig": config,
-        "inputProps": input_props,
-        "uploadTitle": effective_title,
-    }
-    if cover_composition_id:
-        payload["coverCompositionId"] = cover_composition_id
+    # ─── 私有模板路由 ────────────────────────────────────────────────────
+    # 仅【用户私有模板】(isBuiltin=false 且带 sourceOssKey) 源码在 OSS、不在
+    # ab-render 启动 bundle，需走动态渲染：presignSource 取临时 GET URL → /renderDraft。
+    # 内置模板即使带 sourceOssKey（builtin-template-registry 回填，仅服务
+    # derive_template 派生），渲染仍走 ab-render 预构建的 /render，绝不走 /renderDraft，
+    # 否则会用 OSS 上的旧快照 + DraftMainVideo 复刻渲染，与生产 MainVideo 漂移。
+    source_oss_key = None
+    template_id = render_plan.get("templateId", "")
+    if template_id:
+        try:
+            from registry_loader import get_template  # type: ignore
+            _meta = get_template(template_id)
+            if _meta and not _meta.get("isBuiltin"):
+                source_oss_key = _meta.get("sourceOssKey")
+        except Exception:
+            source_oss_key = None
+
+    if source_oss_key:
+        import render_job_client  # type: ignore
+        try:
+            src = render_job_client.presign_template_source(template_id, private_token)
+            tarball_url = src.get("tarballUrl")
+            if not tarball_url:
+                raise RuntimeError(f"presignSource 未返回 tarballUrl: {src}")
+        except Exception as exc:
+            LogPrint(f"❌ presignSource failed for private template {template_id}: {exc}", file=sys.stderr)
+            render_plan["status"] = "failed"
+            render_plan["errors"].append({
+                "phase": "render",
+                "message": f"presignSource failed: {exc}",
+                "timestamp": now_iso(),
+            })
+            return False
+        payload = {
+            "tarballUrl": tarball_url,
+            "inputProps": input_props,
+            "upload": True,
+            "uploadTitle": effective_title,
+        }
+        render_path = "/renderDraft"
+        status_path = "/renderDraftStatus"
+    else:
+        payload = {
+            "compositionId": composition_id,
+            "renderConfig": config,
+            "inputProps": input_props,
+            "uploadTitle": effective_title,
+        }
+        if cover_composition_id:
+            payload["coverCompositionId"] = cover_composition_id
+        render_path = "/render"
+        status_path = "/renderStatus"
 
     total_frames = config.get("totalFrames", 0)
     LogPrint(f"🎬 Submitting remote render task...", file=sys.stderr)
-    LogPrint(f"   Composition: {composition_id}", file=sys.stderr)
-    if cover_composition_id:
+    if source_oss_key:
+        LogPrint(f"   Private template (OSS dynamic bundle): {template_id}", file=sys.stderr)
+    else:
+        LogPrint(f"   Composition: {composition_id}", file=sys.stderr)
+    if cover_composition_id and not source_oss_key:
         LogPrint(f"   Cover: {cover_composition_id}", file=sys.stderr)
     LogPrint(f"   size: {config.get('width')}x{config.get('height')}", file=sys.stderr)
     LogPrint(f"   total frames: {total_frames}", file=sys.stderr)
     sys.stderr.flush()
 
     try:
-        task_id = remote_renderer_client.start_render(payload, private_token=private_token, conversation_id=conversation_id)
+        task_id = remote_renderer_client.start_render(payload, private_token=private_token, conversation_id=conversation_id, path=render_path)
     except Exception as exc:
         LogPrint(f"❌ remote render submission failed: {exc}", file=sys.stderr)
         render_plan["status"] = "failed"
@@ -1686,6 +1733,7 @@ def render_with_remote_api(
             interval=poll_interval,
             on_progress=_on_progress,
             adaptive_interval=True,
+            status_path=status_path,
         )
     except Exception as exc:
         LogPrint(f"❌ remote render polling failed: {exc}", file=sys.stderr)
@@ -1808,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.",
@@ -1896,21 +1973,48 @@ 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("❌ pass --dsl or --dsl-json (with --template-id), or --render-plan / --job-id", file=sys.stderr)
-            parser.print_help()
+            LogPrint(
+                "❌ render_video needs a DSL source. You provided neither --dsl/--dsl-json "
+                "nor --render-plan/--job-id.\n"
+                "   Typical flow: 1) gen_script → DSL skeleton  2) prepare_video_assets "
+                "(returns a job_id)  3) render_video with job_id=<int>.\n"
+                "   Or pass the DSL inline: render_video --dsl-json '<json>' --template-id <id>.",
+                file=sys.stderr,
+            )
             sys.exit(1)
 
         if not args.template_id:
-            LogPrint("❌ pass --template-id (--binding is no longer supported; binding is now computed in-memory from --template-id)", file=sys.stderr)
-            parser.print_help()
+            LogPrint(
+                "❌ render_video needs --template-id when rendering from --dsl/--dsl-json "
+                "(binding is computed in-memory from the template id; --binding is no longer supported).",
+                file=sys.stderr,
+            )
             sys.exit(1)
 
         # 解析 DSL：优先 --dsl-json（inline），其次 --dsl（文件路径）

package/skills/render-video/version.json

@@ -2,6 +2,6 @@
   "skillName": "render-video",
   "repoName": "agent-skill-media-maker",
   "skillId": "473",
-  "version": "V15",
+  "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."
 }

package/skills/template-registry/README.md

@@ -4,30 +4,29 @@ CLI 暴露面是「列出可用模板」(`--list-templates`)。把 Video DSL 场
 
 ## 模板数据来源
 
-模板元数据维护在独立仓库 **template-library**。本 skill 通过 `scripts/registry_loader.py` 按以下顺序解析:
+模板元数据维护在独立仓库 **template-library**，发布到 ab-api，运行时由本 skill 通过 `scripts/registry_loader.py` 从 **单一数据源（ab-api HTTP）** 加载：
 
-| 优先级 | 来源 | 触发条件 | 适用场景 |
-|---|---|---|---|
-| 1 | `VIDEO_TEMPLATE_REGISTRY` 指向的本地 JSON 文件 | 环境变量非空 | CI / 离线 / pinned 调试 |
-| 2 | `VIDEO_TEMPLATE_REGISTRY_URL`(ab-api 接口) | URL 设置 + `PRIV_TOKEN` 有效 | **生产** —— 多租户隔离由 ab-api 做 |
-| 3 | monorepo `template-library/packages/metadata/registry.json` | 本地源码可见 | 本地 dev / 单仓部署 |
+| 来源 | 触发条件 | 适用场景 |
+|---|---|---|
+| 显式 `VIDEO_TEMPLATE_REGISTRY_URL`（ab-api 接口） | 环境变量非空 + `PRIV_TOKEN` 有效 | 指定后端 |
+| 派生默认 URL `<MM_API_BASE_URL>/remotionTemplate/registry` | `VIDEO_TEMPLATE_REGISTRY_URL` 未设置 | 默认（含独立安装 codex / `npm i -g`，默认 `http://localhost:2999/api`） |
+
+只从 ab-api 取数，是为了避免「本地文件 / monorepo 源码 / 数据库」多源并存导致的不一致——私有 / 多租户模板只存在于 ab-api，本地源永远不全。默认 URL **内置在 remixmate-cli 自身**（按 CLI 后端约定 `MM_API_BASE_URL` 推导），不再依赖 ab-agent 等宿主在 spawn 时注入，独立运行即可找到 registry。指向你自己的 ab-api 只需设 `MM_API_BASE_URL`（或直接设 `VIDEO_TEMPLATE_REGISTRY_URL`）并配置 `PRIV_TOKEN`。
 
-`VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL=1` 开启后,#3 抢在 #2 之前——本地源码改动立即生效,不被 HTTP 缓存覆盖。
+HTTP 拉取带磁盘缓存（TTL + ETag/304）；瞬时故障时降级复用同一 URL 的上一份缓存（同源容错，非第二个数据源），无缓存则直接报错。
 
 ab-api 响应包装格式 `{code, msg, data}` 由 `registry_loader._fetch_http` 透明拆封;静态 JSON endpoint 也支持(直接返回 registry 文档)。
 
-> 早期文档曾描述本 skill 通过 `@ab-templates/metadata` npm 包消费 registry —— 该路径已被 ab-api HTTP 取代,但保留 monorepo 文件路径作为兜底。
+> 早期文档曾描述本 skill 通过 `@ab-templates/metadata` npm 包 / monorepo 文件消费 registry —— 这些本地来源已移除，运行时只走 ab-api HTTP。monorepo 文件仅供 `check_contracts.py` / `sync_registry.py` 等 monorepo-only 维护脚本使用。
 
 ## 新增模板工作流
 
-新增模板**不需要改 ab-skill / template-registry 代码**:
+新增模板**不需要改 remixmate / template-registry 代码**:
 
 1. 在 template-library 仓库定义新模板(`template.json` + 组件代码)。
 2. template-library CI 校验 schema + 契约。
 3. 合并后 template-library 的发布流水线将新 registry 推到 ab-api。
-4. ab-skill 端无需更新——下一次 `--list-templates` 即可看到新模板。
-
-本地调试时可通过 `VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL=1` 让 template-library 的源码改动立即生效,不依赖发布周期。
+4. remixmate 端无需更新——下一次 `--list-templates` 即可看到新模板。
 
 ## 契约一致性
 
@@ -45,7 +44,7 @@ python3 <SkillDir>/scripts/check_contracts.py
 
 ## 共享 Python 模块
 
-`scripts/` 是 ab-skill 内**跨 skill 共享 Python 代码**的约定位置。当前住户:
+`scripts/` 是 remixmate 内**跨 skill 共享 Python 代码**的约定位置。当前住户:
 
 | 模块 | 谁在用 | 作用 |
 |---|---|---|

package/skills/template-registry/SKILL.md

@@ -23,9 +23,9 @@ Stores every video-template definition, loads a template by **template-id**, and
 
 ## Template registry
 
-Template metadata lives in the standalone **template-library** monorepo and ships via the `@ab-templates/metadata` package.
+Template metadata is authored in the standalone **template-library** monorepo, published to ab-api, and served to the CLI over HTTP. At runtime template-registry loads the registry from a single source — the ab-api endpoint (see the env table below) — which returns every template definition (full slotMapping, compositions, etc.) including the caller's private/tenant templates.
 
-template-registry reads `template-library/packages/metadata/registry.json` to load every template definition (with the full slotMapping, compositions, etc.).
+> The `template-library/packages/metadata/registry.json` file below is the authoring layout in the monorepo. It is **not** read at runtime anymore; only monorepo-only maintenance tooling (`check_contracts.py`, `sync_registry.py`) touches it directly.
 
 ```
 template-library/packages/
@@ -62,22 +62,21 @@ The skill itself only reads the registry; whether a token is needed depends on t
 
 | Env var | Description | Default |
 |---------|-------------|---------|
-| `VIDEO_TEMPLATE_REGISTRY_URL` | ab-api endpoint returning the registry (production source of truth). | unset |
-| `PRIV_TOKEN` | Sent as `X-Priv-Token` when hitting `VIDEO_TEMPLATE_REGISTRY_URL`. | unset |
+| `VIDEO_TEMPLATE_REGISTRY_URL` | ab-api endpoint returning the registry (the single source of truth). | derived from `MM_API_BASE_URL` |
+| `MM_API_BASE_URL` | ab-api base URL the CLI talks to. When `VIDEO_TEMPLATE_REGISTRY_URL` is unset, the registry endpoint is derived as `<base>/remotionTemplate/registry`. | `http://localhost:2999/api` |
+| `PRIV_TOKEN` | Sent as `X-Priv-Token` when hitting the registry endpoint. Falls back to `~/.config/remixmate/credentials.json`. | unset |
 | `VIDEO_TEMPLATE_REGISTRY_HTTP_METHOD` | `POST` (default) or `GET`. POST shape matches ab-api `{code,msg,data}`. | `POST` |
-| `VIDEO_TEMPLATE_REGISTRY` | Explicit local file path — bypasses HTTP/fallback entirely (CI / pinned debug). | unset |
-| `VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL` | When `1`, monorepo `template-library/packages/metadata/registry.json` wins over HTTP. Defaults to HTTP-first. | unset |
 
-Resolution order (see `scripts/registry_loader.py` for the canonical implementation):
-`VIDEO_TEMPLATE_REGISTRY` → (optional PREFER_LOCAL fast-path to monorepo registry) → `VIDEO_TEMPLATE_REGISTRY_URL` → monorepo `template-library/packages/metadata/registry.json` fallback.
+Resolution (single source — see `scripts/registry_loader.py` for the canonical implementation):
+the registry is loaded **only** from the ab-api HTTP endpoint — explicit `VIDEO_TEMPLATE_REGISTRY_URL`, otherwise `<MM_API_BASE_URL>/remotionTemplate/registry` (default `http://localhost:2999/api/...`). There is no local-file / monorepo / PREFER_LOCAL fallback: those multi-source paths were removed to avoid registry skew (private/multi-tenant templates only exist on ab-api). On a transient HTTP failure the loader degrades to the on-disk cache of the same URL; with no cache it fails loud. A standalone install (Codex / `npm i -g`) just needs `MM_API_BASE_URL` (or `VIDEO_TEMPLATE_REGISTRY_URL`) pointed at your ab-api plus a valid `PRIV_TOKEN`.
 
 ## Steps
 
-> This skill is a Python skill of the ab-skill CLI (`entry.type: python` → `scripts/list_templates.py`). The agent tool name `template_registry` is the only entry; locally reproduce via `ab-skill template-registry --list-templates`. The list command delegates to `scripts/registry_loader.py` — the same loader (with caching + stable/beta gating) that `render-video` and `gen-script` import in-process, so there is a single registry-reading implementation.
+> This skill is a Python skill of the remixmate CLI (`entry.type: python` → `scripts/list_templates.py`). The agent tool name `template_registry` is the only entry; locally reproduce via `remixmate template-registry --list-templates`. The list command delegates to `scripts/registry_loader.py` — the same loader (with caching + stable/beta gating) that `render-video` and `gen-script` import in-process, so there is a single registry-reading implementation.
 >
 > The Python binding logic that maps DSL → TemplateBinding lives in `scripts/match_template.py` but is **not exposed as a CLI** — it is only consumed as a Python library by `render-video`'s `render_video.py` via `import match_template`.
 
-1. **List available templates**: run `ab-skill template-registry --list-templates` to view the templates in the registry along with their supported aspect ratios / style tags, and decide which `templateId` to pick.
+1. **List available templates**: run `remixmate template-registry --list-templates` to view the templates in the registry along with their supported aspect ratios / style tags, and decide which `templateId` to pick.
 2. **Write the DSL**: when generating the Video DSL, put the chosen `templateId` into `meta.templateId` (the canonical location). Use `meta.templateVariant` / `renderHints.templateVariant` to explicitly select a variant. The legacy `renderHints.templatePreference[0]` is still tolerated by `match_template.py` and `dsl_validator._pick_template_id` during transition, but new authors should write `meta.templateId`.
 3. **Produce the TemplateBinding**: there is no standalone CLI for DSL → TemplateBinding; `prepare_video_assets` calls `match_template.build_binding(template, dsl)` inline during the asset-resolution pipeline and embeds the binding into the RenderPlan it hands to the renderer — no separate `*.binding.json` file is written.
 
@@ -86,7 +85,7 @@ Resolution order (see `scripts/registry_loader.py` for the canonical implementat
 ### List available templates
 
 ```bash
-ab-skill template-registry --list-templates
+remixmate template-registry --list-templates
 ```
 
 ### Sync the registry cache (optional, used for offline / LLM prompt)
@@ -233,4 +232,4 @@ With `picture-book-en`, **narration reads English only, never Chinese**:
 
 - **No template specified**: the DSL must set `meta.templateId` (or, for legacy DSLs only, `renderHints.templatePreference[0]`); otherwise `prepare_video_assets` refuses to build a binding and prints the list of available templates.
 - **Malformed DSL**: validate first with `gen-script --validate` (delegates to `video_dsl.runtime.dsl_validator.validate_structural`).
-- **Empty template registry**: confirm `VIDEO_TEMPLATE_REGISTRY_URL` is reachable, or that the monorepo `template-library/packages/metadata/registry.json` fallback exists.
+- **Empty template registry**: confirm the ab-api registry endpoint (`VIDEO_TEMPLATE_REGISTRY_URL`, or the one derived from `MM_API_BASE_URL`) is reachable and that `PRIV_TOKEN` is valid.

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

@@ -1,17 +1,29 @@
 #!/usr/bin/env python3
 """
-模板 registry 加载器 - 统一抽象本地文件 / HTTP API 两种数据源。
+模板 registry 加载器 - 单一数据源（ab-api HTTP）。
 
 为什么独立成一个模块：
   template-registry、render-video 等多个 skill 都要读 registry，集中在一处便于：
     - 缓存策略一致（HTTP 拉取 5 分钟 TTL + ETag 复用）
-    - 解析顺序一致（环境变量 → 本地文件 → monorepo 回退）
-    - 错误降级一致（HTTP 故障时复用上一次缓存）
+    - 错误降级一致（HTTP 故障时复用上一次磁盘缓存）
 
-环境变量解析优先级（高 → 低）：
-  1. VIDEO_TEMPLATE_REGISTRY        显式本地文件路径（CI / 调试）
-  2. VIDEO_TEMPLATE_REGISTRY_URL    HTTP API（生产，多租户由 ab-api 鉴权过滤）
-  3. monorepo 默认回退               <repo>/template-library/packages/metadata/registry.json
+单一数据源（设计取舍）：
+  registry 只从 ab-api HTTP 接口加载，避免「本地文件 / monorepo 源码 / 数据库」
+  多源并存导致的不一致 —— 私有 / 多租户模板只存在于 ab-api，本地源永远不全。
+
+  URL 解析：
+    1. 显式 VIDEO_TEMPLATE_REGISTRY_URL（若设置则直接用）
+    2. 否则按 CLI 后端约定推导：
+         <MM_API_BASE_URL>/remotionTemplate/registry
+       MM_API_BASE_URL 默认 http://localhost:2999/api（与 src/http.ts 一致），
+       兼容 ab-agent 注入的 MM_BACKEND_API_URL。默认值内置在 CLI 自身，独立安装
+       （codex / npm i -g）开箱即用，无需宿主在 spawn 时注入。
+
+  鉴权：PRIV_TOKEN（env）或 ~/.config/remixmate/credentials.json（同源条目）。
+
+  monorepo / 显式本地文件等其它来源已**移除**。需要离线 / pinned 数据的维护脚本
+  （check_contracts.py / sync_registry.py）直接走 template_paths 读 monorepo，
+  那是 monorepo-only 工具，不是运行时数据源。
 
 P1.2 — list/detail split (待后端就绪)：
   100+ 模板时 ``GET /api/template/list`` 应该只返摘要（id / name / aspects /
@@ -21,14 +33,6 @@ P1.2 — list/detail split (待后端就绪)：
   改成「先拉摘要,触发 ``get_template`` 时再补全」,公共 API 不变。
   调用方今天用 ``get_template(id)`` / ``list_templates()`` 已经是按需消费的形态,
   迁移时不需要改任何 caller。
-
-本地 dev 调试开关：
-  VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL=1
-    将 monorepo registry.json 提到 #2 之前 —— 即"软优先"语义：
-      - monorepo 文件存在 → 用本地源码（与 template-library 改动严格一致）
-      - monorepo 文件不存在 → 自动落到 HTTP API，行为与未开启此开关时一致
-    设计意图：让本地开发避开"数据库 template_json 与 template-library 源码不一致"
-    导致的渲染问题，同时不破坏在容器/CI 中错误启用此开关时的鲁棒性。
 """
 
 from __future__ import annotations
@@ -43,8 +47,7 @@ import urllib.error
 import urllib.request
 from functools import lru_cache
 from typing import Optional
-
-from template_paths import monorepo_registry_path
+from urllib.parse import urlparse
 
 __all__ = [
     "load_registry_data",
@@ -67,14 +70,28 @@ _CACHE_DIR = os.environ.get(
 )
 
 
-def _monorepo_fallback_path() -> str:
-    """monorepo 内 registry.json 的路径（仅 dev / 本地单仓部署用）。
+# CLI 默认后端 base，与 remixmate-cli/src/http.ts 的 DEFAULT_API_BASE_URL 保持一致。
+_DEFAULT_API_BASE_URL = "http://localhost:2999/api"
+
 
-    路径解析现已统一到 ``template_paths.monorepo_registry_path``;
-    本函数保留只是为了让模块内其它函数（``_load_from_url`` 的兜底分支）
-    继续按既有名字调用。
+def _default_registry_url() -> str:
+    """未显式配置 VIDEO_TEMPLATE_REGISTRY_URL 时，推导默认 ab-api registry endpoint。
+
+    默认值内置在 CLI 自身（而非依赖 ab-agent 等宿主在 spawn 时注入），这样
+    ``remixmate-cli`` 独立安装（codex / ``npm i -g``）也能开箱即用。
+
+    base 解析顺序与 CLI / ab-agent 对齐：
+      MM_API_BASE_URL（CLI ``src/http.ts`` 约定）
+        → MM_BACKEND_API_URL（ab-agent 约定，向后兼容）
+        → http://localhost:2999/api（本地 dev 兜底）
+    路径段固定为 ``/remotionTemplate/registry``（POST，返回 ``{code,msg,data}``）。
     """
-    return monorepo_registry_path()
+    base = (
+        os.environ.get("MM_API_BASE_URL", "").strip()
+        or os.environ.get("MM_BACKEND_API_URL", "").strip()
+        or _DEFAULT_API_BASE_URL
+    ).rstrip("/")
+    return f"{base}/remotionTemplate/registry"
 
 
 def _cache_path_for(url: str) -> str:
@@ -110,6 +127,60 @@ def _write_cached(cache_file: str, payload: dict) -> None:
         raise
 
 
+# ── PrivToken 解析（env → 凭证库回退）──────────────────────────────────────
+#
+# 与 CLI 的 resolve.ts 共享同一优先级与同一凭证文件路径（Req 7.5）。Python 侧只读
+# 文件存储（不读 keychain —— keychain 由 CLI 写/读，Python 用纯 stdlib 不引依赖）。
+
+def _credentials_file_path() -> str:
+    """凭证文件路径，与 CLI credential-store.ts 的 CRED_FILE 保持一致。"""
+    return os.path.join(os.path.expanduser("~"), ".config", "remixmate", "credentials.json")
+
+
+def _origin(url: str) -> tuple:
+    p = urlparse(url)
+    return (p.scheme, p.hostname, p.port)
+
+
+def _priv_token_from_credential_store(url: str) -> str:
+    """从 ~/.config/remixmate/credentials.json 取与 url 同源的 PrivToken。
+
+    匹配顺序：① 与 registry URL 同源（scheme/host/port）的条目；② 仅有单条目时直接用。
+    secret=='keychain' 的条目跳过（Python 无法读取 keychain）。任何异常静默返回空串。
+    """
+    try:
+        with open(_credentials_file_path(), encoding="utf-8") as f:
+            doc = json.load(f)
+    except (OSError, json.JSONDecodeError):
+        return ""
+    creds = doc.get("credentials") if isinstance(doc, dict) else None
+    if not isinstance(creds, dict) or not creds:
+        return ""
+
+    target = _origin(url)
+    for base_url, entry in creds.items():
+        if not isinstance(entry, dict) or entry.get("secret") == "keychain":
+            continue
+        if _origin(base_url) == target:
+            tok = str(entry.get("privToken") or "").strip()
+            if tok:
+                return tok
+    # 单条目兜底：CLI 通常只登录一个后端。
+    if len(creds) == 1:
+        entry = next(iter(creds.values()))
+        if isinstance(entry, dict) and entry.get("secret") != "keychain":
+            return str(entry.get("privToken") or "").strip()
+    return ""
+
+
+def _resolve_priv_token(url: str) -> str:
+    """PrivToken 解析：环境变量优先，空则回退凭证库（与 CLI 一致的优先级）。"""
+    env = os.environ.get("PRIV_TOKEN", "").strip()
+    if env:
+        return env
+    return _priv_token_from_credential_store(url)
+
+
 def _fetch_http(url: str, timeout: int) -> dict:
     """执行 HTTP 请求，自动加 X-Priv-Token / If-None-Match 头。
 
@@ -127,7 +198,7 @@ def _fetch_http(url: str, timeout: int) -> dict:
     headers = {"Accept": "application/json"}
     if method == "POST":
         headers["Content-Type"] = "application/json"
-    if token := os.environ.get("PRIV_TOKEN", "").strip():
+    if token := _resolve_priv_token(url):
         headers["X-Priv-Token"] = token
     if cached and (etag := cached.get("etag")):
         headers["If-None-Match"] = etag
@@ -166,10 +237,8 @@ def _fetch_http(url: str, timeout: int) -> dict:
 
 
 def _load_from_url(url: str, ttl: int, timeout: int) -> dict:
-    """先看缓存是否在 TTL 内；超期则远程拉取，失败时按以下顺序降级：
-       1. HTTP 缓存（fetchedAt 之后的最后一份成功响应）
-       2. monorepo 本地 registry.json（仅本地 dev 时存在）
-       3. 都没有则抛错
+    """先看缓存是否在 TTL 内；超期则远程拉取。失败时降级到磁盘缓存（同一 URL
+    上一份成功响应），无缓存则抛错 —— 不再回退本地文件 / monorepo，保证单一数据源。
     """
     cache_file = _cache_path_for(url)
     cached = _read_cached(cache_file)
@@ -181,38 +250,20 @@ def _load_from_url(url: str, ttl: int, timeout: int) -> dict:
     try:
         return _fetch_http(url, timeout)
     except Exception as exc:
-        # 1. HTTP 故障时降级：有缓存就继续用，写日志告警
+        # HTTP 故障时降级：有磁盘缓存就继续用（同一数据源的容错，不是第二个源）
         if cached:
             print(
                 f"⚠️  registry HTTP 拉取失败，降级使用本地缓存: {exc}",
                 file=sys.stderr,
             )
             return cached["data"]
-        # 2. 没缓存再尝试 monorepo fallback（本地 dev / 单仓库部署时这条路一定通）
-        fallback = _monorepo_fallback_path()
-        if os.path.exists(fallback):
-            print(
-                f"⚠️  registry HTTP 拉取失败且无 HTTP 缓存，降级使用 monorepo registry: {exc}",
-                file=sys.stderr,
-            )
-            return _load_from_file(fallback)
-        # 3. 都没有，向上抛
         raise RuntimeError(
-            f"registry HTTP 拉取失败且无可用缓存 / 本地 fallback: {url} ({exc})"
+            f"registry HTTP 拉取失败且无可用缓存: {url} ({exc})。"
+            f" 请确认 ab-api 可达、VIDEO_TEMPLATE_REGISTRY_URL / MM_API_BASE_URL"
+            f" 配置正确，并已设置有效 PRIV_TOKEN。"
         ) from exc
 
 
-def _load_from_file(path: str) -> dict:
-    """从本地文件加载并解析 registry.json。"""
-    with open(path, "r", encoding="utf-8") as f:
-        return json.load(f)
-
-
-def _truthy(value: str) -> bool:
-    """统一解析布尔型环境变量：1 / true / yes / on（大小写不敏感）。"""
-    return value.strip().lower() in ("1", "true", "yes", "on")
-
-
 def load_registry_data(
     *,
     ttl_seconds: int = _DEFAULT_TTL_SECONDS,
@@ -220,56 +271,21 @@ def load_registry_data(
 ) -> dict:
     """加载 registry 完整文档（含 version / generatedAt / templates）。
 
-    解析顺序：
-      1. 环境变量 VIDEO_TEMPLATE_REGISTRY 指定的本地文件
-      2. 若 VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL 开启且 monorepo registry 存在，先走本地
-      3. 环境变量 VIDEO_TEMPLATE_REGISTRY_URL 指定的 HTTP API（带缓存）
-      4. monorepo 默认回退（仅本地 dev 有效）
-
-    任何来源都返回相同形状的 dict，调用方按 `data.get("templates", [])` 取列表。
+    单一数据源：ab-api HTTP。URL 取显式 ``VIDEO_TEMPLATE_REGISTRY_URL``，
+    未设置则按 ``MM_API_BASE_URL`` 推导（见 ``_default_registry_url``）。
+    带磁盘缓存（TTL + ETag/304），返回 ``data.get("templates", [])`` 形状的 dict。
     """
-    if explicit_path := os.environ.get("VIDEO_TEMPLATE_REGISTRY", "").strip():
-        print(f"[registry_loader] using explicit file: {explicit_path}", file=sys.stderr)
-        return _load_from_file(explicit_path)
-
-    prefer_local = _truthy(os.environ.get("VIDEO_TEMPLATE_REGISTRY_PREFER_LOCAL", ""))
-    fallback = _monorepo_fallback_path()
-
-    if prefer_local and os.path.exists(fallback):
+    url = os.environ.get("VIDEO_TEMPLATE_REGISTRY_URL", "").strip()
+    if url:
+        print(f"[registry_loader] using HTTP registry: {url}", file=sys.stderr)
+    else:
+        url = _default_registry_url()
         print(
-            f"[registry_loader] PREFER_LOCAL=1, using monorepo registry: {fallback}",
+            f"[registry_loader] VIDEO_TEMPLATE_REGISTRY_URL unset; using derived"
+            f" default URL: {url}",
             file=sys.stderr,
         )
-        return _load_from_file(fallback)
-
-    if url := os.environ.get("VIDEO_TEMPLATE_REGISTRY_URL", "").strip():
-        if prefer_local:
-            # 走到这里说明开启了 PREFER_LOCAL 但 monorepo 文件不存在 —— 例如容器里
-            # 误启用此开关。给出明确告警，避免使用者以为还在用本地源码。
-            print(
-                f"[registry_loader] PREFER_LOCAL=1 but monorepo registry not found"
-                f" ({fallback}), falling back to HTTP: {url}",
-                file=sys.stderr,
-            )
-        else:
-            print(f"[registry_loader] using HTTP registry: {url}", file=sys.stderr)
-        return _load_from_url(url, ttl=ttl_seconds, timeout=http_timeout)
-
-    # 第 ③ 级：monorepo 相对路径兜底。仅在该文件【实际存在】时生效
-    # （私有 monorepo 本地源码可见的场景）。独立开源仓库 clone / npm 安装
-    # 后该路径不存在，这里静默跳过，不抛错、不中断，落到下方的可理解失败。
-    if os.path.exists(fallback):
-        print(
-            f"[registry_loader] using monorepo registry (default fallback): {fallback}",
-            file=sys.stderr,
-        )
-        return _load_from_file(fallback)
-
-    raise RuntimeError(
-        "找不到模板 registry。请设置 VIDEO_TEMPLATE_REGISTRY_URL（ab-api HTTP 接口）"
-        " 并配置有效的 PRIV_TOKEN，或用 VIDEO_TEMPLATE_REGISTRY 指向一份本地"
-        " registry.json。（monorepo 内本地源码可见时会自动走 template-library 兜底。）"
-    )
+    return _load_from_url(url, ttl=ttl_seconds, timeout=http_timeout)
 
 
 # ════════════════════════════════════════════════════════════════════════════
@@ -291,6 +307,11 @@ _DEFAULT_STATUS = "stable"
 _BETA_GATE_ENV = "ENABLE_BETA_TEMPLATES"
 
 
+def _truthy(value: str) -> bool:
+    """统一解析布尔型环境变量：1 / true / yes / on（大小写不敏感）。"""
+    return value.strip().lower() in ("1", "true", "yes", "on")
+
+
 def _truthy_env(name: str) -> bool:
     return _truthy(os.environ.get(name, ""))
 

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

@@ -136,6 +136,18 @@ def get_job(job_id: int, priv_token: str) -> dict:
     return _post("/renderJob/get", {"jobId": job_id}, priv_token)
 
 
+def presign_template_source(template_key: str, priv_token: str) -> dict:
+    """
+    为已注册私有模板的源码包申请临时 GET 下载 URL（渲染取包用）。
+
+    调 ab-api /remotionTemplate/presignSource，返回 { tarballUrl, sourceOssKey, version }。
+    ab-render 用 tarballUrl 走 /renderDraft 动态 bundle 渲染。
+
+    注意：presignSource 端点不在 /renderJob 下，路径以 / 开头直接拼到 _api_base。
+    """
+    return _post("/remotionTemplate/presignSource", {"templateKey": template_key}, priv_token)
+
+
 # ─── CLI self-test ────────────────────────────────────────────────────────────
 
 if __name__ == "__main__":

package/skills/template-registry/skill.json

@@ -5,7 +5,7 @@
   "category": "authoring",
   "title": "Video Template Registry",
   "description": "List all available video templates (templateId / name / aspect ratio / style tags). Template-to-DSL binding is no longer exposed as a separate step — once prepare_video_assets receives a template_id it runs the full DSL→RenderPlan pipeline internally.",
-  "envVars": ["PRIV_TOKEN", "VIDEO_TEMPLATE_REGISTRY", "VIDEO_TEMPLATE_REGISTRY_URL", "VIDEO_TEMPLATE_REGISTRY_HTTP_METHOD"],
+  "envVars": ["PRIV_TOKEN", "VIDEO_TEMPLATE_REGISTRY_URL", "MM_API_BASE_URL", "VIDEO_TEMPLATE_REGISTRY_HTTP_METHOD"],
   "entry": { "type": "python", "scriptPath": "scripts/list_templates.py" },
   "parameters": {
     "type": "object",

package/skills/template-registry/version.json

@@ -2,6 +2,6 @@
   "skillName": "template-registry",
   "repoName": "agent-skill-media-maker",
   "skillId": "475",
-  "version": "V12",
+  "version": "V13",
   "skillDescription": "视频模板仓库（列表查询）。存储所有视频模板定义，对外只暴露「列出可用模板」一个能力；DSL→TemplateBinding 的绑定逻辑已内嵌进 prepare-video-assets，不再作为独立步骤暴露。同时是跨 skill 共享 Python 库（registry_loader / match_template / template_paths / video_dsl 等）的存放位置。\n\n当用户提到以下任何需求时，立即使用本 skill：\n- 查看可用模板、列出所有模板"
 }