honeydo 0.1.0 → 0.1.2

package/packages/lmedia/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import * as fs5 from 'fs';
+import * as fs7 from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { fileURLToPath } from 'url';
@@ -10,12 +10,16 @@ import { setTimeout } from 'timers/promises';
 import { createHash } from 'crypto';
 
 var HERE = path.dirname(fileURLToPath(import.meta.url));
-function rootCandidate() {
+var IMAGE_SNAPSHOT_REPOS = ["Qwen/Qwen-Image-2512", "Qwen/Qwen-Image-Edit-2511"];
+function imageHubDir() {
+  return path.join(os.homedir(), ".cache", "huggingface", "hub");
+}
+function resolveRuntimeRoot() {
   const home = os.homedir();
   let root = process.env.LMEDIA_RUNTIME ?? "";
   if (!root) {
     const link = path.join(home, ".lmedia", "runtime");
-    if (fs5.existsSync(link)) root = fs5.realpathSync(link);
+    if (fs7.existsSync(link)) root = fs7.realpathSync(link);
   }
   if (!root) root = path.join(home, "ml", "lb-local-gen");
   return root;
@@ -28,22 +32,23 @@ function pythonDriverDir() {
     // src/lib/runtime.ts（tsx dev）→ <pkg>/python
   ];
   for (const c of candidates) {
-    if (fs5.existsSync(path.join(c, "sfx.py"))) return c;
+    if (fs7.existsSync(path.join(c, "sfx.py"))) return c;
   }
   return candidates[0];
 }
 function resolveVideoRuntime() {
-  const root = rootCandidate();
+  const root = resolveRuntimeRoot();
   return {
     root,
     venvVideo: path.join(root, ".venv-video"),
     pythonVideo: path.join(root, ".venv-video", "bin", "python"),
     mmh3turbo: path.join(root, ".venv-video", "bin", "mmh3turbo"),
-    weightsDir: path.join(os.homedir(), ".cache", "mmh3turbo")
+    weightsDir: process.env.LMEDIA_WEIGHTS_DIR ?? path.join(os.homedir(), ".cache", "mmh3turbo"),
+    pythonDir: pythonDriverDir()
   };
 }
 function resolveAudioRuntime() {
-  const root = rootCandidate();
+  const root = resolveRuntimeRoot();
   return {
     root,
     pythonAudio: path.join(root, ".venv-audio", "bin", "python"),
@@ -57,28 +62,28 @@ function hfHubCache() {
 }
 function hfSnapshot(repo) {
   const dir = path.join(hfHubCache(), `models--${repo.replace("/", "--")}`, "snapshots");
-  if (!fs5.existsSync(dir)) return null;
-  const snaps = fs5.readdirSync(dir).filter((s) => !s.startsWith("."));
+  if (!fs7.existsSync(dir)) return null;
+  const snaps = fs7.readdirSync(dir).filter((s) => !s.startsWith("."));
   return snaps.length ? path.join(dir, snaps[0]) : null;
 }
 function resolveRuntime() {
-  const root = rootCandidate();
-  if (!fs5.existsSync(root)) {
+  const root = resolveRuntimeRoot();
+  if (!fs7.existsSync(root)) {
     throw new Error(
       `\u8FD0\u884C\u65F6\u672A\u627E\u5230: ${root}
 \u8BF7\u8BBE\u7F6E LMEDIA_RUNTIME \u6307\u5411\u672C\u5730\u751F\u6210\u6808\u76EE\u5F55\uFF08\u542B .venv/.venv-train\uFF09\uFF0C\u6216\u521B\u5EFA\u8F6F\u94FE: mkdir -p ~/.lmedia && ln -s <\u6808\u76EE\u5F55> ~/.lmedia/runtime`
     );
   }
-  const hf = path.join(os.homedir(), ".cache", "huggingface", "hub");
+  const hf = imageHubDir();
   const snapOf = (repo) => {
     const modelDir = path.join(hf, `models--${repo.replace("/", "--")}`);
     const dir = path.join(modelDir, "snapshots");
-    if (!fs5.existsSync(dir)) throw new Error(`\u6A21\u578B\u672A\u4E0B\u8F7D: ${repo}\uFF08\u5148\u8FD0\u884C lmedia doctor \u5B89\u88C5\u6307\u5F15\uFF09`);
-    const snaps = fs5.readdirSync(dir);
+    if (!fs7.existsSync(dir)) throw new Error(`\u6A21\u578B\u672A\u4E0B\u8F7D: ${repo}\uFF08\u5148\u8FD0\u884C lmedia doctor \u5B89\u88C5\u6307\u5F15\uFF09`);
+    const snaps = fs7.readdirSync(dir);
     if (snaps.length === 0) throw new Error(`\u6A21\u578B\u5FEB\u7167\u4E3A\u7A7A: ${repo}`);
     const refFile = path.join(modelDir, "refs", "main");
-    if (fs5.existsSync(refFile)) {
-      const ref = fs5.readFileSync(refFile, "utf-8").trim();
+    if (fs7.existsSync(refFile)) {
+      const ref = fs7.readFileSync(refFile, "utf-8").trim();
       if (snaps.includes(ref)) return path.join(dir, ref);
     }
     return path.join(dir, snaps[0]);
@@ -87,8 +92,8 @@ function resolveRuntime() {
     root,
     pythonGen: path.join(root, ".venv-train", "bin", "python"),
     pythonFast: path.join(root, ".venv", "bin", "python"),
-    snapshot: snapOf("Qwen/Qwen-Image-2512"),
-    snapshotEdit: snapOf("Qwen/Qwen-Image-Edit-2511"),
+    snapshot: snapOf(IMAGE_SNAPSHOT_REPOS[0]),
+    snapshotEdit: snapOf(IMAGE_SNAPSHOT_REPOS[1]),
     pythonDir: pythonDriverDir()
   };
 }
@@ -98,11 +103,11 @@ function seed() {
   return [];
 }
 function loadRegistry() {
-  if (!fs5.existsSync(REGISTRY_PATH)) {
-    fs5.mkdirSync(REGISTRY_DIR, { recursive: true });
-    fs5.writeFileSync(REGISTRY_PATH, JSON.stringify(seed(), null, 2));
+  if (!fs7.existsSync(REGISTRY_PATH)) {
+    fs7.mkdirSync(REGISTRY_DIR, { recursive: true });
+    fs7.writeFileSync(REGISTRY_PATH, JSON.stringify(seed(), null, 2));
   }
-  return JSON.parse(fs5.readFileSync(REGISTRY_PATH, "utf-8"));
+  return JSON.parse(fs7.readFileSync(REGISTRY_PATH, "utf-8"));
 }
 function findLora(name) {
   return loadRegistry().find((l) => l.name === name);
@@ -110,10 +115,10 @@ function findLora(name) {
 function addLora(entry) {
   const list = loadRegistry().filter((l) => l.name !== entry.name);
   list.push(entry);
-  fs5.writeFileSync(REGISTRY_PATH, JSON.stringify(list, null, 2));
+  fs7.writeFileSync(REGISTRY_PATH, JSON.stringify(list, null, 2));
 }
 function runPython(python, script, payload, opts = {}) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     const child = spawn(python, [script, JSON.stringify(payload)], {
       env: { ...process.env, HF_HUB_OFFLINE: process.env.HF_HUB_OFFLINE ?? "1" }
     });
@@ -135,7 +140,7 @@ ${stderrTail}`));
       const lines = stdoutBuf.trim().split("\n").filter(Boolean);
       const lastLine = lines[lines.length - 1] ?? "";
       try {
-        resolve7(JSON.parse(lastLine));
+        resolve8(JSON.parse(lastLine));
       } catch {
         reject(new Error(`\u65E0\u6CD5\u89E3\u6790 python \u8F93\u51FA: ${lastLine}
 ${stderrTail}`));
@@ -161,13 +166,13 @@ function pidAlive(pid) {
 }
 function readStatus(m) {
   try {
-    return JSON.parse(fs5.readFileSync(statusPath(m), "utf-8"));
+    return JSON.parse(fs7.readFileSync(statusPath(m), "utf-8"));
   } catch {
     return null;
   }
 }
 function requestJob(mode, payload) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     const sock = net.connect({ path: sockPath(mode) });
     sock.setNoDelay(true);
     let buf = "";
@@ -183,7 +188,7 @@ function requestJob(mode, payload) {
       if (!sock.writableEnded && buf === "") {
         settled = true;
         sock.destroy();
-        resolve7(null);
+        resolve8(null);
       }
     });
     sock.on("connect", () => {
@@ -196,7 +201,7 @@ function requestJob(mode, payload) {
       if (e.code === "ENOENT" || e.code === "ECONNREFUSED") {
         settled = true;
         sock.destroy();
-        resolve7(null);
+        resolve8(null);
       } else fail2(new Error(`daemon \u8FDE\u63A5\u9519\u8BEF: ${e.message}`));
     });
     sock.on("data", (d) => {
@@ -220,7 +225,7 @@ function requestJob(mode, payload) {
         } else if (frame.t === "done") {
           settled = true;
           sock.end();
-          if (frame.ok) resolve7(frame.result);
+          if (frame.ok) resolve8(frame.result);
           else fail2(new Error(`daemon \u4EFB\u52A1\u5931\u8D25: ${frame.error}
 ${frame.tb ?? ""}`));
         }
@@ -237,7 +242,7 @@ async function spawnDaemon(mode, opts = {}) {
   const alive = await pingDaemon(mode);
   if (alive) return { pid: alive.pid };
   const rt = resolveRuntime();
-  fs5.mkdirSync(SERVE_DIR, { recursive: true });
+  fs7.mkdirSync(SERVE_DIR, { recursive: true });
   const idle = String(opts.idleTimeoutSec ?? DEFAULT_IDLE_TIMEOUT_SEC);
   const args = [
     path.join(rt.pythonDir, "serve.py"),
@@ -254,7 +259,7 @@ async function spawnDaemon(mode, opts = {}) {
     "--idle-timeout",
     idle
   ];
-  const logFd = fs5.openSync(logPath(mode), "a");
+  const logFd = fs7.openSync(logPath(mode), "a");
   const child = spawn(rt.pythonGen, args, {
     detached: true,
     stdio: ["ignore", logFd, logFd],
@@ -263,7 +268,7 @@ async function spawnDaemon(mode, opts = {}) {
   child.unref();
   const deadline = Date.now() + 2e4;
   while (Date.now() < deadline) {
-    if (fs5.existsSync(sockPath(mode))) return { pid: child.pid ?? -1 };
+    if (fs7.existsSync(sockPath(mode))) return { pid: child.pid ?? -1 };
     await setTimeout(200);
   }
   return null;
@@ -271,10 +276,10 @@ async function spawnDaemon(mode, opts = {}) {
 async function stopDaemon(mode) {
   const st = await pingDaemon(mode);
   if (!st) {
-    const had = fs5.existsSync(sockPath(mode)) || fs5.existsSync(statusPath(mode));
+    const had = fs7.existsSync(sockPath(mode)) || fs7.existsSync(statusPath(mode));
     for (const p of [sockPath(mode), statusPath(mode)]) {
       try {
-        fs5.rmSync(p);
+        fs7.rmSync(p);
       } catch {
       }
     }
@@ -294,7 +299,7 @@ async function stopDaemon(mode) {
     await setTimeout(500);
     for (const p of [sockPath(mode), statusPath(mode)]) {
       try {
-        fs5.rmSync(p);
+        fs7.rmSync(p);
       } catch {
       }
     }
@@ -312,6 +317,121 @@ async function waitGpuIdle() {
     await setTimeout(5e3);
   }
 }
+var ESRGAN_CACHE_PATH = path.join(os.homedir(), ".cache", "lmedia", "RealESRGAN_x2.pth");
+var LEGACY_TMP_PATH = "/tmp/RealESRGAN_x2.pth";
+function resolveEsrganPath() {
+  const env = process.env.LMEDIA_REALESRGAN_PATH;
+  if (env && fs7.existsSync(env)) return env;
+  if (fs7.existsSync(ESRGAN_CACHE_PATH)) return ESRGAN_CACHE_PATH;
+  if (fs7.existsSync(LEGACY_TMP_PATH)) return LEGACY_TMP_PATH;
+  return process.env.LMEDIA_REALESRGAN_PATH ?? ESRGAN_CACHE_PATH;
+}
+
+// src/lib/image-state.ts
+var IMAGE_STATE_ENV = "LMEDIA_IMAGE_STATE";
+var IMAGE_GATE_BYPASS_ENV = "LMEDIA_NO_IMAGE_GATE";
+function imageStatePath() {
+  const env = process.env[IMAGE_STATE_ENV];
+  if (env && env.trim()) return path.resolve(env.trim());
+  return path.join(os.homedir(), ".config", "limg", "image-state.json");
+}
+var ImageDisabledError = class extends Error {
+};
+function readImageGate() {
+  const file = imageStatePath();
+  if (!fs7.existsSync(file)) return { state: "enabled", file, present: false };
+  let parsed;
+  try {
+    parsed = JSON.parse(fs7.readFileSync(file, "utf-8"));
+  } catch (e) {
+    return { state: "corrupt", file, error: `\u4E0D\u662F\u5408\u6CD5 JSON\uFF08${e.message}\uFF09` };
+  }
+  const s = parsed;
+  if (!s || typeof s !== "object" || Array.isArray(s)) {
+    return { state: "corrupt", file, error: "\u6839\u4E0D\u662F\u5BF9\u8C61" };
+  }
+  if (typeof s.enabled !== "boolean") {
+    return { state: "corrupt", file, error: "\u7F3A\u5C11 enabled \u5E03\u5C14\u5B57\u6BB5" };
+  }
+  return s.enabled === false ? { state: "disabled", file, present: true, disabledAt: s.disabledAt ?? "", reason: s.reason } : { state: "enabled", file, present: true, reason: s.reason };
+}
+function writeImageState(enabled, opts = {}) {
+  const file = imageStatePath();
+  const state = enabled ? { enabled: true } : { enabled: false, disabledAt: (/* @__PURE__ */ new Date()).toISOString(), ...opts.reason ? { reason: opts.reason } : {} };
+  fs7.mkdirSync(path.dirname(file), { recursive: true });
+  const tmp = `${file}.${process.pid}.tmp`;
+  fs7.writeFileSync(tmp, `${JSON.stringify(state, null, 2)}
+`, "utf-8");
+  fs7.renameSync(tmp, file);
+  return file;
+}
+function gateAdvice(g) {
+  const head = g.state === "disabled" ? `\u56FE\u50CF\u80FD\u529B\u5DF2\u7981\u7528${g.disabledAt ? `\uFF08${g.disabledAt}\uFF09` : ""}${g.reason ? ` \u539F\u56E0: ${g.reason}` : ""}` : `\u56FE\u50CF\u80FD\u529B\u72B6\u6001\u6587\u4EF6\u635F\u574F\uFF0C\u62D2\u7EDD\u6267\u884C\u56FE\u50CF\u547D\u4EE4\uFF08\u4E0D\u731C\uFF09: ${g.file}
+  \u539F\u56E0: ${g.error}`;
+  return `${head}
+  \u6062\u590D: lmedia image enable${g.state === "corrupt" ? `\uFF08\u7528\u542F\u7528\u72B6\u6001\u8986\u76D6\u91CD\u5199\uFF09
+     \u6216 rm ${g.file}\uFF08\u5220\u9664\u540E\u56DE\u5230\u9ED8\u8BA4\u542F\u7528\uFF09` : ""}
+  \u67E5\u770B: lmedia image status
+  \u4E91\u7AEF\u66FF\u4EE3: honeydo image gen "<prompt>" --engine doubao
+  \uFF08\u4E34\u65F6\u7ED5\u8FC7: ${IMAGE_GATE_BYPASS_ENV}=1\uFF09`;
+}
+function assertImageEnabled(what) {
+  if (process.env[IMAGE_GATE_BYPASS_ENV] === "1") {
+    const g2 = readImageGate();
+    if (g2.state !== "enabled") {
+      console.error(`\u26A0\uFE0F ${IMAGE_GATE_BYPASS_ENV}=1\uFF1A\u5DF2\u7ED5\u8FC7\u56FE\u50CF\u80FD\u529B gate\uFF08\u5F53\u524D\u4E3A${g2.state === "disabled" ? "\u7981\u7528" : "\u635F\u574F"}\u6001\uFF09`);
+    }
+    return;
+  }
+  const g = readImageGate();
+  if (g.state === "enabled") return;
+  throw new ImageDisabledError(`${gateAdvice(g)}
+  \uFF08\u88AB\u62E6\u622A\u7684\u547D\u4EE4: ${what}\uFF09`);
+}
+var VENV_FIX = "\u56FE\u50CF venv \u672A\u5C31\u7EEA\uFF1A\u6309 packages/lmedia/USAGE.md\u300C\u56FE\u50CF\u300D\u5C0F\u8282\u91CD\u5EFA .venv / .venv-train";
+var snapDir = (repo) => path.join(imageHubDir(), `models--${repo.replace("/", "--")}`, "snapshots");
+function hasSnapshot(repo) {
+  try {
+    const d = snapDir(repo);
+    return fs7.existsSync(d) && fs7.readdirSync(d).length > 0;
+  } catch {
+    return false;
+  }
+}
+function snapshotFix(repo) {
+  return `HF_HUB_OFFLINE=0 hf download ${repo}\uFF08~54GB\uFF1B\u7F51\u7EDC\u5DEE\u53EF HF_ENDPOINT=https://hf-mirror.com\uFF09`;
+}
+function imagePreflight() {
+  const root = resolveRuntimeRoot();
+  return [
+    {
+      name: "runtime root",
+      ok: fs7.existsSync(root),
+      fix: `\u8BBE LMEDIA_RUNTIME=${root} \u6307\u5411\u672C\u5730\u751F\u6210\u6808\uFF0C\u6216 ln -s <\u6808\u76EE\u5F55> ~/.lmedia/runtime`
+    },
+    {
+      name: "pythonGen (.venv-train)",
+      ok: fs7.existsSync(path.join(root, ".venv-train", "bin", "python")),
+      fix: VENV_FIX
+    },
+    {
+      name: "pythonFast (.venv)",
+      ok: fs7.existsSync(path.join(root, ".venv", "bin", "python")),
+      fix: VENV_FIX
+    },
+    // 标签取 repo 短名（Qwen-Image-2512），与 doctor 既有输出逐字一致，不破坏外部匹配
+    ...IMAGE_SNAPSHOT_REPOS.map((repo) => ({
+      name: `[image] ${repo.split("/")[1]} \u5FEB\u7167`,
+      ok: hasSnapshot(repo),
+      fix: snapshotFix(repo)
+    })),
+    {
+      name: "[image] Real-ESRGAN \u6743\u91CD",
+      ok: fs7.existsSync(resolveEsrganPath()),
+      fix: "\u7F3A RealESRGAN_x2.pth\uFF08~64MB\uFF09\uFF1A\u89C1 USAGE.md\u300C\u56FE\u50CF\u300D\u5C0F\u8282\uFF0C\u6216 LMEDIA_REALESRGAN_PATH \u6307\u5B9A"
+    }
+  ];
+}
 function parseMode(v) {
   if (v !== "gen" && v !== "edit") {
     console.error("--mode \u5FC5\u987B\u662F gen \u6216 edit");
@@ -415,13 +535,119 @@ function registerServe(image) {
   registerStatus(serve);
 }
 
+// src/commands/image-capability.ts
+var MODES = ["gen", "edit"];
+var isBusy = (st) => st.busy || st.queue > 0;
+function registerDisable(image) {
+  image.command("disable").description("\u7981\u7528\u56FE\u50CF\u80FD\u529B\uFF1Agen/edit/upscale/serve start \u5168\u90E8\u62E6\u4E0B\uFF08enable/status/serve stop \u59CB\u7EC8\u53EF\u7528\uFF09").option("--reason <text>", "\u8BB0\u5F55\u7981\u7528\u539F\u56E0\uFF08\u5199\u8FDB\u72B6\u6001\u6587\u4EF6\uFF09").action(async (opts) => {
+    const g = readImageGate();
+    if (g.state === "disabled") {
+      console.log(`\xB7 \u5DF2\u662F\u7981\u7528\u6001\uFF08\u672A\u6539\u5199\u72B6\u6001\u6587\u4EF6\uFF09`);
+    }
+    let stopped = false;
+    for (const m of MODES) {
+      const st = await pingDaemon(m);
+      if (!st) {
+        console.log(`\xB7 ${m} daemon \u672A\u8FD0\u884C`);
+        continue;
+      }
+      if (isBusy(st)) {
+        console.error(
+          `\u2717 ${m} daemon \u6B63\u5FD9\uFF08pid ${st.pid}\uFF0Cjobs ${st.jobs}\uFF09\u2014\u2014\u672A\u5199\u72B6\u6001\u3002
+  \u7B49\u4EFB\u52A1\u7ED3\u675F\uFF0C\u6216 lmedia image serve stop --mode ${m} \u4E2D\u65AD\u5F53\u524D\u4EFB\u52A1\u540E\u91CD\u8BD5\u3002`
+        );
+        process.exit(1);
+      }
+      const r = await stopDaemon(m);
+      console.log(`\u2713 \u5DF2\u505C\u6B62 ${m} daemon\uFF08pid ${st.pid}${r === "killed" ? "\uFF0CSIGKILL" : ""}\uFF09\u2014\u2014\u91CA\u653E\u5E38\u9A7B\u5185\u5B58\u4E0E\u6587\u4EF6\u53E5\u67C4`);
+      stopped = true;
+    }
+    if (g.state === "corrupt") {
+      console.error(`\u26A0\uFE0F \u72B6\u6001\u6587\u4EF6\u635F\u574F\uFF0C\u5DF2\u7528\u65B0\u72B6\u6001\u8986\u76D6: ${g.file}\uFF08${g.error}\uFF09`);
+    }
+    if (g.state !== "disabled") {
+      const file = writeImageState(false, { reason: opts.reason });
+      console.log(`\u2713 \u56FE\u50CF\u80FD\u529B\u5DF2\u7981\u7528\uFF08${file}\uFF09`);
+    }
+    console.log(
+      `  \u6062\u590D: lmedia image enable
+  \u4E91\u7AEF\u66FF\u4EE3: honeydo image gen "<prompt>" --engine doubao
+` + (stopped ? "" : `  \u63D0\u793A: \u5220\u9664\u6743\u91CD\u524D\u8BF7\u786E\u8BA4 lmedia image serve status \u65E0 daemon \u5728\u8DD1\uFF08\u6301\u6709\u6587\u4EF6\u53E5\u67C4\u65F6 rm \u4E0D\u91CA\u653E\u7A7A\u95F4\uFF09
+`) + `  \u968F\u540E\u53EF\u624B\u5DE5\u6E05\u7406\uFF08\u5F53\u524D\u5728\u4F4D\u60C5\u51B5\u89C1 lmedia image status\uFF09`
+    );
+  });
+}
+function registerEnable(image) {
+  image.command("enable").description("\u542F\u7528\u56FE\u50CF\u80FD\u529B\uFF08\u672C\u5730\u6743\u91CD/venv \u82E5\u5DF2\u6E05\u7406\u4F1A\u5217\u51FA\u7F3A\u5931\u9879\u4E0E\u91CD\u65B0\u4E0B\u8F7D\u6307\u5F15\uFF09").action(() => {
+    const g = readImageGate();
+    if (g.state === "corrupt") {
+      console.error(`\u26A0\uFE0F \u72B6\u6001\u6587\u4EF6\u635F\u574F\uFF0C\u5DF2\u7528\u65B0\u72B6\u6001\u8986\u76D6: ${g.file}\uFF08${g.error}\uFF09`);
+    }
+    const file = writeImageState(true);
+    console.log(`\u2713 \u56FE\u50CF\u80FD\u529B\u5DF2\u542F\u7528\uFF08${file}\uFF09`);
+    const missing = imagePreflight().filter((i) => !i.ok);
+    if (!missing.length) {
+      console.log(`  \u672C\u5730\u56FE\u50CF\u8D44\u4EA7\u9F50\u5907\uFF0C\u53EF\u76F4\u63A5\u4F7F\u7528\u3002`);
+      return;
+    }
+    console.error(`\u26A0\uFE0F \u4F46\u56FE\u50CF\u6808\u4ECD\u7F3A ${missing.length} \u9879\uFF0C\u6682\u4E0D\u53EF\u7528\uFF1A`);
+    for (const m of missing) console.error(`  \u2717 ${m.name} \u2192 ${m.fix}`);
+    console.error(`  \u78C1\u76D8\u9700\u9884\u7559\u7EA6 108GB\uFF08\u4E24\u4E2A\u5FEB\u7167\uFF09\uFF1B\u5C31\u7EEA\u540E lmedia doctor \u590D\u6838`);
+    process.exit(1);
+  });
+}
+function registerStatus2(image) {
+  image.command("status").description("\u67E5\u770B\u56FE\u50CF\u80FD\u529B\u5F00\u5173\u72B6\u6001\u4E0E\u672C\u5730\u4F4D\u5728\u4F4D\u60C5\u51B5\uFF080=\u53EF\u8DD1\u56FE\u50CF\u547D\u4EE4\uFF1B\u4E0E image serve status \u770B\u7684\u662F\u4E0D\u540C\u4E1C\u897F\uFF09").action(async () => {
+    const g = readImageGate();
+    const label = g.state === "disabled" ? "\u5DF2\u7981\u7528" : g.state === "corrupt" ? "\u72B6\u6001\u6587\u4EF6\u635F\u574F" : "\u5DF2\u542F\u7528";
+    const when = g.state === "disabled" && g.disabledAt ? `\uFF08${g.disabledAt}\uFF09` : "";
+    const why = g.state !== "corrupt" && g.reason ? ` \xB7 ${g.reason}` : "";
+    console.log(`\u56FE\u50CF\u80FD\u529B: ${label}${when}${why}`);
+    console.log(`  \u72B6\u6001\u6587\u4EF6: ${g.file}${g.state === "enabled" && !g.present ? "\uFF08\u4E0D\u5B58\u5728=\u9ED8\u8BA4\u542F\u7528\uFF09" : ""}`);
+    if (g.state !== "enabled") console.log(gateAdvice(g).split("\n").map((l) => `  ${l}`).join("\n"));
+    const items = imagePreflight();
+    for (const i of items) {
+      console.log(`  ${i.ok ? "\u2713" : "\u2717"} ${i.name}${i.ok ? "" : ` \u2192 ${i.fix}`}`);
+    }
+    for (const m of MODES) {
+      const st = await pingDaemon(m);
+      console.log(
+        `  ${st ? g.state === "disabled" ? "\u2717" : "\u2713" : "\xB7"} daemon ${m}` + (st ? `: ${st.state}\uFF08pid ${st.pid}\uFF0Cjobs ${st.jobs}\uFF09${g.state === "disabled" ? "\u2014\u2014\u80FD\u529B\u5DF2\u7981\u7528\u5374\u4ECD\u5728\u8DD1\uFF0C\u8BF7 lmedia image serve stop" : ""}` : ": \u672A\u8FD0\u884C")
+      );
+    }
+    const usable = g.state === "enabled" && items.every((i) => i.ok);
+    process.exit(usable ? 0 : 1);
+  });
+}
+function registerImageCapability(image) {
+  registerDisable(image);
+  registerEnable(image);
+  registerStatus2(image);
+}
+
 // src/commands/image.ts
+var IMAGE_GATED = /* @__PURE__ */ new Set(["image gen", "image edit", "image upscale", "image serve start"]);
+function commandPath(cmd) {
+  const parts = [];
+  for (let c = cmd; c && c.parent; c = c.parent) parts.unshift(c.name());
+  return parts.join(" ");
+}
+function gateImage(what) {
+  try {
+    assertImageEnabled(what);
+  } catch (e) {
+    if (!(e instanceof ImageDisabledError)) throw e;
+    console.error(`\u2717 ${e.message}`);
+    process.exit(1);
+  }
+}
 var DEFAULT_NEG = "\u4F4E\u5206\u8FA8\u7387\uFF0C\u4F4E\u753B\u8D28\uFF0C\u80A2\u4F53\u7578\u5F62\uFF0C\u624B\u6307\u7578\u5F62\uFF0C\u753B\u9762\u8FC7\u9971\u548C\uFF0C\u8721\u50CF\u611F\uFF0C\u4EBA\u8138\u65E0\u7EC6\u8282\uFF0C\u8FC7\u5EA6\u5149\u6ED1\uFF0C\u753B\u9762\u5177\u6709AI\u611F\u3002\u6784\u56FE\u6DF7\u4E71\u3002\u6587\u5B57\u6A21\u7CCA\uFF0C\u626D\u66F2\u3002";
 function parseCache(v) {
   if (v === void 0) return void 0;
   return { thresh: v === true ? 0.3 : parseFloat(String(v)) };
 }
 async function runImageJob(rt, args) {
+  gateImage(`image ${args.kind}`);
   if (!args.noDaemon && process.env.LMEDIA_NO_DAEMON !== "1") {
     for (const mode of args.daemonModes) {
       const r = await requestJob(mode, { kind: args.kind, ...args.payload });
@@ -474,7 +700,7 @@ function registerGen(image) {
     const trueCfg = opts.cfg !== void 0 ? parseFloat(opts.cfg) : fast ? 1 : 4;
     if (fast && !names.includes("lightning2512")) {
       const lt = findLora("lightning2512");
-      if (!lt || !fs5.existsSync(lt.path)) {
+      if (!lt || !fs7.existsSync(lt.path)) {
         console.error("--fast \u9700\u8981 lightning2512 LoRA\uFF08\u4E0B\u8F7D\u540E: lmedia lora add lightning2512 <path> --kind speed\uFF09");
         process.exit(2);
       }
@@ -521,7 +747,7 @@ function registerEdit(image) {
     if (fast) {
       const wantX4 = fastSteps <= 4;
       const lt = (wantX4 ? findLora("lightningedit2511x4") : void 0) ?? findLora("lightningedit2511");
-      if (!lt || !fs5.existsSync(lt.path)) {
+      if (!lt || !fs7.existsSync(lt.path)) {
         console.error("--fast \u9700\u8981 lightningedit2511 LoRA\uFF08\u4E0B\u8F7D\u540E: lmedia lora add lightningedit2511 <path> --kind speed\uFF09");
         process.exit(2);
       }
@@ -571,11 +797,16 @@ function registerUpscale(image) {
   });
 }
 function registerImage(program2) {
-  const image = program2.command("image").description("\u56FE\u50CF\u751F\u4EA7\u80FD\u529B\uFF08\u6587\u751F\u56FE/\u53C2\u8003\u56FE\u7F16\u8F91/\u8D85\u5206/\u5E38\u9A7B daemon\uFF09");
+  const image = program2.command("image").description("\u56FE\u50CF\u751F\u4EA7\u80FD\u529B\uFF08\u6587\u751F\u56FE/\u53C2\u8003\u56FE\u7F16\u8F91/\u8D85\u5206/\u5E38\u9A7B daemon\uFF1B\u5F00\u5173\u89C1 image disable|enable|status\uFF09");
+  image.hook("preAction", (_thisCommand, actionCommand) => {
+    const p = commandPath(actionCommand);
+    if (IMAGE_GATED.has(p)) gateImage(p);
+  });
   registerGen(image);
   registerEdit(image);
   registerUpscale(image);
   registerServe(image);
+  registerImageCapability(image);
 }
 function hasCommand(cmd) {
   return spawnSync("which", [cmd], { stdio: "ignore" }).status === 0;
@@ -590,11 +821,43 @@ var RES_PRESETS = [
   "704p",
   "720p",
   "768p",
+  "1080p",
   "square",
   "portrait",
   "vertical"
   // 竖版/方版（绘本竖页用 portrait）
 ];
+var TURBO_BUNDLE = "dit-turbo";
+var TURBO_LORA_FILE = "lightx2v_fl2v_turbo_8step_v1.0_768p_bf16.safetensors";
+var TURBO_LORA_URL = `https://hf-mirror.com/lightx2v/Minimax-h3-Turbo/resolve/main/${TURBO_LORA_FILE}`;
+var FAST_STEPS = 8;
+var FAST_SHIFT_VIDEO = 6;
+var PERSON_RE = new RegExp(
+  "\u4EBA\u50CF|\u4EBA\u7269|\u5973\u5B69|\u7537\u5B69|\u5973\u4EBA|\u7537\u4EBA|\u5973\u751F|\u7537\u751F|\u7238\u7238|\u5988\u5988|\u5B9D\u5B9D|\u5B69\u5B50|\u5C0F\u5B69|\u513F\u5B50|\u5973\u513F|\u59D0\u59D0|\u5F1F\u5F1F|\u59B9\u59B9|\u54E5\u54E5|\u7237\u7237|\u5976\u5976|\u53D4\u53D4|\u963F\u59E8|\u5BB6\u5EAD|portrait|person|child|baby|girl|boy|woman|man|people|face",
+  "i"
+);
+var LOWRES_PRESETS = /* @__PURE__ */ new Set(["256p", "352p", "480p", "576p"]);
+function qualityHints(prompt, o) {
+  const hints = [];
+  if (!PERSON_RE.test(prompt)) return hints;
+  if (o.fast) {
+    console.error("\u63D0\u793A: \u4EBA\u7269\u89C6\u9891\u7528 --fast\uFF08\u84B8\u998F\u6863\uFF09\u4F1A\u51FA\u73B0\u7EB9\u7406\u6CB9\u753B\u611F\u4E0E\u8EAB\u4EFD\u6F02\u79FB\u2014\u2014\u8D28\u91CF\u4F18\u5148\u8BF7\u53BB\u6389 --fast \u7528\u57FA\u5EA7 12 \u6B65\uFF0C\u5E76\u628A\u6784\u56FE\u88C1\u5230\u4EBA\u7269\u7279\u5199\uFF08\u4EBA\u8138\u5360\u753B\u9762 1/4 \u4EE5\u4E0A\uFF09\u3002\u914D\u65B9: lmedia video recipes");
+    hints.push("person+fast: \u84B8\u998F\u6863\u7EB9\u7406\u8F6F\u5316\u4E14\u65F6\u57DF\u6F02\u79FB\u5927\uFF1B\u4EBA\u7269\u8D28\u91CF\u4F18\u5148\u7528\u57FA\u5EA7 12 \u6B65 + \u4E3B\u4F53\u7279\u5199\u6784\u56FE\uFF08lmedia video recipes\uFF09");
+  }
+  if (LOWRES_PRESETS.has(o.res)) {
+    console.error(`\u63D0\u793A: \u4EBA\u7269\u89C6\u9891\u5206\u8FA8\u7387\u4E0D\u8DB3\uFF08${o.res} \u77ED\u8FB9 < 704\uFF0C\u4EBA\u8138\u50CF\u7D20\u592A\u5C11\u5FC5\u7CCA\uFF09\u2014\u2014\u5EFA\u8BAE -r 720p/square/portrait \u5E76\u8BA9\u4EBA\u7269\u5360\u753B\u9762\u4E3B\u4F53\u3002\u914D\u65B9: lmedia video recipes`);
+    hints.push(`person+${o.res}: \u4EBA\u8138\u50CF\u7D20\u4E0D\u8DB3\uFF1B\u7528 720p/square/portrait + \u4E3B\u4F53\u7279\u5199\u6784\u56FE`);
+  }
+  if (o.firstFrame && !o.lastFrame) {
+    console.error("\u63D0\u793A: \u56FE\u751F\u89C6\u9891\u4EC5\u951A\u5B9A\u9996\u5E27\uFF0C\u4EBA\u7269\u52A8\u4F5C\u5927\u65F6\u7ED3\u5C3E\u8EAB\u4EFD\u4F1A\u6F02\u79FB\uFF08\u5B9E\u6D4B\u7ED3\u5C3E\u4EBA\u8138\u76F8\u4F3C\u5EA6\u53EF\u8DCC\u5230 0.3\uFF09\u2014\u2014\u540C\u4E00\u5F20\u56FE\u518D\u52A0 --last-frame \u53CC\u951A\u5B9A\u53EF\u56DE\u73AF\u6291\u5236\uFF08\u5B9E\u6D4B\u62C9\u56DE 0.97\uFF09\u3002\u914D\u65B9: lmedia video recipes");
+    hints.push("first-frame only: \u7ED3\u5C3E\u8EAB\u4EFD\u4F1A\u6F02\u79FB\uFF1B\u540C\u56FE --last-frame \u53CC\u951A\u5B9A\u53EF\u5C06\u7ED3\u5C3E\u4EBA\u8138\u76F8\u4F3C\u5EA6 0.3\u21920.97");
+  }
+  if (o.seconds > 5) {
+    console.error("\u63D0\u793A: \u4EBA\u7269\u89C6\u9891\u6F02\u79FB\u968F\u65F6\u957F\u7D2F\u79EF\uFF0C\u5EFA\u8BAE \u22645s\uFF08\u8981\u957F\u955C\u5934\u8BF7\u5206\u591A\u6BB5 + --last-frame \u8854\u63A5\uFF09\u3002");
+    hints.push("person+long: \u6F02\u79FB\u968F\u65F6\u957F\u7D2F\u79EF\uFF0C\u5EFA\u8BAE \u22645s \u6216\u5206\u6BB5");
+  }
+  return hints;
+}
 function runStep(cmd, args) {
   const r = spawnSync(cmd, args, { stdio: "inherit" });
   if (r.status !== 0) {
@@ -604,16 +867,16 @@ function runStep(cmd, args) {
 }
 function patchGgufFilename(venvVideo) {
   const libDir = path.join(venvVideo, "lib");
-  if (!fs5.existsSync(libDir)) return;
-  const pyDir = fs5.readdirSync(libDir).find((d) => d.startsWith("python"));
+  if (!fs7.existsSync(libDir)) return;
+  const pyDir = fs7.readdirSync(libDir).find((d) => d.startsWith("python"));
   if (!pyDir) return;
   const w = path.join(libDir, pyDir, "site-packages", "mmh3turbo", "weights.py");
-  if (!fs5.existsSync(w)) return;
-  const src = fs5.readFileSync(w, "utf8");
+  if (!fs7.existsSync(w)) return;
+  const src = fs7.readFileSync(w, "utf8");
   const OLD = "MiniMax-H3-Qwen3VL-32B-TextEncoder-Q2_K.gguf";
   const NEW = "qwen3vl-32B-MiniMax-H3-Q2_K.gguf";
   if (src.includes(OLD)) {
-    fs5.writeFileSync(w, src.replaceAll(OLD, NEW));
+    fs7.writeFileSync(w, src.replaceAll(OLD, NEW));
     console.error(`\u5DF2\u4FEE\u8865 mmh3turbo \u4E0A\u6E38 GGUF \u6587\u4EF6\u540D\u6F02\u79FB\uFF08${OLD} \u2192 ${NEW}\uFF09`);
   }
 }
@@ -636,8 +899,8 @@ function mirrorProvision() {
   for (const f of MIRROR_FILES) {
     const dest = f.dest.replace(/^~/, os.homedir());
     const url = f.repo === "Comfy-Org/MiniMax-H3" ? `${MIRROR}/${f.repo}/resolve/main/vae/${path.basename(dest)}` : `${MIRROR}/${f.repo}/resolve/main/${path.basename(dest)}`;
-    fs5.mkdirSync(path.dirname(dest), { recursive: true });
-    if (fs5.existsSync(dest) && fs5.statSync(dest).size === f.bytes) {
+    fs7.mkdirSync(path.dirname(dest), { recursive: true });
+    if (fs7.existsSync(dest) && fs7.statSync(dest).size === f.bytes) {
       console.error(`\u5DF2\u5C31\u4F4D: ${dest}`);
       continue;
     }
@@ -657,8 +920,8 @@ function mirrorProvision() {
       console.error(`\u4E0B\u8F7D\u4E2D\u65AD\uFF0C5 \u79D2\u540E\u7EED\u4F20\uFF08\u7B2C ${attempt} \u8F6E\uFF09\u2026`);
       Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 5e3);
     }
-    fs5.renameSync(`${dest}.part`, dest);
-    const got = fs5.statSync(dest).size;
+    fs7.renameSync(`${dest}.part`, dest);
+    const got = fs7.statSync(dest).size;
     if (expect && got !== expect) {
       console.error(`\u5927\u5C0F\u6821\u9A8C\u5931\u8D25: ${dest} got=${got} expect=${expect}`);
       process.exit(1);
@@ -669,11 +932,11 @@ function mirrorProvision() {
 function registerSetup(video) {
   video.command("setup").description("\u521B\u5EFA .venv-video \u5E76\u5B89\u88C5 mmh3turbo\uFF08MiniMax-H3 MLX \u5F15\u64CE\uFF0CApple Silicon\uFF09").option("--mirror", "\u7528 hf-mirror.com + curl \u9884\u7F6E H3 \u6743\u91CD\uFF08~50GB\uFF0C\u56FD\u5185\u63A8\u8350\uFF1Bhuggingface_hub \u5BA2\u6237\u7AEF\u4E0E\u955C\u50CF\u91CD\u5B9A\u5411\u4E0D\u517C\u5BB9\u65F6\u7684\u6B63\u89E3\uFF09").action((opts) => {
     const rt = resolveVideoRuntime();
-    fs5.mkdirSync(rt.root, { recursive: true });
+    fs7.mkdirSync(rt.root, { recursive: true });
     if (!hasCommand("ffmpeg")) {
       console.error("\u26A0\uFE0F  \u672A\u627E\u5230 ffmpeg\uFF08mp4 \u5C01\u88C5\u5FC5\u9700\uFF09\uFF1Abrew install ffmpeg");
     }
-    if (!fs5.existsSync(rt.pythonVideo)) {
+    if (!fs7.existsSync(rt.pythonVideo)) {
       console.error(`\u521B\u5EFA venv: ${rt.venvVideo}`);
       if (hasCommand("uv")) runStep("uv", ["venv", "--python", "3.12", rt.venvVideo]);
       else runStep("python3", ["-m", "venv", rt.venvVideo]);
@@ -694,10 +957,21 @@ function registerSetup(video) {
   });
 }
 function registerGen2(video) {
-  video.command("gen <prompt>").description("\u6587\u751F\u89C6\u9891/\u9996\u5E27\u56FE\u751F\u89C6\u9891\uFF1AMiniMax-H3 \u672C\u5730\uFF08\u9ED8\u8BA4 480p / 5s / 12 \u6B65\uFF0Cmp4 \u542B\u7ACB\u4F53\u58F0\u97F3\u8F68\uFF09").option("-o, --out <path>", "\u8F93\u51FA mp4 \u8DEF\u5F84", `lmedia-video-${Date.now()}.mp4`).option("-r, --res <preset>", `\u5206\u8FA8\u7387\u6863\uFF1A${RES_PRESETS.join("|")}\uFF08lmedia video list-res \u770B\u5B9E\u9645\u753B\u5E03\uFF09`, "480p").option("--seconds <s>", "\u7247\u6BB5\u65F6\u957F\u79D2\uFF081-15\uFF09", "5").option("--steps <n>", "\u53BB\u566A\u6B65\u6570\uFF0812 \u6B65\u4E0E 20 \u6B65\u89C6\u89C9\u4E0D\u53EF\u533A\u5206\uFF0C4/8 \u6B65\u660E\u663E\u6389\u8D28\uFF09", "12").option("--seed <n>", "\u968F\u673A\u79CD\u5B50", "42").option("--first-frame <path>", "\u9996\u5E27\u56FE\uFF08\u56FE\u751F\u89C6\u9891\uFF1B\u63A8\u8350\u8854\u63A5 lmedia image gen \u4EA7\u7269\uFF09").action(async (prompt, opts) => {
+  video.command("gen <prompt>").description("\u6587\u751F\u89C6\u9891/\u9996\u5E27\u56FE\u751F\u89C6\u9891\uFF1AMiniMax-H3 \u672C\u5730\uFF08\u9ED8\u8BA4 480p / 5s / 12 \u6B65\uFF0Cmp4 \u542B\u7ACB\u4F53\u58F0\u97F3\u8F68\uFF1B\u751F\u4EA7\u914D\u65B9\u89C1 lmedia video recipes\uFF09").option("-o, --out <path>", "\u8F93\u51FA mp4 \u8DEF\u5F84", `lmedia-video-${Date.now()}.mp4`).option("-r, --res <preset>", `\u5206\u8FA8\u7387\u6863\uFF1A${RES_PRESETS.join("|")}\uFF08lmedia video list-res \u770B\u5B9E\u9645\u753B\u5E03\uFF09`, "480p").option("--seconds <s>", "\u7247\u6BB5\u65F6\u957F\u79D2\uFF081-15\uFF09", "5").option("--steps <n>", `\u53BB\u566A\u6B65\u6570\uFF08\u57FA\u5EA7 12 \u6B65\u224820 \u6B65\uFF1B--fast \u9ED8\u8BA4\u53D6 bundle meta \u7684\u63A8\u8350\u6B65\u6570\uFF0C\u7F3A\u5931\u6309 ${FAST_STEPS}\uFF0C4-8 \u4E3A\u84B8\u998F\u6709\u6548\u533A\u95F4\uFF09`).option("--seed <n>", "\u968F\u673A\u79CD\u5B50", "42").option("--first-frame <path>", "\u9996\u5E27\u56FE\uFF08\u56FE\u751F\u89C6\u9891\uFF1B\u63A8\u8350\u8854\u63A5 lmedia image gen \u4EA7\u7269\uFF09").option("--last-frame <path>", "\u5C3E\u5E27\u56FE\uFF08\u9996\u5C3E\u951A\u5B9A\u63D2\u503C\uFF09").option("--fast", `Lightning \u84B8\u998F\u52A0\u901F\u6863\uFF08dit-turbo bundle + ${FAST_STEPS} \u6B65 + shift ${FAST_SHIFT_VIDEO}\uFF1B\u9996\u6B21\u5148 lmedia video turbo-merge\uFF09\u3002\u98CE\u666F/\u9759\u7269/\u7ED8\u672C\u7528\uFF1B\u4EBA\u7269\u89C6\u9891\u614E\u7528\uFF08\u6CB9\u753B\u611F+\u6F02\u79FB\uFF0C\u89C1 lmedia video recipes\uFF09`, false).action(async (prompt, opts) => {
+    const rt = resolveVideoRuntime();
+    const turboPrefix = path.join(rt.weightsDir, TURBO_BUNDLE);
+    const turboMeta = (() => {
+      if (!opts.fast) return void 0;
+      try {
+        return JSON.parse(fs7.readFileSync(`${turboPrefix}.idx`, "utf8"))["__meta__"];
+      } catch {
+        return void 0;
+      }
+    })();
     const res = opts.res;
     const seconds = parseFloat(opts.seconds);
-    const steps = parseInt(opts.steps, 10);
+    const fast = !!opts.fast;
+    const steps = opts.steps ? parseInt(opts.steps, 10) : fast ? Number(turboMeta?.turbo_nfe) || FAST_STEPS : 12;
     const seed2 = parseInt(opts.seed, 10);
     if (!RES_PRESETS.includes(res)) {
       console.error(`--res \u4EC5\u652F\u6301 ${RES_PRESETS.join("|")}\uFF08\u5F53\u524D ${res}\uFF09`);
@@ -711,16 +985,35 @@ function registerGen2(video) {
       console.error(`--steps \u9700\u4E3A 1-50 \u7684\u6574\u6570\uFF08\u5F53\u524D ${opts.steps}\uFF09`);
       process.exit(2);
     }
+    if (fast && steps > 8) {
+      console.error(`\u63D0\u793A: --fast \u84B8\u998F\u6863\u6B65\u6570 >8 \u65E0\u6536\u76CA\u4E14\u53EF\u80FD\u8FC7\u9510\u5316\uFF08\u84B8\u998F\u914D\u65B9\u63A8\u8350 ${FAST_STEPS}\uFF0C4-8 \u6709\u6548\uFF09`);
+    }
     if (!Number.isInteger(seed2)) {
       console.error(`--seed \u9700\u4E3A\u6574\u6570\uFF08\u5F53\u524D ${opts.seed}\uFF09`);
       process.exit(2);
     }
-    if (opts.firstFrame && !fs5.existsSync(opts.firstFrame)) {
-      console.error(`\u9996\u5E27\u56FE\u4E0D\u5B58\u5728: ${opts.firstFrame}`);
-      process.exit(2);
+    for (const [label, p] of [["\u9996\u5E27\u56FE", opts.firstFrame], ["\u5C3E\u5E27\u56FE", opts.lastFrame]]) {
+      if (p && !fs7.existsSync(p)) {
+        console.error(`${label}\u4E0D\u5B58\u5728: ${p}`);
+        process.exit(2);
+      }
     }
-    const rt = resolveVideoRuntime();
-    if (!fs5.existsSync(rt.mmh3turbo)) {
+    const hints = qualityHints(prompt, {
+      fast,
+      seconds,
+      res,
+      firstFrame: opts.firstFrame,
+      lastFrame: opts.lastFrame
+    });
+    const turboReady = fs7.existsSync(`${turboPrefix}.bin`);
+    if (fast && !opts.steps && turboReady && !turboMeta?.turbo_nfe) {
+      console.error(`\u63D0\u793A: \u52A0\u901F\u6863 bundle \u672A\u8BB0\u5F55\u63A8\u8350\u6B65\u6570\uFF08turbo_nfe\uFF09\uFF0C\u672C\u6B21\u6309\u515C\u5E95 ${FAST_STEPS} \u6B65\u8DD1\u2014\u2014\u82E5\u5408\u5E76\u7684\u662F 4 \u6B65\u7248 LoRA\uFF0C\u8BF7\u663E\u5F0F --steps 4\uFF08\u6216 turbo-merge --nfe 4 \u91CD\u5199 meta\uFF09`);
+      hints.push(`turbo bundle \u7F3A turbo_nfe\uFF0C\u6B65\u6570\u6309\u515C\u5E95 ${FAST_STEPS}\uFF1B4 \u6B65\u7248 LoRA \u9700\u663E\u5F0F --steps 4`);
+    }
+    if (/[一-鿿]/.test(prompt) && prompt.length < 20) {
+      console.error(`\u63D0\u793A: \u4E2D\u6587 prompt \u5EFA\u8BAE 30-50 \u5B57\uFF08\u5F53\u524D ${prompt.length} \u5B57\uFF09\uFF0C\u592A\u77ED\u6613\u88AB seed \u4E3B\u5BFC\uFF08\u6362 prompt \u753B\u9762\u4E0D\u53D8\uFF09`);
+    }
+    if (!fs7.existsSync(rt.mmh3turbo)) {
       console.error(`mmh3turbo \u672A\u5B89\u88C5\uFF08${rt.venvVideo}\uFF09\u3002\u5148\u8FD0\u884C: lmedia video setup`);
       process.exit(1);
     }
@@ -728,11 +1021,12 @@ function registerGen2(video) {
       console.error("\u672A\u627E\u5230 ffmpeg\uFF08mp4 \u5C01\u88C5\u5FC5\u9700\uFF09\uFF1Abrew install ffmpeg \u540E\u91CD\u8BD5");
       process.exit(1);
     }
-    if (/[一-鿿]/.test(prompt) && prompt.length < 20) {
-      console.error(`\u63D0\u793A: \u4E2D\u6587 prompt \u5EFA\u8BAE 30-50 \u5B57\uFF08\u5F53\u524D ${prompt.length} \u5B57\uFF09\uFF0C\u592A\u77ED\u6613\u88AB seed \u4E3B\u5BFC\uFF08\u6362 prompt \u753B\u9762\u4E0D\u53D8\uFF09`);
+    if (fast && !fs7.existsSync(`${turboPrefix}.bin`)) {
+      console.error(`\u52A0\u901F\u6863 bundle \u672A\u5C31\u7EEA\uFF08${turboPrefix}.bin\uFF09\u3002\u5148\u8FD0\u884C: lmedia video turbo-merge`);
+      process.exit(1);
     }
     const runDir = path.join(os.homedir(), ".lmedia", "video-runs", `${Date.now()}`);
-    fs5.mkdirSync(runDir, { recursive: true });
+    fs7.mkdirSync(runDir, { recursive: true });
     const args = [
       prompt,
       "-r",
@@ -747,40 +1041,54 @@ function registerGen2(video) {
       runDir
     ];
     if (opts.firstFrame) args.push("--first-frame", path.resolve(opts.firstFrame));
-    console.error(`mmh3turbo \xB7 ${res} \xB7 ${seconds}s \xB7 ${steps} \u6B65 \xB7 seed ${seed2} \u2192 ${runDir}`);
+    if (opts.lastFrame) args.push("--last-frame", path.resolve(opts.lastFrame));
+    let engineCmd = rt.mmh3turbo;
+    let engineArgs = args;
+    if (fast) {
+      engineCmd = rt.pythonVideo;
+      engineArgs = [
+        path.join(rt.pythonDir, "video_gen.py"),
+        "--shift-video",
+        String(FAST_SHIFT_VIDEO),
+        "--weights",
+        turboPrefix,
+        ...args
+      ];
+    }
+    console.error(`mmh3turbo${fast ? "(turbo)" : ""} \xB7 ${res} \xB7 ${seconds}s \xB7 ${steps} \u6B65${fast ? ` \xB7 shift ${FAST_SHIFT_VIDEO}` : ""} \xB7 seed ${seed2} \u2192 ${runDir}`);
     const t0 = Date.now();
     const env = { ...process.env };
-    const weightsReady = fs5.existsSync(path.join(rt.weightsDir, "dit.bin"));
+    const weightsReady = fs7.existsSync(path.join(rt.weightsDir, "dit.bin")) || fast && fs7.existsSync(`${turboPrefix}.bin`);
     if (!weightsReady && env.HF_HUB_OFFLINE === "1") {
       console.error("\u63D0\u793A: \u68C0\u6D4B\u5230 HF_HUB_OFFLINE=1 \u4E14 H3 \u6743\u91CD\u672A\u5C31\u7EEA\uFF0C\u672C\u6B21\u4E34\u65F6\u5173\u95ED\u4EE5\u62C9\u53D6\u6743\u91CD\uFF08\u56FD\u5185\u63A8\u8350 lmedia video setup --mirror\uFF09");
       env.HF_HUB_OFFLINE = "0";
     }
-    const code = await new Promise((resolve7) => {
-      const child = spawn(rt.mmh3turbo, args, { env });
+    const code = await new Promise((resolve8) => {
+      const child = spawn(engineCmd, engineArgs, { env });
       child.stdout.on("data", (d) => process.stderr.write(d));
       child.stderr.on("data", (d) => process.stderr.write(d));
       child.on("error", (e) => {
-        console.error(`\u542F\u52A8 mmh3turbo \u5931\u8D25: ${e.message}`);
+        console.error(`\u542F\u52A8\u5F15\u64CE\u5931\u8D25: ${e.message}`);
         process.exit(1);
       });
-      child.on("close", (c) => resolve7(c ?? -1));
+      child.on("close", (c) => resolve8(c ?? -1));
     });
     if (code !== 0) {
-      console.error(`mmh3turbo \u9000\u51FA\u7801 ${code}\uFF08\u8FD0\u884C\u76EE\u5F55\u4FDD\u7559\u4F9B\u6392\u67E5: ${runDir}\uFF1B\u5E38\u89C1\u539F\u56E0: \u78C1\u76D8\u7A7A\u95F4\u4E0D\u8DB3\u3001\u6743\u91CD\u4E0B\u8F7D\u4E2D\u65AD\u2014\u2014\u91CD\u8DD1\u5373\u53EF\u7EED\u4F20\uFF09`);
+      console.error(`\u5F15\u64CE\u9000\u51FA\u7801 ${code}\uFF08\u8FD0\u884C\u76EE\u5F55\u4FDD\u7559\u4F9B\u6392\u67E5: ${runDir}\uFF1B\u5E38\u89C1\u539F\u56E0: \u78C1\u76D8\u7A7A\u95F4\u4E0D\u8DB3\u3001\u6743\u91CD\u4E0B\u8F7D\u4E2D\u65AD\u2014\u2014\u91CD\u8DD1\u5373\u53EF\u7EED\u4F20\uFF09`);
       process.exit(1);
     }
     const produced = path.join(runDir, "video.mp4");
-    if (!fs5.existsSync(produced)) {
+    if (!fs7.existsSync(produced)) {
       console.error(`\u672A\u627E\u5230\u4EA7\u7269 ${produced}\uFF08\u8FD0\u884C\u76EE\u5F55\u5185\u5BB9\u4FDD\u7559\u4F9B\u6392\u67E5: ${runDir}\uFF09`);
       process.exit(1);
     }
     const out = path.resolve(opts.out);
-    fs5.mkdirSync(path.dirname(out), { recursive: true });
+    fs7.mkdirSync(path.dirname(out), { recursive: true });
     try {
-      fs5.renameSync(produced, out);
+      fs7.renameSync(produced, out);
     } catch {
-      fs5.copyFileSync(produced, out);
-      fs5.unlinkSync(produced);
+      fs7.copyFileSync(produced, out);
+      fs7.unlinkSync(produced);
     }
     console.log(
       JSON.stringify(
@@ -788,12 +1096,15 @@ function registerGen2(video) {
           out,
           seconds: Number(((Date.now() - t0) / 1e3).toFixed(1)),
           runDir,
-          engine: "mmh3turbo",
+          engine: fast ? "mmh3turbo+turbo-lora" : "mmh3turbo",
           res,
           duration: seconds,
           steps,
           seed: seed2,
-          ...opts.firstFrame ? { firstFrame: path.resolve(opts.firstFrame) } : {}
+          ...fast ? { fast: true, shiftVideo: FAST_SHIFT_VIDEO, ...turboMeta?.turbo_lora ? { lora: turboMeta.turbo_lora } : {} } : {},
+          ...hints.length ? { hints } : {},
+          ...opts.firstFrame ? { firstFrame: path.resolve(opts.firstFrame) } : {},
+          ...opts.lastFrame ? { lastFrame: path.resolve(opts.lastFrame) } : {}
         },
         null,
         2
@@ -801,10 +1112,99 @@ function registerGen2(video) {
     );
   });
 }
+function registerTurboMerge(video) {
+  video.command("turbo-merge").description("\u628A few-step \u84B8\u998F LoRA \u5408\u5E76\u8FDB int8 DiT bundle\uFF08--fast \u52A0\u901F\u6863\u7684\u4E00\u6B21\u6027\u51C6\u5907\uFF0C~20GB \u8BFB\u5199\uFF09").option("--lora <path>", "\u84B8\u998F LoRA safetensors\uFF08lightx2v \u547D\u540D\uFF1B\u7F3A\u5931\u65F6\u81EA\u52A8\u4ECE\u955C\u50CF\u4E0B\u8F7D\uFF09").option("--bundle <prefix>", "\u6E90 int8 bundle \u524D\u7F00\uFF08dit.bin/.idx\uFF09").option("--out <prefix>", "\u8F93\u51FA bundle \u524D\u7F00").option("--scale <n>", "LoRA \u5F3A\u5EA6\uFF08\u84B8\u998F\u914D\u65B9\u56FA\u5B9A 1.0\uFF0C\u52FF\u8C03\uFF09", "1.0").option("--nfe <n>", "\u63A8\u8350\u53BB\u566A\u6B65\u6570\uFF08\u5199\u5165 bundle meta\uFF0C--fast \u9ED8\u8BA4\u6B65\u6570\uFF1B8 \u6B65\u7248=8\uFF09").option("--no-download", "LoRA \u7F3A\u5931\u65F6\u4E0D\u81EA\u52A8\u4E0B\u8F7D\uFF0C\u76F4\u63A5\u62A5\u9519").action((opts) => {
+    const rt = resolveVideoRuntime();
+    const bundle = opts.bundle ?? path.join(rt.weightsDir, "dit");
+    const out = opts.out ?? path.join(rt.weightsDir, TURBO_BUNDLE);
+    const loraDir = path.join(rt.weightsDir, "loras");
+    const lora = opts.lora ?? path.join(loraDir, TURBO_LORA_FILE);
+    if (!fs7.existsSync(`${bundle}.bin`) || !fs7.existsSync(`${bundle}.idx`)) {
+      console.error(`\u6E90 int8 bundle \u4E0D\u5B58\u5728: ${bundle}.bin/.idx\u3002\u5148\u8FD0\u884C: lmedia video setup --mirror`);
+      process.exit(1);
+    }
+    if (!fs7.existsSync(rt.pythonVideo)) {
+      console.error(`\u89C6\u9891 venv \u4E0D\u5B58\u5728: ${rt.venvVideo}\u3002\u5148\u8FD0\u884C: lmedia video setup`);
+      process.exit(1);
+    }
+    if (!fs7.existsSync(lora)) {
+      if (!opts.download) {
+        console.error(`LoRA \u4E0D\u5B58\u5728\u4E14\u5DF2\u7981\u7528\u81EA\u52A8\u4E0B\u8F7D: ${lora}`);
+        process.exit(1);
+      }
+      fs7.mkdirSync(loraDir, { recursive: true });
+      console.error(`\u4E0B\u8F7D\u84B8\u998F LoRA\uFF08~1.4GB\uFF09\u2192 ${lora}`);
+      const r2 = spawnSync("curl", ["-L", "-C", "-", "--retry", "8", "--retry-delay", "5", "-o", `${lora}.part`, TURBO_LORA_URL], { stdio: "inherit" });
+      if (r2.status !== 0 || !fs7.existsSync(`${lora}.part`) || fs7.statSync(`${lora}.part`).size < 1e8) {
+        console.error(`LoRA \u4E0B\u8F7D\u5931\u8D25\uFF08\u53EF\u624B\u52A8\u4E0B\u8F7D\u540E\u653E\u81F3 ${lora}\uFF09: ${TURBO_LORA_URL}`);
+        process.exit(1);
+      }
+      fs7.renameSync(`${lora}.part`, lora);
+    }
+    console.error(`\u5408\u5E76 ${path.basename(lora)} \u2192 ${out}.bin/.idx\uFF08fp32 \u7CBE\u5EA6\u52A0 delta \u540E\u6309\u884C\u91CD\u91CF\u5316\uFF09`);
+    const mergeArgs = [
+      path.join(rt.pythonDir, "turbo_merge.py"),
+      "--lora",
+      lora,
+      "--bundle",
+      bundle,
+      "--out",
+      out,
+      "--scale",
+      opts.scale
+    ];
+    if (opts.nfe) mergeArgs.push("--nfe", opts.nfe);
+    const r = spawnSync(rt.pythonVideo, mergeArgs, { stdio: "inherit" });
+    if (r.status !== 0) {
+      console.error(`turbo_merge \u9000\u51FA\u7801 ${r.status}`);
+      process.exit(r.status ?? 1);
+    }
+    console.log(`\u5C31\u7EEA: lmedia video gen --fast ... \uFF08bundle: ${out}\uFF09`);
+  });
+}
+function registerRecipes(video) {
+  video.command("recipes").description("\u6253\u5370\u5B9E\u6D4B\u9A8C\u6536\u8FC7\u7684\u751F\u4EA7\u914D\u65B9\uFF08\u4EBA\u7269\u5FAE\u52A8/\u98CE\u666F\u7ED8\u672C/\u53CC\u951A\u5B9A\u4E00\u81F4\u6027\uFF09\uFF0C\u590D\u5236\u5373\u7528").action(() => {
+    console.log(`lmedia video \u751F\u4EA7\u914D\u65B9\uFF08M4 Max \u5B9E\u6D4B\u9A8C\u6536\uFF0C2026-09\uFF09
+
+\u2460 \u4EBA\u7269\u5FAE\u52A8\uFF08\u8D28\u91CF\u4F18\u5148\u2014\u2014\u4EBA\u7269\u89C6\u9891\u7684\u9ED8\u8BA4\u9009\u62E9\uFF09
+   \u8981\u70B9: \u57FA\u5EA7 12 \u6B65\uFF08\u4E0D\u7528 --fast\uFF0C\u84B8\u998F\u6863\u4EBA\u8138\u4F1A\u6CB9\u753B\u5316\uFF09+ \u4E3B\u4F53\u7279\u5199\u6784\u56FE
+   \uFF08\u5148\u88C1\u526A\uFF1A\u8BA9\u4EBA\u8138\u5360\u753B\u9762 1/4 \u4EE5\u4E0A\uFF0C\u8138\u8D8A\u5927\u50CF\u7D20\u8D8A\u8DB3\uFF09+ \u52A8\u4F5C\u6536\u655B\u7684 prompt
+   + \u65F6\u957F \u22645s\uFF08\u6F02\u79FB\u968F\u65F6\u957F\u7D2F\u79EF\uFF09
+
+   # \u4ECE\u5927\u56FE\u88C1\u4EBA\u7269\u7279\u5199\uFF08\u793A\u4F8B\uFF1A\u4ECE 1808\xB2 \u6E90\u56FE\u53D6\u4E3B\u4F53\u65B9\u6846\uFF09
+   ffmpeg -i photo.jpg -vf "crop=1150:1150:X:Y" closeup.jpg
+   lmedia video gen "\u4EBA\u7269+\u8F7B\u5FAE\u52A8\u4F5C\u63CF\u8FF0\uFF0C\u52A8\u4F5C\u8F7B\u67D4\u3002Audio: ambience, no talking, no voices" \\
+     -r square --seconds 4 --seed 11 --first-frame closeup.jpg -o clip.mp4
+   # ~23min/\u6761\uFF08M4 Max square 768\xB2 4s\uFF09
+
+\u2461 \u98CE\u666F/\u9759\u7269/\u7ED8\u672C\u5FAE\u52A8\uFF08\u5FEB\uFF09
+   \u8981\u70B9: --fast \u84B8\u998F\u6863\uFF088 \u6B65 shift 6\uFF0C\u9996\u6B21\u5148 lmedia video turbo-merge\uFF09\uFF1B
+   \u84B8\u998F 768p \u7CFB\u5206\u8FA8\u7387\u7EAA\u5F8B\uFF1A\u77ED\u8FB9 \u2265700\uFF0C352p/480p \u4EC5\u94FE\u8DEF\u9A8C\u8BC1
+
+   lmedia video gen "\u6C34\u5F69\u7ED8\u672C\u98CE\u683C\uFF1A\u5C0F\u871C\u8702\u7537\u5B69\u5728\u82B1\u56ED\u91CC\u6325\u624B\uFF0C\u82B1\u74E3\u98D8\u843D\uFF0C\u7EC6\u8282\u4E30\u5BCC" \\
+     --fast -r square --seconds 4 --first-frame page.png -o clip.mp4
+   # ~17min/\u6761\uFF1B\u4EBA\u7269\u614E\u7528\uFF08\u6CB9\u753B\u611F+\u6F02\u79FB\uFF09
+
+\u2462 \u4EBA\u7269\u4E00\u81F4\u6027\uFF1A\u53CC\u951A\u5B9A\uFF08\u9996\u5C3E\u540C\u56FE\u56DE\u73AF\uFF09
+   \u8981\u70B9: \u56FE\u751F\u89C6\u9891\u53EA\u951A\u9996\u5E27\u65F6\u7ED3\u5C3E\u8EAB\u4EFD\u5FC5\u6F02\uFF08\u5B9E\u6D4B\u4EBA\u8138\u76F8\u4F3C\u5EA6\u8DCC\u5230 0.3\uFF09\uFF1B
+   \u540C\u4E00\u5F20\u56FE\u540C\u65F6\u5582 --first-frame \u548C --last-frame\uFF0C\u52A8\u4F5C\u300C\u8361\u51FA\u53BB\u518D\u8361\u56DE\u6765\u300D\uFF0C
+   ArcFace \u5B9E\u6D4B\u7ED3\u5C3E\u76F8\u4F3C\u5EA6\u62C9\u56DE 0.97\u3002\u8D70\u8DEF\u4F4D\u79FB\u7C7B\u6784\u56FE\u4E0D\u9002\u7528\uFF08\u4F1A\u903C\u51FA\u56DE\u9000\u52A8\u4F5C\uFF09
+
+   lmedia video gen "\u4EBA\u7269+\u8F7B\u5FAE\u52A8\u4F5C\u63CF\u8FF0\uFF0C\u52A8\u4F5C\u8F7B\u67D4\u51E0\u4E4E\u4FDD\u6301\u539F\u59FF\u3002Audio: ..." \\
+     -r square --seconds 4 --seed 11 \\
+     --first-frame closeup.jpg --last-frame closeup.jpg -o clip.mp4
+
+\u901A\u7528\u7EAA\u5F8B\uFF1A
+- \u6587\u751F\u89C6\u9891\u4E2D\u6587 prompt 30-50 \u5B57\uFF0C\u5199\u6E05\u52A8\u4F5C\u4E0E\u955C\u5934\uFF0CAudio: \u6BB5\u5199\u73AF\u5883\u97F3\u5E76\u52A0 no talking
+- \u57FA\u5EA7\u9ED8\u8BA4 12 \u6B65\u5373 20 \u6B65\u89C2\u611F\uFF1B\u4E0D\u8981\u4F4E\u4E8E 8 \u6B65\uFF08\u6389\u8D28\u660E\u663E\uFF09
+- \u9996\u5E27\u7167\u7247\u4F18\u9009\uFF1A\u6B63\u8138\u3001\u6E05\u6670\u3001\u4EBA\u8138\u5360\u6BD4\u5927\u2014\u2014\u9996\u5E27\u5C31\u662F\u8EAB\u4EFD\u7684\u57FA\u56E0
+- \u751F\u6210\u7ED3\u679C\u673A\u8BFB hints \u5B57\u6BB5\u4F1A\u5E26\u573A\u666F\u8D28\u91CF\u5EFA\u8BAE\uFF1B\u73AF\u5883\u81EA\u68C0 lmedia doctor`);
+  });
+}
 function registerListRes(video) {
   video.command("list-res").description("\u5217\u51FA mmh3turbo \u652F\u6301\u7684\u5206\u8FA8\u7387\u6863\u4F4D\uFF08\u900F\u4F20\uFF09").action(() => {
     const rt = resolveVideoRuntime();
-    if (!fs5.existsSync(rt.mmh3turbo)) {
+    if (!fs7.existsSync(rt.mmh3turbo)) {
       console.error("mmh3turbo \u672A\u5B89\u88C5\u3002\u5148\u8FD0\u884C: lmedia video setup");
       process.exit(1);
     }
@@ -817,16 +1217,18 @@ function registerListRes(video) {
   });
 }
 function registerVideo(program2) {
-  const video = program2.command("video").description("\u89C6\u9891\u751F\u4EA7\u80FD\u529B\uFF08\u672C\u5730 MiniMax-H3 / mmh3turbo\uFF0C\u96F6 API \u6210\u672C\uFF09");
+  const video = program2.command("video").description("\u89C6\u9891\u751F\u4EA7\u80FD\u529B\uFF08\u672C\u5730 MiniMax-H3 / mmh3turbo\uFF0C\u96F6 API \u6210\u672C\uFF1B--fast Lightning \u84B8\u998F\u52A0\u901F\u6863\uFF1B\u751F\u4EA7\u914D\u65B9 lmedia video recipes\uFF09");
   registerSetup(video);
   registerGen2(video);
+  registerTurboMerge(video);
+  registerRecipes(video);
   registerListRes(video);
 }
 function registerLora(program2) {
   const lora = program2.command("lora").description("LoRA \u6CE8\u518C\u8868\u7BA1\u7406");
   lora.command("list").description("\u5217\u51FA\u5DF2\u6CE8\u518C LoRA").action(() => {
     for (const l of loadRegistry()) {
-      const exists = fs5.existsSync(l.path) ? "\u2713" : "\u2717 \u6587\u4EF6\u7F3A\u5931";
+      const exists = fs7.existsSync(l.path) ? "\u2713" : "\u2717 \u6587\u4EF6\u7F3A\u5931";
       console.log(
         `${l.name}	[${l.kind}]	weight=${l.defaultWeight}	trigger="${l.trigger}"	${exists}
   ${l.path}${l.note ? `
@@ -848,15 +1250,6 @@ function registerLora(program2) {
     }
   );
 }
-var ESRGAN_CACHE_PATH = path.join(os.homedir(), ".cache", "lmedia", "RealESRGAN_x2.pth");
-var LEGACY_TMP_PATH = "/tmp/RealESRGAN_x2.pth";
-function resolveEsrganPath() {
-  const env = process.env.LMEDIA_REALESRGAN_PATH;
-  if (env && fs5.existsSync(env)) return env;
-  if (fs5.existsSync(ESRGAN_CACHE_PATH)) return ESRGAN_CACHE_PATH;
-  if (fs5.existsSync(LEGACY_TMP_PATH)) return LEGACY_TMP_PATH;
-  return process.env.LMEDIA_REALESRGAN_PATH ?? ESRGAN_CACHE_PATH;
-}
 var ManifestCorruptError = class extends Error {
 };
 var InvalidArgsError = class extends Error {
@@ -881,8 +1274,8 @@ function emptyManifest() {
 }
 function readManifest(root) {
   const p = manifestPath(root);
-  if (!fs5.existsSync(p)) return emptyManifest();
-  const raw = fs5.readFileSync(p, "utf-8");
+  if (!fs7.existsSync(p)) return emptyManifest();
+  const raw = fs7.readFileSync(p, "utf-8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -902,17 +1295,17 @@ function readManifest(root) {
   return { version: 1, generatedAt: m.generatedAt ?? "", items: m.items };
 }
 function writeManifest(root, manifest) {
-  fs5.mkdirSync(root, { recursive: true });
+  fs7.mkdirSync(root, { recursive: true });
   const p = manifestPath(root);
   const tmp = `${p}.${process.pid}.tmp`;
-  fs5.writeFileSync(tmp, `${JSON.stringify(manifest, null, 1)}
+  fs7.writeFileSync(tmp, `${JSON.stringify(manifest, null, 1)}
 `, "utf-8");
-  fs5.renameSync(tmp, p);
+  fs7.renameSync(tmp, p);
 }
 function initLibrary(root) {
-  fs5.mkdirSync(path.join(root, "sfx"), { recursive: true });
-  fs5.mkdirSync(path.join(root, "ambient"), { recursive: true });
-  const created = !fs5.existsSync(manifestPath(root));
+  fs7.mkdirSync(path.join(root, "sfx"), { recursive: true });
+  fs7.mkdirSync(path.join(root, "ambient"), { recursive: true });
+  const created = !fs7.existsSync(manifestPath(root));
   if (created) writeManifest(root, emptyManifest());
   return { root: path.resolve(root), manifest: manifestPath(root), created };
 }
@@ -922,7 +1315,7 @@ function listEntries(root, filter = {}) {
   );
 }
 function sha256File(file) {
-  return createHash("sha256").update(fs5.readFileSync(file)).digest("hex");
+  return createHash("sha256").update(fs7.readFileSync(file)).digest("hex");
 }
 function assertFfmpeg() {
   for (const cmd of ["ffmpeg", "ffprobe"]) {
@@ -971,7 +1364,7 @@ function addEntry(root, opts) {
   if (!KEY_RE.test(opts.key)) throw new InvalidArgsError(`key \u4EC5\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u77ED\u6A2A\u7EBF: ${opts.key}`);
   const type = opts.type ?? "sfx";
   if (type !== "sfx" && type !== "ambient") throw new InvalidArgsError(`type \u4EC5\u652F\u6301 sfx|ambient: ${type}`);
-  if (!fs5.existsSync(opts.file)) throw new InvalidArgsError(`\u8F93\u5165\u97F3\u9891\u4E0D\u5B58\u5728: ${opts.file}`);
+  if (!fs7.existsSync(opts.file)) throw new InvalidArgsError(`\u8F93\u5165\u97F3\u9891\u4E0D\u5B58\u5728: ${opts.file}`);
   const hash = sha256File(opts.file);
   const dup = readManifest(root).items.find((i) => i.content_hash === hash);
   if (dup) return { item: dup, duplicated: true };
@@ -983,7 +1376,7 @@ function addEntry(root, opts) {
   try {
     probe = probeAudio(dst);
   } catch (e) {
-    fs5.rmSync(dst, { force: true });
+    fs7.rmSync(dst, { force: true });
     throw e;
   }
   const item = {
@@ -1020,7 +1413,7 @@ function verifyLibrary(root) {
   const problems = [];
   for (const item of items) {
     const issues = [];
-    if (!fs5.existsSync(item.path)) {
+    if (!fs7.existsSync(item.path)) {
       issues.push(`\u6587\u4EF6\u7F3A\u5931: ${item.path}`);
     } else {
       const dur = probeAudioDurationSync(item.path);
@@ -1077,7 +1470,7 @@ function assertMutuallyExclusive(a, b, nameA, nameB) {
   }
 }
 function assertFilesExist(files, flagName = "\u8F93\u5165\u6587\u4EF6") {
-  const missing = files.filter((f) => !fs5.existsSync(f));
+  const missing = files.filter((f) => !fs7.existsSync(f));
   if (missing.length) {
     throw new InvalidArgsError(`${flagName}\u4E0D\u5B58\u5728: ${missing.join(", ")}`);
   }
@@ -1154,7 +1547,7 @@ function fail(e) {
 }
 function requireAudioRuntime() {
   const rt = resolveAudioRuntime();
-  if (!fs5.existsSync(rt.pythonAudio)) {
+  if (!fs7.existsSync(rt.pythonAudio)) {
     throw new SfxEnvError(
       `\u97F3\u6548 venv \u672A\u627E\u5230: ${rt.pythonAudio}
 \u4FEE\u590D: lmedia sfx setup\uFF08\u6216 cd ${rt.root} && uv venv .venv-audio --python 3.11 && uv pip install -p .venv-audio/bin/python torch torchaudio "transformers<5" einops soundfile\uFF09`
@@ -1184,7 +1577,7 @@ function registerGen3(sfx) {
       const rt = requireAudioRuntime();
       requireFfmpeg();
       const out = path.resolve(opts.out ?? "sfx.wav");
-      fs5.mkdirSync(path.dirname(out), { recursive: true });
+      fs7.mkdirSync(path.dirname(out), { recursive: true });
       console.error(`\u{1F3AC} sfx gen\uFF08${rolls} \u63B7 + \u8D28\u91CF\u95E8 + \u526A\u88C1\uFF09\u2026`);
       const res = await runSfxOp(rt, {
         prompt,
@@ -1206,11 +1599,11 @@ function registerBatch(sfx) {
   sfx.command("batch").description("\u6E05\u5355\u9A71\u52A8\u6279\u91CF\u751F\u6210\uFF1A\u9010 key \u591A\u63B7 + \u8D28\u91CF\u95E8\u9009\u4F18 \u2192 <dir>/<key>.best.wav + report.json").requiredOption("-m, --manifest <file>", "\u6279\u6E05\u5355 JSON \u8DEF\u5F84\uFF08- \u8BFB stdin\uFF09").requiredOption("-o, --out <dir>", "\u8F93\u51FA\u76EE\u5F55").option("--rolls <n>", "\u6BCF key \u57FA\u7840\u751F\u6210\u6B21\u6570\uFF081-10\uFF0C\u5168\u5E9F\u81EA\u52A8\u52A0\u63B7\u22642\uFF09", "3").option("--keep-rolls", "\u4FDD\u7559\u5168\u90E8\u63B7\u6B21\u5230\u8F93\u51FA\u76EE\u5F55\uFF08<key>.r<N>.wav\uFF09").option("--full", "\u8DF3\u8FC7\u526A\u88C1\uFF0C\u4FDD\u7559 10s \u539F\u59CB\u751F\u6210").option("--keys <list>", "\u53EA\u8DD1\u5B50\u96C6\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u5982 bear,frog\uFF09").action(async (opts) => {
     try {
       const rolls = parseRolls(opts.rolls);
-      const text = opts.manifest === "-" ? fs5.readFileSync(0, "utf-8") : (() => {
-        if (!fs5.existsSync(opts.manifest)) {
+      const text = opts.manifest === "-" ? fs7.readFileSync(0, "utf-8") : (() => {
+        if (!fs7.existsSync(opts.manifest)) {
           throw new InvalidArgsError(`\u6279\u6E05\u5355\u4E0D\u5B58\u5728: ${opts.manifest}`);
         }
-        return fs5.readFileSync(opts.manifest, "utf-8");
+        return fs7.readFileSync(opts.manifest, "utf-8");
       })();
       const items = parseBatchManifest(
         text,
@@ -1219,7 +1612,7 @@ function registerBatch(sfx) {
       const rt = requireAudioRuntime();
       requireFfmpeg();
       const outDir = path.resolve(opts.out);
-      fs5.mkdirSync(outDir, { recursive: true });
+      fs7.mkdirSync(outDir, { recursive: true });
       console.error(`\u{1F3AC} sfx batch\uFF08${items.length} key \xD7 ${rolls} \u63B7\uFF09\u2192 ${outDir}`);
       const res = await runSfxOp(rt, {
         op: "batch",
@@ -1349,13 +1742,13 @@ function registerAccept(sfx) {
 function registerAb(sfx) {
   sfx.command("ab").description("\u751F\u6210 A/B \u8BD5\u542C\u9875\uFF08\u72EC\u7ACB html\uFF0C\u5019\u9009\u97F3\u9891\u62F7\u8D1D\u5230 ab_files/ \u76F8\u5BF9\u8DEF\u5F84\u5F15\u7528\uFF09").requiredOption("-m, --groups <file>", 'groups JSON\uFF1A[{"name":"...","candidates":["a.wav","b.wav"]}]').requiredOption("-o, --out <file>", "\u8F93\u51FA html \u8DEF\u5F84").action(async (opts) => {
     try {
-      if (!fs5.existsSync(opts.groups)) throw new InvalidArgsError(`groups \u6587\u4EF6\u4E0D\u5B58\u5728: ${opts.groups}`);
-      const groups = parseAbGroups(fs5.readFileSync(opts.groups, "utf-8"));
+      if (!fs7.existsSync(opts.groups)) throw new InvalidArgsError(`groups \u6587\u4EF6\u4E0D\u5B58\u5728: ${opts.groups}`);
+      const groups = parseAbGroups(fs7.readFileSync(opts.groups, "utf-8"));
       const candidates = groups.flatMap((g) => g.candidates);
       assertFilesExist(candidates, "\u5019\u9009\u97F3\u9891");
       const rt = requireAudioRuntime();
       const out = path.resolve(opts.out);
-      fs5.mkdirSync(path.dirname(out), { recursive: true });
+      fs7.mkdirSync(path.dirname(out), { recursive: true });
       const res = await runSfxOp(rt, { op: "abpage", groups, out });
       console.error(`\xB7 \u5019\u9009\u97F3\u9891\u5DF2\u62F7\u8D1D\u5230 ${path.join(path.dirname(out), "ab_files")}`);
       console.log(`\u2713 ${res.out}\uFF08${res.groups} \u7EC4 / ${res.candidates} \u5019\u9009\uFF09`);
@@ -1372,7 +1765,7 @@ function registerSetup2(sfx) {
         throw new SfxEnvError("\u7F3A\u5C11 uv\uFF08curl -LsSf https://astral.sh/uv/install.sh | sh\uFF09\uFF0Csfx setup \u4F9D\u8D56");
       }
       const deps = ["torch", "torchaudio", "transformers<5", "einops", "soundfile"];
-      if (fs5.existsSync(rt.pythonAudio)) {
+      if (fs7.existsSync(rt.pythonAudio)) {
         const ok = spawnSync(rt.pythonAudio, ["-c", "import torch, torchaudio, transformers, einops, soundfile"], { stdio: "ignore" }).status === 0;
         if (ok) {
           console.error(`\u2713 \u97F3\u6548 venv \u5DF2\u5C31\u7EEA: ${rt.pythonAudio}`);
@@ -1400,7 +1793,7 @@ function registerSfxDoctor(sfx) {
       const checks = [
         [
           "\u97F3\u6548 venv",
-          fs5.existsSync(rt.pythonAudio),
+          fs7.existsSync(rt.pythonAudio),
           `\u4FEE\u590D: lmedia sfx setup\uFF08\u5EFA ${rt.root}/.venv-audio\uFF09`
         ],
         [
@@ -1529,7 +1922,7 @@ function registerSfx(program2) {
 function sfxDoctorChecks() {
   const rt = resolveAudioRuntime();
   return [
-    [`[sfx] .venv-audio\uFF08Dasheng-AudioGen\uFF09`, fs5.existsSync(rt.pythonAudio)],
+    [`[sfx] .venv-audio\uFF08Dasheng-AudioGen\uFF09`, fs7.existsSync(rt.pythonAudio)],
     [`[sfx] \u4E3B\u6A21\u578B\u7F13\u5B58 ${MODEL}`, !!hfSnapshot(MODEL)],
     [`[sfx] \u5206\u8BCD\u5668\u7F13\u5B58 ${TOKENIZER}`, !!hfSnapshot(TOKENIZER)]
   ];
@@ -1537,37 +1930,43 @@ function sfxDoctorChecks() {
 
 // src/commands/doctor.ts
 function registerDoctor(program2) {
-  program2.command("doctor").description("\u73AF\u5883\u81EA\u68C0\uFF1A\u8FD0\u884C\u65F6/\u6A21\u578B\u5FEB\u7167/LoRA \u6587\u4EF6\u5B8C\u6574\u6027").action(async () => {
+  program2.command("doctor").description("\u73AF\u5883\u81EA\u68C0\uFF1A\u8FD0\u884C\u65F6/\u6A21\u578B\u5FEB\u7167/LoRA \u6587\u4EF6\u5B8C\u6574\u6027\uFF08\u80FD\u529B\u5F00\u5173\u89C1 lmedia image status\uFF09").action(async () => {
     const vrt = resolveVideoRuntime();
     const videoChecks = [
-      ["[video] .venv-video\uFF08mmh3turbo\uFF09", fs5.existsSync(vrt.mmh3turbo)],
+      ["[video] .venv-video\uFF08mmh3turbo\uFF09", fs7.existsSync(vrt.mmh3turbo)],
       ["[video] ffmpeg", hasCommand("ffmpeg")],
-      ["[video] H3 \u6743\u91CD\uFF08~/.cache/mmh3turbo\uFF0C\u672A\u5C31\u7EEA\u65F6\u9996\u6B21\u751F\u6210\u81EA\u52A8\u4E0B\u8F7D\u6216 setup --mirror\uFF09", fs5.existsSync(path.join(vrt.weightsDir, "dit.bin"))]
+      ["[video] H3 \u6743\u91CD\uFF08~/.cache/mmh3turbo\uFF0C\u672A\u5C31\u7EEA\u65F6\u9996\u6B21\u751F\u6210\u81EA\u52A8\u4E0B\u8F7D\u6216 setup --mirror\uFF09", fs7.existsSync(path.join(vrt.weightsDir, "dit.bin"))],
+      ["[video] \u52A0\u901F\u6863 bundle dit-turbo\uFF08--fast \u7528\uFF1B\u7F3A\u5931\u8DD1 lmedia video turbo-merge\uFF09", fs7.existsSync(path.join(vrt.weightsDir, "dit-turbo.bin"))]
     ];
+    const gate = readImageGate();
     let imageOk = true;
-    try {
-      const rt = resolveRuntime();
-      const checks = [
-        ["runtime root", fs5.existsSync(rt.root)],
-        ["pythonGen (.venv-train)", fs5.existsSync(rt.pythonGen)],
-        ["pythonFast (.venv)", fs5.existsSync(rt.pythonFast)],
-        ["[image] Qwen-Image-2512 \u5FEB\u7167", fs5.existsSync(rt.snapshot)],
-        ["[image] Qwen-Image-Edit-2511 \u5FEB\u7167", fs5.existsSync(rt.snapshotEdit)],
-        ["[image] Real-ESRGAN \u6743\u91CD", fs5.existsSync(resolveEsrganPath())]
-      ];
-      for (const [name, ok] of checks) console.log(`${ok ? "\u2713" : "\u2717"} ${name}`);
+    if (gate.state === "corrupt") {
+      console.log(`\u2717 [image] \u80FD\u529B\u72B6\u6001\u6587\u4EF6\u635F\u574F\uFF08\u65E0\u6CD5\u89E3\u6790\uFF09\u2192 ${gate.file}`);
+      console.log(`  \u539F\u56E0: ${gate.error}`);
+      console.log(`  \u4FEE\u590D: lmedia image enable\uFF08\u7528\u542F\u7528\u72B6\u6001\u8986\u76D6\u91CD\u5199\uFF09\uFF0C\u6216 rm ${gate.file}\uFF08\u5220\u9664\u540E\u56DE\u5230\u9ED8\u8BA4\u542F\u7528\uFF09`);
+      imageOk = false;
+    } else if (gate.state === "disabled") {
+      console.log(
+        `\xB7 [image] \u56FE\u50CF\u80FD\u529B\u5DF2\u7981\u7528\uFF08${gate.file}${gate.disabledAt ? `\uFF0C${gate.disabledAt}` : ""}${gate.reason ? `\uFF0C\u539F\u56E0: ${gate.reason}` : ""}\uFF09`
+      );
+      console.log(`\xB7 runtime/venv/\u6A21\u578B\u5FEB\u7167/LoRA \u68C0\u67E5\u5DF2\u8DF3\u8FC7\uFF1B\u6062\u590D: lmedia image enable`);
+    } else {
+      const items = imagePreflight();
+      for (const it of items) console.log(`${it.ok ? "\u2713" : "\u2717"} ${it.name}${it.ok ? "" : ` \u2192 ${it.fix}`}`);
       for (const l of loadRegistry()) {
-        console.log(`${fs5.existsSync(l.path) ? "\u2713" : "\u2717"} LoRA: ${l.name}`);
+        console.log(`${fs7.existsSync(l.path) ? "\u2713" : "\u2717"} LoRA: ${l.name}`);
       }
-      imageOk = checks.every(([, ok]) => ok);
-    } catch (e) {
-      imageOk = false;
-      console.error(e.message);
+      imageOk = items.every((i) => i.ok);
     }
     for (const m of ["gen", "edit"]) {
       const st = await pingDaemon(m);
+      if (st && gate.state === "disabled") {
+        console.log(`\u2717 [image] daemon ${m} \u4ECD\u5728\u8FD0\u884C\uFF08pid ${st.pid}\uFF09\u2014\u2014\u56FE\u50CF\u80FD\u529B\u5DF2\u7981\u7528\uFF1B\u505C\u6B62: lmedia image serve stop --mode ${m}`);
+        imageOk = false;
+        continue;
+      }
       console.log(
-        `${st ? "\u2713" : "\xB7"} [image] daemon ${m}${st ? `: ${st.state}\uFF08pid ${st.pid}\uFF0Cjobs ${st.jobs}\uFF09` : ": \u672A\u8FD0\u884C\uFF08\u53EF\u9009\uFF0Clmedia image serve start --mode " + m + "\uFF09"}`
+        `${st ? "\u2713" : "\xB7"} [image] daemon ${m}${st ? `: ${st.state}\uFF08pid ${st.pid}\uFF0Cjobs ${st.jobs}\uFF09` : gate.state === "disabled" ? ": \u672A\u8FD0\u884C\uFF08\u80FD\u529B\u5DF2\u7981\u7528\uFF0Cstart \u88AB\u62E6\u622A\uFF09" : ": \u672A\u8FD0\u884C\uFF08\u53EF\u9009\uFF0Clmedia image serve start --mode " + m + "\uFF09"}`
       );
     }
     for (const [name, ok] of videoChecks) console.log(`${ok ? "\u2713" : "\u2717"} ${name}`);
@@ -1575,9 +1974,10 @@ function registerDoctor(program2) {
     const sfxChecks = sfxDoctorChecks();
     for (const [name, ok] of sfxChecks) console.log(`${ok ? "\u2713" : "\u2717"} ${name}`);
     const sfxOk = sfxChecks.every(([, ok]) => ok);
+    const imageText = gate.state === "corrupt" ? "\u80FD\u529B\u72B6\u6001\u635F\u574F\uFF08\u4FEE\u590D\u6307\u5F15\u89C1\u4E0A\uFF09" : gate.state === "disabled" ? `\u5DF2\u7981\u7528${imageOk ? "" : "\uFF08\u4F46 daemon \u4ECD\u5728\u8FD0\u884C\uFF0C\u89C1\u4E0A\uFF09"}` : imageOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA";
     console.log(
       `
-\u56FE\u50CF\u6A21\u6001${imageOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA"}\u3002\u89C6\u9891\u6A21\u6001\uFF08\u672C\u5730 MiniMax-H3 / mmh3turbo\uFF09\uFF1A${videoOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA\uFF08lmedia video setup\uFF09"}\u3002\u97F3\u6548\u6A21\u6001\uFF1A${sfxOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA\uFF08lmedia sfx doctor \u770B\u4FEE\u590D\u6307\u5F15\uFF09"}`
+\u56FE\u50CF\u6A21\u6001${imageText}\u3002\u89C6\u9891\u6A21\u6001\uFF08\u672C\u5730 MiniMax-H3 / mmh3turbo\uFF09\uFF1A${videoOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA\uFF08lmedia video setup\uFF09"}\u3002\u97F3\u6548\u6A21\u6001\uFF1A${sfxOk ? "\u5C31\u7EEA" : "\u672A\u5C31\u7EEA\uFF08lmedia sfx doctor \u770B\u4FEE\u590D\u6307\u5F15\uFF09"}`
     );
     if (!imageOk) process.exit(1);
   });