reelforge 1.24.3 → 1.25.0

package/dist/commands/platform.js

@@ -1,218 +0,0 @@
-import kleur from "kleur";
-import { isJson, print, table } from "../utils/output.js";
-const CANVAS_W = 1080;
-const CANVAS_H = 1920;
-const IMAGE_SIDE = 1080;
-const SLACK = CANVAS_H - IMAGE_SIDE;
-const PLATFORMS = {
-    douyin: {
-        label: "Douyin (抖音)",
-        top: 250,
-        bottom: 400,
-        left: 150,
-        right: 250,
-        centerMax: 820,
-        reason: "Cover-crop on tall phones cuts ~96-180px per side; status bar ~250px; bottom caption + progress + buttons ~400px; right action-button column ~150px from the visible edge.",
-        recommendedAnchor: 0.40,
-        anchorVariants: [
-            { value: 0.50, case: "短描述 / 无评论弹幕(默认)" },
-            { value: 0.40, case: "长描述,留更多底部 matte(推荐)" },
-            { value: 0.30, case: "很长描述 / 评论弹幕活跃" },
-        ],
-    },
-    tiktok: {
-        label: "TikTok",
-        top: 220,
-        bottom: 380,
-        left: 150,
-        right: 240,
-        centerMax: 820,
-        reason: "Same cover-crop behaviour as Douyin; slightly smaller top tab area and bottom caption.",
-        recommendedAnchor: 0.42,
-        anchorVariants: [
-            { value: 0.50, case: "short caption(default)" },
-            { value: 0.42, case: "long caption / hashtags(recommended)" },
-            { value: 0.30, case: "verbose caption + many hashtags" },
-        ],
-    },
-    wechat: {
-        label: "WeChat Channels (视频号)",
-        top: 200,
-        bottom: 350,
-        left: 120,
-        right: 120,
-        centerMax: 880,
-        reason: "Cover-crop similar; right-side action buttons less obtrusive than 抖音/TikTok, so right padding can be smaller.",
-        recommendedAnchor: 0.45,
-        anchorVariants: [
-            { value: 0.50, case: "短描述(默认)" },
-            { value: 0.45, case: "长描述(推荐)" },
-            { value: 0.30, case: "评论弹幕活跃" },
-        ],
-    },
-};
-const ALIASES = {
-    抖音: "douyin",
-    dy: "douyin",
-    tt: "tiktok",
-    视频号: "wechat",
-    weixin: "wechat",
-    wx: "wechat",
-};
-function resolveKey(input) {
-    const lower = input.toLowerCase();
-    if (PLATFORMS[lower])
-        return lower;
-    if (ALIASES[input])
-        return ALIASES[input];
-    if (ALIASES[lower])
-        return ALIASES[lower];
-    return null;
-}
-function anchorRange(z) {
-    const minAnchor = z.top / SLACK;
-    const maxAnchor = (SLACK - z.bottom) / SLACK;
-    return [Math.max(0, minAnchor), Math.min(1, maxAnchor)];
-}
-function imageYRange(anchor) {
-    const top = Math.round(anchor * SLACK);
-    const bottom = top + IMAGE_SIDE;
-    return { top, bottom, bottomMatte: CANVAS_H - bottom };
-}
-function printOverview() {
-    process.stdout.write(kleur.bold("Reference safe zones for short-video platforms (1080×1920)\n") +
-        kleur.dim("Numbers cover ~90% of mainstream phones — verify on your own target devices.\n\n"));
-    const rows = Object.entries(PLATFORMS).map(([key, z]) => {
-        const [lo, hi] = anchorRange(z);
-        return {
-            platform: key,
-            label: z.label,
-            top: z.top,
-            bottom: z.bottom,
-            left: z.left,
-            right: z.right,
-            "anchor-range": `[${lo.toFixed(2)}, ${hi.toFixed(2)}]`,
-            recommended: z.recommendedAnchor.toFixed(2),
-        };
-    });
-    table(rows);
-    process.stdout.write("\n" +
-        kleur.dim("Detail + anchor variants: ") +
-        kleur.cyan("rf platform <name>") +
-        "\n" +
-        kleur.dim("Aliases: 抖音=douyin · 视频号=wechat · tt=tiktok\n"));
-}
-function printDetail(key, z) {
-    const [lo, hi] = anchorRange(z);
-    const lines = [];
-    lines.push(kleur.bold(`${z.label} — safe zones for 1080×1920 vertical video.`));
-    lines.push("");
-    lines.push(kleur.dim("Why: ") + z.reason);
-    lines.push("");
-    lines.push(kleur.bold("Safe zones (padding from canvas edge, pixels):"));
-    lines.push(`  top              ${String(z.top).padStart(4)}    (status bar / Dynamic Island)`);
-    lines.push(`  bottom           ${String(z.bottom).padStart(4)}    (description + progress + buttons)`);
-    lines.push(`  left             ${String(z.left).padStart(4)}    (cover-crop buffer)`);
-    lines.push(`  right            ${String(z.right).padStart(4)}    (cover-crop + right action column)`);
-    lines.push(`  center-max width ${String(z.centerMax).padStart(4)}    (max safe horizontal width for centred elements)`);
-    lines.push("");
-    lines.push(kleur.bold("For blur-bg / letterbox layouts (--media-anchor-y):"));
-    lines.push(`  Safe range:  ${kleur.cyan(`[${lo.toFixed(2)}, ${hi.toFixed(2)}]`)}` +
-        kleur.dim(`   (image top ≥ ${z.top}, image bottom ≤ ${CANVAS_H - z.bottom})`));
-    lines.push("");
-    lines.push("  Variants:");
-    for (const v of z.anchorVariants) {
-        const r = imageYRange(v.value);
-        const inRange = v.value >= lo && v.value <= hi;
-        const tag = inRange ? kleur.green("✓") : kleur.red("⚠");
-        const recommended = v.value === z.recommendedAnchor ? kleur.cyan(" (recommended)") : "";
-        lines.push(`    ${tag} ${kleur.bold(v.value.toFixed(2))}  ${v.case}${recommended}`);
-        lines.push(kleur.dim(`         image y=${r.top}..${r.bottom},  bottom matte ${r.bottomMatte}px`));
-    }
-    lines.push("");
-    const outsideVariants = z.anchorVariants.filter((v) => v.value < lo || v.value > hi);
-    if (outsideVariants.length) {
-        lines.push(kleur.yellow("⚠ Caveats:"));
-        for (const v of outsideVariants) {
-            if (v.value < lo) {
-                lines.push(kleur.dim(`    anchor=${v.value.toFixed(2)} pushes image top to y=${Math.round(v.value * SLACK)}, below ${z.label} safe top (${z.top}px) — may be clipped by Dynamic Island / status bar on some devices.`));
-            }
-            else {
-                lines.push(kleur.dim(`    anchor=${v.value.toFixed(2)} pushes image bottom to y=${Math.round(v.value * SLACK) + IMAGE_SIDE}, beyond ${z.label} safe bottom (${CANVAS_H - z.bottom}) — content may be covered by platform UI.`));
-            }
-        }
-        lines.push("");
-    }
-    lines.push(kleur.bold("Quick start:"));
-    lines.push("  " +
-        kleur.cyan(`rf create "..." --layout blur-bg --media-anchor-y ${z.recommendedAnchor.toFixed(2)}`));
-    lines.push("");
-    lines.push(kleur.dim(`Note: 'full' layout fills the canvas and ignores --media-anchor-y. For platforms with heavy bottom UI like ${z.label}, prefer blur-bg or letterbox so you have a matte band to lift the image into.`));
-    process.stdout.write(lines.join("\n") + "\n");
-}
-export function registerPlatform(program) {
-    program
-        .command("platform [name]")
-        .description("查询竖屏平台 (抖音 / TikTok / 视频号) 的安全区参数与推荐 --media-anchor-y 值")
-        .helpOption("-h, --help", "show help")
-        .addHelpText("after", [
-        "",
-        "Why this exists:",
-        "  Different short-video apps overlay their own UI (status bar, caption,",
-        "  progress bar, action buttons) on top of your video. The",
-        "  --media-anchor-y knob lifts the central 1080×1080 image up or down",
-        "  inside the 1920-high canvas to keep important content out of those",
-        "  UI zones. This command tells you what anchor value to dial for each",
-        "  platform.",
-        "",
-        "Examples:",
-        "  rf platform                 # overview table for all platforms",
-        "  rf platform 抖音             # detail (alias of `douyin`)",
-        "  rf platform douyin",
-        "  rf platform tiktok",
-        "  rf platform wechat          # 视频号",
-        "  rf platform douyin --json   # machine-readable",
-    ].join("\n"))
-        .action((name) => {
-        if (isJson()) {
-            if (name) {
-                const key = resolveKey(name);
-                if (!key) {
-                    print({ ok: false, error: `unknown platform: ${name}`, known: Object.keys(PLATFORMS) });
-                    process.exit(1);
-                }
-                const z = PLATFORMS[key];
-                const [lo, hi] = anchorRange(z);
-                print({
-                    ok: true,
-                    platform: key,
-                    ...z,
-                    anchorRange: { min: lo, max: hi },
-                    canvas: { width: CANVAS_W, height: CANVAS_H, imageSide: IMAGE_SIDE },
-                });
-            }
-            else {
-                const out = {};
-                for (const [k, z] of Object.entries(PLATFORMS)) {
-                    const [lo, hi] = anchorRange(z);
-                    out[k] = { ...z, anchorRange: { min: lo, max: hi } };
-                }
-                print({ ok: true, canvas: { width: CANVAS_W, height: CANVAS_H, imageSide: IMAGE_SIDE }, platforms: out });
-            }
-            return;
-        }
-        if (name) {
-            const key = resolveKey(name);
-            if (!key) {
-                process.stderr.write(kleur.red(`✗ unknown platform: ${name}\n`) +
-                    `  known: ${Object.keys(PLATFORMS).join(", ")}\n` +
-                    `  aliases: ${Object.keys(ALIASES).join(", ")}\n`);
-                process.exit(1);
-            }
-            printDetail(key, PLATFORMS[key]);
-        }
-        else {
-            printOverview();
-        }
-    });
-}

package/dist/commands/regen.js

@@ -1,134 +0,0 @@
-import { post, get, getServer } from "../client.js";
-import { waitForTask } from "../utils/task-waiter.js";
-import { downloadTo } from "../utils/download.js";
-import { info, print, success, warn } from "../utils/output.js";
-const VALID_KINDS = [
-    "image",
-    "chart-bar",
-    "chart-line",
-    "chart-donut",
-    "kpi-grid",
-    "stat-counter",
-    "comparison-vs",
-    "tweet-card",
-    "ios-messages",
-    "notification",
-    "quote-card",
-    "terminal",
-    "code-editor",
-    "kinetic-text",
-    "bullet-list",
-];
-export function registerRegen(program) {
-    program
-        .command("regen")
-        .description("重生成已有任务里某个 scene 的画面 (音频和时间轴保持不变)")
-        .helpOption("-h, --help", "show help")
-        .argument("<task-id>", "task id from `rf create` or `rf create --preview-only`")
-        .option("--scene <n>", "1-based scene index to regenerate (REQUIRED)", (v) => parseInt(v, 10))
-        .option("--kind <kind>", `force a specific visual kind (one of: ${VALID_KINDS.join(", ")})`, (v) => {
-        if (!VALID_KINDS.includes(v)) {
-            throw new Error(`--kind must be one of: ${VALID_KINDS.join(", ")} (got "${v}")`);
-        }
-        return v;
-    })
-        .option("--hint <text>", "natural-language guidance to steer the regen (e.g. \"数字要大一点 / 用左右两栏不是上下\")")
-        .option("-o, --output <file>", "save the re-rendered MP4 to this exact path (completed-task path only)")
-        .option("--no-download", "skip downloading the re-rendered MP4 (completed-task path only)")
-        .option("--no-wait", "submit and return job id immediately (do not poll)")
-        .option("--poll-ms <ms>", "poll interval while waiting", (v) => parseInt(v, 10), 1500)
-        .option("--timeout-ms <ms>", "max wait time (default: unlimited)", (v) => parseInt(v, 10))
-        .addHelpText("after", [
-        "",
-        "What happens:",
-        "  • LLM picks a fresh { kind, spec } for the target scene only.",
-        "  • Image scenes also re-call image gen (~5-15s, ~$0.003).",
-        "  • Composition is rebuilt — opens in /preview/<task-id> after refresh.",
-        "  • If the task was already MP4-rendered, MP4 is re-rendered too.",
-        "",
-        "Behavior matrix:",
-        "  preview-only task → composition only,   ~5-30s,  no MP4 in response",
-        "  completed task    → composition + MP4,  ~45-90s, MP4 downloaded",
-        "",
-        "Examples:",
-        " rf regen 2026-05-28T12-00-00-000Z_abcd --scene 3",
-        " rf regen 2026-05-28T12-00-00-000Z_abcd --scene 3 --kind kinetic-text",
-        " rf regen 2026-05-28T12-00-00-000Z_abcd --scene 5 --kind chart-bar -o out.mp4",
-    ].join("\n"))
-        .action(async (taskId, opts) => {
-        if (opts.scene === undefined) {
-            throw new Error("--scene <n> is required (1-based scene index)");
-        }
-        if (!Number.isFinite(opts.scene) || opts.scene < 1) {
-            throw new Error("--scene must be a positive integer (1-based)");
-        }
-        info(`Regenerating scene ${opts.scene} on task ${taskId}` +
-            (opts.kind ? ` (kind=${opts.kind})` : " (free pick)") +
-            "…");
-        const body = { scene_index: opts.scene };
-        if (opts.kind)
-            body.kind = opts.kind;
-        if (opts.hint)
-            body.hint = opts.hint;
-        const submitted = await post(`/api/v1/pipelines/standard/${encodeURIComponent(taskId)}/regenerate-scene`, body);
-        if (opts.wait === false) {
-            print({ task_id: submitted.task_id, status: submitted.status });
-            return;
-        }
-        info(`Regen job: ${submitted.task_id} — waiting…`);
-        const t = await waitForTask(submitted.task_id, {
-            pollMs: opts.pollMs,
-            timeoutMs: opts.timeoutMs,
-        });
-        if (t.status !== "completed") {
-            throw new Error(t.error || `Regen ended with status ${t.status}`);
-        }
-        const result = t.result;
-        const newKind = result?.new_kind ?? "(unknown)";
-        const rerendered = !!result?.rerendered_mp4;
-        success(`Scene ${opts.scene} → kind=${newKind}, ` +
-            (rerendered ? "MP4 re-rendered" : "composition only"));
-        if (result?.price_usd !== undefined) {
-            info(`Cost: $${result.price_usd.toFixed(4)}`);
-        }
-        const serverBase = getServer().replace(/\/+$/, "");
-        info(`预览页 (刷新即可看到新画面): ${serverBase}/preview/${taskId}`);
-        if (rerendered && result?.video_url) {
-            const stdoutIsPipe = !process.stdout.isTTY;
-            const skipDownload = opts.download === false || (stdoutIsPipe && !opts.output);
-            let savedPath = opts.output;
-            if (!savedPath && !skipDownload) {
-                let title;
-                try {
-                    const list = await get("/api/v1/history?limit=200");
-                    title = list.items?.find((it) => it.task_id === taskId)?.title;
-                }
-                catch {
-                }
-                const safeTitle = (title || "video")
-                    .replace(/[\\/:*?"<>|]/g, "_")
-                    .slice(0, 80);
-                savedPath = `./${safeTitle}-${taskId}.mp4`;
-            }
-            if (savedPath) {
-                await downloadTo(result.video_url, savedPath);
-                success(`MP4 saved → ${savedPath}`);
-            }
-        }
-        else if (!rerendered) {
-            warn("Task is in preview state — no MP4 produced. Run `rf render " +
-                taskId +
-                "` when you're happy with the preview.");
-        }
-        print({
-            task_id: taskId,
-            scene_index: opts.scene,
-            new_kind: newKind,
-            rerendered_mp4: rerendered,
-            video_url: result?.video_url ?? null,
-            file_size: result?.file_size ?? null,
-            price_usd: result?.price_usd ?? null,
-            preview_urls: result?.preview_urls,
-        });
-    });
-}

package/dist/commands/render.js

@@ -1,82 +0,0 @@
-import { post, get, getServer } from "../client.js";
-import { waitForTask } from "../utils/task-waiter.js";
-import { downloadTo } from "../utils/download.js";
-import { humanDuration, info, print, success } from "../utils/output.js";
-export function registerRender(program) {
-    program
-        .command("render")
-        .description("把先前已生成预览的任务最终渲染成 MP4")
-        .helpOption("-h, --help", "show help")
-        .argument("<task-id>", "task id from `rf create --preview-only`")
-        .option("-o, --output <file>", "save the MP4 to this exact path (must include filename, e.g. ./out/x.mp4)")
-        .option("--no-download", "do not save the video locally — just print JSON with video_url")
-        .option("--fps <n>", "override FPS for this render (default: storyboard.config.videoFps)", (v) => parseInt(v, 10))
-        .option("--no-wait", "submit and return task_id immediately (do not poll)")
-        .option("--poll-ms <ms>", "poll interval while waiting", (v) => parseInt(v, 10), 1500)
-        .option("--timeout-ms <ms>", "max wait time before aborting (default unlimited)", (v) => parseInt(v, 10))
-        .addHelpText("after", [
-        "",
-        "Two-step workflow:",
-        '  1. rf create "topic" --preview-only       # builds composition, opens browser preview',
-        "  2. rf render <task-id>                    # produces the MP4",
-        "",
-        "Notes:",
-        "  • The task must already exist and have a preview-able composition",
-        "    built (via `rf create --preview-only`).",
-        "  • This re-renders from the existing composition only — it does NOT",
-        "    re-run scene-plan / TTS / ASR / image generation.",
-        "  • If you've already rendered once, calling render again will overwrite.",
-        "",
-        "Examples:",
-        " rf render 2026-05-28T12-00-00-000Z_abcd",
-        " rf render 2026-05-28T12-00-00-000Z_abcd -o ./final/space.mp4",
-        " rf render 2026-05-28T12-00-00-000Z_abcd --fps 60",
-    ].join("\n"))
-        .action(async (taskId, opts) => {
-        info(`Submitting render for ${taskId}…`);
-        const body = {};
-        if (opts.fps !== undefined)
-            body.fps = opts.fps;
-        const submitted = await post(`/api/v1/tasks/${encodeURIComponent(taskId)}/render`, body);
-        if (opts.wait === false) {
-            print({ task_id: submitted.task_id, status: submitted.status });
-            return;
-        }
-        info(`Render task: ${submitted.task_id} — waiting for completion…`);
-        const t = await waitForTask(submitted.task_id, {
-            pollMs: opts.pollMs,
-            timeoutMs: opts.timeoutMs,
-        });
-        if (t.status !== "completed") {
-            throw new Error(t.error || `Render ended with status ${t.status}`);
-        }
-        const result = t.result;
-        if (result?.video_url) {
-            const stdoutIsPipe = !process.stdout.isTTY;
-            const skipDownload = !!opts.noDownload || (stdoutIsPipe && !opts.output);
-            let savedPath = opts.output;
-            if (!savedPath && !skipDownload) {
-                let title;
-                try {
-                    const list = await get("/api/v1/history?limit=200");
-                    title = list.items?.find((it) => it.task_id === taskId)?.title;
-                }
-                catch { }
-                const safeTitle = (title || "video").replace(/[\\/:*?"<>|]/g, "_").slice(0, 80);
-                savedPath = `./${safeTitle}-${taskId}.mp4`;
-            }
-            if (savedPath) {
-                await downloadTo(result.video_url, savedPath);
-                success(`Saved → ${savedPath}`);
-            }
-        }
-        if (result?.file_size) {
-            info(`MP4 size: ${(result.file_size / 1024 / 1024).toFixed(1)} MB`);
-        }
-        void humanDuration;
-        const serverBase = getServer().replace(/\/+$/, "");
-        info(`预览页 (全功能): ${serverBase}/preview/${taskId}`);
-        info(`纯播放器:    ${serverBase}/preview/${taskId}/player`);
-        print({ task_id: taskId, ...result });
-    });
-}

package/dist/commands/script.js

@@ -1,128 +0,0 @@
-import fs from "node:fs/promises";
-import { info, isJson, print } from "../utils/output.js";
-const CHARS_PER_SEC_ZH = 5;
-const WORDS_PER_SEC_EN = 2.7;
-const TTS_PRICES_USD_PER_CHAR = {
-    "vox/index-tts-2": 1.575 / 1e6,
-    "edge": 0,
-};
-function countCjk(s) {
-    const re = /[一-鿿㐀-䶿豈-﫿　-〿＀-￯]/gu;
-    return (s.match(re) || []).length;
-}
-function countAscii(s) {
-    const re = /[A-Za-z0-9]/g;
-    return (s.match(re) || []).length;
-}
-function countWords(s) {
-    return s.split(/\s+/).filter(Boolean).length;
-}
-function detectLang(text) {
-    const cjk = countCjk(text);
-    const ascii = countAscii(text);
-    return cjk * 5 >= ascii ? "zh" : "en";
-}
-function estimate(text, langOverride) {
-    const lang = langOverride ?? detectLang(text);
-    const cjk = countCjk(text);
-    const ascii = countAscii(text);
-    const words = countWords(text);
-    const chars = cjk + ascii;
-    const seconds = lang === "zh"
-        ? chars / CHARS_PER_SEC_ZH
-        : words > 0 ? words / WORDS_PER_SEC_EN : chars / 12;
-    const billedChars = text.length;
-    const tts = {};
-    for (const [model, pricePerChar] of Object.entries(TTS_PRICES_USD_PER_CHAR)) {
-        tts[model] = Number((billedChars * pricePerChar).toFixed(6));
-    }
-    const totalSec = Math.round(seconds);
-    const min = Math.floor(totalSec / 60);
-    const sec = totalSec % 60;
-    const hhmmss = `${min}:${String(sec).padStart(2, "0")}`;
-    const notes = lang === "zh"
-        ? `中文口播按 ${CHARS_PER_SEC_ZH} 字 / 秒估算 (普通播报速度)`
-        : `English narration estimated at ${WORDS_PER_SEC_EN} words / sec`;
-    return {
-        lang,
-        chars,
-        ascii_chars: ascii,
-        cjk_chars: cjk,
-        words,
-        seconds: Number(seconds.toFixed(2)),
-        hhmmss,
-        tts_cost_usd_by_model: tts,
-        notes,
-    };
-}
-async function loadText(input) {
-    if (input.startsWith("@")) {
-        const file = input.slice(1);
-        return (await fs.readFile(file, "utf-8")).trim();
-    }
-    return input;
-}
-export function registerScript(program) {
-    const scriptCmd = program
-        .command("script")
-        .description("脚本相关原子能力 (零 LLM / 零网络的本地工具)。")
-        .helpOption("-h, --help", "show help");
-    scriptCmd
-        .command("estimate <text-or-@file>")
-        .description("估算脚本字数 / 口播时长 / TTS 成本。零网络, 零调用 — 在送 TTS 或 scene-plan 之前快速判断 \"这段念出来多久 / 多少钱\"。")
-        .helpOption("-h, --help", "show help")
-        .option("--lang <zh|en>", "强制语言 (默认按 CJK 比例自动判断)")
-        .addHelpText("after", [
-        "",
-        "Examples:",
-        "  # 字符串直传",
-        "  rf script estimate '为什么我们还没有找到外星文明？我们在听, 也在被听。'",
-        "",
-        "  # 从文件读 (适合长脚本)",
-        "  rf script estimate @./draft.txt",
-        "",
-        "  # JSON 模式 (agent 解析)",
-        "  rf script estimate @./draft.txt --json",
-        "",
-        "  # 强制按英文估时",
-        "  rf script estimate @./english.txt --lang en",
-        "",
-        "速率假设:",
-        "  中文: 5 字 / 秒 (普通抖音口播速度)",
-        "  英文: 2.7 words / sec (~ 160 wpm)",
-        "",
-        "TTS 成本估算 (按云端 list price):",
-        "  云端 TTS:  $1.575 / 1M chars",
-        "  本地 TTS:  $0",
-        "",
-        "成本: $0 (纯本地计算, 无服务端调用)",
-    ].join("\n"))
-        .action(async (input, opts) => {
-        const text = await loadText(input);
-        if (!text)
-            throw new Error("script is empty");
-        let langOverride;
-        if (opts.lang !== undefined) {
-            if (opts.lang !== "zh" && opts.lang !== "en") {
-                throw new Error(`--lang must be zh or en (got: ${opts.lang})`);
-            }
-            langOverride = opts.lang;
-        }
-        const r = estimate(text, langOverride);
-        if (isJson()) {
-            print(r);
-            return;
-        }
-        info(`lang:          ${r.lang}`);
-        info(`chars:         ${r.chars}  (CJK ${r.cjk_chars} + ASCII letters/digits ${r.ascii_chars})`);
-        if (r.lang === "en")
-            info(`words:         ${r.words}`);
-        info(`narration:     ${r.seconds.toFixed(1)}s  (${r.hhmmss})`);
-        info("TTS cost estimate:");
-        for (const [model, cost] of Object.entries(r.tts_cost_usd_by_model)) {
-            const costStr = cost === 0 ? "$0 (free)" : `$${cost.toFixed(6)}`;
-            info(`  ${model.padEnd(20)} ${costStr}`);
-        }
-        info(`note:          ${r.notes}`);
-    });
-}

package/dist/commands/styles.js

@@ -1,113 +0,0 @@
-import { get } from "../client.js";
-import { isJson, print } from "../utils/output.js";
-import kleur from "kleur";
-function displayWidth(s) {
-    let w = 0;
-    for (const c of s)
-        w += c.charCodeAt(0) > 0x7f ? 2 : 1;
-    return w;
-}
-function padDisplay(s, width) {
-    const pad = Math.max(0, width - displayWidth(s));
-    return s + " ".repeat(pad);
-}
-function renderTable(presets) {
-    if (!presets.length) {
-        process.stdout.write("(empty)\n");
-        return;
-    }
-    const idW = Math.max(2, ...presets.map((p) => p.id.length));
-    const labelW = Math.max(5, ...presets.map((p) => displayWidth(p.label)));
-    const sceneW = Math.max(5, ...presets.map((p) => displayWidth(p.scene)));
-    const hasPreview = presets.some((p) => p.preview_url);
-    const header = hasPreview
-        ? `${padDisplay("id", idW)}  ${padDisplay("label", labelW)}  ${padDisplay("scene", sceneW)}  preview`
-        : `${padDisplay("id", idW)}  ${padDisplay("label", labelW)}  ${padDisplay("scene", sceneW)}  prefix`;
-    process.stdout.write(kleur.bold(header) + "\n");
-    process.stdout.write(`${"-".repeat(idW)}  ${"-".repeat(labelW)}  ${"-".repeat(sceneW)}  ${"-".repeat(7)}\n`);
-    for (const p of presets) {
-        const last = hasPreview ? p.preview_url || "" : p.prefix;
-        process.stdout.write(`${padDisplay(p.id, idW)}  ${padDisplay(p.label, labelW)}  ${padDisplay(p.scene, sceneW)}  ${last}\n`);
-    }
-}
-function renderDetail(p, preview) {
-    process.stdout.write(`\n● ${p.id}  ${p.label}\n`);
-    if (p.preview_url) {
-        process.stdout.write(`  预览 (直接浏览器打开): ${p.preview_url}\n`);
-    }
-    if (preview) {
-        process.stdout.write(`  样图基线 → subject="${preview.subject}"\n`);
-        if (preview.model || preview.size) {
-            process.stdout.write(`               model=${preview.model || "?"} · size=${preview.size || "?"}\n`);
-        }
-    }
-    process.stdout.write(`  scene: ${p.scene}\n`);
-    process.stdout.write(`  prefix: ${p.prefix}\n`);
-}
-export function registerStyles(program) {
-    const group = program
-        .command("styles")
-        .description("图像风格预设清单 (供 --style / body.style 使用)")
-        .helpOption("-h, --help", "show help");
-    group
-        .command("list")
-        .description("List all image style presets from the server (with preview URLs).")
-        .helpOption("-h, --help", "show help")
-        .option("--id <styleId>", "只看某个风格的详细信息 (id, label, scene, prefix, preview_url)")
-        .option("--json", "JSON 输出 (默认人读表格); 适合 agent / 脚本消费")
-        .addHelpText("after", [
-        "",
-        "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
-        "AGENT 帮用户选风格的标准流程 (LLM 必读)",
-        "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
-        "  当用户没明确指定 --style,或说『我不知道选哪个』时,不要替用户拍板,",
-        "  也不要按 prefix 文字给用户脑补描述 — 直接走这条路径:",
-        "",
-        "  Step 1. 拉 catalog (含 preview_url):",
-        "    rf styles list --json",
-        "",
-        "  Step 2. 把 17 张 preview_url 列表丢给用户 (markdown 图片格式效果最好,",
-        "         用户在你的聊天界面里能直接看到缩略图):",
-        "    ![cinematic](https://rf-cdn.oss-cn-hangzhou.aliyuncs.com/image-style-samples/cinematic.png)",
-        "    ![watercolor](https://rf-cdn.oss-cn-hangzhou.aliyuncs.com/image-style-samples/watercolor.png)",
-        "    ... (其余 15 个同样格式)",
-        "",
-        "  Step 3. 用户照图选,把 id 喂给 `rf create --style <id>`.",
-        "",
-        "  17 张 preview 都是同一个 subject (一座黄昏悬崖上的灯塔) 在不同风格下的",
-        "  渲染样本,只有风格变量在动 — 用户看一眼立刻知道每个风格实际长啥样,",
-        "  不需要现场跑图.",
-        "",
-        "Use the id with `rf create --style <id>` or write it into a recipe:",
-        "  rf create --script @x.txt --style flat",
-        '  { "voice_id": "熊小二", "style": "flat" }   # recipe',
-        "",
-        "Examples:",
-        "  rf styles list                       # 全部 17 个风格 + preview URL 表格",
-        "  rf styles list --id watercolor       # 单看 watercolor 的详情 (含 prefix)",
-        "  rf styles list --json                # JSON 输出 (agent 必跑这条)",
-    ].join("\n"))
-        .action(async (opts) => {
-        const data = await get("/api/v1/styles");
-        const presets = Array.isArray(data.styles) ? data.styles : [];
-        const filtered = opts.id ? presets.filter((s) => s.id === opts.id) : presets;
-        if (opts.id && filtered.length === 0) {
-            throw new Error(`unknown style id "${opts.id}". Known: ${presets.map((s) => s.id).join(", ")}`);
-        }
-        if (opts.json || isJson()) {
-            const payload = opts.id ? filtered[0] : { preview: data.preview, styles: filtered };
-            print(payload);
-            return;
-        }
-        if (opts.id) {
-            renderDetail(filtered[0], data.preview);
-        }
-        else {
-            if (data.preview?.subject) {
-                process.stdout.write(`\n样图基线 (preview_url 都是按这个 subject 渲的):\n  ${data.preview.subject}\n\n`);
-            }
-            renderTable(filtered);
-            process.stdout.write(`\n(用 \`rf styles list --id <id>\` 看单个风格的详情,或 --json 拿结构化输出)\n\n`);
-        }
-    });
-}