@downcity/plugins 1.0.56 → 1.0.57

package/bin/voice/InboundAugment.js

@@ -1,47 +0,0 @@
-/**
- * Voice 入站消息增强 hook。
- *
- * 关键点（中文）
- * - 只处理 voice/audio 附件，转写结果作为 plugin section 注入。
- * - 转写失败不阻塞主链路，保持 best-effort。
- */
-import { transcribeWithVoiceDependency } from "../voice/Dependency.js";
-/**
- * 自动转写入站语音附件。
- */
-export async function augmentVoiceInboundMessage(params) {
-    const input = params.value;
-    const voiceAttachments = (Array.isArray(input.attachments) ? input.attachments : []).filter((item) => (item.kind === "voice" || item.kind === "audio") &&
-        typeof item.path === "string" &&
-        item.path.trim());
-    if (voiceAttachments.length === 0) {
-        return input;
-    }
-    const pluginSections = Array.isArray(input.pluginSections)
-        ? [...input.pluginSections]
-        : [];
-    for (const attachment of voiceAttachments) {
-        try {
-            const result = await transcribeWithVoiceDependency({
-                context: params.context,
-                audioPath: String(attachment.path || "").trim(),
-            });
-            const text = typeof result.text === "string" ? result.text.trim() : "";
-            if (!text)
-                continue;
-            const absPath = String(attachment.path || "").trim();
-            const rel = absPath.startsWith(`${params.context.rootPath}/`)
-                ? absPath.slice(params.context.rootPath.length + 1)
-                : absPath;
-            pluginSections.push(`【语音转写 ${attachment.kind}: ${rel}】\n${text}`);
-        }
-        catch {
-            // 关键点（中文）：转写失败不阻塞主链路，保持 best-effort。
-        }
-    }
-    return {
-        ...input,
-        pluginSections,
-    };
-}
-//# sourceMappingURL=InboundAugment.js.map

package/bin/voice/InboundAugment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"InboundAugment.js","sourceRoot":"","sources":["../../src/voice/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAGhD;IACC,MAAM,KAAK,GAAG,MAAM,CAAC,KAA2C,CAAC;IACjE,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CACzF,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CACnB,CAAC;IACF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,KAA6B,CAAC;IACvC,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;QACxD,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;QAC3B,CAAC,CAAC,EAAE,CAAC;IAEP,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;gBACjD,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;aAChD,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC;gBAC3D,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnD,CAAC,CAAC,OAAO,CAAC;YACZ,cAAc,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,KAAK;QACR,cAAc;KACS,CAAC;AAC5B,CAAC"}

package/bin/voice/ModelCatalog.d.ts

@@ -1,29 +0,0 @@
-/**
- * Voice 插件模型目录封装。
- *
- * 关键点（中文）
- * - 对 plugin 层暴露稳定的 voice 领域接口。
- * - plugin 不直接依赖底层 runtime 文件布局，只依赖这里的领域封装。
- */
-/**
- * 列出内置 voice 模型目录。
- */
-export declare function listVoiceModels(): Array<{
-    /**
-     * 稳定模型 ID。
-     */
-    id: string;
-    /**
-     * 用户可读标签。
-     */
-    label: string;
-    /**
-     * 用户可读说明。
-     */
-    description: string;
-}>;
-/**
- * 解析用户输入的 voice 模型 ID。
- */
-export declare function resolveVoicePluginModelId(input: string): string | null;
-//# sourceMappingURL=ModelCatalog.d.ts.map

package/bin/voice/ModelCatalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ModelCatalog.d.ts","sourceRoot":"","sources":["../../src/voice/ModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE"}

package/bin/voice/ModelCatalog.js

@@ -1,25 +0,0 @@
-/**
- * Voice 插件模型目录封装。
- *
- * 关键点（中文）
- * - 对 plugin 层暴露稳定的 voice 领域接口。
- * - plugin 不直接依赖底层 runtime 文件布局，只依赖这里的领域封装。
- */
-import { VOICE_MODEL_CATALOG, resolveVoiceModelId, } from "../voice/runtime/Catalog.js";
-/**
- * 列出内置 voice 模型目录。
- */
-export function listVoiceModels() {
-    return VOICE_MODEL_CATALOG.map((item) => ({
-        id: item.id,
-        label: item.label,
-        description: item.description,
-    }));
-}
-/**
- * 解析用户输入的 voice 模型 ID。
- */
-export function resolveVoicePluginModelId(input) {
-    return resolveVoiceModelId(input);
-}
-//# sourceMappingURL=ModelCatalog.js.map

package/bin/voice/ModelCatalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ModelCatalog.js","sourceRoot":"","sources":["../../src/voice/ModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,eAAe;IAc7B,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/bin/voice/runtime/Catalog.d.ts

@@ -1,18 +0,0 @@
-import type { VoiceModelCatalogItem, VoiceModelId } from "../../voice/types/Voice.js";
-/**
- * Voice 内置模型目录。
- *
- * 关键点（中文）
- * - 统一维护 CLI 展示、下载源与配置落盘 ID。
- * - 只保留“稳定字段”，避免目录频繁变动影响外部调用。
- */
-export declare const VOICE_MODEL_CATALOG: readonly VoiceModelCatalogItem[];
-/**
- * 解析用户输入为稳定模型 ID（支持别名与大小写）。
- */
-export declare function resolveVoiceModelId(input: string): VoiceModelId | null;
-/**
- * 读取目录项；不存在返回 null。
- */
-export declare function getVoiceModelCatalogItem(id: VoiceModelId): VoiceModelCatalogItem | null;
-//# sourceMappingURL=Catalog.d.ts.map

package/bin/voice/runtime/Catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../../src/voice/runtime/Catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAsBtD,CAAC;AAoBX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,qBAAqB,GAAG,IAAI,CAEvF"}

package/bin/voice/runtime/Catalog.js

@@ -1,61 +0,0 @@
-/**
- * Voice 内置模型目录。
- *
- * 关键点（中文）
- * - 统一维护 CLI 展示、下载源与配置落盘 ID。
- * - 只保留“稳定字段”，避免目录频繁变动影响外部调用。
- */
-export const VOICE_MODEL_CATALOG = [
-    {
-        id: "SenseVoiceSmall",
-        label: "SenseVoiceSmall",
-        description: "中文优先，体积较小，推荐默认选择。",
-        huggingfaceRepo: "FunAudioLLM/SenseVoiceSmall",
-        revision: "main",
-    },
-    {
-        id: "paraformer-zh-streaming",
-        label: "paraformer-zh-streaming",
-        description: "中文流式场景友好，低延迟。",
-        huggingfaceRepo: "funasr/paraformer-zh-streaming",
-        revision: "main",
-    },
-    {
-        id: "whisper-large-v3-turbo",
-        label: "whisper-large-v3-turbo",
-        description: "多语言能力稳定，泛化较强。",
-        huggingfaceRepo: "openai/whisper-large-v3-turbo",
-        revision: "main",
-    },
-];
-const VOICE_MODEL_ALIAS_MAP = {
-    sensevoicesmall: "SenseVoiceSmall",
-    "sensevoice-small": "SenseVoiceSmall",
-    "paraformer-zh-streaming": "paraformer-zh-streaming",
-    paraformer_zh_streaming: "paraformer-zh-streaming",
-    "whisper-large-v3-turbo": "whisper-large-v3-turbo",
-    whisper_large_v3_turbo: "whisper-large-v3-turbo",
-};
-const CATALOG_BY_ID = VOICE_MODEL_CATALOG.reduce((acc, item) => {
-    acc[item.id] = item;
-    return acc;
-}, {});
-/**
- * 解析用户输入为稳定模型 ID（支持别名与大小写）。
- */
-export function resolveVoiceModelId(input) {
-    const raw = String(input || "").trim();
-    if (!raw)
-        return null;
-    const exact = VOICE_MODEL_CATALOG.find((item) => item.id === raw);
-    if (exact)
-        return exact.id;
-    return VOICE_MODEL_ALIAS_MAP[raw.toLowerCase()] || null;
-}
-/**
- * 读取目录项；不存在返回 null。
- */
-export function getVoiceModelCatalogItem(id) {
-    return CATALOG_BY_ID[id] || null;
-}
-//# sourceMappingURL=Catalog.js.map

package/bin/voice/runtime/Catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Catalog.js","sourceRoot":"","sources":["../../../src/voice/runtime/Catalog.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,mBAAmB;QAChC,eAAe,EAAE,6BAA6B;QAC9C,QAAQ,EAAE,MAAM;KACjB;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,eAAe;QAC5B,eAAe,EAAE,gCAAgC;QACjD,QAAQ,EAAE,MAAM;KACjB;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,eAAe;QAC5B,eAAe,EAAE,+BAA+B;QAChD,QAAQ,EAAE,MAAM;KACjB;CACO,CAAC;AAEX,MAAM,qBAAqB,GAAiC;IAC1D,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,iBAAiB;IACrC,yBAAyB,EAAE,yBAAyB;IACpD,uBAAuB,EAAE,yBAAyB;IAClD,wBAAwB,EAAE,wBAAwB;IAClD,sBAAsB,EAAE,wBAAwB;CACjD,CAAC;AAEF,MAAM,aAAa,GACjB,mBAAmB,CAAC,MAAM,CACxB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IACZ,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC,EACD,EAAiD,CAClD,CAAC;AAEJ;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,EAAE,CAAC;IAC3B,OAAO,qBAAqB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAgB;IACvD,OAAO,aAAa,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC"}

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

@@ -1,145 +0,0 @@
-/**
- * Voice 转写依赖安装器。
- *
- * 关键点（中文）
- * - 统一管理 `town voice` 的 Python 依赖安装逻辑。
- * - 根据模型自动推导 runner（funasr / transformers-whisper）并执行 `python -m pip install`。
- * - 返回结构化安装结果，供 CLI/日志/测试复用。
- */
-import type { VoiceModelId, VoiceTranscribeStrategy } from "../../voice/types/Voice.js";
-/**
- * Voice 依赖 runner 类型。
- */
-export type VoiceDependencyRunner = "funasr" | "transformers-whisper";
-/**
- * 单个 runner 的安装摘要。
- */
-export interface VoiceDependencyInstallItem {
-    /**
-     * 当前安装 runner。
-     */
-    runner: VoiceDependencyRunner;
-    /**
-     * Python 可执行文件。
-     */
-    pythonBin: string;
-    /**
-     * 执行参数（不含 pythonBin）。
-     */
-    args: string[];
-    /**
-     * 安装包列表。
-     */
-    packages: string[];
-    /**
-     * 实际执行的命令行（便于排查）。
-     */
-    command: string;
-    /**
-     * 执行耗时（毫秒）。
-     */
-    elapsedMs: number;
-    /**
-     * 是否跳过安装。
-     *
-     * 说明（中文）
-     * - `true` 表示依赖已存在，仅做检查，不再重复安装。
-     * - `false` 或缺省表示执行了实际安装。
-     */
-    skipped?: boolean;
-    /**
-     * 跳过原因（可选）。
-     */
-    skipReason?: string;
-    /**
-     * stdout 尾部（可选）。
-     */
-    stdoutTail?: string;
-    /**
-     * stderr 尾部（可选）。
-     */
-    stderrTail?: string;
-}
-/**
- * 依赖安装结果。
- */
-export interface VoiceDependencyInstallResult {
-    /**
-     * 本次使用的 Python 可执行文件。
-     */
-    pythonBin: string;
-    /**
-     * 本次处理的 runner 列表。
-     */
-    runners: VoiceDependencyRunner[];
-    /**
-     * 各 runner 的安装摘要。
-     */
-    items: VoiceDependencyInstallItem[];
-    /**
-     * 是否使用了虚拟环境安装。
-     */
-    usedVirtualEnv: boolean;
-    /**
-     * 虚拟环境目录（仅 `usedVirtualEnv=true` 时存在）。
-     */
-    venvDir?: string;
-    /**
-     * 初始尝试使用的 Python（仅进入虚拟环境回退时存在）。
-     */
-    basePythonBin?: string;
-}
-/**
- * 依赖安装输入参数。
- */
-export interface VoiceDependencyInstallInput {
-    /**
-     * Python 可执行文件（默认 `python3`）。
-     */
-    pythonBin?: string;
-    /**
-     * 需要安装的 runner 列表。
-     */
-    runners: VoiceDependencyRunner[];
-    /**
-     * 是否使用 `pip -U` 升级。
-     */
-    upgrade?: boolean;
-    /**
-     * pip 安装超时（毫秒）。
-     */
-    timeoutMs?: number;
-    /**
-     * 虚拟环境目录（可选）。
-     *
-     * 说明（中文）
-     * - 当系统 Python 命中 PEP 668（不允许全局 pip install）时，自动回退到该目录。
-     * - 默认 `~/.downcity/venvs/voice`。
-     */
-    venvDir?: string;
-}
-/**
- * 判断是否为 PEP 668（externally-managed-environment）错误。
- */
-export declare function isPep668InstallError(text: string): boolean;
-/**
- * 根据模型推导推荐 runner。
- */
-export declare function resolveVoiceRunnerByModel(modelId: VoiceModelId): VoiceDependencyRunner;
-/**
- * 根据模型列表推导去重后的 runner 列表。
- */
-export declare function resolveVoiceRunnersByModels(modelIds: VoiceModelId[]): VoiceDependencyRunner[];
-/**
- * 根据模型推导推荐转写策略。
- */
-export declare function resolveVoiceStrategyByModel(modelId: VoiceModelId): VoiceTranscribeStrategy;
-/**
- * 安装 Voice 转写依赖。
- *
- * 关键点（中文）
- * - 逐个 runner 执行 pip 安装，任一失败即抛错。
- * - 错误信息携带 stderr/stdout 尾部，便于用户快速定位。
- */
-export declare function installVoiceTranscribeDependencies(input: VoiceDependencyInstallInput): Promise<VoiceDependencyInstallResult>;
-//# sourceMappingURL=DependencyInstaller.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"DependencyInstaller.d.ts","sourceRoot":"","sources":["../../../src/voice/runtime/DependencyInstaller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AASpF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,sBAAsB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;IAC9B;;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;;;;;;OAMG;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,4BAA4B;IAC3C;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;OAEG;IACH,KAAK,EAAE,0BAA0B,EAAE,CAAC;IACpC;;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,2BAA2B;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS1D;AAiPD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAGtF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,YAAY,EAAE,GACvB,qBAAqB,EAAE,CAEzB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,YAAY,GAAG,uBAAuB,CAG1F;AAED;;;;;;GAMG;AACH,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAiDvC"}

package/bin/voice/runtime/DependencyInstaller.js

@@ -1,309 +0,0 @@
-/**
- * Voice 转写依赖安装器。
- *
- * 关键点（中文）
- * - 统一管理 `town voice` 的 Python 依赖安装逻辑。
- * - 根据模型自动推导 runner（funasr / transformers-whisper）并执行 `python -m pip install`。
- * - 返回结构化安装结果，供 CLI/日志/测试复用。
- */
-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_PYTHON_BIN = "python3";
-const DEFAULT_PIP_TIMEOUT_MS = 300_000;
-const OUTPUT_TAIL_LIMIT = 1200;
-const DEFAULT_VENV_DIR = path.join(os.homedir(), ".downcity", "venvs", "voice");
-function normalizePythonBin(input) {
-    const text = String(input || "").trim();
-    return text || DEFAULT_PYTHON_BIN;
-}
-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);
-}
-function resolveVenvPythonBin(venvDir) {
-    return path.join(venvDir, "bin", "python");
-}
-/**
- * 判断是否为 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 === "funasr") {
-        // 关键点（中文）：FunASR 在常见语音模型推理路径会依赖 torch/torchaudio。
-        // 仅安装 funasr 会在转写阶段触发 `ModuleNotFoundError: torch`。
-        return ["funasr", "torch", "torchaudio"];
-    }
-    return ["transformers", "torch", "torchaudio"];
-}
-async function checkRunnerPackagesInstalled(params) {
-    const args = ["-m", "pip", "show", ...params.packages];
-    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,
-                ...(tailText(String(stdout || ""))
-                    ? { stdoutTail: tailText(String(stdout || "")) }
-                    : {}),
-                ...(tailText(String(stderr || ""))
-                    ? { stderrTail: tailText(String(stderr || "")) }
-                    : {}),
-            },
-        };
-    }
-    catch (error) {
-        const errorLike = error;
-        const stdoutTail = tailText(String(errorLike.stdout || ""));
-        const stderrTail = tailText(String(errorLike.stderr || ""));
-        const reason = stderrTail || stdoutTail || String(errorLike.message || error);
-        return {
-            success: false,
-            failure: {
-                runner: params.runner,
-                command,
-                reason,
-            },
-        };
-    }
-}
-async function installAllRunnersWithPython(params) {
-    const items = [];
-    for (const runner of params.runners) {
-        const attempt = await installRunnerWithPython({
-            pythonBin: params.pythonBin,
-            runner,
-            upgrade: params.upgrade,
-            timeoutMs: params.timeoutMs,
-        });
-        if (!attempt.success) {
-            return {
-                success: false,
-                failure: attempt.failure,
-            };
-        }
-        items.push(attempt.item);
-    }
-    return {
-        success: true,
-        items,
-    };
-}
-function formatRunnerInstallFailure(failure) {
-    return `Failed to install voice dependencies for runner "${failure.runner}" via "${failure.command}": ${failure.reason}`;
-}
-async function ensureVoiceVirtualEnvPython(params) {
-    await fs.ensureDir(path.dirname(params.venvDir));
-    const createArgs = ["-m", "venv", params.venvDir];
-    const createCommand = [params.basePythonBin, ...createArgs].join(" ");
-    try {
-        await execFileAsync(params.basePythonBin, createArgs, {
-            timeout: params.timeoutMs,
-            maxBuffer: 8 * 1024 * 1024,
-        });
-    }
-    catch (error) {
-        const errorLike = error;
-        const stdoutTail = tailText(String(errorLike.stdout || ""));
-        const stderrTail = tailText(String(errorLike.stderr || ""));
-        const reason = stderrTail || stdoutTail || String(errorLike.message || error);
-        throw new Error(`Failed to create voice virtual environment via "${createCommand}": ${reason}`);
-    }
-    const venvPythonBin = resolveVenvPythonBin(params.venvDir);
-    const upgradePipArgs = ["-m", "pip", "install", "-U", "pip"];
-    const upgradePipCommand = [venvPythonBin, ...upgradePipArgs].join(" ");
-    try {
-        await execFileAsync(venvPythonBin, upgradePipArgs, {
-            timeout: params.timeoutMs,
-            maxBuffer: 8 * 1024 * 1024,
-        });
-    }
-    catch (error) {
-        const errorLike = error;
-        const stdoutTail = tailText(String(errorLike.stdout || ""));
-        const stderrTail = tailText(String(errorLike.stderr || ""));
-        const reason = stderrTail || stdoutTail || String(errorLike.message || error);
-        throw new Error(`Failed to upgrade pip in voice virtual environment via "${upgradePipCommand}": ${reason}`);
-    }
-    return venvPythonBin;
-}
-/**
- * 根据模型推导推荐 runner。
- */
-export function resolveVoiceRunnerByModel(modelId) {
-    if (modelId === "whisper-large-v3-turbo")
-        return "transformers-whisper";
-    return "funasr";
-}
-/**
- * 根据模型列表推导去重后的 runner 列表。
- */
-export function resolveVoiceRunnersByModels(modelIds) {
-    return dedupeRunners(modelIds.map((modelId) => resolveVoiceRunnerByModel(modelId)));
-}
-/**
- * 根据模型推导推荐转写策略。
- */
-export function resolveVoiceStrategyByModel(modelId) {
-    if (modelId === "whisper-large-v3-turbo")
-        return "transformers-whisper";
-    return "funasr";
-}
-/**
- * 安装 Voice 转写依赖。
- *
- * 关键点（中文）
- * - 逐个 runner 执行 pip 安装，任一失败即抛错。
- * - 错误信息携带 stderr/stdout 尾部，便于用户快速定位。
- */
-export async function installVoiceTranscribeDependencies(input) {
-    const basePythonBin = normalizePythonBin(input.pythonBin);
-    const timeoutMs = normalizeTimeoutMs(input.timeoutMs);
-    const upgrade = input.upgrade !== false;
-    const runners = dedupeRunners(input.runners || []);
-    const firstAttempt = await installAllRunnersWithPython({
-        pythonBin: basePythonBin,
-        runners,
-        upgrade,
-        timeoutMs,
-    });
-    if (firstAttempt.success) {
-        return {
-            pythonBin: basePythonBin,
-            runners,
-            items: firstAttempt.items,
-            usedVirtualEnv: false,
-        };
-    }
-    if (!isPep668InstallError(firstAttempt.failure.reason)) {
-        throw new Error(formatRunnerInstallFailure(firstAttempt.failure));
-    }
-    // 关键点（中文）：命中 PEP 668 时自动回退到独立 venv，避免要求用户手工排障。
-    const venvDir = normalizeVenvDir(input.venvDir);
-    const venvPythonBin = await ensureVoiceVirtualEnvPython({
-        basePythonBin,
-        venvDir,
-        timeoutMs,
-    });
-    const venvAttempt = await installAllRunnersWithPython({
-        pythonBin: venvPythonBin,
-        runners,
-        upgrade,
-        timeoutMs,
-    });
-    if (!venvAttempt.success) {
-        throw new Error(formatRunnerInstallFailure(venvAttempt.failure));
-    }
-    return {
-        pythonBin: venvPythonBin,
-        runners,
-        items: venvAttempt.items,
-        usedVirtualEnv: true,
-        venvDir,
-        basePythonBin,
-    };
-}
-//# sourceMappingURL=DependencyInstaller.js.map