@gitruck/cli 0.2.22 → 0.2.23

package/dist/index.js

@@ -4197,7 +4197,7 @@ var {
 
 // src/index.ts
 import { readFileSync as readFileSync6 } from "node:fs";
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -6833,6 +6833,68 @@ function assertDurationConsistent(originalDuration, artifactAbs, ffmpegPath, tol
     throw new Error(`抽出物时长（${got.toFixed(2)}s）与原片（${originalDuration.toFixed(2)}s）不一致（容差 ${tolSec}s），` + `疑似抽取异常，已中止上传`);
   }
 }
+function assFontNames(assText) {
+  const names = new Set;
+  for (const line2 of assText.split(/\r?\n/)) {
+    if (!line2.startsWith("Style:"))
+      continue;
+    const font = line2.slice("Style:".length).split(",")[1]?.trim();
+    if (font)
+      names.add(font);
+  }
+  return [...names];
+}
+async function probeFontAvailable(font, ffmpegPath) {
+  const { ffmpeg } = requireFfmpeg(ffmpegPath);
+  try {
+    await runFfmpeg(ffmpeg, [
+      "-v",
+      "error",
+      "-f",
+      "lavfi",
+      "-i",
+      "color=c=black:s=64x64:d=0.04",
+      "-vf",
+      `drawtext=font='${font}':text=A`,
+      "-frames:v",
+      "1",
+      "-f",
+      "null",
+      "-"
+    ]);
+    return true;
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    if (/valid font|font.*not found|Fontconfig error/i.test(msg))
+      return false;
+    return null;
+  }
+}
+async function burnSubtitle(videoAbs, assAbs, outAbs, opts = {}) {
+  const { ffmpeg } = requireFfmpeg(opts.ffmpegPath);
+  const filterPath = assAbs.replace(/\\/g, "/").replace(/:/g, "\\:");
+  await runFfmpeg(ffmpeg, [
+    "-y",
+    "-v",
+    "error",
+    "-i",
+    videoAbs,
+    "-vf",
+    `ass='${filterPath}'`,
+    "-c:v",
+    opts.codec ?? "libx264",
+    "-crf",
+    String(opts.crf ?? 18),
+    "-preset",
+    "medium",
+    "-c:a",
+    "copy",
+    "-movflags",
+    "+faststart",
+    outAbs
+  ]);
+  return outAbs;
+}
 
 // src/lib/materialize.ts
 import { join as join14, basename as basename5 } from "node:path";
@@ -7314,8 +7376,8 @@ 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 mkdir7, writeFile as writeFile7 } from "node:fs/promises";
+import { resolve as resolve6, join as join18, dirname as dirname6, basename as basename8, extname as extname5 } from "node:path";
+import { mkdir as mkdir7, writeFile as writeFile8 } from "node:fs/promises";
 import { existsSync as existsSync16 } from "node:fs";
 
 // src/lib/clip-brief.ts
@@ -7445,10 +7507,110 @@ function renderClipsOverview(clips, ctx) {
 `)}
 `;
 }
+var POLISH_LABEL = {
+  split_screen: "智能分屏",
+  camera: "克制运镜",
+  speed: "整体调速",
+  seam: "接缝过渡",
+  subtitle: "智能字幕",
+  subtitle_remap: "字幕时轴重映射",
+  purify_source: "去除原字幕",
+  unknown: "未具名润色项"
+};
+function renderProReport(clips, report, ctx) {
+  const name = ctx.source.split(/[\/]/).pop() || ctx.source;
+  const out = [`# ${name} · 长剪短精剪报告`, ""];
+  out.push(`- 源片：\`${ctx.source}\``);
+  out.push(`- 成片：${clips.length} 条`);
+  const jc = report?.jump_cut;
+  if (typeof jc === "boolean")
+    out.push(`- 跳剪：${jc ? "开" : "关"}`);
+  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("");
+  const degraded = report?.degraded_items;
+  const degRows = [];
+  if (degraded && typeof degraded === "object" && !Array.isArray(degraded)) {
+    for (const [k, v] of Object.entries(degraded)) {
+      const names = list(v).map((x) => POLISH_LABEL[x] ?? x);
+      if (names.length)
+        degRows.push(`- **${k}**：${names.join("、")}`);
+    }
+  }
+  if (degRows.length) {
+    out.push("## ⚠️ 润色降级", "");
+    out.push("以下片子照常出片，但列出的润色项**没有做成**——效果与预期不同，别当成完整成片直接发布。", "");
+    out.push(...degRows, "");
+  }
+  for (const [i, clip] of clips.entries()) {
+    const title = str(clip.title);
+    out.push("---", "", `## clip${i}${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])}`);
+    const f = ctx.clipFiles?.[i];
+    if (f)
+      bits.push(`成片 ${baseName(f)}`);
+    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("");
+    }
+  }
+  return `${out.join(`
+`).replace(/\n{3,}/g, `
+
+`).trimEnd()}
+`;
+}
 
 // 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 mkdir6, writeFile as writeFile6, stat as stat5 } from "node:fs/promises";
+import { resolve as resolve5, join as join17, dirname as dirname5, basename as basename7, extname as extname4 } from "node:path";
+import { mkdir as mkdir6, writeFile as writeFile7, 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";
@@ -7534,11 +7696,13 @@ async function resolveToolPricing(priceKey, pricingContext, fetchFn = fetch) {
 
 // src/lib/tool-descriptors.ts
 import { readFileSync as readFileSync4 } from "node:fs";
-import { extname as extname3, resolve as resolvePath } from "node:path";
+import { readFile as readFile5, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname4, extname as extname3, join as join16, resolve as resolvePath } from "node:path";
 var MULTI_INPUT_KINDS = new Set(["images", "videos"]);
 var IMAGE_EXTS = [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".tif", ".tiff", ".heic", ".heif", ".avif"];
 var VIDEO_EXTS = [".mp4", ".mov", ".mkv", ".webm", ".avi", ".m4v", ".flv", ".wmv", ".mpg", ".mpeg", ".ts", ".m2ts"];
 var AUDIO_EXTS = [".mp3", ".wav", ".m4a", ".aac", ".flac", ".ogg", ".opus", ".wma"];
+var isAudioFile = (p) => AUDIO_EXTS.includes(extname3(p).toLowerCase());
 var PUBLIC_VIDEO_EXTS = [
   ".mp4",
   ".avi",
@@ -8482,18 +8646,37 @@ var videoAiSubtitle = {
     { flag: "--subtitle-type <style>", desc: `字幕样式：${AI_SUBTITLE_TYPES.join("/")}（未传则用服务端默认）` },
     { flag: "--subtitle-color <color>", desc: `字幕颜色：${AI_SUBTITLE_COLORS.join("/")}（未传则用服务端默认）` }
   ],
+  async preprocess(ctx) {
+    const inputAbs = ctx.inputAbs;
+    if (ctx.opts.needPure === true) {
+      ctx.warn("--need-pure 需要画面（去原字幕是画面操作），本次整片上传；只要字幕文件时去掉该 flag 即可只传音频");
+      return inputAbs;
+    }
+    if (isAudioFile(inputAbs))
+      return inputAbs;
+    const audio = await extractAudio(inputAbs, ctx.ffmpegPath);
+    return audio;
+  },
   buildPayload(fileId, ctx) {
     const language = ctx.opts.language == null ? "" : String(ctx.opts.language).trim();
     if (!language)
       throw new Error("--language 必填：请指定源语种代码（具体取值见云端 API 文档 / 服务端支持列表）");
     const payload = { file_id: fileId, language };
+    const inputAbs = ctx.inputAbs;
+    if (inputAbs && !isAudioFile(inputAbs)) {
+      try {
+        const geo = probeGeometry(inputAbs, ctx.ffmpegPath);
+        if (geo.width > 0 && geo.height > 0)
+          payload.video_size = [geo.width, geo.height];
+      } catch {
+        ctx.warn("探原片几何失败，本次不回传 video_size（服务端将按 1920x1080 兜底出字幕）");
+      }
+    }
     if (ctx.opts.translateLanguage != null) {
       const t = String(ctx.opts.translateLanguage).trim();
       if (t)
         payload.translate_language = t;
     }
-    if (ctx.opts.needRender === true)
-      payload.need_render = true;
     if (ctx.opts.needPure === true)
       payload.need_pure = true;
     if (ctx.opts.subtitleType != null) {
@@ -8523,10 +8706,135 @@ var videoAiSubtitle = {
       files.push({ url: pure, filename: `${ctx.baseName}-pure${extFromUrl(pure, ".mp4")}` });
     return files;
   },
+  async postprocess(ctx, landed) {
+    if (ctx.opts.needRender !== true)
+      return;
+    const inputAbs = ctx.inputAbs;
+    if (isAudioFile(inputAbs)) {
+      throw new Error("--need-render 需要视频输入：本次输入是音频文件，无画面可烧");
+    }
+    const ass = landed.find((p) => p.toLowerCase().endsWith(".ass"));
+    if (!ass)
+      throw new Error("未拉回 .ass 字幕文件，无法本地烧录");
+    const fonts = assFontNames(await readFile5(ass, "utf8"));
+    const missing = [];
+    for (const f of fonts) {
+      if (await probeFontAvailable(f, ctx.ffmpegPath) === false)
+        missing.push(f);
+    }
+    if (missing.length) {
+      throw new Error(`本机缺字幕模板所需字体：${missing.join("、")}。` + `装上后重跑即可（字幕文件已落地，无需重新提交任务）。CLI 不自带字体、也不用替代字体顶——` + `替代字体烧出来的成片观感与模板设计不符且难以察觉。`);
+    }
+    const out = join16(dirname4(ass), `${ctx.baseName}-subtitled.mp4`);
+    await burnSubtitle(inputAbs, ass, out, { ffmpegPath: ctx.ffmpegPath });
+    return [out];
+  },
   mapResult(out) {
     return { summary: typeof out.summary === "string" ? out.summary : "", asr: out.asr ?? null };
   }
 };
+var PRO_DURATION_PREFS = ["auto", "short", "medium", "long"];
+var videoLong2ShortPro = {
+  name: "video_long2short_pro",
+  title: "长剪短·精剪（直接出片）",
+  description: "长内容按语义抽多条高光短片并一键出成品：选段+跳剪+分屏内核，叠加模糊底画布适配/克制运镜/调速保音高/智能字幕。只出成片，不产工程文件——要可编辑工程请用 gtrk long2short（粗剪）。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_long2short_pro",
+  outputHint: "逐条高光成片 mp4 + 切片报告 clips.md",
+  enabled: true,
+  taskType: "video_long2short_pro",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    { flag: "--language <code>", desc: "源语种代码（精剪必填；取值以服务端支持列表为准）" },
+    { flag: "--output-language <code>", desc: "选段/文案的输出语种（未传则同源语种）" },
+    { flag: "--main-topic <text>", desc: "主题引导（影响选段偏好）" },
+    { flag: "--output-size <s>", desc: "成片画幅 9:16|16:9|1:1 或自定义 WxH（未传则服务端默认）" },
+    { flag: "--no-jump-cut", desc: "关闭跳剪（默认开：片内去水词/冗余，只删不重排）" },
+    { flag: "--duration-pref <p>", desc: `成片时长偏好 ${PRO_DURATION_PREFS.join("/")}（成片条数由内容语义决定、不可指定）` },
+    { flag: "--max-clip-sec <n>", desc: "单条成片时长安全上限（秒；未传则服务端默认）" },
+    { flag: "--split-screen", desc: "开启智能分屏（多人同框段合成分屏画面）" },
+    { flag: "--split-orientation <o>", desc: "分屏方向 auto|lr|tb（未传则服务端默认）" },
+    { flag: "--speed-factor <n>", desc: "整体调速倍率（保音高；未传则服务端默认）" },
+    { flag: "--no-camera-move", desc: "关闭克制运镜（默认开：亚像素推/拉）" },
+    { flag: "--no-subtitle", desc: "关闭智能字幕（默认开：成片内烧录字幕）" },
+    { flag: "--subtitle-translate-language <code>", desc: "字幕译文语种（未传则单语字幕）" }
+  ],
+  buildPayload(fileId, ctx) {
+    const o = ctx.opts;
+    const language = o.language == null ? "" : String(o.language).trim();
+    if (!language)
+      throw new Error("--language 必填：请指定源语种代码（具体取值见云端 API 文档 / 服务端支持列表）");
+    const p = { file_id: fileId, language };
+    if (o.outputLanguage != null && String(o.outputLanguage).trim())
+      p.output_language = String(o.outputLanguage).trim();
+    if (o.mainTopic != null && String(o.mainTopic).trim())
+      p.main_topic = String(o.mainTopic).trim();
+    if (o.outputSize != null && String(o.outputSize).trim())
+      p.output_size = String(o.outputSize).trim();
+    if (o.jumpCut === false)
+      p.jump_cut = false;
+    const duration = {};
+    if (o.durationPref != null && String(o.durationPref).trim())
+      duration.pref = String(o.durationPref).trim();
+    const mcs = parseCountFlag(o.maxClipSec, "--max-clip-sec");
+    if (mcs != null)
+      duration.max_clip_sec = mcs;
+    if (Object.keys(duration).length)
+      p.duration = duration;
+    if (o.splitScreen === true) {
+      const ss = { enable: true };
+      if (o.splitOrientation != null && String(o.splitOrientation).trim())
+        ss.orientation = String(o.splitOrientation).trim();
+      p.split_screen = ss;
+    }
+    if (o.speedFactor != null) {
+      const n = Number(o.speedFactor);
+      if (!Number.isFinite(n))
+        throw new Error(`--speed-factor 需要有限数值，拿到「${o.speedFactor}」`);
+      p.speed = { factor: n };
+    }
+    if (o.cameraMove === false)
+      p.camera_move = { enable: false };
+    const sub = {};
+    if (o.subtitle === false)
+      sub.enable = false;
+    if (o.subtitleTranslateLanguage != null && String(o.subtitleTranslateLanguage).trim()) {
+      sub.translate_language = String(o.subtitleTranslateLanguage).trim();
+    }
+    if (Object.keys(sub).length)
+      p.subtitle = sub;
+    return p;
+  },
+  mapOutputs(out, _ctx) {
+    const clips = Array.isArray(out.clips) ? out.clips : [];
+    const files = [];
+    for (const [i, clip] of clips.entries()) {
+      const f = clip?.file;
+      const url = typeof f?.download_url === "string" ? f.download_url : undefined;
+      if (!url)
+        continue;
+      files.push({ url, filename: `clip${i}${extFromUrl(url, ".mp4")}` });
+    }
+    return files;
+  },
+  mapResult(out) {
+    return { clips: out.clips ?? [], report: out.report ?? {} };
+  },
+  async postprocess(ctx, landed, out) {
+    const clips = Array.isArray(out.clips) ? out.clips : [];
+    if (!clips.length)
+      return;
+    const mp4s = landed.filter((p) => p.toLowerCase().endsWith(".mp4"));
+    const byIndex = clips.map((_c, i) => mp4s.find((p) => new RegExp(`clip${i}.[a-z0-9]+$`, "i").test(p)));
+    const dest = join16(dirname4(landed[0] ?? "."), "clips.md");
+    await writeFile6(dest, renderProReport(clips, out.report ?? {}, {
+      source: ctx.inputAbs ?? ctx.baseName,
+      clipFiles: byIndex
+    }), "utf8");
+    return [dest];
+  }
+};
 function parseCountFlag(v, flag) {
   if (v == null)
     return;
@@ -8818,6 +9126,7 @@ var TOOL_REGISTRY = [
   imageClassicTemplate,
   imageVerticalStitch,
   videoSplitScreen,
+  videoLong2ShortPro,
   audioTtsClone,
   mad
 ];
@@ -9040,9 +9349,9 @@ function resolveOutDir(descriptor, inputAbs, out) {
     return resolve5(out);
   if (inputAbs) {
     const base = basename7(inputAbs, extname4(inputAbs));
-    return join16(dirname4(inputAbs), `${base}-${descriptor.name}`);
+    return join17(dirname5(inputAbs), `${base}-${descriptor.name}`);
   }
-  return join16(process.cwd(), `${descriptor.name}-${timestamp2()}`);
+  return join17(process.cwd(), `${descriptor.name}-${timestamp2()}`);
 }
 async function safeFingerprint(inputAbs) {
   try {
@@ -9131,7 +9440,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   }
   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({
+  await writeFile7(join17(outDir, "task.json"), JSON.stringify({
     tool: descriptor.name,
     taskType,
     taskId,
@@ -9153,7 +9462,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   const errors = {};
   const items = descriptor.mapOutputs ? descriptor.mapOutputs(outputResult, ctx) : [];
   for (const it of items) {
-    const dest = join16(outDir, it.filename);
+    const dest = join17(outDir, it.filename);
     try {
       await deps.downloadStream(it.url, dest);
       files.push(dest);
@@ -9161,11 +9470,20 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
       errors[it.filename] = e instanceof Error ? e.message : String(e);
     }
   }
+  if (descriptor.postprocess) {
+    try {
+      const extra = await descriptor.postprocess(ctx, [...files], outputResult);
+      if (Array.isArray(extra))
+        files.push(...extra);
+    } catch (e) {
+      errors[`${descriptor.name}:postprocess`] = e instanceof Error ? e.message : String(e);
+    }
+  }
   let resultFile;
   const structured = descriptor.mapResult ? descriptor.mapResult(outputResult, ctx) : undefined;
   if (structured != null) {
-    resultFile = join16(outDir, "result-output.json");
-    await writeFile6(resultFile, JSON.stringify(structured, null, 2));
+    resultFile = join17(outDir, "result-output.json");
+    await writeFile7(resultFile, JSON.stringify(structured, null, 2));
   }
   if (items.length === 0 && resultFile == null) {
     errors["output"] = "任务完成但未解析到任何产物（下载链接与结构化结果均为空，output_result 形态异常）";
@@ -9183,7 +9501,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     ...resultFile ? { resultFile } : {},
     ...Object.keys(errors).length ? { errors } : {}
   };
-  await writeFile6(join16(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
+  await writeFile7(join17(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
   return result;
 }
 
@@ -9240,7 +9558,7 @@ async function copyClipDraftsToRoot(clipDirs, draftTarget, errors) {
   let complete = 0;
   let attempted = 0;
   for (const [i, dir] of clipDirs.entries()) {
-    const src = join17(dir, "jianying");
+    const src = join18(dir, "jianying");
     if (!existsSync16(src)) {
       paths.push(null);
       continue;
@@ -9280,7 +9598,7 @@ async function runLong2Short(input, opts) {
   if (!formats.includes("gtrk"))
     formats.push("gtrk");
   const wantJianying = formats.some((f) => f === "jianying" || f === "capcut");
-  const outDir = resolve6(opts.out ?? join17(dirname5(inputAbs), `${projName}-long2short`));
+  const outDir = resolve6(opts.out ?? join18(dirname6(inputAbs), `${projName}-long2short`));
   const outName = basename8(outDir);
   let draftRoot;
   if (wantJianying) {
@@ -9290,7 +9608,7 @@ async function runLong2Short(input, opts) {
     else
       log.warn("没找到剪映草稿目录 → 将只产 draft_content.json、缺 meta。可加 --jianying-draft-dir <你的草稿目录> 重跑。");
   }
-  const draftTarget = draftRoot ? join17(draftRoot, outName) : undefined;
+  const draftTarget = draftRoot ? join18(draftRoot, outName) : undefined;
   log.step(`▶ 长剪短：${basename8(inputAbs)}（${opts.splitScreen ? "720p 代理 · 智能分屏" : "纯选段 · 音频上传"}，格式 ${formats.join("/")}）`);
   log.step("① 本地预处理（探几何 + 抽音频/720p 代理）…");
   const geo = probeGeometry(inputAbs, opts.ffmpegPath);
@@ -9311,7 +9629,7 @@ async function runLong2Short(input, opts) {
   const { taskId, fileId } = { taskId: submitted.taskId, fileId: submitted.fileId };
   log.info(`task_id = ${taskId}`);
   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));
+  await writeFile8(join18(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, {
     timeoutMs: POLL_TIMEOUT_MS,
@@ -9334,9 +9652,9 @@ async function runLong2Short(input, opts) {
         continue;
       }
       if (!/^(?:[A-Za-z]:[\\/]|[\\/])/.test(dest))
-        dest = join17(dirname5(inputAbs), dest);
+        dest = join18(dirname6(inputAbs), dest);
       try {
-        await mkdir7(dirname5(dest), { recursive: true });
+        await mkdir7(dirname6(dest), { recursive: true });
         await download(url, dest);
         splitLanded++;
       } catch (e) {
@@ -9350,7 +9668,7 @@ async function runLong2Short(input, opts) {
   log.step(`⑥ 逐 clip 拉回三方工程（共 ${clips.length} 条）…`);
   const clipResults = [];
   for (const [i, clip] of clips.entries()) {
-    const clipDir = join17(outDir, `clip${i}`);
+    const clipDir = join18(outDir, `clip${i}`);
     const { files: clipFiles, ...clipMeta } = clip;
     try {
       const r = await materializeResult({
@@ -9391,13 +9709,13 @@ async function runLong2Short(input, opts) {
   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));
+      await writeFile8(join18(cr.dir, "clip.md"), renderClipBrief(clips[i], i, cr.files));
     } catch (e) {
       errors[`clip${i}:brief`] = e instanceof Error ? e.message : String(e);
     }
   }
   try {
-    await writeFile7(join17(outDir, "clips.md"), renderClipsOverview(clips, {
+    await writeFile8(join18(outDir, "clips.md"), renderClipsOverview(clips, {
       source: inputAbs,
       jumpCut: opts.jumpCut !== false,
       splitMaterials: { landed: splitLanded, total: manifest.length },
@@ -9407,7 +9725,7 @@ async function runLong2Short(input, opts) {
   } catch (e) {
     errors["clips.md"] = e instanceof Error ? e.message : String(e);
   }
-  await writeFile7(join17(outDir, "report.json"), JSON.stringify(output.report ?? {}, null, 2));
+  await writeFile8(join18(outDir, "report.json"), JSON.stringify(output.report ?? {}, null, 2));
   const ok = Object.keys(errors).length === 0 && clipResults.some((c3) => c3.ok);
   const rootResult = {
     ok,
@@ -9418,10 +9736,10 @@ async function runLong2Short(input, opts) {
     outDir,
     clips: clipResults,
     splitMaterials: { landed: splitLanded, total: manifest.length },
-    reportFile: join17(outDir, "report.json"),
+    reportFile: join18(outDir, "report.json"),
     ...Object.keys(errors).length ? { errors } : {}
   };
-  await writeFile7(join17(outDir, "result.json"), JSON.stringify({ ...rootResult, finishedAt: new Date().toISOString() }, null, 2));
+  await writeFile8(join18(outDir, "result.json"), JSON.stringify({ ...rootResult, finishedAt: new Date().toISOString() }, null, 2));
   if (opts.json)
     console.log(JSON.stringify(rootResult));
   if (opts.open) {
@@ -9437,7 +9755,7 @@ async function runLong2Short(input, opts) {
 }
 
 // src/commands/oralcut-result.ts
-import { resolve as resolve7, join as join18 } from "node:path";
+import { resolve as resolve7, join as join19 } from "node:path";
 var TASK_TYPE3 = "cli/video_oral_cut_for_cli";
 function timestamp3() {
   const d = new Date;
@@ -9471,7 +9789,7 @@ async function runOralCutResult(taskId, opts) {
     const pct = got.progress != null ? ` ${Math.round(got.progress)}%` : "";
     throw new Error(`任务尚未完成（当前 ${got.status || "未知"}${pct}），暂无法取回结果；请稍后再试。`);
   }
-  const outDir = resolve7(opts.out ?? join18(process.cwd(), `${taskId}-video-project-${timestamp3()}`));
+  const outDir = resolve7(opts.out ?? join19(process.cwd(), `${taskId}-video-project-${timestamp3()}`));
   const draftDir = resolveJianyingDraftDir(opts.jianyingDraftDir);
   await materializeResult({
     outDir,
@@ -9531,7 +9849,7 @@ function registerUpgrade(program2) {
 }
 
 // src/commands/render.ts
-import { resolve as resolve8, dirname as dirname6, join as join19, basename as basename9, extname as extname6 } from "node:path";
+import { resolve as resolve8, dirname as dirname7, join as join20, basename as basename9, extname as extname6 } from "node:path";
 import { existsSync as existsSync17 } from "node:fs";
 function registerRender(program2) {
   program2.command("render <gtrk>").description("本地渲染：gtrk 工程按 EDL 用本地 ffmpeg 渲染成片 mp4（素材取原片本地路径）").option("-o, --out <file>", "输出 mp4 路径（缺省 = <gtrk 同目录>/<gtrk 名>.mp4）").option("--crf <n>", "视频质量 CRF 14-28（越小越清晰/文件越大，默认 18）").option("--codec <c>", "视频编码（默认 h264）").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录（缺省 ~/.gitruck/ffmpeg → 系统）").option("--no-open", "完成后不自动打开产物目录").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (gtrk, opts) => {
@@ -9540,7 +9858,7 @@ function registerRender(program2) {
     const gtrkAbs = resolve8(gtrk);
     if (!existsSync17(gtrkAbs))
       throw new Error(`gtrk 工程不存在：${gtrkAbs}`);
-    const outMp4 = resolve8(opts.out ?? join19(dirname6(gtrkAbs), `${basename9(gtrkAbs, extname6(gtrkAbs))}.mp4`));
+    const outMp4 = resolve8(opts.out ?? join20(dirname7(gtrkAbs), `${basename9(gtrkAbs, extname6(gtrkAbs))}.mp4`));
     log.step(`▶ 本地渲染：${basename9(gtrkAbs)} → ${basename9(outMp4)}`);
     const project = await readGtrkFile(gtrkAbs);
     const result = await renderGtrk(project, outMp4, {
@@ -9556,7 +9874,7 @@ function registerRender(program2) {
     log.tickEnd();
     log.ok(`渲染完成：${outMp4}（${result.duration.toFixed(1)}s）`);
     if (opts.open)
-      openFolder(dirname6(outMp4));
+      openFolder(dirname7(outMp4));
     if (opts.json) {
       console.log(JSON.stringify({ ok: true, output: outMp4, duration: result.duration }));
     }
@@ -9564,14 +9882,14 @@ function registerRender(program2) {
 }
 
 // src/commands/split.ts
-import { resolve as resolve9, join as join21, dirname as dirname8, basename as basename11 } from "node:path";
+import { resolve as resolve9, join as join22, dirname as dirname9, basename as basename11 } from "node:path";
 import { existsSync as existsSync18 } from "node:fs";
-import { readFile as readFile5, writeFile as writeFile8, mkdir as mkdir8 } from "node:fs/promises";
+import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir8 } from "node:fs/promises";
 import { createHash } from "node:crypto";
 
 // src/lib/gtrk-writeback.ts
 import { readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2, renameSync, unlinkSync } from "node:fs";
-import { dirname as dirname7, join as join20, basename as basename10 } from "node:path";
+import { dirname as dirname8, join as join21, basename as basename10 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function readGtrk(path) {
   const raw = readFileSync5(path, "utf8");
@@ -9598,7 +9916,7 @@ function writeStructMetaSplit(path, gtrk, splitObj, expectedMtimeMs) {
   }
   const nextStructMeta = { ...gtrk.struct_meta ?? {}, split: splitObj };
   const next = { ...gtrk, struct_meta: nextStructMeta };
-  const tmp = join20(dirname7(path), `.${basename10(path)}.${randomBytes2(6).toString("hex")}.tmp`);
+  const tmp = join21(dirname8(path), `.${basename10(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
     renameSync(tmp, path);
@@ -9614,7 +9932,7 @@ function writeGtrkAtomic(path, next, expectedMtimeMs) {
   if (cur !== expectedMtimeMs) {
     throw new Error("工程文件在 matrix 运行期间被外部修改（保存冲突），已拒绝写入；请关闭客户端未保存的工程或重跑（plan 与已下载代理均保留）");
   }
-  const tmp = join20(dirname7(path), `.${basename10(path)}.${randomBytes2(6).toString("hex")}.tmp`);
+  const tmp = join21(dirname8(path), `.${basename10(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
     renameSync(tmp, path);
@@ -9642,7 +9960,7 @@ function resolvePaths(opts) {
   if (opts.gtrk) {
     gtrkPath = resolve9(opts.gtrk);
   } else if (project) {
-    gtrkPath = firstExisting([join21(project, "gtrk", "project.gtrk"), join21(project, "project.gtrk")]) ?? join21(project, "gtrk", "project.gtrk");
+    gtrkPath = firstExisting([join22(project, "gtrk", "project.gtrk"), join22(project, "project.gtrk")]) ?? join22(project, "gtrk", "project.gtrk");
   } else {
     throw new Error("需 --project <目录> 或显式 --gtrk <path>");
   }
@@ -9653,11 +9971,11 @@ function resolvePaths(opts) {
     transcriptPath = resolve9(opts.transcript);
   else if (project)
     transcriptPath = firstExisting([
-      join21(project, "transcript", "transcript.json"),
-      join21(project, "json", "transcript.json"),
-      join21(project, "transcript.json")
+      join22(project, "transcript", "transcript.json"),
+      join22(project, "json", "transcript.json"),
+      join22(project, "transcript.json")
     ]);
-  const baseDir = project ?? dirname8(gtrkPath);
+  const baseDir = project ?? dirname9(gtrkPath);
   return { baseDir, gtrkPath, transcriptPath };
 }
 function slugify2(name) {
@@ -9665,7 +9983,7 @@ function slugify2(name) {
   return s || "project";
 }
 async function loadTranscript(path) {
-  const t = JSON.parse(await readFile5(path, "utf8"));
+  const t = JSON.parse(await readFile6(path, "utf8"));
   if (!t || !Array.isArray(t.utterances) || typeof t.material_id !== "string" || typeof t.text_hash !== "string") {
     throw new Error(`transcript.json 结构异常（缺 utterances/material_id/text_hash）：${path}`);
   }
@@ -9686,10 +10004,10 @@ async function runView(baseDir, gtrkPath, transcriptPath, opts) {
   const transcript = await loadTranscript(transcriptPath);
   const { gtrk } = readGtrk(gtrkPath);
   const view = projectTranscript(transcript, gtrk, { words: opts.words });
-  const splitDir = join21(baseDir, "split");
+  const splitDir = join22(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const viewPath = join21(splitDir, "view.json");
-  await writeFile8(viewPath, JSON.stringify(view, null, 2));
+  const viewPath = join22(splitDir, "view.json");
+  await writeFile9(viewPath, JSON.stringify(view, null, 2));
   const dropped = view.utterances.filter((u) => u.dropped).length;
   log.ok(`投影视图已生成：${viewPath}（${view.utterances.length} 条，其中 ${dropped} 条被剪）`);
   const result = {
@@ -9711,7 +10029,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
   if (!transcriptPath || !existsSync18(transcriptPath))
     throw new Error(TRANSCRIPT_MISSING);
   log.step("▶ 校验拆分稿并落地…");
-  const doc = JSON.parse(await readFile5(splitdocPath, "utf8"));
+  const doc = JSON.parse(await readFile6(splitdocPath, "utf8"));
   const transcript = await loadTranscript(transcriptPath);
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
   assertGtrkV1(gtrk);
@@ -9745,14 +10063,14 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
     }
   });
   writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
-  const splitDir = join21(baseDir, "split");
+  const splitDir = join22(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const dispatchPath = join21(splitDir, "dispatch.json");
-  await writeFile8(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
+  const dispatchPath = join22(splitDir, "dispatch.json");
+  await writeFile9(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
   let mdPath = null;
   if (opts.md) {
-    mdPath = join21(splitDir, "visual-split.md");
-    await writeFile8(mdPath, renderSplitMarkdown(doc, landing, { projectSlug, projectedAt }));
+    mdPath = join22(splitDir, "visual-split.md");
+    await writeFile9(mdPath, renderSplitMarkdown(doc, landing, { projectSlug, projectedAt }));
   }
   log.ok(`落地完成：${landing.split.beats.length}/${doc.beats.length} beat 落轨` + `（MG ${landing.dispatch.mg.length} · FILM_BROLL ${landing.dispatch.film_broll.length} · AI_DRAMA ${landing.dispatch.ai_drama.length}）`);
   for (const s of landing.skipped)
@@ -9783,9 +10101,9 @@ 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 { resolve as resolve11, join as join23, dirname as dirname10, basename as basename12 } from "node:path";
 import { existsSync as existsSync20 } from "node:fs";
-import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir9, rename } from "node:fs/promises";
+import { readFile as readFile7, writeFile as writeFile10, mkdir as mkdir9, rename } from "node:fs/promises";
 
 // src/lib/solid-png.ts
 import { deflateSync } from "node:zlib";
@@ -10925,16 +11243,16 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   let baseDir;
   if (opts.dispatch) {
     dispatchPath = resolve11(opts.dispatch);
-    baseDir = dirname9(dirname9(dispatchPath));
+    baseDir = dirname10(dirname10(dispatchPath));
   } else if (opts.project) {
     baseDir = resolve11(opts.project);
-    dispatchPath = join22(baseDir, "split", "dispatch.json");
+    dispatchPath = join23(baseDir, "split", "dispatch.json");
   } else {
     throw new Error('需 --project <目录> 或显式 --dispatch <path>（ad-hoc 检索用：gtrk matrix search "<query>"）');
   }
   if (!existsSync20(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split <拆分稿> 落地派单）`);
-  const dispatch = JSON.parse(await readFile6(dispatchPath, "utf8"));
+  const dispatch = JSON.parse(await readFile7(dispatchPath, "utf8"));
   const rawQueue = Array.isArray(dispatch.film_broll) ? dispatch.film_broll : [];
   const earlyGtrkPath = locateGtrk(baseDir);
   let earlyGtrk;
@@ -10997,10 +11315,10 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     columnId,
     beats
   });
-  const splitDir = join22(baseDir, "split");
+  const splitDir = join23(baseDir, "split");
   await mkdir9(splitDir, { recursive: true });
-  const planPath = join22(splitDir, "broll-plan.json");
-  await writeFile9(planPath, JSON.stringify(plan, null, 2));
+  const planPath = join23(splitDir, "broll-plan.json");
+  await writeFile10(planPath, JSON.stringify(plan, null, 2));
   log.ok(`候选清单已生成：${planPath}（${beats.length} beat · ${okCount}/${totalQueries} query 成功 · ${resultCount} 条候选）`);
   log.info("清单只含引用不含素材：cover_url 可直接预览；url 带签名默认 24h 过期，过期重跑本命令即重签。");
   const layN = parseLay(opts.lay);
@@ -11047,13 +11365,13 @@ function parseScoreFloor(raw) {
   return SCORE_FLOOR_DEFAULT;
 }
 function locateGtrk(baseDir) {
-  const cands = [join22(baseDir, "gtrk", "project.gtrk"), join22(baseDir, "project.gtrk")];
+  const cands = [join23(baseDir, "gtrk", "project.gtrk"), join23(baseDir, "project.gtrk")];
   return cands.find((p) => existsSync20(p));
 }
 async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRelay, reproj) {
   const gtrkPath = locateGtrk(baseDir);
   if (!gtrkPath) {
-    log.warn(`未找到工程文件（${join22(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
+    log.warn(`未找到工程文件（${join23(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
     return;
   }
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
@@ -11061,8 +11379,8 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
   const { fills, clipIds } = planBeatFills(plan, layN, scoreFloor);
   const slotCount = [...fills.values()].flat().reduce((n, s) => n + s.length, 0);
   log.step(`▶ 候选铺轨（${layN} 轨 · 平铺 ${slotCount} 槽位 · ${clipIds.size} 个 clip，preview 代理）…`);
-  const gtrkDir = dirname9(gtrkPath);
-  const previewDir = join22(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
+  const gtrkDir = dirname10(gtrkPath);
+  const previewDir = join23(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
   await mkdir9(previewDir, { recursive: true });
   const prevSource = new Map;
   const prevBroll = gtrk.struct_meta?.broll;
@@ -11085,7 +11403,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     if (!cand)
       continue;
     const rel = `${BROLL_PREVIEW_DIR}/${clipId}.mp4`;
-    const abs = join22(gtrkDir, ...rel.split("/"));
+    const abs = join23(gtrkDir, ...rel.split("/"));
     if (existsSync20(abs)) {
       const prev = prevSource.get(clipId);
       if (prev !== "raw") {
@@ -11148,12 +11466,12 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     const canvas = gtrk.video_size;
     const spec = { hex: BLACK_BED_HEX, width: canvas[0], height: canvas[1] };
     const rel = solidRelPath(spec);
-    const abs = join22(gtrkDir, ...rel.split("/"));
+    const abs = join23(gtrkDir, ...rel.split("/"));
     try {
       if (!existsSync20(abs)) {
-        await mkdir9(dirname9(abs), { recursive: true });
+        await mkdir9(dirname10(abs), { recursive: true });
         const tmp = `${abs}.tmp-${process.pid}`;
-        await writeFile9(tmp, encodeSolidPng(spec));
+        await writeFile10(tmp, encodeSolidPng(spec));
         await rename(tmp, abs);
       }
     } catch (e) {
@@ -11216,7 +11534,7 @@ async function downloadProxy(cand, absPath, opts = {}) {
   if (previewUrl) {
     const bytes = await tryFetch(previewUrl);
     if (bytes) {
-      await writeFile9(absPath, bytes);
+      await writeFile10(absPath, bytes);
       return "preview";
     }
   }
@@ -11224,7 +11542,7 @@ async function downloadProxy(cand, absPath, opts = {}) {
     return null;
   const raw = await tryFetch(cand.url);
   if (raw) {
-    await writeFile9(absPath, raw);
+    await writeFile10(absPath, raw);
     log.warn(`clip ${cand.clip_id} 无 preview 代理，已回落原片（${(raw.length / 1048576).toFixed(1)}MB）`);
     return "raw";
   }
@@ -11247,7 +11565,7 @@ async function runAdhoc(query, cfg, tier, broll, overrides, columnId, opts) {
   };
   if (opts.out) {
     const outPath = resolve11(opts.out);
-    await writeFile9(outPath, JSON.stringify({ query, recalled: data.recalled, results }, null, 2));
+    await writeFile10(outPath, JSON.stringify({ query, recalled: data.recalled, results }, null, 2));
     log.ok(`结果已落盘：${outPath}`);
     result.outPath = outPath;
   } else if (!opts.json) {
@@ -11266,9 +11584,9 @@ function slugify3(name) {
 }
 
 // src/commands/mg.ts
-import { resolve as resolve12, join as join23, dirname as dirname10, basename as basename13 } from "node:path";
+import { resolve as resolve12, join as join24, dirname as dirname11, basename as basename13 } from "node:path";
 import { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile7, mkdir as mkdir10, copyFile } from "node:fs/promises";
+import { readFile as readFile8, 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];
@@ -12929,20 +13247,20 @@ async function runMg(words, opts) {
 function resolveDispatch(opts) {
   if (opts.dispatch) {
     const dispatchPath = resolve12(opts.dispatch);
-    return { dispatchPath, baseDir: dirname10(dirname10(dispatchPath)) };
+    return { dispatchPath, baseDir: dirname11(dirname11(dispatchPath)) };
   }
   if (opts.project) {
     const baseDir = resolve12(opts.project);
-    return { dispatchPath: join23(baseDir, "split", "dispatch.json"), baseDir };
+    return { dispatchPath: join24(baseDir, "split", "dispatch.json"), baseDir };
   }
   throw new Error("需 --project <目录> 或显式 --dispatch <path>");
 }
 function locateGtrk2(baseDir) {
-  return [join23(baseDir, "gtrk", "project.gtrk"), join23(baseDir, "project.gtrk")].find((p) => existsSync21(p));
+  return [join24(baseDir, "gtrk", "project.gtrk"), join24(baseDir, "project.gtrk")].find((p) => existsSync21(p));
 }
 function locateSrcHtml(baseDir, compositionId) {
   for (const d of MG_SRC_DIRS) {
-    const p = join23(baseDir, d, `${compositionId}.html`);
+    const p = join24(baseDir, d, `${compositionId}.html`);
     if (existsSync21(p))
       return p;
   }
@@ -12951,7 +13269,7 @@ function locateSrcHtml(baseDir, compositionId) {
 async function readMgQueue(dispatchPath) {
   if (!existsSync21(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split 落地派单）`);
-  const dispatch = JSON.parse(await readFile7(dispatchPath, "utf8"));
+  const dispatch = JSON.parse(await readFile8(dispatchPath, "utf8"));
   const queue = dispatch.mg ?? dispatch.rrv_mg;
   return Array.isArray(queue) ? queue : [];
 }
@@ -13025,10 +13343,10 @@ async function runLay(opts) {
     const srcPath = locateSrcHtml(baseDir, q.composition_id);
     if (!srcPath) {
       skipped.push({ beat: q.beat, reason: "缺颗粒 HTML（未产出）" });
-      log.warn(`${q.beat}：缺 ${join23(baseDir, MG_SRC_DIRS[0], `${q.composition_id}.html`)}，跳过`);
+      log.warn(`${q.beat}：缺 ${join24(baseDir, MG_SRC_DIRS[0], `${q.composition_id}.html`)}，跳过`);
       continue;
     }
-    const html = await readFile7(srcPath, "utf8");
+    const html = await readFile8(srcPath, "utf8");
     const category = typeof q.category === "string" ? q.category : undefined;
     const slotDuration = Math.round((win.track_ed - win.track_st) * 1000) / 1000;
     const lint = lintParticle(html, {
@@ -13073,7 +13391,7 @@ async function runLay(opts) {
     });
   }
   if (!gtrkPath || !project) {
-    log.warn(`未找到工程文件（${join23(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
+    log.warn(`未找到工程文件（${join24(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
     return done(opts, {
       ok: skipped.length === 0,
       mode: "lay",
@@ -13090,7 +13408,7 @@ async function runLay(opts) {
     });
   }
   const { gtrk, mtimeMs } = project;
-  const gtrkDir = dirname10(gtrkPath);
+  const gtrkDir = dirname11(gtrkPath);
   const covered = new Set(items.map((it) => it.composition_id));
   const orphans = laidBefore.filter((id) => !covered.has(id));
   const inDispatch = new Set(allQueue.map((q) => q.composition_id));
@@ -13132,9 +13450,9 @@ async function runLay(opts) {
   if (opts.replaceAll && orphans.length > 0) {
     log.warn(`--replace-all：已显式授权重置整轨，轨上其余 ${orphans.length} 颗已铺颗粒将被剥离（不走增量保留）。`);
   }
-  await mkdir10(join23(gtrkDir, ...MG_ASSET_DIR.split("/")), { recursive: true });
+  await mkdir10(join24(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("/")));
+    await copyFile(srcByComp.get(it.composition_id), join24(gtrkDir, ...it.html_rel.split("/")));
   }
   const { next, summary, mg } = layMgTracks({ gtrk, items, generatedAt: new Date().toISOString(), keep });
   const written = withTimecodeSource(next, "mg", reproj);
@@ -13178,7 +13496,7 @@ async function runLint(args, opts) {
   const file = args[0];
   if (!file)
     throw new Error("用法：gtrk mg lint <particle.html> [--dispatch <path>]");
-  const html = await readFile7(resolve12(file), "utf8");
+  const html = await readFile8(resolve12(file), "utf8");
   const nameId = basename13(file).replace(/\.html?$/i, "");
   let dispatchIds;
   let slotDuration;
@@ -13249,9 +13567,9 @@ function done(opts, result) {
 }
 
 // src/lib/mad/mad.ts
-import { mkdir as mkdir13, writeFile as writeFile11 } from "node:fs/promises";
+import { mkdir as mkdir13, writeFile as writeFile12 } from "node:fs/promises";
 import { existsSync as existsSync24, statSync as statSync3 } from "node:fs";
-import { resolve as resolve13, join as join27 } from "node:path";
+import { resolve as resolve13, join as join28 } from "node:path";
 
 // src/lib/convert/types.ts
 function num2(v, d = 0) {
@@ -14031,7 +14349,7 @@ function madJsx(opts) {
 
 // src/lib/mad/scan.ts
 import { readdirSync, statSync as statSync2 } from "node:fs";
-import { extname as extname7, join as join24 } from "node:path";
+import { extname as extname7, join as join25 } from "node:path";
 var VIDEO_EXTS2 = new Set(defaultExtsFor("video") ?? []);
 function scanFolder(dirAbs, opts = {}) {
   const probe = opts.probe ?? probeGeometry;
@@ -14042,7 +14360,7 @@ function scanFolder(dirAbs, opts = {}) {
   } catch {
     throw new Error(`素材文件夹不存在或无法读取：${dirAbs}`);
   }
-  const files = entries.filter((n) => VIDEO_EXTS2.has(extname7(n).toLowerCase())).map((n) => join24(dirAbs, n)).filter((p) => {
+  const files = entries.filter((n) => VIDEO_EXTS2.has(extname7(n).toLowerCase())).map((n) => join25(dirAbs, n)).filter((p) => {
     try {
       return statSync2(p).isFile();
     } catch {
@@ -14221,9 +14539,9 @@ function beatQuantized(natLens, analysis) {
 
 // src/lib/mad/data.ts
 import { createHash as createHash2 } from "node:crypto";
-import { mkdir as mkdir11, readFile as readFile8, rename as rename2, rm, writeFile as writeFile10, readdir as readdir2 } from "node:fs/promises";
+import { mkdir as mkdir11, readFile as readFile9, rename as rename2, rm, writeFile as writeFile11, readdir as readdir2 } from "node:fs/promises";
 import { existsSync as existsSync22 } from "node:fs";
-import { join as join25 } from "node:path";
+import { join as join26 } from "node:path";
 function madCacheDir() {
   return homeFile("mad-cache");
 }
@@ -14248,14 +14566,14 @@ async function fetchWithTimeout(fetchFn, url, timeoutMs) {
 }
 async function atomicWrite(dest, data) {
   const tmp = `${dest}.tmp-${process.pid}-${Date.now()}`;
-  await writeFile10(tmp, data);
+  await writeFile11(tmp, data);
   await rename2(tmp, dest);
 }
 async function verifyFile(path, sha256) {
   if (!existsSync22(path))
     return false;
   try {
-    const buf = await readFile8(path);
+    const buf = await readFile9(path);
     return sha256Hex(buf) === sha256;
   } catch {
     return false;
@@ -14280,7 +14598,7 @@ async function cleanupOldVersions(cacheRoot, keepVersion, warn) {
     for (const e of entries) {
       const m = /^v(\d+)$/.exec(e);
       if (m && Number(m[1]) !== keepVersion) {
-        await rm(join25(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
+        await rm(join26(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
       }
     }
   } catch {}
@@ -14289,7 +14607,7 @@ async function ensureMadData(opts, deps) {
   const { cacheRoot, warn } = deps;
   const timeout = deps.manifestTimeoutMs ?? 8000;
   const mfUrl = deps.manifestUrl ?? manifestUrl();
-  const snapshotPath = join25(cacheRoot, "manifest.json");
+  const snapshotPath = join26(cacheRoot, "manifest.json");
   let manifest = null;
   let online = false;
   try {
@@ -14308,7 +14626,7 @@ async function ensureMadData(opts, deps) {
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
     }
     try {
-      manifest = validateManifest(JSON.parse(await readFile8(snapshotPath, "utf8")));
+      manifest = validateManifest(JSON.parse(await readFile9(snapshotPath, "utf8")));
     } catch {
       throw new Error("本地 manifest 缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
     }
@@ -14319,8 +14637,8 @@ async function ensureMadData(opts, deps) {
     }
   }
   const version = manifest.version;
-  const verDir = join25(cacheRoot, `v${version}`);
-  const poolPath = join25(verDir, "mad_pool.json");
+  const verDir = join26(cacheRoot, `v${version}`);
+  const poolPath = join26(verDir, "mad_pool.json");
   const poolMeta = manifest.datasets.mad_pool;
   const cacheValid = await verifyFile(poolPath, poolMeta.sha256);
   const needDownload = !!opts.refresh || !cacheValid;
@@ -14350,7 +14668,7 @@ async function ensureMadData(opts, deps) {
   }
   let pool;
   try {
-    pool = JSON.parse(await readFile8(poolPath, "utf8"));
+    pool = JSON.parse(await readFile9(poolPath, "utf8"));
     if (!Array.isArray(pool))
       throw new Error("mad_pool 非数组");
   } catch (e) {
@@ -14361,11 +14679,11 @@ async function ensureMadData(opts, deps) {
 
 // src/lib/mad/pool.ts
 import { gunzipSync } from "node:zlib";
-import { mkdir as mkdir12, readFile as readFile9 } from "node:fs/promises";
+import { mkdir as mkdir12, readFile as readFile10 } from "node:fs/promises";
 import { existsSync as existsSync23 } from "node:fs";
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 function shardPath(verDir, shard) {
-  return join26(verDir, "ir", `${shard}.json.gz`);
+  return join27(verDir, "ir", `${shard}.json.gz`);
 }
 function decodeShard(gz) {
   const json = gunzipSync(gz).toString("utf8");
@@ -14384,7 +14702,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
     const path = shardPath(verDir, shard);
     if (existsSync23(path)) {
       try {
-        const s2 = decodeShard(await readFile9(path));
+        const s2 = decodeShard(await readFile10(path));
         memo.set(shard, s2);
         return s2;
       } catch {
@@ -14400,7 +14718,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 mkdir12(join26(verDir, "ir"), { recursive: true });
+    await mkdir12(join27(verDir, "ir"), { recursive: true });
     await atomicWrite(path, buf);
     memo.set(shard, s);
     return s;
@@ -14612,10 +14930,10 @@ async function runMad(inputArg, opts, deps = {}) {
   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 ? resolve13(opts.out) : join27(process.cwd(), `mad-${timestamp4(now)}`);
+  const outDir = opts.out ? resolve13(opts.out) : join28(process.cwd(), `mad-${timestamp4(now)}`);
   await mkdir13(outDir, { recursive: true });
-  const jsxPath = join27(outDir, "mad.jsx");
-  await writeFile11(jsxPath, jsx);
+  const jsxPath = join28(outDir, "mad.jsx");
+  await writeFile12(jsxPath, jsx);
   const result = {
     ok: true,
     tool: "mad",
@@ -14626,7 +14944,7 @@ async function runMad(inputArg, opts, deps = {}) {
     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 writeFile11(join27(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
+  await writeFile12(join28(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
   warn(completionMessage(jsxPath, level));
   return result;
 }
@@ -14760,8 +15078,8 @@ async function runMadInTool(inputArg, opts) {
 
 // src/commands/transcript.ts
 import { existsSync as existsSync25 } from "node:fs";
-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";
+import { mkdir as mkdir14, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile13 } from "node:fs/promises";
+import { basename as basename14, dirname as dirname12, extname as extname8, join as join29, resolve as resolve14 } from "node:path";
 
 // src/lib/transcript.ts
 var AGENT_SUMMARY_PENDING = "<!-- gtrk:agent-summary-pending -->";
@@ -14911,16 +15229,16 @@ async function validateTranscriptInput(input) {
 }
 function resolveTranscriptOutput(inputAbs, out) {
   const base = basename14(inputAbs, extname8(inputAbs));
-  const output = out ? resolve14(out) : join28(dirname11(inputAbs), `${base}-transcript.md`);
+  const output = out ? resolve14(out) : join29(dirname12(inputAbs), `${base}-transcript.md`);
   if (extname8(output).toLowerCase() !== ".md")
     throw new Error("--out 必须指向一个 .md 文件");
   return output;
 }
 async function writeMarkdownAtomic(path, markdown) {
-  await mkdir14(dirname11(path), { recursive: true });
+  await mkdir14(dirname12(path), { recursive: true });
   const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
   try {
-    await writeFile12(temp, markdown, "utf8");
+    await writeFile13(temp, markdown, "utf8");
     await rename3(temp, path);
   } finally {
     await rm2(temp, { force: true });
@@ -14994,8 +15312,8 @@ 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 mkdir15, writeFile as writeFile13 } from "node:fs/promises";
+import { resolve as resolve15, join as join30, dirname as dirname13, basename as basename15, extname as extname9 } from "node:path";
+import { mkdir as mkdir15, writeFile as writeFile14 } from "node:fs/promises";
 import { existsSync as existsSync26 } from "node:fs";
 var TASK_TYPE5 = "music_visualizer";
 var PRICE_KEY2 = "music_visualizer";
@@ -15114,7 +15432,7 @@ async function runMusicVisualizer(audio, opts) {
     assertExt(coverAbs, IMAGE_EXTS2, "封面图");
   const extraParams = parseExtraParams3(opts.param, opts.paramsJson);
   const projName = basename15(audioAbs, extname9(audioAbs));
-  const outDir = resolve15(opts.out ?? join29(dirname12(audioAbs), `${projName}-visualizer-${timestamp5()}`));
+  const outDir = resolve15(opts.out ?? join30(dirname13(audioAbs), `${projName}-visualizer-${timestamp5()}`));
   log.step(`▶ 音乐可视化：${basename15(audioAbs)}（模板 ${template}${bgAbs ? " · 背景" : ""}${coverAbs ? " · 封面" : ""}）`);
   let billingHint;
   try {
@@ -15161,7 +15479,7 @@ async function runMusicVisualizer(audio, opts) {
   const { taskId } = submitted;
   log.info(`task_id = ${taskId}`);
   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));
+  await writeFile14(join30(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) => {
     log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
@@ -15172,7 +15490,7 @@ async function runMusicVisualizer(audio, opts) {
   const files = [];
   const errors = {};
   if (url) {
-    const dest = join29(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
+    const dest = join30(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
     try {
       await downloadStream(url, dest);
       files.push(dest);
@@ -15194,7 +15512,7 @@ async function runMusicVisualizer(audio, opts) {
     ...Object.keys(errors).length ? { errors } : {},
     finishedAt: new Date().toISOString()
   };
-  await writeFile13(join29(outDir, "result.json"), JSON.stringify(resultJson, null, 2));
+  await writeFile14(join30(outDir, "result.json"), JSON.stringify(resultJson, null, 2));
   if (opts.json) {
     process.stdout.write(`${JSON.stringify(resultJson)}
 `);
@@ -15212,7 +15530,7 @@ try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync6(join30(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync6(join31(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);