@gitruck/cli 0.2.13 → 0.2.15

package/dist/index.js

@@ -4197,7 +4197,7 @@ var {
 
 // src/index.ts
 import { readFileSync as readFileSync5 } from "node:fs";
-import { join as join28 } from "node:path";
+import { join as join29 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -4526,8 +4526,8 @@ function registerSkills(program2) {
 }
 
 // src/commands/init.ts
-import { join as join9, resolve as resolve3 } from "node:path";
-import { existsSync as existsSync8 } from "node:fs";
+import { join as join10, resolve as resolve3 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
 
 // src/lib/user-config.ts
 import { join as join3 } from "node:path";
@@ -4686,12 +4686,463 @@ async function promptConfirm(message, defaultYes = true) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { join as join9 } from "node:path";
 
 // src/lib/column-config.ts
-import { join as join5 } from "node:path";
-import { existsSync as existsSync5, readFileSync as readFileSync2 } from "node:fs";
+import { join as join6 } from "node:path";
+import { existsSync as existsSync6, readFileSync as readFileSync2 } from "node:fs";
+
+// src/lib/reproject.ts
+import { existsSync as existsSync5 } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, join as join5 } from "node:path";
+
+// src/lib/projection.ts
+function r3(n) {
+  return Math.round(n * 1000) / 1000;
+}
+function normClip(c3) {
+  const clip_st = c3.clip_st ?? 0;
+  const track_st = c3.track_st ?? 0;
+  const dur = c3.duration ?? (c3.clip_ed != null ? c3.clip_ed - clip_st : 0);
+  const clip_ed = c3.clip_ed ?? clip_st + dur;
+  return { clip_st, clip_ed, track_st };
+}
+function pickMainVideoTrack(gtrk) {
+  const tracks = gtrk.video_track ?? [];
+  if (!tracks.length)
+    return;
+  let best = tracks[0];
+  let bestIdx = best.track_index ?? 0;
+  for (const t of tracks) {
+    const idx = t.track_index ?? 0;
+    if (idx < bestIdx) {
+      best = t;
+      bestIdx = idx;
+    }
+  }
+  return best;
+}
+function countMainTrackMaterialClips(gtrk, materialId) {
+  const id = String(materialId);
+  const mainTrack = pickMainVideoTrack(gtrk);
+  return (mainTrack?.track_timeline ?? []).filter((c3) => c3.material != null && String(c3.material) === id).length;
+}
+function projectTranscript(transcript, gtrk, opts = {}) {
+  const materialId = String(transcript.material_id);
+  const mainTrack = pickMainVideoTrack(gtrk);
+  const clips = (mainTrack?.track_timeline ?? []).filter((c3) => c3.material != null && String(c3.material) === materialId).map(normClip);
+  const entries = [];
+  transcript.utterances.forEach((utt, sourceIndex) => {
+    const totalWords = utt.words?.length ?? 0;
+    const instances = [];
+    for (const clip of clips) {
+      const surviving = [];
+      for (const word of utt.words ?? []) {
+        const s = Math.max(word.st, clip.clip_st);
+        const e = Math.min(word.ed, clip.clip_ed);
+        if (e > s) {
+          surviving.push({
+            w: word.w,
+            track_st: r3(clip.track_st + (s - clip.clip_st)),
+            track_ed: r3(clip.track_st + (e - clip.clip_st))
+          });
+        }
+      }
+      if (surviving.length) {
+        instances.push({
+          track_st: Math.min(...surviving.map((x) => x.track_st)),
+          track_ed: Math.max(...surviving.map((x) => x.track_ed)),
+          kept_words: surviving.length,
+          words: surviving
+        });
+      }
+    }
+    if (!instances.length) {
+      entries.push({
+        id: utt.id,
+        text: utt.text,
+        dropped: true,
+        sourceIndex,
+        instIndex: 0,
+        track_st: null,
+        track_ed: null,
+        kept_words: 0,
+        total_words: totalWords,
+        words: [],
+        sortKey: 0
+      });
+    } else {
+      instances.sort((a, b) => a.track_st - b.track_st);
+      instances.forEach((inst, instIndex) => {
+        entries.push({
+          id: utt.id,
+          text: utt.text,
+          dropped: false,
+          sourceIndex,
+          instIndex,
+          track_st: inst.track_st,
+          track_ed: inst.track_ed,
+          kept_words: inst.kept_words,
+          total_words: totalWords,
+          words: inst.words,
+          sortKey: inst.track_st
+        });
+      });
+    }
+  });
+  let maxEd = 0;
+  for (const e of entries) {
+    if (e.dropped)
+      e.sortKey = maxEd;
+    else
+      maxEd = Math.max(maxEd, e.track_ed ?? maxEd);
+  }
+  entries.sort((a, b) => a.sortKey - b.sortKey || a.sourceIndex - b.sourceIndex || a.instIndex - b.instIndex);
+  const utterances = entries.map((e) => {
+    const u = {
+      id: e.id,
+      text: e.text,
+      track_st: e.track_st,
+      track_ed: e.track_ed,
+      dropped: e.dropped,
+      kept_words: e.kept_words,
+      total_words: e.total_words
+    };
+    if (opts.words)
+      u.words = e.words;
+    return u;
+  });
+  return {
+    transcript_hash: transcript.text_hash,
+    projected_at: opts.projectedAt ?? new Date().toISOString(),
+    utterances
+  };
+}
+
+// src/lib/reproject.ts
+function buildSpanIndex(view, utteranceIds) {
+  const byId = new Map;
+  for (const id of utteranceIds)
+    byId.set(id, []);
+  for (const u of view.utterances) {
+    if (u.dropped || u.track_st == null || u.track_ed == null)
+      continue;
+    if (!byId.has(u.id))
+      byId.set(u.id, []);
+    byId.get(u.id).push({ track_st: u.track_st, track_ed: u.track_ed });
+  }
+  const idIndex = new Map;
+  utteranceIds.forEach((id, i) => idIndex.set(id, i));
+  return { utteranceIds, byId, idIndex };
+}
+function envelopeForSpan(index, span) {
+  const fromIdx = index.idIndex.get(span.from);
+  const toIdx = index.idIndex.get(span.to);
+  if (fromIdx === undefined || toIdx === undefined)
+    return { kind: "unresolved" };
+  const spanIds = index.utteranceIds.slice(fromIdx, toIdx + 1);
+  const instances = spanIds.flatMap((id) => index.byId.get(id) ?? []);
+  if (instances.length === 0)
+    return { kind: "dropped" };
+  const droppedCount = spanIds.filter((id) => (index.byId.get(id)?.length ?? 0) === 0).length;
+  return {
+    kind: "ok",
+    track_st: Math.min(...instances.map((x) => x.track_st)),
+    track_ed: Math.max(...instances.map((x) => x.track_ed)),
+    shrunk: droppedCount > 0,
+    kept: spanIds.length - droppedCount,
+    dropped: droppedCount
+  };
+}
+function transcriptCandidates(baseDir) {
+  return [
+    join5(baseDir, "transcript", "transcript.json"),
+    join5(baseDir, "json", "transcript.json"),
+    join5(baseDir, "transcript.json")
+  ];
+}
+var DEGRADE_TEXT = {
+  no_project: "定位不到工程文件（.gtrk）",
+  gtrk_unreadable: "工程文件读不出来（JSON 不可解析）",
+  project_not_v1: "工程不是 v1（重投影不介入，版本门行为不变）",
+  transcript_missing: "找不到 transcript.json",
+  transcript_unreadable: "transcript.json 读不出来或结构异常",
+  no_material_clip: "当刻主轨查不到命中口播素材（material_id）的 clip"
+};
+var ENTRY_DEGRADE_TEXT = {
+  no_span: "派单条目无 span，且 struct_meta.split 里也定位不到（老档 + 工程账本对不上）",
+  span_unresolved: "span 端点在当刻 transcript 里不存在（transcript 被换过）"
+};
+function r32(n) {
+  return Math.round(n * 1000) / 1000;
+}
+function slugify(name) {
+  const s = name.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "");
+  return s || "project";
+}
+function splitSpanIndex(gtrk) {
+  const out = new Map;
+  const split = gtrk?.struct_meta?.split;
+  for (const b of split?.beats ?? []) {
+    const span = b?.span;
+    if (typeof b?.id !== "string" || typeof span?.from !== "string" || typeof span?.to !== "string")
+      continue;
+    out.set(b.id, { from: span.from, to: span.to });
+  }
+  return out;
+}
+function beatIdForComposition(compositionId, projectSlug, knownIds) {
+  const prefix = `${projectSlug}-`;
+  const ids = [...knownIds];
+  if (compositionId.startsWith(prefix)) {
+    const stripped = compositionId.slice(prefix.length);
+    if (ids.includes(stripped))
+      return stripped;
+  }
+  let best;
+  for (const id of ids) {
+    if (!compositionId.endsWith(`-${id}`))
+      continue;
+    if (best === undefined || id.length > best.length)
+      best = id;
+  }
+  return best;
+}
+function loadTranscriptShape(raw) {
+  let t;
+  try {
+    t = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  const c3 = t;
+  if (!c3 || !Array.isArray(c3.utterances) || typeof c3.material_id !== "string")
+    return;
+  return c3;
+}
+function degradeAll(entries, reason) {
+  const outcomes = entries.map((e) => ({
+    key: e.key,
+    beat: e.beat,
+    track_st: e.track_st,
+    track_ed: e.track_ed,
+    source: "dispatch_snapshot",
+    drifted: false,
+    offset: 0,
+    shrunk: false,
+    dropped: false
+  }));
+  return {
+    summary: {
+      mode: "dispatch_snapshot",
+      degraded: true,
+      reason,
+      reason_text: DEGRADE_TEXT[reason],
+      projected_at: null,
+      total: entries.length,
+      reprojected: 0,
+      drifted: 0,
+      max_offset: 0,
+      shrunk: [],
+      dropped: [],
+      degraded_entries: []
+    },
+    entries: outcomes,
+    windows: new Map(outcomes.map((o) => [o.key, { track_st: o.track_st, track_ed: o.track_ed }]))
+  };
+}
+async function reprojectDispatchWindows(req) {
+  const { baseDir, entries } = req;
+  if (req.gtrkUnreadable)
+    return degradeAll(entries, "gtrk_unreadable");
+  if (!req.gtrk)
+    return degradeAll(entries, "no_project");
+  if (req.gtrk.version !== "v1")
+    return degradeAll(entries, "project_not_v1");
+  const transcriptPath = transcriptCandidates(baseDir).find((p) => existsSync5(p));
+  if (!transcriptPath)
+    return degradeAll(entries, "transcript_missing");
+  let transcript;
+  try {
+    transcript = loadTranscriptShape(await readFile(transcriptPath, "utf8"));
+  } catch {
+    transcript = undefined;
+  }
+  if (!transcript)
+    return degradeAll(entries, "transcript_unreadable");
+  const gtrkProject = req.gtrk;
+  if (countMainTrackMaterialClips(gtrkProject, transcript.material_id) === 0) {
+    return degradeAll(entries, "no_material_clip");
+  }
+  const projectedAt = req.now ?? new Date().toISOString();
+  const view = projectTranscript(transcript, gtrkProject, { projectedAt });
+  const index = buildSpanIndex(view, transcript.utterances.map((u) => u.id));
+  const fallback = splitSpanIndex(req.gtrk);
+  const projectSlug = slugify(basename(baseDir));
+  const outcomes = [];
+  const shrunk = [];
+  const dropped = [];
+  const degradedEntries = [];
+  let drifted = 0;
+  let maxOffset = 0;
+  let reprojected = 0;
+  for (const e of entries) {
+    let span = e.span;
+    if (!span) {
+      const bid = e.compositionId ? beatIdForComposition(e.compositionId, projectSlug, fallback.keys()) : e.beat;
+      span = bid ? fallback.get(bid) : undefined;
+    }
+    if (!span) {
+      outcomes.push({
+        key: e.key,
+        beat: e.beat,
+        track_st: e.track_st,
+        track_ed: e.track_ed,
+        source: "dispatch_snapshot",
+        drifted: false,
+        offset: 0,
+        shrunk: false,
+        dropped: false,
+        degradeReason: "no_span"
+      });
+      degradedEntries.push({ beat: e.beat, reason: "no_span", text: ENTRY_DEGRADE_TEXT.no_span });
+      continue;
+    }
+    const env = envelopeForSpan(index, span);
+    if (env.kind === "unresolved") {
+      outcomes.push({
+        key: e.key,
+        beat: e.beat,
+        track_st: e.track_st,
+        track_ed: e.track_ed,
+        source: "dispatch_snapshot",
+        drifted: false,
+        offset: 0,
+        shrunk: false,
+        dropped: false,
+        degradeReason: "span_unresolved"
+      });
+      degradedEntries.push({ beat: e.beat, reason: "span_unresolved", text: ENTRY_DEGRADE_TEXT.span_unresolved });
+      continue;
+    }
+    if (env.kind === "dropped") {
+      reprojected += 1;
+      dropped.push(e.beat);
+      outcomes.push({
+        key: e.key,
+        beat: e.beat,
+        track_st: e.track_st,
+        track_ed: e.track_ed,
+        source: "reprojected",
+        drifted: false,
+        offset: 0,
+        shrunk: false,
+        dropped: true
+      });
+      continue;
+    }
+    reprojected += 1;
+    const offset = r32(Math.max(Math.abs(env.track_st - e.track_st), Math.abs(env.track_ed - e.track_ed)));
+    const isDrifted = offset > 0;
+    if (isDrifted) {
+      drifted += 1;
+      maxOffset = Math.max(maxOffset, offset);
+    }
+    if (env.shrunk)
+      shrunk.push(e.beat);
+    outcomes.push({
+      key: e.key,
+      beat: e.beat,
+      track_st: env.track_st,
+      track_ed: env.track_ed,
+      source: "reprojected",
+      drifted: isDrifted,
+      offset,
+      shrunk: env.shrunk,
+      dropped: false
+    });
+  }
+  return {
+    summary: {
+      mode: "reprojected",
+      degraded: degradedEntries.length > 0,
+      projected_at: projectedAt,
+      total: entries.length,
+      reprojected,
+      drifted,
+      max_offset: r32(maxOffset),
+      shrunk,
+      dropped,
+      degraded_entries: degradedEntries
+    },
+    entries: outcomes,
+    windows: new Map(outcomes.map((o) => [o.key, { track_st: o.track_st, track_ed: o.track_ed }]))
+  };
+}
+function reportReprojection(reproj) {
+  const s = reproj.summary;
+  if (s.mode === "dispatch_snapshot") {
+    log.warn(reprojectSummaryLine(s));
+    log.warn(`正在用**可能已过期**的派单快照时码继续。${reprojectRecoveryHint(s.reason)}`);
+    return;
+  }
+  log.step(`▶ ${reprojectSummaryLine(s)}`);
+  for (const d of s.degraded_entries)
+    log.warn(`${d.beat}：无法重投影（${d.text}），本条回退派单快照时码`);
+  for (const b of s.shrunk)
+    log.warn(`${b}：span 内有句被剪，已按存活包络收缩（建议人工复核）`);
+  for (const b of s.dropped)
+    log.warn(`${b}：重投影后零存活（整段已被剪出成片），本条跳过——不按快照时码铺回去`);
+}
+function withTimecodeSource(next, key, reproj) {
+  const structMeta = next.struct_meta ?? {};
+  const ledger = structMeta[key];
+  if (!ledger)
+    return next;
+  return {
+    ...next,
+    struct_meta: {
+      ...structMeta,
+      [key]: {
+        ...ledger,
+        timecode_source: reproj.summary.mode === "reprojected" ? "reprojected" : "dispatch_snapshot",
+        ...reproj.summary.projected_at ? { reprojected_at: reproj.summary.projected_at } : {},
+        ...reproj.summary.reason ? { timecode_degrade_reason: reproj.summary.reason } : {}
+      }
+    }
+  };
+}
+function reprojectSummaryLine(s) {
+  if (s.mode === "dispatch_snapshot") {
+    return `重投影降级：按派单快照时码铺 ${s.total} 个条目（原因：${s.reason_text ?? s.reason}）——快照可能已过期`;
+  }
+  const bits = [`重投影 ${s.reprojected} 个 beat`, `漂移 ${s.drifted} 条`];
+  if (s.drifted > 0)
+    bits.push(`最大偏移 ${s.max_offset}s`);
+  if (s.shrunk.length)
+    bits.push(`收缩 ${s.shrunk.length} 条`);
+  if (s.dropped.length)
+    bits.push(`整段被剪跳过 ${s.dropped.length} 条`);
+  if (s.degraded_entries.length)
+    bits.push(`逐条降级 ${s.degraded_entries.length} 条`);
+  return bits.join(" · ");
+}
+function reprojectRecoveryHint(reason) {
+  switch (reason) {
+    case "transcript_missing":
+    case "transcript_unreadable":
+      return "复原：把 transcript.json 补回产物目录（transcript/ 或 json/ 下），或用新版 gtrk oralcut 重出产物后重跑本命令。";
+    case "no_project":
+    case "gtrk_unreadable":
+      return "复原：把工程放回 <产物目录>/gtrk/project.gtrk（或用 --project 指到工程所在的产物目录）后重跑本命令。";
+    case "project_not_v1":
+      return "复原：用新链路重产 v1 工程后重跑本命令。";
+    case "no_material_clip":
+      return "复原：确认口播主轨还在、且 relink 没换掉素材 id；拿另一个工程的 dispatch 来跑也会命中本情形。";
+  }
+}
 
 // src/lib/splitdoc.ts
 var BASE_TRACKS = ["真人出镜", "口播继续", "旁白主导"];
@@ -4930,22 +5381,11 @@ var CATEGORY_EXPECTED_OPAQUE = {
 function isKnownCategory(v) {
   return typeof v === "string" && Object.prototype.hasOwnProperty.call(CATEGORY_EXPECTED_OPAQUE, v);
 }
-function r3(n) {
+function r33(n) {
   return Math.round(n * 1000) / 1000;
 }
 function buildLanding(doc, view, opts) {
-  const byId = new Map;
-  for (const id of opts.utteranceIds)
-    byId.set(id, []);
-  for (const u of view.utterances) {
-    if (u.dropped || u.track_st == null || u.track_ed == null)
-      continue;
-    if (!byId.has(u.id))
-      byId.set(u.id, []);
-    byId.get(u.id).push({ track_st: u.track_st, track_ed: u.track_ed });
-  }
-  const idIndex = new Map;
-  opts.utteranceIds.forEach((id, i) => idIndex.set(id, i));
+  const spanIndex = buildSpanIndex(view, opts.utteranceIds);
   const split = {
     contract_version: doc.contract_version,
     transcript_hash: doc.transcript_hash,
@@ -4958,25 +5398,19 @@ function buildLanding(doc, view, opts) {
   const shrunk = [];
   const unhandledLanes = new Set;
   for (const beat of doc.beats) {
-    const fromIdx = idIndex.get(beat.span.from);
-    const toIdx = idIndex.get(beat.span.to);
-    const spanIds = opts.utteranceIds.slice(fromIdx, toIdx + 1);
-    const instances = spanIds.flatMap((id) => byId.get(id) ?? []);
-    const droppedCount = spanIds.filter((id) => (byId.get(id)?.length ?? 0) === 0).length;
-    if (instances.length === 0) {
+    const env = envelopeForSpan(spanIndex, beat.span);
+    if (env.kind !== "ok") {
       skipped.push({ beat: beat.id, reason: "span 内全部 utterance 被剪，未落轨" });
       continue;
     }
-    const track_st = Math.min(...instances.map((x) => x.track_st));
-    const track_ed = Math.max(...instances.map((x) => x.track_ed));
-    const isShrunk = droppedCount > 0;
+    const { track_st, track_ed, shrunk: isShrunk } = env;
     const lane = normalizeLane(beat.lane) ?? beat.lane;
     const metaBeat = { id: beat.id, lane, span: beat.span, track_st, track_ed };
     if (opts.sourceIndex) {
       const from = opts.sourceIndex.utterances.get(beat.span.from);
       const to = opts.sourceIndex.utterances.get(beat.span.to);
       if (from && to && to.ed > from.st) {
-        metaBeat.source_ranges = [{ st: r3(from.st), ed: r3(to.ed) }];
+        metaBeat.source_ranges = [{ st: r33(from.st), ed: r33(to.ed) }];
       }
     }
     if (isShrunk)
@@ -4993,7 +5427,7 @@ function buildLanding(doc, view, opts) {
       metaBeat.handoff = beat.handoff;
     split.beats.push(metaBeat);
     if (isShrunk) {
-      shrunk.push({ beat: beat.id, kept: spanIds.length - droppedCount, dropped: droppedCount, track_st, track_ed });
+      shrunk.push({ beat: beat.id, kept: env.kept, dropped: env.dropped, track_st, track_ed });
     }
     const h = beat.handoff ?? {};
     const compositionId = `${opts.projectSlug}-${beat.id}`;
@@ -5001,13 +5435,15 @@ function buildLanding(doc, view, opts) {
       dispatch.mg.push({
         beat: beat.id,
         composition_id: compositionId,
-        duration: typeof h.duration_hint === "number" ? h.duration_hint : null,
+        duration: r33(track_ed - track_st),
+        duration_hint: typeof h.duration_hint === "number" ? h.duration_hint : null,
         ...h.category !== undefined ? { category: h.category } : {},
         theme: h.theme,
         bg: h.bg,
         slug_hint: h.slug_hint,
         track_st,
-        track_ed
+        track_ed,
+        span: beat.span
       });
     } else if (lane === "FILM_BROLL") {
       dispatch.film_broll.push({
@@ -5017,10 +5453,11 @@ function buildLanding(doc, view, opts) {
         per_shot_sec: h.per_shot_sec,
         exclude: h.exclude,
         track_st,
-        track_ed
+        track_ed,
+        span: beat.span
       });
     } else if (lane === "AI_DRAMA") {
-      dispatch.ai_drama.push({ beat: beat.id, ...h, track_st, track_ed });
+      dispatch.ai_drama.push({ beat: beat.id, ...h, track_st, track_ed, span: beat.span });
     } else if (lane !== "A_ROLL") {
       unhandledLanes.add(lane);
     }
@@ -5043,33 +5480,33 @@ function buildLanding(doc, view, opts) {
         skipped.push({ beat: auxTag, reason: "overlay aux 使用 {trigger} 点挂载，一期不支持（二期补合成窗口）" });
         continue;
       }
-      const auxFromIdx = idIndex.get(auxFromId);
-      const auxToIdx = idIndex.get(auxToId);
-      const auxSpanIds = opts.utteranceIds.slice(auxFromIdx, auxToIdx + 1);
-      const auxInstances = auxSpanIds.flatMap((id) => byId.get(id) ?? []);
-      if (auxInstances.length === 0) {
+      const auxSpan = { from: auxFromId, to: auxToId };
+      const auxEnv = envelopeForSpan(spanIndex, auxSpan);
+      if (auxEnv.kind !== "ok") {
         skipped.push({ beat: auxTag, reason: "overlay aux 源区间 utterance 全被剪，未落轨" });
         continue;
       }
-      const auxTrackSt = Math.min(...auxInstances.map((x) => x.track_st));
-      const auxTrackEd = Math.max(...auxInstances.map((x) => x.track_ed));
+      const auxTrackSt = auxEnv.track_st;
+      const auxTrackEd = auxEnv.track_ed;
       const auxCompositionId = `${opts.projectSlug}-${beat.id}-aux${auxN}`;
       const ah = aux.handoff;
       dispatch.mg.push({
         beat: beat.id,
         composition_id: auxCompositionId,
-        duration: ah && typeof ah.duration_hint === "number" ? ah.duration_hint : null,
+        duration: r33(auxTrackEd - auxTrackSt),
+        duration_hint: ah && typeof ah.duration_hint === "number" ? ah.duration_hint : null,
         category: "overlay",
         theme: ah?.theme,
         bg: ah?.bg,
         slug_hint: ah?.slug_hint,
         track_st: auxTrackSt,
-        track_ed: auxTrackEd
+        track_ed: auxTrackEd,
+        span: auxSpan
       });
       const auxMetaBeat = {
         id: auxTag,
         lane: "MG",
-        span: { from: auxFromId, to: auxToId },
+        span: auxSpan,
         track_st: auxTrackSt,
         track_ed: auxTrackEd,
         category: "overlay"
@@ -5078,7 +5515,7 @@ function buildLanding(doc, view, opts) {
         const sfrom = opts.sourceIndex.utterances.get(auxFromId);
         const sto = opts.sourceIndex.utterances.get(auxToId);
         if (sfrom && sto && sto.ed > sfrom.st) {
-          auxMetaBeat.source_ranges = [{ st: r3(sfrom.st), ed: r3(sto.ed) }];
+          auxMetaBeat.source_ranges = [{ st: r33(sfrom.st), ed: r33(sto.ed) }];
         }
       }
       split.beats.push(auxMetaBeat);
@@ -5130,7 +5567,9 @@ function renderSplitMarkdown(doc, landing, meta) {
   L.push("");
   L.push("## MG Queue");
   for (const r of landing.dispatch.mg) {
-    L.push(`- \`${r.beat}\` composition_id=\`${r.composition_id}\`${r.duration != null ? ` · ${r.duration}s` : ""}`);
+    const slot = r.duration != null ? ` · 坑位 ${r.duration}s` : "";
+    const hint = r.duration_hint != null ? ` · hint ${r.duration_hint}s` : "";
+    L.push(`- \`${r.beat}\` composition_id=\`${r.composition_id}\`${slot}${hint}`);
   }
   L.push("");
   L.push("## AI_DRAMA Queue");
@@ -5157,7 +5596,7 @@ var DEFAULT_COLUMN_CONFIG = {
   fallback: { unknown_narrative: "reject" }
 };
 function columnsDir() {
-  return join5(gitruckHome(), "columns");
+  return join6(gitruckHome(), "columns");
 }
 var uniq = (xs) => [...new Set(xs)];
 function strArr(v) {
@@ -5214,8 +5653,8 @@ function foldColumnConfigs(layers) {
   return out;
 }
 function readLocalColumn(columnId, dir, warnings) {
-  const p = join5(dir, `${columnId}.json`);
-  if (!existsSync5(p)) {
+  const p = join6(dir, `${columnId}.json`);
+  if (!existsSync6(p)) {
     warnings.push(`栏目配置不存在：${p}，回落内置默认`);
     return;
   }
@@ -5349,8 +5788,8 @@ function effectiveVocab(config) {
 
 // src/lib/ffmpeg.ts
 import { spawn as spawn2, spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join6 } from "node:path";
+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 <目录> 指定已装位置。`;
@@ -5372,9 +5811,9 @@ function resolveFfmpeg(ffmpegPath) {
   dirs.push([ffmpegDir(), "~/.gitruck/ffmpeg"]);
   let found = null;
   for (const [dir, label] of dirs) {
-    const ff = join6(dir, bin("ffmpeg"));
-    const fp = join6(dir, bin("ffprobe"));
-    if (existsSync6(ff) && existsSync6(fp)) {
+    const ff = join7(dir, bin("ffmpeg"));
+    const fp = join7(dir, bin("ffprobe"));
+    if (existsSync7(ff) && existsSync7(fp)) {
       found = { ffmpeg: ff, ffprobe: fp, source: label };
       break;
     }
@@ -5456,11 +5895,11 @@ function probeCapabilities(res) {
 
 // src/lib/version.ts
 import { readFileSync as readFileSync3 } from "node:fs";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 var REGISTRY = "https://registry.npmjs.org/@gitruck%2Fcli";
 function currentVersion() {
   try {
-    const { version } = JSON.parse(readFileSync3(join7(packageRoot(), "package.json"), "utf8"));
+    const { version } = JSON.parse(readFileSync3(join8(packageRoot(), "package.json"), "utf8"));
     return version;
   } catch {
     return "0.0.0";
@@ -5542,7 +5981,7 @@ async function runDoctor() {
   }
   rows.push({ name: "云端连通 + 鉴权", status: apiStatus, detail: apiDetail });
   const draftDir = resolveJianyingDraftDir(undefined);
-  const draftOk = !!draftDir && existsSync7(draftDir);
+  const draftOk = !!draftDir && existsSync8(draftDir);
   rows.push({
     name: "剪映草稿目录",
     status: draftOk ? "ok" : "warn",
@@ -5550,15 +5989,15 @@ async function runDoctor() {
   });
   rows.push({
     name: "配置文件",
-    status: existsSync7(configPath()) ? "ok" : "warn",
-    detail: existsSync7(configPath()) ? configPath() : `未生成 —— 跑 gtrk init（${configPath()}）`
+    status: existsSync8(configPath()) ? "ok" : "warn",
+    detail: existsSync8(configPath()) ? configPath() : `未生成 —— 跑 gtrk init（${configPath()}）`
   });
   const col = uc.defaultColumn;
-  const colFile = col ? join8(columnsDir(), `${col}.json`) : undefined;
+  const colFile = col ? join9(columnsDir(), `${col}.json`) : undefined;
   rows.push({
     name: "当前栏目",
     status: "ok",
-    detail: col ? `${col}${colFile && existsSync7(colFile) ? `（${colFile}）` : `（⚠ 配置文件缺失：${colFile}，将回落内置默认）`}` : "内置默认 —— 想建自己栏目的风格体系，跑 /gtrk-style-maker（不建也能直接用默认）"
+    detail: col ? `${col}${colFile && existsSync8(colFile) ? `（${colFile}）` : `（⚠ 配置文件缺失：${colFile}，将回落内置默认）`}` : "内置默认 —— 想建自己栏目的风格体系，跑 /gtrk-style-maker（不建也能直接用默认）"
   });
   const ff = resolveFfmpeg();
   if (ff) {
@@ -5605,7 +6044,7 @@ gtrk 体检：
 }
 
 // src/commands/init.ts
-var GUIDE_IMAGE = join9(packageRoot(), "assets", "jianying-draft-path.png");
+var GUIDE_IMAGE = join10(packageRoot(), "assets", "jianying-draft-path.png");
 function registerInit(program2) {
   program2.command("init").description("一次性配置：API Key + 剪映草稿目录（之后所有命令免重复配置）").option("--api-key <key>", "非交互：直接指定 API Key").option("--api-base <url>", "非交互：指定 API 根地址（缺省用默认生产地址）").option("--jianying-draft-dir <dir>", "非交互：剪映草稿目录（传 auto 则自动探测）").option("--reconfigure", "重走配置向导（默认：已配过则跳过、保留现有配置）").option("-y, --yes", "非交互：用传入值 + 自动探测，不弹任何提示").action(runInit);
 }
@@ -5644,7 +6083,7 @@ async function runInit(opts) {
     defaultValue: existing.apiBase ?? DEFAULT_API_BASE
   })).trim();
   let jianyingDraftDir;
-  if (existing.jianyingDraftDir && existsSync8(existing.jianyingDraftDir)) {
+  if (existing.jianyingDraftDir && existsSync9(existing.jianyingDraftDir)) {
     if (await promptConfirm(`剪映草稿目录现为 ${existing.jianyingDraftDir}，保留吗？`, true)) {
       jianyingDraftDir = existing.jianyingDraftDir;
     }
@@ -5660,7 +6099,7 @@ async function runInit(opts) {
     openFile(GUIDE_IMAGE);
     const manual = (await promptText("剪映草稿根目录（…\\com.lveditor.draft），留空跳过：")).trim();
     if (manual) {
-      if (existsSync8(manual))
+      if (existsSync9(manual))
         jianyingDraftDir = resolve3(manual);
       else
         log.warn(`目录不存在，已跳过：${manual}`);
@@ -5734,9 +6173,9 @@ function registerInstall(program2) {
 }
 
 // src/commands/oralcut.ts
-import { resolve as resolve4, join as join14, dirname as dirname3, basename as basename5, extname as extname2 } from "node:path";
-import { mkdir as mkdir4, writeFile as writeFile5, readFile as readFile3 } from "node:fs/promises";
-import { existsSync as existsSync12 } from "node:fs";
+import { resolve as resolve4, join as join15, dirname as dirname3, basename as basename6, extname as extname2 } from "node:path";
+import { mkdir as mkdir4, writeFile as writeFile5, readFile as readFile4 } from "node:fs/promises";
+import { existsSync as existsSync13 } from "node:fs";
 
 // src/lib/config.ts
 function loadConfig() {
@@ -5750,7 +6189,7 @@ function loadConfig() {
 }
 
 // src/lib/cloud.ts
-import { basename } from "node:path";
+import { basename as basename2 } from "node:path";
 import { writeFile, stat } from "node:fs/promises";
 import { createReadStream } from "node:fs";
 import { Readable } from "node:stream";
@@ -5788,7 +6227,7 @@ async function uploadFile(cfg, path, runtime = {}) {
     if (!bunFile)
       throw new Error("Bun 上传运行时缺少 Bun.file");
     const form = new FormData;
-    form.append("file", bunFile(path), basename(path));
+    form.append("file", bunFile(path), basename2(path));
     res = await fetchFn(`${cfg.base}/base/file/upload`, {
       method: "POST",
       headers: { Authorization: cfg.apiKey },
@@ -5798,7 +6237,7 @@ async function uploadFile(cfg, path, runtime = {}) {
     const size = (await stat(path)).size;
     const boundary = `----gtrkFormBoundary${randomBytes(16).toString("hex")}`;
     const head = Buffer.from(`--${boundary}\r
-` + `Content-Disposition: form-data; name="file"; filename="${basename(path)}"\r
+` + `Content-Disposition: form-data; name="file"; filename="${basename2(path)}"\r
 ` + `Content-Type: application/octet-stream\r
 \r
 `, "utf8");
@@ -5889,14 +6328,14 @@ async function download(url, dest) {
 }
 
 // src/lib/upload-cache.ts
-import { join as join10 } from "node:path";
-import { stat as stat3, mkdir, readFile, writeFile as writeFile2 } from "node:fs/promises";
-import { existsSync as existsSync9 } from "node:fs";
+import { join as join11 } from "node:path";
+import { stat as stat3, mkdir, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { existsSync as existsSync10 } from "node:fs";
 
 // src/lib/chunk-upload.ts
 var import_hash_wasm = __toESM(require_index_umd(), 1);
 import { open, stat as stat2 } from "node:fs/promises";
-import { basename as basename2 } from "node:path";
+import { basename as basename3 } from "node:path";
 var CHUNK_THRESHOLD = 256 * 1024 * 1024;
 var CONCURRENCY = 3;
 var PART_RETRIES = 3;
@@ -5958,7 +6397,7 @@ async function sleep(ms) {
 }
 async function uploadChunked(cfg, path, opts) {
   const size = (await stat2(path)).size;
-  const name = basename2(path);
+  const name = basename3(path);
   for (let rebuilds = 0;; rebuilds++) {
     try {
       return await attemptOnce(cfg, path, name, size, opts);
@@ -6123,8 +6562,8 @@ async function putPart(cfg, uploadId, idx, view) {
 
 // src/lib/upload-cache.ts
 var CACHE_DIR = gitruckHome();
-var CACHE_FILE = join10(CACHE_DIR, "upload-cache.json");
-var SESSION_FILE = join10(CACHE_DIR, "upload-sessions.json");
+var CACHE_FILE = join11(CACHE_DIR, "upload-cache.json");
+var SESSION_FILE = join11(CACHE_DIR, "upload-sessions.json");
 function fingerprintFromStat(s) {
   return `${s.size}:${Math.round(s.mtimeMs)}`;
 }
@@ -6132,10 +6571,10 @@ async function fingerprint(path) {
   return fingerprintFromStat(await stat3(path));
 }
 async function load() {
-  if (!existsSync9(CACHE_FILE))
+  if (!existsSync10(CACHE_FILE))
     return {};
   try {
-    return JSON.parse(await readFile(CACHE_FILE, "utf8"));
+    return JSON.parse(await readFile2(CACHE_FILE, "utf8"));
   } catch {
     return {};
   }
@@ -6159,10 +6598,10 @@ async function invalidateUpload(path) {
   }
 }
 async function loadSessions() {
-  if (!existsSync9(SESSION_FILE))
+  if (!existsSync10(SESSION_FILE))
     return {};
   try {
-    return JSON.parse(await readFile(SESSION_FILE, "utf8"));
+    return JSON.parse(await readFile2(SESSION_FILE, "utf8"));
   } catch {
     return {};
   }
@@ -6257,8 +6696,8 @@ async function uploadAndSubmitTask(cfg, path, taskType, buildPayload, options =
 
 // src/lib/media.ts
 import { mkdir as mkdir2, stat as stat4 } from "node:fs/promises";
-import { existsSync as existsSync10 } from "node:fs";
-import { basename as basename3, extname, join as join11 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { basename as basename4, extname, join as join12 } from "node:path";
 function parseFps(rate) {
   if (typeof rate !== "string")
     return 0;
@@ -6306,14 +6745,14 @@ function probeDuration(path, ffmpegPath) {
 }
 async function artifactPath(inputAbs, ext) {
   const s = await stat4(inputAbs);
-  const base = basename3(inputAbs, extname(inputAbs));
+  const base = basename4(inputAbs, extname(inputAbs));
   await mkdir2(audioCacheDir(), { recursive: true });
-  return join11(audioCacheDir(), `${base}.${s.size}_${Math.round(s.mtimeMs)}.${ext}`);
+  return join12(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 (existsSync10(out))
+  if (existsSync11(out))
     return out;
   await runFfmpeg(ffmpeg, [
     "-y",
@@ -6337,7 +6776,7 @@ async function extractAudio(inputAbs, ffmpegPath) {
 async function compress720p(inputAbs, ffmpegPath) {
   const { ffmpeg } = requireFfmpeg(ffmpegPath);
   const out = await artifactPath(inputAbs, "720p.mp4");
-  if (existsSync10(out))
+  if (existsSync11(out))
     return out;
   await runFfmpeg(ffmpeg, [
     "-y",
@@ -6369,14 +6808,14 @@ function assertDurationConsistent(originalDuration, artifactAbs, ffmpegPath, tol
 }
 
 // src/lib/materialize.ts
-import { join as join13, basename as basename4 } from "node:path";
+import { join as join14, basename as basename5 } from "node:path";
 import { mkdir as mkdir3, cp, writeFile as writeFile4 } from "node:fs/promises";
 
 // src/lib/render.ts
-import { writeFile as writeFile3, unlink, readFile as readFile2 } from "node:fs/promises";
-import { existsSync as existsSync11 } from "node:fs";
+import { writeFile as writeFile3, unlink, readFile as readFile3 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var AUDIO_SAMPLE_RATE = 48000;
 var AUDIO_LAYOUT = "stereo";
 var DEFAULT_CRF = 18;
@@ -6534,7 +6973,7 @@ function materialPathsFromGtrk(gtrk) {
       continue;
     if (!m.path)
       throw new Error(`gtrk 素材 ${m.id} 缺 path（source_path），无法本地渲染`);
-    if (!existsSync11(m.path))
+    if (!existsSync12(m.path))
       throw new Error(`gtrk 素材文件不存在：${m.path}`);
     map[String(m.id)] = m.path;
   }
@@ -6548,7 +6987,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 = join12(tmpdir(), `gtrk-filter-${process.pid}-${inputs.length}.txt`);
+  const filterFile = join13(tmpdir(), `gtrk-filter-${process.pid}-${inputs.length}.txt`);
   await writeFile3(filterFile, graph, "utf8");
   try {
     const args = ["-y"];
@@ -6562,7 +7001,7 @@ async function renderGtrk(gtrk, outputPath, opts = {}) {
   }
 }
 async function readGtrkFile(gtrkPath) {
-  return JSON.parse(await readFile2(gtrkPath, "utf8"));
+  return JSON.parse(await readFile3(gtrkPath, "utf8"));
 }
 
 // src/lib/materialize.ts
@@ -6586,7 +7025,7 @@ function gtrkSourceName(gtrk) {
   const p = gtrk.materials?.[0]?.path;
   if (!p)
     return;
-  const b = basename4(p);
+  const b = basename5(p);
   const dot = b.lastIndexOf(".");
   return dot > 0 ? b.slice(0, dot) : b;
 }
@@ -6598,7 +7037,7 @@ async function materializeResult(opts) {
     throw new Error("任务无工程文件产物（检查 project_formats / 任务是否产出）");
   const errors = { ...output.errors ?? {} };
   await mkdir3(outDir, { recursive: true });
-  const resultPath = join13(outDir, "result.json");
+  const resultPath = join14(outDir, "result.json");
   const writeResult = async (extra) => {
     const r = {
       ok: Object.keys(errors).length === 0,
@@ -6620,9 +7059,9 @@ async function materializeResult(opts) {
   const byFormat = {};
   for (const f of files) {
     const base = baseFormat(f.format);
-    const fmtDir = join13(outDir, base);
+    const fmtDir = join14(outDir, base);
     await mkdir3(fmtDir, { recursive: true });
-    const dest = join13(fmtDir, f.filename);
+    const dest = join14(fmtDir, f.filename);
     try {
       await dl(f.download_url, dest);
       (byFormat[base] ??= []).push(dest);
@@ -6639,9 +7078,9 @@ async function materializeResult(opts) {
   let jianyingDraftPath = null;
   if (byFormat.jianying && opts.draftDir) {
     try {
-      jianyingDraftPath = join13(opts.draftDir, basename4(outDir));
+      jianyingDraftPath = join14(opts.draftDir, basename5(outDir));
       await mkdir3(jianyingDraftPath, { recursive: true });
-      await cp(join13(outDir, "jianying"), jianyingDraftPath, { recursive: true });
+      await cp(join14(outDir, "jianying"), jianyingDraftPath, { recursive: true });
       log.info(`剪映草稿已落到：${jianyingDraftPath}`);
     } catch (e) {
       jianyingDraftPath = null;
@@ -6658,7 +7097,7 @@ async function materializeResult(opts) {
       log.step("本地渲染成片（ffmpeg）…");
       const project = await readGtrkFile(gtrkPath);
       const name = opts.projName ?? gtrkSourceName(project) ?? taskId;
-      const outMp4 = join13(outDir, `${name}.mp4`);
+      const outMp4 = join14(outDir, `${name}.mp4`);
       const r = await renderGtrk(project, outMp4, {
         crf: opts.crf != null ? Number(opts.crf) : undefined,
         codec: opts.codec,
@@ -6680,7 +7119,7 @@ async function materializeResult(opts) {
       log.step("三方打开（产物已就位，按需自取）：");
     for (const base of Object.keys(byFormat)) {
       const meta = FORMAT_META[base];
-      const target = base === "jianying" ? jianyingDraftPath ?? join13(outDir, "jianying") : byFormat[base][0];
+      const target = base === "jianying" ? jianyingDraftPath ?? join14(outDir, "jianying") : byFormat[base][0];
       console.log(`   • ${meta?.label ?? base}：${meta?.openHint(target) ?? target}`);
     }
     if (rendered)
@@ -6748,23 +7187,23 @@ async function runOralCut(input, opts) {
     routeLogsToStderr();
   const cfg = loadConfig();
   const inputAbs = resolve4(input);
-  if (!existsSync12(inputAbs))
+  if (!existsSync13(inputAbs))
     throw new Error(`毛片不存在：${inputAbs}`);
-  const projName = basename5(inputAbs, extname2(inputAbs));
+  const projName = basename6(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 ?? join14(dirname3(inputAbs), `${projName}-video-project-${timestamp()}`));
+  const outDir = resolve4(opts.out ?? join15(dirname3(inputAbs), `${projName}-video-project-${timestamp()}`));
   let scriptPath = opts.script ? resolve4(opts.script) : undefined;
   if (!scriptPath) {
-    const sibling = join14(dirname3(inputAbs), `${projName}.txt`);
-    if (existsSync12(sibling)) {
+    const sibling = join15(dirname3(inputAbs), `${projName}.txt`);
+    if (existsSync13(sibling)) {
       scriptPath = sibling;
       log.info(`自动识别到同名文稿：${sibling}（按有稿剪辑；不想用就改名或显式 --script）`);
     }
   }
-  const script = scriptPath ? await readFile3(scriptPath, "utf8") : undefined;
+  const script = scriptPath ? await readFile4(scriptPath, "utf8") : undefined;
   let draftDir;
   if (wantJianying) {
     draftDir = resolveJianyingDraftDir(opts.jianyingDraftDir);
@@ -6773,14 +7212,14 @@ async function runOralCut(input, opts) {
     else
       log.warn("没找到剪映草稿目录 → 将只产 draft_content.json、缺 meta。可加 --jianying-draft-dir <你的草稿目录> 重跑。");
   }
-  log.step(`▶ 智能口播剪辑：${basename5(inputAbs)}（预设 ${opts.preset}${opts.visualAssist ? " · 视觉兜底(720p)" : ""}，格式 ${formats.join("/")}${opts.render ? " · 本地渲染" : ""}）`);
+  log.step(`▶ 智能口播剪辑：${basename6(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 代理（上传物）：${basename5(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename5(artifact)}`);
+  log.info(opts.visualAssist ? `已压 720p 代理（上传物）：${basename6(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename6(artifact)}`);
   log.step("② 上传抽出物到云端…");
   const buildPayload = (fid) => {
     const p = {
@@ -6820,7 +7259,7 @@ async function runOralCut(input, opts) {
   const up = { fileId: submitted.fileId, cached: submitted.cached };
   log.info(`task_id = ${taskId}`);
   await mkdir4(outDir, { recursive: true });
-  await writeFile5(join14(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE, fileId: up.fileId, source: inputAbs, formats, createdAt: new Date().toISOString() }, null, 2));
+  await writeFile5(join15(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE, fileId: up.fileId, source: inputAbs, formats, createdAt: new Date().toISOString() }, null, 2));
   log.step("④ 云端处理中（每 5s 轮询）…");
   const result = await pollTask(cfg, TASK_TYPE, taskId, (status, progress) => {
     log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
@@ -6844,7 +7283,7 @@ async function runOralCut(input, opts) {
 }
 
 // src/commands/oralcut-result.ts
-import { resolve as resolve5, join as join15 } from "node:path";
+import { resolve as resolve5, join as join16 } from "node:path";
 var TASK_TYPE2 = "cli/video_oral_cut_for_cli";
 function timestamp2() {
   const d = new Date;
@@ -6878,7 +7317,7 @@ async function runOralCutResult(taskId, opts) {
     const pct = got.progress != null ? ` ${Math.round(got.progress)}%` : "";
     throw new Error(`任务尚未完成（当前 ${got.status || "未知"}${pct}），暂无法取回结果；请稍后再试。`);
   }
-  const outDir = resolve5(opts.out ?? join15(process.cwd(), `${taskId}-video-project-${timestamp2()}`));
+  const outDir = resolve5(opts.out ?? join16(process.cwd(), `${taskId}-video-project-${timestamp2()}`));
   const draftDir = resolveJianyingDraftDir(opts.jianyingDraftDir);
   await materializeResult({
     outDir,
@@ -6938,17 +7377,17 @@ function registerUpgrade(program2) {
 }
 
 // src/commands/render.ts
-import { resolve as resolve6, dirname as dirname4, join as join16, basename as basename6, extname as extname3 } from "node:path";
-import { existsSync as existsSync13 } from "node:fs";
+import { resolve as resolve6, dirname as dirname4, join as join17, basename as basename7, extname as extname3 } from "node:path";
+import { existsSync as existsSync14 } 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 = resolve6(gtrk);
-    if (!existsSync13(gtrkAbs))
+    if (!existsSync14(gtrkAbs))
       throw new Error(`gtrk 工程不存在：${gtrkAbs}`);
-    const outMp4 = resolve6(opts.out ?? join16(dirname4(gtrkAbs), `${basename6(gtrkAbs, extname3(gtrkAbs))}.mp4`));
-    log.step(`▶ 本地渲染：${basename6(gtrkAbs)} → ${basename6(outMp4)}`);
+    const outMp4 = resolve6(opts.out ?? join17(dirname4(gtrkAbs), `${basename7(gtrkAbs, extname3(gtrkAbs))}.mp4`));
+    log.step(`▶ 本地渲染：${basename7(gtrkAbs)} → ${basename7(outMp4)}`);
     const project = await readGtrkFile(gtrkAbs);
     const result = await renderGtrk(project, outMp4, {
       crf: opts.crf != null ? Number(opts.crf) : undefined,
@@ -6971,132 +7410,14 @@ function registerRender(program2) {
 }
 
 // src/commands/split.ts
-import { resolve as resolve7, join as join18, dirname as dirname6, basename as basename8 } from "node:path";
-import { existsSync as existsSync14 } from "node:fs";
-import { readFile as readFile4, writeFile as writeFile6, mkdir as mkdir5 } from "node:fs/promises";
+import { resolve as resolve7, join as join19, dirname as dirname6, basename as basename9 } from "node:path";
+import { existsSync as existsSync15 } from "node:fs";
+import { readFile as readFile5, writeFile as writeFile6, mkdir as mkdir5 } from "node:fs/promises";
 import { createHash } from "node:crypto";
 
-// src/lib/projection.ts
-function r32(n) {
-  return Math.round(n * 1000) / 1000;
-}
-function normClip(c3) {
-  const clip_st = c3.clip_st ?? 0;
-  const track_st = c3.track_st ?? 0;
-  const dur = c3.duration ?? (c3.clip_ed != null ? c3.clip_ed - clip_st : 0);
-  const clip_ed = c3.clip_ed ?? clip_st + dur;
-  return { clip_st, clip_ed, track_st };
-}
-function pickMainVideoTrack(gtrk) {
-  const tracks = gtrk.video_track ?? [];
-  if (!tracks.length)
-    return;
-  let best = tracks[0];
-  let bestIdx = best.track_index ?? 0;
-  for (const t of tracks) {
-    const idx = t.track_index ?? 0;
-    if (idx < bestIdx) {
-      best = t;
-      bestIdx = idx;
-    }
-  }
-  return best;
-}
-function projectTranscript(transcript, gtrk, opts = {}) {
-  const materialId = String(transcript.material_id);
-  const mainTrack = pickMainVideoTrack(gtrk);
-  const clips = (mainTrack?.track_timeline ?? []).filter((c3) => c3.material != null && String(c3.material) === materialId).map(normClip);
-  const entries = [];
-  transcript.utterances.forEach((utt, sourceIndex) => {
-    const totalWords = utt.words?.length ?? 0;
-    const instances = [];
-    for (const clip of clips) {
-      const surviving = [];
-      for (const word of utt.words ?? []) {
-        const s = Math.max(word.st, clip.clip_st);
-        const e = Math.min(word.ed, clip.clip_ed);
-        if (e > s) {
-          surviving.push({
-            w: word.w,
-            track_st: r32(clip.track_st + (s - clip.clip_st)),
-            track_ed: r32(clip.track_st + (e - clip.clip_st))
-          });
-        }
-      }
-      if (surviving.length) {
-        instances.push({
-          track_st: Math.min(...surviving.map((x) => x.track_st)),
-          track_ed: Math.max(...surviving.map((x) => x.track_ed)),
-          kept_words: surviving.length,
-          words: surviving
-        });
-      }
-    }
-    if (!instances.length) {
-      entries.push({
-        id: utt.id,
-        text: utt.text,
-        dropped: true,
-        sourceIndex,
-        instIndex: 0,
-        track_st: null,
-        track_ed: null,
-        kept_words: 0,
-        total_words: totalWords,
-        words: [],
-        sortKey: 0
-      });
-    } else {
-      instances.sort((a, b) => a.track_st - b.track_st);
-      instances.forEach((inst, instIndex) => {
-        entries.push({
-          id: utt.id,
-          text: utt.text,
-          dropped: false,
-          sourceIndex,
-          instIndex,
-          track_st: inst.track_st,
-          track_ed: inst.track_ed,
-          kept_words: inst.kept_words,
-          total_words: totalWords,
-          words: inst.words,
-          sortKey: inst.track_st
-        });
-      });
-    }
-  });
-  let maxEd = 0;
-  for (const e of entries) {
-    if (e.dropped)
-      e.sortKey = maxEd;
-    else
-      maxEd = Math.max(maxEd, e.track_ed ?? maxEd);
-  }
-  entries.sort((a, b) => a.sortKey - b.sortKey || a.sourceIndex - b.sourceIndex || a.instIndex - b.instIndex);
-  const utterances = entries.map((e) => {
-    const u = {
-      id: e.id,
-      text: e.text,
-      track_st: e.track_st,
-      track_ed: e.track_ed,
-      dropped: e.dropped,
-      kept_words: e.kept_words,
-      total_words: e.total_words
-    };
-    if (opts.words)
-      u.words = e.words;
-    return u;
-  });
-  return {
-    transcript_hash: transcript.text_hash,
-    projected_at: opts.projectedAt ?? new Date().toISOString(),
-    utterances
-  };
-}
-
 // src/lib/gtrk-writeback.ts
 import { readFileSync as readFileSync4, statSync, writeFileSync as writeFileSync2, renameSync, unlinkSync } from "node:fs";
-import { dirname as dirname5, join as join17, basename as basename7 } from "node:path";
+import { dirname as dirname5, join as join18, basename as basename8 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function readGtrk(path) {
   const raw = readFileSync4(path, "utf8");
@@ -7123,7 +7444,7 @@ function writeStructMetaSplit(path, gtrk, splitObj, expectedMtimeMs) {
   }
   const nextStructMeta = { ...gtrk.struct_meta ?? {}, split: splitObj };
   const next = { ...gtrk, struct_meta: nextStructMeta };
-  const tmp = join17(dirname5(path), `.${basename7(path)}.${randomBytes2(6).toString("hex")}.tmp`);
+  const tmp = join18(dirname5(path), `.${basename8(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
     renameSync(tmp, path);
@@ -7139,7 +7460,7 @@ function writeGtrkAtomic(path, next, expectedMtimeMs) {
   if (cur !== expectedMtimeMs) {
     throw new Error("工程文件在 matrix 运行期间被外部修改（保存冲突），已拒绝写入；请关闭客户端未保存的工程或重跑（plan 与已下载代理均保留）");
   }
-  const tmp = join17(dirname5(path), `.${basename7(path)}.${randomBytes2(6).toString("hex")}.tmp`);
+  const tmp = join18(dirname5(path), `.${basename8(path)}.${randomBytes2(6).toString("hex")}.tmp`);
   try {
     writeFileSync2(tmp, JSON.stringify(next, null, 2));
     renameSync(tmp, path);
@@ -7159,7 +7480,7 @@ function registerSplit(program2) {
   });
 }
 function firstExisting(cands) {
-  return cands.find((p) => existsSync14(p));
+  return cands.find((p) => existsSync15(p));
 }
 function resolvePaths(opts) {
   const project = opts.project ? resolve7(opts.project) : undefined;
@@ -7167,30 +7488,30 @@ function resolvePaths(opts) {
   if (opts.gtrk) {
     gtrkPath = resolve7(opts.gtrk);
   } else if (project) {
-    gtrkPath = firstExisting([join18(project, "gtrk", "project.gtrk"), join18(project, "project.gtrk")]) ?? join18(project, "gtrk", "project.gtrk");
+    gtrkPath = firstExisting([join19(project, "gtrk", "project.gtrk"), join19(project, "project.gtrk")]) ?? join19(project, "gtrk", "project.gtrk");
   } else {
     throw new Error("需 --project <目录> 或显式 --gtrk <path>");
   }
-  if (!existsSync14(gtrkPath))
+  if (!existsSync15(gtrkPath))
     throw new Error(`找不到工程文件：${gtrkPath}`);
   let transcriptPath;
   if (opts.transcript)
     transcriptPath = resolve7(opts.transcript);
   else if (project)
     transcriptPath = firstExisting([
-      join18(project, "transcript", "transcript.json"),
-      join18(project, "json", "transcript.json"),
-      join18(project, "transcript.json")
+      join19(project, "transcript", "transcript.json"),
+      join19(project, "json", "transcript.json"),
+      join19(project, "transcript.json")
     ]);
   const baseDir = project ?? dirname6(gtrkPath);
   return { baseDir, gtrkPath, transcriptPath };
 }
-function slugify(name) {
+function slugify2(name) {
   const s = name.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "");
   return s || "project";
 }
 async function loadTranscript(path) {
-  const t = JSON.parse(await readFile4(path, "utf8"));
+  const t = JSON.parse(await readFile5(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}`);
   }
@@ -7205,15 +7526,15 @@ async function runSplit(splitdoc, opts) {
   return splitdoc ? runLand(resolve7(splitdoc), baseDir, gtrkPath, transcriptPath, opts) : runView(baseDir, gtrkPath, transcriptPath, opts);
 }
 async function runView(baseDir, gtrkPath, transcriptPath, opts) {
-  if (!transcriptPath || !existsSync14(transcriptPath))
+  if (!transcriptPath || !existsSync15(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 = join18(baseDir, "split");
+  const splitDir = join19(baseDir, "split");
   await mkdir5(splitDir, { recursive: true });
-  const viewPath = join18(splitDir, "view.json");
+  const viewPath = join19(splitDir, "view.json");
   await writeFile6(viewPath, JSON.stringify(view, null, 2));
   const dropped = view.utterances.filter((u) => u.dropped).length;
   log.ok(`投影视图已生成：${viewPath}（${view.utterances.length} 条，其中 ${dropped} 条被剪）`);
@@ -7231,12 +7552,12 @@ async function runView(baseDir, gtrkPath, transcriptPath, opts) {
   return result;
 }
 async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
-  if (!existsSync14(splitdocPath))
+  if (!existsSync15(splitdocPath))
     throw new Error(`找不到拆分稿：${splitdocPath}`);
-  if (!transcriptPath || !existsSync14(transcriptPath))
+  if (!transcriptPath || !existsSync15(transcriptPath))
     throw new Error(TRANSCRIPT_MISSING);
   log.step("▶ 校验拆分稿并落地…");
-  const doc = JSON.parse(await readFile4(splitdocPath, "utf8"));
+  const doc = JSON.parse(await readFile5(splitdocPath, "utf8"));
   const transcript = await loadTranscript(transcriptPath);
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
   assertGtrkV1(gtrk);
@@ -7259,7 +7580,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
   }
   const projectedAt = new Date().toISOString();
   const view = projectTranscript(transcript, gtrk, { projectedAt });
-  const projectSlug = slugify(basename8(baseDir));
+  const projectSlug = slugify2(basename9(baseDir));
   const landing = buildLanding(doc, view, {
     utteranceIds: ctx.utteranceIds,
     projectSlug,
@@ -7270,13 +7591,13 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
     }
   });
   writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
-  const splitDir = join18(baseDir, "split");
+  const splitDir = join19(baseDir, "split");
   await mkdir5(splitDir, { recursive: true });
-  const dispatchPath = join18(splitDir, "dispatch.json");
+  const dispatchPath = join19(splitDir, "dispatch.json");
   await writeFile6(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
   let mdPath = null;
   if (opts.md) {
-    mdPath = join18(splitDir, "visual-split.md");
+    mdPath = join19(splitDir, "visual-split.md");
     await writeFile6(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}）`);
@@ -7308,18 +7629,165 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
 }
 
 // src/commands/matrix.ts
-import { resolve as resolve8, join as join19, dirname as dirname7, basename as basename9 } from "node:path";
-import { existsSync as existsSync15 } from "node:fs";
-import { readFile as readFile5, writeFile as writeFile7, mkdir as mkdir6 } from "node:fs/promises";
+import { resolve as resolve9, join as join20, dirname as dirname7, basename as basename10 } from "node:path";
+import { existsSync as existsSync17 } from "node:fs";
+import { readFile as readFile6, writeFile as writeFile7, mkdir as mkdir6, rename } from "node:fs/promises";
+
+// src/lib/solid-png.ts
+import { deflateSync } from "node:zlib";
+var BLACK_BED_HEX = "000000";
+var SOLID_MATERIAL_PREFIX = "ex-solid-";
+var BUILTIN_ASSET_DIR = "assets/builtin";
+var MAX_BED_DIM = 8192;
+var PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+var CRC_TABLE = (() => {
+  const table = new Uint32Array(256);
+  for (let n = 0;n < 256; n++) {
+    let c3 = n;
+    for (let k = 0;k < 8; k++)
+      c3 = c3 & 1 ? 3988292384 ^ c3 >>> 1 : c3 >>> 1;
+    table[n] = c3 >>> 0;
+  }
+  return table;
+})();
+function crc32(buf) {
+  let c3 = 4294967295;
+  for (let i = 0;i < buf.length; i++)
+    c3 = (CRC_TABLE[(c3 ^ buf[i]) & 255] ^ c3 >>> 8) >>> 0;
+  return (c3 ^ 4294967295) >>> 0;
+}
+function chunk(type, data) {
+  const len = Buffer.alloc(4);
+  len.writeUInt32BE(data.length, 0);
+  const body = Buffer.concat([Buffer.from(type, "ascii"), data]);
+  const crc = Buffer.alloc(4);
+  crc.writeUInt32BE(crc32(body), 0);
+  return Buffer.concat([len, body, crc]);
+}
+function normalizeHex(hex) {
+  const h = hex.replace(/^#/, "").toLowerCase();
+  return /^[0-9a-f]{6}$/.test(h) ? h : null;
+}
+function solidMaterialId({
+  hex,
+  width,
+  height
+}) {
+  const h = normalizeHex(hex);
+  if (!h)
+    throw new Error(`非法纯色 hex：${hex}`);
+  return `${SOLID_MATERIAL_PREFIX}${h}-${width}x${height}`;
+}
+function solidRelPath({
+  hex,
+  width,
+  height
+}) {
+  const h = normalizeHex(hex);
+  if (!h)
+    throw new Error(`非法纯色 hex：${hex}`);
+  return `${BUILTIN_ASSET_DIR}/solid-${h}-${width}x${height}.png`;
+}
+function isLayoutableCanvas(canvas) {
+  if (!Array.isArray(canvas) || canvas.length !== 2)
+    return false;
+  return canvas.every((v) => typeof v === "number" && Number.isInteger(v) && v > 0 && v <= MAX_BED_DIM);
+}
+function encodeSolidPng({
+  hex,
+  width,
+  height
+}) {
+  const h = normalizeHex(hex);
+  if (!h)
+    throw new Error(`非法纯色 hex：${hex}`);
+  if (!isLayoutableCanvas([width, height])) {
+    throw new Error(`纯色画布尺寸非法或超上限（${width}x${height}，上限 ${MAX_BED_DIM}）`);
+  }
+  const r = Number.parseInt(h.slice(0, 2), 16);
+  const g2 = Number.parseInt(h.slice(2, 4), 16);
+  const b = Number.parseInt(h.slice(4, 6), 16);
+  const ihdr = Buffer.alloc(13);
+  ihdr.writeUInt32BE(width, 0);
+  ihdr.writeUInt32BE(height, 4);
+  ihdr[8] = 8;
+  ihdr[9] = 2;
+  ihdr[10] = 0;
+  ihdr[11] = 0;
+  ihdr[12] = 0;
+  const stride = 1 + width * 3;
+  const row = Buffer.alloc(stride);
+  row[0] = 0;
+  for (let x = 0;x < width; x++) {
+    const off = 1 + x * 3;
+    row[off] = r;
+    row[off + 1] = g2;
+    row[off + 2] = b;
+  }
+  const raw = Buffer.alloc(stride * height);
+  for (let y = 0;y < height; y++)
+    row.copy(raw, y * stride);
+  return Buffer.concat([
+    PNG_SIGNATURE,
+    chunk("IHDR", ihdr),
+    chunk("IDAT", deflateSync(raw, { level: 9 })),
+    chunk("IEND", Buffer.alloc(0))
+  ]);
+}
 
 // src/lib/matrix-lay.ts
 var BROLL_PREVIEW_DIR = "assets/broll-preview";
 var BROLL_MATERIAL_PREFIX = "broll-";
+var BROLL_RAW_MATERIAL_PREFIX = "broll-raw-";
 var BROLL_META_CANDIDATE_CAP = 12;
 var SHOT_TARGET_DEFAULT = 3;
 var MIN_SHOT_SEC = 1.2;
 var SCORE_FLOOR_DEFAULT = 0.2;
 var MAX_SLOTS_PER_BEAT = 32;
+var BLACK_BED_MERGE_EPS = 0.001;
+function mergeBlackBedSegments(envelopes) {
+  const valid = envelopes.filter((e) => Number.isFinite(e.track_st) && Number.isFinite(e.track_ed) && e.track_ed > e.track_st).sort((a, b) => a.track_st - b.track_st);
+  const out = [];
+  for (const e of valid) {
+    const last = out[out.length - 1];
+    if (last && e.track_st - last.track_ed <= BLACK_BED_MERGE_EPS) {
+      if (e.track_ed > last.track_ed)
+        last.track_ed = e.track_ed;
+      continue;
+    }
+    out.push({ track_st: e.track_st, track_ed: e.track_ed });
+  }
+  return out.map((s) => ({ track_st: r34(s.track_st), track_ed: r34(s.track_ed) }));
+}
+var HOLE_WARN_SEC = 3;
+var HOLE_WARN_RATIO = 0.15;
+function computeBlackBedHoles(opts) {
+  const holes = [];
+  for (const b of opts.beats) {
+    if (!(b.track_ed - b.track_st > BLACK_BED_MERGE_EPS))
+      continue;
+    const covered = mergeBlackBedSegments(b.slots.map((s) => ({
+      track_st: Math.max(b.track_st, s.track_st),
+      track_ed: Math.min(b.track_ed, s.track_ed)
+    })));
+    const push = (st, ed) => {
+      const track_st = r34(st);
+      const track_ed = r34(ed);
+      if (track_ed - track_st > BLACK_BED_MERGE_EPS) {
+        holes.push({ beat: b.beat, track_st, track_ed, sec: r34(track_ed - track_st) });
+      }
+    };
+    let cursor = b.track_st;
+    for (const c3 of covered) {
+      push(cursor, c3.track_st);
+      if (c3.track_ed > cursor)
+        cursor = c3.track_ed;
+    }
+    push(cursor, b.track_ed);
+  }
+  holes.sort((a, b) => a.track_st - b.track_st || a.track_ed - b.track_ed);
+  return { holes, totalSec: r34(holes.reduce((n, h) => n + h.sec, 0)) };
+}
 function mergedCandidates(beat) {
   const all = [];
   for (const q of beat.queries)
@@ -7347,7 +7815,7 @@ function previewDims(width, height) {
   const h = Math.max(2, Math.round(height * 640 / width / 2) * 2);
   return [640, h];
 }
-var r33 = (n) => Math.round(n * 1000) / 1000;
+var r34 = (n) => Math.round(n * 1000) / 1000;
 function buildQueryPools(beat, scoreFloor) {
   const out = [];
   for (const q of beat.queries) {
@@ -7450,10 +7918,10 @@ function fillBeatTrack(opts) {
       clip_id: pick.cand.clip_id,
       query: pick.query,
       score: pick.seg.score,
-      clip_st: r33(clipSt),
-      clip_ed: r33(clipSt + d),
-      track_st: r33(cursor),
-      track_ed: r33(cursor + d)
+      clip_st: r34(clipSt),
+      clip_ed: r34(clipSt + d),
+      track_st: r34(cursor),
+      track_ed: r34(cursor + d)
     });
     consumed.add(pick.key);
     prevClip = pick.cand.clip_id;
@@ -7468,47 +7936,241 @@ function fillBeatTrack(opts) {
       const hi = dur ?? lastPick.seg.end;
       const ext = Math.min(tail, Math.max(0, hi - last.clip_ed));
       if (ext > 0.000001) {
-        last.clip_ed = r33(last.clip_ed + ext);
-        last.track_ed = r33(last.track_ed + ext);
+        last.clip_ed = r34(last.clip_ed + ext);
+        last.track_ed = r34(last.track_ed + ext);
       }
     }
   }
-  return slots;
+  return slots;
+}
+function planBeatFills(plan, lay, scoreFloor) {
+  const fills = new Map;
+  const clipIds = new Set;
+  const consumed = new Set;
+  for (const beat of plan.beats) {
+    const perTrack = [];
+    for (let k = 0;k < Math.max(0, lay); k++) {
+      const slots = fillBeatTrack({ beat, trackOrder: k, consumed, scoreFloor });
+      perTrack.push(slots);
+      for (const s of slots)
+        clipIds.add(s.clip_id);
+    }
+    fills.set(beat.beat, perTrack);
+  }
+  return { fills, clipIds };
+}
+var expectedLabel = (e) => `${e.kind === "black" ? "黑底轨" : "候选轨"}#${e.trackIndex}=${e.clipCount} clip`;
+function expectedSelfProducedTracks(prevBroll) {
+  if (!prevBroll || typeof prevBroll !== "object")
+    return [];
+  const meta = prevBroll;
+  const beats = Array.isArray(meta.beats) ? meta.beats : [];
+  const out = [];
+  const byTrack = new Map;
+  for (const b of beats) {
+    for (const l of Array.isArray(b?.laid) ? b.laid : []) {
+      const idx = l.track_index;
+      const slots = l.slots;
+      if (typeof idx !== "number" || !Array.isArray(slots) || slots.length === 0)
+        continue;
+      byTrack.set(idx, (byTrack.get(idx) ?? 0) + slots.length);
+    }
+  }
+  for (const [trackIndex, clipCount] of [...byTrack.entries()].sort((a, b) => a[0] - b[0])) {
+    out.push({ kind: "candidate", trackIndex, clipCount });
+  }
+  if (typeof meta.black_track === "number") {
+    const envelopes = beats.filter((b) => Array.isArray(b?.laid) && b.laid.length > 0).map((b) => ({ track_st: Number(b.track_st), track_ed: Number(b.track_ed) }));
+    const segCount = mergeBlackBedSegments(envelopes).length;
+    if (segCount > 0)
+      out.push({ kind: "black", trackIndex: meta.black_track, clipCount: segCount });
+  }
+  return out;
+}
+function pickExpectation(expected, clipCount, trackIndex) {
+  let best = null;
+  let bestDist = Number.POSITIVE_INFINITY;
+  for (const e of expected) {
+    if (e.clipCount !== clipCount)
+      continue;
+    const dist = trackIndex === null ? 0 : Math.abs(e.trackIndex - trackIndex);
+    if (dist < bestDist || dist === bestDist && best !== null && e.trackIndex < best.trackIndex) {
+      best = e;
+      bestDist = dist;
+    }
+  }
+  return best;
+}
+function classifyTrack(track, expected, opts = {}) {
+  const clips = Array.isArray(track.track_timeline) ? track.track_timeline : [];
+  const trackIndex = typeof track.track_index === "number" ? track.track_index : null;
+  const materials = clips.map((c3) => typeof c3?.material === "string" ? c3.material : "");
+  const rawClips = materials.filter((m) => m.startsWith(BROLL_RAW_MATERIAL_PREFIX)).length;
+  const foreignClips = materials.filter((m) => !(m.startsWith(BROLL_MATERIAL_PREFIX) || m.startsWith(SOLID_MATERIAL_PREFIX))).length;
+  const base = {
+    trackIndex,
+    clipCount: clips.length,
+    rawClips,
+    foreignClips,
+    samples: [...new Set(materials.filter(Boolean))].slice(0, 2),
+    matched: null
+  };
+  const registered = opts.registered ?? expected.length > 0;
+  if (clips.length === 0)
+    return { ...base, cls: "user", reason: "空轨（track_timeline 为空）" };
+  if (!registered) {
+    return { ...base, cls: "user", reason: "盘上无 struct_meta.broll 登记（或上轮一条都没铺成）：宁留勿删" };
+  }
+  if (rawClips > 0) {
+    return {
+      ...base,
+      cls: "self-produced-edited",
+      reason: `${rawClips}/${clips.length} 个 clip 的 material 已是 broll-raw-*（你在客户端确认过原片）`
+    };
+  }
+  if (foreignClips > 0) {
+    return {
+      ...base,
+      cls: "user",
+      reason: `${foreignClips}/${clips.length} 个 clip 的 material 非自产前缀（用户轨 / 混合轨）`
+    };
+  }
+  const matched = opts.matched !== undefined ? opts.matched : pickExpectation(expected, clips.length, trackIndex);
+  if (matched) {
+    return { ...base, matched, cls: "self-produced", reason: `与登记吻合（${expectedLabel(matched)}）` };
+  }
+  const inLay = new Set(opts.layTracks ?? []).has(trackIndex ?? Number.NaN);
+  const counts = expected.length ? expected.map(expectedLabel).join("、") : "（登记里一条自产轨都没有）";
+  if (inLay) {
+    return {
+      ...base,
+      cls: "self-produced-edited",
+      reason: `clip 数 ${clips.length} 与登记的自产轨条数都对不上（登记：${counts}），而该 track_index 在 lay_tracks 在册`
+    };
+  }
+  return {
+    ...base,
+    cls: "user",
+    reason: `clip 数 ${clips.length} 对不上任何登记指纹（登记：${counts}）且 track_index 不在 lay_tracks 在册：按用户轨保留`
+  };
 }
-function planBeatFills(plan, lay, scoreFloor) {
-  const fills = new Map;
-  const clipIds = new Set;
-  const consumed = new Set;
-  for (const beat of plan.beats) {
-    const perTrack = [];
-    for (let k = 0;k < Math.max(0, lay); k++) {
-      const slots = fillBeatTrack({ beat, trackOrder: k, consumed, scoreFloor });
-      perTrack.push(slots);
-      for (const s of slots)
-        clipIds.add(s.clip_id);
+function classifyVideoTracks(tracks, expected, layTracks = []) {
+  const registered = expected.length > 0;
+  const eligible = tracks.map((t, i) => ({ i, idx: typeof t.track_index === "number" ? t.track_index : null, v: classifyTrack(t, [], { registered: true, matched: null }) })).filter((e) => e.v.clipCount > 0 && e.v.rawClips === 0 && e.v.foreignClips === 0);
+  const claimed = new Map;
+  const taken = new Set;
+  for (const exp of expected) {
+    let best = -1;
+    let bestDist = Number.POSITIVE_INFINITY;
+    let bestIdx = Number.POSITIVE_INFINITY;
+    for (const e of eligible) {
+      if (taken.has(e.i) || e.v.clipCount !== exp.clipCount)
+        continue;
+      const idx = e.idx ?? Number.MAX_SAFE_INTEGER;
+      const dist = Math.abs(idx - exp.trackIndex);
+      if (dist < bestDist || dist === bestDist && idx < bestIdx) {
+        best = e.i;
+        bestDist = dist;
+        bestIdx = idx;
+      }
+    }
+    if (best >= 0) {
+      taken.add(best);
+      claimed.set(best, exp);
     }
-    fills.set(beat.beat, perTrack);
   }
-  return { fills, clipIds };
+  return tracks.map((t, i) => classifyTrack(t, expected, { layTracks, registered, matched: claimed.get(i) ?? null }));
 }
 function layBrollTracks(opts) {
   const { gtrk, plan, lay, fills, downloads } = opts;
+  const blackBedOn = opts.blackBed !== false;
+  const forceRelay = opts.forceRelay === true;
+  const warnings = [];
   const videoTracks = [...gtrk.video_track ?? []];
   const materials = [...gtrk.materials ?? []];
   const structMeta = { ...gtrk.struct_meta ?? {} };
   const prevBroll = structMeta.broll;
   const prevIndices = new Set(Array.isArray(prevBroll?.lay_tracks) ? prevBroll.lay_tracks.filter((x) => typeof x === "number") : []);
-  const removedTracks = videoTracks.filter((t) => typeof t.track_index === "number" && prevIndices.has(t.track_index));
-  const keptTracks = videoTracks.filter((t) => !(typeof t.track_index === "number" && prevIndices.has(t.track_index)));
+  const expected = expectedSelfProducedTracks(prevBroll);
+  const verdicts = classifyVideoTracks(videoTracks, expected, prevIndices);
+  const editedTracks = videoTracks.filter((_, i) => verdicts[i].cls === "self-produced-edited");
+  const keptEditedTracks = editedTracks.map((t) => typeof t.track_index === "number" ? t.track_index : -1).filter((n) => n >= 0);
+  const strippable = (i) => verdicts[i].cls === "self-produced" || forceRelay && verdicts[i].cls === "self-produced-edited";
+  const removedTracks = videoTracks.filter((_, i) => strippable(i));
+  const keptTracks = videoTracks.filter((_, i) => !strippable(i));
+  for (let i = 0;i < videoTracks.length; i++) {
+    const v = verdicts[i];
+    if (v.cls !== "self-produced-edited")
+      continue;
+    const samples = v.samples.length ? `，material 样例 ${v.samples.join(" / ")}` : "";
+    warnings.push(`候选轨 track_index=${v.trackIndex} 判定为「已被你编辑」：${v.reason}（该轨 ${v.clipCount} clip${samples}）。` + (forceRelay ? "已按 --force-relay 强制剥离重铺。" : "本次不剥它、也不铺新轨——在客户端处置该轨后重跑，或加 --force-relay 强剥重铺。"));
+  }
+  if (editedTracks.length > 0 && !forceRelay) {
+    let beatsWithCands = 0;
+    for (const beat of plan.beats)
+      if (mergedCandidates(beat).length > 0)
+        beatsWithCands++;
+    warnings.push(`本次未铺任何轨、工程文件零改动（.gtrk 未写回、struct_meta.broll 未刷新）；` + `broll-plan.json 与已落盘的 preview 代理照常产出/复用。`);
+    return {
+      next: gtrk,
+      summary: {
+        laidTracks: [],
+        laidClips: 0,
+        beatsWithCandidates: beatsWithCands,
+        blackTrack: null,
+        removedTracks: [],
+        keptEditedTracks,
+        refused: true,
+        blackBedHoleSec: 0,
+        blackBedHoles: []
+      },
+      broll: prevBroll ?? {
+        contract_version: "v1",
+        generated_at: opts.generatedAt,
+        plan_path: opts.planPath,
+        lay_tracks: [],
+        black_track: null,
+        confirmed: false,
+        beats: []
+      },
+      warnings
+    };
+  }
   const removedMaterialIds = new Set;
   for (const t of removedTracks) {
     for (const c3 of t.track_timeline ?? []) {
       const m = c3.material;
-      if (typeof m === "string" && m.startsWith(BROLL_MATERIAL_PREFIX))
+      if (typeof m === "string" && (m.startsWith(BROLL_MATERIAL_PREFIX) || m.startsWith(SOLID_MATERIAL_PREFIX))) {
         removedMaterialIds.add(m);
+      }
+    }
+  }
+  const stillReferenced = new Set;
+  for (const group of [keptTracks, gtrk.beat_track ?? [], gtrk.audio_track ?? []]) {
+    for (const t of group) {
+      for (const c3 of t.track_timeline ?? []) {
+        if (typeof c3.material === "string")
+          stillReferenced.add(c3.material);
+      }
     }
   }
+  for (const id of stillReferenced)
+    removedMaterialIds.delete(id);
   const keptMaterials = materials.filter((m) => !(typeof m.id === "string" && removedMaterialIds.has(m.id)));
+  if (forceRelay) {
+    const rawGone = [...removedMaterialIds].filter((id) => id.startsWith(BROLL_RAW_MATERIAL_PREFIX)).length;
+    if (rawGone > 0) {
+      warnings.push(`--force-relay：本次强制剥离将删除 ${rawGone} 条 broll-raw-* 素材登记，` + `gtrk/assets/broll/ 下对应的已下载原片文件会就地成孤儿（CLI 不删字节，但工程里再无引用）。`);
+    }
+  }
+  for (const t of keptTracks) {
+    const clips = t.track_timeline ?? [];
+    if (!clips.length)
+      continue;
+    if (clips.every((c3) => typeof c3.material === "string" && c3.material.startsWith(SOLID_MATERIAL_PREFIX))) {
+      warnings.push(`检测到疑似手工纯色底轨（track_index=${t.track_index}）：新候选轨会落到它之下被遮住。建议删除该轨后重跑，或用 --no-black-bed。`);
+    }
+  }
   const canvas = Array.isArray(gtrk.video_size) ? gtrk.video_size : [1920, 1080];
   const baseIndex = keptTracks.reduce((mx, t) => Math.max(mx, typeof t.track_index === "number" ? t.track_index : 0), -1) + 1;
   const candById = new Map;
@@ -7554,7 +8216,7 @@ function layBrollTracks(opts) {
           clip_ed: s.clip_ed,
           track_st: s.track_st,
           track_ed: s.track_ed,
-          duration: r33(s.track_ed - s.track_st)
+          duration: r34(s.track_ed - s.track_st)
         });
         laidClips++;
       });
@@ -7591,26 +8253,287 @@ function layBrollTracks(opts) {
     muted: false,
     track_timeline: clips.sort((a, b) => a.track_st - b.track_st)
   }));
+  let blackTrack = null;
+  let blackTrackObj = null;
+  if (blackBedOn && createdTracks.length > 0) {
+    if (!isLayoutableCanvas([canvas[0], canvas[1]])) {
+      warnings.push(`画布尺寸非法（${canvas[0]}x${canvas[1]}），跳过铺纯黑底轨（候选轨照常铺）。`);
+    } else {
+      const laidBeatEnvelopes = metaBeats.filter((b) => b.laid.length > 0).map((b) => ({ track_st: b.track_st, track_ed: b.track_ed }));
+      const segments = mergeBlackBedSegments(laidBeatEnvelopes);
+      if (segments.length > 0) {
+        const width = canvas[0];
+        const height = canvas[1];
+        const solidId = solidMaterialId({ hex: BLACK_BED_HEX, width, height });
+        newMaterialsById.set(solidId, {
+          id: solidId,
+          path: solidRelPath({ hex: BLACK_BED_HEX, width, height }),
+          video_size: [width, height]
+        });
+        blackTrack = baseIndex + lay;
+        blackTrackObj = {
+          track_index: blackTrack,
+          track_size: [width, height],
+          muted: false,
+          track_timeline: segments.map((s, i) => ({
+            clip_id: `blackbed-${i}`,
+            material: solidId,
+            clip_st: 0,
+            clip_ed: r34(s.track_ed - s.track_st),
+            track_st: s.track_st,
+            track_ed: s.track_ed,
+            duration: r34(s.track_ed - s.track_st)
+          }))
+        };
+      }
+    }
+  }
+  let blackBedHoles = [];
+  let blackBedHoleSec = 0;
+  if (blackTrack !== null) {
+    const holeBeats = metaBeats.filter((b) => b.laid.length > 0).map((b) => ({
+      beat: b.beat,
+      track_st: b.track_st,
+      track_ed: b.track_ed,
+      slots: b.laid.flatMap((l) => l.slots)
+    }));
+    ({ holes: blackBedHoles, totalSec: blackBedHoleSec } = computeBlackBedHoles({ beats: holeBeats }));
+    const spanOf = new Map(holeBeats.map((b) => [b.beat, b.track_ed - b.track_st]));
+    const perBeat = new Map;
+    for (const h of blackBedHoles) {
+      const cur = perBeat.get(h.beat);
+      if (!cur)
+        perBeat.set(h.beat, { sec: h.sec, longest: h });
+      else {
+        cur.sec = r34(cur.sec + h.sec);
+        if (h.sec > cur.longest.sec)
+          cur.longest = h;
+      }
+    }
+    const offenders = [...perBeat.entries()].filter(([beat, v]) => {
+      const span = spanOf.get(beat) ?? 0;
+      return v.longest.sec >= HOLE_WARN_SEC || span > 0 && v.sec / span >= HOLE_WARN_RATIO;
+    });
+    if (offenders.length > 0) {
+      const detail = offenders.map(([beat, v]) => {
+        const span = spanOf.get(beat) ?? 0;
+        const pct = span > 0 ? Math.round(v.sec / span * 100) : 0;
+        return `${beat} 纯黑 ${v.sec}s / 占 ${pct}%（最长一段 ${v.longest.sec}s @ ${v.longest.track_st}–${v.longest.track_ed}）`;
+      }).join("；");
+      warnings.push(`黑底空洞：${offenders.length} 个 beat 的黑底之上没有任何 B-roll，这几段现在是纯黑压住口播——${detail}；` + `全片累计纯黑 ${blackBedHoleSec}s。铺轨已照常完成（黑底按 beat 包络整条铺，槽位没填满处就是纯黑，属粗剪期预期内）；` + `想调整可：调低 --score-floor 放宽取材、或改用 --no-black-bed 让这些地方露出主轨口播、或到客户端手动往这几段补片。`);
+    }
+  }
+  const laidTrackIndices = createdTracks.map((t) => t.track_index);
   const broll = {
     contract_version: "v1",
     generated_at: opts.generatedAt,
     plan_path: opts.planPath,
-    lay_tracks: createdTracks.map((t) => t.track_index),
+    lay_tracks: blackTrack === null ? laidTrackIndices : [...laidTrackIndices, blackTrack],
+    black_track: blackTrack,
     confirmed: false,
     beats: metaBeats
   };
+  const mergedMaterials = new Map;
+  for (const m of keptMaterials) {
+    if (typeof m.id === "string")
+      mergedMaterials.set(m.id, m);
+    else
+      mergedMaterials.set(`__anon_${mergedMaterials.size}`, m);
+  }
+  for (const [id, m] of newMaterialsById)
+    mergedMaterials.set(id, m);
   const next = {
     ...gtrk,
-    materials: [...keptMaterials, ...newMaterialsById.values()],
-    video_track: [...keptTracks, ...createdTracks],
+    materials: [...mergedMaterials.values()],
+    video_track: [...keptTracks, ...createdTracks, ...blackTrackObj ? [blackTrackObj] : []],
     struct_meta: { ...structMeta, broll }
   };
   return {
     next,
-    summary: { laidTracks: broll.lay_tracks, laidClips, beatsWithCandidates },
-    broll
+    summary: {
+      laidTracks: laidTrackIndices,
+      laidClips,
+      beatsWithCandidates,
+      blackTrack,
+      removedTracks: removedTracks.map((t) => typeof t.track_index === "number" ? t.track_index : -1).filter((n) => n >= 0).sort((a, b) => a - b),
+      keptEditedTracks: forceRelay ? [] : keptEditedTracks,
+      refused: false,
+      blackBedHoleSec,
+      blackBedHoles
+    },
+    broll,
+    warnings
+  };
+}
+
+// src/lib/material-integrity.ts
+import { existsSync as existsSync16 } from "node:fs";
+import { resolve as resolve8 } from "node:path";
+var INTEGRITY_LIST_CAP = 10;
+var r35 = (n) => Math.round(n * 1000) / 1000;
+function classifyMaterialPath(p) {
+  if (typeof p !== "string" || p.trim() === "")
+    return { kind: "none", path: typeof p === "string" ? p : "" };
+  const path = p.trim();
+  if (/^https?:\/\//i.test(path))
+    return { kind: "remote", path };
+  if (/^[a-zA-Z]:[\\/]/.test(path) || /^[\\/]{2}/.test(path) || /^[\\/]/.test(path)) {
+    return { kind: "absolute", path };
+  }
+  return { kind: "relative", path };
+}
+var normalizeRel = (p) => p.replace(/\\/g, "/").replace(/^\.\//, "");
+function clipTrackEd(clip) {
+  if (typeof clip.track_ed === "number")
+    return clip.track_ed;
+  if (typeof clip.track_st === "number" && typeof clip.duration === "number") {
+    return r35(clip.track_st + clip.duration);
+  }
+  return null;
+}
+var TRACK_GROUPS = ["video_track", "audio_track", "beat_track"];
+var REF_KEYS = ["material", "html_material"];
+function collectMaterialRefs(gtrk) {
+  const out = new Map;
+  for (const group of TRACK_GROUPS) {
+    const tracks = gtrk[group];
+    if (!Array.isArray(tracks))
+      continue;
+    for (const t of tracks) {
+      if (!t || typeof t !== "object")
+        continue;
+      const trackIndex = typeof t.track_index === "number" ? t.track_index : null;
+      const clips = Array.isArray(t.track_timeline) ? t.track_timeline : [];
+      for (const c3 of clips) {
+        if (!c3 || typeof c3 !== "object")
+          continue;
+        for (const key of REF_KEYS) {
+          const id = c3[key];
+          if (typeof id !== "string" || id === "")
+            continue;
+          const list = out.get(id) ?? [];
+          list.push({
+            track: group,
+            track_index: trackIndex,
+            clip_id: typeof c3.clip_id === "string" ? c3.clip_id : null,
+            track_st: typeof c3.track_st === "number" ? c3.track_st : null,
+            track_ed: clipTrackEd(c3),
+            key
+          });
+          out.set(id, list);
+        }
+      }
+    }
+  }
+  return out;
+}
+function checkMaterialIntegrity(opts) {
+  const exists = opts.exists ?? ((p) => existsSync16(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 };
+  const dangling = [];
+  const external = [];
+  const noPathIds = [];
+  let degradedCount = 0;
+  let degradedReason = "";
+  for (const m of materials) {
+    const id = typeof m?.id === "string" ? m.id : "";
+    const { kind, path } = classifyMaterialPath(m?.path);
+    if (kind === "none") {
+      counts.noPath++;
+      noPathIds.push(id || "(无 id)");
+      continue;
+    }
+    if (kind === "remote") {
+      counts.remote++;
+      continue;
+    }
+    counts[kind]++;
+    const resolved = kind === "relative" ? resolve8(opts.gtrkDir, normalizeRel(path)) : path;
+    let present;
+    try {
+      present = exists(resolved);
+    } catch (e) {
+      degradedCount++;
+      if (!degradedReason)
+        degradedReason = e instanceof Error ? e.message : String(e);
+      continue;
+    }
+    if (present)
+      continue;
+    const list = refs.get(id) ?? [];
+    const entry = {
+      id,
+      path,
+      kind,
+      resolved,
+      referenced: list.length > 0,
+      refCount: list.length,
+      refs: list
+    };
+    (kind === "relative" ? dangling : external).push(entry);
+  }
+  const bySeverity = (a, b) => a.referenced === b.referenced ? a.id.localeCompare(b.id) : a.referenced ? -1 : 1;
+  dangling.sort(bySeverity);
+  external.sort(bySeverity);
+  return {
+    checked: materials.length,
+    counts,
+    dangling,
+    danglingReferenced: dangling.filter((d) => d.referenced).length,
+    danglingOrphan: dangling.filter((d) => !d.referenced).length,
+    external,
+    noPathIds,
+    ...degradedCount > 0 ? { degraded: { count: degradedCount, reason: degradedReason } } : {}
   };
 }
+function safeCheckMaterialIntegrity(opts) {
+  try {
+    return checkMaterialIntegrity({ gtrk: opts.gtrk, gtrkDir: opts.gtrkDir, exists: opts.exists });
+  } catch (e) {
+    opts.log.warn(`素材落盘自检未能完成（${e instanceof Error ? e.message : String(e)}）——写回结果与命令判定不受影响。`);
+    return;
+  }
+}
+function integritySummaryLine(r) {
+  if (r.dangling.length === 0) {
+    return `素材落盘自检：${r.checked} 条素材全部就位`;
+  }
+  return `素材落盘自检：${r.checked} 条素材里有 ${r.dangling.length} 条的文件不在盘上` + `（被时间线引用 ${r.danglingReferenced} 条 · 孤儿 ${r.danglingOrphan} 条）——只报不动，工程与文件零改动。`;
+}
+function missingLine(m) {
+  const tag = m.referenced ? "被引用" : "孤儿";
+  if (!m.referenced)
+    return `[${tag}] ${m.id} → ${m.path}`;
+  const head = m.refs[0];
+  const span = head.track_st !== null ? ` · ${r35(head.track_st)}→${head.track_ed === null ? "?" : r35(head.track_ed)}s` : "";
+  const more = m.refCount > 1 ? ` 等 ${m.refCount} 处` : "";
+  return `[${tag}] ${m.id} → ${m.path}` + `（${head.track} track_index=${head.track_index ?? "?"} · clip ${head.clip_id ?? "?"}${span}${more}）`;
+}
+function reportMaterialIntegrity(r, log2) {
+  if (r.degraded) {
+    log2.warn(`素材落盘自检降级：${r.degraded.count} 条素材查不了存在性（${r.degraded.reason}）——` + `这几条既不算就位也不算悬空，其余条目照常已查。`);
+  }
+  if (r.dangling.length === 0) {
+    log2.info(integritySummaryLine(r));
+  } else {
+    log2.warn(integritySummaryLine(r));
+    for (const m of r.dangling.slice(0, INTEGRITY_LIST_CAP))
+      log2.warn(`   ${missingLine(m)}`);
+    if (r.dangling.length > INTEGRITY_LIST_CAP) {
+      log2.warn(`   …等共 ${r.dangling.length} 条（全量见 --json 的 integrity.dangling）`);
+    }
+    log2.info("被引用的悬空 = 时间线上那一段没有素材可放（客户端可能 relink 回落到别的素材）；孤儿 = 只在 materials 里挂着、不影响画面。");
+    log2.info("悬空多半是历史遗留（如客户端「确认原片」下载中断）；CLI 只报不删，要修就在客户端重新确认原片、或删掉那条 clip。");
+  }
+  if (r.external.length > 0) {
+    log2.warn(`另有 ${r.external.length} 条**绝对路径**素材当前找不到文件（外接盘/网络盘没挂载也会这样，不计入上面的悬空）：` + r.external.slice(0, INTEGRITY_LIST_CAP).map((m) => `${m.id} → ${m.path}`).join("；") + (r.external.length > INTEGRITY_LIST_CAP ? ` …等共 ${r.external.length} 条` : ""));
+  }
+  if (r.noPathIds.length > 0) {
+    log2.warn(`另有 ${r.noPathIds.length} 条素材没有 path（结构问题，非落盘问题）：` + r.noPathIds.slice(0, INTEGRITY_LIST_CAP).join("、") + (r.noPathIds.length > INTEGRITY_LIST_CAP ? ` …等共 ${r.noPathIds.length} 条` : ""));
+  }
+}
 
 // src/lib/matrix.ts
 var URL_TTL_NOTE = "结果 url 带签名默认 24h 过期；过期后重跑 gtrk matrix 即重签（plan 幂等重生成）。";
@@ -7799,7 +8722,7 @@ async function searchOnce(cfg, tier, body) {
 
 // src/commands/matrix.ts
 function registerMatrix(program2) {
-  program2.command("matrix [words...]").description('B-roll 检索：无 positional=消费 split/dispatch.json 的 film_broll 队列产候选清单；`matrix search "<query>"`=单条 ad-hoc 检索').option("--project <dir>", "oralcut 产物目录（定位 split/dispatch.json 与产物落点）").option("--dispatch <path>", "显式指定 dispatch.json（非标准布局兜底）").option("--column <id>", "栏目配置 id（缺省取 config defaultColumn，再缺省内置默认栏目）").option("--top-k <n>", "每 query 候选数上限（覆盖派单 shots 翻译；服务端上限 50）").option("--material-class <c>", "素材类型 real_shot|concept（仅矩阵成员口；覆盖栏目 material_class_policy）").option("--lay <n>", "候选铺轨数：下载 preview 代理并在工程里平铺 N 条 B-roll 候选轨（默认 1；0=只出 plan 不铺轨）", "1").option("--score-floor <f>", "填充置信度地板：segment score 低于此值不采纳，槽位留空露主轨（默认 0.2）").option("--out <file>", "ad-hoc 模式：结果落文件（缺省输出 stdout）").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (words, opts) => {
+  program2.command("matrix [words...]").description('B-roll 检索：无 positional=消费 split/dispatch.json 的 film_broll 队列产候选清单；`matrix search "<query>"`=单条 ad-hoc 检索').option("--project <dir>", "oralcut 产物目录（定位 split/dispatch.json 与产物落点）").option("--dispatch <path>", "显式指定 dispatch.json（非标准布局兜底）").option("--column <id>", "栏目配置 id（缺省取 config defaultColumn，再缺省内置默认栏目）").option("--top-k <n>", "每 query 候选数上限（覆盖派单 shots 翻译；服务端上限 50）").option("--material-class <c>", "素材类型 real_shot|concept（仅矩阵成员口；覆盖栏目 material_class_policy）").option("--lay <n>", "候选铺轨数：下载 preview 代理并在工程里平铺 N 条 B-roll 候选轨（默认 1；0=只出 plan 不铺轨）", "1").option("--score-floor <f>", "填充置信度地板：segment score 低于此值不采纳，槽位留空——黑底垫轨默认开，留空处露的是黑底（要露主轨口播画面得配 --no-black-bed）。" + "调高会收缩取材池、可能整段无槽位铺成纯黑，调完先看铺轨输出的空洞告警（默认 0.2）").option("--no-black-bed", "不铺纯黑底垫轨（默认铺一条，垫在候选轨之下、口播主轨之上，用于 B-roll 期间遮住口播画面）").option("--force-relay", "候选轨已被你在客户端编辑过（改过 clip / 确认过原片）时仍强制剥离重铺：缺省会拒铺并保留那条轨，本开关是逃生门——" + "会删除已确认原片的 broll-raw-* 素材登记，盘上已下载的原片文件就地成孤儿，且那条轨上的编辑不可恢复").option("--out <file>", "ad-hoc 模式：结果落文件（缺省输出 stdout）").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (words, opts) => {
     await runMatrix(parseAdhocQuery(words), opts);
   });
 }
@@ -7847,18 +8770,40 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   let dispatchPath;
   let baseDir;
   if (opts.dispatch) {
-    dispatchPath = resolve8(opts.dispatch);
+    dispatchPath = resolve9(opts.dispatch);
     baseDir = dirname7(dirname7(dispatchPath));
   } else if (opts.project) {
-    baseDir = resolve8(opts.project);
-    dispatchPath = join19(baseDir, "split", "dispatch.json");
+    baseDir = resolve9(opts.project);
+    dispatchPath = join20(baseDir, "split", "dispatch.json");
   } else {
     throw new Error('需 --project <目录> 或显式 --dispatch <path>（ad-hoc 检索用：gtrk matrix search "<query>"）');
   }
-  if (!existsSync15(dispatchPath))
+  if (!existsSync17(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split <拆分稿> 落地派单）`);
-  const dispatch = JSON.parse(await readFile5(dispatchPath, "utf8"));
-  const queue = Array.isArray(dispatch.film_broll) ? dispatch.film_broll : [];
+  const dispatch = JSON.parse(await readFile6(dispatchPath, "utf8"));
+  const rawQueue = Array.isArray(dispatch.film_broll) ? dispatch.film_broll : [];
+  const earlyGtrkPath = locateGtrk(baseDir);
+  let earlyGtrk;
+  let earlyUnreadable = false;
+  if (earlyGtrkPath) {
+    try {
+      earlyGtrk = readGtrk(earlyGtrkPath).gtrk;
+    } catch {
+      earlyUnreadable = true;
+    }
+  }
+  const reproj = await reprojectDispatchWindows({
+    baseDir,
+    gtrk: earlyGtrk,
+    gtrkUnreadable: earlyUnreadable,
+    entries: rawQueue.map((e) => ({ key: e.beat, beat: e.beat, span: e.span, track_st: e.track_st, track_ed: e.track_ed }))
+  });
+  reportReprojection(reproj);
+  const droppedBeats = new Set(reproj.summary.dropped);
+  const queue = rawQueue.filter((e) => !droppedBeats.has(e.beat)).map((e) => {
+    const win = reproj.windows.get(e.beat);
+    return win ? { ...e, track_st: win.track_st, track_ed: win.track_ed } : e;
+  });
   log.step(`▶ B-roll 检索：${queue.length} 个 beat（${tier} 口）…`);
   const beats = [];
   let okCount = 0;
@@ -7885,12 +8830,12 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     beats.push(buildPlanBeat(entry, outcomes));
   }
   const totalQueries = okCount + errCount;
-  if (queue.length === 0)
+  if (rawQueue.length === 0)
     log.warn("无 B-roll 派单（film_broll 队列为空）——照常写出空 plan");
   if (totalQueries > 0 && okCount === 0) {
     throw new Error(`全部 ${totalQueries} 个 query 检索失败，未写入 plan（逐条原因见上方日志）`);
   }
-  const projectSlug = slugify2(basename9(baseDir));
+  const projectSlug = slugify3(basename10(baseDir));
   const plan = buildPlan({
     generatedAt: new Date().toISOString(),
     memberType: tier,
@@ -7898,26 +8843,33 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
     columnId,
     beats
   });
-  const splitDir = join19(baseDir, "split");
+  const splitDir = join20(baseDir, "split");
   await mkdir6(splitDir, { recursive: true });
-  const planPath = join19(splitDir, "broll-plan.json");
+  const planPath = join20(splitDir, "broll-plan.json");
   await writeFile7(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);
-  let laySummary;
+  let laid;
   if (layN > 0) {
-    laySummary = await layIntoProject(baseDir, plan, layN, parseScoreFloor(opts.scoreFloor));
+    laid = await layIntoProject(baseDir, plan, layN, parseScoreFloor(opts.scoreFloor), opts.blackBed ?? true, opts.forceRelay === true, reproj);
   }
+  const laySummary = laid?.lay;
+  const refused = laySummary?.refused === true ? laySummary.keptEditedTracks : undefined;
   const result = {
-    ok: true,
+    ok: refused === undefined,
     mode: "plan",
     memberType: tier,
     ...columnId ? { columnId } : {},
     planPath,
+    ...refused ? { refused, reason: "tracks_edited", planReusable: true } : {},
     ...laySummary ? { lay: laySummary } : {},
+    ...laid?.integrity ? { integrity: laid.integrity } : {},
+    reprojection: reproj.summary,
     counts: { beats: beats.length, queries: totalQueries, results: resultCount, errors: errCount }
   };
+  if (!result.ok)
+    process.exitCode = 1;
   if (opts.json)
     console.log(JSON.stringify(result));
   return result;
@@ -7941,13 +8893,13 @@ function parseScoreFloor(raw) {
   return SCORE_FLOOR_DEFAULT;
 }
 function locateGtrk(baseDir) {
-  const cands = [join19(baseDir, "gtrk", "project.gtrk"), join19(baseDir, "project.gtrk")];
-  return cands.find((p) => existsSync15(p));
+  const cands = [join20(baseDir, "gtrk", "project.gtrk"), join20(baseDir, "project.gtrk")];
+  return cands.find((p) => existsSync17(p));
 }
-async function layIntoProject(baseDir, plan, layN, scoreFloor) {
+async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRelay, reproj) {
   const gtrkPath = locateGtrk(baseDir);
   if (!gtrkPath) {
-    log.warn(`未找到工程文件（${join19(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
+    log.warn(`未找到工程文件（${join20(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——plan 已产出，可后续在有工程的目录重跑`);
     return;
   }
   const { gtrk, mtimeMs } = readGtrk(gtrkPath);
@@ -7956,7 +8908,7 @@ async function layIntoProject(baseDir, 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 = dirname7(gtrkPath);
-  const previewDir = join19(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
+  const previewDir = join20(gtrkDir, ...BROLL_PREVIEW_DIR.split("/"));
   await mkdir6(previewDir, { recursive: true });
   const prevSource = new Map;
   const prevBroll = gtrk.struct_meta?.broll;
@@ -7979,8 +8931,8 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor) {
     if (!cand)
       continue;
     const rel = `${BROLL_PREVIEW_DIR}/${clipId}.mp4`;
-    const abs = join19(gtrkDir, ...rel.split("/"));
-    if (existsSync15(abs)) {
+    const abs = join20(gtrkDir, ...rel.split("/"));
+    if (existsSync17(abs)) {
       const prev = prevSource.get(clipId);
       if (prev !== "raw") {
         downloads.set(clipId, { rel, source: prev ?? "preview" });
@@ -8006,22 +8958,94 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor) {
       dlStats.failed++;
     }
   }
-  const { next, summary } = layBrollTracks({
+  let { next, summary, warnings } = layBrollTracks({
     gtrk,
     plan,
     lay: layN,
     fills,
     downloads,
     generatedAt: new Date().toISOString(),
-    planPath: "split/broll-plan.json"
+    planPath: "split/broll-plan.json",
+    blackBed,
+    forceRelay
   });
-  writeGtrkAtomic(gtrkPath, next, mtimeMs);
-  log.ok(`铺轨完成：${summary.laidTracks.length} 条候选轨（track_index ${summary.laidTracks.join("/") || "-"}）· 平铺 ${summary.laidClips} 个颗粒 / ${clipIds.size} 个 clip` + `（代理 ${dlStats.preview} · 原片回落 ${dlStats.raw} · 复用 ${dlStats.reused}${dlStats.failed ? ` · 失败 ${dlStats.failed}` : ""}）`);
+  if (summary.refused) {
+    const list = summary.keptEditedTracks;
+    log.err(`拒绝铺轨：${list.length} 条候选轨已被你在客户端编辑过（track_index ${list.join("/") || "-"}）——` + "本次不剥它们、也不铺新轨，工程文件零改动。");
+    for (const w of warnings)
+      log.warn(w);
+    log.warn("下一步二选一：① 在客户端处置那条轨（删掉 / 移走 / 改用别的轨）后重跑本命令；" + "② 确知要丢弃那条轨上的编辑 → 加 --force-relay 强制剥离重铺" + "（会删掉已确认原片的 broll-raw-* 素材登记，盘上原片文件成孤儿，不可恢复）。");
+    log.warn("已产出的 broll-plan.json 与已落盘的 preview 代理照常可用——拒的只是「改工程」这一步。");
+    return {
+      lay: {
+        refused: true,
+        keptEditedTracks: list,
+        laidTracks: [],
+        laidClips: 0,
+        removedTracks: [],
+        blackTrack: null,
+        blackBedHoleSec: 0,
+        blackBedHoles: [],
+        downloads: dlStats
+      }
+    };
+  }
+  if (summary.blackTrack !== null) {
+    const canvas = gtrk.video_size;
+    const spec = { hex: BLACK_BED_HEX, width: canvas[0], height: canvas[1] };
+    const rel = solidRelPath(spec);
+    const abs = join20(gtrkDir, ...rel.split("/"));
+    try {
+      if (!existsSync17(abs)) {
+        await mkdir6(dirname7(abs), { recursive: true });
+        const tmp = `${abs}.tmp-${process.pid}`;
+        await writeFile7(tmp, encodeSolidPng(spec));
+        await rename(tmp, abs);
+      }
+    } catch (e) {
+      log.warn(`纯黑底 PNG 落盘失败（${rel}）：${e.message} —— 本次不铺黑底垫轨，候选轨照常。`);
+      ({ next, summary, warnings } = layBrollTracks({
+        gtrk,
+        plan,
+        lay: layN,
+        fills,
+        downloads,
+        generatedAt: new Date().toISOString(),
+        planPath: "split/broll-plan.json",
+        blackBed: false,
+        forceRelay
+      }));
+    }
+  }
+  const written = withTimecodeSource(next, "broll", reproj);
+  writeGtrkAtomic(gtrkPath, written, mtimeMs);
+  const integrity = safeCheckMaterialIntegrity({ gtrk: written, gtrkDir, log });
+  const bedNote = summary.blackTrack !== null ? ` · 纯黑底垫轨 track_index ${summary.blackTrack}` : blackBed ? " · 未铺纯黑底垫轨" : " · 纯黑底垫轨已关闭（--no-black-bed）";
+  const stripNote = `剥离 ${summary.removedTracks.length} 条旧自产轨` + (summary.removedTracks.length ? `（track_index ${summary.removedTracks.join("/")}）` : "") + (forceRelay ? "（含 --force-relay 强剥的已编辑轨）" : "") + " · ";
+  const keptNote = summary.keptEditedTracks.length ? ` · 保留 ${summary.keptEditedTracks.length} 条已被你编辑的轨（track_index ${summary.keptEditedTracks.join("/")}，本次未剥，因由见下方告警）` : "";
+  log.ok(`铺轨完成：${stripNote}${summary.laidTracks.length} 条候选轨（track_index ${summary.laidTracks.join("/") || "-"}）· 平铺 ${summary.laidClips} 个颗粒 / ${clipIds.size} 个 clip` + `（代理 ${dlStats.preview} · 原片回落 ${dlStats.raw} · 复用 ${dlStats.reused}${dlStats.failed ? ` · 失败 ${dlStats.failed}` : ""}）${bedNote}${keptNote}`);
   log.info("opencut 打开工程即见候选轨：轨道头小眼睛可开关对比；确认下载原片属挑选 UI（E-P1）。");
+  for (const w of warnings)
+    log.warn(w);
   if (dlStats.raw > 0) {
     log.warn("部分候选无 preview 代理已回落原片（体积较大）——服务端 backfill 后重跑本命令可换回代理。");
   }
-  return { laidTracks: summary.laidTracks, laidClips: summary.laidClips, downloads: dlStats };
+  if (integrity)
+    reportMaterialIntegrity(integrity, log);
+  return {
+    lay: {
+      refused: false,
+      laidTracks: summary.laidTracks,
+      laidClips: summary.laidClips,
+      removedTracks: summary.removedTracks,
+      keptEditedTracks: summary.keptEditedTracks,
+      blackTrack: summary.blackTrack,
+      blackBedHoleSec: summary.blackBedHoleSec,
+      blackBedHoles: summary.blackBedHoles,
+      downloads: dlStats
+    },
+    ...integrity ? { integrity } : {}
+  };
 }
 async function downloadProxy(cand, absPath, opts = {}) {
   const tryFetch = async (url) => {
@@ -8068,7 +9092,7 @@ async function runAdhoc(query, cfg, tier, broll, overrides, columnId, opts) {
     counts: { beats: 0, queries: 1, results: results.length, errors: 0 }
   };
   if (opts.out) {
-    const outPath = resolve8(opts.out);
+    const outPath = resolve9(opts.out);
     await writeFile7(outPath, JSON.stringify({ query, recalled: data.recalled, results }, null, 2));
     log.ok(`结果已落盘：${outPath}`);
     result.outPath = outPath;
@@ -8082,15 +9106,15 @@ async function runAdhoc(query, cfg, tier, broll, overrides, columnId, opts) {
     console.log(JSON.stringify(result));
   return result;
 }
-function slugify2(name) {
+function slugify3(name) {
   const s = name.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "");
   return s || "project";
 }
 
 // src/commands/mg.ts
-import { resolve as resolve9, join as join20, dirname as dirname8, basename as basename10 } from "node:path";
-import { existsSync as existsSync16 } from "node:fs";
-import { readFile as readFile6, mkdir as mkdir7, copyFile } from "node:fs/promises";
+import { resolve as resolve10, join as join21, dirname as dirname8, basename as basename11 } from "node:path";
+import { existsSync as existsSync18 } from "node:fs";
+import { readFile as readFile7, mkdir as mkdir7, copyFile } from "node:fs/promises";
 
 // src/lib/mg-lint.ts
 var CDN_OK = [/lib\.baomitu\.com/i, /cdnjs\.cloudflare\.com/i, /unpkg\.com/i];
@@ -8103,16 +9127,68 @@ function attr(tag, name) {
   const m = tag.match(new RegExp(`\\b${name}\\s*=\\s*["']([^"']*)["']`, "i"));
   return m ? m[1] : undefined;
 }
-function deriveOpaque(rootTagStr) {
+function parseCompositionId(html) {
+  const root = rootTag(html);
+  return root ? attr(root, "data-composition-id") : undefined;
+}
+var NON_RENDERING = ["style", "script", "meta", "link", "title"];
+function firstChildTag(html, rootTagStr) {
   if (!rootTagStr)
-    return { opaque: false, declared: false };
-  const style = attr(rootTagStr, "style") ?? "";
+    return null;
+  const at = html.indexOf(rootTagStr);
+  if (at < 0)
+    return null;
+  let i = at + rootTagStr.length;
+  for (;; ) {
+    while (i < html.length && /\s/.test(html[i]))
+      i++;
+    if (html.startsWith("<!--", i)) {
+      const end = html.indexOf("-->", i + 4);
+      if (end < 0)
+        return null;
+      i = end + 3;
+      continue;
+    }
+    const m = /^<([a-zA-Z][\w-]*)\b[^>]*>/.exec(html.slice(i));
+    if (!m)
+      return null;
+    const name = m[1].toLowerCase();
+    if (!NON_RENDERING.includes(name))
+      return m[0];
+    const close = new RegExp(`</${name}\\s*>`, "i").exec(html.slice(i));
+    i += close ? close.index + close[0].length : m[0].length;
+  }
+}
+function isFullBleed(tagStr) {
+  const style = (attr(tagStr, "style") ?? "").toLowerCase();
+  if (!/position\s*:\s*(?:absolute|fixed)/.test(style))
+    return false;
+  if (/\binset\s*:\s*0(?:px|%)?\b/.test(style))
+    return true;
+  const has = (p) => new RegExp(`\\b${p}\\s*:\\s*0(?:px|%)?\\s*(?:;|$)`).test(style);
+  const full = (p) => new RegExp(`\\b${p}\\s*:\\s*(?:100%|100vw|100vh|1920px|1080px)\\s*(?:;|$)`).test(style);
+  return has("top") && has("left") && full("width") && full("height");
+}
+function bgOf(style) {
   const bg = style.match(/background(?:-color)?\s*:\s*([^;"']+)/i);
   if (!bg)
-    return { opaque: false, declared: false };
+    return { declared: false, opaque: false };
   const val = bg[1].trim().toLowerCase();
   const transparent = val === "transparent" || val === "none" || /rgba\([^)]*,\s*0\s*\)/.test(val);
-  return { opaque: !transparent, declared: true };
+  return { declared: true, opaque: !transparent };
+}
+function deriveOpaque(rootTagStr, childTagStr) {
+  if (!rootTagStr)
+    return { opaque: false, declared: false, solidOnRoot: false, solidOnChild: false };
+  const root = bgOf(attr(rootTagStr, "style") ?? "");
+  const childFull = childTagStr !== null && isFullBleed(childTagStr);
+  const child = childFull ? bgOf(attr(childTagStr, "style") ?? "") : { declared: false, opaque: false };
+  return {
+    opaque: root.opaque || child.opaque,
+    declared: root.declared || child.declared,
+    solidOnRoot: root.opaque,
+    solidOnChild: child.opaque
+  };
 }
 var CATEGORY_EXPECTED_OPAQUE2 = {
   overlay: false,
@@ -8124,6 +9200,179 @@ var CATEGORY_EXPECTED_OPAQUE2 = {
   "explain-subtitle": false,
   "op-ed-title": true
 };
+var NUM_LIT = /^-?\d+(?:\.\d+)?$/;
+function rawProp(body, key) {
+  const m = new RegExp(`\\b${key}\\s*:\\s*([^,}\\n]+)`).exec(body);
+  return m ? m[1].trim() : undefined;
+}
+function numProp(body, key) {
+  const raw = rawProp(body, key);
+  if (raw === undefined)
+    return null;
+  return NUM_LIT.test(raw) ? Number(raw) : Number.NaN;
+}
+function estimateTimelineSec(html) {
+  const re = /(?:([A-Za-z_$][\w$]*)\s*)?\.\s*(?:to|from|fromTo|set|add)\s*\(([\s\S]*?)\)\s*;/g;
+  const calls = [];
+  let m;
+  while (m = re.exec(html)) {
+    if (m[1] === "gsap")
+      continue;
+    const args = m[2] ?? "";
+    const lastBrace = args.lastIndexOf("}");
+    let pos = null;
+    if (lastBrace >= 0) {
+      const tail = args.slice(lastBrace + 1).replace(/^\s*,\s*/, "").trim();
+      if (tail)
+        pos = tail.replace(/^["']|["']$/g, "");
+    }
+    calls.push({ body: args, pos });
+  }
+  let chain = 0;
+  let maxEnd = 0;
+  let parsed = 0;
+  let skipped = 0;
+  let hasInfiniteRepeat = false;
+  for (const c3 of calls) {
+    if (c3.pos !== null && !NUM_LIT.test(c3.pos)) {
+      skipped++;
+      continue;
+    }
+    const durProp = numProp(c3.body, "duration");
+    if (durProp !== null && (!Number.isFinite(durProp) || durProp < 0)) {
+      skipped++;
+      continue;
+    }
+    const dur = durProp ?? 0;
+    const repProp = numProp(c3.body, "repeat");
+    let span;
+    if (repProp === -1) {
+      hasInfiniteRepeat = true;
+      span = Number.POSITIVE_INFINITY;
+    } else {
+      const rep = repProp !== null && Number.isFinite(repProp) && repProp > 0 ? repProp : 0;
+      const rdProp = numProp(c3.body, "repeatDelay");
+      const rd = rdProp !== null && Number.isFinite(rdProp) && rdProp > 0 ? rdProp : 0;
+      span = dur * (rep + 1) + rd * rep;
+    }
+    const contrib = c3.pos !== null ? Number(c3.pos) + span : span;
+    if (contrib > 0)
+      parsed++;
+    if (c3.pos !== null)
+      maxEnd = Math.max(maxEnd, Number(c3.pos) + span);
+    else
+      chain += span;
+  }
+  const raw = Math.max(chain, maxEnd);
+  const est = Number.isFinite(raw) ? Math.round(raw * 1000) / 1000 : raw;
+  return { est, parsed, skipped, hasInfiniteRepeat };
+}
+var TL_HOOKS = ["onUpdate", "onStart", "onComplete", "onRepeat"];
+var DOM_WRITE = /\.setAttribute(?:NS)?\s*\(|\.textContent\s*=(?!=)|\.inner(?:HTML|Text)\s*=(?!=)|\.style\.[A-Za-z_$][\w$]*\s*=(?!=)|\.style\.setProperty\s*\(|\.classList\s*\.\s*(?:add|remove|toggle|replace)\s*\(/;
+function skipString(src, i) {
+  const q = src[i];
+  for (let j = i + 1;j < src.length; j++) {
+    if (src[j] === "\\") {
+      j++;
+      continue;
+    }
+    if (src[j] === q)
+      return j;
+  }
+  return src.length;
+}
+function braceBlock(src, open2) {
+  let depth = 0;
+  for (let i = open2;i < src.length; i++) {
+    const c3 = src[i];
+    if (c3 === '"' || c3 === "'" || c3 === "`") {
+      i = skipString(src, i);
+      continue;
+    }
+    if (c3 === "/" && src[i + 1] === "/") {
+      const nl = src.indexOf(`
+`, i);
+      i = nl < 0 ? src.length : nl;
+      continue;
+    }
+    if (c3 === "/" && src[i + 1] === "*") {
+      const e = src.indexOf("*/", i + 2);
+      i = e < 0 ? src.length : e + 1;
+      continue;
+    }
+    if (c3 === "{")
+      depth++;
+    else if (c3 === "}" && --depth === 0)
+      return src.slice(open2 + 1, i);
+  }
+  return src.slice(open2 + 1);
+}
+function namedFnBody(html, name) {
+  const n = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const decl = new RegExp(`\\bfunction\\s+${n}\\s*\\([^)]*\\)\\s*\\{`).exec(html);
+  if (decl)
+    return braceBlock(html, decl.index + decl[0].length - 1);
+  const assign = new RegExp(`\\b(?:var|let|const)\\s+${n}\\s*=\\s*(?:function\\s*[\\w$]*\\s*\\([^)]*\\)|\\([^)]*\\)\\s*=>|[A-Za-z_$][\\w$]*\\s*=>)\\s*\\{`).exec(html);
+  if (assign)
+    return braceBlock(html, assign.index + assign[0].length - 1);
+  return null;
+}
+var NOT_A_CALL = new Set(["if", "for", "while", "switch", "catch", "return", "function", "typeof", "new", "delete", "void", "in", "of", "do", "else"]);
+function bodyWritesDom(html, body, hops, seen) {
+  if (DOM_WRITE.test(body))
+    return true;
+  if (hops <= 0)
+    return false;
+  for (const m of body.matchAll(/\b([A-Za-z_$][\w$]*)\s*\(/g)) {
+    const name = m[1];
+    if (NOT_A_CALL.has(name) || seen.has(name))
+      continue;
+    seen.add(name);
+    const b = namedFnBody(html, name);
+    if (b && bodyWritesDom(html, b, hops - 1, seen))
+      return true;
+  }
+  return false;
+}
+function detectSeekSignals(html) {
+  const hooks = new Set;
+  const hookRe = new RegExp(`\\b(${TL_HOOKS.join("|")})\\s*:\\s*`, "g");
+  let hm;
+  while (hm = hookRe.exec(html)) {
+    const hook = hm[1];
+    const at = hm.index + hm[0].length;
+    const rest = html.slice(at);
+    let body = null;
+    let mm;
+    if (mm = /^function\s*[A-Za-z_$]?[\w$]*\s*\([^)]*\)\s*\{/.exec(rest)) {
+      body = braceBlock(html, at + mm[0].length - 1);
+    } else if (mm = /^(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>\s*/.exec(rest)) {
+      const after = at + mm[0].length;
+      body = html[after] === "{" ? braceBlock(html, after) : rest.slice(mm[0].length).split(`
+`)[0];
+    } else if (mm = /^([A-Za-z_$][\w$]*)/.exec(rest)) {
+      body = namedFnBody(html, mm[1]);
+    }
+    if (body && bodyWritesDom(html, body, 2, new Set))
+      hooks.add(hook);
+  }
+  const overrideForms = [];
+  if (/\.\s*seek\s*=(?!=)|\[\s*["']seek["']\s*\]\s*=(?!=)/.test(html))
+    overrideForms.push("重新赋值 `.seek`");
+  for (const rm of html.matchAll(/window\s*\.\s*__timelines\s*\[[^\]]*\]\s*=\s*([^;\n]*)/g)) {
+    const rhs = rm[1].split("//")[0].trim();
+    if (rhs && !/^[A-Za-z_$][\w$]*$/.test(rhs)) {
+      overrideForms.push("`__timelines[…]` 被赋成包装对象而非时间线本体");
+      break;
+    }
+  }
+  return {
+    callbackDom: hooks.size > 0,
+    hooks: TL_HOOKS.filter((h) => hooks.has(h)),
+    engineApiOverride: overrideForms.length > 0,
+    overrideForms
+  };
+}
 function lintParticle(html, opts = {}) {
   const v = [];
   const push = (law, fatal, msg) => v.push({ law, fatal, msg });
@@ -8133,6 +9382,8 @@ function lintParticle(html, opts = {}) {
   const cid = root ? attr(root, "data-composition-id") : undefined;
   if (!root || !cid)
     push("1-composition-id", true, "根元素缺 data-composition-id");
+  if (opts.compositionId && cid && opts.compositionId !== cid)
+    push("1-cid-expect", true, `HTML 内 data-composition-id「${cid}」与期望 id「${opts.compositionId}」不符（复制改名漏改内部 id？）——` + `按期望 id 落轨会写出 clip_id/material 指向「${opts.compositionId}」，而本文件注册的是 __timelines["${cid}"]，渲染必错`);
   if (root) {
     if (attr(root, "data-width") !== "1920")
       push("1-width", true, `根 data-width 应为 "1920"（实为 ${attr(root, "data-width") ?? "缺"}）`);
@@ -8180,19 +9431,41 @@ function lintParticle(html, opts = {}) {
     if (re.test(html))
       push("4-rel-asset", true, `含相对外链 ${tag}（违反自包含，渲染机读不到）`);
   }
-  const { opaque, declared } = deriveOpaque(root);
+  const { opaque, declared, solidOnRoot, solidOnChild } = deriveOpaque(root, firstChildTag(html, root));
   if (root && !declared)
-    push("4-bg-explicit", false, "根未显式声明 background（透明与否应明确；缺省按透明叠加 opaque=false 处理）");
+    push("4-bg-explicit", false, "根与根下首个全幅子层**都**没有显式声明 background（契约铁律4③：透明与否 MUST 显式）——" + "满屏颗粒应在根下第一个全幅子层（position:absolute;inset:0）声明实心底；" + "透明叠加颗粒应在根显式写 background:transparent。缺省按透明叠加 opaque=false 处理");
+  if (solidOnRoot && !solidOnChild)
+    push("4-bg-on-root", false, "实心底写在**根 style** 上（契约铁律4①②：MUST 下沉为根下第一个全幅子层，根 MUST 保持零视觉）——" + "**根元素的绘制属性会在子合成挂载时被丢弃**，这层底在成片里一个像素都不落地：" + "前景照常渲出、底没了、底轨透出来，观感是「浮空面板」；而本地播放器与客户端预览都看不出（2026-07-26 r69 真渲实测，见契约铁律4证据锚）。" + "改法是机械的：把这条 background 声明整体搬到根下新增的第一个全幅子层" + '（<div style="position:absolute;inset:0;background:<原底色>;z-index:0;"></div>），根上改写 background:transparent');
   if (/var\(\s*--/.test(html))
     push("6-css-var", true, "含 CSS var(--...)（Hyperframes 不解析→整片全黑，须字面值）");
-  const effectiveCid = opts.compositionId ?? cid;
-  if (opts.dispatchIds && effectiveCid && !opts.dispatchIds.includes(effectiveCid))
-    push("x-dispatch", false, `composition_id "${effectiveCid}" 不在 dispatch.mg 派单中`);
+  const sig = detectSeekSignals(html);
+  if (sig.engineApiOverride)
+    push("x-engine-api-override", false, `颗粒在运行时覆写了渲染引擎所调用的 API（${sig.overrideForms.join("、")}）——它会推翻引擎**显式**传入的 ` + `seek(t, true)（颗粒无权静默否决引擎意图），且只在引擎恰好走 seek 时有效，引擎改走 time() / progress() 即完全失效。` + `按契约「回调与 seek 语义」，回调可达性应由**引擎侧**承担，颗粒侧垫片属过渡态——` + `引擎侧结论已于 2026-07-26 经真机核实（引擎 producer 0.6.101 定帧时回调可达），既有垫片可择期清理（删后须重渲复验），新颗粒不应再加`);
+  if (sig.callbackDom && !sig.engineApiOverride)
+    push("x-callback-driven", false, `画面靠时间线回调驱动（${sig.hooks.join(" / ")} 体内写 DOM），且本颗粒无任何 seek 兜底。` + `该写法**合规**——其可达性由契约「回调与 seek 语义」的**引擎侧 MUST 条款**保证` + `（2026-07-26 已真机核实：引擎 producer 0.6.101 定帧时回调可达；结论**绑定该引擎版本**），` + `作者不必也不应为此加装 tl.seek 垫片。本项只是**哨兵**：引擎若失守或换实现，补间属性照常插值、回调不跑 → ` + `画面会静默定格在初始态（不是黑屏，本地播放器与客户端预览都看不出）`);
+  const timers = [
+    /\brequestAnimationFrame\s*\(/.test(html) ? "requestAnimationFrame(" : null,
+    /\bsetInterval\s*\(/.test(html) ? "setInterval(" : null
+  ].filter(Boolean);
+  if (timers.length)
+    push("x-raf-interval", false, `含 ${timers.join(" 与 ")}——这类自有时钟**不被 seek 驱动**，逐帧渲染时等于冻结（契约：所有视觉变化必须挂在 tl 上）。` + `静态正则分不清「驱动画面」与其它用途（如一次性布局测量），故只提醒、不拦`);
+  if (opts.dispatchIds && cid && !opts.dispatchIds.includes(cid))
+    push("x-dispatch", false, `composition_id "${cid}" 不在 dispatch.mg 派单中`);
   if (opts.category && opts.category in CATEGORY_EXPECTED_OPAQUE2) {
     const expect = CATEGORY_EXPECTED_OPAQUE2[opts.category];
     if (expect !== opaque)
       push("x-category-opaque", false, `category「${opts.category}」期望${expect ? "不透明满屏" : "透明叠加"}，但颗粒 HTML 反推为${opaque ? "不透明满屏" : "透明叠加"}（以 HTML 为准落 clip.opaque=${opaque}）`);
   }
+  if (typeof opts.slotDuration === "number" && opts.slotDuration > 0) {
+    const slot = opts.slotDuration;
+    const { est, parsed, skipped, hasInfiniteRepeat } = estimateTimelineSec(html);
+    if (hasInfiniteRepeat)
+      push("7-infinite-repeat", false, `含 repeat:-1 无限循环 → tl 时长为 Infinity，铁律⑦（总长 ≥ 坑位）无法静态验证；请改用按坑位算死的有限 repeat（次数 = ceil(剩余时长 / 单圈时长)），坑位包络 ${slot}s`);
+    if (parsed === 0)
+      push("7-no-estimate", false, `无法静态估长（无一条可解析的时长调用${skipped ? `，${skipped} 条因表达式 position / 非字面量 duration 跳过` : ""}），铁律⑦未校验——须真渲染引擎 seek 验收颗粒是否占满坑位 ${slot}s 并终态驻留`);
+    else if (Number.isFinite(est) && est < slot)
+      push("7-fill-slot", false, `时间线静态估长 ~${est}s，短于槽位包络 ${slot}s（铁律⑦：颗粒应占满坑位并终态驻留）——静态估算是**下界**（${skipped} 条调用因无法静态解析被跳过），仅供参考，最终以真渲染引擎逐帧为准`);
+  }
   return { ok: !v.some((x) => x.fatal), violations: v, opaque, compositionId: cid };
 }
 
@@ -8200,10 +9473,66 @@ function lintParticle(html, opts = {}) {
 var MG_MATERIAL_PREFIX = "mg-";
 var LEGACY_MATERIAL_PREFIX = "rrv-";
 var isOwnMaterialId = (id) => id.startsWith(MG_MATERIAL_PREFIX) || id.startsWith(LEGACY_MATERIAL_PREFIX);
-var r34 = (n) => Math.round(n * 1000) / 1000;
+var OWN_ASSET_DIRS = ["assets/mg/", "assets/rrv/"];
+var normalizeRel2 = (p) => p.replace(/\\/g, "/").replace(/^\.\//, "");
+function ownAssetCompositionId(p) {
+  if (typeof p !== "string")
+    return;
+  const rel = normalizeRel2(p);
+  for (const d of OWN_ASSET_DIRS) {
+    if (!rel.startsWith(d))
+      continue;
+    const name = rel.slice(d.length);
+    if (name.includes("/"))
+      return;
+    return name.replace(/\.html?$/i, "");
+  }
+  return;
+}
+var r36 = (n) => Math.round(n * 1000) / 1000;
+var slotEnvelope = (it) => r36(it.track_ed - it.track_st);
 function layTracksOf(prev) {
   return Array.isArray(prev?.lay_tracks) ? prev.lay_tracks.filter((x) => typeof x === "number") : [];
 }
+function beatsOf(prev) {
+  return Array.isArray(prev?.beats) ? prev.beats.filter((b) => !!b && typeof b.composition_id === "string") : [];
+}
+function clipCompositionId(c3) {
+  const hm = c3.html_material;
+  if (typeof hm === "string") {
+    if (hm.startsWith(MG_MATERIAL_PREFIX))
+      return hm.slice(MG_MATERIAL_PREFIX.length);
+    if (hm.startsWith(LEGACY_MATERIAL_PREFIX))
+      return hm.slice(LEGACY_MATERIAL_PREFIX.length);
+  }
+  if (typeof c3.material === "string")
+    return c3.material;
+  return typeof c3.clip_id === "string" ? c3.clip_id : undefined;
+}
+var stOf = (c3) => typeof c3.track_st === "number" ? c3.track_st : 0;
+function collectClipRefs(c3, into) {
+  for (const k of ["material", "html_material"]) {
+    const v = c3[k];
+    if (typeof v === "string")
+      into.add(v);
+  }
+}
+function collectSurvivingRefs(doc, extraClips) {
+  const refs = new Set;
+  for (const bucket of Object.values(doc)) {
+    if (!Array.isArray(bucket))
+      continue;
+    for (const t of bucket) {
+      if (!t || !Array.isArray(t.track_timeline))
+        continue;
+      for (const c3 of t.track_timeline)
+        collectClipRefs(c3, refs);
+    }
+  }
+  for (const c3 of extraClips)
+    collectClipRefs(c3, refs);
+  return refs;
+}
 function layMgTracks(opts) {
   const { gtrk, items, generatedAt } = opts;
   const beatTracks = [...gtrk.beat_track ?? []];
@@ -8214,15 +9543,37 @@ function layMgTracks(opts) {
   const prevIndices = new Set([...layTracksOf(prevMg), ...layTracksOf(prevRrv)]);
   const removedTracks = beatTracks.filter((t) => typeof t.track_index === "number" && prevIndices.has(t.track_index));
   const keptTracks = beatTracks.filter((t) => !(typeof t.track_index === "number" && prevIndices.has(t.track_index)));
-  const removedMaterialIds = new Set;
+  const ownCompositionIds = new Set([
+    ...beatsOf(prevMg).map((b) => b.composition_id),
+    ...beatsOf(prevRrv).map((b) => b.composition_id),
+    ...items.map((it) => it.composition_id)
+  ]);
   for (const t of removedTracks) {
     for (const c3 of t.track_timeline ?? []) {
-      const hm = c3.html_material;
-      if (typeof hm === "string" && isOwnMaterialId(hm))
-        removedMaterialIds.add(hm);
+      const cid = clipCompositionId(c3);
+      if (cid !== undefined)
+        ownCompositionIds.add(cid);
+    }
+  }
+  const isOwnMaterial = (m) => {
+    if (typeof m.id === "string" && isOwnMaterialId(m.id))
+      return true;
+    const cid = ownAssetCompositionId(m.path);
+    return cid !== undefined && ownCompositionIds.has(cid);
+  };
+  const itemIds = new Set(items.map((it) => it.composition_id));
+  const keepIds = new Set((opts.keep ?? []).filter((id) => !itemIds.has(id)));
+  const carriedClips = [];
+  const carriedIds = new Set;
+  for (const t of removedTracks) {
+    for (const c3 of t.track_timeline ?? []) {
+      const cid = clipCompositionId(c3);
+      if (cid === undefined || !keepIds.has(cid) || carriedIds.has(cid))
+        continue;
+      carriedIds.add(cid);
+      carriedClips.push({ ...c3 });
     }
   }
-  const keptMaterials = materials.filter((m) => !(typeof m.id === "string" && removedMaterialIds.has(m.id)));
   const newMaterials = [];
   const clips = [];
   const metaBeats = [];
@@ -8233,7 +9584,8 @@ function layMgTracks(opts) {
   ].map((t) => typeof t.track_index === "number" ? t.track_index : 0);
   const newIndex = Math.max(9, ...allIndices) + 1;
   for (const it of items) {
-    if (!(it.duration > 0)) {
+    const envelope = slotEnvelope(it);
+    if (!(envelope > 0)) {
       metaBeats.push({ ...toMetaBeat(it), laid: null });
       continue;
     }
@@ -8245,21 +9597,36 @@ function layMgTracks(opts) {
       html_material: materialId,
       opaque: it.opaque,
       track_st: it.track_st,
-      duration: it.duration
+      duration: envelope
     });
     metaBeats.push({ ...toMetaBeat(it), laid: { track_index: newIndex } });
   }
-  const createdTracks = clips.length > 0 ? [
-    {
-      track_index: newIndex,
-      track_timeline: clips.sort((a, b) => a.track_st - b.track_st)
-    }
-  ] : [];
+  const mergedClips = [...carriedClips, ...clips].sort((a, b) => stOf(a) - stOf(b));
+  const createdTracks = mergedClips.length > 0 ? [{ track_index: newIndex, track_timeline: mergedClips }] : [];
+  const survivingRefs = collectSurvivingRefs({ ...gtrk, beat_track: keptTracks }, carriedClips);
+  const newMaterialIds = new Set(newMaterials.map((m) => String(m.id)));
+  const keptMaterials = materials.filter((m) => {
+    if (typeof m.id !== "string")
+      return true;
+    if (newMaterialIds.has(m.id))
+      return false;
+    if (!isOwnMaterial(m))
+      return true;
+    return survivingRefs.has(m.id);
+  });
+  const carriedBeats = [];
+  const seenCarriedBeat = new Set;
+  for (const b of [...beatsOf(prevMg), ...beatsOf(prevRrv)]) {
+    if (!keepIds.has(b.composition_id) || seenCarriedBeat.has(b.composition_id))
+      continue;
+    seenCarriedBeat.add(b.composition_id);
+    carriedBeats.push({ ...b, laid: carriedIds.has(b.composition_id) ? { track_index: newIndex } : null });
+  }
   const mg = {
     contract_version: "v1",
     generated_at: generatedAt,
     lay_tracks: createdTracks.map((t) => t.track_index),
-    beats: metaBeats
+    beats: [...carriedBeats, ...metaBeats]
   };
   const nextStructMeta = { ...structMeta, mg };
   delete nextStructMeta.rrv;
@@ -8271,7 +9638,11 @@ function layMgTracks(opts) {
   };
   return {
     next,
-    summary: { laidTrack: createdTracks[0]?.track_index ?? null, laidParticles: clips.length },
+    summary: {
+      laidTrack: createdTracks[0]?.track_index ?? null,
+      laidParticles: clips.length,
+      keptParticles: carriedClips.length
+    },
     mg
   };
 }
@@ -8280,8 +9651,8 @@ function toMetaBeat(it) {
     beat: it.beat,
     composition_id: it.composition_id,
     track_st: it.track_st,
-    track_ed: r34(it.track_ed),
-    duration: it.duration,
+    track_ed: r36(it.track_ed),
+    duration: slotEnvelope(it),
     html_path: it.html_rel,
     ...it.category ? { category: it.category } : {}
   };
@@ -8291,7 +9662,7 @@ function toMetaBeat(it) {
 var MG_ASSET_DIR = "assets/mg";
 var MG_SRC_DIRS = ["mg", "rrv"];
 function registerMg(program2) {
-  program2.command("mg [words...]").alias("rrv").description("MG 颗粒铺轨：无 positional=消费 dispatch.mg 铺 html-particle；`mg lint <file>`=单文件 lint；`mg status`=看板").option("--project <dir>", "oralcut 产物目录（定位 split/dispatch.json 与工程）").option("--dispatch <path>", "显式指定 dispatch.json（非标准布局兜底）").option("--only <beat>", "只跑单 beat").option("--lint-only", "只 lint 校验，不铺轨不写回").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (words, opts) => {
+  program2.command("mg [words...]").alias("rrv").description("MG 颗粒铺轨：无 positional=消费 dispatch.mg 铺 html-particle；`mg lint <file>`=单文件 lint；`mg status`=看板").option("--project <dir>", "oralcut 产物目录（定位 split/dispatch.json 与工程）").option("--dispatch <path>", "显式指定 dispatch.json（非标准布局兜底）").option("--only <beat>", "只跑单 beat（收 beat id 如 B12，非 composition_id）：增量重铺该 beat，轨上其余已铺颗粒原样保留").option("--lint-only", "只 lint 校验，不铺轨不写回").option("--replace-all", "显式授权重置整轨：不走增量保留、整轨剥掉重铺——会删掉轨上其余已铺颗粒（不在本次派单/--only 里的那些）").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (words, opts) => {
     if (process.argv[2] === "rrv")
       log.warn("`gtrk rrv` 已更名为 `gtrk mg`（去品牌化），别名仍可用但建议改用 `gtrk mg`。");
     await runMg(words ?? [], opts);
@@ -8311,53 +9682,115 @@ async function runMg(words, opts) {
 }
 function resolveDispatch(opts) {
   if (opts.dispatch) {
-    const dispatchPath = resolve9(opts.dispatch);
+    const dispatchPath = resolve10(opts.dispatch);
     return { dispatchPath, baseDir: dirname8(dirname8(dispatchPath)) };
   }
   if (opts.project) {
-    const baseDir = resolve9(opts.project);
-    return { dispatchPath: join20(baseDir, "split", "dispatch.json"), baseDir };
+    const baseDir = resolve10(opts.project);
+    return { dispatchPath: join21(baseDir, "split", "dispatch.json"), baseDir };
   }
   throw new Error("需 --project <目录> 或显式 --dispatch <path>");
 }
 function locateGtrk2(baseDir) {
-  return [join20(baseDir, "gtrk", "project.gtrk"), join20(baseDir, "project.gtrk")].find((p) => existsSync16(p));
+  return [join21(baseDir, "gtrk", "project.gtrk"), join21(baseDir, "project.gtrk")].find((p) => existsSync18(p));
 }
 function locateSrcHtml(baseDir, compositionId) {
   for (const d of MG_SRC_DIRS) {
-    const p = join20(baseDir, d, `${compositionId}.html`);
-    if (existsSync16(p))
+    const p = join21(baseDir, d, `${compositionId}.html`);
+    if (existsSync18(p))
       return p;
   }
   return;
 }
 async function readMgQueue(dispatchPath) {
-  if (!existsSync16(dispatchPath))
+  if (!existsSync18(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split 落地派单）`);
-  const dispatch = JSON.parse(await readFile6(dispatchPath, "utf8"));
+  const dispatch = JSON.parse(await readFile7(dispatchPath, "utf8"));
   const queue = dispatch.mg ?? dispatch.rrv_mg;
   return Array.isArray(queue) ? queue : [];
 }
+function laidCompositionIds(gtrk) {
+  if (!gtrk)
+    return [];
+  const structMeta = gtrk.struct_meta;
+  const ids = [];
+  const seen = new Set;
+  for (const meta of [structMeta?.mg, structMeta?.rrv]) {
+    for (const b of meta?.beats ?? []) {
+      if (!b?.laid || typeof b.composition_id !== "string" || seen.has(b.composition_id))
+        continue;
+      seen.add(b.composition_id);
+      ids.push(b.composition_id);
+    }
+  }
+  return ids;
+}
 async function runLay(opts) {
   const { dispatchPath, baseDir } = resolveDispatch(opts);
-  let queue = await readMgQueue(dispatchPath);
-  if (opts.only)
-    queue = queue.filter((q) => q.beat === opts.only);
+  const allQueue = await readMgQueue(dispatchPath);
+  const queue = opts.only ? allQueue.filter((q) => q.beat === opts.only) : allQueue;
   log.step(`▶ MG 颗粒铺轨：${queue.length} 个 beat…`);
+  if (opts.only && queue.length === 0) {
+    const beats = [...new Set(allQueue.map((q) => q.beat))];
+    log.warn(`--only ${opts.only} 未命中任何 beat——该选择器收的是「beat id」（如 B12），不是 composition_id（如 <slug>-B12）。`);
+    log.warn(`dispatch 现有 beat：${beats.slice(0, 12).join("、") || "（空）"}${beats.length > 12 ? ` …共 ${beats.length} 个` : ""}`);
+  }
+  const gtrkPath = locateGtrk2(baseDir);
+  let project;
+  let gtrkUnreadable = false;
+  if (gtrkPath) {
+    try {
+      project = readGtrk(gtrkPath);
+    } catch (e) {
+      if (!opts.lintOnly)
+        throw e;
+      gtrkUnreadable = true;
+    }
+  }
+  if (!opts.lintOnly && project)
+    assertGtrkV1(project.gtrk);
+  const laidBefore = laidCompositionIds(opts.lintOnly ? undefined : project?.gtrk);
+  const reproj = await reprojectDispatchWindows({
+    baseDir,
+    gtrk: project?.gtrk,
+    gtrkUnreadable,
+    entries: queue.map((q) => ({
+      key: q.composition_id,
+      beat: q.beat,
+      compositionId: q.composition_id,
+      span: q.span,
+      track_st: q.track_st,
+      track_ed: q.track_ed
+    }))
+  });
+  reportReprojection(reproj);
   const dispatchIds = queue.map((q) => q.composition_id);
   const items = [];
   const srcByComp = new Map;
   const skipped = [];
+  const windowOf = new Map(reproj.entries.map((o) => [o.key, o]));
   for (const q of queue) {
+    const outcome = windowOf.get(q.composition_id);
+    if (outcome?.dropped) {
+      skipped.push({ beat: q.beat, reason: "重投影后零存活（该段已被剪出成片）" });
+      continue;
+    }
+    const win = outcome ?? { track_st: q.track_st, track_ed: q.track_ed };
     const srcPath = locateSrcHtml(baseDir, q.composition_id);
     if (!srcPath) {
       skipped.push({ beat: q.beat, reason: "缺颗粒 HTML（未产出）" });
-      log.warn(`${q.beat}：缺 ${join20(baseDir, MG_SRC_DIRS[0], `${q.composition_id}.html`)}，跳过`);
+      log.warn(`${q.beat}：缺 ${join21(baseDir, MG_SRC_DIRS[0], `${q.composition_id}.html`)}，跳过`);
       continue;
     }
-    const html = await readFile6(srcPath, "utf8");
+    const html = await readFile7(srcPath, "utf8");
     const category = typeof q.category === "string" ? q.category : undefined;
-    const lint = lintParticle(html, { compositionId: q.composition_id, dispatchIds, category });
+    const slotDuration = Math.round((win.track_ed - win.track_st) * 1000) / 1000;
+    const lint = lintParticle(html, {
+      compositionId: q.composition_id,
+      dispatchIds,
+      category,
+      ...slotDuration > 0 ? { slotDuration } : {}
+    });
     for (const vv of lint.violations)
       (vv.fatal ? log.warn : log.info)(`${q.beat} lint ${vv.fatal ? "✗" : "·"} ${vv.law}: ${vv.msg}`);
     if (!lint.ok) {
@@ -8365,64 +9798,170 @@ async function runLay(opts) {
       log.warn(`${q.beat}：lint 未过，跳过`);
       continue;
     }
-    if (typeof q.duration !== "number" || !(q.duration > 0)) {
-      skipped.push({ beat: q.beat, reason: "duration 非正数" });
+    if (!(slotDuration > 0)) {
+      skipped.push({ beat: q.beat, reason: "槽位包络非正数" });
       continue;
     }
     srcByComp.set(q.composition_id, srcPath);
     items.push({
       beat: q.beat,
       composition_id: q.composition_id,
-      track_st: q.track_st,
-      track_ed: q.track_ed,
-      duration: q.duration,
+      track_st: win.track_st,
+      track_ed: win.track_ed,
       opaque: lint.opaque,
       html_rel: `${MG_ASSET_DIR}/${q.composition_id}.html`,
       ...category ? { category } : {}
     });
   }
   if (opts.lintOnly) {
-    log.ok(`lint-only：${items.length}/${queue.length} 通过，${skipped.length} 跳过（不铺轨）`);
-    return done(opts, { ok: skipped.length === 0, mode: "lay", lintOnly: true, passed: items.length, skipped });
+    const lintOk = skipped.length === 0;
+    (lintOk ? log.ok : log.warn)(`lint-only：${items.length}/${queue.length} 通过，${skipped.length} 跳过（不铺轨）`);
+    return done(opts, {
+      ok: lintOk,
+      mode: "lay",
+      lintOnly: true,
+      ...lintOk ? {} : { reason: "skipped" },
+      passed: items.length,
+      skipped,
+      reprojection: reproj.summary
+    });
   }
-  const gtrkPath = locateGtrk2(baseDir);
-  if (!gtrkPath) {
-    log.warn(`未找到工程文件（${join20(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
-    return done(opts, { ok: true, mode: "lay", laid: 0, skipped, note: "工程缺失，未铺轨" });
+  if (!gtrkPath || !project) {
+    log.warn(`未找到工程文件（${join21(baseDir, "gtrk", "project.gtrk")}），跳过铺轨——lint 已完成`);
+    return done(opts, {
+      ok: skipped.length === 0,
+      mode: "lay",
+      reason: "no_project",
+      laid: 0,
+      laidTrack: null,
+      track_total: 0,
+      removed: 0,
+      kept: 0,
+      kept_ids: [],
+      skipped,
+      note: "工程缺失，未铺轨",
+      reprojection: reproj.summary
+    });
   }
-  const { gtrk, mtimeMs } = readGtrk(gtrkPath);
-  assertGtrkV1(gtrk);
+  const { gtrk, mtimeMs } = project;
   const gtrkDir = dirname8(gtrkPath);
-  await mkdir7(join20(gtrkDir, ...MG_ASSET_DIR.split("/")), { recursive: true });
+  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));
+  const keep = opts.replaceAll ? [] : opts.only ? orphans : orphans.filter((id) => inDispatch.has(id));
+  const keepSet = new Set(keep);
+  const wouldRemove = laidBefore.filter((id) => !covered.has(id) && !keepSet.has(id));
+  const refuse = laidBefore.length > 0 && items.length === 0 ? "empty_queue" : undefined;
+  if (refuse && !opts.replaceAll) {
+    log.err(`拒绝写回：本次一条颗粒都没定位到，而轨上已铺 ${laidBefore.length} 颗——「一条都没定位到」是派单/选择器出问题的信号，不是清空指令。`);
+    if (opts.only && queue.length === 0) {
+      log.warn(`成因：--only ${opts.only} 未命中任何 beat（选择器提示见上）。`);
+    } else if (allQueue.length === 0) {
+      log.warn("dispatch.mg（读旧 rrv_mg）为空或缺失——先跑 gtrk split 落地派单，再铺轨。");
+    } else {
+      log.warn(`本次 ${queue.length} 个条目全部被跳过（${[...new Set(skipped.map((s) => s.reason))].join("、")}）——先按上面的 lint 报因补产 / 修颗粒，再重铺。`);
+    }
+    if (wouldRemove.length) {
+      const preview = wouldRemove.slice(0, 8);
+      log.warn(`将被铲掉：${preview.join("、")}${wouldRemove.length > preview.length ? ` …等共 ${wouldRemove.length} 颗` : ""}`);
+    }
+    log.warn("出路二选一：① 按上面的报因修好派单 / 选择器 / 颗粒后重铺；② 确知要清空整轨 → 加 --replace-all 显式授权（会删掉轨上全部已铺颗粒）");
+    log.warn(`工程未被改动（.gtrk 逐字节不变，轨上仍 ${laidBefore.length} 颗）。`);
+    return done(opts, {
+      ok: false,
+      mode: "lay",
+      reason: refuse,
+      refused: true,
+      laid: 0,
+      laidTrack: null,
+      track_total: laidBefore.length,
+      removed: 0,
+      kept: 0,
+      kept_ids: [],
+      blocked: wouldRemove,
+      skipped,
+      reprojection: reproj.summary
+    });
+  }
+  if (opts.replaceAll && orphans.length > 0) {
+    log.warn(`--replace-all：已显式授权重置整轨，轨上其余 ${orphans.length} 颗已铺颗粒将被剥离（不走增量保留）。`);
+  }
+  await mkdir7(join21(gtrkDir, ...MG_ASSET_DIR.split("/")), { recursive: true });
   for (const it of items) {
-    await copyFile(srcByComp.get(it.composition_id), join20(gtrkDir, ...it.html_rel.split("/")));
+    await copyFile(srcByComp.get(it.composition_id), join21(gtrkDir, ...it.html_rel.split("/")));
+  }
+  const { next, summary, mg } = layMgTracks({ gtrk, items, generatedAt: new Date().toISOString(), keep });
+  const written = withTimecodeSource(next, "mg", reproj);
+  writeGtrkAtomic(gtrkPath, written, mtimeMs);
+  const integrity = safeCheckMaterialIntegrity({ gtrk: written, gtrkDir, log });
+  const trackTotal = mg.beats.filter((b) => b.laid).length;
+  const keptIds = mg.beats.filter((b) => b.laid && keepSet.has(b.composition_id)).map((b) => b.composition_id);
+  const removed = laidBefore.length - keptIds.length;
+  const ok = skipped.length === 0;
+  const tail = `本次 ${summary.laidParticles} 颗 / 轨上共 ${trackTotal} 颗${keptIds.length ? `（保留 ${keptIds.length} 颗）` : ""}` + ` → beat_track ${summary.laidTrack ?? "-"}` + `${removed ? `（剥旧 ${removed} 颗）` : ""}${skipped.length ? `（${skipped.length} beat 跳过）` : ""}`;
+  if (summary.laidTrack === null)
+    log.warn(`未铺成任何颗粒：${tail}`);
+  else if (ok)
+    log.ok(`铺轨完成：${tail}`);
+  else
+    log.warn(`铺轨完成（有跳过）：${tail}`);
+  if (keptIds.length) {
+    const preview = keptIds.slice(0, 8);
+    log.warn(`其中 ${keptIds.length} 颗是上轮遗留、本次未重铺：${preview.join("、")}${keptIds.length > preview.length ? ` …等共 ${keptIds.length} 颗` : ""}` + `——轨上内容 = 本次 ${summary.laidParticles} 颗 + 上轮 ${keptIds.length} 颗，与本次派单不完全对应（要全部刷新就去掉 --only 全量重铺）。`);
   }
-  const { next, summary } = layMgTracks({ gtrk, items, generatedAt: new Date().toISOString() });
-  writeGtrkAtomic(gtrkPath, next, mtimeMs);
-  log.ok(`铺轨完成：${summary.laidParticles} 颗粒 → beat_track ${summary.laidTrack ?? "-"}` + `${skipped.length ? `（${skipped.length} beat 跳过）` : ""}`);
   log.info("opencut 打开工程即见 MG overlay 轨（预览需 add-particle-project-folder-preview 上线）；出片时客户端云渲。");
+  if (integrity)
+    reportMaterialIntegrity(integrity, log);
   return done(opts, {
-    ok: true,
+    ok,
     mode: "lay",
+    ...ok ? {} : { reason: "skipped" },
     laid: summary.laidParticles,
     laidTrack: summary.laidTrack,
-    skipped
+    track_total: trackTotal,
+    removed,
+    kept: keptIds.length,
+    kept_ids: keptIds,
+    skipped,
+    ...integrity ? { integrity } : {},
+    reprojection: reproj.summary
   });
 }
+var CID_SHAPE = /-B\d+(?:-aux\d+)?$/;
 async function runLint(args, opts) {
   const file = args[0];
   if (!file)
     throw new Error("用法：gtrk mg lint <particle.html> [--dispatch <path>]");
-  const html = await readFile6(resolve9(file), "utf8");
+  const html = await readFile7(resolve10(file), "utf8");
+  const nameId = basename11(file).replace(/\.html?$/i, "");
   let dispatchIds;
-  if (opts.dispatch && existsSync16(resolve9(opts.dispatch))) {
-    dispatchIds = (await readMgQueue(resolve9(opts.dispatch))).map((q) => q.composition_id);
-  }
-  const lint = lintParticle(html, { dispatchIds });
+  let slotDuration;
+  let compositionId;
+  if (opts.dispatch && existsSync18(resolve10(opts.dispatch))) {
+    const queue = await readMgQueue(resolve10(opts.dispatch));
+    dispatchIds = queue.map((q) => q.composition_id);
+    const byName = queue.find((q) => q.composition_id === nameId);
+    const innerCid = parseCompositionId(html);
+    const hit = byName ?? (innerCid ? queue.find((q) => q.composition_id === innerCid) : undefined);
+    if (hit) {
+      const d = Math.round((hit.track_ed - hit.track_st) * 1000) / 1000;
+      if (d > 0)
+        slotDuration = d;
+    }
+    if (byName)
+      compositionId = byName.composition_id;
+  }
+  if (compositionId === undefined && CID_SHAPE.test(nameId))
+    compositionId = nameId;
+  const lint = lintParticle(html, {
+    ...dispatchIds ? { dispatchIds } : {},
+    ...compositionId ? { compositionId } : {},
+    ...slotDuration ? { slotDuration } : {}
+  });
   for (const vv of lint.violations)
     (vv.fatal ? log.err : log.warn)(`${vv.fatal ? "✗" : "·"} ${vv.law}: ${vv.msg}`);
   if (lint.ok)
-    log.ok(`lint 通过（${basename10(file)}；opaque=${lint.opaque}）`);
+    log.ok(`lint 通过（${basename11(file)}；opaque=${lint.opaque}）`);
   else
     log.err(`lint 未过（${lint.violations.filter((v) => v.fatal).length} 项致命）`);
   const result = { mode: "lint", ...lint, ok: lint.ok };
@@ -8456,6 +9995,8 @@ async function runStatus(opts) {
   return done(opts, { ok: true, mode: "status", total: queue.length, authored, laid, rows });
 }
 function done(opts, result) {
+  if (!result.ok)
+    process.exitCode = 1;
   if (opts.json)
     console.log(JSON.stringify(result));
   return result;
@@ -9444,9 +10985,9 @@ function validateRegistry(registry = TOOL_REGISTRY) {
 }
 
 // src/lib/tool-runner.ts
-import { resolve as resolve10, join as join21, dirname as dirname9, basename as basename11, extname as extname5 } from "node:path";
+import { resolve as resolve11, join as join22, dirname as dirname9, basename as basename12, extname as extname5 } from "node:path";
 import { mkdir as mkdir8, writeFile as writeFile8, stat as stat5 } from "node:fs/promises";
-import { createWriteStream, existsSync as existsSync17 } from "node:fs";
+import { createWriteStream, existsSync as existsSync19 } from "node:fs";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline } from "node:stream/promises";
 
@@ -9576,7 +11117,7 @@ function validateToolInput(descriptor, inputAbs) {
     return;
   if (!inputAbs)
     throw new Error(`${descriptor.name} 需要输入${spec.kind === "directory" ? "目录" : "文件"}`);
-  if (!existsSync17(inputAbs))
+  if (!existsSync19(inputAbs))
     throw new Error(`输入不存在：${inputAbs}`);
   if (spec.kind === "directory")
     return;
@@ -9643,12 +11184,12 @@ function timestamp3() {
 }
 function resolveOutDir(descriptor, inputAbs, out) {
   if (out)
-    return resolve10(out);
+    return resolve11(out);
   if (inputAbs) {
-    const base = basename11(inputAbs, extname5(inputAbs));
-    return join21(dirname9(inputAbs), `${base}-${descriptor.name}`);
+    const base = basename12(inputAbs, extname5(inputAbs));
+    return join22(dirname9(inputAbs), `${base}-${descriptor.name}`);
   }
-  return join21(process.cwd(), `${descriptor.name}-${timestamp3()}`);
+  return join22(process.cwd(), `${descriptor.name}-${timestamp3()}`);
 }
 async function safeFingerprint(inputAbs) {
   try {
@@ -9663,8 +11204,8 @@ function emitBilling(hint) {
 `);
 }
 async function runCloudTool(descriptor, inputArg, opts, deps) {
-  const inputAbs = inputArg ? resolve10(inputArg) : undefined;
-  const baseName = inputAbs ? basename11(inputAbs, extname5(inputAbs)) : descriptor.name;
+  const inputAbs = inputArg ? resolve11(inputArg) : undefined;
+  const baseName = inputAbs ? basename12(inputAbs, extname5(inputAbs)) : descriptor.name;
   validateToolInput(descriptor, inputAbs);
   const probe = deps.probeDurationSec ?? probeDuration;
   guardDuration(descriptor, inputAbs, probe, opts.ffmpegPath);
@@ -9701,13 +11242,13 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     uploadCached: deps.uploadCached,
     invalidateUpload: deps.invalidateUpload,
     submitTask: deps.submitTask,
-    sleep: deps.sleep ?? ((ms) => new Promise((resolve11) => setTimeout(resolve11, ms)))
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve12) => setTimeout(resolve12, ms)))
   });
   const { taskId } = submitted;
   const up = { fileId: submitted.fileId, cached: submitted.cached };
   await mkdir8(outDir, { recursive: true });
   const fingerprint2 = inputAbs ? await safeFingerprint(inputAbs) : undefined;
-  await writeFile8(join21(outDir, "task.json"), JSON.stringify({ tool: descriptor.name, taskType, taskId, fileId: up.fileId, source: inputAbs, fingerprint: fingerprint2, createdAt: new Date().toISOString() }, null, 2));
+  await writeFile8(join22(outDir, "task.json"), JSON.stringify({ tool: descriptor.name, taskType, taskId, fileId: up.fileId, source: inputAbs, fingerprint: fingerprint2, createdAt: new Date().toISOString() }, null, 2));
   const output = await pollToolTask(deps.cfg, taskType, taskId, {
     timeoutMs: descriptor.pollTimeoutMs,
     intervalMs: deps.pollIntervalMs,
@@ -9720,7 +11261,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 = join21(outDir, it.filename);
+    const dest = join22(outDir, it.filename);
     try {
       await deps.downloadStream(it.url, dest);
       files.push(dest);
@@ -9731,7 +11272,7 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   let resultFile;
   const structured = descriptor.mapResult ? descriptor.mapResult(outputResult, ctx) : undefined;
   if (structured != null) {
-    resultFile = join21(outDir, "result-output.json");
+    resultFile = join22(outDir, "result-output.json");
     await writeFile8(resultFile, JSON.stringify(structured, null, 2));
   }
   if (items.length === 0 && resultFile == null) {
@@ -9749,14 +11290,14 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     ...resultFile ? { resultFile } : {},
     ...Object.keys(errors).length ? { errors } : {}
   };
-  await writeFile8(join21(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
+  await writeFile8(join22(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: new Date().toISOString() }, null, 2));
   return result;
 }
 
 // src/lib/mad/mad.ts
 import { mkdir as mkdir11, writeFile as writeFile10 } from "node:fs/promises";
-import { existsSync as existsSync20, statSync as statSync3 } from "node:fs";
-import { resolve as resolve11, join as join25 } from "node:path";
+import { existsSync as existsSync22, statSync as statSync3 } from "node:fs";
+import { resolve as resolve12, join as join26 } from "node:path";
 
 // src/lib/convert/types.ts
 function num(v, d = 0) {
@@ -10070,14 +11611,14 @@ var FX_MATCHNAME = {
 function esc(s) {
   return String(s).replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\r/g, "\\r").replace(/\n/g, "\\n").replace(/\t/g, "\\t").replace(new RegExp(String.fromCharCode(8232), "g"), "\\u2028").replace(new RegExp(String.fromCharCode(8233), "g"), "\\u2029");
 }
-function r35(v) {
+function r37(v) {
   return Math.round(v * 1000) / 1000;
 }
 function colorArr(css, fallback) {
   const c3 = parseCssColor(css);
   if (!c3)
     return fallback;
-  return [r35(c3[0] / 255), r35(c3[1] / 255), r35(c3[2] / 255)];
+  return [r37(c3[0] / 255), r37(c3[1] / 255), r37(c3[2] / 255)];
 }
 function easeInfluence(e) {
   const cb = parseCubicBezier(e);
@@ -10093,7 +11634,7 @@ function emitKeys(ctx, propExpr, keys) {
   L.push(`  try {`);
   L.push(`    var p = ${propExpr};`);
   for (const k of keys) {
-    L.push(`    p.setValueAtTime(${r35(k.t)}, ${k.value});`);
+    L.push(`    p.setValueAtTime(${r37(k.t)}, ${k.value});`);
   }
   keys.forEach((k, i) => {
     const inf = easeInfluence(k.e);
@@ -10102,7 +11643,7 @@ function emitKeys(ctx, propExpr, keys) {
     L.push(`    try {`);
     L.push(`      var dim = 1; try { dim = p.value.length || 1; } catch (e) { dim = 1; }`);
     L.push(`      var eo = [], ei = [];`);
-    L.push(`      for (var d = 0; d < Math.min(dim, 3); d++) { eo.push(new KeyframeEase(0, ${r35(inf.out)})); ei.push(new KeyframeEase(0, ${r35(inf.inn)})); }`);
+    L.push(`      for (var d = 0; d < Math.min(dim, 3); d++) { eo.push(new KeyframeEase(0, ${r37(inf.out)})); ei.push(new KeyframeEase(0, ${r37(inf.inn)})); }`);
     L.push(`      p.setTemporalEaseAtKey(${i + 1}, ei, eo);`);
     L.push(`    } catch (e) {}`);
   });
@@ -10183,10 +11724,10 @@ function positionBaseKeys(anim, pos) {
   if (!(anim.x?.length || anim.y?.length))
     return [];
   const merged = mergeChannelTracks(anim.x, anim.y, pos[0], pos[1]);
-  return merged.map((k) => ({ t: k.t, value: `[${r35(k.a)}, ${r35(k.b)}]`, e: k.e }));
+  return merged.map((k) => ({ t: k.t, value: `[${r37(k.a)}, ${r37(k.b)}]`, e: k.e }));
 }
 function scaleBaseKeys(anim, coverExpr) {
-  const sc = (v) => coverExpr ? `${r35(v)}*${coverExpr}` : `${r35(v)}`;
+  const sc = (v) => coverExpr ? `${r37(v)}*${coverExpr}` : `${r37(v)}`;
   if (anim.scale?.length) {
     return anim.scale.map((k) => ({ t: k.t, value: `[${sc(num(k.v, 1) * 100)}, ${sc(num(k.v, 1) * 100)}]`, e: k.e }));
   }
@@ -10206,13 +11747,13 @@ function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
   const pos = [num(ly.pos?.[0], 0), num(ly.pos?.[1], 0)];
   const inn = num(ly.in, 0);
   const out = Math.max(inn + 0.01, num(ly.out, inn + 1));
-  const sc = (v) => coverExpr ? `${r35(v)}*${coverExpr}` : `${r35(v)}`;
+  const sc = (v) => coverExpr ? `${r37(v)}*${coverExpr}` : `${r37(v)}`;
   const brights = tracks.filter((t) => t.prop === "brightness");
   if (brights.length) {
     ctx.lines.push(`  // fx: flicker → 亮度脉冲（ADBE Brightness & Contrast 2，避开 opacity 通道）`);
     ctx.lines.push(`  var flkFx = null; try { flkFx = ${layerVar}.property("ADBE Effect Parade").addProperty("ADBE Brightness & Contrast 2"); } catch (e) { flkFx = null; }`);
     for (const bt of brights) {
-      const keys = bt.times.map((t, i) => ({ t, value: `${r35(bt.values[i][0])}`, e: null }));
+      const keys = bt.times.map((t, i) => ({ t, value: `${r37(bt.values[i][0])}`, e: null }));
       emitKeys(ctx, `flkFx.property(1)`, keys);
     }
   }
@@ -10224,12 +11765,12 @@ function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
     for (const bt of posBaked) {
       windows.push(bt.window);
       for (let i = 0;i < bt.times.length; i++) {
-        bakedKeys.push({ t: bt.times[i], value: `[${r35(bt.values[i][0])}, ${r35(bt.values[i][1])}]`, e: null });
+        bakedKeys.push({ t: bt.times[i], value: `[${r37(bt.values[i][0])}, ${r37(bt.values[i][1])}]`, e: null });
       }
     }
     const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => {
       const [x, y] = samplePos(anim, pos, t);
-      return `[${r35(x)}, ${r35(y)}]`;
+      return `[${r37(x)}, ${r37(y)}]`;
     }, inn, out);
     emitKeys(ctx, `${tf}.property("ADBE Position")`, merged);
   }
@@ -10252,15 +11793,15 @@ function emitBakedOps(ctx, ly, layerVar, tf, coverExpr) {
   }
   const rotBaked = tracks.filter((t) => t.prop === "rotation");
   if (rotBaked.length) {
-    const baseKeys = (anim.rot ?? []).map((k) => ({ t: k.t, value: `${r35(num(k.v, 0))}`, e: k.e }));
+    const baseKeys = (anim.rot ?? []).map((k) => ({ t: k.t, value: `${r37(num(k.v, 0))}`, e: k.e }));
     const bakedKeys = [];
     const windows = [];
     for (const bt of rotBaked) {
       windows.push(bt.window);
       for (let i = 0;i < bt.times.length; i++)
-        bakedKeys.push({ t: bt.times[i], value: `${r35(bt.values[i][0])}`, e: null });
+        bakedKeys.push({ t: bt.times[i], value: `${r37(bt.values[i][0])}`, e: null });
     }
-    const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => `${r35(sampleTrack(anim.rot, t, 0))}`, inn, out);
+    const merged = mergeBaked(baseKeys, bakedKeys, windows, (t) => `${r37(sampleTrack(anim.rot, t, 0))}`, inn, out);
     emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, merged);
   }
 }
@@ -10276,11 +11817,11 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
   const py = num(ly.pos?.[1], c3.h / 2);
   const name = esc(`${ly.id || "L" + id} [${ly.type}]`);
   L.push(``);
-  L.push(`  // ---- 层 ${name} in=${r35(inn)} out=${r35(out)} ----`);
+  L.push(`  // ---- 层 ${name} in=${r37(inn)} out=${r37(out)} ----`);
   if (ly.type === "group") {
-    L.push(`  var ${v} = ${cv}.layers.addNull(${r35(c3.duration)});`);
+    L.push(`  var ${v} = ${cv}.layers.addNull(${r37(c3.duration)});`);
     L.push(`  ${v}.name = "${name}";`);
-    L.push(`  ${v}.inPoint = ${r35(inn)}; ${v}.outPoint = ${r35(out)};`);
+    L.push(`  ${v}.inPoint = ${r37(inn)}; ${v}.outPoint = ${r37(out)};`);
     L.push(`  ${v}.property("ADBE Transform Group").property("ADBE Anchor Point").setValue([0,0]);`);
     L.push(`  ${v}.property("ADBE Transform Group").property("ADBE Position").setValue([0,0]);`);
     if (parentNullVar)
@@ -10300,18 +11841,18 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
     const srcOffset = num(footageHit.srcOffset, 0);
     const cvv = `cv${id}`;
     coverExpr = cvv;
-    L.push(`  // 素材注入(${esc(String(ly.type))}): footage srcOffset=${r35(srcOffset)}`);
+    L.push(`  // 素材注入(${esc(String(ly.type))}): footage srcOffset=${r37(srcOffset)}`);
     L.push(`  var ${v} = null, ${cvv} = 1;`);
     L.push(`  if (${fgVar} != null) {`);
     L.push(`    try {`);
     L.push(`      ${v} = ${cv}.layers.add(${fgVar});`);
     L.push(`      var _fw = ${fgVar}.width || ${slotW}, _fh = ${fgVar}.height || ${slotH};`);
     L.push(`      ${cvv} = Math.max(${slotW} / _fw, ${slotH} / _fh);`);
-    L.push(`      ${v}.startTime = ${r35(inn)} - ${r35(srcOffset)};`);
+    L.push(`      ${v}.startTime = ${r37(inn)} - ${r37(srcOffset)};`);
     L.push(`    } catch (e) { ${v} = null; }`);
     L.push(`  }`);
     L.push(`  if (${v} == null) {`);
-    L.push(`    ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${slotW}, ${slotH}, 1, ${r35(c3.duration)});`);
+    L.push(`    ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${slotW}, ${slotH}, 1, ${r37(c3.duration)});`);
     L.push(`    ${cvv} = 1;`);
     L.push(`  }`);
   } else if (ly.type === "text") {
@@ -10332,15 +11873,15 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
     const h = Math.max(2, Math.round(num(ly.h, 400)));
     if (ly.shape === "ellipse")
       L.push(`  // TODO: 原层为椭圆形状,固态占位,可手动换 shape layer`);
-    L.push(`  var ${v} = ${cv}.layers.addSolid([${col.join(",")}], "${name}", ${w}, ${h}, 1, ${r35(c3.duration)});`);
+    L.push(`  var ${v} = ${cv}.layers.addSolid([${col.join(",")}], "${name}", ${w}, ${h}, 1, ${r37(c3.duration)});`);
   } else {
     const w = Math.max(2, Math.round(num(ly.w, c3.w)));
     const h = Math.max(2, Math.round(num(ly.h, c3.h)));
     L.push(`  // 占位素材(${esc(String(ly.type))}${ly.asset ? ` asset=${esc(String(ly.asset))}` : ""}): 请替换为真实素材`);
-    L.push(`  var ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${w}, ${h}, 1, ${r35(c3.duration)});`);
+    L.push(`  var ${v} = ${cv}.layers.addSolid([0.35,0.35,0.4], "${name} [占位]", ${w}, ${h}, 1, ${r37(c3.duration)});`);
   }
   L.push(`  ${v}.name = "${name}";`);
-  L.push(`  ${v}.inPoint = ${r35(inn)}; ${v}.outPoint = ${r35(out)};`);
+  L.push(`  ${v}.inPoint = ${r37(inn)}; ${v}.outPoint = ${r37(out)};`);
   if (parentNullVar)
     L.push(`  try { ${v}.parent = ${parentNullVar}; } catch (e) {}`);
   if (ly.blend && ly.blend !== "normal") {
@@ -10350,7 +11891,7 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
       L.push(`  try { ${v}.blendingMode = BlendingMode.${bm}; } catch (e) {}`);
   }
   const tf = `${v}.property("ADBE Transform Group")`;
-  L.push(`  ${tf}.property("ADBE Position").setValue([${r35(px)}, ${r35(py)}]);`);
+  L.push(`  ${tf}.property("ADBE Position").setValue([${r37(px)}, ${r37(py)}]);`);
   const anim = ly.anim ?? {};
   const bakedProps = new Set(ctx.bakeOps ? bakeLayerOps(ly).tracks.map((t) => t.prop) : []);
   if ((anim.x?.length || anim.y?.length) && !bakedProps.has("position")) {
@@ -10365,10 +11906,10 @@ function emitLayer(ctx, ir, ly, parentNullVar) {
     }
   }
   if (anim.rot?.length && !bakedProps.has("rotation")) {
-    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, anim.rot.map((k) => ({ t: k.t, value: `${r35(num(k.v, 0))}`, e: k.e })));
+    emitKeys(ctx, `${tf}.property("ADBE Rotate Z")`, anim.rot.map((k) => ({ t: k.t, value: `${r37(num(k.v, 0))}`, e: k.e })));
   }
   if (anim.opacity?.length) {
-    emitKeys(ctx, `${tf}.property("ADBE Opacity")`, anim.opacity.map((k) => ({ t: k.t, value: `${r35(Math.min(1, Math.max(0, num(k.v, 1))) * 100)}`, e: k.e })));
+    emitKeys(ctx, `${tf}.property("ADBE Opacity")`, anim.opacity.map((k) => ({ t: k.t, value: `${r37(Math.min(1, Math.max(0, num(k.v, 1))) * 100)}`, e: k.e })));
   }
   if (anim.ls?.length) {
     L.push(`  // TODO: letterspacing 轨未自动映射（AE 需 Animator>Tracking），共 ${anim.ls.length} 帧`);
@@ -10386,7 +11927,7 @@ function emitGroupAnim(ctx, v, ly) {
   const py = num(ly.pos?.[1], 0);
   if (anim.x?.length || anim.y?.length) {
     const merged = mergeChannelTracks(anim.x, anim.y, px, py);
-    emitKeys(ctx, `${v}.property("ADBE Transform Group").property("ADBE Position")`, merged.map((k) => ({ t: k.t, value: `[${r35(k.a - px)}, ${r35(k.b - py)}]`, e: k.e })));
+    emitKeys(ctx, `${v}.property("ADBE Transform Group").property("ADBE Position")`, merged.map((k) => ({ t: k.t, value: `[${r37(k.a - px)}, ${r37(k.b - py)}]`, e: k.e })));
   }
   for (const ch of ["scale", "rot", "opacity"]) {
     if (anim[ch]?.length) {
@@ -10462,7 +12003,7 @@ function madJsx(opts) {
     totalDur = Math.max(totalDur, win.dropAt + Math.max(0.01, len));
   }
   L.push(``);
-  L.push(`  var master = app.project.items.addComp("${masterName}", ${mw}, ${mh}, 1, ${r35(totalDur)}, ${r35(mfps)});`);
+  L.push(`  var master = app.project.items.addComp("${masterName}", ${mw}, ${mh}, 1, ${r37(totalDur)}, ${r37(mfps)});`);
   L.push(`  try { master.bgColor = [0.04,0.04,0.07]; } catch (e) {}`);
   const subVars = [];
   windows.forEach((win, wi) => {
@@ -10474,8 +12015,8 @@ function madJsx(opts) {
     const subName = esc(`${win.uid}-${win.seq}`);
     const subVar = `sub${wi}`;
     L.push(``);
-    L.push(`  // ==== 子合成 #${wi} 技法 ${subName}（源窗 t0=${r35(win.t0)} t1=${r35(win.t1)}）====`);
-    L.push(`  var ${subVar} = app.project.items.addComp("${subName}", ${sw}, ${sh}, 1, ${r35(sdur)}, ${r35(sfps)});`);
+    L.push(`  // ==== 子合成 #${wi} 技法 ${subName}（源窗 t0=${r37(win.t0)} t1=${r37(win.t1)}）====`);
+    L.push(`  var ${subVar} = app.project.items.addComp("${subName}", ${sw}, ${sh}, 1, ${r37(sdur)}, ${r37(sfps)});`);
     const winFootage = { ...win.footage ?? {} };
     const subCtx = {
       lines: L,
@@ -10496,9 +12037,9 @@ function madJsx(opts) {
     const len = Math.max(0.01, win.outLen ?? win.t1 - win.t0);
     const lv = `mL${wi}`;
     L.push(`  var ${lv} = master.layers.add(${subVar});`);
-    L.push(`  ${lv}.startTime = ${r35(win.dropAt - win.t0)};`);
-    L.push(`  ${lv}.inPoint = ${r35(win.dropAt)};`);
-    L.push(`  ${lv}.outPoint = ${r35(win.dropAt + len)};`);
+    L.push(`  ${lv}.startTime = ${r37(win.dropAt - win.t0)};`);
+    L.push(`  ${lv}.inPoint = ${r37(win.dropAt)};`);
+    L.push(`  ${lv}.outPoint = ${r37(win.dropAt + len)};`);
     L.push(`  try {`);
     L.push(`    var _cov = Math.max(${mw} / ${subVar}.width, ${mh} / ${subVar}.height) * 100;`);
     L.push(`    ${lv}.property("ADBE Transform Group").property("ADBE Scale").setValue([_cov, _cov]);`);
@@ -10520,7 +12061,7 @@ function madJsx(opts) {
       L.push(`    var mk = master.property("ADBE Marker");`);
       for (const m of markers) {
         const label = m.downbeat ? "downbeat" : "beat";
-        L.push(`    mk.setValueAtTime(${r35(m.t)}, new MarkerValue("${label}"));`);
+        L.push(`    mk.setValueAtTime(${r37(m.t)}, new MarkerValue("${label}"));`);
       }
       L.push(`  } catch (e) {}`);
     }
@@ -10536,7 +12077,7 @@ function madJsx(opts) {
 
 // src/lib/mad/scan.ts
 import { readdirSync, statSync as statSync2 } from "node:fs";
-import { extname as extname6, join as join22 } from "node:path";
+import { extname as extname6, join as join23 } from "node:path";
 var VIDEO_EXTS2 = new Set(defaultExtsFor("video") ?? []);
 function scanFolder(dirAbs, opts = {}) {
   const probe = opts.probe ?? probeGeometry;
@@ -10547,7 +12088,7 @@ function scanFolder(dirAbs, opts = {}) {
   } catch {
     throw new Error(`素材文件夹不存在或无法读取：${dirAbs}`);
   }
-  const files = entries.filter((n) => VIDEO_EXTS2.has(extname6(n).toLowerCase())).map((n) => join22(dirAbs, n)).filter((p) => {
+  const files = entries.filter((n) => VIDEO_EXTS2.has(extname6(n).toLowerCase())).map((n) => join23(dirAbs, n)).filter((p) => {
     try {
       return statSync2(p).isFile();
     } catch {
@@ -10677,7 +12218,7 @@ function selectWindows(opts) {
 
 // src/lib/mad/beat.ts
 var clamp2 = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
-var r36 = (v) => Math.round(v * 1000) / 1000;
+var r38 = (v) => Math.round(v * 1000) / 1000;
 var MIN_WIN = 0.4;
 var MAX_WIN = 6;
 function fixedRhythm(natLens) {
@@ -10685,7 +12226,7 @@ function fixedRhythm(natLens) {
   let t = 0;
   for (const nl of natLens) {
     const outLen = clamp2(nl, MIN_WIN, MAX_WIN);
-    placements.push({ dropAt: r36(t), outLen: r36(outLen) });
+    placements.push({ dropAt: r38(t), outLen: r38(outLen) });
     t += outLen;
   }
   return { placements, markers: [] };
@@ -10695,7 +12236,7 @@ function beatQuantized(natLens, analysis) {
   const bts = (analysis.beats ?? []).filter((t2) => Number.isFinite(t2) && t2 >= 0).sort((a, b) => a - b);
   const dbSpanOk = dbs.length >= 2 && dbs[1] - dbs[0] <= MAX_WIN;
   const snap = dbSpanOk ? dbs : bts;
-  const snapSet = new Set(dbs.map((t2) => r36(t2)));
+  const snapSet = new Set(dbs.map((t2) => r38(t2)));
   if (snap.length < 2) {
     return { plan: fixedRhythm(natLens), level: 2 };
   }
@@ -10708,27 +12249,27 @@ function beatQuantized(natLens, analysis) {
       si++;
     if (si >= snap.length) {
       const outLen = clamp2(natLens[i], MIN_WIN, MAX_WIN);
-      placements.push({ dropAt: r36(dropAt), outLen: r36(outLen) });
+      placements.push({ dropAt: r38(dropAt), outLen: r38(outLen) });
       t = dropAt + outLen;
       continue;
     }
     const nextSnap = snap[si];
     const slotLen = clamp2(nextSnap - dropAt, MIN_WIN, MAX_WIN);
-    placements.push({ dropAt: r36(dropAt), outLen: r36(slotLen) });
+    placements.push({ dropAt: r38(dropAt), outLen: r38(slotLen) });
     t = dropAt + slotLen;
     si++;
   }
   const totalDur = placements.length ? placements[placements.length - 1].dropAt + placements[placements.length - 1].outLen : 0;
-  const allBeats = [...new Set([...bts, ...dbs].map((x) => r36(x)))].sort((a, b) => a - b);
+  const allBeats = [...new Set([...bts, ...dbs].map((x) => r38(x)))].sort((a, b) => a - b);
   const markers = allBeats.filter((tt) => tt >= 0 && tt <= totalDur + 0.000001).map((tt) => ({ t: tt, downbeat: snapSet.has(tt) }));
   return { plan: { placements, markers }, level: 1 };
 }
 
 // src/lib/mad/data.ts
 import { createHash as createHash2 } from "node:crypto";
-import { mkdir as mkdir9, readFile as readFile7, rename, rm, writeFile as writeFile9, readdir } from "node:fs/promises";
-import { existsSync as existsSync18 } from "node:fs";
-import { join as join23 } from "node:path";
+import { mkdir as mkdir9, readFile as readFile8, rename as rename2, rm, writeFile as writeFile9, readdir } from "node:fs/promises";
+import { existsSync as existsSync20 } from "node:fs";
+import { join as join24 } from "node:path";
 function madCacheDir() {
   return homeFile("mad-cache");
 }
@@ -10754,13 +12295,13 @@ async function fetchWithTimeout(fetchFn, url, timeoutMs) {
 async function atomicWrite(dest, data) {
   const tmp = `${dest}.tmp-${process.pid}-${Date.now()}`;
   await writeFile9(tmp, data);
-  await rename(tmp, dest);
+  await rename2(tmp, dest);
 }
 async function verifyFile(path, sha256) {
-  if (!existsSync18(path))
+  if (!existsSync20(path))
     return false;
   try {
-    const buf = await readFile7(path);
+    const buf = await readFile8(path);
     return sha256Hex(buf) === sha256;
   } catch {
     return false;
@@ -10785,7 +12326,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(join23(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
+        await rm(join24(cacheRoot, e), { recursive: true, force: true }).catch(() => {});
       }
     }
   } catch {}
@@ -10794,7 +12335,7 @@ async function ensureMadData(opts, deps) {
   const { cacheRoot, warn } = deps;
   const timeout = deps.manifestTimeoutMs ?? 8000;
   const mfUrl = deps.manifestUrl ?? manifestUrl();
-  const snapshotPath = join23(cacheRoot, "manifest.json");
+  const snapshotPath = join24(cacheRoot, "manifest.json");
   let manifest = null;
   let online = false;
   try {
@@ -10809,11 +12350,11 @@ async function ensureMadData(opts, deps) {
     warn(`manifest 拉取失败（${e instanceof Error ? e.message : String(e)}），回退本地缓存`);
   }
   if (!manifest) {
-    if (!existsSync18(snapshotPath)) {
+    if (!existsSync20(snapshotPath)) {
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
     }
     try {
-      manifest = validateManifest(JSON.parse(await readFile7(snapshotPath, "utf8")));
+      manifest = validateManifest(JSON.parse(await readFile8(snapshotPath, "utf8")));
     } catch {
       throw new Error("本地 manifest 缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
     }
@@ -10824,14 +12365,14 @@ async function ensureMadData(opts, deps) {
     }
   }
   const version = manifest.version;
-  const verDir = join23(cacheRoot, `v${version}`);
-  const poolPath = join23(verDir, "mad_pool.json");
+  const verDir = join24(cacheRoot, `v${version}`);
+  const poolPath = join24(verDir, "mad_pool.json");
   const poolMeta = manifest.datasets.mad_pool;
   const cacheValid = await verifyFile(poolPath, poolMeta.sha256);
   const needDownload = !!opts.refresh || !cacheValid;
   if (needDownload) {
     if (!online) {
-      if (existsSync18(poolPath)) {
+      if (existsSync20(poolPath)) {
         throw new Error("本地技法数据缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
       }
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
@@ -10855,7 +12396,7 @@ async function ensureMadData(opts, deps) {
   }
   let pool;
   try {
-    pool = JSON.parse(await readFile7(poolPath, "utf8"));
+    pool = JSON.parse(await readFile8(poolPath, "utf8"));
     if (!Array.isArray(pool))
       throw new Error("mad_pool 非数组");
   } catch (e) {
@@ -10866,11 +12407,11 @@ async function ensureMadData(opts, deps) {
 
 // src/lib/mad/pool.ts
 import { gunzipSync } from "node:zlib";
-import { mkdir as mkdir10, readFile as readFile8 } from "node:fs/promises";
-import { existsSync as existsSync19 } from "node:fs";
-import { join as join24 } from "node:path";
+import { mkdir as mkdir10, readFile as readFile9 } from "node:fs/promises";
+import { existsSync as existsSync21 } from "node:fs";
+import { join as join25 } from "node:path";
 function shardPath(verDir, shard) {
-  return join24(verDir, "ir", `${shard}.json.gz`);
+  return join25(verDir, "ir", `${shard}.json.gz`);
 }
 function decodeShard(gz) {
   const json = gunzipSync(gz).toString("utf8");
@@ -10887,9 +12428,9 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
     if (cached)
       return cached;
     const path = shardPath(verDir, shard);
-    if (existsSync19(path)) {
+    if (existsSync21(path)) {
       try {
-        const s2 = decodeShard(await readFile8(path));
+        const s2 = decodeShard(await readFile9(path));
         memo.set(shard, s2);
         return s2;
       } catch {
@@ -10905,7 +12446,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 mkdir10(join24(verDir, "ir"), { recursive: true });
+    await mkdir10(join25(verDir, "ir"), { recursive: true });
     await atomicWrite(path, buf);
     memo.set(shard, s);
     return s;
@@ -10919,7 +12460,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
       return ir;
     },
     shardCached(shard) {
-      return memo.has(shard) || existsSync19(shardPath(verDir, shard));
+      return memo.has(shard) || existsSync21(shardPath(verDir, shard));
     }
   };
 }
@@ -10941,7 +12482,7 @@ async function analyzeBgm(cfg, bgmAbs, deps) {
     uploadCached: deps.uploadCached,
     invalidateUpload: deps.invalidateUpload,
     submitTask: deps.submitTask,
-    sleep: deps.sleep ?? ((ms) => new Promise((resolve11) => setTimeout(resolve11, ms)))
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve12) => setTimeout(resolve12, ms)))
   });
   const { taskId } = submitted;
   const output = await deps.pollToolTask(cfg, ANALYZE_TASK, taskId, {});
@@ -11002,8 +12543,8 @@ async function runMad(inputArg, opts, deps = {}) {
   const probeDur = deps.probeDurationFn ?? probeDuration;
   if (!inputArg)
     throw new Error("用法：gtrk tool mad <素材文件夹> [--bgm 歌.mp3]");
-  const dirAbs = resolve11(inputArg);
-  if (!existsSync20(dirAbs) || !statSync3(dirAbs).isDirectory()) {
+  const dirAbs = resolve12(inputArg);
+  if (!existsSync22(dirAbs) || !statSync3(dirAbs).isDirectory()) {
     throw new Error(`素材文件夹不存在或不是目录：${dirAbs}`);
   }
   const { videos, orientation, skipped } = scanFolder(dirAbs, {
@@ -11034,7 +12575,7 @@ async function runMad(inputArg, opts, deps = {}) {
   let level = 3;
   let analysis = null;
   let bgmForTrack;
-  const bgmAbs = opts.bgm ? resolve11(opts.bgm) : undefined;
+  const bgmAbs = opts.bgm ? resolve12(opts.bgm) : undefined;
   if (bgmAbs) {
     let dur = -1;
     try {
@@ -11117,9 +12658,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 ? resolve11(opts.out) : join25(process.cwd(), `mad-${timestamp4(now)}`);
+  const outDir = opts.out ? resolve12(opts.out) : join26(process.cwd(), `mad-${timestamp4(now)}`);
   await mkdir11(outDir, { recursive: true });
-  const jsxPath = join25(outDir, "mad.jsx");
+  const jsxPath = join26(outDir, "mad.jsx");
   await writeFile10(jsxPath, jsx);
   const result = {
     ok: true,
@@ -11131,7 +12672,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 writeFile10(join25(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
+  await writeFile10(join26(outDir, "result.json"), JSON.stringify({ ...result, finishedAt: now.toISOString() }, null, 2));
   warn(completionMessage(jsxPath, level));
   return result;
 }
@@ -11263,9 +12804,9 @@ async function runMadInTool(inputArg, opts) {
 }
 
 // src/commands/transcript.ts
-import { existsSync as existsSync21 } from "node:fs";
-import { mkdir as mkdir12, rename as rename2, rm as rm2, stat as stat6, writeFile as writeFile11 } from "node:fs/promises";
-import { basename as basename12, dirname as dirname10, extname as extname7, join as join26, resolve as resolve12 } from "node:path";
+import { existsSync as existsSync23 } from "node:fs";
+import { mkdir as mkdir12, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile11 } from "node:fs/promises";
+import { basename as basename13, dirname as dirname10, extname as extname7, join as join27, resolve as resolve13 } from "node:path";
 
 // src/lib/transcript.ts
 var AGENT_SUMMARY_PENDING = "<!-- gtrk:agent-summary-pending -->";
@@ -11386,7 +12927,7 @@ function buildDeps(overrides = {}) {
     upload: overrides.upload ?? uploadCached,
     invalidate: overrides.invalidate ?? invalidateUpload,
     submit: overrides.submit ?? submitTask,
-    sleep: overrides.sleep ?? ((ms) => new Promise((resolve13) => setTimeout(resolve13, ms))),
+    sleep: overrides.sleep ?? ((ms) => new Promise((resolve14) => setTimeout(resolve14, ms))),
     poll: overrides.poll ?? (async (cfg, taskType, taskId, onTick) => await pollToolTask(cfg, taskType, taskId, { onTick })),
     writeMarkdown: overrides.writeMarkdown ?? writeMarkdownAtomic,
     now: overrides.now ?? (() => new Date)
@@ -11401,8 +12942,8 @@ async function validateTranscriptInput(input) {
   if (looksLikeRemote(input)) {
     throw new Error("视频转文字稿仅支持本地视频文件，不支持 URL、平台视频地址或远端下载");
   }
-  const inputAbs = resolve12(input);
-  if (!existsSync21(inputAbs))
+  const inputAbs = resolve13(input);
+  if (!existsSync23(inputAbs))
     throw new Error(`本地视频不存在：${inputAbs}`);
   const info = await stat6(inputAbs);
   if (!info.isFile())
@@ -11414,8 +12955,8 @@ async function validateTranscriptInput(input) {
   return inputAbs;
 }
 function resolveTranscriptOutput(inputAbs, out) {
-  const base = basename12(inputAbs, extname7(inputAbs));
-  const output = out ? resolve12(out) : join26(dirname10(inputAbs), `${base}-transcript.md`);
+  const base = basename13(inputAbs, extname7(inputAbs));
+  const output = out ? resolve13(out) : join27(dirname10(inputAbs), `${base}-transcript.md`);
   if (extname7(output).toLowerCase() !== ".md")
     throw new Error("--out 必须指向一个 .md 文件");
   return output;
@@ -11425,7 +12966,7 @@ async function writeMarkdownAtomic(path, markdown) {
   const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
   try {
     await writeFile11(temp, markdown, "utf8");
-    await rename2(temp, path);
+    await rename3(temp, path);
   } finally {
     await rm2(temp, { force: true });
   }
@@ -11437,8 +12978,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 = basename12(inputAbs);
-  const title = basename12(inputAbs, extname7(inputAbs));
+  const sourceName = basename13(inputAbs);
+  const title = basename13(inputAbs, extname7(inputAbs));
   log.step(`▶ 视频转文字稿：${sourceName}`);
   log.step("① 本地探测视频…");
   const geometry = deps.probe(inputAbs, opts.ffmpegPath);
@@ -11450,7 +12991,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(`上传物：${basename12(audio)}（仅音频衍生物）`);
+  log.info(`上传物：${basename13(audio)}（仅音频衍生物）`);
   log.step("③ 上传音频并提交 ASR…");
   const payload = (fileId) => ({ file_id: fileId, language, word_level: true });
   const submitted = await uploadAndSubmitTask(deps.cfg, audio, TASK_TYPE3, payload, {
@@ -11498,9 +13039,9 @@ function registerTranscript(program2) {
 }
 
 // src/commands/music-visualizer.ts
-import { resolve as resolve13, join as join27, dirname as dirname11, basename as basename13, extname as extname8 } from "node:path";
+import { resolve as resolve14, join as join28, dirname as dirname11, basename as basename14, extname as extname8 } from "node:path";
 import { mkdir as mkdir13, writeFile as writeFile12 } from "node:fs/promises";
-import { existsSync as existsSync22 } from "node:fs";
+import { existsSync as existsSync24 } from "node:fs";
 var TASK_TYPE4 = "music_visualizer";
 var PRICE_KEY2 = "music_visualizer";
 var HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
@@ -11548,7 +13089,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 (!existsSync22(pathAbs))
+  if (!existsSync24(pathAbs))
     throw new Error(`${label}不存在：${pathAbs}`);
   const e = extname8(pathAbs).toLowerCase();
   if (exts.length && !exts.includes(e)) {
@@ -11604,22 +13145,22 @@ async function runMusicVisualizer(audio, opts) {
   if (opts.json)
     routeLogsToStderr();
   const cfg = loadConfig();
-  const audioAbs = resolve13(audio);
+  const audioAbs = resolve14(audio);
   assertExt(audioAbs, AUDIO_EXTS2, "音频");
   const template = opts.template == null ? "" : String(opts.template).trim();
   if (!template)
     throw new Error("--template 必填：请指定可视化模板 id（取值见云端 API 文档 / 服务端模板列表）");
   const styleFields = buildStyleFields(opts);
-  const bgAbs = opts.background ? resolve13(opts.background) : undefined;
+  const bgAbs = opts.background ? resolve14(opts.background) : undefined;
   if (bgAbs)
     assertExt(bgAbs, [...IMAGE_EXTS2, ...VIDEO_EXTS3], "背景素材");
-  const coverAbs = opts.cover ? resolve13(opts.cover) : undefined;
+  const coverAbs = opts.cover ? resolve14(opts.cover) : undefined;
   if (coverAbs)
     assertExt(coverAbs, IMAGE_EXTS2, "封面图");
   const extraParams = parseExtraParams3(opts.param, opts.paramsJson);
-  const projName = basename13(audioAbs, extname8(audioAbs));
-  const outDir = resolve13(opts.out ?? join27(dirname11(audioAbs), `${projName}-visualizer-${timestamp5()}`));
-  log.step(`▶ 音乐可视化：${basename13(audioAbs)}（模板 ${template}${bgAbs ? " · 背景" : ""}${coverAbs ? " · 封面" : ""}）`);
+  const projName = basename14(audioAbs, extname8(audioAbs));
+  const outDir = resolve14(opts.out ?? join28(dirname11(audioAbs), `${projName}-visualizer-${timestamp5()}`));
+  log.step(`▶ 音乐可视化：${basename14(audioAbs)}（模板 ${template}${bgAbs ? " · 背景" : ""}${coverAbs ? " · 封面" : ""}）`);
   let billingHint;
   try {
     billingHint = (await resolveToolPricing(PRICE_KEY2)).billingHint;
@@ -11665,7 +13206,7 @@ async function runMusicVisualizer(audio, opts) {
   const { taskId } = submitted;
   log.info(`task_id = ${taskId}`);
   await mkdir13(outDir, { recursive: true });
-  await writeFile12(join27(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE4, fileId: submitted.fileId, source: audioAbs, template, createdAt: new Date().toISOString() }, null, 2));
+  await writeFile12(join28(outDir, "task.json"), JSON.stringify({ taskId, taskType: TASK_TYPE4, fileId: submitted.fileId, source: audioAbs, template, createdAt: new Date().toISOString() }, null, 2));
   log.step("③ 云端处理中（每 5s 轮询）…");
   const result = await pollTask(cfg, TASK_TYPE4, taskId, (status, progress) => {
     log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
@@ -11676,7 +13217,7 @@ async function runMusicVisualizer(audio, opts) {
   const files = [];
   const errors = {};
   if (url) {
-    const dest = join27(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
+    const dest = join28(outDir, `${projName}-visualizer${extFromUrl(url, ".mp4")}`);
     try {
       await downloadStream(url, dest);
       files.push(dest);
@@ -11698,7 +13239,7 @@ async function runMusicVisualizer(audio, opts) {
     ...Object.keys(errors).length ? { errors } : {},
     finishedAt: new Date().toISOString()
   };
-  await writeFile12(join27(outDir, "result.json"), JSON.stringify(resultJson, null, 2));
+  await writeFile12(join28(outDir, "result.json"), JSON.stringify(resultJson, null, 2));
   if (opts.json) {
     process.stdout.write(`${JSON.stringify(resultJson)}
 `);
@@ -11716,7 +13257,7 @@ try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync5(join28(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync5(join29(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);