@gitruck/cli 0.2.3 → 0.2.4

package/dist/index.js

@@ -4196,8 +4196,8 @@ var {
 } = import__.default;
 
 // src/index.ts
-import { readFileSync as readFileSync3 } from "node:fs";
-import { join as join15 } from "node:path";
+import { readFileSync as readFileSync4 } from "node:fs";
+import { join as join17 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -4245,7 +4245,7 @@ function migrateLegacyHome() {
 // src/commands/skills.ts
 import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, copyFileSync } from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, cpSync as cpSync2 } from "node:fs";
 
 // src/lib/log.ts
 var c = {
@@ -4274,28 +4274,33 @@ var log = {
 };
 
 // src/commands/skills.ts
-var SKILL_NAME = "gtrk-oralcut";
-var SRC = join2(packageRoot(), "skills", SKILL_NAME, "SKILL.md");
+var SKILL_NAMES = ["gtrk-oralcut", "gtrk-splitter"];
 function installSkill(opts = {}) {
-  if (!existsSync2(SRC)) {
-    log.warn(`找不到打包的 skill 源：${SRC}（跳过 skill 安装，不影响命令行）`);
-    return false;
-  }
-  const dest = join2(opts.dir ?? join2(homedir2(), ".claude", "skills"), SKILL_NAME);
-  try {
-    mkdirSync2(dest, { recursive: true });
-    copyFileSync(SRC, join2(dest, "SKILL.md"));
-    log.ok(`已安装 /${SKILL_NAME} → ${join2(dest, "SKILL.md")}`);
-    log.info("在 Claude Code 里打 /gtrk-oralcut，或直接说「帮我剪个口播」即可触发（可能需重载会话）。");
-    return true;
-  } catch (e) {
-    log.warn(`skill 安装失败（不影响命令行使用）：${e instanceof Error ? e.message : String(e)}`);
-    return false;
+  const destRoot = opts.dir ?? join2(homedir2(), ".claude", "skills");
+  let allOk = true;
+  for (const name of SKILL_NAMES) {
+    const src = join2(packageRoot(), "skills", name);
+    if (!existsSync2(join2(src, "SKILL.md"))) {
+      log.warn(`找不到打包的 skill 源：${join2(src, "SKILL.md")}（跳过 ${name}，不影响命令行）`);
+      allOk = false;
+      continue;
+    }
+    const dest = join2(destRoot, name);
+    try {
+      mkdirSync2(dest, { recursive: true });
+      cpSync2(src, dest, { recursive: true });
+      log.ok(`已安装 /${name} → ${join2(dest, "SKILL.md")}`);
+    } catch (e) {
+      allOk = false;
+      log.warn(`skill 安装失败（${name}，不影响命令行使用）：${e instanceof Error ? e.message : String(e)}`);
+    }
   }
+  log.info("在 Claude Code 里打 /gtrk-oralcut 或 /gtrk-splitter，也可直接说「帮我剪个口播 / 拆个分镜」触发（可能需重载会话）。");
+  return allOk;
 }
 function registerSkills(program2) {
   const skills = program2.command("skills").description("管理 agent skill（安装到 Claude Code）");
-  skills.command("install").description(`把 /${SKILL_NAME} 安装到 ~/.claude/skills（对标飞书 skills add）`).option("--dir <dir>", "自定义 skills 目录（缺省 ~/.claude/skills）").action((opts) => {
+  skills.command("install").description("把 /gtrk-oralcut 与 /gtrk-splitter 安装到 ~/.claude/skills（对标飞书 skills add）").option("--dir <dir>", "自定义 skills 目录（缺省 ~/.claude/skills）").action((opts) => {
     installSkill({ dir: opts.dir });
   });
 }
@@ -5987,12 +5992,633 @@ function registerRender(program2) {
   });
 }
 
+// src/commands/split.ts
+import { resolve as resolve6, join as join16, dirname as dirname5, basename as basename8 } from "node:path";
+import { existsSync as existsSync13 } from "node:fs";
+import { readFile as readFile4, writeFile as writeFile6, mkdir as mkdir5 } from "node:fs/promises";
+import { createHash } from "node:crypto";
+
+// 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 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/splitdoc.ts
+var BASE_TRACKS = ["真人出镜", "口播继续", "旁白主导"];
+var LANES = ["A_ROLL", "RRV_MG", "AI_DRAMA", "FILM_BROLL"];
+var NARRATIVES = [
+  "mirror-hook",
+  "demolition",
+  "container-translation",
+  "abyssal-fall",
+  "holding",
+  "reversal-elevation",
+  "callback-closure",
+  "typography-emphasis"
+];
+var CONTAINER_STAGES = [
+  "none",
+  "seed",
+  "expand",
+  "translate",
+  "rupture",
+  "flip",
+  "callback"
+];
+var IRREPLACEABILITY = ["必须真人出镜", "优先 MG", "可被 B-roll 替代", "可降级处理"];
+var AUX_TYPES = [
+  "quote-card",
+  "term-callout",
+  "network-diagram",
+  "archive-caption",
+  "pause-card",
+  "data-annotation",
+  "timeline-tag"
+];
+function isNonEmptyStr(v) {
+  return typeof v === "string" && v.trim().length > 0;
+}
+function enumOk(v, list) {
+  return typeof v === "string" && list.includes(v);
+}
+function validateSplitDoc(doc, ctx) {
+  const errors = [];
+  const warnings = [];
+  if (typeof doc !== "object" || doc === null || Array.isArray(doc)) {
+    return { errors: ["拆分稿必须是一个 JSON 对象"], warnings };
+  }
+  const d = doc;
+  if (d.contract_version !== "v1") {
+    errors.push(`contract_version 必须为 "v1"（实际：${JSON.stringify(d.contract_version)}）`);
+  }
+  if (!isNonEmptyStr(d.transcript_hash)) {
+    errors.push("缺 transcript_hash（应从投影视图透传）");
+  } else if (d.transcript_hash !== ctx.transcriptHash) {
+    errors.push(`transcript_hash 不匹配：拆分稿 ${d.transcript_hash} ≠ 当前 transcript ${ctx.transcriptHash}——转写已变更，请重新导出视图并重拆`);
+  }
+  if (!Array.isArray(d.beats) || d.beats.length === 0) {
+    errors.push("beats 必须是非空数组");
+    return { errors, warnings };
+  }
+  const idIndex = new Map;
+  ctx.utteranceIds.forEach((id, i) => idIndex.set(id, i));
+  const ranges = [];
+  const seenBeatIds = new Set;
+  d.beats.forEach((raw, i) => {
+    const tag = (() => {
+      const bid = raw?.id;
+      return isNonEmptyStr(bid) ? bid : `beats[${i}]`;
+    })();
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+      errors.push(`${tag}：beat 必须是对象`);
+      return;
+    }
+    const b = raw;
+    if (!isNonEmptyStr(b.id))
+      errors.push(`${tag}：缺 id`);
+    else if (!/^B\d{2,}$/.test(b.id))
+      errors.push(`${b.id}：id 须为 "B"+两位起序号（如 B01）`);
+    else if (seenBeatIds.has(b.id))
+      errors.push(`${b.id}：beat id 重复`);
+    else
+      seenBeatIds.add(b.id);
+    if (!enumOk(b.base_track, BASE_TRACKS))
+      errors.push(`${tag}：base_track 非法（三选一：${BASE_TRACKS.join(" | ")}）`);
+    if (!enumOk(b.lane, LANES))
+      errors.push(`${tag}：lane 非法（四选一：${LANES.join(" | ")}）`);
+    if (!enumOk(b.narrative, NARRATIVES))
+      errors.push(`${tag}：narrative 非法（八枚举之一）`);
+    if (!enumOk(b.container_stage, CONTAINER_STAGES))
+      errors.push(`${tag}：container_stage 非法（七枚举之一）`);
+    if (!enumOk(b.irreplaceability, IRREPLACEABILITY))
+      errors.push(`${tag}：irreplaceability 非法（四枚举之一）`);
+    if (!isNonEmptyStr(b.rhythm))
+      errors.push(`${tag}：缺 rhythm（人读节奏标签）`);
+    if (!isNonEmptyStr(b.visual_task))
+      errors.push(`${tag}：缺 visual_task（一句话视觉任务）`);
+    const span = b.span;
+    let fromIdx = -1;
+    let toIdx = -1;
+    if (!span || !isNonEmptyStr(span.from) || !isNonEmptyStr(span.to)) {
+      errors.push(`${tag}：缺 span.from / span.to（utterance id 区间）`);
+    } else {
+      if (!idIndex.has(span.from))
+        errors.push(`${tag}：span.from 引用了不存在的 utterance id ${span.from}`);
+      else
+        fromIdx = idIndex.get(span.from);
+      if (!idIndex.has(span.to))
+        errors.push(`${tag}：span.to 引用了不存在的 utterance id ${span.to}`);
+      else
+        toIdx = idIndex.get(span.to);
+      if (fromIdx >= 0 && toIdx >= 0) {
+        if (fromIdx > toIdx)
+          errors.push(`${tag}：区间倒序（span.from ${span.from} 晚于 span.to ${span.to}）`);
+        else if (isNonEmptyStr(b.id))
+          ranges.push({ id: b.id, from: fromIdx, to: toIdx });
+      }
+    }
+    validateHandoff(tag, b, errors, warnings);
+    if (b.aux_layers != null) {
+      if (!Array.isArray(b.aux_layers))
+        errors.push(`${tag}：aux_layers 必须是数组`);
+      else
+        b.aux_layers.forEach((a, ai) => validateAux(`${tag}.aux[${ai}]`, a, idIndex, errors));
+    }
+  });
+  const sorted = [...ranges].sort((a, b) => a.from - b.from || a.to - b.to);
+  for (let i = 1;i < sorted.length; i++) {
+    const prev = sorted[i - 1];
+    const cur = sorted[i];
+    if (cur.from <= prev.to) {
+      errors.push(`${prev.id} 与 ${cur.id}：utterance 区间重叠（beats 之间不允许交集）`);
+    }
+  }
+  return { errors, warnings };
+}
+function validateHandoff(tag, b, errors, warnings) {
+  const lane = b.lane;
+  const handoff = b.handoff;
+  if (lane === "A_ROLL") {
+    if (handoff != null)
+      warnings.push(`${tag}：A_ROLL 不应带 handoff，已忽略`);
+    return;
+  }
+  if (lane === "RRV_MG") {
+    if (!handoff || typeof handoff.duration_hint !== "number") {
+      errors.push(`${tag}：RRV_MG 的 handoff.duration_hint 必填（秒，数值）`);
+    }
+    return;
+  }
+  if (lane === "FILM_BROLL") {
+    const q = handoff?.queries;
+    if (!Array.isArray(q) || q.length === 0 || !q.every((x) => isNonEmptyStr(x))) {
+      errors.push(`${tag}：FILM_BROLL 缺检索 query（handoff.queries 必须为非空字符串数组）`);
+    }
+    return;
+  }
+}
+function validateAux(tag, raw, idIndex, errors) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    errors.push(`${tag}：辅助层必须是对象`);
+    return;
+  }
+  const a = raw;
+  if (!enumOk(a.type, AUX_TYPES))
+    errors.push(`${tag}：type 非法（七类之一）`);
+  if (!isNonEmptyStr(a.role))
+    errors.push(`${tag}：缺 role（职责）`);
+  const m = a.mount;
+  if (m === "same_beat")
+    return;
+  if (typeof m === "object" && m !== null) {
+    const mo = m;
+    if (isNonEmptyStr(mo.trigger)) {
+      if (!idIndex.has(mo.trigger))
+        errors.push(`${tag}：mount.trigger 引用了不存在的 utterance id ${mo.trigger}`);
+      return;
+    }
+    if (isNonEmptyStr(mo.from) && isNonEmptyStr(mo.to)) {
+      if (!idIndex.has(mo.from))
+        errors.push(`${tag}：mount.from 引用了不存在的 utterance id ${mo.from}`);
+      if (!idIndex.has(mo.to))
+        errors.push(`${tag}：mount.to 引用了不存在的 utterance id ${mo.to}`);
+      if (idIndex.has(mo.from) && idIndex.has(mo.to) && idIndex.get(mo.from) > idIndex.get(mo.to)) {
+        errors.push(`${tag}：mount 区间倒序`);
+      }
+      return;
+    }
+  }
+  errors.push(`${tag}：mount 非法（应为 "same_beat" | {from,to} | {trigger}）`);
+}
+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 split = {
+    contract_version: doc.contract_version,
+    transcript_hash: doc.transcript_hash,
+    projected_at: opts.projectedAt,
+    beats: []
+  };
+  const dispatch = { rrv_mg: [], film_broll: [], ai_drama: [] };
+  const skipped = [];
+  const shrunk = [];
+  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) {
+      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 metaBeat = { id: beat.id, lane: beat.lane, span: beat.span, track_st, track_ed };
+    if (isShrunk)
+      metaBeat.shrunk = true;
+    if (beat.lane !== "A_ROLL" && beat.handoff)
+      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 });
+    }
+    const h = beat.handoff ?? {};
+    const compositionId = `${opts.projectSlug}-${beat.id}`;
+    if (beat.lane === "RRV_MG") {
+      dispatch.rrv_mg.push({
+        beat: beat.id,
+        composition_id: compositionId,
+        duration: typeof h.duration_hint === "number" ? h.duration_hint : null,
+        theme: h.theme,
+        bg: h.bg,
+        slug_hint: h.slug_hint,
+        track_st,
+        track_ed
+      });
+    } else if (beat.lane === "FILM_BROLL") {
+      dispatch.film_broll.push({
+        beat: beat.id,
+        queries: Array.isArray(h.queries) ? h.queries : [],
+        shots: h.shots,
+        per_shot_sec: h.per_shot_sec,
+        exclude: h.exclude,
+        track_st,
+        track_ed
+      });
+    } else if (beat.lane === "AI_DRAMA") {
+      dispatch.ai_drama.push({ beat: beat.id, ...h, track_st, track_ed });
+    }
+  }
+  return { split, dispatch, skipped, shrunk };
+}
+function renderSplitMarkdown(doc, landing, meta) {
+  const L = [];
+  const metaById = new Map(landing.split.beats.map((b) => [b.id, b]));
+  const skippedIds = new Set(landing.skipped.map((s) => s.beat));
+  L.push(`# 视觉拆分稿（${meta.projectSlug}）`);
+  L.push("");
+  L.push(`- contract_version：\`${doc.contract_version}\``);
+  L.push(`- transcript_hash：\`${doc.transcript_hash}\``);
+  L.push(`- projected_at：\`${meta.projectedAt}\``);
+  L.push(`- beats：${doc.beats.length}（落轨 ${landing.split.beats.length} · 跳过 ${landing.skipped.length} · 收缩 ${landing.shrunk.length}）`);
+  L.push("");
+  L.push("# Beat Timeline");
+  L.push("");
+  for (const beat of doc.beats) {
+    const mb = metaById.get(beat.id);
+    L.push(`## ${beat.id}${skippedIds.has(beat.id) ? "（整段被剪 · 跳过）" : mb?.shrunk ? "（部分被剪 · 已收缩）" : ""}`);
+    L.push(`- 文稿范围：\`${beat.span.from} … ${beat.span.to}\``);
+    L.push(`- 底轨：\`${beat.base_track}\``);
+    L.push(`- 主层：\`${beat.lane}\``);
+    L.push(`- 叙事功能：\`${beat.narrative}\``);
+    L.push(`- 容器阶段：\`${beat.container_stage}\``);
+    if (beat.rhythm)
+      L.push(`- 节奏标签：\`${beat.rhythm}\``);
+    L.push(`- 视觉任务：${beat.visual_task}`);
+    L.push(`- 不可替代性：\`${beat.irreplaceability}\``);
+    if (mb)
+      L.push(`- 轨道时码：\`${mb.track_st}s … ${mb.track_ed}s\``);
+    if (beat.callback_of)
+      L.push(`- 回扣对象：\`${beat.callback_of}\``);
+    for (const a of beat.aux_layers ?? []) {
+      const mount = a.mount === "same_beat" ? "同 beat" : ("trigger" in a.mount) ? `触发 ${a.mount.trigger}` : `${a.mount.from} … ${a.mount.to}`;
+      L.push(`  - 辅助层 \`${a.type}\`（${mount}）：${a.role}`);
+    }
+    L.push("");
+  }
+  L.push("# Production Queues");
+  L.push("");
+  L.push("## A_ROLL Queue");
+  for (const b of doc.beats.filter((x) => x.lane === "A_ROLL" && !skippedIds.has(x.id))) {
+    L.push(`- \`${b.id}\` ${b.visual_task}`);
+  }
+  L.push("");
+  L.push("## RRV_MG Queue");
+  for (const r of landing.dispatch.rrv_mg) {
+    L.push(`- \`${r.beat}\` composition_id=\`${r.composition_id}\`${r.duration != null ? ` · ${r.duration}s` : ""}`);
+  }
+  L.push("");
+  L.push("## AI_DRAMA Queue");
+  for (const a of landing.dispatch.ai_drama)
+    L.push(`- \`${a.beat}\` ${a.track_st}s…${a.track_ed}s`);
+  L.push("");
+  L.push("## FILM_BROLL Queue");
+  for (const f of landing.dispatch.film_broll)
+    L.push(`- \`${f.beat}\` queries=[${f.queries.join(" / ")}]`);
+  L.push("");
+  return L.join(`
+`);
+}
+
+// src/lib/gtrk-writeback.ts
+import { readFileSync as readFileSync3, statSync, writeFileSync as writeFileSync2, renameSync, unlinkSync } from "node:fs";
+import { dirname as dirname4, join as join15, basename as basename7 } from "node:path";
+import { randomBytes as randomBytes2 } from "node:crypto";
+function readGtrk(path) {
+  const raw = readFileSync3(path, "utf8");
+  let gtrk;
+  try {
+    gtrk = JSON.parse(raw);
+  } catch (e) {
+    throw new Error(`工程文件不是合法 JSON：${path}（${e instanceof Error ? e.message : String(e)}）`);
+  }
+  if (typeof gtrk !== "object" || gtrk === null || Array.isArray(gtrk)) {
+    throw new Error(`工程文件结构异常（顶层非对象）：${path}`);
+  }
+  return { gtrk, mtimeMs: statSync(path).mtimeMs };
+}
+function assertGtrkV1(gtrk) {
+  if (gtrk.version !== "v1") {
+    throw new Error(`工程文件不是 v1（version=${JSON.stringify(gtrk.version)}）：请用新链路重产 v1 工程后再拆分`);
+  }
+}
+function writeStructMetaSplit(path, gtrk, splitObj, expectedMtimeMs) {
+  const cur = statSync(path).mtimeMs;
+  if (cur !== expectedMtimeMs) {
+    throw new Error("工程文件在 split 运行期间被外部修改（保存冲突），已拒绝写入；请重新导出视图后重试（客户端侧需先保存、发起后等重载）");
+  }
+  const nextStructMeta = { ...gtrk.struct_meta ?? {}, split: splitObj };
+  const next = { ...gtrk, struct_meta: nextStructMeta };
+  const tmp = join15(dirname4(path), `.${basename7(path)}.${randomBytes2(6).toString("hex")}.tmp`);
+  try {
+    writeFileSync2(tmp, JSON.stringify(next, null, 2));
+    renameSync(tmp, path);
+  } catch (e) {
+    try {
+      unlinkSync(tmp);
+    } catch {}
+    throw e;
+  }
+}
+
+// src/commands/split.ts
+var TRANSCRIPT_MISSING = "工程目录内找不到 transcript.json（可能是旧任务产物）：请用新版本重跑 gtrk oralcut（恒出 transcript），" + "或（规划中）用 transcribe 生成后再拆分；本命令不做降级猜测。";
+function registerSplit(program2) {
+  program2.command("split [splitdoc]").description("视觉拆分派单器：无 positional=导出投影视图；带拆分稿=校验落地（写回 struct_meta.split + dispatch）").option("--project <dir>", "oralcut 产物目录（自动定位 gtrk/project.gtrk 与 transcript/transcript.json）").option("--gtrk <path>", "显式指定 .gtrk 工程文件（非标准布局兜底）").option("--transcript <path>", "显式指定 transcript.json（非标准布局兜底）").option("--md", "落地时额外渲染人读稿 split/visual-split.md").option("--words", "视图模式附字级明细（缺省只出句级）").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (splitdoc, opts) => {
+    await runSplit(splitdoc, opts);
+  });
+}
+function firstExisting(cands) {
+  return cands.find((p) => existsSync13(p));
+}
+function resolvePaths(opts) {
+  const project = opts.project ? resolve6(opts.project) : undefined;
+  let gtrkPath;
+  if (opts.gtrk) {
+    gtrkPath = resolve6(opts.gtrk);
+  } else if (project) {
+    gtrkPath = firstExisting([join16(project, "gtrk", "project.gtrk"), join16(project, "project.gtrk")]) ?? join16(project, "gtrk", "project.gtrk");
+  } else {
+    throw new Error("需 --project <目录> 或显式 --gtrk <path>");
+  }
+  if (!existsSync13(gtrkPath))
+    throw new Error(`找不到工程文件：${gtrkPath}`);
+  let transcriptPath;
+  if (opts.transcript)
+    transcriptPath = resolve6(opts.transcript);
+  else if (project)
+    transcriptPath = firstExisting([
+      join16(project, "transcript", "transcript.json"),
+      join16(project, "json", "transcript.json"),
+      join16(project, "transcript.json")
+    ]);
+  const baseDir = project ?? dirname5(gtrkPath);
+  return { baseDir, gtrkPath, transcriptPath };
+}
+function slugify(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"));
+  if (!t || !Array.isArray(t.utterances) || typeof t.material_id !== "string" || typeof t.text_hash !== "string") {
+    throw new Error(`transcript.json 结构异常（缺 utterances/material_id/text_hash）：${path}`);
+  }
+  t.text_hash = createHash("sha256").update(t.utterances.map((u) => u.text ?? "").join(`
+`), "utf8").digest("hex");
+  return t;
+}
+async function runSplit(splitdoc, opts) {
+  if (opts.json)
+    routeLogsToStderr();
+  const { baseDir, gtrkPath, transcriptPath } = resolvePaths(opts);
+  return splitdoc ? runLand(resolve6(splitdoc), baseDir, gtrkPath, transcriptPath, opts) : runView(baseDir, gtrkPath, transcriptPath, opts);
+}
+async function runView(baseDir, gtrkPath, transcriptPath, opts) {
+  if (!transcriptPath || !existsSync13(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 = join16(baseDir, "split");
+  await mkdir5(splitDir, { recursive: true });
+  const viewPath = join16(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} 条被剪）`);
+  const result = {
+    ok: true,
+    mode: "view",
+    viewPath,
+    transcript_hash: view.transcript_hash,
+    projected_at: view.projected_at,
+    counts: { entries: view.utterances.length, dropped },
+    view
+  };
+  if (opts.json)
+    console.log(JSON.stringify(result));
+  return result;
+}
+async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
+  if (!existsSync13(splitdocPath))
+    throw new Error(`找不到拆分稿：${splitdocPath}`);
+  if (!transcriptPath || !existsSync13(transcriptPath))
+    throw new Error(TRANSCRIPT_MISSING);
+  log.step("▶ 校验拆分稿并落地…");
+  const doc = JSON.parse(await readFile4(splitdocPath, "utf8"));
+  const transcript = await loadTranscript(transcriptPath);
+  const { gtrk, mtimeMs } = readGtrk(gtrkPath);
+  assertGtrkV1(gtrk);
+  const ctx = { utteranceIds: transcript.utterances.map((u) => u.id), transcriptHash: transcript.text_hash };
+  const { errors, warnings } = validateSplitDoc(doc, ctx);
+  for (const w of warnings)
+    log.warn(w);
+  if (errors.length) {
+    throw new Error(`拆分稿校验失败（${errors.length} 条，未写入任何产物）：
+` + errors.map((e) => `  - ${e}`).join(`
+`));
+  }
+  const projectedAt = new Date().toISOString();
+  const view = projectTranscript(transcript, gtrk, { projectedAt });
+  const projectSlug = slugify(basename8(baseDir));
+  const landing = buildLanding(doc, view, { utteranceIds: ctx.utteranceIds, projectSlug, projectedAt });
+  writeStructMetaSplit(gtrkPath, gtrk, landing.split, mtimeMs);
+  const splitDir = join16(baseDir, "split");
+  await mkdir5(splitDir, { recursive: true });
+  const dispatchPath = join16(splitDir, "dispatch.json");
+  await writeFile6(dispatchPath, JSON.stringify(landing.dispatch, null, 2));
+  let mdPath = null;
+  if (opts.md) {
+    mdPath = join16(splitDir, "visual-split.md");
+    await writeFile6(mdPath, renderSplitMarkdown(doc, landing, { projectSlug, projectedAt }));
+  }
+  log.ok(`落地完成：${landing.split.beats.length}/${doc.beats.length} beat 落轨` + `（RRV_MG ${landing.dispatch.rrv_mg.length} · FILM_BROLL ${landing.dispatch.film_broll.length} · AI_DRAMA ${landing.dispatch.ai_drama.length}）`);
+  for (const s of landing.skipped)
+    log.warn(`跳过 ${s.beat}：${s.reason}`);
+  for (const s of landing.shrunk)
+    log.warn(`收缩 ${s.beat}：${s.dropped} 句被剪，按存活 ${s.kept} 句包络 → ${s.track_st}s…${s.track_ed}s（建议人工复核）`);
+  const result = {
+    ok: true,
+    mode: "land",
+    gtrk: gtrkPath,
+    dispatchPath,
+    mdPath,
+    transcript_hash: doc.transcript_hash,
+    projected_at: projectedAt,
+    beats: { total: doc.beats.length, landed: landing.split.beats.length, skipped: landing.skipped, shrunk: landing.shrunk },
+    queues: {
+      rrv_mg: landing.dispatch.rrv_mg.length,
+      film_broll: landing.dispatch.film_broll.length,
+      ai_drama: landing.dispatch.ai_drama.length
+    }
+  };
+  if (opts.json)
+    console.log(JSON.stringify(result));
+  return result;
+}
+
 // src/index.ts
 try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync3(join15(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync4(join17(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);
@@ -6003,6 +6629,7 @@ registerDoctor(program2);
 registerSkills(program2);
 registerUpgrade(program2);
 registerRender(program2);
+registerSplit(program2);
 program2.parseAsync(process.argv).catch((e) => {
   console.error(`
 ❌ ${e instanceof Error ? e.message : String(e)}`);