reelforge 1.18.2

package/dist/commands/compositions.js

@@ -0,0 +1,143 @@
+import { post } from "../client.js";
+import { downloadTo } from "../utils/download.js";
+import { print, success, info } from "../utils/output.js";
+import { fmtSize, resolveFileInput, resolveFileInputs } from "../utils/file-upload.js";
+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 resolveFileInputs(videos, {
+            flagName: "<videos...>",
+        });
+        const bgm = opts.bgm
+            ? await resolveFileInput(opts.bgm, { flagName: "--bgm" })
+            : null;
+        if (totalBytes)
+            info(`Uploading ${resolved.length} videos (${fmtSize(totalBytes + (bgm?.bytes ?? 0))})...`);
+        const r = await post("/api/v1/compositions/concat", {
+            videos: resolved.map((r) => r.url),
+            method: opts.method,
+            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 resolveFileInput(opts.input, { flagName: "-i / --input" });
+        const b = await resolveFileInput(opts.bgm, { flagName: "--bgm" });
+        info(`Uploading video (${fmtSize(v.bytes ?? 0)}) + bgm (${fmtSize(b.bytes ?? 0)})...`);
+        const r = await post("/api/v1/compositions/bgm", {
+            video: v.url,
+            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 resolveFileInput(opts.image, { flagName: "-i / --image" });
+        const aud = await resolveFileInput(opts.audio, { flagName: "-a / --audio" });
+        info(`Uploading image (${fmtSize(img.bytes ?? 0)}) + audio (${fmtSize(aud.bytes ?? 0)})...`);
+        const r = await post("/api/v1/compositions/image-to-video", {
+            image: img.url,
+            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 resolveFileInput(opts.video, { flagName: "-v / --video" });
+        const o = await resolveFileInput(opts.overlay, { flagName: "--overlay" });
+        info(`Uploading video (${fmtSize(v.bytes ?? 0)}) + overlay (${fmtSize(o.bytes ?? 0)})...`);
+        const r = await post("/api/v1/compositions/overlay", {
+            video: v.url,
+            overlay_image: o.url,
+        });
+        await downloadTo(r.url, opts.output);
+        success(`Saved → ${opts.output}`);
+        print(r);
+    });
+}

package/dist/commands/config.js

@@ -0,0 +1,62 @@
+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;
+}

package/dist/commands/content.js

@@ -0,0 +1,66 @@
+import fs from "node:fs/promises";
+import { post } from "../client.js";
+import { print } from "../utils/output.js";
+export function registerContent(program) {
+    const content = program
+        .command("content")
+        .description("内容原子能力: scene-plan (脚本 + 时长 → 分镜 + 每镜图像 prompt)")
+        .helpOption("-h, --help", "show help");
+    content
+        .command("scene-plan")
+        .description("Generate a master script + per-scene image prompts (replaces narration/image-prompts/title)")
+        .helpOption("-h, --help", "show help")
+        .option("-t, --topic <text>", "video topic; AI writes the script (generate mode). Use @file for disk input.")
+        .option("--script <text>", "your own master script text (fixed mode). Use @file for disk input.")
+        .option("-d, --duration <sec>", "target video duration in seconds (generate mode; default 45)", (v) => parseInt(v, 10))
+        .option("-p, --pace <pace>", "visual rhythm hint: slow | normal | fast (default normal)")
+        .option("-m, --model <id>", "override LLM model")
+        .addHelpText("after", [
+        "",
+        "Two modes (exactly one required):",
+        "  generate    -t / --topic <text>     LLM writes both script and image prompts",
+        "  fixed       --script @file or text  LLM only segments + writes image prompts; text unchanged verbatim",
+        "",
+        "Examples:",
+        " rf content scene-plan -t '深夜便利店' -d 60 -p slow",
+        " rf content scene-plan --script @./my-script.txt -p fast",
+        " rf content scene-plan -t '雨天的玻璃窗' --json | jq .scenes",
+    ].join("\n"))
+        .action(async (opts) => {
+        const hasTopic = typeof opts.topic === "string" && opts.topic.length > 0;
+        const hasScript = typeof opts.script === "string" && opts.script.length > 0;
+        if (!hasTopic && !hasScript) {
+            throw new Error("either --topic / -t or --script is required");
+        }
+        if (hasTopic && hasScript) {
+            throw new Error("--topic and --script are mutually exclusive");
+        }
+        if (opts.pace && !["slow", "normal", "fast"].includes(opts.pace)) {
+            throw new Error(`--pace must be one of slow|normal|fast (got: ${opts.pace})`);
+        }
+        let topic = opts.topic;
+        let script = opts.script;
+        if (topic?.startsWith("@"))
+            topic = (await fs.readFile(topic.slice(1), "utf-8")).trim();
+        if (script?.startsWith("@"))
+            script = (await fs.readFile(script.slice(1), "utf-8")).trim();
+        const body = {};
+        if (topic)
+            body.topic = topic;
+        if (script)
+            body.script = script;
+        if (opts.duration !== undefined)
+            body.duration = opts.duration;
+        if (opts.pace)
+            body.pace = opts.pace;
+        if (opts.model)
+            body.model = opts.model;
+        const r = await post("/api/v1/content/scene-plan", body);
+        print({
+            mode: r.mode,
+            title: r.title,
+            n_scenes: r.scenes.length,
+            scenes: r.scenes,
+        });
+    });
+}