@gitruck/cli 0.2.19 → 0.2.20

package/README.md

@@ -414,6 +414,7 @@ gtrk transcript "D:/素材/采访视频.mp4" --lang zh-CN --out "D:/文字稿/
 | `video_motion_cut` | 单条本地视频 | 运镜/高光片段结构 `result-output.json`（结构化数据，非下载文件） | 运行前实时查询 | 已上线 |
 | `video_speaker_detect` | 单条本地视频；可选 `--language`/`--max-faces-per-frame`/`--detect-body`/`--track-sample-fps`（重 GPU） | 可见说话人结构 `result-output.json`（时基以服务端输出为准） | 运行前实时查询 | 已上线 |
 | `video_face_track` | 单条本地视频；可选 `--sample-fps`/`--max-faces`/`--min-face-ratio`/`--enable-body-match`/`--similarity-threshold`；`time_ranges` 走 `--params-json`（重 GPU） | 人物 ID/时间段/轨迹结构 `result-output.json`（时基以服务端输出为准） | 运行前实时查询 | 已上线 |
+| `audio_tts_clone` | **无文件**：`--text`/`--text-file` 二选一（≤2000 字）+ `--speaker` 必填；可选语言/格式/语速/切分法 | 配音音频 wav/mp3（按文本字数折算分钟计费） | 运行前实时查询 | 已上线 |
 | `video_ai_subtitle` | 单条视频或音频；`--language <码>` 必填；可选 `--translate-language`、`--need-render`、`--need-pure`、`--subtitle-type`、`--subtitle-color` | `.ass` 字幕 + 可选烧录/去字幕 `.mp4` + `result-output.json`（摘要 + 字级时间轴） | 运行前实时查询 | 已上线 |
 | `audio_separation` | 单条音频；可选 `--mode fast|turbo` | 人声与伴奏音频（按实际返回可为一项或两项） | 运行前实时查询 | 已上线 |
 | `audio_speaker_split` | 单条音频；可选 `--only-struct` | 各说话人 `.wav` 分轨 + `spoken_list` 时间线（`result-output.json`） | 运行前实时查询 | 已上线 |
@@ -467,6 +468,8 @@ gtrk transcript "D:/素材/采访视频.mp4" --lang zh-CN --out "D:/文字稿/
 - `gtrk tool video_split_screen a.mp4 b.mp4 --clips-json '[{"input":0,"begin_time_ms":0,"end_time_ms":5000},{"input":1,"crop":{"x":0.1,"y":0,"width":0.8,"height":1}}]'` — 精确档：按 0 起索引指定每段毫秒区间与归一化裁剪框；同一文件可多条目出多窗口。
 - `gtrk tool video_speaker_detect ./talk.mp4 --language zh-CN` — 检测画面里谁在何时说话，出结构化 JSON（重 GPU）。
 - `gtrk tool video_face_track ./talk.mp4 --params-json '{"time_ranges":[{"begin_time":0,"end_time":30000}]}'` — 人脸追踪/身份聚类，可限定时间段（**单位毫秒**；重 GPU）。
+- `gtrk tool audio_tts_clone --text "欢迎收听本期节目" --speaker narrator` — 文字转配音音频（音色列表见官网文档）。
+- `gtrk tool audio_tts_clone --text-file 稿子.txt --speaker sweet_female --output-format mp3` — 长文合成，缺省跟随音色调好的语速与切分参数。
 - `gtrk tool mad ./素材 [--bgm 歌.mp3] [--duration 20] [--seed 42] [--refresh] [--json]` — 一键剪 MAD：扫素材文件夹 → 自动选技法 → 单一 `.jsx`（AE 2020+ 跑一遍出母合成成片工程）。`--seed` 可复现；`result.json` 记 seed/数据版本/降级档位/选中技法。
 - 通用：`--out <dir>` 覆盖产物目录、`--param k=v`（可重复）/`--params-json '<对象>'` 透传云端参数、`--reupload` 忽略上传缓存、`--json` 机读、`--ffmpeg-path <dir>` 指定 ffmpeg 目录。
 - cloud 型工具缺 Key → 报错引导 `gtrk init`。产物下载失败（如链接过期 404）→ `result.json` 记 `errors`、`ok=false`、`task.json` 保留可凭 `taskId` 恢复。

package/dist/index.js

@@ -4196,7 +4196,7 @@ var {
 } = import__.default;
 
 // src/index.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 import { join as join30 } from "node:path";
 
 // src/lib/paths.ts
@@ -7286,12 +7286,12 @@ async function runOralCut(input, opts) {
 // src/commands/long2short.ts
 import { resolve as resolve6, join as join17, dirname as dirname5, basename as basename8, extname as extname5 } from "node:path";
 import { mkdir as mkdir6, writeFile as writeFile7, cp as cp2 } from "node:fs/promises";
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 
 // src/lib/tool-runner.ts
 import { resolve as resolve5, join as join16, dirname as dirname4, basename as basename7, extname as extname4 } from "node:path";
 import { mkdir as mkdir5, writeFile as writeFile6, stat as stat5 } from "node:fs/promises";
-import { createWriteStream, existsSync as existsSync14 } from "node:fs";
+import { createWriteStream, existsSync as existsSync15 } from "node:fs";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline } from "node:stream/promises";
 
@@ -7375,7 +7375,8 @@ async function resolveToolPricing(priceKey, pricingContext, fetchFn = fetch) {
 }
 
 // src/lib/tool-descriptors.ts
-import { extname as extname3 } from "node:path";
+import { readFileSync as readFileSync4 } from "node:fs";
+import { extname as extname3, resolve as resolvePath } from "node:path";
 var MULTI_INPUT_KINDS = new Set(["images", "videos"]);
 var IMAGE_EXTS = [".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".tif", ".tiff", ".heic", ".heif", ".avif"];
 var VIDEO_EXTS = [".mp4", ".mov", ".mkv", ".webm", ".avi", ".m4v", ".flv", ".wmv", ".mpg", ".mpeg", ".ts", ".m2ts"];
@@ -8191,7 +8192,7 @@ var audioStretch = {
   taskType: "audio_stretch",
   options: [
     { flag: "--semitones <n>", desc: "变调半音（升正降负；未传则不变调）" },
-    { flag: "--speed <n>", desc: "变速倍率（必须 > 0；未传则不变速）" }
+    { flag: "--speed <n>", desc: "变速/语速倍率（各工具范围与缺省见各自说明）" }
   ],
   buildPayload(fileId, ctx) {
     const payload = { file_id: fileId };
@@ -8549,6 +8550,66 @@ var videoSplitScreen = {
     return url ? [{ url, filename: `${ctx.baseName}-splitscreen${extFromUrl(url, ".mp4")}` }] : [];
   }
 };
+var audioTtsClone = {
+  name: "audio_tts_clone",
+  title: "声音克隆配音",
+  description: "输入一段文字，用指定音色合成配音音频（--text 短文本或 --text-file 文本文件二选一，≤2000 字）。按文本字数折算分钟计费。",
+  kind: "cloud",
+  input: { kind: "none" },
+  priceKey: "audio_tts_clone",
+  outputHint: "配音音频（wav/mp3）",
+  enabled: true,
+  taskType: "audio_tts_clone",
+  options: [
+    { flag: "--text <text>", desc: "待合成的短文本（与 --text-file 二选一）" },
+    { flag: "--text-file <file>", desc: "待合成的文本文件（UTF-8；与 --text 二选一）" },
+    { flag: "--speaker <code>", desc: "音色代号（必填；可用列表见官网文档「可用音色」，传错时报错会列出全部可用项）" },
+    { flag: "--text-lang <lang>", desc: "文本语言（未传则服务端默认 zh）" },
+    { flag: "--output-format <fmt>", desc: "输出音频格式 wav/mp3（未传则服务端默认 wav）" },
+    { flag: "--split-method <m>", desc: "长文切分法 cut0~cut5（未传则跟随该音色调好的参数）" },
+    { flag: "--batch-size <n>", desc: "分段并发批大小 1~16（未传则服务端默认）" }
+  ],
+  buildPayloadNone(ctx) {
+    const o = ctx.opts;
+    const hasText = typeof o.text === "string" && o.text.trim() !== "";
+    const hasFile = typeof o.textFile === "string" && o.textFile.trim() !== "";
+    if (hasText && hasFile)
+      throw new Error("--text 与 --text-file 只能给其一");
+    if (!hasText && !hasFile)
+      throw new Error("需要 --text <短文本> 或 --text-file <文本文件>（UTF-8）之一");
+    const text = hasText ? o.text : readFileSync4(resolvePath(o.textFile), "utf8");
+    if (!text.trim())
+      throw new Error("文本内容为空");
+    if (!(typeof o.speaker === "string" && o.speaker.trim())) {
+      throw new Error("audio_tts_clone 需要 --speaker <音色代号>（可用列表见官网文档；传错时服务端报错会列出可用项）");
+    }
+    const p = { text, speaker: o.speaker };
+    if (typeof o.textLang === "string")
+      p.text_lang = o.textLang;
+    if (typeof o.outputFormat === "string")
+      p.output_format = o.outputFormat;
+    const speed = parseNumFlag(o.speed, "--speed");
+    if (speed != null)
+      p.speed = speed;
+    if (typeof o.splitMethod === "string")
+      p.text_split_method = o.splitMethod;
+    const bs = parseNumFlag(o.batchSize, "--batch-size");
+    if (bs != null) {
+      if (!Number.isInteger(bs))
+        throw new Error(`--batch-size 需要整数，拿到「${String(o.batchSize)}」`);
+      p.batch_size = bs;
+    }
+    return p;
+  },
+  mapOutputs(out, ctx) {
+    const url = pickUrl(out, ["download_url"]);
+    if (!url)
+      return [];
+    const fallback = typeof ctx.opts.outputFormat === "string" ? `.${ctx.opts.outputFormat}` : ".wav";
+    const speaker = typeof ctx.opts.speaker === "string" && ctx.opts.speaker.trim() ? ctx.opts.speaker : "voice";
+    return [{ url, filename: `tts-${speaker}${extFromUrl(url, fallback)}` }];
+  }
+};
 var mad = {
   name: "mad",
   title: "一键剪 MAD",
@@ -8599,6 +8660,7 @@ var TOOL_REGISTRY = [
   imageClassicTemplate,
   imageVerticalStitch,
   videoSplitScreen,
+  audioTtsClone,
   mad
 ];
 function findTool(name, registry = TOOL_REGISTRY) {
@@ -8635,6 +8697,19 @@ function validateRegistry(registry = TOOL_REGISTRY) {
     } else if (d.buildPayloadMulti) {
       throw new Error(`非多文件工具不得声明 buildPayloadMulti：「${d.name}」`);
     }
+    if (d.buildPayloadNone) {
+      if (d.input.kind !== "none")
+        throw new Error(`非 none 工具不得声明 buildPayloadNone：「${d.name}」`);
+      if (d.buildPayload || d.buildPayloadMulti) {
+        throw new Error(`buildPayloadNone 与其他 payload 钩子互斥：「${d.name}」`);
+      }
+    }
+    if (d.kind === "cloud" && d.input.kind === "none") {
+      const paths = (d.preprocess ? 1 : 0) + (d.buildPayloadNone ? 1 : 0);
+      if (paths !== 1) {
+        throw new Error(`none 工具须声明 preprocess 或 buildPayloadNone 恰一：「${d.name}」`);
+      }
+    }
   }
 }
 
@@ -8685,7 +8760,7 @@ function validateToolInput(descriptor, inputAbs) {
     return;
   if (!inputAbs)
     throw new Error(`${descriptor.name} 需要输入${spec.kind === "directory" ? "目录" : "文件"}`);
-  if (!existsSync14(inputAbs))
+  if (!existsSync15(inputAbs))
     throw new Error(`输入不存在：${inputAbs}`);
   if (spec.kind === "directory")
     return;
@@ -8702,7 +8777,7 @@ function validateToolInputs(descriptor, inputAbsList) {
     throw new Error(`${descriptor.name} 需要至少一个输入文件（可传多个，顺序即拼装顺序）`);
   const exts = descriptor.input.exts ?? defaultExtsFor(descriptor.input.kind);
   for (const p of inputAbsList) {
-    if (!existsSync14(p))
+    if (!existsSync15(p))
       throw new Error(`输入不存在：${p}`);
     if (exts && exts.length) {
       const e = extname4(p).toLowerCase();
@@ -8849,11 +8924,13 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   const outDir = resolveOutDir(descriptor, inputAbs, opts.out);
   if (isMulti)
     descriptor.buildPayloadMulti(inputList.map(() => "__dry_run__"), ctx);
+  const isNoneDirect = descriptor.input.kind === "none" && !!descriptor.buildPayloadNone;
   let uploadPath = inputAbs;
   if (!isMulti && descriptor.preprocess)
     uploadPath = await descriptor.preprocess(ctx);
-  if (!uploadPath)
-    throw new Error(`${descriptor.name} 缺上传物（input=none 的 cloud 型工具需 preprocess 产上传物）`);
+  if (!uploadPath && !isNoneDirect) {
+    throw new Error(`${descriptor.name} 缺上传物（input=none 的 cloud 型工具需 preprocess 产上传物或声明 buildPayloadNone）`);
+  }
   let billingHint;
   try {
     billingHint = (await (deps.resolvePricing ?? resolveToolPricing)(descriptor.priceKey, descriptor.pricingContext)).billingHint;
@@ -8865,7 +8942,11 @@ async function runCloudTool(descriptor, inputArg, opts, deps) {
   let taskId;
   let fileId;
   let fileIds;
-  if (isMulti) {
+  if (isNoneDirect) {
+    const p = descriptor.buildPayloadNone(ctx);
+    mergeParams(p, extraParams);
+    taskId = await deps.submitTask(deps.cfg, taskType, p);
+  } else if (isMulti) {
     const buildMulti = (fids) => {
       const p = descriptor.buildPayloadMulti(fids, ctx);
       mergeParams(p, extraParams);
@@ -9006,7 +9087,7 @@ async function runLong2Short(input, opts) {
     routeLogsToStderr();
   const cfg = loadConfig();
   const inputAbs = resolve6(input);
-  if (!existsSync15(inputAbs))
+  if (!existsSync16(inputAbs))
     throw new Error(`毛片不存在：${inputAbs}`);
   const projName = basename8(inputAbs, extname5(inputAbs));
   const formats = opts.formats.split(",").map((s) => s.trim()).filter(Boolean);
@@ -9108,7 +9189,7 @@ async function runLong2Short(input, opts) {
   if (draftRoot) {
     for (const [i, cr] of clipResults.entries()) {
       const src = join17(cr.dir, "jianying");
-      if (!existsSync15(src))
+      if (!existsSync16(src))
         continue;
       const dest = `${draftTarget}_clip${i}`;
       try {
@@ -9245,13 +9326,13 @@ function registerUpgrade(program2) {
 
 // src/commands/render.ts
 import { resolve as resolve8, dirname as dirname6, join as join19, basename as basename9, extname as extname6 } from "node:path";
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 function registerRender(program2) {
   program2.command("render <gtrk>").description("本地渲染：gtrk 工程按 EDL 用本地 ffmpeg 渲染成片 mp4（素材取原片本地路径）").option("-o, --out <file>", "输出 mp4 路径（缺省 = <gtrk 同目录>/<gtrk 名>.mp4）").option("--crf <n>", "视频质量 CRF 14-28（越小越清晰/文件越大，默认 18）").option("--codec <c>", "视频编码（默认 h264）").option("--ffmpeg-path <dir>", "指定 ffmpeg/ffprobe 所在目录（缺省 ~/.gitruck/ffmpeg → 系统）").option("--no-open", "完成后不自动打开产物目录").option("--json", "机读模式：人读日志转 stderr，stdout 只输出结果 JSON").action(async (gtrk, opts) => {
     if (opts.json)
       routeLogsToStderr();
     const gtrkAbs = resolve8(gtrk);
-    if (!existsSync16(gtrkAbs))
+    if (!existsSync17(gtrkAbs))
       throw new Error(`gtrk 工程不存在：${gtrkAbs}`);
     const outMp4 = resolve8(opts.out ?? join19(dirname6(gtrkAbs), `${basename9(gtrkAbs, extname6(gtrkAbs))}.mp4`));
     log.step(`▶ 本地渲染：${basename9(gtrkAbs)} → ${basename9(outMp4)}`);
@@ -9278,16 +9359,16 @@ function registerRender(program2) {
 
 // src/commands/split.ts
 import { resolve as resolve9, join as join21, dirname as dirname8, basename as basename11 } from "node:path";
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 import { readFile as readFile5, writeFile as writeFile8, mkdir as mkdir7 } from "node:fs/promises";
 import { createHash } from "node:crypto";
 
 // src/lib/gtrk-writeback.ts
-import { readFileSync as readFileSync4, statSync, writeFileSync as writeFileSync2, renameSync, unlinkSync } from "node:fs";
+import { readFileSync as readFileSync5, statSync, writeFileSync as writeFileSync2, renameSync, unlinkSync } from "node:fs";
 import { dirname as dirname7, join as join20, basename as basename10 } from "node:path";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function readGtrk(path) {
-  const raw = readFileSync4(path, "utf8");
+  const raw = readFileSync5(path, "utf8");
   let gtrk;
   try {
     gtrk = JSON.parse(raw);
@@ -9347,7 +9428,7 @@ function registerSplit(program2) {
   });
 }
 function firstExisting(cands) {
-  return cands.find((p) => existsSync17(p));
+  return cands.find((p) => existsSync18(p));
 }
 function resolvePaths(opts) {
   const project = opts.project ? resolve9(opts.project) : undefined;
@@ -9359,7 +9440,7 @@ function resolvePaths(opts) {
   } else {
     throw new Error("需 --project <目录> 或显式 --gtrk <path>");
   }
-  if (!existsSync17(gtrkPath))
+  if (!existsSync18(gtrkPath))
     throw new Error(`找不到工程文件：${gtrkPath}`);
   let transcriptPath;
   if (opts.transcript)
@@ -9393,7 +9474,7 @@ async function runSplit(splitdoc, opts) {
   return splitdoc ? runLand(resolve9(splitdoc), baseDir, gtrkPath, transcriptPath, opts) : runView(baseDir, gtrkPath, transcriptPath, opts);
 }
 async function runView(baseDir, gtrkPath, transcriptPath, opts) {
-  if (!transcriptPath || !existsSync17(transcriptPath))
+  if (!transcriptPath || !existsSync18(transcriptPath))
     throw new Error(TRANSCRIPT_MISSING);
   log.step("▶ 导出投影视图（transcript × 当刻 .gtrk）…");
   const transcript = await loadTranscript(transcriptPath);
@@ -9419,9 +9500,9 @@ async function runView(baseDir, gtrkPath, transcriptPath, opts) {
   return result;
 }
 async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
-  if (!existsSync17(splitdocPath))
+  if (!existsSync18(splitdocPath))
     throw new Error(`找不到拆分稿：${splitdocPath}`);
-  if (!transcriptPath || !existsSync17(transcriptPath))
+  if (!transcriptPath || !existsSync18(transcriptPath))
     throw new Error(TRANSCRIPT_MISSING);
   log.step("▶ 校验拆分稿并落地…");
   const doc = JSON.parse(await readFile5(splitdocPath, "utf8"));
@@ -9497,7 +9578,7 @@ async function runLand(splitdocPath, baseDir, gtrkPath, transcriptPath, opts) {
 
 // src/commands/matrix.ts
 import { resolve as resolve11, join as join22, dirname as dirname9, basename as basename12 } from "node:path";
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { readFile as readFile6, writeFile as writeFile9, mkdir as mkdir8, rename } from "node:fs/promises";
 
 // src/lib/solid-png.ts
@@ -10234,7 +10315,7 @@ function layBrollTracks(opts) {
 }
 
 // src/lib/material-integrity.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 import { resolve as resolve10 } from "node:path";
 var INTEGRITY_LIST_CAP = 10;
 var r35 = (n) => Math.round(n * 1000) / 1000;
@@ -10295,7 +10376,7 @@ function collectMaterialRefs(gtrk) {
   return out;
 }
 function checkMaterialIntegrity(opts) {
-  const exists = opts.exists ?? ((p) => existsSync18(p));
+  const exists = opts.exists ?? ((p) => existsSync19(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 };
@@ -10645,7 +10726,7 @@ async function runPlanMode(cfg, tier, broll, overrides, columnId, opts) {
   } else {
     throw new Error('需 --project <目录> 或显式 --dispatch <path>（ad-hoc 检索用：gtrk matrix search "<query>"）');
   }
-  if (!existsSync19(dispatchPath))
+  if (!existsSync20(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split <拆分稿> 落地派单）`);
   const dispatch = JSON.parse(await readFile6(dispatchPath, "utf8"));
   const rawQueue = Array.isArray(dispatch.film_broll) ? dispatch.film_broll : [];
@@ -10761,7 +10842,7 @@ function parseScoreFloor(raw) {
 }
 function locateGtrk(baseDir) {
   const cands = [join22(baseDir, "gtrk", "project.gtrk"), join22(baseDir, "project.gtrk")];
-  return cands.find((p) => existsSync19(p));
+  return cands.find((p) => existsSync20(p));
 }
 async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRelay, reproj) {
   const gtrkPath = locateGtrk(baseDir);
@@ -10799,7 +10880,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
       continue;
     const rel = `${BROLL_PREVIEW_DIR}/${clipId}.mp4`;
     const abs = join22(gtrkDir, ...rel.split("/"));
-    if (existsSync19(abs)) {
+    if (existsSync20(abs)) {
       const prev = prevSource.get(clipId);
       if (prev !== "raw") {
         downloads.set(clipId, { rel, source: prev ?? "preview" });
@@ -10863,7 +10944,7 @@ async function layIntoProject(baseDir, plan, layN, scoreFloor, blackBed, forceRe
     const rel = solidRelPath(spec);
     const abs = join22(gtrkDir, ...rel.split("/"));
     try {
-      if (!existsSync19(abs)) {
+      if (!existsSync20(abs)) {
         await mkdir8(dirname9(abs), { recursive: true });
         const tmp = `${abs}.tmp-${process.pid}`;
         await writeFile9(tmp, encodeSolidPng(spec));
@@ -10980,7 +11061,7 @@ function slugify3(name) {
 
 // src/commands/mg.ts
 import { resolve as resolve12, join as join23, dirname as dirname10, basename as basename13 } from "node:path";
-import { existsSync as existsSync20 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 import { readFile as readFile7, mkdir as mkdir9, copyFile } from "node:fs/promises";
 
 // src/lib/mg-lint.ts
@@ -12506,18 +12587,18 @@ function resolveDispatch(opts) {
   throw new Error("需 --project <目录> 或显式 --dispatch <path>");
 }
 function locateGtrk2(baseDir) {
-  return [join23(baseDir, "gtrk", "project.gtrk"), join23(baseDir, "project.gtrk")].find((p) => existsSync20(p));
+  return [join23(baseDir, "gtrk", "project.gtrk"), join23(baseDir, "project.gtrk")].find((p) => existsSync21(p));
 }
 function locateSrcHtml(baseDir, compositionId) {
   for (const d of MG_SRC_DIRS) {
     const p = join23(baseDir, d, `${compositionId}.html`);
-    if (existsSync20(p))
+    if (existsSync21(p))
       return p;
   }
   return;
 }
 async function readMgQueue(dispatchPath) {
-  if (!existsSync20(dispatchPath))
+  if (!existsSync21(dispatchPath))
     throw new Error(`找不到派单清单：${dispatchPath}（先跑 gtrk split 落地派单）`);
   const dispatch = JSON.parse(await readFile7(dispatchPath, "utf8"));
   const queue = dispatch.mg ?? dispatch.rrv_mg;
@@ -12751,7 +12832,7 @@ async function runLint(args, opts) {
   let dispatchIds;
   let slotDuration;
   let compositionId;
-  if (opts.dispatch && existsSync20(resolve12(opts.dispatch))) {
+  if (opts.dispatch && existsSync21(resolve12(opts.dispatch))) {
     const queue = await readMgQueue(resolve12(opts.dispatch));
     dispatchIds = queue.map((q) => q.composition_id);
     const byName = queue.find((q) => q.composition_id === nameId);
@@ -12818,7 +12899,7 @@ function done(opts, result) {
 
 // src/lib/mad/mad.ts
 import { mkdir as mkdir12, writeFile as writeFile11 } from "node:fs/promises";
-import { existsSync as existsSync23, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync24, statSync as statSync3 } from "node:fs";
 import { resolve as resolve13, join as join27 } from "node:path";
 
 // src/lib/convert/types.ts
@@ -13790,7 +13871,7 @@ function beatQuantized(natLens, analysis) {
 // src/lib/mad/data.ts
 import { createHash as createHash2 } from "node:crypto";
 import { mkdir as mkdir10, readFile as readFile8, rename as rename2, rm, writeFile as writeFile10, readdir } from "node:fs/promises";
-import { existsSync as existsSync21 } from "node:fs";
+import { existsSync as existsSync22 } from "node:fs";
 import { join as join25 } from "node:path";
 function madCacheDir() {
   return homeFile("mad-cache");
@@ -13820,7 +13901,7 @@ async function atomicWrite(dest, data) {
   await rename2(tmp, dest);
 }
 async function verifyFile(path, sha256) {
-  if (!existsSync21(path))
+  if (!existsSync22(path))
     return false;
   try {
     const buf = await readFile8(path);
@@ -13872,7 +13953,7 @@ async function ensureMadData(opts, deps) {
     warn(`manifest 拉取失败（${e instanceof Error ? e.message : String(e)}），回退本地缓存`);
   }
   if (!manifest) {
-    if (!existsSync21(snapshotPath)) {
+    if (!existsSync22(snapshotPath)) {
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
     }
     try {
@@ -13894,7 +13975,7 @@ async function ensureMadData(opts, deps) {
   const needDownload = !!opts.refresh || !cacheValid;
   if (needDownload) {
     if (!online) {
-      if (existsSync21(poolPath)) {
+      if (existsSync22(poolPath)) {
         throw new Error("本地技法数据缓存损坏且当前离线。请连网重跑，或加 --refresh 强制重新下载。");
       }
       throw new Error("首次使用需联网下载技法数据。请连网后重跑 `gtrk tool mad`（数据会缓存到本地，之后可离线出片）。");
@@ -13930,7 +14011,7 @@ async function ensureMadData(opts, deps) {
 // src/lib/mad/pool.ts
 import { gunzipSync } from "node:zlib";
 import { mkdir as mkdir11, readFile as readFile9 } from "node:fs/promises";
-import { existsSync as existsSync22 } from "node:fs";
+import { existsSync as existsSync23 } from "node:fs";
 import { join as join26 } from "node:path";
 function shardPath(verDir, shard) {
   return join26(verDir, "ir", `${shard}.json.gz`);
@@ -13950,7 +14031,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
     if (cached)
       return cached;
     const path = shardPath(verDir, shard);
-    if (existsSync22(path)) {
+    if (existsSync23(path)) {
       try {
         const s2 = decodeShard(await readFile9(path));
         memo.set(shard, s2);
@@ -13982,7 +14063,7 @@ function makeIrLoader(assetsBase, verDir, online, deps) {
       return ir;
     },
     shardCached(shard) {
-      return memo.has(shard) || existsSync22(shardPath(verDir, shard));
+      return memo.has(shard) || existsSync23(shardPath(verDir, shard));
     }
   };
 }
@@ -14066,7 +14147,7 @@ async function runMad(inputArg, opts, deps = {}) {
   if (!inputArg)
     throw new Error("用法：gtrk tool mad <素材文件夹> [--bgm 歌.mp3]");
   const dirAbs = resolve13(inputArg);
-  if (!existsSync23(dirAbs) || !statSync3(dirAbs).isDirectory()) {
+  if (!existsSync24(dirAbs) || !statSync3(dirAbs).isDirectory()) {
     throw new Error(`素材文件夹不存在或不是目录：${dirAbs}`);
   }
   const { videos, orientation, skipped } = scanFolder(dirAbs, {
@@ -14327,7 +14408,7 @@ async function runMadInTool(inputArg, opts) {
 }
 
 // src/commands/transcript.ts
-import { existsSync as existsSync24 } from "node:fs";
+import { existsSync as existsSync25 } from "node:fs";
 import { mkdir as mkdir13, rename as rename3, rm as rm2, stat as stat6, writeFile as writeFile12 } from "node:fs/promises";
 import { basename as basename14, dirname as dirname11, extname as extname8, join as join28, resolve as resolve14 } from "node:path";
 
@@ -14466,7 +14547,7 @@ async function validateTranscriptInput(input) {
     throw new Error("视频转文字稿仅支持本地视频文件，不支持 URL、平台视频地址或远端下载");
   }
   const inputAbs = resolve14(input);
-  if (!existsSync24(inputAbs))
+  if (!existsSync25(inputAbs))
     throw new Error(`本地视频不存在：${inputAbs}`);
   const info = await stat6(inputAbs);
   if (!info.isFile())
@@ -14564,7 +14645,7 @@ function registerTranscript(program2) {
 // src/commands/music-visualizer.ts
 import { resolve as resolve15, join as join29, dirname as dirname12, basename as basename15, extname as extname9 } from "node:path";
 import { mkdir as mkdir14, writeFile as writeFile13 } from "node:fs/promises";
-import { existsSync as existsSync25 } from "node:fs";
+import { existsSync as existsSync26 } from "node:fs";
 var TASK_TYPE5 = "music_visualizer";
 var PRICE_KEY2 = "music_visualizer";
 var HEX_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
@@ -14612,7 +14693,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 (!existsSync25(pathAbs))
+  if (!existsSync26(pathAbs))
     throw new Error(`${label}不存在：${pathAbs}`);
   const e = extname9(pathAbs).toLowerCase();
   if (exts.length && !exts.includes(e)) {
@@ -14780,7 +14861,7 @@ try {
   process.loadEnvFile?.();
 } catch {}
 migrateLegacyHome();
-var { version } = JSON.parse(readFileSync5(join30(packageRoot(), "package.json"), "utf8"));
+var { version } = JSON.parse(readFileSync6(join30(packageRoot(), "package.json"), "utf8"));
 var program2 = new Command;
 program2.name("gtrk").description("同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通").version(version);
 registerInstall(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitruck/cli",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "description": "同合云成片流水线 CLI —— agent 驱动云端任务、产物拉回本地、三方工程文件（客户端/剪映/PR）互通。",
   "license": "MIT",
   "author": "Gitruck (同合云)",

package/skills/gtrk-tools/SKILL.md

@@ -46,6 +46,7 @@ description: gtrk 单点工具与媒体转换能力的调用向导，覆盖 `gtr
 | `image_to_live` | 「图片变 LivePhoto / 静图微动 / 让照片动起来」 | 单张图片 | 微动视频 `.mp4`（产物是视频） | 运行前实时查询 | 未开放（上游生成能力暂未开放，恢复后重新上架） |
 | `image_classic_template` | 「做封面 / 智能拼图 / 标题配图出封面图」 | **多张图片**（可传多个路径，文件顺序即拼装顺序）；**`--main-title <标题>` 必填**；可选 `--sub-title`、`--template-mode`、`--aspect`、`--quality`、`--output-pic-count`（服务端钳制 ≤20）、`--output-text-count`（≤20）、`--title-layout` | 封面/拼图成品（text/pic/render 三组、各组可空可多张） | 运行前实时查询 | 已上线 |
 | `image_vertical_stitch` | 「拼长图 / 多图竖拼 / 截图接成一张长图」 | **多张图片**（可传多个路径，顺序=自上而下拼接顺序） | 一张垂直拼接长图 | 运行前实时查询 | 已上线 |
+| `audio_tts_clone` | 「配音 / 文字转语音 / TTS / 用 xx 音色念这段 / 把这段稿子合成音频」 | **无文件**：`--text <短文本>` 或 `--text-file <txt>` 二选一（≤2000 字，服务端为真相）+ **`--speaker <音色代号>` 必填**（可用音色见官网文档，传错时报错会列出全部可用项）；可选 `--text-lang`/`--output-format wav\|mp3`/`--speed`/`--split-method`/`--batch-size`（speed/切分法缺省跟随该音色调好的参数）。**计费按文本字数折算分钟（约 200 字/分钟）** | 配音音频（wav/mp3） | 运行前实时查询 | 已上线 |
 | `mad` | 「一键剪 MAD / 素材文件夹自动出卡点成片 / 自动选技法 / 给这堆素材出个 AE 工程」 | 一个素材文件夹（3~10 条视频）+ 可选 `--bgm 歌.mp3` | AE 母合成工程 `.jsx`（仅支持 AE） | 仅 `--bgm` 触发实时查价 | 已上线 |
 
 > 清单随 CLI 版本增补。**动手前先跑 `gtrk tool list --json` 拿最新清单**，别凭记忆——新工具、状态变化都在那里。