evomeme 0.1.7 → 0.1.9

package/dist/index.js

@@ -3234,8 +3234,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path24) {
-      let input = path24;
+    function removeDotSegments(path26) {
+      let input = path26;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3487,8 +3487,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path24, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path24 && path24 !== "/" ? path24 : void 0;
+        const [path26, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path26 && path26 !== "/" ? path26 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6906,7 +6906,7 @@ var require_windows = __commonJS({
     module.exports = isexe;
     isexe.sync = sync;
     var fs14 = __require("fs");
-    function checkPathExt(path24, options) {
+    function checkPathExt(path26, options) {
       var pathext = options.pathExt !== void 0 ? options.pathExt : process.env.PATHEXT;
       if (!pathext) {
         return true;
@@ -6917,25 +6917,25 @@ var require_windows = __commonJS({
       }
       for (var i = 0; i < pathext.length; i++) {
         var p = pathext[i].toLowerCase();
-        if (p && path24.substr(-p.length).toLowerCase() === p) {
+        if (p && path26.substr(-p.length).toLowerCase() === p) {
           return true;
         }
       }
       return false;
     }
-    function checkStat(stat7, path24, options) {
+    function checkStat(stat7, path26, options) {
       if (!stat7.isSymbolicLink() && !stat7.isFile()) {
         return false;
       }
-      return checkPathExt(path24, options);
+      return checkPathExt(path26, options);
     }
-    function isexe(path24, options, cb) {
-      fs14.stat(path24, function(er, stat7) {
-        cb(er, er ? false : checkStat(stat7, path24, options));
+    function isexe(path26, options, cb) {
+      fs14.stat(path26, function(er, stat7) {
+        cb(er, er ? false : checkStat(stat7, path26, options));
       });
     }
-    function sync(path24, options) {
-      return checkStat(fs14.statSync(path24), path24, options);
+    function sync(path26, options) {
+      return checkStat(fs14.statSync(path26), path26, options);
     }
   }
 });
@@ -6946,13 +6946,13 @@ var require_mode = __commonJS({
     module.exports = isexe;
     isexe.sync = sync;
     var fs14 = __require("fs");
-    function isexe(path24, options, cb) {
-      fs14.stat(path24, function(er, stat7) {
+    function isexe(path26, options, cb) {
+      fs14.stat(path26, function(er, stat7) {
         cb(er, er ? false : checkStat(stat7, options));
       });
     }
-    function sync(path24, options) {
-      return checkStat(fs14.statSync(path24), options);
+    function sync(path26, options) {
+      return checkStat(fs14.statSync(path26), options);
     }
     function checkStat(stat7, options) {
       return stat7.isFile() && checkMode(stat7, options);
@@ -6985,7 +6985,7 @@ var require_isexe = __commonJS({
     }
     module.exports = isexe;
     isexe.sync = sync;
-    function isexe(path24, options, cb) {
+    function isexe(path26, options, cb) {
       if (typeof options === "function") {
         cb = options;
         options = {};
@@ -6995,7 +6995,7 @@ var require_isexe = __commonJS({
           throw new TypeError("callback not provided");
         }
         return new Promise(function(resolve, reject) {
-          isexe(path24, options || {}, function(er, is) {
+          isexe(path26, options || {}, function(er, is) {
             if (er) {
               reject(er);
             } else {
@@ -7004,7 +7004,7 @@ var require_isexe = __commonJS({
           });
         });
       }
-      core(path24, options || {}, function(er, is) {
+      core(path26, options || {}, function(er, is) {
         if (er) {
           if (er.code === "EACCES" || options && options.ignoreErrors) {
             er = null;
@@ -7014,9 +7014,9 @@ var require_isexe = __commonJS({
         cb(er, is);
       });
     }
-    function sync(path24, options) {
+    function sync(path26, options) {
       try {
-        return core.sync(path24, options || {});
+        return core.sync(path26, options || {});
       } catch (er) {
         if (options && options.ignoreErrors || er.code === "EACCES") {
           return false;
@@ -7032,7 +7032,7 @@ var require_isexe = __commonJS({
 var require_which = __commonJS({
   "node_modules/which/which.js"(exports, module) {
     var isWindows = process.platform === "win32" || process.env.OSTYPE === "cygwin" || process.env.OSTYPE === "msys";
-    var path24 = __require("path");
+    var path26 = __require("path");
     var COLON = isWindows ? ";" : ":";
     var isexe = require_isexe();
     var getNotFoundError = (cmd) => Object.assign(new Error(`not found: ${cmd}`), { code: "ENOENT" });
@@ -7070,7 +7070,7 @@ var require_which = __commonJS({
           return opt.all && found.length ? resolve(found) : reject(getNotFoundError(cmd));
         const ppRaw = pathEnv[i];
         const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
-        const pCmd = path24.join(pathPart, cmd);
+        const pCmd = path26.join(pathPart, cmd);
         const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
         resolve(subStep(p, i, 0));
       });
@@ -7097,7 +7097,7 @@ var require_which = __commonJS({
       for (let i = 0; i < pathEnv.length; i++) {
         const ppRaw = pathEnv[i];
         const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
-        const pCmd = path24.join(pathPart, cmd);
+        const pCmd = path26.join(pathPart, cmd);
         const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
         for (let j = 0; j < pathExt.length; j++) {
           const cur = p + pathExt[j];
@@ -7145,7 +7145,7 @@ var require_path_key = __commonJS({
 var require_resolveCommand = __commonJS({
   "node_modules/cross-spawn/lib/util/resolveCommand.js"(exports, module) {
     "use strict";
-    var path24 = __require("path");
+    var path26 = __require("path");
     var which = require_which();
     var getPathKey = require_path_key();
     function resolveCommandAttempt(parsed, withoutPathExt) {
@@ -7163,7 +7163,7 @@ var require_resolveCommand = __commonJS({
       try {
         resolved = which.sync(parsed.command, {
           path: env[getPathKey({ env })],
-          pathExt: withoutPathExt ? path24.delimiter : void 0
+          pathExt: withoutPathExt ? path26.delimiter : void 0
         });
       } catch (e) {
       } finally {
@@ -7172,7 +7172,7 @@ var require_resolveCommand = __commonJS({
         }
       }
       if (resolved) {
-        resolved = path24.resolve(hasCustomCwd ? parsed.options.cwd : "", resolved);
+        resolved = path26.resolve(hasCustomCwd ? parsed.options.cwd : "", resolved);
       }
       return resolved;
     }
@@ -7226,8 +7226,8 @@ var require_shebang_command = __commonJS({
       if (!match) {
         return null;
       }
-      const [path24, argument] = match[0].replace(/#! ?/, "").split(" ");
-      const binary = path24.split("/").pop();
+      const [path26, argument] = match[0].replace(/#! ?/, "").split(" ");
+      const binary = path26.split("/").pop();
       if (binary === "env") {
         return argument;
       }
@@ -7262,7 +7262,7 @@ var require_readShebang = __commonJS({
 var require_parse = __commonJS({
   "node_modules/cross-spawn/lib/parse.js"(exports, module) {
     "use strict";
-    var path24 = __require("path");
+    var path26 = __require("path");
     var resolveCommand = require_resolveCommand();
     var escape2 = require_escape();
     var readShebang = require_readShebang();
@@ -7287,7 +7287,7 @@ var require_parse = __commonJS({
       const needsShell = !isExecutableRegExp.test(commandFile);
       if (parsed.options.forceShell || needsShell) {
         const needsDoubleEscapeMetaChars = isCmdShimRegExp.test(commandFile);
-        parsed.command = path24.normalize(parsed.command);
+        parsed.command = path26.normalize(parsed.command);
         parsed.command = escape2.command(parsed.command);
         parsed.args = parsed.args.map((arg) => escape2.argument(arg, needsDoubleEscapeMetaChars));
         const shellCommand = [parsed.command].concat(parsed.args).join(" ");
@@ -7377,7 +7377,7 @@ var require_cross_spawn = __commonJS({
     var cp = __require("child_process");
     var parse3 = require_parse();
     var enoent = require_enoent();
-    function spawn6(command, args, options) {
+    function spawn7(command, args, options) {
       const parsed = parse3(command, args, options);
       const spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
       enoent.hookChildProcess(spawned, parsed);
@@ -7389,8 +7389,8 @@ var require_cross_spawn = __commonJS({
       result.error = result.error || enoent.verifyENOENTSync(result.status, parsed);
       return result;
     }
-    module.exports = spawn6;
-    module.exports.spawn = spawn6;
+    module.exports = spawn7;
+    module.exports.spawn = spawn7;
     module.exports.sync = spawnSync;
     module.exports._parse = parse3;
     module.exports._enoent = enoent;
@@ -9753,10 +9753,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path24) {
-  if (!path24)
+function getElementAtPath(obj, path26) {
+  if (!path26)
     return obj;
-  return path24.reduce((acc, key) => acc?.[key], obj);
+  return path26.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -10165,11 +10165,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path24, issues) {
+function prefixIssues(path26, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path24);
+    iss.path.unshift(path26);
     return iss;
   });
 }
@@ -10316,16 +10316,16 @@ function flattenError(error2, mapper = (issue2) => issue2.message) {
 }
 function formatError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error3, path24 = []) => {
+  const processError = (error3, path26 = []) => {
     for (const issue2 of error3.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path24, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path26, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path26, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path24, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path26, ...issue2.path]);
       } else {
-        const fullpath = [...path24, ...issue2.path];
+        const fullpath = [...path26, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -18267,7 +18267,7 @@ var StdioClientTransport = class {
 };
 
 // src/version.ts
-var VERSION = "0.1.7";
+var VERSION = "0.1.9";
 
 // src/publishChannel.generated.ts
 var PUBLISH_NPM_NAME = "evomeme";
@@ -18487,6 +18487,7 @@ function escapeRegExp(value) {
 
 // src/cli/install/ides/codex.ts
 var MCP_SERVER_NAME = "evomeme";
+var MCP_TOOL_TIMEOUT_SECONDS = 60 * 60;
 function getCodexConfigPath(homeDir) {
   return path3.join(homeDir ?? os.homedir(), ".codex", "config.toml");
 }
@@ -18510,6 +18511,7 @@ function mergeCodexMcpConfig(configPath, options) {
     `[mcp_servers."${MCP_SERVER_NAME}"]`,
     `command = "${escapeToml(launch.command)}"`,
     `args = [${launch.args.map((arg) => `"${escapeToml(arg)}"`).join(", ")}]`,
+    `tool_timeout_sec = ${MCP_TOOL_TIMEOUT_SECONDS}`,
     ...envSection,
     ""
   ].join("\n");
@@ -18970,8 +18972,8 @@ async function performRequest(config2, fetchFn, request) {
   }
   return envelope.data;
 }
-function buildUrl(baseUrl, path24, query) {
-  const url = new URL(`${baseUrl}${path24.startsWith("/") ? path24 : `/${path24}`}`);
+function buildUrl(baseUrl, path26, query) {
+  const url = new URL(`${baseUrl}${path26.startsWith("/") ? path26 : `/${path26}`}`);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (value !== void 0) {
@@ -19262,7 +19264,7 @@ async function getImageJobStatus(token, jobId, options = {}) {
     path: `/v1/tools/image/jobs/${encodeURIComponent(jobId)}`,
     token
   });
-  if (typeof data.job_id !== "string" || data.job_id.length === 0 || !IMAGE_JOB_KINDS.includes(data.kind ?? "") || !IMAGE_JOB_STATUSES.includes(data.status ?? "") || typeof data.asset_url !== "string" || data.asset_url.length === 0 || typeof data.pending !== "boolean" || typeof data.attempts !== "number" || typeof data.max_attempts !== "number" || data.error_code !== void 0 && data.error_code !== null && typeof data.error_code !== "string" || data.error_stage !== void 0 && data.error_stage !== null && typeof data.error_stage !== "string" || typeof data.created_at !== "string" || typeof data.updated_at !== "string" || data.completed_at !== void 0 && data.completed_at !== null && typeof data.completed_at !== "string" || data.layers !== void 0 && !Array.isArray(data.layers)) {
+  if (typeof data.job_id !== "string" || data.job_id.length === 0 || !IMAGE_JOB_KINDS.includes(data.kind ?? "") || !IMAGE_JOB_STATUSES.includes(data.status ?? "") || typeof data.asset_url !== "string" || data.asset_url.length === 0 || typeof data.pending !== "boolean" || typeof data.attempts !== "number" || typeof data.max_attempts !== "number" || data.error_code !== void 0 && data.error_code !== null && typeof data.error_code !== "string" || data.error_stage !== void 0 && data.error_stage !== null && typeof data.error_stage !== "string" || data.error_message !== void 0 && data.error_message !== null && typeof data.error_message !== "string" || typeof data.created_at !== "string" || typeof data.updated_at !== "string" || data.completed_at !== void 0 && data.completed_at !== null && typeof data.completed_at !== "string" || data.layers !== void 0 && !Array.isArray(data.layers)) {
     throw incompatibleResponseError(JSON.stringify(data));
   }
   const layers = (data.layers ?? []).map((layer) => {
@@ -19288,6 +19290,7 @@ async function getImageJobStatus(token, jobId, options = {}) {
     maxAttempts: data.max_attempts,
     errorCode: data.error_code ?? void 0,
     errorStage: data.error_stage ?? void 0,
+    ...data.error_message == null ? {} : { errorMessage: data.error_message },
     createdAt: data.created_at,
     updatedAt: data.updated_at,
     completedAt: data.completed_at ?? void 0,
@@ -20161,21 +20164,23 @@ async function runInit(parsed, deps = defaultDeps2) {
 }
 
 // src/cli/canvas/command.ts
-import path21 from "node:path";
+import path22 from "node:path";
 
 // src/canvas/server.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 import { createReadStream, existsSync, watch } from "node:fs";
 import {
   copyFile as copyFile3,
-  mkdir as mkdir6,
-  readFile as readFile3,
+  mkdir as mkdir7,
+  mkdtemp as mkdtemp2,
+  readFile as readFile4,
+  rm as rm4,
   stat as stat6,
   unlink,
-  writeFile as writeFile3
+  writeFile as writeFile4
 } from "node:fs/promises";
 import http from "node:http";
-import path20 from "node:path";
+import path21 from "node:path";
 
 // src/image/service.ts
 import { copyFile, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
@@ -20350,7 +20355,7 @@ async function applyImageMask(sourcePath, maskPath, outputPath) {
     "-i",
     maskPath,
     "-filter_complex",
-    "[1:v]format=gray,negate[alpha];[0:v][alpha]alphamerge[out]",
+    "[0:v]format=rgba,split=2[source][source_alpha_input];[source_alpha_input]alphaextract[source_alpha];[1:v]format=gray,negate[mask_alpha];[source_alpha][mask_alpha]blend=all_mode=multiply[final_alpha];[source][final_alpha]alphamerge[out]",
     "-map",
     "[out]",
     "-frames:v",
@@ -20571,6 +20576,7 @@ async function waitForImageJob(jobId, initialAssetUrl, deps = defaultImageServic
     await hooks.onStatus?.({ ...status, assetUrl: lastAssetUrl });
     if (status.status === "SUCCEEDED") return { ...status, assetUrl: lastAssetUrl };
     if (status.status === "FAILED") {
+      if (status.errorMessage) throw new Error(status.errorMessage);
       throw new Error(
         [
           "图片任务失败。",
@@ -21093,11 +21099,13 @@ function splitAnchorFactors(anchor) {
   const y = anchor.startsWith("top") || anchor === "top" ? 0 : anchor.startsWith("bottom") || anchor === "bottom" ? 1 : 0.5;
   return { x, y };
 }
-async function manualSplitImage(sourcePath, outputDir, fileNameForIndex, rows, columns) {
+async function manualSplitImage(sourcePath, outputDir, fileNameForIndex, rows, columns, options = {}) {
   const rowValue = Number(rows);
   const columnValue = Number(columns);
-  if (!Number.isInteger(rowValue) || !Number.isInteger(columnValue) || rowValue < 1 || columnValue < 1 || rowValue > 64 || columnValue > 64 || rowValue * columnValue < 2) {
-    throw new Error("手动切分的行数与列数需为 1–64 的整数，且至少切为两格");
+  if (!Number.isInteger(rowValue) || !Number.isInteger(columnValue) || rowValue < 1 || columnValue < 1 || rowValue > 64 || columnValue > 64 || !options.allowSingleCell && rowValue * columnValue < 2) {
+    throw new Error(
+      options.allowSingleCell ? "图片切分的行数与列数需为 1–64 的整数" : "手动切分的行数与列数需为 1–64 的整数，且至少切为两格"
+    );
   }
   const r = rowValue;
   const c = columnValue;
@@ -21108,34 +21116,39 @@ async function manualSplitImage(sourcePath, outputDir, fileNameForIndex, rows, c
   await mkdir3(outputDir, { recursive: true });
   const files = [];
   const boxes = [];
-  for (let row = 0; row < r; row += 1) {
+  const requestedIndexes = options.indexes == null ? Array.from({ length: r * c }, (_, index) => index) : [...new Set(options.indexes.map(Number))];
+  if (!requestedIndexes.length || requestedIndexes.some(
+    (index) => !Number.isInteger(index) || index < 0 || index >= r * c
+  )) {
+    throw new Error("图片切分索引无效");
+  }
+  for (const index of requestedIndexes) {
+    const row = Math.floor(index / c);
+    const column = index % c;
     const y = Math.floor(row * source.height / r);
     const bottom = Math.floor((row + 1) * source.height / r);
-    for (let column = 0; column < c; column += 1) {
-      const x = Math.floor(column * source.width / c);
-      const right = Math.floor((column + 1) * source.width / c);
-      const box = { x, y, width: right - x, height: bottom - y };
-      const index = row * c + column;
-      const output = path17.join(outputDir, fileNameForIndex(index));
-      await runBinary(ffmpegPath2(), [
-        "-hide_banner",
-        "-loglevel",
-        "error",
-        "-y",
-        "-i",
-        sourcePath,
-        "-vf",
-        `format=rgba,crop=${box.width}:${box.height}:${box.x}:${box.y}`,
-        "-frames:v",
-        "1",
-        "-c:v",
-        "png",
-        output
-      ]);
-      await assertFile(output, "手动切分输出为空");
-      boxes.push(box);
-      files.push(output);
-    }
+    const x = Math.floor(column * source.width / c);
+    const right = Math.floor((column + 1) * source.width / c);
+    const box = { x, y, width: right - x, height: bottom - y };
+    const output = path17.join(outputDir, fileNameForIndex(index));
+    await runBinary(ffmpegPath2(), [
+      "-hide_banner",
+      "-loglevel",
+      "error",
+      "-y",
+      "-i",
+      sourcePath,
+      "-vf",
+      `format=rgba,crop=${box.width}:${box.height}:${box.x}:${box.y}`,
+      "-frames:v",
+      "1",
+      "-c:v",
+      "png",
+      output
+    ]);
+    await assertFile(output, "手动切分输出为空");
+    boxes.push(box);
+    files.push(output);
   }
   return {
     files,
@@ -21146,7 +21159,7 @@ async function manualSplitImage(sourcePath, outputDir, fileNameForIndex, rows, c
     sourceHeight: source.height
   };
 }
-async function composeSequenceSheet(framePaths, outputPath, rows, columns) {
+async function composeSequenceSheet(framePaths, outputPath, rows, columns, options = {}) {
   const r = Math.round(Number(rows));
   const c = Math.round(Number(columns));
   if (r < 1 || c < 1 || !Number.isFinite(r) || !Number.isFinite(c)) {
@@ -21157,13 +21170,15 @@ async function composeSequenceSheet(framePaths, outputPath, rows, columns) {
     throw new Error(`格子不足：${r}×${c}=${r * c}，但有 ${framePaths.length} 帧`);
   }
   const dimensions = await Promise.all(framePaths.map(probeImageDimensions));
-  const cellWidth = Math.max(...dimensions.map((item) => item.width));
-  const cellHeight = Math.max(...dimensions.map((item) => item.height));
+  const requestedCellWidth = Math.round(Number(options.cellWidth));
+  const requestedCellHeight = Math.round(Number(options.cellHeight));
+  const cellWidth = requestedCellWidth > 0 ? requestedCellWidth : Math.max(...dimensions.map((item) => item.width));
+  const cellHeight = requestedCellHeight > 0 ? requestedCellHeight : Math.max(...dimensions.map((item) => item.height));
   const width = cellWidth * c;
   const height = cellHeight * r;
   const inputs = framePaths.flatMap((frame) => ["-i", frame]);
   const normalized = framePaths.map(
-    (_, index) => `[${index}:v]format=rgba,pad=${cellWidth}:${cellHeight}:0:0:color=0x00000000[f${index}]`
+    (_, index) => options.fit === "contain" ? `[${index}:v]format=rgba,scale=${cellWidth}:${cellHeight}:force_original_aspect_ratio=decrease,pad=${cellWidth}:${cellHeight}:(ow-iw)/2:(oh-ih)/2:color=0x00000000[f${index}]` : `[${index}:v]format=rgba,pad=${cellWidth}:${cellHeight}:0:0:color=0x00000000[f${index}]`
   );
   const layouts = framePaths.map(
     (_, index) => `${index % c * cellWidth}_${Math.floor(index / c) * cellHeight}`
@@ -21297,11 +21312,11 @@ async function probeVideoDimensions(videoPath) {
   if (!stream?.width || !stream.height) throw new Error("无法读取视频尺寸");
   return { width: stream.width, height: stream.height };
 }
-async function trimVideo(videoPath, outputPath, startSeconds, endSeconds) {
+async function writeVideoSegment(videoPath, outputPath, startSeconds, endSeconds) {
   const totalDuration = await probeVideoDuration(videoPath);
   const start = Math.max(0, Number(startSeconds) || 0);
   const end = Math.min(totalDuration, Number(endSeconds) || totalDuration);
-  if (!(end > start + 0.01)) throw new Error("裁剪区间过短，请拉大起止范围");
+  if (!(end > start + 0.01)) throw new Error("视频区间过短");
   await mkdir4(path18.dirname(outputPath), { recursive: true });
   await run2(ffmpegPath3(), [
     "-hide_banner",
@@ -21328,7 +21343,7 @@ async function trimVideo(videoPath, outputPath, startSeconds, endSeconds) {
     "+faststart",
     outputPath
   ]);
-  if (!await fileExists(outputPath)) throw new Error("裁剪失败：未生成视频文件");
+  if (!await fileExists(outputPath)) throw new Error("视频片段生成失败");
   return { start, end, duration: end - start };
 }
 async function probeTotalFrames(videoPath) {
@@ -21496,7 +21511,7 @@ async function detectFirstVideoCycle(videoPath, options = {}) {
 }
 async function extractVideoCycle(videoPath, outputPath, options = {}) {
   const detected = await detectFirstVideoCycle(videoPath, options);
-  await trimVideo(videoPath, outputPath, detected.start, detected.end);
+  await writeVideoSegment(videoPath, outputPath, detected.start, detected.end);
   return { ...detected, file: outputPath };
 }
 function zscore(frame) {
@@ -21520,16 +21535,172 @@ function nccScore(left, right) {
 }
 
 // src/canvas/workspace.ts
-import { createHash, randomUUID as randomUUID2 } from "node:crypto";
+import { createHash, randomUUID as randomUUID3 } from "node:crypto";
 import {
-  mkdir as mkdir5,
-  readFile as readFile2,
+  mkdir as mkdir6,
+  readFile as readFile3,
   readdir,
-  rename as rename2,
+  rename as rename3,
   stat as stat5,
-  writeFile as writeFile2
+  writeFile as writeFile3
 } from "node:fs/promises";
+import path20 from "node:path";
+
+// src/canvas/layoutStore.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { mkdir as mkdir5, readFile as readFile2, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
 import path19 from "node:path";
+var CANVAS_LAYOUT_VERSION = 2;
+var layoutLocks = /* @__PURE__ */ new Map();
+var CanvasLayoutRevisionConflictError = class extends Error {
+  constructor(expectedRevision, actualRevision) {
+    super(`Canvas layout revision conflict: expected ${expectedRevision}, actual ${actualRevision}`);
+    this.status = 409;
+    this.name = "CanvasLayoutRevisionConflictError";
+    this.expectedRevision = expectedRevision;
+    this.actualRevision = actualRevision;
+  }
+};
+function createCanvasNodeId() {
+  return `node_${randomUUID2().replace(/-/g, "")}`;
+}
+function normalizeCanvasLayoutItem(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const source = value;
+  const id = typeof source.id === "string" ? source.id.trim() : "";
+  if (!id || source.type === "sequence") return void 0;
+  const explicitAssetId = typeof source.assetId === "string" ? source.assetId.trim() : "";
+  const assetId = explicitAssetId || (id.startsWith("assets/") ? id : void 0);
+  const explicitOperationId = typeof source.operationId === "string" ? source.operationId.trim() : "";
+  const operationId = explicitOperationId || (source.type === "pending" || id.startsWith("job_") || id.startsWith("pending_") ? id : void 0);
+  const explicitNodeId = typeof source.nodeId === "string" ? source.nodeId.trim() : "";
+  const nodeId = explicitNodeId || (operationId ? `node:${operationId}` : assetId ? `node:${assetId}` : `node:${id}`);
+  return {
+    ...source,
+    id,
+    nodeId,
+    ...assetId ? { assetId } : {},
+    ...operationId ? { operationId } : {}
+  };
+}
+function normalizeCanvasLayoutItems(value) {
+  if (!Array.isArray(value)) return [];
+  const items = [];
+  const nodeIds = /* @__PURE__ */ new Set();
+  const assetIds = /* @__PURE__ */ new Set();
+  for (const valueItem of value) {
+    const item = normalizeCanvasLayoutItem(valueItem);
+    if (!item) continue;
+    const nodeId = String(item.nodeId);
+    const assetId = typeof item.assetId === "string" ? item.assetId : void 0;
+    if (nodeIds.has(nodeId) || assetId && assetIds.has(assetId)) continue;
+    nodeIds.add(nodeId);
+    if (assetId) assetIds.add(assetId);
+    items.push(item);
+  }
+  return items;
+}
+function normalizeCanvasLayout(value) {
+  const source = value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  const revision = Number.isInteger(source.revision) && Number(source.revision) >= 0 ? Number(source.revision) : 0;
+  return {
+    version: CANVAS_LAYOUT_VERSION,
+    revision,
+    items: normalizeCanvasLayoutItems(source.items)
+  };
+}
+async function withLayoutLock(layoutPath, action) {
+  const key = path19.resolve(layoutPath).toLowerCase();
+  const previous = layoutLocks.get(key) ?? Promise.resolve();
+  let release;
+  const gate = new Promise((resolve) => {
+    release = resolve;
+  });
+  const queued = previous.then(() => gate);
+  layoutLocks.set(key, queued);
+  await previous;
+  try {
+    return await action();
+  } finally {
+    release?.();
+    if (layoutLocks.get(key) === queued) layoutLocks.delete(key);
+  }
+}
+var CanvasLayoutStore = class {
+  constructor(workspaceDir) {
+    this.workspaceDir = path19.resolve(workspaceDir);
+    this.layoutPath = path19.join(this.workspaceDir, ".evomeme", "canvas", "layout.json");
+  }
+  async load() {
+    return withLayoutLock(this.layoutPath, async () => {
+      const raw = await this.readUnlocked();
+      const normalized = normalizeCanvasLayout(raw);
+      if (JSON.stringify(raw) !== JSON.stringify(normalized)) {
+        const migrated = {
+          ...normalized,
+          revision: Number(normalized.revision ?? 0) + 1
+        };
+        await this.writeUnlocked(migrated);
+        return migrated;
+      }
+      return normalized;
+    });
+  }
+  async replace(layout, expectedRevision) {
+    return withLayoutLock(this.layoutPath, async () => {
+      const current = normalizeCanvasLayout(await this.readUnlocked());
+      if (expectedRevision !== void 0 && Number.isInteger(expectedRevision) && expectedRevision !== Number(current.revision ?? 0)) {
+        throw new CanvasLayoutRevisionConflictError(
+          expectedRevision,
+          Number(current.revision ?? 0)
+        );
+      }
+      const normalized = normalizeCanvasLayout(layout);
+      const next = {
+        ...normalized,
+        version: CANVAS_LAYOUT_VERSION,
+        revision: Number(current.revision ?? 0) + 1
+      };
+      await this.writeUnlocked(next);
+      return next;
+    });
+  }
+  async mutate(mutateItems) {
+    return withLayoutLock(this.layoutPath, async () => {
+      const raw = await this.readUnlocked();
+      const current = normalizeCanvasLayout(raw);
+      const draft = JSON.parse(JSON.stringify(current.items));
+      const result = await mutateItems(draft);
+      const items = normalizeCanvasLayoutItems(result ?? draft);
+      const normalizedRaw = normalizeCanvasLayout(raw);
+      if (JSON.stringify(items) === JSON.stringify(current.items) && JSON.stringify(raw) === JSON.stringify(normalizedRaw)) {
+        return current;
+      }
+      const next = {
+        version: CANVAS_LAYOUT_VERSION,
+        revision: Number(current.revision ?? 0) + 1,
+        items
+      };
+      await this.writeUnlocked(next);
+      return next;
+    });
+  }
+  async readUnlocked() {
+    try {
+      return JSON.parse(await readFile2(this.layoutPath, "utf8"));
+    } catch {
+      return { version: CANVAS_LAYOUT_VERSION, revision: 0, items: [] };
+    }
+  }
+  async writeUnlocked(layout) {
+    await mkdir5(path19.dirname(this.layoutPath), { recursive: true });
+    const temporaryPath = `${this.layoutPath}.${process.pid}.${randomUUID2()}.tmp`;
+    await writeFile2(temporaryPath, JSON.stringify(layout, null, 2), "utf8");
+    await rename2(temporaryPath, this.layoutPath);
+  }
+};
+
+// src/canvas/workspace.ts
 var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
   ".png",
   ".jpg",
@@ -21542,31 +21713,31 @@ var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 ]);
 var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".webm", ".mov", ".m4v"]);
 function resolveCanvasWorkspace(workspaceDir) {
-  return path19.resolve(workspaceDir?.trim() || process.cwd());
+  return path20.resolve(workspaceDir?.trim() || process.cwd());
 }
 function canvasWorkspacePaths(workspaceDir) {
   const workspace = resolveCanvasWorkspace(workspaceDir);
-  const canvasDir = path19.join(workspace, ".evomeme", "canvas");
+  const canvasDir = path20.join(workspace, ".evomeme", "canvas");
   return {
     workspaceDir: workspace,
-    assetsDir: path19.join(workspace, "assets"),
+    assetsDir: path20.join(workspace, "assets"),
     canvasDir,
-    layoutPath: path19.join(canvasDir, "layout.json"),
-    jobsDir: path19.join(canvasDir, "jobs"),
-    provenanceDir: path19.join(canvasDir, "provenance")
+    layoutPath: path20.join(canvasDir, "layout.json"),
+    jobsDir: path20.join(canvasDir, "jobs"),
+    provenanceDir: path20.join(canvasDir, "provenance")
   };
 }
 async function ensureCanvasWorkspace(workspaceDir) {
   const paths = canvasWorkspacePaths(workspaceDir);
   await Promise.all([
-    mkdir5(paths.assetsDir, { recursive: true }),
-    mkdir5(paths.jobsDir, { recursive: true }),
-    mkdir5(paths.provenanceDir, { recursive: true })
+    mkdir6(paths.assetsDir, { recursive: true }),
+    mkdir6(paths.jobsDir, { recursive: true }),
+    mkdir6(paths.provenanceDir, { recursive: true })
   ]);
   return paths;
 }
 function createCanvasOperationId() {
-  return `job_${randomUUID2().replace(/-/g, "")}`;
+  return `job_${randomUUID3().replace(/-/g, "")}`;
 }
 function assetIdFromRelativePath(relativePath) {
   return `assets/${normalizeRelativePath(relativePath)}`;
@@ -21581,7 +21752,7 @@ function relativePathFromAssetId(assetId) {
 function resolveAssetPath(workspaceDir, assetId) {
   const paths = canvasWorkspacePaths(workspaceDir);
   const relative = relativePathFromAssetId(assetId);
-  const full = path19.resolve(paths.assetsDir, ...relative.split("/"));
+  const full = path20.resolve(paths.assetsDir, ...relative.split("/"));
   if (!pathContained(paths.assetsDir, full)) {
     throw new Error(`非法素材路径：${assetId}`);
   }
@@ -21598,9 +21769,15 @@ async function scanCanvasAssets(workspaceDir) {
 async function beginCanvasJob(input) {
   const paths = await ensureCanvasWorkspace(input.workspaceDir);
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const operationId = input.operationId || createCanvasOperationId();
+  const existingLayout = await new CanvasLayoutStore(paths.workspaceDir).load();
+  const existingNode = existingLayout.items.find(
+    (item) => item.operationId === operationId || item.id === operationId
+  );
   const job = {
     version: 1,
-    operationId: input.operationId || createCanvasOperationId(),
+    operationId,
+    nodeId: input.nodeId || existingNode?.nodeId || createCanvasNodeId(),
     kind: input.kind,
     status: "SUBMITTING",
     workspaceDir: paths.workspaceDir,
@@ -21612,13 +21789,12 @@ async function beginCanvasJob(input) {
     referenceImageUrls: input.referenceImageUrls,
     parentAssetIds: [...new Set(input.parentAssetIds ?? [])],
     outputKind: input.outputKind,
-    presentation: input.presentation ?? "assets",
-    outputLayoutId: input.outputLayoutId,
     metadata: input.metadata,
     createdAt: now,
     updatedAt: now
   };
   await writeJob(paths, job);
+  if (!existingNode) await reconcileCanvasLayout(paths.workspaceDir);
   return job;
 }
 async function updateCanvasJob(workspaceDir, operationId, patch) {
@@ -21643,15 +21819,24 @@ async function updateCanvasJob(workspaceDir, operationId, patch) {
 }
 async function readCanvasJob(workspaceDir, operationId) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  return readJson(jobPath(paths, operationId));
+  const job = await readJson(jobPath(paths, operationId));
+  return normalizeCanvasJob(job);
 }
 async function readCanvasJobs(workspaceDir) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
   const names = await readdir(paths.jobsDir).catch(() => []);
   const jobs = await Promise.all(
-    names.filter((name) => name.endsWith(".json")).map((name) => readJson(path19.join(paths.jobsDir, name)))
+    names.filter((name) => name.endsWith(".json")).map((name) => readJson(path20.join(paths.jobsDir, name)))
   );
-  return jobs.filter((job) => Boolean(job?.operationId)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  return jobs.map(normalizeCanvasJob).filter((job) => Boolean(job)).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+function normalizeCanvasJob(job) {
+  if (!job?.operationId) return void 0;
+  return {
+    ...job,
+    nodeId: job.nodeId || `node:${job.operationId}`,
+    parentAssetIds: Array.isArray(job.parentAssetIds) ? job.parentAssetIds : []
+  };
 }
 async function completeCanvasJob(input) {
   const paths = await ensureCanvasWorkspace(input.workspaceDir);
@@ -21665,16 +21850,17 @@ async function completeCanvasJob(input) {
   }] : [];
   if (!outputs.length) throw new Error("操作完成但没有产物");
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const metadata = input.metadata ?? current.metadata;
   const outputAssetIds = [];
   const outputLocalPaths = [];
   for (const output of outputs) {
-    const full = path19.resolve(output.localPath);
+    const full = path20.resolve(output.localPath);
     if (!pathContained(paths.assetsDir, full)) {
       throw new Error(`操作产物不在 assets 目录：${full}`);
     }
-    const relativePath = normalizeRelativePath(path19.relative(paths.assetsDir, full));
+    const relativePath = normalizeRelativePath(path20.relative(paths.assetsDir, full));
     const assetId = assetIdFromRelativePath(relativePath);
-    const kind = output.kind ?? kindFromExtension(path19.extname(full)) ?? current.outputKind ?? "image";
+    const kind = output.kind ?? kindFromExtension(path20.extname(full)) ?? current.outputKind ?? "image";
     await writeAssetProvenance(paths.workspaceDir, {
       version: 1,
       assetId,
@@ -21689,6 +21875,7 @@ async function completeCanvasJob(input) {
       imageType: current.imageType,
       size: current.size,
       assetUrl: output.assetUrl ?? (outputs.length === 1 ? input.assetUrl : void 0),
+      metadata,
       parents: buildParents(current),
       createdAt: now,
       updatedAt: now
@@ -21696,7 +21883,7 @@ async function completeCanvasJob(input) {
     outputAssetIds.push(assetId);
     outputLocalPaths.push(full);
   }
-  return updateCanvasJob(paths.workspaceDir, current.operationId, {
+  const completed = await updateCanvasJob(paths.workspaceDir, current.operationId, {
     status: "SUCCEEDED",
     jobId: input.jobId ?? current.jobId,
     assetUrl: input.assetUrl,
@@ -21704,15 +21891,16 @@ async function completeCanvasJob(input) {
     outputLocalPath: outputLocalPaths[0],
     outputAssetIds,
     outputLocalPaths,
-    presentation: input.presentation ?? current.presentation ?? "assets",
-    outputLayoutId: input.outputLayoutId ?? current.outputLayoutId,
-    metadata: input.metadata ?? current.metadata,
+    metadata,
     error: void 0
   });
+  await reconcileCanvasLayout(paths.workspaceDir);
+  return completed;
 }
 async function failCanvasJob(workspaceDir, operationId, error2) {
   const detail = error2 instanceof Error ? error2.message : String(error2);
   await updateCanvasJob(workspaceDir, operationId, { status: "FAILED", error: detail });
+  await reconcileCanvasLayout(workspaceDir);
 }
 async function hideCanvasJob(workspaceDir, operationId) {
   await updateCanvasJob(workspaceDir, operationId, { hidden: true });
@@ -21740,7 +21928,7 @@ async function recordUploadedAsset(workspaceDir, assetId, assetUrl) {
     version: 1,
     assetId,
     relativePath: relativePathFromAssetId(assetId),
-    kind: existing?.kind ?? kindFromExtension(path19.extname(assetId)) ?? "image",
+    kind: existing?.kind ?? kindFromExtension(path20.extname(assetId)) ?? "image",
     source: existing?.source ?? "uploaded",
     operation: existing?.operation ?? "upload",
     operationId: existing?.operationId,
@@ -21750,6 +21938,7 @@ async function recordUploadedAsset(workspaceDir, assetId, assetUrl) {
     imageType: existing?.imageType,
     size: existing?.size,
     assetUrl,
+    metadata: existing?.metadata,
     parents: existing?.parents ?? [],
     createdAt: existing?.createdAt ?? now,
     updatedAt: now
@@ -21764,167 +21953,189 @@ async function recordCopiedAsset(workspaceDir, sourceAssetId, outputAssetId) {
     version: 1,
     assetId: outputAssetId,
     relativePath: relativePathFromAssetId(outputAssetId),
-    kind: source?.kind ?? kindFromExtension(path19.extname(outputAssetId)) ?? "image",
+    kind: source?.kind ?? kindFromExtension(path20.extname(outputAssetId)) ?? "image",
     source: "copied",
     operation: "copy",
+    metadata: source?.metadata,
     parents: [{ assetId: sourceAssetId, role: "source" }],
     createdAt: now,
     updatedAt: now
   });
 }
-async function loadCanvasLayout(workspaceDir) {
+async function saveCanvasLayout(workspaceDir, layout, expectedRevision) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const raw = await readJson(paths.layoutPath) ?? { items: [] };
-  return { items: Array.isArray(raw.items) ? raw.items : [] };
+  return new CanvasLayoutStore(paths.workspaceDir).replace(layout, expectedRevision);
 }
-async function saveCanvasLayout(workspaceDir, layout) {
+async function mutateCanvasLayout(workspaceDir, mutateItems) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  await atomicWriteJson(paths.layoutPath, {
-    items: Array.isArray(layout.items) ? layout.items : []
-  });
+  return new CanvasLayoutStore(paths.workspaceDir).mutate(mutateItems);
+}
+function automaticFramePreview(job) {
+  if (job.kind !== "video_frame_extract" && job.kind !== "frame_sheet_edit" || job.metadata?.kind !== "frame_sheet") return void 0;
+  const rows = Math.round(Number(job.metadata.rows));
+  const columns = Math.round(Number(job.metadata.columns));
+  const frameCount = Math.round(Number(job.metadata.frameCount));
+  const fps = Number(job.metadata.fps);
+  if (!Number.isFinite(rows) || !Number.isFinite(columns) || !Number.isFinite(frameCount) || !Number.isFinite(fps) || rows < 1 || columns < 1 || frameCount < 1 || frameCount > rows * columns || fps <= 0) {
+    return void 0;
+  }
+  return { enabled: true, rows, columns, frameCount, fps };
+}
+function completedGenerationMeta(job) {
+  if (job.kind === "generate_game_image") {
+    return {
+      kind: "image",
+      prompt: job.prompt ?? "",
+      model: job.imageModel ?? "",
+      size: job.size ?? "",
+      references: job.parentAssetIds.map((id) => ({ id })),
+      createdAt: job.createdAt
+    };
+  }
+  if (job.kind === "generate_game_video") {
+    return {
+      kind: "video",
+      prompt: job.prompt ?? "",
+      model: job.imageModel ?? "",
+      ratio: String(job.metadata?.ratio ?? ""),
+      duration: job.metadata?.duration ?? null,
+      resolution: String(job.metadata?.resolution ?? ""),
+      generateAudio: job.metadata?.generateAudio === true,
+      seed: job.metadata?.seed ?? null,
+      references: Array.isArray(job.metadata?.references) ? job.metadata.references : job.parentAssetIds.map((id) => ({ id })),
+      createdAt: job.createdAt
+    };
+  }
+  return void 0;
 }
 async function reconcileCanvasLayout(workspaceDir, scannedAssets) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const [assets, jobs, layout] = await Promise.all([
+  const [assets, jobs] = await Promise.all([
     scannedAssets ?? scanCanvasAssets(paths.workspaceDir),
-    readCanvasJobs(paths.workspaceDir),
-    loadCanvasLayout(paths.workspaceDir)
+    readCanvasJobs(paths.workspaceDir)
   ]);
   const assetIds = new Set(assets.map((asset) => asset.id));
   const assetKinds = new Map(assets.map((asset) => [asset.id, asset.kind]));
-  let items = layout.items.filter((item) => {
-    if (!item?.id) return false;
-    if (item.id.startsWith("assets/")) return assetIds.has(item.id);
-    return true;
-  });
-  const sequenceFrameIds = new Set(
-    items.filter((item) => item.type === "sequence" && Array.isArray(item.frames)).flatMap((item) => item.frames.map(String)).filter((id) => assetIds.has(id))
-  );
-  items = items.filter(
-    (item) => item.type === "sequence" || !sequenceFrameIds.has(item.id)
-  );
-  for (const job of jobs) {
-    const index = items.findIndex((item) => item.id === job.operationId);
-    if (job.status === "SUCCEEDED") {
-      const outputIds = (job.outputAssetIds?.length ? job.outputAssetIds : [job.outputAssetId]).filter((id) => Boolean(id && assetIds.has(id)));
-      const previous = index >= 0 ? items[index] : void 0;
-      if (index >= 0) items.splice(index, 1);
-      if (job.kind === "decompose_image_layers" && outputIds.length) {
-        const existingOutputs = outputIds.map((assetId) => items.find((item) => item.id === assetId)).filter((item) => Boolean(item));
-        const alreadyPositioned = existingOutputs.length === outputIds.length && existingOutputs.every((item) => layerGroupId(item) === job.operationId);
-        if (alreadyPositioned) continue;
-        const placementJob = await withDecomposedLayerDimensions(job);
-        const layerItems = buildDecomposedLayerItems(
-          placementJob,
-          outputIds,
-          previous,
-          existingOutputs,
-          items.length
-        );
-        items = items.filter((item) => !outputIds.includes(item.id));
-        items.push(...layerItems);
-      } else if (job.presentation === "sequence" && outputIds.length) {
-        const sequenceId = job.outputLayoutId || `sequence_${job.operationId}`;
-        const existingSequence = items.findIndex((item) => item.id === sequenceId);
-        if (existingSequence >= 0) {
-          const existingFrames = sequenceFrames(items[existingSequence], assetIds);
-          sequenceFrameIdsFor(existingFrames, sequenceFrameIds);
-          items = items.filter(
-            (item) => item.type === "sequence" || !existingFrames.includes(item.id)
+  const store = new CanvasLayoutStore(paths.workspaceDir);
+  return store.mutate(async (currentItems) => {
+    let items = currentItems.filter((item) => {
+      if (!item?.id || item.type === "sequence") return false;
+      const assetId = layoutItemAssetId(item);
+      return !assetId || assetIds.has(assetId);
+    });
+    for (const job of jobs) {
+      const pendingIndex = items.findIndex(
+        (item) => item.type === "pending" && (item.operationId === job.operationId || item.id === job.operationId)
+      );
+      const previous = pendingIndex >= 0 ? items[pendingIndex] : void 0;
+      if (job.status === "SUCCEEDED") {
+        const outputIds = (job.outputAssetIds?.length ? job.outputAssetIds : [job.outputAssetId]).filter((id) => Boolean(id && assetIds.has(id)));
+        const existingOutputs = outputIds.map((assetId) => items.find((item) => layoutItemAssetId(item) === assetId)).filter((item) => Boolean(item));
+        if (pendingIndex >= 0) items.splice(pendingIndex, 1);
+        if (!outputIds.length) continue;
+        const alreadyCompleted = !previous && existingOutputs.length === outputIds.length && existingOutputs.every((item) => item.operationId === job.operationId);
+        if (alreadyCompleted) continue;
+        if (job.kind === "decompose_image_layers") {
+          const alreadyPositioned = !previous && existingOutputs.length === outputIds.length && existingOutputs.every((item) => layerGroupId(item) === job.operationId);
+          if (alreadyPositioned) continue;
+          const placementJob = await withDecomposedLayerDimensions(job);
+          const layerItems = buildDecomposedLayerItems(
+            placementJob,
+            outputIds,
+            previous,
+            existingOutputs,
+            items.length
           );
+          items = items.filter((item) => {
+            const assetId = layoutItemAssetId(item);
+            return !assetId || !outputIds.includes(assetId);
+          });
+          items.push(...layerItems);
           continue;
         }
-        if (outputIds.some((assetId) => sequenceFrameIds.has(assetId))) {
-          continue;
-        }
-        sequenceFrameIdsFor(outputIds, sequenceFrameIds);
-        items = items.filter((item) => item.type === "sequence" || !outputIds.includes(item.id));
-        const sequence = {
-          id: sequenceId,
-          type: "sequence",
-          name: String(job.metadata?.name || "视频序列帧"),
-          x: previous?.x,
-          y: previous?.y,
-          width: previous?.width ?? 220,
-          height: previous?.height ?? null,
-          frames: outputIds,
-          fps: Number(job.metadata?.fps) || Math.min(24, Math.max(1, outputIds.length)),
-          loop: job.metadata?.loop !== false,
-          sourceId: job.parentAssetIds[0],
-          origin: {
-            kind: "video_sequence",
-            parentId: job.parentAssetIds[0],
-            frameCount: outputIds.length
-          }
-        };
-        items.push(withAutoPosition(sequence, items.length));
-      } else if (outputIds.length) {
-        const base = previous ?? withAutoPosition({ id: job.operationId, width: 220 }, items.length);
+        const base = previous ?? existingOutputs[0] ?? withAutoPosition({
+          id: job.operationId,
+          nodeId: job.nodeId,
+          operationId: job.operationId,
+          width: 220
+        }, items.length);
         const columns = Math.min(4, outputIds.length);
+        const framePreview = automaticFramePreview(job);
+        const gen = completedGenerationMeta(job);
+        items = items.filter((item) => {
+          const assetId = layoutItemAssetId(item);
+          return !assetId || !outputIds.includes(assetId);
+        });
         outputIds.forEach((assetId, outputIndex) => {
-          if (sequenceFrameIds.has(assetId)) return;
-          if (items.some((item) => item.id === assetId)) return;
+          const existing = existingOutputs.find(
+            (item) => layoutItemAssetId(item) === assetId
+          );
           const col = outputIndex % columns;
           const row = Math.floor(outputIndex / columns);
           items.push({
             id: assetId,
+            nodeId: outputIndex === 0 ? job.nodeId : existing?.nodeId || `node:${job.operationId}:${outputIndex}`,
+            assetId,
+            operationId: job.operationId,
             ...assetKinds.get(assetId) === "video" ? { type: "video" } : {},
-            x: Number(base.x ?? 80) + col * (Number(base.width ?? 220) + 40),
-            y: Number(base.y ?? 80) + row * (Number(base.height ?? 220) + 80),
-            width: base.width ?? 220,
-            height: base.height ?? null
+            x: outputIndex === 0 ? Number(base.x ?? 80) : Number(existing?.x ?? base.x ?? 80) + col * (Number(base.width ?? 220) + 40),
+            y: outputIndex === 0 ? Number(base.y ?? 80) : Number(existing?.y ?? base.y ?? 80) + row * (Number(base.height ?? 220) + 80),
+            width: outputIndex === 0 ? base.width ?? 220 : existing?.width ?? base.width ?? 220,
+            height: outputIndex === 0 ? base.height ?? null : existing?.height ?? base.height ?? null,
+            ...gen ? { gen } : {},
+            ...framePreview ? { framePreview } : {}
           });
         });
+        continue;
       }
-      continue;
-    }
-    if (job.status === "FAILED") {
-      if (index >= 0) items.splice(index, 1);
-      continue;
-    }
-    if (job.hidden) {
-      if (index >= 0) items.splice(index, 1);
-      continue;
+      if (job.status === "FAILED" || job.hidden) {
+        if (pendingIndex >= 0) items.splice(pendingIndex, 1);
+        continue;
+      }
+      const pending = {
+        id: job.operationId,
+        nodeId: job.nodeId,
+        operationId: job.operationId,
+        type: "pending",
+        name: job.metadata?.interactiveEdit === true ? "交互编辑生成中" : operationLabel(job.kind),
+        x: previous?.x,
+        y: previous?.y,
+        width: previous?.width ?? 220,
+        height: previous?.height,
+        prompt: job.prompt ?? "",
+        size: job.size ?? "",
+        model: job.imageModel ?? "",
+        media: job.outputKind ?? (job.kind === "generate_game_video" || job.kind === "video_cycle" ? "video" : "image"),
+        ratio: String(job.metadata?.ratio ?? ""),
+        error: job.error ?? null,
+        references: job.parentAssetIds.map((id) => ({
+          id,
+          role: parentRole(job.kind)
+        }))
+      };
+      if (pendingIndex >= 0) items[pendingIndex] = { ...previous, ...pending };
+      else items.push(withAutoPosition(pending, items.length));
+    }
+    for (const asset of assets) {
+      if (items.some((item) => layoutItemAssetId(item) === asset.id)) continue;
+      items.push(withAutoPosition({
+        id: asset.id,
+        nodeId: `node:${asset.id}`,
+        assetId: asset.id,
+        ...asset.kind === "video" ? { type: "video" } : {},
+        width: asset.kind === "video" ? 280 : 220,
+        height: null
+      }, items.length));
     }
-    const pending = {
-      id: job.operationId,
-      type: "pending",
-      name: job.metadata?.interactiveEdit === true ? "交互编辑生成中" : operationLabel(job.kind),
-      x: index >= 0 ? items[index].x : void 0,
-      y: index >= 0 ? items[index].y : void 0,
-      width: index >= 0 ? items[index].width : 220,
-      height: index >= 0 ? items[index].height : void 0,
-      prompt: job.prompt ?? "",
-      size: job.size ?? "",
-      model: job.imageModel ?? "",
-      media: job.outputKind ?? (job.kind === "generate_game_video" || job.kind === "video_cycle" || job.kind === "video_trim" ? "video" : "image"),
-      ratio: String(job.metadata?.ratio ?? ""),
-      error: job.error ?? null,
-      references: job.parentAssetIds.map((id) => ({
-        id,
-        role: parentRole(job.kind)
-      }))
-    };
-    if (index >= 0) items[index] = { ...items[index], ...pending };
-    else items.push(withAutoPosition(pending, items.length));
-  }
-  for (const asset of assets) {
-    if (sequenceFrameIds.has(asset.id)) continue;
-    if (items.some((item2) => item2.id === asset.id)) continue;
-    const item = {
-      id: asset.id,
-      ...asset.kind === "video" ? { type: "video" } : {},
-      width: asset.kind === "video" ? 280 : 220,
-      height: null
-    };
-    items.push(withAutoPosition(item, items.length));
-  }
-  const reconciled = { items };
-  await saveCanvasLayout(paths.workspaceDir, reconciled);
-  return reconciled;
+    return items;
+  });
+}
+function layoutItemAssetId(item) {
+  if (typeof item.assetId === "string" && item.assetId) return item.assetId;
+  return item.id.startsWith("assets/") ? item.id : void 0;
 }
 async function walkAssets(root, relativeDir, output) {
-  const dir = path19.join(root, ...relativeDir.split("/").filter(Boolean));
+  const dir = path20.join(root, ...relativeDir.split("/").filter(Boolean));
   const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     const relativePath = normalizeRelativePath(
@@ -21935,9 +22146,9 @@ async function walkAssets(root, relativeDir, output) {
       continue;
     }
     if (!entry.isFile()) continue;
-    const kind = kindFromExtension(path19.extname(entry.name));
+    const kind = kindFromExtension(path20.extname(entry.name));
     if (!kind) continue;
-    const localPath = path19.join(root, ...relativePath.split("/"));
+    const localPath = path20.join(root, ...relativePath.split("/"));
     const info = await stat5(localPath);
     output.push({
       id: assetIdFromRelativePath(relativePath),
@@ -22037,6 +22248,9 @@ function buildDecomposedLayerItems(job, outputIds, previous, existingOutputs, au
     const isBase = metadata.zIndex === 0 || !bounds;
     return {
       id: assetId,
+      nodeId: metadata.zIndex === 0 ? job.nodeId : `node:${job.operationId}:${metadata.zIndex}`,
+      assetId,
+      operationId: job.operationId,
       name: metadata.name,
       x: isBase ? baseX : baseX + bounds.left * baseDisplayWidth,
       y: isBase ? baseY : baseY + bounds.top * baseDisplayHeight,
@@ -22115,18 +22329,11 @@ function operationLabel(kind) {
     cutout_game_image: "智能抠图中",
     smart_split: "智能切分中",
     manual_split: "手动切分中",
-    sequence_sheet: "序列拼图中",
-    video_frame_extract: "视频抽帧中",
-    video_cycle: "循环提取中",
-    video_trim: "视频裁剪中"
+    video_frame_extract: "视频序列帧图生成中",
+    frame_sheet_edit: "序列帧保存中",
+    video_cycle: "循环提取中"
   }[kind] ?? "处理中";
 }
-function sequenceFrameIdsFor(ids, target) {
-  for (const id of ids) target.add(id);
-}
-function sequenceFrames(item, assetIds) {
-  return Array.isArray(item.frames) ? item.frames.map(String).filter((id) => assetIds.has(id)) : [];
-}
 function withAutoPosition(item, index) {
   const col = index % 6;
   const row = Math.floor(index / 6);
@@ -22137,27 +22344,27 @@ function withAutoPosition(item, index) {
   };
 }
 function jobPath(paths, operationId) {
-  return path19.join(paths.jobsDir, `${safeRecordName(operationId)}.json`);
+  return path20.join(paths.jobsDir, `${safeRecordName(operationId)}.json`);
 }
 function provenancePath(paths, relativePath) {
   const digest = createHash("sha256").update(normalizeRelativePath(relativePath)).digest("hex");
-  return path19.join(paths.provenanceDir, `${digest}.json`);
+  return path20.join(paths.provenanceDir, `${digest}.json`);
 }
 async function writeJob(paths, job) {
   await atomicWriteJson(jobPath(paths, job.operationId), job);
 }
 async function readJson(filePath) {
   try {
-    return JSON.parse(await readFile2(filePath, "utf8"));
+    return JSON.parse(await readFile3(filePath, "utf8"));
   } catch {
     return void 0;
   }
 }
 async function atomicWriteJson(filePath, value) {
-  await mkdir5(path19.dirname(filePath), { recursive: true });
-  const tempPath = `${filePath}.${process.pid}.${randomUUID2()}.tmp`;
-  await writeFile2(tempPath, JSON.stringify(value, null, 2), "utf8");
-  await rename2(tempPath, filePath);
+  await mkdir6(path20.dirname(filePath), { recursive: true });
+  const tempPath = `${filePath}.${process.pid}.${randomUUID3()}.tmp`;
+  await writeFile3(tempPath, JSON.stringify(value, null, 2), "utf8");
+  await rename3(tempPath, filePath);
 }
 function kindFromExtension(extension) {
   const ext = extension.toLowerCase();
@@ -22177,9 +22384,9 @@ function safeRecordName(value) {
   return String(value || "").replace(/[^a-zA-Z0-9_.-]/g, "_").slice(0, 180);
 }
 function pathContained(base, target) {
-  const root = path19.resolve(base);
-  const full = path19.resolve(target);
-  const prefix = root.endsWith(path19.sep) ? root : `${root}${path19.sep}`;
+  const root = path20.resolve(base);
+  const full = path20.resolve(target);
+  const prefix = root.endsWith(path20.sep) ? root : `${root}${path20.sep}`;
   return full === root || full.startsWith(prefix);
 }
 
@@ -22261,7 +22468,11 @@ async function runWindowsPowerShell(script, extraEnv = {}) {
 
 // src/canvas/server.ts
 var MAX_JSON_BODY_BYTES = 80 * 1024 * 1024;
+var INTERACTIVE_EDIT_MIN_PIXELS = 921600;
+var INTERACTIVE_EDIT_MAX_PIXELS = 4624220;
 var TRANSPARENT_BACKGROUND_REFERENCE_ERROR = "透明背景图功能要求有且只有一个PNG格式参考图输入";
+var CANVAS_QUOTA_ERROR = "当前账号的生成额度已用完，请充值或补充额度后重试";
+var CANVAS_NETWORK_ERROR = "网络连接失败，请重试";
 var CANVAS_VENDOR_ASSETS = {
   "/vendor/painterro.min.js": {
     packageName: "painterro",
@@ -22305,7 +22516,7 @@ async function startCanvasServer(options = {}) {
     } catch (error2) {
       const status = statusFromError(error2);
       if (!response.headersSent) {
-        sendJson(response, status, { detail: errorMessage(error2) });
+        sendJson(response, status, { detail: canvasGenerationErrorMessage(error2) });
       } else {
         response.end();
       }
@@ -22379,7 +22590,9 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     const layout = await layoutWithProvenance(workspaceDir, assets);
     sendJson(response, 200, {
       images: assets.map(publicAsset),
-      items: layout.items
+      items: layout.items,
+      version: layout.version,
+      revision: layout.revision
     });
     return;
   }
@@ -22391,8 +22604,13 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
   if (request.method === "PUT" && pathname === "/api/layout") {
     const body = await readJsonBody(request);
     const layout = { items: sanitizeLayoutItems(body.items) };
-    await saveCanvasLayout(workspaceDir, layout);
-    sendJson(response, 200, layout);
+    const revision = Number(body.revision);
+    const saved = await saveCanvasLayout(
+      workspaceDir,
+      layout,
+      Number.isInteger(revision) && revision >= 0 ? revision : void 0
+    );
+    sendJson(response, 200, saved);
     return;
   }
   if (request.method === "GET" && pathname === "/api/provenance") {
@@ -22413,7 +22631,7 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     }
     if (interactiveEditSourceId) {
       const sourcePath = resolveAssetPath(workspaceDir, interactiveEditSourceId);
-      if (mediaKind(path20.extname(sourcePath)) !== "image") {
+      if (mediaKind(path21.extname(sourcePath)) !== "image") {
         throw httpError(400, "交互编辑来源必须是图片");
       }
     }
@@ -22446,7 +22664,7 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     }
     if (smartSplitSourceId) {
       const sourcePath = resolveAssetPath(workspaceDir, smartSplitSourceId);
-      if (mediaKind(path20.extname(sourcePath)) !== "image") {
+      if (mediaKind(path21.extname(sourcePath)) !== "image") {
         throw httpError(400, "智能切分来源必须是图片");
       }
     }
@@ -22487,10 +22705,9 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     const filePaths = ids.map((assetId) => resolveAssetPath(workspaceDir, assetId));
     await Promise.all(filePaths.map(async (filePath) => {
       const info = await stat6(filePath).catch(() => void 0);
-      if (!info?.isFile()) throw httpError(404, `素材文件不存在：${path20.basename(filePath)}`);
+      if (!info?.isFile()) throw httpError(404, `素材文件不存在：${path21.basename(filePath)}`);
     }));
-    const sequence = normalizeClipboardSequence(body.sequence, ids.length);
-    await fileClipboard.writeFiles(filePaths, sequence);
+    await fileClipboard.writeFiles(filePaths);
     sendJson(response, 200, { count: filePaths.length });
     return;
   }
@@ -22498,10 +22715,8 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     const clipboard = await fileClipboard.readFiles();
     const pasted = await importClipboardFiles(workspaceDir, clipboard.filePaths);
     if (!pasted.length) throw httpError(400, "剪贴板中没有支持的图片或视频文件");
-    const sequence = normalizeClipboardSequence(clipboard.metadata, pasted.length);
     sendJson(response, 200, {
-      assets: pasted.map(publicAsset),
-      ...sequence && pasted.every((asset) => asset.kind === "image") ? { sequence } : {}
+      assets: pasted.map(publicAsset)
     });
     return;
   }
@@ -22529,26 +22744,20 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     sendJson(response, 200, result);
     return;
   }
-  if (request.method === "POST" && pathname === "/api/video-trim") {
+  if (request.method === "POST" && pathname === "/api/video-frames") {
     const body = await readJsonBody(request);
-    const result = await trimVideoAsset(
+    const result = await extractVideoAssetFrames(
       workspaceDir,
       String(body.id || ""),
-      Number(body.start),
-      Number(body.end),
+      Math.round(Number(body.count) || 0),
       String(body.client_operation_id || "")
     );
     sendJson(response, 200, result);
     return;
   }
-  if (request.method === "POST" && pathname === "/api/video-frames") {
+  if (request.method === "POST" && pathname === "/api/frame-sheet/edit") {
     const body = await readJsonBody(request);
-    const result = await extractVideoAssetFrames(
-      workspaceDir,
-      String(body.id || ""),
-      Math.round(Number(body.count) || 0),
-      String(body.client_operation_id || "")
-    );
+    const result = await editFrameSheetAsset(workspaceDir, body);
     sendJson(response, 200, result);
     return;
   }
@@ -22570,12 +22779,6 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
     sendJson(response, 200, result);
     return;
   }
-  if (request.method === "POST" && pathname === "/api/sequence-sheet") {
-    const body = await readJsonBody(request);
-    const result = await composeSequenceAsset(workspaceDir, body);
-    sendJson(response, 200, result);
-    return;
-  }
   if (request.method === "POST" && pathname === "/api/generate-video") {
     const body = await readJsonBody(request);
     const result = await generateVideoFromCanvas(workspaceDir, body, videoGenerationDeps);
@@ -22587,7 +22790,7 @@ async function handleApi(request, response, url, workspaceDir, eventHub, videoGe
 async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
   const prompt = String(body.prompt || "").trim();
   if (!prompt) throw httpError(400, "prompt 不能为空");
-  const operationId = String(body.client_operation_id || `job_${randomUUID3().replace(/-/g, "")}`);
+  const operationId = String(body.client_operation_id || `job_${randomUUID4().replace(/-/g, "")}`);
   const referenceIds = Array.isArray(body.reference_ids) ? body.reference_ids.map(String).filter(Boolean) : [];
   if (referenceIds.length > 14) throw httpError(400, "最多支持 14 张参考图");
   const interactiveReferenceData = String(body.reference_image_data || "").trim();
@@ -22605,7 +22808,7 @@ async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
     if (imageModel !== "asset-pro") {
       throw httpError(400, "透明背景仅支持 asset-pro 模型");
     }
-    if (referenceIds.length !== 1 || path20.extname(resolveAssetPath(workspaceDir, referenceIds[0])).toLowerCase() !== ".png") {
+    if (referenceIds.length !== 1 || path21.extname(resolveAssetPath(workspaceDir, referenceIds[0])).toLowerCase() !== ".png") {
       throw httpError(400, TRANSPARENT_BACKGROUND_REFERENCE_ERROR);
     }
   }
@@ -22626,8 +22829,8 @@ async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
   }
   const interactiveReference = interactiveReferenceData ? await uploadInteractiveReference(workspaceDir, interactiveReferenceData, imageServiceDeps) : void 0;
   const referenceImageUrls = interactiveReference ? [interactiveReference.assetUrl] : referenceIds.length ? await Promise.all(referenceIds.map((assetId) => ensureReferenceAssetUrl(workspaceDir, assetId))) : void 0;
-  const background = interactiveReference ? path20.extname(resolveAssetPath(workspaceDir, referenceIds[0])).toLowerCase() === ".png" && interactiveReference.isPng && interactiveReference.hasTransparentPixel ? "transparent" : "opaque" : requestedBackground;
-  const operationSize = layerDecomposition || interactiveReferenceData ? "auto" : size;
+  const background = interactiveReference ? path21.extname(resolveAssetPath(workspaceDir, referenceIds[0])).toLowerCase() === ".png" && interactiveReference.isPng && interactiveReference.hasTransparentPixel ? "transparent" : "opaque" : requestedBackground;
+  const operationSize = layerDecomposition ? "auto" : interactiveReference ? resolveInteractiveEditSize(interactiveReference.width, interactiveReference.height) : size;
   const canvasJob = await beginCanvasJob({
     operationId,
     workspaceDir,
@@ -22714,7 +22917,7 @@ async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
       return {
         images: outputIds.map((id, index) => ({
           id,
-          name: decomposed.layers[index].name || path20.basename(completed2.outputLocalPaths[index]),
+          name: decomposed.layers[index].name || path21.basename(completed2.outputLocalPaths[index]),
           url: `/files/${id}`,
           asset_url: decomposed.layers[index].assetUrl,
           z_index: decomposed.layers[index].zIndex,
@@ -22768,7 +22971,7 @@ async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
     }
     return {
       id: completed.outputAssetId,
-      name: path20.basename(completed.outputLocalPath),
+      name: path21.basename(completed.outputLocalPath),
       url: `/files/${completed.outputAssetId}`,
       size: operationSize,
       model: imageModel,
@@ -22778,15 +22981,16 @@ async function generateFromCanvas(workspaceDir, body, imageServiceDeps) {
       tos_url: generated.assetUrl
     };
   } catch (error2) {
-    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, error2).catch(() => void 0);
-    throw error2;
+    const normalized = normalizeCanvasGenerationError(error2);
+    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, normalized).catch(() => void 0);
+    throw normalized;
   }
 }
 async function generateVideoFromCanvas(workspaceDir, body, videoGenerationDeps) {
   const prompt = String(body.prompt || "").trim();
   if (!prompt) throw httpError(400, "prompt 不能为空");
   const operationId = String(
-    body.client_operation_id || `job_${randomUUID3().replace(/-/g, "")}`
+    body.client_operation_id || `job_${randomUUID4().replace(/-/g, "")}`
   );
   const videoModel = String(body.model || GAME_VIDEO_MODELS[0]);
   const ratio = String(body.ratio || "16:9");
@@ -22825,7 +23029,7 @@ async function generateVideoFromCanvas(workspaceDir, body, videoGenerationDeps)
       throw httpError(400, `不支持的引用类型：${type}`);
     }
     const sourcePath = resolveAssetPath(workspaceDir, assetId);
-    const actualKind = mediaKind(path20.extname(sourcePath));
+    const actualKind = mediaKind(path21.extname(sourcePath));
     if (actualKind !== type) {
       throw httpError(400, `引用类型与文件不匹配：${assetId}`);
     }
@@ -22910,7 +23114,7 @@ async function generateVideoFromCanvas(workspaceDir, body, videoGenerationDeps)
     }
     return {
       id: completed.outputAssetId,
-      name: path20.basename(completed.outputLocalPath),
+      name: path21.basename(completed.outputLocalPath),
       kind: "video",
       url: `/files/${completed.outputAssetId}`,
       job_id: generated.jobId,
@@ -22925,19 +23129,20 @@ async function generateVideoFromCanvas(workspaceDir, body, videoGenerationDeps)
       reference_ids: parentAssetIds
     };
   } catch (error2) {
-    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, error2).catch(() => void 0);
-    throw error2;
+    const normalized = normalizeCanvasGenerationError(error2);
+    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, normalized).catch(() => void 0);
+    throw normalized;
   }
 }
 async function cutoutFromCanvas(workspaceDir, body) {
   const sourceAssetId = String(body.id || "").trim();
   if (!sourceAssetId) throw httpError(400, "id 不能为空");
   const sourcePath = resolveAssetPath(workspaceDir, sourceAssetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "image") {
+  if (mediaKind(path21.extname(sourcePath)) !== "image") {
     throw httpError(400, "仅支持对图片进行抠图");
   }
   const operationId = String(
-    body.client_operation_id || `job_${randomUUID3().replace(/-/g, "")}`
+    body.client_operation_id || `job_${randomUUID4().replace(/-/g, "")}`
   );
   const sourceUrl = await ensureReferenceAssetUrl(workspaceDir, sourceAssetId);
   const canvasJob = await beginCanvasJob({
@@ -22978,15 +23183,16 @@ async function cutoutFromCanvas(workspaceDir, body) {
     }
     return {
       id: completed.outputAssetId,
-      name: path20.basename(completed.outputLocalPath),
+      name: path21.basename(completed.outputLocalPath),
       url: `/files/${completed.outputAssetId}`,
       source_id: sourceAssetId,
       job_id: result.jobId,
       tos_url: result.assetUrl
     };
   } catch (error2) {
-    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, error2).catch(() => void 0);
-    throw error2;
+    const normalized = normalizeCanvasGenerationError(error2);
+    await failCanvasJob(canvasJob.workspaceDir, canvasJob.operationId, normalized).catch(() => void 0);
+    throw normalized;
   }
 }
 async function ensureReferenceAssetUrl(workspaceDir, assetId) {
@@ -23004,11 +23210,12 @@ async function uploadInteractiveReference(workspaceDir, dataUrl, imageServiceDep
   if (!bytes.length) throw httpError(400, "交互编辑图片数据为空");
   const extension = match[1].toLowerCase() === "jpeg" ? "jpg" : match[1].toLowerCase();
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const tempDir = path20.join(paths.canvasDir, "interactive-references");
-  await mkdir6(tempDir, { recursive: true });
-  const localPath = path20.join(tempDir, `${randomUUID3()}.${extension}`);
-  await writeFile3(localPath, bytes);
+  const tempDir = path21.join(paths.canvasDir, "interactive-references");
+  await mkdir7(tempDir, { recursive: true });
+  const localPath = path21.join(tempDir, `${randomUUID4()}.${extension}`);
+  await writeFile4(localPath, bytes);
   try {
+    const dimensions = await probeImageDimensions(localPath);
     const uploaded = await uploadImageAsset(
       localPath,
       { folder: "canvas-interactive-edit" },
@@ -23018,109 +23225,261 @@ async function uploadInteractiveReference(workspaceDir, dataUrl, imageServiceDep
     return {
       assetUrl: uploaded.assetUrl,
       isPng,
-      hasTransparentPixel: isPng && pngHasTransparentPixel(bytes)
+      hasTransparentPixel: isPng && pngHasTransparentPixel(bytes),
+      width: dimensions.width,
+      height: dimensions.height
     };
   } finally {
     await unlink(localPath).catch(() => void 0);
   }
 }
-async function trimVideoAsset(workspaceDir, assetId, start, end, requestedOperationId = "") {
+function resolveInteractiveEditSize(width, height) {
+  if (!Number.isSafeInteger(width) || width <= 0 || !Number.isSafeInteger(height) || height <= 0) {
+    throw new Error(`交互编辑图片尺寸无效：${width}x${height}`);
+  }
+  const pixels = width * height;
+  if (pixels >= INTERACTIVE_EDIT_MIN_PIXELS && pixels <= INTERACTIVE_EDIT_MAX_PIXELS) {
+    return `${width}x${height}`;
+  }
+  const targetPixels = pixels < INTERACTIVE_EDIT_MIN_PIXELS ? INTERACTIVE_EDIT_MIN_PIXELS : INTERACTIVE_EDIT_MAX_PIXELS;
+  const aspectRatio = width / height;
+  const targetHeight = Math.max(1, Math.round(Math.sqrt(targetPixels / aspectRatio)));
+  const targetWidth = pixels < INTERACTIVE_EDIT_MIN_PIXELS ? Math.ceil(targetPixels / targetHeight) : Math.max(1, Math.floor(targetPixels / targetHeight));
+  return `${targetWidth}x${targetHeight}`;
+}
+async function extractVideoAssetFrames(workspaceDir, assetId, count, requestedOperationId = "") {
+  if (count < 2 || count > 30) throw httpError(400, "抽取帧数需在 2–30 之间");
   const sourcePath = resolveAssetPath(workspaceDir, assetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "video") {
-    throw httpError(400, "仅支持裁剪视频元素");
+  if (mediaKind(path21.extname(sourcePath)) !== "video") {
+    throw httpError(400, "仅支持将视频转换为序列帧图");
   }
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const filename = uniqueAssetName(`trim_${start.toFixed(3)}-${end.toFixed(3)}.mp4`);
-  const outputPath = path20.join(paths.assetsDir, filename);
+  const batch = randomUUID4().slice(0, 8);
+  let extractionDir = "";
+  let outputPath = "";
   const job = await beginCanvasJob({
     operationId: requestedOperationId || void 0,
     workspaceDir,
-    kind: "video_trim",
+    kind: "video_frame_extract",
     parentAssetIds: [assetId],
-    outputKind: "video"
+    outputKind: "image",
+    metadata: { name: `序列帧图 · ${path21.basename(sourcePath)}` }
   });
   try {
+    extractionDir = await mkdtemp2(path21.join(paths.canvasDir, "video-frames-"));
     await updateCanvasJob(workspaceDir, job.operationId, { status: "RUNNING" });
-    const result = await trimVideo(sourcePath, outputPath, start, end);
+    const [result, sourceDuration] = await Promise.all([
+      extractVideoFrames(
+        sourcePath,
+        extractionDir,
+        count,
+        (index) => `frame_${String(index + 1).padStart(2, "0")}.jpg`
+      ),
+      probeVideoDuration(sourcePath)
+    ]);
+    const columns = Math.max(1, Math.ceil(Math.sqrt(result.files.length)));
+    const rows = Math.max(1, Math.ceil(result.files.length / columns));
+    const fps = result.files.length / sourceDuration;
+    const sourceName = path21.parse(sourcePath).name;
+    const filename = uniqueAssetName(`${sourceName}_${batch}_${result.files.length}frames.png`);
+    outputPath = path21.join(paths.assetsDir, filename);
+    const sheet = await composeSequenceSheet(result.files, outputPath, rows, columns);
     const completed = await completeCanvasJob({
       operationId: job.operationId,
       workspaceDir,
-      outputs: [{ localPath: outputPath, kind: "video" }],
-      metadata: { start: result.start, end: result.end, duration: result.duration }
+      outputs: [{ localPath: sheet.file, kind: "image" }],
+      metadata: {
+        ...job.metadata,
+        kind: "frame_sheet",
+        frameCount: result.files.length,
+        fps,
+        sourceDuration,
+        frameNumbers: result.frameNumbers,
+        totalFrames: result.totalFrames,
+        rows,
+        columns,
+        cellWidth: sheet.cellWidth,
+        cellHeight: sheet.cellHeight,
+        width: sheet.width,
+        height: sheet.height,
+        order: "row-major"
+      }
     });
     const outputId = completed?.outputAssetId;
-    if (!outputId) throw new Error("视频裁剪完成但没有产物记录");
+    if (!outputId) throw new Error("视频序列帧图完成但没有产物记录");
     return {
       id: outputId,
       name: filename,
-      kind: "video",
+      source: "assets",
+      kind: "image",
       url: `/files/${outputId}`,
       operation_id: job.operationId,
-      ...result
+      count: result.files.length,
+      fps,
+      source_duration: sourceDuration,
+      total_frames: result.totalFrames,
+      frame_numbers: result.frameNumbers,
+      rows,
+      columns,
+      width: sheet.width,
+      height: sheet.height,
+      cell_width: sheet.cellWidth,
+      cell_height: sheet.cellHeight
     };
   } catch (error2) {
+    if (outputPath) await unlink(outputPath).catch(() => void 0);
     await failCanvasJob(workspaceDir, job.operationId, error2).catch(() => void 0);
     throw error2;
+  } finally {
+    if (extractionDir) {
+      await rm4(extractionDir, { recursive: true, force: true }).catch(() => void 0);
+    }
   }
 }
-async function extractVideoAssetFrames(workspaceDir, assetId, count, requestedOperationId = "") {
-  if (count < 2 || count > 30) throw httpError(400, "序列帧长度需在 2–30 之间");
-  const sourcePath = resolveAssetPath(workspaceDir, assetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "video") {
-    throw httpError(400, "仅支持对视频进行序列帧化");
+async function editFrameSheetAsset(workspaceDir, body) {
+  const sourceAssetId = String(body.source_id || "").trim();
+  const sourceRows = Number(body.source_rows);
+  const sourceColumns = Number(body.source_columns);
+  const rows = Number(body.rows);
+  const columns = Number(body.columns);
+  const fps = Number(body.fps);
+  if (!Number.isInteger(sourceRows) || !Number.isInteger(sourceColumns) || sourceRows < 1 || sourceColumns < 1 || sourceRows > 64 || sourceColumns > 64) {
+    throw httpError(400, "原图切分的行数与列数需为 1–64 的整数");
+  }
+  if (!Number.isInteger(rows) || !Number.isInteger(columns) || rows < 1 || columns < 1 || rows > 64 || columns > 64 || rows * columns < 2) {
+    throw httpError(400, "输出序列帧的行数与列数需为 1–64 的整数，且至少两格");
+  }
+  if (!Number.isFinite(fps) || fps <= 0) {
+    throw httpError(400, "序列帧 FPS 必须大于 0");
+  }
+  const sourcePath = resolveAssetPath(workspaceDir, sourceAssetId);
+  if (mediaKind(path21.extname(sourcePath)) !== "image") {
+    throw httpError(400, "序列帧编辑来源必须是图片");
   }
+  const rawFrames = Array.isArray(body.frames) ? body.frames : [];
+  if (rawFrames.length < 2) throw httpError(400, "至少需要两帧才能保存序列帧");
+  if (rawFrames.length > rows * columns) {
+    throw httpError(400, `格子不足：${rows}×${columns}=${rows * columns}，但有 ${rawFrames.length} 帧`);
+  }
+  if (rawFrames.length > 256) throw httpError(400, "一次最多编辑 256 帧");
+  const frames = rawFrames.map((value, frameIndex) => {
+    if (!value || typeof value !== "object") {
+      throw httpError(400, `第 ${frameIndex + 1} 帧无效`);
+    }
+    const record2 = value;
+    if (record2.kind === "source_cell") {
+      const index = Number(record2.index);
+      if (!Number.isInteger(index) || index < 0 || index >= sourceRows * sourceColumns) {
+        throw httpError(400, `第 ${frameIndex + 1} 帧的原图格子索引无效`);
+      }
+      return { kind: "source_cell", index };
+    }
+    if (record2.kind === "asset") {
+      const assetId = String(record2.asset_id || "").trim();
+      if (!assetId) throw httpError(400, `第 ${frameIndex + 1} 帧缺少图片素材`);
+      const assetPath = resolveAssetPath(workspaceDir, assetId);
+      if (mediaKind(path21.extname(assetPath)) !== "image") {
+        throw httpError(400, `第 ${frameIndex + 1} 帧引用的素材不是图片`);
+      }
+      return { kind: "asset", assetId };
+    }
+    throw httpError(400, `第 ${frameIndex + 1} 帧类型无效`);
+  });
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const batch = randomUUID3().slice(0, 8);
+  const batch = randomUUID4().slice(0, 8);
+  const sourceName = path21.parse(sourcePath).name;
+  const filename = uniqueAssetName(`${sourceName}_edited_${batch}_${frames.length}frames.png`);
+  const outputPath = path21.join(paths.assetsDir, filename);
+  const temporaryDir = await mkdtemp2(path21.join(paths.canvasDir, "frame-sheet-edit-"));
+  const parentAssetIds = [
+    sourceAssetId,
+    ...frames.filter(
+      (frame) => frame.kind === "asset" && Boolean(frame.assetId)
+    ).map((frame) => frame.assetId)
+  ].filter((value, index, values) => values.indexOf(value) === index);
   const job = await beginCanvasJob({
-    operationId: requestedOperationId || void 0,
+    operationId: String(body.client_operation_id || "") || void 0,
     workspaceDir,
-    kind: "video_frame_extract",
-    parentAssetIds: [assetId],
+    kind: "frame_sheet_edit",
+    parentAssetIds,
     outputKind: "image",
-    presentation: "sequence",
-    outputLayoutId: `sequence_${randomUUID3().replace(/-/g, "")}`,
-    metadata: { name: `序列 · ${path20.basename(sourcePath)}`, loop: true }
+    metadata: { name: `序列帧编辑 · ${path21.basename(sourcePath)}` }
   });
   try {
     await updateCanvasJob(workspaceDir, job.operationId, { status: "RUNNING" });
-    const result = await extractVideoFrames(
-      sourcePath,
-      paths.assetsDir,
-      count,
-      (index) => uniqueAssetName(`${batch}_frame_${String(index + 1).padStart(2, "0")}.jpg`)
-    );
+    const sourceDimensions = await probeImageDimensions(sourcePath);
+    const sourceCellWidth = Math.ceil(sourceDimensions.width / sourceColumns);
+    const sourceCellHeight = Math.ceil(sourceDimensions.height / sourceRows);
+    const sourceIndexes = [...new Set(
+      frames.filter((frame) => frame.kind === "source_cell").map((frame) => Number(frame.index))
+    )];
+    const sourceFiles = /* @__PURE__ */ new Map();
+    if (sourceIndexes.length) {
+      const split = await manualSplitImage(
+        sourcePath,
+        temporaryDir,
+        (index) => `source_cell_${String(index + 1).padStart(4, "0")}.png`,
+        sourceRows,
+        sourceColumns,
+        { allowSingleCell: true, indexes: sourceIndexes }
+      );
+      sourceIndexes.forEach((index, position) => sourceFiles.set(index, split.files[position]));
+    }
+    const framePaths = frames.map((frame) => {
+      if (frame.kind === "asset") return resolveAssetPath(workspaceDir, frame.assetId || "");
+      const sourceFile = sourceFiles.get(Number(frame.index));
+      if (!sourceFile) throw new Error(`无法读取原图第 ${Number(frame.index) + 1} 格`);
+      return sourceFile;
+    });
+    const sheet = await composeSequenceSheet(framePaths, outputPath, rows, columns, {
+      cellWidth: sourceCellWidth,
+      cellHeight: sourceCellHeight,
+      fit: "contain"
+    });
     const completed = await completeCanvasJob({
       operationId: job.operationId,
       workspaceDir,
-      outputs: result.files.map((localPath) => ({ localPath, kind: "image" })),
-      presentation: "sequence",
-      outputLayoutId: job.outputLayoutId,
+      outputs: [{ localPath: sheet.file, kind: "image" }],
       metadata: {
         ...job.metadata,
-        fps: Math.min(24, Math.max(1, result.files.length)),
-        frameNumbers: result.frameNumbers,
-        totalFrames: result.totalFrames
+        kind: "frame_sheet",
+        frameCount: frames.length,
+        fps,
+        rows,
+        columns,
+        cellWidth: sheet.cellWidth,
+        cellHeight: sheet.cellHeight,
+        width: sheet.width,
+        height: sheet.height,
+        sourceRows,
+        sourceColumns,
+        order: "row-major"
       }
     });
-    const outputIds = completed?.outputAssetIds ?? [];
-    const images = outputIds.map((id) => ({
-      id,
-      name: path20.basename(relativePathFromAssetId(id)),
+    const outputId = completed?.outputAssetId;
+    if (!outputId) throw new Error("序列帧编辑完成但没有产物记录");
+    return {
+      id: outputId,
+      name: filename,
       source: "assets",
       kind: "image",
-      url: `/files/${id}`
-    }));
-    return {
-      images,
-      sequence_id: completed?.outputLayoutId,
+      url: `/files/${outputId}`,
       operation_id: job.operationId,
-      count: images.length,
-      total_frames: result.totalFrames,
-      frame_numbers: result.frameNumbers
+      count: frames.length,
+      fps,
+      rows,
+      columns,
+      width: sheet.width,
+      height: sheet.height,
+      cell_width: sheet.cellWidth,
+      cell_height: sheet.cellHeight
     };
   } catch (error2) {
+    await unlink(outputPath).catch(() => void 0);
     await failCanvasJob(workspaceDir, job.operationId, error2).catch(() => void 0);
     throw error2;
+  } finally {
+    await rm4(temporaryDir, { recursive: true, force: true }).catch(() => void 0);
   }
 }
 async function manualSplitImageAsset(workspaceDir, body) {
@@ -23131,11 +23490,11 @@ async function manualSplitImageAsset(workspaceDir, body) {
     throw httpError(400, "手动切分的行数与列数需为 1–64 的整数，且至少切为两格");
   }
   const sourcePath = resolveAssetPath(workspaceDir, sourceAssetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "image") {
+  if (mediaKind(path21.extname(sourcePath)) !== "image") {
     throw httpError(400, "手动切分来源必须是图片");
   }
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const batch = randomUUID3().slice(0, 8);
+  const batch = randomUUID4().slice(0, 8);
   const job = await beginCanvasJob({
     operationId: String(body.client_operation_id || "") || void 0,
     workspaceDir,
@@ -23168,7 +23527,7 @@ async function manualSplitImageAsset(workspaceDir, body) {
     });
     const images = (completed?.outputAssetIds ?? []).map((id) => ({
       id,
-      name: path20.basename(relativePathFromAssetId(id)),
+      name: path21.basename(relativePathFromAssetId(id)),
       source: "assets",
       kind: "image",
       url: `/files/${id}`
@@ -23194,9 +23553,9 @@ async function splitImageAsset(workspaceDir, body) {
     throw httpError(400, "智能切分基准点无效");
   }
   const sourcePath = resolveAssetPath(workspaceDir, sourceAssetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "image") throw httpError(400, "智能切分来源必须是图片");
+  if (mediaKind(path21.extname(sourcePath)) !== "image") throw httpError(400, "智能切分来源必须是图片");
   const paths = await ensureCanvasWorkspace(workspaceDir);
-  const batch = randomUUID3().slice(0, 8);
+  const batch = randomUUID4().slice(0, 8);
   const job = await beginCanvasJob({
     operationId: String(body.client_operation_id || "") || void 0,
     workspaceDir,
@@ -23226,7 +23585,7 @@ async function splitImageAsset(workspaceDir, body) {
     });
     const images = (completed?.outputAssetIds ?? []).map((id) => ({
       id,
-      name: path20.basename(relativePathFromAssetId(id)),
+      name: path21.basename(relativePathFromAssetId(id)),
       source: "assets",
       kind: "image",
       url: `/files/${id}`
@@ -23245,57 +23604,13 @@ async function splitImageAsset(workspaceDir, body) {
     throw error2;
   }
 }
-async function composeSequenceAsset(workspaceDir, body) {
-  const frameIds = Array.isArray(body.frame_ids) ? body.frame_ids.map(String).filter(Boolean) : [];
-  if (!frameIds.length) throw httpError(400, "序列没有可拼接的帧");
-  const rows = Math.round(Number(body.rows));
-  const columns = Math.round(Number(body.columns));
-  const framePaths = frameIds.map((id) => resolveAssetPath(workspaceDir, id));
-  if (framePaths.some((file) => mediaKind(path20.extname(file)) !== "image")) {
-    throw httpError(400, "序列拼图只支持图片帧");
-  }
-  const paths = await ensureCanvasWorkspace(workspaceDir);
-  const filename = uniqueAssetName(`sheet_${rows}x${columns}.png`);
-  const outputPath = path20.join(paths.assetsDir, filename);
-  const job = await beginCanvasJob({
-    operationId: String(body.client_operation_id || "") || void 0,
-    workspaceDir,
-    kind: "sequence_sheet",
-    parentAssetIds: frameIds,
-    outputKind: "image",
-    metadata: { rows, columns, frameCount: frameIds.length }
-  });
-  try {
-    await updateCanvasJob(workspaceDir, job.operationId, { status: "RUNNING" });
-    const result = await composeSequenceSheet(framePaths, outputPath, rows, columns);
-    const completed = await completeCanvasJob({
-      operationId: job.operationId,
-      workspaceDir,
-      outputs: [{ localPath: result.file, kind: "image" }],
-      metadata: { ...job.metadata, width: result.width, height: result.height }
-    });
-    const outputId = completed?.outputAssetId;
-    if (!outputId) throw new Error("序列拼图完成但没有产物记录");
-    return {
-      id: outputId,
-      name: filename,
-      kind: "image",
-      url: `/files/${outputId}`,
-      operation_id: job.operationId,
-      ...result
-    };
-  } catch (error2) {
-    await failCanvasJob(workspaceDir, job.operationId, error2).catch(() => void 0);
-    throw error2;
-  }
-}
 async function extractVideoCycleAsset(workspaceDir, body) {
   const assetId = String(body.id || "").trim();
   const sourcePath = resolveAssetPath(workspaceDir, assetId);
-  if (mediaKind(path20.extname(sourcePath)) !== "video") throw httpError(400, "循环提取来源必须是视频");
+  if (mediaKind(path21.extname(sourcePath)) !== "video") throw httpError(400, "循环提取来源必须是视频");
   const paths = await ensureCanvasWorkspace(workspaceDir);
   const filename = uniqueAssetName("cycle.mp4");
-  const outputPath = path20.join(paths.assetsDir, filename);
+  const outputPath = path21.join(paths.assetsDir, filename);
   const job = await beginCanvasJob({
     operationId: String(body.client_operation_id || "") || void 0,
     workspaceDir,
@@ -23339,13 +23654,13 @@ async function layoutWithProvenance(workspaceDir, scannedAssets) {
       return provenance ? { ...item, provenance } : item;
     })
   );
-  return { items };
+  return { ...layout, items };
 }
 async function saveUploadedFile(workspaceDir, rawName, rawData, requestedKind) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
   const fallbackName = requestedKind === "video" ? "video.mp4" : requestedKind === "audio" ? "audio.mp3" : "image.png";
-  const originalName = path20.basename(String(rawName || fallbackName));
-  const extension = path20.extname(originalName).toLowerCase();
+  const originalName = path21.basename(String(rawName || fallbackName));
+  const extension = path21.extname(originalName).toLowerCase();
   const kind = mediaKind(extension);
   if (!kind || kind !== requestedKind) {
     throw httpError(400, `不支持的${requestedKind === "video" ? "视频" : "图片"}类型：${extension || "(无后缀)"}`);
@@ -23356,8 +23671,8 @@ async function saveUploadedFile(workspaceDir, rawName, rawData, requestedKind) {
   const bytes = Buffer.from(base642, "base64");
   if (!bytes.length) throw httpError(400, "媒体数据为空");
   const filename = uniqueAssetName(originalName);
-  const localPath = path20.join(paths.assetsDir, filename);
-  await writeFile3(localPath, bytes);
+  const localPath = path21.join(paths.assetsDir, filename);
+  await writeFile4(localPath, bytes);
   const info = await stat6(localPath);
   const asset = {
     id: assetIdFromRelativePath(filename),
@@ -23386,19 +23701,19 @@ async function saveUploadedFile(workspaceDir, rawName, rawData, requestedKind) {
 async function duplicateAsset(workspaceDir, assetId) {
   const sourcePath = resolveAssetPath(workspaceDir, assetId);
   const relative = relativePathFromAssetId(assetId);
-  const parsed = path20.posix.parse(relative);
-  const outputRelative = [parsed.dir, `${parsed.name}_${randomUUID3().slice(0, 8)}${parsed.ext}`].filter(Boolean).join("/");
+  const parsed = path21.posix.parse(relative);
+  const outputRelative = [parsed.dir, `${parsed.name}_${randomUUID4().slice(0, 8)}${parsed.ext}`].filter(Boolean).join("/");
   const outputId = assetIdFromRelativePath(outputRelative);
   const outputPath = resolveAssetPath(workspaceDir, outputId);
-  await mkdir6(path20.dirname(outputPath), { recursive: true });
+  await mkdir7(path21.dirname(outputPath), { recursive: true });
   await copyFile3(sourcePath, outputPath);
   await recordCopiedAsset(workspaceDir, assetId, outputId);
   const info = await stat6(outputPath);
-  const kind = mediaKind(path20.extname(outputPath));
+  const kind = mediaKind(path21.extname(outputPath));
   if (!kind) throw httpError(400, "不支持的素材类型");
   return {
     id: outputId,
-    name: path20.basename(outputPath),
+    name: path21.basename(outputPath),
     relativePath: outputRelative,
     localPath: outputPath,
     kind,
@@ -23411,13 +23726,13 @@ async function importClipboardFiles(workspaceDir, sourcePaths) {
   const paths = await ensureCanvasWorkspace(workspaceDir);
   const imported = [];
   for (const rawSourcePath of [...new Set(sourcePaths.map(String).filter(Boolean))]) {
-    const sourcePath = path20.resolve(rawSourcePath);
+    const sourcePath = path21.resolve(rawSourcePath);
     const info = await stat6(sourcePath).catch(() => void 0);
     if (!info?.isFile()) continue;
-    const kind = mediaKind(path20.extname(sourcePath));
+    const kind = mediaKind(path21.extname(sourcePath));
     if (!kind || kind === "audio") continue;
-    const filename = uniqueAssetName(path20.basename(sourcePath));
-    const localPath = path20.join(paths.assetsDir, filename);
+    const filename = uniqueAssetName(path21.basename(sourcePath));
+    const localPath = path21.join(paths.assetsDir, filename);
     await copyFile3(sourcePath, localPath);
     const copiedInfo = await stat6(localPath);
     const assetId = assetIdFromRelativePath(filename);
@@ -23431,12 +23746,12 @@ async function importClipboardFiles(workspaceDir, sourcePaths) {
       url: `/files/${assetId}`,
       mtime: copiedInfo.mtimeMs
     };
-    const relativeSource = path20.relative(paths.assetsDir, sourcePath);
-    const isWorkspaceAsset = relativeSource !== "" && !relativeSource.startsWith(`..${path20.sep}`) && relativeSource !== ".." && !path20.isAbsolute(relativeSource);
+    const relativeSource = path21.relative(paths.assetsDir, sourcePath);
+    const isWorkspaceAsset = relativeSource !== "" && !relativeSource.startsWith(`..${path21.sep}`) && relativeSource !== ".." && !path21.isAbsolute(relativeSource);
     if (isWorkspaceAsset) {
       await recordCopiedAsset(
         workspaceDir,
-        assetIdFromRelativePath(relativeSource.split(path20.sep).join("/")),
+        assetIdFromRelativePath(relativeSource.split(path21.sep).join("/")),
         asset.id
       );
     } else {
@@ -23457,32 +23772,12 @@ async function importClipboardFiles(workspaceDir, sourcePaths) {
   }
   return imported;
 }
-function normalizeClipboardSequence(value, fileCount) {
-  if (!value || typeof value !== "object" || Array.isArray(value) || fileCount < 1) return void 0;
-  const raw = value;
-  if (raw.kind !== "sequence") return void 0;
-  const expectedFrameCount = Number(raw.frameCount);
-  if (Number.isFinite(expectedFrameCount) && expectedFrameCount !== fileCount) return void 0;
-  const fps = Number(raw.fps);
-  return {
-    kind: "sequence",
-    version: 1,
-    name: String(raw.name || "序列").slice(0, 200),
-    fps: Number.isFinite(fps) && fps > 0 ? Math.min(120, fps) : 8,
-    loop: raw.loop !== false,
-    frameCount: fileCount
-  };
-}
 async function deleteCanvasItems(workspaceDir, body) {
   const imageIds = Array.isArray(body.image_ids) ? body.image_ids.map(String) : [];
   const layoutIds = Array.isArray(body.layout_ids) ? body.layout_ids.map(String) : [];
-  const layout = await loadCanvasLayout(workspaceDir);
   const files = new Set(imageIds);
   for (const layoutId of layoutIds) {
-    const item = layout.items.find((candidate) => candidate.id === layoutId);
-    if (item?.type === "sequence" && Array.isArray(item.frames)) {
-      item.frames.map(String).forEach((frame) => files.add(frame));
-    } else if (layoutId.startsWith("assets/")) {
+    if (layoutId.startsWith("assets/")) {
       files.add(layoutId);
     } else if (layoutId.startsWith("job_") || layoutId.startsWith("pending_")) {
       await hideCanvasJob(workspaceDir, layoutId);
@@ -23500,26 +23795,33 @@ async function deleteCanvasItems(workspaceDir, body) {
     }
   }
   const remove = /* @__PURE__ */ new Set([...files, ...layoutIds]);
-  await saveCanvasLayout(workspaceDir, {
-    items: layout.items.filter((item) => !remove.has(item.id)).map(
-      (item) => item.type === "sequence" && Array.isArray(item.frames) ? { ...item, frames: item.frames.map(String).filter((frame) => !files.has(frame)) } : item
-    ).filter((item) => item.type !== "sequence" || Array.isArray(item.frames) && item.frames.length > 0)
-  });
+  await mutateCanvasLayout(
+    workspaceDir,
+    (items) => items.filter((item) => !remove.has(item.id) && item.type !== "sequence")
+  );
   return { deleted, missing, layout: await reconcileCanvasLayout(workspaceDir) };
 }
 async function placeAssets(workspaceDir, assets) {
-  const layout = await reconcileCanvasLayout(workspaceDir);
-  const ids = new Set(layout.items.map((item) => item.id));
-  for (const asset of assets) {
-    if (ids.has(asset.id)) continue;
-    layout.items.push({ id: asset.id, ...asset.kind === "video" ? { type: "video" } : {} });
-  }
-  await saveCanvasLayout(workspaceDir, layout);
+  await reconcileCanvasLayout(workspaceDir);
+  await mutateCanvasLayout(workspaceDir, (items) => {
+    const ids = new Set(items.map((item) => item.assetId || item.id));
+    for (const asset of assets) {
+      if (ids.has(asset.id)) continue;
+      items.push({
+        id: asset.id,
+        assetId: asset.id,
+        ...asset.kind === "video" ? { type: "video" } : {}
+      });
+      ids.add(asset.id);
+    }
+  });
 }
 function sanitizeLayoutItems(value) {
   if (!Array.isArray(value)) return [];
   return value.filter(
-    (item) => Boolean(item && typeof item === "object" && typeof item.id === "string")
+    (item) => Boolean(
+      item && typeof item === "object" && typeof item.id === "string" && item.type !== "sequence"
+    )
   );
 }
 function publicAsset(asset) {
@@ -23536,7 +23838,7 @@ function projectPayload(workspaceDir) {
   return { project: projectInfo(workspaceDir), recent: [] };
 }
 function projectInfo(workspaceDir) {
-  return { path: workspaceDir, name: path20.basename(workspaceDir) || workspaceDir };
+  return { path: workspaceDir, name: path21.basename(workspaceDir) || workspaceDir };
 }
 async function readJsonBody(request) {
   const chunks = [];
@@ -23556,10 +23858,10 @@ async function readJsonBody(request) {
 }
 async function servePublic(request, response, publicDir, pathname) {
   const relative = pathname === "/" ? "index.html" : decodeURIComponent(pathname).replace(/^\/+/, "");
-  const full = path20.resolve(publicDir, relative);
+  const full = path21.resolve(publicDir, relative);
   if (!pathContained2(publicDir, full) || !existsSync(full)) throw httpError(404, "Not Found");
   if (relative === "styles.css") {
-    const css = await readFile3(full, "utf8");
+    const css = await readFile4(full, "utf8");
     const extra = "\n#switch-project-btn { display: none !important; }\n";
     sendText(response, 200, css + extra, "text/css; charset=utf-8");
     return;
@@ -23569,22 +23871,22 @@ async function servePublic(request, response, publicDir, pathname) {
 function resolveCanvasVendorAsset(pathname, publicDir) {
   const asset = CANVAS_VENDOR_ASSETS[pathname];
   if (!asset) return void 0;
-  const modulePath = path20.join(asset.packageName, asset.relativePath);
-  const roots = [publicDir, process.cwd(), path20.dirname(path20.resolve(process.argv[1] || process.cwd()))];
+  const modulePath = path21.join(asset.packageName, asset.relativePath);
+  const roots = [publicDir, process.cwd(), path21.dirname(path21.resolve(process.argv[1] || process.cwd()))];
   const checked = /* @__PURE__ */ new Set();
   for (const root of roots) {
-    let current = path20.resolve(root);
+    let current = path21.resolve(root);
     for (; ; ) {
       const candidates = [
-        path20.join(current, "node_modules", modulePath),
-        ...path20.basename(current).toLowerCase() === "node_modules" ? [path20.join(current, modulePath)] : []
+        path21.join(current, "node_modules", modulePath),
+        ...path21.basename(current).toLowerCase() === "node_modules" ? [path21.join(current, modulePath)] : []
       ];
       for (const candidate of candidates) {
         if (checked.has(candidate)) continue;
         checked.add(candidate);
         if (existsSync(candidate)) return candidate;
       }
-      const parent = path20.dirname(current);
+      const parent = path21.dirname(current);
       if (parent === current) break;
       current = parent;
     }
@@ -23626,28 +23928,28 @@ async function serveFileWithRange(request, response, filePath) {
   createReadStream(filePath, { start, end }).pipe(response);
 }
 function resolveCanvasPublicDir() {
-  const executableDir = path20.dirname(path20.resolve(process.argv[1] || process.cwd()));
+  const executableDir = path21.dirname(path21.resolve(process.argv[1] || process.cwd()));
   const sourceCandidates = [
-    path20.resolve(executableDir, "canvas/public"),
-    path20.resolve(executableDir, "../src/canvas/public"),
-    path20.resolve(process.cwd(), "src/canvas/public"),
-    path20.resolve(process.cwd(), "plugin_client/src/canvas/public")
+    path21.resolve(executableDir, "canvas/public"),
+    path21.resolve(executableDir, "../src/canvas/public"),
+    path21.resolve(process.cwd(), "src/canvas/public"),
+    path21.resolve(process.cwd(), "plugin_client/src/canvas/public")
   ];
   const packagedCandidates = [
-    path20.resolve(executableDir, "../dist/canvas-public"),
-    path20.resolve(executableDir, "canvas-public"),
-    path20.resolve(process.cwd(), "dist/canvas-public")
+    path21.resolve(executableDir, "../dist/canvas-public"),
+    path21.resolve(executableDir, "canvas-public"),
+    path21.resolve(process.cwd(), "dist/canvas-public")
   ];
   const candidates = [...sourceCandidates, ...packagedCandidates];
-  const found = candidates.find((candidate) => existsSync(path20.join(candidate, "index.html")));
+  const found = candidates.find((candidate) => existsSync(path21.join(candidate, "index.html")));
   if (!found) throw new Error("找不到 Image Canvas 前端资源，请先运行 npm run build");
   return found;
 }
 function uniqueAssetName(originalName) {
-  const extension = path20.extname(originalName);
-  const stem = path20.basename(originalName, extension).replace(/[^\p{L}\p{N}_.-]+/gu, "_") || "asset";
+  const extension = path21.extname(originalName);
+  const stem = path21.basename(originalName, extension).replace(/[^\p{L}\p{N}_.-]+/gu, "_") || "asset";
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
-  return `${stamp}_${randomUUID3().slice(0, 8)}_${stem}${extension.toLowerCase()}`;
+  return `${stamp}_${randomUUID4().slice(0, 8)}_${stem}${extension.toLowerCase()}`;
 }
 function mediaKind(extension) {
   const ext = extension.toLowerCase();
@@ -23657,7 +23959,7 @@ function mediaKind(extension) {
   return void 0;
 }
 function mimeType(filePath) {
-  const ext = path20.extname(filePath).toLowerCase();
+  const ext = path21.extname(filePath).toLowerCase();
   return {
     ".html": "text/html; charset=utf-8",
     ".js": "text/javascript; charset=utf-8",
@@ -23770,9 +24072,9 @@ async function listenOnAvailablePort(server, host, preferredPort) {
   throw new Error(`端口 ${preferredPort}-${preferredPort + 19} 均被占用`);
 }
 function pathContained2(base, target) {
-  const root = path20.resolve(base);
-  const full = path20.resolve(target);
-  const prefix = root.endsWith(path20.sep) ? root : `${root}${path20.sep}`;
+  const root = path21.resolve(base);
+  const full = path21.resolve(target);
+  const prefix = root.endsWith(path21.sep) ? root : `${root}${path21.sep}`;
   return full === root || full.startsWith(prefix);
 }
 function httpError(status, message) {
@@ -23785,10 +24087,72 @@ function statusFromError(error2) {
 function errorMessage(error2) {
   return error2 instanceof Error ? error2.message : String(error2);
 }
+function canvasGenerationErrorMessage(error2) {
+  const message = incompatibleResponseDetail(error2) ?? errorMessage(error2);
+  const normalized = message.toLowerCase();
+  if (/insufficient[_ -]?quota|quota (?:has been )?(?:exceeded|exhausted)|insufficient (?:balance|credit|funds)|credit balance (?:is )?too low/i.test(message) || /(?:额度(?:不足|已?用完|耗尽)|余额(?:不足|已?用完))/.test(message)) {
+    return CANVAS_QUOTA_ERROR;
+  }
+  const code = String(error2?.code || "").toUpperCase();
+  const name = error2 instanceof Error ? error2.name : "";
+  if (name === "NetworkError" || ["ECONNABORTED", "ECONNREFUSED", "ECONNRESET", "EHOSTUNREACH", "ENETUNREACH", "ETIMEDOUT"].includes(code) || /fetch failed|network(?: request)? (?:error|failed)|socket hang up|connection (?:error|failed|refused|reset|timed out)|request timed out|connecttimeout|网络异常|连接失败/.test(normalized)) {
+    return CANVAS_NETWORK_ERROR;
+  }
+  return message;
+}
+function incompatibleResponseDetail(error2) {
+  if (!(error2 instanceof Error) || error2.name !== "IncompatibleResponseError") return void 0;
+  const rawBody = error2.rawBody;
+  if (typeof rawBody !== "string" || !rawBody.trim()) {
+    return "服务端返回了无法解析的响应";
+  }
+  const raw = rawBody.trim();
+  try {
+    const parsed = JSON.parse(raw);
+    const extracted = responseErrorMessage(parsed);
+    if (extracted) return providerMessageFromText(extracted);
+  } catch {
+  }
+  return providerMessageFromText(raw);
+}
+function responseErrorMessage(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const record2 = value;
+  if (typeof record2.error_message === "string" && record2.error_message.trim()) {
+    return record2.error_message.trim();
+  }
+  if (record2.error && typeof record2.error === "object" && !Array.isArray(record2.error)) {
+    const nested = responseErrorMessage(record2.error);
+    if (nested) return nested;
+  }
+  if (record2.data && typeof record2.data === "object" && !Array.isArray(record2.data)) {
+    const nested = responseErrorMessage(record2.data);
+    if (nested) return nested;
+  }
+  if (typeof record2.detail === "string" && record2.detail.trim()) return record2.detail.trim();
+  if (typeof record2.message === "string" && record2.message.trim() && record2.message !== "ok") {
+    return record2.message.trim();
+  }
+  return void 0;
+}
+function providerMessageFromText(message) {
+  const pythonPayloadMessage = message.match(
+    /['"]message['"]\s*:\s*(['"])([\s\S]*?)\1\s*,\s*['"](?:type|param|code)['"]\s*:/
+  );
+  return pythonPayloadMessage?.[2]?.trim() || message;
+}
+function normalizeCanvasGenerationError(error2) {
+  const message = canvasGenerationErrorMessage(error2);
+  if (error2 instanceof Error && message === error2.message) return error2;
+  const normalized = new Error(message);
+  const status = error2?.status;
+  if (typeof status === "number") Object.assign(normalized, { status });
+  return normalized;
+}
 
 // src/cli/canvas/command.ts
 async function runCanvas(parsed) {
-  const workspaceDir = path21.resolve(process.cwd());
+  const workspaceDir = path22.resolve(process.cwd());
   const portOption = stringOption(parsed, "port");
   const port = portOption === void 0 ? 5178 : Number(portOption);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
@@ -24739,7 +25103,7 @@ async function handleLoginEvomeme(deps = defaultDeps4) {
 }
 
 // src/mcp/tools/submitGameCode.ts
-import path22 from "node:path";
+import path23 from "node:path";
 var SUBMIT_GAME_CODE_TOOL_NAME = "evomeme_submit_game_code";
 var SUBMIT_GAME_CODE_DESCRIPTION = [
   "将当前工作区发布为 evomeme云端作品（全量覆盖对应 thread_id 下的全部文件）。",
@@ -24798,7 +25162,7 @@ var defaultDeps5 = {
 };
 async function handleSubmitGameCode(args = {}, deps = defaultDeps5) {
   try {
-    const workspaceDir = path22.resolve(args.workspace_dir?.trim() || deps.cwd());
+    const workspaceDir = path23.resolve(args.workspace_dir?.trim() || deps.cwd());
     const submitOptions = {};
     const name = args.name?.trim();
     if (name) {
@@ -24829,7 +25193,7 @@ function formatSuccess(workspaceDir, result) {
 }
 
 // src/mcp/tools/uploadGameAsset.ts
-import path23 from "node:path";
+import path24 from "node:path";
 var UPLOAD_GAME_ASSET_TOOL_NAME = "evomeme_upload_game_asset";
 var UPLOAD_GAME_ASSET_DESCRIPTION = [
   "将本地二进制文件交给 evomeme服务端上传到对象存储（TOS），返回公开可访问的 asset_url。",
@@ -24883,7 +25247,7 @@ async function handleUploadGameAsset(args, deps = defaultDeps6) {
     if (!args.local_path?.trim()) {
       return toolError(new Error("缺少必填参数 local_path"));
     }
-    const localPath = path23.isAbsolute(args.local_path) ? args.local_path : path23.resolve(deps.cwd(), args.local_path);
+    const localPath = path24.isAbsolute(args.local_path) ? args.local_path : path24.resolve(deps.cwd(), args.local_path);
     const uploadOptions = {};
     if (args.folder !== void 0) {
       uploadOptions.folder = args.folder;
@@ -24931,6 +25295,174 @@ function imageArtifactToolResult(input) {
   );
 }
 
+// src/background/generationTask.ts
+import { randomUUID as randomUUID5 } from "node:crypto";
+import { spawn as spawn6 } from "node:child_process";
+import { mkdir as mkdir8, readFile as readFile5, rename as rename4, rm as rm5, writeFile as writeFile5 } from "node:fs/promises";
+import path25 from "node:path";
+var INTERNAL_GENERATION_WORKER_COMMAND = "__evomeme_generation_worker";
+var TASK_FORMAT_VERSION = 1;
+var DEFAULT_RESULT_POLL_INTERVAL_MS = 250;
+var DEFAULT_RESULT_WAIT_TIMEOUT_MS = 65 * 6e4;
+var defaultClientDeps = {
+  spawnFn: spawn6,
+  sleep: (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)),
+  entryPath: () => {
+    const entryPath = process.argv[1];
+    if (!entryPath) throw new Error("Cannot locate the evomeme CLI entry point for the background worker");
+    return path25.resolve(entryPath);
+  },
+  now: Date.now,
+  waitTimeoutMs: positiveEnvNumber3(
+    "EVOMEME_BACKGROUND_GENERATION_TIMEOUT_MS",
+    DEFAULT_RESULT_WAIT_TIMEOUT_MS
+  ),
+  pollIntervalMs: DEFAULT_RESULT_POLL_INTERVAL_MS
+};
+var runDetachedGenerationTask = async (kind, args, workspaceDir) => runDetachedGenerationTaskWithDeps(kind, args, workspaceDir, defaultClientDeps);
+async function runDetachedGenerationTaskWithDeps(kind, args, workspaceDir, deps) {
+  const resolvedWorkspace = path25.resolve(workspaceDir);
+  const taskId = randomUUID5();
+  const paths = backgroundTaskPaths(resolvedWorkspace, taskId);
+  const request = {
+    version: TASK_FORMAT_VERSION,
+    taskId,
+    kind,
+    workspaceDir: resolvedWorkspace,
+    args,
+    createdAt: new Date(deps.now()).toISOString()
+  };
+  await mkdir8(paths.directory, { recursive: true });
+  await writeJsonAtomic(paths.requestPath, request);
+  let child;
+  try {
+    const entryPath = deps.entryPath();
+    child = deps.spawnFn(
+      process.execPath,
+      [
+        ...workerExecArgv(entryPath),
+        entryPath,
+        INTERNAL_GENERATION_WORKER_COMMAND,
+        paths.requestPath
+      ],
+      {
+        cwd: resolvedWorkspace,
+        env: process.env,
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true
+      }
+    );
+  } catch (error2) {
+    await rm5(paths.requestPath, { force: true }).catch(() => void 0);
+    throw error2;
+  }
+  let workerError;
+  let workerExit;
+  child.once("error", (error2) => {
+    workerError = error2;
+  });
+  child.once("exit", (code, signal) => {
+    workerExit = { code, signal };
+  });
+  child.unref();
+  const deadline = deps.now() + deps.waitTimeoutMs;
+  try {
+    for (; ; ) {
+      const completed = await tryReadBackgroundTaskResult(paths.resultPath, taskId);
+      if (completed) return completed;
+      if (workerError) throw workerError;
+      if (workerExit) {
+        await deps.sleep(Math.min(100, deps.pollIntervalMs));
+        const finalResult = await tryReadBackgroundTaskResult(paths.resultPath, taskId);
+        if (finalResult) return finalResult;
+        throw new Error(
+          `Background generation worker exited before writing a result (code=${workerExit.code ?? "null"}, signal=${workerExit.signal ?? "none"})`
+        );
+      }
+      if (deps.now() >= deadline) {
+        throw new Error(
+          `Timed out waiting for the background generation result. task_id: ${taskId}`
+        );
+      }
+      await deps.sleep(Math.min(deps.pollIntervalMs, Math.max(1, deadline - deps.now())));
+    }
+  } finally {
+    await Promise.all([
+      rm5(paths.requestPath, { force: true }).catch(() => void 0),
+      rm5(paths.resultPath, { force: true }).catch(() => void 0)
+    ]);
+  }
+}
+function backgroundTaskPaths(workspaceDir, taskId) {
+  const directory = path25.join(path25.resolve(workspaceDir), ".evomeme", "background-tasks");
+  return {
+    directory,
+    requestPath: path25.join(directory, `${taskId}.request.json`),
+    resultPath: path25.join(directory, `${taskId}.result.json`)
+  };
+}
+async function readBackgroundTaskRequest(requestPath) {
+  const value = JSON.parse(await readFile5(requestPath, "utf8"));
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Invalid background generation request");
+  }
+  const request = value;
+  if (request.version !== TASK_FORMAT_VERSION || typeof request.taskId !== "string" || !isBackgroundGenerationKind(request.kind) || typeof request.workspaceDir !== "string" || !request.args || typeof request.args !== "object" || Array.isArray(request.args)) {
+    throw new Error("Invalid background generation request");
+  }
+  return request;
+}
+async function writeBackgroundTaskResult(requestPath, taskId, result) {
+  const resultPath = requestPath.replace(/\.request\.json$/u, ".result.json");
+  if (resultPath === requestPath) throw new Error("Invalid background generation request path");
+  const envelope = {
+    version: TASK_FORMAT_VERSION,
+    taskId,
+    completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    result
+  };
+  await writeJsonAtomic(resultPath, envelope);
+}
+async function tryReadBackgroundTaskResult(resultPath, expectedTaskId) {
+  let text;
+  try {
+    text = await readFile5(resultPath, "utf8");
+  } catch (error2) {
+    if (error2.code === "ENOENT") return void 0;
+    throw error2;
+  }
+  const envelope = JSON.parse(text);
+  if (envelope.version !== TASK_FORMAT_VERSION || envelope.taskId !== expectedTaskId || !envelope.result || !Array.isArray(envelope.result.content)) {
+    throw new Error(`Invalid background generation result for task_id: ${expectedTaskId}`);
+  }
+  return envelope.result;
+}
+async function writeJsonAtomic(filePath, value) {
+  const tempPath = `${filePath}.${process.pid}.${randomUUID5()}.tmp`;
+  try {
+    await writeFile5(tempPath, `${JSON.stringify(value)}
+`, { encoding: "utf8", mode: 384 });
+    await rename4(tempPath, filePath);
+  } catch (error2) {
+    await rm5(tempPath, { force: true }).catch(() => void 0);
+    throw error2;
+  }
+}
+function workerExecArgv(entryPath) {
+  if (path25.extname(entryPath).toLowerCase() !== ".ts") return [];
+  return process.execArgv.filter(
+    (argument) => !argument.startsWith("--inspect") && !argument.startsWith("--debug")
+  );
+}
+function isBackgroundGenerationKind(value) {
+  return value === "generate_game_image" || value === "cutout_game_image" || value === "generate_game_video";
+}
+function positiveEnvNumber3(name, fallback) {
+  const parsed = Number(process.env[name]);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
 // src/mcp/tools/generateGameImage.ts
 var GENERATE_GAME_IMAGE_TOOL_NAME = "evomeme_generate_game_image";
 var GENERATE_GAME_IMAGE_DESCRIPTION = [
@@ -24989,6 +25521,7 @@ var generateGameImageTool = {
 };
 var defaultDeps7 = {
   ...defaultImageServiceDeps,
+  backgroundTaskRunner: runDetachedGenerationTask,
   canvasTracking: {
     begin: beginCanvasJob,
     update: updateCanvasJob,
@@ -24997,6 +25530,21 @@ var defaultDeps7 = {
   }
 };
 async function handleGenerateGameImage(args, deps = defaultDeps7) {
+  if (deps.backgroundTaskRunner) {
+    const workspaceDir = args.workspace_dir?.trim() || deps.cwd();
+    try {
+      return await deps.backgroundTaskRunner(
+        "generate_game_image",
+        { ...args, workspace_dir: workspaceDir },
+        workspaceDir
+      );
+    } catch (error2) {
+      return toolError(error2);
+    }
+  }
+  return executeGenerateGameImage(args, deps);
+}
+async function executeGenerateGameImage(args, deps = defaultDeps7) {
   let canvasJob;
   try {
     if (!args.prompt?.trim()) {
@@ -25178,6 +25726,7 @@ var cutoutGameImageTool = {
 };
 var defaultDeps8 = {
   ...defaultImageServiceDeps,
+  backgroundTaskRunner: runDetachedGenerationTask,
   canvasTracking: {
     begin: beginCanvasJob,
     update: updateCanvasJob,
@@ -25186,6 +25735,21 @@ var defaultDeps8 = {
   }
 };
 async function handleCutoutGameImage(args, deps = defaultDeps8) {
+  if (deps.backgroundTaskRunner) {
+    const workspaceDir = args.workspace_dir?.trim() || deps.cwd();
+    try {
+      return await deps.backgroundTaskRunner(
+        "cutout_game_image",
+        { ...args, workspace_dir: workspaceDir },
+        workspaceDir
+      );
+    } catch (error2) {
+      return toolError(error2);
+    }
+  }
+  return executeCutoutGameImage(args, deps);
+}
+async function executeCutoutGameImage(args, deps = defaultDeps8) {
   let canvasJob;
   try {
     if (!args.image_url?.trim()) {
@@ -25305,6 +25869,7 @@ var generateGameVideoTool = {
 };
 var defaultDeps9 = {
   ...defaultVideoGenerationDeps,
+  backgroundTaskRunner: runDetachedGenerationTask,
   canvasTracking: {
     begin: beginCanvasJob,
     update: updateCanvasJob,
@@ -25313,6 +25878,21 @@ var defaultDeps9 = {
   }
 };
 async function handleGenerateGameVideo(args, deps = defaultDeps9) {
+  if (deps.backgroundTaskRunner) {
+    const workspaceDir = args.workspace_dir?.trim() || deps.cwd();
+    try {
+      return await deps.backgroundTaskRunner(
+        "generate_game_video",
+        { ...args, workspace_dir: workspaceDir },
+        workspaceDir
+      );
+    } catch (error2) {
+      return toolError(error2);
+    }
+  }
+  return executeGenerateGameVideo(args, deps);
+}
+async function executeGenerateGameVideo(args, deps = defaultDeps9) {
   let canvasJob;
   try {
     const input = buildVideoInput(args);
@@ -25569,9 +26149,33 @@ async function startServer() {
   await server.connect(transport);
 }
 
+// src/background/generationWorker.ts
+var defaultExecutors = {
+  generate_game_image: (args) => executeGenerateGameImage(args),
+  cutout_game_image: (args) => executeCutoutGameImage(args),
+  generate_game_video: (args) => executeGenerateGameVideo(args)
+};
+async function runBackgroundGenerationWorker(requestPath, executors = defaultExecutors) {
+  const request = await readBackgroundTaskRequest(requestPath);
+  let result;
+  try {
+    result = await executors[request.kind](request.args);
+  } catch (error2) {
+    result = toolError(error2);
+  }
+  await writeBackgroundTaskResult(requestPath, request.taskId, result);
+  return 0;
+}
+
 // src/index.ts
 async function main() {
   const command = process.argv[2];
+  if (command === INTERNAL_GENERATION_WORKER_COMMAND) {
+    const requestPath = process.argv[3];
+    if (!requestPath) throw new Error("Missing background generation request path");
+    process.exitCode = await runBackgroundGenerationWorker(requestPath);
+    return;
+  }
   if (!command) {
     await startServer();
     return;