@downcity/plugins 1.0.56 → 1.0.57

package/bin/tts/runtime/DependencyInstaller.d.ts

@@ -1,143 +0,0 @@
-/**
- * TTS 依赖安装器。
- *
- * 关键点（中文）
- * - 统一管理 `town tts` 的 Python 依赖安装逻辑。
- * - 根据模型自动推导 runner（qwen3 / kokoro）并执行 `python -m pip install`。
- */
-import type { TtsModelId, TtsRuntimeFamily } from "../../tts/types/Tts.js";
-/**
- * TTS 依赖 runner 类型。
- */
-export type TtsDependencyRunner = TtsRuntimeFamily;
-/**
- * 单个 runner 的安装摘要。
- */
-export interface TtsDependencyInstallItem {
-    /**
-     * 当前安装 runner。
-     */
-    runner: TtsDependencyRunner;
-    /**
-     * Python 可执行文件。
-     */
-    pythonBin: string;
-    /**
-     * 执行参数（不含 pythonBin）。
-     */
-    args: string[];
-    /**
-     * 安装包列表。
-     */
-    packages: string[];
-    /**
-     * 实际执行的命令行。
-     */
-    command: string;
-    /**
-     * 执行耗时（毫秒）。
-     */
-    elapsedMs: number;
-    /**
-     * 是否跳过安装。
-     */
-    skipped?: boolean;
-    /**
-     * 跳过原因（可选）。
-     */
-    skipReason?: string;
-    /**
-     * stdout 尾部（可选）。
-     */
-    stdoutTail?: string;
-    /**
-     * stderr 尾部（可选）。
-     */
-    stderrTail?: string;
-}
-/**
- * 依赖安装结果。
- */
-export interface TtsDependencyInstallResult {
-    /**
-     * 本次使用的 Python 可执行文件。
-     */
-    pythonBin: string;
-    /**
-     * 本次处理的 runner 列表。
-     */
-    runners: TtsDependencyRunner[];
-    /**
-     * 各 runner 的安装摘要。
-     */
-    items: TtsDependencyInstallItem[];
-    /**
-     * 是否使用了虚拟环境安装。
-     */
-    usedVirtualEnv: boolean;
-    /**
-     * 虚拟环境目录（仅 `usedVirtualEnv=true` 时存在）。
-     */
-    venvDir?: string;
-    /**
-     * 初始尝试使用的 Python（仅进入虚拟环境回退时存在）。
-     */
-    basePythonBin?: string;
-}
-/**
- * 依赖安装输入参数。
- */
-export interface TtsDependencyInstallInput {
-    /**
-     * Python 可执行文件（默认 `python3`）。
-     */
-    pythonBin?: string;
-    /**
-     * 需要安装的 runner 列表。
-     */
-    runners: TtsDependencyRunner[];
-    /**
-     * 是否使用 `pip -U` 升级。
-     */
-    upgrade?: boolean;
-    /**
-     * pip 安装超时（毫秒）。
-     */
-    timeoutMs?: number;
-    /**
-     * 虚拟环境目录（可选）。
-     */
-    venvDir?: string;
-}
-export declare function resolveTtsVenvPythonBin(venvDir: string): string;
-/**
- * 返回 TTS 默认虚拟环境目录。
- */
-export declare function resolveDefaultTtsVenvDir(): string;
-/**
- * 返回 TTS 默认虚拟环境 Python 路径。
- */
-export declare function resolveDefaultTtsVenvPythonBin(): string;
-/**
- * 判断是否为 PEP 668（externally-managed-environment）错误。
- */
-export declare function isPep668InstallError(text: string): boolean;
-export declare function ensureTtsVirtualEnv(params: {
-    /**
-     * 虚拟环境目录。
-     */
-    venvDir?: string;
-    /**
-     * 用于创建 venv 的基础 Python。
-     */
-    basePythonBin?: string;
-}): Promise<string>;
-/**
- * 安装 TTS Python 依赖。
- */
-export declare function installTtsDependencies(input: TtsDependencyInstallInput): Promise<TtsDependencyInstallResult>;
-/**
- * 根据模型列表推导需要安装的 runner 集合。
- */
-export declare function resolveTtsRunnersByModels(modelIds: TtsModelId[]): TtsDependencyRunner[];
-//# sourceMappingURL=DependencyInstaller.d.ts.map

package/bin/tts/runtime/DependencyInstaller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DependencyInstaller.d.ts","sourceRoot":"","sources":["../../../src/tts/runtime/DependencyInstaller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQvE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4BD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS1D;AA+ID,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalB;AAkCD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAgCrC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,mBAAmB,EAAE,CAUvF"}

package/bin/tts/runtime/DependencyInstaller.js

@@ -1,261 +0,0 @@
-/**
- * TTS 依赖安装器。
- *
- * 关键点（中文）
- * - 统一管理 `town tts` 的 Python 依赖安装逻辑。
- * - 根据模型自动推导 runner（qwen3 / kokoro）并执行 `python -m pip install`。
- */
-import { execFile as execFileCb } from "node:child_process";
-import os from "node:os";
-import path from "node:path";
-import { promisify } from "node:util";
-import fs from "fs-extra";
-const execFileAsync = promisify(execFileCb);
-const DEFAULT_PIP_TIMEOUT_MS = 300_000;
-const OUTPUT_TAIL_LIMIT = 1200;
-const DEFAULT_VENV_DIR = path.join(os.homedir(), ".downcity", "venvs", "tts");
-function normalizePythonBin(input) {
-    const text = String(input || "").trim();
-    return text || "python3";
-}
-function normalizeTimeoutMs(value) {
-    if (!Number.isFinite(value))
-        return DEFAULT_PIP_TIMEOUT_MS;
-    const ms = Math.floor(Number(value));
-    if (ms < 5_000)
-        return 5_000;
-    if (ms > 1_800_000)
-        return 1_800_000;
-    return ms;
-}
-function normalizeVenvDir(input) {
-    const text = String(input || "").trim();
-    if (!text)
-        return DEFAULT_VENV_DIR;
-    return path.resolve(text);
-}
-function tailText(value) {
-    const text = String(value || "").trim();
-    if (!text)
-        return undefined;
-    if (text.length <= OUTPUT_TAIL_LIMIT)
-        return text;
-    return text.slice(text.length - OUTPUT_TAIL_LIMIT);
-}
-export function resolveTtsVenvPythonBin(venvDir) {
-    return path.join(venvDir, "bin", "python");
-}
-/**
- * 返回 TTS 默认虚拟环境目录。
- */
-export function resolveDefaultTtsVenvDir() {
-    return DEFAULT_VENV_DIR;
-}
-/**
- * 返回 TTS 默认虚拟环境 Python 路径。
- */
-export function resolveDefaultTtsVenvPythonBin() {
-    return resolveTtsVenvPythonBin(DEFAULT_VENV_DIR);
-}
-/**
- * 判断是否为 PEP 668（externally-managed-environment）错误。
- */
-export function isPep668InstallError(text) {
-    const msg = String(text || "").toLowerCase();
-    if (!msg)
-        return false;
-    return (msg.includes("externally-managed-environment") ||
-        msg.includes("this environment is externally managed") ||
-        msg.includes("pep 668") ||
-        msg.includes("--break-system-packages"));
-}
-function dedupeRunners(runners) {
-    const seen = new Set();
-    const out = [];
-    for (const runner of runners) {
-        if (seen.has(runner))
-            continue;
-        seen.add(runner);
-        out.push(runner);
-    }
-    return out;
-}
-function getRunnerPackages(runner) {
-    if (runner === "qwen3") {
-        return ["qwen-tts", "soundfile", "torch", "torchaudio", "transformers", "accelerate"];
-    }
-    return ["kokoro==0.7.16", "soundfile", "misaki[zh]", "torch"];
-}
-async function checkRunnerPackagesInstalled(params) {
-    const args = ["-m", "pip", "show", ...params.packages.map((item) => item.replace(/\[.*\]$/, "").replace(/==.+$/, ""))];
-    const command = [params.pythonBin, ...args].join(" ");
-    try {
-        await execFileAsync(params.pythonBin, args, {
-            timeout: params.timeoutMs,
-            maxBuffer: 8 * 1024 * 1024,
-        });
-        return {
-            installed: true,
-            args,
-            command,
-        };
-    }
-    catch {
-        return {
-            installed: false,
-            args,
-            command,
-        };
-    }
-}
-async function installRunnerWithPython(params) {
-    const packages = getRunnerPackages(params.runner);
-    const checkStartedAt = Date.now();
-    const checkResult = await checkRunnerPackagesInstalled({
-        pythonBin: params.pythonBin,
-        packages,
-        timeoutMs: params.timeoutMs,
-    });
-    if (checkResult.installed) {
-        return {
-            success: true,
-            item: {
-                runner: params.runner,
-                pythonBin: params.pythonBin,
-                args: checkResult.args,
-                packages,
-                command: checkResult.command,
-                elapsedMs: Date.now() - checkStartedAt,
-                skipped: true,
-                skipReason: "already-installed",
-            },
-        };
-    }
-    const args = [
-        "-m",
-        "pip",
-        "install",
-        ...(params.upgrade ? ["-U"] : []),
-        ...packages,
-    ];
-    const command = [params.pythonBin, ...args].join(" ");
-    const startedAt = Date.now();
-    try {
-        const { stdout, stderr } = await execFileAsync(params.pythonBin, args, {
-            timeout: params.timeoutMs,
-            maxBuffer: 8 * 1024 * 1024,
-        });
-        return {
-            success: true,
-            item: {
-                runner: params.runner,
-                pythonBin: params.pythonBin,
-                args,
-                packages,
-                command,
-                elapsedMs: Date.now() - startedAt,
-                stdoutTail: tailText(String(stdout || "")),
-                stderrTail: tailText(String(stderr || "")),
-            },
-        };
-    }
-    catch (error) {
-        const errorLike = error;
-        const reason = tailText(String(errorLike.stderr || "")) ||
-            tailText(String(errorLike.stdout || "")) ||
-            String(errorLike.message || error);
-        return {
-            success: false,
-            failure: {
-                runner: params.runner,
-                command,
-                reason,
-            },
-        };
-    }
-}
-export async function ensureTtsVirtualEnv(params) {
-    const venvDir = normalizeVenvDir(params.venvDir);
-    const basePythonBin = normalizePythonBin(params.basePythonBin);
-    const pythonBin = resolveTtsVenvPythonBin(venvDir);
-    if (await fs.pathExists(pythonBin)) {
-        return pythonBin;
-    }
-    await fs.ensureDir(venvDir);
-    await execFileAsync(basePythonBin, ["-m", "venv", venvDir], {
-        timeout: DEFAULT_PIP_TIMEOUT_MS,
-        maxBuffer: 8 * 1024 * 1024,
-    });
-    return pythonBin;
-}
-async function installAllRunners(params) {
-    const items = [];
-    const failures = [];
-    for (const runner of params.runners) {
-        const result = await installRunnerWithPython({
-            pythonBin: params.pythonBin,
-            runner,
-            upgrade: params.upgrade,
-            timeoutMs: params.timeoutMs,
-        });
-        if (result.success) {
-            items.push(result.item);
-        }
-        else {
-            failures.push(result.failure);
-        }
-    }
-    return {
-        success: failures.length === 0,
-        items,
-        failures,
-    };
-}
-/**
- * 安装 TTS Python 依赖。
- */
-export async function installTtsDependencies(input) {
-    const runners = dedupeRunners(input.runners);
-    const basePythonBin = normalizePythonBin(input.pythonBin);
-    const timeoutMs = normalizeTimeoutMs(input.timeoutMs);
-    const upgrade = input.upgrade === true;
-    const venvDir = normalizeVenvDir(input.venvDir);
-    const venvPythonBin = await ensureTtsVirtualEnv({
-        venvDir,
-        basePythonBin,
-    });
-    const venvAttempt = await installAllRunners({
-        pythonBin: venvPythonBin,
-        runners,
-        upgrade,
-        timeoutMs,
-    });
-    if (!venvAttempt.success) {
-        throw new Error(venvAttempt.failures
-            .map((item) => `${item.runner}: ${item.reason}`)
-            .join("\n"));
-    }
-    return {
-        pythonBin: venvPythonBin,
-        runners,
-        items: venvAttempt.items,
-        usedVirtualEnv: true,
-        venvDir,
-        basePythonBin,
-    };
-}
-/**
- * 根据模型列表推导需要安装的 runner 集合。
- */
-export function resolveTtsRunnersByModels(modelIds) {
-    const runners = new Set();
-    for (const modelId of modelIds) {
-        if (modelId === "qwen3-tts-0.6b") {
-            runners.add("qwen3");
-            continue;
-        }
-        runners.add("kokoro");
-    }
-    return [...runners];
-}
-//# sourceMappingURL=DependencyInstaller.js.map

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

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

package/bin/tts/runtime/Installer.d.ts

@@ -1,89 +0,0 @@
-/**
- * TTS 模型安装器。
- *
- * 关键点（中文）
- * - 统一把 HuggingFace 资源下载到本地模型目录。
- * - 支持“整仓下载”与“仅下载指定文件”两种模式。
- */
-import type { TtsModelCatalogItem, TtsModelId } from "../../tts/types/Tts.js";
-/**
- * TTS 模型安装结果。
- */
-export interface TtsModelInstallResult {
-    /**
-     * 模型目录（绝对路径）。
-     */
-    modelDir: string;
-    /**
-     * 本次下载文件数。
-     */
-    downloadedFiles: number;
-    /**
-     * 本次跳过文件数（已存在且未强制覆盖）。
-     */
-    skippedFiles: number;
-    /**
-     * 本次实际下载的文件路径（相对模型目录）。
-     */
-    downloadedFilePaths: string[];
-    /**
-     * 本次跳过的文件路径（相对模型目录）。
-     */
-    skippedFilePaths: string[];
-}
-/**
- * 判断模型在本地是否已安装。
- *
- * 关键点（中文）
- * - 优先识别安装清单 `downcity.tts.install.json`。
- * - 若无清单但目录非空，也视为已存在模型，避免重复下载。
- */
-export declare function detectLocalTtsModelInstallState(input: {
-    /**
-     * 模型 ID。
-     */
-    modelId: TtsModelId;
-    /**
-     * TTS 模型根目录。
-     */
-    modelsRootDir: string;
-}): Promise<{
-    /**
-     * 模型目录（绝对路径）。
-     */
-    modelDir: string;
-    /**
-     * 是否判断为“已安装”。
-     */
-    installed: boolean;
-    /**
-     * 已安装来源。
-     */
-    source?: "manifest" | "directory";
-}>;
-/**
- * 安装指定 TTS 模型到本地目录。
- *
- * 关键点（中文）
- * - 使用 HTTP 文件级下载，不依赖 git-lfs。
- * - 默认复用已有文件；`force=true` 时覆盖重下。
- */
-export declare function installTtsModelFromHuggingFace(input: {
-    /**
-     * 目标模型目录项。
-     */
-    model: TtsModelCatalogItem;
-    /**
-     * TTS 模型根目录。
-     */
-    modelsRootDir: string;
-    /**
-     * 是否强制覆盖。
-     */
-    force?: boolean;
-    /**
-     * HuggingFace Token（可选）。
-     */
-    hfToken?: string;
-}): Promise<TtsModelInstallResult>;
-//# sourceMappingURL=Installer.d.ts.map

package/bin/tts/runtime/Installer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Installer.d.ts","sourceRoot":"","sources":["../../../src/tts/runtime/Installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAW1E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;OAEG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA8FD;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC;IACV;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACnC,CAAC,CAoCD;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+DjC"}