@gitruck/cli 0.2.22 → 1.0.0

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 join33 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -4230,6 +4230,12 @@ function ffmpegDir() {
 function audioCacheDir() {
   return join(GITRUCK_HOME, "audio-cache");
 }
+function fontsDir() {
+  return join(GITRUCK_HOME, "fonts");
+}
+function tmpDir() {
+  return join(GITRUCK_HOME, "tmp");
+}
 var _migrated = false;
 function migrateLegacyHome() {
   if (_migrated)
@@ -5819,7 +5825,8 @@ import { existsSync as existsSync7 } from "node:fs";
 import { join as join7 } from "node:path";
 var isWin = process.platform === "win32";
 var bin = (base) => isWin ? `${base}.exe` : base;
-var FFMPEG_INSTALL_HINT = `未找到 ffmpeg/ffprobe。请把二者放到 ${ffmpegDir()}（agent 可代办：先查本地确实缺失才拉，` + `面向国内用户优先国内加速站点——GitHub 代理 pass-through 拉 BtbN/gyan.dev 官方静态构建，或同合云自建镜像，` + `并做 sha256 校验），或用 --ffmpeg-path <目录> 指定已装位置。`;
+var FFMPEG_INSTALL_HINT = `未找到 ffmpeg/ffprobe。装它：gtrk deps install --ffmpeg` + `（从同合云镜像拉，自动过 sha256 校验，落 ${ffmpegDir()}；agent 可代办）。
+` + `  也可自行把 ffmpeg/ffprobe 放到该目录，或用 --ffmpeg-path <目录> 指定已装位置。`;
 var _cache = new Map;
 function onSystemPath(cmd) {
   try {
@@ -6200,9 +6207,9 @@ 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 { resolve as resolve4, join as join16, dirname as dirname4, basename as basename7, extname as extname2 } from "node:path";
 import { mkdir as mkdir5, writeFile as writeFile5, readFile as readFile4 } from "node:fs/promises";
-import { existsSync as existsSync13 } from "node:fs";
+import { existsSync as existsSync14 } from "node:fs";
 
 // src/lib/config.ts
 function loadConfig() {
@@ -6723,8 +6730,194 @@ async function uploadAndSubmitTask(cfg, path, taskType, buildPayload, options =
 
 // src/lib/media.ts
 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";
+import { closeSync, existsSync as existsSync12, openSync, readSync, readdirSync as readdirSync2 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { basename as basename5, extname, join as join13 } from "node:path";
+
+// src/lib/runtime-assets.ts
+import { spawnSync as spawnSync4 } from "node:child_process";
+import { createHash } from "node:crypto";
+import { createWriteStream, existsSync as existsSync11, mkdirSync as mkdirSync4, chmodSync, renameSync, rmSync, readdirSync } from "node:fs";
+import { createReadStream as createReadStream2 } from "node:fs";
+import { once } from "node:events";
+import { pipeline } from "node:stream/promises";
+import { basename as basename4, dirname as dirname3, join as join12 } from "node:path";
+var MANIFEST_URL = "https://api.ai-mcn.tv:9000/broadcast/exe/ffmpeg/dist/manifest.json";
+var SUPPORTED_SCHEMA = 1;
+function assertHttps(url) {
+  if (!/^https:\/\//i.test(url)) {
+    throw new Error(`运行时资产下载 MUST 用 https，收到：${url}`);
+  }
+}
+var DISTRIBUTED_PLATFORMS = ["win-x64", "linux-x64", "mac-x64", "mac-arm64"];
+function resolvePlatformKey(platform = process.platform, arch = process.arch) {
+  const os = { win32: "win", linux: "linux", darwin: "mac" }[platform];
+  const cpu = { x64: "x64", arm64: "arm64" }[arch];
+  const key = os && cpu ? `${os}-${cpu}` : "";
+  if (!key || !DISTRIBUTED_PLATFORMS.includes(key)) {
+    throw new Error(`当前平台 ${platform}-${arch} 无对应的 ffmpeg 分发包（已分发：${DISTRIBUTED_PLATFORMS.join(" / ")}）。` + `请自行安装 ffmpeg/ffprobe 到 ${ffmpegDir()}，或用 --ffmpeg-path <目录> 指定已装位置。`);
+  }
+  return key;
+}
+function parseManifest(raw) {
+  if (!raw || typeof raw !== "object")
+    throw new Error("manifest 不是对象");
+  const m = raw;
+  if (typeof m.schema !== "number")
+    throw new Error("manifest 缺 schema 字段");
+  if (m.schema > SUPPORTED_SCHEMA) {
+    throw new Error(`manifest schema=${m.schema} 高于本 CLI 支持的 ${SUPPORTED_SCHEMA}，请先升级 CLI（gtrk upgrade）`);
+  }
+  if (!m.base || !m.ffmpeg || !m.font)
+    throw new Error("manifest 缺 base/ffmpeg/font 字段");
+  assertHttps(m.base);
+  return m;
+}
+async function fetchManifest(url = MANIFEST_URL) {
+  assertHttps(url);
+  const r = await fetch(url);
+  if (!r.ok)
+    throw new Error(`取 manifest 失败：HTTP ${r.status} ${url}`);
+  return parseManifest(await r.json());
+}
+async function sha256File(path) {
+  const h = createHash("sha256");
+  await pipeline(createReadStream2(path), h);
+  return h.digest("hex");
+}
+function systemTarPath() {
+  if (process.platform === "win32") {
+    const sys = join12(process.env.SystemRoot || "C:\\Windows", "System32", "tar.exe");
+    if (existsSync11(sys))
+      return sys;
+  }
+  return "tar";
+}
+function hasSystemTar() {
+  try {
+    return spawnSync4(systemTarPath(), ["--version"], { stdio: "ignore" }).status === 0;
+  } catch {
+    return false;
+  }
+}
+async function downloadVerified(url, expectSha256, onProgress) {
+  assertHttps(url);
+  mkdirSync4(tmpDir(), { recursive: true });
+  const tmp = join12(tmpDir(), `dl-${Date.now()}-${url.split("/").pop() ?? "asset"}`);
+  try {
+    const r = await fetch(url);
+    if (!r.ok)
+      throw new Error(`下载失败：HTTP ${r.status} ${url}`);
+    if (!r.body)
+      throw new Error(`下载失败：响应无 body ${url}`);
+    const total = Number(r.headers.get("content-length") ?? 0);
+    let got = 0;
+    const reader = r.body.getReader();
+    const ws = createWriteStream(tmp);
+    try {
+      for (;; ) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        got += value.length;
+        if (onProgress)
+          onProgress(got, total);
+        if (!ws.write(value))
+          await once(ws, "drain");
+      }
+    } finally {
+      ws.end();
+    }
+    await once(ws, "close");
+    const actual = await sha256File(tmp);
+    if (actual !== expectSha256) {
+      rmSync(tmp, { force: true });
+      throw new Error(`sha256 校验不通过，已丢弃下载物、未落地任何文件。
+  期望 ${expectSha256}
+  实得 ${actual}
+  来源 ${url}`);
+    }
+    return tmp;
+  } catch (e) {
+    rmSync(tmp, { force: true });
+    throw e;
+  }
+}
+function extractTar(archive, destDir) {
+  if (!hasSystemTar()) {
+    throw new Error(`未找到可用的系统 tar，无法解包 ${archive}。
+` + `Windows 10+/macOS/Linux 通常自带；若确无，请手工解开该 .tar.xz 并把二进制放到 ${destDir}。`);
+  }
+  mkdirSync4(destDir, { recursive: true });
+  const r = spawnSync4(systemTarPath(), ["-xf", basename4(archive), "-C", destDir], {
+    cwd: dirname3(archive),
+    encoding: "utf8"
+  });
+  if (r.status !== 0) {
+    throw new Error(`tar 解包失败（code=${r.status}）：${(r.stderr || "").slice(-300)}`);
+  }
+}
+async function installFfmpeg(m, opts = {}) {
+  const key = resolvePlatformKey();
+  const entry = m.ffmpeg[key];
+  if (!entry) {
+    throw new Error(`manifest 中无 ${key} 的 ffmpeg 包（可用：${Object.keys(m.ffmpeg).join(" / ")}）。` + `请自行安装到 ${ffmpegDir()} 或用 --ffmpeg-path。`);
+  }
+  const dest = ffmpegDir();
+  const already = entry.members.every((f) => existsSync11(join12(dest, f)));
+  if (already && !opts.force) {
+    return { installed: false, reason: "已存在", detail: `${dest}（--force 可覆盖）` };
+  }
+  const tmp = await downloadVerified(`${m.base}/${entry.file}`, entry.sha256, opts.onProgress);
+  try {
+    const stage = join12(tmpDir(), `x-${Date.now()}`);
+    extractTar(tmp, stage);
+    for (const f of entry.members) {
+      if (!existsSync11(join12(stage, f))) {
+        rmSync(stage, { recursive: true, force: true });
+        throw new Error(`解包结果缺成员 ${f}，已中止，未改动 ${dest}`);
+      }
+    }
+    mkdirSync4(dest, { recursive: true });
+    for (const f of entry.members) {
+      const target = join12(dest, f);
+      rmSync(target, { force: true });
+      renameSync(join12(stage, f), target);
+      if (process.platform !== "win32")
+        chmodSync(target, 493);
+    }
+    rmSync(stage, { recursive: true, force: true });
+    return { installed: true, detail: `${entry.version} → ${dest}` };
+  } finally {
+    rmSync(tmp, { force: true });
+  }
+}
+async function installFont(m, opts = {}) {
+  const out = [];
+  const dest = fontsDir();
+  for (const [name, entry] of Object.entries(m.font)) {
+    const target = join12(dest, entry.file);
+    if (existsSync11(target) && !opts.force) {
+      out.push({ installed: false, reason: "已存在", detail: `${name} → ${target}` });
+      continue;
+    }
+    const tmp = await downloadVerified(entry.url, entry.sha256, opts.onProgress);
+    mkdirSync4(dest, { recursive: true });
+    rmSync(target, { force: true });
+    renameSync(tmp, target);
+    out.push({ installed: true, detail: `${name} → ${target}` });
+  }
+  return out;
+}
+function hasLocalFonts() {
+  try {
+    return readdirSync(fontsDir()).some((f) => /\.(otf|ttf|ttc|otc)$/i.test(f));
+  } catch {
+    return false;
+  }
+}
+
+// src/lib/media.ts
 function parseFps(rate) {
   if (typeof rate !== "string")
     return 0;
@@ -6772,14 +6965,14 @@ function probeDuration(path, ffmpegPath) {
 }
 async function artifactPath(inputAbs, ext) {
   const s = await stat4(inputAbs);
-  const base = basename4(inputAbs, extname(inputAbs));
+  const base = basename5(inputAbs, extname(inputAbs));
   await mkdir3(audioCacheDir(), { recursive: true });
-  return join12(audioCacheDir(), `${base}.${s.size}_${Math.round(s.mtimeMs)}.${ext}`);
+  return join13(audioCacheDir(), `${base}.${s.size}_${Math.round(s.mtimeMs)}.${ext}`);
 }
 async function extractAudio(inputAbs, ffmpegPath) {
   const { ffmpeg } = requireFfmpeg(ffmpegPath);
   const out = await artifactPath(inputAbs, "mp3");
-  if (existsSync11(out))
+  if (existsSync12(out))
     return out;
   await runFfmpeg(ffmpeg, [
     "-y",
@@ -6803,7 +6996,7 @@ async function extractAudio(inputAbs, ffmpegPath) {
 async function compress720p(inputAbs, ffmpegPath) {
   const { ffmpeg } = requireFfmpeg(ffmpegPath);
   const out = await artifactPath(inputAbs, "720p.mp4");
-  if (existsSync11(out))
+  if (existsSync12(out))
     return out;
   await runFfmpeg(ffmpeg, [
     "-y",
@@ -6833,16 +7026,230 @@ 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;
+  }
+}
+function assFilterPath(p) {
+  return p.replace(/\\/g, "/").replace(/:/g, "\\:");
+}
+function nameTableNames(buf) {
+  const out = [];
+  if (buf.length < 6)
+    return out;
+  const count = buf.readUInt16BE(2);
+  const strBase = buf.readUInt16BE(4);
+  for (let i = 0;i < count; i++) {
+    const r = 6 + i * 12;
+    if (r + 12 > buf.length)
+      break;
+    const platformID = buf.readUInt16BE(r);
+    const nameID = buf.readUInt16BE(r + 6);
+    if (nameID !== 1 && nameID !== 4 && nameID !== 16)
+      continue;
+    const len = buf.readUInt16BE(r + 8);
+    const off = strBase + buf.readUInt16BE(r + 10);
+    if (off + len > buf.length)
+      continue;
+    const slice = buf.subarray(off, off + len);
+    let s;
+    if (platformID === 1) {
+      s = slice.toString("latin1");
+    } else {
+      const even = slice.length % 2 === 0 ? slice : slice.subarray(0, slice.length - 1);
+      s = Buffer.from(even).swap16().toString("utf16le");
+    }
+    const v = s.replace(/\0/g, "").trim();
+    if (v)
+      out.push(v);
+  }
+  return out;
+}
+function fontFileFamilies(path) {
+  let fd = null;
+  try {
+    fd = openSync(path, "r");
+    const head = Buffer.alloc(12);
+    if (readSync(fd, head, 0, 12, 0) < 12)
+      return [];
+    const bases = [];
+    if (head.toString("latin1", 0, 4) === "ttcf") {
+      const n = head.readUInt32BE(8);
+      const dir = Buffer.alloc(Math.min(n, 64) * 4);
+      readSync(fd, dir, 0, dir.length, 12);
+      for (let i = 0;i < dir.length / 4; i++)
+        bases.push(dir.readUInt32BE(i * 4));
+    } else {
+      bases.push(0);
+    }
+    const out = [];
+    for (const base of bases) {
+      const h = base === 0 ? head : Buffer.alloc(12);
+      if (base !== 0 && readSync(fd, h, 0, 12, base) < 12)
+        continue;
+      const numTables = h.readUInt16BE(4);
+      if (!numTables || numTables > 512)
+        continue;
+      const dir = Buffer.alloc(numTables * 16);
+      if (readSync(fd, dir, 0, dir.length, base + 12) < dir.length)
+        continue;
+      let nameOff = 0;
+      let nameLen = 0;
+      for (let i = 0;i < numTables; i++) {
+        if (dir.toString("latin1", i * 16, i * 16 + 4) === "name") {
+          nameOff = dir.readUInt32BE(i * 16 + 8);
+          nameLen = dir.readUInt32BE(i * 16 + 12);
+          break;
+        }
+      }
+      if (!nameOff || !nameLen || nameLen > 1 << 20)
+        continue;
+      const nameBuf = Buffer.alloc(nameLen);
+      if (readSync(fd, nameBuf, 0, nameLen, nameOff) < nameLen)
+        continue;
+      out.push(...nameTableNames(nameBuf));
+    }
+    return out;
+  } catch {
+    return [];
+  } finally {
+    if (fd !== null)
+      try {
+        closeSync(fd);
+      } catch {}
+  }
+}
+var FONT_EXT = /\.(otf|ttf|ttc|otc)$/i;
+function scanFontDir(dir, out, depth = 0) {
+  if (depth > 3)
+    return;
+  let entries;
+  try {
+    entries = readdirSync2(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const e of entries) {
+    const p = join13(dir, e.name);
+    if (e.isDirectory())
+      scanFontDir(p, out, depth + 1);
+    else if (FONT_EXT.test(e.name))
+      for (const n of fontFileFamilies(p))
+        out.add(n);
+  }
+}
+var _famCache = null;
+function localFontFamilies() {
+  if (_famCache)
+    return _famCache;
+  const out = new Set;
+  scanFontDir(fontsDir(), out);
+  _famCache = [...out];
+  return _famCache;
+}
+function systemFontDirs() {
+  const home = homedir3();
+  if (process.platform === "win32") {
+    return [
+      join13(process.env.SystemRoot || "C:\\Windows", "Fonts"),
+      join13(process.env.LOCALAPPDATA || join13(home, "AppData", "Local"), "Microsoft", "Windows", "Fonts")
+    ];
+  }
+  if (process.platform === "darwin") {
+    return ["/System/Library/Fonts", "/Library/Fonts", join13(home, "Library", "Fonts")];
+  }
+  return ["/usr/share/fonts", "/usr/local/share/fonts", join13(home, ".local/share/fonts"), join13(home, ".fonts")];
+}
+var _sysCache = null;
+function systemFontFamilies() {
+  if (_sysCache)
+    return _sysCache;
+  const out = new Set;
+  for (const d of systemFontDirs())
+    scanFontDir(d, out);
+  _sysCache = [...out];
+  return _sysCache;
+}
+async function burnSubtitle(videoAbs, assAbs, outAbs, opts = {}) {
+  const { ffmpeg } = requireFfmpeg(opts.ffmpegPath);
+  let filter = `ass='${assFilterPath(assAbs)}'`;
+  if (hasLocalFonts())
+    filter += `:fontsdir='${assFilterPath(fontsDir())}'`;
+  await runFfmpeg(ffmpeg, [
+    "-y",
+    "-v",
+    "error",
+    "-i",
+    videoAbs,
+    "-vf",
+    filter,
+    "-c:v",
+    opts.codec ?? "libx264",
+    "-crf",
+    String(opts.crf ?? 18),
+    "-preset",
+    "medium",
+    "-c:a",
+    "copy",
+    "-movflags",
+    "+faststart",
+    outAbs
+  ]);
+  return outAbs;
+}
+async function fontUsableForBurn(font, ffmpegPath) {
+  const local = localFontFamilies();
+  const sys = systemFontFamilies();
+  if (local.includes(font) || sys.includes(font))
+    return true;
+  if (local.length === 0 && sys.length === 0) {
+    return await probeFontAvailable(font, ffmpegPath) !== false;
+  }
+  return false;
+}
 
 // src/lib/materialize.ts
-import { join as join14, basename as basename5 } from "node:path";
+import { join as join15, basename as basename6 } from "node:path";
 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";
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync13 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 var AUDIO_SAMPLE_RATE = 48000;
 var AUDIO_LAYOUT = "stereo";
 var DEFAULT_CRF = 18;
@@ -7000,7 +7407,7 @@ function materialPathsFromGtrk(gtrk) {
       continue;
     if (!m.path)
       throw new Error(`gtrk 素材 ${m.id} 缺 path（source_path），无法本地渲染`);
-    if (!existsSync12(m.path))
+    if (!existsSync13(m.path))
       throw new Error(`gtrk 素材文件不存在：${m.path}`);
     map[String(m.id)] = m.path;
   }
@@ -7014,7 +7421,7 @@ async function renderGtrk(gtrk, outputPath, opts = {}) {
   const { ffmpeg } = requireFfmpeg(opts.ffmpegPath);
   const materialPaths = materialPathsFromGtrk(gtrk);
   const { inputs, graph, total } = buildFilterGraph(gtrk, materialPaths, { crf });
-  const filterFile = join13(tmpdir(), `gtrk-filter-${process.pid}-${inputs.length}.txt`);
+  const filterFile = join14(tmpdir(), `gtrk-filter-${process.pid}-${inputs.length}.txt`);
   await writeFile3(filterFile, graph, "utf8");
   try {
     const args = ["-y"];
@@ -7052,7 +7459,7 @@ function gtrkSourceName(gtrk) {
   const p = gtrk.materials?.[0]?.path;
   if (!p)
     return;
-  const b = basename5(p);
+  const b = basename6(p);
   const dot = b.lastIndexOf(".");
   return dot > 0 ? b.slice(0, dot) : b;
 }
@@ -7064,7 +7471,7 @@ async function materializeResult(opts) {
     throw new Error("任务无工程文件产物（检查 project_formats / 任务是否产出）");
   const errors = { ...output.errors ?? {} };
   await mkdir4(outDir, { recursive: true });
-  const resultPath = join14(outDir, "result.json");
+  const resultPath = join15(outDir, "result.json");
   const writeResult = async (extra) => {
     const r = {
       ok: Object.keys(errors).length === 0,
@@ -7086,9 +7493,9 @@ async function materializeResult(opts) {
   const byFormat = {};
   for (const f of files) {
     const base = baseFormat(f.format);
-    const fmtDir = join14(outDir, base);
+    const fmtDir = join15(outDir, base);
     await mkdir4(fmtDir, { recursive: true });
-    const dest = join14(fmtDir, f.filename);
+    const dest = join15(fmtDir, f.filename);
     try {
       await dl(f.download_url, dest);
       (byFormat[base] ??= []).push(dest);
@@ -7104,9 +7511,9 @@ async function materializeResult(opts) {
   }
   let jianyingDraftPath = null;
   if (byFormat.jianying && opts.draftDir) {
-    const dest = join14(opts.draftDir, basename5(outDir));
+    const dest = join15(opts.draftDir, basename6(outDir));
     try {
-      const landing = await copyJianyingDraft(join14(outDir, "jianying"), dest);
+      const landing = await copyJianyingDraft(join15(outDir, "jianying"), dest);
       if (landing.complete) {
         jianyingDraftPath = dest;
         log.info(`剪映草稿已落到：${dest}`);
@@ -7128,7 +7535,7 @@ async function materializeResult(opts) {
       log.step("本地渲染成片（ffmpeg）…");
       const project = await readGtrkFile(gtrkPath);
       const name = opts.projName ?? gtrkSourceName(project) ?? taskId;
-      const outMp4 = join14(outDir, `${name}.mp4`);
+      const outMp4 = join15(outDir, `${name}.mp4`);
       const r = await renderGtrk(project, outMp4, {
         crf: opts.crf != null ? Number(opts.crf) : undefined,
         codec: opts.codec,
@@ -7150,7 +7557,7 @@ async function materializeResult(opts) {
       log.step("三方打开（产物已就位，按需自取）：");
     for (const base of Object.keys(byFormat)) {
       const meta = FORMAT_META[base];
-      const target = base === "jianying" ? jianyingDraftPath ?? join14(outDir, "jianying") : byFormat[base][0];
+      const target = base === "jianying" ? jianyingDraftPath ?? join15(outDir, "jianying") : byFormat[base][0];
       console.log(`   • ${meta?.label ?? base}：${meta?.openHint(target) ?? target}`);
     }
     if (rendered)
@@ -7218,18 +7625,18 @@ async function runOralCut(input, opts) {
     routeLogsToStderr();
   const cfg = loadConfig();
   const inputAbs = resolve4(input);
-  if (!existsSync13(inputAbs))
+  if (!existsSync14(inputAbs))
     throw new Error(`毛片不存在：${inputAbs}`);
-  const projName = basename6(inputAbs, extname2(inputAbs));
+  const projName = basename7(inputAbs, extname2(inputAbs));
   const formats = opts.formats.split(",").map((s) => s.trim()).filter(Boolean);
   if (opts.render && !formats.includes("gtrk"))
     formats.push("gtrk");
   const wantJianying = formats.some((f) => f === "jianying" || f === "capcut");
-  const outDir = resolve4(opts.out ?? join15(dirname3(inputAbs), `${projName}-video-project-${timestamp()}`));
+  const outDir = resolve4(opts.out ?? join16(dirname4(inputAbs), `${projName}-video-project-${timestamp()}`));
   let scriptPath = opts.script ? resolve4(opts.script) : undefined;
   if (!scriptPath) {
-    const sibling = join15(dirname3(inputAbs), `${projName}.txt`);
-    if (existsSync13(sibling)) {
+    const sibling = join16(dirname4(inputAbs), `${projName}.txt`);
+    if (existsSync14(sibling)) {
       scriptPath = sibling;
       log.info(`自动识别到同名文稿：${sibling}（按有稿剪辑；不想用就改名或显式 --script）`);
     }
@@ -7243,14 +7650,14 @@ async function runOralCut(input, opts) {
     else
       log.warn("没找到剪映草稿目录 → 将只产 draft_content.json、缺 meta。可加 --jianying-draft-dir <你的草稿目录> 重跑。");
   }
-  log.step(`▶ 智能口播剪辑：${basename6(inputAbs)}（预设 ${opts.preset}${opts.visualAssist ? " · 视觉兜底(720p)" : ""}，格式 ${formats.join("/")}${opts.render ? " · 本地渲染" : ""}）`);
+  log.step(`▶ 智能口播剪辑：${basename7(inputAbs)}（预设 ${opts.preset}${opts.visualAssist ? " · 视觉兜底(720p)" : ""}，格式 ${formats.join("/")}${opts.render ? " · 本地渲染" : ""}）`);
   const extraParams = parseExtraParams(opts.param, opts.paramsJson);
   log.step("① 本地预处理（探几何 + 抽音频/720p）…");
   const geo = probeGeometry(inputAbs, opts.ffmpegPath);
   log.info(`原片几何 ${geo.width}x${geo.height} @ ${geo.fps.toFixed(2)}fps · ${geo.duration.toFixed(1)}s`);
   const artifact = opts.visualAssist ? await compress720p(inputAbs, opts.ffmpegPath) : await extractAudio(inputAbs, opts.ffmpegPath);
   assertDurationConsistent(geo.duration, artifact, opts.ffmpegPath);
-  log.info(opts.visualAssist ? `已压 720p 代理（上传物）：${basename6(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename6(artifact)}`);
+  log.info(opts.visualAssist ? `已压 720p 代理（上传物）：${basename7(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename7(artifact)}`);
   log.step("② 上传抽出物到云端…");
   const buildPayload = (fid) => {
     const p = {
@@ -7290,7 +7697,7 @@ async function runOralCut(input, opts) {
   const up = { fileId: submitted.fileId, cached: submitted.cached };
   log.info(`task_id = ${taskId}`);
   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));
+  await writeFile5(join16(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) => {
     log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
@@ -7314,9 +7721,9 @@ 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 { existsSync as existsSync16 } from "node:fs";
+import { resolve as resolve6, join as join19, dirname as dirname7, basename as basename9, extname as extname5 } from "node:path";
+import { mkdir as mkdir7, writeFile as writeFile8 } from "node:fs/promises";
+import { existsSync as existsSync17 } from "node:fs";
 
 // src/lib/clip-brief.ts
 var str = (v) => {
@@ -7445,13 +7852,113 @@ 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 { createWriteStream, existsSync as existsSync15 } from "node:fs";
+import { resolve as resolve5, join as join18, dirname as dirname6, basename as basename8, extname as extname4 } from "node:path";
+import { mkdir as mkdir6, writeFile as writeFile7, stat as stat5 } from "node:fs/promises";
+import { createWriteStream as createWriteStream2, existsSync as existsSync16 } from "node:fs";
 import { Readable as Readable2 } from "node:stream";
-import { pipeline } from "node:stream/promises";
+import { pipeline as pipeline2 } from "node:stream/promises";
 
 // src/lib/tool-pricing.ts
 var TOOL_PRICE_LIST_URL = "https://cloud.ai-mcn.tv/api/get_price_list";
@@ -7534,11 +8041,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 dirname5, extname as extname3, join as join17, 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 +8991,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 +9051,136 @@ 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 fontUsableForBurn(f, ctx.ffmpegPath))
+        missing.push(f);
+    }
+    if (missing.length) {
+      throw new Error(`本机缺字幕模板所需字体：${missing.join("、")}。` + `装它：gtrk deps install --font（落 ~/.gitruck/fonts，不写系统字体表）。
+` + `  装上后重跑即可（字幕文件已落地，无需重新提交任务）。不用替代字体顶——` + `替代字体烧出来的成片观感与模板设计不符且难以察觉。`);
+    }
+    const out = join17(dirname5(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 = join17(dirname5(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 +9472,7 @@ var TOOL_REGISTRY = [
   imageClassicTemplate,
   imageVerticalStitch,
   videoSplitScreen,
+  videoLong2ShortPro,
   audioTtsClone,
   mad
 ];
@@ -8918,7 +9573,7 @@ function validateToolInput(descriptor, inputAbs) {
     return;
   if (!inputAbs)
     throw new Error(`${descriptor.name} 需要输入${spec.kind === "directory" ? "目录" : "文件"}`);
-  if (!existsSync15(inputAbs))
+  if (!existsSync16(inputAbs))
     throw new Error(`输入不存在：${inputAbs}`);
   if (spec.kind === "directory")
     return;
@@ -8935,13 +9590,13 @@ function validateToolInputs(descriptor, inputAbsList) {
     throw new Error(`${descriptor.name} 需要至少一个输入文件（可传多个，顺序即拼装顺序）`);
   const exts = descriptor.input.exts ?? defaultExtsFor(descriptor.input.kind);
   for (const p of inputAbsList) {
-    if (!existsSync15(p))
+    if (!existsSync16(p))
       throw new Error(`输入不存在：${p}`);
     if (exts && exts.length) {
       const e = extname4(p).toLowerCase();
       if (!exts.includes(e)) {
         const noun = descriptor.input.kind === "videos" ? "视频" : "图片";
-        throw new Error(`${descriptor.name} 需要${noun}输入，但「${basename7(p)}」是「${e || "无扩展名"}」（支持：${exts.join(" ")}）`);
+        throw new Error(`${descriptor.name} 需要${noun}输入，但「${basename8(p)}」是「${e || "无扩展名"}」（支持：${exts.join(" ")}）`);
       }
     }
   }
@@ -8959,7 +9614,7 @@ async function downloadStream(url, dest) {
   const res = await fetch(url);
   if (!res.ok || !res.body)
     throw new Error(`下载失败 HTTP ${res.status}：${url}`);
-  await pipeline(Readable2.fromWeb(res.body), createWriteStream(dest));
+  await pipeline2(Readable2.fromWeb(res.body), createWriteStream2(dest));
 }
 async function pollToolTask(cfg, taskType, taskId, opts = {}) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
@@ -9039,10 +9694,10 @@ function resolveOutDir(descriptor, inputAbs, out) {
   if (out)
     return resolve5(out);
   if (inputAbs) {
-    const base = basename7(inputAbs, extname4(inputAbs));
-    return join16(dirname4(inputAbs), `${base}-${descriptor.name}`);
+    const base = basename8(inputAbs, extname4(inputAbs));
+    return join18(dirname6(inputAbs), `${base}-${descriptor.name}`);
   }
-  return join16(process.cwd(), `${descriptor.name}-${timestamp2()}`);
+  return join18(process.cwd(), `${descriptor.name}-${timestamp2()}`);
 }
 async function safeFingerprint(inputAbs) {
   try {
@@ -9060,7 +9715,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 baseName2 = inputAbs ? basename7(inputAbs, extname4(inputAbs)) : descriptor.name;
+  const baseName2 = inputAbs ? basename8(inputAbs, extname4(inputAbs)) : descriptor.name;
   if (isMulti) {
     validateToolInputs(descriptor, inputList);
   } else {
@@ -9131,7 +9786,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(join18(outDir, "task.json"), JSON.stringify({
     tool: descriptor.name,
     taskType,
     taskId,
@@ -9153,7 +9808,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 = join18(outDir, it.filename);
     try {
       await deps.downloadStream(it.url, dest);
       files.push(dest);
@@ -9161,11 +9816,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 = join18(outDir, "result-output.json");
+    await writeFile7(resultFile, JSON.stringify(structured, null, 2));
   }
   if (items.length === 0 && resultFile == null) {
     errors["output"] = "任务完成但未解析到任何产物（下载链接与结构化结果均为空，output_result 形态异常）";
@@ -9183,7 +9847,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(join18(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
   return result;
 }
 
@@ -9240,8 +9904,8 @@ async function copyClipDraftsToRoot(clipDirs, draftTarget, errors) {
   let complete = 0;
   let attempted = 0;
   for (const [i, dir] of clipDirs.entries()) {
-    const src = join17(dir, "jianying");
-    if (!existsSync16(src)) {
+    const src = join19(dir, "jianying");
+    if (!existsSync17(src)) {
       paths.push(null);
       continue;
     }
@@ -9273,15 +9937,15 @@ async function runLong2Short(input, opts) {
     routeLogsToStderr();
   const cfg = loadConfig();
   const inputAbs = resolve6(input);
-  if (!existsSync16(inputAbs))
+  if (!existsSync17(inputAbs))
     throw new Error(`毛片不存在：${inputAbs}`);
-  const projName = basename8(inputAbs, extname5(inputAbs));
+  const projName = basename9(inputAbs, extname5(inputAbs));
   const formats = opts.formats.split(",").map((s) => s.trim()).filter(Boolean);
   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 outName = basename8(outDir);
+  const outDir = resolve6(opts.out ?? join19(dirname7(inputAbs), `${projName}-long2short`));
+  const outName = basename9(outDir);
   let draftRoot;
   if (wantJianying) {
     draftRoot = resolveJianyingDraftDir(opts.jianyingDraftDir);
@@ -9290,14 +9954,14 @@ async function runLong2Short(input, opts) {
     else
       log.warn("没找到剪映草稿目录 → 将只产 draft_content.json、缺 meta。可加 --jianying-draft-dir <你的草稿目录> 重跑。");
   }
-  const draftTarget = draftRoot ? join17(draftRoot, outName) : undefined;
-  log.step(`▶ 长剪短：${basename8(inputAbs)}（${opts.splitScreen ? "720p 代理 · 智能分屏" : "纯选段 · 音频上传"}，格式 ${formats.join("/")}）`);
+  const draftTarget = draftRoot ? join19(draftRoot, outName) : undefined;
+  log.step(`▶ 长剪短：${basename9(inputAbs)}（${opts.splitScreen ? "720p 代理 · 智能分屏" : "纯选段 · 音频上传"}，格式 ${formats.join("/")}）`);
   log.step("① 本地预处理（探几何 + 抽音频/720p 代理）…");
   const geo = probeGeometry(inputAbs, opts.ffmpegPath);
   log.info(`原片几何 ${geo.width}x${geo.height} @ ${geo.fps.toFixed(2)}fps · ${(geo.duration / 60).toFixed(1)}min`);
   const artifact = opts.splitScreen ? await compress720p(inputAbs, opts.ffmpegPath) : await extractAudio(inputAbs, opts.ffmpegPath);
   assertDurationConsistent(geo.duration, artifact, opts.ffmpegPath);
-  log.info(opts.splitScreen ? `已压 720p 代理（上传物）：${basename8(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename8(artifact)}`);
+  log.info(opts.splitScreen ? `已压 720p 代理（上传物）：${basename9(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename9(artifact)}`);
   const payloadProbe = buildLong2ShortPayload("__dry_run__", opts, geo, inputAbs, formats, draftTarget);
   log.step("② 上传抽出物到云端…");
   const submitted = await uploadAndSubmitTask(cfg, artifact, TASK_TYPE2, (fid) => buildLong2ShortPayload(fid, opts, geo, inputAbs, formats, draftTarget), {
@@ -9311,7 +9975,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(join19(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,14 +9998,14 @@ async function runLong2Short(input, opts) {
         continue;
       }
       if (!/^(?:[A-Za-z]:[\\/]|[\\/])/.test(dest))
-        dest = join17(dirname5(inputAbs), dest);
+        dest = join19(dirname7(inputAbs), dest);
       try {
-        await mkdir7(dirname5(dest), { recursive: true });
+        await mkdir7(dirname7(dest), { recursive: true });
         await download(url, dest);
         splitLanded++;
       } catch (e) {
-        errors[`split:${basename8(dest)}`] = e instanceof Error ? e.message : String(e);
-        log.warn(`分屏素材下载失败（${basename8(dest)}），对应工程中该素材将缺席`);
+        errors[`split:${basename9(dest)}`] = e instanceof Error ? e.message : String(e);
+        log.warn(`分屏素材下载失败（${basename9(dest)}），对应工程中该素材将缺席`);
       }
     }
     if (splitLanded)
@@ -9350,7 +10014,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 = join19(outDir, `clip${i}`);
     const { files: clipFiles, ...clipMeta } = clip;
     try {
       const r = await materializeResult({
@@ -9391,13 +10055,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(join19(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(join19(outDir, "clips.md"), renderClipsOverview(clips, {
       source: inputAbs,
       jumpCut: opts.jumpCut !== false,
       splitMaterials: { landed: splitLanded, total: manifest.length },
@@ -9407,7 +10071,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(join19(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 +10082,10 @@ async function runLong2Short(input, opts) {
     outDir,
     clips: clipResults,
     splitMaterials: { landed: splitLanded, total: manifest.length },
-    reportFile: join17(outDir, "report.json"),
+    reportFile: join19(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(join19(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 +10101,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 join20 } from "node:path";
 var TASK_TYPE3 = "cli/video_oral_cut_for_cli";
 function timestamp3() {
   const d = new Date;
@@ -9471,7 +10135,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 ?? join20(process.cwd(), `${taskId}-video-project-${timestamp3()}`));
   const draftDir = resolveJianyingDraftDir(opts.jianyingDraftDir);
   await materializeResult({
     outDir,
@@ -9489,10 +10153,10 @@ async function runOralCutResult(taskId, opts) {
 }
 
 // src/commands/upgrade.ts
-import { spawnSync as spawnSync4 } from "node:child_process";
+import { spawnSync as spawnSync5 } from "node:child_process";
 var CLIENT_UPGRADE = "irm https://api.ai-mcn.tv:9000/broadcast/exe/install.ps1 | iex";
 function run(cmd) {
-  const r = spawnSync4(cmd, { stdio: "inherit", shell: true });
+  const r = spawnSync5(cmd, { stdio: "inherit", shell: true });
   return r.status ?? 1;
 }
 function registerUpgrade(program2) {
@@ -9531,17 +10195,17 @@ 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 { existsSync as existsSync17 } from "node:fs";
+import { resolve as resolve8, dirname as dirname8, join as join21, basename as basename10, extname as extname6 } from "node:path";
+import { existsSync as existsSync18 } 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) => {
     if (opts.json)
       routeLogsToStderr();
     const gtrkAbs = resolve8(gtrk);
-    if (!existsSync17(gtrkAbs))
+    if (!existsSync18(gtrkAbs))
       throw new Error(`gtrk 工程不存在：${gtrkAbs}`);
-    const outMp4 = resolve8(opts.out ?? join19(dirname6(gtrkAbs), `${basename9(gtrkAbs, extname6(gtrkAbs))}.mp4`));
-    log.step(`▶ 本地渲染：${basename9(gtrkAbs)} → ${basename9(outMp4)}`);
+    const outMp4 = resolve8(opts.out ?? join21(dirname8(gtrkAbs), `${basename10(gtrkAbs, extname6(gtrkAbs))}.mp4`));
+    log.step(`▶ 本地渲染：${basename10(gtrkAbs)} → ${basename10(outMp4)}`);
     const project = await readGtrkFile(gtrkAbs);
     const result = await renderGtrk(project, outMp4, {
       crf: opts.crf != null ? Number(opts.crf) : undefined,
@@ -9556,7 +10220,7 @@ function registerRender(program2) {
     log.tickEnd();
     log.ok(`渲染完成：${outMp4}（${result.duration.toFixed(1)}s）`);
     if (opts.open)
-      openFolder(dirname6(outMp4));
+      openFolder(dirname8(outMp4));
     if (opts.json) {
       console.log(JSON.stringify({ ok: true, output: outMp4, duration: result.duration }));
     }
@@ -9564,14 +10228,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 { existsSync as existsSync18 } from "node:fs";
-import { readFile as readFile5, writeFile as writeFile8, mkdir as mkdir8 } from "node:fs/promises";
-import { createHash } from "node:crypto";
+import { resolve as resolve9, join as join23, dirname as dirname10, basename as basename12 } from "node:path";
+import { existsSync as existsSync19 } from "node:fs";
+import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir8 } from "node:fs/promises";
+import { createHash as createHash2 } 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 { readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2, renameSync as renameSync2, unlinkSync } from "node:fs";
+import { dirname as dirname9, join as join22, basename as basename11 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function readGtrk(path) {
   const raw = readFileSync5(path, "utf8");
@@ -9598,10 +10262,10 @@ 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 = join22(dirname9(path), `.${basename11(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
-    renameSync(tmp, path);
+    renameSync2(tmp, path);
   } catch (e) {
     try {
       unlinkSync(tmp);
@@ -9614,10 +10278,10 @@ 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 = join22(dirname9(path), `.${basename11(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
-    renameSync(tmp, path);
+    renameSync2(tmp, path);
   } catch (e) {
     try {
       unlinkSync(tmp);
@@ -9634,7 +10298,7 @@ function registerSplit(program2) {
   });
 }
 function firstExisting(cands) {
-  return cands.find((p) => existsSync18(p));
+  return cands.find((p) => existsSync19(p));
 }
 function resolvePaths(opts) {
   const project = opts.project ? resolve9(opts.project) : undefined;
@@ -9642,22 +10306,22 @@ 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([join23(project, "gtrk", "project.gtrk"), join23(project, "project.gtrk")]) ?? join23(project, "gtrk", "project.gtrk");
   } else {
     throw new Error("需 --project <目录> 或显式 --gtrk <path>");
   }
-  if (!existsSync18(gtrkPath))
+  if (!existsSync19(gtrkPath))
     throw new Error(`找不到工程文件：${gtrkPath}`);
   let transcriptPath;
   if (opts.transcript)
     transcriptPath = resolve9(opts.transcript);
   else if (project)
     transcriptPath = firstExisting([
-      join21(project, "transcript", "transcript.json"),
-      join21(project, "json", "transcript.json"),
-      join21(project, "transcript.json")
+      join23(project, "transcript", "transcript.json"),
+      join23(project, "json", "transcript.json"),
+      join23(project, "transcript.json")
     ]);
-  const baseDir = project ?? dirname8(gtrkPath);
+  const baseDir = project ?? dirname10(gtrkPath);
   return { baseDir, gtrkPath, transcriptPath };
 }
 function slugify2(name) {
@@ -9665,11 +10329,11 @@ 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}`);
   }
-  t.text_hash = createHash("sha256").update(t.utterances.map((u) => u.text ?? "").join(`
+  t.text_hash = createHash2("sha256").update(t.utterances.map((u) => u.text ?? "").join(`
 `), "utf8").digest("hex");
   return t;
 }
@@ -9680,16 +10344,16 @@ async function runSplit(splitdoc, opts) {
   return splitdoc ? runLand(resolve9(splitdoc), baseDir, gtrkPath, transcriptPath, opts) : runView(baseDir, gtrkPath, transcriptPath, opts);
 }
 async function runView(baseDir, gtrkPath, transcriptPath, opts) {
-  if (!transcriptPath || !existsSync18(transcriptPath))
+  if (!transcriptPath || !existsSync19(transcriptPath))
     throw new Error(TRANSCRIPT_MISSING);
   log.step("▶ 导出投影视图（transcript × 当刻 .gtrk）…");
   const transcript = await loadTranscript(transcriptPath);
   const { gtrk } = readGtrk(gtrkPath);
   const view = projectTranscript(transcript, gtrk, { words: opts.words });
-  const splitDir = join21(baseDir, "split");
+  const splitDir = join23(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const viewPath = join21(splitDir, "view.json");
-  await writeFile8(viewPath, JSON.stringify(view, null, 2));
+  const viewPath = join23(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 = {
@@ -9706,12 +10370,12 @@ async function runView(baseDir, gtrkPath, transcriptPath, opts) {
   return result;
 }
 async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
-  if (!existsSync18(splitdocPath))
+  if (!existsSync19(splitdocPath))
     throw new Error(`找不到拆分稿：${splitdocPath}`);
-  if (!transcriptPath || !existsSync18(transcriptPath))
+  if (!transcriptPath || !existsSync19(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);
@@ -9734,7 +10398,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
   }
   const projectedAt = new Date().toISOString();
   const view = projectTranscript(transcript, gtrk, { projectedAt });
-  const projectSlug = slugify2(basename11(baseDir));
+  const projectSlug = slugify2(basename12(baseDir));
   const landing = buildLanding(doc, view, {
     utteranceIds: ctx.utteranceIds,
     projectSlug,
@@ -9745,14 +10409,14 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
     }
   });
   writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
-  const splitDir = join21(baseDir, "split");
+  const splitDir = join23(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const dispatchPath = join21(splitDir, "dispatch.json");
-  await writeFile8(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
+  const dispatchPath = join23(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 = join23(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 +10447,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 { existsSync as existsSync20 } from "node:fs";
-import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir9, rename } from "node:fs/promises";
+import { resolve as resolve11, join as join24, dirname as dirname11, basename as basename13 } from "node:path";
+import { existsSync as existsSync21 } from "node:fs";
+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";
@@ -10521,7 +11185,7 @@ function layBrollTracks(opts) {
 }
 
 // src/lib/material-integrity.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { resolve as resolve10 } from "node:path";
 var INTEGRITY_LIST_CAP = 10;
 var r35 = (n) => Math.round(n * 1000) / 1000;
@@ -10582,7 +11246,7 @@ function collectMaterialRefs(gtrk) {
   return out;
 }
 function checkMaterialIntegrity(opts) {
-  const exists = opts.exists ?? ((p) => existsSync19(p));
+  const exists = opts.exists ?? ((p) => existsSync20(p));
   const materials = Array.isArray(opts.gtrk.materials) ? opts.gtrk.materials : [];
   const refs = collectMaterialRefs(opts.gtrk);
   const counts = { relative: 0, absolute: 0, remote: 0, noPath: 0 };
@@ -10925,16 +11589,16 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   let baseDir;
   if (opts.dispatch) {
     dispatchPath = resolve11(opts.dispatch);
-    baseDir = dirname9(dirname9(dispatchPath));
+    baseDir = dirname11(dirname11(dispatchPath));
   } else if (opts.project) {
     baseDir = resolve11(opts.project);
-    dispatchPath = join22(baseDir, "split", "dispatch.json");
+    dispatchPath = join24(baseDir, "split", "dispatch.json");
   } else {
     throw new Error('需 --project <目录> 或显式 --dispatch <path>（ad-hoc 检索用：gtrk matrix search "<query>"）');
   }
-  if (!existsSync20(dispatchPath))
+  if (!existsSync21(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;
@@ -10989,7 +11653,7 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   if (totalQueries > 0 && okCount === 0) {
     throw new Error(`全部 ${totalQueries} 个 query 检索失败，未写入 plan（逐条原因见上方日志）`);
   }
-  const projectSlug = slugify3(basename12(baseDir));
+  const projectSlug = slugify3(basename13(baseDir));
   const plan = buildPlan({
     generatedAt: new Date().toISOString(),
     memberType: tier,
@@ -10997,10 +11661,10 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     columnId,
     beats
   });
-  const splitDir = join22(baseDir, "split");
+  const splitDir = join24(baseDir, "split");
   await mkdir9(splitDir, { recursive: true });
-  const planPath = join22(splitDir, "broll-plan.json");
-  await writeFile9(planPath, JSON.stringify(plan, null, 2));
+  const planPath = join24(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 +11711,13 @@ function parseScoreFloor(raw) {
   return SCORE_FLOOR_DEFAULT;
 }
 function locateGtrk(baseDir) {
-  const cands = [join22(baseDir, "gtrk", "project.gtrk"), join22(baseDir, "project.gtrk")];
-  return cands.find((p) => existsSync20(p));
+  const cands = [join24(baseDir, "gtrk", "project.gtrk"), join24(baseDir, "project.gtrk")];
+  return cands.find((p) => existsSync21(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(`未找到工程文件（${join24(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
     return;
   }
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
@@ -11061,8 +11725,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 = dirname11(gtrkPath);
+  const previewDir = join24(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
   await mkdir9(previewDir, { recursive: true });
   const prevSource = new Map;
   const prevBroll = gtrk.struct_meta?.broll;
@@ -11085,8 +11749,8 @@ 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("/"));
-    if (existsSync20(abs)) {
+    const abs = join24(gtrkDir, ...rel.split("/"));
+    if (existsSync21(abs)) {
       const prev = prevSource.get(clipId);
       if (prev !== "raw") {
         downloads.set(clipId, { rel, source: prev ?? "preview" });
@@ -11148,12 +11812,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 = join24(gtrkDir, ...rel.split("/"));
     try {
-      if (!existsSync20(abs)) {
-        await mkdir9(dirname9(abs), { recursive: true });
+      if (!existsSync21(abs)) {
+        await mkdir9(dirname11(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 +11880,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 +11888,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 +11911,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 +11930,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 { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile7, mkdir as mkdir10, copyFile } from "node:fs/promises";
+import { resolve as resolve12, join as join25, dirname as dirname12, basename as basename14 } from "node:path";
+import { existsSync as existsSync22 } from "node:fs";
+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,29 +13593,29 @@ 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: dirname12(dirname12(dispatchPath)) };
   }
   if (opts.project) {
     const baseDir = resolve12(opts.project);
-    return { dispatchPath: join23(baseDir, "split", "dispatch.json"), baseDir };
+    return { dispatchPath: join25(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 [join25(baseDir, "gtrk", "project.gtrk"), join25(baseDir, "project.gtrk")].find((p) => existsSync22(p));
 }
 function locateSrcHtml(baseDir, compositionId) {
   for (const d of MG_SRC_DIRS) {
-    const p = join23(baseDir, d, `${compositionId}.html`);
-    if (existsSync21(p))
+    const p = join25(baseDir, d, `${compositionId}.html`);
+    if (existsSync22(p))
       return p;
   }
   return;
 }
 async function readMgQueue(dispatchPath) {
-  if (!existsSync21(dispatchPath))
+  if (!existsSync22(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 +13689,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}：缺 ${join25(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 +13737,7 @@ async function runLay(opts) {
     });
   }
   if (!gtrkPath || !project) {
-    log.warn(`未找到工程文件（${join23(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
+    log.warn(`未找到工程文件（${join25(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
     return done(opts, {
       ok: skipped.length === 0,
       mode: "lay",
@@ -13090,7 +13754,7 @@ async function runLay(opts) {
     });
   }
   const { gtrk, mtimeMs } = project;
-  const gtrkDir = dirname10(gtrkPath);
+  const gtrkDir = dirname12(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 +13796,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(join25(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), join25(gtrkDir, ...it.html_rel.split("/")));
   }
   const { next, summary, mg } = layMgTracks({ gtrk, items, generatedAt: new Date().toISOString(), keep });
   const written = withTimecodeSource(next, "mg", reproj);
@@ -13178,12 +13842,12 @@ 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 nameId = basename13(file).replace(/\.html?$/i, "");
+  const html = await readFile8(resolve12(file), "utf8");
+  const nameId = basename14(file).replace(/\.html?$/i, "");
   let dispatchIds;
   let slotDuration;
   let compositionId;
-  if (opts.dispatch && existsSync21(resolve12(opts.dispatch))) {
+  if (opts.dispatch && existsSync22(resolve12(opts.dispatch))) {
     const queue = await readMgQueue(resolve12(opts.dispatch));
     dispatchIds = queue.map((q) => q.composition_id);
     const byName = queue.find((q) => q.composition_id === nameId);
@@ -13207,7 +13871,7 @@ async function runLint(args, opts) {
   for (const vv of lint.violations)
     (vv.fatal ? log.err : log.warn)(`${vv.fatal ? "✗" : "·"} ${vv.law}: ${vv.msg}`);
   if (lint.ok)
-    log.ok(`lint 通过（${basename13(file)}；opaque=${lint.opaque}）`);
+    log.ok(`lint 通过（${basename14(file)}；opaque=${lint.opaque}）`);
   else
     log.err(`lint 未过（${lint.violations.filter((v) => v.fatal).length} 项致命）`);
   const result = { mode: "lint", ...lint, ok: lint.ok };
@@ -13249,9 +13913,9 @@ function done(opts, result) {
 }
 
 // src/lib/mad/mad.ts
-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";
+import { mkdir as mkdir13, writeFile as writeFile12 } from "node:fs/promises";
+import { existsSync as existsSync25, statSync as statSync3 } from "node:fs";
+import { resolve as resolve13, join as join29 } from "node:path";
 
 // src/lib/convert/types.ts
 function num2(v, d = 0) {
@@ -14030,19 +14694,19 @@ 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 { readdirSync as readdirSync3, statSync as statSync2 } from "node:fs";
+import { extname as extname7, join as join26 } from "node:path";
 var VIDEO_EXTS2 = new Set(defaultExtsFor("video") ?? []);
 function scanFolder(dirAbs, opts = {}) {
   const probe = opts.probe ?? probeGeometry;
   const warn = opts.warn ?? (() => {});
   let entries;
   try {
-    entries = readdirSync(dirAbs);
+    entries = readdirSync3(dirAbs);
   } 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) => join26(dirAbs, n)).filter((p) => {
     try {
       return statSync2(p).isFile();
     } catch {
@@ -14220,10 +14884,10 @@ 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 { existsSync as existsSync22 } from "node:fs";
-import { join as join25 } from "node:path";
+import { createHash as createHash3 } from "node:crypto";
+import { mkdir as mkdir11, readFile as readFile9, rename as rename2, rm, writeFile as writeFile11, readdir as readdir2 } from "node:fs/promises";
+import { existsSync as existsSync23 } from "node:fs";
+import { join as join27 } from "node:path";
 function madCacheDir() {
   return homeFile("mad-cache");
 }
@@ -14235,7 +14899,7 @@ function manifestUrl() {
 }
 var REQUIRED_KEYS = ["mad_pool"];
 function sha256Hex(buf) {
-  return createHash2("sha256").update(buf).digest("hex");
+  return createHash3("sha256").update(buf).digest("hex");
 }
 async function fetchWithTimeout(fetchFn, url, timeoutMs) {
   const ctrl = new AbortController;
@@ -14248,14 +14912,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))
+  if (!existsSync23(path))
     return false;
   try {
-    const buf = await readFile8(path);
+    const buf = await readFile9(path);
     return sha256Hex(buf) === sha256;
   } catch {
     return false;
@@ -14280,7 +14944,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(join27(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
       }
     }
   } catch {}
@@ -14289,7 +14953,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 = join27(cacheRoot, "manifest.json");
   let manifest = null;
   let online = false;
   try {
@@ -14304,11 +14968,11 @@ async function ensureMadData(opts, deps) {
     warn(`manifest 拉取失败（${e instanceof Error ? e.message : String(e)}），回退本地缓存`);
   }
   if (!manifest) {
-    if (!existsSync22(snapshotPath)) {
+    if (!existsSync23(snapshotPath)) {
       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,14 +14983,14 @@ async function ensureMadData(opts, deps) {
     }
   }
   const version = manifest.version;
-  const verDir = join25(cacheRoot, `v${version}`);
-  const poolPath = join25(verDir, "mad_pool.json");
+  const verDir = join27(cacheRoot, `v${version}`);
+  const poolPath = join27(verDir, "mad_pool.json");
   const poolMeta = manifest.datasets.mad_pool;
   const cacheValid = await verifyFile(poolPath, poolMeta.sha256);
   const needDownload = !!opts.refresh || !cacheValid;
   if (needDownload) {
     if (!online) {
-      if (existsSync22(poolPath)) {
+      if (existsSync23(poolPath)) {
         throw new Error("本地技法数据缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
       }
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
@@ -14350,7 +15014,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 +15025,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 { existsSync as existsSync23 } from "node:fs";
-import { join as join26 } from "node:path";
+import { mkdir as mkdir12, readFile as readFile10 } from "node:fs/promises";
+import { existsSync as existsSync24 } from "node:fs";
+import { join as join28 } from "node:path";
 function shardPath(verDir, shard) {
-  return join26(verDir, "ir", `${shard}.json.gz`);
+  return join28(verDir, "ir", `${shard}.json.gz`);
 }
 function decodeShard(gz) {
   const json = gunzipSync(gz).toString("utf8");
@@ -14382,9 +15046,9 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
     if (cached)
       return cached;
     const path = shardPath(verDir, shard);
-    if (existsSync23(path)) {
+    if (existsSync24(path)) {
       try {
-        const s2 = decodeShard(await readFile9(path));
+        const s2 = decodeShard(await readFile10(path));
         memo.set(shard, s2);
         return s2;
       } catch {
@@ -14400,7 +15064,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(join28(verDir, "ir"), { recursive: true });
     await atomicWrite(path, buf);
     memo.set(shard, s);
     return s;
@@ -14414,7 +15078,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
       return ir;
     },
     shardCached(shard) {
-      return memo.has(shard) || existsSync23(shardPath(verDir, shard));
+      return memo.has(shard) || existsSync24(shardPath(verDir, shard));
     }
   };
 }
@@ -14498,7 +15162,7 @@ async function runMad(inputArg, opts, deps = {}) {
   if (!inputArg)
     throw new Error("用法：gtrk tool mad <素材文件夹> [--bgm 歌.mp3]");
   const dirAbs = resolve13(inputArg);
-  if (!existsSync24(dirAbs) || !statSync3(dirAbs).isDirectory()) {
+  if (!existsSync25(dirAbs) || !statSync3(dirAbs).isDirectory()) {
     throw new Error(`素材文件夹不存在或不是目录：${dirAbs}`);
   }
   const { videos, orientation, skipped } = scanFolder(dirAbs, {
@@ -14612,10 +15276,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) : join29(process.cwd(), `mad-${timestamp4(now)}`);
   await mkdir13(outDir, { recursive: true });
-  const jsxPath = join27(outDir, "mad.jsx");
-  await writeFile11(jsxPath, jsx);
+  const jsxPath = join29(outDir, "mad.jsx");
+  await writeFile12(jsxPath, jsx);
   const result = {
     ok: true,
     tool: "mad",
@@ -14626,7 +15290,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(join29(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
   warn(completionMessage(jsxPath, level));
   return result;
 }
@@ -14759,9 +15423,9 @@ 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 { existsSync as existsSync26 } from "node:fs";
+import { mkdir as mkdir14, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile13 } from "node:fs/promises";
+import { basename as basename15, dirname as dirname13, extname as extname8, join as join30, resolve as resolve14 } from "node:path";
 
 // src/lib/transcript.ts
 var AGENT_SUMMARY_PENDING = "<!-- gtrk:agent-summary-pending -->";
@@ -14898,7 +15562,7 @@ async function validateTranscriptInput(input) {
     throw new Error("视频转文字稿仅支持本地视频文件，不支持 URL、平台视频地址或远端下载");
   }
   const inputAbs = resolve14(input);
-  if (!existsSync25(inputAbs))
+  if (!existsSync26(inputAbs))
     throw new Error(`本地视频不存在：${inputAbs}`);
   const info = await stat6(inputAbs);
   if (!info.isFile())
@@ -14910,17 +15574,17 @@ async function validateTranscriptInput(input) {
   return inputAbs;
 }
 function resolveTranscriptOutput(inputAbs, out) {
-  const base = basename14(inputAbs, extname8(inputAbs));
-  const output = out ? resolve14(out) : join28(dirname11(inputAbs), `${base}-transcript.md`);
+  const base = basename15(inputAbs, extname8(inputAbs));
+  const output = out ? resolve14(out) : join30(dirname13(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(dirname13(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 });
@@ -14933,8 +15597,8 @@ async function runTranscript(input, opts = {}, depsOverride) {
   const output = resolveTranscriptOutput(inputAbs, opts.out);
   const deps = buildDeps(depsOverride);
   const language = opts.lang?.trim() || "zh-CN";
-  const sourceName = basename14(inputAbs);
-  const title = basename14(inputAbs, extname8(inputAbs));
+  const sourceName = basename15(inputAbs);
+  const title = basename15(inputAbs, extname8(inputAbs));
   log.step(`▶ 视频转文字稿：${sourceName}`);
   log.step("① 本地探测视频…");
   const geometry = deps.probe(inputAbs, opts.ffmpegPath);
@@ -14946,7 +15610,7 @@ async function runTranscript(input, opts = {}, depsOverride) {
   log.step("② 本地抽取 16k 单声道音频（原视频不上传）…");
   const audio = await deps.extract(inputAbs, opts.ffmpegPath);
   deps.assertDuration(geometry.duration, audio, opts.ffmpegPath);
-  log.info(`上传物：${basename14(audio)}（仅音频衍生物）`);
+  log.info(`上传物：${basename15(audio)}（仅音频衍生物）`);
   log.step("③ 上传音频并提交 ASR…");
   const payload = (fileId) => ({ file_id: fileId, language, word_level: true });
   const submitted = await uploadAndSubmitTask(deps.cfg, audio, TASK_TYPE4, payload, {
@@ -14994,9 +15658,9 @@ 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 { existsSync as existsSync26 } from "node:fs";
+import { resolve as resolve15, join as join31, dirname as dirname14, basename as basename16, extname as extname9 } from "node:path";
+import { mkdir as mkdir15, writeFile as writeFile14 } from "node:fs/promises";
+import { existsSync as existsSync27 } from "node:fs";
 var TASK_TYPE5 = "music_visualizer";
 var PRICE_KEY2 = "music_visualizer";
 var HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
@@ -15044,7 +15708,7 @@ function timestamp5() {
   return `${p(d.getFullYear() % 100)}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
 }
 function assertExt(pathAbs, exts, label) {
-  if (!existsSync26(pathAbs))
+  if (!existsSync27(pathAbs))
     throw new Error(`${label}不存在：${pathAbs}`);
   const e = extname9(pathAbs).toLowerCase();
   if (exts.length && !exts.includes(e)) {
@@ -15113,9 +15777,9 @@ async function runMusicVisualizer(audio, opts) {
   if (coverAbs)
     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()}`));
-  log.step(`▶ 音乐可视化：${basename15(audioAbs)}（模板 ${template}${bgAbs ? " · 背景" : ""}${coverAbs ? " · 封面" : ""}）`);
+  const projName = basename16(audioAbs, extname9(audioAbs));
+  const outDir = resolve15(opts.out ?? join31(dirname14(audioAbs), `${projName}-visualizer-${timestamp5()}`));
+  log.step(`▶ 音乐可视化：${basename16(audioAbs)}（模板 ${template}${bgAbs ? " · 背景" : ""}${coverAbs ? " · 封面" : ""}）`);
   let billingHint;
   try {
     billingHint = (await resolveToolPricing(PRICE_KEY2)).billingHint;
@@ -15161,7 +15825,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(join31(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 +15836,7 @@ async function runMusicVisualizer(audio, opts) {
   const files = [];
   const errors = {};
   if (url) {
-    const dest = join29(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
+    const dest = join31(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
     try {
       await downloadStream(url, dest);
       files.push(dest);
@@ -15194,7 +15858,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(join31(outDir, "result.json"), JSON.stringify(resultJson, null, 2));
   if (opts.json) {
     process.stdout.write(`${JSON.stringify(resultJson)}
 `);
@@ -15207,12 +15871,121 @@ async function runMusicVisualizer(audio, opts) {
   log.ok(`完成。产物目录：${outDir}`);
 }
 
+// src/commands/deps.ts
+import { existsSync as existsSync28, readdirSync as readdirSync4, statSync as statSync4 } from "node:fs";
+import { join as join32 } from "node:path";
+function registerDeps(program2) {
+  const deps = program2.command("deps").description("运行时资产：查看状态 / 显式安装 ffmpeg 与渲染字体");
+  deps.command("status").description("查看 ffmpeg / 字体的当前来源、版本与授权信息").option("--ffmpeg-path <dir>", "显式 ffmpeg/ffprobe 目录").action(async (opts) => {
+    await runStatus2(opts.ffmpegPath);
+  });
+  deps.command("install").description("从同合云镜像安装运行时资产（已存在则跳过）").option("--ffmpeg", "只装 ffmpeg/ffprobe").option("--font", "只装渲染字体").option("--force", "已存在也覆盖重装").action(async (opts) => {
+    await runInstall(opts);
+  });
+}
+function fmtMB(n) {
+  return `${(n / 1048576).toFixed(1)} MB`;
+}
+async function runStatus2(ffmpegPath) {
+  log.step("① ffmpeg / ffprobe");
+  const res = resolveFfmpeg(ffmpegPath);
+  if (res) {
+    log.ok(`来源：${res.source}`);
+    try {
+      const cap = probeCapabilities(res);
+      log.info(cap.version);
+      log.info(`libx264 ${cap.hasLibx264 ? "✅" : "❌"}   ass 滤镜 ${cap.filters.has("ass") ? "✅" : "❌"}`);
+    } catch {
+      log.warn("二进制存在但探测能力失败");
+    }
+  } else {
+    log.warn(`未找到。装它：gtrk deps install --ffmpeg`);
+  }
+  log.step("② 渲染字体");
+  const fdir = fontsDir();
+  const fonts = existsSync28(fdir) ? readdirSync4(fdir).filter((f) => /\.(otf|ttf|ttc|otc)$/i.test(f)) : [];
+  if (fonts.length) {
+    log.ok(`${fdir}（${fonts.length} 个）`);
+    for (const f of fonts)
+      log.info(`${f}  ${fmtMB(statSync4(join32(fdir, f)).size)}`);
+    log.info("经 ass 滤镜 fontsdir 供给 libass，未安装进系统字体表");
+  } else {
+    log.warn(`${fdir} 无字体。装它：gtrk deps install --font`);
+    log.info("（系统已装所需字体时也可直接用，两处任一命中即可）");
+  }
+  log.step("③ 分发物授权与源码");
+  let m = null;
+  try {
+    m = await fetchManifest();
+  } catch (e) {
+    log.warn(`取 manifest 失败：${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (m) {
+    let key = "";
+    try {
+      key = resolvePlatformKey();
+    } catch {}
+    for (const [k, v] of Object.entries(m.ffmpeg)) {
+      const mark = k === key ? "→" : " ";
+      log.info(`${mark} ${k.padEnd(10)} ${v.version.padEnd(20)} ${v.license}  源码 ${v.source}`);
+    }
+    for (const [name, v] of Object.entries(m.font)) {
+      log.info(`  字体 ${name}  ${v.license}`);
+    }
+    log.info(`合规说明：${m.base}/SOURCE.md`);
+    log.info("分发不附加任何使用限制（不限 gtrk 用户、不禁转发）");
+  }
+}
+async function runInstall(opts) {
+  const doFfmpeg = opts.ffmpeg || !opts.font;
+  const doFont = opts.font || !opts.ffmpeg;
+  log.step(`读 manifest：${MANIFEST_URL}`);
+  const m = await fetchManifest();
+  log.info(`schema ${m.schema}，生成于 ${m.generated}`);
+  let lastPct = -1;
+  let lastAt = 0;
+  const onProgress = (got, total) => {
+    if (total <= 0)
+      return;
+    const pct = Math.floor(got / total * 100);
+    const now = Date.now();
+    if (pct < 100 && pct - lastPct < 5 && now - lastAt < 2000)
+      return;
+    lastPct = pct;
+    lastAt = now;
+    log.tick(`下载 ${fmtMB(got)} / ${fmtMB(total)}（${pct}%）`);
+  };
+  if (doFfmpeg) {
+    const key = resolvePlatformKey();
+    log.step(`① ffmpeg（${key}）`);
+    const r = await installFfmpeg(m, { force: opts.force, onProgress });
+    log.tickEnd();
+    if (r.installed)
+      log.ok(`已安装 ${r.detail}`);
+    else
+      log.info(`跳过（${r.reason}）：${r.detail}`);
+  }
+  if (doFont) {
+    log.step("② 渲染字体");
+    const rs = await installFont(m, { force: opts.force, onProgress });
+    log.tickEnd();
+    for (const r of rs) {
+      if (r.installed)
+        log.ok(`已安装 ${r.detail}`);
+      else
+        log.info(`跳过（${r.reason}）：${r.detail}`);
+    }
+    log.info("未写系统字体表、未改注册表——烧录时经 ass 滤镜 fontsdir 供给");
+  }
+  log.ok(`完成。二进制在 ${ffmpegDir()}，字体在 ${fontsDir()}`);
+}
+
 // src/index.ts
 try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync6(join30(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync6(join33(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);
@@ -15230,6 +16003,7 @@ registerMg(program2);
 registerTool(program2);
 registerTranscript(program2);
 registerMusicVisualizer(program2);
+registerDeps(program2);
 program2.parseAsync(process.argv).catch((e) => {
   console.error(`
 ❌ ${e instanceof Error ? e.message : String(e)}`);