reelforge 1.24.2 → 1.25.0

package/dist/commands/assets.js

@@ -1,243 +0,0 @@
-import fs from "node:fs/promises";
-import fsSync from "node:fs";
-import path from "node:path";
-import { post } from "../client.js";
-import { uploadToOss } from "../utils/oss-upload.js";
-import { info, isJson, print, success, warn } from "../utils/output.js";
-import { ASSETS_WORKFLOW_TEXT } from "./assets-workflow-text.js";
-const IMAGE_EXT = new Set([".jpg", ".jpeg", ".png", ".webp"]);
-const VIDEO_EXT = new Set([".mp4", ".mov", ".webm", ".mkv", ".m4v"]);
-const SUPPORTED_EXT = new Set([...IMAGE_EXT, ...VIDEO_EXT]);
-const BATCH_CONCURRENCY = 4;
-function mimeForExt(ext) {
-    switch (ext) {
-        case ".png": return "image/png";
-        case ".jpg":
-        case ".jpeg": return "image/jpeg";
-        case ".webp": return "image/webp";
-        case ".mp4":
-        case ".m4v": return "video/mp4";
-        case ".mov": return "video/quicktime";
-        case ".webm": return "video/webm";
-        case ".mkv": return "video/x-matroska";
-        default: return null;
-    }
-}
-function typeForExt(ext) {
-    if (IMAGE_EXT.has(ext))
-        return "image";
-    if (VIDEO_EXT.has(ext))
-        return "video";
-    return null;
-}
-async function resolveAsset(input) {
-    const t = input.trim();
-    if (t.startsWith("data:image/"))
-        return { url: t, type: "image" };
-    if (t.startsWith("data:video/"))
-        return { url: t, type: "video" };
-    if (t.startsWith("data:")) {
-        throw new Error(`unsupported data: URI MIME (need data:image/... or data:video/...)`);
-    }
-    if (/^https?:\/\//i.test(t)) {
-        let ext = "";
-        try {
-            ext = path.extname(new URL(t).pathname).toLowerCase();
-        }
-        catch {
-        }
-        const guessed = typeForExt(ext);
-        if (!guessed) {
-            throw new Error(`cannot infer asset type from URL (extension "${ext || "<none>"}"). ` +
-                `Use a URL ending in a supported extension, or download the file and pass the local path.`);
-        }
-        return { url: t, type: guessed };
-    }
-    const abs = path.resolve(t);
-    if (!fsSync.existsSync(abs)) {
-        throw new Error(`asset not found: ${abs}`);
-    }
-    const ext = path.extname(abs).toLowerCase();
-    const type = typeForExt(ext);
-    const mime = mimeForExt(ext);
-    if (!type || !mime) {
-        const supported = [...IMAGE_EXT, ...VIDEO_EXT].join(" / ");
-        throw new Error(`unsupported extension ${ext} (supported: ${supported})`);
-    }
-    try {
-        const key = await uploadToOss(abs);
-        return { key, type };
-    }
-    catch (e) {
-        warn(`${path.basename(abs)}: OSS 直传不可用,回退内联上传 (${e instanceof Error ? e.message : e})`);
-        const buf = await fs.readFile(abs);
-        return { url: `data:${mime};base64,${buf.toString("base64")}`, type };
-    }
-}
-async function describeOne(input, opts) {
-    const { url, key, type } = await resolveAsset(input);
-    const body = {};
-    if (key)
-        body[`${type}_key`] = key;
-    else
-        body[`${type}_url`] = url;
-    if (opts.model)
-        body.model = opts.model;
-    if (opts.prompt)
-        body.prompt = opts.prompt;
-    return post("/api/v1/assets/describe", body);
-}
-function listAssetFiles(dir) {
-    return fsSync
-        .readdirSync(dir)
-        .filter((name) => SUPPORTED_EXT.has(path.extname(name).toLowerCase()))
-        .filter((name) => !name.startsWith("."))
-        .sort();
-}
-async function pMap(items, fn, limit) {
-    const out = new Array(items.length);
-    let idx = 0;
-    async function worker() {
-        while (true) {
-            const i = idx++;
-            if (i >= items.length)
-                return;
-            out[i] = await fn(items[i], i);
-        }
-    }
-    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
-    return out;
-}
-export function registerAssets(program) {
-    const cmd = program
-        .command("assets")
-        .description("素材相关能力: describe(图片/视频 → 一句话描述) / workflow(agent 用户素材→视频 SOP)")
-        .helpOption("-h, --help", "show help");
-    cmd
-        .command("workflow")
-        .description("打印 agent 用户素材→视频 完整 SOP（给 Claude / Cursor 等 agent 看；底层使用 rf compose 渲染）")
-        .helpOption("-h, --help", "show help")
-        .addHelpText("after", [
-        "",
-        "打印素材→视频工作流指南到 stdout。",
-        "适合 agent 启动时一次性读入；普通用户也可以 `rf assets workflow | less` 浏览。",
-        "spec 的结构与示例见 `rf compose --help`。",
-    ].join("\n"))
-        .action(() => {
-        warn("`rf assets workflow` 已更名 → 用 `rf vlog`(列赛道)/ `rf vlog pet`(宠物 SOP)。下方为旧版通用 SOP。");
-        process.stdout.write(ASSETS_WORKFLOW_TEXT);
-        if (!ASSETS_WORKFLOW_TEXT.endsWith("\n"))
-            process.stdout.write("\n");
-    });
-    cmd
-        .command("describe <pathOrDir>")
-        .description("用多模态 LLM 给图片或视频生成中文描述。" +
-        "单文件打印一句话;目录批量,扫描所有 jpg/png/mp4/mov 等并输出 recipe 风格 JSON。")
-        .helpOption("-h, --help", "show help")
-        .option("-o, --output <file>", "写到文件而不是 stdout(单文件写描述文本,目录写 JSON)")
-        .option("--model <id>", "指定 RelayX 上的 vision-capable 模型(默认 qwen/qwen3-vl-flash;其他可选: qwen/qwen3-vl-plus / openai/gpt-4.1-mini / google/gemini-3-flash / anthropic/claude-4-7-sonnet)")
-        .option("--prompt <text>", "覆盖默认提示词(图片默认 30 字简描,视频默认 80 字动作+氛围描述)")
-        .addHelpText("after", [
-        "",
-        "支持的扩展名:",
-        "  图片: .jpg .jpeg .png .webp",
-        "  视频: .mp4 .mov .webm .mkv .m4v",
-        "",
-        "Examples:",
-        "  # 图片,直接打到终端",
-        "  rf assets describe ./cat.jpg",
-        "",
-        "  # 视频(自动检测扩展名),输出 ~80 字含动作和氛围的描述",
-        "  rf assets describe ./clip.mp4",
-        "",
-        "  # 整个相册目录批量(图片视频混着扫),输出 recipe JSON",
-        "  rf assets describe ./trip/ -o trip.recipe.json",
-        "",
-        "  # 自定义提示词",
-        "  rf assets describe ./clip.mp4 --prompt 'List 3 key visual moments in this video, comma-separated.'",
-        "",
-        "Output:",
-        "  单文件: 直接打印 description 到 stdout(--json 时打印完整 JSON)",
-        "  目录:   { assets: [{image|video, description}, ...] }",
-        "",
-        "成本参考(默认 qwen3-vl-flash):",
-        "  图片 ~$0.00007 (¥0.0005)",
-        "  视频 ~$0.00007/秒 (60s 视频 ¥0.03)",
-    ].join("\n"))
-        .action(async (pathOrDir, opts) => {
-        const isLocal = !/^https?:\/\//i.test(pathOrDir) && !pathOrDir.startsWith("data:");
-        const isDir = isLocal && fsSync.existsSync(pathOrDir) && fsSync.statSync(pathOrDir).isDirectory();
-        if (isDir) {
-            const abs = path.resolve(pathOrDir);
-            const names = listAssetFiles(abs);
-            if (names.length === 0) {
-                throw new Error(`no supported asset files in ${abs} ` +
-                    `(looked for ${[...SUPPORTED_EXT].join(" / ")})`);
-            }
-            info(`Captioning ${names.length} assets from ${abs} (concurrency=${BATCH_CONCURRENCY})...`);
-            const results = await pMap(names, async (name) => {
-                const filePath = path.join(abs, name);
-                const ext = path.extname(name).toLowerCase();
-                const type = typeForExt(ext);
-                try {
-                    const r = await describeOne(filePath, opts);
-                    return {
-                        type,
-                        path: filePath,
-                        description: r.description,
-                        cost_usd: r.cost_usd ?? 0,
-                        intrinsic_duration_ms: r.intrinsic_duration_ms,
-                    };
-                }
-                catch (err) {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    warn(`  ${name}: failed — ${msg}`);
-                    return { type, path: filePath, description: "", error: msg, cost_usd: 0 };
-                }
-            }, BATCH_CONCURRENCY);
-            const totalCost = results.reduce((s, r) => s + (r.cost_usd ?? 0), 0);
-            const okCount = results.filter((r) => r.description).length;
-            const stub = {
-                assets: results.map((r) => {
-                    if (r.type === "video") {
-                        const entry = {
-                            video: r.path,
-                            description: r.description,
-                        };
-                        if (typeof r.intrinsic_duration_ms === "number" && r.intrinsic_duration_ms > 0) {
-                            entry.intrinsic_duration_ms = r.intrinsic_duration_ms;
-                        }
-                        return entry;
-                    }
-                    return { image: r.path, description: r.description };
-                }),
-            };
-            const json = JSON.stringify(stub, null, 2);
-            if (opts.output) {
-                const outAbs = path.resolve(opts.output);
-                await fs.mkdir(path.dirname(outAbs), { recursive: true });
-                await fs.writeFile(outAbs, json);
-                success(`Wrote ${okCount}/${names.length} captions → ${outAbs}  (total cost $${totalCost.toFixed(4)})`);
-            }
-            else {
-                print(stub);
-                info(`(${okCount}/${names.length} ok, total cost $${totalCost.toFixed(4)})`);
-            }
-            return;
-        }
-        const r = await describeOne(pathOrDir, opts);
-        if (opts.output) {
-            const outAbs = path.resolve(opts.output);
-            await fs.mkdir(path.dirname(outAbs), { recursive: true });
-            await fs.writeFile(outAbs, r.description);
-            success(`Wrote description (${r.type}) → ${outAbs}  (${r.model} · ${(r.duration_ms / 1000).toFixed(2)}s · $${(r.cost_usd ?? 0).toFixed(6)})`);
-        }
-        else if (isJson()) {
-            print(r);
-        }
-        else {
-            print(r.description);
-            info(`${r.type} · ${r.model} · ${(r.duration_ms / 1000).toFixed(2)}s · cost $${(r.cost_usd ?? 0).toFixed(6)}`);
-        }
-    });
-}

package/dist/commands/audio.js

@@ -1,91 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { uploadMultipart, post } from "../client.js";
-import { uploadToOss } from "../utils/oss-upload.js";
-import { print, warn } from "../utils/output.js";
-export function registerAudio(program) {
-    const audio = program
-        .command("audio")
-        .description("音频原子能力: 转写 (音频 → 文字 + 词级时间戳)")
-        .helpOption("-h, --help", "show help");
-    audio
-        .command("transcribe")
-        .description("Transcribe an audio file to text + word-level timestamps")
-        .helpOption("-h, --help", "show help")
-        .option("-f, --file <path>", "local audio file (mp3/wav/m4a). Use this OR --url.")
-        .option("-u, --url <url>", "remote audio URL — server downloads and transcribes.")
-        .option("-l, --language <code>", "language hint (e.g. zh, en). Optional — auto-detected.")
-        .option("-m, --model <id>", "override the ASR model id (defaults to the server's)")
-        .option("-o, --output <file>", "write the full JSON response to this file as well as stdout")
-        .addHelpText("after", [
-        "",
-        "Examples:",
-        " rf audio transcribe -f ./narration.mp3",
-        " rf audio transcribe --url https://example.com/clip.mp3 --language zh",
-        " rf audio transcribe -f ./voice.wav --json | jq '.words[:5]'",
-    ].join("\n"))
-        .action(async (opts) => {
-        if (!opts.file && !opts.url) {
-            throw new Error("either --file or --url is required");
-        }
-        if (opts.file && opts.url) {
-            throw new Error("--file and --url are mutually exclusive");
-        }
-        let r;
-        if (opts.file) {
-            let key = null;
-            try {
-                key = await uploadToOss(opts.file);
-            }
-            catch (e) {
-                warn(`OSS 直传不可用,回退 multipart 上传 (${e instanceof Error ? e.message : e})`);
-            }
-            if (key) {
-                const body = { key };
-                if (opts.language)
-                    body.language = opts.language;
-                if (opts.model)
-                    body.model = opts.model;
-                r = await post("/api/v1/audio/transcribe", body);
-            }
-            else {
-                const buf = await fs.readFile(opts.file);
-                const filename = path.basename(opts.file);
-                const ext = path.extname(filename).toLowerCase();
-                const mime = ext === ".wav" ? "audio/wav" :
-                    ext === ".m4a" ? "audio/mp4" :
-                        ext === ".flac" ? "audio/flac" :
-                            ext === ".ogg" ? "audio/ogg" :
-                                "audio/mpeg";
-                const fileBlob = new File([new Uint8Array(buf)], filename, { type: mime });
-                const fields = { file: fileBlob };
-                if (opts.language)
-                    fields.language = opts.language;
-                if (opts.model)
-                    fields.model = opts.model;
-                r = await uploadMultipart("/api/v1/audio/transcribe", fields);
-            }
-        }
-        else {
-            const body = { audio_url: opts.url };
-            if (opts.language)
-                body.language = opts.language;
-            if (opts.model)
-                body.model = opts.model;
-            r = await post("/api/v1/audio/transcribe", body);
-        }
-        if (opts.output) {
-            await fs.writeFile(opts.output, JSON.stringify(r, null, 2), "utf-8");
-        }
-        print({
-            model: r.model,
-            language: r.language,
-            duration: r.duration,
-            text: r.text,
-            n_segments: r.segments.length,
-            n_words: r.words.length,
-            segments: r.segments,
-            words: r.words,
-        });
-    });
-}

package/dist/commands/auth.js

@@ -1,170 +0,0 @@
-import http from "node:http";
-import crypto from "node:crypto";
-import os from "node:os";
-import { spawn } from "node:child_process";
-import { get, setApiKey, setServer, getServer } from "../client.js";
-import { loadConfig, saveConfig, deleteConfig, getConfigPath } from "../utils/config-file.js";
-import { info, success, print, table, formatUsd } from "../utils/output.js";
-function openBrowser(url) {
-    const cmd = process.platform === "darwin"
-        ? "open"
-        : process.platform === "win32"
-            ? "rundll32"
-            : "xdg-open";
-    const args = process.platform === "win32"
-        ? ["url.dll,FileProtocolHandler", url]
-        : [url];
-    try {
-        spawn(cmd, args, { detached: true, stdio: "ignore" }).unref();
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function browserOAuthFlow(serverUrl) {
-    const state = crypto.randomBytes(16).toString("hex");
-    const hostname = (os.hostname() || "device").slice(0, 64);
-    return new Promise((resolve, reject) => {
-        let timer = null;
-        const server = http.createServer((req, res) => {
-            const url = new URL(req.url || "/", "http://127.0.0.1");
-            if (url.pathname !== "/cb") {
-                res.writeHead(404, { "Content-Type": "text/plain" }).end("Not found");
-                return;
-            }
-            const gotState = url.searchParams.get("state");
-            const token = url.searchParams.get("token");
-            const errCode = url.searchParams.get("error");
-            const finish = (statusCode, title, body, outcome) => {
-                res.writeHead(statusCode, {
-                    "Content-Type": "text/html; charset=utf-8",
-                    Connection: "close",
-                }).end(`<!DOCTYPE html><html lang="zh-CN"><head><meta charset="utf-8"><title>ReelForge CLI</title><style>body{font-family:-apple-system,system-ui,"Segoe UI",sans-serif;display:flex;align-items:center;justify-content:center;min-height:100vh;margin:0;background:#fafaf7;color:#222}div{text-align:center;max-width:24rem;padding:1.5rem}h1{font-size:1.5rem;margin:0 0 .5rem;font-weight:600}p{color:#666;font-size:.875rem;line-height:1.5}</style></head><body><div><h1>${title}</h1><p>${body}</p></div><script>setTimeout(()=>window.close?.(),2000)</script></body></html>`);
-                if (timer)
-                    clearTimeout(timer);
-                server.close();
-                server.closeAllConnections?.();
-                if (outcome.ok)
-                    resolve(outcome.token);
-                else
-                    reject(outcome.err);
-            };
-            if (gotState !== state) {
-                finish(400, "授权失败", "state 不匹配，可能是 CSRF。请重新跑 reelforge login。", {
-                    ok: false,
-                    err: new Error("state mismatch"),
-                });
-                return;
-            }
-            if (errCode || !token) {
-                finish(400, "授权被取消", "可以关闭此页面回到 CLI。", {
-                    ok: false,
-                    err: new Error(errCode || "no token returned"),
-                });
-                return;
-            }
-            finish(200, "✓ 授权成功", "可以关闭此页面，CLI 已自动接收 key。", {
-                ok: true,
-                token,
-            });
-        });
-        server.listen(0, "127.0.0.1", () => {
-            const addr = server.address();
-            const port = typeof addr === "object" && addr ? addr.port : 0;
-            const callback = `http://127.0.0.1:${port}/cb`;
-            const authUrl = new URL("/cli-auth", serverUrl);
-            authUrl.searchParams.set("callback", callback);
-            authUrl.searchParams.set("state", state);
-            authUrl.searchParams.set("hostname", hostname);
-            info(`Listening on ${callback}`);
-            info("正在打开浏览器完成授权...");
-            const opened = openBrowser(authUrl.toString());
-            if (!opened) {
-                info("(打开浏览器失败，请手动访问以下 URL):");
-                info(authUrl.toString());
-            }
-            else {
-                info(`(如果浏览器没自动弹出，请手动访问: ${authUrl.toString()})`);
-            }
-        });
-        timer = setTimeout(() => {
-            server.close();
-            reject(new Error("授权超时（5 分钟）。请重新跑 reelforge login"));
-        }, 5 * 60 * 1000);
-    });
-}
-export function registerAuth(program) {
-    program
-        .command("login [api_key]")
-        .description("登录: 不带参数自动开浏览器 OAuth; 带 api_key 直接保存")
-        .helpOption("-h, --help", "show help")
-        .option("--server <url>", "also persist a custom server URL")
-        .addHelpText("after", [
-        "",
-        "Examples:",
-        "  reelforge login                            # browser OAuth (recommended)",
-        "  reelforge login JK1234567890ABCDEF         # manual paste (SSH / headless)",
-        "  reelforge login --server http://nas:8501   # OAuth against a self-hosted server",
-        "",
-        "The token is verified against /api/v1/me before being saved.",
-    ].join("\n"))
-        .action(async (apiKey, opts) => {
-        if (opts.server)
-            setServer(opts.server);
-        let token;
-        if (apiKey) {
-            token = apiKey;
-        }
-        else {
-            info(`Starting browser OAuth against ${getServer()}`);
-            token = await browserOAuthFlow(getServer());
-        }
-        setApiKey(token);
-        const me = await get("/api/v1/me");
-        const existing = await loadConfig();
-        const saved = await saveConfig({
-            ...existing,
-            api_key: token,
-            ...(opts.server ? { server: opts.server } : {}),
-        });
-        success(`Saved → ${saved}`);
-        info(`Account: ${me.account.account_number}${me.account.label ? ` · ${me.account.label}` : ""}`);
-        info(`Balance: ${formatUsd(me.account.balance / 1_000_000)}`);
-        info(`Server:  ${getServer()}`);
-    });
-    program
-        .command("logout")
-        .description("登出: 删除本地保存的 API key 和 server")
-        .helpOption("-h, --help", "show help")
-        .action(async () => {
-        const path = getConfigPath();
-        const deleted = await deleteConfig();
-        if (deleted) {
-            success(`Deleted ${path}`);
-        }
-        else {
-            info(`No config to delete (${path} not found)`);
-        }
-    });
-    program
-        .command("whoami")
-        .description("查看当前账户: 余额 / API key 列表 / 调用统计")
-        .helpOption("-h, --help", "show help")
-        .action(async () => {
-        const me = await get("/api/v1/me");
-        print({
-            account: me.account,
-        });
-        if (me.api_keys.length) {
-            info(`API keys (${me.api_keys.length}):`);
-            table(me.api_keys.map((k) => ({
-                id: k.id,
-                api_key: k.api_key,
-                label: k.label ?? "",
-                status: k.status,
-                last_used_at: k.last_used_at ?? "—",
-            })));
-        }
-    });
-}

package/dist/commands/bgm.js

@@ -1,59 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { del, get, post, uploadMultipart } from "../client.js";
-import { uploadToOss } from "../utils/oss-upload.js";
-import { print, table, success, bytes, warn } from "../utils/output.js";
-export function registerBgm(program) {
-    const bgm = program
-        .command("bgm")
-        .description("BGM 库管理 (内置 + 用户上传)")
-        .helpOption("-h, --help", "show help");
-    bgm
-        .command("list")
-        .description("List all BGM files (default + user-uploaded)")
-        .helpOption("-h, --help", "show help")
-        .action(async () => {
-        const r = await get("/api/v1/bgm");
-        table(r.bgm.map((b) => ({
-            name: b.name,
-            size: bytes(b.size_bytes),
-            source: b.source,
-            path: b.relative_path,
-        })));
-    });
-    bgm
-        .command("upload <file>")
-        .description("Upload a new BGM file (saved under data/bgm/)")
-        .helpOption("-h, --help", "show help")
-        .action(async (file) => {
-        const abs = path.resolve(file);
-        const name = path.basename(abs);
-        let r;
-        let key = null;
-        try {
-            key = await uploadToOss(abs);
-        }
-        catch (e) {
-            warn(`OSS 直传不可用,回退 multipart 上传 (${e instanceof Error ? e.message : e})`);
-        }
-        if (key) {
-            r = await post("/api/v1/bgm", { key, filename: name });
-        }
-        else {
-            const buf = fs.readFileSync(abs);
-            const fileObj = new File([new Uint8Array(buf)], name, { type: "audio/mpeg" });
-            r = await uploadMultipart("/api/v1/bgm", { file: fileObj });
-        }
-        success(`Uploaded ${name}`);
-        print(r);
-    });
-    bgm
-        .command("delete <name>")
-        .alias("rm")
-        .description("Delete a user-uploaded BGM (default repo BGM is protected)")
-        .helpOption("-h, --help", "show help")
-        .action(async (name) => {
-        const r = await del(`/api/v1/bgm/${encodeURIComponent(name)}`);
-        print(r);
-    });
-}