@downcity/city 1.1.1 → 1.1.4

package/bin/plugins/tts/runtime/Installer.js

@@ -1,188 +0,0 @@
-/**
- * TTS 模型安装器。
- *
- * 关键点（中文）
- * - 统一把 HuggingFace 资源下载到本地模型目录。
- * - 支持“整仓下载”与“仅下载指定文件”两种模式。
- */
-import fs from "node:fs";
-import path from "node:path";
-import { Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
-import fsExtra from "fs-extra";
-const HUGGINGFACE_HOST = "https://huggingface.co";
-const TTS_INSTALL_MANIFEST = "downcity.tts.install.json";
-function encodePathSegments(input) {
-    return input
-        .split("/")
-        .map((segment) => encodeURIComponent(segment))
-        .join("/");
-}
-function buildAuthHeaders(token) {
-    const t = String(token || "").trim();
-    if (!t)
-        return undefined;
-    return { Authorization: `Bearer ${t}` };
-}
-function resolveSafeTargetPath(baseDir, relativePath) {
-    const normalized = relativePath.replace(/\\/g, "/");
-    const target = path.resolve(baseDir, normalized);
-    const base = path.resolve(baseDir);
-    if (target !== base && !target.startsWith(`${base}${path.sep}`)) {
-        throw new Error(`Unsafe file path from HuggingFace: ${relativePath}`);
-    }
-    return target;
-}
-async function readRepoFiles(input) {
-    const repoUrlPath = encodePathSegments(input.repoId);
-    const metadataUrl = `${HUGGINGFACE_HOST}/api/models/${repoUrlPath}`;
-    const response = await fetch(metadataUrl, {
-        headers: {
-            Accept: "application/json",
-            ...(buildAuthHeaders(input.hfToken) || {}),
-        },
-    });
-    if (!response.ok) {
-        const responseText = await response.text().catch(() => "");
-        throw new Error(`Failed to fetch model metadata (${input.repoId}): HTTP ${response.status}${responseText ? ` ${responseText.slice(0, 300)}` : ""}`);
-    }
-    const payload = (await response.json());
-    const files = (Array.isArray(payload.siblings) ? payload.siblings : [])
-        .map((item) => String(item?.rfilename || "").trim())
-        .filter(Boolean)
-        .filter((item) => item !== ".gitattributes");
-    if (files.length === 0) {
-        throw new Error(`No downloadable files found in repo: ${input.repoId}`);
-    }
-    return files;
-}
-async function downloadModelFile(input) {
-    const repoPath = encodePathSegments(input.repoId);
-    const revision = encodeURIComponent(input.revision);
-    const filePath = encodePathSegments(input.filePath);
-    const url = `${HUGGINGFACE_HOST}/${repoPath}/resolve/${revision}/${filePath}?download=1`;
-    const response = await fetch(url, {
-        headers: {
-            ...(buildAuthHeaders(input.hfToken) || {}),
-        },
-    });
-    if (!response.ok) {
-        const responseText = await response.text().catch(() => "");
-        throw new Error(`Failed to download ${input.filePath}: HTTP ${response.status}${responseText ? ` ${responseText.slice(0, 300)}` : ""}`);
-    }
-    if (!response.body) {
-        throw new Error(`Empty response body for file: ${input.filePath}`);
-    }
-    const tempPath = `${input.targetPath}.downloading`;
-    await fsExtra.ensureDir(path.dirname(input.targetPath));
-    try {
-        const body = Readable.fromWeb(response.body);
-        await pipeline(body, fs.createWriteStream(tempPath));
-        await fsExtra.move(tempPath, input.targetPath, { overwrite: true });
-    }
-    catch (error) {
-        await fsExtra.remove(tempPath).catch(() => undefined);
-        throw error;
-    }
-}
-/**
- * 判断模型在本地是否已安装。
- *
- * 关键点（中文）
- * - 优先识别安装清单 `downcity.tts.install.json`。
- * - 若无清单但目录非空，也视为已存在模型，避免重复下载。
- */
-export async function detectLocalTtsModelInstallState(input) {
-    const modelDir = path.resolve(input.modelsRootDir, input.modelId);
-    const manifestPath = path.join(modelDir, TTS_INSTALL_MANIFEST);
-    const hasManifest = await fsExtra.pathExists(manifestPath);
-    if (hasManifest) {
-        return {
-            modelDir,
-            installed: true,
-            source: "manifest",
-        };
-    }
-    const hasModelDir = await fsExtra.pathExists(modelDir);
-    if (!hasModelDir) {
-        return {
-            modelDir,
-            installed: false,
-        };
-    }
-    const entries = await fsExtra.readdir(modelDir).catch(() => []);
-    const hasPersistedFiles = entries.some((entry) => !String(entry).endsWith(".downloading"));
-    if (!hasPersistedFiles) {
-        return {
-            modelDir,
-            installed: false,
-        };
-    }
-    return {
-        modelDir,
-        installed: true,
-        source: "directory",
-    };
-}
-/**
- * 安装指定 TTS 模型到本地目录。
- *
- * 关键点（中文）
- * - 使用 HTTP 文件级下载，不依赖 git-lfs。
- * - 默认复用已有文件；`force=true` 时覆盖重下。
- */
-export async function installTtsModelFromHuggingFace(input) {
-    const modelDir = path.resolve(input.modelsRootDir, input.model.id);
-    await fsExtra.ensureDir(modelDir);
-    let downloadedFiles = 0;
-    let skippedFiles = 0;
-    const downloadedFilePaths = [];
-    const skippedFilePaths = [];
-    for (const asset of input.model.assets) {
-        const assetFiles = Array.isArray(asset.files) && asset.files.length > 0
-            ? asset.files
-            : await readRepoFiles({
-                repoId: asset.repoId,
-                hfToken: input.hfToken,
-            });
-        const assetBaseDir = asset.targetSubdir
-            ? path.resolve(modelDir, asset.targetSubdir)
-            : modelDir;
-        await fsExtra.ensureDir(assetBaseDir);
-        for (const filePath of assetFiles) {
-            const relativeToModel = asset.targetSubdir
-                ? path.posix.join(asset.targetSubdir.replace(/\\/g, "/"), filePath)
-                : filePath;
-            const targetPath = resolveSafeTargetPath(assetBaseDir, filePath);
-            const exists = await fsExtra.pathExists(targetPath);
-            if (exists && input.force !== true) {
-                skippedFiles += 1;
-                skippedFilePaths.push(relativeToModel);
-                continue;
-            }
-            await downloadModelFile({
-                repoId: asset.repoId,
-                revision: asset.revision,
-                filePath,
-                targetPath,
-                hfToken: input.hfToken,
-            });
-            downloadedFiles += 1;
-            downloadedFilePaths.push(relativeToModel);
-        }
-    }
-    const manifestPath = path.join(modelDir, TTS_INSTALL_MANIFEST);
-    await fsExtra.writeJson(manifestPath, {
-        modelId: input.model.id,
-        installedAt: new Date().toISOString(),
-        assets: input.model.assets,
-    }, { spaces: 2 });
-    return {
-        modelDir,
-        downloadedFiles,
-        skippedFiles,
-        downloadedFilePaths,
-        skippedFilePaths,
-    };
-}
-//# sourceMappingURL=Installer.js.map

package/bin/plugins/tts/runtime/Installer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Installer.js","sourceRoot":"","sources":["../../../../src/plugins/tts/runtime/Installer.ts"],"names":[],"mappings":"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"}

package/bin/plugins/tts/runtime/Paths.d.ts

@@ -1,20 +0,0 @@
-/**
- * TTS 模型目录路径辅助。
- *
- * 关键点（中文）
- * - 统一把相对路径、`~` 与默认目录解析成绝对路径。
- */
-/**
- * 将相对路径解析为绝对路径；空值时回退默认目录。
- */
-export declare function resolveTtsModelsRootDir(input: {
-    /**
-     * 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 用户显式配置的模型目录（可选）。
-     */
-    modelsDir?: string;
-}): string;
-//# sourceMappingURL=Paths.d.ts.map

package/bin/plugins/tts/runtime/Paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../../src/plugins/tts/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAMT"}

package/bin/plugins/tts/runtime/Paths.js

@@ -1,32 +0,0 @@
-/**
- * TTS 模型目录路径辅助。
- *
- * 关键点（中文）
- * - 统一把相对路径、`~` 与默认目录解析成绝对路径。
- */
-import os from "node:os";
-import path from "node:path";
-function expandHomePath(inputPath) {
-    const raw = String(inputPath || "").trim();
-    if (!raw)
-        return raw;
-    if (raw === "~")
-        return os.homedir();
-    if (raw.startsWith("~/")) {
-        return path.join(os.homedir(), raw.slice(2));
-    }
-    return raw;
-}
-/**
- * 将相对路径解析为绝对路径；空值时回退默认目录。
- */
-export function resolveTtsModelsRootDir(input) {
-    const fallback = path.join(os.homedir(), ".downcity", "models", "tts");
-    const raw = expandHomePath(String(input.modelsDir || fallback).trim());
-    if (!raw)
-        return path.resolve(fallback);
-    if (path.isAbsolute(raw))
-        return path.resolve(raw);
-    return path.resolve(input.projectRoot, raw);
-}
-//# sourceMappingURL=Paths.js.map

package/bin/plugins/tts/runtime/Paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../../../src/plugins/tts/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,cAAc,CAAC,SAAiB;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACrC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KASvC;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/bin/plugins/tts/runtime/Synthesizer.d.ts

@@ -1,44 +0,0 @@
-/**
- * TTS 语音合成 runtime。
- *
- * 关键点（中文）
- * - 读取本地模型目录，不再依赖 console 模型池。
- * - 根据模型族选择对应 Python runner，并把输出落到本地文件。
- */
-import type { TtsPluginConfig, TtsSynthesizeInput } from "../../../shared/types/TtsPlugin.js";
-import type { PluginCommandContext } from "../../../shared/types/Plugin.js";
-/**
- * 执行一次 TTS 合成，并写出音频文件。
- */
-export declare function synthesizeSpeechFile(params: {
-    /**
-     * 当前执行上下文。
-     */
-    context: PluginCommandContext;
-    /**
-     * 当前 plugin 配置。
-     */
-    config: TtsPluginConfig;
-    /**
-     * 本次合成输入。
-     */
-    input: TtsSynthesizeInput;
-}): Promise<{
-    /**
-     * 输出相对路径。
-     */
-    outputPath: string;
-    /**
-     * 可发送文件标签。
-     */
-    fileTag: string;
-    /**
-     * 文件字节数。
-     */
-    bytes: number;
-    /**
-     * Python runner stderr 摘要（可选）。
-     */
-    stderrSummary?: string;
-}>;
-//# sourceMappingURL=Synthesizer.d.ts.map

package/bin/plugins/tts/runtime/Synthesizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Synthesizer.d.ts","sourceRoot":"","sources":["../../../../src/plugins/tts/runtime/Synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAuWrE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD;;OAEG;IACH,OAAO,EAAE,oBAAoB,CAAC;IAC9B;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAyED"}

package/bin/plugins/tts/runtime/Synthesizer.js

@@ -1,363 +0,0 @@
-/**
- * TTS 语音合成 runtime。
- *
- * 关键点（中文）
- * - 读取本地模型目录，不再依赖 console 模型池。
- * - 根据模型族选择对应 Python runner，并把输出落到本地文件。
- */
-import { execFile as execFileCb } from "node:child_process";
-import path from "node:path";
-import { promisify } from "node:util";
-import fs from "fs-extra";
-import { renderChatMessageFileTag } from "../../../services/chat/runtime/ChatMessageMarkup.js";
-import { getTtsModelCatalogItem, resolveTtsModelId } from "../../../plugins/tts/runtime/Catalog.js";
-import { resolveTtsModelsRootDir } from "../../../plugins/tts/runtime/Paths.js";
-const execFileAsync = promisify(execFileCb);
-const DEFAULT_TTS_TIMEOUT_MS = 300_000;
-function normalizeText(value) {
-    return String(value || "").trim();
-}
-function normalizeFormat(value) {
-    return normalizeText(value).toLowerCase() === "flac" ? "flac" : "wav";
-}
-function normalizeSpeed(value) {
-    if (typeof value !== "number" || !Number.isFinite(value) || Number.isNaN(value)) {
-        return 1;
-    }
-    const next = Math.max(0.5, Math.min(2, value));
-    return Number(next.toFixed(2));
-}
-function normalizeTimeoutMs(value) {
-    if (typeof value !== "number" || !Number.isFinite(value) || Number.isNaN(value)) {
-        return DEFAULT_TTS_TIMEOUT_MS;
-    }
-    if (value < 5_000)
-        return 5_000;
-    if (value > 900_000)
-        return 900_000;
-    return Math.floor(value);
-}
-function sanitizeFileStem(value) {
-    return value
-        .replace(/[^A-Za-z0-9_-]+/g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 48) || "tts";
-}
-function toProjectRelativePath(projectRoot, targetPath) {
-    const relative = path.relative(projectRoot, targetPath);
-    if (!relative)
-        return null;
-    if (relative.startsWith(".."))
-        return null;
-    if (path.isAbsolute(relative))
-        return null;
-    return relative.split(path.sep).join("/");
-}
-function resolveOutputTarget(params) {
-    const output = normalizeText(params.output);
-    const defaultDir = path.join(params.context.paths.getCacheDirPath(), "tts");
-    const target = output
-        ? (path.isAbsolute(output)
-            ? path.normalize(output)
-            : path.resolve(params.context.rootPath, output))
-        : defaultDir;
-    const ext = `.${params.format}`;
-    const hasExplicitFile = Boolean(path.extname(target));
-    const filePath = hasExplicitFile
-        ? target
-        : path.join(target, `${Date.now()}-${sanitizeFileStem(params.modelId)}${ext}`);
-    const relativePath = toProjectRelativePath(params.context.rootPath, filePath);
-    if (!relativePath) {
-        throw new Error(`TTS output must stay inside project root: ${filePath}`);
-    }
-    return {
-        absPath: filePath,
-        relativePath,
-    };
-}
-function pickLastNonEmptyLine(value) {
-    const lines = String(value || "")
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean);
-    return lines.length > 0 ? lines[lines.length - 1] : "";
-}
-/**
- * 判断一条 stderr 是否属于可忽略的 Python 推理提示。
- *
- * 关键点（中文）
- * - 某些第三方库会把 warning / info 打到 stderr，但并不影响音频文件生成。
- * - 这里只过滤已知的非致命提示，避免把真实错误静默吞掉。
- */
-function isIgnorablePythonStderrLine(value) {
-    const line = normalizeText(value);
-    if (!line)
-        return true;
-    if (/^Setting `pad_token_id` to `eos_token_id`/u.test(line))
-        return true;
-    if (/^`torch_dtype` is deprecated!/u.test(line))
-        return true;
-    if (/^Warning: flash-attn is not installed\./u.test(line))
-        return true;
-    return false;
-}
-/**
- * 提取 stderr 中真正需要上抛的错误文本。
- *
- * 关键点（中文）
- * - 去掉空行与已知 warning 后，只要还有剩余内容，就按真实错误处理。
- * - 返回最后一条非 warning 行，方便 CLI 给出更稳定的错误摘要。
- */
-function pickUnexpectedPythonStderr(value) {
-    const lines = String(value || "")
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter((line) => Boolean(line) && !isIgnorablePythonStderrLine(line));
-    return lines.length > 0 ? lines[lines.length - 1] : "";
-}
-/**
- * 归一化 Python stderr 摘要。
- *
- * 关键点（中文）
- * - 某些 runner 会把非致命提示打印到 stderr。
- * - 这里保留最后一条真正有意义的内容，供上层作为说明返回。
- */
-function normalizePythonStderrSummary(value) {
-    const lines = String(value || "")
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean);
-    if (lines.length === 0) {
-        return undefined;
-    }
-    return lines[lines.length - 1];
-}
-function detectLanguageHint(input) {
-    return /[\u3400-\u9fff]/u.test(input) ? "zh" : "en";
-}
-function resolveKokoroVoicePath(params) {
-    const voicesDir = path.join(params.modelDir, "voices");
-    const requested = normalizeText(params.voice);
-    if (requested) {
-        const requestedPath = requested.endsWith(".pt")
-            ? path.resolve(voicesDir, requested)
-            : path.resolve(voicesDir, `${requested}.pt`);
-        if (fs.existsSync(requestedPath)) {
-            return requestedPath;
-        }
-    }
-    const preferred = params.language === "zh"
-        ? ["zf_xiaoni.pt", "af_heart.pt"]
-        : ["af_heart.pt", "zf_xiaoni.pt"];
-    for (const fileName of preferred) {
-        const candidate = path.join(voicesDir, fileName);
-        if (fs.existsSync(candidate)) {
-            return candidate;
-        }
-    }
-    const entries = fs.readdirSync(voicesDir).filter((item) => item.endsWith(".pt"));
-    if (entries.length === 0) {
-        throw new Error(`kokoro voice assets are missing: ${voicesDir}`);
-    }
-    return path.join(voicesDir, entries[0]);
-}
-function buildPythonExecEnv(pythonBin) {
-    const env = { ...process.env };
-    const raw = String(pythonBin || "").trim();
-    if (!raw || (!raw.includes("/") && !raw.includes("\\"))) {
-        return env;
-    }
-    const pythonDir = path.dirname(path.resolve(raw));
-    const currentPath = String(env.PATH || "");
-    const segments = currentPath
-        .split(path.delimiter)
-        .map((item) => item.trim())
-        .filter(Boolean);
-    if (!segments.includes(pythonDir)) {
-        env.PATH = [pythonDir, ...segments].join(path.delimiter);
-    }
-    return env;
-}
-async function runPythonInline(params) {
-    let stdout = "";
-    let stderr = "";
-    try {
-        const output = await execFileAsync(params.pythonBin, ["-c", params.script, ...params.args], {
-            timeout: params.timeoutMs,
-            maxBuffer: 8 * 1024 * 1024,
-            env: buildPythonExecEnv(params.pythonBin),
-        });
-        stdout = String(output.stdout || "");
-        stderr = String(output.stderr || "");
-    }
-    catch (error) {
-        const errorLike = error;
-        stdout = String(errorLike.stdout || "");
-        stderr = String(errorLike.stderr || "");
-        const err = pickLastNonEmptyLine(stderr) || pickLastNonEmptyLine(stdout);
-        if (err) {
-            throw new Error(`python runner failed: ${err}`);
-        }
-        throw new Error(`python runner failed: ${String(errorLike.message || error)}`);
-    }
-    const err = pickUnexpectedPythonStderr(stderr);
-    return {
-        stderrSummary: err || normalizePythonStderrSummary(stderr),
-    };
-}
-const KOKORO_INLINE_SCRIPT = [
-    "import numpy as np",
-    "import soundfile as sf",
-    "import torch",
-    "from kokoro import KModel, KPipeline",
-    "config_path = __import__('sys').argv[1]",
-    "model_path = __import__('sys').argv[2]",
-    "voice_path = __import__('sys').argv[3]",
-    "lang_code = __import__('sys').argv[4]",
-    "text = __import__('sys').argv[5]",
-    "output_path = __import__('sys').argv[6]",
-    "speed = float(__import__('sys').argv[7])",
-    "device = 'cuda' if torch.cuda.is_available() else 'cpu'",
-    "model = KModel(config=config_path, model=model_path).to(device).eval()",
-    "pipeline = KPipeline(lang_code=lang_code, model=model, device=device)",
-    "chunks = []",
-    "for _, _, audio in pipeline(text, voice=voice_path, speed=speed):",
-    "    if audio is None:",
-    "        continue",
-    "    chunks.append(audio.cpu().numpy() if hasattr(audio, 'cpu') else np.asarray(audio))",
-    "if not chunks:",
-    "    raise RuntimeError('kokoro returned empty audio')",
-    "wave = np.concatenate(chunks)",
-    "sf.write(output_path, wave, 24000)",
-    "print(output_path)",
-].join("\n");
-const QWEN3_INLINE_SCRIPT = [
-    "import soundfile as sf",
-    "import torch",
-    "from qwen_tts import Qwen3TTSModel",
-    "model_path = __import__('sys').argv[1]",
-    "text = __import__('sys').argv[2]",
-    "voice = __import__('sys').argv[3]",
-    "language = __import__('sys').argv[4]",
-    "output_path = __import__('sys').argv[5]",
-    "speed = float(__import__('sys').argv[6])",
-    "device = 'cuda' if torch.cuda.is_available() else 'cpu'",
-    "dtype = torch.bfloat16 if torch.cuda.is_available() else torch.float32",
-    "model = Qwen3TTSModel.from_pretrained(model_path, device_map=device, dtype=dtype)",
-    "speakers = model.get_supported_speakers() or []",
-    "speaker = voice if voice and voice in speakers else (speakers[0] if speakers else voice)",
-    "if not speaker:",
-    "    raise RuntimeError('qwen3 supported speaker list is empty')",
-    "languages = model.get_supported_languages() or []",
-    "resolved_language = language if language and language in languages else ('Auto' if 'Auto' in languages else (languages[0] if languages else 'Auto'))",
-    "wavs, sample_rate = model.generate_custom_voice(text=text, speaker=speaker, language=resolved_language, non_streaming_mode=True, do_sample=True, top_p=0.9, temperature=0.7, repetition_penalty=1.05)",
-    "wave = wavs[0] if isinstance(wavs, list) else wavs",
-    "sf.write(output_path, wave, sample_rate)",
-    "print(output_path)",
-].join("\n");
-async function runKokoroSynthesizer(params) {
-    const voicePath = resolveKokoroVoicePath({
-        modelDir: params.modelDir,
-        voice: params.voice,
-        language: params.language,
-    });
-    const configPath = path.join(params.modelDir, "config.json");
-    const modelPath = path.join(params.modelDir, "kokoro-v1_0.pth");
-    return runPythonInline({
-        pythonBin: params.pythonBin,
-        script: KOKORO_INLINE_SCRIPT,
-        args: [
-            configPath,
-            modelPath,
-            voicePath,
-            params.language === "zh" ? "z" : "a",
-            params.text,
-            params.outputPath,
-            String(params.speed),
-        ],
-        timeoutMs: params.timeoutMs,
-    });
-}
-async function runQwen3Synthesizer(params) {
-    return runPythonInline({
-        pythonBin: params.pythonBin,
-        script: QWEN3_INLINE_SCRIPT,
-        args: [
-            params.modelDir,
-            params.text,
-            normalizeText(params.voice),
-            params.language === "zh" ? "Chinese" : params.language === "en" ? "English" : "Auto",
-            params.outputPath,
-            String(params.speed),
-        ],
-        timeoutMs: params.timeoutMs,
-    });
-}
-/**
- * 执行一次 TTS 合成，并写出音频文件。
- */
-export async function synthesizeSpeechFile(params) {
-    const text = normalizeText(params.input.text);
-    if (!text) {
-        throw new Error("tts synthesize requires text");
-    }
-    const modelId = resolveTtsModelId(normalizeText(params.input.modelId || params.config.modelId));
-    if (!modelId) {
-        throw new Error("tts modelId is missing");
-    }
-    const model = getTtsModelCatalogItem(modelId);
-    if (!model) {
-        throw new Error(`Unsupported tts model: ${modelId}`);
-    }
-    const format = normalizeFormat(params.input.format || params.config.format);
-    const speed = normalizeSpeed(typeof params.input.speed === "number" ? params.input.speed : params.config.speed);
-    const language = normalizeText(params.input.language || params.config.language) ||
-        detectLanguageHint(text);
-    const pythonBin = normalizeText(params.config.pythonBin) || "python3";
-    const timeoutMs = normalizeTimeoutMs(params.config.timeoutMs);
-    const modelsRootDir = resolveTtsModelsRootDir({
-        projectRoot: params.context.rootPath,
-        modelsDir: params.config.modelsDir,
-    });
-    const modelDir = path.join(modelsRootDir, modelId);
-    const output = resolveOutputTarget({
-        context: params.context,
-        format,
-        output: normalizeText(params.input.output || params.config.outputDir),
-        modelId,
-    });
-    await fs.ensureDir(path.dirname(output.absPath));
-    const runResult = model.family === "kokoro"
-        ? await runKokoroSynthesizer({
-            pythonBin,
-            modelDir,
-            text,
-            voice: params.input.voice || params.config.voice,
-            language,
-            outputPath: output.absPath,
-            speed,
-            timeoutMs,
-        })
-        : await runQwen3Synthesizer({
-            pythonBin,
-            modelDir,
-            text,
-            voice: params.input.voice || params.config.voice,
-            language,
-            outputPath: output.absPath,
-            speed,
-            timeoutMs,
-        });
-    const stats = await fs.stat(output.absPath);
-    return {
-        outputPath: output.relativePath,
-        fileTag: renderChatMessageFileTag({
-            type: "audio",
-            path: output.relativePath,
-        }),
-        bytes: stats.size,
-        ...(runResult.stderrSummary ? { stderrSummary: runResult.stderrSummary } : {}),
-    };
-}
-//# sourceMappingURL=Synthesizer.js.map