reelforge 1.24.3 → 1.25.0

package/dist/commands/clip.js

@@ -1,139 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { post } from "../client.js";
-import { waitForTask } from "../utils/task-waiter.js";
-import { downloadTo } from "../utils/download.js";
-import { formatUsd, humanDuration, info, isJson, print, success } from "../utils/output.js";
-async function loadSpec(raw) {
-    let text = raw;
-    if (raw.startsWith("@")) {
-        text = await fs.readFile(path.resolve(raw.slice(1)), "utf8");
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch (e) {
-        throw new Error(`--spec is not valid JSON: ${e instanceof Error ? e.message : e}`);
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-        throw new Error("--spec must be a JSON object (the component's render spec)");
-    }
-    return parsed;
-}
-export function registerClip(program) {
-    program
-        .command("clip")
-        .description("一个 scene 组件 → 独立竖屏 MP4 (可选配音; 给 `rf dub --append` 拼片尾用)")
-        .helpOption("-h, --help", "show help")
-        .requiredOption("--component <id>", "组件 kind id (如 kinetic-text / quote-card / index-board)")
-        .requiredOption("--spec <json>", "组件 spec,内联 JSON 或 @文件路径")
-        .option("--theme <id>", "主题皮肤 id (缺省 = 组件所属 profile;general 组件用 general)")
-        .option("--narration <text>", "配音文案 (传了才有声音;不传 = 无声片段)")
-        .option("--voice <id>", "配音音色 (index-tts-2 音色名, 默认 熊小二)", "熊小二")
-        .option("--tts-model <id>", "TTS 模型 (默认 vox/index-tts-2)", "vox/index-tts-2")
-        .option("--duration <sec>", "片段时长 (秒);缺省 = 组件自然时长(无声)或配音时长(有声)", (v) => parseFloat(v))
-        .option("--subtitles", "烧录字幕 (默认不烧;组件通常自带文字)")
-        .option("--subtitle-style <style>", "字幕样式: plate | stroke | cinema (默认 plate)", "plate")
-        .option("-o, --output <file>", "输出 MP4 路径 (默认: clip-<组件>.mp4, 放在当前目录)")
-        .option("--preview-only", "只生成 preview, 不渲染最终 MP4")
-        .option("--poll-ms <ms>", "轮询间隔", (v) => parseInt(v, 10), 1500)
-        .option("--timeout-ms <ms>", "最长等待时间", (v) => parseInt(v, 10))
-        .addHelpText("after", [
-        "",
-        "它是什么:",
-        "  把单个 scene 组件渲染成一段独立的 1080×1920 竖屏 MP4。通用命令 —— 任何",
-        "  想单独跑的组件都走这里;最常见用途是给 `rf dub --append` 做固定片尾(关注卡 /",
-        "  赞助板 / 口播尾板),生成一次反复拼,省去每条视频重复 TTS。",
-        "",
-        "配音 (可选):",
-        "  · 不传 --narration → 无声片段,时长 = 组件自然时长 (或 --duration)。",
-        "  · 传 --narration   → 熊小二配音 (可 --voice 换),时长 = max(配音, 组件自然时长),",
-        "                       即配音短也不会截断动画;--subtitles 可另烧字幕。",
-        "",
-        "组件 (--component) + spec (--spec):",
-        "  · --component 传组件的 kind id。常用通用组件: kinetic-text(一句大字) /",
-        "    quote-card(金句) / comparison-vs(对比) / stat-counter(数字) /",
-        "    bullet-list(要点) / timeline(时间线)。finance / mindset 垂直组件也可,",
-        "    会自动套对应主题皮肤 (也可 --theme 指定)。",
-        "  · --spec 是该组件的渲染字段 (JSON 对象),内联或 @文件。字段随组件而定,",
-        "    例: kinetic-text = {text, emphasis};quote-card = {quote, author, context}。",
-        "",
-        "认证: 需要 API key — `rf login <key>` / $REELFORGE_API_KEY / --api-key。",
-        "可用音色: `rf tts voices`。",
-        "",
-        "示例:",
-        "  # 无声金句卡 (用组件自然时长)",
-        '  rf clip --component quote-card --spec \'{"quote":"慢即是快","author":"老张"}\'',
-        "",
-        "  # 带配音的关注片尾,再拼到 dub 后面 (典型用法)",
-        '  rf clip --component kinetic-text --spec \'{"text":"关注 机械制造师","emphasis":"机械制造师"}\' \\',
-        '    --narration "关注机械制造师官方账号,每天一个离谱发明" -o outro.mp4',
-        "  rf dub gameplay.mp4 --append outro.mp4",
-        "",
-        "  # 指定时长 + 字幕",
-        '  rf clip --component kinetic-text --spec \'{"text":"上车!"}\' --narration "都给我上车" --subtitles --duration 4',
-        "",
-        "  # 财经组件 (spec 从文件读, 自动用 finance 皮肤)",
-        "  rf clip --component index-board --spec @board.json",
-    ].join("\n"))
-        .action(async (opts) => {
-        const spec = await loadSpec(opts.spec);
-        const subtitleStyle = (opts.subtitleStyle || "plate").toLowerCase();
-        if (!["plate", "stroke", "cinema"].includes(subtitleStyle)) {
-            throw new Error(`--subtitle-style must be plate | stroke | cinema (got ${opts.subtitleStyle})`);
-        }
-        if (opts.duration !== undefined && (!Number.isFinite(opts.duration) || opts.duration <= 0)) {
-            throw new Error(`--duration must be a positive number (got ${opts.duration})`);
-        }
-        const body = {
-            component: opts.component,
-            spec,
-            voice: opts.voice || "熊小二",
-            tts_model: opts.ttsModel || "vox/index-tts-2",
-            subtitles: opts.subtitles === true,
-            subtitle_style: subtitleStyle,
-        };
-        if (opts.theme)
-            body.theme = opts.theme;
-        if (opts.narration)
-            body.narration = opts.narration;
-        if (opts.duration !== undefined)
-            body.duration_sec = opts.duration;
-        if (opts.previewOnly)
-            body.preview_only = true;
-        info(`Rendering component "${opts.component}"${opts.narration ? " (voiced)" : " (silent)"}...`);
-        const submitted = await post("/api/v1/clip", body);
-        info(`Submitted task: ${submitted.task_id} — 渲染中, 请稍候...`);
-        const t = await waitForTask(submitted.task_id, { pollMs: opts.pollMs, timeoutMs: opts.timeoutMs });
-        if (t.status !== "completed") {
-            throw new Error(t.error || `Task ended with status ${t.status}`);
-        }
-        const result = t.result;
-        if (result?.render_pending) {
-            info(`MP4 render skipped (--preview-only). Run \`rf render ${t.id}\` to finalize.`);
-        }
-        else if (result?.video_url) {
-            const stdoutIsPipe = !process.stdout.isTTY;
-            const skipDownload = stdoutIsPipe && !opts.output;
-            let savedPath;
-            if (opts.output)
-                savedPath = path.resolve(opts.output);
-            else if (!skipDownload)
-                savedPath = path.resolve(`clip-${opts.component}.mp4`);
-            if (savedPath) {
-                await downloadTo(result.video_url, savedPath);
-                success(`Saved → ${savedPath}`);
-            }
-        }
-        if (result?.generation_ms != null) {
-            const playback = result.duration != null ? `, ${result.duration.toFixed(1)}s` : "";
-            const skin = result.theme ? `, theme ${result.theme}` : "";
-            info(`generated in ${humanDuration(result.generation_ms)}${playback}${skin}`);
-        }
-        if (result?.price_usd != null)
-            info(`charge: ${formatUsd(result.price_usd)}`);
-        if (isJson())
-            print({ task_id: t.id, status: t.status, ...result });
-    });
-}

package/dist/commands/compose.js

@@ -1,298 +0,0 @@
-import fs from "node:fs/promises";
-import fsSync from "node:fs";
-import path from "node:path";
-import { post, getServer } from "../client.js";
-import { uploadToOss } from "../utils/oss-upload.js";
-import { waitForTask } from "../utils/task-waiter.js";
-import { downloadTo } from "../utils/download.js";
-import { formatUsd, humanDuration, info, print, success, warn } from "../utils/output.js";
-const EXT_TO_MIME = {
-    ".mp3": "audio/mpeg",
-    ".wav": "audio/wav",
-    ".m4a": "audio/mp4",
-    ".ogg": "audio/ogg",
-    ".png": "image/png",
-    ".jpg": "image/jpeg",
-    ".jpeg": "image/jpeg",
-    ".webp": "image/webp",
-    ".mp4": "video/mp4",
-    ".mov": "video/quicktime",
-    ".webm": "video/webm",
-};
-function listSpecPaths(spec) {
-    const paths = new Set();
-    if (spec.audio.narration)
-        paths.add(spec.audio.narration);
-    if (spec.audio.bgm)
-        paths.add(spec.audio.bgm);
-    for (const s of spec.scenes) {
-        if (s.image)
-            paths.add(s.image);
-        if (s.video)
-            paths.add(s.video);
-    }
-    if (spec.cover)
-        paths.add(spec.cover.image);
-    if (spec.brand?.logo)
-        paths.add(spec.brand.logo);
-    return [...paths];
-}
-async function readAsDataUri(specPath, baseDir) {
-    const abs = path.isAbsolute(specPath) ? specPath : path.resolve(baseDir, specPath);
-    if (!fsSync.existsSync(abs)) {
-        throw new Error(`compose: spec references "${specPath}" but file not found at ${abs}`);
-    }
-    const ext = path.extname(abs).toLowerCase();
-    const mime = EXT_TO_MIME[ext];
-    if (!mime) {
-        throw new Error(`compose: unsupported file extension "${ext}" (path: ${abs}). Supported: ` +
-            Object.keys(EXT_TO_MIME).join(" / "));
-    }
-    const buf = await fs.readFile(abs);
-    return { dataUri: `data:${mime};base64,${buf.toString("base64")}`, bytes: buf.byteLength };
-}
-const EXAMPLE_SPEC_HINT = `{
-  "experimental": "compose.v2",
-  "audio": { "narration": "./narration.mp3" },
-  "scenes": [
-    { "start_sec": 0,  "end_sec": 5,  "image": "./s1.png",  "motion": "zoom-in"   },
-    { "start_sec": 5,  "end_sec": 11, "video": "./clip.mp4", "muted": true        }
-  ],
-  "subtitles": [
-    { "start_sec": 0, "end_sec": 5,  "text": "为什么咖啡因让人精神" },
-    { "start_sec": 5, "end_sec": 11, "text": "原来它跟睡眠物质是同一把钥匙" }
-  ],
-  "title": "咖啡因的真相"
-}`;
-const EXAMPLE_SPEC_V3_HINT = `{
-  "experimental": "compose.v3",
-  "audio": { "tts_voice": "熊小二" },
-  "scenes": [
-    {
-      "video": "./s1.mp4", "muted": true,
-      "narration": ["今天热得不行", "我跑厕所睡觉"],
-      "intro_title": "热到躲厕所"
-    },
-    {
-      "image": "./splash.jpg",
-      "narration": ["主人你找拖鞋去吧"]
-    }
-  ],
-  "subtitle_style": "stroke",
-  "title": "贼喵被抓现行"
-}`;
-export function registerCompose(program) {
-    program
-        .command("compose <spec>")
-        .description("⚠️ EXPERIMENTAL · 从 JSON spec 渲染 MP4 — 调用方精确指定每个 scene 的图/视频 / 时间 / 字幕")
-        .helpOption("-h, --help", "show help")
-        .option("-o, --output <file>", "output MP4 path. Default: <spec-basename>.mp4 in cwd")
-        .option("--preview-only", "build the composition and return preview URLs; skip MP4 render (faster + cheaper iteration)")
-        .option("--poll-ms <ms>", "poll interval while waiting", (v) => parseInt(v, 10), 1500)
-        .option("--timeout-ms <ms>", "max wait time before aborting", (v) => parseInt(v, 10))
-        .option("--watch", "监听 spec.json,每次保存让 server 重建 HF preview(自动 --preview-only,不渲 MP4),打印一个 preview URL — 任何设备浏览器打开即可看效果。Ctrl-C 退出")
-        .option("--watch-debounce-ms <ms>", "watch 模式下文件变化的 debounce 时长", (v) => parseInt(v, 10), 400)
-        .addHelpText("after", [
-        "",
-        "⚠️ Schema versioning",
-        "  Two schemas coexist; the server picks one via spec.experimental.",
-        "    compose.v2 — you write every start_sec/end_sec yourself.",
-        "    compose.v3 — audio-first: server runs TTS+ASR and derives times.",
-        "  Both are EXPERIMENTAL; pin your CLI (e.g. reelforge@1.16.x) if you",
-        "  build an agent against them.",
-        "",
-        "compose.v2 minimal example (manual timing):",
-        EXAMPLE_SPEC_HINT,
-        "",
-        "compose.v3 minimal example (audio-first, recommended for short videos):",
-        EXAMPLE_SPEC_V3_HINT,
-        "",
-        "Path resolution:",
-        "  File paths in the spec are resolved RELATIVE to the spec.json's",
-        "  directory. Absolute paths are also accepted. The CLI reads each",
-        "  file and base64-encodes it into the request body — no separate",
-        "  upload step needed.",
-        "",
-        "Supported file types:",
-        "  audio:  .mp3 .wav .m4a .ogg",
-        "  image:  .png .jpg .jpeg .webp",
-        "  video:  .mp4 .mov .webm",
-        "",
-        "Scene visuals:",
-        "  Each scene has exactly one of `image` or `video`. Video scenes",
-        "  play their source clip; if the clip is shorter than the scene",
-        "  window, the last frame freezes (Ken-Burns continues, so the held",
-        "  shot doesn't look frozen). Use `muted: true` to silence the clip's",
-        "  own audio — default lets it mix with the narration.",
-        "",
-        "Size limits:",
-        "  total decoded payload ≤ 55 MB (server cap). Stays in the safe-upload",
-        "  envelope. Typical 30s spec (5 scenes + narration) is ~5-10 MB.",
-        "",
-        "Examples:",
-        "  # Render directly to a file",
-        "  rf compose ./my-video-spec.json -o ./output.mp4",
-        "",
-        "  # Preview only — prints preview URL, no MP4 yet (~2 min, ~$0.05)",
-        "  rf compose ./my-video-spec.json --preview-only",
-        "",
-        "  # Watch mode — 编辑 spec → 保存 → server 重建 preview → CLI 打印 URL,手机/浏览器点开看效果",
-        "  rf compose ./my-video-spec.json --watch",
-        "",
-        "  # JSON output (parse from agent)",
-        "  rf compose ./my-video-spec.json --json",
-        "",
-        "Full schema reference + worked examples (cognitive science / mixed",
-        "image+video / dual-language financial / minimal) live at:",
-        "  docs/compose-spec.md in the ReelForge repo",
-        "",
-        "Use-case workflows (compose is the generic primitive; use-case SOPs",
-        "live under their own namespace):",
-        "  rf assets workflow      用户素材 → 视频 工作流",
-        "",
-        "(`rf` works wherever you see `reelforge`)",
-    ].join("\n"))
-        .action(async (specPathArg, opts) => {
-        const specPath = path.resolve(specPathArg);
-        if (!fsSync.existsSync(specPath)) {
-            throw new Error(`spec not found: ${specPath}`);
-        }
-        await renderComposeOnce(specPath, opts);
-        if (opts.watch) {
-            await runWatchLoop(specPath, opts);
-        }
-    });
-}
-async function renderComposeOnce(specPath, opts) {
-    let spec;
-    try {
-        const raw = await fs.readFile(specPath, "utf-8");
-        spec = JSON.parse(raw);
-    }
-    catch (e) {
-        throw new Error(`failed to read / parse spec ${specPath}: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    if (spec.experimental !== "compose.v2" && spec.experimental !== "compose.v3") {
-        throw new Error(`spec.experimental must be "compose.v2" or "compose.v3" (got: ${JSON.stringify(spec.experimental)}). ` +
-            `See docs/compose-spec.md or docs/assets-to-video-workflow.md.`);
-    }
-    const baseDir = path.dirname(specPath);
-    info(`Reading spec from ${specPath}...`);
-    const specPaths = listSpecPaths(spec);
-    const files = {};
-    const fileKeys = {};
-    for (const p of specPaths) {
-        const abs = path.isAbsolute(p) ? p : path.resolve(baseDir, p);
-        if (!fsSync.existsSync(abs)) {
-            throw new Error(`compose: spec references "${p}" but file not found at ${abs}`);
-        }
-        try {
-            fileKeys[p] = await uploadToOss(abs);
-        }
-        catch (e) {
-            warn(`${p}: OSS 直传不可用,回退内联上传 (${e instanceof Error ? e.message : e})`);
-            const r = await readAsDataUri(p, baseDir);
-            files[p] = r.dataUri;
-        }
-    }
-    info(`Bundling ${specPaths.length} files (${Object.keys(fileKeys).length} 直传 OSS, ${Object.keys(files).length} 内联)...`);
-    const body = { spec };
-    if (Object.keys(fileKeys).length)
-        body.file_keys = fileKeys;
-    if (Object.keys(files).length)
-        body.files = files;
-    if (opts.previewOnly)
-        body.preview_only = true;
-    const submitted = await post("/api/v1/compose", body);
-    info(`Submitted task: ${submitted.task_id}`);
-    const t = await waitForTask(submitted.task_id, {
-        pollMs: opts.pollMs,
-        timeoutMs: opts.timeoutMs,
-    });
-    if (t.status !== "completed") {
-        throw new Error(t.error || `Task ended with status ${t.status}`);
-    }
-    const result = t.result;
-    const serverBase = getServer().replace(/\/+$/, "");
-    const previewPageAbs = result?.preview_urls?.page ? serverBase + result.preview_urls.page : undefined;
-    const previewPlayerAbs = result?.preview_urls?.player ? serverBase + result.preview_urls.player : undefined;
-    if (previewPageAbs)
-        info(`Preview page: ${previewPageAbs}`);
-    if (previewPlayerAbs)
-        info(`Player only: ${previewPlayerAbs}`);
-    if (result?.render_pending) {
-        info(`MP4 render skipped (--preview-only). Run \`rf render ${t.id}\` to finalize.`);
-    }
-    else if (result?.video_url) {
-        const stdoutIsPipe = !process.stdout.isTTY;
-        const skipDownload = stdoutIsPipe && !opts.output;
-        let savedPath;
-        if (opts.output) {
-            savedPath = opts.output;
-        }
-        else if (!skipDownload) {
-            const stem = path.parse(specPath).name;
-            savedPath = path.resolve(`${stem}-${t.id.slice(0, 8)}.mp4`);
-        }
-        if (savedPath) {
-            await downloadTo(result.video_url, savedPath);
-            success(`Saved → ${savedPath}`);
-        }
-    }
-    if (result?.generation_ms != null) {
-        const gen = humanDuration(result.generation_ms);
-        const playback = result.duration != null ? `, video ${result.duration.toFixed(1)}s` : "";
-        info(`generated in ${gen}${playback}`);
-    }
-    if (result?.price_usd != null)
-        info(`charge: ${formatUsd(result.price_usd)}`);
-    print({ task_id: t.id, status: t.status, ...result });
-}
-async function runWatchLoop(specPath, opts) {
-    const debounceMs = opts.watchDebounceMs ?? 400;
-    const watchOpts = { ...opts, previewOnly: true };
-    if (opts.output) {
-        warn(`   --output is ignored in --watch mode (preview-only — no MP4 is produced)`);
-    }
-    info(`👀 watching ${specPath} — preview iteration mode`);
-    info(`   server: ${getServer()}`);
-    info(`   each save → server rebuilds preview (NO MP4 render) → prints URL`);
-    info(`   open the URL on any device (phone / laptop) to scrub HF player`);
-    info(`   Ctrl-C to stop`);
-    let running = false;
-    let queued = false;
-    let debounceTimer = null;
-    const rerender = async () => {
-        if (running) {
-            queued = true;
-            return;
-        }
-        running = true;
-        try {
-            const t0 = Date.now();
-            info(`\n— rebuild —`);
-            await renderComposeOnce(specPath, watchOpts);
-            info(`✓ rebuilt in ${humanDuration(Date.now() - t0)}; refresh / open the URL above`);
-        }
-        catch (e) {
-            warn(`✗ rebuild failed: ${e instanceof Error ? e.message : String(e)}`);
-        }
-        finally {
-            running = false;
-            if (queued) {
-                queued = false;
-                setTimeout(rerender, 50);
-            }
-        }
-    };
-    fsSync.watch(specPath, () => {
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(rerender, debounceMs);
-    });
-    process.on("SIGINT", () => {
-        info("\n👋 watch stopped");
-        process.exit(0);
-    });
-    await new Promise(() => { });
-}

package/dist/commands/compositions.js

@@ -1,148 +0,0 @@
-import { post } from "../client.js";
-import { downloadTo } from "../utils/download.js";
-import { print, success, info, warn } from "../utils/output.js";
-import { fmtSize, resolveUploadInput, resolveUploadInputs } from "../utils/file-upload.js";
-const onOssFallback = (flagName, reason) => warn(`${flagName}: OSS 直传不可用,回退内联上传 (${reason})`);
-const WHEN_TO_USE = [
-    "",
-    "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
-    "何时用 / 不要用 rf compositions (AGENT 必读)",
-    "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
-    "✓ 用户已经有完整素材 (视频 / 图片 / 音频),仅需 拼接 / 加 BGM / 叠 logo",
-    "✓ 用户明确说『不要 AI 配文案』『只是简单合成』",
-    "",
-    "✗ 用户说『帮我做个视频』+ 给的是主题/想法 → 走 `rf create -t \"<topic>\"`",
-    "✗ 用户给了文案脚本 → 走 `rf create --script @file.txt`",
-    "✗ 用户想 AI 在自己的素材上加配音 + 字幕 → 当前需要分两步:",
-    "    先 `rf create --script ...` 出 AI 部分,再用 compositions 拼到自己素材里",
-    "✗ Agent 全控每帧 → 走 `rf compose <spec.json>` (EXPERIMENTAL)",
-    "",
-    "文件输入 (1.14.0+):",
-    "  全部命令的文件参数都支持三种形式,CLI 自动判定:",
-    "    本地路径    →  CLI 读 + base64 上传 (最常用)",
-    "    https://    →  透传给服务端,ffmpeg 直接拉",
-    "    data: URI   →  透传,服务端解码",
-    "  注: 老接口里 `rf files upload` 拿到的服务端路径 (data/uploads/<name>) ",
-    "      不再支持 — 这组命令现在自带上传,无需先 upload。",
-].join("\n");
-export function registerCompositions(program) {
-    const comp = program
-        .command("compositions")
-        .description("视频合成 (底层 ffmpeg): 拼接 / 加 BGM / 图+音 → 视频 / 透明叠加")
-        .helpOption("-h, --help", "show help")
-        .addHelpText("after", WHEN_TO_USE);
-    comp
-        .command("concat <videos...>")
-        .description("Concatenate multiple MP4 files into one (optionally mix a BGM track)")
-        .helpOption("-h, --help", "show help")
-        .option("-o, --output <file>", "output path (REQUIRED)")
-        .option("--method <method>", "demuxer | filter", "demuxer")
-        .option("--bgm <path>", "optional BGM file to mix in (local / URL / data: URI)")
-        .option("--bgm-volume <n>", "BGM volume (0..1)", parseFloat, 0.2)
-        .option("--bgm-mode <mode>", "loop | once", "loop")
-        .addHelpText("after", [
-        "",
-        "Example:",
-        "  rf compositions concat clip1.mp4 clip2.mp4 clip3.mp4 -o final.mp4 \\",
-        "    --bgm bgm/default.mp3 --bgm-volume 0.15",
-        "",
-        "Files are auto-uploaded — pass local paths directly. Don't pre-upload",
-        "via `rf files upload` and pass server-side paths; that's the old broken",
-        "pattern.",
-    ].join("\n"))
-        .action(async (videos, opts) => {
-        if (!opts.output)
-            throw new Error("--output is required");
-        const { resolved, totalBytes } = await resolveUploadInputs(videos, {
-            flagName: "<videos...>",
-            onFallback: onOssFallback,
-        });
-        const bgm = opts.bgm
-            ? await resolveUploadInput(opts.bgm, { flagName: "--bgm", onFallback: onOssFallback })
-            : null;
-        if (totalBytes)
-            info(`Uploading ${resolved.length} videos (${fmtSize(totalBytes + (bgm?.bytes ?? 0))})...`);
-        const videoKeys = resolved.filter((r) => r.key).map((r) => r.key);
-        const videoUris = resolved.filter((r) => r.url).map((r) => r.url);
-        const r = await post("/api/v1/compositions/concat", {
-            videos: videoUris,
-            video_keys: videoKeys,
-            method: opts.method,
-            ...(bgm?.key ? { bgm_key: bgm.key } : bgm?.url ? { bgm_path: bgm.url } : {}),
-            bgm_volume: opts.bgmVolume,
-            bgm_mode: opts.bgmMode,
-        });
-        await downloadTo(r.url, opts.output);
-        success(`Saved → ${opts.output}`);
-        print(r);
-    });
-    comp
-        .command("bgm")
-        .description("Add background music to an existing video")
-        .helpOption("-h, --help", "show help")
-        .requiredOption("-i, --input <file>", "input video (local / URL / data: URI)")
-        .requiredOption("--bgm <file>", "BGM audio file (local / URL / data: URI)")
-        .option("-o, --output <file>", "output path (REQUIRED)")
-        .option("--volume <n>", "BGM volume (0..1)", parseFloat, 0.2)
-        .option("--mode <mode>", "loop | once", "loop")
-        .action(async (opts) => {
-        if (!opts.output)
-            throw new Error("--output is required");
-        const v = await resolveUploadInput(opts.input, { flagName: "-i / --input", onFallback: onOssFallback });
-        const b = await resolveUploadInput(opts.bgm, { flagName: "--bgm", onFallback: onOssFallback });
-        info(`Uploading video (${fmtSize(v.bytes ?? 0)}) + bgm (${fmtSize(b.bytes ?? 0)})...`);
-        const r = await post("/api/v1/compositions/bgm", {
-            ...(v.key ? { video_key: v.key } : { video: v.url }),
-            ...(b.key ? { bgm_key: b.key } : { bgm: b.url }),
-            volume: opts.volume,
-            mode: opts.mode,
-        });
-        await downloadTo(r.url, opts.output);
-        success(`Saved → ${opts.output}`);
-        print(r);
-    });
-    comp
-        .command("image-to-video")
-        .description("Build a video from a single image + an audio track")
-        .helpOption("-h, --help", "show help")
-        .requiredOption("-i, --image <file>", "input image (local / URL / data: URI)")
-        .requiredOption("-a, --audio <file>", "input audio (local / URL / data: URI)")
-        .option("-o, --output <file>", "output path (REQUIRED)")
-        .option("--fps <n>", "frames per second", parseInt, 30)
-        .action(async (opts) => {
-        if (!opts.output)
-            throw new Error("--output is required");
-        const img = await resolveUploadInput(opts.image, { flagName: "-i / --image", onFallback: onOssFallback });
-        const aud = await resolveUploadInput(opts.audio, { flagName: "-a / --audio", onFallback: onOssFallback });
-        info(`Uploading image (${fmtSize(img.bytes ?? 0)}) + audio (${fmtSize(aud.bytes ?? 0)})...`);
-        const r = await post("/api/v1/compositions/image-to-video", {
-            ...(img.key ? { image_key: img.key } : { image: img.url }),
-            ...(aud.key ? { audio_key: aud.key } : { audio: aud.url }),
-            fps: opts.fps,
-        });
-        await downloadTo(r.url, opts.output);
-        success(`Saved → ${opts.output}`);
-        print(r);
-    });
-    comp
-        .command("overlay")
-        .description("Overlay a transparent PNG on top of a video")
-        .helpOption("-h, --help", "show help")
-        .requiredOption("-v, --video <file>", "input video (local / URL / data: URI)")
-        .requiredOption("--overlay <file>", "overlay PNG, transparent (local / URL / data: URI)")
-        .option("-o, --output <file>", "output path (REQUIRED)")
-        .action(async (opts) => {
-        if (!opts.output)
-            throw new Error("--output is required");
-        const v = await resolveUploadInput(opts.video, { flagName: "-v / --video", onFallback: onOssFallback });
-        const o = await resolveUploadInput(opts.overlay, { flagName: "--overlay", onFallback: onOssFallback });
-        info(`Uploading video (${fmtSize(v.bytes ?? 0)}) + overlay (${fmtSize(o.bytes ?? 0)})...`);
-        const r = await post("/api/v1/compositions/overlay", {
-            ...(v.key ? { video_key: v.key } : { video: v.url }),
-            ...(o.key ? { overlay_key: o.key } : { overlay_image: o.url }),
-        });
-        await downloadTo(r.url, opts.output);
-        success(`Saved → ${opts.output}`);
-        print(r);
-    });
-}

package/dist/commands/config.js

@@ -1,62 +0,0 @@
-import fs from "node:fs/promises";
-import { get, patch } from "../client.js";
-import { print } from "../utils/output.js";
-export function registerConfig(program) {
-    const cfg = program
-        .command("config")
-        .description("读取或更新服务器配置 (LLM / 模型网关 keys)")
-        .helpOption("-h, --help", "show help");
-    cfg
-        .command("get")
-        .description("Print the current config (API keys masked)")
-        .helpOption("-h, --help", "show help")
-        .action(async () => {
-        const r = await get("/api/v1/config");
-        print(r);
-    });
-    cfg
-        .command("set <key> <value>")
-        .description("Update a single config value using dotted path, e.g. `llm.api_key sk-xxx`")
-        .helpOption("-h, --help", "show help")
-        .addHelpText("after", [
-        "",
-        "Examples:",
-        "  reelforge config set llm.api_key sk-xxxxxx",
-        "  reelforge config set llm.model <model-id>",
-    ].join("\n"))
-        .action(async (key, value) => {
-        const parts = key.split(".");
-        const patchBody = {};
-        let cur = patchBody;
-        for (let i = 0; i < parts.length - 1; i++) {
-            const next = {};
-            cur[parts[i]] = next;
-            cur = next;
-        }
-        cur[parts[parts.length - 1]] = coerce(value);
-        const r = await patch("/api/v1/config", patchBody);
-        print(r);
-    });
-    cfg
-        .command("patch <file>")
-        .description("Apply a JSON-merge patch file to the config")
-        .helpOption("-h, --help", "show help")
-        .action(async (file) => {
-        const body = JSON.parse(await fs.readFile(file, "utf-8"));
-        const r = await patch("/api/v1/config", body);
-        print(r);
-    });
-}
-function coerce(s) {
-    if (s === "true")
-        return true;
-    if (s === "false")
-        return false;
-    if (s === "null")
-        return null;
-    if (/^-?\d+$/.test(s))
-        return parseInt(s, 10);
-    if (/^-?\d+\.\d+$/.test(s))
-        return parseFloat(s);
-    return s;
-}