@remixmate/cli 0.9.72 → 0.9.73

package/dist/template/init.js

@@ -1,133 +1,5 @@
-/**
- * `remixmate template init <dir> [--force]` — scaffold a starter project.
- *
- * Only Node + npm are required (requirement 3.1): the starter is fetched with
- * `npm pack` (works with whatever registry/proxy npm is configured for), unpacked
- * with the system `tar` (bsdtar ships with Windows 10+), then `npm install`ed.
- * No login is needed (requirement 3.5).
- */
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync, statSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { EXIT, SkillError } from '../errors.js';
-import { emitProgress } from '../progress.js';
-import { STARTER_PACKAGE, STARTER_TARBALL_ENV, STARTER_VERSION } from './constants.js';
-import { Output } from './project.js';
-import { runNpm, runProcess } from './proc.js';
-import { skillInstallHint } from '../install.js';
-function isNonEmptyDir(dir) {
-    if (!existsSync(dir))
-        return false;
-    if (!statSync(dir).isDirectory()) {
-        throw new SkillError(`❌ ${dir} 已存在且不是目录`, EXIT.USAGE);
-    }
-    return readdirSync(dir).length > 0;
-}
-/** Obtain the starter tarball: local override, else `npm pack` into `tmp`. Shared with `upgrade`. */
-export async function obtainStarterTarball(tmp, out) {
-    const override = (process.env[STARTER_TARBALL_ENV] ?? '').trim();
-    if (override) {
-        const file = path.resolve(override);
-        if (!existsSync(file)) {
-            throw new SkillError(`❌ ${STARTER_TARBALL_ENV} 指向的文件不存在: ${file}`, EXIT.USAGE);
-        }
-        out.info(`使用本地 starter 包: ${file}`);
-        return { file, label: `local:${path.basename(file)}` };
-    }
-    const spec = `${STARTER_PACKAGE}@${STARTER_VERSION}`;
-    out.info(`下载 ${spec} …`);
-    const res = await runNpm(['pack', spec, '--json', '--silent'], { cwd: tmp, stdio: 'pipe' });
-    if (res.code !== 0) {
-        const tail = res.stderr.trim().split('\n').slice(-5).join('\n');
-        throw new SkillError(`❌ npm pack ${spec} 失败（退出码 ${res.code}）。检查网络与 npm registry 配置。\n${tail}`, EXIT.BACKEND_UNREACHABLE);
-    }
-    let file;
-    try {
-        const parsed = JSON.parse(res.stdout);
-        if (parsed[0]?.filename)
-            file = path.join(tmp, parsed[0].filename);
-    }
-    catch {
-        // Older npm without --json support: fall back to whatever .tgz landed in tmp.
-    }
-    file ??= readdirSync(tmp).filter((f) => f.endsWith('.tgz')).map((f) => path.join(tmp, f))[0];
-    if (!file || !existsSync(file))
-        throw new SkillError('❌ npm pack 未产出 tarball');
-    return { file, label: spec };
-}
-export async function runInit(opts) {
-    const out = new Output(Boolean(opts.json));
-    if (!opts.dir)
-        throw new SkillError('❌ 缺少目标目录：remixmate template init <dir>', EXIT.USAGE);
-    // agent 常把 `~/remixmate-templates/x` 加引号传进来，shell 不会展开 —— 这里补上，
-    // 否则会在 cwd 下建一个字面量 `~` 目录。
-    const raw = opts.dir === '~' || /^~[\\/]/.test(opts.dir) ? path.join(os.homedir(), opts.dir.slice(1)) : opts.dir;
-    const dir = path.resolve(raw);
-    if (isNonEmptyDir(dir) && !opts.force) {
-        throw new SkillError(`❌ 目标目录非空: ${dir}\n   换一个空目录，或确认可以覆盖后加 --force。`, EXIT.USAGE);
-    }
-    const tmp = mkdtempSync(path.join(os.tmpdir(), 'remixmate-starter-'));
-    try {
-        emitProgress({ phase: 'template-init:fetch', progress: 0.1 });
-        const { file, label } = await obtainStarterTarball(tmp, out);
-        emitProgress({ phase: 'template-init:extract', progress: 0.4 });
-        mkdirSync(dir, { recursive: true });
-        // npm tarballs are rooted at `package/` — strip it so files land directly in <dir>.
-        const tar = await runProcess('tar', ['-xzf', file, '-C', dir, '--strip-components=1'], { stdio: 'pipe' });
-        if (tar.code !== 0) {
-            throw new SkillError(`❌ 解压 starter 失败（tar 退出码 ${tar.code}）: ${tar.stderr.trim().slice(0, 300)}`);
-        }
-        let installed = false;
-        if (!opts.skipInstall) {
-            emitProgress({ phase: 'template-init:install', progress: 0.6 });
-            out.info('安装依赖（npm install）…');
-            const inst = await runNpm(['install', '--no-audit', '--no-fund'], { cwd: dir, stdio: 'stderr' });
-            if (inst.code !== 0) {
-                throw new SkillError(`❌ npm install 失败（退出码 ${inst.code}）。工程文件已解压到 ${dir}，修复后在该目录重跑 npm install。`);
-            }
-            installed = true;
-        }
-        emitProgress({ phase: 'template-init:done', progress: 1 });
-        printNextSteps(out, dir, installed);
-        const result = { ok: true, dir, starter: label, installed };
-        out.result({ ...result });
-        return result;
-    }
-    finally {
-        rmSync(tmp, { recursive: true, force: true });
-    }
-}
-function printNextSteps(out, dir, installed) {
-    // 一律给绝对路径：agent 会话的 cwd 往往和用户终端不同，相对路径（尤其 ../../..）既难读又容易 cd 错。
-    // 含空格等字符时加引号，保证可以原样复制执行。
-    const cdTarget = /^[\w@%+=:,./\\~-]+$/.test(dir) ? dir : `"${dir}"`;
-    out.info('');
-    out.info(`✅ 模板工程已创建: ${dir}`);
-    out.info('');
-    out.info('下一步：');
-    out.info(`  cd ${cdTarget}`);
-    if (!installed)
-        out.info('  npm install');
-    out.info('  npm run dev                          # 打开 Remotion Studio 本地预览');
-    out.info('  remixmate template check <name>      # 本地校验（无需登录）');
-    out.info('  remixmate template preview <name>    # 远程渲染预览 mp4（需登录）');
-    out.info('  remixmate template publish <name>    # 发布为你的私有模板（需登录）');
-    out.info('');
-    out.info('在本地 agent 里使用：');
-    out.info('  Codex / WorkBuddy   在工程目录打开，agent 会读取 AGENTS.md');
-    out.info('  Claude Code         在工程目录打开，agent 会读取 CLAUDE.md（与 AGENTS.md 内容相同）');
-    out.info('  TraeWork            只认项目级 skill：在工程目录执行一次 remixmate install --project');
-    out.info('  其它宿主若还没装 skill：remixmate install');
-    out.info('  当前会话不在工程目录里时：先读 ' + path.join(dir, 'AGENTS.md') + '，或在该目录重开会话');
-    let hint = null;
-    try {
-        hint = skillInstallHint();
-    }
-    catch {
-        // 提示只是锦上添花，读回执失败不能让 init 失败。
-    }
-    if (hint) {
-        out.info('');
-        out.info(hint);
-    }
-}
+var k=Object.defineProperty;var m=(e,i)=>k(e,"name",{value:i,configurable:!0});import{existsSync as w,mkdirSync as u,mkdtempSync as x,readdirSync as E,rmSync as T,statSync as g}from"node:fs";import $ from"node:os";import o from"node:path";import{EXIT as f,SkillError as a}from"../errors.js";import{emitProgress as c}from"../progress.js";import{STARTER_PACKAGE as N,STARTER_TARBALL_ENV as A,STARTER_VERSION as R}from"./constants.js";import{Output as j}from"./project.js";import{runNpm as y,runProcess as b}from"./proc.js";import{skillInstallHint as v}from"../install.js";function C(e){if(!w(e))return!1;if(!g(e).isDirectory())throw new a(`❌ ${e} 已存在且不是目录`,f.USAGE);return E(e).length>0}m(C,"isNonEmptyDir");async function G(e,i){const l=(process.env[A]??"").trim();if(l){const t=o.resolve(l);if(!w(t))throw new a(`❌ ${A} 指向的文件不存在: ${t}`,f.USAGE);return i.info(`使用本地 starter 包: ${t}`),{file:t,label:`local:${o.basename(t)}`}}const n=`${N}@${R}`;i.info(`下载 ${n} …`);const r=await y(["pack",n,"--json","--silent"],{cwd:e,stdio:"pipe"});if(r.code!==0){const t=r.stderr.trim().split(`
+`).slice(-5).join(`
+`);throw new a(`❌ npm pack ${n} 失败（退出码 ${r.code}）。检查网络与 npm registry 配置。
+${t}`,f.BACKEND_UNREACHABLE)}let s;try{const t=JSON.parse(r.stdout);t[0]?.filename&&(s=o.join(e,t[0].filename))}catch{}if(s??=E(e).filter(t=>t.endsWith(".tgz")).map(t=>o.join(e,t))[0],!s||!w(s))throw new a("❌ npm pack 未产出 tarball");return{file:s,label:n}}m(G,"obtainStarterTarball");async function K(e){const i=new j(!!e.json);if(!e.dir)throw new a("❌ 缺少目标目录：remixmate template init <dir>",f.USAGE);const l=e.dir==="~"||/^~[\\/]/.test(e.dir)?o.join($.homedir(),e.dir.slice(1)):e.dir,n=o.resolve(l);if(C(n)&&!e.force)throw new a(`❌ 目标目录非空: ${n}
+   换一个空目录，或确认可以覆盖后加 --force。`,f.USAGE);const r=x(o.join($.tmpdir(),"remixmate-starter-"));try{c({phase:"template-init:fetch",progress:.1});const{file:s,label:t}=await G(r,i);c({phase:"template-init:extract",progress:.4}),u(n,{recursive:!0});const p=await b("tar",["-xzf",s,"-C",n,"--strip-components=1"],{stdio:"pipe"});if(p.code!==0)throw new a(`❌ 解压 starter 失败（tar 退出码 ${p.code}）: ${p.stderr.trim().slice(0,300)}`);let d=!1;if(!e.skipInstall){c({phase:"template-init:install",progress:.6}),i.info("安装依赖（npm install）…");const S=await y(["install","--no-audit","--no-fund"],{cwd:n,stdio:"stderr"});if(S.code!==0)throw new a(`❌ npm install 失败（退出码 ${S.code}）。工程文件已解压到 ${n}，修复后在该目录重跑 npm install。`);d=!0}c({phase:"template-init:done",progress:1}),U(i,n,d);const h={ok:!0,dir:n,starter:t,installed:d};return i.result({...h}),h}finally{T(r,{recursive:!0,force:!0})}}m(K,"runInit");function U(e,i,l){const n=/^[\w@%+=:,./\\~-]+$/.test(i)?i:`"${i}"`;e.info(""),e.info(`✅ 模板工程已创建: ${i}`),e.info(""),e.info("下一步："),e.info(`  cd ${n}`),l||e.info("  npm install"),e.info("  npm run dev                          # 打开 Remotion Studio 本地预览"),e.info("  remixmate template check <name>      # 本地校验（无需登录）"),e.info("  remixmate template preview <name>    # 远程渲染预览 mp4（需登录）"),e.info("  remixmate template publish <name>    # 发布为你的私有模板（需登录）"),e.info(""),e.info("在本地 agent 里使用："),e.info("  Codex / WorkBuddy   在工程目录打开，agent 会读取 AGENTS.md"),e.info("  Claude Code         在工程目录打开，agent 会读取 CLAUDE.md（与 AGENTS.md 内容相同）"),e.info("  TraeWork            只认项目级 skill：在工程目录执行一次 remixmate install --project"),e.info("  其它宿主若还没装 skill：remixmate install"),e.info("  当前会话不在工程目录里时：先读 "+o.join(i,"AGENTS.md")+"，或在该目录重开会话");let r=null;try{r=v()}catch{}r&&(e.info(""),e.info(r))}m(U,"printNextSteps");export{G as obtainStarterTarball,K as runInit};

package/dist/template/list.js

@@ -1,46 +1 @@
-/**
- * `remixmate template list` — the caller's own (non-builtin) templates.
- *
- * Uses ab-api `/remotionTemplate/myPage` (the "mine" view: user_id = caller,
- * is_builtin = 0, not deleted). The builtin filter is re-applied client side
- * so a backend change can never make this list show platform templates.
- */
-import { mmPost, resolveHttpContext } from '../http.js';
-import { padDisplay } from '../text.js';
-import { Output } from './project.js';
-const PAGE_SIZE = 100;
-const MAX_PAGES = 20;
-export async function runList(opts) {
-    const out = new Output(Boolean(opts.json));
-    const ctx = await resolveHttpContext('template-list', { privateToken: opts.token, apiBaseUrl: opts.apiBaseUrl });
-    const templates = [];
-    for (let current = 1; current <= MAX_PAGES; current++) {
-        const page = await mmPost(ctx, '/remotionTemplate/myPage', { current, pageSize: PAGE_SIZE }, { timeoutMs: 30_000 });
-        const list = page?.list ?? [];
-        for (const t of list) {
-            if (t.isBuiltin === true)
-                continue;
-            templates.push({
-                templateKey: String(t.templateKey ?? ''),
-                name: String(t.name ?? ''),
-                lifecycleStatus: typeof t.lifecycleStatus === 'string' ? t.lifecycleStatus : undefined,
-                coreVersion: typeof t.coreVersion === 'string' && t.coreVersion ? t.coreVersion : undefined,
-                updateTime: typeof t.updateTime === 'string' ? t.updateTime : undefined,
-            });
-        }
-        const total = page?.pager?.total ?? 0;
-        if (list.length < PAGE_SIZE || current * PAGE_SIZE >= total)
-            break;
-    }
-    if (templates.length === 0) {
-        out.info('还没有私有模板。用 remixmate template publish <name> 发布一个。');
-    }
-    else {
-        for (const t of templates) {
-            out.info(`  ${padDisplay(t.templateKey, 32)}${padDisplay(t.name, 24)}${padDisplay(t.lifecycleStatus ?? '', 12)}${t.updateTime ?? ''}`);
-        }
-    }
-    const result = { ok: true, templates };
-    out.result(result);
-    return result;
-}
+var f=Object.defineProperty;var m=(o,n)=>f(o,"name",{value:n,configurable:!0});import{mmPost as y,resolveHttpContext as d}from"../http.js";import{padDisplay as a}from"../text.js";import{Output as g}from"./project.js";const r=100,S=20;async function B(o){const n=new g(!!o.json),p=await d("template-list",{privateToken:o.token,apiBaseUrl:o.apiBaseUrl}),i=[];for(let t=1;t<=S;t++){const l=await y(p,"/remotionTemplate/myPage",{current:t,pageSize:r},{timeoutMs:3e4}),c=l?.list??[];for(const e of c)e.isBuiltin!==!0&&i.push({templateKey:String(e.templateKey??""),name:String(e.name??""),lifecycleStatus:typeof e.lifecycleStatus=="string"?e.lifecycleStatus:void 0,coreVersion:typeof e.coreVersion=="string"&&e.coreVersion?e.coreVersion:void 0,updateTime:typeof e.updateTime=="string"?e.updateTime:void 0});const u=l?.pager?.total??0;if(c.length<r||t*r>=u)break}if(i.length===0)n.info("还没有私有模板。用 remixmate template publish <name> 发布一个。");else for(const t of i)n.info(`  ${a(t.templateKey,32)}${a(t.name,24)}${a(t.lifecycleStatus??"",12)}${t.updateTime??""}`);const s={ok:!0,templates:i};return n.result(s),s}m(B,"runList");export{B as runList};

package/dist/template/preview.js

@@ -1,318 +1,7 @@
-/**
- * `remixmate template preview <name>` — render a draft mp4 on the real ab-render.
- *
- * Ported from template-library `scripts/preview-remote.mjs` (same HTTP contract,
- * same file-enumeration and sample-props rules). It deliberately does NOT
- * reimplement the DSL → TemplateBinding pipeline: preview answers "does this
- * code run in the real renderer"; binding correctness is `render-video`'s job.
- *
- * Sample props are contract-driven: they come from the template's own
- * `dsl-example.json` through the `slotMapping[slot].propExtractors` it declares,
- * plus two global conventions (scene.customPayload → props.templateData,
- * dsl.assets → resolvedAssets). Nothing here knows any specific template.
- */
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
-import path from 'node:path';
-import { EXIT, SkillError } from '../errors.js';
-import { resolveHttpContext } from '../http.js';
-import { emitProgress } from '../progress.js';
-import { IDENTITY_FILE, PREVIEW_MAX_LONG_EDGE, PREVIEW_MAX_SECONDS, PREVIEW_MAX_SHORT_EDGE, } from './constants.js';
-import { runCheck } from './check.js';
-import { Output, readJsonFile, requireProjectRoot, requireTemplateDir, validateTemplateName } from './project.js';
-import { RenderBusinessError, renderPost, resolveRenderBaseUrl } from './render-client.js';
-const FPS = 30;
-const DEFAULT_DURATION_SEC = 5;
-const DEFAULT_TIMEOUT_SEC = 180;
-// Same enumeration rules as preview-remote.mjs.
-const SKIP_DIRS = new Set(['node_modules', 'dist', '__pycache__', '.git']);
-const TEXT_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mts', '.cts', '.json', '.css', '.scss', '.md']);
-const MAX_FILE_BYTES = 512 * 1024;
-const WARN_TOTAL_BYTES = 20 * 1024 * 1024;
-/** Keys must stay in sync with the metadata schema's supportedAspectRatios enum. */
-const ASPECT_RATIOS = {
-    '16:9': [16, 9],
-    '9:16': [9, 16],
-    '1:1': [1, 1],
-    '3:4': [3, 4],
-    '4:3': [4, 3],
-};
-export const PREVIEW_LIMIT_MESSAGE = `草稿预览超出上限：长边 ≤ ${PREVIEW_MAX_LONG_EDGE}px、短边 ≤ ${PREVIEW_MAX_SHORT_EDGE}px、时长 ≤ ${PREVIEW_MAX_SECONDS} 秒。` +
-    '请缩短 --duration-sec，或减少 --props-json 的页数；正式出片用 remixmate render-video，不受此限。';
-// ── files ────────────────────────────────────────────────────────────────────
-export function collectFiles(root, warn = () => { }) {
-    const files = {};
-    let bytes = 0;
-    const walk = (dir) => {
-        for (const entry of readdirSync(dir, { withFileTypes: true })) {
-            const full = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                if (!SKIP_DIRS.has(entry.name))
-                    walk(full);
-                continue;
-            }
-            if (!TEXT_EXTS.has(path.extname(entry.name)))
-                continue;
-            if (/\.(test|spec)\./.test(entry.name))
-                continue;
-            // Local publish identity — not template source.
-            if (dir === root && entry.name === IDENTITY_FILE)
-                continue;
-            const size = statSync(full).size;
-            if (size > MAX_FILE_BYTES) {
-                warn(`  ⚠ 跳过超大文件（${(size / 1024).toFixed(0)} KB）：${path.relative(root, full)}`);
-                continue;
-            }
-            bytes += size;
-            files[path.relative(root, full).split(path.sep).join('/')] = readFileSync(full, 'utf8');
-        }
-    };
-    walk(root);
-    return { files, bytes };
-}
-// ── sample props ─────────────────────────────────────────────────────────────
-function applyExtractors(scene, extractors) {
-    const out = {};
-    for (const [propName, spec] of Object.entries(extractors ?? {})) {
-        if (!spec || typeof spec.from !== 'string')
-            continue;
-        const from = spec.from;
-        if (from === 'textLayers') {
-            const layer = (scene.textLayers ?? []).find((l) => l.role === spec.role);
-            if (layer?.content !== undefined)
-                out[propName] = layer.content;
-            continue;
-        }
-        const value = from.split('.').reduce((acc, k) => (acc == null ? acc : acc[k]), scene); // eslint-disable-line @typescript-eslint/no-explicit-any
-        if (value !== undefined)
-            out[propName] = value;
-    }
-    return out;
-}
-export function buildSampleProps(tplDir, tpl, compositionId, propsJson, warn = () => { }) {
-    const examplePath = path.join(tplDir, 'dsl-example.json');
-    const dsl = existsSync(examplePath) ? readJsonFile(examplePath) : null;
-    const assets = Array.isArray(dsl?.assets) ? dsl.assets : [];
-    // --props-json overrides props but keeps the example's asset table: assetRefs
-    // in the override still need something to resolve against.
-    if (propsJson !== undefined) {
-        let props;
-        try {
-            props = JSON.parse(propsJson);
-        }
-        catch (err) {
-            throw new SkillError(`❌ --props-json 解析失败: ${err.message}`, EXIT.USAGE);
-        }
-        return { props, assets, durationSec: null };
-    }
-    const scene = (dsl?.scenes ?? [])[0];
-    if (!scene)
-        return { props: {}, assets, durationSec: null };
-    const slot = (tpl.compositions ?? []).find((c) => c.compositionId === compositionId)?.slot;
-    const extractors = slot ? tpl.slotMapping?.[slot]?.propExtractors : undefined;
-    // Covers render through a dedicated channel and never declare slotMapping.cover.
-    if (slot && slot !== 'cover' && !extractors) {
-        warn(`  ⚠ template.json 的 slotMapping.${slot} 未声明 propExtractors —— 预览将只带 templateData。`);
-    }
-    const props = applyExtractors(scene, extractors);
-    if (scene.customPayload)
-        props.templateData = scene.customPayload;
-    return { props, assets, durationSec: typeof scene.duration === 'number' ? scene.duration : null, scene };
-}
-/** Narration → subtitle segments (exact from items[].atSec, else proportional by sentence). */
-export function buildSubtitleSegments(scene, totalFrames) {
-    const narration = scene?.audio?.narration;
-    if (!narration)
-        return [];
-    const finish = (segs) => segs
-        .filter((s) => s.text)
-        .map((s, i, arr) => ({
-        text: s.text,
-        startFrame: Math.max(0, Math.round(s.startFrame)),
-        endFrame: i === arr.length - 1 ? totalFrames : Math.round(arr[i + 1].startFrame),
-    }))
-        .filter((s) => s.endFrame > s.startFrame);
-    const items = Array.isArray(narration.items) ? narration.items : null;
-    if (items && items.length > 0 && items.some((it) => typeof it?.atSec === 'number')) {
-        let cursor = 0;
-        return finish(items.map((it) => {
-            const at = typeof it?.atSec === 'number' ? it.atSec * FPS : cursor;
-            cursor = at;
-            return { text: it?.text ?? '', startFrame: at };
-        }));
-    }
-    const text = typeof narration.text === 'string' ? narration.text.trim() : '';
-    if (!text)
-        return [];
-    const sentences = text.split(/(?<=[。！？!?])/).map((s) => s.trim()).filter(Boolean);
-    if (sentences.length === 0)
-        return [];
-    const weights = sentences.map((s) => Math.max(1, s.length));
-    const total = weights.reduce((a, b) => a + b, 0);
-    let acc = 0;
-    return finish(sentences.map((s, i) => {
-        const startFrame = (acc / total) * totalFrames;
-        acc += weights[i];
-        return { text: s, startFrame };
-    }));
-}
-/** Largest even-pixel frame of the given aspect that fits the draft preview limits. */
-export function previewDimensions(aspect) {
-    const [aw, ah] = ASPECT_RATIOS[aspect] ?? ASPECT_RATIOS['16:9'];
-    const landscape = aw >= ah;
-    const long = landscape ? aw : ah;
-    const short = landscape ? ah : aw;
-    const scale = Math.min(PREVIEW_MAX_LONG_EDGE / long, PREVIEW_MAX_SHORT_EDGE / short);
-    const even = (n) => Math.floor(n / 2) * 2;
-    const w = even(aw * scale);
-    const h = even(ah * scale);
-    return [w, h];
-}
-export function buildPreviewPlan(tplDir, opts, warn = () => { }) {
-    const tpl = readJsonFile(path.join(tplDir, 'template.json'));
-    const comps = Array.isArray(tpl.compositions) ? tpl.compositions : [];
-    const compositionId = opts.compositionId ?? comps[0]?.compositionId;
-    if (!compositionId)
-        throw new SkillError('❌ template.json 未声明 compositions', EXIT.USAGE);
-    if (opts.compositionId && !comps.some((c) => c.compositionId === compositionId)) {
-        throw new SkillError(`❌ composition "${compositionId}" 不在该模板中。可选: ${comps.map((c) => c.compositionId).join(', ')}`, EXIT.USAGE);
-    }
-    const { files, bytes } = collectFiles(tplDir, warn);
-    if (Object.keys(files).length === 0)
-        throw new SkillError('❌ 模板目录没有可提交的源文件');
-    if (bytes > WARN_TOTAL_BYTES)
-        warn(`  ⚠ 模板总体积 ${(bytes / 1024 / 1024).toFixed(1)} MB，接近 ab-render 的请求上限`);
-    const sample = buildSampleProps(tplDir, tpl, compositionId, opts.propsJson, warn);
-    const aspect = (tpl.supportedAspectRatios ?? [])[0] ?? '16:9';
-    const durationSec = Number(opts.durationSec ?? sample.durationSec ?? tpl.supportedDurations?.min ?? DEFAULT_DURATION_SEC);
-    const [width, height] = previewDimensions(aspect);
-    // An array of props = one page each, chained into a multi-entry timeline.
-    const propsList = Array.isArray(sample.props) ? sample.props : null;
-    const perSceneFrames = Math.max(1, Math.round(durationSec * FPS));
-    const totalFrames = propsList ? perSceneFrames * propsList.length : perSceneFrames;
-    const totalSeconds = totalFrames / FPS;
-    if (totalSeconds > PREVIEW_MAX_SECONDS) {
-        throw new SkillError(`❌ ${PREVIEW_LIMIT_MESSAGE}（本次 ${totalSeconds.toFixed(1)} 秒）`, EXIT.USAGE);
-    }
-    const subtitleSegments = propsList ? [] : buildSubtitleSegments(sample.scene, perSceneFrames);
-    const timeline = (propsList ?? [sample.props]).map((props, i) => {
-        const startFrame = i * perSceneFrames;
-        const endFrame = startFrame + perSceneFrames;
-        return {
-            sceneId: propsList ? `preview-${String(i + 1).padStart(2, '0')}` : 'preview',
-            compositionId,
-            startFrame,
-            endFrame,
-            durationFrames: perSceneFrames,
-            startTime: Number((startFrame / FPS).toFixed(2)),
-            endTime: Number((endFrame / FPS).toFixed(2)),
-            props,
-            layers: [],
-            subtitleSegments,
-            transition: { type: 'none', durationFrames: 0 },
-        };
-    });
-    const inputProps = {
-        timeline,
-        renderConfig: {
-            width,
-            height,
-            fps: FPS,
-            totalFrames,
-            totalDuration: Number(totalSeconds.toFixed(2)),
-            codec: 'h264',
-            crf: 18,
-            outputFormat: 'mp4',
-        },
-        resolvedAssets: sample.assets,
-        globalTypography: tpl.defaultTypography,
-        colorScheme: tpl.defaultColorScheme,
-        motionPreset: tpl.defaultMotionPreset,
-    };
-    return { files, inputProps, compositionId, totalSeconds };
-}
-function isLimitError(err) {
-    return JSON.stringify(err.payload ?? {}).includes('draft_preview_limit_exceeded');
-}
-function printScanIssues(out, err) {
-    const data = err.payload?.data;
-    const issues = data?.issues ?? err.payload?.issues;
-    if (!Array.isArray(issues) || issues.length === 0)
-        return false;
-    out.warn(`\n✗ 被 ab-render 的安全扫描拒绝（${issues.length} 处）：`);
-    for (const i of issues) {
-        out.warn(typeof i === 'string' ? `    · ${i}` : `    · ${i.file}\n      ${i.reason}${i.detail ? `: ${i.detail}` : ''}`);
-    }
-    out.warn('\n  先在本地运行 remixmate template check，它与平台使用同一份安全策略。');
-    return true;
-}
-export async function runPreview(opts) {
-    const out = new Output(Boolean(opts.json));
-    const name = validateTemplateName(opts.name);
-    const root = requireProjectRoot(opts.cwd);
-    const tplDir = requireTemplateDir(root, name);
-    emitProgress({ phase: 'template-preview:check', progress: 0.05 });
-    const checkCode = await runCheck({ name, cwd: root, stdio: opts.json ? 'stderr' : 'inherit' });
-    if (checkCode !== 0) {
-        throw new SkillError(`❌ 本地校验未通过（check 退出码 ${checkCode}），已中止预览。`, checkCode === 2 ? EXIT.USAGE : EXIT.ERROR);
-    }
-    const plan = buildPreviewPlan(tplDir, opts, (m) => out.warn(m));
-    const http = await resolveHttpContext('template-preview', { privateToken: opts.token, apiBaseUrl: opts.apiBaseUrl });
-    const base = resolveRenderBaseUrl();
-    const { width, height } = plan.inputProps.renderConfig;
-    out.info(`模板        ${name}`);
-    out.info(`composition ${plan.compositionId}`);
-    out.info(`画幅        ${width}×${height}  ${plan.totalSeconds.toFixed(1)}s @${FPS}fps`);
-    out.info(`文件        ${Object.keys(plan.files).length} 个`);
-    out.info(`ab-render   ${base}`);
-    const post = (route, body) => renderPost(base, route, body, { token: http.privateToken, skillName: 'template-preview' });
-    let taskId;
-    try {
-        emitProgress({ phase: 'template-preview:submit', progress: 0.1 });
-        const start = await post('/renderDraft', { files: plan.files, inputProps: plan.inputProps, upload: false });
-        if (!start.taskId)
-            throw new SkillError('❌ /renderDraft 未返回 taskId');
-        taskId = start.taskId;
-    }
-    catch (err) {
-        if (err instanceof RenderBusinessError) {
-            if (isLimitError(err))
-                throw new SkillError(`❌ ${PREVIEW_LIMIT_MESSAGE}`, EXIT.ERROR);
-            if (printScanIssues(out, err))
-                throw new SkillError('❌ 预览被安全扫描拒绝', EXIT.ERROR);
-        }
-        throw err;
-    }
-    out.info(`taskId      ${taskId}`);
-    const timeoutSec = opts.timeoutSec ?? DEFAULT_TIMEOUT_SEC;
-    const interval = opts.pollIntervalMs ?? 1500;
-    const deadline = Date.now() + timeoutSec * 1000;
-    let lastStatus = '';
-    for (;;) {
-        if (Date.now() > deadline) {
-            // A timeout doesn't mean the task is gone — it's usually still queued.
-            throw new SkillError(`❌ 轮询超时（${timeoutSec}s），任务 ${taskId} 仍在 ab-render 排队/渲染。\n` +
-                '   加长等待：--timeout-sec 900');
-        }
-        await new Promise((r) => setTimeout(r, interval));
-        const st = await post('/renderDraftStatus', { taskId });
-        if (st.status !== lastStatus) {
-            lastStatus = st.status ?? '';
-            out.info(st.status === 'pending' ? '排队中…（队列前面还有任务）' : `状态: ${st.status}`);
-        }
-        emitProgress({ phase: `template-preview:${st.status ?? 'unknown'}`, progress: 0.1 + 0.9 * (st.progress ?? 0), taskId });
-        if (st.status === 'succeeded') {
-            const url = st.previewUrl?.startsWith('http') ? st.previewUrl : `${base}${st.previewUrl ?? ''}`;
-            out.info(`\n✅ 预览就绪\n  ${url}`);
-            out.info('  临时产物，最长保留 24 小时（服务重启后可能更早失效）。');
-            const result = { ok: true, name, taskId, url, compositionId: plan.compositionId, durationSec: plan.totalSeconds };
-            out.result({ ...result });
-            return result;
-        }
-        if (st.status === 'failed') {
-            const detail = st.error ?? '（无错误详情）';
-            if (detail.includes('draft_preview_limit_exceeded'))
-                throw new SkillError(`❌ ${PREVIEW_LIMIT_MESSAGE}`);
-            throw new SkillError(`❌ 渲染失败: ${detail}`);
-        }
-    }
-}
+var O=Object.defineProperty;var f=(e,t)=>O(e,"name",{value:t,configurable:!0});import{existsSync as U,readdirSync as N,readFileSync as L,statSync as B}from"node:fs";import $ from"node:path";import{EXIT as x,SkillError as w}from"../errors.js";import{resolveHttpContext as C}from"../http.js";import{emitProgress as A}from"../progress.js";import{IDENTITY_FILE as G,PREVIEW_MAX_LONG_EDGE as R,PREVIEW_MAX_SECONDS as k,PREVIEW_MAX_SHORT_EDGE as j}from"./constants.js";import{runCheck as X}from"./check.js";import{Output as W,readJsonFile as M,requireProjectRoot as V,requireTemplateDir as J,validateTemplateName as Y}from"./project.js";import{RenderBusinessError as q,renderPost as z,resolveRenderBaseUrl as H}from"./render-client.js";const g=30,K=5,Q=180,Z=new Set(["node_modules","dist","__pycache__",".git"]),tt=new Set([".ts",".tsx",".js",".jsx",".mts",".cts",".json",".css",".scss",".md"]),et=512*1024,ot=20*1024*1024,D={"16:9":[16,9],"9:16":[9,16],"1:1":[1,1],"3:4":[3,4],"4:3":[4,3]},T=`草稿预览超出上限：长边 ≤ ${R}px、短边 ≤ ${j}px、时长 ≤ ${k} 秒。请缩短 --duration-sec，或减少 --props-json 的页数；正式出片用 remixmate render-video，不受此限。`;function nt(e,t=()=>{}){const r={};let n=0;const i=f(p=>{for(const o of N(p,{withFileTypes:!0})){const a=$.join(p,o.name);if(o.isDirectory()){Z.has(o.name)||i(a);continue}if(!tt.has($.extname(o.name))||/\.(test|spec)\./.test(o.name)||p===e&&o.name===G)continue;const s=B(a).size;if(s>et){t(`  ⚠ 跳过超大文件（${(s/1024).toFixed(0)} KB）：${$.relative(e,a)}`);continue}n+=s,r[$.relative(e,a).split($.sep).join("/")]=L(a,"utf8")}},"walk");return i(e),{files:r,bytes:n}}f(nt,"collectFiles");function st(e,t){const r={};for(const[n,i]of Object.entries(t??{})){if(!i||typeof i.from!="string")continue;const p=i.from;if(p==="textLayers"){const a=(e.textLayers??[]).find(s=>s.role===i.role);a?.content!==void 0&&(r[n]=a.content);continue}const o=p.split(".").reduce((a,s)=>a==null?a:a[s],e);o!==void 0&&(r[n]=o)}return r}f(st,"applyExtractors");function rt(e,t,r,n,i=()=>{}){const p=$.join(e,"dsl-example.json"),o=U(p)?M(p):null,a=Array.isArray(o?.assets)?o.assets:[];if(n!==void 0){let u;try{u=JSON.parse(n)}catch(h){throw new w(`❌ --props-json 解析失败: ${h.message}`,x.USAGE)}return{props:u,assets:a,durationSec:null}}const s=(o?.scenes??[])[0];if(!s)return{props:{},assets:a,durationSec:null};const d=(t.compositions??[]).find(u=>u.compositionId===r)?.slot,l=d?t.slotMapping?.[d]?.propExtractors:void 0;d&&d!=="cover"&&!l&&i(`  ⚠ template.json 的 slotMapping.${d} 未声明 propExtractors —— 预览将只带 templateData。`);const m=st(s,l);return s.customPayload&&(m.templateData=s.customPayload),{props:m,assets:a,durationSec:typeof s.duration=="number"?s.duration:null,scene:s}}f(rt,"buildSampleProps");function it(e,t){const r=e?.audio?.narration;if(!r)return[];const n=f(l=>l.filter(m=>m.text).map((m,u,h)=>({text:m.text,startFrame:Math.max(0,Math.round(m.startFrame)),endFrame:u===h.length-1?t:Math.round(h[u+1].startFrame)})).filter(m=>m.endFrame>m.startFrame),"finish"),i=Array.isArray(r.items)?r.items:null;if(i&&i.length>0&&i.some(l=>typeof l?.atSec=="number")){let l=0;return n(i.map(m=>{const u=typeof m?.atSec=="number"?m.atSec*g:l;return l=u,{text:m?.text??"",startFrame:u}}))}const p=typeof r.text=="string"?r.text.trim():"";if(!p)return[];const o=p.split(/(?<=[。！？!?])/).map(l=>l.trim()).filter(Boolean);if(o.length===0)return[];const a=o.map(l=>Math.max(1,l.length)),s=a.reduce((l,m)=>l+m,0);let d=0;return n(o.map((l,m)=>{const u=d/s*t;return d+=a[m],{text:l,startFrame:u}}))}f(it,"buildSubtitleSegments");function at(e){const[t,r]=D[e]??D["16:9"],n=t>=r,i=n?t:r,p=n?r:t,o=Math.min(R/i,j/p),a=f(l=>Math.floor(l/2)*2,"even"),s=a(t*o),d=a(r*o);return[s,d]}f(at,"previewDimensions");function ct(e,t,r=()=>{}){const n=M($.join(e,"template.json")),i=Array.isArray(n.compositions)?n.compositions:[],p=t.compositionId??i[0]?.compositionId;if(!p)throw new w("❌ template.json 未声明 compositions",x.USAGE);if(t.compositionId&&!i.some(I=>I.compositionId===p))throw new w(`❌ composition "${p}" 不在该模板中。可选: ${i.map(I=>I.compositionId).join(", ")}`,x.USAGE);const{files:o,bytes:a}=nt(e,r);if(Object.keys(o).length===0)throw new w("❌ 模板目录没有可提交的源文件");a>ot&&r(`  ⚠ 模板总体积 ${(a/1024/1024).toFixed(1)} MB，接近 ab-render 的请求上限`);const s=rt(e,n,p,t.propsJson,r),d=(n.supportedAspectRatios??[])[0]??"16:9",l=Number(t.durationSec??s.durationSec??n.supportedDurations?.min??K),[m,u]=at(d),h=Array.isArray(s.props)?s.props:null,y=Math.max(1,Math.round(l*g)),_=h?y*h.length:y,E=_/g;if(E>k)throw new w(`❌ ${T}（本次 ${E.toFixed(1)} 秒）`,x.USAGE);const c=h?[]:it(s.scene,y),F={timeline:(h??[s.props]).map((I,b)=>{const v=b*y,P=v+y;return{sceneId:h?`preview-${String(b+1).padStart(2,"0")}`:"preview",compositionId:p,startFrame:v,endFrame:P,durationFrames:y,startTime:Number((v/g).toFixed(2)),endTime:Number((P/g).toFixed(2)),props:I,layers:[],subtitleSegments:c,transition:{type:"none",durationFrames:0}}}),renderConfig:{width:m,height:u,fps:g,totalFrames:_,totalDuration:Number(E.toFixed(2)),codec:"h264",crf:18,outputFormat:"mp4"},resolvedAssets:s.assets,globalTypography:n.defaultTypography,colorScheme:n.defaultColorScheme,motionPreset:n.defaultMotionPreset};return{files:o,inputProps:F,compositionId:p,totalSeconds:E}}f(ct,"buildPreviewPlan");function pt(e){return JSON.stringify(e.payload??{}).includes("draft_preview_limit_exceeded")}f(pt,"isLimitError");function lt(e,t){const n=t.payload?.data?.issues??t.payload?.issues;if(!Array.isArray(n)||n.length===0)return!1;e.warn(`
+✗ 被 ab-render 的安全扫描拒绝（${n.length} 处）：`);for(const i of n)e.warn(typeof i=="string"?`    · ${i}`:`    · ${i.file}
+      ${i.reason}${i.detail?`: ${i.detail}`:""}`);return e.warn(`
+  先在本地运行 remixmate template check，它与平台使用同一份安全策略。`),!0}f(lt,"printScanIssues");async function $t(e){const t=new W(!!e.json),r=Y(e.name),n=V(e.cwd),i=J(n,r);A({phase:"template-preview:check",progress:.05});const p=await X({name:r,cwd:n,stdio:e.json?"stderr":"inherit"});if(p!==0)throw new w(`❌ 本地校验未通过（check 退出码 ${p}），已中止预览。`,p===2?x.USAGE:x.ERROR);const o=ct(i,e,c=>t.warn(c)),a=await C("template-preview",{privateToken:e.token,apiBaseUrl:e.apiBaseUrl}),s=H(),{width:d,height:l}=o.inputProps.renderConfig;t.info(`模板        ${r}`),t.info(`composition ${o.compositionId}`),t.info(`画幅        ${d}×${l}  ${o.totalSeconds.toFixed(1)}s @${g}fps`),t.info(`文件        ${Object.keys(o.files).length} 个`),t.info(`ab-render   ${s}`);const m=f((c,S)=>z(s,c,S,{token:a.privateToken,skillName:"template-preview"}),"post");let u;try{A({phase:"template-preview:submit",progress:.1});const c=await m("/renderDraft",{files:o.files,inputProps:o.inputProps,upload:!1});if(!c.taskId)throw new w("❌ /renderDraft 未返回 taskId");u=c.taskId}catch(c){if(c instanceof q){if(pt(c))throw new w(`❌ ${T}`,x.ERROR);if(lt(t,c))throw new w("❌ 预览被安全扫描拒绝",x.ERROR)}throw c}t.info(`taskId      ${u}`);const h=e.timeoutSec??Q,y=e.pollIntervalMs??1500,_=Date.now()+h*1e3;let E="";for(;;){if(Date.now()>_)throw new w(`❌ 轮询超时（${h}s），任务 ${u} 仍在 ab-render 排队/渲染。
+   加长等待：--timeout-sec 900`);await new Promise(S=>setTimeout(S,y));const c=await m("/renderDraftStatus",{taskId:u});if(c.status!==E&&(E=c.status??"",t.info(c.status==="pending"?"排队中…（队列前面还有任务）":`状态: ${c.status}`)),A({phase:`template-preview:${c.status??"unknown"}`,progress:.1+.9*(c.progress??0),taskId:u}),c.status==="succeeded"){const S=c.previewUrl?.startsWith("http")?c.previewUrl:`${s}${c.previewUrl??""}`;t.info(`
+✅ 预览就绪
+  ${S}`),t.info("  临时产物，最长保留 24 小时（服务重启后可能更早失效）。");const F={ok:!0,name:r,taskId:u,url:S,compositionId:o.compositionId,durationSec:o.totalSeconds};return t.result({...F}),F}if(c.status==="failed"){const S=c.error??"（无错误详情）";throw S.includes("draft_preview_limit_exceeded")?new w(`❌ ${T}`):new w(`❌ 渲染失败: ${S}`)}}}f($t,"runPreview");export{T as PREVIEW_LIMIT_MESSAGE,ct as buildPreviewPlan,rt as buildSampleProps,it as buildSubtitleSegments,nt as collectFiles,at as previewDimensions,$t as runPreview};

package/dist/template/proc.js

@@ -1,43 +1 @@
-/**
- * Child-process helpers for `remixmate template`.
- *
- * Every command is spawned with an argv array — never a shell string — so a
- * directory or package spec can't be interpreted by a shell. The one exception
- * is npm on Windows: `npm` is `npm.cmd` there, and since Node's CVE-2024-27980
- * fix a .cmd can only be spawned with `shell: true`. For that path we only ever
- * pass fixed tokens or validated package specs (paths travel via `cwd`), and
- * refuse anything containing shell metacharacters.
- */
-import { spawn } from 'node:child_process';
-import { EXIT, SkillError } from '../errors.js';
-export function runProcess(command, args, opts = {}) {
-    const mode = opts.stdio ?? 'inherit';
-    // 'stderr' = child output is human progress (npm install chatter), route it
-    // to our stderr so our stdout stays the result/progress protocol.
-    const stdio = mode === 'inherit' ? 'inherit' : mode === 'pipe' ? ['ignore', 'pipe', 'pipe'] : ['ignore', 'pipe', 'inherit'];
-    return new Promise((resolve, reject) => {
-        let stdout = '';
-        let stderr = '';
-        const child = spawn(command, args, { cwd: opts.cwd, stdio, env: opts.env ?? process.env, shell: opts.shell ?? false });
-        child.stdout?.on('data', (d) => {
-            if (mode === 'stderr')
-                process.stderr.write(d);
-            else
-                stdout += d.toString();
-        });
-        child.stderr?.on('data', (d) => (stderr += d.toString()));
-        child.on('error', (err) => reject(new SkillError(`❌ 无法启动 ${command}: ${err.message}`, EXIT.SPAWN_FAILED)));
-        child.on('close', (code, signal) => resolve({ code: signal ? EXIT.ERROR : code ?? EXIT.ERROR, stdout, stderr }));
-    });
-}
-const SAFE_SHELL_ARG = /^[A-Za-z0-9@._/:=+-]+$/;
-/** Run npm portably. `args` must be plain tokens; paths go through `cwd`. */
-export function runNpm(args, opts = {}) {
-    if (process.platform !== 'win32')
-        return runProcess('npm', args, opts);
-    for (const a of args) {
-        if (!SAFE_SHELL_ARG.test(a))
-            throw new SkillError(`❌ 拒绝把不安全的参数交给 npm.cmd: ${a}`);
-    }
-    return runProcess('npm.cmd', args, { ...opts, shell: true });
-}
+var a=Object.defineProperty;var s=(e,n)=>a(e,"name",{value:n,configurable:!0});import{spawn as E}from"node:child_process";import{EXIT as c,SkillError as l}from"../errors.js";function m(e,n,t={}){const i=t.stdio??"inherit",f=i==="inherit"?"inherit":i==="pipe"?["ignore","pipe","pipe"]:["ignore","pipe","inherit"];return new Promise((u,h)=>{let p="",d="";const o=E(e,n,{cwd:t.cwd,stdio:f,env:t.env??process.env,shell:t.shell??!1});o.stdout?.on("data",r=>{i==="stderr"?process.stderr.write(r):p+=r.toString()}),o.stderr?.on("data",r=>d+=r.toString()),o.on("error",r=>h(new l(`❌ 无法启动 ${e}: ${r.message}`,c.SPAWN_FAILED))),o.on("close",(r,w)=>u({code:w?c.ERROR:r??c.ERROR,stdout:p,stderr:d}))})}s(m,"runProcess");const R=/^[A-Za-z0-9@._/:=+-]+$/;function $(e,n={}){if(process.platform!=="win32")return m("npm",e,n);for(const t of e)if(!R.test(t))throw new l(`❌ 拒绝把不安全的参数交给 npm.cmd: ${t}`);return m("npm.cmd",e,{...n,shell:!0})}s($,"runNpm");export{$ as runNpm,m as runProcess};