@gitruck/cli 0.2.8 → 0.2.10

package/dist/index.js

@@ -4197,7 +4197,7 @@ var {
 
 // src/index.ts
 import { readFileSync as readFileSync5 } from "node:fs";
-import { join as join21 } from "node:path";
+import { join as join27 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -4221,6 +4221,9 @@ var GITRUCK_HOME = join(homedir(), ".gitruck");
 function gitruckHome() {
   return GITRUCK_HOME;
 }
+function homeFile(name) {
+  return join(GITRUCK_HOME, name);
+}
 function ffmpegDir() {
   return join(GITRUCK_HOME, "ffmpeg");
 }
@@ -4280,7 +4283,9 @@ var SKILL_NAMES = [
   "gtrk-matrix",
   "gtrk-mg",
   "gtrk-ai-drama",
-  "gtrk-style-maker"
+  "gtrk-style-maker",
+  "gtrk-transcript",
+  "gtrk-tools"
 ];
 function installSkill(opts = {}) {
   const destRoot = opts.dir ?? join2(homedir2(), ".claude", "skills");
@@ -4302,7 +4307,7 @@ function installSkill(opts = {}) {
       log.warn(`skill 安装失败（${name}，不影响命令行使用）：${e instanceof Error ? e.message : String(e)}`);
     }
   }
-  log.info("在 Claude Code 里打 /gtrk-oralcut、/gtrk-splitter 或 /gtrk-style-maker，也可直接说「帮我剪个口播 / 拆个分镜 / 造我栏目的风格 skill」触发（可能需重载会话）。");
+  log.info("在 Claude Code 里打 /gtrk-oralcut、/gtrk-transcript 或 /gtrk-tools，也可直接说「帮我剪个口播 / 把本地视频转成文字稿 / 给视频声音降噪」触发（可能需重载会话）。");
   return allOk;
 }
 function registerSkills(program2) {
@@ -5544,6 +5549,10 @@ class CloudError extends Error {
     this.name = "CloudError";
   }
 }
+function cloudErrorCode(error) {
+  const code = error && typeof error === "object" ? error.code : undefined;
+  return typeof code === "number" ? code : undefined;
+}
 async function parseJson(res) {
   try {
     return await res.json();
@@ -5551,38 +5560,58 @@ async function parseJson(res) {
     throw new Error(`服务响应解析失败 (HTTP ${res.status})`);
   }
 }
-async function uploadFile(cfg, path) {
-  const size = (await stat(path)).size;
-  const boundary = `----gtrkFormBoundary${randomBytes(16).toString("hex")}`;
-  const head = Buffer.from(`--${boundary}\r
+function globalBunFile() {
+  const bun = globalThis.Bun;
+  return bun ? bun.file.bind(bun) : undefined;
+}
+async function uploadFile(cfg, path, runtime = {}) {
+  const fetchFn = runtime.fetchFn ?? fetch;
+  const bunFile = runtime.bunFile ?? globalBunFile();
+  const useBun = runtime.runtime ? runtime.runtime === "bun" : bunFile != null;
+  let res;
+  if (useBun) {
+    if (!bunFile)
+      throw new Error("Bun 上传运行时缺少 Bun.file");
+    const form = new FormData;
+    form.append("file", bunFile(path), basename(path));
+    res = await fetchFn(`${cfg.base}/base/file/upload`, {
+      method: "POST",
+      headers: { Authorization: cfg.apiKey },
+      body: form
+    });
+  } else {
+    const size = (await stat(path)).size;
+    const boundary = `----gtrkFormBoundary${randomBytes(16).toString("hex")}`;
+    const head = Buffer.from(`--${boundary}\r
 ` + `Content-Disposition: form-data; name="file"; filename="${basename(path)}"\r
 ` + `Content-Type: application/octet-stream\r
 \r
 `, "utf8");
-  const tail = Buffer.from(`\r
+    const tail = Buffer.from(`\r
 --${boundary}--\r
 `, "utf8");
-  async function* multipart() {
-    yield head;
-    for await (const chunk of createReadStream(path))
-      yield chunk;
-    yield tail;
+    async function* multipart() {
+      yield head;
+      for await (const chunk of createReadStream(path))
+        yield chunk;
+      yield tail;
+    }
+    res = await fetchFn(`${cfg.base}/base/file/upload`, {
+      method: "POST",
+      headers: {
+        Authorization: cfg.apiKey,
+        "Content-Type": `multipart/form-data; boundary=${boundary}`,
+        "Content-Length": String(head.length + size + tail.length)
+      },
+      body: Readable.toWeb(Readable.from(multipart())),
+      duplex: "half"
+    });
   }
-  const res = await fetch(`${cfg.base}/base/file/upload`, {
-    method: "POST",
-    headers: {
-      Authorization: cfg.apiKey,
-      "Content-Type": `multipart/form-data; boundary=${boundary}`,
-      "Content-Length": String(head.length + size + tail.length)
-    },
-    body: Readable.toWeb(Readable.from(multipart())),
-    duplex: "half"
-  });
   const r = await parseJson(res);
   const fid = r.data?.file_id ?? r.data?.id;
   if (r.code === 200 && fid)
     return String(fid);
-  throw new Error(`上传失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
+  throw new CloudError(r.code, `上传失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
 }
 async function submitTask(cfg, taskType, payload) {
   const res = await fetch(`${cfg.base}/task/${taskType}`, {
@@ -5593,7 +5622,7 @@ async function submitTask(cfg, taskType, payload) {
   const r = await parseJson(res);
   if (r.code === 200 && r.data?.task_id)
     return String(r.data.task_id);
-  throw new Error(`提交失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
+  throw new CloudError(r.code, `提交失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
 }
 async function getTaskResult(cfg, taskType, taskId) {
   const res = await fetch(`${cfg.base}/task/${taskType}/${taskId}`, {
@@ -5881,10 +5910,12 @@ async function putPart(cfg, uploadId, idx, view) {
 var CACHE_DIR = gitruckHome();
 var CACHE_FILE = join10(CACHE_DIR, "upload-cache.json");
 var SESSION_FILE = join10(CACHE_DIR, "upload-sessions.json");
-async function fingerprint(path) {
-  const s = await stat3(path);
+function fingerprintFromStat(s) {
   return `${s.size}:${Math.round(s.mtimeMs)}`;
 }
+async function fingerprint(path) {
+  return fingerprintFromStat(await stat3(path));
+}
 async function load() {
   if (!existsSync9(CACHE_FILE))
     return {};
@@ -5898,6 +5929,12 @@ async function save(cache) {
   await mkdir(CACHE_DIR, { recursive: true });
   await writeFile2(CACHE_FILE, JSON.stringify(cache, null, 2));
 }
+var defaultUploadCacheDeps = {
+  stat: stat3,
+  uploadFile,
+  uploadChunked,
+  cacheStore: { load, save }
+};
 async function invalidateUpload(path) {
   const fp = await fingerprint(path);
   const cache = await load();
@@ -5936,19 +5973,22 @@ var fileSessionStore = {
     }
   }
 };
-async function uploadCached(cfg, path, opts) {
-  const fp = await fingerprint(path);
-  const cache = await load();
+async function uploadCached(cfg, path, opts, deps = defaultUploadCacheDeps) {
+  const s0 = await deps.stat(path);
+  const fp = fingerprintFromStat(s0);
+  const cache = await deps.cacheStore.load();
   const hit = cache[fp]?.fileId;
   if (!opts?.force && hit)
     return { fileId: hit, cached: true };
-  const s0 = await stat3(path);
-  const fileId = s0.size >= CHUNK_THRESHOLD ? await uploadChunked(cfg, path, {
+  const fileId = s0.size >= CHUNK_THRESHOLD ? await deps.uploadChunked(cfg, path, {
     fingerprint: fp,
     store: fileSessionStore,
     force: opts?.force
-  }) : await uploadFile(cfg, path);
-  const s = await stat3(path);
+  }) : await deps.uploadFile(cfg, path);
+  const s = await deps.stat(path);
+  if (s.size !== s0.size || Math.round(s.mtimeMs) !== Math.round(s0.mtimeMs)) {
+    throw new Error("上传过程中输入文件发生变化，请等待文件写入完成后重试");
+  }
   cache[fp] = {
     fileId,
     size: s.size,
@@ -5956,10 +5996,50 @@ async function uploadCached(cfg, path, opts) {
     path,
     uploadedAt: Date.now()
   };
-  await save(cache);
+  await deps.cacheStore.save(cache);
   return { fileId, cached: false };
 }
 
+// src/lib/upload-submit.ts
+var MATERIAL_NOT_FOUND = 6004;
+var DEFAULT_VISIBILITY_BACKOFF_MS = [250, 750, 1500, 3000];
+var defaultDeps = {
+  uploadCached,
+  invalidateUpload,
+  submitTask,
+  sleep: (ms) => new Promise((resolve3) => setTimeout(resolve3, ms))
+};
+async function submitFreshFile(cfg, taskType, fileId, buildPayload, backoffMs, deps) {
+  for (let attempt = 0;; attempt++) {
+    try {
+      return await deps.submitTask(cfg, taskType, buildPayload(fileId));
+    } catch (error) {
+      if (cloudErrorCode(error) !== MATERIAL_NOT_FOUND || attempt >= backoffMs.length)
+        throw error;
+      await deps.sleep(backoffMs[attempt]);
+    }
+  }
+}
+async function uploadAndSubmitTask(cfg, path, taskType, buildPayload, options = {}, deps = defaultDeps) {
+  let uploaded = await deps.uploadCached(cfg, path, { force: options.force });
+  options.onUploaded?.(uploaded);
+  const backoffMs = options.visibilityBackoffMs ?? DEFAULT_VISIBILITY_BACKOFF_MS;
+  if (uploaded.cached) {
+    try {
+      const taskId2 = await deps.submitTask(cfg, taskType, buildPayload(uploaded.fileId));
+      return { taskId: taskId2, fileId: uploaded.fileId, cached: true };
+    } catch (error) {
+      if (cloudErrorCode(error) !== MATERIAL_NOT_FOUND)
+        throw error;
+      options.onCacheInvalid?.();
+      await deps.invalidateUpload(path);
+      uploaded = await deps.uploadCached(cfg, path, { force: true });
+    }
+  }
+  const taskId = await submitFreshFile(cfg, taskType, uploaded.fileId, buildPayload, backoffMs, deps);
+  return { taskId, fileId: uploaded.fileId, cached: false };
+}
+
 // src/lib/media.ts
 import { mkdir as mkdir2, stat as stat4 } from "node:fs/promises";
 import { existsSync as existsSync10 } from "node:fs";
@@ -6487,8 +6567,6 @@ async function runOralCut(input, opts) {
   assertDurationConsistent(geo.duration, artifact, opts.ffmpegPath);
   log.info(opts.visualAssist ? `已压 720p 代理（上传物）：${basename5(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename5(artifact)}`);
   log.step("② 上传抽出物到云端…");
-  let up = await uploadCached(cfg, artifact, { force: opts.reupload });
-  log.info(up.cached ? `命中上传缓存，复用 file_id = ${up.fileId}（免二次上传）` : `file_id = ${up.fileId}`);
   const buildPayload = (fid) => {
     const p = {
       file_id: fid,
@@ -6515,19 +6593,16 @@ async function runOralCut(input, opts) {
     }
     return p;
   };
-  log.step("③ 提交智能口播剪辑任务…");
-  let taskId;
-  try {
-    taskId = await submitTask(cfg, TASK_TYPE, buildPayload(up.fileId));
-  } catch (e) {
-    if (up.cached && e instanceof CloudError && e.code === 6004) {
-      log.warn("缓存的 file_id 在云端已失效，重新上传后重试…");
-      await invalidateUpload(artifact);
-      up = await uploadCached(cfg, artifact, { force: true });
-      taskId = await submitTask(cfg, TASK_TYPE, buildPayload(up.fileId));
-    } else
-      throw e;
-  }
+  const submitted = await uploadAndSubmitTask(cfg, artifact, TASK_TYPE, buildPayload, {
+    force: opts.reupload,
+    onUploaded: (uploaded) => {
+      log.info(uploaded.cached ? `命中上传缓存，复用 file_id = ${uploaded.fileId}（免二次上传）` : `file_id = ${uploaded.fileId}`);
+      log.step("③ 提交智能口播剪辑任务…");
+    },
+    onCacheInvalid: () => log.warn("缓存的 file_id 在云端已失效，重新上传后重试…")
+  });
+  const { taskId } = submitted;
+  const up = { fileId: submitted.fileId, cached: submitted.cached };
   log.info(`task_id = ${taskId}`);
   await mkdir4(outDir, { recursive: true });
   await writeFile5(join14(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE, fileId: up.fileId, source: inputAbs, formats, createdAt: new Date().toISOString() }, null, 2));
@@ -8171,12 +8246,2724 @@ function done(opts, result) {
   return result;
 }
 
+// src/lib/tool-descriptors.ts
+import { extname as extname4 } from "node:path";
+var IMAGE_EXTS = [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".tif", ".tiff", ".heic", ".heif", ".avif"];
+var VIDEO_EXTS = [".mp4", ".mov", ".mkv", ".webm", ".avi", ".m4v", ".flv", ".wmv", ".mpg", ".mpeg", ".ts", ".m2ts"];
+var AUDIO_EXTS = [".mp3", ".wav", ".m4a", ".aac", ".flac", ".ogg", ".opus", ".wma"];
+var PUBLIC_VIDEO_EXTS = [
+  ".mp4",
+  ".avi",
+  ".mpg",
+  ".mov",
+  ".flv",
+  ".mxf",
+  ".mpeg",
+  ".ogg",
+  ".3gp",
+  ".wmv",
+  ".h264",
+  ".m4v",
+  ".ts"
+];
+function defaultExtsFor(kind) {
+  if (kind === "image")
+    return IMAGE_EXTS;
+  if (kind === "video")
+    return VIDEO_EXTS;
+  if (kind === "audio")
+    return AUDIO_EXTS;
+  return;
+}
+function pickUrl(out, keys) {
+  for (const k of keys) {
+    const v = out[k];
+    if (typeof v === "string" && v.trim())
+      return v;
+  }
+  return;
+}
+function extFromUrl(url, fallback) {
+  let path = url;
+  try {
+    path = new URL(url).pathname;
+  } catch {
+    path = url.split("?")[0] ?? url;
+  }
+  const e = extname4(path);
+  return e || fallback;
+}
+function deriveMoveGeometry(dims) {
+  if (!dims || !(dims.width > 0) || !(dims.height > 0))
+    return { fellBack: true };
+  return dims.height > dims.width ? { width: 1080, height: 1920, fellBack: false } : { width: 1920, height: 1080, fellBack: false };
+}
+function probeImageDims(inputAbs, ffmpegPath) {
+  if (!resolveFfmpeg(ffmpegPath))
+    return;
+  try {
+    const g2 = probeGeometry(inputAbs, ffmpegPath);
+    if (g2.width > 0 && g2.height > 0)
+      return { width: g2.width, height: g2.height };
+  } catch {}
+  return;
+}
+var imageMove = {
+  name: "image_move",
+  title: "图转运镜",
+  description: "把一张静态图生成带运镜的短视频。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_move_local",
+  outputHint: "运镜视频",
+  enabled: true,
+  taskType: "image_move",
+  buildPayload(fileId, ctx) {
+    const p = { file_id: fileId };
+    const explicit = ctx.extraParams.width != null || ctx.extraParams.height != null;
+    if (!explicit && ctx.inputAbs) {
+      const dims = probeImageDims(ctx.inputAbs, ctx.ffmpegPath);
+      const geo = deriveMoveGeometry(dims);
+      if (geo.width && geo.height) {
+        p.width = geo.width;
+        p.height = geo.height;
+      }
+      if (geo.fellBack) {
+        ctx.warn("未探测到图片朝向（缺 ffprobe），将按云端默认横屏 1920×1080 出片；" + "可用 --param width=… --param height=… 显式指定几何。");
+      }
+    }
+    return p;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url", "video_download_url", "url"]);
+    if (!url)
+      return [];
+    return [{ url, filename: `${ctx.baseName}-image_move${extFromUrl(url, ".mp4")}` }];
+  }
+};
+var imageMatting = {
+  name: "image_matting",
+  title: "图片抠像",
+  description: "把图片主体从背景抠出，产透明背景 png（可经 --param 请求额外背景底板输出）。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_matting",
+  outputHint: "透明 png",
+  enabled: true,
+  taskType: "image_matting",
+  buildPayload(fileId) {
+    return { file_id: fileId, output_format: "png" };
+  },
+  mapOutputs(out, ctx) {
+    const files = [];
+    const main = pickUrl(out, ["download_url", "image_download_url", "url"]);
+    if (main)
+      files.push({ url: main, filename: `${ctx.baseName}-matte${extFromUrl(main, ".png")}` });
+    const bg = pickUrl(out, ["background_download_url", "bg_download_url"]);
+    if (bg)
+      files.push({ url: bg, filename: `${ctx.baseName}-bg${extFromUrl(bg, ".png")}` });
+    return files;
+  }
+};
+var imageBlackborderRemove = {
+  name: "image_blackborder_remove",
+  title: "图片去黑边",
+  description: "自动检测并裁去单张图片四周的黑边，保留有效画面。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_blackborder_remove",
+  outputHint: "去黑边图片",
+  enabled: true,
+  taskType: "image_blackborder_remove",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-blackborder-removed${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var imageCanvasAdapt = {
+  name: "image_canvas_adapt",
+  title: "图片比例转换",
+  description: "把单张图片适配到目标画布尺寸，可选适配、矩形裁剪或方形裁剪。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_canvas_adapt",
+  outputHint: "比例适配图片",
+  enabled: true,
+  taskType: "image_canvas_adapt",
+  options: [
+    { flag: "--canvas-width <px>", desc: "目标画布宽度（像素；未传则使用服务端默认）" },
+    { flag: "--canvas-height <px>", desc: "目标画布高度（像素；未传则使用服务端默认）" },
+    {
+      flag: "--canvas-type <normal|rectangle|square>",
+      desc: "画布模式：normal、rectangle 或 square（未传则使用服务端默认）"
+    }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["canvasWidth", "canvas_width", "--canvas-width"],
+      ["canvasHeight", "canvas_height", "--canvas-height"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value))
+        throw new Error(`${flag} 必须是数字`);
+      payload[payloadKey] = value;
+    }
+    if (ctx.opts.canvasType != null) {
+      const value = String(ctx.opts.canvasType);
+      if (value !== "normal" && value !== "rectangle" && value !== "square") {
+        throw new Error("--canvas-type 只支持 normal、rectangle 或 square");
+      }
+      payload.canvas_type = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-canvas-adapted${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var imagePurify = {
+  name: "image_purify",
+  title: "图片净化",
+  description: "清理你有权处理的图片中的水印、Logo 或叠加元素。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_purify",
+  outputHint: "净化图片",
+  enabled: true,
+  taskType: "image_purify",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-purified${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var videoBlackborderRemove = {
+  name: "video_blackborder_remove",
+  title: "视频去黑边",
+  description: "自动检测并裁去单条视频四周的黑边，保留有效画面与原音轨。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_blackborder_remove",
+  outputHint: "去黑边视频",
+  enabled: true,
+  taskType: "video_blackborder_remove",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-blackborder-removed${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoCanvasAdapt = {
+  name: "video_canvas_adapt",
+  title: "视频比例转换",
+  description: "把单条视频适配到目标画布，可选截取时间片段并移除音轨。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_canvas_adapt",
+  outputHint: "比例适配视频",
+  enabled: true,
+  taskType: "video_canvas_adapt",
+  options: [
+    { flag: "--canvas-width <px>", desc: "目标画布宽度（像素；未传则使用服务端默认）" },
+    { flag: "--canvas-height <px>", desc: "目标画布高度（像素；未传则使用服务端默认）" },
+    {
+      flag: "--canvas-type <normal|rectangle|square>",
+      desc: "画布模式：normal、rectangle 或 square（未传则使用服务端默认）"
+    },
+    { flag: "--clip-start <frame>", desc: "截取起始帧序号（未传则使用服务端默认）" },
+    { flag: "--clip-end <frame>", desc: "截取结束帧序号（未传则使用服务端默认）" },
+    { flag: "--without-audio", desc: "输出视频不保留音轨" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["canvasWidth", "target_width", "--canvas-width"],
+      ["canvasHeight", "target_height", "--canvas-height"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${flag} 必须是有限整数`);
+      }
+      payload[payloadKey] = value;
+    }
+    for (const [optKey, payloadKey, flag] of [
+      ["clipStart", "start", "--clip-start"],
+      ["clipEnd", "end", "--clip-end"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${flag} 必须是有限整数帧号`);
+      }
+      payload[payloadKey] = value;
+    }
+    if (ctx.opts.canvasType != null) {
+      const value = String(ctx.opts.canvasType);
+      if (value !== "normal" && value !== "rectangle" && value !== "square") {
+        throw new Error("--canvas-type 只支持 normal、rectangle 或 square");
+      }
+      payload.canvas_type = value;
+    }
+    if (ctx.opts.withoutAudio === true)
+      payload.need_audio = false;
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-canvas-adapted${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoStabilizer = {
+  name: "video_stabilizer",
+  title: "视频防抖",
+  description: "稳定手持或运动拍摄画面；exp 为实验方式，产物观感需自行检查。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_stabilizer",
+  outputHint: "防抖视频",
+  enabled: true,
+  taskType: "video_stabilizer",
+  options: [{ flag: "--stabilizer-method <fast|exp|turbo>", desc: "防抖方式（未传则使用服务端 turbo 默认值）" }],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.stabilizerMethod == null)
+      return payload;
+    const method = String(ctx.opts.stabilizerMethod);
+    if (method !== "fast" && method !== "exp" && method !== "turbo") {
+      throw new Error("--stabilizer-method 只支持 fast、exp 或 turbo");
+    }
+    payload.method = method;
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-stabilized${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoVaporwave = {
+  name: "video_vaporwave",
+  title: "视频蒸汽波滤镜",
+  description: "按精确预设名称为单条视频应用蒸汽波风格滤镜。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_vaporwave",
+  outputHint: "蒸汽波滤镜视频",
+  enabled: true,
+  taskType: "video_vaporwave",
+  options: [{ flag: "--vaporwave-filter <name>", desc: "精确滤镜名称（默认：愈漸升溫）" }],
+  buildPayload(fileId, ctx) {
+    const raw = ctx.opts.vaporwaveFilter;
+    const filter = raw == null ? "愈漸升溫" : String(raw);
+    if (!filter.trim())
+      throw new Error("--vaporwave-filter 不能为空");
+    return { file_id: fileId, filter };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-vaporwave${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+function parseNormalizedRoi(value) {
+  let rawValues;
+  let acceptNumericStrings = false;
+  if (typeof value === "string") {
+    acceptNumericStrings = true;
+    const parts = value.split(",");
+    if (parts.length !== 4 || parts.some((part) => !part.trim())) {
+      throw new Error("--purify-roi 必须是 x,y,w,h 四个归一化数字");
+    }
+    rawValues = parts;
+  } else if (value && typeof value === "object" && !Array.isArray(value)) {
+    const roi = value;
+    rawValues = [roi.x, roi.y, roi.w, roi.h];
+  } else {
+    throw new Error("ROI 必须包含归一化数字 x、y、w、h");
+  }
+  const numbers = rawValues.map((item) => {
+    if (typeof item === "number")
+      return item;
+    if (acceptNumericStrings && typeof item === "string")
+      return Number(item);
+    return Number.NaN;
+  });
+  if (numbers.some((item) => !Number.isFinite(item))) {
+    throw new Error("ROI 的 x、y、w、h 必须是有限数字");
+  }
+  const [x, y, w, h] = numbers;
+  if (x < 0 || x > 1 || y < 0 || y > 1 || w <= 0 || w > 1 || h <= 0 || h > 1 || x + w > 1 || y + h > 1) {
+    throw new Error("ROI 必须满足 0≤x,y≤1、0<w,h≤1、x+w≤1、y+h≤1");
+  }
+  return { x, y, w, h };
+}
+var videoPurify = {
+  name: "video_purify",
+  title: "视频净化",
+  description: "清理你有权处理的视频中的水印、字幕或指定区域；不承诺还原被遮挡的原始内容。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_purify",
+  outputHint: "净化视频",
+  enabled: true,
+  taskType: "video_purify",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    {
+      flag: "--purify-scope <full_screen|subtitle|custom>",
+      desc: "净化范围；未传时使用服务端 full_screen 默认值"
+    },
+    {
+      flag: "--purify-method <ffmpeg|raft>",
+      desc: "净化方式；未传时使用服务端 ffmpeg 默认值，raft 仅支持 20 分钟以内视频"
+    },
+    { flag: "--purify-roi <x,y,w,h>", desc: "custom 模式的归一化矩形区域" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    const scopeRaw = ctx.opts.purifyScope;
+    const scope = scopeRaw == null ? undefined : String(scopeRaw);
+    if (scope != null && scope !== "full_screen" && scope !== "subtitle" && scope !== "custom") {
+      throw new Error("--purify-scope 只支持 full_screen、subtitle 或 custom");
+    }
+    if (scope != null)
+      payload.purify_scope = scope;
+    const methodRaw = ctx.opts.purifyMethod;
+    const method = methodRaw == null ? undefined : String(methodRaw);
+    if (method != null && method !== "ffmpeg" && method !== "raft") {
+      throw new Error("--purify-method 只支持 ffmpeg 或 raft");
+    }
+    if (method != null)
+      payload.purify_func_type = method;
+    const roiRaw = ctx.opts.purifyRoi;
+    if (roiRaw != null) {
+      if (scope !== "custom") {
+        throw new Error("--purify-roi 只能与 --purify-scope custom 一起使用");
+      }
+      payload.roi = parseNormalizedRoi(roiRaw);
+    } else if (scope === "custom") {
+      if (ctx.extraParams.roi == null) {
+        throw new Error("--purify-scope custom 必须同时提供 --purify-roi 或 params-json.roi");
+      }
+      parseNormalizedRoi(ctx.extraParams.roi);
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-purified${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoUpscale = {
+  name: "video_upscale",
+  title: "视频超分",
+  description: "对一分钟以内的低分辨率视频做实验性 GPU 超分；效果需自行检查。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS, maxDurationSec: 60 },
+  priceKey: "video_upscale",
+  outputHint: "超分视频",
+  enabled: true,
+  taskType: "video_upscale",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    { flag: "--upscale-times <2|3|4>", desc: "超分倍数；未传时使用服务端 2 倍默认值" },
+    { flag: "--upscale-type <Reality|Anime>", desc: "写实或动漫类型；未传时使用服务端 Reality 默认值" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.upscaleTimes != null) {
+      const times = Number(ctx.opts.upscaleTimes);
+      if (!Number.isInteger(times) || times !== 2 && times !== 3 && times !== 4) {
+        throw new Error("--upscale-times 只支持 2、3 或 4");
+      }
+      payload.times = times;
+    }
+    if (ctx.opts.upscaleType != null) {
+      const upscaleType = String(ctx.opts.upscaleType);
+      if (upscaleType !== "Reality" && upscaleType !== "Anime") {
+        throw new Error("--upscale-type 只支持 Reality 或 Anime");
+      }
+      payload.upscale_type = upscaleType;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-upscaled${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoInterpolate = {
+  name: "video_interpolate",
+  title: "视频插帧",
+  description: "以 GPU 帧插值提升视频流畅度；不附加未经服务端声明的时长限制。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_interpolate",
+  outputHint: "插帧视频",
+  enabled: true,
+  taskType: "video_interpolate",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    { flag: "--interpolate-multiplier <2|3|4>", desc: "插帧倍数；未传时使用服务端 2 倍默认值" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.interpolateMultiplier != null) {
+      const multiplier = Number(ctx.opts.interpolateMultiplier);
+      if (!Number.isInteger(multiplier) || multiplier !== 2 && multiplier !== 3 && multiplier !== 4) {
+        throw new Error("--interpolate-multiplier 只支持 2、3 或 4");
+      }
+      payload.multiplier = multiplier;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-interpolated${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoMatting = {
+  name: "video_matting",
+  title: "视频抠像",
+  description: "把视频主体从背景抠出，产透明背景 webm（像素级、原片直传不压代理；单片 ≤10 分钟）。",
+  kind: "cloud",
+  input: { kind: "video", maxDurationSec: 600 },
+  priceKey: "video_matting",
+  outputHint: "透明 webm",
+  enabled: true,
+  taskType: "video_matting",
+  pollTimeoutMs: 60 * 60 * 1000,
+  buildPayload(fileId) {
+    return { file_id: fileId, target_mode: "auto", output_format: "webm" };
+  },
+  mapOutputs(out, ctx) {
+    const files = [];
+    const main = pickUrl(out, ["download_url", "video_download_url", "url"]);
+    if (main)
+      files.push({ url: main, filename: `${ctx.baseName}-matte${extFromUrl(main, ".webm")}` });
+    const mask2 = pickUrl(out, ["mask_download_url"]);
+    if (mask2)
+      files.push({ url: mask2, filename: `${ctx.baseName}-mask${extFromUrl(mask2, ".webm")}` });
+    return files;
+  }
+};
+var audioSeparation = {
+  name: "audio_separation",
+  title: "人声伴奏分离",
+  description: "把单条音频分离为人声与伴奏，可返回其中一项或两项。",
+  kind: "cloud",
+  input: { kind: "audio" },
+  priceKey: "audio_separation",
+  outputHint: "人声与伴奏音频",
+  enabled: true,
+  taskType: "audio_separation",
+  options: [{ flag: "--mode <fast|turbo>", desc: "处理档位（默认 fast，可选 turbo）" }],
+  buildPayload(fileId, ctx) {
+    const raw = ctx.opts.mode;
+    const mode = raw == null ? "fast" : String(raw);
+    if (mode !== "fast" && mode !== "turbo")
+      throw new Error("--mode 只支持 fast 或 turbo");
+    return { file_id: fileId, mode };
+  },
+  mapOutputs(out, ctx) {
+    if (!Array.isArray(out.files))
+      return [];
+    const items = [];
+    for (const raw of out.files) {
+      if (!raw || typeof raw !== "object")
+        continue;
+      const file = raw;
+      const type = file.type;
+      const url = file.download_url;
+      if (type !== "vocals" && type !== "instrumental" || typeof url !== "string" || !url.trim())
+        continue;
+      items.push({ url, filename: `${ctx.baseName}-${type}${extFromUrl(url, ".wav")}` });
+    }
+    return items;
+  }
+};
+var audioNoiseReduce = {
+  name: "audio_noise_reduce",
+  title: "音频降噪",
+  description: "对音频或视频中的声音降噪，输出降噪后的音频。",
+  kind: "cloud",
+  input: { kind: "audio", exts: [...AUDIO_EXTS, ...VIDEO_EXTS] },
+  priceKey: "audio_noise_reduce",
+  outputHint: "降噪音频",
+  enabled: true,
+  taskType: "audio_noise_reduce",
+  options: [{ flag: "--prop-decrease <0..1>", desc: "降噪强度（0 到 1；未传则使用服务端默认）" }],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.propDecrease != null) {
+      const value = Number(ctx.opts.propDecrease);
+      if (!Number.isFinite(value) || value < 0 || value > 1)
+        throw new Error("--prop-decrease 必须是 0 到 1 的数字");
+      payload.prop_decrease = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-denoise${extFromUrl(url, ".wav")}` }] : [];
+  }
+};
+var audioSilenceRemove = {
+  name: "audio_silence_remove",
+  title: "静音片段移除",
+  description: "移除音频中过长的静音片段，输出压缩停顿后的音频。",
+  kind: "cloud",
+  input: { kind: "audio" },
+  priceKey: "audio_silence_remove",
+  outputHint: "去静音音频",
+  enabled: true,
+  taskType: "audio_silence_remove",
+  options: [
+    { flag: "--min-silence-len <ms>", desc: "被视为静音片段的最短毫秒数（未传则使用服务端默认）" },
+    { flag: "--desired-silence-len <ms>", desc: "处理后保留的静音毫秒数（未传则使用服务端默认）" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["minSilenceLen", "min_silence_len", "--min-silence-len"],
+      ["desiredSilenceLen", "desired_silence_len", "--desired-silence-len"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || value < 0)
+        throw new Error(`${flag} 必须是非负毫秒数`);
+      payload[payloadKey] = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-desilence${extFromUrl(url, ".wav")}` }] : [];
+  }
+};
+var mad = {
+  name: "mad",
+  title: "一键剪 MAD",
+  description: "素材文件夹（3~10 条视频）+ 可选 BGM → 自动选技法 → 单一 .jsx，AE 2020+ 跑一遍出 15~30s 卡点成片工程。仅支持 AE。",
+  kind: "local",
+  input: { kind: "directory" },
+  priceKey: "audio_music_analyze",
+  pricingContext: "仅 --bgm 卡点时",
+  outputHint: "AE 母合成工程 .jsx",
+  enabled: true,
+  options: [
+    { flag: "--bgm <音频文件>", desc: "可选 BGM，卡点到 downbeat（需 API Key，计费一次；无 Key 则 BGM 仍入轨、固定节奏）" },
+    { flag: "--duration <秒>", desc: "成片目标时长（默认 20，文案口径 15~30）" },
+    { flag: "--seed <n>", desc: "选窗随机种子（同素材同种子同数据版本 → 可复现同序列）" },
+    { flag: "--refresh", desc: "强制忽略本地缓存、重拉当前 manifest 版本数据" }
+  ]
+};
+var RESERVED_NAMES = new Set(["list"]);
+var TOOL_REGISTRY = [
+  imageMove,
+  imageMatting,
+  imageBlackborderRemove,
+  imageCanvasAdapt,
+  imagePurify,
+  videoMatting,
+  videoBlackborderRemove,
+  videoCanvasAdapt,
+  videoStabilizer,
+  videoVaporwave,
+  videoPurify,
+  videoUpscale,
+  videoInterpolate,
+  audioSeparation,
+  audioNoiseReduce,
+  audioSilenceRemove,
+  mad
+];
+function findTool(name, registry = TOOL_REGISTRY) {
+  return registry.find((d) => d.name === name);
+}
+function validateRegistry(registry = TOOL_REGISTRY) {
+  const seen = new Set;
+  for (const d of registry) {
+    if (!d.name)
+      throw new Error("descriptor 缺 name");
+    if (RESERVED_NAMES.has(d.name))
+      throw new Error(`descriptor 名与保留字冲突：「${d.name}」`);
+    if (seen.has(d.name))
+      throw new Error(`descriptor 名重复：「${d.name}」`);
+    seen.add(d.name);
+    if (!d.enabled && !d.disabledReason)
+      throw new Error(`未启用工具缺 disabledReason：「${d.name}」`);
+    if (d.kind === "cloud" && !d.taskType)
+      throw new Error(`cloud 型工具缺 taskType：「${d.name}」`);
+    if (d.kind === "cloud" && !d.priceKey)
+      throw new Error(`cloud 型工具缺 priceKey：「${d.name}」`);
+  }
+}
+
+// src/lib/tool-runner.ts
+import { resolve as resolve9, join as join21, dirname as dirname8, basename as basename11, extname as extname5 } from "node:path";
+import { mkdir as mkdir8, writeFile as writeFile8, stat as stat5 } from "node:fs/promises";
+import { createWriteStream, existsSync as existsSync17 } from "node:fs";
+import { Readable as Readable2 } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
+// src/lib/tool-pricing.ts
+var TOOL_PRICE_LIST_URL = "https://cloud.ai-mcn.tv/api/get_price_list";
+var PRICE_UNAVAILABLE_HINT = "实时价格暂不可用，以服务端结算为准";
+var PRICE_REQUEST_TIMEOUT_MS = 5000;
+function validNumber(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+function parseToolPriceList(value) {
+  if (!Array.isArray(value))
+    throw new Error("价格表响应不是数组");
+  const prices = new Map;
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const item = raw;
+    const key = typeof item.key === "string" ? item.key.trim() : "";
+    const measure = typeof item.measure === "string" ? item.measure.trim() : "";
+    if (!key || !measure || !validNumber(item.price) || !validNumber(item.exPrice))
+      continue;
+    prices.set(key, {
+      ...validNumber(item.taskTypeId) ? { taskTypeId: item.taskTypeId } : {},
+      ...typeof item.name === "string" ? { name: item.name } : {},
+      key,
+      price: item.price,
+      exPrice: item.exPrice,
+      measure,
+      ...typeof item.note === "string" ? { note: item.note } : {}
+    });
+  }
+  return prices;
+}
+async function fetchToolPrices(fetchFn = fetch) {
+  const res = await fetchFn(TOOL_PRICE_LIST_URL, {
+    method: "GET",
+    headers: { Accept: "application/json" },
+    signal: AbortSignal.timeout(PRICE_REQUEST_TIMEOUT_MS)
+  });
+  if (!res.ok)
+    throw new Error(`价格表请求失败 HTTP ${res.status}`);
+  return parseToolPriceList(await res.json());
+}
+function formatToolPrice(item, pricingContext) {
+  let price;
+  if (item.price === 0 && item.exPrice === 0) {
+    price = `免费（0 积分/${item.measure}）`;
+  } else if (item.price === item.exPrice) {
+    price = `${item.price} 积分/${item.measure}`;
+  } else {
+    price = `标准价 ${item.price} 积分/${item.measure}；超额价 ${item.exPrice} 积分/${item.measure}`;
+  }
+  return pricingContext ? `${pricingContext}：${price}` : price;
+}
+function resolveToolPricingFromMap(priceKey, prices, pricingContext) {
+  const item = prices?.get(priceKey);
+  if (!item) {
+    return {
+      billingHint: pricingContext ? `${pricingContext}：${PRICE_UNAVAILABLE_HINT}` : PRICE_UNAVAILABLE_HINT,
+      pricing: { key: priceKey, available: false }
+    };
+  }
+  return {
+    billingHint: formatToolPrice(item, pricingContext),
+    pricing: {
+      key: priceKey,
+      available: true,
+      price: item.price,
+      exPrice: item.exPrice,
+      measure: item.measure
+    }
+  };
+}
+async function resolveToolPricing(priceKey, pricingContext, fetchFn = fetch) {
+  try {
+    return resolveToolPricingFromMap(priceKey, await fetchToolPrices(fetchFn), pricingContext);
+  } catch {
+    return resolveToolPricingFromMap(priceKey, undefined, pricingContext);
+  }
+}
+
+// src/lib/tool-runner.ts
+var DEFAULT_POLL_TIMEOUT_MS = 30 * 60 * 1000;
+var DEFAULT_POLL_INTERVAL_MS = 5000;
+function coerceValue2(v) {
+  if (v === "true")
+    return true;
+  if (v === "false")
+    return false;
+  if (v.trim() !== "" && !Number.isNaN(Number(v)))
+    return Number(v);
+  return v;
+}
+function parseExtraParams2(pairs, jsonStr) {
+  const out = {};
+  for (const pair of pairs) {
+    const i = pair.indexOf("=");
+    if (i < 0)
+      throw new Error(`--param 需要 key=value 格式：「${pair}」`);
+    out[pair.slice(0, i).trim()] = coerceValue2(pair.slice(i + 1));
+  }
+  if (jsonStr) {
+    let parsed;
+    try {
+      parsed = JSON.parse(jsonStr);
+    } catch {
+      throw new Error(`--params-json 不是合法 JSON：${jsonStr}`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      throw new Error("--params-json 必须是一个 JSON 对象");
+    }
+    Object.assign(out, parsed);
+  }
+  return out;
+}
+function mergeParams(payload, extra) {
+  for (const [k, v] of Object.entries(extra)) {
+    const cur = payload[k];
+    const bothObj = !!cur && !!v && typeof cur === "object" && typeof v === "object" && !Array.isArray(cur) && !Array.isArray(v);
+    payload[k] = bothObj ? { ...cur, ...v } : v;
+  }
+}
+function validateToolInput(descriptor, inputAbs) {
+  const spec = descriptor.input;
+  if (spec.kind === "none")
+    return;
+  if (!inputAbs)
+    throw new Error(`${descriptor.name} 需要输入${spec.kind === "directory" ? "目录" : "文件"}`);
+  if (!existsSync17(inputAbs))
+    throw new Error(`输入不存在：${inputAbs}`);
+  if (spec.kind === "directory")
+    return;
+  const exts = spec.exts ?? defaultExtsFor(spec.kind);
+  if (exts && exts.length) {
+    const e = extname5(inputAbs).toLowerCase();
+    if (!exts.includes(e)) {
+      throw new Error(`${descriptor.name} 需要 ${spec.kind} 输入，但拿到「${e || "无扩展名"}」（支持：${exts.join(" ")}）`);
+    }
+  }
+}
+function guardDuration(descriptor, inputAbs, probe, ffmpegPath) {
+  const max = descriptor.input.maxDurationSec;
+  if (max == null || !inputAbs)
+    return;
+  const sec = probe(inputAbs, ffmpegPath);
+  if (sec > max) {
+    throw new Error(`视频超过 ${Math.round(max / 60)} 分钟上限，请先裁剪`);
+  }
+}
+async function downloadStream(url, dest) {
+  const res = await fetch(url);
+  if (!res.ok || !res.body)
+    throw new Error(`下载失败 HTTP ${res.status}：${url}`);
+  await pipeline(Readable2.fromWeb(res.body), createWriteStream(dest));
+}
+async function pollToolTask(cfg, taskType, taskId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+  const intervalMs = opts.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const getResult = opts.getResult ?? getTaskResult;
+  const sleep2 = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const now = opts.now ?? Date.now;
+  const start = now();
+  for (;; ) {
+    if (now() - start > timeoutMs) {
+      throw new Error(`任务超时（超过 ${Math.round(timeoutMs / 60000)} 分钟）。可稍后凭 task_id（${taskId}）在云端查询或重试。`);
+    }
+    await sleep2(intervalMs);
+    let got;
+    try {
+      got = await getResult(cfg, taskType, taskId);
+    } catch (e) {
+      if (isCloudErrorCode(e) != null)
+        throw e;
+      continue;
+    }
+    if (got.status === "completed")
+      return got.output;
+    if (got.status === "failed" || got.status === "cancelled") {
+      const out = got.output;
+      throw new Error(out?.error ?? (got.status === "failed" ? "任务失败" : "任务已取消"));
+    }
+    opts.onTick?.(got.status || "处理中", got.progress);
+  }
+}
+function isCloudErrorCode(e) {
+  const c3 = e && typeof e === "object" ? e.code : undefined;
+  return typeof c3 === "number" ? c3 : undefined;
+}
+function timestamp3() {
+  const d = new Date;
+  const p = (n) => String(n).padStart(2, "0");
+  return `${p(d.getFullYear() % 100)}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
+}
+function resolveOutDir(descriptor, inputAbs, out) {
+  if (out)
+    return resolve9(out);
+  if (inputAbs) {
+    const base = basename11(inputAbs, extname5(inputAbs));
+    return join21(dirname8(inputAbs), `${base}-${descriptor.name}`);
+  }
+  return join21(process.cwd(), `${descriptor.name}-${timestamp3()}`);
+}
+async function safeFingerprint(inputAbs) {
+  try {
+    const s = await stat5(inputAbs);
+    return `${s.size}:${Math.round(s.mtimeMs)}`;
+  } catch {
+    return;
+  }
+}
+function emitBilling(hint) {
+  process.stderr.write(`\x1B[33m⚠️  计费提示：${hint}\x1B[0m
+`);
+}
+async function runCloudTool(descriptor, inputArg, opts, deps) {
+  const inputAbs = inputArg ? resolve9(inputArg) : undefined;
+  const baseName = inputAbs ? basename11(inputAbs, extname5(inputAbs)) : descriptor.name;
+  validateToolInput(descriptor, inputAbs);
+  const probe = deps.probeDurationSec ?? probeDuration;
+  guardDuration(descriptor, inputAbs, probe, opts.ffmpegPath);
+  const extraParams = parseExtraParams2(opts.param ?? [], opts.paramsJson);
+  const ctx = {
+    inputAbs,
+    baseName,
+    ffmpegPath: opts.ffmpegPath,
+    opts,
+    extraParams,
+    warn: (m) => process.stderr.write(`\x1B[2m   ${m}\x1B[0m
+`)
+  };
+  const outDir = resolveOutDir(descriptor, inputAbs, opts.out);
+  let uploadPath = inputAbs;
+  if (descriptor.preprocess)
+    uploadPath = await descriptor.preprocess(ctx);
+  if (!uploadPath)
+    throw new Error(`${descriptor.name} 缺上传物（input=none 的 cloud 型工具需 preprocess 产上传物）`);
+  let billingHint;
+  try {
+    billingHint = (await (deps.resolvePricing ?? resolveToolPricing)(descriptor.priceKey, descriptor.pricingContext)).billingHint;
+  } catch {
+    billingHint = "实时价格暂不可用，以服务端结算为准";
+  }
+  emitBilling(billingHint);
+  const buildPayload = (fid) => {
+    const p = descriptor.buildPayload ? descriptor.buildPayload(fid, ctx) : { file_id: fid };
+    mergeParams(p, extraParams);
+    return p;
+  };
+  const taskType = descriptor.taskType;
+  const submitted = await uploadAndSubmitTask(deps.cfg, uploadPath, taskType, buildPayload, { force: opts.reupload }, {
+    uploadCached: deps.uploadCached,
+    invalidateUpload: deps.invalidateUpload,
+    submitTask: deps.submitTask,
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve10) => setTimeout(resolve10, ms)))
+  });
+  const { taskId } = submitted;
+  const up = { fileId: submitted.fileId, cached: submitted.cached };
+  await mkdir8(outDir, { recursive: true });
+  const fingerprint2 = inputAbs ? await safeFingerprint(inputAbs) : undefined;
+  await writeFile8(join21(outDir, "task.json"), JSON.stringify({ tool: descriptor.name, taskType, taskId, fileId: up.fileId, source: inputAbs, fingerprint: fingerprint2, createdAt: new Date().toISOString() }, null, 2));
+  const output = await pollToolTask(deps.cfg, taskType, taskId, {
+    timeoutMs: descriptor.pollTimeoutMs,
+    intervalMs: deps.pollIntervalMs,
+    getResult: deps.getTaskResult,
+    sleep: deps.sleep,
+    now: deps.now
+  });
+  const items = descriptor.mapOutputs ? descriptor.mapOutputs(output, ctx) : [];
+  const files = [];
+  const errors = {};
+  if (items.length === 0)
+    errors["output"] = "任务完成但未解析到产物下载链接（output_result 形态异常）";
+  for (const it of items) {
+    const dest = join21(outDir, it.filename);
+    try {
+      await deps.downloadStream(it.url, dest);
+      files.push(dest);
+    } catch (e) {
+      errors[it.filename] = e instanceof Error ? e.message : String(e);
+    }
+  }
+  const ok = files.length > 0 && Object.keys(errors).length === 0;
+  const result = {
+    ok,
+    tool: descriptor.name,
+    taskType,
+    taskId,
+    fileId: up.fileId,
+    outDir,
+    files,
+    ...Object.keys(errors).length ? { errors } : {}
+  };
+  await writeFile8(join21(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
+  return result;
+}
+
+// src/lib/mad/mad.ts
+import { mkdir as mkdir11, writeFile as writeFile10 } from "node:fs/promises";
+import { existsSync as existsSync20, statSync as statSync3 } from "node:fs";
+import { resolve as resolve10, join as join25 } from "node:path";
+
+// src/lib/convert/types.ts
+function num(v, d = 0) {
+  return typeof v === "number" && isFinite(v) ? v : d;
+}
+function parseCubicBezier(e) {
+  if (!e || typeof e !== "string")
+    return null;
+  const m = e.match(/cubic-bezier\(\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*\)/);
+  if (!m)
+    return null;
+  const v = m.slice(1, 5).map(Number);
+  return v.every((x) => isFinite(x)) ? v : null;
+}
+function fontPx(font, d = 90) {
+  if (!font)
+    return d;
+  const m = font.match(/([\d.]+)px/);
+  return m ? Math.max(1, parseFloat(m[1])) : d;
+}
+function parseCssColor(c3) {
+  if (!c3 || typeof c3 !== "string")
+    return null;
+  const s = c3.trim();
+  let m = s.match(/^#([0-9a-fA-F]{3})$/);
+  if (m) {
+    const h = m[1];
+    return [parseInt(h[0] + h[0], 16), parseInt(h[1] + h[1], 16), parseInt(h[2] + h[2], 16), 1];
+  }
+  m = s.match(/^#([0-9a-fA-F]{6})([0-9a-fA-F]{2})?$/);
+  if (m) {
+    const h = m[1];
+    const a = m[2] ? parseInt(m[2], 16) / 255 : 1;
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16), a];
+  }
+  m = s.match(/^rgba?\(\s*([\d.]+)\s*,\s*([\d.]+)\s*,\s*([\d.]+)\s*(?:,\s*([\d.]+)\s*)?\)$/);
+  if (m) {
+    return [
+      Math.min(255, parseFloat(m[1])),
+      Math.min(255, parseFloat(m[2])),
+      Math.min(255, parseFloat(m[3])),
+      m[4] !== undefined ? Math.min(1, parseFloat(m[4])) : 1
+    ];
+  }
+  return null;
+}
+function mergeChannelTracks(ta, tb, defA, defB) {
+  const sample = (track, t, dflt) => {
+    if (!track || track.length === 0)
+      return dflt;
+    if (t <= track[0].t)
+      return num(track[0].v, dflt);
+    for (let i = 1;i < track.length; i++) {
+      if (t <= track[i].t) {
+        const p = track[i - 1];
+        const q = track[i];
+        const span = q.t - p.t;
+        if (span <= 0)
+          return num(q.v, dflt);
+        const k = (t - p.t) / span;
+        return num(p.v, dflt) + (num(q.v, dflt) - num(p.v, dflt)) * k;
+      }
+    }
+    return num(track[track.length - 1].v, dflt);
+  };
+  const times = new Set;
+  for (const k of ta ?? [])
+    times.add(k.t);
+  for (const k of tb ?? [])
+    times.add(k.t);
+  const sorted = [...times].sort((x, y) => x - y);
+  return sorted.map((t) => {
+    const ea = (ta ?? []).find((k) => k.t === t)?.e;
+    const eb = (tb ?? []).find((k) => k.t === t)?.e;
+    return { t, a: sample(ta, t, defA), b: sample(tb, t, defB), e: ea ?? eb ?? null };
+  });
+}
+
+// src/lib/convert/bake_ops.ts
+var TIME_DOMAIN_OPS = new Set(["shake", "pulsate", "oscillate", "flicker", "zoom"]);
+function sampleTrack(track, t, def) {
+  if (!track || track.length === 0)
+    return def;
+  if (t <= track[0].t)
+    return num(track[0].v, def);
+  for (let i = 1;i < track.length; i++) {
+    const a = track[i - 1];
+    const b = track[i];
+    if (t <= b.t) {
+      const span = Math.max(b.t - a.t, 0.000001);
+      const k = (t - a.t) / span;
+      return num(a.v, def) + (num(b.v, def) - num(a.v, def)) * k;
+    }
+  }
+  return num(track[track.length - 1].v, def);
+}
+function phasePair(i) {
+  return [Math.sin(i * 2.399), Math.cos(i * 3.11)];
+}
+var round = (v, p) => {
+  const k = 10 ** p;
+  return Math.round(v * k) / k;
+};
+var clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+var dn = (n) => Math.max(2, Math.floor(n));
+function basePos(anim, pos, t) {
+  return [sampleTrack(anim.x, t, pos[0]), sampleTrack(anim.y, t, pos[1])];
+}
+function baseScale(anim, t) {
+  if (anim.scale?.length) {
+    const s = sampleTrack(anim.scale, t, 1);
+    return [s, s];
+  }
+  if (anim.sx?.length || anim.sy?.length) {
+    return [sampleTrack(anim.sx, t, 1), sampleTrack(anim.sy, t, 1)];
+  }
+  return [1, 1];
+}
+function baseRot(anim, t) {
+  return sampleTrack(anim.rot, t, 0);
+}
+function opWindow(fx, ly) {
+  const t0 = num(fx.t0, num(ly.in, 0));
+  const t1 = num(fx.t1, num(ly.out, t0 + 1));
+  return [t0, t1];
+}
+function bakeLayerOps(ly) {
+  const anim = ly.anim ?? {};
+  const pos = [num(ly.pos?.[0], 0), num(ly.pos?.[1], 0)];
+  const tracks = [];
+  const warnings = [];
+  for (const fx of ly.fx ?? []) {
+    const op = fx.op;
+    if (!TIME_DOMAIN_OPS.has(op))
+      continue;
+    if (op === "zoom") {
+      const tr = fx.tracks?.scale;
+      if (!tr || tr.length < 1) {
+        warnings.push(`bake: zoom 无 scale 参数轨，跳过（layer ${ly.id}）`);
+        continue;
+      }
+      const times = [];
+      const values = [];
+      for (const k of tr) {
+        const t = num(k.t, 0);
+        const v = num(k.v, 1);
+        const [bx, by] = baseScale(anim, t);
+        times.push(round(t, 3));
+        values.push([round(bx * v * 100, 3), round(by * v * 100, 3)]);
+      }
+      const w = [times[0], times[times.length - 1]];
+      tracks.push({ prop: "scale", times, values, window: w, ease: "power2.out" });
+      continue;
+    }
+    const [t0, t1] = opWindow(fx, ly);
+    if (op === "flicker") {
+      if (t1 - t0 < 0.05)
+        continue;
+      let freq = num(fx.freq, 8);
+      freq = clamp(freq >= 0.5 ? freq : freq * 30, 0.5, 20);
+      const mag = clamp(num(fx.mag, 0.6), 0.05, 1);
+      const hi = 1 + mag * 0.8;
+      const lo = Math.max(0.3, 1 - mag * 0.6);
+      const n = Math.min(dn(Math.max(2, Math.floor((t1 - t0) * freq * 2))), 160);
+      const times = [round(t0, 3)];
+      const values = [[0]];
+      for (let j = 1;j <= n; j++) {
+        const tt = t0 + (t1 - t0) * j / n;
+        const v = j % 2 ? hi : lo;
+        const b = clamp((v - 1) * 100, -100, 100);
+        times.push(round(tt, 3));
+        values.push([round(b, 3)]);
+      }
+      tracks.push({ prop: "brightness", times, values, window: [t0, t1] });
+      continue;
+    }
+    if (t1 - t0 < 0.05)
+      continue;
+    if (op === "shake") {
+      const amp0 = num(fx.mag ?? fx.amp, 18);
+      const freq = clamp(num(fx.freq, 20), 1, 40);
+      const n = Math.min(dn(Math.max(2, Math.floor((t1 - t0) * freq))), 160);
+      const tr = fx.tracks?.mag;
+      const seqX = [];
+      const seqY = [];
+      const ttArr = [];
+      for (let i = 0;i <= n; i++) {
+        const tt = t0 + (t1 - t0) * i / n;
+        let a = sampleTrack(tr, tt, amp0);
+        if (fx.decay)
+          a *= 1 - i / n;
+        const [px, py] = phasePair(i);
+        seqX.push(round(a * px, 1));
+        seqY.push(round(a * py, 1));
+        ttArr.push(round(tt, 3));
+      }
+      const off0x = seqX[0];
+      const off0y = seqY[0];
+      const times = [];
+      const values = [];
+      for (let i = 0;i <= n; i++) {
+        const [bx, by] = basePos(anim, pos, ttArr[i]);
+        times.push(ttArr[i]);
+        values.push([round(bx + (seqX[i] - off0x), 3), round(by + (seqY[i] - off0y), 3)]);
+      }
+      tracks.push({ prop: "position", times, values, window: [t0, t1] });
+      continue;
+    }
+    if (op === "oscillate") {
+      if (fx.rot === true) {
+        const a1 = num(fx.a1, -3);
+        const a2 = num(fx.a2, 3);
+        const freq = clamp(num(fx.freq, 2), 0.2, 20);
+        const n = Math.min(dn(Math.max(4, Math.floor((t1 - t0) * freq * 4))), 120);
+        const times = [round(t0, 3)];
+        const values = [[round(baseRot(anim, t0), 3)]];
+        let prev = 0;
+        let acc = 0;
+        for (let i = 1;i <= n; i++) {
+          const tt = t0 + (t1 - t0) * i / n;
+          const ph = Math.sin(2 * Math.PI * freq * (tt - t0));
+          const cur = (a1 + a2) / 2 + (a2 - a1) / 2 * ph;
+          acc += round(cur - prev, 2);
+          prev = cur;
+          times.push(round(tt, 3));
+          values.push([round(baseRot(anim, tt) + acc, 3)]);
+        }
+        tracks.push({ prop: "rotation", times, values, window: [t0, t1] });
+      } else {
+        const mag0 = num(fx.mag, 40);
+        const ang = num(fx.angle, 90) * Math.PI / 180;
+        const freq = clamp(num(fx.freq, 4), 0.2, 30);
+        const n = Math.min(dn(Math.max(4, Math.floor((t1 - t0) * freq * 4))), 160);
+        const tr = fx.tracks?.mag;
+        const times = [round(t0, 3)];
+        const [b0x, b0y] = basePos(anim, pos, t0);
+        const values = [[round(b0x, 3), round(b0y, 3)]];
+        let prevX = 0;
+        let prevY = 0;
+        let accX = 0;
+        let accY = 0;
+        for (let i = 1;i <= n; i++) {
+          const tt = t0 + (t1 - t0) * i / n;
+          const a = sampleTrack(tr, tt, mag0);
+          const ph = Math.sin(2 * Math.PI * freq * (tt - t0));
+          const curX = a * ph * Math.cos(ang);
+          const curY = a * ph * Math.sin(ang);
+          accX += round(curX - prevX, 2);
+          accY += round(curY - prevY, 2);
+          prevX = curX;
+          prevY = curY;
+          const [bx, by] = basePos(anim, pos, tt);
+          times.push(round(tt, 3));
+          values.push([round(bx + accX, 3), round(by + accY, 3)]);
+        }
+        tracks.push({ prop: "position", times, values, window: [t0, t1] });
+      }
+      continue;
+    }
+    if (op === "pulsate") {
+      let lo;
+      let hi;
+      if (fx.amp != null) {
+        lo = 1 - num(fx.amp, 0);
+        hi = 1 + num(fx.amp, 0);
+      } else {
+        lo = num(fx.min, 1);
+        hi = num(fx.max, 1.06);
+      }
+      const freq = clamp(num(fx.freq, 2), 0.2, 20);
+      const n = Math.min(dn(Math.max(4, Math.floor((t1 - t0) * freq * 4))), 160);
+      const tr = fx.tracks?.max;
+      const times = [round(t0, 3)];
+      const [bs0x, bs0y] = baseScale(anim, t0);
+      const values = [[round(bs0x * 100, 3), round(bs0y * 100, 3)]];
+      for (let i = 1;i <= n; i++) {
+        const tt = t0 + (t1 - t0) * i / n;
+        const h = sampleTrack(tr, tt, hi);
+        const ph = (Math.sin(2 * Math.PI * freq * (tt - t0)) + 1) / 2;
+        const s = round(lo + (Math.max(h, lo) - lo) * ph, 3);
+        const [bx, by] = baseScale(anim, tt);
+        times.push(round(tt, 3));
+        values.push([round(bx * s * 100, 3), round(by * s * 100, 3)]);
+      }
+      tracks.push({ prop: "scale", times, values, window: [t0, t1] });
+      continue;
+    }
+  }
+  return { tracks, warnings };
+}
+
+// src/lib/convert/ir_to_jsx.ts
+var HEADER = `// 由技法图鉴重建生成,仅供学习研究;素材为占位,请替换
+// Generated by gitruck-creation IR->JSX converter. For study only; placeholder footage, replace before use.
+// 用法: AE 菜单 文件>脚本>运行脚本文件 选择本文件（AE 2020+ 建议）`;
+var FX_MATCHNAME = {
+  glow: "ADBE Glo2",
+  blur: "ADBE Gaussian Blur 2",
+  dirBlur: "ADBE Motion Blur",
+  turbulence: "ADBE Turbulent Displace",
+  tile: "ADBE Tile",
+  dropShadow: "ADBE Drop Shadow",
+  invert: "ADBE Invert",
+  wipe: "ADBE Linear Wipe",
+  bulge: "ADBE Bulge",
+  noise: "ADBE Noise",
+  fill: "ADBE Fill",
+  vignette: "ADBE Vignette",
+  colorAdjust: "ADBE Brightness & Contrast 2"
+};
+function esc(s) {
+  return String(s).replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\r/g, "\\r").replace(/\n/g, "\\n").replace(/\t/g, "\\t").replace(new RegExp(String.fromCharCode(8232), "g"), "\\u2028").replace(new RegExp(String.fromCharCode(8233), "g"), "\\u2029");
+}
+function r35(v) {
+  return Math.round(v * 1000) / 1000;
+}
+function colorArr(css, fallback) {
+  const c3 = parseCssColor(css);
+  if (!c3)
+    return fallback;
+  return [r35(c3[0] / 255), r35(c3[1] / 255), r35(c3[2] / 255)];
+}
+function easeInfluence(e) {
+  const cb = parseCubicBezier(e);
+  if (!cb)
+    return null;
+  const clamp2 = (v) => Math.min(100, Math.max(0.1, v));
+  return { out: clamp2(cb[0] * 100 || 33), inn: clamp2((1 - cb[2]) * 100 || 33) };
+}
+function emitKeys(ctx, propExpr, keys) {
+  if (keys.length === 0)
+    return;
+  const L = ctx.lines;
+  L.push(`  try {`);
+  L.push(`    var p = ${propExpr};`);
+  for (const k of keys) {
+    L.push(`    p.setValueAtTime(${r35(k.t)}, ${k.value});`);
+  }
+  keys.forEach((k, i) => {
+    const inf = easeInfluence(k.e);
+    if (!inf)
+      return;
+    L.push(`    try {`);
+    L.push(`      var dim = 1; try { dim = p.value.length || 1; } catch (e) { dim = 1; }`);
+    L.push(`      var eo = [], ei = [];`);
+    L.push(`      for (var d = 0; d < Math.min(dim, 3); d++) { eo.push(new KeyframeEase(0, ${r35(inf.out)})); ei.push(new KeyframeEase(0, ${r35(inf.inn)})); }`);
+    L.push(`      p.setTemporalEaseAtKey(${i + 1}, ei, eo);`);
+    L.push(`    } catch (e) {}`);
+  });
+  L.push(`  } catch (e) {}`);
+}
+function fxComment(fx) {
+  const params = Object.keys(fx).filter((k) => !["op", "src", "tracks"].includes(k)).map((k) => `${k}=${JSON.stringify(fx[k])}`).join(" ");
+  const tracks = fx.tracks ? ` tracks:[${Object.keys(fx.tracks).join(",")}]` : "";
+  return `${fx.op}${fx.src ? ` (原特效: ${fx.src})` : ""}${params ? " " + params : ""}${tracks}`;
+}
+function emitEffects(ctx, layerVar, fxList) {
+  if (!fxList || fxList.length === 0)
+    return;
+  const L = ctx.lines;
+  L.push(`  // —— 特效（原工程特效清单，已知 matchName 自动 applyEffect，其余 TODO 手动补）——`);
+  for (const fx of fxList) {
+    const mn = FX_MATCHNAME[fx.op];
+    if (ctx.bakeOps && TIME_DOMAIN_OPS.has(fx.op))
+      continue;
+    if (mn && !TIME_DOMAIN_OPS.has(fx.op)) {
+      L.push(`  // fx: ${esc(fxComment(fx))}`);
+      L.push(`  try { ${layerVar}.property("ADBE Effect Parade").addProperty("${mn}"); } catch (e) {}`);
+    } else if (TIME_DOMAIN_OPS.has(fx.op)) {
+      L.push(`  // TODO fx(时序算子,请用表达式或关键帧手动复现): ${esc(fxComment(fx))}`);
+      ctx.warnings.push(`jsx: 时序算子 ${fx.op} 未自动铺帧（已写 TODO 注释）`);
+    } else {
+      L.push(`  // TODO fx(无对应 AE 原生 matchName): ${esc(fxComment(fx))}`);
+      ctx.warnings.push(`jsx: 未映射特效 ${fx.op}（已写 TODO 注释）`);
+    }
+  }
+}
+function samplePos(anim, pos, t) {
+  return [sampleTrack(anim.x, t, pos[0]), sampleTrack(anim.y, t, pos[1])];
+}
+function sampleScaleMul(anim, t) {
+  if (anim.scale?.length) {
+    const s = sampleTrack(anim.scale, t, 1);
+    return [s, s];
+  }
+  if (anim.sx?.length || anim.sy?.length)
+    return [sampleTrack(anim.sx, t, 1), sampleTrack(anim.sy, t, 1)];
+  return [1, 1];
+}
+function mergeBaked(baseKeys, bakedKeys, windows, anchorAt, layerIn, layerOut) {
+  const inWindow = (t) => {
+    for (const w of windows)
+      if (t > w[0] + 0.000001 && t < w[1] - 0.000001)
+        return true;
+    return false;
+  };
+  const out = [];
+  for (const k of baseKeys)
+    if (!inWindow(k.t))
+      out.push(k);
+  const EPS = 0.033;
+  for (const w of windows) {
+    if (w[1] < layerOut - EPS) {
+      const at = Math.min(w[1] + EPS, layerOut);
+      out.push({ t: at, value: anchorAt(at), e: null });
+    }
+    if (w[0] > layerIn + EPS) {
+      const at = Math.max(w[0] - EPS, layerIn);
+      out.push({ t: at, value: anchorAt(at), e: null });
+    }
+  }
+  out.push(...bakedKeys);
+  out.sort((a, b) => a.t - b.t);
+  const ded = [];
+  for (const k of out) {
+    if (ded.length && Math.abs(k.t - ded[ded.length - 1].t) < 0.000001)
+      ded[ded.length - 1] = k;
+    else
+      ded.push(k);
+  }
+  return ded;
+}
+function positionBaseKeys(anim, pos) {
+  if (!(anim.x?.length || anim.y?.length))
+    return [];
+  const merged = mergeChannelTracks(anim.x, anim.y, pos[0], pos[1]);
+  return merged.map((k) => ({ t: k.t, value: `[${r35(k.a)}, ${r35(k.b)}]`, e: k.e }));
+}
+function scaleBaseKeys(anim, coverExpr) {
+  const sc = (v) => coverExpr ? `${r35(v)}*${coverExpr}` : `${r35(v)}`;
+  if (anim.scale?.length) {
+    return anim.scale.map((k) => ({ t: k.t, value: `[${sc(num(k.v, 1) * 100)}, ${sc(num(k.v, 1) * 100)}]`, e: k.e }));
+  }
+  if (anim.sx?.length || anim.sy?.length) {
+    const merged = mergeChannelTracks(anim.sx, anim.sy, 1, 1);
+    return merged.map((k) => ({ t: k.t, value: `[${sc(k.a * 100)}, ${sc(k.b * 100)}]`, e: k.e }));
+  }
+  return [];
+}
+function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
+  const { tracks, warnings } = bakeLayerOps(ly);
+  for (const w of warnings)
+    ctx.warnings.push(w);
+  if (tracks.length === 0)
+    return;
+  const anim = ly.anim ?? {};
+  const pos = [num(ly.pos?.[0], 0), num(ly.pos?.[1], 0)];
+  const inn = num(ly.in, 0);
+  const out = Math.max(inn + 0.01, num(ly.out, inn + 1));
+  const sc = (v) => coverExpr ? `${r35(v)}*${coverExpr}` : `${r35(v)}`;
+  const brights = tracks.filter((t) => t.prop === "brightness");
+  if (brights.length) {
+    ctx.lines.push(`  // fx: flicker → 亮度脉冲（ADBE Brightness & Contrast 2，避开 opacity 通道）`);
+    ctx.lines.push(`  var flkFx = null; try { flkFx = ${layerVar}.property("ADBE Effect Parade").addProperty("ADBE Brightness & Contrast 2"); } catch (e) { flkFx = null; }`);
+    for (const bt of brights) {
+      const keys = bt.times.map((t, i) => ({ t, value: `${r35(bt.values[i][0])}`, e: null }));
+      emitKeys(ctx, `flkFx.property(1)`, keys);
+    }
+  }
+  const posBaked = tracks.filter((t) => t.prop === "position");
+  if (posBaked.length) {
+    const baseKeys = positionBaseKeys(anim, pos);
+    const bakedKeys = [];
+    const windows = [];
+    for (const bt of posBaked) {
+      windows.push(bt.window);
+      for (let i = 0;i < bt.times.length; i++) {
+        bakedKeys.push({ t: bt.times[i], value: `[${r35(bt.values[i][0])}, ${r35(bt.values[i][1])}]`, e: null });
+      }
+    }
+    const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => {
+      const [x, y] = samplePos(anim, pos, t);
+      return `[${r35(x)}, ${r35(y)}]`;
+    }, inn, out);
+    emitKeys(ctx, `${tf}.property("ADBE Position")`, merged);
+  }
+  const scaleBaked = tracks.filter((t) => t.prop === "scale");
+  if (scaleBaked.length) {
+    const baseKeys = scaleBaseKeys(anim, coverExpr);
+    const bakedKeys = [];
+    const windows = [];
+    for (const bt of scaleBaked) {
+      windows.push(bt.window);
+      for (let i = 0;i < bt.times.length; i++) {
+        bakedKeys.push({ t: bt.times[i], value: `[${sc(bt.values[i][0])}, ${sc(bt.values[i][1])}]`, e: null });
+      }
+    }
+    const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => {
+      const [mx, my] = sampleScaleMul(anim, t);
+      return `[${sc(mx * 100)}, ${sc(my * 100)}]`;
+    }, inn, out);
+    emitKeys(ctx, `${tf}.property("ADBE Scale")`, merged);
+  }
+  const rotBaked = tracks.filter((t) => t.prop === "rotation");
+  if (rotBaked.length) {
+    const baseKeys = (anim.rot ?? []).map((k) => ({ t: k.t, value: `${r35(num(k.v, 0))}`, e: k.e }));
+    const bakedKeys = [];
+    const windows = [];
+    for (const bt of rotBaked) {
+      windows.push(bt.window);
+      for (let i = 0;i < bt.times.length; i++)
+        bakedKeys.push({ t: bt.times[i], value: `${r35(bt.values[i][0])}`, e: null });
+    }
+    const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => `${r35(sampleTrack(anim.rot, t, 0))}`, inn, out);
+    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, merged);
+  }
+}
+function emitLayer(ctx, ir, ly, parentNullVar) {
+  const L = ctx.lines;
+  const cv = ctx.compVar;
+  const c3 = ir.canvas;
+  const id = ++ctx.layerSeq;
+  const v = `ly${id}`;
+  const inn = num(ly.in, 0);
+  const out = Math.max(inn + 0.01, num(ly.out, c3.duration));
+  const px = num(ly.pos?.[0], c3.w / 2);
+  const py = num(ly.pos?.[1], c3.h / 2);
+  const name = esc(`${ly.id || "L" + id} [${ly.type}]`);
+  L.push(``);
+  L.push(`  // ---- 层 ${name} in=${r35(inn)} out=${r35(out)} ----`);
+  if (ly.type === "group") {
+    L.push(`  var ${v} = ${cv}.layers.addNull(${r35(c3.duration)});`);
+    L.push(`  ${v}.name = "${name}";`);
+    L.push(`  ${v}.inPoint = ${r35(inn)}; ${v}.outPoint = ${r35(out)};`);
+    L.push(`  ${v}.property("ADBE Transform Group").property("ADBE Anchor Point").setValue([0,0]);`);
+    L.push(`  ${v}.property("ADBE Transform Group").property("ADBE Position").setValue([0,0]);`);
+    if (parentNullVar)
+      L.push(`  try { ${v}.parent = ${parentNullVar}; } catch (e) {}`);
+    emitGroupAnim(ctx, v, ly);
+    emitEffects(ctx, v, ly.fx);
+    for (const child of ly.children ?? [])
+      emitLayer(ctx, ir, child, v);
+    return;
+  }
+  let coverExpr = null;
+  const footageHit = ly.type === "image" || ly.type === "video" ? ctx.footage[ly.id] : undefined;
+  const fgVar = footageHit ? ctx.footageVars.get(footageHit.path) : undefined;
+  if (footageHit && fgVar) {
+    const slotW = Math.max(2, Math.round(num(ly.w, c3.w)));
+    const slotH = Math.max(2, Math.round(num(ly.h, c3.h)));
+    const srcOffset = num(footageHit.srcOffset, 0);
+    const cvv = `cv${id}`;
+    coverExpr = cvv;
+    L.push(`  // 素材注入(${esc(String(ly.type))}): footage srcOffset=${r35(srcOffset)}`);
+    L.push(`  var ${v} = null, ${cvv} = 1;`);
+    L.push(`  if (${fgVar} != null) {`);
+    L.push(`    try {`);
+    L.push(`      ${v} = ${cv}.layers.add(${fgVar});`);
+    L.push(`      var _fw = ${fgVar}.width || ${slotW}, _fh = ${fgVar}.height || ${slotH};`);
+    L.push(`      ${cvv} = Math.max(${slotW} / _fw, ${slotH} / _fh);`);
+    L.push(`      ${v}.startTime = ${r35(inn)} - ${r35(srcOffset)};`);
+    L.push(`    } catch (e) { ${v} = null; }`);
+    L.push(`  }`);
+    L.push(`  if (${v} == null) {`);
+    L.push(`    ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${slotW}, ${slotH}, 1, ${r35(c3.duration)});`);
+    L.push(`    ${cvv} = 1;`);
+    L.push(`  }`);
+  } else if (ly.type === "text") {
+    const size = fontPx(ly.font);
+    const col = colorArr(ly.color, [1, 1, 1]);
+    L.push(`  var ${v} = ${cv}.layers.addText("${esc(ly.text ?? "")}");`);
+    L.push(`  try {`);
+    L.push(`    var td = ${v}.property("ADBE Text Properties").property("ADBE Text Document");`);
+    L.push(`    var tdv = td.value;`);
+    L.push(`    tdv.fontSize = ${Math.round(size)};`);
+    L.push(`    tdv.fillColor = [${col.join(",")}];`);
+    L.push(`    tdv.justification = ParagraphJustification.CENTER_JUSTIFY;`);
+    L.push(`    td.setValue(tdv);`);
+    L.push(`  } catch (e) {}`);
+  } else if (ly.type === "shape") {
+    const col = colorArr(ly.fill, [0.2, 0.33, 0.67]);
+    const w = Math.max(2, Math.round(num(ly.w, 400)));
+    const h = Math.max(2, Math.round(num(ly.h, 400)));
+    if (ly.shape === "ellipse")
+      L.push(`  // TODO: 原层为椭圆形状,固态占位,可手动换 shape layer`);
+    L.push(`  var ${v} = ${cv}.layers.addSolid([${col.join(",")}], "${name}", ${w}, ${h}, 1, ${r35(c3.duration)});`);
+  } else {
+    const w = Math.max(2, Math.round(num(ly.w, c3.w)));
+    const h = Math.max(2, Math.round(num(ly.h, c3.h)));
+    L.push(`  // 占位素材(${esc(String(ly.type))}${ly.asset ? ` asset=${esc(String(ly.asset))}` : ""}): 请替换为真实素材`);
+    L.push(`  var ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${w}, ${h}, 1, ${r35(c3.duration)});`);
+  }
+  L.push(`  ${v}.name = "${name}";`);
+  L.push(`  ${v}.inPoint = ${r35(inn)}; ${v}.outPoint = ${r35(out)};`);
+  if (parentNullVar)
+    L.push(`  try { ${v}.parent = ${parentNullVar}; } catch (e) {}`);
+  if (ly.blend && ly.blend !== "normal") {
+    L.push(`  // 混合模式: ${esc(ly.blend)}`);
+    const bm = BLEND_JSX[ly.blend];
+    if (bm)
+      L.push(`  try { ${v}.blendingMode = BlendingMode.${bm}; } catch (e) {}`);
+  }
+  const tf = `${v}.property("ADBE Transform Group")`;
+  L.push(`  ${tf}.property("ADBE Position").setValue([${r35(px)}, ${r35(py)}]);`);
+  const anim = ly.anim ?? {};
+  const bakedProps = new Set(ctx.bakeOps ? bakeLayerOps(ly).tracks.map((t) => t.prop) : []);
+  if ((anim.x?.length || anim.y?.length) && !bakedProps.has("position")) {
+    emitKeys(ctx, `${tf}.property("ADBE Position")`, positionBaseKeys(anim, [px, py]));
+  }
+  if (!bakedProps.has("scale")) {
+    const scKeys = scaleBaseKeys(anim, coverExpr);
+    if (scKeys.length)
+      emitKeys(ctx, `${tf}.property("ADBE Scale")`, scKeys);
+    else if (coverExpr) {
+      L.push(`  ${tf}.property("ADBE Scale").setValue([100*${coverExpr}, 100*${coverExpr}]);`);
+    }
+  }
+  if (anim.rot?.length && !bakedProps.has("rotation")) {
+    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, anim.rot.map((k) => ({ t: k.t, value: `${r35(num(k.v, 0))}`, e: k.e })));
+  }
+  if (anim.opacity?.length) {
+    emitKeys(ctx, `${tf}.property("ADBE Opacity")`, anim.opacity.map((k) => ({ t: k.t, value: `${r35(Math.min(1, Math.max(0, num(k.v, 1))) * 100)}`, e: k.e })));
+  }
+  if (anim.ls?.length) {
+    L.push(`  // TODO: letterspacing 轨未自动映射（AE 需 Animator>Tracking），共 ${anim.ls.length} 帧`);
+  }
+  emitEffects(ctx, v, ly.fx);
+  if (ctx.bakeOps)
+    emitBakedOps(ctx, ly, v, tf, coverExpr);
+  if (ly.raw_fx?.length) {
+    L.push(`  // TODO 原工程还有未解析特效: ${esc(ly.raw_fx.join(", "))}`);
+  }
+}
+function emitGroupAnim(ctx, v, ly) {
+  const anim = ly.anim ?? {};
+  const px = num(ly.pos?.[0], 0);
+  const py = num(ly.pos?.[1], 0);
+  if (anim.x?.length || anim.y?.length) {
+    const merged = mergeChannelTracks(anim.x, anim.y, px, py);
+    emitKeys(ctx, `${v}.property("ADBE Transform Group").property("ADBE Position")`, merged.map((k) => ({ t: k.t, value: `[${r35(k.a - px)}, ${r35(k.b - py)}]`, e: k.e })));
+  }
+  for (const ch of ["scale", "rot", "opacity"]) {
+    if (anim[ch]?.length) {
+      ctx.lines.push(`  // TODO: 组自身 ${ch} 动画未映射到 null（子层坐标为画布绝对值,直接缩放会偏移）`);
+      ctx.warnings.push(`jsx: 组 ${ly.id} 的 ${ch} 动画需手动复现`);
+    }
+  }
+}
+var BLEND_JSX = {
+  screen: "SCREEN",
+  add: "ADD",
+  multiply: "MULTIPLY",
+  overlay: "OVERLAY",
+  lighten: "LIGHTEN",
+  darken: "DARKEN",
+  "soft-light": "SOFT_LIGHT",
+  "hard-light": "HARD_LIGHT",
+  difference: "DIFFERENCE",
+  exclude: "EXCLUSION",
+  hue: "HUE",
+  color: "COLOR"
+};
+function fwdSlash(p) {
+  return p.replace(/\\/g, "/");
+}
+function emitFootageImports(ctx, paths) {
+  const L = ctx.lines;
+  const uniq2 = [...new Set(paths)];
+  if (uniq2.length === 0)
+    return;
+  L.push(`  // —— 素材导入（每素材仅导入一次、变量缓存复用）——`);
+  let i = 0;
+  for (const p of uniq2) {
+    const vn = `fg${++i}`;
+    ctx.footageVars.set(p, vn);
+    L.push(`  var ${vn} = null;`);
+    L.push(`  try { ${vn} = app.project.importFile(new ImportOptions(new File("${esc(fwdSlash(p))}"))); } catch (e) { ${vn} = null; }`);
+  }
+}
+function newCtx(opts) {
+  return {
+    lines: [],
+    warnings: [],
+    layerSeq: 0,
+    compVar: opts?.compVar ?? "comp",
+    footage: opts?.footage ?? {},
+    bakeOps: !!opts?.bakeOps,
+    footageVars: new Map
+  };
+}
+function madJsx(opts) {
+  const { master, windows } = opts;
+  const mw = Math.max(4, Math.round(master.w));
+  const mh = Math.max(4, Math.round(master.h));
+  const mfps = Math.min(99, Math.max(1, master.fps || 30));
+  const masterName = esc(master.name ?? "MAD Master");
+  const allPaths = [];
+  for (const win of windows) {
+    for (const f of Object.values(win.footage ?? {}))
+      allPaths.push(f.path);
+  }
+  const ctx = newCtx({ bakeOps: true });
+  const L = ctx.lines;
+  L.push(opts.header ?? HEADER);
+  L.push(``);
+  L.push(`app.beginUndoGroup("MAD Rebuild ${masterName}");`);
+  L.push(`(function () {`);
+  emitFootageImports(ctx, allPaths);
+  const globalFootageVars = ctx.footageVars;
+  let totalDur = 0.1;
+  for (const win of windows) {
+    const len = win.outLen ?? win.t1 - win.t0;
+    totalDur = Math.max(totalDur, win.dropAt + Math.max(0.01, len));
+  }
+  L.push(``);
+  L.push(`  var master = app.project.items.addComp("${masterName}", ${mw}, ${mh}, 1, ${r35(totalDur)}, ${r35(mfps)});`);
+  L.push(`  try { master.bgColor = [0.04,0.04,0.07]; } catch (e) {}`);
+  const subVars = [];
+  windows.forEach((win, wi) => {
+    const c3 = win.ir.canvas;
+    const sw = Math.max(4, Math.round(num(c3.w, 1920)));
+    const sh = Math.max(4, Math.round(num(c3.h, 1080)));
+    const sfps = Math.min(99, Math.max(1, num(c3.fps, 30)));
+    const sdur = Math.max(0.1, num(c3.duration, 3));
+    const subName = esc(`${win.uid}-${win.seq}`);
+    const subVar = `sub${wi}`;
+    L.push(``);
+    L.push(`  // ==== 子合成 #${wi} 技法 ${subName}（源窗 t0=${r35(win.t0)} t1=${r35(win.t1)}）====`);
+    L.push(`  var ${subVar} = app.project.items.addComp("${subName}", ${sw}, ${sh}, 1, ${r35(sdur)}, ${r35(sfps)});`);
+    const winFootage = { ...win.footage ?? {} };
+    const subCtx = {
+      lines: L,
+      warnings: ctx.warnings,
+      layerSeq: 0,
+      compVar: subVar,
+      footage: winFootage,
+      bakeOps: true,
+      footageVars: globalFootageVars
+    };
+    for (const ly of win.ir.layers ?? [])
+      emitLayer(subCtx, win.ir, ly, null);
+    subVars.push({ subVar, win });
+  });
+  L.push(``);
+  L.push(`  // ==== 母合成裁窗串接（startTime=落点−t0，inPoint=落点，outPoint=落点+窗长）====`);
+  subVars.forEach(({ subVar, win }, wi) => {
+    const len = Math.max(0.01, win.outLen ?? win.t1 - win.t0);
+    const lv = `mL${wi}`;
+    L.push(`  var ${lv} = master.layers.add(${subVar});`);
+    L.push(`  ${lv}.startTime = ${r35(win.dropAt - win.t0)};`);
+    L.push(`  ${lv}.inPoint = ${r35(win.dropAt)};`);
+    L.push(`  ${lv}.outPoint = ${r35(win.dropAt + len)};`);
+    L.push(`  try {`);
+    L.push(`    var _cov = Math.max(${mw} / ${subVar}.width, ${mh} / ${subVar}.height) * 100;`);
+    L.push(`    ${lv}.property("ADBE Transform Group").property("ADBE Scale").setValue([_cov, _cov]);`);
+    L.push(`    ${lv}.property("ADBE Transform Group").property("ADBE Position").setValue([${mw / 2}, ${mh / 2}]);`);
+    L.push(`  } catch (e) {}`);
+  });
+  if (opts.bgm) {
+    L.push(``);
+    L.push(`  // ==== BGM 入轨（importFile 包 try/catch，AE 侧文件缺失/损坏脚本继续跑完仅缺音轨）====`);
+    L.push(`  try {`);
+    L.push(`    var bgm = app.project.importFile(new ImportOptions(new File("${esc(fwdSlash(opts.bgm.path))}")));`);
+    L.push(`    var bgmL = master.layers.add(bgm);`);
+    L.push(`    bgmL.startTime = 0;`);
+    L.push(`  } catch (e) {}`);
+    const markers = opts.bgm.markers ?? [];
+    if (markers.length) {
+      L.push(`  // beat marker（downbeat 带标签区分）`);
+      L.push(`  try {`);
+      L.push(`    var mk = master.property("ADBE Marker");`);
+      for (const m of markers) {
+        const label = m.downbeat ? "downbeat" : "beat";
+        L.push(`    mk.setValueAtTime(${r35(m.t)}, new MarkerValue("${label}"));`);
+      }
+      L.push(`  } catch (e) {}`);
+    }
+  }
+  L.push(``);
+  L.push(`  master.openInViewer();`);
+  L.push(`})();`);
+  L.push(`app.endUndoGroup();`);
+  return { jsx: L.join(`
+`) + `
+`, warnings: ctx.warnings };
+}
+
+// src/lib/mad/scan.ts
+import { readdirSync, statSync as statSync2 } from "node:fs";
+import { extname as extname6, join as join22 } from "node:path";
+var VIDEO_EXTS2 = new Set(defaultExtsFor("video") ?? []);
+function scanFolder(dirAbs, opts = {}) {
+  const probe = opts.probe ?? probeGeometry;
+  const warn = opts.warn ?? (() => {});
+  let entries;
+  try {
+    entries = readdirSync(dirAbs);
+  } catch {
+    throw new Error(`素材文件夹不存在或无法读取：${dirAbs}`);
+  }
+  const files = entries.filter((n) => VIDEO_EXTS2.has(extname6(n).toLowerCase())).map((n) => join22(dirAbs, n)).filter((p) => {
+    try {
+      return statSync2(p).isFile();
+    } catch {
+      return false;
+    }
+  }).sort();
+  const videos = [];
+  const skipped = [];
+  for (const p of files) {
+    try {
+      const g2 = probe(p, opts.ffmpegPath);
+      if (!(g2.width > 0) || !(g2.height > 0)) {
+        skipped.push(p);
+        warn(`跳过无法探测几何的文件：${p}`);
+        continue;
+      }
+      videos.push({ path: p, width: g2.width, height: g2.height, duration: g2.duration || 0 });
+    } catch {
+      skipped.push(p);
+      warn(`跳过 ffprobe 失败的文件：${p}`);
+    }
+  }
+  if (videos.length === 0) {
+    throw new Error(`未在「${dirAbs}」发现可用素材视频。支持的扩展名：${[...VIDEO_EXTS2].join(" ")}。请确认文件夹内含 3~10 条视频。`);
+  }
+  const portrait = videos.filter((v) => v.height > v.width).length;
+  const orientation = portrait > videos.length / 2 ? "portrait" : "landscape";
+  return { videos, orientation, skipped };
+}
+function masterCanvas(orientation) {
+  return orientation === "portrait" ? { w: 1080, h: 1920, fps: 30 } : { w: 1920, h: 1080, fps: 30 };
+}
+
+// src/lib/mad/selector.ts
+function mulberry322(seed) {
+  let a = seed >>> 0;
+  return () => {
+    a |= 0;
+    a = a + 1831565813 | 0;
+    let t = Math.imul(a ^ a >>> 15, 1 | a);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+}
+function tierWeight(format) {
+  if (format === "am" || format === "nv")
+    return 1;
+  return 0.55;
+}
+function entryOrientation(e) {
+  return e.h > e.w ? "portrait" : "landscape";
+}
+function baseWeight(e, orientation) {
+  const nSeen = Math.sqrt(Math.max(1, e.n_seen));
+  const tier = tierWeight(e.format);
+  const orient = entryOrientation(e) === orientation ? 1 : 0.5;
+  const fxPenalty = Math.max(0.1, 1 - Math.min(1, Math.max(0, e.unmapped_fx_ratio)));
+  return nSeen * tier * orient * fxPenalty;
+}
+function weightedPick(weights, rnd) {
+  const total = weights.reduce((s, w) => s + Math.max(0, w), 0);
+  if (total <= 0)
+    return weights.length ? Math.floor(rnd() * weights.length) : -1;
+  let r = rnd() * total;
+  for (let i = 0;i < weights.length; i++) {
+    r -= Math.max(0, weights[i]);
+    if (r <= 0)
+      return i;
+  }
+  return weights.length - 1;
+}
+function budgetWindowCount(durationSec, targetAvgSec = 2.2) {
+  const n = Math.round(durationSec / Math.max(0.5, targetAvgSec));
+  return Math.min(12, Math.max(6, n));
+}
+function selectWindows(opts) {
+  const { pool, videos, durationSec, orientation, seed } = opts;
+  const rnd = mulberry322(seed || 1);
+  const want = budgetWindowCount(durationSec, opts.targetAvgSec);
+  if (pool.length === 0 || videos.length === 0)
+    return [];
+  const cats = [...new Set(pool.map((e) => e.cat))];
+  const byCat = new Map;
+  for (const c3 of cats)
+    byCat.set(c3, pool.filter((e) => e.cat === c3));
+  const chosen = [];
+  const usedPatterns = new Set;
+  const usedUids = new Set;
+  let catCursor = 0;
+  let videoCursor = 0;
+  const srcCursor = new Map;
+  const tryPickFrom = (candidates, relaxDedup) => {
+    const pool2 = candidates.filter((e) => !usedUids.has(e.uid) && (relaxDedup || !usedPatterns.has(e.pid)));
+    if (pool2.length === 0)
+      return null;
+    const weights = pool2.map((e) => baseWeight(e, orientation));
+    const idx = weightedPick(weights, rnd);
+    return idx >= 0 ? pool2[idx] : null;
+  };
+  let guard = 0;
+  while (chosen.length < want && guard < want * (cats.length + 4) + 50) {
+    guard++;
+    let entry = null;
+    for (let k = 0;k < cats.length && !entry; k++) {
+      const cat = cats[(catCursor + k) % cats.length];
+      entry = tryPickFrom(byCat.get(cat) ?? [], false);
+      if (entry)
+        catCursor = (catCursor + k + 1) % cats.length;
+    }
+    if (!entry)
+      entry = tryPickFrom(pool, true);
+    if (!entry)
+      break;
+    usedUids.add(entry.uid);
+    usedPatterns.add(entry.pid);
+    const video = videos[videoCursor % videos.length];
+    videoCursor++;
+    const winLen = Math.max(0.4, entry.t1 - entry.t0);
+    const prev = srcCursor.get(video.path) ?? 0;
+    const room = Math.max(0.1, video.duration - winLen);
+    const srcOffsetBase = room > 0 ? prev % room : 0;
+    srcCursor.set(video.path, prev + winLen);
+    chosen.push({ entry, video, srcOffsetBase });
+  }
+  return chosen;
+}
+
+// src/lib/mad/beat.ts
+var clamp2 = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+var r36 = (v) => Math.round(v * 1000) / 1000;
+var MIN_WIN = 0.4;
+var MAX_WIN = 6;
+function fixedRhythm(natLens) {
+  const placements = [];
+  let t = 0;
+  for (const nl of natLens) {
+    const outLen = clamp2(nl, MIN_WIN, MAX_WIN);
+    placements.push({ dropAt: r36(t), outLen: r36(outLen) });
+    t += outLen;
+  }
+  return { placements, markers: [] };
+}
+function beatQuantized(natLens, analysis) {
+  const dbs = (analysis.downbeats ?? []).filter((t2) => Number.isFinite(t2) && t2 >= 0).sort((a, b) => a - b);
+  const bts = (analysis.beats ?? []).filter((t2) => Number.isFinite(t2) && t2 >= 0).sort((a, b) => a - b);
+  const dbSpanOk = dbs.length >= 2 && dbs[1] - dbs[0] <= MAX_WIN;
+  const snap = dbSpanOk ? dbs : bts;
+  const snapSet = new Set(dbs.map((t2) => r36(t2)));
+  if (snap.length < 2) {
+    return { plan: fixedRhythm(natLens), level: 2 };
+  }
+  const placements = [];
+  let t = 0;
+  let si = 0;
+  for (let i = 0;i < natLens.length; i++) {
+    const dropAt = t;
+    while (si < snap.length && snap[si] <= dropAt + MIN_WIN)
+      si++;
+    if (si >= snap.length) {
+      const outLen = clamp2(natLens[i], MIN_WIN, MAX_WIN);
+      placements.push({ dropAt: r36(dropAt), outLen: r36(outLen) });
+      t = dropAt + outLen;
+      continue;
+    }
+    const nextSnap = snap[si];
+    const slotLen = clamp2(nextSnap - dropAt, MIN_WIN, MAX_WIN);
+    placements.push({ dropAt: r36(dropAt), outLen: r36(slotLen) });
+    t = dropAt + slotLen;
+    si++;
+  }
+  const totalDur = placements.length ? placements[placements.length - 1].dropAt + placements[placements.length - 1].outLen : 0;
+  const allBeats = [...new Set([...bts, ...dbs].map((x) => r36(x)))].sort((a, b) => a - b);
+  const markers = allBeats.filter((tt) => tt >= 0 && tt <= totalDur + 0.000001).map((tt) => ({ t: tt, downbeat: snapSet.has(tt) }));
+  return { plan: { placements, markers }, level: 1 };
+}
+
+// src/lib/mad/data.ts
+import { createHash as createHash2 } from "node:crypto";
+import { mkdir as mkdir9, readFile as readFile7, rename, rm, writeFile as writeFile9, readdir } from "node:fs/promises";
+import { existsSync as existsSync18 } from "node:fs";
+import { join as join23 } from "node:path";
+function madCacheDir() {
+  return homeFile("mad-cache");
+}
+function madContentBase() {
+  return (process.env.GITRUCK_MAD_BASE ?? "https://api.ai-mcn.tv:10000").replace(/\/+$/, "");
+}
+function manifestUrl() {
+  return `${madContentBase()}/task/mad/manifest`;
+}
+var REQUIRED_KEYS = ["mad_pool"];
+function sha256Hex(buf) {
+  return createHash2("sha256").update(buf).digest("hex");
+}
+async function fetchWithTimeout(fetchFn, url, timeoutMs) {
+  const ctrl = new AbortController;
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    return await fetchFn(url, { signal: ctrl.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function atomicWrite(dest, data) {
+  const tmp = `${dest}.tmp-${process.pid}-${Date.now()}`;
+  await writeFile9(tmp, data);
+  await rename(tmp, dest);
+}
+async function verifyFile(path, sha256) {
+  if (!existsSync18(path))
+    return false;
+  try {
+    const buf = await readFile7(path);
+    return sha256Hex(buf) === sha256;
+  } catch {
+    return false;
+  }
+}
+function validateManifest(obj) {
+  if (!obj || typeof obj !== "object")
+    throw new Error("manifest 结构非法");
+  const m = obj;
+  if (typeof m.version !== "number")
+    throw new Error("manifest 缺 version");
+  if (!m.datasets || typeof m.datasets !== "object")
+    throw new Error("manifest 缺 datasets");
+  if (typeof m.assets_base !== "string" || !/^https:\/\//i.test(m.assets_base)) {
+    throw new Error("manifest 缺 assets_base（须 HTTPS）");
+  }
+  return m;
+}
+async function cleanupOldVersions(cacheRoot, keepVersion, warn) {
+  try {
+    const entries = await readdir(cacheRoot);
+    for (const e of entries) {
+      const m = /^v(\d+)$/.exec(e);
+      if (m && Number(m[1]) !== keepVersion) {
+        await rm(join23(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
+      }
+    }
+  } catch {}
+}
+async function ensureMadData(opts, deps) {
+  const { cacheRoot, warn } = deps;
+  const timeout = deps.manifestTimeoutMs ?? 8000;
+  const mfUrl = deps.manifestUrl ?? manifestUrl();
+  const snapshotPath = join23(cacheRoot, "manifest.json");
+  let manifest = null;
+  let online = false;
+  try {
+    if (!/^https:\/\//i.test(mfUrl))
+      throw new Error("manifest 必须 HTTPS");
+    const res = await fetchWithTimeout(deps.fetchFn, mfUrl, timeout);
+    if (!res.ok)
+      throw new Error(`manifest HTTP ${res.status}`);
+    manifest = validateManifest(await res.json());
+    online = true;
+  } catch (e) {
+    warn(`manifest 拉取失败（${e instanceof Error ? e.message : String(e)}），回退本地缓存`);
+  }
+  if (!manifest) {
+    if (!existsSync18(snapshotPath)) {
+      throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
+    }
+    try {
+      manifest = validateManifest(JSON.parse(await readFile7(snapshotPath, "utf8")));
+    } catch {
+      throw new Error("本地 manifest 缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
+    }
+  }
+  for (const k of REQUIRED_KEYS) {
+    if (!manifest.datasets[k]) {
+      throw new Error("技法数据尚未就绪，请稍后再试。");
+    }
+  }
+  const version = manifest.version;
+  const verDir = join23(cacheRoot, `v${version}`);
+  const poolPath = join23(verDir, "mad_pool.json");
+  const poolMeta = manifest.datasets.mad_pool;
+  const cacheValid = await verifyFile(poolPath, poolMeta.sha256);
+  const needDownload = !!opts.refresh || !cacheValid;
+  if (needDownload) {
+    if (!online) {
+      if (existsSync18(poolPath)) {
+        throw new Error("本地技法数据缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
+      }
+      throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
+    }
+    await mkdir9(verDir, { recursive: true });
+    warn(`下载技法池数据 mad_pool（版本 v${version}，约 ${Math.round(poolMeta.size / 1024)} KB）…`);
+    const res = await deps.fetchFn(poolMeta.url);
+    if (!res.ok)
+      throw new Error(`mad_pool 下载失败 HTTP ${res.status}`);
+    const buf = new Uint8Array(await res.arrayBuffer());
+    if (sha256Hex(buf) !== poolMeta.sha256) {
+      throw new Error("mad_pool 下载校验不通过（sha256 不符），请重试或 --refresh。");
+    }
+    await atomicWrite(poolPath, buf);
+    warn(`技法池数据就绪（v${version}）`);
+  }
+  if (online) {
+    await mkdir9(cacheRoot, { recursive: true });
+    await atomicWrite(snapshotPath, new Uint8Array(Buffer.from(JSON.stringify(manifest), "utf8")));
+    await cleanupOldVersions(cacheRoot, version, warn);
+  }
+  let pool;
+  try {
+    pool = JSON.parse(await readFile7(poolPath, "utf8"));
+    if (!Array.isArray(pool))
+      throw new Error("mad_pool 非数组");
+  } catch (e) {
+    throw new Error(`技法池数据装载失败：${e instanceof Error ? e.message : String(e)}（可加 --refresh 重拉）`);
+  }
+  return { version, assetsBase: manifest.assets_base, pool, verDir, online };
+}
+
+// src/lib/mad/pool.ts
+import { gunzipSync } from "node:zlib";
+import { mkdir as mkdir10, readFile as readFile8 } from "node:fs/promises";
+import { existsSync as existsSync19 } from "node:fs";
+import { join as join24 } from "node:path";
+function shardPath(verDir, shard) {
+  return join24(verDir, "ir", `${shard}.json.gz`);
+}
+function decodeShard(gz) {
+  const json = gunzipSync(gz).toString("utf8");
+  const obj = JSON.parse(json);
+  if (!obj || typeof obj !== "object")
+    throw new Error("IR 分片结构非法");
+  return obj;
+}
+function makeIrLoader(assetsBase, verDir, online, deps) {
+  const memo = new Map;
+  const base = assetsBase.replace(/\/+$/, "");
+  async function loadShard(shard) {
+    const cached = memo.get(shard);
+    if (cached)
+      return cached;
+    const path = shardPath(verDir, shard);
+    if (existsSync19(path)) {
+      try {
+        const s2 = decodeShard(await readFile8(path));
+        memo.set(shard, s2);
+        return s2;
+      } catch {
+        deps.warn(`IR 分片缓存损坏（${shard}），尝试重拉`);
+      }
+    }
+    if (!online) {
+      throw new Error(`离线且 IR 分片「${shard}」无缓存。请连网重跑，或加 --refresh 预热数据。`);
+    }
+    const url = `${base}/ir/${shard}.json.gz`;
+    const res = await deps.fetchFn(url);
+    if (!res.ok)
+      throw new Error(`IR 分片下载失败 HTTP ${res.status}：${url}`);
+    const buf = new Uint8Array(await res.arrayBuffer());
+    const s = decodeShard(buf);
+    await mkdir10(join24(verDir, "ir"), { recursive: true });
+    await atomicWrite(path, buf);
+    memo.set(shard, s);
+    return s;
+  }
+  return {
+    async getIr(entry) {
+      const shard = await loadShard(entry.shard);
+      const ir = shard[entry.ir];
+      if (!ir)
+        throw new Error(`IR 分片「${entry.shard}」中缺工程 ir=${entry.ir}`);
+      return ir;
+    },
+    shardCached(shard) {
+      return memo.has(shard) || existsSync19(shardPath(verDir, shard));
+    }
+  };
+}
+
+// src/lib/mad/cloud-beat.ts
+var ANALYZE_TASK = "audio_music_analyze";
+function extractAnalysis(output) {
+  const o = output ?? {};
+  const arr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "number" && Number.isFinite(x)) : [];
+  return {
+    bpm: typeof o.bpm === "number" ? o.bpm : undefined,
+    beats: arr(o.beats),
+    downbeats: arr(o.downbeats)
+  };
+}
+async function analyzeBgm(cfg, bgmAbs, deps) {
+  const payload = (fid) => ({ file_id: fid });
+  const submitted = await uploadAndSubmitTask(cfg, bgmAbs, ANALYZE_TASK, payload, {}, {
+    uploadCached: deps.uploadCached,
+    invalidateUpload: deps.invalidateUpload,
+    submitTask: deps.submitTask,
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve10) => setTimeout(resolve10, ms)))
+  });
+  const { taskId } = submitted;
+  const output = await deps.pollToolTask(cfg, ANALYZE_TASK, taskId, {});
+  return extractAnalysis(output);
+}
+
+// src/lib/mad/mad.ts
+function madHeader(version, generatedAt) {
+  return [
+    "/*═══════════════════════════════════════════════",
+    "  MAD 一键工程 — 由 gtrk 自动生成",
+    "  ───────────────────────────────────────────────",
+    "  用法：After Effects  文件 › 脚本 › 运行脚本文件…  选择本文件",
+    "  运行后自动生成母合成：素材已按技法段填入各素材位，",
+    "  彩色占位块为素材位，可在合成里替换或微调。",
+    "",
+    "  生成工具：gtrk tool mad · 同合云 gitruck",
+    "  了解一键成片流程：https://cloud.ai-mcn.tv/cli",
+    `  版本 ${version} · 生成于 ${generatedAt}`,
+    "═══════════════════════════════════════════════*/"
+  ].join(`
+`);
+}
+function completionMessage(jsxPath, level) {
+  const beat = level === 1 ? "已按 BGM downbeat 卡点" : level === 2 ? "BGM 已入轨、按固定节奏切窗" : "按固定节奏切窗";
+  return [
+    `工程文件已生成：${jsxPath}（${beat}）`,
+    "用法：装 After Effects 2020+ 后，文件 › 脚本 › 运行脚本文件… 选它，30 秒重建整条时间线。"
+  ].join(`
+`);
+}
+function collectSlotIds(ir) {
+  const ids = [];
+  const walk = (layers) => {
+    for (const l of layers) {
+      const ly = l;
+      if (ly.type === "image" || ly.type === "video")
+        ids.push(String(ly.id ?? ""));
+      if (ly.type === "group" && Array.isArray(ly.children))
+        walk(ly.children);
+    }
+  };
+  walk(ir.layers ?? []);
+  return ids.filter((x) => x);
+}
+var SLOT_STAGGER = 0.3;
+function timestamp4(now) {
+  const p = (n) => String(n).padStart(2, "0");
+  return `${p(now.getFullYear() % 100)}${p(now.getMonth() + 1)}${p(now.getDate())}-${p(now.getHours())}${p(now.getMinutes())}${p(now.getSeconds())}`;
+}
+async function runMad(inputArg, opts, deps = {}) {
+  const warn = deps.warn ?? ((m) => process.stderr.write(`\x1B[2m   ${m}\x1B[0m
+`));
+  const emitBilling2 = deps.emitBilling ?? ((h) => process.stderr.write(`\x1B[33m⚠️  计费提示：${h}\x1B[0m
+`));
+  const now = (deps.now ?? (() => new Date))();
+  const fetchFn = deps.fetchFn ?? fetch;
+  const probeDur = deps.probeDurationFn ?? probeDuration;
+  if (!inputArg)
+    throw new Error("用法：gtrk tool mad <素材文件夹> [--bgm 歌.mp3]");
+  const dirAbs = resolve10(inputArg);
+  if (!existsSync20(dirAbs) || !statSync3(dirAbs).isDirectory()) {
+    throw new Error(`素材文件夹不存在或不是目录：${dirAbs}`);
+  }
+  const { videos, orientation, skipped } = scanFolder(dirAbs, {
+    ffmpegPath: opts.ffmpegPath,
+    probe: deps.probeGeometry,
+    warn
+  });
+  for (const s of skipped)
+    ;
+  const master = masterCanvas(orientation);
+  const dataDeps = { fetchFn, cacheRoot: deps.cacheRoot ?? madCacheDir(), warn };
+  const data = await ensureMadData({ refresh: opts.refresh }, dataDeps);
+  const irLoader = makeIrLoader(data.assetsBase, data.verDir, data.online, { fetchFn, warn });
+  const durationSec = opts.duration && opts.duration > 0 ? opts.duration : 20;
+  const seed = opts.seed && Number.isFinite(opts.seed) ? opts.seed : Math.floor(Math.random() * 2 ** 31);
+  warn(`选窗种子 seed=${seed}（复现加 --seed ${seed}）`);
+  const selectablePool = data.online ? data.pool : data.pool.filter((e) => irLoader.shardCached(e.shard));
+  if (!data.online && selectablePool.length === 0) {
+    throw new Error("当前离线且无已缓存的技法数据分片。请连网重跑首拉，或加 --refresh 预热。");
+  }
+  const chosen = selectWindows({ pool: selectablePool, videos, durationSec, orientation, seed });
+  if (chosen.length === 0) {
+    throw new Error("技法池为空或无可用条目（数据版本可能异常，可加 --refresh 重拉）。");
+  }
+  const irs = [];
+  for (const c3 of chosen)
+    irs.push(await irLoader.getIr(c3.entry));
+  let level = 3;
+  let analysis = null;
+  let bgmForTrack;
+  const bgmAbs = opts.bgm ? resolve10(opts.bgm) : undefined;
+  if (bgmAbs) {
+    let dur = -1;
+    try {
+      dur = probeDur(bgmAbs, opts.ffmpegPath);
+    } catch {
+      dur = -1;
+    }
+    if (!(dur > 0)) {
+      warn(`BGM 无法读取（ffprobe 校验失败），按无 BGM 固定节奏出片：${bgmAbs}`);
+      level = 3;
+    } else {
+      let cfg = null;
+      try {
+        cfg = (deps.loadConfig ?? loadConfig)();
+      } catch {
+        cfg = null;
+      }
+      if (!cfg) {
+        warn("未配置 API Key，无法解锁 BGM 卡点。跑 `gtrk init` 配置后可卡点；本次 BGM 已入轨、按固定节奏出片。");
+        level = 2;
+        bgmForTrack = bgmAbs;
+      } else {
+        const pricing = await (deps.resolvePricing ?? resolveToolPricing)("audio_music_analyze", "仅 --bgm 卡点时");
+        emitBilling2(pricing.billingHint);
+        const beatCloud = deps.beatCloud ?? { uploadCached, invalidateUpload, submitTask, pollToolTask };
+        try {
+          analysis = await analyzeBgm(cfg, bgmAbs, beatCloud);
+          level = 1;
+          bgmForTrack = bgmAbs;
+        } catch (e) {
+          warn(`BGM 云端分析失败（${e instanceof Error ? e.message : String(e)}），BGM 已入轨、切点回退固定节奏`);
+          level = 2;
+          bgmForTrack = bgmAbs;
+        }
+      }
+    }
+  }
+  const natLens = chosen.map((c3) => Math.max(MIN_WIN, c3.entry.t1 - c3.entry.t0));
+  let placements;
+  let markers = [];
+  if (level === 1 && analysis) {
+    const q = beatQuantized(natLens, analysis);
+    placements = q.plan.placements;
+    markers = q.plan.markers;
+    if (q.level === 2) {
+      warn("BGM 无有效节拍（beats/downbeats 均空），切点回退固定节奏。");
+      level = 2;
+      markers = [];
+    }
+  } else {
+    placements = fixedRhythm(natLens).placements;
+  }
+  const windows = chosen.map((c3, i) => {
+    const ir = irs[i];
+    const slotIds = collectSlotIds(ir);
+    const footage = {};
+    const vidDur = c3.video.duration || 0;
+    const winLen = Math.max(MIN_WIN, c3.entry.t1 - c3.entry.t0);
+    slotIds.forEach((lid, idx) => {
+      let off = c3.srcOffsetBase + idx * SLOT_STAGGER;
+      const room = Math.max(0, vidDur - winLen);
+      if (room > 0)
+        off = off % room;
+      else
+        off = 0;
+      footage[lid] = { path: c3.video.path, srcOffset: Math.round(off * 1000) / 1000 };
+    });
+    return {
+      ir,
+      uid: c3.entry.uid,
+      seq: i,
+      t0: c3.entry.t0,
+      t1: c3.entry.t1,
+      dropAt: placements[i].dropAt,
+      outLen: placements[i].outLen,
+      footage
+    };
+  });
+  const version = deps.cliVersion ?? "";
+  const header = madHeader(version, now.toISOString());
+  const bgm = level <= 2 && bgmForTrack ? { path: bgmForTrack, markers } : undefined;
+  const { jsx } = madJsx({ master, windows, header, bgm });
+  const outDir = opts.out ? resolve10(opts.out) : join25(process.cwd(), `mad-${timestamp4(now)}`);
+  await mkdir11(outDir, { recursive: true });
+  const jsxPath = join25(outDir, "mad.jsx");
+  await writeFile10(jsxPath, jsx);
+  const result = {
+    ok: true,
+    tool: "mad",
+    outDir,
+    files: [jsxPath],
+    seed,
+    dataVersion: data.version,
+    degradeLevel: level,
+    techniques: chosen.map((c3) => ({ uid: c3.entry.uid, pid: c3.entry.pid, cat: c3.entry.cat, t0: c3.entry.t0, t1: c3.entry.t1 }))
+  };
+  await writeFile10(join25(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
+  warn(completionMessage(jsxPath, level));
+  return result;
+}
+
+// src/commands/tool.ts
+var collectParam2 = (v, acc) => {
+  acc.push(v);
+  return acc;
+};
+function configureToolCommand(cmd, registry = TOOL_REGISTRY) {
+  cmd.description("单点工具族：`gtrk tool <name> [input]` 跑单个能力；`gtrk tool list` 查全部（含输入/产物/计费/状态）").option("-o, --out <dir>", "产物目录（缺省 = <输入名>-<tool>/；input=none 落 cwd 下 <tool>-<时间戳>/）").option("--param <k=v>", "透传任意云端参数（标量、可重复；如 --param width=1080）", collectParam2, []).option("--params-json <json>", "透传任意云端参数（JSON 对象）").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录（缺省 ~/.gitruck/ffmpeg → 系统 PATH）").option("--reupload", "强制重新上传，忽略本地上传缓存").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON（给 agent/脚本解析）");
+  const seen = new Set;
+  for (const d of registry) {
+    for (const o of d.options ?? []) {
+      if (seen.has(o.flag))
+        continue;
+      seen.add(o.flag);
+      cmd.option(o.flag, o.desc);
+    }
+  }
+  cmd.action(async (words, opts) => {
+    await runToolCommand(words ?? [], opts, registry);
+  });
+  return cmd;
+}
+function registerTool(program2, registry = TOOL_REGISTRY) {
+  validateRegistry(registry);
+  const cmd = program2.command("tool [words...]");
+  configureToolCommand(cmd, registry);
+}
+async function runToolCommand(words, opts, registry = TOOL_REGISTRY, deps) {
+  if (opts.json)
+    routeLogsToStderr();
+  const name = words[0];
+  if (!name) {
+    throw new Error("用法：`gtrk tool <name> [input]` 跑工具；`gtrk tool list` 查全部工具");
+  }
+  if (name === "list") {
+    await runList(opts, registry);
+    return;
+  }
+  const descriptor = findTool(name, registry);
+  if (!descriptor) {
+    const names = registry.map((d) => d.name).join(", ");
+    throw new Error(`未知工具「${name}」。可用工具：${names || "（空）"}（用 gtrk tool list 查看详情）`);
+  }
+  return runTool(descriptor, words[1], opts, deps);
+}
+async function runList(opts, registry = TOOL_REGISTRY, loadPrices = fetchToolPrices) {
+  let prices;
+  try {
+    prices = await loadPrices();
+  } catch {
+    prices = undefined;
+  }
+  const rows = registry.map((d) => {
+    const resolved = resolveToolPricingFromMap(d.priceKey ?? d.name, prices, d.pricingContext);
+    return {
+      name: d.name,
+      title: d.title,
+      input: d.input.kind,
+      output: d.outputHint,
+      billingHint: resolved.billingHint,
+      pricing: resolved.pricing,
+      enabled: d.enabled,
+      ...d.disabledReason ? { disabledReason: d.disabledReason } : {}
+    };
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(rows));
+    return;
+  }
+  log.step("▶ gtrk 工具族（gtrk tool <name> [input]）：");
+  for (const r of rows) {
+    const status = r.enabled ? "已上线" : `未开放（${r.disabledReason ?? "无原因"}）`;
+    log.info(`${r.name} — ${r.title}｜输入 ${r.input}｜产物 ${r.output}｜${r.billingHint}｜${status}`);
+  }
+  log.info("agent 一律带 --json；缺 API Key 先跑 `gtrk init`；跑前把计费提示转述给用户。");
+}
+async function runTool(descriptor, inputArg, opts, depsOverride) {
+  if (!descriptor.enabled) {
+    throw new Error(`能力未开放：${descriptor.disabledReason ?? "（未提供原因）"}（用 gtrk tool list 查看全部工具）`);
+  }
+  if (descriptor.kind === "local") {
+    if (descriptor.name === "mad")
+      return runMadInTool(inputArg, opts);
+    throw new Error(`local 型工具「${descriptor.name}」由后续 change 实现，暂不可用`);
+  }
+  const cfg = loadConfig();
+  const deps = {
+    cfg,
+    uploadCached,
+    invalidateUpload,
+    submitTask,
+    getTaskResult,
+    downloadStream,
+    probeDurationSec: (p, ff) => probeDuration(p, ff),
+    ...depsOverride
+  };
+  log.step(`▶ ${descriptor.title}（${descriptor.name}）…`);
+  const result = await runCloudTool(descriptor, inputArg, opts, deps);
+  if (opts.json)
+    console.log(JSON.stringify(result));
+  if (result.ok)
+    log.ok(`完成。产物目录：${result.outDir}`);
+  else {
+    log.err(`部分产物未落地（任务已完成、积分可能已扣）。task.json 已保留，可凭 task_id 恢复：${result.taskId}`);
+    process.exitCode = 1;
+  }
+  return result;
+}
+async function runMadInTool(inputArg, opts) {
+  log.step("▶ 一键剪 MAD（mad）…");
+  const madOpts = {
+    bgm: typeof opts.bgm === "string" ? opts.bgm : undefined,
+    duration: opts.duration != null ? Number(opts.duration) : undefined,
+    seed: opts.seed != null ? Number(opts.seed) : undefined,
+    refresh: !!opts.refresh,
+    out: opts.out,
+    ffmpegPath: opts.ffmpegPath,
+    json: !!opts.json
+  };
+  const r = await runMad(inputArg, madOpts, { cliVersion: currentVersion() });
+  if (opts.json)
+    console.log(JSON.stringify(r));
+  if (r.ok)
+    log.ok(`完成。产物目录：${r.outDir}`);
+  return { ok: r.ok, tool: r.tool, outDir: r.outDir, files: r.files };
+}
+
+// src/commands/transcript.ts
+import { existsSync as existsSync21 } from "node:fs";
+import { mkdir as mkdir12, rename as rename2, rm as rm2, stat as stat6, writeFile as writeFile11 } from "node:fs/promises";
+import { basename as basename12, dirname as dirname9, extname as extname7, join as join26, resolve as resolve11 } from "node:path";
+
+// src/lib/transcript.ts
+var AGENT_SUMMARY_PENDING = "<!-- gtrk:agent-summary-pending -->";
+function finiteNumber(value) {
+  const n = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(n) && n >= 0 ? n : undefined;
+}
+function timeFrom(item, secondsKey, msKey, shortKey) {
+  const seconds = finiteNumber(item[secondsKey]);
+  if (seconds != null)
+    return seconds;
+  const milliseconds = finiteNumber(item[msKey]);
+  if (milliseconds != null)
+    return milliseconds / 1000;
+  return finiteNumber(item[shortKey]) ?? 0;
+}
+function normalizeTimedList(value) {
+  if (!Array.isArray(value))
+    return [];
+  const items = [];
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const item = raw;
+    const text = typeof item.text === "string" ? item.text.trim() : "";
+    if (!text)
+      continue;
+    const start = timeFrom(item, "start_time", "begin_time_ms", "st");
+    const end = timeFrom(item, "end_time", "end_time_ms", "ed");
+    items.push({ text, start, end: Math.max(start, end) });
+  }
+  return items.sort((a, b) => a.start - b.start || a.end - b.end);
+}
+function normalizeAsrOutput(output) {
+  let sentences = normalizeTimedList(output.sentence_tc_list ?? output.sentence_list);
+  const words = normalizeTimedList(output.word_tc_list ?? output.word_list);
+  let text = "";
+  for (const key of ["asr_text", "text"]) {
+    const value = output[key];
+    if (typeof value === "string" && value.trim()) {
+      text = value.trim();
+      break;
+    }
+  }
+  if (sentences.length === 0 && words.length > 0) {
+    sentences = [{
+      text: text || words.map((word) => word.text).join(""),
+      start: words[0]?.start ?? 0,
+      end: words[words.length - 1]?.end ?? 0
+    }];
+  }
+  if (!text && sentences.length > 0)
+    text = sentences.map((sentence) => sentence.text).join(`
+`);
+  if (!text.trim() || sentences.length === 0) {
+    throw new Error("ASR 任务已完成，但没有返回可用的文字或句级时间戳");
+  }
+  return { text: text.trim(), sentences, words };
+}
+function formatTimestamp(seconds) {
+  const total = Math.max(0, Math.floor(Number.isFinite(seconds) ? seconds : 0));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = total % 60;
+  return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+function ensureTerminalPunctuation(text) {
+  const value = text.trim();
+  if (!value)
+    return value;
+  return /[。！？!?；;：:]$/.test(value) ? value : `${value}。`;
+}
+function localDateTime(date) {
+  const p = (value) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())} ${p(date.getHours())}:${p(date.getMinutes())}`;
+}
+function renderTranscriptMarkdown(input) {
+  const timed = input.asr.sentences.flatMap((sentence) => [
+    `**[${formatTimestamp(sentence.start)}]**`,
+    "",
+    ensureTerminalPunctuation(sentence.text),
+    ""
+  ]);
+  return [
+    `# ${input.title}`,
+    "",
+    `> 生成时间：${localDateTime(input.generatedAt)}  `,
+    `> 视频时长：${formatTimestamp(input.durationSec)}  `,
+    `> 来源：本地视频 \`${input.sourceName}\`  `,
+    `> 识别语言：${input.language}`,
+    "",
+    "## 总结",
+    "",
+    AGENT_SUMMARY_PENDING,
+    "> 待驱动 CLI 的 Agent 阅读下方完整文字稿后，在此生成总结。",
+    "",
+    "## 文字记录",
+    "",
+    ...timed,
+    "## 纯文本",
+    "",
+    input.asr.text.trim(),
+    ""
+  ].join(`
+`);
+}
+
+// src/commands/transcript.ts
+var TASK_TYPE3 = "asr";
+var PRICE_KEY = "asr";
+function buildDeps(overrides = {}) {
+  return {
+    cfg: overrides.cfg ?? loadConfig(),
+    probe: overrides.probe ?? probeGeometry,
+    extract: overrides.extract ?? extractAudio,
+    assertDuration: overrides.assertDuration ?? assertDurationConsistent,
+    resolvePricing: overrides.resolvePricing ?? ((key) => resolveToolPricing(key)),
+    upload: overrides.upload ?? uploadCached,
+    invalidate: overrides.invalidate ?? invalidateUpload,
+    submit: overrides.submit ?? submitTask,
+    sleep: overrides.sleep ?? ((ms) => new Promise((resolve12) => setTimeout(resolve12, ms))),
+    poll: overrides.poll ?? (async (cfg, taskType, taskId, onTick) => await pollToolTask(cfg, taskType, taskId, { onTick })),
+    writeMarkdown: overrides.writeMarkdown ?? writeMarkdownAtomic,
+    now: overrides.now ?? (() => new Date)
+  };
+}
+function looksLikeRemote(value) {
+  return /^[a-z][a-z0-9+.-]*:\/\//i.test(value.trim());
+}
+async function validateTranscriptInput(input) {
+  if (!input.trim())
+    throw new Error("缺少本地视频路径。用法：gtrk transcript <本地视频>");
+  if (looksLikeRemote(input)) {
+    throw new Error("视频转文字稿仅支持本地视频文件，不支持 URL、平台视频地址或远端下载");
+  }
+  const inputAbs = resolve11(input);
+  if (!existsSync21(inputAbs))
+    throw new Error(`本地视频不存在：${inputAbs}`);
+  const info = await stat6(inputAbs);
+  if (!info.isFile())
+    throw new Error(`输入不是文件：${inputAbs}`);
+  const extension = extname7(inputAbs).toLowerCase();
+  if (!(defaultExtsFor("video") ?? []).includes(extension)) {
+    throw new Error(`不支持的视频格式「${extension || "无扩展名"}」；请输入本地视频文件`);
+  }
+  return inputAbs;
+}
+function resolveTranscriptOutput(inputAbs, out) {
+  const base = basename12(inputAbs, extname7(inputAbs));
+  const output = out ? resolve11(out) : join26(dirname9(inputAbs), `${base}-transcript.md`);
+  if (extname7(output).toLowerCase() !== ".md")
+    throw new Error("--out 必须指向一个 .md 文件");
+  return output;
+}
+async function writeMarkdownAtomic(path, markdown) {
+  await mkdir12(dirname9(path), { recursive: true });
+  const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
+  try {
+    await writeFile11(temp, markdown, "utf8");
+    await rename2(temp, path);
+  } finally {
+    await rm2(temp, { force: true });
+  }
+}
+async function runTranscript(input, opts = {}, depsOverride) {
+  if (opts.json)
+    routeLogsToStderr();
+  const inputAbs = await validateTranscriptInput(input);
+  const output = resolveTranscriptOutput(inputAbs, opts.out);
+  const deps = buildDeps(depsOverride);
+  const language = opts.lang?.trim() || "zh-CN";
+  const sourceName = basename12(inputAbs);
+  const title = basename12(inputAbs, extname7(inputAbs));
+  log.step(`▶ 视频转文字稿：${sourceName}`);
+  log.step("① 本地探测视频…");
+  const geometry = deps.probe(inputAbs, opts.ffmpegPath);
+  if (!(geometry.duration > 0))
+    throw new Error("未探测到有效视频时长，无法转写");
+  log.info(`视频时长 ${geometry.duration.toFixed(1)}s`);
+  const pricing = await deps.resolvePricing(PRICE_KEY);
+  log.info(`实时计费：${pricing.billingHint}`);
+  log.step("② 本地抽取 16k 单声道音频（原视频不上传）…");
+  const audio = await deps.extract(inputAbs, opts.ffmpegPath);
+  deps.assertDuration(geometry.duration, audio, opts.ffmpegPath);
+  log.info(`上传物：${basename12(audio)}（仅音频衍生物）`);
+  log.step("③ 上传音频并提交 ASR…");
+  const payload = (fileId) => ({ file_id: fileId, language, word_level: true });
+  const submitted = await uploadAndSubmitTask(deps.cfg, audio, TASK_TYPE3, payload, {
+    force: opts.reupload,
+    onCacheInvalid: () => log.warn("缓存的 file_id 已失效，重新上传后重试…")
+  }, {
+    uploadCached: deps.upload,
+    invalidateUpload: deps.invalidate,
+    submitTask: deps.submit,
+    sleep: deps.sleep
+  });
+  const { taskId } = submitted;
+  const uploaded = { fileId: submitted.fileId, cached: submitted.cached };
+  log.info(`task_id = ${taskId}`);
+  log.step("④ 云端识别中…");
+  const raw = await deps.poll(deps.cfg, TASK_TYPE3, taskId, (status, progress) => {
+    log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
+  });
+  log.tickEnd();
+  const asr = normalizeAsrOutput(raw);
+  const markdown = renderTranscriptMarkdown({
+    title,
+    sourceName,
+    durationSec: geometry.duration,
+    language,
+    generatedAt: deps.now(),
+    asr
+  });
+  await deps.writeMarkdown(output, markdown);
+  return { ok: true, taskId, fileId: uploaded.fileId, output, summaryPending: true };
+}
+function configureTranscriptCommand(cmd, deps) {
+  return cmd.description("本地视频转文字稿：原视频不上传，只上传抽取音频，生成单个待 Agent 补总结的 Markdown").option("-o, --out <file>", "输出 Markdown 文件（缺省 <视频同目录>/<视频名>-transcript.md）").option("--lang <code>", "识别语言代码（默认 zh-CN）", "zh-CN").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录").option("--reupload", "强制重新上传抽取音频，忽略上传缓存").option("--json", "机读模式：stdout 只输出最终结果 JSON").action(async (video, opts) => {
+    const result = await runTranscript(video, opts, deps);
+    if (opts.json)
+      console.log(JSON.stringify(result));
+    else {
+      log.ok(`带时码文字稿已生成：${result.output}`);
+      log.warn("总结仍待驱动 CLI 的 Agent 阅读全文后写回同一个 Markdown");
+    }
+  });
+}
+function registerTranscript(program2) {
+  configureTranscriptCommand(program2.command("transcript <video>"));
+}
+
 // src/index.ts
 try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync5(join21(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync5(join27(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);
@@ -8190,6 +10977,8 @@ registerRender(program2);
 registerSplit(program2);
 registerMatrix(program2);
 registerMg(program2);
+registerTool(program2);
+registerTranscript(program2);
 program2.parseAsync(process.argv).catch((e) => {
   console.error(`
 ❌ ${e instanceof Error ? e.message : String(e)}`);