reelforge 1.18.2

package/dist/commands/extract.js

@@ -0,0 +1,102 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { post } from "../client.js";
+import { info, isJson, print, success } from "../utils/output.js";
+const FILE_EXT_TO_MIME = {
+    ".pdf": "application/pdf",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+};
+async function resolveSource(input) {
+    const t = input.trim();
+    if (!t)
+        throw new Error("--reference / source is empty");
+    if (t.startsWith("data:"))
+        return t;
+    if (/^https?:\/\//i.test(t))
+        return t;
+    if (/v\.douyin\.com\//i.test(t) || /复制此链接/.test(t) || /打开抖音/.test(t))
+        return t;
+    if (/^[a-z0-9][a-z0-9-._]*\/[a-z0-9][a-z0-9-._]*$/i.test(t) && !t.split("/")[0].includes(".")) {
+        return t;
+    }
+    const abs = path.resolve(t);
+    if (!fsSync.existsSync(abs)) {
+        throw new Error(`source not found: ${abs}\n` +
+            `For documents pass a PDF/DOCX/XLSX path; for videos / articles / repos pass a URL or owner/repo.`);
+    }
+    const ext = path.extname(abs).toLowerCase();
+    const mime = FILE_EXT_TO_MIME[ext];
+    if (!mime) {
+        throw new Error(`unsupported file extension "${ext}". ` +
+            `Supported: ${Object.keys(FILE_EXT_TO_MIME).join(" / ")}, or pass a URL / github owner/repo / 抖音 link.`);
+    }
+    const buf = await fs.readFile(abs);
+    return `data:${mime};base64,${buf.toString("base64")}`;
+}
+export function registerExtract(program) {
+    program
+        .command("extract <source>")
+        .description("素材解析: 抖音 / 网页 / GitHub repo / PDF / DOCX / XLSX → 纯文本")
+        .helpOption("-h, --help", "show help")
+        .option("-o, --output <file>", "write extracted text to file instead of stdout")
+        .addHelpText("after", [
+        "",
+        "Supported sources (auto-detected by the server):",
+        "  抖音 link        v.douyin.com/... or full 复制口令 paste     → ASR transcript",
+        "  web URL          https://... article / 知乎 / 公众号           → article body",
+        "  github           owner/repo  or  https://github.com/owner/repo → README + metadata",
+        "  PDF / DOCX /     local file path; auto base64-uploaded         → extracted text",
+        "  XLSX                                                           ",
+        "",
+        "Examples (tip: `rf` works wherever you see `reelforge`):",
+        "  # 抖音视频 → ASR 文字",
+        "  rf extract 'https://v.douyin.com/abc/'",
+        "  rf extract '<整段复制此链接 paste>'",
+        "",
+        "  # 网页文章",
+        "  rf extract 'https://zhuanlan.zhihu.com/p/123456'",
+        "",
+        "  # GitHub 项目",
+        "  rf extract 'anthropics/claude-code'",
+        "  rf extract 'https://github.com/openai/openai-cookbook'",
+        "",
+        "  # 本地文档",
+        "  rf extract ./paper.pdf -o /tmp/ref.txt",
+        "  rf extract ./report.docx",
+        "  rf extract ./sales.xlsx",
+        "",
+        "  # JSON 模式 (拿到 kind + meta + text 完整 payload)",
+        "  rf extract ./paper.pdf --json | jq",
+        "",
+        "Common flow (agent-driven):",
+        "  rf extract <source> -o /tmp/ref.txt    # 1) parse",
+        "  # → (agent / 你的 LLM 用 /tmp/ref.txt 作素材, 写出脚本到 /tmp/final.txt)",
+        "  rf create --script @/tmp/final.txt -d 60   # 2) render",
+        "",
+        "Cost reference:",
+        "  douyin   ~$0.005 (ASR cost; depends on video duration)",
+        "  web/github/pdf/docx/xlsx  $0 (pure parsing, no LLM/ASR)",
+    ].join("\n"))
+        .action(async (source, opts) => {
+        const resolved = await resolveSource(source);
+        const r = await post("/api/v1/reference/extract", { source: resolved });
+        if (opts.output) {
+            const outAbs = path.resolve(opts.output);
+            await fs.mkdir(path.dirname(outAbs), { recursive: true });
+            await fs.writeFile(outAbs, r.text, "utf-8");
+            success(`Saved → ${outAbs}  (${r.kind}, ${r.text.length} chars, ` +
+                `parse ${(r.duration_ms / 1000).toFixed(1)}s` +
+                (r.cost_usd > 0 ? `, $${r.cost_usd.toFixed(6)})` : ")"));
+            return;
+        }
+        if (isJson()) {
+            print(r);
+            return;
+        }
+        print(r.text);
+        info(`${r.kind} · ${r.text.length} chars · parse ${(r.duration_ms / 1000).toFixed(1)}s` +
+            (r.cost_usd > 0 ? ` · $${r.cost_usd.toFixed(6)}` : ""));
+    });
+}

package/dist/commands/fetch.js

@@ -0,0 +1,129 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { post } from "../client.js";
+import { print, success, info, error as logError } from "../utils/output.js";
+function resolveOutputPaths(opts, awemeId) {
+    const cwd = process.cwd();
+    let baseDir;
+    let stem;
+    if (!opts.output) {
+        baseDir = cwd;
+        stem = awemeId;
+    }
+    else {
+        const abs = path.resolve(opts.output);
+        const isExistingDir = fsSync.existsSync(abs) && fsSync.statSync(abs).isDirectory();
+        if (isExistingDir || opts.output.endsWith("/") || opts.output.endsWith("\\")) {
+            baseDir = abs;
+            stem = awemeId;
+        }
+        else {
+            baseDir = path.dirname(abs);
+            const ext = path.extname(abs);
+            stem = ext ? path.basename(abs, ext) : path.basename(abs);
+        }
+    }
+    return {
+        mp4Path: path.join(baseDir, `${stem}.mp4`),
+        txtPath: path.join(baseDir, `${stem}.txt`),
+    };
+}
+async function streamDownload(url, dest) {
+    await fs.mkdir(path.dirname(path.resolve(dest)), { recursive: true });
+    const r = await fetch(url, {
+        redirect: "follow",
+        headers: {
+            "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1",
+            Accept: "*/*",
+        },
+    });
+    if (!r.ok)
+        throw new Error(`MP4 download failed: HTTP ${r.status}`);
+    const buf = Buffer.from(await r.arrayBuffer());
+    if (buf.byteLength === 0)
+        throw new Error("MP4 download returned empty body");
+    await fs.writeFile(dest, buf);
+    return buf.byteLength;
+}
+function fmtSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+export function registerFetch(program) {
+    program
+        .command("fetch <link>")
+        .description("解析抖音分享链接 → 下载 MP4 (可选附 ASR 转写)")
+        .helpOption("-h, --help", "show help")
+        .option("-o, --output <path>", "output file or directory (default: ./<aweme_id>.mp4)")
+        .option("--url-only", "only print the high-quality MP4 URL; do not download")
+        .option("-t, --transcribe", "also run ASR on the audio and save text as <basename>.txt")
+        .option("--transcribe-only", "skip MP4 download — only save the ASR transcript .txt")
+        .addHelpText("after", [
+        "",
+        "Arguments:",
+        "  <link>   抖音 share link. Bare URL or full 复制 paste (e.g. 'xxxx https://v.douyin.com/abc/ yyyy').",
+        "",
+        "Examples:",
+        "  # default — download MP4 to ./<aweme_id>.mp4",
+        "  rf fetch 'https://v.douyin.com/iABCxyz/'",
+        "",
+        "  # paste the whole 抖音 share口令 verbatim (quotes recommended in shell)",
+        "  rf fetch '5.32 复制此链接... https://v.douyin.com/iABCxyz/ ...'",
+        "",
+        "  # specify output dir or file",
+        "  rf fetch <link> -o ./clips/                          # → ./clips/<aweme_id>.mp4",
+        "  rf fetch <link> -o ./clips/charlie.mp4              # → ./clips/charlie.mp4",
+        "",
+        "  # just print the MP4 URL (scripts / curl)",
+        "  rf fetch <link> --url-only",
+        "",
+        "  # MP4 + transcript (writes <basename>.mp4 and <basename>.txt)",
+        "  rf fetch <link> -t",
+        "",
+        "  # only the transcript",
+        "  rf fetch <link> --transcribe-only -o ./scripts/charlie.txt",
+    ].join("\n"))
+        .action(async (link, opts) => {
+        const transcribe = !!opts.transcribe || !!opts.transcribeOnly;
+        const r = await post("/api/v1/douyin/parse", {
+            share_text: link,
+            transcribe,
+        });
+        if (!r.ok) {
+            throw new Error("Server returned non-ok response");
+        }
+        if (opts.urlOnly) {
+            console.log(r.video_url);
+            return;
+        }
+        info(`[${r.aweme_id}] ${r.author ? `@${r.author} — ` : ""}${r.title.slice(0, 60)}${r.duration_sec ? `  (${r.duration_sec.toFixed(1)}s)` : ""}`);
+        const { mp4Path, txtPath } = resolveOutputPaths(opts, r.aweme_id);
+        if (!opts.transcribeOnly) {
+            const size = await streamDownload(r.video_url, mp4Path);
+            success(`Saved MP4 → ${mp4Path}  (${fmtSize(size)})`);
+        }
+        if (transcribe) {
+            if (!r.transcript) {
+                logError("Server did not return a transcript despite transcribe=true (check server logs).");
+            }
+            else {
+                await fs.mkdir(path.dirname(path.resolve(txtPath)), { recursive: true });
+                await fs.writeFile(txtPath, r.transcript.text, "utf-8");
+                success(`Saved transcript → ${txtPath}  (${r.transcript.text.length} chars)`);
+            }
+        }
+        print({
+            aweme_id: r.aweme_id,
+            title: r.title,
+            author: r.author,
+            duration_sec: r.duration_sec,
+            mp4_path: opts.transcribeOnly ? null : mp4Path,
+            txt_path: transcribe && r.transcript ? txtPath : null,
+            video_url: r.video_url,
+        });
+    });
+}

package/dist/commands/files.js

@@ -0,0 +1,56 @@
+import fs from "node:fs";
+import path from "node:path";
+import { del, get, uploadMultipart } from "../client.js";
+import { downloadTo } from "../utils/download.js";
+import { print, table, success, bytes } from "../utils/output.js";
+export function registerFiles(program) {
+    const files = program
+        .command("files")
+        .alias("file")
+        .description("用户文件管理: 上传 / 列表 / 下载 / 删除")
+        .helpOption("-h, --help", "show help");
+    files
+        .command("list")
+        .description("List all uploaded files")
+        .helpOption("-h, --help", "show help")
+        .action(async () => {
+        const r = await get("/api/v1/files");
+        table(r.files.map((f) => ({
+            name: f.name,
+            size: bytes(f.size_bytes),
+            modified: f.modified_at,
+            path: f.relative_path,
+        })));
+    });
+    files
+        .command("upload <file>")
+        .description("Upload a local file (saved under data/uploads/, returns its server path)")
+        .helpOption("-h, --help", "show help")
+        .action(async (file) => {
+        const abs = path.resolve(file);
+        const buf = fs.readFileSync(abs);
+        const name = path.basename(abs);
+        const fileObj = new File([new Uint8Array(buf)], name);
+        const r = await uploadMultipart("/api/v1/files", { file: fileObj });
+        success(`Uploaded → ${r.relative_path}`);
+        print(r);
+    });
+    files
+        .command("download <relativePath>")
+        .description("Download a server file to a local path")
+        .helpOption("-h, --help", "show help")
+        .requiredOption("-o, --output <file>", "local destination path")
+        .action(async (rel, opts) => {
+        await downloadTo(`/api/v1/files/${rel}`, opts.output);
+        success(`Saved → ${opts.output}`);
+    });
+    files
+        .command("delete <relativePath>")
+        .alias("rm")
+        .description("Delete an uploaded file (only data/uploads/ and output/ paths)")
+        .helpOption("-h, --help", "show help")
+        .action(async (rel) => {
+        const r = await del(`/api/v1/files/${rel}`);
+        print(r);
+    });
+}

package/dist/commands/health.js

@@ -0,0 +1,12 @@
+import { get } from "../client.js";
+import { print } from "../utils/output.js";
+export function registerHealth(program) {
+    program
+        .command("health")
+        .description("检查服务器健康状态与可用能力")
+        .helpOption("-h, --help", "show help")
+        .action(async () => {
+        const r = await get("/api/v1/health");
+        print(r);
+    });
+}

package/dist/commands/history.js

@@ -0,0 +1,44 @@
+import { del, get } from "../client.js";
+import { downloadTo } from "../utils/download.js";
+import { print, table, success, bytes } from "../utils/output.js";
+export function registerHistory(program) {
+    const h = program
+        .command("history")
+        .description("浏览之前生成的视频")
+        .helpOption("-h, --help", "show help");
+    h
+        .command("list")
+        .description("List all generation tasks with completed videos")
+        .helpOption("-h, --help", "show help")
+        .action(async () => {
+        const r = await get("/api/v1/history");
+        table(r.history.map((e) => ({
+            task_id: e.task_id,
+            created: e.created_at,
+            size: bytes(e.size_bytes),
+            video: e.video_url || "-",
+        })));
+    });
+    h
+        .command("get <id>")
+        .description("Show metadata + storyboard JSON for a completed task")
+        .helpOption("-h, --help", "show help")
+        .option("--download <file>", "additionally download the final video to this path")
+        .action(async (id, opts) => {
+        const r = await get(`/api/v1/history/${id}`);
+        if (opts.download && r.video_url) {
+            await downloadTo(r.video_url, opts.download);
+            success(`Saved video → ${opts.download}`);
+        }
+        print(r);
+    });
+    h
+        .command("delete <id>")
+        .alias("rm")
+        .description("Permanently delete an output/<id>/ directory")
+        .helpOption("-h, --help", "show help")
+        .action(async (id) => {
+        const r = await del(`/api/v1/history/${id}`);
+        print(r);
+    });
+}

package/dist/commands/images.js

@@ -0,0 +1,88 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { post } from "../client.js";
+import { downloadTo } from "../utils/download.js";
+import { print, success } from "../utils/output.js";
+async function resolveImageRef(input) {
+    const t = input.trim();
+    if (!t)
+        throw new Error("--image: empty value");
+    if (/^https?:\/\//i.test(t) || t.startsWith("data:"))
+        return t;
+    const abs = path.resolve(t);
+    if (!fsSync.existsSync(abs)) {
+        throw new Error(`--image: local file not found: ${abs}`);
+    }
+    const ext = path.extname(abs).toLowerCase();
+    const mime = ext === ".jpg" || ext === ".jpeg" ? "image/jpeg" :
+        ext === ".webp" ? "image/webp" :
+            ext === ".png" ? "image/png" :
+                null;
+    if (!mime) {
+        throw new Error(`--image: unsupported extension ${ext} (use png/jpg/jpeg/webp)`);
+    }
+    const buf = await fs.readFile(abs);
+    return `data:${mime};base64,${buf.toString("base64")}`;
+}
+export function registerImages(program) {
+    const images = program
+        .command("images")
+        .description("图像生成: 文本 → 图片")
+        .helpOption("-h, --help", "show help");
+    images
+        .command("generate")
+        .description("Generate an image (text-to-image or ref-image, depending on model + --image)")
+        .helpOption("-h, --help", "show help")
+        .requiredOption("-p, --prompt <text>", "text prompt. With --image, reference each ref via 「图 N」/「Image N」.")
+        .option("-m, --model <id>", "image model id (rx-image-z | rx-image-flux | rx-image-qwen | rx-image-qwen-edit)")
+        .option("--width <n>", "image width", parseInt)
+        .option("--height <n>", "image height", parseInt)
+        .option("-i, --image <urlOrPath>", "reference image, repeatable up to 3 times. URL / data: URI / local png/jpg/webp path (auto-base64'd). Index N-1 maps to 「图 N」in the prompt. Only honored by edit-capable SKUs (rx-image-qwen-edit).", (val, prev) => [...prev, val], [])
+        .option("-o, --output <file>", "download first image to this local path")
+        .option("--all-output <dir>", "download ALL generated images into this directory")
+        .addHelpText("after", [
+        "",
+        "Examples:",
+        "  # plain text-to-image",
+        "  reelforge images generate -p 'a cat' -m rx-image-flux --width 1024 --height 1024 -o cat.png",
+        "",
+        "  # ref-image edit (Qwen-Image-Edit), 1 ref local file",
+        "  reelforge images generate -m rx-image-qwen-edit \\",
+        "    -p '保持图1人物，把背景改成雪山黄昏' \\",
+        "    -i ./hero.png -o out.png",
+        "",
+        "  # ref-image edit, 2 refs (URL + local), 「图1」+「图2」",
+        "  reelforge images generate -m rx-image-qwen-edit \\",
+        "    -p '让图1的人物穿上图2的衣服' \\",
+        "    -i https://example.com/person.jpg -i ./outfit.png -o composite.png",
+    ].join("\n"))
+        .action(async (opts) => {
+        const body = { prompt: opts.prompt };
+        if (opts.model)
+            body.model = opts.model;
+        if (opts.width !== undefined)
+            body.width = opts.width;
+        if (opts.height !== undefined)
+            body.height = opts.height;
+        if (opts.image && Array.isArray(opts.image) && opts.image.length > 0) {
+            if (opts.image.length > 3) {
+                throw new Error(`--image accepts at most 3 refs (got ${opts.image.length})`);
+            }
+            body.image_urls = await Promise.all(opts.image.map(resolveImageRef));
+        }
+        const r = await post("/api/v1/images/generate", body);
+        if (opts.output && r.images?.[0]) {
+            await downloadTo(r.images[0], opts.output);
+            success(`Saved → ${opts.output}`);
+        }
+        if (opts.allOutput) {
+            for (let i = 0; i < r.images.length; i++) {
+                const dest = `${opts.allOutput}/image_${i + 1}.png`;
+                await downloadTo(r.images[i], dest);
+                success(`Saved → ${dest}`);
+            }
+        }
+        print(r);
+    });
+}

package/dist/commands/llm.js

@@ -0,0 +1,67 @@
+import fs from "node:fs/promises";
+import { get, post } from "../client.js";
+import { print, table } from "../utils/output.js";
+export function registerLlm(program) {
+    const llm = program
+        .command("llm")
+        .description("LLM 工具: chat (单轮对话) / presets (模型预设清单)")
+        .helpOption("-h, --help", "show help");
+    llm
+        .command("chat")
+        .description("Send a single prompt to the configured LLM and print the response")
+        .helpOption("-h, --help", "show help")
+        .requiredOption("-p, --prompt <text>", "the prompt text (use @file to read from a file)")
+        .option("-m, --model <name>", "override model (default: from server config)")
+        .option("--base-url <url>", "override LLM base URL")
+        .option("--api-key <key>", "override LLM API key")
+        .option("-t, --temperature <n>", "sampling temperature (0..2)", parseFloat)
+        .option("--max-tokens <n>", "max tokens to generate", parseInt)
+        .option("--schema <file>", "JSON schema file for structured output (returns parsed object)")
+        .addHelpText("after", [
+        "",
+        "Examples:",
+        "  reelforge llm chat -p 'Hello'",
+        "  reelforge llm chat -p @prompt.txt -m deepseek-v4-flash -t 0.4",
+        "  reelforge llm chat -p 'movie review of Inception' --schema review.json --json",
+        "",
+        "Model IDs:",
+        "  Pass the bare model id (e.g. `model-name`).",
+        "  The provider/model form returned by `rf models` (e.g. `provider/model-name`)",
+        "  may need explicit provider access on your account and is more",
+        "  likely to return 'no permission'.",
+    ].join("\n"))
+        .action(async (opts) => {
+        let prompt = opts.prompt;
+        if (prompt.startsWith("@"))
+            prompt = await fs.readFile(prompt.slice(1), "utf-8");
+        const body = { prompt };
+        if (opts.model)
+            body.model = opts.model;
+        if (opts.baseUrl)
+            body.base_url = opts.baseUrl;
+        if (opts.apiKey)
+            body.api_key = opts.apiKey;
+        if (opts.temperature !== undefined)
+            body.temperature = opts.temperature;
+        if (opts.maxTokens !== undefined)
+            body.max_tokens = opts.maxTokens;
+        if (opts.schema) {
+            body.json_schema = JSON.parse(await fs.readFile(opts.schema, "utf-8"));
+        }
+        const r = await post("/api/v1/llm/chat", body);
+        print(r.output);
+    });
+    llm
+        .command("presets")
+        .description("List built-in model presets")
+        .helpOption("-h, --help", "show help")
+        .action(async () => {
+        const r = await get("/api/v1/llm/presets");
+        table(r.presets.map((p) => ({
+            id: p.id,
+            label: p.label,
+            base_url: p.baseUrl,
+            default_model: p.defaultModel,
+        })));
+    });
+}

package/dist/commands/media.js

@@ -0,0 +1,128 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { post } from "../client.js";
+import { info, isJson, print } from "../utils/output.js";
+const MEDIA_EXT_TO_MIME = {
+    ".mp4": "video/mp4",
+    ".mov": "video/quicktime",
+    ".webm": "video/webm",
+    ".mkv": "video/x-matroska",
+    ".m4v": "video/mp4",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".m4a": "audio/mp4",
+    ".ogg": "audio/ogg",
+    ".flac": "audio/flac",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+};
+function fmtSize(bytes) {
+    if (!bytes)
+        return "0";
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+function formatHuman(r, label) {
+    const lines = [];
+    lines.push(`${label}  [${r.kind}]`);
+    if (r.formatName)
+        lines.push(`  format:       ${r.formatName}`);
+    if (r.durationSec) {
+        const min = Math.floor(r.durationSec / 60);
+        const sec = (r.durationSec % 60).toFixed(2);
+        lines.push(`  duration:     ${r.durationSec.toFixed(2)}s  (${min}:${sec.padStart(5, "0")})`);
+    }
+    if (r.sizeBytes)
+        lines.push(`  size:         ${fmtSize(r.sizeBytes)}`);
+    if (r.bitrate)
+        lines.push(`  bitrate:      ${(r.bitrate / 1000).toFixed(0)} kbps`);
+    if (r.video) {
+        lines.push(`  video:        ${r.video.codec}  ${r.video.width}×${r.video.height}  @ ${r.video.fps} fps` +
+            (r.video.pixFmt ? `  (${r.video.pixFmt})` : ""));
+    }
+    if (r.audio) {
+        lines.push(`  audio:        ${r.audio.codec}  ${r.audio.sampleRate} Hz  ${r.audio.channels}ch` +
+            (r.audio.channelLayout ? ` (${r.audio.channelLayout})` : ""));
+    }
+    const counts = r.streamCounts;
+    if (counts.subtitle > 0 || counts.other > 0) {
+        lines.push(`  streams:      ${counts.video}v + ${counts.audio}a + ${counts.subtitle}sub + ${counts.other}other`);
+    }
+    return lines;
+}
+export function registerMedia(program) {
+    const mediaCmd = program
+        .command("media")
+        .description("媒体处理原子能力。目前包含: probe (ffprobe 探针)")
+        .helpOption("-h, --help", "show help");
+    mediaCmd
+        .command("probe <input>")
+        .description("ffprobe 一个媒体文件 / URL → JSON metadata。常用于 agent 在决定下游参数前查媒体长度/编码/分辨率/帧率。")
+        .helpOption("-h, --help", "show help")
+        .addHelpText("after", [
+        "",
+        "Input 类型 (自动识别):",
+        "  本地路径    ./video.mp4              CLI base64 上传到服务端探针",
+        "  http(s) URL https://example.com/x.mp4  服务端 ffprobe 直读",
+        "",
+        "支持的扩展名:",
+        "  视频: .mp4 .mov .webm .mkv .m4v",
+        "  音频: .mp3 .wav .m4a .ogg .flac",
+        "  图片: .png .jpg .jpeg .webp",
+        "",
+        "Examples:",
+        "  # 本地 MP4",
+        "  rf media probe ./video.mp4",
+        "",
+        "  # 远程 URL (服务端直读, 不下载到本地)",
+        "  rf media probe 'https://example.com/clip.mp4'",
+        "",
+        "  # JSON 输出 (agent 解析)",
+        "  rf media probe ./video.mp4 --json",
+        "",
+        "  # 抽特定字段",
+        "  rf media probe ./video.mp4 --json | jq '.durationSec'",
+        "  rf media probe ./video.mp4 --json | jq '.video.fps'",
+        "",
+        "成本: $0 (纯 ffprobe, 无 LLM/ASR)",
+    ].join("\n"))
+        .action(async (input) => {
+        const isRemote = /^https?:\/\//i.test(input);
+        let body;
+        let label;
+        if (isRemote) {
+            body = { url: input };
+            label = input;
+        }
+        else {
+            const abs = path.resolve(input);
+            if (!fsSync.existsSync(abs))
+                throw new Error(`file not found: ${abs}`);
+            const ext = path.extname(abs).toLowerCase();
+            const mime = MEDIA_EXT_TO_MIME[ext];
+            if (!mime) {
+                throw new Error(`unsupported extension "${ext}". Supported: ${Object.keys(MEDIA_EXT_TO_MIME).join(" / ")}, ` +
+                    `or pass a URL.`);
+            }
+            const buf = await fs.readFile(abs);
+            body = { data_uri: `data:${mime};base64,${buf.toString("base64")}` };
+            label = path.basename(abs);
+        }
+        const r = await post("/api/v1/media/probe", body);
+        if (isJson()) {
+            print(r);
+            return;
+        }
+        const lines = formatHuman(r, label);
+        for (const line of lines)
+            info(line);
+    });
+}

package/dist/commands/models.js

@@ -0,0 +1,36 @@
+import { get } from "../client.js";
+import { table } from "../utils/output.js";
+export function registerModels(program) {
+    program
+        .command("models")
+        .description("列出可用模型目录 (LLM / TTS / 图片 / ASR) 含价格")
+        .helpOption("-h, --help", "show help")
+        .option("--modality <m>", "filter by modality: llm | tts | image | asr")
+        .option("--refresh", "bypass the 5-minute server-side cache")
+        .addHelpText("after", [
+        "",
+        "Examples:",
+        "  reelforge models                       # all modalities",
+        "  reelforge models --modality llm        # only chat models",
+        "  reelforge models --modality tts        # only TTS models",
+        "  reelforge models --refresh             # force a re-fetch",
+    ].join("\n"))
+        .action(async (opts) => {
+        const qs = new URLSearchParams();
+        if (opts.modality)
+            qs.set("modality", opts.modality);
+        if (opts.refresh)
+            qs.set("refresh", "1");
+        const path = `/api/v1/models${qs.toString() ? `?${qs.toString()}` : ""}`;
+        const r = await get(path);
+        table(r.models.map((m) => ({
+            id: m.id,
+            modality: m.modality,
+            owned_by: m.owned_by,
+            context: m.context_length ?? "",
+            input_per_1m: m.pricing.input_per_1m ?? "",
+            output_per_1m: m.pricing.output_per_1m ?? "",
+            per_1m_chars: m.pricing.per_1m_chars ?? "",
+        })));
+    });
+}