@jingyi0605/codingns4dsh 0.2.1-beta.2 → 0.2.1-beta.4

package/data/build/dist/host/features/types.d.ts

@@ -14,6 +14,12 @@ export interface CodingNsHostEvents {
     emit?(name: string, ...args: any[]): unknown;
 }
 export interface AssistantHostGateway {
+    /** 已显式加入聚合的工作区元数据；不读取远端会话正文。 */
+    workspaces?(): Promise<readonly {
+        readonly workspaceId: string;
+        readonly name: string;
+        readonly path: string | null;
+    }[]>;
     list(managedWorkspaceIds: readonly string[]): Promise<{
         readonly sessions: readonly AssistantSessionSourceRecord[];
         readonly archivedSessionIds: readonly string[];
@@ -31,7 +37,7 @@ export interface AssistantHostGateway {
             readonly type: 'text';
             readonly text: string;
         }];
-    }): Promise<void>;
+    }, signal?: AbortSignal): Promise<void>;
 }
 /**
  * Host 侧功能模块可用的服务集合。
@@ -69,6 +75,8 @@ export interface CodingNsHostServices {
     readonly registerPeerHostHandshakeRoute?: (handler: (request: Request) => Promise<Response>) => () => Promise<void>;
     /** 全局助理二进制 PCM 流入口；只由语音模块注册和注销。 */
     readonly registerAssistantVoiceStreamRoute?: (handler: (request: Request) => Promise<Response>) => () => Promise<void>;
+    /** 引擎与已安装素材入口；旧预设仅在已有配置需要时登记兼容路由。 */
+    readonly registerAssistantAvatarRuntimeRoute?: (handler: (request: Request) => Promise<Response>, legacy?: boolean) => () => Promise<void>;
     /** 由 Host 权威解析 Workspace ID，Client 不可覆盖。 */
     readonly resolveWorkspaceRoot?: (workspaceId: string) => string | null;
     /** 返回 Host 当前已知的工作区根目录，用于文件管理路径校验。 */

package/data/build/dist/host/features/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAA;AACxH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAA;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAE/E,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAAA;IAC5D,2CAA2C;IAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,UAAU,CAAC,IAAI,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC,CAAA;IACxH,IAAI,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;QACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,4BAA4B,EAAE,CAAA;QAC1D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;QAC9C,qCAAqC;QACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;QAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;KACvG,CAAC,CAAA;IACF,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5P;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,gBAAgB,CAAC,CAAA;IAC1D,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;IACnD,wCAAwC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,2BAA2B,CAAA;IACrD,mDAAmD;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;IAC7C,sCAAsC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;IACnD,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAA;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5G,qCAAqC;IACrC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACnH,mCAAmC;IACnC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACtH,qCAAqC;IACrC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1I,4CAA4C;IAC5C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACtE,sCAAsC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAA;IACrD,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;CACjD"}

package/data/build/dist/host/features/voice-model-management.d.ts

@@ -0,0 +1,22 @@
+import type { AssistantVoiceSettings } from '../../shared/contracts/config.js';
+import { type AssistantVoiceModelPaths, type AssistantVoiceModelProgress, type AssistantVoiceModelStatus, type AssistantVoiceModelsSnapshot } from '../../shared/voice-models.js';
+import { type InstalledAssistantVoiceModel } from './voice-model-setup.js';
+export type AssistantVoiceModelProbe = (paths: AssistantVoiceModelPaths, signal: AbortSignal) => Promise<void>;
+type Validation = AssistantVoiceModelStatus['validation'];
+/** 统一管理缓存事实与验证记录；查看状态不会触发下载或原生模型加载。 */
+export declare class AssistantVoiceModelManager {
+    private readonly probe;
+    constructor(probe?: AssistantVoiceModelProbe);
+    snapshot(settings: AssistantVoiceSettings, runtime: {
+        readonly running: boolean;
+        readonly ready: boolean;
+        readonly operation: AssistantVoiceModelsSnapshot['operation'];
+    }): Promise<AssistantVoiceModelsSnapshot>;
+    verify(modelId: string, settings: AssistantVoiceSettings, signal: AbortSignal): Promise<Validation>;
+    /** 先验证再交给调用方保存配置；修复在独立目录完成，失败时保留旧缓存。 */
+    prepare(modelId: string, settings: AssistantVoiceSettings, onProgress: (progress: AssistantVoiceModelProgress) => void, signal: AbortSignal, repair?: boolean): Promise<InstalledAssistantVoiceModel>;
+    private validate;
+    private repair;
+}
+export {};
+//# sourceMappingURL=voice-model-management.d.ts.map

package/data/build/dist/host/features/voice-model-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-model-management.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-management.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAEqB,KAAK,wBAAwB,EAAE,KAAK,2BAA2B,EACzF,KAAK,yBAAyB,EAAE,KAAK,4BAA4B,EAClE,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAA8C,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAGtH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAC9G,KAAK,UAAU,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAA;AAGzD,uCAAuC;AACvC,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,GAAE,wBAAyF;IAEvH,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE;QACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;QACvB,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC,WAAW,CAAC,CAAA;KAC9D,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAYnC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAOzG,wCAAwC;IAClC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,4BAA4B,CAAC;YAiB3L,QAAQ;YAkBR,MAAM;CAiBrB"}

package/data/build/dist/host/features/voice-model-management.js

@@ -0,0 +1,178 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ASSISTANT_VOICE_MODEL_CATALOG, findAssistantVoiceModel, } from '../../shared/voice-models.js';
+import { installAssistantVoiceModel, voiceModelRoot } from './voice-model-setup.js';
+import { probeAssistantVoiceModel } from './voice-model-probe.js';
+const unchecked = { state: 'unchecked', checkedAt: null, error: null };
+/** 统一管理缓存事实与验证记录；查看状态不会触发下载或原生模型加载。 */
+export class AssistantVoiceModelManager {
+    probe;
+    constructor(probe = (paths, signal) => probeAssistantVoiceModel(paths, { signal })) {
+        this.probe = probe;
+    }
+    async snapshot(settings, runtime) {
+        const currentModelId = settings.initialized && settings.provider === 'sherpa-onnx' ? settings.modelId?.trim() || null : null;
+        const models = await Promise.all(ASSISTANT_VOICE_MODEL_CATALOG.map(async (model) => {
+            const current = currentModelId === model.id;
+            const paths = current ? configuredPaths(settings) ?? cachedPaths(model) : cachedPaths(model);
+            const inspected = await inspectFiles(model, paths);
+            const validation = inspected.state === 'downloaded' ? await readValidation(model.id, inspected.fingerprint) : unchecked;
+            return { modelId: model.id, current, ...inspected.status, validation };
+        }));
+        return { models, currentModelId, runtimeRunning: runtime.running, runtimeReady: runtime.ready, operation: runtime.operation };
+    }
+    async verify(modelId, settings, signal) {
+        const model = requireModel(modelId);
+        const paths = currentPaths(model, settings) ?? cachedPaths(model);
+        await this.validate(model, paths, signal);
+        return { state: 'passed', checkedAt: Date.now(), error: null };
+    }
+    /** 先验证再交给调用方保存配置；修复在独立目录完成，失败时保留旧缓存。 */
+    async prepare(modelId, settings, onProgress, signal, repair = false) {
+        const model = requireModel(modelId);
+        const stage = (phase) => onProgress({
+            modelId, phase, fileName: null, fileIndex: model.files.length, fileCount: model.files.length, downloadedBytes: 0, totalBytes: null,
+        });
+        if (repair)
+            return this.repair(model, onProgress, signal);
+        const configured = currentPaths(model, settings);
+        const reuse = configured !== undefined && (await inspectFiles(model, configured)).state === 'downloaded';
+        const installed = reuse
+            ? { model, paths: configured, downloaded: false }
+            : await installAssistantVoiceModel(modelId, onProgress, { signal });
+        stage('verifying');
+        await this.validate(model, installed.paths, signal);
+        stage('initializing');
+        return installed;
+    }
+    async validate(model, paths, signal) {
+        signal.throwIfAborted();
+        const before = await inspectFiles(model, paths);
+        if (before.state !== 'downloaded')
+            throw new Error('模型文件尚未下载完整，请先补全下载');
+        try {
+            await this.probe(paths, signal);
+            signal.throwIfAborted();
+            const after = await inspectFiles(model, paths);
+            if (after.fingerprint !== before.fingerprint)
+                throw new Error('验证期间模型文件发生变化，请重新验证');
+            await writeValidation(model.id, before.fingerprint, { state: 'passed', checkedAt: Date.now(), error: null });
+        }
+        catch (error) {
+            if (!signal.aborted)
+                await writeValidation(model.id, before.fingerprint, {
+                    state: 'failed', checkedAt: Date.now(), error: error instanceof Error ? error.message : String(error),
+                }).catch(() => undefined);
+            throw error;
+        }
+    }
+    async repair(model, onProgress, signal) {
+        const staging = join(voiceModelRoot(), `.${model.id}-${randomUUID()}.download`);
+        try {
+            const installed = await installAssistantVoiceModel(model.id, onProgress, { directory: staging, signal });
+            onProgress({ modelId: model.id, phase: 'verifying', fileName: null, fileIndex: model.files.length, fileCount: model.files.length, downloadedBytes: 0, totalBytes: null });
+            await this.probe(installed.paths, signal);
+            signal.throwIfAborted();
+            await promoteDirectory(staging, join(voiceModelRoot(), model.id));
+            const paths = cachedPaths(model);
+            const inspected = await inspectFiles(model, paths);
+            await writeValidation(model.id, inspected.fingerprint, { state: 'passed', checkedAt: Date.now(), error: null });
+            onProgress({ modelId: model.id, phase: 'initializing', fileName: null, fileIndex: model.files.length, fileCount: model.files.length, downloadedBytes: 0, totalBytes: null });
+            return { model, paths, downloaded: true };
+        }
+        finally {
+            await rm(staging, { recursive: true, force: true });
+        }
+    }
+}
+function requireModel(modelId) {
+    const model = findAssistantVoiceModel(modelId);
+    if (model === undefined)
+        throw new Error('不支持的实时语音模型');
+    return model;
+}
+function cachedPaths(model) {
+    return Object.fromEntries(model.files.map((file) => [file.setting, join(voiceModelRoot(), model.id, file.name)]));
+}
+function configuredPaths(settings) {
+    const { asrEncoder, asrDecoder, asrJoiner, asrTokens } = settings;
+    return [asrEncoder, asrDecoder, asrJoiner, asrTokens].every((path) => path.trim() !== '')
+        ? { asrEncoder, asrDecoder, asrJoiner, asrTokens } : undefined;
+}
+function currentPaths(model, settings) {
+    return settings.initialized && settings.provider === 'sherpa-onnx' && settings.modelId?.trim() === model.id ? configuredPaths(settings) : undefined;
+}
+async function fileInfo(path) {
+    try {
+        const info = await stat(path);
+        return info.isFile() ? { bytes: info.size, mtime: info.mtimeMs, ctime: info.ctimeMs } : { bytes: 0, mtime: 0, ctime: 0 };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { bytes: 0, mtime: 0, ctime: 0 };
+        throw error;
+    }
+}
+async function inspectFiles(model, paths) {
+    const facts = await Promise.all(model.files.map(async (file) => {
+        const path = paths[file.setting];
+        const [info, partial] = await Promise.all([fileInfo(path), fileInfo(`${path}.part`)]);
+        return { name: file.name, path, ...info, partialBytes: partial.bytes, present: info.bytes > 0 };
+    }));
+    const count = facts.filter((file) => file.present).length;
+    const state = count === facts.length ? 'downloaded'
+        : count > 0 || facts.some((file) => file.partialBytes > 0) ? 'partial' : 'missing';
+    return {
+        state,
+        fingerprint: JSON.stringify(facts.map(({ path, bytes, mtime, ctime }) => [path, bytes, mtime, ctime])),
+        status: { state, totalBytes: facts.reduce((sum, file) => sum + file.bytes, 0), files: facts.map(({ name, path, bytes, partialBytes, present }) => ({ name, path, bytes, partialBytes, present })) },
+    };
+}
+async function readValidation(modelId, fingerprint) {
+    try {
+        const value = JSON.parse(await readFile(join(voiceModelRoot(), modelId, '.validation.json'), 'utf8'));
+        if (value.fingerprint !== fingerprint || !['passed', 'failed'].includes(value.state) || typeof value.checkedAt !== 'number')
+            return unchecked;
+        return { state: value.state, checkedAt: value.checkedAt, error: typeof value.error === 'string' ? value.error : null };
+    }
+    catch {
+        return unchecked;
+    }
+}
+async function writeValidation(modelId, fingerprint, validation) {
+    const directory = join(voiceModelRoot(), modelId);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const temporary = join(directory, `.validation-${randomUUID()}.part`);
+    try {
+        await writeFile(temporary, JSON.stringify({ fingerprint, ...validation }), { mode: 0o600 });
+        await rename(temporary, join(directory, '.validation.json'));
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+/** 只有整组文件验证通过才替换缓存目录，目录替换失败时恢复原目录。 */
+async function promoteDirectory(staging, target) {
+    const backup = `${target}.backup-${randomUUID()}`;
+    let backedUp = false;
+    try {
+        await rename(target, backup);
+        backedUp = true;
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    try {
+        await rename(staging, target);
+    }
+    catch (error) {
+        if (backedUp)
+            await rename(backup, target);
+        throw error;
+    }
+    if (backedUp)
+        await rm(backup, { recursive: true, force: true });
+}
+//# sourceMappingURL=voice-model-management.js.map

package/data/build/dist/host/features/voice-model-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-model-management.js","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-management.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/features/voice-model-probe.d.ts

@@ -0,0 +1,8 @@
+import type { AssistantVoiceModelPaths } from '../../shared/voice-models.js';
+/** 加载四个模型文件并执行静音识别，不启动麦克风，也不占用全局语音租约。 */
+export declare function probeAssistantVoiceModel(paths: AssistantVoiceModelPaths, options?: {
+    readonly modulePath?: string;
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=voice-model-probe.d.ts.map

package/data/build/dist/host/features/voice-model-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-model-probe.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-probe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAgC5E,yCAAyC;AACzC,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,EAAE,OAAO,GAAE;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrB"}

package/data/build/dist/host/features/voice-model-probe.js

@@ -0,0 +1,76 @@
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { createSherpaRecognizerConfig } from './sherpa-voice-runtime.js';
+const PROBE_OK = 'CODINGNS_VOICE_MODEL_PROBE_OK';
+// 原生 ONNX 加载失败可能直接终止进程；验证必须在独立子进程中执行。
+const PROBE_SCRIPT = `
+import { readFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+try {
+  const imported = await import(pathToFileURL(process.argv[1]).href);
+  const module = imported.default ?? imported;
+  if (typeof module.OnlineRecognizer !== 'function') throw new Error('Sherpa-ONNX Node 未导出 OnlineRecognizer');
+  const config = JSON.parse(readFileSync(0, 'utf8'));
+  const recognizer = new module.OnlineRecognizer(config);
+  const stream = recognizer.createStream();
+  stream.acceptWaveform({ sampleRate: config.featConfig.sampleRate, samples: new Float32Array(config.featConfig.sampleRate * 2) });
+  stream.inputFinished();
+  let decoded = 0;
+  while (recognizer.isReady(stream)) {
+    if (++decoded > 500) throw new Error('模型验证解码未能正常结束');
+    recognizer.decode(stream);
+  }
+  if (decoded === 0) throw new Error('模型无法执行识别解码');
+  const result = recognizer.getResult(stream);
+  if (typeof result?.text !== 'string') throw new Error('模型没有返回有效的识别结果');
+  process.stdout.write('${PROBE_OK}');
+} catch (error) {
+  process.stderr.write(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}
+`;
+/** 加载四个模型文件并执行静音识别，不启动麦克风，也不占用全局语音租约。 */
+export async function probeAssistantVoiceModel(paths, options = {}) {
+    options.signal?.throwIfAborted();
+    let modulePath;
+    try {
+        modulePath = options.modulePath ?? createRequire(import.meta.url).resolve('sherpa-onnx-node');
+    }
+    catch {
+        throw new Error('当前 Host 缺少 Sherpa-ONNX 运行时，无法验证或使用模型');
+    }
+    await new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, ['--input-type=module', '--eval', PROBE_SCRIPT, modulePath], {
+            stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true, env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' },
+        });
+        let output = '';
+        let errorOutput = '';
+        let stopped;
+        const stop = (reason) => { stopped = reason; child.kill('SIGKILL'); };
+        const abort = () => stop('模型验证已取消');
+        const timer = setTimeout(() => stop('模型验证超时，请检查 Host 运行时或重新下载模型'), options.timeoutMs ?? 45_000);
+        const cleanup = () => { clearTimeout(timer); options.signal?.removeEventListener('abort', abort); };
+        options.signal?.addEventListener('abort', abort, { once: true });
+        child.stdout.on('data', (chunk) => { output = (output + chunk.toString()).slice(-8192); });
+        child.stderr.on('data', (chunk) => { errorOutput = (errorOutput + chunk.toString()).slice(-8192); });
+        child.once('error', (error) => { cleanup(); reject(new Error(`模型验证进程无法启动：${error.message}`)); });
+        child.once('close', (code, signal) => {
+            cleanup();
+            if (stopped !== undefined) {
+                reject(new Error(stopped));
+                return;
+            }
+            if (code === 0 && output.includes(PROBE_OK)) {
+                resolve();
+                return;
+            }
+            reject(new Error(`模型验证失败：${errorOutput.trim() || `验证进程退出（${signal ?? code}）`}`));
+        });
+        // 原生模块提前退出时管道可能关闭，最终错误由 close 事件统一报告。
+        child.stdin.on('error', () => { });
+        child.stdin.end(JSON.stringify(createSherpaRecognizerConfig(paths)));
+        if (options.signal?.aborted)
+            abort();
+    });
+}
+//# sourceMappingURL=voice-model-probe.js.map

package/data/build/dist/host/features/voice-model-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-model-probe.js","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-probe.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/features/voice-model-setup.d.ts

@@ -1,4 +1,4 @@
-import { type AssistantVoiceModel } from '../../shared/voice-models.js';
+import { type AssistantVoiceModel, type AssistantVoiceModelProgress } from '../../shared/voice-models.js';
 export interface InstalledAssistantVoiceModel {
     readonly model: AssistantVoiceModel;
     readonly paths: Readonly<{
@@ -15,6 +15,9 @@ export interface InstalledAssistantVoiceModel {
  * 所有路径由 Host 生成，客户端只能提交目录 ID，避免把任意 URL 或任意本地
  * 路径带入设置。临时文件下载完成后才改名，进程中断不会留下半个模型。
  */
-export declare function installAssistantVoiceModel(modelId: string): Promise<InstalledAssistantVoiceModel>;
+export declare function installAssistantVoiceModel(modelId: string, onProgress?: (progress: AssistantVoiceModelProgress) => void, options?: {
+    readonly directory?: string;
+    readonly signal?: AbortSignal;
+}): Promise<InstalledAssistantVoiceModel>;
 export declare function voiceModelRoot(): string;
 //# sourceMappingURL=voice-model-setup.d.ts.map

package/data/build/dist/host/features/voice-model-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-model-setup.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAA;AAErC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA2BvG;AAED,wBAAgB,cAAc,IAAI,MAAM,CAGvC"}
+{"version":3,"file":"voice-model-setup.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-model-setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EACjC,MAAM,8BAA8B,CAAA;AAErC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,EAC5D,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC3E,OAAO,CAAC,4BAA4B,CAAC,CAsCvC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAGvC"}

package/data/build/dist/host/features/voice-model-setup.js

@@ -8,25 +8,36 @@ import { findAssistantVoiceModel, } from '../../shared/voice-models.js';
  * 所有路径由 Host 生成，客户端只能提交目录 ID，避免把任意 URL 或任意本地
  * 路径带入设置。临时文件下载完成后才改名，进程中断不会留下半个模型。
  */
-export async function installAssistantVoiceModel(modelId) {
+export async function installAssistantVoiceModel(modelId, onProgress, options = {}) {
     const model = findAssistantVoiceModel(modelId);
     if (model === undefined)
         throw new Error('不支持的实时语音模型');
-    const modelDirectory = join(voiceModelRoot(), model.id);
+    const progress = {
+        modelId, phase: 'checking', fileName: null, fileIndex: 0, fileCount: model.files.length,
+        downloadedBytes: 0, totalBytes: null,
+    };
+    onProgress?.(progress);
+    options.signal?.throwIfAborted();
+    const modelDirectory = options.directory ?? join(voiceModelRoot(), model.id);
     await mkdir(modelDirectory, { recursive: true, mode: 0o700 });
     let downloaded = false;
     const paths = {};
-    for (const file of model.files) {
+    for (const [index, file] of model.files.entries()) {
+        const fileProgress = { ...progress, fileName: file.name, fileIndex: index + 1 };
+        onProgress?.(fileProgress);
         const target = join(modelDirectory, file.name);
         paths[file.setting] = target;
         if (await isNonEmptyFile(target))
             continue;
         downloaded = true;
-        await downloadModelFile(model, file.name, target);
+        await downloadModelFile(model, file.name, target, (downloadedBytes, totalBytes) => {
+            onProgress?.({ ...fileProgress, phase: 'downloading', downloadedBytes, totalBytes });
+        }, options.signal);
     }
     if (paths.asrEncoder === undefined || paths.asrDecoder === undefined || paths.asrJoiner === undefined || paths.asrTokens === undefined) {
         throw new Error('实时语音模型目录不完整');
     }
+    onProgress?.({ ...progress, phase: 'initializing', fileIndex: model.files.length });
     return {
         model,
         paths: {
@@ -42,40 +53,56 @@ export function voiceModelRoot() {
     const dshHome = process.env.DSH_HOME?.trim();
     return join(dshHome === undefined || dshHome === '' ? join(homedir(), '.dsh') : dshHome, 'codingns4dsh', 'voice-models');
 }
-async function downloadModelFile(model, name, target) {
+async function downloadModelFile(model, name, target, onProgress, signal) {
     const url = `https://huggingface.co/${model.repository}/resolve/main/${encodeURIComponent(name)}`;
-    const response = await fetch(url, { redirect: 'follow' });
+    const response = await fetch(url, { redirect: 'follow', ...(signal === undefined ? {} : { signal }) });
     if (!response.ok || response.body === null) {
         throw new Error(`实时语音模型下载失败（${response.status}）：${name}`);
     }
+    // fetch 会自动解压响应；压缩正文的 Content-Length 不能用作模型文件大小。
+    const contentLength = Number(response.headers.get('content-length'));
+    const encoding = response.headers.get('content-encoding');
+    const totalBytes = (encoding === null || encoding === 'identity') && Number.isSafeInteger(contentLength) && contentLength > 0
+        ? contentLength : null;
+    let downloadedBytes = 0;
+    onProgress(0, totalBytes);
     const temporary = `${target}.part`;
     await unlink(temporary).catch(() => undefined);
     const handle = await open(temporary, 'w', 0o600);
+    let complete = false;
     try {
         const reader = response.body.getReader();
         try {
             while (true) {
                 const chunk = await reader.read();
+                signal?.throwIfAborted();
                 if (chunk.done)
                     break;
-                if (chunk.value.byteLength > 0)
-                    await handle.write(chunk.value);
+                if (chunk.value.byteLength === 0)
+                    continue;
+                // writeFile 保证整个分块写入，进度只统计已经落盘的字节。
+                await handle.writeFile(chunk.value);
+                downloadedBytes += chunk.value.byteLength;
+                onProgress(downloadedBytes, totalBytes);
             }
         }
         finally {
             reader.releaseLock();
         }
+        if (downloadedBytes === 0 || (totalBytes !== null && downloadedBytes !== totalBytes)) {
+            throw new Error(`实时语音模型文件下载不完整：${name}`);
+        }
         await handle.sync();
-    }
-    catch (error) {
-        await unlink(temporary).catch(() => undefined);
-        throw error;
+        complete = true;
     }
     finally {
         await handle.close();
+        // Windows 不允许删除仍然打开的文件，因此关闭后再清理失败下载。
+        if (!complete)
+            await unlink(temporary).catch(() => undefined);
     }
-    await unlink(target).catch(() => undefined);
     await rename(temporary, target);
+    onProgress(downloadedBytes, downloadedBytes);
 }
 async function isNonEmptyFile(path) {
     try {

package/data/build/dist/host/features/voice-model-setup.js.map

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

package/data/build/dist/host/features/voice-process-environment.d.ts

@@ -0,0 +1,3 @@
+/** 托管 Python 的环境边界；不继承宿主库路径，管道协议统一使用 UTF-8。 */
+export declare function voiceProcessEnvironment(source?: NodeJS.ProcessEnv, platform?: string): NodeJS.ProcessEnv;
+//# sourceMappingURL=voice-process-environment.d.ts.map

package/data/build/dist/host/features/voice-process-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-process-environment.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-process-environment.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,MAAM,CAAC,UAAwB,EAAE,QAAQ,GAAE,MAAyB,GAAG,MAAM,CAAC,UAAU,CAYvI"}

package/data/build/dist/host/features/voice-process-environment.js

@@ -0,0 +1,16 @@
+/** 托管 Python 的环境边界；不继承宿主库路径，管道协议统一使用 UTF-8。 */
+export function voiceProcessEnvironment(source = process.env, platform = process.platform) {
+    const controlled = {
+        PYTHONNOUSERSITE: '1', PYTHONUTF8: '1', PYTHONIOENCODING: 'utf-8',
+        PIP_NO_INPUT: '1', PIP_REQUIRE_VIRTUALENV: 'true',
+    };
+    const removed = new Set(['PYTHONHOME', 'PYTHONPATH', ...Object.keys(controlled)]);
+    const environment = {};
+    for (const [name, value] of Object.entries(source)) {
+        // Windows 子进程不区分变量名大小写，必须先删除所有变体再写入规范名称。
+        if (!removed.has(platform === 'win32' ? name.toUpperCase() : name))
+            environment[name] = value;
+    }
+    return { ...environment, ...controlled };
+}
+//# sourceMappingURL=voice-process-environment.js.map

package/data/build/dist/host/features/voice-process-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-process-environment.js","sourceRoot":"","sources":["../../../../../src/host/features/voice-process-environment.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,UAAU,uBAAuB,CAAC,SAA4B,OAAO,CAAC,GAAG,EAAE,WAAmB,OAAO,CAAC,QAAQ;IAClH,MAAM,UAAU,GAAsB;QACpC,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO;QACjE,YAAY,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM;KAClD,CAAA;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACjF,MAAM,WAAW,GAAsB,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,yCAAyC;QACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IAC/F,CAAC;IACD,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU,EAAE,CAAA;AAC1C,CAAC"}

package/data/build/dist/host/features/voice-python-runtime.d.ts

@@ -0,0 +1,21 @@
+export type VoiceEnvironmentCommand = (command: string, args: readonly string[], signal: AbortSignal) => Promise<void>;
+export type VoiceEnvironmentProgress = (phase: string, bytes?: number, total?: number | null) => void;
+export interface VoicePythonArtifact {
+    readonly target: string;
+    readonly url: string;
+    readonly sha256: string;
+    readonly executable: string;
+}
+/** 保留原导出名；系统解压器解析规则统一由 tar-archive 提供。 */
+export declare function voicePythonArchiveCommand(platform?: string, environment?: NodeJS.ProcessEnv): string;
+/** 下载源和摘要均固定；无需预装系统 Python，不执行远程安装脚本。 */
+export declare function voicePythonArtifact(platform?: string, arch?: string): VoicePythonArtifact;
+/** 已有专用虚拟环境继续复用；显式环境覆盖保留兼容，默认自动下载独立解释器。 */
+export declare function prepareVoicePython(directory: string, signal: AbortSignal, progress: VoiceEnvironmentProgress): Promise<string>;
+/** 在专属暂存目录验证，再原子提升；失败不留下伪就绪标记，重试能修复坏缓存。 */
+export declare function installVoicePythonRuntime(root: string, artifact: VoicePythonArtifact, signal: AbortSignal, progress: VoiceEnvironmentProgress, run?: VoiceEnvironmentCommand): Promise<string>;
+/** 在下载大型模型前真实导入推理库，提前发现缺失 DLL 或不兼容的二进制依赖。 */
+export declare function verifyVoicePythonDependencies(python: string, signal: AbortSignal, run?: VoiceEnvironmentCommand, platform?: string): Promise<void>;
+/** 所有命令使用参数数组，退出或取消后才结算，防止重置与旧安装进程互相覆盖。 */
+export declare function runVoiceEnvironmentProcess(command: string, args: readonly string[], signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=voice-python-runtime.d.ts.map

package/data/build/dist/host/features/voice-python-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-python-runtime.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/voice-python-runtime.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AACtH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;AACrG,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAE5I,0CAA0C;AAC1C,wBAAgB,yBAAyB,CAAC,QAAQ,GAAE,MAAyB,EAAE,WAAW,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEnI;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,MAAyB,EAAE,IAAI,GAAE,MAAqB,GAAG,mBAAmB,CAczH;AAED,2CAA2C;AAC3C,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAapI;AAED,2CAA2C;AAC3C,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,EAC9G,QAAQ,EAAE,wBAAwB,EAAE,GAAG,GAAE,uBAAoD,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhH;AAED,6CAA6C;AAC7C,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EACrF,GAAG,GAAE,uBAAoD,EAAE,QAAQ,GAAE,MAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/G;AAiCD,2CAA2C;AAC3C,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB7H"}