@jingyi0605/codingns4dsh 0.2.0-rc.3 → 0.2.1-beta.1

package/data/build/dist/client/voice-capture.js

@@ -0,0 +1,158 @@
+import { inspectBrowserVoiceSecurity } from './voice-security.js';
+import { BrowserVoiceDeviceManager } from './voice-device-manager.js';
+/** 浏览器端实时 PCM 采集器；设备权限始终由 Client 自己持有。 */
+export class ClientVoiceCapture {
+    options;
+    stream;
+    context;
+    source;
+    processor;
+    output;
+    workletUrl;
+    sequence = 0;
+    started = false;
+    inputRate = 16_000;
+    constructor(options) { this.options = options; }
+    get isStarted() { return this.started; }
+    async start() {
+        if (this.started)
+            return;
+        const security = inspectBrowserVoiceSecurity();
+        if (!security.secure)
+            throw new Error('当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风');
+        const mediaDevices = globalThis.navigator?.mediaDevices;
+        if (mediaDevices === undefined || typeof mediaDevices.getUserMedia !== 'function')
+            throw new Error('当前浏览器不支持 getUserMedia');
+        const permission = await this.options.devices.requestInputPermission();
+        const selected = permission.selectedInputId;
+        const constraints = {
+            audio: selected === null ? { channelCount: 1, echoCancellation: true, noiseSuppression: true, autoGainControl: true } : {
+                deviceId: { exact: selected },
+                channelCount: 1,
+                echoCancellation: true,
+                noiseSuppression: true,
+                autoGainControl: true,
+            },
+            video: false,
+        };
+        const stream = await mediaDevices.getUserMedia(constraints);
+        this.stream = stream;
+        try {
+            const Context = globalThis.AudioContext
+                ?? globalThis.webkitAudioContext;
+            if (Context === undefined)
+                throw new Error('当前浏览器不支持 AudioContext');
+            const context = new Context({ sampleRate: this.options.targetSampleRate ?? 16_000 });
+            this.context = context;
+            this.inputRate = context.sampleRate;
+            await context.resume();
+            this.source = context.createMediaStreamSource(stream);
+            this.output = context.createGain();
+            this.output.gain.value = 0;
+            this.output.connect(context.destination);
+            this.sequence = 0;
+            if (context.audioWorklet !== undefined && typeof AudioWorkletNode === 'function')
+                await this.startWorklet(context);
+            else
+                this.startScriptProcessor(context);
+            this.started = true;
+            for (const track of stream.getAudioTracks())
+                track.addEventListener('ended', this.handleEnded, { once: true });
+        }
+        catch (error) {
+            await this.stop();
+            throw error;
+        }
+    }
+    async stop() {
+        const stream = this.stream;
+        const processor = this.processor;
+        this.started = false;
+        this.stream = undefined;
+        this.processor = undefined;
+        this.source?.disconnect();
+        this.source = undefined;
+        processor?.disconnect();
+        this.output?.disconnect();
+        this.output = undefined;
+        if (this.context !== undefined && this.context.state !== 'closed')
+            await this.context.close();
+        this.context = undefined;
+        if (this.workletUrl !== undefined)
+            URL.revokeObjectURL(this.workletUrl);
+        this.workletUrl = undefined;
+        for (const track of stream?.getTracks() ?? []) {
+            track.removeEventListener('ended', this.handleEnded);
+            try {
+                track.stop();
+            }
+            catch { /* 轨道可能已由浏览器停止 */ }
+        }
+    }
+    async startWorklet(context) {
+        const source = this.source;
+        const output = this.output;
+        if (source === undefined || output === undefined || context.audioWorklet === undefined)
+            throw new Error('音频采集图未初始化');
+        const sourceText = `class CodingNsVoiceProcessor extends AudioWorkletProcessor { process(inputs) { const input = inputs[0] && inputs[0][0]; if (input) this.port.postMessage(new Float32Array(input)); return true; } } registerProcessor('codingns-voice-capture', CodingNsVoiceProcessor);`;
+        const blob = new Blob([sourceText], { type: 'application/javascript' });
+        this.workletUrl = URL.createObjectURL(blob);
+        await context.audioWorklet.addModule(this.workletUrl);
+        const node = new AudioWorkletNode(context, 'codingns-voice-capture', { numberOfInputs: 1, numberOfOutputs: 1, outputChannelCount: [1] });
+        node.port.onmessage = (event) => {
+            if (!this.started && this.context !== context)
+                return;
+            const samples = event.data instanceof Float32Array ? event.data : new Float32Array(event.data);
+            this.emitSamples(samples);
+        };
+        source.connect(node);
+        node.connect(output);
+        this.processor = node;
+    }
+    startScriptProcessor(context) {
+        const source = this.source;
+        const output = this.output;
+        if (source === undefined || output === undefined)
+            throw new Error('音频采集图未初始化');
+        const node = context.createScriptProcessor(1024, 1, 1);
+        node.onaudioprocess = (event) => this.emitSamples(event.inputBuffer.getChannelData(0));
+        source.connect(node);
+        node.connect(output);
+        this.processor = node;
+    }
+    handleEnded = () => {
+        if (!this.started)
+            return;
+        this.options.onEnded?.(new Error('麦克风轨道已结束'));
+        void this.stop();
+    };
+    emitSamples(samples) {
+        if (!this.started)
+            return;
+        const bytes = resampleFloat32ToPcm16(samples, this.inputRate, this.options.targetSampleRate ?? 16_000);
+        if (bytes.byteLength === 0)
+            return;
+        const frame = { sequence: ++this.sequence, bytes, sampleRate: this.options.targetSampleRate ?? 16_000, channels: 1 };
+        void Promise.resolve(this.options.onFrame(frame)).catch((error) => this.options.onEnded?.(error instanceof Error ? error : new Error(String(error))));
+    }
+}
+/** 无依赖的线性重采样，适合语音 16 kHz 采集；整段音频不会进入内存。 */
+export function resampleFloat32ToPcm16(samples, inputRate, outputRate) {
+    if (samples.length === 0)
+        return new Uint8Array();
+    if (!Number.isFinite(inputRate) || inputRate <= 0 || !Number.isFinite(outputRate) || outputRate <= 0)
+        throw new RangeError('采样率必须为正数');
+    const outputLength = Math.max(1, Math.round(samples.length * outputRate / inputRate));
+    const bytes = new Uint8Array(outputLength * 2);
+    const view = new DataView(bytes.buffer);
+    for (let index = 0; index < outputLength; index += 1) {
+        const sourcePosition = index * inputRate / outputRate;
+        const left = Math.min(samples.length - 1, Math.floor(sourcePosition));
+        const right = Math.min(samples.length - 1, left + 1);
+        const fraction = sourcePosition - left;
+        const sample = Math.max(-1, Math.min(1, (samples[left] ?? 0) * (1 - fraction) + (samples[right] ?? 0) * fraction));
+        view.setInt16(index * 2, Math.round(sample * (sample < 0 ? 32_768 : 32_767)), true);
+    }
+    return bytes;
+}
+//# sourceMappingURL=voice-capture.js.map

package/data/build/dist/client/voice-capture.js.map

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

package/data/build/dist/client/voice-device-manager.d.ts

@@ -0,0 +1,24 @@
+import type { VoiceClientDeviceManager, VoiceClientDeviceSnapshot } from '../shared/contracts/voice-runtime.js';
+/**
+ * 浏览器 Client 的设备管理器。
+ *
+ * 设备权限、设备 ID 和设备变化都属于当前浏览器来源；Host 只会收到选择后的
+ * PCM 数据，不会接触这里的真实硬件清单。
+ */
+export declare class BrowserVoiceDeviceManager implements VoiceClientDeviceManager {
+    private readonly listeners;
+    private current;
+    private readonly deviceChangeDispose;
+    private disposed;
+    constructor();
+    snapshot(): VoiceClientDeviceSnapshot;
+    subscribe(listener: (snapshot: VoiceClientDeviceSnapshot) => void): () => void;
+    refresh(): Promise<VoiceClientDeviceSnapshot>;
+    requestInputPermission(): Promise<VoiceClientDeviceSnapshot>;
+    selectInput(deviceId: string): Promise<VoiceClientDeviceSnapshot>;
+    selectOutput(deviceId: string): Promise<VoiceClientDeviceSnapshot>;
+    dispose(): void;
+    private refreshPermission;
+    private update;
+}
+//# sourceMappingURL=voice-device-manager.d.ts.map

package/data/build/dist/client/voice-device-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-device-manager.d.ts","sourceRoot":"","sources":["../../../../src/client/voice-device-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,sCAAsC,CAAA;AAM7C;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,wBAAwB;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;IACrF,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0B;IAC9D,OAAO,CAAC,QAAQ,CAAQ;;IAqBxB,QAAQ,IAAI,yBAAyB;IAErC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,yBAAyB,KAAK,IAAI,GAAG,MAAM,IAAI;IAMxE,OAAO,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAwB7C,sBAAsB,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAyB5D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAYjE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAYxE,OAAO,IAAI,IAAI;YAOD,iBAAiB;IAW/B,OAAO,CAAC,MAAM;CAOf"}

package/data/build/dist/client/voice-device-manager.js

@@ -0,0 +1,197 @@
+import { inspectBrowserVoiceSecurity } from './voice-security.js';
+const INPUT_KEY = 'codingns4dsh.voice.input-device';
+const OUTPUT_KEY = 'codingns4dsh.voice.output-device';
+/**
+ * 浏览器 Client 的设备管理器。
+ *
+ * 设备权限、设备 ID 和设备变化都属于当前浏览器来源；Host 只会收到选择后的
+ * PCM 数据，不会接触这里的真实硬件清单。
+ */
+export class BrowserVoiceDeviceManager {
+    listeners = new Set();
+    current;
+    deviceChangeDispose;
+    disposed = false;
+    constructor() {
+        const security = inspectBrowserVoiceSecurity();
+        this.current = {
+            secureContext: security.secure,
+            permission: 'unknown',
+            inputs: [],
+            outputs: [],
+            selectedInputId: readStorage(INPUT_KEY),
+            selectedOutputId: readStorage(OUTPUT_KEY),
+        };
+        const mediaDevices = globalThis.navigator?.mediaDevices;
+        if (mediaDevices !== undefined && typeof mediaDevices.addEventListener === 'function') {
+            const onDeviceChange = () => { void this.refresh(); };
+            mediaDevices.addEventListener('devicechange', onDeviceChange);
+            this.deviceChangeDispose = () => mediaDevices.removeEventListener('devicechange', onDeviceChange);
+        }
+        else
+            this.deviceChangeDispose = undefined;
+    }
+    snapshot() { return cloneSnapshot(this.current); }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot());
+        return () => this.listeners.delete(listener);
+    }
+    async refresh() {
+        if (this.disposed)
+            return this.snapshot();
+        const security = inspectBrowserVoiceSecurity();
+        const mediaDevices = globalThis.navigator?.mediaDevices;
+        if (!security.secure || mediaDevices === undefined || typeof mediaDevices.enumerateDevices !== 'function') {
+            this.update({ secureContext: security.secure, inputs: [], outputs: [] });
+            return this.snapshot();
+        }
+        const devices = await mediaDevices.enumerateDevices();
+        const inputs = devices.filter((device) => device.kind === 'audioinput').map(toDevice('audioinput'));
+        const outputs = devices.filter((device) => device.kind === 'audiooutput').map(toDevice('audiooutput'));
+        const selectedInputId = this.current.selectedInputId !== null && inputs.some((device) => device.deviceId === this.current.selectedInputId)
+            ? this.current.selectedInputId
+            : null;
+        const selectedOutputId = this.current.selectedOutputId !== null && outputs.some((device) => device.deviceId === this.current.selectedOutputId)
+            ? this.current.selectedOutputId
+            : null;
+        if (selectedInputId === null)
+            removeStorage(INPUT_KEY);
+        if (selectedOutputId === null)
+            removeStorage(OUTPUT_KEY);
+        this.update({ inputs, outputs, selectedInputId, selectedOutputId });
+        await this.refreshPermission();
+        return this.snapshot();
+    }
+    async requestInputPermission() {
+        if (this.disposed)
+            throw new Error('语音设备管理器已释放');
+        const security = inspectBrowserVoiceSecurity();
+        if (!security.secure)
+            throw new Error('当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风');
+        const mediaDevices = globalThis.navigator?.mediaDevices;
+        if (mediaDevices === undefined || typeof mediaDevices.getUserMedia !== 'function')
+            throw new Error('当前浏览器不支持 getUserMedia');
+        const selected = this.current.selectedInputId;
+        let stream;
+        try {
+            stream = await mediaDevices.getUserMedia({ audio: buildInputConstraints(selected), video: false });
+        }
+        catch (error) {
+            // 浏览器会在麦克风被拔出、蓝牙设备重建或权限数据变化后保留旧 deviceId。
+            // 这时继续使用 exact 约束只会得到 “Requested device not found”，应清掉
+            // 失效偏好并回退到系统默认麦克风，让首次点击仍能完成初始化。
+            if (selected === null || !isMissingInputDeviceError(error))
+                throw error;
+            removeStorage(INPUT_KEY);
+            this.update({ selectedInputId: null });
+            stream = await mediaDevices.getUserMedia({ audio: buildInputConstraints(null), video: false });
+        }
+        for (const track of stream.getTracks())
+            track.stop();
+        await this.refresh();
+        this.update({ permission: 'granted' });
+        return this.snapshot();
+    }
+    async selectInput(deviceId) {
+        const value = deviceId.trim();
+        if (value !== '' && !this.current.inputs.some((device) => device.deviceId === value)) {
+            await this.refresh();
+            if (!this.current.inputs.some((device) => device.deviceId === value))
+                throw new Error('选择的麦克风设备不存在');
+        }
+        if (value === '')
+            removeStorage(INPUT_KEY);
+        else
+            writeStorage(INPUT_KEY, value);
+        this.update({ selectedInputId: value === '' ? null : value });
+        return this.snapshot();
+    }
+    async selectOutput(deviceId) {
+        const value = deviceId.trim();
+        if (value !== '' && !this.current.outputs.some((device) => device.deviceId === value)) {
+            await this.refresh();
+            if (!this.current.outputs.some((device) => device.deviceId === value))
+                throw new Error('选择的播放设备不存在');
+        }
+        if (value === '')
+            removeStorage(OUTPUT_KEY);
+        else
+            writeStorage(OUTPUT_KEY, value);
+        this.update({ selectedOutputId: value === '' ? null : value });
+        return this.snapshot();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.deviceChangeDispose?.();
+        this.listeners.clear();
+    }
+    async refreshPermission() {
+        const permissions = globalThis.navigator?.permissions;
+        if (permissions === undefined || typeof permissions.query !== 'function')
+            return;
+        try {
+            const status = await permissions.query({ name: 'microphone' });
+            this.update({ permission: status.state === 'granted' || status.state === 'denied' ? status.state : 'prompt' });
+        }
+        catch {
+            // 某些浏览器不暴露 microphone 权限查询，不能因此阻断 getUserMedia。
+        }
+    }
+    update(patch) {
+        this.current = { ...this.current, ...patch };
+        const snapshot = this.snapshot();
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(snapshot);
+            }
+            catch { /* 单个 UI 订阅者异常不能破坏设备生命周期 */ }
+        }
+    }
+}
+function buildInputConstraints(selectedInputId) {
+    return selectedInputId === null
+        ? { echoCancellation: true, noiseSuppression: true, autoGainControl: true }
+        : {
+            deviceId: { exact: selectedInputId },
+            echoCancellation: true,
+            noiseSuppression: true,
+            autoGainControl: true,
+        };
+}
+function isMissingInputDeviceError(error) {
+    if (typeof error !== 'object' || error === null)
+        return false;
+    const name = 'name' in error && typeof error.name === 'string' ? error.name : '';
+    return name === 'NotFoundError' || name === 'OverconstrainedError' || name === 'DevicesNotFoundError';
+}
+function toDevice(kind) {
+    return (device) => ({ kind, deviceId: device.deviceId, label: device.label, groupId: device.groupId });
+}
+function cloneSnapshot(value) {
+    return { ...value, inputs: [...value.inputs], outputs: [...value.outputs] };
+}
+function readStorage(key) {
+    try {
+        const value = globalThis.localStorage?.getItem(key);
+        return value?.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeStorage(key, value) {
+    try {
+        globalThis.localStorage?.setItem(key, value);
+    }
+    catch { /* 隐私模式下允许只保留内存偏好 */ }
+}
+function removeStorage(key) {
+    try {
+        globalThis.localStorage?.removeItem(key);
+    }
+    catch { /* 忽略不可写存储 */ }
+}
+//# sourceMappingURL=voice-device-manager.js.map

package/data/build/dist/client/voice-device-manager.js.map

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

package/data/build/dist/client/voice-output.d.ts

@@ -0,0 +1,14 @@
+export interface VoiceOutputAdapter {
+    speak(text: string, epoch: number): Promise<void> | void;
+    cancel(): Promise<void> | void;
+}
+/** 播报控制器：每次新播报都会取消旧队列，打断时不会继续播放旧文本。 */
+export declare class VoiceOutputController {
+    private readonly adapter;
+    private epoch;
+    constructor(adapter: VoiceOutputAdapter);
+    speak(text: string): Promise<number>;
+    interrupt(): Promise<void>;
+    currentEpoch(): number;
+}
+//# sourceMappingURL=voice-output.d.ts.map

package/data/build/dist/client/voice-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-output.d.ts","sourceRoot":"","sources":["../../../../src/client/voice-output.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACxD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/B;AAED,uCAAuC;AACvC,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,KAAK,CAAI;gBAEY,OAAO,EAAE,kBAAkB;IAElD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAapC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC,YAAY,IAAI,MAAM;CACvB"}

package/data/build/dist/client/voice-output.js

@@ -0,0 +1,32 @@
+import { sanitizeVoiceText } from '../shared/voice-text.js';
+/** 播报控制器：每次新播报都会取消旧队列，打断时不会继续播放旧文本。 */
+export class VoiceOutputController {
+    adapter;
+    epoch = 0;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async speak(text) {
+        const normalized = sanitizeVoiceText(text);
+        this.epoch += 1;
+        const epoch = this.epoch;
+        await this.adapter.cancel();
+        if (normalized === '')
+            return epoch;
+        for (const sentence of splitSentences(normalized)) {
+            if (epoch !== this.epoch)
+                return epoch;
+            await this.adapter.speak(sentence, epoch);
+        }
+        return epoch;
+    }
+    async interrupt() {
+        this.epoch += 1;
+        await this.adapter.cancel();
+    }
+    currentEpoch() { return this.epoch; }
+}
+function splitSentences(value) {
+    return value.split(/(?<=[。！？!?；;。\n])/u).map((item) => item.trim()).filter(Boolean);
+}
+//# sourceMappingURL=voice-output.js.map

package/data/build/dist/client/voice-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-output.js","sourceRoot":"","sources":["../../../../src/client/voice-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAO3D,uCAAuC;AACvC,MAAM,OAAO,qBAAqB;IAGH;IAFrB,KAAK,GAAG,CAAC,CAAA;IAEjB,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;QAC3B,IAAI,UAAU,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;QACnC,KAAK,MAAM,QAAQ,IAAI,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAA;YACtC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;QACf,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAC7B,CAAC;IAED,YAAY,KAAa,OAAO,IAAI,CAAC,KAAK,CAAA,CAAC,CAAC;CAC7C;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACrF,CAAC"}

package/data/build/dist/client/voice-security.d.ts

@@ -0,0 +1,8 @@
+/** 检查浏览器麦克风和实时语音流所需的安全上下文。 */
+export interface BrowserVoiceSecurity {
+    readonly secure: boolean;
+    readonly protocol: string;
+    readonly reason?: 'isSecureContext' | 'insecureProtocol' | 'unknown';
+}
+export declare function inspectBrowserVoiceSecurity(): BrowserVoiceSecurity;
+//# sourceMappingURL=voice-security.d.ts.map

package/data/build/dist/client/voice-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-security.d.ts","sourceRoot":"","sources":["../../../../src/client/voice-security.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,CAAA;CACrE;AAED,wBAAgB,2BAA2B,IAAI,oBAAoB,CAqBlE"}

package/data/build/dist/client/voice-security.js

@@ -0,0 +1,26 @@
+export function inspectBrowserVoiceSecurity() {
+    const environment = globalThis;
+    const windowLike = environment.window;
+    const location = windowLike?.location ?? environment.location;
+    const protocol = typeof location?.protocol === 'string' ? location.protocol.toLowerCase() : '';
+    const hostname = typeof location?.hostname === 'string' ? location.hostname.toLowerCase() : '';
+    const secureValue = typeof windowLike?.isSecureContext === 'boolean'
+        ? windowLike.isSecureContext
+        : typeof environment.isSecureContext === 'boolean' ? environment.isSecureContext : undefined;
+    const hasBrowserSurface = windowLike !== undefined || environment.document !== undefined || secureValue !== undefined || protocol !== '';
+    if (!hasBrowserSurface)
+        return { secure: true, protocol };
+    if (secureValue === false)
+        return { secure: false, protocol, reason: 'isSecureContext' };
+    if (protocol === 'http:' && !isLoopbackHostname(hostname))
+        return { secure: false, protocol, reason: 'insecureProtocol' };
+    if (secureValue === true || protocol === 'https:' || protocol === 'wss:' || protocol === 'file:' || protocol === 'chrome-extension:')
+        return { secure: true, protocol };
+    if (protocol === 'http:' && isLoopbackHostname(hostname))
+        return { secure: true, protocol };
+    return { secure: false, protocol, reason: 'unknown' };
+}
+function isLoopbackHostname(hostname) {
+    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]' || hostname === '::1';
+}
+//# sourceMappingURL=voice-security.js.map

package/data/build/dist/client/voice-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-security.js","sourceRoot":"","sources":["../../../../src/client/voice-security.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,2BAA2B;IACzC,MAAM,WAAW,GAAG,UAKnB,CAAA;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAA;IACrC,MAAM,QAAQ,GAAG,UAAU,EAAE,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAA;IAC7D,MAAM,QAAQ,GAAG,OAAO,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9F,MAAM,QAAQ,GAAG,OAAO,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9F,MAAM,WAAW,GAAG,OAAO,UAAU,EAAE,eAAe,KAAK,SAAS;QAClE,CAAC,CAAC,UAAU,CAAC,eAAe;QAC5B,CAAC,CAAC,OAAO,WAAW,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAA;IAC9F,MAAM,iBAAiB,GAAG,UAAU,KAAK,SAAS,IAAI,WAAW,CAAC,QAAQ,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAA;IACxI,IAAI,CAAC,iBAAiB;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACzD,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAA;IACxF,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IACzH,IAAI,WAAW,KAAK,IAAI,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,mBAAmB;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IACvK,IAAI,QAAQ,KAAK,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAC3F,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AACvD,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,KAAK,CAAA;AAC3G,CAAC"}

package/data/build/dist/dsh-capabilities/client/primitives-adapter.d.ts

@@ -1,14 +1,25 @@
-import type { ComponentType } from 'react';
+import { type ComponentType } from 'react';
 type IconComponent = ComponentType<{
     readonly size?: number;
     readonly className?: string;
 }>;
+type ShortcutKeysComponent = ComponentType<{
+    readonly keys: readonly string[];
+}>;
 /**
  * 图标导出兼容层。0.1.7 可能改名为 Regular/Medium，运行时优先使用新导出，
  * 旧导出仍作为回退；业务组件不再直接判断 DSH 版本。
  */
 export declare function resolvePlusIcon(): IconComponent;
 export declare function resolveChevronDownIcon(): IconComponent;
+/** 终端工具栏使用的原生刷新图标。 */
+export declare function resolveRefreshIcon(): IconComponent;
+/** 终端工具栏入口使用的原生工具图标。 */
+export declare function resolveToolIcon(): IconComponent;
+/** 终端快捷操作的方向图标。 */
+export declare function resolveTerminalArrowIcon(direction: 'up' | 'down' | 'left' | 'right'): IconComponent;
+/** 终端按键标签使用 DSH 原生 ShortcutKeys，旧版本缺失时退回纯文本。 */
+export declare function resolveShortcutKeys(): ShortcutKeysComponent;
 /**
  * 模型图标：DSH 原生模型选择器在紧凑状态显示的 data 图标（0.1.7 起为 Regular/Medium，
  * 0.1.6 为 16 后缀），插件模型选择器收起时与之保持一致。

package/data/build/dist/dsh-capabilities/client/primitives-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-capabilities/client/primitives-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C,KAAK,aAAa,GAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAmB3F;;;GAGG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAG/C;AAED,wBAAgB,sBAAsB,IAAI,aAAa,CAGtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAG/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAOnD"}
+{"version":3,"file":"primitives-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-capabilities/client/primitives-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA;AAEzD,KAAK,aAAa,GAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAC3F,KAAK,qBAAqB,GAAG,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CAAA;AAiChF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAG/C;AAED,wBAAgB,sBAAsB,IAAI,aAAa,CAGtD;AAED,sBAAsB;AACtB,wBAAgB,kBAAkB,IAAI,aAAa,CAGlD;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,aAAa,CAO/C;AAED,mBAAmB;AACnB,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAMnG;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,IAAI,qBAAqB,CAG3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAG/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAOnD"}

package/data/build/dist/dsh-capabilities/client/primitives-adapter.js

@@ -1,5 +1,7 @@
 import * as primitives from '@deepseek-ai/dsh-client-ui-primitives';
+import { createElement } from 'react';
 const unavailableIcon = () => null;
+const fallbackShortcutKeys = ({ keys }) => createElement('span', undefined, keys.join(' + '));
 /**
  * 图标导出兼容层。0.1.7 可能改名为 Regular/Medium，运行时优先使用新导出，
  * 旧导出仍作为回退；业务组件不再直接判断 DSH 版本。
@@ -12,6 +14,36 @@ export function resolveChevronDownIcon() {
     const value = primitives;
     return value.IconChevronDownOutlineRegular ?? value.IconChevronDownOutlineMedium ?? value.IconChevronDownOutline14 ?? unavailableIcon;
 }
+/** 终端工具栏使用的原生刷新图标。 */
+export function resolveRefreshIcon() {
+    const value = primitives;
+    return value.IconRefreshOutlineRegular ?? value.IconRefreshOutlineMedium ?? unavailableIcon;
+}
+/** 终端工具栏入口使用的原生工具图标。 */
+export function resolveToolIcon() {
+    const value = primitives;
+    return value.IconSlidersTwoOutlineRegular
+        ?? value.IconSlidersTwoOutlineMedium
+        ?? value.IconSettingsOutlineRegular
+        ?? value.IconSettingsOutlineMedium
+        ?? unavailableIcon;
+}
+/** 终端快捷操作的方向图标。 */
+export function resolveTerminalArrowIcon(direction) {
+    const value = primitives;
+    if (direction === 'up')
+        return value.IconChevronUpOutlineRegular ?? value.IconChevronUpOutlineMedium ?? unavailableIcon;
+    if (direction === 'down')
+        return value.IconChevronDownOutlineRegular ?? value.IconChevronDownOutlineMedium ?? unavailableIcon;
+    if (direction === 'left')
+        return value.IconChevronLeftOutlineRegular ?? value.IconChevronLeftOutlineMedium ?? unavailableIcon;
+    return value.IconChevronRightOutlineRegular ?? value.IconChevronRightOutlineMedium ?? unavailableIcon;
+}
+/** 终端按键标签使用 DSH 原生 ShortcutKeys，旧版本缺失时退回纯文本。 */
+export function resolveShortcutKeys() {
+    const value = primitives;
+    return value.ShortcutKeys ?? fallbackShortcutKeys;
+}
 /**
  * 模型图标：DSH 原生模型选择器在紧凑状态显示的 data 图标（0.1.7 起为 Regular/Medium，
  * 0.1.6 为 16 后缀），插件模型选择器收起时与之保持一致。

package/data/build/dist/dsh-capabilities/client/primitives-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives-adapter.js","sourceRoot":"","sources":["../../../../../src/dsh-capabilities/client/primitives-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uCAAuC,CAAA;AAoBnE,MAAM,eAAe,GAAkB,GAAG,EAAE,CAAC,IAAI,CAAA;AAEjD;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,iBAAiB,IAAI,eAAe,CAAA;AAClH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,6BAA6B,IAAI,KAAK,CAAC,4BAA4B,IAAI,KAAK,CAAC,wBAAwB,IAAI,eAAe,CAAA;AACvI,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,iBAAiB,IAAI,eAAe,CAAA;AAClH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,uBAAuB;WAC/B,KAAK,CAAC,sBAAsB;WAC5B,KAAK,CAAC,sBAAsB;WAC5B,KAAK,CAAC,qBAAqB;WAC3B,eAAe,EAAE,CAAA;AACxB,CAAC"}
+{"version":3,"file":"primitives-adapter.js","sourceRoot":"","sources":["../../../../../src/dsh-capabilities/client/primitives-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,uCAAuC,CAAA;AACnE,OAAO,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAA;AAiCzD,MAAM,eAAe,GAAkB,GAAG,EAAE,CAAC,IAAI,CAAA;AACjD,MAAM,oBAAoB,GAA0B,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AAEpH;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,iBAAiB,IAAI,eAAe,CAAA;AAClH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,6BAA6B,IAAI,KAAK,CAAC,4BAA4B,IAAI,KAAK,CAAC,wBAAwB,IAAI,eAAe,CAAA;AACvI,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,yBAAyB,IAAI,KAAK,CAAC,wBAAwB,IAAI,eAAe,CAAA;AAC7F,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,4BAA4B;WACpC,KAAK,CAAC,2BAA2B;WACjC,KAAK,CAAC,0BAA0B;WAChC,KAAK,CAAC,yBAAyB;WAC/B,eAAe,CAAA;AACtB,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,wBAAwB,CAAC,SAA2C;IAClF,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,2BAA2B,IAAI,KAAK,CAAC,0BAA0B,IAAI,eAAe,CAAA;IACvH,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,6BAA6B,IAAI,KAAK,CAAC,4BAA4B,IAAI,eAAe,CAAA;IAC7H,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,6BAA6B,IAAI,KAAK,CAAC,4BAA4B,IAAI,eAAe,CAAA;IAC7H,OAAO,KAAK,CAAC,8BAA8B,IAAI,KAAK,CAAC,6BAA6B,IAAI,eAAe,CAAA;AACvG,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,YAAY,IAAI,oBAAoB,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,sBAAsB,IAAI,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,iBAAiB,IAAI,eAAe,CAAA;AAClH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,UAA8B,CAAA;IAC5C,OAAO,KAAK,CAAC,uBAAuB;WAC/B,KAAK,CAAC,sBAAsB;WAC5B,KAAK,CAAC,sBAAsB;WAC5B,KAAK,CAAC,qBAAqB;WAC3B,eAAe,EAAE,CAAA;AACxB,CAAC"}

package/data/build/dist/host/cli-adapters/acp-cli-driver.d.ts

@@ -5,8 +5,19 @@ export interface AcpCliDriverOptions {
     readonly binaries?: readonly string[];
     readonly spawnSync?: typeof spawnSync;
     readonly spawn?: typeof spawn;
+    /** 传给 Provider 子进程的环境覆盖；不会改写 Host 自身的 process.env。 */
+    readonly environment?: Readonly<Record<string, string | undefined>>;
     /** ACP 的启动参数；每个产品的参数必须在驱动文件中显式写出。 */
     readonly args: readonly string[];
+    /**
+     * 按当前会话选择生成启动参数。Cursor 的 ACP 只能在进程启动时固定模型，
+     * 因此不能把所有产品都强行塞进 session/set_model。
+     */
+    readonly buildArgs?: (input: CodingNsCliTurnInput) => readonly string[];
+    /** Provider 是否支持在已经建立的 ACP 会话内切换模型。 */
+    readonly runtimeModelSelection?: boolean;
+    /** 读取 Provider 自己公开的只读模型目录；返回 null 表示本次读取失败。 */
+    readonly readModelCatalog?: (command: string, runSpawnSync: typeof spawnSync) => CodingNsCliModelCatalog | null;
     readonly id: string;
     readonly name: string;
     /** 只保留已经验证的能力，默认不声明 usage/fork/压缩/权限交互。 */
@@ -33,9 +44,13 @@ export declare class AcpCliDriver implements CodingNsCliDriver {
     readonly supportsToolStepSplitting = true;
     private readonly binaries;
     private readonly args;
+    private readonly buildArgsForTurn;
+    private readonly runtimeModelSelection;
+    private readonly readModelCatalog;
     private readonly fallbackCatalog;
     private readonly runSpawnSync;
     private readonly runSpawn;
+    private readonly environment;
     private readonly probeReason;
     private cachedBinary;
     private readonly processes;