@gitruck/cli 0.2.20 → 0.2.22

package/dist/index.js

@@ -4557,6 +4557,7 @@ function writeUserConfig(patch) {
 // src/lib/jianying.ts
 import { join as join4, resolve as resolve2 } from "node:path";
 import { existsSync as existsSync4 } from "node:fs";
+import { cp, mkdir, readdir } from "node:fs/promises";
 function probeJianyingDraftDir() {
   const local = process.env.LOCALAPPDATA;
   if (!local)
@@ -4575,6 +4576,31 @@ function resolveJianyingDraftDir(opt) {
     return saved;
   return probeJianyingDraftDir();
 }
+var JIANYING_DRAFT_FILES = ["draft_content.json", "draft_meta_info.json"];
+async function copyJianyingDraft(srcDir, destDir) {
+  const entries = (await readdir(srcDir, { withFileTypes: true })).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+  const chosen = new Map;
+  for (const fixed of JIANYING_DRAFT_FILES) {
+    const cands = entries.filter((e) => e.isFile() && e.name.toLowerCase().endsWith(fixed));
+    const pick = cands.find((e) => e.name.toLowerCase() === fixed) ?? cands[0];
+    if (pick)
+      chosen.set(pick.name, fixed);
+  }
+  await mkdir(destDir, { recursive: true });
+  const landed = {};
+  const passthrough = [];
+  for (const e of entries) {
+    const fixed = chosen.get(e.name);
+    const dest = join4(destDir, fixed ?? e.name);
+    await cp(join4(srcDir, e.name), dest, { recursive: true });
+    if (fixed)
+      landed[fixed] = dest;
+    else
+      passthrough.push(e.name);
+  }
+  const missing = JIANYING_DRAFT_FILES.filter((f) => !landed[f]);
+  return { landed, missing, complete: missing.length === 0, passthrough };
+}
 
 // src/lib/open.ts
 import { spawn } from "node:child_process";
@@ -6175,7 +6201,7 @@ function registerInstall(program2) {
 
 // src/commands/oralcut.ts
 import { resolve as resolve4, join as join15, dirname as dirname3, basename as basename6, extname as extname2 } from "node:path";
-import { mkdir as mkdir4, writeFile as writeFile5, readFile as readFile4 } from "node:fs/promises";
+import { mkdir as mkdir5, writeFile as writeFile5, readFile as readFile4 } from "node:fs/promises";
 import { existsSync as existsSync13 } from "node:fs";
 
 // src/lib/config.ts
@@ -6330,7 +6356,7 @@ async function download(url, dest) {
 
 // src/lib/upload-cache.ts
 import { join as join11 } from "node:path";
-import { stat as stat3, mkdir, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { stat as stat3, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
 import { existsSync as existsSync10 } from "node:fs";
 
 // src/lib/chunk-upload.ts
@@ -6581,7 +6607,7 @@ async function load() {
   }
 }
 async function save(cache) {
-  await mkdir(CACHE_DIR, { recursive: true });
+  await mkdir2(CACHE_DIR, { recursive: true });
   await writeFile2(CACHE_FILE, JSON.stringify(cache, null, 2));
 }
 var defaultUploadCacheDeps = {
@@ -6608,7 +6634,7 @@ async function loadSessions() {
   }
 }
 async function saveSessions(sessions) {
-  await mkdir(CACHE_DIR, { recursive: true });
+  await mkdir2(CACHE_DIR, { recursive: true });
   await writeFile2(SESSION_FILE, JSON.stringify(sessions, null, 2));
 }
 var fileSessionStore = {
@@ -6696,7 +6722,7 @@ async function uploadAndSubmitTask(cfg, path, taskType, buildPayload, options =
 }
 
 // src/lib/media.ts
-import { mkdir as mkdir2, stat as stat4 } from "node:fs/promises";
+import { mkdir as mkdir3, stat as stat4 } from "node:fs/promises";
 import { existsSync as existsSync11 } from "node:fs";
 import { basename as basename4, extname, join as join12 } from "node:path";
 function parseFps(rate) {
@@ -6747,7 +6773,7 @@ function probeDuration(path, ffmpegPath) {
 async function artifactPath(inputAbs, ext) {
   const s = await stat4(inputAbs);
   const base = basename4(inputAbs, extname(inputAbs));
-  await mkdir2(audioCacheDir(), { recursive: true });
+  await mkdir3(audioCacheDir(), { recursive: true });
   return join12(audioCacheDir(), `${base}.${s.size}_${Math.round(s.mtimeMs)}.${ext}`);
 }
 async function extractAudio(inputAbs, ffmpegPath) {
@@ -6810,7 +6836,7 @@ function assertDurationConsistent(originalDuration, artifactAbs, ffmpegPath, tol
 
 // src/lib/materialize.ts
 import { join as join14, basename as basename5 } from "node:path";
-import { mkdir as mkdir3, cp, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, writeFile as writeFile4 } from "node:fs/promises";
 
 // src/lib/render.ts
 import { writeFile as writeFile3, unlink, readFile as readFile3 } from "node:fs/promises";
@@ -7037,7 +7063,7 @@ async function materializeResult(opts) {
   if (!files.length)
     throw new Error("任务无工程文件产物（检查 project_formats / 任务是否产出）");
   const errors = { ...output.errors ?? {} };
-  await mkdir3(outDir, { recursive: true });
+  await mkdir4(outDir, { recursive: true });
   const resultPath = join14(outDir, "result.json");
   const writeResult = async (extra) => {
     const r = {
@@ -7061,7 +7087,7 @@ async function materializeResult(opts) {
   for (const f of files) {
     const base = baseFormat(f.format);
     const fmtDir = join14(outDir, base);
-    await mkdir3(fmtDir, { recursive: true });
+    await mkdir4(fmtDir, { recursive: true });
     const dest = join14(fmtDir, f.filename);
     try {
       await dl(f.download_url, dest);
@@ -7078,13 +7104,17 @@ async function materializeResult(opts) {
   }
   let jianyingDraftPath = null;
   if (byFormat.jianying && opts.draftDir) {
+    const dest = join14(opts.draftDir, basename5(outDir));
     try {
-      jianyingDraftPath = join14(opts.draftDir, basename5(outDir));
-      await mkdir3(jianyingDraftPath, { recursive: true });
-      await cp(join14(outDir, "jianying"), jianyingDraftPath, { recursive: true });
-      log.info(`剪映草稿已落到：${jianyingDraftPath}`);
+      const landing = await copyJianyingDraft(join14(outDir, "jianying"), dest);
+      if (landing.complete) {
+        jianyingDraftPath = dest;
+        log.info(`剪映草稿已落到：${dest}`);
+      } else {
+        errors["jianying:draft"] = `草稿两件套不全（缺 ${landing.missing.join("、")}），剪映列表里不会显示：${dest}`;
+        log.warn(errors["jianying:draft"]);
+      }
     } catch (e) {
-      jianyingDraftPath = null;
       errors["jianying:draft"] = e instanceof Error ? e.message : String(e);
       log.warn(`剪映草稿落盘失败：${errors["jianying:draft"]}`);
     }
@@ -7259,7 +7289,7 @@ async function runOralCut(input, opts) {
   const { taskId } = submitted;
   const up = { fileId: submitted.fileId, cached: submitted.cached };
   log.info(`task_id = ${taskId}`);
-  await mkdir4(outDir, { recursive: true });
+  await mkdir5(outDir, { recursive: true });
   await writeFile5(join15(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE, fileId: up.fileId, source: inputAbs, formats, createdAt: new Date().toISOString() }, null, 2));
   log.step("④ 云端处理中（每 5s 轮询）…");
   const result = await pollTask(cfg, TASK_TYPE, taskId, (status, progress) => {
@@ -7285,12 +7315,140 @@ async function runOralCut(input, opts) {
 
 // src/commands/long2short.ts
 import { resolve as resolve6, join as join17, dirname as dirname5, basename as basename8, extname as extname5 } from "node:path";
-import { mkdir as mkdir6, writeFile as writeFile7, cp as cp2 } from "node:fs/promises";
+import { mkdir as mkdir7, writeFile as writeFile7 } from "node:fs/promises";
 import { existsSync as existsSync16 } from "node:fs";
 
+// src/lib/clip-brief.ts
+var str = (v) => {
+  const s = typeof v === "string" ? v.trim() : "";
+  return s ? s : undefined;
+};
+var num = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
+var list = (v) => Array.isArray(v) ? v.map((x) => str(x)).filter((x) => !!x) : [];
+function fmtTime(ms) {
+  const total = Math.max(0, Math.round((num(ms) ?? 0) / 1000));
+  const s = total % 60;
+  const m = Math.floor(total / 60) % 60;
+  const h = Math.floor(total / 3600);
+  const mm = h ? String(m).padStart(2, "0") : String(m);
+  return `${h ? `${h}:` : ""}${mm}:${String(s).padStart(2, "0")}`;
+}
+var baseName = (p) => p.split(/[\\/]/).pop() || p;
+var cell = (s) => s.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ");
+function jumpcutText(note) {
+  if (note === "jumpcut_off")
+    return "未启用跳剪（`--no-jump-cut`），片段按原样保留。";
+  if (note === "too_short")
+    return "片段过短，跳剪跳过（保留全部内容）。";
+  if (note === "degraded")
+    return "跳剪降级：本条未压缩，保留全部内容。";
+  return note;
+}
+function clipDurationMs(clip) {
+  return num(clip.total_duration_ms) ?? num(clip.duration_ms);
+}
+function clipSegmentCount(clip) {
+  return num(clip.segment_count) ?? (Array.isArray(clip.segments) ? clip.segments.length : undefined);
+}
+function sourceSpan(clip) {
+  const segs = Array.isArray(clip.segments) ? clip.segments : [];
+  if (segs.length) {
+    const b2 = num(segs[0]?.begin_time);
+    const e2 = num(segs[segs.length - 1]?.end_time);
+    if (b2 != null && e2 != null)
+      return [b2, e2];
+  }
+  const b = num(clip.begin_time);
+  const e = num(clip.end_time);
+  return b != null && e != null ? [b, e] : undefined;
+}
+function renderClipBrief(clip, index, files = {}) {
+  const title = str(clip.title);
+  const out = [`# clip${index}${title ? `「${title}」` : ""}`, ""];
+  const bits = [];
+  const dur = clipDurationMs(clip);
+  if (dur != null)
+    bits.push(`时长 ${fmtTime(dur)}`);
+  const segCount = clipSegmentCount(clip);
+  if (segCount != null)
+    bits.push(`${segCount} 个保留片段`);
+  const span = sourceSpan(clip);
+  if (span)
+    bits.push(`源片 ${fmtTime(span[0])}–${fmtTime(span[1])}`);
+  if (bits.length)
+    out.push(`- ${bits.join(" · ")}`, "");
+  const score = num(clip.score);
+  const reason = str(clip.score_reason);
+  if (score != null || reason) {
+    out.push("## 入选理由", "");
+    out.push([score != null ? `**评分 ${score}**` : null, reason].filter(Boolean).join(" — "), "");
+  }
+  const summary = str(clip.summary);
+  if (summary)
+    out.push("## 简介", "", summary, "");
+  const note = str(clip.jumpcut_note);
+  if (note)
+    out.push("## 跳剪", "", jumpcutText(note), "");
+  const cats = [
+    ["主题", list(clip.themes)],
+    ["标签", list(clip.tags)],
+    ["类型", list(clip.genres)],
+    ["调性", list(clip.moods)]
+  ];
+  const shown = cats.filter(([, v]) => v.length);
+  if (shown.length) {
+    out.push("## 分类与调性", "");
+    for (const [k, v] of shown)
+      out.push(`- ${k}：${v.join("、")}`);
+    out.push("");
+  }
+  const hl = Array.isArray(clip.highlight_words) ? clip.highlight_words : [];
+  const hlRows = hl.map((h) => ({ text: str(h?.text), at: num(h?.begin_time) })).filter((h) => h.text);
+  if (hlRows.length) {
+    out.push("## 高光词（源片时码）", "");
+    for (const h of hlRows)
+      out.push(`- ${h.at != null ? `${fmtTime(h.at)} ` : ""}「${h.text}」`);
+    out.push("");
+  }
+  const formats = Object.keys(files).filter((f) => files[f]?.length);
+  if (formats.length) {
+    out.push("## 本条工程文件", "");
+    for (const f of formats)
+      out.push(`- ${f}：${files[f].map(baseName).join("、")}`);
+    out.push("");
+  }
+  return `${out.join(`
+`).replace(/\n{3,}/g, `
+
+`).trimEnd()}
+`;
+}
+function renderClipsOverview(clips, ctx) {
+  const name = ctx.source.split(/[\\/]/).pop() || ctx.source;
+  const out = [`# ${name} · 长剪短总览`, ""];
+  out.push(`- 源片：\`${ctx.source}\``);
+  out.push(`- 切片：${clips.length} 条`);
+  out.push(`- 跳剪：${ctx.jumpCut ? "开" : "关"}`);
+  if (ctx.splitMaterials?.total)
+    out.push(`- 分屏素材：${ctx.splitMaterials.landed}/${ctx.splitMaterials.total} 条已落地`);
+  if (ctx.taskId)
+    out.push(`- task_id：\`${ctx.taskId}\``);
+  out.push("");
+  out.push("| # | 标题 | 时长 | 评分 | 简介 |", "| --- | --- | --- | --- | --- |");
+  for (const [i, clip] of clips.entries()) {
+    const dur = clipDurationMs(clip);
+    const score = num(clip.score);
+    out.push(`| clip${i} | ${cell(str(clip.title) ?? "—")} | ${dur != null ? fmtTime(dur) : "—"} | ${score ?? "—"} | ${cell(str(clip.summary) ?? "—")} |`);
+  }
+  out.push("", "> 逐条入选理由、跳剪说明、高光词见各 `clip{i}/clip.md`。");
+  return `${out.join(`
+`)}
+`;
+}
+
 // src/lib/tool-runner.ts
 import { resolve as resolve5, join as join16, dirname as dirname4, basename as basename7, extname as extname4 } from "node:path";
-import { mkdir as mkdir5, writeFile as writeFile6, stat as stat5 } from "node:fs/promises";
+import { mkdir as mkdir6, writeFile as writeFile6, stat as stat5 } from "node:fs/promises";
 import { createWriteStream, existsSync as existsSync15 } from "node:fs";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline } from "node:stream/promises";
@@ -8902,7 +9060,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   const isMulti = MULTI_INPUT_KINDS.has(descriptor.input.kind);
   const inputList = isMulti ? (Array.isArray(inputArg) ? inputArg : inputArg != null ? [inputArg] : []).map((p) => resolve5(p)) : undefined;
   const inputAbs = isMulti ? inputList[0] : typeof inputArg === "string" ? resolve5(inputArg) : undefined;
-  const baseName = inputAbs ? basename7(inputAbs, extname4(inputAbs)) : descriptor.name;
+  const baseName2 = inputAbs ? basename7(inputAbs, extname4(inputAbs)) : descriptor.name;
   if (isMulti) {
     validateToolInputs(descriptor, inputList);
   } else {
@@ -8914,7 +9072,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   const ctx = {
     inputAbs,
     ...inputList ? { inputAbsList: inputList } : {},
-    baseName,
+    baseName: baseName2,
     ffmpegPath: opts.ffmpegPath,
     opts,
     extraParams,
@@ -8971,7 +9129,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     taskId = submitted.taskId;
     fileId = submitted.fileId;
   }
-  await mkdir5(outDir, { recursive: true });
+  await mkdir6(outDir, { recursive: true });
   const fingerprint2 = inputList ? await Promise.all(inputList.map((p) => safeFingerprint(p))) : inputAbs ? await safeFingerprint(inputAbs) : undefined;
   await writeFile6(join16(outDir, "task.json"), JSON.stringify({
     tool: descriptor.name,
@@ -9077,6 +9235,34 @@ function buildLong2ShortPayload(fileId, opts, geo, inputAbs, formats, draftTarge
   mergeParams(p, parseExtraParams2(opts.param ?? [], opts.paramsJson));
   return p;
 }
+async function copyClipDraftsToRoot(clipDirs, draftTarget, errors) {
+  const paths = [];
+  let complete = 0;
+  let attempted = 0;
+  for (const [i, dir] of clipDirs.entries()) {
+    const src = join17(dir, "jianying");
+    if (!existsSync16(src)) {
+      paths.push(null);
+      continue;
+    }
+    attempted++;
+    const dest = `${draftTarget}_clip${i}`;
+    try {
+      const landing = await copyJianyingDraft(src, dest);
+      if (landing.complete) {
+        complete++;
+        paths.push(dest);
+      } else {
+        paths.push(null);
+        errors[`clip${i}:jianying:draft`] = `草稿两件套不全（缺 ${landing.missing.join("、")}），剪映列表里不会显示：${dest}`;
+      }
+    } catch (e) {
+      paths.push(null);
+      errors[`clip${i}:jianying:draft`] = e instanceof Error ? e.message : String(e);
+    }
+  }
+  return { paths, complete, attempted };
+}
 function registerLong2Short(program2) {
   program2.command("long2short <input>").description("长剪短闭环：本地抽音频/720p 代理 → 只传抽出物 → 云端选段跳剪（可选分屏）→ 逐 clip 拉回 gtrk/剪映/PR 三方工程").option("--language <code>", "源语种（必填，如 zh-CN；取值以服务端支持列表为准）").option("--split-screen", "开启智能分屏：本地改传 720p 代理，云端在代理上检测多人同框并烤 720p 分屏素材（素材落毛片旁 split_screen/）").option("--split-orientation <o>", "分屏方向 auto|lr|tb（缺省服务端 auto=按内容随机）").option("--main-topic <text>", "主题引导（影响选段偏好）").option("--duration-pref <p>", "成片时长偏好（缺省服务端 auto；成片条数由内容语义决定、不可指定）").option("--max-clip-sec <n>", "单条成片时长安全上限（秒；缺省服务端默认）").option("--no-jump-cut", "关闭跳剪（默认开：片内去水词/冗余，只删不重排）").option("--output-size <s>", "输出画布 9:16|16:9|1:1 或自定义 WxH（缺省服务端 9:16）").option("-f, --formats <list>", "三方格式（逗号分隔，云端逐 clip 直产）", "gtrk,jianying,xml").option("--jianying-draft-dir <dir>", "剪映草稿根目录；传路径或 auto（默认读 gtrk init 配置 / 自动探测）").option("-o, --out <dir>", "产物根目录（缺省 = <毛片同目录>/<毛片名>-long2short）").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录（缺省 ~/.gitruck/ffmpeg → 系统 PATH）").option("--param <k=v>", "透传任意云端参数（标量、可重复）", collectParam2, []).option("--params-json <json>", `透传任意云端参数（JSON 对象、支持嵌套；如 '{"split_screen":{"prefer_mode":"..."}}'）`).option("--reupload", "强制重新上传，忽略本地上传缓存").option("--no-open", "完成后不自动打开产物根目录（默认会自动打开一次）").option("--json", "机读模式：人读日志转 stderr，stdout 只输出根级结果 JSON").action(async (input, opts) => {
     await runLong2Short(input, opts);
@@ -9124,7 +9310,7 @@ async function runLong2Short(input, opts) {
   });
   const { taskId, fileId } = { taskId: submitted.taskId, fileId: submitted.fileId };
   log.info(`task_id = ${taskId}`);
-  await mkdir6(outDir, { recursive: true });
+  await mkdir7(outDir, { recursive: true });
   await writeFile7(join17(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE2, fileId, source: inputAbs, formats, createdAt: new Date().toISOString() }, null, 2));
   log.step("④ 云端处理中（选段/跳剪" + (opts.splitScreen ? "/分屏" : "") + "，每 5s 轮询）…");
   const output = await pollToolTask(cfg, TASK_TYPE2, taskId, {
@@ -9150,7 +9336,7 @@ async function runLong2Short(input, opts) {
       if (!/^(?:[A-Za-z]:[\\/]|[\\/])/.test(dest))
         dest = join17(dirname5(inputAbs), dest);
       try {
-        await mkdir6(dirname5(dest), { recursive: true });
+        await mkdir7(dirname5(dest), { recursive: true });
         await download(url, dest);
         splitLanded++;
       } catch (e) {
@@ -9186,20 +9372,40 @@ async function runLong2Short(input, opts) {
       log.warn(`clip${i} 落地失败（不连坐其余）：${errors[`clip${i}`]}`);
     }
   }
-  if (draftRoot) {
-    for (const [i, cr] of clipResults.entries()) {
-      const src = join17(cr.dir, "jianying");
-      if (!existsSync16(src))
-        continue;
-      const dest = `${draftTarget}_clip${i}`;
-      try {
-        await mkdir6(dest, { recursive: true });
-        await cp2(src, dest, { recursive: true });
-      } catch (e) {
-        errors[`clip${i}:jianying:draft`] = e instanceof Error ? e.message : String(e);
-      }
+  if (draftRoot && draftTarget) {
+    const landing = await copyClipDraftsToRoot(clipResults.map((c3) => c3.dir), draftTarget, errors);
+    landing.paths.forEach((p, i) => {
+      clipResults[i].jianyingDraftPath = p;
+    });
+    const { complete, attempted } = landing;
+    if (!attempted)
+      log.warn("没有任何 clip 产出剪映草稿，草稿根未落地");
+    else if (complete === attempted)
+      log.info(`剪映草稿：<草稿根>/${outName}_clip{i} —— ${complete}/${attempted} 条两件套齐全（剪映里直接可见）`);
+    else if (complete) {
+      log.info(`剪映草稿：<草稿根>/${outName}_clip{i} —— ${complete}/${attempted} 条两件套齐全（剪映里可见）`);
+      log.warn(`另有 ${attempted - complete} 条草稿两件套不全，剪映里不会显示（详见 result.json errors）`);
+    } else
+      log.warn(`${attempted} 条草稿两件套均不全，剪映里不会显示（详见 result.json errors）`);
+  }
+  for (const [i, cr] of clipResults.entries()) {
+    try {
+      await mkdir7(cr.dir, { recursive: true });
+      await writeFile7(join17(cr.dir, "clip.md"), renderClipBrief(clips[i], i, cr.files));
+    } catch (e) {
+      errors[`clip${i}:brief`] = e instanceof Error ? e.message : String(e);
     }
-    log.info(`剪映草稿：<草稿根>/${outName}_clip{i}（剪映里直接可见）`);
+  }
+  try {
+    await writeFile7(join17(outDir, "clips.md"), renderClipsOverview(clips, {
+      source: inputAbs,
+      jumpCut: opts.jumpCut !== false,
+      splitMaterials: { landed: splitLanded, total: manifest.length },
+      taskId
+    }));
+    log.info(`总览已生成：clips.md（逐条见 clip{i}/clip.md）`);
+  } catch (e) {
+    errors["clips.md"] = e instanceof Error ? e.message : String(e);
   }
   await writeFile7(join17(outDir, "report.json"), JSON.stringify(output.report ?? {}, null, 2));
   const ok = Object.keys(errors).length === 0 && clipResults.some((c3) => c3.ok);
@@ -9360,7 +9566,7 @@ function registerRender(program2) {
 // src/commands/split.ts
 import { resolve as resolve9, join as join21, dirname as dirname8, basename as basename11 } from "node:path";
 import { existsSync as existsSync18 } from "node:fs";
-import { readFile as readFile5, writeFile as writeFile8, mkdir as mkdir7 } from "node:fs/promises";
+import { readFile as readFile5, writeFile as writeFile8, mkdir as mkdir8 } from "node:fs/promises";
 import { createHash } from "node:crypto";
 
 // src/lib/gtrk-writeback.ts
@@ -9481,7 +9687,7 @@ async function runView(baseDir, gtrkPath, transcriptPath, opts) {
   const { gtrk } = readGtrk(gtrkPath);
   const view = projectTranscript(transcript, gtrk, { words: opts.words });
   const splitDir = join21(baseDir, "split");
-  await mkdir7(splitDir, { recursive: true });
+  await mkdir8(splitDir, { recursive: true });
   const viewPath = join21(splitDir, "view.json");
   await writeFile8(viewPath, JSON.stringify(view, null, 2));
   const dropped = view.utterances.filter((u) => u.dropped).length;
@@ -9540,7 +9746,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
   });
   writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
   const splitDir = join21(baseDir, "split");
-  await mkdir7(splitDir, { recursive: true });
+  await mkdir8(splitDir, { recursive: true });
   const dispatchPath = join21(splitDir, "dispatch.json");
   await writeFile8(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
   let mdPath = null;
@@ -9579,7 +9785,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
 // src/commands/matrix.ts
 import { resolve as resolve11, join as join22, dirname as dirname9, basename as basename12 } from "node:path";
 import { existsSync as existsSync20 } from "node:fs";
-import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir8, rename } from "node:fs/promises";
+import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir9, rename } from "node:fs/promises";
 
 // src/lib/solid-png.ts
 import { deflateSync } from "node:zlib";
@@ -10359,8 +10565,8 @@ function collectMaterialRefs(gtrk) {
           const id = c3[key];
           if (typeof id !== "string" || id === "")
             continue;
-          const list = out.get(id) ?? [];
-          list.push({
+          const list2 = out.get(id) ?? [];
+          list2.push({
             track: group,
             track_index: trackIndex,
             clip_id: typeof c3.clip_id === "string" ? c3.clip_id : null,
@@ -10368,7 +10574,7 @@ function collectMaterialRefs(gtrk) {
             track_ed: clipTrackEd(c3),
             key
           });
-          out.set(id, list);
+          out.set(id, list2);
         }
       }
     }
@@ -10410,15 +10616,15 @@ function checkMaterialIntegrity(opts) {
     }
     if (present)
       continue;
-    const list = refs.get(id) ?? [];
+    const list2 = refs.get(id) ?? [];
     const entry = {
       id,
       path,
       kind,
       resolved,
-      referenced: list.length > 0,
-      refCount: list.length,
-      refs: list
+      referenced: list2.length > 0,
+      refCount: list2.length,
+      refs: list2
     };
     (kind === "relative" ? dangling : external).push(entry);
   }
@@ -10567,9 +10773,9 @@ function dedupeBeatQueries(queries) {
       const best = bestByClip.get(r.clip_id);
       if (best.qi === qi && best.r === r)
         return true;
-      const list = best.r.also_matched_queries ??= [];
-      if (!list.includes(q.query))
-        list.push(q.query);
+      const list2 = best.r.also_matched_queries ??= [];
+      if (!list2.includes(q.query))
+        list2.push(q.query);
       return false;
     });
   }
@@ -10792,7 +10998,7 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     beats
   });
   const splitDir = join22(baseDir, "split");
-  await mkdir8(splitDir, { recursive: true });
+  await mkdir9(splitDir, { recursive: true });
   const planPath = join22(splitDir, "broll-plan.json");
   await writeFile9(planPath, JSON.stringify(plan, null, 2));
   log.ok(`候选清单已生成：${planPath}（${beats.length} beat · ${okCount}/${totalQueries} query 成功 · ${resultCount} 条候选）`);
@@ -10857,7 +11063,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
   log.step(`▶ 候选铺轨（${layN} 轨 · 平铺 ${slotCount} 槽位 · ${clipIds.size} 个 clip，preview 代理）…`);
   const gtrkDir = dirname9(gtrkPath);
   const previewDir = join22(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
-  await mkdir8(previewDir, { recursive: true });
+  await mkdir9(previewDir, { recursive: true });
   const prevSource = new Map;
   const prevBroll = gtrk.struct_meta?.broll;
   for (const b of prevBroll?.beats ?? []) {
@@ -10918,8 +11124,8 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     forceRelay
   });
   if (summary.refused) {
-    const list = summary.keptEditedTracks;
-    log.err(`拒绝铺轨：${list.length} 条候选轨已被你在客户端编辑过（track_index ${list.join("/") || "-"}）——` + "本次不剥它们、也不铺新轨，工程文件零改动。");
+    const list2 = summary.keptEditedTracks;
+    log.err(`拒绝铺轨：${list2.length} 条候选轨已被你在客户端编辑过（track_index ${list2.join("/") || "-"}）——` + "本次不剥它们、也不铺新轨，工程文件零改动。");
     for (const w of warnings)
       log.warn(w);
     log.warn("下一步二选一：① 在客户端处置那条轨（删掉 / 移走 / 改用别的轨）后重跑本命令；" + "② 确知要丢弃那条轨上的编辑 → 加 --force-relay 强制剥离重铺" + "（会删掉已确认原片的 broll-raw-* 素材登记，盘上原片文件成孤儿，不可恢复）。");
@@ -10927,7 +11133,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     return {
       lay: {
         refused: true,
-        keptEditedTracks: list,
+        keptEditedTracks: list2,
         laidTracks: [],
         laidClips: 0,
         removedTracks: [],
@@ -10945,7 +11151,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     const abs = join22(gtrkDir, ...rel.split("/"));
     try {
       if (!existsSync20(abs)) {
-        await mkdir8(dirname9(abs), { recursive: true });
+        await mkdir9(dirname9(abs), { recursive: true });
         const tmp = `${abs}.tmp-${process.pid}`;
         await writeFile9(tmp, encodeSolidPng(spec));
         await rename(tmp, abs);
@@ -11062,7 +11268,7 @@ function slugify3(name) {
 // src/commands/mg.ts
 import { resolve as resolve12, join as join23, dirname as dirname10, basename as basename13 } from "node:path";
 import { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile7, mkdir as mkdir9, copyFile } from "node:fs/promises";
+import { readFile as readFile7, mkdir as mkdir10, copyFile } from "node:fs/promises";
 
 // src/lib/mg-lint.ts
 var CDN_OK = [/lib\.baomitu\.com/i, /cdnjs\.cloudflare\.com/i, /unpkg\.com/i];
@@ -11926,9 +12132,9 @@ function detectPrimitiveLoops(html) {
   }
   const callsByFunction = new Map;
   const pushCall = (fn, at) => {
-    const list = callsByFunction.get(fn.declStart) ?? [];
-    list.push({ at, loops: executionLoopsAt(at) });
-    callsByFunction.set(fn.declStart, list);
+    const list2 = callsByFunction.get(fn.declStart) ?? [];
+    list2.push({ at, loops: executionLoopsAt(at) });
+    callsByFunction.set(fn.declStart, list2);
   };
   const functionNames = new Set(functions.map((fn) => fn.name).filter((name) => name !== null));
   for (const call of code.matchAll(/\b([A-Za-z_$][\w$]*)\s*\(/g)) {
@@ -12129,21 +12335,27 @@ function filterDecls(styleDecls) {
     out.push(m[1].trim());
   return out;
 }
-function styleBlockOwnDecls(html) {
+function styleBlockRules(html) {
   const out = [];
   for (const sm of html.matchAll(/<style\b[^>]*>([\s\S]*?)<\/style\s*>/gi)) {
     const css = sm[1].replace(/\/\*[\s\S]*?\*\//g, " ");
     const stack = [];
+    const selStack = [];
+    let segStart = 0;
     for (let i = 0;i < css.length; i++) {
       const c3 = css[i];
       if (c3 === '"' || c3 === "'") {
         i = skipString(css, i);
         continue;
       }
-      if (c3 === "{")
+      if (c3 === "{") {
         stack.push(i);
-      else if (c3 === "}") {
+        selStack.push(css.slice(segStart, i));
+        segStart = i + 1;
+      } else if (c3 === "}") {
         const open2 = stack.pop();
+        const sel = selStack.pop() ?? "";
+        segStart = i + 1;
         if (open2 === undefined)
           continue;
         let own = css.slice(open2 + 1, i);
@@ -12151,8 +12363,9 @@ function styleBlockOwnDecls(html) {
           prev = own;
           own = own.replace(/\{[^{}]*\}/g, " ");
         }
-        out.push(own);
-      }
+        out.push({ selector: sel.trim(), own });
+      } else if (c3 === ";")
+        segStart = i + 1;
     }
   }
   return out;
@@ -12212,21 +12425,138 @@ function tweenVarObjects(js) {
   }
   return out;
 }
+var GSAP_TRANSFORM_KEY = /^(?:transform|x|y|z|xPercent|yPercent|scale|scaleX|scaleY|scaleZ|rotate|rotation|rotationX|rotationY|rotationZ|skew|skewX|skewY|translateX|translateY|translateZ)$/;
+var TWEENING_METHOD = /^(?:to|from|fromTo)$/;
+function selectorSubjectKeys(selector) {
+  const keys = [];
+  for (const alt of selector.split(",")) {
+    const subject = alt.trim().split(/[\s>+~]+/).filter(Boolean).pop();
+    if (!subject)
+      continue;
+    const core = subject.split(/[:\[]/)[0];
+    for (const m of core.matchAll(/([.#])([A-Za-z_][\w-]*)/g))
+      keys.push(`${m[1] === "#" ? "id" : "class"}:${m[2]}`);
+  }
+  return keys;
+}
+function tagIdentityKeys(tag) {
+  const keys = [];
+  const id = attr(tag, "id");
+  if (id)
+    keys.push(`id:${id.trim()}`);
+  for (const cls of (attr(tag, "class") ?? "").trim().split(/\s+/))
+    if (cls)
+      keys.push(`class:${cls}`);
+  return keys;
+}
+function tweenCalls(js) {
+  const out = [];
+  const re = /\.\s*(to|from|fromTo|set)\s*\(/g;
+  let m;
+  while (m = re.exec(js)) {
+    const open2 = m.index + m[0].length - 1;
+    const args = parenArg(js, open2);
+    re.lastIndex = open2 + 1;
+    if (args === null)
+      continue;
+    const target = readObjValue(args, 0);
+    const bodies = [];
+    for (let i = 0;i < args.length; i++) {
+      const c3 = args[i];
+      if (c3 === '"' || c3 === "'" || c3 === "`") {
+        i = skipString(args, i);
+        continue;
+      }
+      if (c3 !== "{")
+        continue;
+      const body = braceBlock(args, i);
+      bodies.push(body);
+      i += body.length + 1;
+    }
+    out.push({ method: m[1], target, bodies });
+  }
+  return out;
+}
+function selectorBindings(js) {
+  const out = new Map;
+  const re = /([A-Za-z_$][\w$]*)\s*=\s*(?:[A-Za-z_$][\w$]*\s*\.\s*)?([A-Za-z_$][\w$]*)\s*\(\s*(["'])(.*?)\3\s*\)/g;
+  for (const m of js.matchAll(re)) {
+    const [, name, fn, , raw] = m;
+    const keys = fn === "getElementById" ? [`id:${raw.trim()}`] : /^\s*[.#]/.test(raw) ? selectorSubjectKeys(raw) : [];
+    if (!keys.length)
+      continue;
+    const prev = out.get(name) ?? [];
+    out.set(name, [...new Set([...prev, ...keys])]);
+  }
+  return out;
+}
+function tweenTargetKeys(target, bindings) {
+  const t = target.trim();
+  const lit = stringLiteral(t);
+  if (lit !== null)
+    return /^\s*[.#]/.test(lit) ? selectorSubjectKeys(lit) : [];
+  if (/^[A-Za-z_$][\w$]*$/.test(t))
+    return bindings.get(t) ?? [];
+  return [];
+}
+function topLevelObjKeys(body) {
+  const keys = [];
+  let depth = 0;
+  let expectKey = true;
+  for (let i = 0;i < body.length; i++) {
+    const c3 = body[i];
+    if (c3 === '"' || c3 === "'" || c3 === "`") {
+      if (depth === 0 && expectKey) {
+        const end = skipString(body, i);
+        const name = body.slice(i + 1, end);
+        const rest = body.slice(end + 1);
+        if (/^\s*:/.test(rest)) {
+          keys.push(name);
+          expectKey = false;
+        }
+      }
+      i = skipString(body, i);
+      continue;
+    }
+    if (c3 === "(" || c3 === "[" || c3 === "{")
+      depth++;
+    else if (c3 === ")" || c3 === "]" || c3 === "}")
+      depth = Math.max(0, depth - 1);
+    else if (c3 === "," && depth === 0)
+      expectKey = true;
+    else if (depth === 0 && expectKey && /[A-Za-z_$]/.test(c3)) {
+      const m = /^([A-Za-z_$][\w$]*)\s*:/.exec(body.slice(i));
+      if (m) {
+        keys.push(m[1]);
+        expectKey = false;
+        i += m[1].length;
+      }
+    }
+  }
+  return keys;
+}
 function detectFilterCost(html) {
   const src = maskHtmlComments(html);
   const svgConvIds = svgConvolutionFilterIds(src);
   const animated = [];
   const staticFullBleed = [];
+  const staticTransformed = [];
   const indeterminate = [];
   const add = (bucket, site) => {
     const s = site.replace(/\s+/g, " ").trim().slice(0, 120);
     if (!bucket.includes(s))
       bucket.push(s);
   };
-  for (const own of styleBlockOwnDecls(src)) {
+  const staticFilterSites = new Map;
+  for (const { selector, own } of styleBlockRules(src)) {
     const hit = filterDecls(own).filter((val) => filterValueConvolves(val, svgConvIds));
-    if (hit.length && isFullBleedStyle(own))
+    if (!hit.length)
+      continue;
+    if (isFullBleedStyle(own))
       add(staticFullBleed, `<style> 规则：filter:${hit[0]}`);
+    for (const key of selectorSubjectKeys(selector))
+      if (!staticFilterSites.has(key))
+        staticFilterSites.set(key, `<style> 规则 ${selector.slice(0, 60)}：filter:${hit[0]}`);
   }
   for (const m of src.matchAll(/<[a-zA-Z][^>]*>/g)) {
     const tag = m[0];
@@ -12236,9 +12566,13 @@ function detectFilterCost(html) {
     const byAttr = refAttr !== undefined && filterValueConvolves(refAttr, svgConvIds) ? refAttr : null;
     if (!inline.length && byAttr === null)
       continue;
+    const site = inline.length ? `内联 style：filter:${inline[0]}` : `SVG 属性：filter="${byAttr}"`;
+    for (const key of tagIdentityKeys(tag))
+      if (!staticFilterSites.has(key))
+        staticFilterSites.set(key, site);
     if (!isFullBleedStyle(style))
       continue;
-    add(staticFullBleed, inline.length ? `内联 style：filter:${inline[0]}` : `SVG 属性：filter="${byAttr}"`);
+    add(staticFullBleed, site);
   }
   const js = maskJsComments(scriptBodiesOnly(src));
   for (const body of tweenVarObjects(js)) {
@@ -12253,7 +12587,22 @@ function detectFilterCost(html) {
     if (svgConvIds.size && /(?:^|[{,])\s*["']?stdDeviation["']?\s*:/.test(body))
       add(animated, "补间驱动 SVG 滤镜基元的 stdDeviation");
   }
-  return { animated, staticFullBleed, indeterminate };
+  if (staticFilterSites.size) {
+    const bindings = selectorBindings(js);
+    for (const { method, target, bodies } of tweenCalls(js)) {
+      if (!TWEENING_METHOD.test(method))
+        continue;
+      const driven = bodies.some((b) => topLevelObjKeys(b).some((k) => GSAP_TRANSFORM_KEY.test(k)));
+      if (!driven)
+        continue;
+      for (const key of tweenTargetKeys(target, bindings)) {
+        const site = staticFilterSites.get(key);
+        if (site)
+          add(staticTransformed, `${site} —— 而 \`.${method}(${target.trim().slice(0, 30)}, …)\` 驱动了它的 transform`);
+      }
+    }
+  }
+  return { animated, staticFullBleed, staticTransformed, indeterminate };
 }
 function lintParticle(html, opts = {}) {
   const v = [];
@@ -12359,6 +12708,8 @@ function lintParticle(html, opts = {}) {
     push("c-filter-animated", false, `时间线补间直接驱动了真卷积滤镜（${cost.animated.slice(0, 3).join("；")}）——` + "blur / drop-shadow / feGaussianBlur 是**真卷积**，每帧成本 ∝「被覆盖面积 × 半径 × 帧数」；" + "一旦被补间驱动，卷积结果**每帧失效**、缓存彻底失灵，这是本组三项里成本机制最重的一项。" + "改法：用 `opacity` / `transform`（`scale` / 位移）表达同一叙事动作；" + "确需滤镜就做成**静态两态切换**（滤镜值不随时间连续变），并把被滤元素的几何覆盖面积收到真正需要的那块矩形上。" + "本项是**成本提示**，不影响 ok / 退出码 / 铺轨；**未报 ≠ 这颗便宜**——真判据是真渲染出片计时");
   if (cost.staticFullBleed.length)
     push("c-filter-static-fullbleed", false, `整幅静态真卷积滤镜（${cost.staticFullBleed.slice(0, 3).join("；")}）——该声明自身即全幅` + "（`position:absolute|fixed` + `inset:0` 或等价铺满），于是每帧都要对整幅做一次卷积。" + "**首选改法：缩小被滤镜覆盖的几何面积**（把滤镜收到它真正需要的那块矩形上——面积一项同时压掉卷积与整幅逐帧合成两笔成本）；" + "次选把静态滤镜结果**预烘成图**，且 MUST 用 **RGBA PNG**（透明叠加颗粒的 alpha 是成片合成的必需通道，" + "烘成 JPEG 或任何无 alpha 格式会在成片里塌成不透明色块），但预烘只消得掉卷积、消不掉整幅逐帧合成，收益有上限、必有残差。" + "去不去滤镜属审美取值，判断权在作者：本项只给信息与改法，**恒非致命**、不拦铺轨；未报 ≠ 便宜，真判据是真渲染出片计时");
+  if (cost.staticTransformed.length)
+    push("c-filter-static-transformed", false, `静态真卷积滤镜的元素，其 transform 被补间驱动（${cost.staticTransformed.slice(0, 3).join("；")}）——` + "滤镜值本身不变，但被滤子树**每帧换一个几何**，卷积结果每帧失效、必须重算，" + "与 `c-filter-animated` 是**同一类缓存失效**，只是驱动源从滤镜值换成了 transform。" + "r69 真渲实测：同颗粒对照下这一档 **+42.7%**，比「补间驱动 blur」的 +36.2% **还贵**——它是本组里最容易被忽略的一档。" + "改法（按优先级）：① 把滤镜移到**不参与位移/缩放**的那一层（滤镜层与运动层拆开，运动交给外层容器）；" + "② 缩小被滤元素的几何覆盖面积；③ 把静态滤镜结果**预烘成 RGBA PNG** 再让它随 transform 走（预烘图平移是零卷积）。" + "⚠️ 射程只收 `transform`：`opacity` 被补间驱动**不在本项射程**（opacity 侧尚无对照实测，不凭推测扩）。" + "本项恒非致命、不拦铺轨；未报 ≠ 便宜，真判据是真渲染出片计时");
   if (cost.indeterminate.length)
     push("c-filter-indeterminate", false, `该处 filter 值无法静态判定是否含真卷积（${cost.indeterminate.slice(0, 3).join("；")}）——` + "补间值不是字符串字面量（变量 / 模板串 / 函数返回），本 lint 不做表达式求值与常量折叠，" + "故对该处**未作判定**：既不是「判过且通过」，也不是命中。请人工确认它是否会驱动 blur / drop-shadow；" + "若是，按 `c-filter-animated` 的改法处理。本项恒非致命、不拦铺轨");
   return { ok: !v.some((x) => x.fatal), violations: v, opaque, compositionId: cid };
@@ -12781,7 +13132,7 @@ async function runLay(opts) {
   if (opts.replaceAll && orphans.length > 0) {
     log.warn(`--replace-all：已显式授权重置整轨，轨上其余 ${orphans.length} 颗已铺颗粒将被剥离（不走增量保留）。`);
   }
-  await mkdir9(join23(gtrkDir, ...MG_ASSET_DIR.split("/")), { recursive: true });
+  await mkdir10(join23(gtrkDir, ...MG_ASSET_DIR.split("/")), { recursive: true });
   for (const it of items) {
     await copyFile(srcByComp.get(it.composition_id), join23(gtrkDir, ...it.html_rel.split("/")));
   }
@@ -12898,12 +13249,12 @@ function done(opts, result) {
 }
 
 // src/lib/mad/mad.ts
-import { mkdir as mkdir12, writeFile as writeFile11 } from "node:fs/promises";
+import { mkdir as mkdir13, writeFile as writeFile11 } from "node:fs/promises";
 import { existsSync as existsSync24, statSync as statSync3 } from "node:fs";
 import { resolve as resolve13, join as join27 } from "node:path";
 
 // src/lib/convert/types.ts
-function num(v, d = 0) {
+function num2(v, d = 0) {
   return typeof v === "number" && isFinite(v) ? v : d;
 }
 function parseCubicBezier(e) {
@@ -12952,19 +13303,19 @@ function mergeChannelTracks(ta, tb, defA, defB) {
     if (!track || track.length === 0)
       return dflt;
     if (t <= track[0].t)
-      return num(track[0].v, dflt);
+      return num2(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);
+          return num2(q.v, dflt);
         const k = (t - p.t) / span;
-        return num(p.v, dflt) + (num(q.v, dflt) - num(p.v, dflt)) * k;
+        return num2(p.v, dflt) + (num2(q.v, dflt) - num2(p.v, dflt)) * k;
       }
     }
-    return num(track[track.length - 1].v, dflt);
+    return num2(track[track.length - 1].v, dflt);
   };
   const times = new Set;
   for (const k of ta ?? [])
@@ -12985,17 +13336,17 @@ function sampleTrack(track, t, def) {
   if (!track || track.length === 0)
     return def;
   if (t <= track[0].t)
-    return num(track[0].v, def);
+    return num2(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 num2(a.v, def) + (num2(b.v, def) - num2(a.v, def)) * k;
     }
   }
-  return num(track[track.length - 1].v, def);
+  return num2(track[track.length - 1].v, def);
 }
 function phasePair(i) {
   return [Math.sin(i * 2.399), Math.cos(i * 3.11)];
@@ -13023,13 +13374,13 @@ 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));
+  const t0 = num2(fx.t0, num2(ly.in, 0));
+  const t1 = num2(fx.t1, num2(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 pos = [num2(ly.pos?.[0], 0), num2(ly.pos?.[1], 0)];
   const tracks = [];
   const warnings = [];
   for (const fx of ly.fx ?? []) {
@@ -13045,8 +13396,8 @@ function bakeLayerOps(ly) {
       const times = [];
       const values = [];
       for (const k of tr) {
-        const t = num(k.t, 0);
-        const v = num(k.v, 1);
+        const t = num2(k.t, 0);
+        const v = num2(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)]);
@@ -13059,9 +13410,9 @@ function bakeLayerOps(ly) {
     if (op === "flicker") {
       if (t1 - t0 < 0.05)
         continue;
-      let freq = num(fx.freq, 8);
+      let freq = num2(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 mag = clamp(num2(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);
@@ -13080,8 +13431,8 @@ function bakeLayerOps(ly) {
     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 amp0 = num2(fx.mag ?? fx.amp, 18);
+      const freq = clamp(num2(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 = [];
@@ -13111,9 +13462,9 @@ function bakeLayerOps(ly) {
     }
     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 a1 = num2(fx.a1, -3);
+        const a2 = num2(fx.a2, 3);
+        const freq = clamp(num2(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)]];
@@ -13130,9 +13481,9 @@ function bakeLayerOps(ly) {
         }
         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 mag0 = num2(fx.mag, 40);
+        const ang = num2(fx.angle, 90) * Math.PI / 180;
+        const freq = clamp(num2(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)];
@@ -13164,13 +13515,13 @@ function bakeLayerOps(ly) {
       let lo;
       let hi;
       if (fx.amp != null) {
-        lo = 1 - num(fx.amp, 0);
-        hi = 1 + num(fx.amp, 0);
+        lo = 1 - num2(fx.amp, 0);
+        hi = 1 + num2(fx.amp, 0);
       } else {
-        lo = num(fx.min, 1);
-        hi = num(fx.max, 1.06);
+        lo = num2(fx.min, 1);
+        hi = num2(fx.max, 1.06);
       }
-      const freq = clamp(num(fx.freq, 2), 0.2, 20);
+      const freq = clamp(num2(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)];
@@ -13332,7 +13683,7 @@ function positionBaseKeys(anim, pos) {
 function scaleBaseKeys(anim, coverExpr) {
   const sc = (v) => coverExpr ? `${r37(v)}*${coverExpr}` : `${r37(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 }));
+    return anim.scale.map((k) => ({ t: k.t, value: `[${sc(num2(k.v, 1) * 100)}, ${sc(num2(k.v, 1) * 100)}]`, e: k.e }));
   }
   if (anim.sx?.length || anim.sy?.length) {
     const merged = mergeChannelTracks(anim.sx, anim.sy, 1, 1);
@@ -13347,9 +13698,9 @@ function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
   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 pos = [num2(ly.pos?.[0], 0), num2(ly.pos?.[1], 0)];
+  const inn = num2(ly.in, 0);
+  const out = Math.max(inn + 0.01, num2(ly.out, inn + 1));
   const sc = (v) => coverExpr ? `${r37(v)}*${coverExpr}` : `${r37(v)}`;
   const brights = tracks.filter((t) => t.prop === "brightness");
   if (brights.length) {
@@ -13396,7 +13747,7 @@ function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
   }
   const rotBaked = tracks.filter((t) => t.prop === "rotation");
   if (rotBaked.length) {
-    const baseKeys = (anim.rot ?? []).map((k) => ({ t: k.t, value: `${r37(num(k.v, 0))}`, e: k.e }));
+    const baseKeys = (anim.rot ?? []).map((k) => ({ t: k.t, value: `${r37(num2(k.v, 0))}`, e: k.e }));
     const bakedKeys = [];
     const windows = [];
     for (const bt of rotBaked) {
@@ -13414,10 +13765,10 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
   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 inn = num2(ly.in, 0);
+  const out = Math.max(inn + 0.01, num2(ly.out, c3.duration));
+  const px = num2(ly.pos?.[0], c3.w / 2);
+  const py = num2(ly.pos?.[1], c3.h / 2);
   const name = esc(`${ly.id || "L" + id} [${ly.type}]`);
   L.push(``);
   L.push(`  // ---- 层 ${name} in=${r37(inn)} out=${r37(out)} ----`);
@@ -13439,9 +13790,9 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
   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 slotW = Math.max(2, Math.round(num2(ly.w, c3.w)));
+    const slotH = Math.max(2, Math.round(num2(ly.h, c3.h)));
+    const srcOffset = num2(footageHit.srcOffset, 0);
     const cvv = `cv${id}`;
     coverExpr = cvv;
     L.push(`  // 素材注入(${esc(String(ly.type))}): footage srcOffset=${r37(srcOffset)}`);
@@ -13472,14 +13823,14 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
     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)));
+    const w = Math.max(2, Math.round(num2(ly.w, 400)));
+    const h = Math.max(2, Math.round(num2(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, ${r37(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)));
+    const w = Math.max(2, Math.round(num2(ly.w, c3.w)));
+    const h = Math.max(2, Math.round(num2(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, ${r37(c3.duration)});`);
   }
@@ -13509,10 +13860,10 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
     }
   }
   if (anim.rot?.length && !bakedProps.has("rotation")) {
-    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, anim.rot.map((k) => ({ t: k.t, value: `${r37(num(k.v, 0))}`, e: k.e })));
+    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, anim.rot.map((k) => ({ t: k.t, value: `${r37(num2(k.v, 0))}`, e: k.e })));
   }
   if (anim.opacity?.length) {
-    emitKeys(ctx, `${tf}.property("ADBE Opacity")`, anim.opacity.map((k) => ({ t: k.t, value: `${r37(Math.min(1, Math.max(0, num(k.v, 1))) * 100)}`, e: k.e })));
+    emitKeys(ctx, `${tf}.property("ADBE Opacity")`, anim.opacity.map((k) => ({ t: k.t, value: `${r37(Math.min(1, Math.max(0, num2(k.v, 1))) * 100)}`, e: k.e })));
   }
   if (anim.ls?.length) {
     L.push(`  // TODO: letterspacing 轨未自动映射（AE 需 Animator>Tracking），共 ${anim.ls.length} 帧`);
@@ -13526,8 +13877,8 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
 }
 function emitGroupAnim(ctx, v, ly) {
   const anim = ly.anim ?? {};
-  const px = num(ly.pos?.[0], 0);
-  const py = num(ly.pos?.[1], 0);
+  const px = num2(ly.pos?.[0], 0);
+  const py = num2(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: `[${r37(k.a - px)}, ${r37(k.b - py)}]`, e: k.e })));
@@ -13611,10 +13962,10 @@ function madJsx(opts) {
   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 sw = Math.max(4, Math.round(num2(c3.w, 1920)));
+    const sh = Math.max(4, Math.round(num2(c3.h, 1080)));
+    const sfps = Math.min(99, Math.max(1, num2(c3.fps, 30)));
+    const sdur = Math.max(0.1, num2(c3.duration, 3));
     const subName = esc(`${win.uid}-${win.seq}`);
     const subVar = `sub${wi}`;
     L.push(``);
@@ -13870,7 +14221,7 @@ function beatQuantized(natLens, analysis) {
 
 // src/lib/mad/data.ts
 import { createHash as createHash2 } from "node:crypto";
-import { mkdir as mkdir10, readFile as readFile8, rename as rename2, rm, writeFile as writeFile10, readdir } from "node:fs/promises";
+import { mkdir as mkdir11, readFile as readFile8, rename as rename2, rm, writeFile as writeFile10, readdir as readdir2 } from "node:fs/promises";
 import { existsSync as existsSync22 } from "node:fs";
 import { join as join25 } from "node:path";
 function madCacheDir() {
@@ -13925,7 +14276,7 @@ function validateManifest(obj) {
 }
 async function cleanupOldVersions(cacheRoot, keepVersion, warn) {
   try {
-    const entries = await readdir(cacheRoot);
+    const entries = await readdir2(cacheRoot);
     for (const e of entries) {
       const m = /^v(\d+)$/.exec(e);
       if (m && Number(m[1]) !== keepVersion) {
@@ -13980,7 +14331,7 @@ async function ensureMadData(opts, deps) {
       }
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
     }
-    await mkdir10(verDir, { recursive: true });
+    await mkdir11(verDir, { recursive: true });
     warn(`下载技法池数据 mad_pool（版本 v${version}，约 ${Math.round(poolMeta.size / 1024)} KB）…`);
     const res = await deps.fetchFn(poolMeta.url);
     if (!res.ok)
@@ -13993,7 +14344,7 @@ async function ensureMadData(opts, deps) {
     warn(`技法池数据就绪（v${version}）`);
   }
   if (online) {
-    await mkdir10(cacheRoot, { recursive: true });
+    await mkdir11(cacheRoot, { recursive: true });
     await atomicWrite(snapshotPath, new Uint8Array(Buffer.from(JSON.stringify(manifest), "utf8")));
     await cleanupOldVersions(cacheRoot, version, warn);
   }
@@ -14010,7 +14361,7 @@ async function ensureMadData(opts, deps) {
 
 // src/lib/mad/pool.ts
 import { gunzipSync } from "node:zlib";
-import { mkdir as mkdir11, readFile as readFile9 } from "node:fs/promises";
+import { mkdir as mkdir12, readFile as readFile9 } from "node:fs/promises";
 import { existsSync as existsSync23 } from "node:fs";
 import { join as join26 } from "node:path";
 function shardPath(verDir, shard) {
@@ -14049,7 +14400,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
       throw new Error(`IR 分片下载失败 HTTP ${res.status}：${url}`);
     const buf = new Uint8Array(await res.arrayBuffer());
     const s = decodeShard(buf);
-    await mkdir11(join26(verDir, "ir"), { recursive: true });
+    await mkdir12(join26(verDir, "ir"), { recursive: true });
     await atomicWrite(path, buf);
     memo.set(shard, s);
     return s;
@@ -14262,7 +14613,7 @@ async function runMad(inputArg, opts, deps = {}) {
   const bgm = level <= 2 && bgmForTrack ? { path: bgmForTrack, markers } : undefined;
   const { jsx } = madJsx({ master, windows, header, bgm });
   const outDir = opts.out ? resolve13(opts.out) : join27(process.cwd(), `mad-${timestamp4(now)}`);
-  await mkdir12(outDir, { recursive: true });
+  await mkdir13(outDir, { recursive: true });
   const jsxPath = join27(outDir, "mad.jsx");
   await writeFile11(jsxPath, jsx);
   const result = {
@@ -14409,7 +14760,7 @@ async function runMadInTool(inputArg, opts) {
 
 // src/commands/transcript.ts
 import { existsSync as existsSync25 } from "node:fs";
-import { mkdir as mkdir13, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile12 } from "node:fs/promises";
+import { mkdir as mkdir14, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile12 } from "node:fs/promises";
 import { basename as basename14, dirname as dirname11, extname as extname8, join as join28, resolve as resolve14 } from "node:path";
 
 // src/lib/transcript.ts
@@ -14566,7 +14917,7 @@ function resolveTranscriptOutput(inputAbs, out) {
   return output;
 }
 async function writeMarkdownAtomic(path, markdown) {
-  await mkdir13(dirname11(path), { recursive: true });
+  await mkdir14(dirname11(path), { recursive: true });
   const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
   try {
     await writeFile12(temp, markdown, "utf8");
@@ -14644,7 +14995,7 @@ function registerTranscript(program2) {
 
 // src/commands/music-visualizer.ts
 import { resolve as resolve15, join as join29, dirname as dirname12, basename as basename15, extname as extname9 } from "node:path";
-import { mkdir as mkdir14, writeFile as writeFile13 } from "node:fs/promises";
+import { mkdir as mkdir15, writeFile as writeFile13 } from "node:fs/promises";
 import { existsSync as existsSync26 } from "node:fs";
 var TASK_TYPE5 = "music_visualizer";
 var PRICE_KEY2 = "music_visualizer";
@@ -14809,7 +15160,7 @@ async function runMusicVisualizer(audio, opts) {
   });
   const { taskId } = submitted;
   log.info(`task_id = ${taskId}`);
-  await mkdir14(outDir, { recursive: true });
+  await mkdir15(outDir, { recursive: true });
   await writeFile13(join29(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE5, fileId: submitted.fileId, source: audioAbs, template, createdAt: new Date().toISOString() }, null, 2));
   log.step("③ 云端处理中（每 5s 轮询）…");
   const result = await pollTask(cfg, TASK_TYPE5, taskId, (status, progress) => {