@deepseek-ai/dsh-experimental-client-ui-voice-input 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,37 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/experimental/client-ui-voice-input/README.md
-README.md: 4d859f4d9837c249c564abfbba0682f1493502d9
-README.zh.md: 84a02e4f620feb35706de5b3bc10ec291f32c423
+/:
+  en: 03616f946faebe55
+  zh: 293309d5ea63305e
+/deepseek-ai-dsh-experimental-client-ui-voice-input:
+  en: e9ad8d109a27c143
+  zh: cb09880ab2ce8942
+/deepseek-ai-dsh-experimental-client-ui-voice-input/summary:
+  en: a75bfd33f96a2e7a
+  zh: 6866534c6a3e0662
+/deepseek-ai-dsh-experimental-client-ui-voice-input/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 364c80ee00a374ff
+/deepseek-ai-dsh-experimental-client-ui-voice-input/use-this-package:
+  en: 44f25ad14ceda123
+  zh: 43c4680be42af1cf
+/deepseek-ai-dsh-experimental-client-ui-voice-input/understand-the-implementation:
+  en: 18807008bccfdb6e
+  zh: bb5a82c92d4aa056
+/deepseek-ai-dsh-experimental-client-ui-voice-input/further-exploration:
+  en: 5c64426add9d79d6
+  zh: 4e06aa2ead8d2ccd
+/deepseek-ai-dsh-experimental-client-ui-voice-input/model-experience:
+  en: 3c5a85f8b7129ce8
+  zh: d5f491ca88d9a810
+/deepseek-ai-dsh-experimental-client-ui-voice-input/model-experience/kv-cache-effect:
+  en: b5ec79db2e1d0dbc
+  zh: e5aff567ae5ee6fc
+/deepseek-ai-dsh-experimental-client-ui-voice-input/known-limitations-and-deferred-work:
+  en: e6d37618956f3ff8
+  zh: ebb74dd513ece5e3
+/deepseek-ai-dsh-experimental-client-ui-voice-input/known-limitations-and-deferred-work/dev-note:
+  en: 0225ba087c5266f3
+  zh: 4e706f1b2b984e63

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-This optional browser plugin adds an outline microphone icon between the model selector and Send. Clicking it opens a recording toolbar with measured audio levels, Cancel and Stop. The waveform stays shorter than the recording buttons. Stopping transcribes into the draft. Recognition preferences and model preparation live in plugin settings; language choices come from the selected provider.
+This optional browser plugin adds an outline microphone icon between the model selector and Send. When recognition is ready, clicking it opens a recording toolbar with measured audio levels, Cancel and Stop. The waveform stays shorter than the recording buttons. Stopping transcribes into the draft. Recognition preferences and model preparation live in plugin settings; language choices come from the selected provider.
 
 ## Table of Contents
 
@@ -25,7 +25,9 @@ This optional browser plugin adds an outline microphone icon between the model s
 <a id="use-this-package"></a>
 ## Use this package
 
-Enable the [voice input bundle](../voice-input-bundle/README.md) from Plugins. After cache inspection, missing models trigger a setup prompt with Go to setup and Later actions. Go to setup opens bundle details; Download and prepare starts installation there. Intact cached models need no prompt or repeated installation. Before preparation, local providers can show their estimated disk, memory and setup-time requirements. The preparation summary starts collapsed; expand it to inspect completed, current and pending steps. Once ready, click the microphone, allow access and click Stop to transcribe. Cancel or Escape discards capture. Recognition feedback stays inside the toolbar. Provider and language preferences are saved from bundle details through the Settings service. Browser microphone access requires HTTPS or loopback and operating-system permission.
+Enable the [voice input bundle](../voice-input-bundle/README.md) from Plugins. After cache inspection, missing models trigger a setup prompt with Go to setup and Later actions. Go to setup opens bundle details; Download and prepare starts installation there. Intact cached models need no prompt or repeated installation. Before recognition is ready, guidance appears only on click, with no microphone tooltip. Clicking the microphone opens the same guidance dialog; its action opens the voice bundle details without recording or downloading. Cache inspection, preparation in progress, failures and disconnected services instead offer navigation to status, progress or error details. The dialog moves focus to its navigation action and keeps Tab traversal inside it; Later or Escape restores the previous focus without changing or submitting the draft. Before preparation, local providers can show their estimated disk, memory and setup-time requirements. The preparation summary starts collapsed; expand it to inspect completed, current and pending steps. Once ready, click the microphone, allow access and click Stop to transcribe. Cancel or Escape discards capture. Recognition feedback stays inside the toolbar. Provider and language preferences are saved from bundle details through the Settings service. Browser microphone access requires HTTPS or loopback and operating-system permission.
+
+Before downloading or retrying, **Model download source** offers Automatic and the origins advertised by the Host. SenseVoice normally offers Hugging Face and HF-Mirror; a fixed private deployment exposes only its configured origin. Manual selection uses only that source, while Automatic preserves the provider’s comparison and fallback policy. The choice is retained for retries in the current card, without changing deployment configuration or recognition preferences. Source controls are unavailable during preparation and hidden when resources are ready.
 
 -----
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-此可选浏览器插件在模型选择器与发送按钮之间添加空心麦克风图标。点击后展开录音栏，显示实际音量以及取消、停止按钮。声波高度低于录音按钮高度。停止后转写到草稿。识别偏好和模型准备放在插件设置中；语言选项来自所选 Provider。
+此可选浏览器插件在模型选择器与发送按钮之间添加空心麦克风图标。识别就绪后，点击展开录音栏，显示实际音量以及取消、停止按钮。声波高度低于录音按钮高度。停止后转写到草稿。识别偏好和模型准备放在插件设置中；语言选项来自所选 Provider。
 
 ## 目录
 
@@ -25,7 +25,9 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用此包
 
-在插件管理页启用[语音输入 Bundle](../voice-input-bundle/README.zh.md)。缓存检查后，缺少模型时弹出安装引导，可选择“前往安装”或“稍后”。“前往安装”打开 Bundle 详情，再点击“下载并准备”才开始安装。缓存完整时不弹引导，也无需重复安装。准备前，本地 Provider 可展示磁盘、内存与安装时间的估算。准备摘要默认折叠；展开后可查看已完成、当前和未开始的步骤。就绪后点击麦克风，允许访问，再点击停止以转写。取消或 Escape 丢弃录音。识别反馈留在工具栏内部。Provider 和语言偏好在 Bundle 详情中通过 Settings 服务保存。浏览器麦克风访问需要 HTTPS 或环回地址，以及操作系统权限。
+在插件管理页启用[语音输入 Bundle](../voice-input-bundle/README.zh.md)。缓存检查后，缺少模型时弹出安装引导，可选择“前往安装”或“稍后”。“前往安装”打开 Bundle 详情，再点击“下载并准备”才开始安装。缓存完整时不弹引导，也无需重复安装。识别未就绪时不显示麦克风悬停提示，点击后才打开同一个引导弹窗；点击引导按钮进入语音 Bundle 详情，不会录音或下载。缓存检查、正在准备、准备失败或服务断连时，弹窗改为引导查看状态、进度或错误详情。弹窗将焦点移到导航按钮，并将 Tab 切换约束在弹窗内；选择“稍后”或按 Escape 关闭时恢复此前焦点，不改变或提交草稿。准备前，本地 Provider 可展示磁盘、内存与安装时间的估算。准备摘要默认折叠；展开后可查看已完成、当前和未开始的步骤。就绪后点击麦克风，允许访问，再点击停止以转写。取消或 Escape 丢弃录音。识别反馈留在工具栏内部。Provider 和语言偏好在 Bundle 详情中通过 Settings 服务保存。浏览器麦克风访问需要 HTTPS 或环回地址，以及操作系统权限。
+
+下载或重试前，**模型下载源**提供自动选择及 Host 公布的源。SenseVoice 默认提供 Hugging Face 和 HF-Mirror；固定私有部署仅显示配置的源。手动选择只使用指定源，自动选择沿用提供方的比较与回退策略。当前卡片中的重试会保留选择，不修改部署配置或识别偏好。准备期间不能改源，资源就绪后隐藏源选择器。
 
 -----
 

package/lib/client.js

@@ -614,6 +614,7 @@ window.__ModuleLoader__.load({
 		};
 		const integer = /^-?\d+$/;
 		const number$1 = /^-?\d+(?:\.\d+)?$/;
+		const _undefined$2 = /^undefined$/i;
 		const lowercase = /^[^A-Z]*$/;
 		const uppercase = /^[^a-z]*$/;
 		//#endregion
@@ -1408,6 +1409,22 @@ window.__ModuleLoader__.load({
 			$ZodCheckNumberFormat.init(inst, def);
 			$ZodNumber.init(inst, def);
 		});
+		const $ZodUndefined = /*@__PURE__*/ $constructor("$ZodUndefined", (inst, def) => {
+			$ZodType.init(inst, def);
+			inst._zod.pattern = _undefined$2;
+			inst._zod.values = new Set([void 0]);
+			inst._zod.parse = (payload, _ctx) => {
+				const input = payload.value;
+				if (typeof input === "undefined") return payload;
+				payload.issues.push({
+					expected: "undefined",
+					code: "invalid_type",
+					input,
+					inst
+				});
+				return payload;
+			};
+		});
 		const $ZodUnknown = /*@__PURE__*/ $constructor("$ZodUnknown", (inst, def) => {
 			$ZodType.init(inst, def);
 			inst._zod.parse = (payload) => payload;
@@ -2472,6 +2489,13 @@ window.__ModuleLoader__.load({
 			});
 		}
 		// @__NO_SIDE_EFFECTS__
+		function _undefined$1(Class, params) {
+			return new Class({
+				type: "undefined",
+				...normalizeParams(params)
+			});
+		}
+		// @__NO_SIDE_EFFECTS__
 		function _unknown(Class) {
 			return new Class({ type: "unknown" });
 		}
@@ -3024,6 +3048,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			else if (typeof maximum === "number") json.maximum = maximum;
 			if (typeof multipleOf === "number") json.multipleOf = multipleOf;
 		};
+		const undefinedProcessor = (_schema, ctx, _json, _params) => {
+			if (ctx.unrepresentable === "throw") throw new Error("Undefined cannot be represented in JSON Schema");
+		};
 		const voidProcessor = (_schema, ctx, _json, _params) => {
 			if (ctx.unrepresentable === "throw") throw new Error("Void cannot be represented in JSON Schema");
 		};
@@ -3676,6 +3703,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function int(params) {
 			return /* @__PURE__ */ _int(ZodNumberFormat, params);
 		}
+		const ZodUndefined = /*@__PURE__*/ $constructor("ZodUndefined", (inst, def) => {
+			$ZodUndefined.init(inst, def);
+			ZodType.init(inst, def);
+			inst._zod.processJSONSchema = (ctx, json, params) => undefinedProcessor(inst, ctx, json, params);
+		});
+		function _undefined(params) {
+			return /* @__PURE__ */ _undefined$1(ZodUndefined, params);
+		}
 		const ZodUnknown = /*@__PURE__*/ $constructor("ZodUnknown", (inst, def) => {
 			$ZodUnknown.init(inst, def);
 			ZodType.init(inst, def);
@@ -4204,7 +4239,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					"expectedMemoryBytes": number().readonly(),
 					"minimumMinutes": number().readonly(),
 					"maximumMinutes": number().readonly()
-				}).readonly().optional()
+				}).readonly().optional(),
+				"downloadSources": array(string()).readonly().optional()
 			})).readonly(),
 			"selection": object({
 				"providerId": intersection(string(), unknown()).readonly(),
@@ -4375,7 +4411,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					"expectedMemoryBytes": number().readonly(),
 					"minimumMinutes": number().readonly(),
 					"maximumMinutes": number().readonly()
-				}).readonly().optional()
+				}).readonly().optional(),
+				"downloadSources": array(string()).readonly().optional()
 			})).readonly(),
 			"selection": object({
 				"providerId": intersection(string(), unknown()).readonly(),
@@ -4384,6 +4421,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		});
 		let _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_0$schema$value;
 		const _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_0$schema = () => _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_0$schema$value ??= intersection(string(), unknown());
+		let _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_1$schema$value;
+		const _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_1$schema = () => _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_1$schema$value ??= union([_undefined(), object({ "downloadSource": string().readonly().optional() })]);
 		let _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_result$schema$value;
 		const _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_result$schema = () => _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_result$schema$value ??= _void();
 		let _deepseek_ai_dsh_experimental_api_speech_to_text_speech_transcribe_parameter_0$schema$value;
@@ -4424,7 +4463,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/experimental/api-speech-to-text/src/index.ts",
-						"line": 79,
+						"line": 80,
 						"column": 3
 					}
 				},
@@ -4508,6 +4547,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 							typeSymbol: "@deepseek-ai/dsh-experimental-speech-to-text/types#SpeechProviderId",
 							create: _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_0$schema
 						}
+					}, {
+						name: "options",
+						wire: "options",
+						source: "json",
+						acceptsUndefined: true,
+						codec: {
+							mode: "strict",
+							typeSymbol: "@deepseek-ai/dsh-experimental-speech-to-text/types#SpeechPreparationOptions",
+							create: _deepseek_ai_dsh_experimental_api_speech_to_text_speech_prepare_parameter_1$schema
+						}
 					}],
 					result: {
 						mode: "strict",
@@ -4516,7 +4565,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/experimental/api-speech-to-text/src/index.ts",
-						"line": 71,
+						"line": 72,
 						"column": 3
 					}
 				},
@@ -4544,7 +4593,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					},
 					sourceLocation: {
 						"file": "packages/experimental/api-speech-to-text/src/index.ts",
-						"line": 88,
+						"line": 89,
 						"column": 9
 					}
 				}
@@ -4753,7 +4802,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		};
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/experimental/client-ui-voice-input/src/client/VoiceInput.module.css.mjs
-		const css = ".ddpbLW_trigger{flex:none;width:28px;padding:0}.ddpbLW_triggerAnchor{flex:none;display:inline-flex}.ddpbLW_captureRow{align-items:center;gap:12px;width:100%;min-width:0;min-height:34px;display:flex}.ddpbLW_roundButton{corner-shape:round;background:var(--dsw-specific-selector);border-radius:50%;flex:none;width:32px;height:32px;padding:0}.ddpbLW_roundButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.ddpbLW_waveform{width:0;min-width:24px;height:24px;color:var(--dsw-alias-label-secondary);flex:1;display:block}.ddpbLW_activityMessage{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;text-overflow:ellipsis;flex:1;align-items:center;gap:8px;font-size:12px;display:flex;overflow:hidden}.ddpbLW_inlineAction{flex:none}.ddpbLW_preparation{border:.5px solid var(--dsw-alias-border-l1);border-radius:10px;flex-direction:column;gap:10px;margin:12px 0;padding:14px;font-size:13px;display:flex}.ddpbLW_preparation p{margin:0}.ddpbLW_preparationActions{gap:8px;display:flex}.ddpbLW_preparationActions:empty{display:none}.ddpbLW_preparationError{color:var(--dsw-alias-state-error-primary);overflow-wrap:anywhere;font-size:12px}.ddpbLW_downloadFailure{overflow-wrap:anywhere;gap:6px;display:grid}.ddpbLW_summaryRow{flex-wrap:wrap;gap:4px;height:auto;min-height:28px}.ddpbLW_summaryTitle{flex:1;min-width:0}.ddpbLW_metric{color:var(--dsw-alias-label-tertiary);font-size:12px}.ddpbLW_progress{width:100%;height:6px;accent-color:var(--dsw-alias-state-business-primary)}.ddpbLW_steps{flex-direction:column;gap:14px;margin:0;padding:16px 0 2px;list-style:none;display:flex}.ddpbLW_steps li{align-items:flex-start;gap:10px;line-height:18px;display:flex}.ddpbLW_steps li>:first-child{margin-top:1px}.ddpbLW_steps li[data-step-state=pending]{color:var(--dsw-alias-label-tertiary)}.ddpbLW_stepBody{flex:1;min-width:0}.ddpbLW_stepProgress{flex-direction:column;gap:6px;margin-top:6px;display:flex}.ddpbLW_stepProgress small{color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere;font-size:11px}.ddpbLW_preferences{gap:12px;margin:18px 0;font-size:13px;display:grid}.ddpbLW_preferences label{grid-template-columns:100px minmax(120px,280px);align-items:center;gap:12px;display:grid}.ddpbLW_preferences select{border:.5px solid var(--dsw-alias-border-l1);color:inherit;font:inherit;background:0 0;border-radius:6px;padding:6px 10px}.ddpbLW_preferences p{margin:0}.ddpbLW_settingsCard{border:.5px solid var(--dsw-alias-border-l1);border-radius:10px;padding:16px;list-style:none}.ddpbLW_settingsCard>p{color:var(--dsw-alias-label-secondary);margin:8px 0 0;font-size:13px}.ddpbLW_setupEstimate{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);border-radius:8px;gap:10px;padding:12px;line-height:1.6;display:grid}.ddpbLW_setupEstimate dl{gap:6px;margin:0;display:grid}.ddpbLW_setupEstimate dl>div{grid-template-columns:72px minmax(0,1fr);gap:10px;display:grid}.ddpbLW_setupEstimate dt{color:var(--dsw-alias-label-tertiary)}.ddpbLW_setupEstimate dd{margin:0}.ddpbLW_setupEstimate small{color:var(--dsw-alias-label-tertiary);font-size:12px}";
+		const css = ".ddpbLW_trigger{flex:none;width:28px;padding:0}.ddpbLW_triggerAnchor{flex:none;display:inline-flex}.ddpbLW_captureRow{align-items:center;gap:12px;width:100%;min-width:0;min-height:34px;display:flex}.ddpbLW_roundButton{corner-shape:round;background:var(--dsw-specific-selector);border-radius:50%;flex:none;width:32px;height:32px;padding:0}.ddpbLW_roundButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.ddpbLW_waveform{width:0;min-width:24px;height:24px;color:var(--dsw-alias-label-secondary);flex:1;display:block}.ddpbLW_activityMessage{min-width:0;color:var(--dsw-alias-label-secondary);white-space:nowrap;text-overflow:ellipsis;flex:1;align-items:center;gap:8px;font-size:12px;display:flex;overflow:hidden}.ddpbLW_inlineAction{flex:none}.ddpbLW_preparation{border:.5px solid var(--dsw-alias-border-l1);border-radius:10px;flex-direction:column;gap:10px;margin:12px 0;padding:14px;font-size:13px;display:flex}.ddpbLW_preparation p{margin:0}.ddpbLW_preparationActions{gap:8px;display:flex}.ddpbLW_preparationActions:empty{display:none}.ddpbLW_preparationError{color:var(--dsw-alias-state-error-primary);overflow-wrap:anywhere;font-size:12px}.ddpbLW_downloadFailure{overflow-wrap:anywhere;gap:6px;display:grid}.ddpbLW_summaryRow{flex-wrap:wrap;gap:4px;height:auto;min-height:28px}.ddpbLW_summaryTitle{flex:1;min-width:0}.ddpbLW_metric{color:var(--dsw-alias-label-tertiary);font-size:12px}.ddpbLW_progress{width:100%;height:6px;accent-color:var(--dsw-alias-state-business-primary)}.ddpbLW_steps{flex-direction:column;gap:14px;margin:0;padding:16px 0 2px;list-style:none;display:flex}.ddpbLW_steps li{align-items:flex-start;gap:10px;line-height:18px;display:flex}.ddpbLW_steps li>:first-child{margin-top:1px}.ddpbLW_steps li[data-step-state=pending]{color:var(--dsw-alias-label-tertiary)}.ddpbLW_stepBody{flex:1;min-width:0}.ddpbLW_stepProgress{flex-direction:column;gap:6px;margin-top:6px;display:flex}.ddpbLW_stepProgress small{color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere;font-size:11px}.ddpbLW_preferences{gap:12px;margin:18px 0;font-size:13px;display:grid}.ddpbLW_preferences label,.ddpbLW_sourceChoice label{grid-template-columns:100px minmax(120px,280px);align-items:center;gap:12px;display:grid}.ddpbLW_preferences select,.ddpbLW_sourceChoice select{border:.5px solid var(--dsw-alias-border-l1);color:inherit;font:inherit;background:0 0;border-radius:6px;padding:6px 10px}.ddpbLW_sourceChoice{gap:6px;display:grid}.ddpbLW_preferences p{margin:0}.ddpbLW_settingsCard{border:.5px solid var(--dsw-alias-border-l1);border-radius:10px;padding:16px;list-style:none}.ddpbLW_settingsCard>p{color:var(--dsw-alias-label-secondary);margin:8px 0 0;font-size:13px}.ddpbLW_setupEstimate{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);border-radius:8px;gap:10px;padding:12px;line-height:1.6;display:grid}.ddpbLW_setupEstimate dl{gap:6px;margin:0;display:grid}.ddpbLW_setupEstimate dl>div{grid-template-columns:72px minmax(0,1fr);gap:10px;display:grid}.ddpbLW_setupEstimate dt{color:var(--dsw-alias-label-tertiary)}.ddpbLW_setupEstimate dd{margin:0}.ddpbLW_setupEstimate small{color:var(--dsw-alias-label-tertiary);font-size:12px}";
 		const tagId = "@deepseek-ai/dsh-experimental-client-ui-voice-input/VoiceInput.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -4776,6 +4825,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"roundButton": "ddpbLW_roundButton",
 			"settingsCard": "ddpbLW_settingsCard",
 			"setupEstimate": "ddpbLW_setupEstimate",
+			"sourceChoice": "ddpbLW_sourceChoice",
 			"stepBody": "ddpbLW_stepBody",
 			"stepProgress": "ddpbLW_stepProgress",
 			"steps": "ddpbLW_steps",
@@ -4837,6 +4887,33 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			});
 		}
 		//#endregion
+		//#region lib/types/client/VoiceSetupDialog.js
+		/** Shared modal for voice activation and unavailable recognition. */
+		/**
+		* Guide activation or microphone clicks to the existing plugin details.
+		* @param props - visibility, installation need and navigation callbacks.
+		* @returns a dismissible prompt that never starts preparation or recording.
+		*/
+		function VoiceSetupDialog({ open, needsInstallation, onDismiss, onOpenDetails, t }) {
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+				open,
+				title: t(needsInstallation ? "setupPrompt.title" : "setupPrompt.unavailableTitle"),
+				closeLabel: t("cancel"),
+				onClose: onDismiss,
+				footer: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "ghost",
+					onClick: onDismiss,
+					children: t("setupPrompt.later")
+				}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "primary",
+					"data-modal-autofocus": true,
+					onClick: onOpenDetails,
+					children: t(needsInstallation ? "setupPrompt.open" : "setupPrompt.details")
+				})] }),
+				children: (0, react_jsx_runtime.jsx)("p", { children: t(needsInstallation ? "setupPrompt.body" : "setupPrompt.unavailableBody") })
+			});
+		}
+		//#endregion
 		//#region lib/types/client/VoiceInput.js
 		/** Click-to-record toolbar activity; transcripts remain in the original Session draft. */
 		async function disposeRecording(capture) {
@@ -4845,11 +4922,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			} catch (_error) {}
 		}
 		/** Render a compact microphone or an expanded capture, transcription, or retry row. */
-		function VoiceInput({ sessionId, inputActions, locked, onActiveChange, createRecording, transcribe, useSpeechReadiness, t }) {
+		function VoiceInput({ sessionId, inputActions, locked, onActiveChange, createRecording, transcribe, openSettings, useSpeechReadiness, t }) {
 			const readiness = useSpeechReadiness((value) => value), catalog = readiness.catalog;
 			const provider = catalog?.providers.find((item) => item.id === catalog.selection.providerId);
 			const usable = readiness.connected && (provider?.preparation.phase === "ready" || provider?.preparation.phase === "standby" || provider?.preparation.phase === "waking");
 			const [phase, setPhase] = (0, react.useState)("idle"), [message, setMessage] = (0, react.useState)(""), [pending, setPending] = (0, react.useState)("");
+			const [setupOpen, setSetupOpen] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				if (usable) setSetupOpen(false);
+			}, [usable]);
 			const current = (0, react.useRef)(), generation = (0, react.useRef)(0);
 			const expanded = phase !== "idle";
 			(0, react.useLayoutEffect)(() => {
@@ -4870,11 +4951,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				setPending("");
 				setMessage("");
 				setPhase("idle");
+				setSetupOpen(false);
 			};
 			(0, react.useEffect)(() => {
 				setPending("");
 				setMessage("");
 				setPhase("idle");
+				setSetupOpen(false);
 				const blur = () => {
 					if (current.current?.phase === "recording") cancel();
 				};
@@ -4987,8 +5070,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}
 				}
 			};
-			if (!expanded) return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-				label: t(usable ? "dictate" : "prepareRequired"),
+			if (!expanded) return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: t("dictate"),
+				disabled: !usable,
 				side: "top",
 				portal: true,
 				children: (0, react_jsx_runtime.jsx)("span", {
@@ -4996,18 +5080,31 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 						className: VoiceInput_module_css_default.trigger,
 						size: "sm",
-						disabled: !usable || locked,
-						"aria-label": t("start"),
+						disabled: locked,
+						"aria-label": t(usable ? "start" : "setupPrompt.trigger"),
+						"aria-haspopup": usable ? void 0 : "dialog",
 						onMouseDown: (event) => {
 							event.preventDefault();
 						},
 						onClick: () => {
-							start();
+							if (usable) start();
+							else setSetupOpen(true);
 						},
 						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconMicrophoneOutlineRegular, { size: 18 })
 					})
 				})
-			});
+			}), (0, react_jsx_runtime.jsx)(VoiceSetupDialog, {
+				open: setupOpen && !usable,
+				needsInstallation: readiness.connected && provider?.location === "host-local" && provider.preparation.phase === "unprepared",
+				onDismiss: () => {
+					setSetupOpen(false);
+				},
+				onOpenDetails: () => {
+					setSetupOpen(false);
+					openSettings();
+				},
+				t
+			})] });
 			return (0, react_jsx_runtime.jsxs)("div", {
 				className: VoiceInput_module_css_default.captureRow,
 				"data-voice-activity": phase,
@@ -5075,6 +5172,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"setupPrompt.body": "语音输入插件已开启。首次使用需要在本机下载并准备识别模型，请前往插件详情页查看空间、内存和时间说明，再开始安装。",
 			"setupPrompt.later": "稍后",
 			"setupPrompt.open": "前往安装",
+			"setupPrompt.trigger": "打开语音输入引导",
+			"setupPrompt.details": "前往语音插件设置",
+			"setupPrompt.unavailableTitle": "语音识别尚未就绪",
+			"setupPrompt.unavailableBody": "请前往语音插件详情页查看识别服务状态、准备进度或错误信息",
 			"setup.local": "将在运行 DSH 的机器上下载本地模型，无需安装 Python 或编译工具。",
 			"setup.disk": "硬盘空间",
 			"setup.diskValue": "建议预留约 {gb} GB，包含模型、运行时和下载缓存",
@@ -5122,6 +5223,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"downloadAdvice.storage": "请检查运行 DSH 的机器的剩余磁盘空间，以及模型目录的写入权限后重试。",
 			"downloadAdvice.unknown": "请检查运行 DSH 的机器的网络、磁盘空间和模型目录权限后重试。",
 			downloadSource: "下载来源：{source}",
+			sourceChoice: "模型下载源",
+			sourceAuto: "自动选择（推荐）",
+			sourceHuggingFace: "Hugging Face",
+			sourceMirror: "HF-Mirror（国内镜像）",
+			sourceAutoHelp: "优先使用响应较快的源，下载失败时自动尝试其他源。",
+			sourceManualHelp: "仅从所选源下载；已下载并通过校验的文件会复用。",
 			downloadCode: "错误码：{code}",
 			"reconnecting": "正在连接语音服务…",
 			"preparation.unprepared": "首次使用需要下载本地识别模型。",
@@ -5133,7 +5240,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"preparation.cancelled": "准备已取消，已完成的下载会保留。",
 			"preparation.cancelling": "正在取消准备…",
 			cloudReady: "云端语音识别已就绪。",
-			prepareRequired: "请先在语音插件设置中准备识别服务",
 			discard: "丢弃识别文字",
 			transcribingShort: "识别中…",
 			wakingShort: "唤醒中…",
@@ -5153,7 +5259,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			requesting: "请允许使用麦克风…",
 			recording: "正在录音…",
 			interrupted: "录音中断，请重试。",
-			local: "音频在运行 DSH 的机器上识别。首次准备默认从 Hugging Face 下载模型，该机器需要能访问 Hugging Face 及其模型下载服务。如需代理，请在该机器上配置。",
+			local: "音频在运行 DSH 的机器上识别。需要下载模型时，请确保该机器能访问所选下载源及其文件服务。如需代理，请在该机器上配置。",
 			cloud: "音频将发送至所选云端服务。",
 			empty: "未识别到语音",
 			cancelled: "已取消语音输入。",
@@ -5170,6 +5276,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"setupPrompt.body": "Voice input is enabled. First use requires downloading and preparing local recognition models. Open the plugin details to review disk space, memory and time estimates before starting setup.",
 			"setupPrompt.later": "Later",
 			"setupPrompt.open": "Go to setup",
+			"setupPrompt.trigger": "Open voice input setup",
+			"setupPrompt.details": "Open voice plugin settings",
+			"setupPrompt.unavailableTitle": "Speech recognition is not ready",
+			"setupPrompt.unavailableBody": "Open the voice plugin details to check recognition status, preparation progress, or errors.",
 			"setup.local": "Local models will be downloaded to the machine running DSH. No Python or compiler is required.",
 			"setup.disk": "Disk space",
 			"setup.diskValue": "Allow about {gb} GB for models, runtime, and download caches",
@@ -5217,6 +5327,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"downloadAdvice.storage": "Check available disk space and write permission for the model directory on the machine running DSH, then retry.",
 			"downloadAdvice.unknown": "Check the network, disk space and model directory permissions on the machine running DSH, then retry.",
 			downloadSource: "Download source: {source}",
+			sourceChoice: "Model download source",
+			sourceAuto: "Automatic (recommended)",
+			sourceHuggingFace: "Hugging Face",
+			sourceMirror: "HF-Mirror (China mirror)",
+			sourceAutoHelp: "Prefer the first responding source and try another if a download fails.",
+			sourceManualHelp: "Download only from the selected source. Verified downloaded files are reused.",
 			downloadCode: "Error code: {code}",
 			"reconnecting": "Connecting to speech recognition…",
 			"preparation.unprepared": "First use downloads the local recognition models.",
@@ -5228,7 +5344,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			"preparation.cancelled": "Preparation cancelled. Completed downloads are retained.",
 			"preparation.cancelling": "Cancelling preparation…",
 			cloudReady: "Cloud speech recognition is ready.",
-			prepareRequired: "Prepare recognition in the voice plugin settings first",
 			discard: "Discard transcript",
 			transcribingShort: "Transcribing…",
 			wakingShort: "Waking…",
@@ -5248,7 +5363,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			requesting: "Allow microphone access to continue…",
 			recording: "Recording…",
 			interrupted: "Recording was interrupted. Please try again.",
-			local: "Audio is recognized on the machine running DSH. First setup downloads models from Hugging Face by default, so that machine must be able to access Hugging Face and its model download services. If a proxy is needed, configure it on that machine.",
+			local: "Audio is recognized on the machine running DSH. If models need downloading, that machine must be able to reach the selected source and its file services. Configure a proxy on that machine if needed.",
 			cloud: "Audio will be sent to the selected cloud service.",
 			empty: "No speech recognized",
 			cancelled: "Voice input cancelled.",
@@ -5367,6 +5482,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function PreparationCard({ provider, connected, prepare, cancelPreparation, t }) {
 			const state = provider.preparation;
 			const [expanded, setExpanded] = (0, react.useState)(false), [now, setNow] = (0, react.useState)(Date.now), [error, setError] = (0, react.useState)("");
+			const [source, setSource] = (0, react.useState)(""), [submitting, setSubmitting] = (0, react.useState)(false);
+			const sources = provider.downloadSources ?? [];
+			const [firstSource = ""] = sources;
+			const selectedSource = sources.includes(source) ? source : sources.length === 1 ? firstSource : "";
+			const canPrepare = [
+				"unprepared",
+				"cancelled",
+				"failed"
+			].includes(state.phase);
 			const current = state.steps?.find((step) => step.status === "running" || step.status === "failed" || step.status === "cancelled");
 			const preparing = preparationTone(state) === "ongoing";
 			const startedAt = current?.startedAt ?? ("startedAt" in state ? state.startedAt : void 0);
@@ -5381,10 +5505,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}, [preparing, startedAt]);
 			const run = async (action) => {
 				setError("");
+				setSubmitting(true);
 				try {
 					await action();
 				} catch (failure) {
 					setError(failure instanceof Error ? failure.message : String(failure));
+				} finally {
+					setSubmitting(false);
 				}
 			};
 			const metric = state.phase === "downloading" ? byteText(state, t) : preparing && startedAt !== void 0 ? t("elapsed", { seconds: String(Math.max(0, Math.floor((now - startedAt) / 1e3))) }) : "";
@@ -5469,24 +5596,41 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 						state,
 						t
 					}),
+					canPrepare && sources.length > 0 && (0, react_jsx_runtime.jsxs)("div", {
+						className: VoiceInput_module_css_default.sourceChoice,
+						children: [(0, react_jsx_runtime.jsxs)("label", { children: [t("sourceChoice"), (0, react_jsx_runtime.jsxs)("select", {
+							"aria-label": t("sourceChoice"),
+							value: selectedSource,
+							disabled: !connected || submitting || sources.length === 1,
+							onChange: (event) => {
+								setSource(event.target.value);
+							},
+							children: [sources.length > 1 && (0, react_jsx_runtime.jsx)("option", {
+								value: "",
+								children: t("sourceAuto")
+							}), sources.map((origin) => (0, react_jsx_runtime.jsx)("option", {
+								value: origin,
+								children: origin === "https://huggingface.co" ? t("sourceHuggingFace") : origin === "https://hf-mirror.com" ? t("sourceMirror") : origin
+							}, origin))]
+						})] }), (0, react_jsx_runtime.jsx)("small", {
+							className: VoiceInput_module_css_default.metric,
+							children: t(selectedSource === "" ? "sourceAutoHelp" : "sourceManualHelp")
+						})]
+					}),
 					(0, react_jsx_runtime.jsxs)("div", {
 						className: VoiceInput_module_css_default.preparationActions,
-						children: [[
-							"unprepared",
-							"cancelled",
-							"failed"
-						].includes(state.phase) && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						children: [canPrepare && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 							variant: "outline",
 							size: "sm",
-							disabled: !connected,
+							disabled: !connected || submitting,
 							onClick: () => {
-								run(() => prepare(provider.id));
+								run(() => selectedSource === "" ? prepare(provider.id) : prepare(provider.id, { downloadSource: selectedSource }));
 							},
 							children: t(state.phase === "unprepared" ? "prepare" : "retryPrepare")
 						}), preparing && state.phase !== "waking" && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 							variant: "ghost",
 							size: "sm",
-							disabled: !connected || state.phase === "cancelling",
+							disabled: !connected || submitting || state.phase === "cancelling",
 							onClick: () => {
 								run(() => cancelPreparation(provider.id));
 							},
@@ -5575,7 +5719,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		//#endregion
 		//#region lib/types/client/VoiceSetupPrompt.js
-		/** First-use guidance after explicit enablement, once the Host finishes inspecting its cache. */
+		/** Activation guidance after the Host inspects local recognition resources. */
 		/**
 		* Offer navigation to installation without starting a download.
 		* @param props - activation navigation and the shared Host readiness observer.
@@ -5593,21 +5737,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				needsSetup,
 				onDismiss
 			]);
-			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+			return (0, react_jsx_runtime.jsx)(VoiceSetupDialog, {
 				open: needsSetup,
-				title: t("setupPrompt.title"),
-				closeLabel: t("cancel"),
-				onClose: onDismiss,
-				footer: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
-					variant: "ghost",
-					onClick: onDismiss,
-					children: t("setupPrompt.later")
-				}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
-					variant: "primary",
-					onClick: onOpenDetails,
-					children: t("setupPrompt.open")
-				})] }),
-				children: (0, react_jsx_runtime.jsx)("p", { children: t("setupPrompt.body") })
+				needsInstallation: true,
+				onDismiss,
+				onOpenDetails,
+				t
 			});
 		}
 		//#endregion
@@ -5615,7 +5750,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const inject = [
 			"remote",
 			"slots",
-			"locale"
+			"locale",
+			"pluginNavigation"
 		];
 		function registerUi(ctx) {
 			ctx.effect(() => ctx.locale.register(NS, {
@@ -5629,6 +5765,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				await Promise.all([...recordings].map((recording) => recording.dispose()));
 			});
 			const actions = {
+				openSettings: () => {
+					ctx.pluginNavigation.openBundle("@deepseek-ai/dsh-experimental-voice-input-bundle");
+				},
 				hooks: { speechReadiness: readiness.state },
 				createRecording: () => {
 					const recording = new Recording(() => {
@@ -5642,8 +5781,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					const result = await ctx.remote.speech.configure(patch);
 					if (!result.ok) throw result.error;
 				},
-				prepare: async (providerId) => {
-					const result = await ctx.remote.speech.prepare(providerId);
+				prepare: async (providerId, options) => {
+					const result = await ctx.remote.speech.prepare(providerId, options);
 					if (!result.ok) throw result.error;
 				},
 				cancelPreparation: async (providerId) => {
@@ -5680,7 +5819,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const ui = ctx.inject([
 				"remote.speech",
 				"slots",
-				"locale"
+				"locale",
+				"pluginNavigation"
 			], registerUi);
 			try {
 				await ui;

package/lib/types/client/PreparationCard.d.ts

@@ -10,5 +10,5 @@ export type PreparationCardProps = Pick<InjectFace<VoiceInputInjected>, 'prepare
 /** Render a collapsed current-step summary or all Host-owned preparation steps. */
 export declare function PreparationCard({ provider, connected, prepare, cancelPreparation, t }: PreparationCardProps): import("react").JSX.Element;
 /** Recognition preferences and preparation cards shared by plugin details and Settings. */
-export declare function VoicePreparation({ useSpeechReadiness, ...props }: InjectFace<VoiceInputInjected> & PropsLocale<typeof NS>): import("react").JSX.Element;
+export declare function VoicePreparation({ useSpeechReadiness, ...props }: Pick<InjectFace<VoiceInputInjected>, 'useSpeechReadiness' | 'configure' | 'prepare' | 'cancelPreparation'> & PropsLocale<typeof NS>): import("react").JSX.Element;
 //# sourceMappingURL=PreparationCard.d.ts.map

package/lib/types/client/VoiceInput.d.ts

@@ -1,16 +1,18 @@
 import type { HostObservable, InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { TranscriptionRequest } from '@deepseek-ai/dsh-experimental-api-speech-to-text/types';
-import type { SpeechProviderId, SpeechSelectionPatch, Transcript } from '@deepseek-ai/dsh-experimental-speech-to-text/types';
+import type { SpeechPreparationOptions, SpeechProviderId, SpeechSelectionPatch, Transcript } from '@deepseek-ai/dsh-experimental-speech-to-text/types';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import { type Recording } from './audio.ts';
 import type { SpeechReadiness } from './readiness.ts';
 import { NS } from './locales.ts';
 /** Host calls injected without exposing a Cordis Context to React. */
 export interface VoiceInputActions {
+    /** Open the voice bundle details without starting preparation. */
+    openSettings: () => void;
     /** @returns one microphone operation owned by the plugin lifecycle. */
     createRecording: () => Recording;
     transcribe: (request: TranscriptionRequest, signal: AbortSignal) => Promise<RemoteResult<Transcript>>;
-    prepare: (providerId: SpeechProviderId) => Promise<void>;
+    prepare: (providerId: SpeechProviderId, options?: SpeechPreparationOptions) => Promise<void>;
     cancelPreparation: (providerId: SpeechProviderId) => Promise<void>;
     configure: (patch: SpeechSelectionPatch) => Promise<void>;
 }
@@ -23,5 +25,5 @@ export interface VoiceInputInjected extends VoiceInputActions {
 /** Composer-owned expansion and draft actions; preferences stay in plugin settings. */
 export type VoiceInputProps = Pick<PropsRuntime<'conversation.input.activity'>, 'sessionId' | 'inputActions' | 'locked' | 'onActiveChange'> & PropsLocale<typeof NS> & InjectFace<VoiceInputInjected>;
 /** Render a compact microphone or an expanded capture, transcription, or retry row. */
-export declare function VoiceInput({ sessionId, inputActions, locked, onActiveChange, createRecording, transcribe, useSpeechReadiness, t }: VoiceInputProps): import("react").JSX.Element;
+export declare function VoiceInput({ sessionId, inputActions, locked, onActiveChange, createRecording, transcribe, openSettings, useSpeechReadiness, t }: VoiceInputProps): import("react").JSX.Element;
 //# sourceMappingURL=VoiceInput.d.ts.map

package/lib/types/client/VoiceSetupDialog.d.ts

@@ -0,0 +1,14 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { NS } from './locales.ts';
+type VoiceSetupDialogProps = PropsLocale<typeof NS> & Pick<PropsRuntime<'plugins.bundle.activation'>, 'onDismiss' | 'onOpenDetails'> & {
+    open: boolean;
+    needsInstallation: boolean;
+};
+/**
+ * Guide activation or microphone clicks to the existing plugin details.
+ * @param props - visibility, installation need and navigation callbacks.
+ * @returns a dismissible prompt that never starts preparation or recording.
+ */
+export declare function VoiceSetupDialog({ open, needsInstallation, onDismiss, onOpenDetails, t }: VoiceSetupDialogProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=VoiceSetupDialog.d.ts.map

package/lib/types/client/locales.d.ts

@@ -7,6 +7,10 @@ export declare const zh: {
     readonly 'setupPrompt.body': "语音输入插件已开启。首次使用需要在本机下载并准备识别模型，请前往插件详情页查看空间、内存和时间说明，再开始安装。";
     readonly 'setupPrompt.later': "稍后";
     readonly 'setupPrompt.open': "前往安装";
+    readonly 'setupPrompt.trigger': "打开语音输入引导";
+    readonly 'setupPrompt.details': "前往语音插件设置";
+    readonly 'setupPrompt.unavailableTitle': "语音识别尚未就绪";
+    readonly 'setupPrompt.unavailableBody': "请前往语音插件详情页查看识别服务状态、准备进度或错误信息";
     readonly 'setup.local': "将在运行 DSH 的机器上下载本地模型，无需安装 Python 或编译工具。";
     readonly 'setup.disk': "硬盘空间";
     readonly 'setup.diskValue': "建议预留约 {gb} GB，包含模型、运行时和下载缓存";
@@ -54,6 +58,12 @@ export declare const zh: {
     readonly 'downloadAdvice.storage': "请检查运行 DSH 的机器的剩余磁盘空间，以及模型目录的写入权限后重试。";
     readonly 'downloadAdvice.unknown': "请检查运行 DSH 的机器的网络、磁盘空间和模型目录权限后重试。";
     readonly downloadSource: "下载来源：{source}";
+    readonly sourceChoice: "模型下载源";
+    readonly sourceAuto: "自动选择（推荐）";
+    readonly sourceHuggingFace: "Hugging Face";
+    readonly sourceMirror: "HF-Mirror（国内镜像）";
+    readonly sourceAutoHelp: "优先使用响应较快的源，下载失败时自动尝试其他源。";
+    readonly sourceManualHelp: "仅从所选源下载；已下载并通过校验的文件会复用。";
     readonly downloadCode: "错误码：{code}";
     readonly reconnecting: "正在连接语音服务…";
     readonly 'preparation.unprepared': "首次使用需要下载本地识别模型。";
@@ -65,7 +75,6 @@ export declare const zh: {
     readonly 'preparation.cancelled': "准备已取消，已完成的下载会保留。";
     readonly 'preparation.cancelling': "正在取消准备…";
     readonly cloudReady: "云端语音识别已就绪。";
-    readonly prepareRequired: "请先在语音插件设置中准备识别服务";
     readonly discard: "丢弃识别文字";
     readonly transcribingShort: "识别中…";
     readonly wakingShort: "唤醒中…";
@@ -85,7 +94,7 @@ export declare const zh: {
     readonly requesting: "请允许使用麦克风…";
     readonly recording: "正在录音…";
     readonly interrupted: "录音中断，请重试。";
-    readonly local: "音频在运行 DSH 的机器上识别。首次准备默认从 Hugging Face 下载模型，该机器需要能访问 Hugging Face 及其模型下载服务。如需代理，请在该机器上配置。";
+    readonly local: "音频在运行 DSH 的机器上识别。需要下载模型时，请确保该机器能访问所选下载源及其文件服务。如需代理，请在该机器上配置。";
     readonly cloud: "音频将发送至所选云端服务。";
     readonly empty: "未识别到语音";
     readonly cancelled: "已取消语音输入。";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-experimental-client-ui-voice-input",
   "description": "Record speech and insert editable text into the conversation draft",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -33,22 +33,22 @@
   "license": "MIT",
   "dependencies": {},
   "peerDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-experimental-api-speech-to-text": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-experimental-speech-to-text": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-experimental-api-speech-to-text": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-experimental-speech-to-text": "0.1.7-rc.2"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
@@ -56,22 +56,22 @@
     "react-dom": "^18.2.0",
     "@testing-library/react": "^16.1.0",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-experimental-speech-to-text": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-experimental-api-speech-to-text": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-experimental-api-speech-to-text": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-experimental-speech-to-text": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2"
   },
   "dsh": {
     "client": {