reelforge 0.7.0 → 0.7.1

package/dist/commands/create.js

@@ -184,8 +184,6 @@ function optsToBody(opts) {
         out.prompt_prefix = opts.promptPrefix;
     if (opts.characterRef !== undefined)
         out.character_ref = opts.characterRef;
-    if (opts.styleRef !== undefined)
-        out.style_ref = opts.styleRef;
     if (opts.voiceId !== undefined)
         out.voice_id = opts.voiceId;
     if (opts.ttsSpeed !== undefined)
@@ -339,11 +337,10 @@ export function registerCreate(program) {
         .option("--frame-template <keyOrPath>", "HTML frame template: preset key (e.g. 1080x1920/image_default.html) OR path to a local .html (auto-sent inline)")
         .option("--frame-template-size <wxh>", "size for inline HTML when the file lacks <meta template:width|height>, e.g. 1080x1920")
         .option("--frame-template-type <type>", "inline template type: image (default) | static | asset. Controls whether AI image generation runs per scene.")
-        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen | rx-image-qwen-edit). Auto-switches to rx-image-qwen-edit when --character-ref or --style-ref is set.")
+        .option("--image-model <id>", "RelayX image model (rx-image-z | rx-image-flux | rx-image-qwen | rx-image-qwen-edit). Auto-switches to rx-image-qwen-edit when --character-ref is set.")
         .option("--prompt-prefix <text>", "raw style prefix prepended to every image prompt (overrides --style)")
         .option("--style <preset>", "image style preset — shortcut for --prompt-prefix; see 'Style presets' below")
         .option("--character-ref <urlOrPath>", "reference image of the main character — locks identity across scenes. URL, data: URI, or local png/jpg/webp path (auto-encoded). Auto-enables rx-image-qwen-edit.")
-        .option("--style-ref <urlOrPath>", "reference image of the overall visual style — locks palette/composition/mood across scenes. Same input formats as --character-ref.")
         // --- Audio (TTS) ---
         .option("--voice-id <id>", "RelayX TTS voice id (default 专业解说); see `rf tts voices`")
         .option("--tts-speed <n>", "speech speed 0.5..2 (default 1.0)", parseFloat)
@@ -417,8 +414,7 @@ export function registerCreate(program) {
         "",
         "  # Cross-scene character consistency (auto-switches image model)",
         '  rf create "主角小女孩的一天" --character-ref ./hero.png',
-        "  rf create '...' --character-ref ./hero.png --style-ref ./mood.jpg",
-        '  rf create "..." --style-ref https://example.com/style.png',
+        '  rf create "..." --character-ref https://example.com/hero.png',
         "",
         "  # Recipe + replay last",
         "  rf create --recipe ./space.recipe.json",
@@ -480,19 +476,14 @@ export function registerCreate(program) {
         if (typeof body.script === "string") {
             body.script = await resolveTextOrFile(body.script);
         }
-        // Resolve refs: local file paths → data: URIs (RelayX accepts both
-        // https:// and data: in image_urls). Done after layering so a recipe
-        // can carry refs by path too.
+        // Resolve character ref: local file path → data: URI (RelayX accepts
+        // both https:// and data: in image_urls). Done after layering so a
+        // recipe can carry the ref by path too.
         const resolvedChar = await resolveRefImage(body.character_ref, "--character-ref");
-        const resolvedStyle = await resolveRefImage(body.style_ref, "--style-ref");
         if (resolvedChar !== undefined)
             body.character_ref = resolvedChar;
         else
             delete body.character_ref;
-        if (resolvedStyle !== undefined)
-            body.style_ref = resolvedStyle;
-        else
-            delete body.style_ref;
         // Validate content mode
         const hasTopic = typeof body.topic === "string" && body.topic.trim().length > 0;
         const hasScript = typeof body.script === "string" && body.script.trim().length > 0;

package/dist/commands/images.js

@@ -1,6 +1,35 @@
+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";
+/**
+ * Reference image resolver. Accepts an https:// URL, a data: URI, or a local
+ * file path. Local files are read + base64-encoded into a data: URI so the
+ * server can forward them inside the JSON body — no file-hosting step needed.
+ */
+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")
@@ -8,19 +37,30 @@ export function registerImages(program) {
         .helpOption("-h, --help", "show help");
     images
         .command("generate")
-        .description("Generate an image via RelayX")
+        .description("Generate an image via RelayX (text-to-image or ref-image, depending on model + --image)")
         .helpOption("-h, --help", "show help")
-        .requiredOption("-p, --prompt <text>", "text prompt")
-        .option("-m, --model <id>", "RelayX image model id (rx-image-z | rx-image-flux | rx-image-qwen)")
+        .requiredOption("-p, --prompt <text>", "text prompt. With --image, reference each ref via 「图 N」/「Image N」.")
+        .option("-m, --model <id>", "RelayX 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",
-        "  reelforge images generate -p 'cyberpunk city, neon, 9:16' --width 1080 --height 1920 -o city.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 };
@@ -30,6 +70,12 @@ export function registerImages(program) {
             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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelforge",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "CLI for ReelForge Studio — AI video engine. Installs as both `reelforge` and the short alias `rf`. Every REST API exposed as a command, with --help on every level.",
   "license": "Apache-2.0",
   "type": "module",