@gitruck/cli 0.2.7 → 0.2.9

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 join26 } 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,8 @@ var SKILL_NAMES = [
   "gtrk-matrix",
   "gtrk-mg",
   "gtrk-ai-drama",
-  "gtrk-style-maker"
+  "gtrk-style-maker",
+  "gtrk-tools"
 ];
 function installSkill(opts = {}) {
   const destRoot = opts.dir ?? join2(homedir2(), ".claude", "skills");
@@ -8171,12 +8175,1903 @@ 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"];
+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" },
+  billingHint: "2 积分/个",
+  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" },
+  billingHint: "免费",
+  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 videoMatting = {
+  name: "video_matting",
+  title: "视频抠像",
+  description: "把视频主体从背景抠出，产透明背景 webm（像素级、原片直传不压代理；单片 ≤10 分钟）。",
+  kind: "cloud",
+  input: { kind: "video", maxDurationSec: 600 },
+  billingHint: "免费",
+  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 mad = {
+  name: "mad",
+  title: "一键剪 MAD",
+  description: "素材文件夹（3~10 条视频）+ 可选 BGM → 自动选技法 → 单一 .jsx，AE 2020+ 跑一遍出 15~30s 卡点成片工程。仅支持 AE。",
+  kind: "local",
+  input: { kind: "directory" },
+  billingHint: "免费（--bgm 卡点时计费一次云端节拍分析 audio_music_analyze）",
+  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, videoMatting, 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}」`);
+  }
+}
+
+// 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";
+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 产上传物）`);
+  emitBilling(descriptor.billingHint);
+  let up = await deps.uploadCached(deps.cfg, uploadPath, { force: opts.reupload });
+  const buildPayload = (fid) => {
+    const p = descriptor.buildPayload ? descriptor.buildPayload(fid, ctx) : { file_id: fid };
+    mergeParams(p, extraParams);
+    return p;
+  };
+  const taskType = descriptor.taskType;
+  let taskId;
+  try {
+    taskId = await deps.submitTask(deps.cfg, taskType, buildPayload(up.fileId));
+  } catch (e) {
+    if (up.cached && isCloudErrorCode(e) === 6004) {
+      await deps.invalidateUpload(uploadPath);
+      up = await deps.uploadCached(deps.cfg, uploadPath, { force: true });
+      taskId = await deps.submitTask(deps.cfg, taskType, buildPayload(up.fileId));
+    } else
+      throw e;
+  }
+  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 isCode(e, code) {
+  return !!e && typeof e === "object" && e.code === code;
+}
+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) {
+  let up = await deps.uploadCached(cfg, bgmAbs, {});
+  const payload = (fid) => ({ file_id: fid });
+  let taskId;
+  try {
+    taskId = await deps.submitTask(cfg, ANALYZE_TASK, payload(up.fileId));
+  } catch (e) {
+    if (up.cached && isCode(e, 6004)) {
+      await deps.invalidateUpload(bgmAbs);
+      up = await deps.uploadCached(cfg, bgmAbs, { force: true });
+      taskId = await deps.submitTask(cfg, ANALYZE_TASK, payload(up.fileId));
+    } else
+      throw e;
+  }
+  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 {
+        emitBilling2("BGM 卡点将调用一次云端节拍分析（audio_music_analyze），按现行价计费。");
+        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") {
+    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);
+}
+function runList(opts, registry = TOOL_REGISTRY) {
+  const rows = registry.map((d) => ({
+    name: d.name,
+    title: d.title,
+    input: d.input.kind,
+    output: d.outputHint,
+    billingHint: d.billingHint,
+    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/index.ts
 try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync5(join21(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync5(join26(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);
@@ -8190,6 +10085,7 @@ registerRender(program2);
 registerSplit(program2);
 registerMatrix(program2);
 registerMg(program2);
+registerTool(program2);
 program2.parseAsync(process.argv).catch((e) => {
   console.error(`
 ❌ ${e instanceof Error ? e.message : String(e)}`);