koishi-plugin-local-vitspro 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
-# Changelog
-
+# Changelog
+
+## 0.1.3 (2026-11-02)
+
+- GPT-SoVITS 完整适配：`api_v2.py` 的 `/tts` 支持 GET / POST / auto 回退；补齐官方全部常用参数（`fragment_interval` / `parallel_infer` / `repetition_penalty` / `sample_steps` / `cfg_rate` / `super_sampling` / `use_cuda_graph` 等），默认值与官方一致。
+- 新增老版 `api.py` 支持（`apiVersion: v1`）：自动映射 `refer_wav_path` / `prompt_language` / `text_language` / `inp_refs` / `speed`，且不会调用不存在的底模切换接口。
+- 必填字段前置校验（`ref_audio_path` / `prompt_lang` / `text_lang`），缺字段直接报参数错误，不再把无效请求打给后端。
+- 解析官方 400 的 JSON 错误体（`message` / `Exception`）并拼进错误信息；`auto` 模式仅在 405/404/501 时回退另一种 HTTP 方法。
+- 讲者支持 `languages`（按语言生成多个 key）与 `speed` 旧写法；`top_k` 默认值对齐官方 15。
+- 测试：148 个用例、13 项冒烟（新增 `tests/gpt-sovits.test.ts`）。
+
+## 0.1.2 (2026-11-02)
+
+- 讲者拉取排障：新增 `tts probe`，打印最终 URL、状态码、耗时、原始错误与可操作提示。
+- `url` 容错：自动去掉尾部斜杠与误填的 `/voice`，避免拼成 `/voice/voice/speakers`。
+- `/voice/speakers` 响应容错：兼容数组、`{data:[…]}`、`{speakers:[…]}`、以 id 为键的对象、`lang` 为字符串等写法；仍然跳过 `HUBERT-VITS`。
+- 拉取失败时错误信息带上 URL / 状态 / 响应片段；没有自动拉取能力的后端（如 GPT-SoVITS2）讲者为空时不再无限重试。
+- 测试：136 个用例、12 项冒烟。
+
 ## 0.1.1 (2026-11-02)
 
 - 文档：重写 README，聚焦「插件做什么 / 机制怎么转 / 怎么安装与配置 / 常见问题」，补 npm 与 GitHub 徽章，末尾标注改自 `SilverWolfHoney/koishi-plugin-local-vits`。代码无改动。
@@ -31,3 +48,5 @@
 - 不支持 gradio 后端；
 - 不支持自动翻译。
 
+
+

package/lib/adapters/base.d.ts

@@ -15,6 +15,22 @@ export interface SynthesizeRequest {
     /** 需要 session 的后端（QQ 声聊） */
     session?: any;
 }
+/** `tts probe` 的输出：只做一次真实的讲者探测，不触发合成 */
+export interface SpeakerProbe {
+    label: string;
+    type: Backend['type'];
+    /** 该后端是否真的发了请求（autoPullSpeaker=false 时为 false） */
+    requested: boolean;
+    url?: string;
+    ok: boolean;
+    status?: number;
+    ms: number;
+    count: number;
+    sample?: string[];
+    error?: string;
+    /** 针对常见配置错误的提示 */
+    hint?: string;
+}
 export declare abstract class VitsAdapter {
     protected readonly ctx: AdapterContext;
     abstract readonly type: Backend['type'];
@@ -24,6 +40,8 @@ export declare abstract class VitsAdapter {
     abstract synthesize(request: SynthesizeRequest): Promise<AudioResult>;
     /** 自动拉取讲者（默认返回配置里写死的） */
     getSpeakers(backend: Backend): Promise<SpeakerBase[]>;
+    /** 诊断：跑一次讲者拉取，把 URL / 状态 / 耗时 / 错误都带回来 */
+    probeSpeakers(backend: Backend): Promise<SpeakerProbe>;
     protected headers(backend: Backend, extra?: Record<string, string>): Record<string, string>;
     protected url(base: string, path: string): string;
 }

package/lib/adapters/base.js

@@ -19,6 +19,48 @@ class VitsAdapter {
     async getSpeakers(backend) {
         return backend.speakers ?? [];
     }
+    /** 诊断：跑一次讲者拉取，把 URL / 状态 / 耗时 / 错误都带回来 */
+    async probeSpeakers(backend) {
+        const started = Date.now();
+        const label = backend.label ?? backend.type;
+        if (this.autoPull && backend.autoPullSpeaker === false) {
+            return {
+                label,
+                type: backend.type,
+                requested: false,
+                ok: false,
+                ms: 0,
+                count: 0,
+                hint: 'autoPullSpeaker=false，不会请求后端；请手动配置 speakers'
+            };
+        }
+        try {
+            const speakers = await this.getSpeakers(backend);
+            return {
+                label,
+                type: backend.type,
+                requested: this.autoPull,
+                ok: true,
+                ms: Date.now() - started,
+                count: speakers.length,
+                sample: speakers.slice(0, 5).map((speaker) => speaker.name),
+                hint: this.autoPull && speakers.length === 0
+                    ? '后端返回了空的讲者列表：确认后端已加载模型（/voice/speakers 里有内容）'
+                    : undefined
+            };
+        }
+        catch (error) {
+            return {
+                label,
+                type: backend.type,
+                requested: true,
+                ok: false,
+                ms: Date.now() - started,
+                count: 0,
+                error: error?.message ?? String(error)
+            };
+        }
+    }
     headers(backend, extra) {
         return { ...(backend.headers ?? {}), ...(extra ?? {}) };
     }

package/lib/adapters/base.js.map

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

package/lib/adapters/gpt-sovits2.d.ts

@@ -6,6 +6,16 @@ export declare class GptSovits2Adapter extends VitsAdapter {
     private readonly weights;
     constructor(ctx: AdapterContext);
     synthesize(request: SynthesizeRequest): Promise<AudioResult>;
+    private request;
+    private decorate;
+    private assertRequired;
+    private buildV2Payload;
+    private buildV1Payload;
     private setWeights;
-    private buildPayload;
 }
+/** GET 方式：数组用重复 key，布尔转 true/false，跳过空值 */
+export declare function buildQuery(payload: Record<string, unknown>): string;
+/** 只有「方法/路径不对」才值得换一种 HTTP 方法再试 */
+export declare function shouldFallback(error: unknown): boolean;
+/** v2 的失败响应是 HTTP 400 + JSON：{"message": "...", "Exception": "..."} */
+export declare function extractErrorBody(raw: unknown): string | undefined;

package/lib/adapters/gpt-sovits2.js

@@ -1,9 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GptSovits2Adapter = void 0;
+exports.buildQuery = buildQuery;
+exports.shouldFallback = shouldFallback;
+exports.extractErrorBody = extractErrorBody;
 const base_1 = require("./base");
 const errors_1 = require("../core/errors");
-const WEIGHT_KEYS = ['name', 'gpt_weights', 'sovits_weights', 'languages'];
+/** v2 的官方默认值（与 api_v2.py 的默认参数保持一致） */
+const V2_DEFAULTS = {
+    text_split_method: 'cut5',
+    batch_size: 1,
+    batch_threshold: 0.75,
+    split_bucket: true,
+    speed_factor: 1,
+    fragment_interval: 0.3,
+    top_k: 15,
+    top_p: 1,
+    temperature: 1,
+    seed: -1,
+    media_type: 'wav',
+    streaming_mode: false,
+    parallel_infer: true,
+    use_cuda_graph: true,
+    repetition_penalty: 1.35,
+    super_sampling: false
+};
+/** 允许讲者覆盖的 v2 参数 */
+const V2_SPEAKER_KEYS = [
+    'top_k',
+    'top_p',
+    'temperature',
+    'text_split_method',
+    'batch_size',
+    'batch_threshold',
+    'split_bucket',
+    'speed_factor',
+    'fragment_interval',
+    'seed',
+    'media_type',
+    'parallel_infer',
+    'use_cuda_graph',
+    'repetition_penalty',
+    'sample_steps',
+    'cfg_rate',
+    'super_sampling',
+    'streaming_mode',
+    'overlap_length',
+    'min_chunk_length',
+    'gpt_streaming',
+    'streaming_chunk_seconds',
+    'streaming_window_mode'
+];
+const WEIGHT_KEYS = [
+    'name',
+    'gpt_weights',
+    'sovits_weights',
+    'languages',
+    'ref_audio_path',
+    'aux_ref_audio_paths',
+    'prompt_text',
+    'prompt_lang',
+    'text_lang',
+    'speed'
+];
 class GptSovits2Adapter extends base_1.VitsAdapter {
     type = 'GPT-SoVITS2';
     /** 已切换的底模，避免每次合成都重复调用 set_*_weights */
@@ -14,35 +73,142 @@ class GptSovits2Adapter extends base_1.VitsAdapter {
     async synthesize(request) {
         const backend = request.backend;
         const speaker = request.speaker;
-        const stateKey = backend.label ?? backend.url;
+        const version = backend.apiVersion ?? backend.config?.apiVersion ?? 'v2';
+        if (version === 'v1') {
+            const payload = this.buildV1Payload(backend, speaker, request);
+            this.assertRequired(payload, ['text', 'text_language', 'refer_wav_path', 'prompt_language'], 'v1');
+            const data = await this.request(backend, '/', payload, request.timeout);
+            return { data: (0, base_1.assertAudio)(data), mime: 'audio/wav' };
+        }
         if (speaker.sovits_weights) {
-            await this.setWeights(backend, stateKey, 'sovits', speaker.sovits_weights, request.timeout);
+            await this.setWeights(backend, 'sovits', speaker.sovits_weights, request.timeout);
         }
         if (speaker.gpt_weights) {
-            await this.setWeights(backend, stateKey, 'gpt', speaker.gpt_weights, request.timeout);
+            await this.setWeights(backend, 'gpt', speaker.gpt_weights, request.timeout);
         }
-        const payload = this.buildPayload(backend, speaker, request);
-        const url = this.url(backend.url, '/tts');
-        try {
-            const data = await this.ctx.http.post(url, payload, {
-                headers: this.headers(backend, {
-                    'Content-Type': 'application/json'
-                }),
+        const payload = this.buildV2Payload(backend, speaker, request);
+        this.assertRequired(payload, ['text', 'text_lang', 'ref_audio_path', 'prompt_lang'], 'v2');
+        const data = await this.request(backend, '/tts', payload, request.timeout);
+        return {
+            data: (0, base_1.assertAudio)(data),
+            mime: (0, base_1.mimeFromFormat)(String(payload.media_type ?? 'wav'))
+        };
+    }
+    // -----------------------------------------------------------------------
+    // 请求
+    // -----------------------------------------------------------------------
+    async request(backend, path, payload, timeout) {
+        const method = backend.method ?? backend.config?.method ?? 'auto';
+        const base = String(backend.url ?? '').replace(/\/+$/, '');
+        const url = `${base}${path}`;
+        const headers = this.headers(backend);
+        const jsonHeaders = this.headers(backend, {
+            'Content-Type': 'application/json'
+        });
+        const send = async (verb) => {
+            if (verb === 'POST') {
+                return this.ctx.http.post(url, payload, {
+                    headers: jsonHeaders,
+                    responseType: 'arraybuffer',
+                    timeout
+                });
+            }
+            return this.ctx.http.get(`${url}${buildQuery(payload)}`, {
+                headers,
                 responseType: 'arraybuffer',
-                timeout: request.timeout
+                timeout
             });
-            return {
-                data: (0, base_1.assertAudio)((0, base_1.toBuffer)(data)),
-                mime: payload.media_type === 'mp3'
-                    ? 'audio/mpeg'
-                    : 'audio/wav'
-            };
+        };
+        try {
+            return (0, base_1.toBuffer)(await send(method === 'get' ? 'GET' : 'POST'));
         }
         catch (error) {
-            throw (0, base_1.wrapError)(error, 'GPT-SoVITS2');
+            if (method !== 'auto' || !shouldFallback(error)) {
+                throw this.decorate(error);
+            }
+            // 老版本 api_v2 可能只有 GET；反过来也有的部署只放 POST
+            try {
+                return (0, base_1.toBuffer)(await send('GET'));
+            }
+            catch (fallbackError) {
+                throw this.decorate(fallbackError);
+            }
         }
     }
-    async setWeights(backend, stateKey, which, weightsPath, timeout) {
+    decorate(error) {
+        const wrapped = (0, base_1.wrapError)(error, 'GPT-SoVITS');
+        const body = extractErrorBody(error?.response?.data);
+        if (body && !wrapped.message.includes(body)) {
+            return new errors_1.BackendError(wrapped.errorClass, `${wrapped.message} · body: ${body}`, wrapped.status, { cause: error });
+        }
+        return wrapped;
+    }
+    assertRequired(payload, keys, version) {
+        const missing = keys.filter((key) => payload[key] == null || payload[key] === '');
+        if (missing.length === 0)
+            return;
+        throw new errors_1.BackendError('BAD_REQUEST', `GPT-SoVITS ${version} 缺少必填字段：${missing.join(', ')}` +
+            '（讲者里需要配置 ref_audio_path 与 prompt_lang；v2 还需要 text_lang）');
+    }
+    // -----------------------------------------------------------------------
+    // 请求体
+    // -----------------------------------------------------------------------
+    buildV2Payload(backend, speaker, request) {
+        const merged = {
+            ...V2_DEFAULTS,
+            ...(backend.config ?? {})
+        };
+        for (const key of V2_SPEAKER_KEYS) {
+            const value = speaker[key];
+            if (value != null)
+                merged[key] = value;
+        }
+        // 讲者上的 speed 是旧写法，统一成 speed_factor
+        if (speaker.speed != null && speaker.speed_factor == null) {
+            merged.speed_factor = speaker.speed;
+        }
+        const payload = {
+            ...merged,
+            text: request.text,
+            text_lang: (0, base_1.mapLanguage)(speaker.text_lang ??
+                request.language ??
+                speaker.languages?.[0] ??
+                'zh'),
+            ref_audio_path: speaker.ref_audio_path,
+            aux_ref_audio_paths: speaker.aux_ref_audio_paths ?? [],
+            prompt_text: speaker.prompt_text ?? '',
+            prompt_lang: (0, base_1.mapLanguage)(speaker.prompt_lang ?? request.language ?? 'zh')
+        };
+        return dropUndefined(payload);
+    }
+    buildV1Payload(backend, speaker, request) {
+        const config = backend.config ?? {};
+        const payload = {
+            refer_wav_path: speaker.ref_audio_path,
+            prompt_text: speaker.prompt_text ?? '',
+            prompt_language: (0, base_1.mapLanguage)(speaker.prompt_lang ?? request.language ?? 'zh'),
+            text: request.text,
+            text_language: (0, base_1.mapLanguage)(speaker.text_lang ??
+                request.language ??
+                speaker.languages?.[0] ??
+                'zh'),
+            cut_punc: config.cut_punc,
+            top_k: speaker.top_k ?? config.top_k ?? 15,
+            top_p: speaker.top_p ?? config.top_p ?? 1,
+            temperature: speaker.temperature ?? config.temperature ?? 1,
+            speed: speaker.speed ?? config.speed ?? 1,
+            inp_refs: speaker.aux_ref_audio_paths ?? [],
+            sample_steps: config.sample_steps,
+            if_sr: config.if_sr,
+            cfg_rate: config.cfg_rate
+        };
+        return dropUndefined(payload);
+    }
+    // -----------------------------------------------------------------------
+    // 底模切换（仅 v2）
+    // -----------------------------------------------------------------------
+    async setWeights(backend, which, weightsPath, timeout) {
+        const stateKey = backend.label ?? backend.url;
         const state = this.weights.get(stateKey) ?? {};
         if (state[which] === weightsPath)
             return;
@@ -56,46 +222,88 @@ class GptSovits2Adapter extends base_1.VitsAdapter {
                 typeof response === 'object' &&
                 'message' in response &&
                 response.message !== 'success') {
-                throw new errors_1.BackendError('SERVER', `GPT-SoVITS2 切换 ${which} 底模失败：${JSON.stringify(response).slice(0, 120)}`);
+                throw new errors_1.BackendError('SERVER', `GPT-SoVITS 切换 ${which} 底模失败：${JSON.stringify(response).slice(0, 120)}`);
             }
             state[which] = weightsPath;
             this.weights.set(stateKey, state);
         }
         catch (error) {
-            throw (0, base_1.wrapError)(error, `GPT-SoVITS2:set_${which}_weights`);
+            throw (0, base_1.wrapError)(error, `GPT-SoVITS:set_${which}_weights`);
         }
     }
-    buildPayload(backend, speaker, request) {
-        const overrides = {};
-        for (const [key, value] of Object.entries(speaker)) {
-            if (WEIGHT_KEYS.includes(key))
-                continue;
-            if (key === 'text' || value == null)
-                continue;
-            overrides[key] = value;
-        }
-        const payload = {
-            ...(backend.config ?? {}),
-            ...overrides,
-            text: request.text,
-            text_lang: (0, base_1.mapLanguage)(speaker.text_lang ??
-                request.language ??
-                speaker.languages?.[0] ??
-                'zh'),
-            streaming_mode: false
-        };
-        if (payload.speed != null) {
-            payload.speed_factor = payload.speed;
-            delete payload.speed;
+}
+exports.GptSovits2Adapter = GptSovits2Adapter;
+function dropUndefined(payload) {
+    const result = {};
+    for (const [key, value] of Object.entries(payload)) {
+        if (value === undefined || value === null)
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+/** GET 方式：数组用重复 key，布尔转 true/false，跳过空值 */
+function buildQuery(payload) {
+    const parts = [];
+    for (const [key, value] of Object.entries(payload)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item == null || item === '')
+                    continue;
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+            }
+            continue;
         }
-        if (payload.prompt_lang != null) {
-            payload.prompt_lang = (0, base_1.mapLanguage)(String(payload.prompt_lang));
+        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    }
+    return parts.length > 0 ? `?${parts.join('&')}` : '';
+}
+/** 只有「方法/路径不对」才值得换一种 HTTP 方法再试 */
+function shouldFallback(error) {
+    const status = error?.status ?? error?.response?.status;
+    if (status === 405 || status === 404 || status === 501)
+        return true;
+    const message = String(error?.message ?? '');
+    return /method not allowed|405/i.test(message);
+}
+/** v2 的失败响应是 HTTP 400 + JSON：{"message": "...", "Exception": "..."} */
+function extractErrorBody(raw) {
+    if (raw == null)
+        return undefined;
+    if (typeof raw === 'object' && !Buffer.isBuffer(raw) && !(raw instanceof ArrayBuffer)) {
+        try {
+            const json = raw;
+            const parts = [json.message, json.Exception, json.detail]
+                .filter((item) => typeof item === 'string' && item.length > 0)
+                .join(' · ');
+            if (parts)
+                return parts.slice(0, 300);
+            return JSON.stringify(raw).slice(0, 300);
         }
-        if (payload.aux_ref_audio_paths == null) {
-            payload.aux_ref_audio_paths = [];
+        catch {
+            return undefined;
         }
-        return payload;
+    }
+    let text;
+    if (typeof raw === 'string')
+        text = raw;
+    else if (Buffer.isBuffer(raw))
+        text = raw.toString('utf8');
+    else if (raw instanceof ArrayBuffer)
+        text = Buffer.from(raw).toString('utf8');
+    if (!text)
+        return undefined;
+    try {
+        const json = JSON.parse(text);
+        const parts = [json.message, json.Exception, json.detail]
+            .filter((item) => typeof item === 'string')
+            .join(' · ');
+        return (parts || text).slice(0, 300);
+    }
+    catch {
+        return text.slice(0, 300);
     }
 }
-exports.GptSovits2Adapter = GptSovits2Adapter;
 //# sourceMappingURL=gpt-sovits2.js.map

package/lib/adapters/gpt-sovits2.js.map

@@ -1 +1 @@
-{"version":3,"file":"gpt-sovits2.js","sourceRoot":"","sources":["../../src/adapters/gpt-sovits2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gpt-sovits2.js","sourceRoot":"","sources":["../../src/adapters/gpt-sovits2.ts"],"names":[],"mappings":";;;AAmWA,gCAsBC;AAGD,wCAOC;AAGD,4CAgCC;AA/ZD,iCASe;AACf,2CAA6C;AAe7C,uCAAuC;AACvC,MAAM,WAAW,GAAqB;IAClC,iBAAiB,EAAE,MAAM;IACzB,UAAU,EAAE,CAAC;IACb,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,GAAG;IACtB,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,CAAC;IACR,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,EAAE,KAAK;IACjB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,KAAK;CACxB,CAAA;AAED,oBAAoB;AACpB,MAAM,eAAe,GAAkD;IACnE,OAAO;IACP,OAAO;IACP,aAAa;IACb,mBAAmB;IACnB,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,MAAM;IACN,YAAY;IACZ,gBAAgB;IAChB,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,UAAU;IACV,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;IACf,yBAAyB;IACzB,uBAAuB;CAC1B,CAAA;AAED,MAAM,WAAW,GAAG;IAChB,MAAM;IACN,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,qBAAqB;IACrB,aAAa;IACb,aAAa;IACb,WAAW;IACX,OAAO;CACV,CAAA;AAED,MAAa,iBAAkB,SAAQ,kBAAW;IACrC,IAAI,GAAG,aAAsB,CAAA;IAEtC,uCAAuC;IACtB,OAAO,GAAG,IAAI,GAAG,EAG/B,CAAA;IAEH,YAAY,GAAmB;QAC3B,KAAK,CAAC,GAAG,CAAC,CAAA;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA0B;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAA4B,CAAA;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAqB,CAAA;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI,CAAA;QAExE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YAC9D,IAAI,CAAC,cAAc,CACf,OAAO,EACP,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAC9D,IAAI,CACP,CAAA;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;YACvE,OAAO,EAAE,IAAI,EAAE,IAAA,kBAAW,EAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;QACzD,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QACrF,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/E,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC9D,IAAI,CAAC,cAAc,CACf,OAAO,EACP,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,CAAC,EACtD,IAAI,CACP,CAAA;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1E,OAAO;YACH,IAAI,EAAE,IAAA,kBAAW,EAAC,IAAI,CAAC;YACvB,IAAI,EAAE,IAAA,qBAAc,EAAC,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;SAC5D,CAAA;IACL,CAAC;IAED,0EAA0E;IAC1E,KAAK;IACL,0EAA0E;IAElE,KAAK,CAAC,OAAO,CACjB,OAA0B,EAC1B,IAAY,EACZ,OAAgC,EAChC,OAAe;QAEf,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM,CAAA;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,CAAA;QAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YACtC,cAAc,EAAE,kBAAkB;SACrC,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAoB,EAAoB,EAAE;YAC1D,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE;oBACpC,OAAO,EAAE,WAAW;oBACpB,YAAY,EAAE,aAAa;oBAC3B,OAAO;iBACV,CAAC,CAAA;YACN,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE;gBACrD,OAAO;gBACP,YAAY,EAAE,aAAa;gBAC3B,OAAO;aACV,CAAC,CAAA;QACN,CAAC,CAAA;QAED,IAAI,CAAC;YACD,OAAO,IAAA,eAAQ,EAAC,MAAM,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC9B,CAAC;YAED,sCAAsC;YACtC,IAAI,CAAC;gBACD,OAAO,IAAA,eAAQ,EAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;YACtC,CAAC;QACL,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,KAAc;QAC3B,MAAM,OAAO,GAAG,IAAA,gBAAS,EAAC,KAAK,EAAE,YAAY,CAAC,CAAA;QAC9C,MAAM,IAAI,GAAG,gBAAgB,CAAE,KAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;QAE7D,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,qBAAY,CACnB,OAAO,CAAC,UAAU,EAClB,GAAG,OAAO,CAAC,OAAO,YAAY,IAAI,EAAE,EACpC,OAAO,CAAC,MAAM,EACd,EAAE,KAAK,EAAE,KAAK,EAAE,CACnB,CAAA;QACL,CAAC;QACD,OAAO,OAAO,CAAA;IAClB,CAAC;IAEO,cAAc,CAClB,OAAgC,EAChC,IAAc,EACd,OAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CACvB,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CACvD,CAAA;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEhC,MAAM,IAAI,qBAAY,CAClB,aAAa,EACb,cAAc,OAAO,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAChD,yDAAyD,CAChE,CAAA;IACL,CAAC;IAED,0EAA0E;IAC1E,MAAM;IACN,0EAA0E;IAElE,cAAc,CAClB,OAA0B,EAC1B,OAAmB,EACnB,OAA0B;QAE1B,MAAM,MAAM,GAA4B;YACpC,GAAG,WAAW;YACd,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;SAC5B,CAAA;QAED,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAChC,MAAM,KAAK,GAAI,OAAmC,CAAC,GAAa,CAAC,CAAA;YACjE,IAAI,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,GAAa,CAAC,GAAG,KAAK,CAAA;QACpD,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;YACxD,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,CAAA;QACvC,CAAC;QAED,MAAM,OAAO,GAA4B;YACrC,GAAG,MAAM;YACT,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,IAAA,kBAAW,EAClB,OAAO,CAAC,SAAS;gBACb,OAAO,CAAC,QAAQ;gBAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBACtB,IAAI,CACX;YACD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,EAAE;YACtD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,WAAW,EAAE,IAAA,kBAAW,EACpB,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,CAClD;SACJ,CAAA;QAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAEO,cAAc,CAClB,OAA0B,EAC1B,OAAmB,EACnB,OAA0B;QAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;QACnC,MAAM,OAAO,GAA4B;YACrC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,eAAe,EAAE,IAAA,kBAAW,EACxB,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,CAClD;YACD,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,aAAa,EAAE,IAAA,kBAAW,EACtB,OAAO,CAAC,SAAS;gBACb,OAAO,CAAC,QAAQ;gBAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBACtB,IAAI,CACX;YACD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAC1C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;YACzC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC;YAC3D,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;YACzC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,IAAI,EAAE;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC5B,CAAA;QAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAED,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAElE,KAAK,CAAC,UAAU,CACpB,OAA0B,EAC1B,KAAuB,EACvB,WAAmB,EACnB,OAAe;QAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAA;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,WAAW;YAAE,OAAM;QAExC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,UAAU,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAA;QAE/G,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;gBAC1C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC9B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;aACpC,CAAC,CAAA;YAEF,IACI,QAAQ;gBACR,OAAO,QAAQ,KAAK,QAAQ;gBAC5B,SAAS,IAAK,QAAoC;gBACjD,QAAoC,CAAC,OAAO,KAAK,SAAS,EAC7D,CAAC;gBACC,MAAM,IAAI,qBAAY,CAClB,QAAQ,EACR,iBAAiB,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC1E,CAAA;YACL,CAAC;YAED,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAA,gBAAS,EAAC,KAAK,EAAE,kBAAkB,KAAK,UAAU,CAAC,CAAA;QAC7D,CAAC;IACL,CAAC;CACJ;AAzPD,8CAyPC;AAED,SAAS,aAAa,CAClB,OAAgC;IAEhC,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACvB,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED,2CAA2C;AAC3C,SAAgB,UAAU,CAAC,OAAgC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,SAAQ;QAEnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE;oBAAE,SAAQ;gBACzC,KAAK,CAAC,IAAI,CACN,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CACnE,CAAA;YACL,CAAC;YACD,SAAQ;QACZ,CAAC;QAED,KAAK,CAAC,IAAI,CACN,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CACpE,CAAA;IACL,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACxD,CAAC;AAED,kCAAkC;AAClC,SAAgB,cAAc,CAAC,KAAc;IACzC,MAAM,MAAM,GACP,KAAa,EAAE,MAAM,IAAK,KAAa,EAAE,QAAQ,EAAE,MAAM,CAAA;IAC9D,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAEnE,MAAM,OAAO,GAAG,MAAM,CAAE,KAAa,EAAE,OAAO,IAAI,EAAE,CAAC,CAAA;IACrD,OAAO,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC;AAED,uEAAuE;AACvE,SAAgB,gBAAgB,CAAC,GAAY;IACzC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IAEjC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,WAAW,CAAC,EAAE,CAAC;QACpF,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,GAA8B,CAAA;YAC3C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;iBACpD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;iBAC7D,IAAI,CAAC,KAAK,CAAC,CAAA;YAChB,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YACrC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,SAAS,CAAA;QACpB,CAAC;IACL,CAAC;IAED,IAAI,IAAwB,CAAA;IAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,IAAI,GAAG,GAAG,CAAA;SAClC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;SACrD,IAAI,GAAG,YAAY,WAAW;QAAE,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE7E,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAE3B,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;aACpD,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;aACnD,IAAI,CAAC,KAAK,CAAC,CAAA;QAChB,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC7B,CAAC;AACL,CAAC"}

package/lib/adapters/vits-simple-api.d.ts

@@ -1,11 +1,25 @@
 import { AudioResult, Backend, SpeakerBase } from '../types';
-import { AdapterContext, SynthesizeRequest, VitsAdapter } from './base';
+import { AdapterContext, SynthesizeRequest, SpeakerProbe, VitsAdapter } from './base';
+import { ErrorClass } from '../types';
 export declare class VitsSimpleApiAdapter extends VitsAdapter {
     readonly type: "vits-simple-api";
     readonly autoPull = true;
     constructor(ctx: AdapterContext);
     synthesize(request: SynthesizeRequest): Promise<AudioResult>;
+    /** 基础地址容错：去掉尾部斜杠，以及误填的 `/voice` 后缀 */
+    protected url(base: string, path: string): string;
     getSpeakers(backend: Backend): Promise<SpeakerBase[]>;
+    /** 诊断用：带 URL / 状态 / 原始响应片段 */
+    probeSpeakers(backend: Backend): Promise<SpeakerProbe>;
+    private fetchSpeakers;
     private buildHeaders;
     private buildPayload;
 }
+/**
+ * 解析 `/voice/speakers` 的返回。标准形状是
+ * `{"VITS":[{"id":0,"name":"x","lang":["zh"]}], "HUBERT-VITS":[…]}`，
+ * 同时兼容数组、`{data:[…]}`、`{speakers:[…]}`、以 id 为键的对象等写法。
+ */
+export declare function parseSpeakersResponse(response: unknown): SpeakerBase[];
+/** 把常见失败翻译成一句可操作的提示 */
+export declare function speakersErrorHint(status?: number, errorClass?: ErrorClass): string | undefined;