@gitruck/cli 0.2.9 → 0.2.10

package/dist/index.js

@@ -4197,7 +4197,7 @@ var {
 
 // src/index.ts
 import { readFileSync as readFileSync5 } from "node:fs";
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 
 // src/lib/paths.ts
 import { dirname, join } from "node:path";
@@ -4284,6 +4284,7 @@ var SKILL_NAMES = [
   "gtrk-mg",
   "gtrk-ai-drama",
   "gtrk-style-maker",
+  "gtrk-transcript",
   "gtrk-tools"
 ];
 function installSkill(opts = {}) {
@@ -4306,7 +4307,7 @@ function installSkill(opts = {}) {
       log.warn(`skill 安装失败（${name}，不影响命令行使用）：${e instanceof Error ? e.message : String(e)}`);
     }
   }
-  log.info("在 Claude Code 里打 /gtrk-oralcut、/gtrk-splitter 或 /gtrk-style-maker，也可直接说「帮我剪个口播 / 拆个分镜 / 造我栏目的风格 skill」触发（可能需重载会话）。");
+  log.info("在 Claude Code 里打 /gtrk-oralcut、/gtrk-transcript 或 /gtrk-tools，也可直接说「帮我剪个口播 / 把本地视频转成文字稿 / 给视频声音降噪」触发（可能需重载会话）。");
   return allOk;
 }
 function registerSkills(program2) {
@@ -5548,6 +5549,10 @@ class CloudError extends Error {
     this.name = "CloudError";
   }
 }
+function cloudErrorCode(error) {
+  const code = error && typeof error === "object" ? error.code : undefined;
+  return typeof code === "number" ? code : undefined;
+}
 async function parseJson(res) {
   try {
     return await res.json();
@@ -5555,38 +5560,58 @@ async function parseJson(res) {
     throw new Error(`服务响应解析失败 (HTTP ${res.status})`);
   }
 }
-async function uploadFile(cfg, path) {
-  const size = (await stat(path)).size;
-  const boundary = `----gtrkFormBoundary${randomBytes(16).toString("hex")}`;
-  const head = Buffer.from(`--${boundary}\r
+function globalBunFile() {
+  const bun = globalThis.Bun;
+  return bun ? bun.file.bind(bun) : undefined;
+}
+async function uploadFile(cfg, path, runtime = {}) {
+  const fetchFn = runtime.fetchFn ?? fetch;
+  const bunFile = runtime.bunFile ?? globalBunFile();
+  const useBun = runtime.runtime ? runtime.runtime === "bun" : bunFile != null;
+  let res;
+  if (useBun) {
+    if (!bunFile)
+      throw new Error("Bun 上传运行时缺少 Bun.file");
+    const form = new FormData;
+    form.append("file", bunFile(path), basename(path));
+    res = await fetchFn(`${cfg.base}/base/file/upload`, {
+      method: "POST",
+      headers: { Authorization: cfg.apiKey },
+      body: form
+    });
+  } else {
+    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-Type: application/octet-stream\r
 \r
 `, "utf8");
-  const tail = Buffer.from(`\r
+    const tail = Buffer.from(`\r
 --${boundary}--\r
 `, "utf8");
-  async function* multipart() {
-    yield head;
-    for await (const chunk of createReadStream(path))
-      yield chunk;
-    yield tail;
+    async function* multipart() {
+      yield head;
+      for await (const chunk of createReadStream(path))
+        yield chunk;
+      yield tail;
+    }
+    res = await fetchFn(`${cfg.base}/base/file/upload`, {
+      method: "POST",
+      headers: {
+        Authorization: cfg.apiKey,
+        "Content-Type": `multipart/form-data; boundary=${boundary}`,
+        "Content-Length": String(head.length + size + tail.length)
+      },
+      body: Readable.toWeb(Readable.from(multipart())),
+      duplex: "half"
+    });
   }
-  const res = await fetch(`${cfg.base}/base/file/upload`, {
-    method: "POST",
-    headers: {
-      Authorization: cfg.apiKey,
-      "Content-Type": `multipart/form-data; boundary=${boundary}`,
-      "Content-Length": String(head.length + size + tail.length)
-    },
-    body: Readable.toWeb(Readable.from(multipart())),
-    duplex: "half"
-  });
   const r = await parseJson(res);
   const fid = r.data?.file_id ?? r.data?.id;
   if (r.code === 200 && fid)
     return String(fid);
-  throw new Error(`上传失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
+  throw new CloudError(r.code, `上传失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
 }
 async function submitTask(cfg, taskType, payload) {
   const res = await fetch(`${cfg.base}/task/${taskType}`, {
@@ -5597,7 +5622,7 @@ async function submitTask(cfg, taskType, payload) {
   const r = await parseJson(res);
   if (r.code === 200 && r.data?.task_id)
     return String(r.data.task_id);
-  throw new Error(`提交失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
+  throw new CloudError(r.code, `提交失败 (code=${r.code ?? "?"})：${r.msg ?? "未知错误"}`);
 }
 async function getTaskResult(cfg, taskType, taskId) {
   const res = await fetch(`${cfg.base}/task/${taskType}/${taskId}`, {
@@ -5885,10 +5910,12 @@ async function putPart(cfg, uploadId, idx, view) {
 var CACHE_DIR = gitruckHome();
 var CACHE_FILE = join10(CACHE_DIR, "upload-cache.json");
 var SESSION_FILE = join10(CACHE_DIR, "upload-sessions.json");
-async function fingerprint(path) {
-  const s = await stat3(path);
+function fingerprintFromStat(s) {
   return `${s.size}:${Math.round(s.mtimeMs)}`;
 }
+async function fingerprint(path) {
+  return fingerprintFromStat(await stat3(path));
+}
 async function load() {
   if (!existsSync9(CACHE_FILE))
     return {};
@@ -5902,6 +5929,12 @@ async function save(cache) {
   await mkdir(CACHE_DIR, { recursive: true });
   await writeFile2(CACHE_FILE, JSON.stringify(cache, null, 2));
 }
+var defaultUploadCacheDeps = {
+  stat: stat3,
+  uploadFile,
+  uploadChunked,
+  cacheStore: { load, save }
+};
 async function invalidateUpload(path) {
   const fp = await fingerprint(path);
   const cache = await load();
@@ -5940,19 +5973,22 @@ var fileSessionStore = {
     }
   }
 };
-async function uploadCached(cfg, path, opts) {
-  const fp = await fingerprint(path);
-  const cache = await load();
+async function uploadCached(cfg, path, opts, deps = defaultUploadCacheDeps) {
+  const s0 = await deps.stat(path);
+  const fp = fingerprintFromStat(s0);
+  const cache = await deps.cacheStore.load();
   const hit = cache[fp]?.fileId;
   if (!opts?.force && hit)
     return { fileId: hit, cached: true };
-  const s0 = await stat3(path);
-  const fileId = s0.size >= CHUNK_THRESHOLD ? await uploadChunked(cfg, path, {
+  const fileId = s0.size >= CHUNK_THRESHOLD ? await deps.uploadChunked(cfg, path, {
     fingerprint: fp,
     store: fileSessionStore,
     force: opts?.force
-  }) : await uploadFile(cfg, path);
-  const s = await stat3(path);
+  }) : await deps.uploadFile(cfg, path);
+  const s = await deps.stat(path);
+  if (s.size !== s0.size || Math.round(s.mtimeMs) !== Math.round(s0.mtimeMs)) {
+    throw new Error("上传过程中输入文件发生变化，请等待文件写入完成后重试");
+  }
   cache[fp] = {
     fileId,
     size: s.size,
@@ -5960,10 +5996,50 @@ async function uploadCached(cfg, path, opts) {
     path,
     uploadedAt: Date.now()
   };
-  await save(cache);
+  await deps.cacheStore.save(cache);
   return { fileId, cached: false };
 }
 
+// src/lib/upload-submit.ts
+var MATERIAL_NOT_FOUND = 6004;
+var DEFAULT_VISIBILITY_BACKOFF_MS = [250, 750, 1500, 3000];
+var defaultDeps = {
+  uploadCached,
+  invalidateUpload,
+  submitTask,
+  sleep: (ms) => new Promise((resolve3) => setTimeout(resolve3, ms))
+};
+async function submitFreshFile(cfg, taskType, fileId, buildPayload, backoffMs, deps) {
+  for (let attempt = 0;; attempt++) {
+    try {
+      return await deps.submitTask(cfg, taskType, buildPayload(fileId));
+    } catch (error) {
+      if (cloudErrorCode(error) !== MATERIAL_NOT_FOUND || attempt >= backoffMs.length)
+        throw error;
+      await deps.sleep(backoffMs[attempt]);
+    }
+  }
+}
+async function uploadAndSubmitTask(cfg, path, taskType, buildPayload, options = {}, deps = defaultDeps) {
+  let uploaded = await deps.uploadCached(cfg, path, { force: options.force });
+  options.onUploaded?.(uploaded);
+  const backoffMs = options.visibilityBackoffMs ?? DEFAULT_VISIBILITY_BACKOFF_MS;
+  if (uploaded.cached) {
+    try {
+      const taskId2 = await deps.submitTask(cfg, taskType, buildPayload(uploaded.fileId));
+      return { taskId: taskId2, fileId: uploaded.fileId, cached: true };
+    } catch (error) {
+      if (cloudErrorCode(error) !== MATERIAL_NOT_FOUND)
+        throw error;
+      options.onCacheInvalid?.();
+      await deps.invalidateUpload(path);
+      uploaded = await deps.uploadCached(cfg, path, { force: true });
+    }
+  }
+  const taskId = await submitFreshFile(cfg, taskType, uploaded.fileId, buildPayload, backoffMs, deps);
+  return { taskId, fileId: uploaded.fileId, cached: false };
+}
+
 // src/lib/media.ts
 import { mkdir as mkdir2, stat as stat4 } from "node:fs/promises";
 import { existsSync as existsSync10 } from "node:fs";
@@ -6491,8 +6567,6 @@ async function runOralCut(input, opts) {
   assertDurationConsistent(geo.duration, artifact, opts.ffmpegPath);
   log.info(opts.visualAssist ? `已压 720p 代理（上传物）：${basename5(artifact)}` : `已抽 16k 单声道 mp3（上传物）：${basename5(artifact)}`);
   log.step("② 上传抽出物到云端…");
-  let up = await uploadCached(cfg, artifact, { force: opts.reupload });
-  log.info(up.cached ? `命中上传缓存，复用 file_id = ${up.fileId}（免二次上传）` : `file_id = ${up.fileId}`);
   const buildPayload = (fid) => {
     const p = {
       file_id: fid,
@@ -6519,19 +6593,16 @@ async function runOralCut(input, opts) {
     }
     return p;
   };
-  log.step("③ 提交智能口播剪辑任务…");
-  let taskId;
-  try {
-    taskId = await submitTask(cfg, TASK_TYPE, buildPayload(up.fileId));
-  } catch (e) {
-    if (up.cached && e instanceof CloudError && e.code === 6004) {
-      log.warn("缓存的 file_id 在云端已失效，重新上传后重试…");
-      await invalidateUpload(artifact);
-      up = await uploadCached(cfg, artifact, { force: true });
-      taskId = await submitTask(cfg, TASK_TYPE, buildPayload(up.fileId));
-    } else
-      throw e;
-  }
+  const submitted = await uploadAndSubmitTask(cfg, artifact, TASK_TYPE, buildPayload, {
+    force: opts.reupload,
+    onUploaded: (uploaded) => {
+      log.info(uploaded.cached ? `命中上传缓存，复用 file_id = ${uploaded.fileId}（免二次上传）` : `file_id = ${uploaded.fileId}`);
+      log.step("③ 提交智能口播剪辑任务…");
+    },
+    onCacheInvalid: () => log.warn("缓存的 file_id 在云端已失效，重新上传后重试…")
+  });
+  const { taskId } = submitted;
+  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));
@@ -8180,6 +8251,21 @@ import { extname as extname4 } from "node:path";
 var IMAGE_EXTS = [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".tif", ".tiff", ".heic", ".heif", ".avif"];
 var VIDEO_EXTS = [".mp4", ".mov", ".mkv", ".webm", ".avi", ".m4v", ".flv", ".wmv", ".mpg", ".mpeg", ".ts", ".m2ts"];
 var AUDIO_EXTS = [".mp3", ".wav", ".m4a", ".aac", ".flac", ".ogg", ".opus", ".wma"];
+var PUBLIC_VIDEO_EXTS = [
+  ".mp4",
+  ".avi",
+  ".mpg",
+  ".mov",
+  ".flv",
+  ".mxf",
+  ".mpeg",
+  ".ogg",
+  ".3gp",
+  ".wmv",
+  ".h264",
+  ".m4v",
+  ".ts"
+];
 function defaultExtsFor(kind) {
   if (kind === "image")
     return IMAGE_EXTS;
@@ -8228,7 +8314,7 @@ var imageMove = {
   description: "把一张静态图生成带运镜的短视频。",
   kind: "cloud",
   input: { kind: "image" },
-  billingHint: "2 积分/个",
+  priceKey: "image_move_local",
   outputHint: "运镜视频",
   enabled: true,
   taskType: "image_move",
@@ -8261,7 +8347,7 @@ var imageMatting = {
   description: "把图片主体从背景抠出，产透明背景 png（可经 --param 请求额外背景底板输出）。",
   kind: "cloud",
   input: { kind: "image" },
-  billingHint: "免费",
+  priceKey: "image_matting",
   outputHint: "透明 png",
   enabled: true,
   taskType: "image_matting",
@@ -8279,13 +8365,382 @@ var imageMatting = {
     return files;
   }
 };
+var imageBlackborderRemove = {
+  name: "image_blackborder_remove",
+  title: "图片去黑边",
+  description: "自动检测并裁去单张图片四周的黑边，保留有效画面。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_blackborder_remove",
+  outputHint: "去黑边图片",
+  enabled: true,
+  taskType: "image_blackborder_remove",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-blackborder-removed${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var imageCanvasAdapt = {
+  name: "image_canvas_adapt",
+  title: "图片比例转换",
+  description: "把单张图片适配到目标画布尺寸，可选适配、矩形裁剪或方形裁剪。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_canvas_adapt",
+  outputHint: "比例适配图片",
+  enabled: true,
+  taskType: "image_canvas_adapt",
+  options: [
+    { flag: "--canvas-width <px>", desc: "目标画布宽度（像素；未传则使用服务端默认）" },
+    { flag: "--canvas-height <px>", desc: "目标画布高度（像素；未传则使用服务端默认）" },
+    {
+      flag: "--canvas-type <normal|rectangle|square>",
+      desc: "画布模式：normal、rectangle 或 square（未传则使用服务端默认）"
+    }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["canvasWidth", "canvas_width", "--canvas-width"],
+      ["canvasHeight", "canvas_height", "--canvas-height"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value))
+        throw new Error(`${flag} 必须是数字`);
+      payload[payloadKey] = value;
+    }
+    if (ctx.opts.canvasType != null) {
+      const value = String(ctx.opts.canvasType);
+      if (value !== "normal" && value !== "rectangle" && value !== "square") {
+        throw new Error("--canvas-type 只支持 normal、rectangle 或 square");
+      }
+      payload.canvas_type = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-canvas-adapted${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var imagePurify = {
+  name: "image_purify",
+  title: "图片净化",
+  description: "清理你有权处理的图片中的水印、Logo 或叠加元素。",
+  kind: "cloud",
+  input: { kind: "image" },
+  priceKey: "image_purify",
+  outputHint: "净化图片",
+  enabled: true,
+  taskType: "image_purify",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-purified${extFromUrl(url, ".jpg")}` }] : [];
+  }
+};
+var videoBlackborderRemove = {
+  name: "video_blackborder_remove",
+  title: "视频去黑边",
+  description: "自动检测并裁去单条视频四周的黑边，保留有效画面与原音轨。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_blackborder_remove",
+  outputHint: "去黑边视频",
+  enabled: true,
+  taskType: "video_blackborder_remove",
+  buildPayload(fileId) {
+    return { file_id: fileId };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-blackborder-removed${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoCanvasAdapt = {
+  name: "video_canvas_adapt",
+  title: "视频比例转换",
+  description: "把单条视频适配到目标画布，可选截取时间片段并移除音轨。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_canvas_adapt",
+  outputHint: "比例适配视频",
+  enabled: true,
+  taskType: "video_canvas_adapt",
+  options: [
+    { flag: "--canvas-width <px>", desc: "目标画布宽度（像素；未传则使用服务端默认）" },
+    { flag: "--canvas-height <px>", desc: "目标画布高度（像素；未传则使用服务端默认）" },
+    {
+      flag: "--canvas-type <normal|rectangle|square>",
+      desc: "画布模式：normal、rectangle 或 square（未传则使用服务端默认）"
+    },
+    { flag: "--clip-start <frame>", desc: "截取起始帧序号（未传则使用服务端默认）" },
+    { flag: "--clip-end <frame>", desc: "截取结束帧序号（未传则使用服务端默认）" },
+    { flag: "--without-audio", desc: "输出视频不保留音轨" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["canvasWidth", "target_width", "--canvas-width"],
+      ["canvasHeight", "target_height", "--canvas-height"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${flag} 必须是有限整数`);
+      }
+      payload[payloadKey] = value;
+    }
+    for (const [optKey, payloadKey, flag] of [
+      ["clipStart", "start", "--clip-start"],
+      ["clipEnd", "end", "--clip-end"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new Error(`${flag} 必须是有限整数帧号`);
+      }
+      payload[payloadKey] = value;
+    }
+    if (ctx.opts.canvasType != null) {
+      const value = String(ctx.opts.canvasType);
+      if (value !== "normal" && value !== "rectangle" && value !== "square") {
+        throw new Error("--canvas-type 只支持 normal、rectangle 或 square");
+      }
+      payload.canvas_type = value;
+    }
+    if (ctx.opts.withoutAudio === true)
+      payload.need_audio = false;
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-canvas-adapted${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoStabilizer = {
+  name: "video_stabilizer",
+  title: "视频防抖",
+  description: "稳定手持或运动拍摄画面；exp 为实验方式，产物观感需自行检查。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_stabilizer",
+  outputHint: "防抖视频",
+  enabled: true,
+  taskType: "video_stabilizer",
+  options: [{ flag: "--stabilizer-method <fast|exp|turbo>", desc: "防抖方式（未传则使用服务端 turbo 默认值）" }],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.stabilizerMethod == null)
+      return payload;
+    const method = String(ctx.opts.stabilizerMethod);
+    if (method !== "fast" && method !== "exp" && method !== "turbo") {
+      throw new Error("--stabilizer-method 只支持 fast、exp 或 turbo");
+    }
+    payload.method = method;
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-stabilized${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoVaporwave = {
+  name: "video_vaporwave",
+  title: "视频蒸汽波滤镜",
+  description: "按精确预设名称为单条视频应用蒸汽波风格滤镜。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_vaporwave",
+  outputHint: "蒸汽波滤镜视频",
+  enabled: true,
+  taskType: "video_vaporwave",
+  options: [{ flag: "--vaporwave-filter <name>", desc: "精确滤镜名称（默认：愈漸升溫）" }],
+  buildPayload(fileId, ctx) {
+    const raw = ctx.opts.vaporwaveFilter;
+    const filter = raw == null ? "愈漸升溫" : String(raw);
+    if (!filter.trim())
+      throw new Error("--vaporwave-filter 不能为空");
+    return { file_id: fileId, filter };
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-vaporwave${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+function parseNormalizedRoi(value) {
+  let rawValues;
+  let acceptNumericStrings = false;
+  if (typeof value === "string") {
+    acceptNumericStrings = true;
+    const parts = value.split(",");
+    if (parts.length !== 4 || parts.some((part) => !part.trim())) {
+      throw new Error("--purify-roi 必须是 x,y,w,h 四个归一化数字");
+    }
+    rawValues = parts;
+  } else if (value && typeof value === "object" && !Array.isArray(value)) {
+    const roi = value;
+    rawValues = [roi.x, roi.y, roi.w, roi.h];
+  } else {
+    throw new Error("ROI 必须包含归一化数字 x、y、w、h");
+  }
+  const numbers = rawValues.map((item) => {
+    if (typeof item === "number")
+      return item;
+    if (acceptNumericStrings && typeof item === "string")
+      return Number(item);
+    return Number.NaN;
+  });
+  if (numbers.some((item) => !Number.isFinite(item))) {
+    throw new Error("ROI 的 x、y、w、h 必须是有限数字");
+  }
+  const [x, y, w, h] = numbers;
+  if (x < 0 || x > 1 || y < 0 || y > 1 || w <= 0 || w > 1 || h <= 0 || h > 1 || x + w > 1 || y + h > 1) {
+    throw new Error("ROI 必须满足 0≤x,y≤1、0<w,h≤1、x+w≤1、y+h≤1");
+  }
+  return { x, y, w, h };
+}
+var videoPurify = {
+  name: "video_purify",
+  title: "视频净化",
+  description: "清理你有权处理的视频中的水印、字幕或指定区域；不承诺还原被遮挡的原始内容。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_purify",
+  outputHint: "净化视频",
+  enabled: true,
+  taskType: "video_purify",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    {
+      flag: "--purify-scope <full_screen|subtitle|custom>",
+      desc: "净化范围；未传时使用服务端 full_screen 默认值"
+    },
+    {
+      flag: "--purify-method <ffmpeg|raft>",
+      desc: "净化方式；未传时使用服务端 ffmpeg 默认值，raft 仅支持 20 分钟以内视频"
+    },
+    { flag: "--purify-roi <x,y,w,h>", desc: "custom 模式的归一化矩形区域" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    const scopeRaw = ctx.opts.purifyScope;
+    const scope = scopeRaw == null ? undefined : String(scopeRaw);
+    if (scope != null && scope !== "full_screen" && scope !== "subtitle" && scope !== "custom") {
+      throw new Error("--purify-scope 只支持 full_screen、subtitle 或 custom");
+    }
+    if (scope != null)
+      payload.purify_scope = scope;
+    const methodRaw = ctx.opts.purifyMethod;
+    const method = methodRaw == null ? undefined : String(methodRaw);
+    if (method != null && method !== "ffmpeg" && method !== "raft") {
+      throw new Error("--purify-method 只支持 ffmpeg 或 raft");
+    }
+    if (method != null)
+      payload.purify_func_type = method;
+    const roiRaw = ctx.opts.purifyRoi;
+    if (roiRaw != null) {
+      if (scope !== "custom") {
+        throw new Error("--purify-roi 只能与 --purify-scope custom 一起使用");
+      }
+      payload.roi = parseNormalizedRoi(roiRaw);
+    } else if (scope === "custom") {
+      if (ctx.extraParams.roi == null) {
+        throw new Error("--purify-scope custom 必须同时提供 --purify-roi 或 params-json.roi");
+      }
+      parseNormalizedRoi(ctx.extraParams.roi);
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-purified${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoUpscale = {
+  name: "video_upscale",
+  title: "视频超分",
+  description: "对一分钟以内的低分辨率视频做实验性 GPU 超分；效果需自行检查。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS, maxDurationSec: 60 },
+  priceKey: "video_upscale",
+  outputHint: "超分视频",
+  enabled: true,
+  taskType: "video_upscale",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    { flag: "--upscale-times <2|3|4>", desc: "超分倍数；未传时使用服务端 2 倍默认值" },
+    { flag: "--upscale-type <Reality|Anime>", desc: "写实或动漫类型；未传时使用服务端 Reality 默认值" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.upscaleTimes != null) {
+      const times = Number(ctx.opts.upscaleTimes);
+      if (!Number.isInteger(times) || times !== 2 && times !== 3 && times !== 4) {
+        throw new Error("--upscale-times 只支持 2、3 或 4");
+      }
+      payload.times = times;
+    }
+    if (ctx.opts.upscaleType != null) {
+      const upscaleType = String(ctx.opts.upscaleType);
+      if (upscaleType !== "Reality" && upscaleType !== "Anime") {
+        throw new Error("--upscale-type 只支持 Reality 或 Anime");
+      }
+      payload.upscale_type = upscaleType;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-upscaled${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
+var videoInterpolate = {
+  name: "video_interpolate",
+  title: "视频插帧",
+  description: "以 GPU 帧插值提升视频流畅度；不附加未经服务端声明的时长限制。",
+  kind: "cloud",
+  input: { kind: "video", exts: PUBLIC_VIDEO_EXTS },
+  priceKey: "video_interpolate",
+  outputHint: "插帧视频",
+  enabled: true,
+  taskType: "video_interpolate",
+  pollTimeoutMs: 4 * 60 * 60 * 1000,
+  options: [
+    { flag: "--interpolate-multiplier <2|3|4>", desc: "插帧倍数；未传时使用服务端 2 倍默认值" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.interpolateMultiplier != null) {
+      const multiplier = Number(ctx.opts.interpolateMultiplier);
+      if (!Number.isInteger(multiplier) || multiplier !== 2 && multiplier !== 3 && multiplier !== 4) {
+        throw new Error("--interpolate-multiplier 只支持 2、3 或 4");
+      }
+      payload.multiplier = multiplier;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-interpolated${extFromUrl(url, ".mp4")}` }] : [];
+  }
+};
 var videoMatting = {
   name: "video_matting",
   title: "视频抠像",
   description: "把视频主体从背景抠出，产透明背景 webm（像素级、原片直传不压代理；单片 ≤10 分钟）。",
   kind: "cloud",
   input: { kind: "video", maxDurationSec: 600 },
-  billingHint: "免费",
+  priceKey: "video_matting",
   outputHint: "透明 webm",
   enabled: true,
   taskType: "video_matting",
@@ -8304,13 +8759,109 @@ var videoMatting = {
     return files;
   }
 };
+var audioSeparation = {
+  name: "audio_separation",
+  title: "人声伴奏分离",
+  description: "把单条音频分离为人声与伴奏，可返回其中一项或两项。",
+  kind: "cloud",
+  input: { kind: "audio" },
+  priceKey: "audio_separation",
+  outputHint: "人声与伴奏音频",
+  enabled: true,
+  taskType: "audio_separation",
+  options: [{ flag: "--mode <fast|turbo>", desc: "处理档位（默认 fast，可选 turbo）" }],
+  buildPayload(fileId, ctx) {
+    const raw = ctx.opts.mode;
+    const mode = raw == null ? "fast" : String(raw);
+    if (mode !== "fast" && mode !== "turbo")
+      throw new Error("--mode 只支持 fast 或 turbo");
+    return { file_id: fileId, mode };
+  },
+  mapOutputs(out, ctx) {
+    if (!Array.isArray(out.files))
+      return [];
+    const items = [];
+    for (const raw of out.files) {
+      if (!raw || typeof raw !== "object")
+        continue;
+      const file = raw;
+      const type = file.type;
+      const url = file.download_url;
+      if (type !== "vocals" && type !== "instrumental" || typeof url !== "string" || !url.trim())
+        continue;
+      items.push({ url, filename: `${ctx.baseName}-${type}${extFromUrl(url, ".wav")}` });
+    }
+    return items;
+  }
+};
+var audioNoiseReduce = {
+  name: "audio_noise_reduce",
+  title: "音频降噪",
+  description: "对音频或视频中的声音降噪，输出降噪后的音频。",
+  kind: "cloud",
+  input: { kind: "audio", exts: [...AUDIO_EXTS, ...VIDEO_EXTS] },
+  priceKey: "audio_noise_reduce",
+  outputHint: "降噪音频",
+  enabled: true,
+  taskType: "audio_noise_reduce",
+  options: [{ flag: "--prop-decrease <0..1>", desc: "降噪强度（0 到 1；未传则使用服务端默认）" }],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    if (ctx.opts.propDecrease != null) {
+      const value = Number(ctx.opts.propDecrease);
+      if (!Number.isFinite(value) || value < 0 || value > 1)
+        throw new Error("--prop-decrease 必须是 0 到 1 的数字");
+      payload.prop_decrease = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-denoise${extFromUrl(url, ".wav")}` }] : [];
+  }
+};
+var audioSilenceRemove = {
+  name: "audio_silence_remove",
+  title: "静音片段移除",
+  description: "移除音频中过长的静音片段，输出压缩停顿后的音频。",
+  kind: "cloud",
+  input: { kind: "audio" },
+  priceKey: "audio_silence_remove",
+  outputHint: "去静音音频",
+  enabled: true,
+  taskType: "audio_silence_remove",
+  options: [
+    { flag: "--min-silence-len <ms>", desc: "被视为静音片段的最短毫秒数（未传则使用服务端默认）" },
+    { flag: "--desired-silence-len <ms>", desc: "处理后保留的静音毫秒数（未传则使用服务端默认）" }
+  ],
+  buildPayload(fileId, ctx) {
+    const payload = { file_id: fileId };
+    for (const [optKey, payloadKey, flag] of [
+      ["minSilenceLen", "min_silence_len", "--min-silence-len"],
+      ["desiredSilenceLen", "desired_silence_len", "--desired-silence-len"]
+    ]) {
+      if (ctx.opts[optKey] == null)
+        continue;
+      const value = Number(ctx.opts[optKey]);
+      if (!Number.isFinite(value) || value < 0)
+        throw new Error(`${flag} 必须是非负毫秒数`);
+      payload[payloadKey] = value;
+    }
+    return payload;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    return url ? [{ url, filename: `${ctx.baseName}-desilence${extFromUrl(url, ".wav")}` }] : [];
+  }
+};
 var mad = {
   name: "mad",
   title: "一键剪 MAD",
   description: "素材文件夹（3~10 条视频）+ 可选 BGM → 自动选技法 → 单一 .jsx，AE 2020+ 跑一遍出 15~30s 卡点成片工程。仅支持 AE。",
   kind: "local",
   input: { kind: "directory" },
-  billingHint: "免费（--bgm 卡点时计费一次云端节拍分析 audio_music_analyze）",
+  priceKey: "audio_music_analyze",
+  pricingContext: "仅 --bgm 卡点时",
   outputHint: "AE 母合成工程 .jsx",
   enabled: true,
   options: [
@@ -8321,7 +8872,25 @@ var mad = {
   ]
 };
 var RESERVED_NAMES = new Set(["list"]);
-var TOOL_REGISTRY = [imageMove, imageMatting, videoMatting, mad];
+var TOOL_REGISTRY = [
+  imageMove,
+  imageMatting,
+  imageBlackborderRemove,
+  imageCanvasAdapt,
+  imagePurify,
+  videoMatting,
+  videoBlackborderRemove,
+  videoCanvasAdapt,
+  videoStabilizer,
+  videoVaporwave,
+  videoPurify,
+  videoUpscale,
+  videoInterpolate,
+  audioSeparation,
+  audioNoiseReduce,
+  audioSilenceRemove,
+  mad
+];
 function findTool(name, registry = TOOL_REGISTRY) {
   return registry.find((d) => d.name === name);
 }
@@ -8339,6 +8908,8 @@ function validateRegistry(registry = TOOL_REGISTRY) {
       throw new Error(`未启用工具缺 disabledReason：「${d.name}」`);
     if (d.kind === "cloud" && !d.taskType)
       throw new Error(`cloud 型工具缺 taskType：「${d.name}」`);
+    if (d.kind === "cloud" && !d.priceKey)
+      throw new Error(`cloud 型工具缺 priceKey：「${d.name}」`);
   }
 }
 
@@ -8348,6 +8919,87 @@ import { mkdir as mkdir8, writeFile as writeFile8, stat as stat5 } from "node:fs
 import { createWriteStream, existsSync as existsSync17 } from "node:fs";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline } from "node:stream/promises";
+
+// src/lib/tool-pricing.ts
+var TOOL_PRICE_LIST_URL = "https://cloud.ai-mcn.tv/api/get_price_list";
+var PRICE_UNAVAILABLE_HINT = "实时价格暂不可用，以服务端结算为准";
+var PRICE_REQUEST_TIMEOUT_MS = 5000;
+function validNumber(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+function parseToolPriceList(value) {
+  if (!Array.isArray(value))
+    throw new Error("价格表响应不是数组");
+  const prices = new Map;
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const item = raw;
+    const key = typeof item.key === "string" ? item.key.trim() : "";
+    const measure = typeof item.measure === "string" ? item.measure.trim() : "";
+    if (!key || !measure || !validNumber(item.price) || !validNumber(item.exPrice))
+      continue;
+    prices.set(key, {
+      ...validNumber(item.taskTypeId) ? { taskTypeId: item.taskTypeId } : {},
+      ...typeof item.name === "string" ? { name: item.name } : {},
+      key,
+      price: item.price,
+      exPrice: item.exPrice,
+      measure,
+      ...typeof item.note === "string" ? { note: item.note } : {}
+    });
+  }
+  return prices;
+}
+async function fetchToolPrices(fetchFn = fetch) {
+  const res = await fetchFn(TOOL_PRICE_LIST_URL, {
+    method: "GET",
+    headers: { Accept: "application/json" },
+    signal: AbortSignal.timeout(PRICE_REQUEST_TIMEOUT_MS)
+  });
+  if (!res.ok)
+    throw new Error(`价格表请求失败 HTTP ${res.status}`);
+  return parseToolPriceList(await res.json());
+}
+function formatToolPrice(item, pricingContext) {
+  let price;
+  if (item.price === 0 && item.exPrice === 0) {
+    price = `免费（0 积分/${item.measure}）`;
+  } else if (item.price === item.exPrice) {
+    price = `${item.price} 积分/${item.measure}`;
+  } else {
+    price = `标准价 ${item.price} 积分/${item.measure}；超额价 ${item.exPrice} 积分/${item.measure}`;
+  }
+  return pricingContext ? `${pricingContext}：${price}` : price;
+}
+function resolveToolPricingFromMap(priceKey, prices, pricingContext) {
+  const item = prices?.get(priceKey);
+  if (!item) {
+    return {
+      billingHint: pricingContext ? `${pricingContext}：${PRICE_UNAVAILABLE_HINT}` : PRICE_UNAVAILABLE_HINT,
+      pricing: { key: priceKey, available: false }
+    };
+  }
+  return {
+    billingHint: formatToolPrice(item, pricingContext),
+    pricing: {
+      key: priceKey,
+      available: true,
+      price: item.price,
+      exPrice: item.exPrice,
+      measure: item.measure
+    }
+  };
+}
+async function resolveToolPricing(priceKey, pricingContext, fetchFn = fetch) {
+  try {
+    return resolveToolPricingFromMap(priceKey, await fetchToolPrices(fetchFn), pricingContext);
+  } catch {
+    return resolveToolPricingFromMap(priceKey, undefined, pricingContext);
+  }
+}
+
+// src/lib/tool-runner.ts
 var DEFAULT_POLL_TIMEOUT_MS = 30 * 60 * 1000;
 var DEFAULT_POLL_INTERVAL_MS = 5000;
 function coerceValue2(v) {
@@ -8502,25 +9154,27 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
     uploadPath = await descriptor.preprocess(ctx);
   if (!uploadPath)
     throw new Error(`${descriptor.name} 缺上传物（input=none 的 cloud 型工具需 preprocess 产上传物）`);
-  emitBilling(descriptor.billingHint);
-  let up = await deps.uploadCached(deps.cfg, uploadPath, { force: opts.reupload });
+  let billingHint;
+  try {
+    billingHint = (await (deps.resolvePricing ?? resolveToolPricing)(descriptor.priceKey, descriptor.pricingContext)).billingHint;
+  } catch {
+    billingHint = "实时价格暂不可用，以服务端结算为准";
+  }
+  emitBilling(billingHint);
   const buildPayload = (fid) => {
     const p = descriptor.buildPayload ? descriptor.buildPayload(fid, ctx) : { file_id: fid };
     mergeParams(p, extraParams);
     return p;
   };
   const taskType = descriptor.taskType;
-  let taskId;
-  try {
-    taskId = await deps.submitTask(deps.cfg, taskType, buildPayload(up.fileId));
-  } catch (e) {
-    if (up.cached && isCloudErrorCode(e) === 6004) {
-      await deps.invalidateUpload(uploadPath);
-      up = await deps.uploadCached(deps.cfg, uploadPath, { force: true });
-      taskId = await deps.submitTask(deps.cfg, taskType, buildPayload(up.fileId));
-    } else
-      throw e;
-  }
+  const submitted = await uploadAndSubmitTask(deps.cfg, uploadPath, taskType, buildPayload, { force: opts.reupload }, {
+    uploadCached: deps.uploadCached,
+    invalidateUpload: deps.invalidateUpload,
+    submitTask: deps.submitTask,
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve10) => setTimeout(resolve10, 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));
@@ -9733,9 +10387,6 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
 
 // src/lib/mad/cloud-beat.ts
 var ANALYZE_TASK = "audio_music_analyze";
-function isCode(e, code) {
-  return !!e && typeof e === "object" && e.code === code;
-}
 function extractAnalysis(output) {
   const o = output ?? {};
   const arr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "number" && Number.isFinite(x)) : [];
@@ -9746,19 +10397,14 @@ function extractAnalysis(output) {
   };
 }
 async function analyzeBgm(cfg, bgmAbs, deps) {
-  let up = await deps.uploadCached(cfg, bgmAbs, {});
   const payload = (fid) => ({ file_id: fid });
-  let taskId;
-  try {
-    taskId = await deps.submitTask(cfg, ANALYZE_TASK, payload(up.fileId));
-  } catch (e) {
-    if (up.cached && isCode(e, 6004)) {
-      await deps.invalidateUpload(bgmAbs);
-      up = await deps.uploadCached(cfg, bgmAbs, { force: true });
-      taskId = await deps.submitTask(cfg, ANALYZE_TASK, payload(up.fileId));
-    } else
-      throw e;
-  }
+  const submitted = await uploadAndSubmitTask(cfg, bgmAbs, ANALYZE_TASK, payload, {}, {
+    uploadCached: deps.uploadCached,
+    invalidateUpload: deps.invalidateUpload,
+    submitTask: deps.submitTask,
+    sleep: deps.sleep ?? ((ms) => new Promise((resolve10) => setTimeout(resolve10, ms)))
+  });
+  const { taskId } = submitted;
   const output = await deps.pollToolTask(cfg, ANALYZE_TASK, taskId, {});
   return extractAnalysis(output);
 }
@@ -9872,7 +10518,8 @@ async function runMad(inputArg, opts, deps = {}) {
         level = 2;
         bgmForTrack = bgmAbs;
       } else {
-        emitBilling2("BGM 卡点将调用一次云端节拍分析（audio_music_analyze），按现行价计费。");
+        const pricing = await (deps.resolvePricing ?? resolveToolPricing)("audio_music_analyze", "仅 --bgm 卡点时");
+        emitBilling2(pricing.billingHint);
         const beatCloud = deps.beatCloud ?? { uploadCached, invalidateUpload, submitTask, pollToolTask };
         try {
           analysis = await analyzeBgm(cfg, bgmAbs, beatCloud);
@@ -9984,7 +10631,7 @@ async function runToolCommand(words, opts, registry = TOOL_REGISTRY, deps) {
     throw new Error("用法：`gtrk tool <name> [input]` 跑工具；`gtrk tool list` 查全部工具");
   }
   if (name === "list") {
-    runList(opts, registry);
+    await runList(opts, registry);
     return;
   }
   const descriptor = findTool(name, registry);
@@ -9994,16 +10641,26 @@ async function runToolCommand(words, opts, registry = TOOL_REGISTRY, deps) {
   }
   return runTool(descriptor, words[1], opts, deps);
 }
-function runList(opts, registry = TOOL_REGISTRY) {
-  const rows = registry.map((d) => ({
-    name: d.name,
-    title: d.title,
-    input: d.input.kind,
-    output: d.outputHint,
-    billingHint: d.billingHint,
-    enabled: d.enabled,
-    ...d.disabledReason ? { disabledReason: d.disabledReason } : {}
-  }));
+async function runList(opts, registry = TOOL_REGISTRY, loadPrices = fetchToolPrices) {
+  let prices;
+  try {
+    prices = await loadPrices();
+  } catch {
+    prices = undefined;
+  }
+  const rows = registry.map((d) => {
+    const resolved = resolveToolPricingFromMap(d.priceKey ?? d.name, prices, d.pricingContext);
+    return {
+      name: d.name,
+      title: d.title,
+      input: d.input.kind,
+      output: d.outputHint,
+      billingHint: resolved.billingHint,
+      pricing: resolved.pricing,
+      enabled: d.enabled,
+      ...d.disabledReason ? { disabledReason: d.disabledReason } : {}
+    };
+  });
   if (opts.json) {
     console.log(JSON.stringify(rows));
     return;
@@ -10066,12 +10723,247 @@ async function runMadInTool(inputArg, opts) {
   return { ok: r.ok, tool: r.tool, outDir: r.outDir, files: r.files };
 }
 
+// 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 dirname9, extname as extname7, join as join26, resolve as resolve11 } from "node:path";
+
+// src/lib/transcript.ts
+var AGENT_SUMMARY_PENDING = "<!-- gtrk:agent-summary-pending -->";
+function finiteNumber(value) {
+  const n = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(n) && n >= 0 ? n : undefined;
+}
+function timeFrom(item, secondsKey, msKey, shortKey) {
+  const seconds = finiteNumber(item[secondsKey]);
+  if (seconds != null)
+    return seconds;
+  const milliseconds = finiteNumber(item[msKey]);
+  if (milliseconds != null)
+    return milliseconds / 1000;
+  return finiteNumber(item[shortKey]) ?? 0;
+}
+function normalizeTimedList(value) {
+  if (!Array.isArray(value))
+    return [];
+  const items = [];
+  for (const raw of value) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const item = raw;
+    const text = typeof item.text === "string" ? item.text.trim() : "";
+    if (!text)
+      continue;
+    const start = timeFrom(item, "start_time", "begin_time_ms", "st");
+    const end = timeFrom(item, "end_time", "end_time_ms", "ed");
+    items.push({ text, start, end: Math.max(start, end) });
+  }
+  return items.sort((a, b) => a.start - b.start || a.end - b.end);
+}
+function normalizeAsrOutput(output) {
+  let sentences = normalizeTimedList(output.sentence_tc_list ?? output.sentence_list);
+  const words = normalizeTimedList(output.word_tc_list ?? output.word_list);
+  let text = "";
+  for (const key of ["asr_text", "text"]) {
+    const value = output[key];
+    if (typeof value === "string" && value.trim()) {
+      text = value.trim();
+      break;
+    }
+  }
+  if (sentences.length === 0 && words.length > 0) {
+    sentences = [{
+      text: text || words.map((word) => word.text).join(""),
+      start: words[0]?.start ?? 0,
+      end: words[words.length - 1]?.end ?? 0
+    }];
+  }
+  if (!text && sentences.length > 0)
+    text = sentences.map((sentence) => sentence.text).join(`
+`);
+  if (!text.trim() || sentences.length === 0) {
+    throw new Error("ASR 任务已完成，但没有返回可用的文字或句级时间戳");
+  }
+  return { text: text.trim(), sentences, words };
+}
+function formatTimestamp(seconds) {
+  const total = Math.max(0, Math.floor(Number.isFinite(seconds) ? seconds : 0));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = total % 60;
+  return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+function ensureTerminalPunctuation(text) {
+  const value = text.trim();
+  if (!value)
+    return value;
+  return /[。！？!?；;：:]$/.test(value) ? value : `${value}。`;
+}
+function localDateTime(date) {
+  const p = (value) => String(value).padStart(2, "0");
+  return `${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())} ${p(date.getHours())}:${p(date.getMinutes())}`;
+}
+function renderTranscriptMarkdown(input) {
+  const timed = input.asr.sentences.flatMap((sentence) => [
+    `**[${formatTimestamp(sentence.start)}]**`,
+    "",
+    ensureTerminalPunctuation(sentence.text),
+    ""
+  ]);
+  return [
+    `# ${input.title}`,
+    "",
+    `> 生成时间：${localDateTime(input.generatedAt)}  `,
+    `> 视频时长：${formatTimestamp(input.durationSec)}  `,
+    `> 来源：本地视频 \`${input.sourceName}\`  `,
+    `> 识别语言：${input.language}`,
+    "",
+    "## 总结",
+    "",
+    AGENT_SUMMARY_PENDING,
+    "> 待驱动 CLI 的 Agent 阅读下方完整文字稿后，在此生成总结。",
+    "",
+    "## 文字记录",
+    "",
+    ...timed,
+    "## 纯文本",
+    "",
+    input.asr.text.trim(),
+    ""
+  ].join(`
+`);
+}
+
+// src/commands/transcript.ts
+var TASK_TYPE3 = "asr";
+var PRICE_KEY = "asr";
+function buildDeps(overrides = {}) {
+  return {
+    cfg: overrides.cfg ?? loadConfig(),
+    probe: overrides.probe ?? probeGeometry,
+    extract: overrides.extract ?? extractAudio,
+    assertDuration: overrides.assertDuration ?? assertDurationConsistent,
+    resolvePricing: overrides.resolvePricing ?? ((key) => resolveToolPricing(key)),
+    upload: overrides.upload ?? uploadCached,
+    invalidate: overrides.invalidate ?? invalidateUpload,
+    submit: overrides.submit ?? submitTask,
+    sleep: overrides.sleep ?? ((ms) => new Promise((resolve12) => setTimeout(resolve12, ms))),
+    poll: overrides.poll ?? (async (cfg, taskType, taskId, onTick) => await pollToolTask(cfg, taskType, taskId, { onTick })),
+    writeMarkdown: overrides.writeMarkdown ?? writeMarkdownAtomic,
+    now: overrides.now ?? (() => new Date)
+  };
+}
+function looksLikeRemote(value) {
+  return /^[a-z][a-z0-9+.-]*:\/\//i.test(value.trim());
+}
+async function validateTranscriptInput(input) {
+  if (!input.trim())
+    throw new Error("缺少本地视频路径。用法：gtrk transcript <本地视频>");
+  if (looksLikeRemote(input)) {
+    throw new Error("视频转文字稿仅支持本地视频文件，不支持 URL、平台视频地址或远端下载");
+  }
+  const inputAbs = resolve11(input);
+  if (!existsSync21(inputAbs))
+    throw new Error(`本地视频不存在：${inputAbs}`);
+  const info = await stat6(inputAbs);
+  if (!info.isFile())
+    throw new Error(`输入不是文件：${inputAbs}`);
+  const extension = extname7(inputAbs).toLowerCase();
+  if (!(defaultExtsFor("video") ?? []).includes(extension)) {
+    throw new Error(`不支持的视频格式「${extension || "无扩展名"}」；请输入本地视频文件`);
+  }
+  return inputAbs;
+}
+function resolveTranscriptOutput(inputAbs, out) {
+  const base = basename12(inputAbs, extname7(inputAbs));
+  const output = out ? resolve11(out) : join26(dirname9(inputAbs), `${base}-transcript.md`);
+  if (extname7(output).toLowerCase() !== ".md")
+    throw new Error("--out 必须指向一个 .md 文件");
+  return output;
+}
+async function writeMarkdownAtomic(path, markdown) {
+  await mkdir12(dirname9(path), { recursive: true });
+  const temp = `${path}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
+  try {
+    await writeFile11(temp, markdown, "utf8");
+    await rename2(temp, path);
+  } finally {
+    await rm2(temp, { force: true });
+  }
+}
+async function runTranscript(input, opts = {}, depsOverride) {
+  if (opts.json)
+    routeLogsToStderr();
+  const inputAbs = await validateTranscriptInput(input);
+  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));
+  log.step(`▶ 视频转文字稿：${sourceName}`);
+  log.step("① 本地探测视频…");
+  const geometry = deps.probe(inputAbs, opts.ffmpegPath);
+  if (!(geometry.duration > 0))
+    throw new Error("未探测到有效视频时长，无法转写");
+  log.info(`视频时长 ${geometry.duration.toFixed(1)}s`);
+  const pricing = await deps.resolvePricing(PRICE_KEY);
+  log.info(`实时计费：${pricing.billingHint}`);
+  log.step("② 本地抽取 16k 单声道音频（原视频不上传）…");
+  const audio = await deps.extract(inputAbs, opts.ffmpegPath);
+  deps.assertDuration(geometry.duration, audio, opts.ffmpegPath);
+  log.info(`上传物：${basename12(audio)}（仅音频衍生物）`);
+  log.step("③ 上传音频并提交 ASR…");
+  const payload = (fileId) => ({ file_id: fileId, language, word_level: true });
+  const submitted = await uploadAndSubmitTask(deps.cfg, audio, TASK_TYPE3, payload, {
+    force: opts.reupload,
+    onCacheInvalid: () => log.warn("缓存的 file_id 已失效，重新上传后重试…")
+  }, {
+    uploadCached: deps.upload,
+    invalidateUpload: deps.invalidate,
+    submitTask: deps.submit,
+    sleep: deps.sleep
+  });
+  const { taskId } = submitted;
+  const uploaded = { fileId: submitted.fileId, cached: submitted.cached };
+  log.info(`task_id = ${taskId}`);
+  log.step("④ 云端识别中…");
+  const raw = await deps.poll(deps.cfg, TASK_TYPE3, taskId, (status, progress) => {
+    log.tick(`${status}${progress != null ? ` ${Math.round(progress)}%` : ""}`);
+  });
+  log.tickEnd();
+  const asr = normalizeAsrOutput(raw);
+  const markdown = renderTranscriptMarkdown({
+    title,
+    sourceName,
+    durationSec: geometry.duration,
+    language,
+    generatedAt: deps.now(),
+    asr
+  });
+  await deps.writeMarkdown(output, markdown);
+  return { ok: true, taskId, fileId: uploaded.fileId, output, summaryPending: true };
+}
+function configureTranscriptCommand(cmd, deps) {
+  return cmd.description("本地视频转文字稿：原视频不上传，只上传抽取音频，生成单个待 Agent 补总结的 Markdown").option("-o, --out <file>", "输出 Markdown 文件（缺省 <视频同目录>/<视频名>-transcript.md）").option("--lang <code>", "识别语言代码（默认 zh-CN）", "zh-CN").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录").option("--reupload", "强制重新上传抽取音频，忽略上传缓存").option("--json", "机读模式：stdout 只输出最终结果 JSON").action(async (video, opts) => {
+    const result = await runTranscript(video, opts, deps);
+    if (opts.json)
+      console.log(JSON.stringify(result));
+    else {
+      log.ok(`带时码文字稿已生成：${result.output}`);
+      log.warn("总结仍待驱动 CLI 的 Agent 阅读全文后写回同一个 Markdown");
+    }
+  });
+}
+function registerTranscript(program2) {
+  configureTranscriptCommand(program2.command("transcript <video>"));
+}
+
 // src/index.ts
 try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync5(join26(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync5(join27(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);
@@ -10086,6 +10978,7 @@ registerSplit(program2);
 registerMatrix(program2);
 registerMg(program2);
 registerTool(program2);
+registerTranscript(program2);
 program2.parseAsync(process.argv).catch((e) => {
   console.error(`
 ❌ ${e instanceof Error ? e.message : String(e)}`);