@downcity/plugins 1.0.4

package/bin/tts/runtime/Synthesizer.js

@@ -0,0 +1,363 @@
+/**
+ * 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 "@downcity/agent/internal/executor/messages/ChatMessageMarkup.js";
+import { getTtsModelCatalogItem, resolveTtsModelId } from "../../tts/runtime/Catalog.js";
+import { resolveTtsModelsRootDir } from "../../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

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

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

package/bin/tts/types/Tts.d.ts

@@ -0,0 +1,91 @@
+/**
+ * TTS 模型目录与推理族类型定义。
+ *
+ * 设计目标（中文）
+ * - 统一描述 TTS 领域里的稳定模型 ID、模型族与下载清单。
+ * - 让 plugin / runtime / console 共用同一套目录元数据。
+ */
+/**
+ * TTS provider 类型。
+ *
+ * 说明（中文）
+ * - 当前仅保留 `local`，统一走本地模型目录与 Python runner。
+ */
+export type TtsProvider = "local";
+/**
+ * 内置可选 TTS 模型 ID。
+ *
+ * 说明（中文）
+ * - 保持稳定字符串，避免后续改名破坏用户配置。
+ */
+export type TtsModelId = "qwen3-tts-0.6b" | "kokoro-82m" | "qwen3-tts-1.7b";
+/**
+ * TTS 本地推理实现族。
+ *
+ * 说明（中文）
+ * - `qwen3`：Qwen3-TTS 系列。
+ * - `kokoro`：Kokoro 系列。
+ */
+export type TtsRuntimeFamily = "qwen3" | "kokoro";
+/**
+ * TTS 输出音频格式。
+ *
+ * 说明（中文）
+ * - 当前仅保留本地 runner 稳定支持的格式。
+ */
+export type TtsAudioFormat = "wav" | "flac";
+/**
+ * 单个 HuggingFace 下载资源定义。
+ */
+export interface TtsModelAsset {
+    /**
+     * 资源仓库 ID（owner/repo）。
+     */
+    repoId: string;
+    /**
+     * 下载 revision（通常为 main）。
+     */
+    revision: string;
+    /**
+     * 仅下载这些文件（可选）。
+     *
+     * 说明（中文）
+     * - 为空时表示下载该 repo 的全部文件。
+     * - 用于像 Kokoro 这样只需要少量核心文件的场景。
+     */
+    files?: string[];
+    /**
+     * 下载到模型目录内的目标子目录（可选）。
+     */
+    targetSubdir?: string;
+}
+/**
+ * TTS 内置模型目录条目。
+ */
+export interface TtsModelCatalogItem {
+    /**
+     * 模型稳定 ID（配置与命令唯一键）。
+     */
+    id: TtsModelId;
+    /**
+     * Console / CLI 展示名称。
+     */
+    label: string;
+    /**
+     * 面向用户的简要说明。
+     */
+    description: string;
+    /**
+     * 本地推理所对应的实现族。
+     */
+    family: TtsRuntimeFamily;
+    /**
+     * 是否作为优先推荐项展示。
+     */
+    recommended: boolean;
+    /**
+     * 模型安装时需要下载的资源列表。
+     */
+    assets: TtsModelAsset[];
+}
+//# sourceMappingURL=Tts.d.ts.map

package/bin/tts/types/Tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tts.d.ts","sourceRoot":"","sources":["../../../src/tts/types/Tts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,UAAU,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB"}

package/bin/tts/types/Tts.js

@@ -0,0 +1,9 @@
+/**
+ * TTS 模型目录与推理族类型定义。
+ *
+ * 设计目标（中文）
+ * - 统一描述 TTS 领域里的稳定模型 ID、模型族与下载清单。
+ * - 让 plugin / runtime / console 共用同一套目录元数据。
+ */
+export {};
+//# sourceMappingURL=Tts.js.map

package/bin/tts/types/Tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tts.js","sourceRoot":"","sources":["../../../src/tts/types/Tts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/tts/types/TtsPlugin.d.ts

@@ -0,0 +1,161 @@
+/**
+ * TTS Plugin 类型定义。
+ *
+ * 关键点（中文）
+ * - TTS 的行为配置与本地模型依赖统一收敛到 `plugins.tts`。
+ * - Console 只需要理解 plugin setup，不需要理解底层 asset 细节。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { TtsAudioFormat, TtsProvider } from "../../tts/types/Tts.js";
+/**
+ * TTS Plugin 配置。
+ */
+export interface TtsPluginConfig {
+    /**
+     * 兼容统一结构化配置约束的索引签名。
+     */
+    [key: string]: JsonValue | undefined;
+    /**
+     * 语音合成 provider 类型。
+     *
+     * 说明（中文）
+     * - 当前固定为 `local`。
+     */
+    provider?: TtsProvider;
+    /**
+     * 当前激活的本地模型 ID。
+     */
+    modelId?: string;
+    /**
+     * 本地模型根目录（可选）。
+     */
+    modelsDir?: string;
+    /**
+     * Python 可执行文件（可选）。
+     */
+    pythonBin?: string;
+    /**
+     * 默认语言提示（可选）。
+     *
+     * 说明（中文）
+     * - `auto` / `zh` / `en` 等简短值即可。
+     */
+    language?: string;
+    /**
+     * 默认音色 ID（可选）。
+     *
+     * 说明（中文）
+     * - 主要给运行时做覆盖；Console 默认不要求手动填写。
+     */
+    voice?: string;
+    /**
+     * 默认输出格式。
+     */
+    format?: TtsAudioFormat;
+    /**
+     * 默认语速倍率。
+     */
+    speed?: number;
+    /**
+     * 输出目录。
+     *
+     * 说明（中文）
+     * - 可为相对项目根目录或绝对路径。
+     * - 为空时默认写到 `.downcity/.cache/tts/`。
+     */
+    outputDir?: string;
+    /**
+     * 单次合成超时时间（毫秒，可选）。
+     */
+    timeoutMs?: number;
+    /**
+     * 已安装模型列表（可选）。
+     *
+     * 说明（中文）
+     * - 仅作为状态快照使用，不应作为真实安装判断唯一依据。
+     */
+    installedModels?: string[];
+}
+/**
+ * TTS 安装输入。
+ */
+export interface TtsInstallInput {
+    /**
+     * 兼容统一结构化配置约束的索引签名。
+     */
+    [key: string]: JsonValue | undefined;
+    /**
+     * 需要安装的模型 ID 列表（可选）。
+     */
+    modelIds?: string[];
+    /**
+     * 安装完成后激活的模型 ID（可选）。
+     */
+    activeModel?: string;
+    /**
+     * 是否强制覆盖已存在资源。
+     */
+    force?: boolean;
+    /**
+     * 模型目录（可选）。
+     */
+    modelsDir?: string;
+    /**
+     * Python 可执行文件（可选）。
+     */
+    pythonBin?: string;
+    /**
+     * 是否同时安装 Python 依赖。
+     */
+    installDeps?: boolean;
+    /**
+     * HuggingFace Token（可选）。
+     */
+    hfToken?: string;
+    /**
+     * 安装完成后默认输出格式（可选）。
+     */
+    format?: TtsAudioFormat;
+}
+/**
+ * TTS 合成输入。
+ */
+export interface TtsSynthesizeInput {
+    /**
+     * 兼容统一结构化配置约束的索引签名。
+     */
+    [key: string]: JsonValue | undefined;
+    /**
+     * 需要合成的文本内容。
+     */
+    text?: string;
+    /**
+     * 覆盖当前使用的模型 ID。
+     */
+    modelId?: string;
+    /**
+     * 覆盖当前语言提示（可选）。
+     */
+    language?: string;
+    /**
+     * 覆盖当前音色（可选）。
+     */
+    voice?: string;
+    /**
+     * 覆盖当前输出格式。
+     */
+    format?: TtsAudioFormat;
+    /**
+     * 覆盖当前语速倍率。
+     */
+    speed?: number;
+    /**
+     * 覆盖当前输出路径或目录。
+     *
+     * 说明（中文）
+     * - 若传入带扩展名的路径，则直接写该文件。
+     * - 若传入目录，则按默认命名生成文件。
+     */
+    output?: string;
+}
+//# sourceMappingURL=TtsPlugin.d.ts.map

package/bin/tts/types/TtsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TtsPlugin.d.ts","sourceRoot":"","sources":["../../../src/tts/types/TtsPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/bin/tts/types/TtsPlugin.js

@@ -0,0 +1,9 @@
+/**
+ * TTS Plugin 类型定义。
+ *
+ * 关键点（中文）
+ * - TTS 的行为配置与本地模型依赖统一收敛到 `plugins.tts`。
+ * - Console 只需要理解 plugin setup，不需要理解底层 asset 细节。
+ */
+export {};
+//# sourceMappingURL=TtsPlugin.js.map

package/bin/tts/types/TtsPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TtsPlugin.js","sourceRoot":"","sources":["../../../src/tts/types/TtsPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}