@jingyi0605/codingns4dsh 0.2.0-rc3 → 0.2.1-beta.1

package/data/build/dist/client/bundle.js

@@ -877,6 +877,7 @@ window.__ModuleLoader__.load({
 				"terminalView.readOnly": "This page is currently read-only.",
 				"terminalView.reconnect": "Reconnect",
 				"terminalView.readingEnvironment": "Reading the terminal environment…",
+				"terminalView.loadTimeout": "The terminal service did not respond in time. Please retry.",
 				"terminalView.starting": "Starting…",
 				"terminalView.connecting": "Connecting…",
 				"terminalView.disconnected": "Connection lost.",
@@ -909,6 +910,7 @@ window.__ModuleLoader__.load({
 				"terminalView.readOnly": "此页面当前只读。",
 				"terminalView.reconnect": "重新连接",
 				"terminalView.readingEnvironment": "正在读取终端环境…",
+				"terminalView.loadTimeout": "终端服务响应超时，请重试。",
 				"terminalView.starting": "正在启动…",
 				"terminalView.connecting": "正在连接…",
 				"terminalView.disconnected": "连接已断开。",
@@ -958,6 +960,8 @@ window.__ModuleLoader__.load({
 				"usage.windowFiveHour": "5-hour quota",
 				"usage.windowWeekly": "Weekly quota",
 				"usage.windowMonthly": "Monthly quota",
+				"usage.quotaGroupGemini": "Gemini models",
+				"usage.quotaGroupThirdParty": "Claude and GPT models",
 				"usage.popoverSubscriptionUsage": "{provider} subscription usage",
 				"usage.popoverSubscriptionTitle": "{provider} subscription",
 				"usage.windowRemaining": "{label} remaining {percent}%",
@@ -1062,6 +1066,8 @@ window.__ModuleLoader__.load({
 				"usage.windowFiveHour": "5 小时额度",
 				"usage.windowWeekly": "周额度",
 				"usage.windowMonthly": "月额度",
+				"usage.quotaGroupGemini": "Gemini 模型",
+				"usage.quotaGroupThirdParty": "Claude 与 GPT 模型",
 				"usage.popoverSubscriptionUsage": "{provider} 订阅使用情况",
 				"usage.popoverSubscriptionTitle": "{provider} 订阅",
 				"usage.windowRemaining": "{label}剩余 {percent}%",
@@ -1231,6 +1237,70 @@ window.__ModuleLoader__.load({
 				"feature.cliAdapters.description": "View installed external Agents, versions, command paths, available models, and enable them independently. External Agent context panels keep only the occupancy percentage and totals.",
 				"feature.workspaceSession.label": "Workspace session enhancement",
 				"feature.workspaceSession.description": "Show Agent logos, archived-session entries, workspace hiding controls, subscription or usage information, local quick sessions, and an optional remembered conversation/right-sidebar width ratio.",
+				"feature.assistant.label": "Global smart assistant (Testing)",
+				"feature.assistant.description": "Summarize progress across selected workspaces and route voice or text instructions to an explicit target session.",
+				"voice.globalAssistant": "Global voice assistant (Testing)",
+				"voice.audioNotice": "Audio is processed by the configured local or cloud voice provider.",
+				"voice.emptyTranscript": "No usable speech was recognized; nothing was submitted. Please try again.",
+				"voice.invalidTranscript": "The transcription was not valid, so nothing was submitted. Please say it again.",
+				"voice.secureContextRequired": "Microphone access requires a secure browser context. Use HTTPS, WSS, or localhost and try again.",
+				"voice.microphoneNotice": "Starting this control uses the microphone in this browser.",
+				"voice.microphoneUpdated": "Microphone updated.",
+				"voice.inputDevice": "Input device",
+				"voice.defaultMicrophone": "Browser default microphone",
+				"voice.unnamedMicrophone": "Unnamed microphone",
+				"voice.outputDevice": "Output device",
+				"voice.defaultOutput": "Browser/OS default output",
+				"voice.unnamedOutput": "Unnamed output",
+				"voice.outputUpdated": "Output device updated.",
+				"voice.dialog.title": "Global voice assistant (Testing)",
+				"voice.dialog.description": "Open this window first. Start voice when you are ready; recognized text appears here in real time.",
+				"voice.dialog.realtimeHint": "Realtime Sherpa-ONNX mode. Partial recognition appears while you speak.",
+				"voice.dialog.unavailable": "Realtime Sherpa-ONNX is unavailable. Check the local runtime and model configuration; fallback transcription is disabled.",
+				"voice.dialog.liveText": "Live transcription",
+				"voice.dialog.empty": "Nothing recognized yet.",
+				"voice.dialog.start": "Start realtime conversation",
+				"voice.dialog.stop": "Stop conversation",
+				"voice.dialog.close": "Close",
+				"voice.dialog.clear": "Clear text",
+				"voice.dialog.status.loading": "Preparing microphone…",
+				"voice.dialog.status.listening": "Listening",
+				"voice.dialog.status.recording": "Recording",
+				"voice.dialog.status.error": "Error",
+				"voice.dialog.status.active": "Active",
+				"voice.dialog.status.idle": "Idle",
+				"voice.setup.open": "Configure voice assistant (Testing)",
+				"voice.setup.title": "Initialize global voice assistant (Testing)",
+				"voice.setup.description": "Choose a recommended realtime model. CodingNS will download and initialize it automatically.",
+				"voice.setup.onlyRealtime": "Only streaming models that support realtime conversation are shown. Files are stored on the current Host and reused after download.",
+				"voice.setup.model": "Realtime voice model",
+				"voice.setup.modelRequired": "Choose a realtime voice model.",
+				"voice.setup.downloadHint": "The first setup downloads the model and configures the runtime. You will not need to enter file paths.",
+				"voice.setup.downloading": "Downloading and initializing the model. Keep this window open…",
+				"voice.setup.provider": "Voice provider",
+				"voice.setup.provider.dsh": "DSH speechToText（browser hold-to-speak）",
+				"voice.setup.provider.sherpa": "Sherpa-ONNX（local realtime）",
+				"voice.setup.providerDshHint": "This mode uses the Host speechToText provider for sentence transcription and browser speech synthesis for replies. No local Sherpa model is required.",
+				"voice.setup.modelHint": "Enter absolute paths to the Sherpa-ONNX model files on the Host machine.",
+				"voice.setup.asrEncoder": "ASR encoder model",
+				"voice.setup.asrDecoder": "ASR decoder model",
+				"voice.setup.asrJoiner": "ASR joiner model",
+				"voice.setup.asrTokens": "ASR tokens file",
+				"voice.setup.vadModel": "VAD model（optional）",
+				"voice.setup.ttsModel": "TTS model（optional）",
+				"voice.setup.ttsTokens": "TTS tokens（optional）",
+				"voice.setup.ttsLexicon": "TTS lexicon（optional）",
+				"voice.setup.optional": "Optional; leave empty to disable",
+				"voice.setup.required": "Sherpa-ONNX requires encoder, decoder, joiner, and tokens paths.",
+				"voice.setup.cancel": "Cancel",
+				"voice.setup.save": "Download and initialize",
+				"voice.setup.reconfigure": "Configure",
+				"voice.setup.status.uninitialized": "Not initialized; the assistant button opens setup instead of starting voice.",
+				"voice.setup.status.dsh": "DSH speechToText sentence transcription with browser speech synthesis.",
+				"voice.setup.status.sherpa": "Sherpa-ONNX local realtime mode.",
+				"assistant.scopeDescription": "Only selected workspaces are readable by the global assistant. Archived sessions are always excluded.",
+				"assistant.noWorkspaces": "No workspaces are available in this Host.",
+				"assistant.saved": "Assistant scope saved.",
 				"feature.mobileAccess.label": "Mobile access enhancements",
 				"feature.mobileAccess.description": "On phones or narrow viewports, hide the left sidebar entirely and keep only the top-left logo as the way back in.",
 				"mobile.hideSidebarOnMobile": "Fully hide the left sidebar on mobile",
@@ -1255,6 +1325,26 @@ window.__ModuleLoader__.load({
 				"terminal.title": "Terminal",
 				"terminal.new": "New terminal",
 				"terminal.close": "Close terminal",
+				"terminal.refresh": "Refresh terminal",
+				"terminal.tools": "Terminal shortcuts",
+				"terminal.holdCtrl": "Hold Ctrl",
+				"terminal.holdAlt": "Hold Alt",
+				"terminal.holdWin": "Hold Win",
+				"terminal.holdOption": "Hold Option",
+				"terminal.holdCommand": "Hold Command",
+				"terminal.holdSuper": "Hold Super",
+				"terminal.shortcutTab": "Tab",
+				"terminal.shortcutEscape": "Escape",
+				"terminal.shortcutEnter": "Enter",
+				"terminal.shortcutBackspace": "Backspace",
+				"terminal.shortcutUp": "Arrow up",
+				"terminal.shortcutDown": "Arrow down",
+				"terminal.shortcutLeft": "Arrow left",
+				"terminal.shortcutRight": "Arrow right",
+				"terminal.shortcutC": "C (Ctrl+C when Ctrl is held)",
+				"terminal.shortcutD": "D (Ctrl+D when Ctrl is held)",
+				"terminal.shortcutL": "L (Ctrl+L when Ctrl is held)",
+				"terminal.shortcutZ": "Z (Ctrl+Z when Ctrl is held)",
 				"terminal.description": "Run commands in the session workspace",
 				"terminal.loadingShell": "Reading shells…",
 				"terminal.retry": "Retry",
@@ -1458,6 +1548,12 @@ window.__ModuleLoader__.load({
 				"delegate.cardTitle": "Delegation task",
 				"delegate.cardStatus": "Delegating",
 				"delegate.cardTarget": "{label} ({adapter}{model})",
+				"skills.label": "Skills",
+				"skills.description": "Browse and explicitly invoke Skills provided by the current Agent",
+				"skills.searchPlaceholder": "Search Skills",
+				"skills.searchEmpty": "The current Agent has no available Skills",
+				"skills.searchNoResults": "No matching Skill",
+				"skills.draftUnsupported": "This DSH version cannot write a Skill mention. Please upgrade DSH.",
 				"cli.loadingModel": "Loading models…",
 				"cli.noModelsAvailable": "No models available",
 				"cli.model": "Model",
@@ -1503,6 +1599,8 @@ window.__ModuleLoader__.load({
 				"subscriptionUsage.saved": "Usage query settings saved",
 				"workspace.showQuickPhrases": "Show quick sessions",
 				"workspace.quickPhrasesDescription": "Keep reusable session instructions locally in Codingns4DSH and show the quick sessions button inside the composer.",
+				"workspace.showSkillQuickReference": "Index the selected Agent Skills for quick command references",
+				"workspace.skillQuickReferenceDescription": "Load Skills from the selected Agent, insert them as one reference chip, and render them as a compact element in the message list.",
 				"workspace.rememberConversationRightbarRatio": "Remember conversation and right sidebar width ratio",
 				"workspace.rememberConversationRightbarRatioDescription": "Restore the right sidebar proportion after refreshing this browser; the ratio is stored locally.",
 				"mobile.sidebarGestures": "Swipe to open or close sidebars",
@@ -1561,6 +1659,70 @@ window.__ModuleLoader__.load({
 				"feature.cliAdapters.description": "管理外部 Agent",
 				"feature.workspaceSession.label": "工作区会话增强",
 				"feature.workspaceSession.description": "增强工作区会话体验",
+				"feature.assistant.label": "全局智能助理（测试中）",
+				"feature.assistant.description": "汇总受管工作区进展，并把语音或文字指令派发到明确的目标会话。",
+				"voice.globalAssistant": "全局语音助理（测试中）",
+				"voice.audioNotice": "音频会交给当前配置的本地或云端语音提供方处理。",
+				"voice.emptyTranscript": "未识别到有效语音，未提交内容；请重试。",
+				"voice.invalidTranscript": "转写结果无效，未提交内容；请重新说一遍。",
+				"voice.secureContextRequired": "麦克风需要浏览器安全上下文，请改用 HTTPS、WSS 或 localhost 后重试。",
+				"voice.microphoneNotice": "启动此入口会使用当前浏览器的麦克风。",
+				"voice.microphoneUpdated": "麦克风已更新。",
+				"voice.inputDevice": "输入设备",
+				"voice.defaultMicrophone": "浏览器默认麦克风",
+				"voice.unnamedMicrophone": "未命名麦克风",
+				"voice.outputDevice": "输出设备",
+				"voice.defaultOutput": "浏览器/系统默认输出",
+				"voice.unnamedOutput": "未命名输出设备",
+				"voice.outputUpdated": "输出设备已更新。",
+				"voice.dialog.title": "全局语音助理（测试中）",
+				"voice.dialog.description": "先打开此窗口，再按需要开始语音；识别文字会实时显示在这里。",
+				"voice.dialog.realtimeHint": "Sherpa-ONNX 实时模式，说话时会显示实时识别结果。",
+				"voice.dialog.unavailable": "Sherpa-ONNX 实时模式不可用，请检查本地运行时和模型配置；已禁用回退转写。",
+				"voice.dialog.liveText": "实时文字转换",
+				"voice.dialog.empty": "暂时还没有识别文字。",
+				"voice.dialog.start": "开始实时对话",
+				"voice.dialog.stop": "停止对话",
+				"voice.dialog.close": "关闭",
+				"voice.dialog.clear": "清空文字",
+				"voice.dialog.status.loading": "正在准备麦克风……",
+				"voice.dialog.status.listening": "正在聆听",
+				"voice.dialog.status.recording": "正在录音",
+				"voice.dialog.status.error": "出错",
+				"voice.dialog.status.active": "运行中",
+				"voice.dialog.status.idle": "未启动",
+				"voice.setup.open": "配置语音助理（测试中）",
+				"voice.setup.title": "初始化全局语音助理（测试中）",
+				"voice.setup.description": "选择一个推荐的实时模型，系统会自动下载并完成初始化。",
+				"voice.setup.onlyRealtime": "这里只显示支持实时对话的流式语音模型。模型文件保存在当前 Host，已下载的文件会自动复用。",
+				"voice.setup.model": "实时语音模型",
+				"voice.setup.modelRequired": "请选择一个实时语音模型。",
+				"voice.setup.downloadHint": "首次使用会自动下载模型并配置运行时，之后无需再次填写路径。",
+				"voice.setup.downloading": "正在下载并初始化模型，请保持此窗口打开……",
+				"voice.setup.provider": "语音提供商",
+				"voice.setup.provider.dsh": "DSH speechToText（浏览器按住说话）",
+				"voice.setup.provider.sherpa": "Sherpa-ONNX（本地实时模式）",
+				"voice.setup.providerDshHint": "此模式使用 Host 的 speechToText 进行句级转写，并使用浏览器 speechSynthesis 播报回复，不需要本地 Sherpa 模型。",
+				"voice.setup.modelHint": "请输入 Host 机器上的 Sherpa-ONNX 模型文件绝对路径。",
+				"voice.setup.asrEncoder": "ASR encoder 模型",
+				"voice.setup.asrDecoder": "ASR decoder 模型",
+				"voice.setup.asrJoiner": "ASR joiner 模型",
+				"voice.setup.asrTokens": "ASR tokens 文件",
+				"voice.setup.vadModel": "VAD 模型（可选）",
+				"voice.setup.ttsModel": "TTS 模型（可选）",
+				"voice.setup.ttsTokens": "TTS tokens（可选）",
+				"voice.setup.ttsLexicon": "TTS lexicon（可选）",
+				"voice.setup.optional": "可选；留空表示禁用",
+				"voice.setup.required": "Sherpa-ONNX 必须填写 encoder、decoder、joiner 和 tokens 路径。",
+				"voice.setup.cancel": "取消",
+				"voice.setup.save": "下载并初始化",
+				"voice.setup.reconfigure": "配置",
+				"voice.setup.status.uninitialized": "尚未初始化；点击助手按钮只打开配置页，不会直接启动语音。",
+				"voice.setup.status.dsh": "使用 DSH speechToText 句级转写和浏览器语音播报。",
+				"voice.setup.status.sherpa": "使用 Sherpa-ONNX 本地实时模式。",
+				"assistant.scopeDescription": "全局助理只读取已勾选的工作区，已归档会话始终排除。",
+				"assistant.noWorkspaces": "当前 Host 没有可选工作区。",
+				"assistant.saved": "助理受管范围已保存。",
 				"feature.mobileAccess.label": "移动端访问增强",
 				"feature.mobileAccess.description": "优化移动端访问布局",
 				"mobile.hideSidebarOnMobile": "移动端彻底隐藏左侧边栏",
@@ -1585,6 +1747,26 @@ window.__ModuleLoader__.load({
 				"terminal.title": "终端",
 				"terminal.new": "新建终端",
 				"terminal.close": "关闭终端",
+				"terminal.refresh": "刷新终端",
+				"terminal.tools": "终端快捷操作",
+				"terminal.holdCtrl": "按住 Ctrl",
+				"terminal.holdAlt": "按住 Alt",
+				"terminal.holdWin": "按住 Win",
+				"terminal.holdOption": "按住 Option",
+				"terminal.holdCommand": "按住 Command",
+				"terminal.holdSuper": "按住 Super",
+				"terminal.shortcutTab": "Tab 制表键",
+				"terminal.shortcutEscape": "Esc 退出键",
+				"terminal.shortcutEnter": "Enter 回车键",
+				"terminal.shortcutBackspace": "Backspace 退格键",
+				"terminal.shortcutUp": "向上箭头",
+				"terminal.shortcutDown": "向下箭头",
+				"terminal.shortcutLeft": "向左箭头",
+				"terminal.shortcutRight": "向右箭头",
+				"terminal.shortcutC": "C（按住 Ctrl 时发送 Ctrl+C）",
+				"terminal.shortcutD": "D（按住 Ctrl 时发送 Ctrl+D）",
+				"terminal.shortcutL": "L（按住 Ctrl 时发送 Ctrl+L）",
+				"terminal.shortcutZ": "Z（按住 Ctrl 时发送 Ctrl+Z）",
 				"terminal.description": "在会话工作区运行命令",
 				"terminal.loadingShell": "正在读取 Shell…",
 				"terminal.retry": "重试",
@@ -1788,6 +1970,12 @@ window.__ModuleLoader__.load({
 				"delegate.cardTitle": "委派任务",
 				"delegate.cardStatus": "委派中",
 				"delegate.cardTarget": "{label}（{adapter}{model}）",
+				"skills.label": "技能",
+				"skills.description": "浏览并显式调用当前 Agent 提供的技能",
+				"skills.searchPlaceholder": "搜索技能",
+				"skills.searchEmpty": "当前 Agent 没有可用技能",
+				"skills.searchNoResults": "没有匹配的技能",
+				"skills.draftUnsupported": "当前 DSH 不支持写入技能引用，请先升级 DSH。",
 				"cli.loadingModel": "加载模型…",
 				"cli.noModelsAvailable": "无可用模型",
 				"cli.model": "模型",
@@ -1831,8 +2019,10 @@ window.__ModuleLoader__.load({
 				"subscriptionUsage.cancel": "取消",
 				"subscriptionUsage.save": "保存",
 				"subscriptionUsage.saved": "用量查询设置已保存",
-				"workspace.showQuickPhrases": "显示快捷会话",
+				"workspace.showQuickPhrases": "在对话框中显示快捷短语组件",
 				"workspace.quickPhrasesDescription": "在 Codingns4DSH 内本地保存可复用的会话指令，并将快捷会话按钮显示在输入工具区。",
+				"workspace.showSkillQuickReference": "索引指定 Agent 的 Skill 列表并通过指令快速引用",
+				"workspace.skillQuickReferenceDescription": "加载本次会话所选 Agent 的 Skill，将其作为整体引用元素插入聊天框，并在消息列表中美化显示。",
 				"workspace.rememberConversationRightbarRatio": "记忆对话窗口与右侧栏的宽度比例",
 				"workspace.rememberConversationRightbarRatioDescription": "刷新后恢复右侧栏比例；比例仅保存在当前浏览器中。",
 				"mobile.sidebarGestures": "横滑开合侧栏",
@@ -2571,9 +2761,16 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/shared/contracts/version.ts
 		/** 当前经过完整验证的 DSH 版本；源文件由根目录 version.json 同步。 */
-		const DSH_VERSION = "0.2.0-rc.2";
-		/** 插件正式验证的 DSH 版本范围；rc.2 的 Client ABI 未经验证不得放宽上限。 */
-		const DSH_COMPATIBILITY = ">=0.2.0-rc.2 <=0.2.0-rc.2";
+		const DSH_VERSION = "0.2.1-alpha.1";
+		/**
+		* 插件正式验证的 DSH 版本范围，覆盖 rc.2 到当前验证的 alpha.1。
+		*
+		* 0.2.0-rc.2 与 0.2.1-alpha.1 属于同一 API 世代：插件消费的 7 个宿主包接口面
+		* 未变（仅 dsh-client-ui-primitives 新增 InlineEditor），会话格式仍为 v4。因此
+		* 这里保留明确上界，是为了让 npm/DSH 安装期也能识别 0.2.1-alpha.1 这个跨 patch
+		* 预发布版本；出现新的 API 世代或结构变化时，应重新验证并更新范围与能力路由。
+		*/
+		const DSH_COMPATIBILITY = ">=0.2.0-rc.2 <=0.2.1-alpha.1";
 		/**
 		* 兼容范围下界，即插件仍然接受的最低 DSH 版本。
 		*
@@ -2582,7 +2779,7 @@ window.__ModuleLoader__.load({
 		* “不支持的 DSH 版本”，把仅仅缺少启动页注入的页面误判为宿主不兼容。
 		*/
 		function minimumSupportedDshVersion() {
-			return /^>=([^ ]+)/u.exec(">=0.2.0-rc.2 <=0.2.0-rc.2")?.[1] ?? "0.2.0-rc.2";
+			return /^>=([^ ]+)/u.exec(">=0.2.0-rc.2 <=0.2.1-alpha.1")?.[1] ?? "0.2.1-alpha.1";
 		}
 		/** Host 注入到浏览器页面的真实 DSH 版本全局字段。 */
 		const CODINGNS_DSH_VERSION_GLOBAL = "__CODINGNS_DSH_VERSION__";
@@ -2591,7 +2788,7 @@ window.__ModuleLoader__.load({
 			return /^0\.1\.5(?:-|$)/u.test(version);
 		}
 		/** Codingns4DSH 插件自身的 npm 版本。 */
-		const CODINGNS_VERSION = "0.2.0-rc3";
+		const CODINGNS_VERSION = "0.2.1-beta.1";
 		/** 判断宿主版本是否落在当前插件声明的 DSH 兼容范围内；范围省略上界时不校验上限。 */
 		function isDshVersionCompatible(version) {
 			const match = /^>=([^ ]+)(?: <=([^ ]+))?$/u.exec(DSH_COMPATIBILITY);
@@ -2642,6 +2839,23 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/shared/contracts/config.ts
+		const DEFAULT_ASSISTANT_VOICE_SETTINGS = {
+			initialized: false,
+			provider: "dsh-speech-to-text",
+			modelId: "",
+			asrEncoder: "",
+			asrDecoder: "",
+			asrJoiner: "",
+			asrTokens: "",
+			vadModel: "",
+			ttsModel: "",
+			ttsTokens: "",
+			ttsLexicon: ""
+		};
+		const DEFAULT_ASSISTANT_SETTINGS = {
+			managedWorkspaceIds: [],
+			voice: DEFAULT_ASSISTANT_VOICE_SETTINGS
+		};
 		/** 并发子代理数上限：下限 1 保证至少能派发，上限避免一次性压垮本机。 */
 		const SUBAGENT_BRIDGE_MAX_CONCURRENT_LIMITS = {
 			min: 1,
@@ -2809,6 +3023,7 @@ window.__ModuleLoader__.load({
 		const CODINGNS_FILE_MANAGEMENT_FIELD = "fileManagement";
 		const CODINGNS_MOBILE_ACCESS_FIELD = "mobileAccess";
 		const CODINGNS_SUBSCRIPTION_USAGE_FIELD = "subscriptionUsage";
+		const CODINGNS_ASSISTANT_FIELD = "assistant";
 		const DEFAULT_CODINGNS_CONTROL_BASE_URLS = ["https://channel.codingns.com:1443"];
 		/** 独立 H5 登录页面地址；登录控制站后可从设置页复制给其他设备。 */
 		const CODINGNS_H5_LOGIN_URL = "https://dsh.codingns.com";
@@ -2835,6 +3050,7 @@ window.__ModuleLoader__.load({
 			hiddenWorkspaceIds: [],
 			showSubscriptionUsage: true,
 			showQuickPhrases: true,
+			showSkillQuickReference: true,
 			rememberConversationRightbarRatio: false,
 			quickPhrases: DEFAULT_QUICK_PHRASES.map((phrase) => ({ ...phrase })),
 			quickPhrasesSeeded: true
@@ -3108,6 +3324,8 @@ window.__ModuleLoader__.load({
 			let userActivation;
 			let suppressedClick;
 			let dispatchingSyntheticClick = false;
+			let mountedUnsubscribe;
+			let collapseTimers = [];
 			const now = () => Date.now();
 			const blurComposer = () => {
 				const activeElement = hostDocument?.activeElement;
@@ -3161,6 +3379,7 @@ window.__ModuleLoader__.load({
 				if (!isShortMobileTap(start, end)) return;
 				const row = sessionRow(point.target);
 				if (row === null || isRowControl(point.target, row)) return;
+				collapseRightbar();
 				preventDefault$1(event);
 				suppressedClick = {
 					row,
@@ -3185,6 +3404,7 @@ window.__ModuleLoader__.load({
 					preventDefault$1(event);
 					stopPropagation(event);
 				}
+				if (row !== null && !isRowControl(eventTarget(event), row)) collapseRightbar();
 				suppressedClick = void 0;
 			};
 			const onDoubleClickCapture = (event) => {
@@ -3207,6 +3427,7 @@ window.__ModuleLoader__.load({
 				hostDocument.addEventListener("focusin", onFocusIn, capture);
 				hostDocument.addEventListener("click", onClickCapture, capture);
 				hostDocument.addEventListener("dblclick", onDoubleClickCapture, capture);
+				subscribeMountedSession();
 			};
 			const removeListeners = () => {
 				if (!active || hostDocument === void 0) return;
@@ -3218,10 +3439,53 @@ window.__ModuleLoader__.load({
 				hostDocument.removeEventListener("focusin", onFocusIn, true);
 				hostDocument.removeEventListener("click", onClickCapture, true);
 				hostDocument.removeEventListener("dblclick", onDoubleClickCapture, true);
+				mountedUnsubscribe?.();
+				mountedUnsubscribe = void 0;
+				for (const timer of collapseTimers) clearTimeout(timer);
+				collapseTimers = [];
 				touchStart = void 0;
 				userActivation = void 0;
 				suppressedClick = void 0;
 			};
+			/**
+			* DSH 的右栏布局按会话保存。移动端切换到新会话时，宿主会先挂载会话，
+			* 随后恢复该会话上次的展开状态；这里仅在移动端把这次自动恢复收回，
+			* 让主界面稳定停留在消息区。用户之后仍可通过右滑或原生按钮主动打开。
+			*/
+			const collapseRightbar = () => {
+				const sidebarRight = options.sidebarRight;
+				if (sidebarRight === void 0) return false;
+				try {
+					if (!sidebarRight.isExpanded()) return false;
+					sidebarRight.toggleExpanded();
+					for (const timer of collapseTimers) clearTimeout(timer);
+					collapseTimers = [];
+					return true;
+				} catch {
+					return false;
+				}
+			};
+			const scheduleRightbarCollapse = () => {
+				if (!active || options.sidebarRight === void 0) return;
+				for (const timer of collapseTimers) clearTimeout(timer);
+				collapseTimers = [];
+				if (collapseRightbar()) return;
+				collapseTimers = [
+					setTimeout(collapseRightbar, 0),
+					setTimeout(collapseRightbar, 60),
+					setTimeout(collapseRightbar, 240)
+				];
+			};
+			const subscribeMountedSession = () => {
+				const subscribe = options.sidebarRight?.mounted?.subscribe;
+				if (typeof subscribe !== "function") return;
+				try {
+					mountedUnsubscribe = subscribe(scheduleRightbarCollapse);
+				} catch {
+					mountedUnsubscribe = void 0;
+				}
+				scheduleRightbarCollapse();
+			};
 			const refresh = () => {
 				if (disposed) return false;
 				if (isMobileTouchViewport$1(hostWindow, viewportMaxPx)) addListeners();
@@ -4080,7 +4344,7 @@ window.__ModuleLoader__.load({
 			start: (context) => {
 				ensureCryptoRandomUUID();
 				let prompt;
-				const mobileSessionInteraction = startMobileSessionInteractionDom();
+				const mobileSessionInteraction = startMobileSessionInteractionDom({ sidebarRight: context.services.sidebarRight });
 				const sync = () => {
 					const pwa = context.services.settings.getSnapshot().value?.lanAccessDsh.pwa ?? DEFAULT_LAN_ACCESS_DSH_PWA_SETTINGS;
 					if (!pwa.enabled || !pwa.installPrompt) {
@@ -5001,6 +5265,54 @@ window.__ModuleLoader__.load({
 			return age >= 0 && age < refreshIntervalMins * 6e4;
 		}
 		//#endregion
+		//#region src/shared/voice-stream.ts
+		function encodeVoiceStreamMessage(message) {
+			return new TextEncoder().encode(`${JSON.stringify(message)}\n`);
+		}
+		function encodeVoiceStreamOpen(message) {
+			return encodeVoiceStreamMessage({
+				type: "open",
+				...message
+			});
+		}
+		//#endregion
+		//#region src/shared/voice-models.ts
+		const STREAMING_FILES = [
+			{
+				setting: "asrEncoder",
+				name: "encoder-epoch-99-avg-1.int8.onnx"
+			},
+			{
+				setting: "asrDecoder",
+				name: "decoder-epoch-99-avg-1.int8.onnx"
+			},
+			{
+				setting: "asrJoiner",
+				name: "joiner-epoch-99-avg-1.int8.onnx"
+			},
+			{
+				setting: "asrTokens",
+				name: "tokens.txt"
+			}
+		];
+		/** 只暴露支持实时输入的推荐模型；模型地址由 Host 根据此白名单解析。 */
+		const ASSISTANT_VOICE_MODEL_CATALOG = [{
+			id: "sherpa-onnx-streaming-zh-14m",
+			label: "中文实时模型（推荐）",
+			description: "本地运行，约 27 MB，适合中文语音对话。",
+			repository: "csukuangfj/sherpa-onnx-streaming-zipformer-zh-14M-2023-02-23",
+			files: STREAMING_FILES
+		}, {
+			id: "sherpa-onnx-streaming-zh-en",
+			label: "中英双语实时模型",
+			description: "本地运行，约 200 MB，同时识别中文和英文。",
+			repository: "csukuangfj/sherpa-onnx-streaming-zipformer-bilingual-zh-en-2023-02-20",
+			files: STREAMING_FILES
+		}];
+		function findAssistantVoiceModel(modelId) {
+			return ASSISTANT_VOICE_MODEL_CATALOG.find((model) => model.id === modelId);
+		}
+		//#endregion
 		//#region src/transport/debug.ts
 		init_debug();
 		/** 创建一个可注入测试 sink 的调试 logger。默认开关由当前运行环境决定。 */
@@ -5034,12 +5346,12 @@ window.__ModuleLoader__.load({
 			if (typeof fields.status === "number" && fields.status >= 400) return true;
 			if (typeof fields.state === "string" && /^(failed|disconnected|closed|degraded)$/iu.test(fields.state)) return true;
 			if (typeof fields.event === "string" && fields.event !== event) {
-				const nestedFields = isRecord$9(fields.fields) ? fields.fields : {};
+				const nestedFields = isRecord$10(fields.fields) ? fields.fields : {};
 				return isDshTransportWarningEvent(fields.event, nestedFields);
 			}
 			return false;
 		}
-		function isRecord$9(value) {
+		function isRecord$10(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		/**
@@ -5859,15 +6171,15 @@ window.__ModuleLoader__.load({
 			sendHello() {
 				this.send(this.createEnvelope("session.hello", "session", {
 					protocol: this.options.protocol ?? "dsh-transport-v1",
-					dshVersion: this.options.dshVersion ?? "0.2.0-rc.2",
+					dshVersion: this.options.dshVersion ?? "0.2.1-alpha.1",
 					capabilities: [...this.options.capabilities ?? []]
 				}));
 			}
 			sendReady(capabilities, peerDshVersion) {
 				this.send(this.createEnvelope("session.ready", "session", {
 					protocol: this.options.protocol ?? "dsh-transport-v1",
-					dshVersion: peerDshVersion ?? this.options.dshVersion ?? "0.2.0-rc.2",
-					hostDshVersion: this.options.dshVersion ?? "0.2.0-rc.2",
+					dshVersion: peerDshVersion ?? this.options.dshVersion ?? "0.2.1-alpha.1",
+					hostDshVersion: this.options.dshVersion ?? "0.2.1-alpha.1",
 					capabilities: [...capabilities],
 					byteCredit: 65536,
 					messageCredit: 32
@@ -6993,7 +7305,7 @@ window.__ModuleLoader__.load({
 			async onMessage(event) {
 				const sourceWindow = event.source;
 				if (this.disposed || sourceWindow === null || !this.iframeWindows.has(sourceWindow)) return;
-				if (!isRecord$8(event.data) || typeof event.data.kind !== "string") return;
+				if (!isRecord$9(event.data) || typeof event.data.kind !== "string") return;
 				const message = event.data;
 				if (message.kind !== "dsh-web-debug" && typeof message.id !== "string") return;
 				if (typeof message.id === "string") this.messageWindows.set(message.id, sourceWindow);
@@ -7004,7 +7316,7 @@ window.__ModuleLoader__.load({
 				try {
 					if (message.kind === "dsh-web-debug") {
 						const eventName = typeof message.event === "string" ? message.event : "unknown";
-						const fields = isRecord$8(message.fields) ? message.fields : {};
+						const fields = isRecord$9(message.fields) ? message.fields : {};
 						this.debug.log(`iframe.${eventName}`, fields);
 						if (/^(bridge\.ws\.|client\.connection\.)/u.test(eventName)) await this.options.transport.webRequest("web.debug", {
 							event: eventName,
@@ -7013,7 +7325,7 @@ window.__ModuleLoader__.load({
 						return;
 					}
 					if (message.kind === "fetch") {
-						const input = isRecord$8(message.input) ? message.input : {};
+						const input = isRecord$9(message.input) ? message.input : {};
 						const path = resolveRemotePath(typeof input.path === "string" ? input.path : "/");
 						const body = typeof message.body === "string" ? message.body : typeof input.body === "string" ? input.body : void 0;
 						const response = path.startsWith("/assets/") || path.startsWith("/plugins/") ? {
@@ -7039,7 +7351,7 @@ window.__ModuleLoader__.load({
 						return;
 					}
 					if (message.kind === "script") {
-						const input = isRecord$8(message.input) ? message.input : {};
+						const input = isRecord$9(message.input) ? message.input : {};
 						const path = resolveRemotePath(typeof input.path === "string" ? input.path : "/");
 						const url = await this.loadScript(path, void 0);
 						this.postResponse(message.id, {
@@ -7049,7 +7361,7 @@ window.__ModuleLoader__.load({
 						return;
 					}
 					if (message.kind === "style") {
-						const input = isRecord$8(message.input) ? message.input : {};
+						const input = isRecord$9(message.input) ? message.input : {};
 						const path = resolveRemotePath(typeof input.path === "string" ? input.path : "/");
 						const url = await this.loadStyle(path, void 0);
 						this.postResponse(message.id, {
@@ -7059,7 +7371,7 @@ window.__ModuleLoader__.load({
 						return;
 					}
 					if (message.kind === "ws.open") {
-						const input = isRecord$8(message.input) ? message.input : {};
+						const input = isRecord$9(message.input) ? message.input : {};
 						const opened = this.options.transport.openWebStreamWithId("web.ws.open", {
 							sessionId: this.sessionIdValue,
 							path: resolveRemotePath(typeof input.path === "string" ? input.path : "/")
@@ -7151,7 +7463,7 @@ window.__ModuleLoader__.load({
 					for await (const value of stream) {
 						if (!opened) {
 							opened = true;
-							if (isRecord$8(value) && value.opened === true) {
+							if (isRecord$9(value) && value.opened === true) {
 								this.socketReady.get(id)?.resolve();
 								this.socketReady.delete(id);
 								continue;
@@ -7800,7 +8112,7 @@ window.__ModuleLoader__.load({
 			const policy = "default-src 'self' blob: data:; script-src 'self' blob: data: 'unsafe-inline' 'unsafe-eval'; style-src 'self' blob: data: 'unsafe-inline'; img-src 'self' blob: data:; font-src 'self' blob: data:; media-src 'self' blob: data:; worker-src 'self' blob:; connect-src 'none'; frame-src 'self' blob: data:";
 			for (const node of documentValue.querySelectorAll("meta[http-equiv]")) if ((node.getAttribute("http-equiv") ?? "").toLowerCase() === "content-security-policy") node.setAttribute("content", policy);
 		}
-		function isRecord$8(value) {
+		function isRecord$9(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		function toBytes(value) {
@@ -8917,14 +9229,14 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/cli-catalog.ts
 		/** Client 侧访问 Host CLI 命名空间的统一入口。 */
-		async function callCliRpc(rpc, action, payload) {
+		async function callCliRpc(rpc, action, payload, signal) {
 			let response;
 			try {
 				debugInfo("codingns4dsh: cli rpc request", {
 					channel: CODINGNS_RPC_CHANNEL,
 					action
 				});
-				response = await rpc.call(CODINGNS_RPC_CHANNEL, `cli/${action}`, payload);
+				response = await rpc.call(CODINGNS_RPC_CHANNEL, `cli/${action}`, payload, signal);
 			} catch (error) {
 				const message = error instanceof Error ? error.message : String(error);
 				if (!/HTTP (?:404|405)\b/u.test(message)) throw error;
@@ -8933,7 +9245,7 @@ window.__ModuleLoader__.load({
 					error: message
 				});
 				try {
-					response = await rpc.call("/api", `codingns/cli/${action}`, payload);
+					response = await rpc.call("/api", `codingns/cli/${action}`, payload, signal);
 				} catch (fallbackError) {
 					console.error("codingns4dsh: cli rpc fallback failed", {
 						action,
@@ -9101,11 +9413,11 @@ window.__ModuleLoader__.load({
 			};
 		}
 		function readMarker(event) {
-			if (!isRecord$7(event)) return null;
+			if (!isRecord$8(event)) return null;
 			const data = event.data;
-			if (!isRecord$7(data)) return null;
-			const candidate = event.type === "assistant/live-chunk" ? isRecord$7(data.chunk) ? data.chunk.codingnsExternalTool : void 0 : event.type === "assistant/attempt" ? data.codingnsExternalTool : void 0;
-			if (!isRecord$7(candidate) || candidate.source !== "codingns-external-tool") return null;
+			if (!isRecord$8(data)) return null;
+			const candidate = event.type === "assistant/live-chunk" ? isRecord$8(data.chunk) ? data.chunk.codingnsExternalTool : void 0 : event.type === "assistant/attempt" ? data.codingnsExternalTool : void 0;
+			if (!isRecord$8(candidate) || candidate.source !== "codingns-external-tool") return null;
 			if (typeof candidate.callId !== "string" || candidate.callId === "") return null;
 			if (typeof candidate.name !== "string" || typeof candidate.arguments !== "string") return null;
 			if (candidate.phase !== "start" && candidate.phase !== "update") return null;
@@ -9121,7 +9433,7 @@ window.__ModuleLoader__.load({
 				...typeof candidate.error === "string" ? { error: candidate.error } : {}
 			};
 		}
-		function isRecord$7(value) {
+		function isRecord$8(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		//#endregion
@@ -9199,7 +9511,11 @@ window.__ModuleLoader__.load({
 		/** 对话根节点上承载当前会话 id 的 DSH 属性。 */
 		const CONTEXT_BREAKDOWN_CONVERSATION_ATTRIBUTE = "data-conversation-session";
 		/** 默认隐藏构成明细的适配器：它们自己组装请求，启发式估算与真实上下文不同源。 */
-		const DEFAULT_CONTEXT_BREAKDOWN_HIDDEN_ADAPTERS = ["codex"];
+		const DEFAULT_CONTEXT_BREAKDOWN_HIDDEN_ADAPTERS = [
+			"codex",
+			"qoder",
+			"qoder-cn"
+		];
 		/** 适配器未知时请求刷新映射的最小间隔，避免面板长时间停留时反复查询。 */
 		const ADAPTER_REFRESH_INTERVAL_MS = 5e3;
 		const CONTEXT_BREAKDOWN_STYLE_TEXT = `[${CONTEXT_BREAKDOWN_HIDDEN_ATTRIBUTE}]>dl{display:none!important}[${CONTEXT_BREAKDOWN_HIDDEN_ATTRIBUTE}]>div:nth-of-type(2){display:none!important}`;
@@ -9493,7 +9809,7 @@ window.__ModuleLoader__.load({
 					decoratePopupRows(listboxes, options.popupPlaceholder(), iconUrl);
 				}
 				decorateReferenceChips(dom, iconUrl);
-				decorateTimelineMessages(dom, iconUrl, options);
+				decorateTimelineMessages$1(dom, iconUrl, options);
 				decorateComposerPlaceholders(dom, options.composerPlaceholder);
 			};
 			const scan = () => {
@@ -9726,23 +10042,23 @@ window.__ModuleLoader__.load({
 		* `user/message` 也会携带这段传输文本。这里仅处理 DSH 的 userRow/bubble，
 		* 不触碰 assistant、代码块和普通页面文本，避免把模型内容中的 carrier 改写。
 		*/
-		function decorateTimelineMessages(dom, iconUrl, options) {
+		function decorateTimelineMessages$1(dom, iconUrl, options) {
 			const rows = [...dom.querySelectorAll("[class*=\"userRow\"]")];
 			for (const row of dom.querySelectorAll("[data-submission-echo]")) if (!rows.includes(row)) rows.push(row);
 			for (const row of rows) {
 				const bubble = row.querySelector("[class*=\"bubble\"]") ?? row.querySelector("[class*=\"preview\"]");
 				if (bubble === null) continue;
-				decorateTimelineNode(bubble, dom, iconUrl, options);
+				decorateTimelineNode$1(bubble, dom, iconUrl, options);
 			}
 		}
-		function decorateTimelineNode(node, dom, iconUrl, options) {
+		function decorateTimelineNode$1(node, dom, iconUrl, options) {
 			if (node.nodeType === 3) {
 				const value = node.nodeValue ?? "";
 				if (value.includes("<!--codingns:delegate:") || value.includes(DELEGATION_INSTRUCTION_MARKER)) replaceTimelineTextNode(node, value, dom, iconUrl, options);
 				return;
 			}
 			if (node.nodeType !== 1 || node.hasAttribute("data-codingns-delegate-timeline-chip") || node.hasAttribute("data-codingns-delegation-card")) return;
-			for (const child of [...node.childNodes]) decorateTimelineNode(child, dom, iconUrl, options);
+			for (const child of [...node.childNodes]) decorateTimelineNode$1(child, dom, iconUrl, options);
 		}
 		/** 解析 Host 改写后的委派指令，提取用户真正关心的任务和目标 Agent。 */
 		function parseDelegationTimelineCard(value) {
@@ -9956,6 +10272,51 @@ window.__ModuleLoader__.load({
 		}));
 		//#endregion
 		//#region src/client/model-catalog-cache.ts
+		function cacheEntry(rpc, adapterId) {
+			return cacheTimesFor(rpc).get(adapterId);
+		}
+		function cacheTimesFor(rpc) {
+			const key = rpc;
+			let times = modelCatalogCacheTimes.get(key);
+			if (times === void 0) {
+				times = /* @__PURE__ */ new Map();
+				modelCatalogCacheTimes.set(key, times);
+			}
+			return times;
+		}
+		function storeCatalog(rpc, adapterId, value) {
+			getModelCatalogCache(rpc).set(adapterId, value);
+			cacheTimesFor(rpc).set(adapterId, {
+				value,
+				storedAt: Date.now()
+			});
+		}
+		/** 作废某个适配器（或全部适配器）的 Client 目录缓存。 */
+		function invalidateModelCatalogCache(rpc, adapterId) {
+			const cache = getModelCatalogCache(rpc);
+			const times = cacheTimesFor(rpc);
+			if (adapterId === void 0) {
+				cache.clear();
+				times.clear();
+				return;
+			}
+			cache.delete(adapterId);
+			times.delete(adapterId);
+		}
+		function shouldRevalidateModelCatalog(rpc, adapterId, needsRevalidation) {
+			if (!needsRevalidation) return false;
+			const key = rpc;
+			let times = modelCatalogRevalidations.get(key);
+			if (times === void 0) {
+				times = /* @__PURE__ */ new Map();
+				modelCatalogRevalidations.set(key, times);
+			}
+			const last = times.get(adapterId);
+			const now = Date.now();
+			if (last !== void 0 && now - last < 6e4) return false;
+			times.set(adapterId, now);
+			return true;
+		}
 		function getModelCatalogCache(rpc) {
 			const key = rpc;
 			let cache = modelCatalogCaches.get(key);
@@ -9967,8 +10328,8 @@ window.__ModuleLoader__.load({
 		}
 		function loadModelCatalog(rpc, adapterId, sessionId) {
 			const cached = getModelCatalogCache(rpc).get(adapterId);
-			if (cached !== void 0 && cached.fallback !== true) return Promise.resolve(cached);
-			if (cached?.fallback === true) getModelCatalogCache(rpc).delete(adapterId);
+			if (cached !== void 0 && cached.fallback !== true && isFreshCacheEntry(rpc, adapterId, cached)) return Promise.resolve(cached);
+			if (cached !== void 0) invalidateModelCatalogCache(rpc, adapterId);
 			const loads = getModelCatalogLoadCache(rpc);
 			const running = loads.get(adapterId);
 			if (running !== void 0) return running;
@@ -9976,8 +10337,8 @@ window.__ModuleLoader__.load({
 				adapterId,
 				...sessionId === void 0 ? {} : { sessionId }
 			}).then((value) => {
-				if (value.fallback === true) getModelCatalogCache(rpc).delete(adapterId);
-				else getModelCatalogCache(rpc).set(adapterId, value);
+				if (value.fallback === true) invalidateModelCatalogCache(rpc, adapterId);
+				else storeCatalog(rpc, adapterId, value);
 				return value;
 			}).finally(() => {
 				if (loads.get(adapterId) === request) loads.delete(adapterId);
@@ -9985,6 +10346,12 @@ window.__ModuleLoader__.load({
 			loads.set(adapterId, request);
 			return request;
 		}
+		/** 缓存条目是否仍在有效期内；没有时间戳的旧条目按过期处理并触发一次重新读取。 */
+		function isFreshCacheEntry(rpc, adapterId, cached) {
+			const entry = cacheEntry(rpc, adapterId);
+			if (entry === void 0 || entry.value !== cached) return false;
+			return Date.now() - entry.storedAt < MODEL_CATALOG_CACHE_TTL_MS;
+		}
 		function getModelCatalogLoadCache(rpc) {
 			const key = rpc;
 			let cache = modelCatalogLoads.get(key);
@@ -9994,11 +10361,15 @@ window.__ModuleLoader__.load({
 			}
 			return cache;
 		}
-		var modelCatalogCaches, modelCatalogLoads;
+		var modelCatalogCaches, modelCatalogLoads, MODEL_CATALOG_CACHE_TTL_MS, modelCatalogCacheTimes, MODEL_CATALOG_REVALIDATE_INTERVAL_MS, modelCatalogRevalidations;
 		var init_model_catalog_cache = __esmMin((() => {
 			init_cli_catalog();
 			modelCatalogCaches = /* @__PURE__ */ new WeakMap();
 			modelCatalogLoads = /* @__PURE__ */ new WeakMap();
+			MODEL_CATALOG_CACHE_TTL_MS = 6e4;
+			modelCatalogCacheTimes = /* @__PURE__ */ new WeakMap();
+			MODEL_CATALOG_REVALIDATE_INTERVAL_MS = 6e4;
+			modelCatalogRevalidations = /* @__PURE__ */ new WeakMap();
 		}));
 		//#endregion
 		//#region src/dsh-capabilities/client/primitives-adapter.ts
@@ -10014,6 +10385,28 @@ window.__ModuleLoader__.load({
 			const value = _deepseek_ai_dsh_client_ui_primitives;
 			return value.IconChevronDownOutlineRegular ?? value.IconChevronDownOutlineMedium ?? value.IconChevronDownOutline14 ?? unavailableIcon;
 		}
+		/** 终端工具栏使用的原生刷新图标。 */
+		function resolveRefreshIcon() {
+			const value = _deepseek_ai_dsh_client_ui_primitives;
+			return value.IconRefreshOutlineRegular ?? value.IconRefreshOutlineMedium ?? unavailableIcon;
+		}
+		/** 终端工具栏入口使用的原生工具图标。 */
+		function resolveToolIcon() {
+			const value = _deepseek_ai_dsh_client_ui_primitives;
+			return value.IconSlidersTwoOutlineRegular ?? value.IconSlidersTwoOutlineMedium ?? value.IconSettingsOutlineRegular ?? value.IconSettingsOutlineMedium ?? unavailableIcon;
+		}
+		/** 终端快捷操作的方向图标。 */
+		function resolveTerminalArrowIcon(direction) {
+			const value = _deepseek_ai_dsh_client_ui_primitives;
+			if (direction === "up") return value.IconChevronUpOutlineRegular ?? value.IconChevronUpOutlineMedium ?? unavailableIcon;
+			if (direction === "down") return value.IconChevronDownOutlineRegular ?? value.IconChevronDownOutlineMedium ?? unavailableIcon;
+			if (direction === "left") return value.IconChevronLeftOutlineRegular ?? value.IconChevronLeftOutlineMedium ?? unavailableIcon;
+			return value.IconChevronRightOutlineRegular ?? value.IconChevronRightOutlineMedium ?? unavailableIcon;
+		}
+		/** 终端按键标签使用 DSH 原生 ShortcutKeys，旧版本缺失时退回纯文本。 */
+		function resolveShortcutKeys() {
+			return _deepseek_ai_dsh_client_ui_primitives.ShortcutKeys ?? fallbackShortcutKeys;
+		}
 		/**
 		* 模型图标：DSH 原生模型选择器在紧凑状态显示的 data 图标（0.1.7 起为 Regular/Medium，
 		* 0.1.6 为 16 后缀），插件模型选择器收起时与之保持一致。
@@ -10030,9 +10423,10 @@ window.__ModuleLoader__.load({
 			const value = _deepseek_ai_dsh_client_ui_primitives;
 			return value.IconShareOutlineRegular ?? value.IconShareOutlineMedium ?? value.IconSendOutlineRegular ?? value.IconSendOutlineMedium ?? resolveDataIcon();
 		}
-		var unavailableIcon;
+		var unavailableIcon, fallbackShortcutKeys;
 		var init_primitives_adapter = __esmMin((() => {
 			unavailableIcon = () => null;
+			fallbackShortcutKeys = ({ keys }) => (0, react.createElement)("span", void 0, keys.join(" + "));
 		}));
 		//#endregion
 		//#region src/client/delegate-command.ts
@@ -10071,7 +10465,7 @@ window.__ModuleLoader__.load({
 		}
 		/** 在 commandUi 就绪的作用域内注册 `/委派`；失败只降级为不注册。 */
 		function registerDelegateCommandIn(ctx, options) {
-			const commandUi = readCommandUi(ctx);
+			const commandUi = readCommandUi$1(ctx);
 			if (commandUi === void 0) {
 				debugWarn("codingns4dsh: /委派 未注册，当前 DSH 未提供 commandUi 服务");
 				return;
@@ -10101,7 +10495,7 @@ window.__ModuleLoader__.load({
 							return list;
 						},
 						async onSelect(option, session) {
-							const input = readSessionInput(ctx, session.sessionId);
+							const input = readSessionInput$1(ctx, session.sessionId);
 							if (input === void 0) return;
 							const snapshot = input.state.getSnapshot();
 							const draft = snapshot.draft ?? "";
@@ -10159,7 +10553,7 @@ window.__ModuleLoader__.load({
 		}
 		/** 注册结构化 Agent 引用源：显示层使用 chip，提交层再序列化为 Host carrier。 */
 		function registerDelegateReferenceSource(ctx, options) {
-			const inputTriggers = readService(ctx, "inputTriggers");
+			const inputTriggers = readService$1(ctx, "inputTriggers");
 			const source = {
 				trigger: "@",
 				name: DELEGATE_REFERENCE_SOURCE,
@@ -10262,8 +10656,8 @@ window.__ModuleLoader__.load({
 			};
 			const inputFor = (sessionId) => {
 				try {
-					const conversation = readConversation(ctx);
-					const actx = readSessions(ctx)?.scope(sessionId);
+					const conversation = readConversation$1(ctx);
+					const actx = readSessions$1(ctx)?.scope(sessionId);
 					if (actx !== void 0 && conversation !== void 0) return conversation.input.for(actx);
 					return conversation?.input.shell?.(sessionId);
 				} catch {
@@ -10627,29 +11021,29 @@ window.__ModuleLoader__.load({
 				query: before.slice(hash + 1)
 			};
 		}
-		function readSessionInput(ctx, sessionId) {
+		function readSessionInput$1(ctx, sessionId) {
 			try {
-				const actx = readSessions(ctx)?.scope(sessionId);
+				const actx = readSessions$1(ctx)?.scope(sessionId);
 				if (actx === void 0) return void 0;
-				return readConversation(ctx)?.input.for(actx);
+				return readConversation$1(ctx)?.input.for(actx);
 			} catch {
 				return;
 			}
 		}
-		function readCommandUi(ctx) {
-			const service = readService(ctx, "commandUi");
+		function readCommandUi$1(ctx) {
+			const service = readService$1(ctx, "commandUi");
 			return service !== void 0 && typeof service.register === "function" ? service : void 0;
 		}
-		function readSessions(ctx) {
-			const service = readService(ctx, "sessions");
+		function readSessions$1(ctx) {
+			const service = readService$1(ctx, "sessions");
 			return service !== void 0 && typeof service.scope === "function" ? service : void 0;
 		}
-		function readConversation(ctx) {
-			const service = readService(ctx, "conversation");
+		function readConversation$1(ctx) {
+			const service = readService$1(ctx, "conversation");
 			return service !== void 0 && typeof service.input?.for === "function" ? service : void 0;
 		}
 		/** Cordis 直接读取未声明的服务会抛 without-inject；探测统一走这里。 */
-		function readService(ctx, name) {
+		function readService$1(ctx, name) {
 			try {
 				return ctx.get(name);
 			} catch {
@@ -10721,6 +11115,20 @@ window.__ModuleLoader__.load({
 			return modelServiceTiers(model).find((tier) => tier.id === id);
 		}
 		/**
+		* 目录是否「声明了档位、但未确认官方订阅」——即档位开关缺席的原因可能只是判定过期。
+		*
+		* 这一状态有两种来源，界面上无法区分：
+		* - 真实第三方中转/纯 API key：档位确实不会生效，应当持续不展示；
+		* - 判定过期：用户在外部工具（cc-switch 等）里刚切回官方订阅，而页面还持有旧目录。
+		*
+		* 因此它只用来决定「值得再探测一次」，不能用来决定「应该展示开关」。重新探测由
+		* Host 的 Provider 配置指纹保证廉价：配置没变时 Host 直接返回缓存，不会重启 CLI。
+		*/
+		function needsServiceTierRevalidation(catalog) {
+			if (catalog === null || catalog.officialSubscription === true) return false;
+			return catalog.groups.some((group) => group.models.some((model) => modelServiceTiers(model).length > 0));
+		}
+		/**
 		* 在“只改了其它字段”的部分更新里保留当前档位选择。
 		*
 		* 这是本功能最容易被写坏的地方：档位与模型/思考等级共用同一份会话配置，任何一次
@@ -10748,7 +11156,9 @@ window.__ModuleLoader__.load({
 		var cli_slots_exports = /* @__PURE__ */ __exportAll({
 			AgentSlot: () => AgentSlot,
 			ModelSlot: () => ModelSlot,
-			registerCliConversationSlots: () => registerCliConversationSlots
+			cliSessionSelectionRevision: () => cliSessionSelectionRevision,
+			registerCliConversationSlots: () => registerCliConversationSlots,
+			waitForCliSessionSelection: () => waitForCliSessionSelection
 		});
 		function installComposerStyles() {
 			if (typeof document === "undefined" || document.querySelector(`style[data-plugin-css="${CLI_STYLE_ID}"]`) !== null) return;
@@ -10781,6 +11191,20 @@ window.__ModuleLoader__.load({
 			].join("");
 			document.head.appendChild(style);
 		}
+		/** 等待会话 Agent 选择写入 Host，避免切换后立即打开命令菜单仍读到旧 Agent。 */
+		async function waitForCliSessionSelection(sessionId) {
+			if (sessionId.trim() === "") return;
+			for (;;) {
+				const pending = selectionUpdates.get(sessionId);
+				if (pending === void 0) return;
+				await pending.promise;
+				if (selectionUpdates.get(sessionId) === pending) return;
+			}
+		}
+		/** 读取当前会话 Agent 选择版本，供按会话缓存的目录在切换 Agent 后失效。 */
+		function cliSessionSelectionRevision(sessionId) {
+			return selectionRevisions.get(sessionId) ?? 0;
+		}
 		/** 在 Agent 和模型两个 Slot 之间共享当前会话选择。 */
 		function useSelection(sessionId, rpc) {
 			const [selection, setSelection] = (0, react.useState)(() => sessionId ? selections.get(sessionId) ?? DEFAULT_SELECTION : DEFAULT_SELECTION);
@@ -11084,6 +11508,7 @@ window.__ModuleLoader__.load({
 			});
 			const catalog = catalogState?.adapterId === selection.adapterId ? catalogState.value : null;
 			const loading = selection.adapterId !== "dsh" && catalog === null && refreshingAdapterId === selection.adapterId;
+			const serviceTierRevalidation = needsServiceTierRevalidation(catalog);
 			(0, react.useEffect)(() => {
 				if (selection.adapterId === "dsh") {
 					setCatalogState(null);
@@ -11099,6 +11524,7 @@ window.__ModuleLoader__.load({
 					value: cached
 				});
 				setRefreshingAdapterId(adapterId);
+				if (shouldRevalidateModelCatalog(props.rpc, adapterId, needsServiceTierRevalidation(cached ?? null))) invalidateModelCatalogCache(props.rpc, adapterId);
 				loadModelCatalog(props.rpc, adapterId, sessionId).then((value) => {
 					if (!active) return;
 					setCatalogState({
@@ -11119,7 +11545,7 @@ window.__ModuleLoader__.load({
 						if (model.id !== currentSelection.modelId || effort !== currentSelection.effortId || tier !== currentSelection.serviceTierId) update({
 							adapterId,
 							modelId: model.id,
-							...effort ? { effortId: effort } : {},
+							effortId: effort ?? "default",
 							...tier ? { serviceTierId: tier } : {}
 						});
 					};
@@ -11149,13 +11575,33 @@ window.__ModuleLoader__.load({
 				sessionId,
 				catalogRetry
 			]);
+			/**
+			* 档位判定处于「未确认官方订阅」时周期复检。
+			*
+			* 用户在 cc-switch 之类的工具里切回官方订阅不会触发页面事件，唯一能发现变化的
+			* 方式就是再探测一次。这里只负责到点触发一次目录重读，是否真正作废缓存交给主
+			* effect 的节流判定——若在本 effect 里调用节流函数，会先消耗掉窗口，紧接着主
+			* effect 的判定就被挡下，反而不会重新请求。
+			*
+			* 探测本身很廉价：Host 比对配置指纹后，配置没变就直接返回缓存，不会重启 CLI。
+			* 真实第三方接入会长期停在该状态，因此轮询持续存在，代价是每分钟一次缓存命中的
+			* RPC；这换取的是用户切换供应商后无需刷新页面。
+			*/
+			(0, react.useEffect)(() => {
+				if (!serviceTierRevalidation) return;
+				const timer = setInterval(() => {
+					setCatalogRetry((value) => value + 1);
+				}, MODEL_CATALOG_REVALIDATE_INTERVAL_MS + 5e3);
+				return () => clearInterval(timer);
+			}, [selection.adapterId, serviceTierRevalidation]);
 			(0, react.useEffect)(() => {
 				if (selection.adapterId === "dsh") setOpen(false);
 			}, [selection.adapterId]);
 			if (selection.adapterId === "dsh") return null;
 			const model = catalog === null ? void 0 : findModel(catalog, selection.modelId) ?? firstModel(catalog);
 			const efforts = model?.efforts ?? [];
-			const effortValue = selection.effortId ?? (efforts.length > 0 ? defaultEffort(efforts) : void 0) ?? "default";
+			const storedEffort = selection.effortId;
+			const effortValue = storedEffort !== void 0 && (model === void 0 || efforts.includes(storedEffort)) ? storedEffort : defaultEffort(efforts) ?? "default";
 			const modelLabel = model?.name ?? (loading ? t("cli.loadingModel") : t("cli.noModelsAvailable"));
 			const effortLabel = effortDisplayName(model, effortValue, t("cli.defaultEffort"));
 			const modelUnavailable = model === void 0;
@@ -11166,7 +11612,7 @@ window.__ModuleLoader__.load({
 				update({
 					adapterId: selection.adapterId,
 					modelId: next.id,
-					...nextEffort ? { effortId: nextEffort } : {},
+					effortId: nextEffort ?? "default",
 					...nextTier ? { serviceTierId: nextTier } : {}
 				});
 				setOpen(false);
@@ -11501,6 +11947,7 @@ window.__ModuleLoader__.load({
 				minWidth: 240,
 				maxWidth: "min(420px, calc(100vw - 32px))",
 				maxHeight: "min(360px, calc(100vh - 96px))",
+				overflowX: "hidden",
 				overflowY: "auto",
 				padding: 4,
 				border: 0,
@@ -11509,6 +11956,7 @@ window.__ModuleLoader__.load({
 			nativeMenuCellStyle = {
 				width: "100%",
 				minHeight: 40,
+				boxSizing: "border-box",
 				color: "inherit",
 				cursor: "pointer",
 				background: "transparent",
@@ -11525,6 +11973,7 @@ window.__ModuleLoader__.load({
 			serviceTierRowStyle = {
 				width: "100%",
 				minHeight: 40,
+				boxSizing: "border-box",
 				color: "inherit",
 				borderRadius: 10,
 				padding: "0 10px",
@@ -12229,7 +12678,7 @@ window.__ModuleLoader__.load({
 					...value,
 					defaultProfile: event.currentTarget.value
 				}),
-				style: fieldStyle$1
+				style: fieldStyle$2
 			}, ...profileOptions(value.defaultProfile, hostStatus, t).map((profile) => (0, react.createElement)("option", {
 				key: profile.profileId,
 				value: profile.profileId,
@@ -12244,7 +12693,7 @@ window.__ModuleLoader__.load({
 					...value,
 					bindingScope: event.currentTarget.value === "session" ? "session" : "workspace"
 				}),
-				style: fieldStyle$1
+				style: fieldStyle$2
 			}, (0, react.createElement)("option", { value: "workspace" }, t("terminal.workspaceBinding")), (0, react.createElement)("option", { value: "session" }, t("terminal.sessionBinding")))), (0, react.createElement)("div", { style: dshSettingsSectionHeaderStyle }, (0, react.createElement)("h3", { style: {
 				margin: 0,
 				color: dshThemeColor.labelPrimary,
@@ -12306,7 +12755,7 @@ window.__ModuleLoader__.load({
 				value: appearance.cursorStyle,
 				disabled,
 				onChange: (event) => updateAppearance({ cursorStyle: parseCursorStyle(event.currentTarget.value) }),
-				style: fieldStyle$1
+				style: fieldStyle$2
 			}, (0, react.createElement)("option", { value: "block" }, t("terminal.cursorBlock")), (0, react.createElement)("option", { value: "bar" }, t("terminal.cursorBar")), (0, react.createElement)("option", { value: "underline" }, t("terminal.cursorUnderline")))), (0, react.createElement)(NumberField, {
 				label: t("terminal.scrollback"),
 				value: appearance.scrollback,
@@ -12355,7 +12804,7 @@ window.__ModuleLoader__.load({
 				disabled,
 				onChange: (event) => onChange(event.currentTarget.value === "" ? null : Number(event.currentTarget.value)),
 				style: {
-					...fieldStyle$1,
+					...fieldStyle$2,
 					flex: 1,
 					minWidth: 0
 				}
@@ -12419,7 +12868,7 @@ window.__ModuleLoader__.load({
 		function parseCursorStyle(value) {
 			return value === "block" || value === "bar" || value === "underline" ? value : null;
 		}
-		const fieldStyle$1 = dshSettingsFieldStyle;
+		const fieldStyle$2 = dshSettingsFieldStyle;
 		const buttonStyle = {
 			...dshSettingsButtonStyle,
 			flex: "0 0 auto",
@@ -12483,17 +12932,17 @@ window.__ModuleLoader__.load({
 		*/
 		function readNativeWorkspaceListStore(uiContext) {
 			const store = readNativeService(uiContext, "workspaces", "list");
-			if (!isRecord$6(store) || typeof store.getSnapshot !== "function" || typeof store.subscribe !== "function") return void 0;
+			if (!isRecord$7(store) || typeof store.getSnapshot !== "function" || typeof store.subscribe !== "function") return void 0;
 			return store;
 		}
 		/** 读取原生 Workspace 快照；形状不符或服务缺失时返回 undefined，调用方退回原生 Remote。 */
 		function readNativeWorkspaceSnapshot(uiContext) {
 			const snapshot = readNativeWorkspaceListStore(uiContext)?.getSnapshot();
-			const record = isRecord$6(snapshot) ? snapshot : void 0;
+			const record = isRecord$7(snapshot) ? snapshot : void 0;
 			if (record === void 0 || !Array.isArray(record.items)) return void 0;
 			return {
 				items: record.items.flatMap((item) => {
-					const value = isRecord$6(item) ? item : void 0;
+					const value = isRecord$7(item) ? item : void 0;
 					const workspaceId = readText(value?.workspaceId);
 					if (workspaceId === void 0) return [];
 					const path = readText(value?.path);
@@ -12516,7 +12965,7 @@ window.__ModuleLoader__.load({
 				if (typeof getter !== "function") return void 0;
 				const service = getter.call(uiContext, name);
 				if (field === void 0) return service;
-				return isRecord$6(service) ? service[field] : void 0;
+				return isRecord$7(service) ? service[field] : void 0;
 			} catch {
 				return;
 			}
@@ -12530,7 +12979,7 @@ window.__ModuleLoader__.load({
 				return text === void 0 ? [] : [text];
 			}) : [];
 		}
-		function isRecord$6(value) {
+		function isRecord$7(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		//#endregion
@@ -12564,7 +13013,7 @@ window.__ModuleLoader__.load({
 			const fiberKey = Object.getOwnPropertyNames(row).find((key) => key.startsWith("__reactFiber$"));
 			if (fiberKey === void 0) return void 0;
 			let current = carrier[fiberKey];
-			for (let depth = 0; depth < 32 && isRecord$5(current); depth += 1) {
+			for (let depth = 0; depth < 32 && isRecord$6(current); depth += 1) {
 				const fiber = current;
 				const sessionId = sessionIdFromProps(fiber.memoizedProps) ?? sessionIdFromProps(fiber.pendingProps);
 				if (sessionId !== void 0) return sessionId;
@@ -12572,15 +13021,15 @@ window.__ModuleLoader__.load({
 			}
 		}
 		function sessionIdFromProps(value) {
-			if (!isRecord$5(value)) return void 0;
+			if (!isRecord$6(value)) return void 0;
 			for (const key of ["node", "result"]) {
 				const candidate = value[key];
-				if (!isRecord$5(candidate) || typeof candidate.id !== "string") continue;
+				if (!isRecord$6(candidate) || typeof candidate.id !== "string") continue;
 				const sessionId = candidate.id.trim();
 				if (sessionId !== "") return sessionId;
 			}
 		}
-		function isRecord$5(value) {
+		function isRecord$6(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		//#endregion
@@ -12947,7 +13396,7 @@ window.__ModuleLoader__.load({
 		}
 		function findWorkspaceIdInFiber(value) {
 			let current = value;
-			for (let depth = 0; depth < 24 && isRecord$4(current); depth += 1) {
+			for (let depth = 0; depth < 24 && isRecord$5(current); depth += 1) {
 				for (const props of [current.memoizedProps, current.pendingProps]) {
 					const id = findWorkspaceIdInProps(props);
 					if (id !== void 0) return id;
@@ -12956,7 +13405,7 @@ window.__ModuleLoader__.load({
 			}
 		}
 		function findWorkspaceIdInProps(value) {
-			if (!isRecord$4(value)) return void 0;
+			if (!isRecord$5(value)) return void 0;
 			for (const key of ["workspaceId", "workspaceID"]) {
 				const id = readString$1(value[key]);
 				if (id !== void 0) return id;
@@ -13355,7 +13804,7 @@ window.__ModuleLoader__.load({
 			dom.querySelector(`[${WORKSPACE_SESSION_ARCHIVE_MODAL_ATTRIBUTE}]`)?.remove();
 		}
 		function normalizeRemote(value) {
-			if (!isRecord$4(value)) return {};
+			if (!isRecord$5(value)) return {};
 			const workspace = asRecord$4(readRemoteProperty(value, "workspace")) ?? asRecord$4(readRemoteProperty(value, "workspaceController"));
 			const session = asRecord$4(readRemoteProperty(value, "session")) ?? asRecord$4(readRemoteProperty(value, "sessionController"));
 			return {
@@ -13381,7 +13830,7 @@ window.__ModuleLoader__.load({
 			}) : [];
 		}
 		function asRecord$4(value) {
-			return isRecord$4(value) ? value : void 0;
+			return isRecord$5(value) ? value : void 0;
 		}
 		/** DSH Remote 的直接调用返回 RemoteResult；测试桩和旧宿主可能直接返回 value。 */
 		function unwrapRemoteValue$1(value) {
@@ -13389,7 +13838,7 @@ window.__ModuleLoader__.load({
 			if (record === void 0 || typeof record.ok !== "boolean") return value;
 			return record.ok ? record.value : void 0;
 		}
-		function isRecord$4(value) {
+		function isRecord$5(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		//#endregion
@@ -14110,6 +14559,19 @@ window.__ModuleLoader__.load({
 		//#region src/client/features/workspace-session-enhancement-panel.ts
 		init_theme();
 		init_locale();
+		/** 用量查询设置入口的图标按钮：沿用共享按钮表面，只收成方形并居中图标。 */
+		const usageSettingsIconButtonStyle = {
+			...dshSettingsButtonStyle,
+			flex: "0 0 auto",
+			width: 36,
+			height: 36,
+			minHeight: 36,
+			padding: 0,
+			boxSizing: "border-box",
+			display: "inline-flex",
+			alignItems: "center",
+			justifyContent: "center"
+		};
 		/** 工作区会话增强的单列设置面板。 */
 		function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot, notify }) {
 			const t = useCodingNsTranslator(services.locale);
@@ -14176,6 +14638,25 @@ window.__ModuleLoader__.load({
 				display: "block",
 				fontSize: 13,
 				lineHeight: 1.4
+			} }, t("workspace.showSkillQuickReference")), (0, react.createElement)("span", { style: {
+				display: "block",
+				marginTop: 3,
+				...dshSettingsHelpStyle
+			} }, t("workspace.skillQuickReferenceDescription"))), (0, react.createElement)("input", {
+				type: "checkbox",
+				role: "switch",
+				"aria-label": t("workspace.showSkillQuickReference"),
+				checked: value.showSkillQuickReference,
+				disabled,
+				onChange: (event) => updateSetting("showSkillQuickReference", event.currentTarget.checked),
+				style: {
+					flex: "0 0 auto",
+					accentColor: dshThemeColor.accent
+				}
+			})), (0, react.createElement)("label", { style: dshSettingsListRowStyle }, (0, react.createElement)("span", { style: { minWidth: 0 } }, (0, react.createElement)("strong", { style: {
+				display: "block",
+				fontSize: 13,
+				lineHeight: 1.4
 			} }, t("workspace.showWorkspaceHiding")), (0, react.createElement)("span", { style: {
 				display: "block",
 				marginTop: 3,
@@ -14222,10 +14703,11 @@ window.__ModuleLoader__.load({
 				"aria-haspopup": "dialog",
 				"aria-expanded": usageSettingsOpen,
 				"aria-label": t("workspace.subscriptionUsageSettings"),
+				title: t("workspace.subscriptionUsageSettings"),
 				disabled,
 				onClick: () => setUsageSettingsOpen(true),
-				style: dshSettingsButtonStyle
-			}, t("workspace.subscriptionUsageSettings"))), (0, react.createElement)("label", { style: dshSettingsListRowStyle }, (0, react.createElement)("span", { style: { minWidth: 0 } }, (0, react.createElement)("strong", { style: {
+				style: usageSettingsIconButtonStyle
+			}, createUsageSettingsGearIcon())), (0, react.createElement)("label", { style: dshSettingsListRowStyle }, (0, react.createElement)("span", { style: { minWidth: 0 } }, (0, react.createElement)("strong", { style: {
 				display: "block",
 				fontSize: 13,
 				lineHeight: 1.4
@@ -14289,6 +14771,40 @@ window.__ModuleLoader__.load({
 				onClose: () => setUsageSettingsOpen(false)
 			}));
 		}
+		/**
+		* 用量查询设置入口的齿轮图标。
+		*
+		* 文字收成图形后，可访问名称由按钮自身的 aria-label/title 保留；图标只做装饰，
+		* 对读屏和指针都隐藏，避免重复朗读和吞掉点击。
+		*/
+		function createUsageSettingsGearIcon() {
+			return (0, react.createElement)("svg", {
+				width: 17,
+				height: 17,
+				viewBox: "0 0 24 24",
+				fill: "none",
+				focusable: false,
+				"aria-hidden": true,
+				style: {
+					display: "block",
+					pointerEvents: "none"
+				}
+			}, (0, react.createElement)("path", {
+				d: "M19.43 12.98c.04-.32.07-.65.07-.98s-.02-.66-.07-.98l2.11-1.65a.5.5 0 0 0 .12-.64l-2-3.46a.5.5 0 0 0-.61-.22l-2.49 1a7.4 7.4 0 0 0-1.7-.98L14.5 2.42A.49.49 0 0 0 14.01 2h-4a.49.49 0 0 0-.49.42L9.14 5.07c-.61.25-1.18.58-1.7.98l-2.49-1a.5.5 0 0 0-.61.22l-2 3.46a.5.5 0 0 0 .12.64l2.11 1.65c-.04.32-.08.65-.08.98s.03.66.08.98l-2.11 1.65a.5.5 0 0 0-.12.64l2 3.46c.12.21.37.3.61.22l2.49-1c.52.4 1.09.73 1.7.98l.38 2.65c.04.24.25.42.49.42h4c.24 0 .45-.18.49-.42l.38-2.65c.61-.25 1.18-.58 1.7-.98l2.49 1c.24.09.49-.01.61-.22l2-3.46a.5.5 0 0 0-.12-.64l-2.11-1.65Z",
+				fill: "currentColor",
+				fillOpacity: .22,
+				stroke: "currentColor",
+				strokeWidth: 1.35,
+				strokeLinejoin: "round"
+			}), (0, react.createElement)("circle", {
+				cx: 12,
+				cy: 12,
+				r: 3.1,
+				fill: dshThemeColor.accent,
+				stroke: "currentColor",
+				strokeWidth: 1.15
+			}));
+		}
 		//#endregion
 		//#region src/client/subscription-slot.ts
 		init_cli_catalog();
@@ -14404,7 +14920,7 @@ window.__ModuleLoader__.load({
 							setProviderId(selection.providerId ?? null);
 						}
 						const intervalMins = props.getRefreshIntervalMins?.() ?? DEFAULT_SUBSCRIPTION_USAGE_SETTINGS.refreshIntervalMins;
-						const cacheKey = `${adapterId}|${selection.providerId ?? ""}`;
+						const cacheKey = `${adapterId}|${selection.providerId ?? ""}|${selection.modelId ?? ""}`;
 						const cached = subscriptionUsageCache.get(cacheKey);
 						if (cached !== void 0 && cached.usage.provider?.capability !== "new-api" && isSubscriptionUsageFresh(cached.capturedAt, Date.now(), intervalMins)) {
 							if (active) setUsage(cached.usage);
@@ -14412,7 +14928,8 @@ window.__ModuleLoader__.load({
 						}
 						const next = await callCliRpc(props.rpc, "subscription", {
 							adapterId,
-							...selection.providerId ? { providerId: selection.providerId } : {}
+							...selection.providerId ? { providerId: selection.providerId } : {},
+							...selection.modelId ? { modelId: selection.modelId } : {}
 						});
 						if (next !== null) subscriptionUsageCache.set(cacheKey, {
 							usage: next,
@@ -14649,16 +15166,8 @@ window.__ModuleLoader__.load({
 					window: usage.monthly
 				}
 			];
-			const credits = usage.credits ?? null;
-			const creditText = credits === null ? null : credits.unlimited ? t("usage.creditUnlimited") : credits.balance !== null ? formatCreditBalance(credits.balance) : credits.hasCredits ? "0.00" : "--";
-			const expiries = usage.resetCredits === null ? [] : usage.resetCredits.credits.map((credit) => credit.expiresAt).filter((expiry) => expiry !== null).sort((left, right) => left - right);
-			return (0, react.createElement)("div", {
-				className: "codingns4dsh-subscription-popover",
-				role: "dialog",
-				"aria-label": t("usage.popoverSubscriptionUsage", { provider: providerName }),
-				style: subscriptionPopoverStyle
-			}, (0, react.createElement)("div", { style: popoverHeadingStyle }, (0, react.createElement)("strong", void 0, t("usage.popoverSubscriptionTitle", { provider: providerName })), usage.planType && (0, react.createElement)("span", { style: { color: dshThemeColor.labelTertiary } }, formatPlanType(usage.planType))), ...windows.map(({ id, label, window }) => window === null ? null : (0, react.createElement)("section", {
-				key: id,
+			const renderWindow = (key, label, window) => window === null ? null : (0, react.createElement)("section", {
+				key,
 				style: windowStyle
 			}, (0, react.createElement)("div", { style: windowHeadingStyle }, (0, react.createElement)("span", void 0, label), (0, react.createElement)("span", void 0, `${formatPercent$1(window.remainingPercent)}%`)), (0, react.createElement)("div", {
 				role: "progressbar",
@@ -14673,7 +15182,25 @@ window.__ModuleLoader__.load({
 			}, (0, react.createElement)("span", { style: {
 				...barFillStyle,
 				width: `${window.remainingPercent}%`
-			} })), window.resetsAt !== null && (0, react.createElement)("div", { style: resetStyle }, t("usage.resetsIn", { time: formatCountdown(window.resetsAt, t) })))), (creditText !== null || usage.resetCredits !== null) && (0, react.createElement)("section", { style: resetCreditsSectionStyle }, creditText !== null && (0, react.createElement)("div", { style: resetCreditsRowStyle }, (0, react.createElement)("span", void 0, t("usage.creditBalanceLabel")), (0, react.createElement)("span", { style: resetCreditsValueStyle }, creditText)), usage.resetCredits !== null && (0, react.createElement)("div", { style: resetCreditsRowStyle }, (0, react.createElement)("span", void 0, t("usage.resetCreditsLabel")), (0, react.createElement)("span", { style: resetCreditsValueGroupStyle }, (0, react.createElement)("span", { style: resetCreditsValueStyle }, t("usage.resetCreditsCount", { count: usage.resetCredits.availableCount })), reset !== null && (0, react.createElement)("button", {
+			} })), window.resetsAt !== null && (0, react.createElement)("div", { style: resetStyle }, t("usage.resetsIn", { time: formatCountdown(window.resetsAt, t) })));
+			const quotaGroups = usage.groups ?? [];
+			const windowSections = quotaGroups.length > 0 ? quotaGroups.flatMap((group) => [(0, react.createElement)("div", {
+				key: `group:${group.id}`,
+				style: quotaGroupTitleStyle
+			}, formatSubscriptionGroupLabel(group, t)), ...group.windows.map((entry) => renderWindow(`group:${group.id}:${entry.kind}:${entry.label ?? ""}`, formatSubscriptionGroupWindowLabel(entry, t), entry.window))]) : windows.map(({ id, label, window }) => renderWindow(id, label, window));
+			const credits = usage.credits ?? null;
+			const creditText = credits === null ? null : credits.unlimited ? t("usage.creditUnlimited") : credits.balance !== null ? formatCreditBalance(credits.balance) : credits.hasCredits ? "0.00" : "--";
+			const expiries = usage.resetCredits === null ? [] : usage.resetCredits.credits.map((credit) => credit.expiresAt).filter((expiry) => expiry !== null).sort((left, right) => left - right);
+			const accountName = usage.accountName?.trim() || null;
+			const planLabel = usage.planType === null ? null : formatPlanType(usage.planType);
+			const paidPlanLabel = usage.paidPlanType?.trim() || null;
+			const planText = planLabel === null ? paidPlanLabel : paidPlanLabel === null || paidPlanLabel === planLabel ? planLabel : `${planLabel} · ${paidPlanLabel}`;
+			return (0, react.createElement)("div", {
+				className: "codingns4dsh-subscription-popover",
+				role: "dialog",
+				"aria-label": t("usage.popoverSubscriptionUsage", { provider: providerName }),
+				style: subscriptionPopoverStyle
+			}, (0, react.createElement)("div", { style: popoverHeadingStyle }, (0, react.createElement)("div", { style: popoverHeadingTextStyle }, (0, react.createElement)("strong", void 0, t("usage.popoverSubscriptionTitle", { provider: providerName })), accountName !== null && (0, react.createElement)("span", { style: accountMetaStyle }, accountName)), planText !== null && (0, react.createElement)("span", { style: { color: dshThemeColor.labelTertiary } }, planText)), ...windowSections, (creditText !== null || usage.resetCredits !== null) && (0, react.createElement)("section", { style: resetCreditsSectionStyle }, creditText !== null && (0, react.createElement)("div", { style: resetCreditsRowStyle }, (0, react.createElement)("span", void 0, t("usage.creditBalanceLabel")), (0, react.createElement)("span", { style: resetCreditsValueStyle }, creditText)), usage.resetCredits !== null && (0, react.createElement)("div", { style: resetCreditsRowStyle }, (0, react.createElement)("span", void 0, t("usage.resetCreditsLabel")), (0, react.createElement)("span", { style: resetCreditsValueGroupStyle }, (0, react.createElement)("span", { style: resetCreditsValueStyle }, t("usage.resetCreditsCount", { count: usage.resetCredits.availableCount })), reset !== null && (0, react.createElement)("button", {
 				type: "button",
 				className: "codingns4dsh-subscription-reset",
 				disabled: !reset.enabled,
@@ -14768,6 +15295,19 @@ window.__ModuleLoader__.load({
 			if (durationMins % 60 === 0) return t("usage.windowHours", { count: durationMins / 60 });
 			return t("usage.windowMinutes", { count: durationMins });
 		}
+		/** 上游分组名本地化：只有已知分组用词条，其余原样显示上游名称。 */
+		function formatSubscriptionGroupLabel(group, t) {
+			if (group.id === "gemini") return t("usage.quotaGroupGemini");
+			if (group.id === "third-party") return t("usage.quotaGroupThirdParty");
+			return group.displayName;
+		}
+		/** 窗口文案按类型取词条，未知类型回退到上游标签。 */
+		function formatSubscriptionGroupWindowLabel(entry, t) {
+			if (entry.kind === "five-hour") return t("usage.windowFiveHour");
+			if (entry.kind === "weekly") return t("usage.windowWeekly");
+			if (entry.kind === "monthly") return t("usage.windowMonthly");
+			return entry.label ?? "";
+		}
 		/**
 		* New-API 的普通 Key 没有 Sub2API 那种统一的完整统计对象。
 		* 这里只投影读取器明确拿到的真实数值，隐藏内部 quota、Key 状态和占位文本，
@@ -15047,7 +15587,7 @@ window.__ModuleLoader__.load({
 		}
 		/** 已具备用量读取契约的适配器才挂载底部订阅入口。 */
 		function isSubscriptionAdapter(adapterId) {
-			return adapterId === "command-code" || adapterId === "codex" || adapterId === "claude-code" || adapterId === "codebuddy" || adapterId === "codebuddy-cn" || adapterId === "dsh" || adapterId === "grok" || adapterId === "kimi" || adapterId === "opencode" || adapterId === "workbuddy" || adapterId === "zcode";
+			return adapterId === "antigravity" || adapterId === "command-code" || adapterId === "codex" || adapterId === "claude-code" || adapterId === "codebuddy" || adapterId === "codebuddy-cn" || adapterId === "dsh" || adapterId === "grok" || adapterId === "kimi" || adapterId === "opencode" || adapterId === "qoder" || adapterId === "qoder-cn" || adapterId === "workbuddy" || adapterId === "zcode";
 		}
 		function isRemoteWebContext() {
 			return globalThis.__CODINGNS4DSH_REMOTE_WEB_CONTEXT__ === true;
@@ -15067,6 +15607,8 @@ window.__ModuleLoader__.load({
 				case "grok": return "Grok";
 				case "kimi": return "Kimi Code";
 				case "opencode": return "OpenCode";
+				case "qoder": return "Qoder";
+				case "qoder-cn": return "Qoder CN";
 				case "zcode": return "ZCode";
 				case "codebuddy": return "CodeBuddy";
 				case "codebuddy-cn": return "CodeBuddy";
@@ -15390,6 +15932,19 @@ window.__ModuleLoader__.load({
 			borderBottom: `1px solid ${dshThemeColor.border}`,
 			fontSize: 14
 		};
+		const popoverHeadingTextStyle = {
+			display: "grid",
+			gap: 2,
+			minWidth: 0
+		};
+		const accountMetaStyle = {
+			overflow: "hidden",
+			color: dshThemeColor.labelTertiary,
+			fontSize: 11,
+			lineHeight: "16px",
+			textOverflow: "ellipsis",
+			whiteSpace: "nowrap"
+		};
 		const upstreamMetaStyle = {
 			display: "flex",
 			alignItems: "center",
@@ -15446,6 +16001,13 @@ window.__ModuleLoader__.load({
 			color: dshThemeColor.labelTertiary,
 			fontSize: 12
 		};
+		const quotaGroupTitleStyle = {
+			paddingTop: 12,
+			color: dshThemeColor.labelSecondary,
+			fontSize: 12,
+			fontWeight: 600,
+			letterSpacing: ".02em"
+		};
 		const subscriptionPopoverStyle = {
 			...dshPopupSurfaceStyle,
 			position: "absolute",
@@ -16515,6 +17077,415 @@ window.__ModuleLoader__.load({
 			return Math.abs(left - right) < .002;
 		}
 		//#endregion
+		//#region src/client/skill-reference-dom.ts
+		init_cli_slots();
+		/**
+		* Skill 引用的视觉投影。
+		*
+		* 输入框使用 DSH 原生 ReferenceChip；已经提交到时间线的用户消息仍然是普通文本，
+		* 这里把其中有效的 `/skill-name` 投影成同一套原子元素。只扫描用户气泡和提交回显，
+		* 不改写助手正文、代码块或普通页面文本。
+		*/
+		const SKILL_REFERENCE_ATTRIBUTE = "data-codingns-skill-reference";
+		const SKILL_REFERENCE_RAW_ATTRIBUTE = "data-codingns-skill-reference-raw";
+		const SKILL_REFERENCE_STYLE_ID = "codingns4dsh-skill-reference-style";
+		const sessionSkillNames = /* @__PURE__ */ new Map();
+		const catalogListeners = /* @__PURE__ */ new Set();
+		/** 把一个会话最新的 Skill 目录发布给时间线投影和输入框预热使用。 */
+		function publishSkillCatalog(sessionId, catalog) {
+			sessionSkillNames.set(sessionId, new Set(catalog.filter((skill) => skill.enabled).map((skill) => skill.name)));
+			for (const listener of [...catalogListeners]) listener();
+		}
+		/** 返回所有已加载会话的 Skill 名称并集；名称本身区分大小写，匹配时另行兼容大小写。 */
+		function getSkillNames() {
+			const names = /* @__PURE__ */ new Set();
+			for (const sessionNames of sessionSkillNames.values()) for (const name of sessionNames) names.add(name);
+			return names;
+		}
+		function subscribeSkillCatalog(listener) {
+			catalogListeners.add(listener);
+			return () => catalogListeners.delete(listener);
+		}
+		/** 从用户消息中提取有效 Skill 指令；URL、路径中间片段和未索引名称都会被忽略。 */
+		function findSkillReferenceMentions(value, names) {
+			const byLowerName = new Map([...names].map((name) => [name.toLocaleLowerCase(), name]));
+			const matches = [];
+			for (const match of value.matchAll(/\/[A-Za-z0-9][A-Za-z0-9._-]*(?=\s|$)/gu)) {
+				const token = match[0] ?? "";
+				const start = match.index ?? -1;
+				const before = start > 0 ? value[start - 1] : void 0;
+				const name = byLowerName.get(token.slice(1).toLocaleLowerCase());
+				if (start < 0 || name === void 0 || before !== void 0 && !/\s/u.test(before)) continue;
+				matches.push({
+					raw: token,
+					name,
+					start,
+					end: start + token.length
+				});
+			}
+			return matches;
+		}
+		/** 安装 Skill chip 的消息列表投影与统一样式。 */
+		function startSkillReferenceDom(options = {}) {
+			const dom = options.document ?? (typeof document === "undefined" ? void 0 : document);
+			const Observer = options.MutationObserver ?? (typeof MutationObserver === "undefined" ? void 0 : MutationObserver);
+			const getNames = options.getSkillNames ?? getSkillNames;
+			let disposed = false;
+			let scanQueued = false;
+			let observer;
+			const observe = () => {
+				if (disposed || dom === void 0 || observer === void 0) return;
+				observer.observe(dom.documentElement, {
+					childList: true,
+					subtree: true
+				});
+			};
+			const scan = () => {
+				if (disposed || dom === void 0) return;
+				observer?.disconnect();
+				try {
+					decorateTimelineMessages(dom, getNames());
+				} finally {
+					observe();
+				}
+			};
+			const scheduleScan = () => {
+				if (disposed || scanQueued) return;
+				scanQueued = true;
+				queueMicrotask(() => {
+					scanQueued = false;
+					scan();
+				});
+			};
+			if (dom !== void 0) installSkillReferenceStyles(dom);
+			observer = dom === void 0 || Observer === void 0 ? void 0 : new Observer(scheduleScan);
+			observe();
+			const unsubscribeCatalog = subscribeSkillCatalog(scheduleScan);
+			scan();
+			return {
+				refresh: scheduleScan,
+				dispose() {
+					if (disposed) return;
+					disposed = true;
+					observer?.disconnect();
+					unsubscribeCatalog();
+					if (dom !== void 0) removeSkillReferenceNodes(dom);
+					dom?.querySelector(`style[data-plugin-css="${SKILL_REFERENCE_STYLE_ID}"]`)?.remove();
+				}
+			};
+		}
+		function decorateTimelineMessages(dom, names) {
+			const rows = [...dom.querySelectorAll("[class*=\"userRow\"]")];
+			for (const row of dom.querySelectorAll("[data-submission-echo]")) if (!rows.includes(row)) rows.push(row);
+			const byLowerName = new Map([...names].map((name) => [name.toLocaleLowerCase(), name]));
+			if (byLowerName.size === 0) return;
+			for (const row of rows) {
+				const bubble = row.querySelector("[class*=\"bubble\"]") ?? row.querySelector("[class*=\"preview\"]");
+				if (bubble !== null) decorateTimelineNode(bubble, dom, byLowerName);
+			}
+		}
+		function decorateTimelineNode(node, dom, names) {
+			if (node.nodeType === 3) {
+				replaceSkillTextNode(node, dom, names);
+				return;
+			}
+			if (node.nodeType !== 1 || node.hasAttribute("data-codingns-skill-reference") || node.closest("code,pre,[contenteditable=\"true\"]") !== null) return;
+			for (const child of [...node.childNodes]) decorateTimelineNode(child, dom, names);
+		}
+		function replaceSkillTextNode(node, dom, names) {
+			const value = node.nodeValue ?? "";
+			if (value === "" || node.parentElement?.closest("code,pre,[contenteditable=\"true\"]") !== null) return;
+			const matches = findSkillReferenceMentions(value, new Set(names.values()));
+			if (matches.length === 0 || node.parentNode === null) return;
+			const fragment = dom.createDocumentFragment();
+			let cursor = 0;
+			for (const match of matches) {
+				if (match.start < cursor) continue;
+				if (match.start > cursor) fragment.append(dom.createTextNode(value.slice(cursor, match.start)));
+				fragment.append(buildSkillChip(dom, value.slice(match.start, match.end), match.name));
+				cursor = match.end;
+			}
+			if (cursor < value.length) fragment.append(dom.createTextNode(value.slice(cursor)));
+			node.parentNode.replaceChild(fragment, node);
+		}
+		function buildSkillChip(dom, raw, name) {
+			const chip = dom.createElement("span");
+			chip.setAttribute(SKILL_REFERENCE_ATTRIBUTE, name);
+			chip.setAttribute(SKILL_REFERENCE_RAW_ATTRIBUTE, raw);
+			chip.setAttribute("title", `/${name}`);
+			chip.setAttribute("aria-label", `/${name}`);
+			const icon = dom.createElement("span");
+			icon.setAttribute("aria-hidden", "true");
+			icon.textContent = "✦";
+			const label = dom.createElement("span");
+			label.textContent = raw;
+			chip.append(icon, label);
+			return chip;
+		}
+		function removeSkillReferenceNodes(dom) {
+			for (const chip of dom.querySelectorAll(`[${SKILL_REFERENCE_ATTRIBUTE}]`)) {
+				const raw = chip.getAttribute(SKILL_REFERENCE_RAW_ATTRIBUTE);
+				const parent = chip.parentNode;
+				if (raw !== null && parent !== null) parent.replaceChild(dom.createTextNode(raw), chip);
+			}
+		}
+		function installSkillReferenceStyles(dom) {
+			if (dom.querySelector(`style[data-plugin-css="codingns4dsh-skill-reference-style"]`) !== null) return;
+			const style = dom.createElement("style");
+			style.setAttribute("data-plugin", "codingns4dsh");
+			style.setAttribute("data-plugin-css", SKILL_REFERENCE_STYLE_ID);
+			style.textContent = [
+				`[${SKILL_REFERENCE_ATTRIBUTE}], [data-composer-chip="codingns-skills"]{display:inline-flex;align-items:center;vertical-align:baseline;gap:4px;padding:1px 7px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.22));border-radius:999px;background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12));color:var(--dsw-alias-label-primary);white-space:nowrap;font-size:.94em;line-height:1.45;user-select:all}`,
+				`[${SKILL_REFERENCE_ATTRIBUTE}], [data-composer-chip="codingns-skills"]{border-color:color-mix(in srgb,var(--dsw-alias-label-primary,#888) 18%,transparent);background:color-mix(in srgb,var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12)) 82%,transparent)}`,
+				`[${SKILL_REFERENCE_ATTRIBUTE}]>span:first-child{color:var(--dsw-alias-brand-primary,var(--dsw-alias-label-primary));font-size:.8em}`,
+				`[${SKILL_REFERENCE_ATTRIBUTE}]{cursor:default}`,
+				`[data-composer-chip="codingns-skills"]>svg{color:var(--dsw-alias-brand-primary,var(--dsw-alias-label-primary))}`
+			].join("");
+			dom.head.appendChild(style);
+		}
+		//#endregion
+		//#region src/client/skill-command.ts
+		init_cli_catalog();
+		init_debug();
+		const SKILL_COMMAND_NAME = "skills";
+		const SKILL_INPUT_SOURCE = "codingns-skills";
+		const SKILL_CATALOG_CACHE_TTL_MS = 3e4;
+		const skillCatalogCache = /* @__PURE__ */ new Map();
+		/** 把 Codex 原生 Skill 目录接入 DSH `/` 菜单。 */
+		function registerSkillCommand(ctx, options) {
+			const state = {
+				catalogReady: false,
+				disposeFallback: void 0
+			};
+			const markCatalogReady = (catalog) => {
+				if (!catalog.some((skill) => skill.enabled) || state.catalogReady) return;
+				state.catalogReady = true;
+				state.disposeFallback?.();
+				state.disposeFallback = void 0;
+			};
+			const commandFiber = ctx.inject(["commandUi"], (scope) => {
+				if (state.catalogReady) return;
+				const dispose = registerSkillCommandFallback(scope, options, markCatalogReady);
+				state.disposeFallback = dispose;
+			});
+			const triggerFiber = ctx.inject(["inputTriggers"], (scope) => {
+				registerSkillInputTriggerSource(scope, options, markCatalogReady);
+			});
+			return () => {
+				state.disposeFallback?.();
+				commandFiber.dispose();
+				triggerFiber.dispose();
+			};
+		}
+		/** 在没有原生 inputTriggers 时保留旧版 DSH 的可用 Skill 菜单。 */
+		function registerSkillCommandFallback(ctx, options, onCatalogReady) {
+			const commandUi = readCommandUi(ctx);
+			if (commandUi === void 0) {
+				debugWarn("codingns4dsh: /skills 未注册，当前 DSH 未提供 commandUi 服务");
+				return;
+			}
+			const t = options.locale.bind("codingns");
+			try {
+				return ctx.effect(() => commandUi.register({
+					name: SKILL_COMMAND_NAME,
+					label: () => t("skills.label"),
+					description: () => t("skills.description"),
+					available: () => true,
+					ui: {
+						kind: "popupSelect",
+						searchMode: "fuzzy-label",
+						searchLabels: () => ({
+							placeholder: t("skills.searchPlaceholder"),
+							empty: t("skills.searchEmpty"),
+							noResults: t("skills.searchNoResults")
+						}),
+						async options(session, signal) {
+							await waitForCliSessionSelection(session.sessionId);
+							const catalog = await loadSkillCatalog(options.rpc, session.sessionId, signal, true);
+							onCatalogReady(catalog);
+							return catalog.filter((skill) => skill.enabled).map((skill) => ({
+								id: skill.name,
+								label: skill.displayName ?? skill.name,
+								...skill.description.trim() === "" ? {} : { detail: skill.description }
+							}));
+						},
+						onSelect(option, session) {
+							const input = readSessionInput(ctx, session.sessionId);
+							if (input === void 0 || input.setDraft === void 0 && input.insertReference === void 0) {
+								input?.notify("error", t("skills.draftUnsupported"));
+								return;
+							}
+							const snapshot = input.state.getSnapshot();
+							const draft = snapshot.draft ?? "";
+							const selection = input.caretSpan?.();
+							const span = skillCommandSpan(draft, snapshot.draftRev ?? selection?.draftRev ?? 0, selection);
+							const token = `/${option.id} `;
+							const reference = {
+								source: SKILL_INPUT_SOURCE,
+								ref: option.id,
+								label: option.label,
+								appearance: "session",
+								clipboardText: `/${option.id}`
+							};
+							if (span !== void 0 && input.insertReference?.(reference, span) === true) return;
+							if (input.setDraft === void 0) {
+								input.notify("error", t("skills.draftUnsupported"));
+								return;
+							}
+							if (span !== void 0) {
+								input.setDraft(`${draft.slice(0, span.start)}${token}${draft.slice(span.end)}`);
+								return;
+							}
+							const caret = selection?.end ?? draft.length;
+							input.setDraft(`${draft.slice(0, caret)}${token}${draft.slice(caret)}`);
+						}
+					}
+				}), "codingns4dsh: skills command");
+			} catch (error) {
+				debugWarn("codingns4dsh: /skills 命令注册失败", { error: error instanceof Error ? error.message : String(error) });
+				return;
+			}
+		}
+		/** 注册直接的 `/` Skill 搜索源。 */
+		function registerSkillInputTriggerSource(ctx, options, onCatalogReady) {
+			const inputTriggers = readService(ctx, "inputTriggers");
+			if (inputTriggers === void 0 || typeof inputTriggers.registerSource !== "function") {
+				debugWarn("codingns4dsh: Skill `/` 搜索源未注册，当前 DSH 未提供 inputTriggers 服务");
+				return false;
+			}
+			const source = {
+				trigger: "/",
+				name: SKILL_INPUT_SOURCE,
+				order: 2,
+				showGroupTitle: false,
+				async candidates(session, request) {
+					try {
+						await waitForCliSessionSelection(session.sessionId);
+						const query = request.query.trim().toLocaleLowerCase();
+						const catalog = await loadSkillCatalog(options.rpc, session.sessionId, request.signal, query === "");
+						onCatalogReady(catalog);
+						return catalog.filter((skill) => skill.enabled).filter((skill) => query === "" || [
+							skill.name,
+							skill.displayName,
+							skill.description
+						].some((value) => value?.toLocaleLowerCase().includes(query) === true)).map((skill) => ({
+							name: skill.name,
+							label: skill.displayName ?? skill.name,
+							value: skill.name,
+							...skill.description.trim() === "" ? {} : { description: skill.description }
+						}));
+					} catch (error) {
+						debugWarn("codingns4dsh: 读取 Skill `/` 搜索目录失败", { error: error instanceof Error ? error.message : String(error) });
+						return [];
+					}
+				},
+				warm(session) {
+					const controller = new AbortController();
+					waitForCliSessionSelection(session.sessionId).then(() => loadSkillCatalog(options.rpc, session.sessionId, controller.signal, true)).then((catalog) => {
+						onCatalogReady(catalog);
+					}).catch((error) => {
+						debugWarn("codingns4dsh: 预热 Skill `/` 搜索目录失败", { error: error instanceof Error ? error.message : String(error) });
+					});
+				},
+				lexicon(session) {
+					return (skillCatalogCache.get(session.sessionId)?.catalog)?.filter((skill) => skill.enabled).map((skill) => skill.name);
+				},
+				onPick(pick) {
+					const name = pick.candidate.value?.trim() || pick.candidate.name.trim();
+					if (name === "") return { text: "" };
+					return { insert: {
+						source: SKILL_INPUT_SOURCE,
+						ref: name,
+						label: pick.candidate.label?.trim() || name,
+						appearance: "session",
+						clipboardText: `/${name}`
+					} };
+				},
+				codec: {
+					clipboardText(ref) {
+						return `/${ref}`;
+					},
+					async serialize(ref) {
+						return `/${ref}`;
+					}
+				}
+			};
+			try {
+				ctx.effect(() => inputTriggers.registerSource(source), "codingns4dsh: skill slash source");
+				debugInfo("codingns4dsh: Skill `/` 搜索源已注册");
+				return true;
+			} catch (error) {
+				debugWarn("codingns4dsh: Skill `/` 搜索源注册失败", { error: error instanceof Error ? error.message : String(error) });
+				return false;
+			}
+		}
+		/** 按会话与 Agent 选择版本缓存目录，避免输入每个字符都请求 Codex。 */
+		async function loadSkillCatalog(rpc, sessionId, signal, forceReload) {
+			const selectionRevision = cliSessionSelectionRevision(sessionId);
+			const cached = skillCatalogCache.get(sessionId);
+			if (!forceReload && cached !== void 0 && cached.selectionRevision === selectionRevision && Date.now() - cached.loadedAt < SKILL_CATALOG_CACHE_TTL_MS) return cached.catalog;
+			const catalog = await callCliRpc(rpc, "skills", {
+				sessionId,
+				forceReload: true
+			}, signal);
+			skillCatalogCache.set(sessionId, {
+				selectionRevision,
+				loadedAt: Date.now(),
+				catalog
+			});
+			publishSkillCatalog(sessionId, catalog);
+			return catalog;
+		}
+		function skillCommandSpan(draft, draftRev, selection) {
+			const caret = selection?.end ?? draft.length;
+			const token = /\/(?:skills|技能)(?=\s|$)/gu;
+			let match;
+			while ((match = token.exec(draft)) !== null) {
+				const start = match.index;
+				const end = start + match[0].length;
+				const before = draft[start - 1];
+				if (start > 0 && before !== void 0 && !/\s/u.test(before)) continue;
+				if (caret >= start && caret <= end + 1) return {
+					start,
+					end,
+					draftRev
+				};
+				if (caret > end && draft.slice(end, caret).trim() === "") return {
+					start,
+					end,
+					draftRev
+				};
+			}
+		}
+		function readSessionInput(ctx, sessionId) {
+			try {
+				const actx = readSessions(ctx)?.scope(sessionId);
+				if (actx === void 0) return void 0;
+				return readConversation(ctx)?.input.for(actx);
+			} catch {
+				return;
+			}
+		}
+		function readCommandUi(ctx) {
+			const service = readService(ctx, "commandUi");
+			return service !== void 0 && typeof service.register === "function" ? service : void 0;
+		}
+		function readSessions(ctx) {
+			const service = readService(ctx, "sessions");
+			return service !== void 0 && typeof service.scope === "function" ? service : void 0;
+		}
+		function readConversation(ctx) {
+			const service = readService(ctx, "conversation");
+			return service !== void 0 && typeof service.input?.for === "function" ? service : void 0;
+		}
+		function readService(ctx, name) {
+			try {
+				return ctx.get(name);
+			} catch {
+				return;
+			}
+		}
+		//#endregion
 		//#region src/client/features/workspace-session-enhancement.ts
 		init_session_adapter_cache();
 		init_locale();
@@ -16548,6 +17519,8 @@ window.__ModuleLoader__.load({
 				let adapterRefreshTimer;
 				let disposeSubscription;
 				let disposeQuickPhrases;
+				let disposeSkillCommand;
+				let skillReferenceDom;
 				let lastSubscriptionUsageSignature = null;
 				const disableLogo = () => {
 					generation += 1;
@@ -16615,6 +17588,20 @@ window.__ModuleLoader__.load({
 					disposeQuickPhrases?.();
 					disposeQuickPhrases = void 0;
 				};
+				const enableSkillQuickReference = () => {
+					if (skillReferenceDom === void 0) skillReferenceDom = startSkillReferenceDom();
+					if (disposeSkillCommand !== void 0 || context.services.uiContext === void 0) return;
+					disposeSkillCommand = registerSkillCommand(context.services.uiContext, {
+						rpc: context.services.rpc,
+						locale: context.services.locale
+					});
+				};
+				const disableSkillQuickReference = () => {
+					disposeSkillCommand?.();
+					disposeSkillCommand = void 0;
+					skillReferenceDom?.dispose();
+					skillReferenceDom = void 0;
+				};
 				const disposeAll = () => {
 					disableLogo();
 					archiveDom?.dispose();
@@ -16623,6 +17610,7 @@ window.__ModuleLoader__.load({
 					disableRightbarMemory();
 					disableSubscription();
 					disableQuickPhrases();
+					disableSkillQuickReference();
 				};
 				const enableLogo = () => {
 					if (logoDom !== void 0) return;
@@ -16657,6 +17645,8 @@ window.__ModuleLoader__.load({
 					else disableSubscription();
 					if (workspaceSettings?.showQuickPhrases ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showQuickPhrases) enableQuickPhrases();
 					else disableQuickPhrases();
+					if (workspaceSettings?.showSkillQuickReference ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showSkillQuickReference) enableSkillQuickReference();
+					else disableSkillQuickReference();
 					if (workspaceSettings?.rememberConversationRightbarRatio ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.rememberConversationRightbarRatio) enableRightbarMemory();
 					else disableRightbarMemory();
 					const subscriptionUsageSignature = JSON.stringify(context.services.settings.getSnapshot().value?.subscriptionUsage ?? null);
@@ -18509,9 +19499,9 @@ window.__ModuleLoader__.load({
 			}
 			function createProfileForm(value) {
 				const field = (label, key, type = "text", placeholder, layout) => (0, react.createElement)("label", { style: {
-					...fieldStyle,
+					...fieldStyle$1,
 					...layout
-				} }, (0, react.createElement)("span", { style: fieldLabelStyle }, label), (0, react.createElement)("input", {
+				} }, (0, react.createElement)("span", { style: fieldLabelStyle$1 }, label), (0, react.createElement)("input", {
 					type,
 					value: typeof value[key] === "boolean" ? void 0 : value[key],
 					placeholder,
@@ -18526,7 +19516,7 @@ window.__ModuleLoader__.load({
 					}),
 					style: inputStyle
 				}));
-				const selectField = (label, key, options) => (0, react.createElement)("label", { style: selectFieldStyle }, (0, react.createElement)("span", { style: fieldLabelStyle }, label), (0, react.createElement)("select", {
+				const selectField = (label, key, options) => (0, react.createElement)("label", { style: selectFieldStyle }, (0, react.createElement)("span", { style: fieldLabelStyle$1 }, label), (0, react.createElement)("select", {
 					value: value[key],
 					onChange: (event) => setDraft({
 						...value,
@@ -18559,7 +19549,7 @@ window.__ModuleLoader__.load({
 					onClick: () => setDraft(null),
 					style: closeButtonStyle,
 					"aria-label": t("debug.closeFormAria")
-				}, "×")), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionLaunch")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionLaunchHint"))), (0, react.createElement)("div", { style: formGridStyle }, field(t("debug.fieldName"), "name", "text", t("debug.fieldNamePlaceholder")), field(t("debug.fieldCwd"), "cwdRelative", "text", t("debug.fieldCwdPlaceholder")), field(t("debug.fieldCommand"), "commandLine", "text", t("debug.fieldCommandPlaceholder"), { gridColumn: "1 / -1" }))), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionRuntime")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionRuntimeHint"))), (0, react.createElement)("div", { style: formGridStyle }, selectField(t("debug.fieldShell"), "shellProfileId", shellOptions(terminalStatus, t))), (0, react.createElement)("p", { style: runtimeHintStyle }, t("debug.runtimeHint", { runtime: terminalRuntimeLabel(terminalStatus, t) })), terminalStatus?.runtimeWarning === void 0 ? null : (0, react.createElement)("p", { style: warningHintStyle }, terminalStatus.runtimeWarning)), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionPort")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionPortHint"))), (0, react.createElement)("div", { style: formGridStyle }, field(t("debug.fieldPort"), "port", "number", "1 - 65535"), (0, react.createElement)("label", { style: proxyFieldStyle }, (0, react.createElement)("span", { style: fieldLabelStyle }, t("debug.fieldProxy")), (0, react.createElement)("span", { style: proxyToggleStyle }, (0, react.createElement)("span", void 0, t("debug.proxyToggleLabel")), (0, react.createElement)("input", {
+				}, "×")), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionLaunch")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionLaunchHint"))), (0, react.createElement)("div", { style: formGridStyle }, field(t("debug.fieldName"), "name", "text", t("debug.fieldNamePlaceholder")), field(t("debug.fieldCwd"), "cwdRelative", "text", t("debug.fieldCwdPlaceholder")), field(t("debug.fieldCommand"), "commandLine", "text", t("debug.fieldCommandPlaceholder"), { gridColumn: "1 / -1" }))), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionRuntime")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionRuntimeHint"))), (0, react.createElement)("div", { style: formGridStyle }, selectField(t("debug.fieldShell"), "shellProfileId", shellOptions(terminalStatus, t))), (0, react.createElement)("p", { style: runtimeHintStyle }, t("debug.runtimeHint", { runtime: terminalRuntimeLabel(terminalStatus, t) })), terminalStatus?.runtimeWarning === void 0 ? null : (0, react.createElement)("p", { style: warningHintStyle }, terminalStatus.runtimeWarning)), (0, react.createElement)("section", { style: formSectionStyle }, (0, react.createElement)("div", { style: formSectionHeaderStyle }, (0, react.createElement)("strong", { style: formSectionTitleStyle }, t("debug.sectionPort")), (0, react.createElement)("span", { style: formSectionHintStyle }, t("debug.sectionPortHint"))), (0, react.createElement)("div", { style: formGridStyle }, field(t("debug.fieldPort"), "port", "number", "1 - 65535"), (0, react.createElement)("label", { style: proxyFieldStyle }, (0, react.createElement)("span", { style: fieldLabelStyle$1 }, t("debug.fieldProxy")), (0, react.createElement)("span", { style: proxyToggleStyle }, (0, react.createElement)("span", void 0, t("debug.proxyToggleLabel")), (0, react.createElement)("input", {
 					type: "checkbox",
 					"aria-label": t("debug.proxyToggleAria"),
 					checked: value.proxyEnabled,
@@ -19141,14 +20131,14 @@ window.__ModuleLoader__.load({
 			fontSize: 20,
 			lineHeight: 1
 		};
-		const fieldStyle = {
+		const fieldStyle$1 = {
 			display: "flex",
 			flexDirection: "column",
 			gap: 5,
 			minWidth: 0
 		};
-		const selectFieldStyle = { ...fieldStyle };
-		const fieldLabelStyle = {
+		const selectFieldStyle = { ...fieldStyle$1 };
+		const fieldLabelStyle$1 = {
 			color: dshThemeColor.labelSecondary,
 			fontSize: 12,
 			fontWeight: 500
@@ -19181,7 +20171,7 @@ window.__ModuleLoader__.load({
 			gridTemplateColumns: "repeat(auto-fit, minmax(220px, 1fr))",
 			gap: 14
 		};
-		const proxyFieldStyle = { ...fieldStyle };
+		const proxyFieldStyle = { ...fieldStyle$1 };
 		const proxyToggleStyle = {
 			display: "flex",
 			alignItems: "center",
@@ -56864,7 +57854,7 @@ window.__ModuleLoader__.load({
 						close();
 						return;
 					}
-					setMessage(t("peerHost.handshakeFailed", { status: statusLabel(record.status, t) }));
+					setMessage(t("peerHost.handshakeFailed", { status: statusLabel$1(record.status, t) }));
 				}).catch((error) => setMessage(error instanceof Error ? error.message : String(error))).finally(() => {
 					submit.disabled = false;
 					submit.textContent = t("peerHost.addAndLogin");
@@ -56973,7 +57963,7 @@ window.__ModuleLoader__.load({
 				lineHeight: "1.3"
 			});
 			const status = dom.createElement("span");
-			status.textContent = statusLabel(record.status, t);
+			status.textContent = statusLabel$1(record.status, t);
 			Object.assign(status.style, {
 				flex: "0 0 auto",
 				padding: "2px 6px",
@@ -57398,7 +58388,7 @@ window.__ModuleLoader__.load({
 				reset.style.borderColor = selected === null ? dshThemeColor.accent : dshThemeColor.border;
 			}
 		}
-		function statusLabel(status, t) {
+		function statusLabel$1(status, t) {
 			const key = {
 				configured: "peerHost.statusConfigured",
 				checking: "peerHost.statusChecking",
@@ -57679,7 +58669,7 @@ window.__ModuleLoader__.load({
 			const store = readNativeWorkspaceListStore(input.uiContext);
 			if (store === void 0) return () => void 0;
 			const service = readNativeService(input.uiContext, "workspaces");
-			const serviceRecord = isRecord$3(service) ? service : void 0;
+			const serviceRecord = isRecord$4(service) ? service : void 0;
 			const sessionStoreValue = readNativeService(input.uiContext, "sessions", "list");
 			const sessionStore = isSnapshotStore(sessionStoreValue) ? sessionStoreValue : void 0;
 			const ownsGetSnapshot = Object.hasOwn(store, "getSnapshot");
@@ -57738,7 +58728,7 @@ window.__ModuleLoader__.load({
 		*/
 		async function refreshPeerHostNativeSessions(uiContext) {
 			const sessions = readNativeService(uiContext, "sessions");
-			const refresh = isRecord$3(sessions) ? sessions.refresh : void 0;
+			const refresh = isRecord$4(sessions) ? sessions.refresh : void 0;
 			if (typeof refresh !== "function") return;
 			try {
 				await refresh.call(sessions);
@@ -57837,7 +58827,7 @@ window.__ModuleLoader__.load({
 			const byId = state?.byId;
 			const workspaceState = asRecord$1(workspaceSnapshot);
 			const items = Array.isArray(workspaceState?.items) ? workspaceState.items : [];
-			if (state === null || !isRecord$3(byId) || items.length === 0) return snapshot;
+			if (state === null || !isRecord$4(byId) || items.length === 0) return snapshot;
 			let changed = false;
 			const nextById = { ...byId };
 			for (const [id, value] of Object.entries(byId)) {
@@ -57983,13 +58973,13 @@ window.__ModuleLoader__.load({
 			return merged.length === local.length ? void 0 : merged;
 		}
 		function asRecord$1(value) {
-			return isRecord$3(value) ? value : null;
+			return isRecord$4(value) ? value : null;
 		}
-		function isRecord$3(value) {
+		function isRecord$4(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		function isSnapshotStore(value) {
-			return isRecord$3(value) && typeof value.getSnapshot === "function" && typeof value.subscribe === "function";
+			return isRecord$4(value) && typeof value.getSnapshot === "function" && typeof value.subscribe === "function";
 		}
 		//#endregion
 		//#region src/client/peer-host-workspace-tag.ts
@@ -58099,7 +59089,7 @@ window.__ModuleLoader__.load({
 			const fiberKey = Object.getOwnPropertyNames(row).find((key) => key.startsWith("__reactFiber$"));
 			if (fiberKey === void 0) return void 0;
 			let current = row[fiberKey];
-			for (let depth = 0; depth < 24 && isRecord$2(current); depth += 1) {
+			for (let depth = 0; depth < 24 && isRecord$3(current); depth += 1) {
 				for (const props of [current.memoizedProps, current.pendingProps]) {
 					const found = readWorkspaceIdFromProps(props);
 					if (found !== void 0) return found;
@@ -58108,7 +59098,7 @@ window.__ModuleLoader__.load({
 			}
 		}
 		function readWorkspaceIdFromProps(value) {
-			if (!isRecord$2(value)) return void 0;
+			if (!isRecord$3(value)) return void 0;
 			for (const key of ["workspaceId", "workspaceID"]) {
 				const candidate = value[key];
 				if (typeof candidate === "string" && candidate.trim() !== "") return candidate.trim();
@@ -58122,7 +59112,7 @@ window.__ModuleLoader__.load({
 				"data"
 			]) {
 				const nested = value[key];
-				if (!isRecord$2(nested)) continue;
+				if (!isRecord$3(nested)) continue;
 				const candidate = nested.workspaceId ?? nested.id;
 				if (typeof candidate === "string" && candidate.trim() !== "") return candidate.trim();
 			}
@@ -58168,7 +59158,7 @@ window.__ModuleLoader__.load({
 			});
 			host.append(element);
 		}
-		function isRecord$2(value) {
+		function isRecord$3(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		//#endregion
@@ -59466,6 +60456,1598 @@ window.__ModuleLoader__.load({
 			}, message);
 		}
 		//#endregion
+		//#region src/client/global-voice-runtime-registry.ts
+		const adapters = /* @__PURE__ */ new WeakMap();
+		function registerGlobalVoiceAdapter(services, adapter) {
+			adapters.set(services, adapter);
+			return () => {
+				if (adapters.get(services) === adapter) adapters.delete(services);
+			};
+		}
+		function getGlobalVoiceAdapter(services) {
+			return adapters.get(services);
+		}
+		//#endregion
+		//#region src/client/features/voice-initialization-dialog.ts
+		init_transport();
+		init_theme();
+		init_locale();
+		/** 全局语音助理初始化页；用户只选择模型，路径和下载由 Host 自动处理。 */
+		function VoiceInitializationDialog({ services, value, onClose }) {
+			const t = useCodingNsTranslator(services.locale);
+			const defaultModelId = ASSISTANT_VOICE_MODEL_CATALOG[0]?.id ?? "";
+			const configuredModelId = value.modelId?.trim() ?? "";
+			const [modelId, setModelId] = (0, react.useState)(() => configuredModelId !== "" && findAssistantVoiceModel(configuredModelId) !== void 0 ? configuredModelId : defaultModelId);
+			const [saving, setSaving] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)();
+			const settingsSnapshot = services.settings.getSnapshot();
+			const disabled = saving || settingsSnapshot.status === "loading" || !settingsSnapshot.writable;
+			const selectedModel = findAssistantVoiceModel(modelId);
+			(0, react.useEffect)(() => {
+				const closeOnEscape = (event) => {
+					if (event.key === "Escape" && !saving) onClose();
+				};
+				document.addEventListener("keydown", closeOnEscape);
+				return () => document.removeEventListener("keydown", closeOnEscape);
+			}, [onClose, saving]);
+			const save = async () => {
+				if (selectedModel === void 0) {
+					setError(t("voice.setup.modelRequired"));
+					return;
+				}
+				setSaving(true);
+				setError(void 0);
+				try {
+					const result = await services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/setup", { modelId });
+					if (!result.ok) {
+						setError(result.error.message);
+						return;
+					}
+					onClose();
+				} catch (cause) {
+					setError(cause instanceof Error ? cause.message : String(cause));
+				} finally {
+					setSaving(false);
+				}
+			};
+			return (0, react.createElement)("div", {
+				role: "presentation",
+				onPointerDown: () => {
+					if (!saving) onClose();
+				},
+				style: {
+					position: "fixed",
+					inset: 0,
+					zIndex: 1e4,
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "center",
+					padding: 16,
+					background: dshThemeColor.overlay,
+					boxSizing: "border-box"
+				}
+			}, (0, react.createElement)("div", {
+				role: "dialog",
+				"aria-modal": true,
+				"aria-label": t("voice.setup.title"),
+				onPointerDown: (event) => event.stopPropagation(),
+				style: {
+					display: "flex",
+					flexDirection: "column",
+					gap: 16,
+					width: "min(560px, 100%)",
+					maxHeight: "min(620px, 100%)",
+					overflowY: "auto",
+					padding: 24,
+					color: dshThemeColor.labelPrimary,
+					background: dshThemeColor.menuBackground,
+					border: `1px solid ${dshThemeColor.border}`,
+					borderRadius: 12,
+					boxShadow: dshThemeColor.prominentShadow,
+					boxSizing: "border-box"
+				}
+			}, (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: 7
+			} }, (0, react.createElement)("strong", { style: {
+				fontSize: 18,
+				lineHeight: 1.4
+			} }, t("voice.setup.title")), (0, react.createElement)("span", { style: dshSettingsHelpStyle }, t("voice.setup.description"))), (0, react.createElement)("div", { style: {
+				padding: "11px 13px",
+				borderRadius: 8,
+				background: dshThemeColor.inputBackground,
+				color: dshThemeColor.labelSecondary,
+				fontSize: 13,
+				lineHeight: 1.55
+			} }, t("voice.setup.onlyRealtime")), (0, react.createElement)("label", { style: fieldLabelStyle }, (0, react.createElement)("span", null, t("voice.setup.model")), (0, react.createElement)("select", {
+				value: modelId,
+				disabled,
+				onChange: (event) => setModelId(event.currentTarget.value),
+				style: fieldStyle
+			}, ...ASSISTANT_VOICE_MODEL_CATALOG.map((model) => (0, react.createElement)("option", {
+				key: model.id,
+				value: model.id
+			}, model.label)))), selectedModel === void 0 ? null : (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: 5,
+				color: dshThemeColor.labelSecondary,
+				fontSize: 13,
+				lineHeight: 1.5
+			} }, (0, react.createElement)("strong", { style: {
+				color: dshThemeColor.labelPrimary,
+				fontSize: 14
+			} }, selectedModel.label), (0, react.createElement)("span", null, selectedModel.description), (0, react.createElement)("span", null, t("voice.setup.downloadHint"))), saving ? (0, react.createElement)("div", {
+				role: "status",
+				style: {
+					color: dshThemeColor.labelSecondary,
+					fontSize: 13
+				}
+			}, t("voice.setup.downloading")) : null, error === void 0 ? null : (0, react.createElement)("div", {
+				role: "alert",
+				style: {
+					color: dshThemeColor.error,
+					fontSize: 13,
+					lineHeight: 1.5
+				}
+			}, error), (0, react.createElement)("div", { style: {
+				display: "flex",
+				justifyContent: "flex-end",
+				gap: 8,
+				paddingTop: 3
+			} }, (0, react.createElement)("button", {
+				type: "button",
+				disabled: saving,
+				onClick: onClose,
+				style: dshSettingsButtonStyle
+			}, t("voice.setup.cancel")), (0, react.createElement)("button", {
+				type: "button",
+				disabled,
+				onClick: () => void save(),
+				style: dshSettingsPrimaryButtonStyle
+			}, t("voice.setup.save")))));
+		}
+		const fieldLabelStyle = {
+			display: "grid",
+			gap: 7,
+			color: dshThemeColor.labelSecondary,
+			fontSize: 12,
+			lineHeight: 1.4,
+			fontWeight: 600
+		};
+		const fieldStyle = {
+			...dshFieldStyle,
+			width: "100%",
+			minHeight: 40,
+			padding: "9px 11px",
+			borderRadius: 7,
+			boxSizing: "border-box",
+			fontSize: 14
+		};
+		//#endregion
+		//#region src/client/features/assistant-panel.ts
+		init_locale();
+		init_theme();
+		/** 全局智能助理范围设置；默认空范围，工作区必须由用户逐个勾选。 */
+		function AssistantPanel({ services, enabled, snapshot, notify }) {
+			const t = useCodingNsTranslator(services.locale);
+			const [workspaces, setWorkspaces] = (0, react.useState)([]);
+			const [inputDevices, setInputDevices] = (0, react.useState)([]);
+			const [inputDeviceId, setInputDeviceId] = (0, react.useState)("");
+			const [outputDevices, setOutputDevices] = (0, react.useState)([]);
+			const [outputDeviceId, setOutputDeviceId] = (0, react.useState)("");
+			const [outputDeviceSupported, setOutputDeviceSupported] = (0, react.useState)(false);
+			const [voiceSetupOpen, setVoiceSetupOpen] = (0, react.useState)(false);
+			const value = snapshot.value?.assistant ?? DEFAULT_ASSISTANT_SETTINGS;
+			const voice = value.voice ?? DEFAULT_ASSISTANT_VOICE_SETTINGS;
+			const voiceModel = findAssistantVoiceModel(voice.modelId ?? "");
+			const disabled = !enabled || snapshot.status === "loading" || !snapshot.writable;
+			(0, react.useEffect)(() => {
+				const store = readNativeWorkspaceListStore(services.uiContext);
+				const refresh = () => setWorkspaces(readNativeWorkspaceSnapshot(services.uiContext)?.items ?? []);
+				refresh();
+				return store?.subscribe(refresh);
+			}, [services.uiContext]);
+			(0, react.useEffect)(() => {
+				const adapter = getGlobalVoiceAdapter(services);
+				if (adapter === void 0) return void 0;
+				let disposed = false;
+				const refresh = () => {
+					adapter.enumerateInputDevices().then((devices) => {
+						if (disposed) return;
+						setInputDevices(devices.map(({ deviceId, label }) => ({
+							deviceId,
+							label
+						})));
+						setInputDeviceId(adapter.inputDeviceId ?? "");
+					}).catch(() => {
+						if (!disposed) setInputDevices([]);
+					});
+					setOutputDeviceSupported(adapter.outputDeviceSupported);
+					adapter.enumerateOutputDevices().then((devices) => {
+						if (disposed) return;
+						setOutputDevices(devices.map(({ deviceId, label }) => ({
+							deviceId,
+							label
+						})));
+						setOutputDeviceId(adapter.outputDeviceId ?? "");
+					}).catch(() => {
+						if (!disposed) setOutputDevices([]);
+					});
+				};
+				refresh();
+				const mediaDevices = globalThis.navigator?.mediaDevices;
+				const onChange = () => refresh();
+				mediaDevices?.addEventListener?.("devicechange", onChange);
+				return () => {
+					disposed = true;
+					mediaDevices?.removeEventListener?.("devicechange", onChange);
+				};
+			}, [services]);
+			const chooseInputDevice = (deviceId) => {
+				const adapter = getGlobalVoiceAdapter(services);
+				if (adapter === void 0) return;
+				adapter.selectInputDevice(deviceId).then(() => {
+					setInputDeviceId(deviceId);
+					notify({
+						kind: "success",
+						message: t("voice.microphoneUpdated")
+					});
+				}).catch((error) => notify({
+					kind: "error",
+					message: error instanceof Error ? error.message : String(error)
+				}));
+			};
+			const chooseOutputDevice = (deviceId) => {
+				const adapter = getGlobalVoiceAdapter(services);
+				if (adapter === void 0) return;
+				adapter.selectOutputDevice(deviceId).then(() => {
+					setOutputDeviceId(deviceId);
+					notify({
+						kind: "success",
+						message: t("voice.outputUpdated")
+					});
+				}).catch((error) => notify({
+					kind: "error",
+					message: error instanceof Error ? error.message : String(error)
+				}));
+			};
+			const update = (workspaceId, checked) => {
+				const current = new Set(value.managedWorkspaceIds);
+				if (checked) current.add(workspaceId);
+				else current.delete(workspaceId);
+				services.settings.mutate([{
+					op: "set",
+					path: [CODINGNS_ASSISTANT_FIELD, "managedWorkspaceIds"],
+					value: [...current]
+				}]).then((accepted) => {
+					if (!accepted) notify({
+						kind: "error",
+						message: t("settings.moduleWriteRejected")
+					});
+					else notify({
+						kind: "success",
+						message: t("assistant.saved")
+					});
+				}).catch((error) => notify({
+					kind: "error",
+					message: error instanceof Error ? error.message : String(error)
+				}));
+			};
+			return (0, react.createElement)("div", {
+				"aria-disabled": disabled,
+				style: {
+					...dshFormRootStyle,
+					display: "flex",
+					flexDirection: "column",
+					gap: 12,
+					opacity: disabled ? .5 : 1,
+					pointerEvents: disabled ? "none" : "auto"
+				}
+			}, (0, react.createElement)("p", { style: dshSettingsHelpStyle }, t("assistant.scopeDescription")), (0, react.createElement)("div", { style: dshSettingsListRowStyle }, (0, react.createElement)("span", { style: {
+				minWidth: 0,
+				flex: "1 1 auto"
+			} }, (0, react.createElement)("strong", { style: {
+				display: "block",
+				fontSize: 13,
+				lineHeight: 1.4
+			} }, t("voice.setup.title")), (0, react.createElement)("span", { style: {
+				display: "block",
+				marginTop: 3,
+				...dshSettingsHelpStyle
+			} }, voice.initialized && voice.provider === "sherpa-onnx" ? voiceModel?.label ?? t("voice.setup.status.sherpa") : t("voice.setup.status.uninitialized"))), (0, react.createElement)("button", {
+				type: "button",
+				disabled,
+				onClick: () => setVoiceSetupOpen(true),
+				style: {
+					...dshSettingsButtonStyle,
+					flex: "0 0 auto",
+					whiteSpace: "nowrap"
+				}
+			}, t("voice.setup.reconfigure"))), inputDevices.length === 0 ? null : (0, react.createElement)("label", { style: {
+				...dshSettingsListRowStyle,
+				alignItems: "center"
+			} }, (0, react.createElement)("span", { style: { minWidth: 0 } }, t("voice.inputDevice")), (0, react.createElement)("select", {
+				value: inputDeviceId,
+				disabled,
+				onChange: (event) => chooseInputDevice(event.currentTarget.value),
+				style: {
+					maxWidth: 220,
+					minWidth: 0,
+					flex: "0 1 220px"
+				}
+			}, (0, react.createElement)("option", { value: "" }, t("voice.defaultMicrophone")), ...inputDevices.map((device) => (0, react.createElement)("option", {
+				key: device.deviceId,
+				value: device.deviceId
+			}, device.label || t("voice.unnamedMicrophone"))))), !outputDeviceSupported ? null : (0, react.createElement)("label", { style: {
+				...dshSettingsListRowStyle,
+				alignItems: "center"
+			} }, (0, react.createElement)("span", { style: { minWidth: 0 } }, t("voice.outputDevice")), outputDevices.length === 0 ? (0, react.createElement)("span", { style: dshSettingsHelpStyle }, t("voice.defaultOutput")) : (0, react.createElement)("select", {
+				value: outputDeviceId,
+				disabled,
+				onChange: (event) => chooseOutputDevice(event.currentTarget.value),
+				style: {
+					maxWidth: 220,
+					minWidth: 0,
+					flex: "0 1 220px"
+				}
+			}, (0, react.createElement)("option", { value: "" }, t("voice.defaultOutput")), ...outputDevices.map((device) => (0, react.createElement)("option", {
+				key: device.deviceId,
+				value: device.deviceId
+			}, device.label || t("voice.unnamedOutput"))))), workspaces.length === 0 ? (0, react.createElement)("div", {
+				role: "status",
+				style: dshSettingsHelpStyle
+			}, t("assistant.noWorkspaces")) : workspaces.map((workspace) => (0, react.createElement)("label", {
+				key: workspace.workspaceId,
+				style: dshSettingsListRowStyle
+			}, (0, react.createElement)("span", { style: { minWidth: 0 } }, (0, react.createElement)("strong", { style: {
+				display: "block",
+				fontSize: 13,
+				lineHeight: 1.4
+			} }, workspace.title), workspace.path === void 0 ? null : (0, react.createElement)("span", { style: {
+				display: "block",
+				marginTop: 3,
+				...dshSettingsHelpStyle
+			} }, workspace.path)), (0, react.createElement)("input", {
+				type: "checkbox",
+				role: "switch",
+				"aria-label": workspace.title,
+				checked: value.managedWorkspaceIds.includes(workspace.workspaceId),
+				disabled,
+				onChange: (event) => update(workspace.workspaceId, event.currentTarget.checked),
+				style: {
+					flex: "0 0 auto",
+					accentColor: dshThemeColor.accent
+				}
+			}))), voiceSetupOpen ? (0, react.createElement)(VoiceInitializationDialog, {
+				services,
+				value: voice,
+				onClose: () => setVoiceSetupOpen(false)
+			}) : null);
+		}
+		//#endregion
+		//#region src/client/voice-security.ts
+		function inspectBrowserVoiceSecurity() {
+			const environment = globalThis;
+			const windowLike = environment.window;
+			const location = windowLike?.location ?? environment.location;
+			const protocol = typeof location?.protocol === "string" ? location.protocol.toLowerCase() : "";
+			const hostname = typeof location?.hostname === "string" ? location.hostname.toLowerCase() : "";
+			const secureValue = typeof windowLike?.isSecureContext === "boolean" ? windowLike.isSecureContext : typeof environment.isSecureContext === "boolean" ? environment.isSecureContext : void 0;
+			if (!(windowLike !== void 0 || environment.document !== void 0 || secureValue !== void 0 || protocol !== "")) return {
+				secure: true,
+				protocol
+			};
+			if (secureValue === false) return {
+				secure: false,
+				protocol,
+				reason: "isSecureContext"
+			};
+			if (protocol === "http:" && !isLoopbackHostname(hostname)) return {
+				secure: false,
+				protocol,
+				reason: "insecureProtocol"
+			};
+			if (secureValue === true || protocol === "https:" || protocol === "wss:" || protocol === "file:" || protocol === "chrome-extension:") return {
+				secure: true,
+				protocol
+			};
+			if (protocol === "http:" && isLoopbackHostname(hostname)) return {
+				secure: true,
+				protocol
+			};
+			return {
+				secure: false,
+				protocol,
+				reason: "unknown"
+			};
+		}
+		function isLoopbackHostname(hostname) {
+			return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]" || hostname === "::1";
+		}
+		//#endregion
+		//#region src/client/voice-device-manager.ts
+		const INPUT_KEY = "codingns4dsh.voice.input-device";
+		const OUTPUT_KEY = "codingns4dsh.voice.output-device";
+		/**
+		* 浏览器 Client 的设备管理器。
+		*
+		* 设备权限、设备 ID 和设备变化都属于当前浏览器来源；Host 只会收到选择后的
+		* PCM 数据，不会接触这里的真实硬件清单。
+		*/
+		var BrowserVoiceDeviceManager = class {
+			listeners = /* @__PURE__ */ new Set();
+			current;
+			deviceChangeDispose;
+			disposed = false;
+			constructor() {
+				const security = inspectBrowserVoiceSecurity();
+				this.current = {
+					secureContext: security.secure,
+					permission: "unknown",
+					inputs: [],
+					outputs: [],
+					selectedInputId: readStorage(INPUT_KEY),
+					selectedOutputId: readStorage(OUTPUT_KEY)
+				};
+				const mediaDevices = globalThis.navigator?.mediaDevices;
+				if (mediaDevices !== void 0 && typeof mediaDevices.addEventListener === "function") {
+					const onDeviceChange = () => {
+						this.refresh();
+					};
+					mediaDevices.addEventListener("devicechange", onDeviceChange);
+					this.deviceChangeDispose = () => mediaDevices.removeEventListener("devicechange", onDeviceChange);
+				} else this.deviceChangeDispose = void 0;
+			}
+			snapshot() {
+				return cloneSnapshot(this.current);
+			}
+			subscribe(listener) {
+				this.listeners.add(listener);
+				listener(this.snapshot());
+				return () => this.listeners.delete(listener);
+			}
+			async refresh() {
+				if (this.disposed) return this.snapshot();
+				const security = inspectBrowserVoiceSecurity();
+				const mediaDevices = globalThis.navigator?.mediaDevices;
+				if (!security.secure || mediaDevices === void 0 || typeof mediaDevices.enumerateDevices !== "function") {
+					this.update({
+						secureContext: security.secure,
+						inputs: [],
+						outputs: []
+					});
+					return this.snapshot();
+				}
+				const devices = await mediaDevices.enumerateDevices();
+				const inputs = devices.filter((device) => device.kind === "audioinput").map(toDevice("audioinput"));
+				const outputs = devices.filter((device) => device.kind === "audiooutput").map(toDevice("audiooutput"));
+				const selectedInputId = this.current.selectedInputId !== null && inputs.some((device) => device.deviceId === this.current.selectedInputId) ? this.current.selectedInputId : null;
+				const selectedOutputId = this.current.selectedOutputId !== null && outputs.some((device) => device.deviceId === this.current.selectedOutputId) ? this.current.selectedOutputId : null;
+				if (selectedInputId === null) removeStorage(INPUT_KEY);
+				if (selectedOutputId === null) removeStorage(OUTPUT_KEY);
+				this.update({
+					inputs,
+					outputs,
+					selectedInputId,
+					selectedOutputId
+				});
+				await this.refreshPermission();
+				return this.snapshot();
+			}
+			async requestInputPermission() {
+				if (this.disposed) throw new Error("语音设备管理器已释放");
+				if (!inspectBrowserVoiceSecurity().secure) throw new Error("当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风");
+				const mediaDevices = globalThis.navigator?.mediaDevices;
+				if (mediaDevices === void 0 || typeof mediaDevices.getUserMedia !== "function") throw new Error("当前浏览器不支持 getUserMedia");
+				const selected = this.current.selectedInputId;
+				let stream;
+				try {
+					stream = await mediaDevices.getUserMedia({
+						audio: buildInputConstraints(selected),
+						video: false
+					});
+				} catch (error) {
+					if (selected === null || !isMissingInputDeviceError(error)) throw error;
+					removeStorage(INPUT_KEY);
+					this.update({ selectedInputId: null });
+					stream = await mediaDevices.getUserMedia({
+						audio: buildInputConstraints(null),
+						video: false
+					});
+				}
+				for (const track of stream.getTracks()) track.stop();
+				await this.refresh();
+				this.update({ permission: "granted" });
+				return this.snapshot();
+			}
+			async selectInput(deviceId) {
+				const value = deviceId.trim();
+				if (value !== "" && !this.current.inputs.some((device) => device.deviceId === value)) {
+					await this.refresh();
+					if (!this.current.inputs.some((device) => device.deviceId === value)) throw new Error("选择的麦克风设备不存在");
+				}
+				if (value === "") removeStorage(INPUT_KEY);
+				else writeStorage(INPUT_KEY, value);
+				this.update({ selectedInputId: value === "" ? null : value });
+				return this.snapshot();
+			}
+			async selectOutput(deviceId) {
+				const value = deviceId.trim();
+				if (value !== "" && !this.current.outputs.some((device) => device.deviceId === value)) {
+					await this.refresh();
+					if (!this.current.outputs.some((device) => device.deviceId === value)) throw new Error("选择的播放设备不存在");
+				}
+				if (value === "") removeStorage(OUTPUT_KEY);
+				else writeStorage(OUTPUT_KEY, value);
+				this.update({ selectedOutputId: value === "" ? null : value });
+				return this.snapshot();
+			}
+			dispose() {
+				if (this.disposed) return;
+				this.disposed = true;
+				this.deviceChangeDispose?.();
+				this.listeners.clear();
+			}
+			async refreshPermission() {
+				const permissions = globalThis.navigator?.permissions;
+				if (permissions === void 0 || typeof permissions.query !== "function") return;
+				try {
+					const status = await permissions.query({ name: "microphone" });
+					this.update({ permission: status.state === "granted" || status.state === "denied" ? status.state : "prompt" });
+				} catch {}
+			}
+			update(patch) {
+				this.current = {
+					...this.current,
+					...patch
+				};
+				const snapshot = this.snapshot();
+				for (const listener of [...this.listeners]) try {
+					listener(snapshot);
+				} catch {}
+			}
+		};
+		function buildInputConstraints(selectedInputId) {
+			return selectedInputId === null ? {
+				echoCancellation: true,
+				noiseSuppression: true,
+				autoGainControl: true
+			} : {
+				deviceId: { exact: selectedInputId },
+				echoCancellation: true,
+				noiseSuppression: true,
+				autoGainControl: true
+			};
+		}
+		function isMissingInputDeviceError(error) {
+			if (typeof error !== "object" || error === null) return false;
+			const name = "name" in error && typeof error.name === "string" ? error.name : "";
+			return name === "NotFoundError" || name === "OverconstrainedError" || name === "DevicesNotFoundError";
+		}
+		function toDevice(kind) {
+			return (device) => ({
+				kind,
+				deviceId: device.deviceId,
+				label: device.label,
+				groupId: device.groupId
+			});
+		}
+		function cloneSnapshot(value) {
+			return {
+				...value,
+				inputs: [...value.inputs],
+				outputs: [...value.outputs]
+			};
+		}
+		function readStorage(key) {
+			try {
+				return (globalThis.localStorage?.getItem(key))?.trim() || null;
+			} catch {
+				return null;
+			}
+		}
+		function writeStorage(key, value) {
+			try {
+				globalThis.localStorage?.setItem(key, value);
+			} catch {}
+		}
+		function removeStorage(key) {
+			try {
+				globalThis.localStorage?.removeItem(key);
+			} catch {}
+		}
+		//#endregion
+		//#region src/client/voice-capture.ts
+		/** 浏览器端实时 PCM 采集器；设备权限始终由 Client 自己持有。 */
+		var ClientVoiceCapture = class {
+			options;
+			stream;
+			context;
+			source;
+			processor;
+			output;
+			workletUrl;
+			sequence = 0;
+			started = false;
+			inputRate = 16e3;
+			constructor(options) {
+				this.options = options;
+			}
+			get isStarted() {
+				return this.started;
+			}
+			async start() {
+				if (this.started) return;
+				if (!inspectBrowserVoiceSecurity().secure) throw new Error("当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风");
+				const mediaDevices = globalThis.navigator?.mediaDevices;
+				if (mediaDevices === void 0 || typeof mediaDevices.getUserMedia !== "function") throw new Error("当前浏览器不支持 getUserMedia");
+				const selected = (await this.options.devices.requestInputPermission()).selectedInputId;
+				const constraints = {
+					audio: selected === null ? {
+						channelCount: 1,
+						echoCancellation: true,
+						noiseSuppression: true,
+						autoGainControl: true
+					} : {
+						deviceId: { exact: selected },
+						channelCount: 1,
+						echoCancellation: true,
+						noiseSuppression: true,
+						autoGainControl: true
+					},
+					video: false
+				};
+				const stream = await mediaDevices.getUserMedia(constraints);
+				this.stream = stream;
+				try {
+					const Context = globalThis.AudioContext ?? globalThis.webkitAudioContext;
+					if (Context === void 0) throw new Error("当前浏览器不支持 AudioContext");
+					const context = new Context({ sampleRate: this.options.targetSampleRate ?? 16e3 });
+					this.context = context;
+					this.inputRate = context.sampleRate;
+					await context.resume();
+					this.source = context.createMediaStreamSource(stream);
+					this.output = context.createGain();
+					this.output.gain.value = 0;
+					this.output.connect(context.destination);
+					this.sequence = 0;
+					if (context.audioWorklet !== void 0 && typeof AudioWorkletNode === "function") await this.startWorklet(context);
+					else this.startScriptProcessor(context);
+					this.started = true;
+					for (const track of stream.getAudioTracks()) track.addEventListener("ended", this.handleEnded, { once: true });
+				} catch (error) {
+					await this.stop();
+					throw error;
+				}
+			}
+			async stop() {
+				const stream = this.stream;
+				const processor = this.processor;
+				this.started = false;
+				this.stream = void 0;
+				this.processor = void 0;
+				this.source?.disconnect();
+				this.source = void 0;
+				processor?.disconnect();
+				this.output?.disconnect();
+				this.output = void 0;
+				if (this.context !== void 0 && this.context.state !== "closed") await this.context.close();
+				this.context = void 0;
+				if (this.workletUrl !== void 0) URL.revokeObjectURL(this.workletUrl);
+				this.workletUrl = void 0;
+				for (const track of stream?.getTracks() ?? []) {
+					track.removeEventListener("ended", this.handleEnded);
+					try {
+						track.stop();
+					} catch {}
+				}
+			}
+			async startWorklet(context) {
+				const source = this.source;
+				const output = this.output;
+				if (source === void 0 || output === void 0 || context.audioWorklet === void 0) throw new Error("音频采集图未初始化");
+				const blob = new Blob([`class CodingNsVoiceProcessor extends AudioWorkletProcessor { process(inputs) { const input = inputs[0] && inputs[0][0]; if (input) this.port.postMessage(new Float32Array(input)); return true; } } registerProcessor('codingns-voice-capture', CodingNsVoiceProcessor);`], { type: "application/javascript" });
+				this.workletUrl = URL.createObjectURL(blob);
+				await context.audioWorklet.addModule(this.workletUrl);
+				const node = new AudioWorkletNode(context, "codingns-voice-capture", {
+					numberOfInputs: 1,
+					numberOfOutputs: 1,
+					outputChannelCount: [1]
+				});
+				node.port.onmessage = (event) => {
+					if (!this.started && this.context !== context) return;
+					const samples = event.data instanceof Float32Array ? event.data : new Float32Array(event.data);
+					this.emitSamples(samples);
+				};
+				source.connect(node);
+				node.connect(output);
+				this.processor = node;
+			}
+			startScriptProcessor(context) {
+				const source = this.source;
+				const output = this.output;
+				if (source === void 0 || output === void 0) throw new Error("音频采集图未初始化");
+				const node = context.createScriptProcessor(1024, 1, 1);
+				node.onaudioprocess = (event) => this.emitSamples(event.inputBuffer.getChannelData(0));
+				source.connect(node);
+				node.connect(output);
+				this.processor = node;
+			}
+			handleEnded = () => {
+				if (!this.started) return;
+				this.options.onEnded?.(/* @__PURE__ */ new Error("麦克风轨道已结束"));
+				this.stop();
+			};
+			emitSamples(samples) {
+				if (!this.started) return;
+				const bytes = resampleFloat32ToPcm16(samples, this.inputRate, this.options.targetSampleRate ?? 16e3);
+				if (bytes.byteLength === 0) return;
+				const frame = {
+					sequence: ++this.sequence,
+					bytes,
+					sampleRate: this.options.targetSampleRate ?? 16e3,
+					channels: 1
+				};
+				Promise.resolve(this.options.onFrame(frame)).catch((error) => this.options.onEnded?.(error instanceof Error ? error : new Error(String(error))));
+			}
+		};
+		/** 无依赖的线性重采样，适合语音 16 kHz 采集；整段音频不会进入内存。 */
+		function resampleFloat32ToPcm16(samples, inputRate, outputRate) {
+			if (samples.length === 0) return /* @__PURE__ */ new Uint8Array();
+			if (!Number.isFinite(inputRate) || inputRate <= 0 || !Number.isFinite(outputRate) || outputRate <= 0) throw new RangeError("采样率必须为正数");
+			const outputLength = Math.max(1, Math.round(samples.length * outputRate / inputRate));
+			const bytes = new Uint8Array(outputLength * 2);
+			const view = new DataView(bytes.buffer);
+			for (let index = 0; index < outputLength; index += 1) {
+				const sourcePosition = index * inputRate / outputRate;
+				const left = Math.min(samples.length - 1, Math.floor(sourcePosition));
+				const right = Math.min(samples.length - 1, left + 1);
+				const fraction = sourcePosition - left;
+				const sample = Math.max(-1, Math.min(1, (samples[left] ?? 0) * (1 - fraction) + (samples[right] ?? 0) * fraction));
+				view.setInt16(index * 2, Math.round(sample * (sample < 0 ? 32768 : 32767)), true);
+			}
+			return bytes;
+		}
+		//#endregion
+		//#region src/client/sherpa-voice-adapter.ts
+		init_transport();
+		/** 浏览器侧 Sherpa 数据面：设备和权限在 Client，识别在 Host。 */
+		var ClientSherpaVoiceAdapter = class {
+			listeners = /* @__PURE__ */ new Set();
+			services;
+			devices;
+			options;
+			capture;
+			uploader;
+			responseAbort;
+			active = false;
+			hostLeaseActive = false;
+			epoch = 0;
+			configuredOwner;
+			selectedInputDeviceId;
+			selectedOutputDeviceId;
+			constructor(options) {
+				this.options = options;
+				this.services = options.services;
+				this.configuredOwner = options.ownerId;
+				this.devices = new BrowserVoiceDeviceManager();
+				const snapshot = this.devices.snapshot();
+				this.selectedInputDeviceId = snapshot.selectedInputId ?? void 0;
+				this.selectedOutputDeviceId = snapshot.selectedOutputId ?? void 0;
+				this.devices.subscribe((next) => {
+					this.selectedInputDeviceId = next.selectedInputId ?? void 0;
+					this.selectedOutputDeviceId = next.selectedOutputId ?? void 0;
+				});
+			}
+			get capabilities() {
+				const supported = this.devices.snapshot().secureContext && typeof globalThis.fetch === "function" && typeof globalThis.ReadableStream === "function";
+				return {
+					realtime: supported,
+					wakeWord: false,
+					streamingInput: supported,
+					streamingOutput: false,
+					bargeIn: supported,
+					speechToText: supported,
+					textToSpeech: typeof globalThis.speechSynthesis !== "undefined"
+				};
+			}
+			get ownerId() {
+				return this.active ? this.configuredOwner : void 0;
+			}
+			get configuredOwnerId() {
+				return this.configuredOwner;
+			}
+			get inputDeviceId() {
+				return this.selectedInputDeviceId;
+			}
+			get outputDeviceId() {
+				return this.selectedOutputDeviceId;
+			}
+			get outputDeviceSupported() {
+				return typeof (globalThis.HTMLMediaElement?.prototype)?.setSinkId === "function";
+			}
+			subscribe(listener) {
+				this.listeners.add(listener);
+				return () => this.listeners.delete(listener);
+			}
+			async enumerateInputDevices() {
+				return (await this.devices.refresh()).inputs;
+			}
+			async enumerateOutputDevices() {
+				return (await this.devices.refresh()).outputs;
+			}
+			async selectInputDevice(deviceId) {
+				await this.devices.selectInput(deviceId);
+				this.selectedInputDeviceId = this.devices.snapshot().selectedInputId ?? void 0;
+				if (this.active) {
+					await this.stop();
+					await this.start(this.configuredOwner);
+				}
+			}
+			async selectOutputDevice(deviceId) {
+				if (!this.outputDeviceSupported) throw new Error("当前浏览器不支持输出设备选择");
+				await this.devices.selectOutput(deviceId);
+				this.selectedOutputDeviceId = this.devices.snapshot().selectedOutputId ?? void 0;
+				await this.applyOutputDevice();
+			}
+			async start(ownerId) {
+				if (this.active) return;
+				this.configuredOwner = ownerId?.trim() || this.configuredOwner;
+				if (this.configuredOwner === "") throw new Error("全局语音租约缺少 ownerId");
+				const lease = await this.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/start", { ownerId: this.configuredOwner });
+				if (!lease.ok) throw new Error(lease.error.message);
+				if (isRecord$2(lease.value) && lease.value.unavailable === true) throw new Error(typeof lease.value.message === "string" ? lease.value.message : "本地 Sherpa 语音运行时不可用");
+				this.hostLeaseActive = true;
+				if (!(await this.devices.refresh()).secureContext) throw new Error("当前页面不是安全上下文，请改用 HTTPS 或 localhost 后访问麦克风");
+				this.epoch += 1;
+				const epoch = this.epoch;
+				const uploader = new VoiceStreamUploader();
+				const abort = new AbortController();
+				this.uploader = uploader;
+				this.responseAbort = abort;
+				this.active = true;
+				this.emit({
+					type: "state",
+					state: "loading",
+					epoch
+				});
+				try {
+					uploader.enqueue(encodeVoiceStreamOpen({
+						ownerId: this.configuredOwner,
+						clientId: createClientId(),
+						sampleRate: 16e3,
+						channels: 1,
+						encoding: "pcm16le"
+					}));
+					const response = await globalThis.fetch(resolveVoiceStreamUrl(), {
+						method: "POST",
+						body: uploader.stream,
+						signal: abort.signal,
+						credentials: "same-origin",
+						headers: {
+							"content-type": "application/octet-stream",
+							accept: "application/x-ndjson"
+						},
+						duplex: "half"
+					});
+					if (!response.ok || response.body === null) throw new Error(`语音流连接失败（HTTP ${response.status}）`);
+					this.readEvents(response.body, epoch);
+					const capture = new ClientVoiceCapture({
+						devices: this.devices,
+						targetSampleRate: 16e3,
+						onFrame: (frame) => this.sendPcmFrame(frame, epoch),
+						onEnded: (error) => this.emit({
+							type: "error",
+							code: "voice_capture_ended",
+							message: error.message,
+							recoverable: true,
+							epoch
+						})
+					});
+					this.capture = capture;
+					await capture.start();
+					this.emit({
+						type: "state",
+						state: "listening",
+						epoch
+					});
+				} catch (error) {
+					await this.stop().catch(() => void 0);
+					throw error;
+				}
+			}
+			async stop() {
+				if (!this.active && this.capture === void 0 && !this.hostLeaseActive) return;
+				this.active = false;
+				let captureError;
+				try {
+					await this.capture?.stop();
+				} catch (error) {
+					captureError = error;
+				}
+				this.capture = void 0;
+				this.uploader?.enqueue(encodeVoiceStreamMessage({
+					type: "close",
+					epoch: this.epoch
+				}));
+				this.uploader?.close();
+				this.uploader = void 0;
+				this.responseAbort?.abort();
+				this.responseAbort = void 0;
+				if (this.hostLeaseActive) {
+					this.hostLeaseActive = false;
+					await this.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/stop", { ownerId: this.configuredOwner }).catch(() => void 0);
+				}
+				this.epoch += 1;
+				this.emit({
+					type: "state",
+					state: "disabled",
+					epoch: this.epoch
+				});
+				if (captureError !== void 0) throw captureError;
+			}
+			async interrupt() {
+				this.epoch += 1;
+				globalThis.speechSynthesis?.cancel();
+				this.uploader?.enqueue(encodeVoiceStreamMessage({
+					type: "interrupt",
+					epoch: this.epoch
+				}));
+				await this.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/interrupt", { ownerId: this.configuredOwner }).catch(() => void 0);
+				this.emit({
+					type: "barge-in",
+					epoch: this.epoch
+				});
+			}
+			sendPcm(frame, epoch) {
+				this.sendPcmFrame(frame, epoch);
+			}
+			async speak(text, epoch) {
+				if (epoch !== this.epoch || text.trim() === "") return;
+				const synthesis = globalThis.speechSynthesis;
+				if (synthesis === void 0 || typeof globalThis.SpeechSynthesisUtterance !== "function") throw new Error("当前浏览器不支持语音播报");
+				synthesis.cancel();
+				await new Promise((resolve) => {
+					const utterance = new SpeechSynthesisUtterance(text.trim());
+					utterance.lang = "zh-CN";
+					utterance.onend = () => resolve();
+					utterance.onerror = () => resolve();
+					synthesis.speak(utterance);
+				});
+			}
+			dispose() {
+				this.stop();
+				this.devices.dispose();
+				this.listeners.clear();
+			}
+			sendPcmFrame(frame, epoch) {
+				if (!this.active || this.uploader === void 0 || epoch !== this.epoch) return;
+				this.uploader.enqueue(encodeVoiceStreamMessage({
+					type: "pcm",
+					sequence: frame.sequence,
+					sampleRate: frame.sampleRate,
+					channels: 1,
+					epoch,
+					byteLength: frame.bytes.byteLength
+				}));
+				this.uploader.enqueue(frame.bytes);
+			}
+			async readEvents(body, streamEpoch) {
+				const reader = body.getReader();
+				const decoder = new TextDecoder();
+				let text = "";
+				try {
+					while (true) {
+						const next = await reader.read();
+						if (next.done) break;
+						text += decoder.decode(next.value, { stream: true });
+						let newline = text.indexOf("\n");
+						while (newline >= 0) {
+							const line = text.slice(0, newline).trim();
+							text = text.slice(newline + 1);
+							if (line !== "") await this.handleEvent(JSON.parse(line), streamEpoch);
+							newline = text.indexOf("\n");
+						}
+					}
+				} catch (error) {
+					if (this.active) this.emit({
+						type: "error",
+						code: "voice_stream_response_failed",
+						message: error instanceof Error ? error.message : String(error),
+						recoverable: true,
+						epoch: streamEpoch
+					});
+				}
+			}
+			async handleEvent(value, streamEpoch) {
+				if (streamEpoch !== this.epoch || typeof value.type !== "string") return;
+				if (value.type === "state" && typeof value.state === "string") this.emit({
+					type: "state",
+					state: value.state,
+					epoch: readEpoch(value, streamEpoch)
+				});
+				else if (value.type === "partial" && typeof value.text === "string") this.emit({
+					type: "partial",
+					text: value.text,
+					epoch: readEpoch(value, streamEpoch)
+				});
+				else if (value.type === "final" && typeof value.text === "string") {
+					const eventEpoch = readEpoch(value, streamEpoch);
+					this.emit({
+						type: "final",
+						text: value.text,
+						epoch: eventEpoch
+					});
+					const result = await this.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/text", {
+						ownerId: this.configuredOwner,
+						text: value.text,
+						requestId: createClientId()
+					});
+					if (result.ok && isRecord$2(result.value) && typeof result.value.speechText === "string") await this.speak(result.value.speechText, eventEpoch);
+				} else if (value.type === "barge-in") this.emit({
+					type: "barge-in",
+					epoch: readEpoch(value, streamEpoch)
+				});
+				else if (value.type === "error") this.emit({
+					type: "error",
+					code: String(value.code ?? "voice_stream_error"),
+					message: String(value.message ?? value.code ?? ""),
+					recoverable: value.recoverable !== false,
+					epoch: readEpoch(value, streamEpoch)
+				});
+			}
+			async applyOutputDevice() {
+				if (!this.outputDeviceSupported) return;
+				for (const media of [...document.querySelectorAll("audio,video")]) {
+					const sink = media.setSinkId;
+					if (typeof sink === "function") await sink.call(media, this.selectedOutputDeviceId ?? "");
+				}
+			}
+			emit(event) {
+				for (const listener of [...this.listeners]) try {
+					listener(event);
+				} catch {}
+			}
+		};
+		var VoiceStreamUploader = class {
+			stream;
+			controller;
+			closed = false;
+			constructor() {
+				this.stream = new ReadableStream({ start: (controller) => {
+					this.controller = controller;
+				} });
+			}
+			enqueue(bytes) {
+				if (!this.closed) try {
+					this.controller?.enqueue(bytes.slice());
+				} catch {
+					this.closed = true;
+				}
+			}
+			close() {
+				if (this.closed) return;
+				this.closed = true;
+				try {
+					this.controller?.close();
+				} catch {}
+			}
+		};
+		function resolveVoiceStreamUrl() {
+			return new URL("/api/codingns/assistant/voice/stream", globalThis.location?.origin ?? "http://localhost").toString();
+		}
+		function createClientId() {
+			try {
+				return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;
+			} catch {
+				return `${Date.now()}-${Math.random()}`;
+			}
+		}
+		function readEpoch(value, fallback) {
+			return typeof value.epoch === "number" && Number.isInteger(value.epoch) ? value.epoch : fallback;
+		}
+		function isRecord$2(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		//#endregion
+		//#region src/client/features/voice-conversation-dialog.ts
+		init_theme();
+		/** 全局语音助理独立对话窗口；打开窗口不会自动申请麦克风。 */
+		function VoiceConversationDialog({ t, active, pending, state, message, partialText, transcript, realtimeAvailable, unavailableMessage, onStart, onStop, onClose, onClear }) {
+			const status = statusLabel(t, state, active);
+			const canStart = !active && !pending;
+			const transcriptRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				const element = transcriptRef.current;
+				if (element !== null) element.scrollTop = element.scrollHeight;
+			}, [partialText, transcript.length]);
+			return (0, react.createElement)("div", {
+				role: "presentation",
+				onPointerDown: () => {
+					if (!pending) onClose();
+				},
+				style: {
+					position: "fixed",
+					inset: 0,
+					zIndex: 1e4,
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "center",
+					padding: 16,
+					background: dshThemeColor.overlay,
+					boxSizing: "border-box"
+				}
+			}, (0, react.createElement)("div", {
+				role: "dialog",
+				"aria-modal": true,
+				"aria-label": t("voice.dialog.title"),
+				onPointerDown: (event) => event.stopPropagation(),
+				style: {
+					display: "flex",
+					flexDirection: "column",
+					gap: 14,
+					width: "min(620px, 100%)",
+					maxHeight: "min(700px, 100%)",
+					overflowY: "auto",
+					padding: 24,
+					color: dshThemeColor.labelPrimary,
+					background: dshThemeColor.menuBackground,
+					border: `1px solid ${dshThemeColor.border}`,
+					borderRadius: 12,
+					boxShadow: dshThemeColor.prominentShadow,
+					boxSizing: "border-box"
+				}
+			}, (0, react.createElement)("div", { style: {
+				display: "flex",
+				alignItems: "flex-start",
+				justifyContent: "space-between",
+				gap: 16
+			} }, (0, react.createElement)("div", { style: {
+				display: "grid",
+				gap: 6,
+				minWidth: 0
+			} }, (0, react.createElement)("strong", { style: {
+				fontSize: 18,
+				lineHeight: 1.4
+			} }, t("voice.dialog.title")), (0, react.createElement)("span", { style: dshSettingsHelpStyle }, t("voice.dialog.description"))), (0, react.createElement)("span", {
+				role: "status",
+				style: {
+					flex: "0 0 auto",
+					color: active ? dshThemeColor.success : dshThemeColor.labelSecondary,
+					fontSize: 12
+				}
+			}, status)), (0, react.createElement)("div", { style: {
+				padding: "10px 12px",
+				borderRadius: 8,
+				background: dshThemeColor.surfaceSubtle,
+				color: dshThemeColor.labelSecondary,
+				fontSize: 12,
+				lineHeight: 1.5
+			} }, realtimeAvailable ? t("voice.dialog.realtimeHint") : unavailableMessage ?? t("voice.dialog.unavailable")), (0, react.createElement)("div", {
+				"aria-live": "polite",
+				ref: transcriptRef,
+				style: {
+					display: "flex",
+					flexDirection: "column",
+					gap: 8,
+					minHeight: 180,
+					maxHeight: 340,
+					overflowY: "auto",
+					padding: 14,
+					border: `1px solid ${dshThemeColor.border}`,
+					borderRadius: 8,
+					background: dshThemeColor.inputBackground,
+					boxSizing: "border-box"
+				}
+			}, (0, react.createElement)("div", { style: {
+				color: dshThemeColor.labelTertiary,
+				fontSize: 12,
+				fontWeight: 600
+			} }, t("voice.dialog.liveText")), transcript.length === 0 && partialText === "" ? (0, react.createElement)("div", { style: {
+				color: dshThemeColor.labelTertiary,
+				fontSize: 14,
+				lineHeight: 1.6
+			} }, t("voice.dialog.empty")) : null, ...transcript.map((text, index) => (0, react.createElement)("div", {
+				key: `${index}-${text}`,
+				style: {
+					color: dshThemeColor.labelPrimary,
+					fontSize: 15,
+					lineHeight: 1.65
+				}
+			}, text)), partialText === "" ? null : (0, react.createElement)("div", { style: {
+				color: dshThemeColor.accent,
+				fontSize: 15,
+				lineHeight: 1.65
+			} }, partialText)), message === void 0 || message === "" || state !== "error" ? null : (0, react.createElement)("div", {
+				role: "alert",
+				style: {
+					color: dshThemeColor.error,
+					fontSize: 13,
+					lineHeight: 1.5
+				}
+			}, message), (0, react.createElement)("div", { style: {
+				display: "flex",
+				justifyContent: "space-between",
+				gap: 8,
+				paddingTop: 3
+			} }, (0, react.createElement)("button", {
+				type: "button",
+				disabled: transcript.length === 0 && partialText === "",
+				onClick: onClear,
+				style: dshSettingsButtonStyle
+			}, t("voice.dialog.clear")), (0, react.createElement)("div", { style: {
+				display: "flex",
+				justifyContent: "flex-end",
+				gap: 8
+			} }, (0, react.createElement)("button", {
+				type: "button",
+				disabled: pending,
+				onClick: onClose,
+				style: dshSettingsButtonStyle
+			}, t("voice.dialog.close")), active ? (0, react.createElement)("button", {
+				type: "button",
+				onClick: onStop,
+				style: dshSettingsButtonStyle
+			}, t("voice.dialog.stop")) : (0, react.createElement)("button", {
+				type: "button",
+				disabled: !canStart || !realtimeAvailable,
+				onClick: onStart,
+				style: dshSettingsPrimaryButtonStyle
+			}, t("voice.dialog.start"))))));
+		}
+		function statusLabel(t, state, active) {
+			if (state === "loading") return t("voice.dialog.status.loading");
+			if (state === "listening") return t("voice.dialog.status.listening");
+			if (state === "recording") return t("voice.dialog.status.recording");
+			if (state === "error") return t("voice.dialog.status.error");
+			return active ? t("voice.dialog.status.active") : t("voice.dialog.status.idle");
+		}
+		//#endregion
+		//#region src/client/features/global-voice-assistant.ts
+		init_transport();
+		init_locale();
+		const GLOBAL_ASSISTANT_BUTTON_SIZE = 38;
+		/** Client 根级语音入口；使用 shell.overlay，绝不绑定当前 session。 */
+		const globalVoiceAssistantFeature = {
+			descriptor: {
+				name: "globalVoiceAssistant",
+				version: "0.1.0",
+				enabledByDefault: false,
+				dependencies: [],
+				runtime: "client",
+				ui: {
+					label: "Global smart assistant (Testing)",
+					description: "Choose the workspaces that the global assistant may read and control.",
+					labelKey: "feature.assistant.label",
+					descriptionKey: "feature.assistant.description",
+					order: 30,
+					defaultOpen: false
+				}
+			},
+			start(context) {
+				const ui = context.services.uiContext;
+				if (ui === void 0) return;
+				const actionOwnerId = createVoiceLeaseOwnerId();
+				const adapter = new ClientSherpaVoiceAdapter({
+					ownerId: actionOwnerId,
+					services: context.services
+				});
+				context.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/register-client", {
+					ownerId: actionOwnerId,
+					capabilities: adapter.capabilities,
+					secureContext: inspectBrowserVoiceSecurity().secure
+				}).catch(() => void 0);
+				const disposeAdapter = registerGlobalVoiceAdapter(context.services, adapter);
+				context.resources.add(() => {
+					disposeAdapter();
+					adapter.dispose();
+					context.services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/unregister-client", { ownerId: actionOwnerId }).catch(() => void 0);
+				});
+				const disposer = ui.slots.inject("shell.overlay", () => ui.slots.register({
+					name: "shell.overlay",
+					id: "codingns4dsh-global-voice-assistant",
+					order: 40,
+					inject: () => ({ services: context.services })
+				}, GlobalVoiceOverlay));
+				context.resources.add(disposer);
+			},
+			settingsPanel: AssistantPanel
+		};
+		function GlobalVoiceOverlay({ services }) {
+			const [snapshot, setSnapshot] = (0, react.useState)({ state: "disabled" });
+			const [setupOpen, setSetupOpen] = (0, react.useState)(false);
+			const [conversationOpen, setConversationOpen] = (0, react.useState)(false);
+			const [conversationPending, setConversationPending] = (0, react.useState)(false);
+			const [partialText, setPartialText] = (0, react.useState)("");
+			const [transcript, setTranscript] = (0, react.useState)([]);
+			const [settingsValue, setSettingsValue] = (0, react.useState)(() => services.settings.getSnapshot().value);
+			const ownerIdRef = (0, react.useRef)(void 0);
+			const eventSequenceRef = (0, react.useRef)(0);
+			if (ownerIdRef.current === void 0) ownerIdRef.current = createVoiceLeaseOwnerId();
+			const t = useCodingNsTranslator(services.locale);
+			const nativeAdapter = getGlobalVoiceAdapter(services);
+			const ownerId = nativeAdapter?.configuredOwnerId ?? ownerIdRef.current;
+			const browserVoiceSecurity = inspectBrowserVoiceSecurity();
+			const voiceSettings = settingsValue?.assistant?.voice ?? DEFAULT_ASSISTANT_VOICE_SETTINGS;
+			const needsSetup = !isVoiceSettingsReady(voiceSettings);
+			const adapter = nativeAdapter?.capabilities.realtime === true && browserVoiceSecurity.secure && !needsSetup && voiceSettings.provider === "sherpa-onnx" ? nativeAdapter : void 0;
+			const realtimeUnavailableMessage = !browserVoiceSecurity.secure ? t("voice.secureContextRequired") : nativeAdapter?.capabilities.realtime !== true ? t("voice.dialog.unavailable") : voiceSettings.provider !== "sherpa-onnx" ? t("voice.dialog.unavailable") : void 0;
+			(0, react.useEffect)(() => {
+				const refresh = () => setSettingsValue(services.settings.getSnapshot().value);
+				refresh();
+				return services.settings.subscribe(refresh);
+			}, [services.settings]);
+			(0, react.useEffect)(() => {
+				if (adapter !== void 0) {
+					setSnapshot({
+						state: "disabled",
+						active: false
+					});
+					const unsubscribe = adapter.subscribe((event) => {
+						if (event.type === "state" || event.type === "wake" || event.type === "barge-in" || event.type === "error") services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/event", {
+							ownerId,
+							event,
+							sequence: ++eventSequenceRef.current
+						}).catch(() => void 0);
+						if (event.type === "partial") setPartialText(event.text);
+						else if (event.type === "final" && event.text.trim() !== "") {
+							setTranscript((previous) => [...previous, event.text.trim()]);
+							setPartialText("");
+						}
+						if (event.type === "state") setSnapshot({
+							state: event.state,
+							active: event.state !== "disabled",
+							ownerId
+						});
+						else if (event.type === "barge-in") setSnapshot({
+							state: "interrupted",
+							active: true,
+							ownerId
+						});
+						else if (event.type === "error") {
+							const message = event.code === "voice_empty_transcript" ? t("voice.emptyTranscript") : event.code === "voice_invalid_transcript" ? t("voice.invalidTranscript") : event.message;
+							setSnapshot({
+								state: "error",
+								active: true,
+								ownerId,
+								message
+							});
+							if (!event.recoverable) adapter.stop().catch(() => void 0);
+						}
+					});
+					const onPageHide = () => {
+						adapter.stop().catch(() => void 0);
+					};
+					if (typeof window !== "undefined") window.addEventListener("pagehide", onPageHide);
+					return () => {
+						unsubscribe();
+						if (typeof window !== "undefined") window.removeEventListener("pagehide", onPageHide);
+						adapter.stop().catch(() => void 0);
+					};
+				}
+				setSnapshot({
+					state: "error",
+					active: false,
+					ownerId,
+					...realtimeUnavailableMessage === void 0 ? {} : { message: realtimeUnavailableMessage }
+				});
+			}, [
+				adapter,
+				ownerId,
+				realtimeUnavailableMessage,
+				services,
+				t
+			]);
+			(0, react.useEffect)(() => {
+				if (adapter === void 0) return void 0;
+				const timer = setInterval(() => {
+					if (adapter.ownerId === void 0) return;
+					services.rpc.call(CODINGNS_RPC_CHANNEL, "assistant/voice/heartbeat", { ownerId }).catch(() => void 0);
+				}, 1e4);
+				return () => clearInterval(timer);
+			}, [
+				adapter,
+				ownerId,
+				services
+			]);
+			const startConversation = async () => {
+				if (conversationPending || snapshot.active === true) return;
+				setConversationPending(true);
+				setPartialText("");
+				setSnapshot((previous) => ({
+					...previous,
+					state: "loading",
+					active: false,
+					ownerId
+				}));
+				try {
+					if (adapter === void 0) throw new Error(realtimeUnavailableMessage ?? t("voice.dialog.unavailable"));
+					await adapter.start(ownerId);
+				} catch (error) {
+					setSnapshot({
+						state: "error",
+						active: false,
+						ownerId,
+						message: error instanceof Error ? error.message : String(error)
+					});
+				} finally {
+					setConversationPending(false);
+				}
+			};
+			const stopConversation = async () => {
+				if (!conversationPending && snapshot.active !== true) return;
+				setConversationPending(true);
+				try {
+					if (adapter !== void 0) await adapter.stop();
+					setPartialText("");
+				} catch (error) {
+					setSnapshot({
+						state: "error",
+						active: false,
+						ownerId,
+						message: error instanceof Error ? error.message : String(error)
+					});
+				} finally {
+					setConversationPending(false);
+				}
+			};
+			const closeConversation = () => {
+				if (snapshot.active === true) {
+					stopConversation().finally(() => setConversationOpen(false));
+					return;
+				}
+				setConversationOpen(false);
+			};
+			const openConversation = () => {
+				if (needsSetup) {
+					setSetupOpen(true);
+					return;
+				}
+				setConversationOpen(true);
+			};
+			(0, react.useEffect)(() => {
+				const doc = typeof document === "undefined" ? void 0 : document;
+				if (doc === void 0) return void 0;
+				const assistantButtonSize = `${GLOBAL_ASSISTANT_BUTTON_SIZE}px`;
+				let mountedNative;
+				let mountedRow;
+				let mountedParent;
+				let mountedNextSibling;
+				let mountedNativeInlineStyle;
+				const mount = () => {
+					const buttons = [...doc.querySelectorAll("button")];
+					const native = buttons.find((candidate) => {
+						return (typeof candidate.className === "string" ? candidate.className.split(/\s+/u) : []).some((name) => name.endsWith("_newSession"));
+					}) ?? buttons.find((candidate) => {
+						const aria = candidate.getAttribute("aria-label") ?? "";
+						return /新建会话|新建对话|new session|new conversation/iu.test(aria);
+					});
+					if (native === void 0 || native.parentElement === null || native.parentElement.querySelector("[data-codingns-global-voice-button]") !== null) return;
+					const button = doc.createElement("button");
+					button.type = "button";
+					button.setAttribute("data-codingns-global-voice-button", "true");
+					const label = needsSetup ? t("voice.setup.open") : t("voice.globalAssistant");
+					button.setAttribute("aria-label", label);
+					button.setAttribute("aria-description", [
+						t("voice.microphoneNotice"),
+						t("voice.audioNotice"),
+						snapshot.message
+					].filter(Boolean).join(" "));
+					button.setAttribute("aria-haspopup", "dialog");
+					button.setAttribute("aria-expanded", String(conversationOpen || setupOpen));
+					button.setAttribute("data-codingns-voice-state", snapshot.state ?? "disabled");
+					button.title = label;
+					button.innerHTML = "<svg aria-hidden=\"true\" viewBox=\"0 0 24 24\" width=\"18\" height=\"18\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m12 2 1.45 5.55L19 9l-5.55 1.45L12 16l-1.45-5.55L5 9l5.55-1.45L12 2Z\"/><path d=\"m5 15 .7 2.3L8 18l-2.3.7L5 21l-.7-2.3L2 18l2.3-.7L5 15Z\"/><path d=\"m19 14 .45 1.55L21 16l-1.55.45L19 18l-.45-1.55L17 16l1.55-.45L19 14Z\"/></svg>";
+					button.style.cssText = `display:inline-flex;align-items:center;justify-content:center;padding:0;border:0;border-radius:8px;cursor:pointer;background:var(--ds-color-fill-tertiary,rgba(127,127,127,.12));flex:0 1 ${assistantButtonSize};min-width:${assistantButtonSize};width:${assistantButtonSize};max-width:${assistantButtonSize};height:${assistantButtonSize};aspect-ratio:1 / 1;box-sizing:border-box;white-space:nowrap;margin:0`;
+					button.addEventListener("click", openConversation);
+					const parent = native.parentElement;
+					const row = doc.createElement("div");
+					row.setAttribute("data-codingns-global-voice-row", "true");
+					row.style.cssText = "display:flex;flex:0 1 auto;flex-flow:row nowrap;align-items:center;gap:4px;min-width:0;width:calc(100% - 4px);max-width:100%;box-sizing:border-box;overflow:hidden;margin:0 2px 12px";
+					mountedNative = native;
+					mountedRow = row;
+					mountedParent = parent;
+					mountedNextSibling = native.nextSibling;
+					mountedNativeInlineStyle = {
+						flex: native.style.flex,
+						minWidth: native.style.minWidth,
+						width: native.style.width,
+						maxWidth: native.style.maxWidth,
+						boxSizing: native.style.boxSizing,
+						whiteSpace: native.style.whiteSpace,
+						margin: native.style.margin
+					};
+					parent.insertBefore(row, native);
+					row.append(native, button);
+					native.style.flex = "1 1 auto";
+					native.style.minWidth = "0";
+					native.style.width = "auto";
+					native.style.maxWidth = "100%";
+					native.style.boxSizing = "border-box";
+					native.style.whiteSpace = "nowrap";
+					native.style.margin = "0";
+					button.style.flex = `0 1 ${assistantButtonSize}`;
+					button.style.width = assistantButtonSize;
+					button.style.minWidth = assistantButtonSize;
+					button.style.maxWidth = assistantButtonSize;
+					button.style.height = assistantButtonSize;
+				};
+				mount();
+				const observer = typeof MutationObserver === "undefined" ? void 0 : new MutationObserver(mount);
+				observer?.observe(doc.body ?? doc.documentElement, {
+					childList: true,
+					subtree: true
+				});
+				return () => {
+					observer?.disconnect();
+					if (mountedNative !== void 0 && mountedNativeInlineStyle !== void 0) {
+						mountedNative.style.flex = mountedNativeInlineStyle.flex;
+						mountedNative.style.minWidth = mountedNativeInlineStyle.minWidth;
+						mountedNative.style.width = mountedNativeInlineStyle.width;
+						mountedNative.style.maxWidth = mountedNativeInlineStyle.maxWidth;
+						mountedNative.style.boxSizing = mountedNativeInlineStyle.boxSizing;
+						mountedNative.style.whiteSpace = mountedNativeInlineStyle.whiteSpace;
+						mountedNative.style.margin = mountedNativeInlineStyle.margin;
+					}
+					if (mountedNative !== void 0 && mountedParent !== void 0 && mountedParent.isConnected) {
+						if (mountedNextSibling !== null && mountedNextSibling !== void 0 && mountedNextSibling.parentNode === mountedParent) mountedParent.insertBefore(mountedNative, mountedNextSibling);
+						else mountedParent.appendChild(mountedNative);
+					}
+					mountedRow?.remove();
+					doc.querySelectorAll("[data-codingns-global-voice-button]").forEach((node) => node.remove());
+				};
+			}, [
+				adapter,
+				conversationOpen,
+				needsSetup,
+				openConversation,
+				setSetupOpen,
+				setupOpen,
+				snapshot.state,
+				t
+			]);
+			return (0, react.createElement)("span", {
+				"data-codingns-global-voice": "true",
+				...setupOpen || conversationOpen ? {} : { "aria-hidden": "true" }
+			}, setupOpen ? (0, react.createElement)(VoiceInitializationDialog, {
+				services,
+				value: voiceSettings,
+				onClose: () => setSetupOpen(false)
+			}) : conversationOpen ? (0, react.createElement)(VoiceConversationDialog, {
+				t,
+				active: snapshot.active === true,
+				pending: conversationPending,
+				state: snapshot.state,
+				message: snapshot.message,
+				partialText,
+				transcript,
+				realtimeAvailable: adapter !== void 0,
+				unavailableMessage: realtimeUnavailableMessage,
+				onStart: () => {
+					startConversation();
+				},
+				onStop: () => {
+					stopConversation();
+				},
+				onClose: closeConversation,
+				onClear: () => {
+					setTranscript([]);
+					setPartialText("");
+				}
+			}) : null);
+		}
+		function createVoiceLeaseOwnerId() {
+			try {
+				const randomUUID = globalThis.crypto?.randomUUID;
+				if (typeof randomUUID === "function") return `codingns4dsh:global-voice:${randomUUID.call(globalThis.crypto)}`;
+			} catch {}
+			return `codingns4dsh:global-voice:${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+		}
+		function isVoiceSettingsReady(settings) {
+			if (!settings.initialized || settings.provider !== "sherpa-onnx") return false;
+			return settings.asrEncoder.trim() !== "" && settings.asrDecoder.trim() !== "" && settings.asrJoiner.trim() !== "" && settings.asrTokens.trim() !== "";
+		}
+		//#endregion
 		//#region src/client/peer-host-scoped-client.ts
 		init_transport();
 		/** 根据当前 Host 自有端点生成作用域 WebSocket 工厂；不接受目标 Host URL。 */
@@ -60060,7 +62642,8 @@ window.__ModuleLoader__.load({
 			debugFeature,
 			gitManagementFeature,
 			fileManagementFeature,
-			peerHostFeature
+			peerHostFeature,
+			globalVoiceAssistantFeature
 		];
 		/**
 		* 汇总需要在设置页显示的模块，按 ui.order 升序。
@@ -60754,7 +63337,7 @@ window.__ModuleLoader__.load({
 			Time.template = template;
 		})(Time || (Time = {}));
 		//#endregion
-		//#region node_modules/.pnpm/@deepseek-ai+cordis@4.0.4_@deepseek-ai+cordis-plugin-include@1.0.9_@deepseek-ai+cordis-plugin-loader@1.0.5/node_modules/@deepseek-ai/cordis/lib/index.js
+		//#region node_modules/.pnpm/@deepseek-ai+cordis@4.0.4_@deepseek-ai+cordis-plugin-include@1.0.9_@deepseek-ai+cordis-plugin-loader@1.0.6-alpha.1/node_modules/@deepseek-ai/cordis/lib/index.js
 		/** Ordered collection of disposable values with O(1) deletion by value. */
 		var DisposableList = class {
 			sn = 0;
@@ -62659,7 +65242,7 @@ window.__ModuleLoader__.load({
 						this.initialStateConsumed = true;
 						if (initial.info.state === "running") this.connect();
 						else this.refresh();
-					} else this.refresh();
+					} else if (!this.resumeFollow()) this.refresh();
 				}
 				let active = true;
 				return () => {
@@ -62669,9 +65252,20 @@ window.__ModuleLoader__.load({
 					if (this.mounted === 0 && !this.keepAlive) this.detach();
 				};
 			}
-			async refresh() {
-				if (this.loading !== void 0) return this.loading;
+			/**
+			* 重新加载终端环境与库存。
+			*
+			* 默认复用仍然活跃的 follow 连接：只有连接确实不存在时才向 Host 重新发起
+			* environment/list。`force` 供“重新连接/刷新”这类显式动作使用，会先释放
+			* 现有 follow 再重建，避免保活连接变成无法恢复的僵尸订阅。
+			*/
+			async refresh(options) {
 				if (this.lifetime.signal.aborted) return;
+				if (this.loading !== void 0) return this.loading;
+				if (options?.force === true) {
+					this.clearReconnect();
+					this.releaseFollow();
+				} else if (this.resumeFollow()) return;
 				this.loading = this.load().finally(() => {
 					this.loading = void 0;
 				});
@@ -62687,6 +65281,7 @@ window.__ModuleLoader__.load({
 				if (this.loading !== void 0) return this.loading;
 				this.clearReconnect();
 				this.reconnectAttempts = 0;
+				this.releaseFollow();
 				this.patch({
 					phase: "loading",
 					writable: false
@@ -62700,17 +65295,17 @@ window.__ModuleLoader__.load({
 			async loadWithRebuild() {
 				try {
 					const remote = resolveRemote(this.remote);
-					const environment = unwrap(await remote.environment(this.sessionId, this.lifetime.signal));
+					const environment = unwrap(await this.request(remote.environment(this.sessionId, this.lifetime.signal)));
 					this.patch({
 						phase: "creating",
 						environment
 					});
-					const info = unwrap(await remote.create(this.sessionId, {
+					const info = unwrap(await this.request(remote.create(this.sessionId, {
 						id: this.id,
 						...this.shellPath === void 0 ? {} : { shellPath: this.shellPath },
 						cols: Math.min(80, environment.maxCols),
 						rows: Math.min(24, environment.maxRows)
-					}, this.lifetime.signal));
+					}, this.lifetime.signal)));
 					debugInfo("codingns4dsh: client terminal rebuilt", {
 						sessionId: this.sessionId,
 						terminalId: info.id
@@ -62722,7 +65317,7 @@ window.__ModuleLoader__.load({
 						info,
 						title: info.title
 					});
-					if (this.mounted > 0) this.connect();
+					this.finishLoad();
 				} catch (error) {
 					if (!this.lifetime.signal.aborted) this.fail(error);
 				}
@@ -62747,7 +65342,7 @@ window.__ModuleLoader__.load({
 					unwrap(await resolveRemote(this.remote).write(this.sessionId, this.id, attachmentId, data));
 				}).catch((error) => this.fail(error));
 			}
-			resize(cols, rows) {
+			resize(cols, rows, options) {
 				const state = this.store.getSnapshot();
 				const attachmentId = this.attachmentId;
 				if (!state.writable || attachmentId === void 0) return;
@@ -62758,7 +65353,7 @@ window.__ModuleLoader__.load({
 					cols: nextCols,
 					rows: nextRows
 				};
-				if (sameResize(this.lastResize, request)) return;
+				if (options?.force !== true && sameResize(this.lastResize, request)) return;
 				this.lastResize = request;
 				this.writes = this.writes.then(async () => {
 					unwrap(await resolveRemote(this.remote).resize(this.sessionId, this.id, attachmentId, nextCols, nextRows));
@@ -62817,7 +65412,7 @@ window.__ModuleLoader__.load({
 				});
 				try {
 					const remote = resolveRemote(this.remote);
-					const environment = unwrap(await remote.environment(this.sessionId, this.lifetime.signal));
+					const environment = unwrap(await this.request(remote.environment(this.sessionId, this.lifetime.signal)));
 					debugInfo("codingns4dsh: client terminal environment", {
 						sessionId: this.sessionId,
 						workspaceId: environment.workspaceId,
@@ -62837,7 +65432,7 @@ window.__ModuleLoader__.load({
 							createWhenMissing = createWhenMissing && !binding.existing;
 						}
 					}
-					const listed = unwrap(await remote.list(this.sessionId));
+					const listed = unwrap(await this.request(remote.list(this.sessionId)));
 					debugInfo("codingns4dsh: client terminal list", {
 						sessionId: this.sessionId,
 						workspaceId: environment.workspaceId,
@@ -62851,12 +65446,12 @@ window.__ModuleLoader__.load({
 							phase: "creating",
 							environment
 						});
-						info = unwrap(await remote.create(this.sessionId, {
+						info = unwrap(await this.request(remote.create(this.sessionId, {
 							id: this.id,
 							...this.shellPath === void 0 ? {} : { shellPath: this.shellPath },
 							cols: Math.min(80, environment.maxCols),
 							rows: Math.min(24, environment.maxRows)
-						}, this.lifetime.signal));
+						}, this.lifetime.signal)));
 						debugInfo("codingns4dsh: client terminal created", {
 							sessionId: this.sessionId,
 							workspaceId: environment.workspaceId,
@@ -62869,13 +65464,42 @@ window.__ModuleLoader__.load({
 						info,
 						title: info.title
 					});
-					if (this.mounted > 0) this.connect();
+					this.finishLoad();
 				} catch (error) {
 					if (!this.lifetime.signal.aborted) this.fail(error);
 				}
 			}
+			/**
+			* 加载阶段的 Host 请求等待上限。
+			*
+			* 页面被浏览器冻结（切到后台）期间发出的请求可能永远不会返回；没有上限时
+			* 视图会永久停在“正在读取终端环境”，用户点重试也只会复用同一个挂起 Promise。
+			*/
+			request(task) {
+				return withLoadTimeout(task, TERMINAL_LOAD_TIMEOUT_MS, this.t("terminalView.loadTimeout"));
+			}
+			/**
+			* 加载完成后的状态收敛。
+			*
+			* 可见时建立或复用 follow；不可见且没有保活连接时不能停在 loading，否则
+			* 切回会话的瞬间会先渲染成“正在读取终端环境”。
+			*/
+			finishLoad() {
+				if (this.mounted > 0) {
+					this.connect();
+					return;
+				}
+				if (this.followController === void 0 && this.store.getSnapshot().phase === "loading") this.patch({
+					phase: "disconnected",
+					writable: false
+				});
+			}
 			connect() {
-				if (this.followController !== void 0 || this.lifetime.signal.aborted || this.mounted === 0) return;
+				if (this.followController !== void 0) {
+					this.resumeFollow();
+					return;
+				}
+				if (this.lifetime.signal.aborted || this.mounted === 0) return;
 				this.clearReconnect();
 				const controller = new AbortController();
 				this.followController = controller;
@@ -62887,6 +65511,41 @@ window.__ModuleLoader__.load({
 				});
 				this.consume(controller.signal);
 			}
+			/**
+			* 复用仍然活跃的 follow 连接，并恢复可见状态。
+			*
+			* 聚合视图在后台保活期间连接不会释放，重新可见只是显示层切换，不需要重新
+			* 读取环境或库存；把它降级成 loading 会让终端变成只读，且只能等下一次
+			* 输出帧才能恢复。
+			*
+			* @returns 是否复用了已有连接；false 表示必须重新加载。
+			*/
+			resumeFollow() {
+				const controller = this.followController;
+				if (controller === void 0 || controller.signal.aborted) return false;
+				const state = this.store.getSnapshot();
+				if (state.phase === "closed" || state.phase === "failed") return false;
+				this.clearReconnect();
+				if (state.render !== void 0) {
+					if (state.phase !== "connected" || !state.writable) this.patch({
+						phase: "connected",
+						writable: true
+					});
+				} else if (state.phase !== "connecting") this.patch({
+					phase: "connecting",
+					writable: false
+				});
+				return true;
+			}
+			/** 只释放 follow 连接与附件，不改变对外状态；detach、重建和强制刷新共用。 */
+			releaseFollow() {
+				this.pendingRender?.resolve();
+				this.pendingRender = void 0;
+				this.followController?.abort(/* @__PURE__ */ new Error("终端视图重新连接"));
+				this.followController = void 0;
+				this.attachmentId = void 0;
+				this.lastResize = void 0;
+			}
 			async consume(signal) {
 				try {
 					const attachmentId = this.attachmentId;
@@ -62934,6 +65593,7 @@ window.__ModuleLoader__.load({
 					revision: this.revision,
 					resolve: resolveWaiting
 				};
+				const recoveredControl = this.store.getSnapshot().error?.includes("当前 attach 没有终端输入控制权") === true;
 				this.patch({
 					phase: "connected",
 					writable: true,
@@ -62942,16 +65602,12 @@ window.__ModuleLoader__.load({
 						frame
 					}
 				});
+				if (recoveredControl) this.clearError();
 				await waiting;
 			}
 			detach() {
 				this.clearReconnect();
-				this.pendingRender?.resolve();
-				this.pendingRender = void 0;
-				this.followController?.abort(/* @__PURE__ */ new Error("终端视图已 detach"));
-				this.followController = void 0;
-				this.attachmentId = void 0;
-				this.lastResize = void 0;
+				this.releaseFollow();
 				if (!this.lifetime.signal.aborted && this.store.getSnapshot().phase !== "closed") {
 					const { render: _render, ...state } = this.store.getSnapshot();
 					this.store.set({
@@ -63017,6 +65673,10 @@ window.__ModuleLoader__.load({
 					...patch
 				});
 			}
+			clearError() {
+				const { error: _error, ...state } = this.store.getSnapshot();
+				this.store.set(state);
+			}
 			fail(error) {
 				this.patch({
 					phase: "failed",
@@ -63360,6 +66020,37 @@ window.__ModuleLoader__.load({
 				}
 			}
 		};
+		/** 加载阶段单次 Host 请求的等待上限；超过后按失败处理，用户可以显式重试。 */
+		const TERMINAL_LOAD_TIMEOUT_MS = 2e4;
+		/**
+		* 给加载阶段的请求加等待上限。
+		*
+		* 页面被浏览器冻结（切到后台）期间发出的请求可能永远不会返回；没有上限时
+		* 视图会永久停在“正在读取终端环境”，重试也只会复用同一个挂起的 Promise。
+		* 底层请求不保证可取消，因此这里只结束等待，并先给原请求挂上拒绝处理器，
+		* 避免它稍后失败时产生 unhandled rejection。
+		*/
+		async function withLoadTimeout(task, timeoutMs, message) {
+			const guarded = task.then((value) => ({
+				state: "value",
+				value
+			}), (error) => ({
+				state: "error",
+				error
+			}));
+			let timer;
+			const expired = new Promise((resolve) => {
+				timer = setTimeout(() => resolve({ state: "timeout" }), timeoutMs);
+			});
+			try {
+				const outcome = await Promise.race([guarded, expired]);
+				if (outcome.state === "value") return outcome.value;
+				if (outcome.state === "error") throw outcome.error;
+				throw new Error(message);
+			} finally {
+				if (timer !== void 0) clearTimeout(timer);
+			}
+		}
 		function unwrap(result) {
 			if (typeof result !== "object" || result === null || !("ok" in result)) throw new Error("终端服务返回了无效响应");
 			if (result.ok) return result.value;
@@ -63670,8 +66361,16 @@ window.__ModuleLoader__.load({
 			titleInput: "codingns4dsh-terminal-title-input",
 			root: "codingns4dsh-terminal-root",
 			aggregateRoot: "codingns4dsh-terminal-aggregate-root",
+			listDock: "codingns4dsh-terminal-list-dock",
 			list: "codingns4dsh-terminal-list",
+			listTabs: "codingns4dsh-terminal-list-tabs",
+			listActions: "codingns4dsh-terminal-list-actions",
 			newButton: "codingns4dsh-terminal-new-button",
+			refreshButton: "codingns4dsh-terminal-refresh-button",
+			toolsButton: "codingns4dsh-terminal-tools-button",
+			toolsPanel: "codingns4dsh-terminal-tools-panel",
+			toolAction: "codingns4dsh-terminal-tool-action",
+			toolModifierActive: "codingns4dsh-terminal-tool-modifier-active",
 			listRow: "codingns4dsh-terminal-list-row",
 			listRowSelected: "codingns4dsh-terminal-list-row-selected",
 			listSelect: "codingns4dsh-terminal-list-select",
@@ -63709,8 +66408,20 @@ window.__ModuleLoader__.load({
 .${terminalClass.titleInput}{width:120px;min-width:48px;max-width:100%;color:inherit;font:inherit;background:var(--dsw-alias-bg-l1);border:.5px solid var(--dsw-alias-border-l3);border-radius:4px;outline:none;padding:0 4px}
 .${terminalClass.root}{box-sizing:border-box;width:0;height:100%;min-width:0;min-height:0;color:var(--dsw-alias-label-primary);flex-direction:column;flex:1 1 auto;padding-top:8px;font-size:13px;display:flex;overflow:hidden}
 .${terminalClass.aggregateRoot}{box-sizing:border-box;width:100%;height:100%;min-width:0;min-height:0;display:flex;flex-direction:column;flex:1 1 auto;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);overflow:hidden}
-.${terminalClass.list}{box-sizing:border-box;width:100%;height:40px;min-width:0;min-height:40px;display:flex;align-items:center;gap:2px;padding:3px 8px;background:var(--dsw-alias-bg-layer-1);border-bottom:.5px solid var(--dsw-alias-border-l3);overflow-x:auto;overflow-y:hidden;flex:none}
+.${terminalClass.listDock}{box-sizing:border-box;width:100%;min-width:0;flex:none;background:var(--dsw-alias-bg-layer-1);border-bottom:.5px solid var(--dsw-alias-border-l3)}
+.${terminalClass.list}{box-sizing:border-box;width:100%;height:40px;min-width:0;min-height:40px;display:flex;align-items:center;gap:2px;padding:3px 8px;background:inherit;overflow-x:auto;overflow-y:hidden;flex:none}
+.${terminalClass.listTabs}{box-sizing:border-box;min-width:0;height:34px;display:flex;align-items:center;gap:2px;flex:1 1 auto;overflow-x:auto;overflow-y:hidden;scrollbar-width:none}
+.${terminalClass.listTabs}::-webkit-scrollbar{display:none}
+.${terminalClass.listActions}{box-sizing:border-box;display:flex;align-items:center;gap:2px;flex:none;margin-left:4px;padding-left:4px;border-left:.5px solid var(--dsw-alias-border-l3);background:inherit}
 .${terminalClass.newButton}{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;flex:none;align-self:center;width:30px;min-width:30px;height:30px;min-height:30px;max-height:30px;margin:0 0 0 4px;padding:0;white-space:nowrap}
+.${terminalClass.refreshButton},.${terminalClass.toolsButton}{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;flex:none;width:30px;min-width:30px;height:30px;min-height:30px;max-height:30px;margin:0;padding:0;color:var(--dsw-alias-label-secondary)}
+.${terminalClass.refreshButton}:hover, .${terminalClass.toolsButton}:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}
+.${terminalClass.toolsButton}[aria-expanded="true"]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}
+.${terminalClass.toolsPanel}{box-sizing:border-box;width:100%;min-width:0;display:flex;align-items:center;gap:4px;padding:4px 8px 6px;border-top:.5px solid var(--dsw-alias-border-l3);overflow-x:auto;overflow-y:hidden;scrollbar-width:thin;overscroll-behavior:contain}
+.${terminalClass.toolsPanel}::-webkit-scrollbar{height:5px}
+.${terminalClass.toolsPanel}::-webkit-scrollbar-thumb{background:var(--dsw-alias-label-tertiary,#777);border-radius:3px}
+.${terminalClass.toolAction}{box-sizing:border-box;display:inline-flex;align-items:center;justify-content:center;flex:none;width:38px;min-width:38px;height:28px;min-height:28px;padding:0!important;border-radius:var(--dsw-radius-sm,6px)}
+.${terminalClass.toolAction}[aria-pressed="true"],.${terminalClass.toolModifierActive}{background:var(--dsw-alias-button-ghost-active-fill,var(--dsw-alias-interactive-bg-active));box-shadow:inset 0 0 0 .5px var(--dsw-alias-button-ghost-active-border,var(--dsw-alias-border-l3))}
 .${terminalClass.listRow}{box-sizing:border-box;display:flex;align-items:center;height:28px;min-width:110px;max-width:220px;border-radius:var(--dsw-radius-sm,6px);background:transparent;flex:none}
 .${terminalClass.listRowSelected}{background:var(--dsw-alias-interactive-bg-hover);box-shadow:var(--dsw-elevation-soft,0 1px 2px rgba(0,0,0,.08))}
 .${terminalClass.listSelect}{box-sizing:border-box;min-width:0;height:28px;min-height:28px;flex:1;text-align:left;color:inherit;border:0;background:transparent;cursor:pointer;padding:0 8px;display:flex;align-items:center;gap:5px;font:inherit;line-height:20px}
@@ -63721,12 +66432,13 @@ window.__ModuleLoader__.load({
 .${terminalClass.listClose}:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}
 .${terminalClass.content}{box-sizing:border-box;width:100%;min-width:0;min-height:0;display:flex;flex:1 1 auto;overflow:hidden}
 .${terminalClass.empty}{display:flex;flex:1;min-height:0;align-items:center;justify-content:center;flex-direction:column;gap:10px;color:var(--dsw-alias-label-secondary);text-align:center;padding:24px}
-.${terminalClass.screen}{box-sizing:border-box;width:100%;min-width:0;min-height:0;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);flex:1 1 auto;padding:8px;overflow:hidden}
+.${terminalClass.screen}{box-sizing:border-box;width:100%;min-width:0;min-height:0;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);flex:1 1 auto;padding:0;overflow:hidden}
 .${terminalClass.status}{background:var(--dsw-alias-bg-l2);flex-wrap:wrap;align-items:center;gap:8px;padding:5px 12px;display:flex}
 .${terminalClass.error}{overflow-wrap:anywhere;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-l2);margin:0;padding:10px 12px}
 .${terminalClass.cleanupStack}{pointer-events:auto;gap:8px;max-width:min(440px,calc(100vw - 40px));display:grid;position:fixed;bottom:20px;right:20px}
 .${terminalClass.cleanupNotice}{border:.5px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-l1);overflow-wrap:anywhere;border-radius:8px;align-items:center;gap:12px;padding:12px 16px;font-size:13px;display:flex;box-shadow:0 4px 20px #0002}
 .${terminalClass.cleanupNotice} button{border:.5px solid var(--dsw-alias-border-l3);color:inherit;cursor:pointer;background:transparent;border-radius:4px;flex-shrink:0;padding:4px 8px}
+@media (max-width:640px){.${terminalClass.list}{padding-left:6px;padding-right:6px}.${terminalClass.listActions}{margin-left:2px;padding-left:2px}.${terminalClass.toolsPanel}{padding-left:6px;padding-right:6px}}
 `;
 		//#endregion
 		//#region node_modules/.pnpm/@xterm+addon-fit@0.11.0/node_modules/@xterm/addon-fit/lib/addon-fit.js
@@ -76779,6 +79491,12 @@ window.__ModuleLoader__.load({
 		const TERMINAL_TOUCH_MOMENTUM_MAX_DURATION_MS = 3600;
 		const TERMINAL_TOUCH_MOMENTUM_MAX_IDLE_FRAMES = 3;
 		const TERMINAL_TOUCH_MOMENTUM_RELEASE_IDLE_MS = 100;
+		/** 视图夺回终端尺寸的最小间隔，避免可见性抖动时反复重发。 */
+		const TERMINAL_SIZE_CLAIM_INTERVAL_MS = 1e3;
+		/** 终端文本与可视容器边缘之间至少保留 5px 的安全距离。 */
+		const TERMINAL_CONTENT_EDGE_GAP = 5;
+		/** 终端滚动条停止滚动后的自动隐藏延迟。 */
+		const TERMINAL_SCROLLBAR_HIDE_DELAY_MS = 3e3;
 		/** 使用与 DSH 内置终端相同的布局、状态条和 xterm 默认参数。 */
 		function CodingNsXtermView({ view, settings, themeRevision, onNewTerminal, active = true, visible = true, t: injectedTranslator }) {
 			const t = injectedTranslator ?? resolveCodingNsTranslator();
@@ -76787,6 +79505,8 @@ window.__ModuleLoader__.load({
 			const fitRef = (0, react.useRef)(null);
 			const scheduleReflowRef = (0, react.useRef)(null);
 			const lastRevision = (0, react.useRef)(0);
+			const sizeClaimAtRef = (0, react.useRef)(0);
+			const previousActiveRef = (0, react.useRef)(active);
 			const state = (0, react.useSyncExternalStore)(view.state.subscribe.bind(view.state), view.state.getSnapshot.bind(view.state));
 			const appearance = (0, react.useSyncExternalStore)(settings.subscribe.bind(settings), settings.getSnapshot.bind(settings)).value?.terminalEnhancement.appearance ?? DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS.appearance;
 			const hasTerminal = state.info !== void 0;
@@ -76944,11 +79664,34 @@ window.__ModuleLoader__.load({
 				};
 				const xtermRoot = terminal.element;
 				if (xtermRoot === void 0) return;
-				const scrollTarget = xtermRoot?.querySelector(".xterm-viewport") ?? xtermRoot ?? container;
+				const scrollTarget = xtermRoot?.querySelector(".xterm-scrollable-element") ?? xtermRoot ?? container;
 				const interactionTarget = xtermRoot ?? container;
-				const syncScrollbar = () => {
+				let scrollbarHideTimer;
+				let lastViewportY = terminal.buffer.active.viewportY;
+				const hideScrollbar = () => {
+					if (scrollbarHideTimer !== void 0) {
+						window.clearTimeout(scrollbarHideTimer);
+						scrollbarHideTimer = void 0;
+					}
+					xtermRoot.dataset.codingnsScrollbar = "hidden";
+				};
+				const revealScrollbar = () => {
+					if (terminal.buffer.active.baseY <= 0) {
+						hideScrollbar();
+						return;
+					}
+					xtermRoot.dataset.codingnsScrollbar = "visible";
+					if (scrollbarHideTimer !== void 0) window.clearTimeout(scrollbarHideTimer);
+					scrollbarHideTimer = window.setTimeout(() => {
+						scrollbarHideTimer = void 0;
+						xtermRoot.dataset.codingnsScrollbar = "hidden";
+					}, TERMINAL_SCROLLBAR_HIDE_DELAY_MS);
+				};
+				const syncScrollbarState = () => {
 					const hasScrollback = terminal.buffer.active.baseY > 0;
 					xtermRoot.dataset.codingnsScrollback = hasScrollback ? "true" : "false";
+					if (!hasScrollback) hideScrollbar();
+					else if (xtermRoot.dataset.codingnsScrollbar === void 0) xtermRoot.dataset.codingnsScrollbar = "hidden";
 					debugInfo("codingns4dsh: client terminal scrollbar state", {
 						terminalId: view.id,
 						hasScrollback,
@@ -76956,7 +79699,7 @@ window.__ModuleLoader__.load({
 						viewportY: terminal.buffer.active.viewportY
 					});
 				};
-				syncScrollbar();
+				syncScrollbarState();
 				scrollTarget.style.touchAction = "pan-y";
 				scrollTarget.style.overscrollBehavior = "contain";
 				if ("webkitOverflowScrolling" in scrollTarget.style) scrollTarget.style.webkitOverflowScrolling = "touch";
@@ -76965,7 +79708,10 @@ window.__ModuleLoader__.load({
 				interactionTarget.addEventListener("touchend", touchEnd, { passive: true });
 				interactionTarget.addEventListener("touchcancel", touchCancel, { passive: true });
 				const scroll = terminal.onScroll((viewportY) => {
-					syncScrollbar();
+					const didScroll = viewportY !== lastViewportY;
+					lastViewportY = viewportY;
+					syncScrollbarState();
+					if (didScroll) revealScrollbar();
 					debugInfo("codingns4dsh: client terminal viewport scroll", {
 						terminalId: view.id,
 						viewportY,
@@ -76977,9 +79723,10 @@ window.__ModuleLoader__.load({
 					if (!preserveHostTitle) view.rename(value);
 				});
 				const measure = () => {
+					syncTerminalViewport(host);
 					if (host.clientWidth === 0 || host.clientHeight === 0) return;
 					fitTerminal(terminal, fit, view);
-					syncScrollbar();
+					syncScrollbarState();
 				};
 				let measureFrame;
 				const scheduleMeasure = () => {
@@ -77009,17 +79756,20 @@ window.__ModuleLoader__.load({
 				resize.observe(host);
 				resize.observe(container);
 				const visualViewport = window.visualViewport;
-				const handleViewportResize = () => schedulePostAttachReflow();
-				visualViewport?.addEventListener("resize", handleViewportResize);
-				window.addEventListener("resize", handleViewportResize);
+				const handleViewportChange = () => schedulePostAttachReflow();
+				visualViewport?.addEventListener("resize", handleViewportChange);
+				visualViewport?.addEventListener("scroll", handleViewportChange);
+				window.addEventListener("resize", handleViewportChange);
 				schedulePostAttachReflow();
 				return () => {
 					resize.disconnect();
-					visualViewport?.removeEventListener("resize", handleViewportResize);
-					window.removeEventListener("resize", handleViewportResize);
+					visualViewport?.removeEventListener("resize", handleViewportChange);
+					visualViewport?.removeEventListener("scroll", handleViewportChange);
+					window.removeEventListener("resize", handleViewportChange);
 					if (measureFrame !== void 0) window.cancelAnimationFrame(measureFrame);
 					if (reflowFrame !== void 0) window.cancelAnimationFrame(reflowFrame);
 					if (reflowTimer !== void 0) window.clearTimeout(reflowTimer);
+					if (scrollbarHideTimer !== void 0) window.clearTimeout(scrollbarHideTimer);
 					scheduleReflowRef.current = null;
 					input.dispose();
 					scroll.dispose();
@@ -77032,17 +79782,24 @@ window.__ModuleLoader__.load({
 					terminal.dispose();
 					terminalRef.current = null;
 					fitRef.current = null;
+					host.style.height = "100%";
 					root.replaceChildren();
 				};
 			}, [hasTerminal, view]);
 			(0, react.useEffect)(() => {
+				const becameActive = active && !previousActiveRef.current;
+				previousActiveRef.current = active;
 				const terminal = terminalRef.current;
 				const host = hostRef.current;
 				if (terminal === null || host === null) return;
 				applyAppearance(terminal, appearance, host, state.environment?.scrollback ?? 1e3);
 				terminal.options.disableStdin = !state.writable;
+				if (active) syncTerminalViewport(host);
 				if (state.writable && host.clientWidth > 0 && host.clientHeight > 0) {
-					fitTerminal(terminal, fitRef.current, view);
+					const now = Date.now();
+					const claim = becameActive && now - sizeClaimAtRef.current >= TERMINAL_SIZE_CLAIM_INTERVAL_MS;
+					if (claim) sizeClaimAtRef.current = now;
+					fitTerminal(terminal, fitRef.current, view, claim ? { force: true } : void 0);
 					terminal.focus();
 				} else if (state.info !== void 0) terminal.resize(state.info.cols, state.info.rows);
 			}, [
@@ -77055,6 +79812,26 @@ window.__ModuleLoader__.load({
 				themeRevision,
 				view
 			]);
+			(0, react.useEffect)(() => {
+				if (!active || !hasTerminal) return;
+				const onVisibilityChange = () => {
+					if (document.visibilityState !== "visible") return;
+					const terminal = terminalRef.current;
+					const host = hostRef.current;
+					if (terminal === null || host === null) return;
+					if (host.clientWidth === 0 || host.clientHeight === 0) return;
+					const now = Date.now();
+					if (now - sizeClaimAtRef.current < TERMINAL_SIZE_CLAIM_INTERVAL_MS) return;
+					sizeClaimAtRef.current = now;
+					fitTerminal(terminal, fitRef.current, view, { force: true });
+				};
+				document.addEventListener("visibilitychange", onVisibilityChange);
+				return () => document.removeEventListener("visibilitychange", onVisibilityChange);
+			}, [
+				active,
+				hasTerminal,
+				view
+			]);
 			(0, react.useEffect)(() => {
 				const terminal = terminalRef.current;
 				const host = hostRef.current;
@@ -77072,8 +79849,12 @@ window.__ModuleLoader__.load({
 						fitTerminal(terminal, fitRef.current, view);
 						scheduleReflowRef.current?.();
 					}
-					if (terminal.element !== void 0) terminal.element.dataset.codingnsScrollback = terminal.buffer.active.baseY > 0 ? "true" : "false";
-					const viewport = terminal.element?.querySelector(".xterm-viewport");
+					if (terminal.element !== void 0) {
+						const hasScrollback = terminal.buffer.active.baseY > 0;
+						terminal.element.dataset.codingnsScrollback = hasScrollback ? "true" : "false";
+						if (!hasScrollback) terminal.element.dataset.codingnsScrollbar = "hidden";
+					}
+					const viewport = terminal.element?.querySelector(".xterm-scrollable-element");
 					debugInfo("codingns4dsh: client terminal frame rendered", {
 						terminalId: view.id,
 						frameType: render.frame.type,
@@ -77121,7 +79902,7 @@ window.__ModuleLoader__.load({
 				variant: "outline",
 				size: "sm",
 				onClick: () => {
-					view.refresh();
+					view.refresh({ force: true });
 				}
 			}, state.phase === "disconnected" ? t("terminalView.reconnect") : t("terminal.retry")) : null, lost ? (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 				variant: "outline",
@@ -77189,31 +79970,80 @@ window.__ModuleLoader__.load({
 				selectionInactiveBackground: foreground
 			};
 		}
-		function fitTerminal(terminal, fit, view) {
+		function fitTerminal(terminal, fit, view, options) {
 			if (fit === null) return;
 			const dimensions = resolveTerminalDimensions(terminal, fit);
 			if (dimensions === void 0) return;
 			if (terminal.cols !== dimensions.cols || terminal.rows !== dimensions.rows) terminal.resize(dimensions.cols, dimensions.rows);
-			view.resize(terminal.cols, terminal.rows);
+			view.resize(terminal.cols, terminal.rows, options);
+		}
+		/**
+		* 让终端宿主节点的底边停在当前可视视口之内。
+		*
+		* 移动端软键盘出现时，布局视口通常仍保持原高度，只有 `visualViewport.height`
+		* 变小。只调用 FitAddon 不够，因为它读取到的父节点高度没有变化；这里按屏幕
+		* 实际可见底边收缩宿主，键盘收起后再恢复 `100%`。
+		*/
+		function syncTerminalViewport(host) {
+			const screen = host.parentElement;
+			if (screen === null) return;
+			const hostRect = host.getBoundingClientRect();
+			const screenRect = screen.getBoundingClientRect();
+			if (screenRect.width <= 0 || screenRect.height <= 0 || hostRect.width <= 0) return;
+			const screenStyle = getComputedStyle(screen);
+			const contentBottom = screenRect.bottom - parseCssPixels(screenStyle.paddingBottom) - parseCssPixels(screenStyle.borderBottomWidth);
+			const viewportHeight = window.visualViewport?.height ?? window.innerHeight;
+			if (!Number.isFinite(contentBottom) || !Number.isFinite(viewportHeight) || viewportHeight <= 0) return;
+			const visibleBottom = Math.min(contentBottom, viewportHeight);
+			const normalHeight = Math.max(1, Math.floor(contentBottom - hostRect.top));
+			if (visibleBottom >= contentBottom - 1) {
+				if (host.style.height !== "100%") host.style.height = "100%";
+				return;
+			}
+			const visibleHeight = Math.max(1, Math.floor(visibleBottom - hostRect.top - 1));
+			const nextHeight = `${Math.min(normalHeight, visibleHeight)}px`;
+			if (host.style.height !== nextHeight) host.style.height = nextHeight;
 		}
 		function resolveTerminalDimensions(terminal, fit) {
 			const fallback = fit.proposeDimensions();
 			const root = terminal.element;
 			if (root === void 0 || root.clientWidth <= 0 || root.clientHeight <= 0) return fallback;
-			const measure = root.querySelector(".xterm-char-measure-element");
-			const row = root.querySelector(".xterm-rows > div");
-			const measureWidth = measure?.getBoundingClientRect().width ?? 0;
-			const cellWidth = measureWidth > 0 ? measureWidth / 32 : 0;
-			const cellHeight = row?.getBoundingClientRect().height ?? 0;
+			const cell = resolveRendererCell(terminal);
+			if (cell === void 0) return fallback === void 0 ? void 0 : {
+				...fallback,
+				cols: Math.max(2, fallback.cols - 1)
+			};
+			const HOST_PADDING_LEFT = 8;
+			const HOST_PADDING_RIGHT = 8;
 			const computed = getComputedStyle(root);
-			const paddingX = parseCssPixels(computed.paddingLeft) + parseCssPixels(computed.paddingRight);
 			const paddingY = parseCssPixels(computed.paddingTop) + parseCssPixels(computed.paddingBottom);
-			const width = root.clientWidth - paddingX - (terminal.options.scrollback === 0 ? 0 : 14);
+			const rootRect = root.getBoundingClientRect();
+			const scrollable = root.querySelector(".xterm-scrollable-element");
+			const scrollbarRect = (terminal.options.scrollback === 0 ? void 0 : scrollable?.querySelector(".scrollbar.vertical"))?.getBoundingClientRect();
+			scrollable?.getBoundingClientRect();
+			const scrollbarInset = scrollbarRect !== void 0 && scrollbarRect.width > 0 ? Math.max(0, rootRect.right - scrollbarRect.left) : 0;
+			const safeEdgeGap = Math.max(0, TERMINAL_CONTENT_EDGE_GAP - scrollbarInset);
+			const width = rootRect.width - HOST_PADDING_LEFT - HOST_PADDING_RIGHT - scrollbarInset - safeEdgeGap;
 			const height = root.clientHeight - paddingY;
-			if (cellWidth <= 0 || cellHeight <= 0 || width <= 0 || height <= 0) return fallback;
+			if (width <= 0 || height <= 0) return fallback;
+			return {
+				cols: Math.max(2, Math.floor(width / cell.width)),
+				rows: Math.max(1, Math.floor(height / cell.height))
+			};
+		}
+		/**
+		* 读取 xterm 渲染服务的单元格尺寸。`.xterm-char-measure-element` 会被 DOM renderer
+		* 的宽度缓存复用，其文本内容会随最近一次测量的字符变化（例如中文全角字符）。
+		* 用它除以 32 推算列宽会把列数按该字符宽度计算，宽字符时列数近乎减半，表现为
+		* 文本提前换行、右侧留出大片空白。这里改用官方 FitAddon 依赖的 renderService
+		* cell 尺寸（CharSizeService 固定按 32 个 'W' 测量），列宽不再受终端内容影响。
+		*/
+		function resolveRendererCell(terminal) {
+			const cell = (terminal._core?._renderService?.dimensions)?.css?.cell;
+			if (cell === void 0 || !(cell.width > 0) || !(cell.height > 0)) return void 0;
 			return {
-				cols: Math.max(2, Math.floor(width / cellWidth)),
-				rows: Math.max(1, Math.floor(height / cellHeight))
+				width: cell.width,
+				height: cell.height
 			};
 		}
 		function parseCssPixels(value) {
@@ -77239,28 +80069,37 @@ window.__ModuleLoader__.load({
 			return normalized === "" || normalized === "rgba(0, 0, 0, 0)" ? fallback : normalized;
 		}
 		const terminalHostStyle = {
+			boxSizing: "border-box",
 			width: "100%",
 			height: "100%",
 			minWidth: 0,
 			minHeight: 0,
+			paddingLeft: 8,
+			paddingRight: 8,
 			color: "var(--dsw-alias-label-primary)",
 			background: "var(--dsw-alias-bg-base)"
 		};
 		const shadowCss = `${_codingns4dsh_xterm_css_default}
 :host{display:block;width:100%;height:100%;min-width:0;min-height:0;color:inherit;background:inherit}
-.codingns-xterm{width:100%;height:100%;min-width:0;min-height:0;overflow:hidden;touch-action:pan-y;overscroll-behavior:contain;-webkit-overflow-scrolling:touch}
-.xterm{width:100%;height:100%;min-width:0;min-height:0}
-.xterm-scrollable-element{min-width:0;max-width:100%}
-.xterm-viewport{background:var(--dsw-alias-bg-base);touch-action:pan-y;overscroll-behavior:contain;-webkit-overflow-scrolling:touch;overflow-y:scroll;scrollbar-gutter:stable;scrollbar-width:auto;scrollbar-color:var(--dsw-alias-label-tertiary,#777) transparent}
-.xterm-viewport::-webkit-scrollbar{width:10px}
-.xterm-viewport::-webkit-scrollbar-track{background:transparent}
-.xterm-viewport::-webkit-scrollbar-thumb{background:var(--dsw-alias-label-tertiary,#777);border-radius:5px}
-.xterm-viewport::-webkit-scrollbar-thumb:hover{background:var(--dsw-alias-label-secondary,#aaa)}
-.xterm .xterm-scrollable-element>.scrollbar.vertical{width:14px!important;pointer-events:auto!important}
-.xterm[data-codingns-scrollback="false"] .xterm-scrollable-element>.scrollbar.vertical{opacity:0!important;pointer-events:none!important}
-.xterm[data-codingns-scrollback="true"] .xterm-scrollable-element>.scrollbar.vertical{opacity:1!important;pointer-events:auto!important;background:rgba(128,128,128,.22)}
-.xterm[data-codingns-scrollback="true"] .xterm-scrollable-element>.scrollbar.vertical>.slider{background:var(--dsw-alias-label-secondary,#aaa)!important;border-radius:7px;min-height:24px}
+.codingns-xterm{box-sizing:border-box;width:100%;height:100%;min-width:0;min-height:0;overflow:hidden;touch-action:pan-y;overscroll-behavior:contain;-webkit-overflow-scrolling:touch}
+.xterm{box-sizing:border-box;width:100%;height:100%;min-width:0;min-height:0}
+.xterm-scrollable-element{box-sizing:border-box;width:100%;min-width:0;max-width:100%}
+/* xterm 6 已由 xterm-scrollable-element 接管滚动；隐藏兼容 viewport，避免产生第二个滚动条槽位。 */
+.xterm-viewport{background:var(--dsw-alias-bg-base);touch-action:pan-y;overscroll-behavior:contain;-webkit-overflow-scrolling:touch;overflow:hidden;scrollbar-gutter:stable;scrollbar-width:none}
+.xterm-viewport::-webkit-scrollbar{display:none}
+.xterm-viewport::-webkit-scrollbar-track{display:none}
+.xterm-viewport::-webkit-scrollbar-thumb{display:none}
+.xterm-viewport::-webkit-scrollbar-thumb:hover{display:none}
+.xterm .xterm-scrollable-element>.scrollbar.vertical{width:6px!important;right:2px!important;pointer-events:none!important;opacity:0!important;background:transparent!important;transition:opacity 180ms ease!important}
+.xterm[data-codingns-scrollbar="visible"] .xterm-scrollable-element>.scrollbar.vertical{opacity:.7!important;pointer-events:auto!important}
+.xterm .xterm-scrollable-element>.scrollbar.vertical>.slider{width:6px!important;left:0!important;min-height:24px;border-radius:999px;background:rgba(170,178,190,.72)!important;box-shadow:0 1px 4px rgba(0,0,0,.28);transition:background-color 180ms ease,box-shadow 180ms ease!important}
+.xterm[data-codingns-scrollbar="visible"] .xterm-scrollable-element>.scrollbar.vertical>.slider:hover{background:rgba(224,229,237,.9)!important;box-shadow:0 1px 6px rgba(0,0,0,.4)}
 .xterm .xterm-scrollable-element>.scrollbar.horizontal{display:none!important}
+/* xterm 的字宽缓存会把单个字符重复 32 次测量宽度，Chrome 对连续的全角标点默认做
+   标点压缩（「。」从 13px 压到 6.72px），导致 letter-spacing 在每处标点被多补约
+   6.3px，行内标点密集时渲染内容向右累积溢出网格宽度，行尾一两个字被裁剪。
+   space-all 关闭标点压缩，让字宽测量与单字实际渲染一致，全角标点按两格渲染。 */
+.xterm-width-cache-measure-container,.xterm-rows{text-spacing-trim:space-all}
 `;
 		//#endregion
 		//#region src/client/terminal/ui.ts
@@ -77354,8 +80193,12 @@ window.__ModuleLoader__.load({
 			const [loading, setLoading] = (0, react.useState)(true);
 			const [creating, setCreating] = (0, react.useState)(false);
 			const [createError, setCreateError] = (0, react.useState)();
+			const [refreshing, setRefreshing] = (0, react.useState)(false);
+			const [toolsOpen, setToolsOpen] = (0, react.useState)(false);
+			const [heldModifiers, setHeldModifiers] = (0, react.useState)(EMPTY_HELD_MODIFIERS);
 			/** React 状态更新前可能收到连续点击；用同步锁保证只发出一个 create 请求。 */
 			const creatingRef = (0, react.useRef)(false);
+			const refreshingRef = (0, react.useRef)(false);
 			const autoCreatedFor = (0, react.useRef)(void 0);
 			const reloadSequence = (0, react.useRef)(0);
 			const reload = (0, react.useCallback)(async () => {
@@ -77427,10 +80270,32 @@ window.__ModuleLoader__.load({
 				terminals.length
 			]);
 			const activeId = terminals.find((item) => item.id === selectedId)?.id ?? terminals[0]?.id;
-			const navigation = (0, react.createElement)("nav", {
+			const activeView = activeId === void 0 ? void 0 : webTerminals.viewForTerminal(String(sessionId), activeId, terminals.find((item) => item.id === activeId)?.shell.path);
+			const activePlatform = (0, react.useSyncExternalStore)(activeView?.state.subscribe.bind(activeView.state) ?? noSubscribe, () => activeView?.state.getSnapshot().environment?.platform, () => activeView?.state.getSnapshot().environment?.platform);
+			const refreshTerminal = (0, react.useCallback)(async () => {
+				if (refreshingRef.current) return;
+				refreshingRef.current = true;
+				setRefreshing(true);
+				try {
+					await Promise.all([reload(), activeView?.refresh({ force: true })]);
+				} catch (cause) {
+					debugWarn("codingns4dsh: client terminal toolbar refresh failed", {
+						sessionId: String(sessionId),
+						error: messageOf(cause)
+					});
+				} finally {
+					refreshingRef.current = false;
+					setRefreshing(false);
+				}
+			}, [
+				activeView,
+				reload,
+				sessionId
+			]);
+			const navigation = (0, react.createElement)("div", { className: terminalClass.listDock }, (0, react.createElement)("nav", {
 				className: terminalClass.list,
 				"aria-label": t("terminal.title")
-			}, [...terminals.map((item) => (0, react.createElement)(TerminalListRow, {
+			}, (0, react.createElement)("div", { className: terminalClass.listTabs }, ...terminals.map((item) => (0, react.createElement)(TerminalListRow, {
 				key: item.id,
 				item,
 				selected: item.id === activeId,
@@ -77454,7 +80319,37 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					createNewTerminal();
 				}
-			})]);
+			})), (0, react.createElement)("div", { className: terminalClass.listActions }, (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				variant: "ghost",
+				size: "sm",
+				className: terminalClass.refreshButton,
+				icon: (0, react.createElement)(resolveRefreshIcon(), { size: 16 }),
+				"aria-label": t("terminal.refresh"),
+				title: t("terminal.refresh"),
+				disabled: refreshing,
+				onClick: () => {
+					refreshTerminal();
+				}
+			}), (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				variant: "ghost",
+				size: "sm",
+				className: terminalClass.toolsButton,
+				icon: (0, react.createElement)(resolveToolIcon(), { size: 16 }),
+				"aria-label": t("terminal.tools"),
+				title: t("terminal.tools"),
+				"aria-haspopup": "true",
+				"aria-expanded": toolsOpen,
+				onClick: () => setToolsOpen((value) => !value)
+			}))), toolsOpen ? (0, react.createElement)(TerminalToolsPanel, {
+				view: activeView,
+				platform: activePlatform,
+				heldModifiers,
+				onToggleModifier: (modifier) => setHeldModifiers((current) => ({
+					...current,
+					[modifier]: !current[modifier]
+				})),
+				t
+			}) : null);
 			const content = (0, react.createElement)("div", { className: terminalClass.content }, terminals.length === 0 ? (0, react.createElement)("div", {
 				role: "status",
 				className: terminalClass.empty
@@ -77478,6 +80373,88 @@ window.__ModuleLoader__.load({
 			})));
 			return (0, react.createElement)("div", { className: `${terminalClass.aggregateRoot} ${terminalClass.content}` }, navigation, content);
 		}
+		const EMPTY_HELD_MODIFIERS = {
+			ctrl: false,
+			alt: false,
+			win: false
+		};
+		function TerminalToolsPanel({ view, platform, heldModifiers, onToggleModifier, t }) {
+			const modifier = (kind, label) => (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				key: kind,
+				variant: "toolbar",
+				size: "sm",
+				className: `${terminalClass.toolAction} ${heldModifiers[kind] ? terminalClass.toolModifierActive : ""}`,
+				"aria-label": label,
+				title: label,
+				"aria-pressed": heldModifiers[kind],
+				disabled: view === void 0,
+				onClick: () => onToggleModifier(kind)
+			}, (0, react.createElement)(resolveShortcutKeys(), { keys: [terminalModifierKey(kind, platform)] }));
+			const command = (kind, label) => (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+				key: kind,
+				variant: "toolbar",
+				size: "sm",
+				className: terminalClass.toolAction,
+				"aria-label": label,
+				title: label,
+				disabled: view === void 0,
+				onClick: () => {
+					if (view !== void 0) view.write(terminalShortcutData(kind, heldModifiers));
+				}
+			}, terminalToolControl(kind));
+			return (0, react.createElement)("div", {
+				className: terminalClass.toolsPanel,
+				role: "toolbar",
+				"aria-label": t("terminal.tools")
+			}, modifier("ctrl", terminalModifierLabel("ctrl", platform, t)), modifier("alt", terminalModifierLabel("alt", platform, t)), modifier("win", terminalModifierLabel("win", platform, t)), command("tab", t("terminal.shortcutTab")), command("escape", t("terminal.shortcutEscape")), command("enter", t("terminal.shortcutEnter")), command("backspace", t("terminal.shortcutBackspace")), command("up", t("terminal.shortcutUp")), command("down", t("terminal.shortcutDown")), command("left", t("terminal.shortcutLeft")), command("right", t("terminal.shortcutRight")), command("c", t("terminal.shortcutC")), command("d", t("terminal.shortcutD")), command("l", t("terminal.shortcutL")), command("z", t("terminal.shortcutZ")));
+		}
+		function terminalModifierKey(modifier, platform) {
+			if (modifier === "alt" && platform === "darwin") return "Option";
+			if (modifier !== "win") return modifier === "ctrl" ? "Ctrl" : "Alt";
+			if (platform === "darwin") return "Cmd";
+			if (platform === "linux") return "Super";
+			return "Win";
+		}
+		function terminalModifierLabel(modifier, platform, t) {
+			if (modifier === "ctrl") return t("terminal.holdCtrl");
+			if (modifier === "alt" && platform === "darwin") return t("terminal.holdOption");
+			if (modifier === "win" && platform === "darwin") return t("terminal.holdCommand");
+			if (modifier === "win" && platform === "linux") return t("terminal.holdSuper");
+			if (modifier === "alt") return t("terminal.holdAlt");
+			return t("terminal.holdWin");
+		}
+		function terminalToolControl(command) {
+			if (command === "up" || command === "down" || command === "left" || command === "right") return (0, react.createElement)(resolveTerminalArrowIcon(command), { size: 16 });
+			return (0, react.createElement)(resolveShortcutKeys(), { keys: [{
+				tab: "Tab",
+				escape: "Esc",
+				enter: "Enter",
+				backspace: "⌫",
+				c: "C",
+				d: "D",
+				l: "L",
+				z: "Z"
+			}[command]] });
+		}
+		function terminalShortcutData(command, modifiers) {
+			let value = {
+				tab: "	",
+				escape: "\x1B",
+				enter: "\r",
+				backspace: "",
+				up: "\x1B[A",
+				down: "\x1B[B",
+				left: "\x1B[D",
+				right: "\x1B[C",
+				c: "c",
+				d: "d",
+				l: "l",
+				z: "z"
+			}[command];
+			if (modifiers.ctrl && /^[a-z]$/u.test(command)) value = String.fromCharCode(command.charCodeAt(0) - 96);
+			if (modifiers.alt || modifiers.win) value = `\x1b${value}`;
+			return value;
+		}
 		function TerminalTitle({ useTabInfo, locale }) {
 			const t = useCodingNsTranslator(locale);
 			useTabInfo();
@@ -83840,6 +86817,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const environmentSchema = object({
 			cwd: string().readonly(),
 			workspaceId: string().readonly().optional(),
+			platform: union([
+				literal("darwin"),
+				literal("linux"),
+				literal("win32"),
+				literal("unsupported")
+			]).readonly().optional(),
 			maxInputBytes: number().readonly(),
 			maxCols: number().readonly(),
 			maxRows: number().readonly(),