@openvulcan/dsh-vulcancode 0.4.3 → 0.4.4

package/node_modules/@openvulcan/dsh-vulcan-voice-input/lib/client.js

@@ -0,0 +1,1567 @@
+window.__ModuleLoader__.load({
+	id: "@openvulcan/dsh-vulcan-voice-input",
+	factory: (platformRequire) => {
+		var definitions = {
+		"./composer": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.MicrophoneIcon = MicrophoneIcon;
+			exports.ComposerVoice = ComposerVoice;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const react_1 = require("react");
+			const quick_1 = require("./quick");
+			const shared_1 = require("./shared");
+			const shortcut_1 = require("./shortcut");
+			const wav_1 = require("./wav");
+			// MediaRecorder only receives a format supported by the current browser.
+			// 录音器仅使用当前浏览器支持的格式。
+			const FORMATS = ['audio/webm;codecs=opus', 'audio/ogg;codecs=opus', 'audio/mp4'];
+			// Brief recording results disappear independently of ongoing progress.
+			// 录音结果提示会自动消失，进行中的状态独立显示。
+			const NOTICE_MS = 2000;
+			// Match VulcanCode's grace period for a lone modifier before opening the microphone.
+			// 沿用 VulcanCode 的单独修饰键等待时间，再打开麦克风。
+			const MODIFIER_HOLD_MS = 150;
+			/**
+			 * Identify the physical press that owns a release or cancellation.
+			 * 识别该次释放或取消对应的物理按压。
+			 */
+			function sameHold(first, second) {
+			    if ('shortcut' in first)
+			        return 'shortcut' in second && first.shortcut === second.shortcut;
+			    return 'key' in first ? 'key' in second && first.key === second.key
+			        : 'pointer' in second && first.pointer === second.pointer;
+			}
+			/**
+			 * Release the microphone and both recording clocks.
+			 * 释放麦克风和两项录音计时。
+			 */
+			function release(recording) {
+			    window.clearInterval(recording.tick);
+			    window.clearTimeout(recording.deadline);
+			    (0, shared_1.releaseMicrophone)(recording.stream);
+			    delete recording.stream;
+			}
+			/**
+			 * Cancel an operation before releasing its recorder so a stop callback cannot submit it.
+			 * 在释放录音器前取消操作，防止停止回调提交已取消的录音。
+			 */
+			function discard(recording) {
+			    if (recording === undefined)
+			        return;
+			    recording.controller.abort();
+			    if (recording.recorder?.state === 'recording')
+			        recording.recorder.stop();
+			    release(recording);
+			}
+			/**
+			 * Render the same microphone mark at toolbar or settings navigation size.
+			 * 按工具栏或设置导航尺寸绘制同一麦克风图标。
+			 */
+			function MicrophoneIcon({ size }) {
+			    return (0, jsx_runtime_1.jsxs)("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 1.65, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [(0, jsx_runtime_1.jsx)("rect", { x: "9", y: "3", width: "6", height: "12", rx: "3" }), (0, jsx_runtime_1.jsx)("path", { d: "M5.5 11v1a6.5 6.5 0 0 0 13 0v-1M12 18.5V22M9 22h6" })] });
+			}
+			/**
+			 * Record speech for one composer and return the transcript to its original draft.
+			 * 为单个输入框录音，并将转写结果回填至原草稿。
+			 */
+			function ComposerVoice({ status, preferences, actions, openSettings, t }) {
+			    // Read the shared account state without giving the browser access to the device token.
+			    // 读取共享账号状态，浏览器无需访问设备令牌。
+			    const state = (0, react_1.useSyncExternalStore)(status.subscribe, status.getSnapshot);
+			    const authorization = state?.status === 'ready' ? state.authorizationId : undefined;
+			    const current = (0, react_1.useRef)(undefined);
+			    const toolbar = (0, react_1.useRef)(null);
+			    const [phase, setPhase] = (0, react_1.useState)('idle');
+			    const [seconds, setSeconds] = (0, react_1.useState)(0);
+			    const [notice, setNotice] = (0, react_1.useState)();
+			    const [pending, setPending] = (0, react_1.useState)();
+			    (0, react_1.useEffect)(() => {
+			        /**
+			         * Cancel when the page is hidden or the user presses Escape during capture.
+			         * 页面隐藏或用户在录音时按 Escape 时取消。
+			         */
+			        const cancel = () => {
+			            if (current.current === undefined)
+			                return;
+			            discard(current.current);
+			            current.current = undefined;
+			            setPhase('idle');
+			        };
+			        /**
+			         * Only react when the page loses visibility.
+			         * 仅在页面不可见时处理。
+			         */
+			        const onVisibility = () => { if (document.hidden)
+			            cancel(); };
+			        /**
+			         * Let Escape dismiss this active recording.
+			         * 允许 Escape 关闭当前录音。
+			         */
+			        const onKey = (event) => { if (event.key === 'Escape')
+			            cancel(); };
+			        document.addEventListener('visibilitychange', onVisibility);
+			        document.addEventListener('keydown', onKey);
+			        window.addEventListener('blur', cancel);
+			        return () => {
+			            document.removeEventListener('visibilitychange', onVisibility);
+			            document.removeEventListener('keydown', onKey);
+			            window.removeEventListener('blur', cancel);
+			            discard(current.current);
+			            current.current = undefined;
+			        };
+			    }, []);
+			    (0, react_1.useEffect)(() => {
+			        // Track physical sides because both Ctrl keys share one ctrlKey flag.
+			        // 左右 Ctrl 共用 ctrlKey 标志，因此按物理键记录状态。
+			        const heldModifiers = new Set();
+			        let pendingModifier;
+			        /**
+			         * Clear a pending single modifier before it can open the microphone.
+			         * 在单独修饰键打开麦克风前清除等待状态。
+			         */
+			        function clearPending() {
+			            if (pendingModifier === undefined)
+			                return;
+			            window.clearTimeout(pendingModifier.timer);
+			            pendingModifier = undefined;
+			        }
+			        /**
+			         * Check that the supplied event or focus target belongs to this draft editor.
+			         * 检查传入的事件目标或焦点是否属于当前草稿编辑器。
+			         */
+			        function ownsEditor(element) {
+			            if (!(element instanceof Element))
+			                return false;
+			            const editor = element.closest('[data-composer-input]');
+			            return editor !== null && toolbar.current?.closest('[data-composer-card]')?.contains(editor) === true;
+			        }
+			        /**
+			         * Yield a standalone modifier hold to an ordinary chord before dsh handles the next key.
+			         * 在 dsh 处理下一个按键前，让单独修饰键录音让位于普通组合键。
+			         */
+			        function onOtherDown(event) {
+			            if ((0, shortcut_1.isModifierCode)(event.code))
+			                heldModifiers.add(event.code);
+			            if (pendingModifier !== undefined && pendingModifier.code !== event.code)
+			                clearPending();
+			            const recording = current.current;
+			            if (recording === undefined || recording.submit || !('shortcut' in recording.hold))
+			                return;
+			            const active = recording.hold.shortcut;
+			            if ((0, shortcut_1.isModifierCode)(active) && active !== event.code)
+			                cancel();
+			        }
+			        /**
+			         * Handle the configured chord only when this conversation's draft editor has focus.
+			         * 仅在当前会话草稿编辑器聚焦时响应已设置的组合键。
+			         */
+			        const onDown = (event) => {
+			            if (event.defaultPrevented || !ownsEditor(event.target))
+			                return;
+			            const chord = (0, shortcut_1.shortcutFromKey)(event);
+			            if (chord === '' || chord !== preferences.getShortcut())
+			                return;
+			            if (status.getSnapshot()?.status !== 'ready')
+			                return;
+			            if ((0, shortcut_1.isModifierCode)(chord)) {
+			                if (event.repeat || heldModifiers.size !== 1 || pendingModifier !== undefined || current.current !== undefined)
+			                    return;
+			                pendingModifier = { code: chord, timer: window.setTimeout(() => {
+			                        pendingModifier = undefined;
+			                        if (!document.hidden && ownsEditor(document.activeElement) && preferences.getShortcut() === chord) {
+			                            void start({ shortcut: chord });
+			                        }
+			                    }, MODIFIER_HOLD_MS) };
+			                return;
+			            }
+			            event.preventDefault();
+			            if (!event.repeat)
+			                void start({ shortcut: chord });
+			        };
+			        /**
+			         * Release the active shortcut as soon as any of its keys lifts.
+			         * 快捷键任一组成键松开时结束对应录音。
+			         */
+			        const onUp = (event) => {
+			            heldModifiers.delete(event.code);
+			            if (pendingModifier?.code === event.code)
+			                clearPending();
+			            const recording = current.current;
+			            if (recording === undefined || recording.submit || !('shortcut' in recording.hold))
+			                return;
+			            if (!(0, shortcut_1.releasesShortcut)(recording.hold.shortcut, event))
+			                return;
+			            event.preventDefault();
+			            releaseHold(recording.hold);
+			        };
+			        /**
+			         * Forget pending keys when the document may no longer receive their releases.
+			         * 文档可能收不到松键事件时清除等待中的按键。
+			         */
+			        function resetKeys() {
+			            heldModifiers.clear();
+			            clearPending();
+			        }
+			        /**
+			         * Clear the hold delay when the page is hidden.
+			         * 页面隐藏时清除长按等待状态。
+			         */
+			        const onHidden = () => { if (document.hidden)
+			            resetKeys(); };
+			        window.addEventListener('keydown', onOtherDown, true);
+			        window.addEventListener('keydown', onDown);
+			        window.addEventListener('keyup', onUp, true);
+			        window.addEventListener('blur', resetKeys);
+			        document.addEventListener('visibilitychange', onHidden);
+			        return () => {
+			            resetKeys();
+			            window.removeEventListener('keydown', onOtherDown, true);
+			            window.removeEventListener('keydown', onDown);
+			            window.removeEventListener('keyup', onUp, true);
+			            window.removeEventListener('blur', resetKeys);
+			            document.removeEventListener('visibilitychange', onHidden);
+			        };
+			    }, [actions, preferences, status, t]);
+			    (0, react_1.useEffect)(() => {
+			        setPending(undefined);
+			        setNotice(undefined);
+			        if (current.current !== undefined && current.current.authorizationId !== authorization) {
+			            discard(current.current);
+			            current.current = undefined;
+			            setPhase('idle');
+			        }
+			    }, [authorization]);
+			    (0, react_1.useEffect)(() => {
+			        if (notice === undefined)
+			            return;
+			        // An earlier notice's timer must not clear feedback from a newer recording.
+			        // 旧提示的计时器不能清除新录音产生的提示。
+			        const timer = window.setTimeout(() => {
+			            setNotice(current => current === notice ? undefined : current);
+			        }, NOTICE_MS);
+			        return () => window.clearTimeout(timer);
+			    }, [notice]);
+			    /**
+			     * Verify the recording is still attached to this composer and the same login.
+			     * 确认录音仍属于当前输入框和同一次登录。
+			     */
+			    function stillCurrent(recording) {
+			        const snapshot = status.getSnapshot();
+			        return current.current === recording && !recording.controller.signal.aborted &&
+			            snapshot?.status === 'ready' && snapshot.authorizationId === recording.authorizationId;
+			    }
+			    /**
+			     * Encode and upload the stopped recording, then use dsh's revision-aware draft action.
+			     * 编码并上传已停止的录音，再使用 dsh 带版本校验的草稿操作。
+			     */
+			    async function finish(recording, mimeType) {
+			        release(recording);
+			        if (!stillCurrent(recording))
+			            return;
+			        try {
+			            // Missing chunks and silent PCM have the same outcome as a successful blank transcript.
+			            // 没有录音片段、PCM 静音与转写成功但文本为空属于同一种结果。
+			            const wav = recording.chunks.length === 0
+			                ? null
+			                : await (0, wav_1.encodeVoiceInputWav)(new Blob(recording.chunks, { type: mimeType }), recording.maxSeconds);
+			            if (!stillCurrent(recording))
+			                return;
+			            // Text stays empty when there is no audio to send.
+			            // 没有可上传的音频时，转写文本保持为空。
+			            let text = '';
+			            if (wav !== null) {
+			                const result = await (0, shared_1.requestTranscript)(wav, recording.authorizationId, recording.selection, recording.controller.signal);
+			                if (!stillCurrent(recording))
+			                    return;
+			                if (!result.ok) {
+			                    const retry = result.retryAfter === undefined ? '' : ' ' + t('retry').replace('{seconds}', String(result.retryAfter));
+			                    setNotice({ text: t(result.code) + retry });
+			                    if (result.code === 'signed_out' || result.code === 'selection_unavailable')
+			                        status.refresh(true);
+			                    return;
+			                }
+			                text = result.text.trim();
+			            }
+			            if (text === '') {
+			                setNotice({ text: t('noSpeech') });
+			            }
+			            else if (!actions.insertText(text, recording.insertion)) {
+			                setPending({ text, authorizationId: recording.authorizationId });
+			                setNotice({ text: t('draftChanged') });
+			            }
+			        }
+			        catch {
+			            if (stillCurrent(recording))
+			                setNotice({ text: t('unavailable') });
+			        }
+			        finally {
+			            if (current.current === recording) {
+			                current.current = undefined;
+			                setPhase('idle');
+			            }
+			        }
+			    }
+			    /**
+			     * Start recording for a physical hold while the account is ready.
+			     * 账号就绪时，为一次物理按压启动录音。
+			     */
+			    async function start(hold) {
+			        const ready = status.getSnapshot();
+			        if (ready?.status !== 'ready')
+			            return;
+			        if (current.current !== undefined)
+			            return;
+			        // Prevent recording with an unavailable preference before requesting the microphone.
+			        // 所选参数已不可用时，在打开麦克风前提示用户。
+			        const selection = preferences.selection(ready.site, ready.catalog);
+			        const model = ready.catalog.models.find(entry => entry.id === selection.modelId);
+			        if (model === undefined || (selection.language !== undefined && !model.languages.includes(selection.language))) {
+			            setNotice({ text: t('selection_unavailable') });
+			            return;
+			        }
+			        setNotice(undefined);
+			        setPending(undefined);
+			        const mimeType = typeof MediaRecorder === 'undefined' ? undefined : FORMATS.find(type => MediaRecorder.isTypeSupported(type));
+			        if (mimeType === undefined || navigator.mediaDevices === undefined) {
+			            setNotice({ text: t('unsupported') });
+			            return;
+			        }
+			        const recording = {
+			            controller: new AbortController(), authorizationId: ready.authorizationId, hold,
+			            maxSeconds: ready.maxSeconds, selection,
+			            insertion: actions.captureInsertion(), chunks: [], submit: false,
+			        };
+			        current.current = recording;
+			        setPhase('opening');
+			        try {
+			            const stream = await (0, shared_1.openMicrophone)(preferences.getDevice());
+			            if (!stillCurrent(recording)) {
+			                (0, shared_1.releaseMicrophone)(stream);
+			                return;
+			            }
+			            recording.stream = stream;
+			            const recorder = new MediaRecorder(stream, { mimeType });
+			            recording.recorder = recorder;
+			            recorder.ondataavailable = event => { if (event.data.size !== 0)
+			                recording.chunks.push(event.data); };
+			            recorder.onstop = () => {
+			                if (recording.submit) {
+			                    void finish(recording, recorder.mimeType);
+			                }
+			                else if (stillCurrent(recording)) {
+			                    // An unplugged microphone can stop MediaRecorder without a user action.
+			                    // 拔出麦克风可能在没有用户操作时停止录音器。
+			                    cancel();
+			                    setNotice({ text: t('micError') });
+			                }
+			            };
+			            recorder.onerror = () => {
+			                if (!stillCurrent(recording))
+			                    return;
+			                cancel();
+			                setNotice({ text: t('micError') });
+			            };
+			            recorder.start();
+			            const started = performance.now();
+			            recording.started = started;
+			            setSeconds(ready.maxSeconds);
+			            setPhase('recording');
+			            recording.tick = window.setInterval(() => {
+			                setSeconds(Math.max(0, ready.maxSeconds - Math.floor((performance.now() - started) / 1000)));
+			            }, 250);
+			            recording.deadline = window.setTimeout(() => { submitRecording(recording); }, ready.maxSeconds * 1000);
+			        }
+			        catch {
+			            if (current.current === recording) {
+			                cancel();
+			                setNotice({ text: t('micError') });
+			            }
+			        }
+			    }
+			    /**
+			     * Submit audio when the matching hold ends after the minimum recording duration.
+			     * 对应的按压松开且满足最短录音时长时提交音频。
+			     */
+			    function releaseHold(hold) {
+			        const recording = current.current;
+			        if (recording === undefined || recording.submit || !sameHold(recording.hold, hold))
+			            return;
+			        if (recording.started === undefined || recording.recorder?.state !== 'recording') {
+			            cancel();
+			            return;
+			        }
+			        // Measure duration at release so an asynchronous MediaRecorder stop cannot extend a short press.
+			        // 在松开时计算时长，避免 MediaRecorder 异步停止将短按误算为有效录音。
+			        const elapsed = performance.now() - recording.started;
+			        if (elapsed < 250) {
+			            cancel();
+			            setNotice({ text: t('tooShort') });
+			            return;
+			        }
+			        submitRecording(recording);
+			    }
+			    /**
+			     * Commit a recording once, whether released by the user or stopped at the duration limit.
+			     * 录音由用户松开或达到时限时只提交一次。
+			     */
+			    function submitRecording(recording) {
+			        if (!stillCurrent(recording) || recording.submit || recording.recorder?.state !== 'recording')
+			            return;
+			        // Mark the submission before stopping so a later release cannot enqueue another upload.
+			        // 先标记已提交再停止录音器，防止稍后的松开操作重复上传。
+			        recording.submit = true;
+			        window.clearInterval(recording.tick);
+			        window.clearTimeout(recording.deadline);
+			        setPhase('transcribing');
+			        recording.recorder.stop();
+			    }
+			    /**
+			     * Cancel after an interrupted pointer gesture, without interrupting a normal release.
+			     * 指针手势意外中断时取消，不打断正常释放。
+			     */
+			    function cancelPointer(pointer) {
+			        const recording = current.current;
+			        if (recording !== undefined && !recording.submit && sameHold(recording.hold, { pointer }))
+			            cancel();
+			    }
+			    /**
+			     * Cancel capture or upload and return the toolbar to idle.
+			     * 取消录音或上传，使工具栏回到空闲状态。
+			     */
+			    function cancel() {
+			        discard(current.current);
+			        current.current = undefined;
+			        setPhase('idle');
+			    }
+			    /**
+			     * Insert a retained transcript only after the user explicitly confirms the new draft position.
+			     * 用户明确确认新的草稿位置后，才插入保留的转写。
+			     */
+			    function insertPending() {
+			        const snapshot = status.getSnapshot();
+			        if (pending === undefined || snapshot?.status !== 'ready' || pending.authorizationId !== snapshot.authorizationId ||
+			            !actions.insertText(pending.text, actions.captureInsertion()))
+			            return;
+			        setPending(undefined);
+			        setNotice(undefined);
+			    }
+			    // Keep status and recovery actions in the microphone's floating surface throughout the operation.
+			    // 录音全程将状态与恢复操作放在麦克风浮层中。
+			    const feedback = phase !== 'idle' || notice !== undefined ? (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [phase === 'recording' && (0, jsx_runtime_1.jsxs)("span", { className: "vvi-recording", children: [(0, jsx_runtime_1.jsx)("span", { className: "vvi-dot", "aria-hidden": "true" }), (0, jsx_runtime_1.jsx)("span", { role: "status", children: t('recording') }), (0, jsx_runtime_1.jsxs)("span", { className: "vvi-timer", role: "timer", children: [seconds, "s"] })] }), (phase === 'opening' || phase === 'transcribing') && (0, jsx_runtime_1.jsx)("span", { role: "status", children: t(phase) }), phase !== 'idle' && (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: cancel, children: t('cancel') }), notice !== undefined && (0, jsx_runtime_1.jsx)("span", { className: "vvi-notice", role: "status", children: notice.text })] }) : undefined;
+			    return (0, jsx_runtime_1.jsx)("div", { ref: toolbar, className: "vvi-composer", children: (0, jsx_runtime_1.jsx)(quick_1.VoiceTrigger, { icon: (0, jsx_runtime_1.jsx)(MicrophoneIcon, { size: 17 }), state: state, preferences: preferences, feedback: feedback, pendingAction: pending === undefined ? undefined : (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: insertPending, children: t('insert') }), idle: phase === 'idle', pressed: phase === 'opening' || phase === 'recording', openSettings: openSettings, start: hold => { void start(hold); }, release: releaseHold, cancelPointer: cancelPointer, t: t }) });
+			}
+
+		},
+		"./dsh-client": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+
+		},
+		"./fields": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.ModelFields = ModelFields;
+			exports.MicrophonePicker = MicrophonePicker;
+			exports.ShortcutField = ShortcutField;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const react_1 = require("react");
+			const shortcut_1 = require("./shortcut");
+			/**
+			 * List local microphone devices and refresh after permission or device changes.
+			 * 列出本地麦克风，在授权或设备变化后刷新。
+			 */
+			function useMicrophones(revision) {
+			    const [devices, setDevices] = (0, react_1.useState)([]);
+			    (0, react_1.useEffect)(() => {
+			        const media = navigator.mediaDevices;
+			        if (media === undefined)
+			            return;
+			        let generation = 0;
+			        /**
+			         * Publish only the most recent enumeration result.
+			         * 仅发布最近一次设备枚举的结果。
+			         */
+			        const refresh = () => {
+			            const current = ++generation;
+			            void media.enumerateDevices().then(all => {
+			                if (current !== generation)
+			                    return;
+			                setDevices(all.filter(item => item.kind === 'audioinput' && item.deviceId !== '' &&
+			                    item.deviceId !== 'default' && item.deviceId !== 'communications'));
+			            }, () => { if (current === generation)
+			                setDevices([]); });
+			        };
+			        refresh();
+			        media.addEventListener('devicechange', refresh);
+			        return () => {
+			            generation += 1;
+			            media.removeEventListener('devicechange', refresh);
+			        };
+			    }, [revision]);
+			    return devices;
+			}
+			/**
+			 * Let either surface select the model and its supported language.
+			 * 允许在任一界面选择模型及该模型支持的语言。
+			 */
+			function ModelFields({ ready, preferences, t }) {
+			    const { site, catalog } = ready;
+			    (0, react_1.useSyncExternalStore)(preferences.subscribe, preferences.getSnapshot);
+			    const selection = preferences.selection(site, catalog);
+			    const current = catalog.models.find(model => model.id === selection.modelId);
+			    const defaultModel = catalog.models.find(model => model.id === catalog.defaultModelId);
+			    const languageNames = new Intl.DisplayNames([t('languageLocale')], { type: 'language' });
+			    // Keep withdrawn preferences visible until the user picks a different value.
+			    // 保留已下架的选项，直到用户主动改选。
+			    const retiredLanguage = selection.language !== undefined && !current?.languages.includes(selection.language);
+			    return (0, jsx_runtime_1.jsxs)("div", { className: "vvi-fields", children: [(0, jsx_runtime_1.jsxs)("label", { children: [t('model'), (0, jsx_runtime_1.jsxs)("select", { value: preferences.getModelChoice(site), onChange: event => { preferences.setModelChoice(site, event.target.value); }, children: [(0, jsx_runtime_1.jsx)("option", { value: "", children: t('siteDefault').replace('{model}', defaultModel?.label ?? catalog.defaultModelId) }), current === undefined && (0, jsx_runtime_1.jsx)("option", { value: selection.modelId, disabled: true, children: t('retiredChoice').replace('{value}', selection.modelId) }), catalog.models.map(model => (0, jsx_runtime_1.jsx)("option", { value: model.id, children: model.label }, model.id))] })] }), (0, jsx_runtime_1.jsxs)("label", { children: [t('language'), (0, jsx_runtime_1.jsxs)("select", { value: selection.language ?? '', disabled: !retiredLanguage && !current?.languages.length, onChange: event => { preferences.setLanguage(site, selection.modelId, event.target.value); }, children: [(0, jsx_runtime_1.jsx)("option", { value: "", children: t('autoLanguage') }), retiredLanguage && (0, jsx_runtime_1.jsx)("option", { value: selection.language, disabled: true, children: t('retiredChoice').replace('{value}', selection.language) }), current?.languages.map(language => (0, jsx_runtime_1.jsx)("option", { value: language, children: languageNames.of(language) ?? language }, language))] })] })] });
+			}
+			/**
+			 * Pick the same local microphone from settings or the floating card.
+			 * 在设置或浮层中选择同一个本地麦克风。
+			 */
+			function MicrophonePicker({ preferences, revision = 0, disabled = false, t }) {
+			    const devices = useMicrophones(revision);
+			    (0, react_1.useSyncExternalStore)(preferences.subscribe, preferences.getSnapshot);
+			    const selected = preferences.getDevice();
+			    return (0, jsx_runtime_1.jsxs)("select", { "aria-label": t('microphone'), value: selected, disabled: disabled || navigator.mediaDevices === undefined, onChange: event => { preferences.setDevice(event.target.value); }, children: [(0, jsx_runtime_1.jsx)("option", { value: "", children: t('system') }), selected !== '' && !devices.some(item => item.deviceId === selected) && (0, jsx_runtime_1.jsx)("option", { value: selected, children: t('missing') }), devices.map((item, index) => (0, jsx_runtime_1.jsx)("option", { value: item.deviceId, children: item.label || t('unnamed').replace('{index}', String(index + 1)) }, item.deviceId))] });
+			}
+			/**
+			 * Record a local push-to-talk shortcut from a focusable read-only field.
+			 * 在可聚焦的只读字段中录入本地按住说话快捷键。
+			 */
+			function ShortcutField({ preferences, t }) {
+			    (0, react_1.useSyncExternalStore)(preferences.subscribe, preferences.getSnapshot);
+			    const chord = preferences.getShortcut();
+			    // Save an isolated modifier only on release, after allowing a chord to follow.
+			    // 单独修饰键只在松开时保存，为随后可能出现的组合键留出机会。
+			    const candidate = (0, react_1.useRef)('');
+			    const heldModifiers = (0, react_1.useRef)(new Set());
+			    return (0, jsx_runtime_1.jsxs)("div", { className: "vvi-shortcut-row", children: [(0, jsx_runtime_1.jsx)("input", { "aria-label": t('shortcut'), readOnly: true, value: (0, shortcut_1.shortcutLabel)(chord, t), placeholder: t('captureShortcut'), onBlur: () => { candidate.current = ''; heldModifiers.current.clear(); }, onKeyDown: event => {
+			                    const next = (0, shortcut_1.shortcutFromKey)(event.nativeEvent);
+			                    if ((0, shortcut_1.isModifierCode)(event.code)) {
+			                        if (event.repeat)
+			                            return;
+			                        heldModifiers.current.add(event.code);
+			                        candidate.current = heldModifiers.current.size === 1 ? next : '';
+			                        return;
+			                    }
+			                    candidate.current = '';
+			                    if (next === '')
+			                        return;
+			                    event.preventDefault();
+			                    event.stopPropagation();
+			                    if (!event.repeat)
+			                        preferences.setShortcut(next);
+			                }, onKeyUp: event => {
+			                    heldModifiers.current.delete(event.code);
+			                    if (candidate.current === '' || candidate.current !== event.code)
+			                        return;
+			                    candidate.current = '';
+			                    event.preventDefault();
+			                    event.stopPropagation();
+			                    preferences.setShortcut(event.code);
+			                } }), (0, jsx_runtime_1.jsx)("button", { type: "button", disabled: chord === '', onClick: () => { preferences.setShortcut(''); }, children: t('clearShortcut') })] });
+			}
+
+		},
+		"./i18n": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.en = exports.zh = void 0;
+			// The same keys drive the toolbar, service status and microphone settings in both languages.
+			// 同一组文案键用于中英文工具栏、服务状态和麦克风设置。
+			exports.zh = {
+			    title: 'OpenVulcan 语音输入',
+			    lead: '用麦克风口述消息，转写完成后可在输入框里编辑。',
+			    service: '转写服务',
+			    microphone: '麦克风',
+			    serviceHint: '松开后，录音会发往 OpenVulcan 账号所属站点免费转写。',
+			    model: '转写模型',
+			    siteDefault: '站点默认（{model}）',
+			    language: '优先语言',
+			    autoLanguage: '自动识别',
+			    retiredChoice: '{value}（已不可用）',
+			    languageLocale: 'zh-CN',
+			    shortcut: '录音快捷键',
+			    shortcutHint: '在对话输入框按住快捷键说话，松开任一组成键转写。可单独绑定右 Ctrl 等左右修饰键。',
+			    captureShortcut: '点击后按快捷键，如右 Ctrl',
+			    shortcutLeft: '左 {key}',
+			    shortcutRight: '右 {key}',
+			    shortcutNumpad: '数字键盘 {key}',
+			    clearShortcut: '清除',
+			    holdHint: '按住说话，松开转写',
+			    selection_unavailable: '所选模型或语言已不可用，请检查设置后重录。',
+			    loading: '正在检查',
+			    ready: '可用',
+			    signed_out: '请登录 OpenVulcan',
+			    disabled: '当前站点未开放语音转写',
+			    unavailable: '转写服务暂不可用',
+			    cn: '中国站',
+			    global: '国际站',
+			    refresh: '重新检查',
+			    account: '打开账号设置',
+			    system: '系统默认',
+			    missing: '所选麦克风暂未列出',
+			    unnamed: '麦克风 {index}',
+			    test: '测试麦克风',
+			    stopTest: '结束测试',
+			    testHint: '对着麦克风说话，观察输入电平。测试音频仅在本机处理。',
+			    meter: '麦克风输入电平',
+			    unsupported: '当前页面无法访问麦克风。',
+			    micError: '无法打开麦克风。请检查权限和所选设备。',
+			    openSettings: '打开语音输入设置',
+			    opening: '正在打开麦克风',
+			    recording: '录音中',
+			    cancel: '取消',
+			    transcribing: '正在转写',
+			    duration: '录满 {seconds} 秒自动转写',
+			    tooShort: '录音太短，请再说一次。',
+			    noSpeech: '没有识别到语音。',
+			    draftChanged: '草稿已变化，请确认后插入转写结果。',
+			    insert: '插入转写',
+			    invalid_audio: '无法转写这段录音，请重新录制。',
+			    rate_limited: '已达到转写限额，请稍后再试。',
+			    busy: '转写服务正忙，请稍后再试。',
+			    retry: '可在 {seconds} 秒后重试。',
+			};
+			// English text mirrors the exact Chinese dictionary keys.
+			// 英文文案与中文词典的键严格一致。
+			exports.en = {
+			    title: 'OpenVulcan voice input',
+			    lead: 'Dictate a message and edit the transcript in the composer.',
+			    service: 'Transcription service',
+			    microphone: 'Microphone',
+			    serviceHint: 'When you release, your OpenVulcan account’s site transcribes the audio for free.',
+			    model: 'Transcription model',
+			    siteDefault: 'Site default ({model})',
+			    language: 'Preferred language',
+			    autoLanguage: 'Detect automatically',
+			    retiredChoice: '{value} (unavailable)',
+			    languageLocale: 'en',
+			    shortcut: 'Recording shortcut',
+			    shortcutHint: 'Hold your shortcut in the composer to speak. Release any key in it to transcribe. You can bind a single modifier, such as Right Ctrl.',
+			    captureShortcut: 'Press a shortcut (e.g. Right Ctrl)',
+			    shortcutLeft: 'Left {key}',
+			    shortcutRight: 'Right {key}',
+			    shortcutNumpad: 'Numpad {key}',
+			    clearShortcut: 'Clear',
+			    holdHint: 'Hold to speak. Release to transcribe.',
+			    selection_unavailable: 'The selected model or language is unavailable. Check settings and record again.',
+			    loading: 'Checking',
+			    ready: 'Available',
+			    signed_out: 'Sign in to OpenVulcan',
+			    disabled: 'Voice transcription is disabled on this site',
+			    unavailable: 'Transcription service is unavailable',
+			    cn: 'China',
+			    global: 'Global',
+			    refresh: 'Check again',
+			    account: 'Open account settings',
+			    system: 'System default',
+			    missing: 'Selected microphone is not listed',
+			    unnamed: 'Microphone {index}',
+			    test: 'Test microphone',
+			    stopTest: 'End test',
+			    testHint: 'Speak and watch the input level. Test audio stays on this device.',
+			    meter: 'Microphone input level',
+			    unsupported: 'Microphone access is unavailable on this page.',
+			    micError: 'Could not open the microphone. Check permission and the selected device.',
+			    openSettings: 'Open voice input settings',
+			    opening: 'Opening microphone',
+			    recording: 'Recording',
+			    cancel: 'Cancel',
+			    transcribing: 'Transcribing',
+			    duration: 'Automatically transcribes after {seconds} seconds',
+			    tooShort: 'The recording is too short. Please try again.',
+			    noSpeech: 'No speech was recognized.',
+			    draftChanged: 'Your draft changed. Confirm to insert the transcript.',
+			    insert: 'Insert transcript',
+			    invalid_audio: 'Could not transcribe this recording. Record it again.',
+			    rate_limited: 'You reached the transcription limit. Try again later.',
+			    busy: 'Transcription is busy. Try again later.',
+			    retry: 'Try again in {seconds} seconds.',
+			};
+
+		},
+		"./index": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.inject = void 0;
+			exports.apply = apply;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const composer_1 = require("./composer");
+			const i18n_1 = require("./i18n");
+			const shared_1 = require("./shared");
+			const settings_1 = require("./settings");
+			const style_1 = require("./style");
+			// Cordis supplies the slot and locale services before loading the client contribution.
+			// Cordis 在加载浏览器扩展前提供插槽与本地化服务。
+			exports.inject = ['slots', 'locale'];
+			/**
+			 * Add the OpenVulcan microphone and its settings to dsh without claiming the local voice slot.
+			 * 将 OpenVulcan 麦克风及设置接入 dsh，并保留本地语音使用的插槽。
+			 */
+			function apply(ctx) {
+			    const status = new shared_1.VoiceStatus();
+			    const preferences = new shared_1.VoicePreferences();
+			    /**
+			     * Open a known settings section through the sidebar's shell action.
+			     * 通过侧栏宿主操作打开已知的设置页。
+			     */
+			    function open(section) {
+			        const shell = ctx.slots.entries('sidebar.settings')[0]?.store?.create();
+			        shell?.actions.openSection(section);
+			    }
+			    ctx.effect(style_1.installStyle, 'vulcan-voice-input: stylesheet');
+			    ctx.effect(() => ctx.locale.register(shared_1.SECTION, { zh: i18n_1.zh, en: i18n_1.en }), 'vulcan-voice-input: dictionaries');
+			    ctx.effect(() => {
+			        /**
+			         * Invalidate the previous connection's state before reading from the new Host.
+			         * 在读取新宿主前使上一个连接的状态失效。
+			         */
+			        const reconnect = () => { status.reset(); status.refresh(); };
+			        /**
+			         * Read login changes after returning from the browser's authorization tab.
+			         * 从浏览器授权页返回后检查登录状态变化。
+			         */
+			        const refresh = () => { if (!document.hidden)
+			            status.refresh(); };
+			        const stop = ctx.on('connection/reset', reconnect);
+			        const interval = window.setInterval(refresh, 8000);
+			        window.addEventListener('focus', refresh);
+			        document.addEventListener('visibilitychange', refresh);
+			        refresh();
+			        return () => {
+			            window.clearInterval(interval);
+			            window.removeEventListener('focus', refresh);
+			            document.removeEventListener('visibilitychange', refresh);
+			            stop();
+			            status.reset();
+			        };
+			    }, 'vulcan-voice-input: Host state');
+			    ctx.slots.inject('settings.section', () => ctx.slots.register({
+			        name: 'settings.section',
+			        id: shared_1.SECTION,
+			        order: 25,
+			        label: () => ctx.locale.bind(shared_1.SECTION)('title'),
+			        locale: shared_1.SECTION,
+			    }, ({ t }) => (0, jsx_runtime_1.jsx)(settings_1.VoiceSettings, { status: status, preferences: preferences, openAccount: () => { open(shared_1.ACCOUNT_SECTION); }, t: t })));
+			    ctx.slots.inject('settings.section.icon', () => ctx.slots.register({
+			        name: 'settings.section.icon', id: shared_1.SECTION,
+			    }, composer_1.MicrophoneIcon));
+			    ctx.slots.inject('conversation.input.right', () => ctx.slots.register({
+			        name: 'conversation.input.right',
+			        id: shared_1.SECTION,
+			        order: 14,
+			        locale: shared_1.SECTION,
+			    }, ({ t, inputActions, sessionId }) => (0, jsx_runtime_1.jsx)(composer_1.ComposerVoice, { status: status, preferences: preferences, actions: inputActions, openSettings: () => { open(shared_1.SECTION); }, t: t }, sessionId)));
+			}
+
+		},
+		"./quick": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.VoiceTrigger = VoiceTrigger;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const react_1 = require("react");
+			const react_dom_1 = require("react-dom");
+			const fields_1 = require("./fields");
+			/**
+			 * Render the microphone and anchor its settings and optional feedback outside the toolbar layout.
+			 * 渲染麦克风，并将快捷设置与可选提示锚定在工具栏布局之外。
+			 */
+			function VoiceTrigger({ icon, state, preferences, idle, pressed, feedback, pendingAction, openSettings, start, release, cancelPointer, t }) {
+			    const id = (0, react_1.useId)();
+			    const button = (0, react_1.useRef)(null);
+			    const panel = (0, react_1.useRef)(null);
+			    const timer = (0, react_1.useRef)();
+			    const suppressFocus = (0, react_1.useRef)(false);
+			    const [expanded, setExpanded] = (0, react_1.useState)(false);
+			    const [position, setPosition] = (0, react_1.useState)({});
+			    const open = idle && expanded;
+			    // Render one anchored surface so recording feedback and quick settings cannot overlap.
+			    // 只渲染一个锚定浮层，避免录音提示与快捷设置重叠。
+			    const floating = open || feedback !== undefined;
+			    (0, react_1.useEffect)(() => () => window.clearTimeout(timer.current), []);
+			    (0, react_1.useEffect)(() => {
+			        if (idle)
+			            return;
+			        window.clearTimeout(timer.current);
+			        setExpanded(false);
+			    }, [idle]);
+			    (0, react_1.useLayoutEffect)(() => {
+			        if (!floating)
+			            return;
+			        /**
+			         * Keep the fixed card inside the viewport while the composer moves.
+			         * 输入框移动时，将固定定位浮层留在视口内。
+			         */
+			        const place = () => {
+			            const anchor = button.current?.getBoundingClientRect();
+			            if (anchor === undefined)
+			                return;
+			            // Bound the compact hint separately while keeping both surfaces aligned to the microphone.
+			            // 为紧凑提示单独限制宽度，并让两种浮层都与麦克风对齐。
+			            const maxWidth = Math.min(open ? 336 : 280, window.innerWidth - 16);
+			            const below = window.innerHeight - anchor.bottom;
+			            const above = anchor.top;
+			            setPosition({
+			                maxWidth, right: Math.max(8, Math.min(window.innerWidth - anchor.right, window.innerWidth - maxWidth - 8)),
+			                ...(above >= below ? { bottom: below + anchor.height + 6, maxHeight: above - 14 }
+			                    : { top: anchor.bottom + 6, maxHeight: below - 14 }),
+			            });
+			        };
+			        place();
+			        window.addEventListener('resize', place);
+			        window.addEventListener('scroll', place, true);
+			        return () => {
+			            window.removeEventListener('resize', place);
+			            window.removeEventListener('scroll', place, true);
+			        };
+			    }, [floating, open]);
+			    (0, react_1.useEffect)(() => {
+			        if (!open)
+			            return;
+			        /**
+			         * Dismiss the card when a click moves outside its trigger and controls.
+			         * 点击触发按钮及控件以外的位置时关闭浮层。
+			         */
+			        const outside = (event) => {
+			            if (event.target instanceof Node && !button.current?.contains(event.target) && !panel.current?.contains(event.target)) {
+			                setExpanded(false);
+			            }
+			        };
+			        /**
+			         * Return keyboard focus to the trigger after Escape without reopening the card.
+			         * 按 Escape 后将键盘焦点交回触发按钮，并避免重新打开浮层。
+			         */
+			        const escape = (event) => {
+			            if (event.key !== 'Escape')
+			                return;
+			            if (panel.current?.contains(document.activeElement)) {
+			                suppressFocus.current = true;
+			                button.current?.focus();
+			                suppressFocus.current = false;
+			            }
+			            setExpanded(false);
+			        };
+			        document.addEventListener('pointerdown', outside);
+			        document.addEventListener('keydown', escape);
+			        return () => {
+			            document.removeEventListener('pointerdown', outside);
+			            document.removeEventListener('keydown', escape);
+			        };
+			    }, [open]);
+			    /**
+			     * Delay pointer dismissal long enough to cross the gap to the card.
+			     * 延迟指针触发的关闭，使指针有时间跨过间隙进入浮层。
+			     */
+			    function leave() {
+			        window.clearTimeout(timer.current);
+			        timer.current = window.setTimeout(() => {
+			            if (!panel.current?.contains(document.activeElement) && !button.current?.matches(':focus-visible'))
+			                setExpanded(false);
+			        }, 250);
+			    }
+			    const ready = state?.status === 'ready' ? state : undefined;
+			    const label = ready === undefined ? `${t(state?.status ?? 'loading')} · ${t('openSettings')}` : `${t('title')} · ${t('holdHint')}`;
+			    return (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("button", { ref: button, type: "button", className: "vvi-mic", "aria-label": label, "aria-pressed": pressed, "aria-controls": floating ? id : undefined, "aria-expanded": open, disabled: !idle && !pressed, onPointerEnter: event => {
+			                    if (!idle || event.pointerType !== 'mouse')
+			                        return;
+			                    window.clearTimeout(timer.current);
+			                    timer.current = window.setTimeout(() => { setExpanded(true); }, 300);
+			                }, onPointerLeave: leave, onFocus: event => { if (idle && !suppressFocus.current && event.currentTarget.matches(':focus-visible'))
+			                    setExpanded(true); }, onBlur: event => {
+			                    if (!panel.current?.contains(event.relatedTarget))
+			                        leave();
+			                }, onContextMenu: event => { if (idle) {
+			                    event.preventDefault();
+			                    setExpanded(true);
+			                } }, onPointerDown: event => {
+			                    if (event.button !== 0 || ready === undefined || !idle)
+			                        return;
+			                    event.preventDefault();
+			                    event.currentTarget.setPointerCapture(event.pointerId);
+			                    window.clearTimeout(timer.current);
+			                    setExpanded(false);
+			                    start({ pointer: event.pointerId });
+			                }, onPointerUp: event => { release({ pointer: event.pointerId }); }, onPointerCancel: event => { cancelPointer(event.pointerId); }, onLostPointerCapture: event => { cancelPointer(event.pointerId); }, onClick: () => { if (idle && ready === undefined) {
+			                    setExpanded(false);
+			                    openSettings();
+			                } }, onKeyDown: event => {
+			                    if (open && !event.shiftKey && (event.key === 'Tab' || event.key === 'ArrowDown')) {
+			                        event.preventDefault();
+			                        panel.current?.querySelector('select:not(:disabled), button:not(:disabled), input:not(:disabled)')?.focus();
+			                    }
+			                    else if (ready !== undefined && (event.code === 'Space' || event.code === 'Enter') &&
+			                        !(event.ctrlKey || event.altKey || event.shiftKey || event.metaKey)) {
+			                        event.preventDefault();
+			                        if (idle && !event.repeat) {
+			                            window.clearTimeout(timer.current);
+			                            setExpanded(false);
+			                            start({ key: event.code });
+			                        }
+			                    }
+			                }, onKeyUp: event => { if (event.code === 'Space' || event.code === 'Enter')
+			                    release({ key: event.code }); }, children: icon }), floating && (0, react_dom_1.createPortal)((0, jsx_runtime_1.jsxs)("div", { ref: panel, id: id, role: open ? 'dialog' : undefined, "aria-label": open ? t('title') : undefined, className: open ? 'vvi-quick' : 'vvi-feedback', style: position, onPointerEnter: () => window.clearTimeout(timer.current), onPointerLeave: leave, onBlur: event => {
+			                    if (!event.currentTarget.contains(event.relatedTarget) && event.relatedTarget !== button.current)
+			                        leave();
+			                }, children: [(feedback !== undefined || pendingAction !== undefined) && (0, jsx_runtime_1.jsxs)("div", { className: "vvi-feedback-row", children: [feedback, pendingAction] }), open && (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("div", { className: "vvi-quick-head", children: [(0, jsx_runtime_1.jsx)("strong", { children: t('title') }), ready !== undefined && (0, jsx_runtime_1.jsx)("small", { children: t(ready.site) })] }), (0, jsx_runtime_1.jsx)("p", { children: ready === undefined ? t(state?.status ?? 'loading') : t('holdHint') }), ready !== undefined && (0, jsx_runtime_1.jsx)(fields_1.ModelFields, { ready: ready, preferences: preferences, t: t }), (0, jsx_runtime_1.jsxs)("div", { className: "vvi-fields", children: [(0, jsx_runtime_1.jsxs)("label", { children: [t('microphone'), (0, jsx_runtime_1.jsx)(fields_1.MicrophonePicker, { preferences: preferences, t: t })] }), (0, jsx_runtime_1.jsxs)("div", { className: "vvi-quick-shortcut", children: [(0, jsx_runtime_1.jsx)("span", { children: t('shortcut') }), (0, jsx_runtime_1.jsx)(fields_1.ShortcutField, { preferences: preferences, t: t })] })] }), (0, jsx_runtime_1.jsx)("footer", { children: (0, jsx_runtime_1.jsxs)("button", { type: "button", onClick: () => { setExpanded(false); openSettings(); }, children: [t('openSettings'), " ", (0, jsx_runtime_1.jsx)("span", { "aria-hidden": "true", children: "\u203A" })] }) })] })] }), document.body)] });
+			}
+
+		},
+		"./settings": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.VoiceSettings = VoiceSettings;
+			const jsx_runtime_1 = require("react/jsx-runtime");
+			const react_1 = require("react");
+			const fields_1 = require("./fields");
+			const shared_1 = require("./shared");
+			/**
+			 * Release the local audio graph, microphone and timers. No recording is created.
+			 * 释放本地音频图、麦克风和计时器。测试过程不创建录音。
+			 */
+			function disposeTest(test) {
+			    if (test === undefined)
+			        return;
+			    if (test.frame !== undefined)
+			        cancelAnimationFrame(test.frame);
+			    window.clearTimeout(test.timeout);
+			    (0, shared_1.releaseMicrophone)(test.stream);
+			    if (test.context !== undefined)
+			        void test.context.close().catch(() => { });
+			}
+			/**
+			 * Show the regional service status and let the user select and test a local microphone.
+			 * 显示区域服务状态，并允许用户选择和测试本地麦克风。
+			 */
+			function VoiceSettings({ status, preferences, openAccount, t }) {
+			    // Settings and the composer read one service status and share one local device preference.
+			    // 设置和输入框共用一份服务状态及本地设备偏好。
+			    const state = (0, react_1.useSyncExternalStore)(status.subscribe, status.getSnapshot);
+			    const ready = state?.status === 'ready' ? state : undefined;
+			    const authorization = ready?.authorizationId;
+			    const [deviceRevision, setDeviceRevision] = (0, react_1.useState)(0);
+			    const [testing, setTesting] = (0, react_1.useState)(false);
+			    const [level, setLevel] = (0, react_1.useState)(0);
+			    const [problem, setProblem] = (0, react_1.useState)('');
+			    const test = (0, react_1.useRef)(undefined);
+			    const media = navigator.mediaDevices;
+			    (0, react_1.useEffect)(() => {
+			        /**
+			         * End the local test when this settings page is no longer visible.
+			         * 设置页失去可见性时结束本地测试。
+			         */
+			        const onVisibility = () => {
+			            if (!document.hidden)
+			                return;
+			            disposeTest(test.current);
+			            test.current = undefined;
+			            setTesting(false);
+			            setLevel(0);
+			        };
+			        document.addEventListener('visibilitychange', onVisibility);
+			        return () => {
+			            document.removeEventListener('visibilitychange', onVisibility);
+			            disposeTest(test.current);
+			            test.current = undefined;
+			        };
+			    }, []);
+			    (0, react_1.useEffect)(() => {
+			        if (test.current === undefined)
+			            return;
+			        disposeTest(test.current);
+			        test.current = undefined;
+			        setTesting(false);
+			        setLevel(0);
+			    }, [authorization]);
+			    /**
+			     * Stop testing and reset the level while retaining the device selection.
+			     * 停止测试并重置电平，保留设备选择。
+			     */
+			    function stopTest() {
+			        disposeTest(test.current);
+			        test.current = undefined;
+			        setTesting(false);
+			        setLevel(0);
+			    }
+			    /**
+			     * Show a short live level test after an explicit click. The graph has no output destination.
+			     * 用户明确点击后进行短时实时电平测试，音频图不连接输出设备。
+			     */
+			    async function startTest() {
+			        if (media === undefined || typeof AudioContext === 'undefined' || ready === undefined || test.current !== undefined)
+			            return;
+			        const operation = {};
+			        test.current = operation;
+			        setTesting(true);
+			        setProblem('');
+			        try {
+			            const stream = await (0, shared_1.openMicrophone)(preferences.getDevice());
+			            if (test.current !== operation) {
+			                (0, shared_1.releaseMicrophone)(stream);
+			                return;
+			            }
+			            operation.stream = stream;
+			            setDeviceRevision(value => value + 1);
+			            const context = new AudioContext();
+			            operation.context = context;
+			            const analyser = context.createAnalyser();
+			            analyser.fftSize = 512;
+			            context.createMediaStreamSource(stream).connect(analyser);
+			            const samples = new Float32Array(analyser.fftSize);
+			            operation.timeout = window.setTimeout(stopTest, 8000);
+			            await context.resume();
+			            if (test.current !== operation)
+			                return;
+			            /**
+			             * Read the RMS level and update the meter while this test is active.
+			             * 测试活动期间读取均方根电平并更新电平表。
+			             */
+			            const measure = () => {
+			                if (test.current !== operation)
+			                    return;
+			                analyser.getFloatTimeDomainData(samples);
+			                const power = samples.reduce((sum, sample) => sum + sample * sample, 0);
+			                setLevel(Math.min(100, Math.round(Math.sqrt(power / samples.length) * 300)));
+			                operation.frame = requestAnimationFrame(measure);
+			            };
+			            measure();
+			        }
+			        catch {
+			            if (test.current === operation) {
+			                stopTest();
+			                setProblem(t('micError'));
+			            }
+			        }
+			    }
+			    // The status reports a site only when the host confirmed the account.
+			    // 只有宿主确认账号时，状态才包含站点。
+			    const site = state?.status === 'ready' || state?.status === 'disabled' ? state.site : undefined;
+			    const unavailable = media === undefined || typeof AudioContext === 'undefined';
+			    return (0, jsx_runtime_1.jsxs)("div", { className: "vvi-settings", "data-vulcan-settings-width": "full", children: [(0, jsx_runtime_1.jsxs)("header", { className: "vvi-head", "data-vulcan-settings-header": true, children: [(0, jsx_runtime_1.jsx)("h2", { children: t('title') }), (0, jsx_runtime_1.jsx)("p", { children: t('lead') })] }), (0, jsx_runtime_1.jsxs)("section", { className: "vvi-card", children: [(0, jsx_runtime_1.jsx)("h3", { children: t('service') }), (0, jsx_runtime_1.jsx)("p", { children: t('serviceHint') }), (0, jsx_runtime_1.jsxs)("div", { className: "vvi-row", children: [(0, jsx_runtime_1.jsxs)("div", { className: "vvi-state", role: "status", children: [(0, jsx_runtime_1.jsx)("span", { className: "vvi-badge", "data-voice-status": state?.status ?? 'loading', children: t(state?.status ?? 'loading') }), site !== undefined && (0, jsx_runtime_1.jsx)("span", { children: t(site) })] }), (0, jsx_runtime_1.jsxs)("div", { className: "vvi-actions", children: [state?.status === 'signed_out' && (0, jsx_runtime_1.jsx)("button", { type: "button", className: "vvi-primary", onClick: openAccount, children: t('account') }), (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: () => { status.refresh(true); }, children: t('refresh') })] })] }), ready !== undefined && (0, jsx_runtime_1.jsx)(fields_1.ModelFields, { ready: ready, preferences: preferences, t: t }), ready !== undefined && (0, jsx_runtime_1.jsx)("small", { children: t('duration').replace('{seconds}', String(ready.maxSeconds)) })] }), (0, jsx_runtime_1.jsxs)("section", { className: "vvi-card", children: [(0, jsx_runtime_1.jsx)("h3", { children: t('microphone') }), (0, jsx_runtime_1.jsx)("p", { children: t('testHint') }), (0, jsx_runtime_1.jsxs)("div", { className: "vvi-row vvi-device-row", children: [(0, jsx_runtime_1.jsx)(fields_1.MicrophonePicker, { preferences: preferences, revision: deviceRevision, disabled: unavailable || testing, t: t }), (0, jsx_runtime_1.jsx)("button", { type: "button", disabled: ready === undefined || unavailable, onClick: () => {
+			                                    if (testing)
+			                                        stopTest();
+			                                    else
+			                                        void startTest();
+			                                }, children: t(testing ? 'stopTest' : 'test') })] }), (0, jsx_runtime_1.jsx)("meter", { min: 0, max: 100, value: level, "aria-label": t('meter') }), unavailable && (0, jsx_runtime_1.jsx)("small", { children: t('unsupported') }), problem !== '' && (0, jsx_runtime_1.jsx)("small", { className: "vvi-error", role: "alert", children: problem })] }), (0, jsx_runtime_1.jsxs)("section", { className: "vvi-card", children: [(0, jsx_runtime_1.jsx)("h3", { children: t('shortcut') }), (0, jsx_runtime_1.jsx)("p", { children: t('shortcutHint') }), (0, jsx_runtime_1.jsx)(fields_1.ShortcutField, { preferences: preferences, t: t })] })] });
+			}
+
+		},
+		"./shared": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.VoicePreferences = exports.VoiceStatus = exports.ACCOUNT_SECTION = exports.SECTION = exports.PACKAGE_NAME = void 0;
+			exports.requestTranscript = requestTranscript;
+			exports.openMicrophone = openMicrophone;
+			exports.releaseMicrophone = releaseMicrophone;
+			const shortcut_1 = require("./shortcut");
+			// The dsh client bundler checks this identity against the package manifest.
+			// dsh 客户端打包器会将此标识与包清单比对。
+			exports.PACKAGE_NAME = '@openvulcan/dsh-vulcan-voice-input';
+			// One same-origin route prefix and settings entry for the microphone UI.
+			// 麦克风界面共用的同源路由前缀及设置页标识。
+			const BASE = '/api/vulcan-voice-input/';
+			exports.SECTION = 'vulcan-voice-input';
+			exports.ACCOUNT_SECTION = 'vulcan-account';
+			// Microphone IDs belong to a browser origin and stay on this device.
+			// 麦克风标识属于浏览器来源，仅保存在本设备。
+			const DEVICE_KEY = 'vulcan.dsh.voice-input-device.v1';
+			// Keep preferences for each account site and published model separately.
+			// 按账号站点与发布模型分别保存偏好。
+			const MODEL_KEY = 'vulcan.dsh.voice-input-model.v1';
+			const LANGUAGE_KEY = 'vulcan.dsh.voice-input-language.v1';
+			const SHORTCUT_KEY = 'vulcan.dsh.voice-input-shortcut.v1';
+			/**
+			 * A shared host status snapshot for the toolbar and settings page.
+			 * 输入框工具栏和设置页共用的宿主状态快照。
+			 */
+			class VoiceStatus {
+			    // Start with no observed state and ignore replies from superseded requests.
+			    // 初始状态未知，并忽略已被替换的请求结果。
+			    #state;
+			    #request;
+			    #listeners = new Set();
+			    /**
+			     * Subscribe one rendered consumer and return its disposer.
+			     * 订阅一个已渲染的消费者并返回注销函数。
+			     */
+			    subscribe = (listener) => {
+			        this.#listeners.add(listener);
+			        return () => { this.#listeners.delete(listener); };
+			    };
+			    /**
+			     * Return the last observed status, or undefined before the first read.
+			     * 返回最近观察到的状态，首次读取前返回 undefined。
+			     */
+			    getSnapshot = () => this.#state;
+			    /**
+			     * Read the account status, optionally asking the Host to refresh the publication.
+			     * 读取账号状态，并可显式要求宿主刷新发布目录。
+			     */
+			    refresh(force = false) {
+			        if (this.#request !== undefined && !force)
+			            return;
+			        this.#request?.abort();
+			        const request = new AbortController();
+			        this.#request = request;
+			        void fetch(`${BASE}state${force ? '?refresh=1' : ''}`, {
+			            signal: request.signal, cache: 'no-store',
+			        }).then(async (response) => {
+			            if (!response.ok)
+			                throw new Error('Voice status unavailable');
+			            return await response.json();
+			        }).then(state => {
+			            if (this.#request !== request)
+			                return;
+			            this.#publish(state);
+			        }, () => {
+			            if (this.#request !== request)
+			                return;
+			            this.#publish({ status: 'unavailable' });
+			        }).finally(() => {
+			            if (this.#request === request)
+			                this.#request = undefined;
+			        });
+			    }
+			    /**
+			     * Invalidate the snapshot across host connections and drop pending replies.
+			     * 在宿主连接切换时使快照失效，并丢弃未完成的响应。
+			     */
+			    reset() {
+			        this.#request?.abort();
+			        this.#request = undefined;
+			        this.#publish(undefined);
+			    }
+			    /**
+			     * Publish a new snapshot to mounted consumers.
+			     * 向已挂载的消费者发布新快照。
+			     */
+			    #publish(state) {
+			        this.#state = state;
+			        for (const listener of this.#listeners)
+			            listener();
+			    }
+			}
+			exports.VoiceStatus = VoiceStatus;
+			/**
+			 * Send an authorization-bound microphone WAV to the owning dsh Host.
+			 * 将绑定至设备授权的麦克风 WAV 发给所属 dsh 宿主。
+			 */
+			async function requestTranscript(wav, authorizationId, selection, signal) {
+			    const response = await fetch(`${BASE}transcriptions`, {
+			        method: 'POST', body: wav, signal, cache: 'no-store',
+			        headers: {
+			            'content-type': 'audio/wav', 'x-vulcan-voice-authorization': authorizationId,
+			            'x-vulcan-voice-model': selection.modelId,
+			            ...(selection.language === undefined ? {} : { 'x-vulcan-asr-language': selection.language }),
+			        },
+			    });
+			    return await response.json();
+			}
+			/**
+			 * Share local voice preferences between settings and all composer cards.
+			 * 在设置页与所有输入框浮层之间共享本地语音偏好。
+			 */
+			class VoicePreferences {
+			    // Memory also keeps the selected values usable when browser storage is unavailable.
+			    // 浏览器存储不可用时，仍在内存保留当前选择。
+			    #values = new Map();
+			    #listeners = new Set();
+			    #revision = 0;
+			    /**
+			     * Register a listener and return its disposer.
+			     * 注册监听器并返回注销函数。
+			     */
+			    subscribe = (listener) => {
+			        this.#listeners.add(listener);
+			        return () => { this.#listeners.delete(listener); };
+			    };
+			    /**
+			     * Return a stable snapshot until a preference changes.
+			     * 在偏好变更前返回稳定的快照。
+			     */
+			    getSnapshot = () => this.#revision;
+			    /**
+			     * Return the selected device ID, or an empty string for system default.
+			     * 返回所选设备标识，系统默认时返回空字符串。
+			     */
+			    getDevice() { return this.#read(DEVICE_KEY); }
+			    /**
+			     * Save a device ID or clear it to use the system default.
+			     * 保存设备标识，或清空以使用系统默认。
+			     */
+			    setDevice(device) { this.#write(DEVICE_KEY, device); }
+			    /**
+			     * Return the saved model ID, or an empty string to follow the site default.
+			     * 返回已保存的模型标识，空字符串表示跟随站点默认。
+			     */
+			    getModelChoice(site) { return this.#read(`${MODEL_KEY}:${site}`); }
+			    /**
+			     * Save a preferred model ID for this site, or clear it to follow the site default.
+			     * 保存当前站点的首选模型标识，或清空以跟随站点默认。
+			     */
+			    setModelChoice(site, id) { this.#write(`${MODEL_KEY}:${site}`, id); }
+			    /**
+			     * Save a language hint for this published model, or clear it for automatic detection.
+			     * 为当前发布模型保存优先语言，或清空以自动识别。
+			     */
+			    setLanguage(site, id, language) { this.#write(`${LANGUAGE_KEY}:${site}:${id}`, language); }
+			    /**
+			     * Resolve the recorded preference against the site default while preserving withdrawn selections.
+			     * 结合站点默认值解析已保存的偏好，并保留已下架的选择。
+			     */
+			    selection(site, catalog) {
+			        const choice = this.getModelChoice(site);
+			        const modelId = choice === '' ? catalog.defaultModelId : choice;
+			        const language = this.#read(`${LANGUAGE_KEY}:${site}:${modelId}`);
+			        return { modelId, ...(language === '' ? {} : { language }) };
+			    }
+			    /**
+			     * Return the local push-to-talk chord, or an empty string when unset.
+			     * 返回本地按住说话组合键，未设置时返回空字符串。
+			     */
+			    getShortcut() { return (0, shortcut_1.normalizeShortcut)(this.#read(SHORTCUT_KEY)); }
+			    /**
+			     * Store a canonical shortcut chord, or remove it.
+			     * 保存规范的快捷键组合，或清除它。
+			     */
+			    setShortcut(chord) { this.#write(SHORTCUT_KEY, chord); }
+			    /**
+			     * Read one saved string with an in-memory value for the current window.
+			     * 读取已保存的字符串，并在当前窗口保留内存值。
+			     */
+			    #read(key) {
+			        const cached = this.#values.get(key);
+			        if (cached !== undefined)
+			            return cached;
+			        let value = '';
+			        try {
+			            value = localStorage.getItem(key) ?? '';
+			        }
+			        catch { /* Storage may be blocked. 存储可能被禁用。 */ }
+			        this.#values.set(key, value);
+			        return value;
+			    }
+			    /**
+			     * Update one preference and notify mounted selectors.
+			     * 更新一项偏好并通知已挂载的选择器。
+			     */
+			    #write(key, value) {
+			        if (value === this.#read(key))
+			            return;
+			        this.#values.set(key, value);
+			        try {
+			            if (value === '')
+			                localStorage.removeItem(key);
+			            else
+			                localStorage.setItem(key, value);
+			        }
+			        catch { /* The selection remains active in this window. 选择在当前窗口仍然有效。 */ }
+			        this.#revision += 1;
+			        for (const listener of this.#listeners)
+			            listener();
+			    }
+			}
+			exports.VoicePreferences = VoicePreferences;
+			/**
+			 * Open the selected microphone exactly, or the system default if no device was selected.
+			 * 精确打开已选麦克风，未选择时打开系统默认设备。
+			 */
+			function openMicrophone(device) {
+			    return navigator.mediaDevices.getUserMedia({ audio: device === '' ? true : { deviceId: { exact: device } } });
+			}
+			/**
+			 * Release every track held by a cancelled or completed operation.
+			 * 释放已取消或已完成操作持有的所有音轨。
+			 */
+			function releaseMicrophone(stream) {
+			    stream?.getTracks().forEach(track => track.stop());
+			}
+
+		},
+		"./shortcut": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.isModifierCode = isModifierCode;
+			exports.normalizeShortcut = normalizeShortcut;
+			exports.shortcutFromKey = shortcutFromKey;
+			exports.releasesShortcut = releasesShortcut;
+			exports.shortcutLabel = shortcutLabel;
+			// Match VulcanCode's physical keys while keeping ordinary typing available.
+			// 匹配 VulcanCode 的物理按键，并保留普通键入。
+			const PRIMARY_KEY = /^(?:Key[A-Z]|Digit[0-9]|Space|F(?:[1-9]|1[0-9]|2[0-4]))$/;
+			const MODIFIER_KEY = /^(?:Control|Alt|Shift|Meta)(?:Left|Right)$/;
+			const MODIFIERS = [
+			    ['ctrlKey', 'Control'], ['altKey', 'Alt'], ['shiftKey', 'Shift'], ['metaKey', 'Meta'],
+			];
+			// Label physical punctuation and numpad keys independently of keyboard layout.
+			// 使用与键盘布局无关的标签显示物理标点及数字键盘按键。
+			const SYMBOLS = {
+			    Backquote: '`', Minus: '-', Equal: '=', BracketLeft: '[', BracketRight: ']', Backslash: '\\',
+			    Semicolon: ';', Quote: "'", Comma: ',', Period: '.', Slash: '/', IntlBackslash: '\\',
+			    IntlRo: '\\', IntlYen: '¥', NumpadAdd: '+', NumpadSubtract: '-', NumpadMultiply: '*',
+			    NumpadDivide: '/', NumpadDecimal: '.', NumpadEqual: '=', NumpadComma: ',',
+			};
+			/**
+			 * Identify whether the supplied physical code is a left or right modifier.
+			 * 判断传入的物理键码是否为左侧或右侧修饰键。
+			 */
+			function isModifierCode(code) {
+			    return MODIFIER_KEY.test(code);
+			}
+			/**
+			 * Return the canonical form of a saved binding, or an empty string when invalid.
+			 * 返回已保存绑定的规范形式，无效时返回空字符串。
+			 */
+			function normalizeShortcut(shortcut) {
+			    if (isModifierCode(shortcut))
+			        return shortcut;
+			    // Older dsh voice versions stored Ctrl where VulcanCode stores Control.
+			    // 旧版 dsh 语音以 Ctrl 表示 VulcanCode 的 Control。
+			    const canonical = shortcut.replace(/^Ctrl\+/, 'Control+');
+			    const modifiers = canonical.split('+');
+			    const code = modifiers.pop();
+			    const ordered = MODIFIERS.map(([, name]) => name).filter(name => modifiers.includes(name));
+			    return code !== undefined && (PRIMARY_KEY.test(code) || Object.hasOwn(SYMBOLS, code))
+			        && modifiers.join('+') === ordered.join('+')
+			        && (code.startsWith('F') || ordered.some(name => name !== 'Shift')) ? canonical : '';
+			}
+			/**
+			 * Return the binding represented by a keydown event, excluding IME and AltGr input.
+			 * 返回按下事件代表的绑定，排除输入法及 AltGr 输入。
+			 */
+			function shortcutFromKey(event) {
+			    if (event.isComposing || event.key === 'AltGraph' || event.getModifierState('AltGraph'))
+			        return '';
+			    const held = MODIFIERS.filter(([field]) => event[field]).map(([, name]) => name);
+			    if (isModifierCode(event.code))
+			        return held.every(name => event.code.startsWith(name)) ? event.code : '';
+			    return normalizeShortcut([...held, event.code].join('+'));
+			}
+			/**
+			 * Recognize the release of the saved physical key or a participating chord modifier.
+			 * 识别已绑定物理键或组合键修饰键的松开。
+			 */
+			function releasesShortcut(shortcut, event) {
+			    if (isModifierCode(shortcut))
+			        return event.code === shortcut;
+			    const parts = shortcut.split('+');
+			    return parts.includes(event.code) || parts.includes(event.key);
+			}
+			/**
+			 * Format a saved binding with localized sides and readable physical key labels.
+			 * 使用本地化左右方向与易读物理键名显示已保存的绑定。
+			 */
+			function shortcutLabel(shortcut, t) {
+			    if (isModifierCode(shortcut)) {
+			        const key = shortcut.replace(/(?:Left|Right)$/, '').replace(/^Control$/, 'Ctrl');
+			        return t(shortcut.endsWith('Left') ? 'shortcutLeft' : 'shortcutRight').replace('{key}', key);
+			    }
+			    return shortcut.split('+').map(code => {
+			        if (code === 'Control')
+			            return 'Ctrl';
+			        const label = SYMBOLS[code] ?? code.replace(/^(?:Key|Digit)(?=[A-Z0-9]$)/, '');
+			        return code.startsWith('Numpad') ? t('shortcutNumpad').replace('{key}', label) : label;
+			    }).join('+');
+			}
+
+		},
+		"./style": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.installStyle = installStyle;
+			// Scope the Vulcan cards and compact controls to the voice plugin and follow the active host palette.
+			// 将 Vulcan 卡片和紧凑控件限定在语音插件范围内，并跟随当前宿主配色。
+			const CSS = String.raw `
+			:is(.vvi-settings, .vvi-composer, .vvi-quick, .vvi-feedback) {
+			  --voice-ink: var(--vulcan-ink, var(--dsw-alias-label-primary));
+			  --voice-muted: var(--vulcan-ink-2, var(--dsw-alias-label-secondary));
+			  --voice-panel: var(--vulcan-panel, var(--dsw-alias-bg-layer-1));
+			  --voice-line: var(--vulcan-line, var(--dsw-alias-border-l3));
+			  --voice-focus: var(--dsw-alias-state-business-primary);
+			  --voice-error: var(--dsw-alias-state-error-primary);
+			  --voice-ember: var(--vulcan-ember, #e2511a);
+			  --voice-ready: #18774a;
+			  color: var(--voice-ink);
+			}
+			body[data-ds-dark-theme] :is(.vvi-settings, .vvi-composer, .vvi-quick, .vvi-feedback) {
+			  --voice-ember: var(--vulcan-ember, #ff6a2b);
+			  --voice-ready: #3fc48a;
+			  color-scheme: dark;
+			}
+			.vvi-settings { display: grid; gap: 16px; min-width: 0; padding-bottom: 8px; font-size: 13px; line-height: 1.5; }
+			.vvi-head h2, .vvi-card h3 { margin: 0; font-weight: 600; }
+			.vvi-head h2 { font-size: 16px; }
+			.vvi-card h3 { font-size: 14px; }
+			.vvi-settings p, .vvi-settings small { margin: 0; color: var(--voice-muted); }
+			.vvi-head p { margin-top: 4px; }
+			.vvi-card {
+			  position: relative; display: grid; gap: 10px; min-width: 0; padding: 14px 16px;
+			  border: 1px solid var(--voice-line); background: var(--voice-panel);
+			}
+			.vvi-card::before { position: absolute; top: -1px; left: -1px; width: 28px; height: 2px; background: var(--voice-ember); content: ''; }
+			.vvi-row, .vvi-state, .vvi-actions { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; min-width: 0; }
+			.vvi-row { justify-content: space-between; gap: 10px 16px; }
+			.vvi-device-row { justify-content: flex-start; }
+			.vvi-state { color: var(--voice-muted); }
+			.vvi-badge {
+			  padding: 1px 6px; border: 1px solid var(--voice-line); color: var(--voice-muted);
+			  font-size: 11px; font-weight: 600;
+			}
+			.vvi-badge[data-voice-status=ready] { color: var(--voice-ready); }
+			.vvi-badge[data-voice-status=signed_out] { color: var(--voice-ember); }
+			:is(.vvi-settings, .vvi-quick) :is(button, select, input), :is(.vvi-composer, .vvi-feedback) button {
+			  box-sizing: border-box; min-height: 28px; padding: 3px 8px; border: 1px solid var(--voice-line);
+			  border-radius: 0; background: var(--voice-panel); color: var(--voice-ink); font: inherit;
+			}
+			:is(.vvi-settings, .vvi-composer, .vvi-quick, .vvi-feedback) button { cursor: pointer; }
+			:is(.vvi-settings, .vvi-composer, .vvi-quick, .vvi-feedback) button:hover:not(:disabled) {
+			  border-color: var(--voice-focus);
+			}
+			:is(.vvi-settings, .vvi-quick) :is(button, select):disabled { opacity: .6; cursor: default; }
+			.vvi-settings .vvi-primary { background: var(--dsw-alias-button-primary-fill); color: var(--dsw-alias-label-primary-foreground); }
+			:is(.vvi-settings, .vvi-quick) :is(button, select, input):focus-visible, :is(.vvi-composer, .vvi-feedback) button:focus-visible {
+			  outline: 2px solid var(--voice-focus); outline-offset: 2px;
+			}
+			.vvi-fields { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 230px), 1fr)); gap: 10px 14px; }
+			.vvi-fields > :is(label, .vvi-quick-shortcut) { display: grid; gap: 4px; min-width: 0; color: var(--voice-muted); }
+			.vvi-fields select, .vvi-shortcut-row input { min-width: 0; width: 100%; }
+			.vvi-shortcut-row { display: flex; gap: 8px; align-items: center; max-width: 380px; }
+			.vvi-shortcut-row button { flex: none; }
+			.vvi-settings .vvi-device-row select { flex: 1 1 200px; max-width: 380px; min-width: 0; }
+			.vvi-settings meter { display: block; width: 100%; height: 8px; border: 0; border-radius: 0; background: var(--voice-line); }
+			.vvi-settings meter::-webkit-meter-bar { height: 8px; border: 0; border-radius: 0; background: var(--voice-line); }
+			.vvi-settings meter::-webkit-meter-optimum-value { border-radius: 0; background: var(--voice-ready); }
+			.vvi-settings meter::-moz-meter-bar { background: var(--voice-ready); }
+			.vvi-settings .vvi-error { color: var(--voice-error); }
+			.vvi-composer { display: inline-flex; align-items: center; font-size: 12px; }
+			.vvi-composer .vvi-mic { display: inline-flex; align-items: center; justify-content: center; width: 28px; padding: 0; touch-action: none; }
+			.vvi-composer .vvi-mic[aria-pressed=true] { color: var(--voice-error); border-color: currentColor; }
+			.vvi-recording { display: inline-flex; align-items: center; gap: 5px; color: var(--voice-error); }
+			.vvi-timer { min-width: 4ch; font-variant-numeric: tabular-nums; text-align: right; }
+			.vvi-dot { width: 6px; height: 6px; background: currentColor; }
+			.vvi-notice { max-width: 18rem; color: var(--voice-muted); }
+			:is(.vvi-quick, .vvi-feedback) {
+			  position: fixed; z-index: 60; box-sizing: border-box; overflow: auto;
+			  border: 1px solid var(--vulcan-line-strong, var(--voice-line)); border-radius: 0;
+			  background: var(--voice-panel); box-shadow: var(--vulcan-shadow-2, 0 8px 24px #0003);
+			  font-size: 12px; line-height: 1.4;
+			}
+			.vvi-quick { width: 336px; display: grid; gap: 10px; padding: 12px; }
+			.vvi-feedback { width: max-content; padding: 6px 8px; }
+			.vvi-feedback-row { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; overflow-wrap: anywhere; }
+			.vvi-feedback-row button { flex: none; min-height: 24px; white-space: nowrap; }
+			.vvi-quick > .vvi-feedback-row { padding-bottom: 8px; border-bottom: 1px solid var(--voice-line); }
+			.vvi-quick::before { position: absolute; top: 0; left: 0; width: 28px; height: 2px; background: var(--voice-ember); content: ''; }
+			.vvi-quick-head { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
+			.vvi-quick-head strong { font-size: 13px; font-weight: 600; }
+			.vvi-quick p, .vvi-quick small { margin: 0; color: var(--voice-muted); }
+			.vvi-quick footer { display: flex; justify-content: flex-end; border-top: 1px solid var(--voice-line); padding-top: 8px; }
+			`;
+			/**
+			 * Mount the scoped voice styles and return a disposer for plugin reload.
+			 * 挂载语音模块限定样式，并返回用于插件重载的注销函数。
+			 */
+			function installStyle() {
+			    const node = document.createElement('style');
+			    node.textContent = CSS;
+			    document.head.append(node);
+			    return () => node.remove();
+			}
+
+		},
+		"./wav": function (module, exports, require) {
+			"use strict";
+			Object.defineProperty(exports, "__esModule", { value: true });
+			exports.encodeVoiceInputWav = encodeVoiceInputWav;
+			// Resample speech at 16 kHz to keep the full recording within the ASR request size limit.
+			// 语音重采样至 16 kHz，使最长录音也能满足语音识别请求体积限制。
+			const VOICE_SAMPLE_RATE = 16_000;
+			// A PCM WAV file uses a 44-byte header before the sample data.
+			// PCM WAV 文件在采样数据之前使用 44 字节的文件头。
+			const WAV_HEADER_BYTES = 44;
+			// The PCM format uses signed 16-bit samples, stored as two little-endian bytes.
+			// PCM 格式使用有符号 16 位采样，每个采样占两个小端字节。
+			const PCM_SAMPLE_BYTES = 2;
+			/**
+			 * Decode the finished browser recording and return one mono PCM WAV blob for transcription.
+			 * 解码已录制完成的浏览器音频，返回一个供转写使用的单声道 PCM WAV Blob。
+			 * @param recording A complete recording produced by MediaRecorder.
+			 * recording 是 MediaRecorder 生成的完整录音。
+			 * @param maxSeconds The site's maximum recording duration, in seconds.
+			 * maxSeconds 是站点允许的最长录音时长，单位为秒。
+			 * @returns A 16 kHz WAV blob, or null when every encoded PCM sample is silent.
+			 * 返回采样率为 16 kHz 的 WAV Blob；编码后的 PCM 采样全为静音时返回 null。
+			 */
+			async function encodeVoiceInputWav(recording, maxSeconds) {
+			    // The offline decoder resamples to its context rate without playing the microphone recording.
+			    // 离线解码器会重采样至上下文的采样率，且不会播放麦克风录音。
+			    const decoder = new OfflineAudioContext(1, 1, VOICE_SAMPLE_RATE);
+			    // The decoded PCM buffer keeps its original channel count.
+			    // 解码后的 PCM 缓冲区保留原声道数量。
+			    const audio = await decoder.decodeAudioData(await recording.arrayBuffer());
+			    // Store one PCM sample per decoded frame after mixing the channels.
+			    // 混合声道后，每个解码帧保存一个 PCM 采样。
+			    const frames = Math.min(audio.length, maxSeconds * VOICE_SAMPLE_RATE);
+			    const sampleBytes = frames * PCM_SAMPLE_BYTES;
+			    // Allocate the header and sample data together for a single WAV blob.
+			    // 为文件头和采样数据分配同一块缓冲区，生成一个 WAV Blob。
+			    const bytes = new ArrayBuffer(WAV_HEADER_BYTES + sampleBytes);
+			    // The view writes the RIFF identifiers and little-endian PCM fields into that buffer.
+			    // 通过该视图将 RIFF 标识和小端 PCM 字段写入缓冲区。
+			    const wav = new DataView(bytes);
+			    wav.setUint32(0, 0x52494646); // RIFF
+			    wav.setUint32(4, bytes.byteLength - 8, true);
+			    wav.setUint32(8, 0x57415645); // WAVE
+			    wav.setUint32(12, 0x666d7420); // fmt
+			    wav.setUint32(16, 16, true);
+			    wav.setUint16(20, 1, true);
+			    wav.setUint16(22, 1, true);
+			    wav.setUint32(24, audio.sampleRate, true);
+			    wav.setUint32(28, audio.sampleRate * PCM_SAMPLE_BYTES, true);
+			    wav.setUint16(32, PCM_SAMPLE_BYTES, true);
+			    wav.setUint16(34, PCM_SAMPLE_BYTES * 8, true);
+			    wav.setUint32(36, 0x64617461); // data
+			    wav.setUint32(40, sampleBytes, true);
+			    // Average channels before quantizing so either input channel can carry speech.
+			    // 量化前取各声道平均值，保留任一输入声道上的语音。
+			    const channels = Array.from({ length: audio.numberOfChannels }, (_, channel) => audio.getChannelData(channel));
+			    // Use the encoded PCM to detect silence so even the quietest representable sample is kept.
+			    // 按编码后的 PCM 检测静音，保留所有可表示的微弱声音。
+			    let hasSignal = false;
+			    for (let frame = 0; frame < frames; frame += 1) {
+			        // Sum this frame across all channels for the mono mix.
+			        // 累加本帧的各声道采样，用于混合成单声道。
+			        let sum = 0;
+			        // All channels have audio.length samples, and frames is capped at that length.
+			        // 每个声道都有 audio.length 个采样，frames 已限制在该长度内。
+			        for (const channel of channels)
+			            sum += channel[frame];
+			        // Clamp the quantized average so full-scale samples cannot wrap around.
+			        // 限制量化后平均值的范围，避免满幅采样发生溢出回绕。
+			        const sample = Math.round(Math.max(-32_768, Math.min(32_767, sum / channels.length * 32_768)));
+			        wav.setInt16(WAV_HEADER_BYTES + frame * PCM_SAMPLE_BYTES, sample, true);
+			        if (sample !== 0)
+			            hasSignal = true;
+			    }
+			    return hasSignal ? new Blob([bytes], { type: "audio/wav" }) : null;
+			}
+
+		},
+		};
+		var cache = {};
+		function load(request) {
+			if (!(request in definitions)) return platformRequire(request);
+			if (!(request in cache)) {
+				var module = { exports: {} };
+				cache[request] = module;
+				definitions[request](module, module.exports, load);
+			}
+			return cache[request].exports;
+		}
+		return load('./index');
+	}
+});