@downcity/plugins 1.0.4

package/bin/task/types/TaskCommand.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Task 命令协议类型。
+ *
+ * 关键点（中文）
+ * - task 模块相关 DTO 就近放在 task/types
+ * - 统一给 CLI / Server / service 复用
+ */
+import type { ShipTaskKind, ShipTaskRunExecutionStatusV1, ShipTaskRunResultStatusV1, ShipTaskRunStatusV1, ShipTaskStatus } from "./Task.js";
+export type TaskCreateRequest = {
+    /** 任务名称。 */
+    title: string;
+    /** 触发条件。 */
+    when: string;
+    /** 任务描述。 */
+    description: string;
+    /** 任务会话标识。 */
+    sessionId: string;
+    /** 任务执行类型。 */
+    kind?: ShipTaskKind;
+    /** 是否启用 review 多轮复核。 */
+    review?: boolean;
+    /** 任务状态。 */
+    status?: ShipTaskStatus;
+    /** 任务正文。 */
+    body?: string;
+    /** 是否覆盖已有定义。 */
+    overwrite?: boolean;
+};
+export type TaskCreateResponse = {
+    /** 调用是否成功 */
+    success: boolean;
+    /** 任务名称（新建成功或复用已有任务时返回） */
+    title?: string;
+    /** 任务定义文件相对路径 */
+    taskMdPath?: string;
+    /** 是否复用了已有任务（true 表示未新建） */
+    reusedExisting?: boolean;
+    /** 说明信息（例如“复用已有任务”） */
+    message?: string;
+    /** 错误信息 */
+    error?: string;
+};
+export type TaskUpdateRequest = {
+    /** 当前任务名称。 */
+    title: string;
+    /** 新任务名称。 */
+    titleNext?: string;
+    /** 新触发条件。 */
+    when?: string;
+    /** 是否清空触发条件并回退到 `@manual`。 */
+    clearWhen?: boolean;
+    /** 新任务描述。 */
+    description?: string;
+    /** 新会话标识。 */
+    sessionId?: string;
+    /** 新任务执行类型。 */
+    kind?: ShipTaskKind;
+    /** 是否启用 review 多轮复核。 */
+    review?: boolean;
+    /** 新任务状态。 */
+    status?: ShipTaskStatus;
+    /** 新任务正文。 */
+    body?: string;
+    /** 是否清空正文。 */
+    clearBody?: boolean;
+};
+export type TaskUpdateResponse = {
+    success: boolean;
+    title?: string;
+    taskMdPath?: string;
+    error?: string;
+};
+export type TaskListItemView = {
+    /** 任务名称。 */
+    title: string;
+    /** 任务描述。 */
+    description: string;
+    /** 任务正文。 */
+    body?: string;
+    /** 触发条件。 */
+    when: string;
+    /** 任务状态。 */
+    status: string;
+    /** 当前是否正在执行。 */
+    running?: boolean;
+    /** 任务会话标识。 */
+    sessionId: string;
+    /** 任务执行类型。 */
+    kind?: ShipTaskKind;
+    /** 是否启用 review 多轮复核。 */
+    review?: boolean;
+    /** 任务定义文件相对路径。 */
+    taskMdPath: string;
+    /** 最近一次运行时间戳。 */
+    lastRunTimestamp?: string;
+};
+export type TaskListResponse = {
+    success: true;
+    tasks: TaskListItemView[];
+};
+export type TaskRunRequest = {
+    title: string;
+    reason?: string;
+};
+export type TaskRunResponse = {
+    success: boolean;
+    /** 是否已受理后台执行（true 表示任务已开始异步执行） */
+    accepted?: boolean;
+    /** 给调用方的简短提示（例如“任务已开始，完成后 task 会自动发送给用户，请直接继续后续流程，无需等待完成”） */
+    message?: string;
+    /** 本次执行 ID（可用于 UI 关联执行状态） */
+    executionId?: string;
+    status?: ShipTaskRunStatusV1;
+    executionStatus?: ShipTaskRunExecutionStatusV1;
+    resultStatus?: ShipTaskRunResultStatusV1;
+    resultErrors?: string[];
+    dialogueRounds?: number;
+    userSimulatorSatisfied?: boolean;
+    userSimulatorReply?: string;
+    userSimulatorReason?: string;
+    userSimulatorScore?: number;
+    title?: string;
+    timestamp?: string;
+    runDir?: string;
+    runDirRel?: string;
+    error?: string;
+};
+export type TaskSetStatusRequest = {
+    title: string;
+    status: ShipTaskStatus;
+};
+export type TaskSetStatusResponse = {
+    success: boolean;
+    title?: string;
+    status?: ShipTaskStatus;
+    error?: string;
+};
+export type TaskDeleteRequest = {
+    title: string;
+};
+export type TaskDeleteResponse = {
+    success: boolean;
+    title?: string;
+    taskDirPath?: string;
+    error?: string;
+};
+//# sourceMappingURL=TaskCommand.d.ts.map

package/bin/task/types/TaskCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskCommand.d.ts","sourceRoot":"","sources":["../../../src/task/types/TaskCommand.ts"],"names":[],"mappings":"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"}

package/bin/task/types/TaskCommand.js

@@ -0,0 +1,9 @@
+/**
+ * Task 命令协议类型。
+ *
+ * 关键点（中文）
+ * - task 模块相关 DTO 就近放在 task/types
+ * - 统一给 CLI / Server / service 复用
+ */
+export {};
+//# sourceMappingURL=TaskCommand.js.map

package/bin/task/types/TaskCommand.js.map

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

package/bin/task/types/TaskPluginTypes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Task plugin runtime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 task plugin runtime 在类化拆分后共享的 action payload 与调度结果类型。
+ * - 跨模块复用的 task plugin runtime 类型统一收敛在 `plugins/task/types/`。
+ */
+import type { ShipTaskStatus } from "../../task/types/Task.js";
+/**
+ * `task.list` action 的输入载荷。
+ */
+export type TaskListActionPayload = {
+    /**
+     * 按任务状态过滤；省略时返回全部状态。
+     */
+    status?: ShipTaskStatus;
+};
+/**
+ * task cron runtime 启动或重载后的统计结果。
+ */
+export type TaskCronRegisterResult = {
+    /**
+     * 本次扫描到的任务定义数量。
+     */
+    tasksFound: number;
+    /**
+     * 本次成功注册到 cron engine 的作业数量。
+     */
+    jobsScheduled: number;
+};
+/**
+ * 任务定义变更后 scheduler 重载结果。
+ */
+export type TaskSchedulerReloadResult = {
+    /**
+     * scheduler 是否成功完成重载。
+     */
+    reloaded: boolean;
+    /**
+     * 成功重载时扫描到的任务数量。
+     */
+    tasksFound?: number;
+    /**
+     * 成功重载时注册成功的 cron 作业数量。
+     */
+    jobsScheduled?: number;
+    /**
+     * 重载失败时的错误文本。
+     */
+    error?: string;
+};
+//# sourceMappingURL=TaskPluginTypes.d.ts.map

package/bin/task/types/TaskPluginTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskPluginTypes.d.ts","sourceRoot":"","sources":["../../../src/task/types/TaskPluginTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/bin/task/types/TaskPluginTypes.js

@@ -0,0 +1,9 @@
+/**
+ * Task plugin runtime 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里集中声明 task plugin runtime 在类化拆分后共享的 action payload 与调度结果类型。
+ * - 跨模块复用的 task plugin runtime 类型统一收敛在 `plugins/task/types/`。
+ */
+export {};
+//# sourceMappingURL=TaskPluginTypes.js.map

package/bin/task/types/TaskPluginTypes.js.map

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

package/bin/tts/Dependency.d.ts

@@ -0,0 +1,90 @@
+/**
+ * TTS Plugin Dependency Helper。
+ *
+ * 关键点（中文）
+ * - TTS 的模型安装、配置读写与可用性检查都内聚在 plugin 内部。
+ * - Console 只调用 plugin action，不直接理解底层资源结构。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { PluginCommandContext } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { TtsInstallInput, TtsPluginConfig } from "../tts/types/TtsPlugin.js";
+export interface TtsDependencyCheckResult {
+    /**
+     * 当前依赖是否可用。
+     */
+    available: boolean;
+    /**
+     * 不可用原因列表。
+     */
+    reasons: string[];
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+export interface TtsDependencyInstallResult {
+    /**
+     * 安装是否成功。
+     */
+    success: boolean;
+    /**
+     * 人类可读消息（可选）。
+     */
+    message?: string;
+    /**
+     * 结构化附加数据（可选）。
+     */
+    details?: JsonValue;
+}
+/**
+ * 读取 TTS Plugin 配置。
+ */
+export declare function readTtsPluginConfig(context: PluginCommandContext): TtsPluginConfig;
+/**
+ * 写入完整 TTS plugin 配置。
+ */
+export declare function writeTtsPluginConfig(params: {
+    /**
+     * 当前执行上下文。
+     */
+    context: PluginCommandContext;
+    /**
+     * 目标配置值。
+     */
+    value: TtsPluginConfig;
+}): Promise<TtsPluginConfig>;
+/**
+ * 检查 TTS 依赖可用性。
+ */
+export declare function checkTtsSynthesizer(context: PluginCommandContext): Promise<TtsDependencyCheckResult>;
+/**
+ * 安装或修复 TTS 依赖。
+ */
+export declare function installTtsSynthesizer(params: {
+    /**
+     * 当前执行上下文。
+     */
+    context: PluginCommandContext;
+    /**
+     * 安装输入（可选）。
+     */
+    input?: TtsInstallInput;
+}): Promise<TtsDependencyInstallResult>;
+/**
+ * 列出可用于 TTS 的内置模型选项。
+ */
+export declare function listTtsModelOptions(): Array<{
+    /**
+     * 选项标签。
+     */
+    label: string;
+    /**
+     * 选项值。
+     */
+    value: string;
+    /**
+     * 选项说明。
+     */
+    hint: string;
+}>;
+//# sourceMappingURL=Dependency.d.ts.map

package/bin/tts/Dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../src/tts/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAChB,MAAM,0BAA0B,CAAC;AA4BlC,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAkFD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAsBlF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD;;OAEG;IACH,OAAO,EAAE,oBAAoB,CAAC;IAC9B;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC;CACxB,GAAG,OAAO,CAAC,eAAe,CAAC,CAW3B;AAqBD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAmEnC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD;;OAEG;IACH,OAAO,EAAE,oBAAoB,CAAC;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA0ItC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAC3C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAMD"}

package/bin/tts/Dependency.js

@@ -0,0 +1,344 @@
+/**
+ * TTS Plugin Dependency Helper。
+ *
+ * 关键点（中文）
+ * - TTS 的模型安装、配置读写与可用性检查都内聚在 plugin 内部。
+ * - Console 只调用 plugin action，不直接理解底层资源结构。
+ */
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+import { getTtsModelCatalogItem, resolveTtsModelId, TTS_MODEL_CATALOG, } from "../tts/runtime/Catalog.js";
+import { detectLocalTtsModelInstallState, installTtsModelFromHuggingFace, } from "../tts/runtime/Installer.js";
+import { ensureTtsVirtualEnv, installTtsDependencies, resolveDefaultTtsVenvPythonBin, resolveTtsRunnersByModels, } from "../tts/runtime/DependencyInstaller.js";
+import { resolveTtsModelsRootDir } from "../tts/runtime/Paths.js";
+const execFileAsync = promisify(execFileCb);
+function readTtsPluginRecord(context) {
+    const current = context.config.plugins?.tts;
+    if (!current || typeof current !== "object" || Array.isArray(current)) {
+        return {};
+    }
+    return current;
+}
+function toJsonObject(input) {
+    const out = {};
+    if (!input)
+        return out;
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined)
+            continue;
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            out[key] = value;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            out[key] = value
+                .filter((item) => item !== undefined)
+                .map((item) => item);
+            continue;
+        }
+        if (typeof value === "object") {
+            out[key] = toJsonObject(value);
+        }
+    }
+    return out;
+}
+function normalizeFormat(value) {
+    return String(value || "").trim().toLowerCase() === "flac" ? "flac" : "wav";
+}
+function normalizeTtsPythonBin(value) {
+    const text = String(value || "").trim();
+    if (!text || text === "python3") {
+        return resolveDefaultTtsVenvPythonBin();
+    }
+    return text;
+}
+async function readPythonVersionInfo(pythonBin) {
+    try {
+        const { stdout, stderr } = await execFileAsync(pythonBin, ["--version"], {
+            timeout: 15_000,
+            maxBuffer: 1024 * 1024,
+        });
+        const text = String(stdout || stderr || "").trim();
+        const match = text.match(/Python\s+(\d+)\.(\d+)\.(\d+)/i);
+        if (!match)
+            return null;
+        return {
+            major: Number(match[1]),
+            minor: Number(match[2]),
+            patch: Number(match[3]),
+            raw: text,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function getTtsPythonCompatibilityReason(params) {
+    if (!params.version)
+        return null;
+    if (params.modelId === "kokoro-82m") {
+        if (params.version.major > 3 || (params.version.major === 3 && params.version.minor >= 13)) {
+            return `kokoro-82m currently requires Python < 3.13, current is ${params.version.major}.${params.version.minor}.${params.version.patch}`;
+        }
+    }
+    return null;
+}
+/**
+ * 读取 TTS Plugin 配置。
+ */
+export function readTtsPluginConfig(context) {
+    const { enabled: _ignoredEnabled, ...current } = readTtsPluginRecord(context);
+    return {
+        provider: "local",
+        ...(typeof current.modelId === "string" ? { modelId: current.modelId } : {}),
+        ...(typeof current.modelsDir === "string" ? { modelsDir: current.modelsDir } : {}),
+        pythonBin: normalizeTtsPythonBin(current.pythonBin),
+        ...(typeof current.language === "string" ? { language: current.language } : {}),
+        ...(typeof current.voice === "string" ? { voice: current.voice } : {}),
+        ...(typeof current.outputDir === "string" ? { outputDir: current.outputDir } : {}),
+        ...(typeof current.timeoutMs === "number" ? { timeoutMs: current.timeoutMs } : {}),
+        ...(typeof current.speed === "number" ? { speed: current.speed } : {}),
+        format: normalizeFormat(current.format),
+        ...(Array.isArray(current.installedModels)
+            ? { installedModels: current.installedModels }
+            : {}),
+    };
+}
+/**
+ * 写入完整 TTS plugin 配置。
+ */
+export async function writeTtsPluginConfig(params) {
+    if (!params.context.config.plugins) {
+        params.context.config.plugins = {};
+    }
+    const next = {
+        ...params.value,
+    };
+    delete next.enabled;
+    params.context.config.plugins.tts = toJsonObject(next);
+    await params.context.pluginConfig.persistProjectPlugins(params.context.config.plugins);
+    return params.context.config.plugins.tts;
+}
+async function checkPythonPackageImports(params) {
+    const importScript = params.modelId === "qwen3-tts-0.6b"
+        ? "import qwen_tts, soundfile"
+        : "import kokoro, soundfile";
+    try {
+        await execFileAsync(params.pythonBin, ["-c", importScript], {
+            timeout: 30_000,
+            maxBuffer: 1024 * 1024,
+        });
+        return null;
+    }
+    catch (error) {
+        return `python packages missing: ${String(error)}`;
+    }
+}
+/**
+ * 检查 TTS 依赖可用性。
+ */
+export async function checkTtsSynthesizer(context) {
+    const config = readTtsPluginConfig(context);
+    const reasons = [];
+    const modelId = resolveTtsModelId(String(config.modelId || ""));
+    if (!modelId) {
+        reasons.push("tts modelId is missing");
+        return {
+            available: false,
+            reasons,
+        };
+    }
+    const modelsRootDir = resolveTtsModelsRootDir({
+        projectRoot: context.rootPath,
+        modelsDir: config.modelsDir,
+    });
+    const installState = await detectLocalTtsModelInstallState({
+        modelId,
+        modelsRootDir,
+    });
+    if (!installState.installed) {
+        reasons.push(`tts model is not installed: ${modelId}`);
+    }
+    const pythonBin = normalizeTtsPythonBin(config.pythonBin);
+    const pythonVersion = await readPythonVersionInfo(pythonBin);
+    if (!pythonVersion) {
+        reasons.push(`python runtime missing: ${pythonBin}`);
+        return {
+            available: false,
+            reasons,
+        };
+    }
+    const compatibilityReason = getTtsPythonCompatibilityReason({
+        modelId,
+        version: pythonVersion,
+    });
+    if (compatibilityReason) {
+        reasons.push(compatibilityReason);
+        return {
+            available: false,
+            reasons,
+            details: {
+                modelDir: installState.modelDir,
+                source: installState.source || null,
+                pythonVersion: pythonVersion.raw,
+            },
+        };
+    }
+    const importError = await checkPythonPackageImports({
+        pythonBin,
+        modelId,
+    });
+    if (importError) {
+        reasons.push(importError);
+    }
+    return {
+        available: reasons.length === 0,
+        reasons,
+        details: {
+            modelDir: installState.modelDir,
+            source: installState.source || null,
+        },
+    };
+}
+/**
+ * 安装或修复 TTS 依赖。
+ */
+export async function installTtsSynthesizer(params) {
+    const context = params.context;
+    const input = params.input;
+    const config = readTtsPluginConfig(context);
+    const logs = [];
+    const requestedModelIds = (Array.isArray(input?.modelIds) ? input.modelIds : [])
+        .map((item) => resolveTtsModelId(String(item || "").trim()))
+        .filter((item) => Boolean(item));
+    const selectedModelIds = requestedModelIds.length > 0
+        ? requestedModelIds
+        : [resolveTtsModelId(String(config.modelId || "qwen3-tts-0.6b")) || "qwen3-tts-0.6b"];
+    const modelsRootDir = resolveTtsModelsRootDir({
+        projectRoot: context.rootPath,
+        modelsDir: input?.modelsDir || config.modelsDir,
+    });
+    logs.push(`models dir: ${modelsRootDir}`);
+    const installResults = [];
+    for (const modelId of selectedModelIds) {
+        logs.push(`prepare model: ${modelId}`);
+        const model = getTtsModelCatalogItem(modelId);
+        if (!model) {
+            throw new Error(`Unsupported tts model: ${modelId}`);
+        }
+        const installState = await detectLocalTtsModelInstallState({
+            modelId,
+            modelsRootDir,
+        });
+        if (!installState.installed || input?.force === true) {
+            logs.push(installState.installed && input?.force === true
+                ? `redownload model: ${modelId}`
+                : `download model: ${modelId}`);
+            const result = await installTtsModelFromHuggingFace({
+                model,
+                modelsRootDir,
+                force: input?.force === true,
+                hfToken: input?.hfToken,
+            });
+            logs.push(`model ready: ${modelId} (downloaded ${result.downloadedFiles}, skipped ${result.skippedFiles})`);
+            installResults.push(toJsonObject({
+                modelId,
+                downloadedFiles: result.downloadedFiles,
+                skippedFiles: result.skippedFiles,
+            }));
+            continue;
+        }
+        logs.push(`reuse installed model: ${modelId}`);
+        installResults.push(toJsonObject({
+            modelId,
+            downloadedFiles: 0,
+            skippedFiles: 0,
+            reused: true,
+        }));
+    }
+    const basePythonBin = String(input?.pythonBin || "").trim() || "python3";
+    const basePythonVersion = await readPythonVersionInfo(basePythonBin);
+    let resolvedPythonBin = normalizeTtsPythonBin(config.pythonBin);
+    let dependencyDetails;
+    const compatibilityFailures = selectedModelIds
+        .map((modelId) => getTtsPythonCompatibilityReason({
+        modelId,
+        version: basePythonVersion,
+    }))
+        .filter((item) => Boolean(item));
+    if (compatibilityFailures.length > 0) {
+        logs.push(...compatibilityFailures);
+        return {
+            success: false,
+            message: compatibilityFailures.join(" · "),
+            details: {
+                pythonVersion: basePythonVersion?.raw || basePythonBin,
+                logs,
+            },
+        };
+    }
+    if (input?.installDeps !== false) {
+        logs.push(`prepare python env from: ${basePythonBin}`);
+        const dependencyResult = await installTtsDependencies({
+            pythonBin: basePythonBin,
+            runners: resolveTtsRunnersByModels(selectedModelIds),
+        });
+        resolvedPythonBin = dependencyResult.pythonBin;
+        logs.push(`python env ready: ${dependencyResult.pythonBin}`);
+        for (const item of dependencyResult.items) {
+            logs.push(item.skipped
+                ? `dependency ${item.runner}: already installed`
+                : `dependency ${item.runner}: installed`);
+        }
+        dependencyDetails = toJsonObject({
+            pythonBin: dependencyResult.pythonBin,
+            runners: dependencyResult.runners,
+            usedVirtualEnv: dependencyResult.usedVirtualEnv,
+            venvDir: dependencyResult.venvDir,
+        });
+    }
+    else {
+        logs.push(`prepare python env only: ${basePythonBin}`);
+        resolvedPythonBin = await ensureTtsVirtualEnv({
+            basePythonBin,
+        });
+        logs.push(`python env ready: ${resolvedPythonBin}`);
+    }
+    const activeModelId = resolveTtsModelId(String(input?.activeModel || "")) || selectedModelIds[0];
+    const nextConfig = await writeTtsPluginConfig({
+        context,
+        value: {
+            ...config,
+            provider: "local",
+            modelId: activeModelId,
+            modelsDir: modelsRootDir,
+            pythonBin: resolvedPythonBin,
+            format: normalizeFormat(input?.format || config.format),
+            installedModels: selectedModelIds,
+        },
+    });
+    return {
+        success: true,
+        message: "tts synthesizer installed",
+        details: {
+            plugin: toJsonObject(nextConfig),
+            models: installResults,
+            dependency: dependencyDetails || null,
+            logs,
+        },
+    };
+}
+/**
+ * 列出可用于 TTS 的内置模型选项。
+ */
+export function listTtsModelOptions() {
+    return TTS_MODEL_CATALOG.map((item) => ({
+        label: item.label,
+        value: item.id,
+        hint: item.description,
+    }));
+}
+//# sourceMappingURL=Dependency.js.map