reelforge2 1.0.0 → 1.0.1

package/dist/commands/audio.js

@@ -19,9 +19,9 @@ export function registerAudio(program) {
         .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]'",
+        " rf2 audio transcribe -f ./narration.mp3",
+        " rf2 audio transcribe --url https://example.com/clip.mp3 --language zh",
+        " rf2 audio transcribe -f ./voice.wav --json | jq '.words[:5]'",
     ].join("\n"))
         .action(async (opts) => {
         if (!opts.file && !opts.url) {

package/dist/commands/content.js

@@ -22,9 +22,9 @@ export function registerContent(program) {
         "  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",
+        " rf2 content scene-plan -t '深夜便利店' -d 60 -p slow",
+        " rf2 content scene-plan --script @./my-script.txt -p fast",
+        " rf2 content scene-plan -t '雨天的玻璃窗' --json | jq .scenes",
     ].join("\n"))
         .action(async (opts) => {
         const hasTopic = typeof opts.topic === "string" && opts.topic.length > 0;

package/dist/commands/create.js

@@ -346,7 +346,7 @@ export function registerCreate(program) {
         .option("--brand-position <pos>", "where to render brand chrome: top-left | top-right | bottom-left | bottom-right")
         .option("--brand-color <css>", "brand text color, e.g. '#ffffff' (default)")
         // --- Audio (TTS) ---
-        .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf tts voices`")
+        .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf2 tts voices`")
         .option("--tts-speed <n>", "speech speed 0.5..2 (default 1.0). Only honored by Edge-TTS backends — vox/index-tts-2 (the default) ignores it.", parseFloat)
         // --- Service overrides ---
         .option("--llm-model <id>", "override the LLM model used for scene-plan")
@@ -366,7 +366,7 @@ export function registerCreate(program) {
         .option("--no-download", "do not save the video locally — just print JSON with video_url")
         .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))
-        .option("--preview-only", "skip the MP4 render — build the HyperFrames composition + open a browser preview URL. Render later via `rf render <task-id>`. Fastest iteration loop.")
+        .option("--preview-only", "skip the MP4 render — build the HyperFrames composition + open a browser preview URL. Render later via `rf2 render <task-id>`. Fastest iteration loop.")
         .option("--no-open", "do not auto-open the preview URL in the system browser (preview mode only)")
         .addHelpText("after", [
         "",
@@ -418,7 +418,7 @@ export function registerCreate(program) {
         "  Build the HyperFrames composition, skip the MP4 render. The CLI prints",
         "  preview URLs (a full studio-like page + a bare-player page) and opens",
         "  the studio in your browser. Iterate visually first; render to MP4 later",
-        "  with `rf render <task-id>` — much faster feedback loop than waiting",
+        "  with `rf2 render <task-id>` — much faster feedback loop than waiting",
         "  60-90s for the MP4 on every tweak.",
         "",
         "Image style presets (--style <preset>) — quick shortcut for --prompt-prefix:",
@@ -434,46 +434,46 @@ export function registerCreate(program) {
         "",
         "Examples (`rf` is the short alias):",
         "  # Minimum — AI writes a 45s script",
-        '  rf create "为什么我们还没找到外星文明？"',
+        ' rf2 create "为什么我们还没找到外星文明？"',
         "",
         "  # 60-second video with slow visual pace",
-        '  rf create "..." -d 60 -p slow',
+        ' rf2 create "..." -d 60 -p slow',
         "",
         "  # Your own script, you decide the wording",
-        "  rf create --script @./script.txt",
-        '  rf create --script "整段文案文本..."',
+        " rf2 create --script @./script.txt",
+        ' rf2 create --script "整段文案文本..."',
         "",
         "  # Pick a built-in image style preset",
-        '  rf create "..." --style cinematic',
+        ' rf2 create "..." --style cinematic',
         "",
         "  # Cross-scene character consistency (auto-switches image model)",
-        '  rf create "主角小女孩的一天" --character-ref ./hero.png',
-        '  rf create "..." --character-ref https://example.com/hero.png',
+        ' rf2 create "主角小女孩的一天" --character-ref ./hero.png',
+        ' rf2 create "..." --character-ref https://example.com/hero.png',
         "",
         "  # Motion + subtitle style combos",
-        '  rf create "..." --motion max --subtitle-style stroke    # 抖音网红风',
-        '  rf create "..." --motion lite --subtitle-style cinema   # 文艺纪录片',
-        '  rf create "..." --motion off                            # PPT 模式（旧行为）',
+        ' rf2 create "..." --motion max --subtitle-style stroke    # 抖音网红风',
+        ' rf2 create "..." --motion lite --subtitle-style cinema   # 文艺纪录片',
+        ' rf2 create "..." --motion off                            # PPT 模式（旧行为）',
         "",
         "  # Layout combos",
-        '  rf create "财经日报" --layout blur-bg                       # 小红书 / 抖音 风（图表内容首选）',
-        '  rf create "纪录片片段" --layout letterbox --motion max       # 电影感',
-        '  rf create "..." --layout letterbox --layout-matte-color "#1a1a1a"  # 柔和黑',
+        ' rf2 create "财经日报" --layout blur-bg                       # 小红书 / 抖音 风（图表内容首选）',
+        ' rf2 create "纪录片片段" --layout letterbox --motion max       # 电影感',
+        ' rf2 create "..." --layout letterbox --layout-matte-color "#1a1a1a"  # 柔和黑',
         "",
         "  # Preview-first workflow — see the storyboard before paying for the MP4",
-        '  rf create "..." --preview-only        # opens browser studio, no MP4 yet',
-        "  rf render <task-id>                   # finalize the MP4 when happy",
+        ' rf2 create "..." --preview-only        # opens browser studio, no MP4 yet',
+        " rf2 render <task-id>                   # finalize the MP4 when happy",
         "",
         "  # Recipe + replay last",
-        "  rf create --recipe ./space.recipe.json",
-        "  rf create --redo                       # replay last successful create",
-        "  rf create --redo -p fast               # replay with one knob tweaked",
+        " rf2 create --recipe ./space.recipe.json",
+        " rf2 create --redo                       # replay last successful create",
+        " rf2 create --redo -p fast               # replay with one knob tweaked",
         "",
         "  # See exactly what would be sent (no submission)",
-        '  rf create "..." -d 60 --dry-run',
+        ' rf2 create "..." -d 60 --dry-run',
         "",
         "  # Pipe-friendly",
-        '  rf create "..." --no-download --json | jq -r .video_url',
+        ' rf2 create "..." --no-download --json | jq -r .video_url',
     ].join("\n"))
         .action(async (topicArg, opts) => {
         if (opts.output) {
@@ -620,7 +620,7 @@ export function registerCreate(program) {
         //   preview_only=true  → no MP4; we just announce URLs and (optionally) open the browser
         //   normal             → download MP4 (current behavior)
         if (result?.render_pending) {
-            info(`MP4 渲染未触发 (preview-only)。完成后用 \`rf render ${t.id}\` 生成。`);
+            info(`MP4 渲染未触发 (preview-only)。完成后用 \`rf2 render ${t.id}\` 生成。`);
             if (previewPageAbs && !opts.noOpen) {
                 await openInBrowser(previewPageAbs).catch((e) => {
                     warn(`无法自动打开浏览器: ${e.message}; 请手动复制 URL`);

package/dist/commands/llm.js

@@ -26,7 +26,7 @@ export function registerLlm(program) {
         "",
         "Model IDs:",
         "  Pass the bare model id (e.g. `deepseek-v4-flash`, `gpt-5-nano`).",
-        "  The provider/model form returned by `rf models` (e.g. `openai/gpt-5-nano`)",
+        "  The provider/model form returned by `rf2 models` (e.g. `openai/gpt-5-nano`)",
         "  may need explicit provider access on your RelayX account and is more",
         "  likely to return 'no permission'.",
     ].join("\n"))

package/dist/commands/pipelines.js

@@ -50,11 +50,11 @@ export function registerPipelines(program) {
         .option("--layout <preset>", "image layout: full (default) | blur-bg | letterbox. See below.")
         .option("--layout-matte-color <css>", "letterbox matte color (CSS). Ignored unless --layout letterbox. Default: black.")
         .option("--subtitle-style <preset>", "subtitle visual style: plate (default) | stroke | cinema")
-        .option("--preview-only", "build the HyperFrames composition and return preview URLs; skip MP4 render. Finalize later with `rf render <task-id>`.")
+        .option("--preview-only", "build the HyperFrames composition and return preview URLs; skip MP4 render. Finalize later with `rf2 render <task-id>`.")
         .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen | rx-image-qwen-edit)")
         .option("--prompt-prefix <text>", "style prefix prepended to every image prompt")
         .option("--character-ref <urlOrPath>", "main character ref for cross-scene identity lock")
-        .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf tts voices`")
+        .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf2 tts voices`")
         .option("--tts-speed <n>", "speech speed (0.5..2; default 1.0). Only honored by Edge-TTS backends — vox/index-tts-2 (default) ignores it.", parseFloat)
         .option("--video-fps <n>", "output video fps (default 30)", (v) => parseInt(v, 10))
         .option("--segment-min-chars <N>", "subtitle SEGMENT (分段) min chars (default 10). Segment = one on-screen subtitle unit, not a visual line.", (v) => parseInt(v, 10))
@@ -78,12 +78,12 @@ export function registerPipelines(program) {
         "  · Image is generated at the actual on-screen size, so you don't pay for cropped pixels.",
         "",
         "Examples:",
-        "  rf pipelines standard -t 'why we explore space' -d 60 -o space.mp4",
-        "  rf pipelines standard --script @script.txt -p slow --motion max -o out.mp4",
-        "  rf pipelines standard -t '财经日报' --layout blur-bg --subtitle-style plate -o out.mp4",
-        "  rf pipelines standard -t '纪录片' --layout letterbox --motion max -o film.mp4",
+        " rf2 pipelines standard -t 'why we explore space' -d 60 -o space.mp4",
+        " rf2 pipelines standard --script @script.txt -p slow --motion max -o out.mp4",
+        " rf2 pipelines standard -t '财经日报' --layout blur-bg --subtitle-style plate -o out.mp4",
+        " rf2 pipelines standard -t '纪录片' --layout letterbox --motion max -o film.mp4",
         "",
-        "Tip: `rf create` is a more ergonomic wrapper around the same endpoint.",
+        "Tip: `rf2 create` is a more ergonomic wrapper around the same endpoint.",
     ].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;

package/dist/commands/render.js

@@ -7,7 +7,7 @@ export function registerRender(program) {
         .command("render")
         .description("Finalize a preview-only task into an MP4 by running the HF render step on the server.")
         .helpOption("-h, --help", "show help")
-        .argument("<task-id>", "task id from `rf create --preview-only`")
+        .argument("<task-id>", "task id from `rf2 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))
@@ -28,9 +28,9 @@ export function registerRender(program) {
         "  • 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",
+        " rf2 render 2026-05-28T12-00-00-000Z_abcd",
+        " rf2 render 2026-05-28T12-00-00-000Z_abcd -o ./final/space.mp4",
+        " rf2 render 2026-05-28T12-00-00-000Z_abcd --fps 60",
     ].join("\n"))
         .action(async (taskId, opts) => {
         info(`Submitting render for ${taskId}…`);

package/dist/commands/subtitles.js

@@ -28,8 +28,8 @@ export function registerSubtitles(program) {
         "  No punctuation in window → force-cut at max.",
         "",
         "Examples:",
-        "  rf subtitles split -t '雨水缓缓滑落在玻璃窗上，像是无声的泪珠。'",
-        "  rf subtitles split -t @./narration.txt --min 8 --max 30",
+        " rf2 subtitles split -t '雨水缓缓滑落在玻璃窗上，像是无声的泪珠。'",
+        " rf2 subtitles split -t @./narration.txt --min 8 --max 30",
     ].join("\n"))
         .action(async (opts) => {
         let text = opts.text;

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
  * ReelForge CLI — entry point.
  *
- * Every leaf command supports `--help`. Sub-groups (e.g. `reelforge llm`) print
+ * Every leaf command supports `--help`. Sub-groups (e.g. `reelforge2 llm`) print
  * a list of their sub-commands when invoked without arguments OR with `--help`.
  */
 import { readFileSync } from "node:fs";
@@ -67,14 +67,14 @@ program
 program.addHelpText("afterAll", [
     "",
     "Examples (tip: `rf` works wherever you see `reelforge`):",
-    "  rf create '为什么我们还没有找到外星文明？'              # auto-saves to ./<title>-<id>.mp4 in cwd",
-    "  rf create '...' -o ./videos/space.mp4                # pick the exact path",
-    "  rf llm chat --prompt 'explain antifragile in 3 sentences'",
-    "  rf tts edge --text 'hello world' --voice en-US-AriaNeural -o out.mp3",
-    "  rf images generate --prompt 'a cat' --model rx-image-flux -o cat.png",
-    "  rf pipelines standard -t 'why we explore space' -d 60",
-    "  rf tasks list --status running",
-    "  rf config get",
+    " rf2 create '为什么我们还没有找到外星文明？'              # auto-saves to ./<title>-<id>.mp4 in cwd",
+    " rf2 create '...' -o ./videos/space.mp4                # pick the exact path",
+    " rf2 llm chat --prompt 'explain antifragile in 3 sentences'",
+    " rf2 tts edge --text 'hello world' --voice en-US-AriaNeural -o out.mp3",
+    " rf2 images generate --prompt 'a cat' --model rx-image-flux -o cat.png",
+    " rf2 pipelines standard -t 'why we explore space' -d 60",
+    " rf2 tasks list --status running",
+    " rf2 config get",
 ].join("\n"));
 registerAuth(program);
 registerCreate(program);
@@ -105,7 +105,7 @@ async function main() {
     catch (err) {
         if (err instanceof ApiCallError) {
             const hint = err.status === 401
-                ? "  → Run `reelforge login <api_key>` first, or pass --api-key <key>."
+                ? "  → Run `reelforge2 login <api_key>` first, or pass --api-key <key>."
                 : err.status === 402
                     ? "  → Insufficient balance. Top up via admin."
                     : err.status === 403

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelforge2",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI for ReelForge2 — HyperFrames-powered video engine, sibling deployment of the legacy `reelforge`. Installs as `reelforge2` and the short alias `rf2`. Defaults to https://reelforge2.timor419.com. Use this CLI for the HF-engine line; the legacy ffmpeg-line stays on `reelforge` (0.x.x).",
   "license": "Apache-2.0",
   "type": "module",