@jingyi0605/codingns4dsh 0.2.1-beta.3 → 0.2.1-beta.5

package/data/build/dist/host/features/assistant-voice-chat.d.ts

@@ -0,0 +1,35 @@
+import type { AssistantChatRun, AssistantIndexSnapshot } from '../../shared/contracts/assistant.js';
+import { AssistantTextChat } from './assistant-text-chat.js';
+import type { AssistantConversation } from './assistant-conversation.js';
+export interface AssistantVoiceChatContext {
+    readonly index: AssistantIndexSnapshot;
+    readonly provider: string;
+    readonly model: string;
+    readonly prompt: string;
+    readonly isCurrent: () => boolean;
+    readonly createSystem: (index: AssistantIndexSnapshot) => string;
+}
+/** 一份租约拥有一份有界历史；只有完成且仍有效的问答对能进入下一轮。 */
+export declare class AssistantVoiceChat {
+    private readonly chat;
+    private readonly conversation?;
+    private readonly entries;
+    private history;
+    private contextKey;
+    private active;
+    private readonly cancelledRequests;
+    private orderKey;
+    private sequence;
+    constructor(chat: AssistantTextChat, conversation?: AssistantConversation | undefined);
+    /** 只向持有本轮租约的页面发送自己的累计文字，不能泄露其他对话。 */
+    subscribe(ownerId: string, listener: (run: AssistantChatRun, epoch: number) => void): () => void;
+    start(ownerId: string, epoch: number, requestId: string, text: string, context: AssistantVoiceChatContext, sequence?: number): Promise<AssistantChatRun>;
+    read(ownerId: string, epoch: number, requestId: string): AssistantChatRun;
+    wait(ownerId: string, epoch: number, requestId: string): Promise<AssistantChatRun>;
+    cancel(ownerId: string, epoch: number, requestId: string): void;
+    cancelActive(): void;
+    clear(): void;
+    private requireEntry;
+    private commit;
+}
+//# sourceMappingURL=assistant-voice-chat.d.ts.map

package/data/build/dist/host/features/assistant-voice-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-voice-chat.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AACzH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGxE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAA;IACjC,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,MAAM,CAAA;CACjE;AAcD,uCAAuC;AACvC,qBAAa,kBAAkB;IASjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAqB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IARpF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAI;gBAES,IAAI,EAAE,iBAAiB,EAAmB,YAAY,CAAC,EAAE,qBAAqB,YAAA;IAE3G,qCAAqC;IACrC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAO1F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqC9J,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB;IASnE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOxF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAW/D,YAAY,IAAI,IAAI;IAKpB,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,MAAM;CAMf"}

package/data/build/dist/host/features/assistant-voice-chat.js

@@ -0,0 +1,133 @@
+import { AssistantTextChat } from './assistant-text-chat.js';
+import { createAssistantVoiceSystem } from './assistant-prompts.js';
+/** 一份租约拥有一份有界历史；只有完成且仍有效的问答对能进入下一轮。 */
+export class AssistantVoiceChat {
+    chat;
+    conversation;
+    entries = new Map();
+    history = [];
+    contextKey = '';
+    active;
+    cancelledRequests = new Set();
+    orderKey = '';
+    sequence = 0;
+    constructor(chat, conversation) {
+        this.chat = chat;
+        this.conversation = conversation;
+    }
+    /** 只向持有本轮租约的页面发送自己的累计文字，不能泄露其他对话。 */
+    subscribe(ownerId, listener) {
+        return this.chat.subscribe((run) => {
+            const entry = this.entries.get(run.requestId);
+            if (entry?.ownerId === ownerId && entry.context.isCurrent())
+                listener(run, entry.epoch);
+        });
+    }
+    async start(ownerId, epoch, requestId, text, context, sequence) {
+        if (this.cancelledRequests.has(JSON.stringify([ownerId, epoch, requestId])))
+            throw new Error('语音对话已取消');
+        const orderKey = JSON.stringify([ownerId, epoch]);
+        if (orderKey !== this.orderKey) {
+            this.orderKey = orderKey;
+            this.sequence = 0;
+        }
+        const existing = this.entries.get(requestId);
+        if (existing?.start !== undefined) {
+            if (existing.ownerId !== ownerId || existing.epoch !== epoch || existing.text !== text)
+                throw new Error('语音请求标识已被使用，请重新开始本轮对话');
+            if (!existing.context.isCurrent())
+                throw new Error('语音对话索引或配置已变化，请重新说话');
+            return existing.start;
+        }
+        const nextSequence = sequence ?? this.sequence + 1;
+        if (!Number.isSafeInteger(nextSequence) || nextSequence <= this.sequence)
+            throw new Error('语音对话顺序已失效，请重新说话');
+        this.sequence = nextSequence;
+        const key = JSON.stringify([ownerId, context.index.generation, context.index.scope, context.provider, context.model, context.prompt]);
+        if (key !== this.contextKey) {
+            this.clear();
+            this.contextKey = key;
+        }
+        // 上一轮可能刚完成、客户端尚未来得及轮询，先提交完成对再开始追问。
+        if (this.active?.started)
+            this.commit(this.active, this.chat.read(this.active.requestId));
+        this.cancelActive();
+        for (const [id, entry] of this.entries)
+            if (this.entries.size >= 30 && entry !== this.active)
+                this.entries.delete(id);
+        const entry = { ownerId, epoch, requestId, text, context, started: false, cancelled: false, committed: false };
+        this.entries.set(requestId, entry);
+        this.active = entry;
+        // 在模型目录的异步读取之前登记本轮；关闭、清空和新话语都能取消尚未启动的请求。
+        const isCurrent = () => !entry.cancelled && this.active === entry && context.isCurrent();
+        const start = this.conversation === undefined
+            ? this.chat.start({ requestId, provider: context.provider, model: context.model, generation: context.index.generation, messages: [...this.history.slice(-18), { role: 'user', text }] }, context.index, isCurrent, (index) => createAssistantVoiceSystem(context.createSystem(index)))
+            : this.conversation.start(requestId, text, { ...context, isCurrent }, 'voice');
+        entry.start = start
+            .then((run) => {
+            entry.started = true;
+            if (entry.cancelled || !context.isCurrent())
+                return this.chat.cancel(requestId);
+            void this.chat.wait(requestId).then((result) => this.commit(entry, result));
+            return run;
+        });
+        return entry.start;
+    }
+    read(ownerId, epoch, requestId) {
+        const entry = this.requireEntry(ownerId, epoch, requestId);
+        if (!entry.context.isCurrent())
+            this.cancel(ownerId, epoch, requestId);
+        const run = this.chat.read(requestId);
+        if (entry.cancelled)
+            return { ...run, state: 'cancelled', error: '语音对话已停止或索引已变化', finishedAt: Date.now() };
+        this.commit(entry, run);
+        return run;
+    }
+    async wait(ownerId, epoch, requestId) {
+        const entry = this.requireEntry(ownerId, epoch, requestId);
+        await entry.start;
+        const result = await this.chat.wait(requestId);
+        return this.read(ownerId, epoch, result.requestId);
+    }
+    cancel(ownerId, epoch, requestId) {
+        // HTTP 取消可能先于启动到达；保留有界撤销标记，禁止迟到请求重新启动模型。
+        this.cancelledRequests.add(JSON.stringify([ownerId, epoch, requestId]));
+        if (this.cancelledRequests.size > 60)
+            this.cancelledRequests.delete(this.cancelledRequests.values().next().value);
+        const entry = this.entries.get(requestId);
+        if (entry?.ownerId !== ownerId || entry.epoch !== epoch)
+            return;
+        entry.cancelled = true;
+        if (entry.started)
+            this.chat.cancel(requestId);
+        if (this.active === entry)
+            this.active = undefined;
+    }
+    cancelActive() {
+        const entry = this.active;
+        if (entry !== undefined)
+            this.cancel(entry.ownerId, entry.epoch, entry.requestId);
+    }
+    clear() {
+        for (const entry of this.entries.values())
+            this.cancel(entry.ownerId, entry.epoch, entry.requestId);
+        this.entries.clear();
+        this.history = [];
+        this.contextKey = '';
+    }
+    requireEntry(ownerId, epoch, requestId) {
+        const entry = this.entries.get(requestId);
+        if (entry === undefined || entry.ownerId !== ownerId || entry.epoch !== epoch)
+            throw new Error('找不到当前租约的语音对话请求');
+        return entry;
+    }
+    commit(entry, run) {
+        if (this.conversation !== undefined)
+            return;
+        if (run.state !== 'completed' || !run.text.trim() || entry.committed || entry.cancelled || this.active !== entry || !entry.context.isCurrent())
+            return;
+        entry.committed = true;
+        this.history = [...this.history, { role: 'user', text: entry.text }, { role: 'assistant', text: run.text }].slice(-18);
+    }
+}
+//# sourceMappingURL=assistant-voice-chat.js.map

package/data/build/dist/host/features/assistant-voice-chat.js.map

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

package/data/build/dist/host/features/assistant-voice-hotwords.d.ts

@@ -0,0 +1,33 @@
+import type { SessionIndexEntry } from '../../shared/contracts/assistant.js';
+export interface AssistantVoiceHotword {
+    readonly phrase: string;
+    readonly score: number;
+}
+export interface SherpaHotwordConfig {
+    readonly hotwordsFile: string;
+    readonly modelingUnit: 'cjkchar' | 'cjkchar+bpe';
+    readonly bpeVocab?: string;
+    readonly count: number;
+}
+export declare const MAX_ASSISTANT_VOICE_HOTWORDS = 64;
+/** 只收集受管、未归档的元数据；工作区优先，剩余预算按最近活动选会话标题。 */
+export declare function buildAssistantVoiceHotwords(entries: readonly SessionIndexEntry[], managedWorkspaceIds: readonly string[], workspaces?: readonly {
+    readonly workspaceId: string;
+    readonly name: string;
+}[]): readonly AssistantVoiceHotword[];
+/** 远端列表没有及时返回时中止本次取词；不能让可选的名称热词拖住通话启动。 */
+export declare function readAssistantVoiceHotwords(read: (signal: AbortSignal) => Promise<{
+    readonly entries: readonly SessionIndexEntry[];
+    readonly scope: {
+        readonly managedWorkspaceIds: readonly string[];
+    };
+    readonly workspaces?: readonly {
+        readonly workspaceId: string;
+        readonly name: string;
+    }[];
+}>, timeoutMs?: number): Promise<readonly AssistantVoiceHotword[]>;
+/** 原生热词编码可能直接退出进程，先检查词元及 BPE 兼容性，未知字符整条跳过。 */
+export declare function prepareSherpaHotwords(tokensPath: string, words?: readonly AssistantVoiceHotword[], temporaryRoot?: string): Promise<(SherpaHotwordConfig & {
+    dispose(): Promise<void>;
+}) | undefined>;
+//# sourceMappingURL=assistant-voice-hotwords.d.ts.map

package/data/build/dist/host/features/assistant-voice-hotwords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-voice-hotwords.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-hotwords.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAE5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAgB9C,0CAA0C;AAC1C,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EAAE,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACvH,UAAU,GAAE,SAAS;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAO,GAAG,SAAS,qBAAqB,EAAE,CAiBvH;AAED,0CAA0C;AAC1C,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;IACtF,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC9C,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACzF,CAAC,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAU/D;AAmBD,8CAA8C;AAC9C,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,qBAAqB,EAAoB,EACvH,aAAa,SAAW,GAAG,OAAO,CAAC,CAAC,mBAAmB,GAAG;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC,CA6BrG"}

package/data/build/dist/host/features/assistant-voice-hotwords.js

@@ -0,0 +1,114 @@
+import { existsSync } from 'node:fs';
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+export const MAX_ASSISTANT_VOICE_HOTWORDS = 64;
+const MAX_PHRASE_LENGTH = 40;
+// 单个同音术语的权重低于完整短语，避免闲聊中的“绘画”被强行推向“会话”。
+const DOMAIN_HOTWORDS = [
+    { phrase: '工作区', score: 1.0 }, { phrase: '会话', score: 0.25 },
+    { phrase: '绘画', score: 1.0 },
+    { phrase: '会话列表', score: 1.2 }, { phrase: '当前会话', score: 1.2 },
+    { phrase: '工作区会话', score: 1.2 }, { phrase: '会话标题', score: 1.2 },
+    { phrase: '工作区的会话', score: 1.2 }, { phrase: '有哪些会话', score: 1.2 },
+    { phrase: '这个会话', score: 1.2 }, { phrase: '会话现在', score: 1.2 },
+    { phrase: '会话的运行状态', score: 1.2 },
+    // 同时给真实绘画语境提供完整短语，防止仅有业务侧词表压过另一种合法含义。
+    { phrase: '学绘画', score: 0.8 }, { phrase: '学习绘画', score: 0.8 },
+    { phrase: '绘画的颜色', score: 0.8 }, { phrase: '绘画作品', score: 0.8 },
+];
+/** 只收集受管、未归档的元数据；工作区优先，剩余预算按最近活动选会话标题。 */
+export function buildAssistantVoiceHotwords(entries, managedWorkspaceIds, workspaces = []) {
+    const managed = new Set(managedWorkspaceIds);
+    const included = entries.filter((entry) => managed.has(entry.workspaceId) && entry.archived !== true)
+        .sort((left, right) => (right.updatedAt ?? 0) - (left.updatedAt ?? 0) || left.sessionId.localeCompare(right.sessionId));
+    const candidates = [...DOMAIN_HOTWORDS,
+        ...workspaces.filter((entry) => managed.has(entry.workspaceId)).map((entry) => ({ phrase: entry.name, score: 0.8 })),
+        ...included.map((entry) => ({ phrase: entry.workspaceName, score: 0.8 })),
+        ...included.map((entry) => ({ phrase: entry.title ?? '', score: 0.8 })),
+    ];
+    const selected = new Map();
+    for (const candidate of candidates) {
+        const phrase = normalizeHotword(candidate.phrase);
+        if (phrase === null || selected.has(phrase))
+            continue;
+        selected.set(phrase, { ...candidate, phrase });
+        if (selected.size === MAX_ASSISTANT_VOICE_HOTWORDS)
+            break;
+    }
+    return [...selected.values()];
+}
+/** 远端列表没有及时返回时中止本次取词；不能让可选的名称热词拖住通话启动。 */
+export async function readAssistantVoiceHotwords(read, timeoutMs = 1500) {
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => { controller.abort(); reject(new Error('语音热词元数据读取超时')); }, timeoutMs);
+    });
+    try {
+        const source = await Promise.race([read(controller.signal), timeout]);
+        return buildAssistantVoiceHotwords(source.entries, source.scope.managedWorkspaceIds, source.workspaces);
+    }
+    finally {
+        clearTimeout(timer);
+        controller.abort();
+    }
+}
+/** 去掉热词协议控制符；长标题整体跳过，不截断成可能指向其他会话的短词。 */
+function normalizeHotword(value) {
+    const phrase = value.normalize('NFKC').replace(/[^\p{Script=Han}A-Za-z0-9]+/gu, ' ').trim().replace(/\s+/gu, ' ').toUpperCase();
+    return phrase.length >= 2 && phrase.length <= MAX_PHRASE_LENGTH ? phrase : null;
+}
+/** 找到源码或 npm 包的资源根；不依赖进程 cwd，也不读取用户 Profile。 */
+function findBpeVocabulary() {
+    let directory = dirname(fileURLToPath(import.meta.url));
+    for (let depth = 0; depth < 7; depth++) {
+        const candidate = join(directory, 'assets', 'voice', 'bilingual-zh-en-bpe.vocab');
+        if (existsSync(candidate))
+            return candidate;
+        directory = dirname(directory);
+    }
+    return undefined;
+}
+/** 原生热词编码可能直接退出进程，先检查词元及 BPE 兼容性，未知字符整条跳过。 */
+export async function prepareSherpaHotwords(tokensPath, words = DOMAIN_HOTWORDS, temporaryRoot = tmpdir()) {
+    const text = await readFile(tokensPath, 'utf8');
+    const tokens = new Set(text.split(/\r?\n/u).flatMap((line) => {
+        const match = /^(\S+)\s+\d+\s*$/u.exec(line);
+        return match?.[1] === undefined ? [] : [match[1]];
+    }));
+    const vocabulary = findBpeVocabulary();
+    const bpePieces = vocabulary === undefined ? [] : (await readFile(vocabulary, 'utf8')).split(/\r?\n/u)
+        // 只校验归一化名称能生成的字母词元；原始词表中的引号／连字符不会进入热词。
+        .map((line) => line.split(/\s/u)[0]).filter((piece) => /^[▁A-Z]+$/u.test(piece));
+    const bilingual = bpePieces.length > 0 && bpePieces.every((piece) => tokens.has(piece));
+    const selected = new Map();
+    for (const word of words) {
+        const phrase = normalizeHotword(word.phrase);
+        if (phrase === null || !Number.isFinite(word.score) || word.score <= 0 || word.score > 2)
+            continue;
+        if (/[A-Z]/u.test(phrase) && !bilingual)
+            continue;
+        if ([...phrase].some((char) => char !== ' ' && !(/[A-Z]/u.test(char) && bilingual) && !tokens.has(char)))
+            continue;
+        selected.set(phrase, word.score);
+        if (selected.size === MAX_ASSISTANT_VOICE_HOTWORDS)
+            break;
+    }
+    if (selected.size === 0)
+        return undefined;
+    const directory = await mkdtemp(join(temporaryRoot, 'codingns-voice-hotwords-'));
+    const dispose = () => rm(directory, { recursive: true, force: true });
+    try {
+        const hotwordsFile = join(directory, 'hotwords.txt');
+        await writeFile(hotwordsFile, [...selected].map(([phrase, score]) => `${phrase} :${score}`).join('\n') + '\n', { mode: 0o600 });
+        return { hotwordsFile, count: selected.size, modelingUnit: bilingual ? 'cjkchar+bpe' : 'cjkchar',
+            ...(bilingual ? { bpeVocab: vocabulary } : {}), dispose };
+    }
+    catch (error) {
+        await dispose();
+        throw error;
+    }
+}
+//# sourceMappingURL=assistant-voice-hotwords.js.map

package/data/build/dist/host/features/assistant-voice-hotwords.js.map

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

package/data/build/dist/host/features/assistant-voice-initialization.d.ts

@@ -0,0 +1,26 @@
+import type { AssistantTtsSnapshot } from '../../shared/assistant-tts.js';
+import { type AssistantVoiceInitializationSnapshot } from '../../shared/voice-initialization.js';
+import { type AssistantVoiceModelProgress, type AssistantVoiceModelsSnapshot } from '../../shared/voice-models.js';
+interface VoiceInitializationServices {
+    readonly readModels: () => Promise<AssistantVoiceModelsSnapshot>;
+    readonly readTts: () => Promise<AssistantTtsSnapshot>;
+    readonly prepareModel: (modelId: string) => Promise<unknown>;
+    readonly prepareTts: () => Promise<unknown>;
+    readonly selectTts: (id: string) => Promise<unknown>;
+    readonly modelProgress: () => AssistantVoiceModelProgress | null;
+    readonly active: () => boolean;
+}
+/** 首次配置只负责资源准备；已有识别选择、音色、参数和导入资料均由原服务保管。 */
+export declare class AssistantVoiceInitialization {
+    private readonly services;
+    private pending;
+    private phase;
+    private error;
+    constructor(services: VoiceInitializationServices);
+    get busy(): boolean;
+    reset(): void;
+    snapshot(): Promise<AssistantVoiceInitializationSnapshot>;
+    initialize(signal: AbortSignal): Promise<AssistantVoiceInitializationSnapshot>;
+}
+export {};
+//# sourceMappingURL=assistant-voice-initialization.d.ts.map

package/data/build/dist/host/features/assistant-voice-initialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-voice-initialization.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-initialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,EAA0B,KAAK,oCAAoC,EAAiC,MAAM,sCAAsC,CAAA;AACvJ,OAAO,EAA2B,KAAK,2BAA2B,EAAE,KAAK,4BAA4B,EAAE,MAAM,8BAA8B,CAAA;AAE3I,UAAU,2BAA2B;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAA;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACrD,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,QAAQ,CAAC,aAAa,EAAE,MAAM,2BAA2B,GAAG,IAAI,CAAA;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;CAC/B;AAED,4CAA4C;AAC5C,qBAAa,4BAA4B;IAI3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,KAAK,CAAsB;gBACN,QAAQ,EAAE,2BAA2B;IAClE,IAAI,IAAI,IAAI,OAAO,CAAwB;IAC3C,KAAK,IAAI,IAAI;IAEP,QAAQ,IAAI,OAAO,CAAC,oCAAoC,CAAC;IAezD,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,oCAAoC,CAAC;CA4BrF"}

package/data/build/dist/host/features/assistant-voice-initialization.js

@@ -0,0 +1,68 @@
+import { DEFAULT_VOICE_MODEL_ID } from '../../shared/voice-initialization.js';
+import { findAssistantVoiceModel } from '../../shared/voice-models.js';
+/** 首次配置只负责资源准备；已有识别选择、音色、参数和导入资料均由原服务保管。 */
+export class AssistantVoiceInitialization {
+    services;
+    pending = false;
+    phase = 'idle';
+    error = null;
+    constructor(services) {
+        this.services = services;
+    }
+    get busy() { return this.pending; }
+    reset() { this.phase = 'idle'; this.error = null; }
+    async snapshot() {
+        const [models, tts] = await Promise.all([this.services.readModels(), this.services.readTts()]);
+        const selected = models.models.find((model) => model.current);
+        const modelId = models.currentModelId ?? DEFAULT_VOICE_MODEL_ID;
+        const recognitionReady = selected?.state === 'downloaded' && selected.validation.state === 'passed';
+        const progress = this.services.modelProgress();
+        const downloadingSpeech = this.phase === 'speech' || tts.status.busy;
+        return { ready: recognitionReady && tts.status.ready && tts.settings.backend === 'moss-onnx',
+            busy: this.pending || models.operation !== null || tts.status.busy, phase: this.phase,
+            recognitionReady, modelId, modelLabel: findAssistantVoiceModel(modelId)?.label ?? modelId, tts,
+            progress: downloadingSpeech ? { label: tts.status.phase, downloadedBytes: tts.status.downloadedBytes, totalBytes: tts.status.totalBytes }
+                : this.pending && progress !== null ? { label: progress.phase, downloadedBytes: progress.downloadedBytes, totalBytes: progress.totalBytes } : null,
+            error: this.error ?? tts.status.error };
+    }
+    async initialize(signal) {
+        if (this.pending)
+            throw new Error('语音初始化正在进行，请等待完成');
+        if (this.services.active())
+            throw new Error('请先停止实时语音，再进行初次配置');
+        this.pending = true;
+        this.error = null;
+        try {
+            signal.throwIfAborted();
+            this.phase = 'recognition';
+            const current = await this.snapshot();
+            // 自定义目录 ID 不应被中英双语默认值静默覆盖，保留高级模型管理的处理边界。
+            if (!current.recognitionReady) {
+                if (findAssistantVoiceModel(current.modelId) === undefined)
+                    throw new Error('当前为自定义识别模型，请在高级模型管理中验证配置');
+                await this.services.prepareModel(current.modelId);
+            }
+            signal.throwIfAborted();
+            this.phase = 'speech';
+            const tts = await this.services.readTts();
+            if (!tts.status.ready)
+                await this.services.prepareTts();
+            signal.throwIfAborted();
+            const prepared = await this.services.readTts();
+            if (prepared.settings.backend !== 'moss-onnx')
+                await this.services.selectTts(prepared.settings.selectedId);
+            signal.throwIfAborted();
+            this.phase = 'completed';
+        }
+        catch (error) {
+            this.phase = 'failed';
+            this.error = error instanceof Error ? error.message : String(error);
+            throw error;
+        }
+        finally {
+            this.pending = false;
+        }
+        return this.snapshot();
+    }
+}
+//# sourceMappingURL=assistant-voice-initialization.js.map

package/data/build/dist/host/features/assistant-voice-initialization.js.map

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

package/data/build/dist/host/features/assistant-voice-sources.d.ts

@@ -0,0 +1,13 @@
+import type { AssistantTtsVoice } from '../../shared/assistant-tts.js';
+export interface ResolvedVoiceSource {
+    readonly id: string;
+    readonly path: string;
+    readonly repository: 'kyutai/tts-voices' | 'AISHELL/AISHELL-3';
+    readonly url: string;
+    readonly license: string;
+    readonly language: string;
+}
+/** 只解析已知开放录音库；文件链接和 ID 归一化后产生相同的缓存键。 */
+export declare function resolveAssistantVoiceSource(input: string): ResolvedVoiceSource;
+export declare function sourceVoice(source: ResolvedVoiceSource, fields: Record<string, unknown>): AssistantTtsVoice;
+//# sourceMappingURL=assistant-voice-sources.d.ts.map

package/data/build/dist/host/features/assistant-voice-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-voice-sources.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,mBAAmB,CAAA;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,wCAAwC;AACxC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAwC9E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAM3G"}

package/data/build/dist/host/features/assistant-voice-sources.js

@@ -0,0 +1,72 @@
+import { createHash } from 'node:crypto';
+/** 只解析已知开放录音库；文件链接和 ID 归一化后产生相同的缓存键。 */
+export function resolveAssistantVoiceSource(input) {
+    const value = input.trim();
+    if (value.length === 0 || value.length > 2048)
+        throw new Error('请填写完整录音 ID 或音频文件网址');
+    let repository = 'kyutai/tts-voices';
+    let path = value.replace(/^kyutai:/u, '');
+    if (value.startsWith('aishell:') || /^SSB\d{8}(?:\.wav)?$/u.test(value)) {
+        const id = value.replace(/^aishell:/u, '').replace(/\.wav$/u, '');
+        if (!/^SSB\d{8}$/u.test(id))
+            throw new Error('AISHELL-3 需要完整录音 ID，例如 SSB00050001');
+        repository = 'AISHELL/AISHELL-3';
+        path = `train/wav/${id.slice(0, 7)}/${id}.wav`;
+    }
+    else if (value.startsWith('hf://')) {
+        const prefix = 'hf://kyutai/tts-voices/';
+        if (!value.startsWith(prefix))
+            throw new Error('不支持的 Hugging Face 录音仓库');
+        path = value.slice(prefix.length);
+    }
+    else if (/^https?:/u.test(value)) {
+        const url = new URL(value);
+        if (url.protocol !== 'https:' || url.hostname !== 'huggingface.co' || url.port || url.username || url.password)
+            throw new Error('请使用受支持的 Hugging Face 音频文件网址');
+        const parts = url.pathname.split('/').filter(Boolean).map((part) => decodeURIComponent(part));
+        if (parts[0] === 'datasets')
+            parts.shift();
+        const name = parts.slice(0, 2).join('/');
+        if (name !== 'kyutai/tts-voices' && name !== 'AISHELL/AISHELL-3')
+            throw new Error('该网址不属于受支持的开放录音库');
+        if (!['resolve', 'blob', 'raw'].includes(parts[2] ?? '') || parts[3] !== 'main')
+            throw new Error('请填写 main 分支中单个音频文件的链接');
+        repository = name;
+        path = parts.slice(4).join('/');
+    }
+    if (!/^[A-Za-z0-9_./@-]+\.(?:wav|flac)$/u.test(path) || path.split('/').some((part) => part === '.' || part === '..' || part === ''))
+        throw new Error('需要 WAV 或 FLAC 参考录音，不能使用网页或音色嵌入文件');
+    let license;
+    let language = 'unknown';
+    if (repository === 'AISHELL/AISHELL-3') {
+        if (!/^(?:train|test)\/wav\/SSB\d{4}\/SSB\d{8}\.wav$/u.test(path) || path.split('/')[2] !== path.split('/')[3]?.slice(0, 7))
+            throw new Error('AISHELL-3 录音路径无效');
+        license = 'Apache-2.0';
+        language = 'zh';
+    }
+    else {
+        const directory = path.split('/')[0];
+        if (directory === 'voice-donations' || directory === 'voice-zero')
+            license = 'CC0-1.0';
+        else if (directory === 'vctk' || directory === 'alba-mackenna' || path.startsWith('cml-tts/fr/'))
+            license = 'CC-BY-4.0';
+        else
+            throw new Error('该目录许可不适合默认开放音色导入；请选择 voice-donations、voice-zero、vctk、alba-mackenna 或 cml-tts/fr');
+        if (directory === 'vctk' || directory === 'voice-zero' || directory === 'alba-mackenna')
+            language = 'en';
+        if (path.startsWith('cml-tts/fr/'))
+            language = 'fr';
+    }
+    const root = repository === 'AISHELL/AISHELL-3' ? 'datasets/' : '';
+    const url = `https://huggingface.co/${root}${repository}/resolve/main/${path.split('/').map(encodeURIComponent).join('/')}`;
+    return { id: `ref-${createHash('sha256').update(`${repository}/${path}`).digest('hex')}`, repository, path, url, license, language };
+}
+export function sourceVoice(source, fields) {
+    const name = typeof fields.name === 'string' && fields.name.trim() !== '' ? fields.name.trim() : source.path.split('/').at(-1).replace(/\.(?:wav|flac)$/u, '');
+    const language = typeof fields.language === 'string' && /^[a-z]{2}(?:-[A-Z]{2})?$/u.test(fields.language) ? fields.language : source.language;
+    const gender = fields.gender === 'male' || fields.gender === 'female' ? fields.gender : 'unknown';
+    if (name.length > 80)
+        throw new Error('音色名称不能超过 80 个字符');
+    return { id: source.id, name, language, gender, kind: 'reference', reference: source.id, source: source.url, license: source.license };
+}
+//# sourceMappingURL=assistant-voice-sources.js.map

package/data/build/dist/host/features/assistant-voice-sources.js.map

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

package/data/build/dist/host/features/assistant-voice-stream.d.ts

@@ -1,7 +1,17 @@
 import type { GlobalVoiceCoordinator } from './global-voice-coordinator.js';
+import type { HostConnectionFetch } from '@deepseek-ai/dsh-client-connection';
+import type { AssistantVoiceChat } from './assistant-voice-chat.js';
 export interface AssistantVoiceStreamOptions {
     readonly coordinator: GlobalVoiceCoordinator;
+    readonly tts?: (request: Request) => Promise<Response>;
+    readonly chat?: AssistantVoiceChat;
 }
+/**
+ * DSH 的 requestBody 是路由级配置。GET 必须单独登记为 buffered，
+ * 否则原生 HTTP 桥会给 GET 附加 ReadableStream 正文，被 Node 拒绝为 400。
+ * buffered 只约束请求读取，不影响事件响应持续下发。
+ */
+export declare function registerAssistantVoiceStreamRoutes(registry: HostConnectionFetch, handler: (request: Request) => Promise<Response>): () => Promise<void>;
 /**
  * Host 的流式入口只转发 PCM 和运行时事件，不把音频字节塞进 JSON RPC。
  * 浏览器通过同源 HTTPS 访问此路由，因而麦克风权限属于真正打开页面的客户端。

package/data/build/dist/host/features/assistant-voice-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-voice-stream.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAI3E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAA;CAC7C;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,2BAA2B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA+E/H"}
+{"version":3,"file":"assistant-voice-stream.d.ts","sourceRoot":"","sources":["../../../../../src/host/features/assistant-voice-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAM7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAGnE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAA;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAMvJ;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,2BAA2B,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAqF/H"}