@gitruck/cli 0.2.23 → 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 join31 } 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",
@@ -6870,9 +7063,151 @@ async function probeFontAvailable(font, ffmpegPath) {
     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);
-  const filterPath = assAbs.replace(/\\/g, "/").replace(/:/g, "\\:");
+  let filter = `ass='${assFilterPath(assAbs)}'`;
+  if (hasLocalFonts())
+    filter += `:fontsdir='${assFilterPath(fontsDir())}'`;
   await runFfmpeg(ffmpeg, [
     "-y",
     "-v",
@@ -6880,7 +7215,7 @@ async function burnSubtitle(videoAbs, assAbs, outAbs, opts = {}) {
     "-i",
     videoAbs,
     "-vf",
-    `ass='${filterPath}'`,
+    filter,
     "-c:v",
     opts.codec ?? "libx264",
     "-crf",
@@ -6895,16 +7230,26 @@ async function burnSubtitle(videoAbs, assAbs, outAbs, opts = {}) {
   ]);
   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;
@@ -7062,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;
   }
@@ -7076,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"];
@@ -7114,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;
 }
@@ -7126,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,
@@ -7148,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);
@@ -7166,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}`);
@@ -7190,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,
@@ -7212,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)
@@ -7280,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）`);
     }
@@ -7305,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 = {
@@ -7352,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)}%` : ""}`);
@@ -7376,9 +7721,9 @@ async function runOralCut(input, opts) {
 }
 
 // src/commands/long2short.ts
-import { resolve as resolve6, join as join18, dirname as dirname6, basename as basename8, extname as extname5 } from "node:path";
+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 existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 
 // src/lib/clip-brief.ts
 var str = (v) => {
@@ -7609,11 +7954,11 @@ function renderProReport(clips, report, ctx) {
 }
 
 // src/lib/tool-runner.ts
-import { resolve as resolve5, join as join17, dirname as dirname5, basename as basename7, extname as extname4 } from "node:path";
+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, existsSync as existsSync15 } from "node:fs";
+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";
@@ -7697,7 +8042,7 @@ async function resolveToolPricing(priceKey, pricingContext, fetchFn = fetch) {
 // src/lib/tool-descriptors.ts
 import { readFileSync as readFileSync4 } from "node:fs";
 import { readFile as readFile5, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname4, extname as extname3, join as join16, resolve as resolvePath } from "node:path";
+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"];
@@ -8719,13 +9064,14 @@ var videoAiSubtitle = {
     const fonts = assFontNames(await readFile5(ass, "utf8"));
     const missing = [];
     for (const f of fonts) {
-      if (await probeFontAvailable(f, ctx.ffmpegPath) === false)
+      if (!await fontUsableForBurn(f, ctx.ffmpegPath))
         missing.push(f);
     }
     if (missing.length) {
-      throw new Error(`本机缺字幕模板所需字体：${missing.join("、")}。` + `装上后重跑即可（字幕文件已落地，无需重新提交任务）。CLI 不自带字体、也不用替代字体顶——` + `替代字体烧出来的成片观感与模板设计不符且难以察觉。`);
+      throw new Error(`本机缺字幕模板所需字体：${missing.join("、")}。` + `装它：gtrk deps install --font（落 ~/.gitruck/fonts，不写系统字体表）。
+` + `  装上后重跑即可（字幕文件已落地，无需重新提交任务）。不用替代字体顶——` + `替代字体烧出来的成片观感与模板设计不符且难以察觉。`);
     }
-    const out = join16(dirname4(ass), `${ctx.baseName}-subtitled.mp4`);
+    const out = join17(dirname5(ass), `${ctx.baseName}-subtitled.mp4`);
     await burnSubtitle(inputAbs, ass, out, { ffmpegPath: ctx.ffmpegPath });
     return [out];
   },
@@ -8827,7 +9173,7 @@ var videoLong2ShortPro = {
       return;
     const mp4s = landed.filter((p) => p.toLowerCase().endsWith(".mp4"));
     const byIndex = clips.map((_c, i) => mp4s.find((p) => new RegExp(`clip${i}.[a-z0-9]+$`, "i").test(p)));
-    const dest = join16(dirname4(landed[0] ?? "."), "clips.md");
+    const dest = join17(dirname5(landed[0] ?? "."), "clips.md");
     await writeFile6(dest, renderProReport(clips, out.report ?? {}, {
       source: ctx.inputAbs ?? ctx.baseName,
       clipFiles: byIndex
@@ -9227,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;
@@ -9244,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(" ")}）`);
       }
     }
   }
@@ -9268,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;
@@ -9348,10 +9694,10 @@ function resolveOutDir(descriptor, inputAbs, out) {
   if (out)
     return resolve5(out);
   if (inputAbs) {
-    const base = basename7(inputAbs, extname4(inputAbs));
-    return join17(dirname5(inputAbs), `${base}-${descriptor.name}`);
+    const base = basename8(inputAbs, extname4(inputAbs));
+    return join18(dirname6(inputAbs), `${base}-${descriptor.name}`);
   }
-  return join17(process.cwd(), `${descriptor.name}-${timestamp2()}`);
+  return join18(process.cwd(), `${descriptor.name}-${timestamp2()}`);
 }
 async function safeFingerprint(inputAbs) {
   try {
@@ -9369,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 {
@@ -9440,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 writeFile7(join17(outDir, "task.json"), JSON.stringify({
+  await writeFile7(join18(outDir, "task.json"), JSON.stringify({
     tool: descriptor.name,
     taskType,
     taskId,
@@ -9462,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 = join17(outDir, it.filename);
+    const dest = join18(outDir, it.filename);
     try {
       await deps.downloadStream(it.url, dest);
       files.push(dest);
@@ -9482,7 +9828,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   let resultFile;
   const structured = descriptor.mapResult ? descriptor.mapResult(outputResult, ctx) : undefined;
   if (structured != null) {
-    resultFile = join17(outDir, "result-output.json");
+    resultFile = join18(outDir, "result-output.json");
     await writeFile7(resultFile, JSON.stringify(structured, null, 2));
   }
   if (items.length === 0 && resultFile == null) {
@@ -9501,7 +9847,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     ...resultFile ? { resultFile } : {},
     ...Object.keys(errors).length ? { errors } : {}
   };
-  await writeFile7(join17(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;
 }
 
@@ -9558,8 +9904,8 @@ async function copyClipDraftsToRoot(clipDirs, draftTarget, errors) {
   let complete = 0;
   let attempted = 0;
   for (const [i, dir] of clipDirs.entries()) {
-    const src = join18(dir, "jianying");
-    if (!existsSync16(src)) {
+    const src = join19(dir, "jianying");
+    if (!existsSync17(src)) {
       paths.push(null);
       continue;
     }
@@ -9591,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 ?? join18(dirname6(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);
@@ -9608,14 +9954,14 @@ async function runLong2Short(input, opts) {
     else
       log.warn("没找到剪映草稿目录 → 将只产 draft_content.json、缺 meta。可加 --jianying-draft-dir <你的草稿目录> 重跑。");
   }
-  const draftTarget = draftRoot ? join18(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), {
@@ -9629,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 writeFile8(join18(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,
@@ -9652,14 +9998,14 @@ async function runLong2Short(input, opts) {
         continue;
       }
       if (!/^(?:[A-Za-z]:[\\/]|[\\/])/.test(dest))
-        dest = join18(dirname6(inputAbs), dest);
+        dest = join19(dirname7(inputAbs), dest);
       try {
-        await mkdir7(dirname6(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)
@@ -9668,7 +10014,7 @@ async function runLong2Short(input, opts) {
   log.step(`⑥ 逐 clip 拉回三方工程（共 ${clips.length} 条）…`);
   const clipResults = [];
   for (const [i, clip] of clips.entries()) {
-    const clipDir = join18(outDir, `clip${i}`);
+    const clipDir = join19(outDir, `clip${i}`);
     const { files: clipFiles, ...clipMeta } = clip;
     try {
       const r = await materializeResult({
@@ -9709,13 +10055,13 @@ async function runLong2Short(input, opts) {
   for (const [i, cr] of clipResults.entries()) {
     try {
       await mkdir7(cr.dir, { recursive: true });
-      await writeFile8(join18(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 writeFile8(join18(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 },
@@ -9725,7 +10071,7 @@ async function runLong2Short(input, opts) {
   } catch (e) {
     errors["clips.md"] = e instanceof Error ? e.message : String(e);
   }
-  await writeFile8(join18(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,
@@ -9736,10 +10082,10 @@ async function runLong2Short(input, opts) {
     outDir,
     clips: clipResults,
     splitMaterials: { landed: splitLanded, total: manifest.length },
-    reportFile: join18(outDir, "report.json"),
+    reportFile: join19(outDir, "report.json"),
     ...Object.keys(errors).length ? { errors } : {}
   };
-  await writeFile8(join18(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) {
@@ -9755,7 +10101,7 @@ async function runLong2Short(input, opts) {
 }
 
 // src/commands/oralcut-result.ts
-import { resolve as resolve7, join as join19 } 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;
@@ -9789,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 ?? join19(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,
@@ -9807,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) {
@@ -9849,17 +10195,17 @@ function registerUpgrade(program2) {
 }
 
 // src/commands/render.ts
-import { resolve as resolve8, dirname as dirname7, join as join20, basename as basename9, extname as extname6 } from "node:path";
-import { existsSync as existsSync17 } from "node:fs";
+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 ?? join20(dirname7(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,
@@ -9874,7 +10220,7 @@ function registerRender(program2) {
     log.tickEnd();
     log.ok(`渲染完成：${outMp4}（${result.duration.toFixed(1)}s）`);
     if (opts.open)
-      openFolder(dirname7(outMp4));
+      openFolder(dirname8(outMp4));
     if (opts.json) {
       console.log(JSON.stringify({ ok: true, output: outMp4, duration: result.duration }));
     }
@@ -9882,14 +10228,14 @@ function registerRender(program2) {
 }
 
 // src/commands/split.ts
-import { resolve as resolve9, join as join22, dirname as dirname9, basename as basename11 } from "node:path";
-import { existsSync as existsSync18 } from "node:fs";
+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 } from "node:crypto";
+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 dirname8, join as join21, 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");
@@ -9916,10 +10262,10 @@ function writeStructMetaSplit(path, gtrk, splitObj, expectedMtimeMs) {
   }
   const nextStructMeta = { ...gtrk.struct_meta ?? {}, split: splitObj };
   const next = { ...gtrk, struct_meta: nextStructMeta };
-  const tmp = join21(dirname8(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);
@@ -9932,10 +10278,10 @@ function writeGtrkAtomic(path, next, expectedMtimeMs) {
   if (cur !== expectedMtimeMs) {
     throw new Error("工程文件在 matrix 运行期间被外部修改（保存冲突），已拒绝写入；请关闭客户端未保存的工程或重跑（plan 与已下载代理均保留）");
   }
-  const tmp = join21(dirname8(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);
@@ -9952,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;
@@ -9960,22 +10306,22 @@ function resolvePaths(opts) {
   if (opts.gtrk) {
     gtrkPath = resolve9(opts.gtrk);
   } else if (project) {
-    gtrkPath = firstExisting([join22(project, "gtrk", "project.gtrk"), join22(project, "project.gtrk")]) ?? join22(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([
-      join22(project, "transcript", "transcript.json"),
-      join22(project, "json", "transcript.json"),
-      join22(project, "transcript.json")
+      join23(project, "transcript", "transcript.json"),
+      join23(project, "json", "transcript.json"),
+      join23(project, "transcript.json")
     ]);
-  const baseDir = project ?? dirname9(gtrkPath);
+  const baseDir = project ?? dirname10(gtrkPath);
   return { baseDir, gtrkPath, transcriptPath };
 }
 function slugify2(name) {
@@ -9987,7 +10333,7 @@ async function loadTranscript(path) {
   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;
 }
@@ -9998,15 +10344,15 @@ 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 = join22(baseDir, "split");
+  const splitDir = join23(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const viewPath = join22(splitDir, "view.json");
+  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} 条被剪）`);
@@ -10024,9 +10370,9 @@ 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 readFile6(splitdocPath, "utf8"));
@@ -10052,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,
@@ -10063,13 +10409,13 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
     }
   });
   writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
-  const splitDir = join22(baseDir, "split");
+  const splitDir = join23(baseDir, "split");
   await mkdir8(splitDir, { recursive: true });
-  const dispatchPath = join22(splitDir, "dispatch.json");
+  const dispatchPath = join23(splitDir, "dispatch.json");
   await writeFile9(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
   let mdPath = null;
   if (opts.md) {
-    mdPath = join22(splitDir, "visual-split.md");
+    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}）`);
@@ -10101,8 +10447,8 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
 }
 
 // src/commands/matrix.ts
-import { resolve as resolve11, join as join23, dirname as dirname10, basename as basename12 } from "node:path";
-import { existsSync as existsSync20 } from "node:fs";
+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
@@ -10839,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;
@@ -10900,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 };
@@ -11243,14 +11589,14 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   let baseDir;
   if (opts.dispatch) {
     dispatchPath = resolve11(opts.dispatch);
-    baseDir = dirname10(dirname10(dispatchPath));
+    baseDir = dirname11(dirname11(dispatchPath));
   } else if (opts.project) {
     baseDir = resolve11(opts.project);
-    dispatchPath = join23(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 readFile7(dispatchPath, "utf8"));
   const rawQueue = Array.isArray(dispatch.film_broll) ? dispatch.film_broll : [];
@@ -11307,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,
@@ -11315,9 +11661,9 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     columnId,
     beats
   });
-  const splitDir = join23(baseDir, "split");
+  const splitDir = join24(baseDir, "split");
   await mkdir9(splitDir, { recursive: true });
-  const planPath = join23(splitDir, "broll-plan.json");
+  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 过期，过期重跑本命令即重签。");
@@ -11365,13 +11711,13 @@ function parseScoreFloor(raw) {
   return SCORE_FLOOR_DEFAULT;
 }
 function locateGtrk(baseDir) {
-  const cands = [join23(baseDir, "gtrk", "project.gtrk"), join23(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(`未找到工程文件（${join23(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
+    log.warn(`未找到工程文件（${join24(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
     return;
   }
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
@@ -11379,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 = dirname10(gtrkPath);
-  const previewDir = join23(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;
@@ -11403,8 +11749,8 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     if (!cand)
       continue;
     const rel = `${BROLL_PREVIEW_DIR}/${clipId}.mp4`;
-    const abs = join23(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" });
@@ -11466,10 +11812,10 @@ 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 = join23(gtrkDir, ...rel.split("/"));
+    const abs = join24(gtrkDir, ...rel.split("/"));
     try {
-      if (!existsSync20(abs)) {
-        await mkdir9(dirname10(abs), { recursive: true });
+      if (!existsSync21(abs)) {
+        await mkdir9(dirname11(abs), { recursive: true });
         const tmp = `${abs}.tmp-${process.pid}`;
         await writeFile10(tmp, encodeSolidPng(spec));
         await rename(tmp, abs);
@@ -11584,8 +11930,8 @@ function slugify3(name) {
 }
 
 // src/commands/mg.ts
-import { resolve as resolve12, join as join24, dirname as dirname11, basename as basename13 } from "node:path";
-import { existsSync as existsSync21 } from "node:fs";
+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
@@ -13247,27 +13593,27 @@ async function runMg(words, opts) {
 function resolveDispatch(opts) {
   if (opts.dispatch) {
     const dispatchPath = resolve12(opts.dispatch);
-    return { dispatchPath, baseDir: dirname11(dirname11(dispatchPath)) };
+    return { dispatchPath, baseDir: dirname12(dirname12(dispatchPath)) };
   }
   if (opts.project) {
     const baseDir = resolve12(opts.project);
-    return { dispatchPath: join24(baseDir, "split", "dispatch.json"), baseDir };
+    return { dispatchPath: join25(baseDir, "split", "dispatch.json"), baseDir };
   }
   throw new Error("需 --project <目录> 或显式 --dispatch <path>");
 }
 function locateGtrk2(baseDir) {
-  return [join24(baseDir, "gtrk", "project.gtrk"), join24(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 = join24(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 readFile8(dispatchPath, "utf8"));
   const queue = dispatch.mg ?? dispatch.rrv_mg;
@@ -13343,7 +13689,7 @@ async function runLay(opts) {
     const srcPath = locateSrcHtml(baseDir, q.composition_id);
     if (!srcPath) {
       skipped.push({ beat: q.beat, reason: "缺颗粒 HTML（未产出）" });
-      log.warn(`${q.beat}：缺 ${join24(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 readFile8(srcPath, "utf8");
@@ -13391,7 +13737,7 @@ async function runLay(opts) {
     });
   }
   if (!gtrkPath || !project) {
-    log.warn(`未找到工程文件（${join24(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
+    log.warn(`未找到工程文件（${join25(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
     return done(opts, {
       ok: skipped.length === 0,
       mode: "lay",
@@ -13408,7 +13754,7 @@ async function runLay(opts) {
     });
   }
   const { gtrk, mtimeMs } = project;
-  const gtrkDir = dirname11(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));
@@ -13450,9 +13796,9 @@ async function runLay(opts) {
   if (opts.replaceAll && orphans.length > 0) {
     log.warn(`--replace-all：已显式授权重置整轨，轨上其余 ${orphans.length} 颗已铺颗粒将被剥离（不走增量保留）。`);
   }
-  await mkdir10(join24(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), join24(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);
@@ -13497,11 +13843,11 @@ async function runLint(args, opts) {
   if (!file)
     throw new Error("用法：gtrk mg lint <particle.html> [--dispatch <path>]");
   const html = await readFile8(resolve12(file), "utf8");
-  const nameId = basename13(file).replace(/\.html?$/i, "");
+  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);
@@ -13525,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 };
@@ -13568,8 +13914,8 @@ function done(opts, result) {
 
 // src/lib/mad/mad.ts
 import { mkdir as mkdir13, writeFile as writeFile12 } from "node:fs/promises";
-import { existsSync as existsSync24, statSync as statSync3 } from "node:fs";
-import { resolve as resolve13, join as join28 } from "node:path";
+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) {
@@ -14348,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 join25 } 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) => join25(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 {
@@ -14538,10 +14884,10 @@ function beatQuantized(natLens, analysis) {
 }
 
 // src/lib/mad/data.ts
-import { createHash as createHash2 } from "node:crypto";
+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 existsSync22 } from "node:fs";
-import { join as join26 } from "node:path";
+import { existsSync as existsSync23 } from "node:fs";
+import { join as join27 } from "node:path";
 function madCacheDir() {
   return homeFile("mad-cache");
 }
@@ -14553,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;
@@ -14570,7 +14916,7 @@ async function atomicWrite(dest, data) {
   await rename2(tmp, dest);
 }
 async function verifyFile(path, sha256) {
-  if (!existsSync22(path))
+  if (!existsSync23(path))
     return false;
   try {
     const buf = await readFile9(path);
@@ -14598,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(join26(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
+        await rm(join27(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
       }
     }
   } catch {}
@@ -14607,7 +14953,7 @@ async function ensureMadData(opts, deps) {
   const { cacheRoot, warn } = deps;
   const timeout = deps.manifestTimeoutMs ?? 8000;
   const mfUrl = deps.manifestUrl ?? manifestUrl();
-  const snapshotPath = join26(cacheRoot, "manifest.json");
+  const snapshotPath = join27(cacheRoot, "manifest.json");
   let manifest = null;
   let online = false;
   try {
@@ -14622,7 +14968,7 @@ 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 {
@@ -14637,14 +14983,14 @@ async function ensureMadData(opts, deps) {
     }
   }
   const version = manifest.version;
-  const verDir = join26(cacheRoot, `v${version}`);
-  const poolPath = join26(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`（数据会缓存到本地，之后可离线出片）。");
@@ -14680,10 +15026,10 @@ async function ensureMadData(opts, deps) {
 // src/lib/mad/pool.ts
 import { gunzipSync } from "node:zlib";
 import { mkdir as mkdir12, readFile as readFile10 } from "node:fs/promises";
-import { existsSync as existsSync23 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync24 } from "node:fs";
+import { join as join28 } from "node:path";
 function shardPath(verDir, shard) {
-  return join27(verDir, "ir", `${shard}.json.gz`);
+  return join28(verDir, "ir", `${shard}.json.gz`);
 }
 function decodeShard(gz) {
   const json = gunzipSync(gz).toString("utf8");
@@ -14700,7 +15046,7 @@ 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 readFile10(path));
         memo.set(shard, s2);
@@ -14718,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(join27(verDir, "ir"), { recursive: true });
+    await mkdir12(join28(verDir, "ir"), { recursive: true });
     await atomicWrite(path, buf);
     memo.set(shard, s);
     return s;
@@ -14732,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));
     }
   };
 }
@@ -14816,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, {
@@ -14930,9 +15276,9 @@ 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) : join28(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 = join28(outDir, "mad.jsx");
+  const jsxPath = join29(outDir, "mad.jsx");
   await writeFile12(jsxPath, jsx);
   const result = {
     ok: true,
@@ -14944,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 writeFile12(join28(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;
 }
@@ -15077,9 +15423,9 @@ async function runMadInTool(inputArg, opts) {
 }
 
 // src/commands/transcript.ts
-import { existsSync as existsSync25 } from "node:fs";
+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 basename14, dirname as dirname12, extname as extname8, join as join29, resolve as resolve14 } from "node:path";
+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 -->";
@@ -15216,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())
@@ -15228,14 +15574,14 @@ async function validateTranscriptInput(input) {
   return inputAbs;
 }
 function resolveTranscriptOutput(inputAbs, out) {
-  const base = basename14(inputAbs, extname8(inputAbs));
-  const output = out ? resolve14(out) : join29(dirname12(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(dirname12(path), { recursive: true });
+  await mkdir14(dirname13(path), { recursive: true });
   const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
   try {
     await writeFile13(temp, markdown, "utf8");
@@ -15251,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);
@@ -15264,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, {
@@ -15312,9 +15658,9 @@ function registerTranscript(program2) {
 }
 
 // src/commands/music-visualizer.ts
-import { resolve as resolve15, join as join30, dirname as dirname13, basename as basename15, extname as extname9 } from "node:path";
+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 existsSync26 } from "node:fs";
+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})$/;
@@ -15362,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)) {
@@ -15431,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 ?? join30(dirname13(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;
@@ -15479,7 +15825,7 @@ async function runMusicVisualizer(audio, opts) {
   const { taskId } = submitted;
   log.info(`task_id = ${taskId}`);
   await mkdir15(outDir, { recursive: true });
-  await writeFile14(join30(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)}%` : ""}`);
@@ -15490,7 +15836,7 @@ async function runMusicVisualizer(audio, opts) {
   const files = [];
   const errors = {};
   if (url) {
-    const dest = join30(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
+    const dest = join31(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
     try {
       await downloadStream(url, dest);
       files.push(dest);
@@ -15512,7 +15858,7 @@ async function runMusicVisualizer(audio, opts) {
     ...Object.keys(errors).length ? { errors } : {},
     finishedAt: new Date().toISOString()
   };
-  await writeFile14(join30(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)}
 `);
@@ -15525,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(join31(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);
@@ -15548,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)}`);