dsh-vscode-mode 0.5.0 → 0.5.2

package/lib/client.js

@@ -6744,7 +6744,9 @@ window.__ModuleLoader__.load({
 		/**
 		* 订阅窗口会话广播（幂等）：EditorView 是 sessionId 的权威来源，挂载与会话切换时广播。
 		* 独立于服务订阅，避免服务形状变化时 LSP 整体失联。
-		* @author ddj 2026年09月11号
+		*
+		* 返回值是可重入的取消订阅函数；调用方应保存并在卸载时调用（否则重载后会累积监听）。
+		* @author ddj 2026年09月11号 / 2026年09月18号
 		* @returns 取消订阅函数
 		*/
 		function bindLspSession() {
@@ -6978,6 +6980,8 @@ window.__ModuleLoader__.load({
 		};
 		let registered$2 = false;
 		const disposables = [];
+		/** LSP provider 注册标记的全局挂点名（跨插件重载认领；见 disposeLspProviders）。 */
+		const LSP_PROVIDERS_GLOBAL = "__edrvLspProvidersRegistered__";
 		/** 目标文件打开并定位（复用现有 openFileAt 的 edrv:open-editor 事件通道）。 */
 		function openAt(path, target) {
 			window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: Object.assign({ path }, target) }));
@@ -7018,6 +7022,11 @@ window.__ModuleLoader__.load({
 		/** 注册全部 Monaco LSP provider 与文档跟踪（幂等）。 */
 		function registerLspProviders(monaco) {
 			if (registered$2) return;
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host && host[LSP_PROVIDERS_GLOBAL]) {
+				registered$2 = true;
+				return;
+			}
 			registered$2 = true;
 			const attachModel = (model) => {
 				if (!model || model.uri.scheme !== "edrv") return;
@@ -7084,6 +7093,24 @@ window.__ModuleLoader__.load({
 				},
 				releaseDocumentSemanticTokens: () => {}
 			}));
+			if (host) host[LSP_PROVIDERS_GLOBAL] = true;
+		}
+		/**
+		* 卸载 LSP provider 集合：注销全部注册并复位状态（插件重载/卸载时调用）。
+		*
+		* 必须存在的原因：DSH 0.1.6-alpha.2 起支持插件运行时卸载/重载，而 `window.monaco`
+		* 由 loader 注入后**跨重载存活**；模块级 `registered`/`disposables` 却随 bundle 重新
+		* 求值清空 —— 不注销则每次重载都重复叠加一整套 provider（跳转/hover/语义高亮翻倍）。
+		* @author ddj 2026年09月18号
+		*/
+		function disposeLspProviders() {
+			for (const dispose of disposables.splice(0)) try {
+				if (typeof dispose === "function") dispose();
+				else if (dispose && typeof dispose.dispose === "function") dispose.dispose();
+			} catch {}
+			registered$2 = false;
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host) delete host[LSP_PROVIDERS_GLOBAL];
 		}
 		/** LSP SymbolInfo（host 归一化后）→ Monaco DocumentSymbol。 */
 		function toMonacoSymbol(symbol) {
@@ -7270,12 +7297,23 @@ window.__ModuleLoader__.load({
 		* 作者 ddj 2026-08-27
 		*/
 		let sessionBound = false;
+		/** 会话广播取消订阅函数（卸载时调用；落 window 以便跨重载清理上一代监听）。 */
+		let sessionUnbind = null;
+		/** 会话广播订阅标记的全局挂点名（跨插件重载认领；见 disposeLsp）。 */
+		const LSP_SESSION_GLOBAL = "__edrvLspSessionUnbind__";
 		/** Monaco 加载后装配（幂等；重复调用仅刷新会话）。 */
 		function setupLsp(monaco) {
 			registerLspProviders(monaco);
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host && typeof host[LSP_SESSION_GLOBAL] === "function") {
+				sessionBound = true;
+				sessionUnbind = host[LSP_SESSION_GLOBAL];
+				return;
+			}
 			if (!sessionBound) {
 				sessionBound = true;
-				bindLspSession();
+				sessionUnbind = bindLspSession();
+				if (host) host[LSP_SESSION_GLOBAL] = sessionUnbind;
 			}
 		}
 		/** 会话切换：更新 host 侧文档归属 + 刷新状态。 */
@@ -7283,6 +7321,21 @@ window.__ModuleLoader__.load({
 			setLspSession(sessionId);
 			refreshStatus(true);
 		}
+		/**
+		* 卸载 LSP 装配（插件重载/卸载时调用）：注销全部 provider、解绑会话广播并复位标记。
+		* @author ddj 2026年09月18号
+		*/
+		function disposeLsp() {
+			disposeLspProviders();
+			const unbind = sessionUnbind;
+			if (typeof unbind === "function") try {
+				unbind();
+			} catch {}
+			sessionUnbind = null;
+			sessionBound = false;
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host) delete host[LSP_SESSION_GLOBAL];
+		}
 		//#endregion
 		//#region src/shared/ai.ts
 		/**
@@ -7294,6 +7347,29 @@ window.__ModuleLoader__.load({
 		/** 上下文窗口：前缀字符上限（含未保存编辑的当前文档）。 */
 		const AI_PREFIX_MAX = 2e3;
 		/**
+		* 已从官方默认模型列表下架的模型标识（依据 DSH 0.1.6-alpha.2 release notes：
+		* 「默认模型列表移除 V4 Flash 和 V4 Flash Vision Exp」）。
+		*
+		* 用途：用户此前保存过这些模型时，配置仍指向它们，而新版模型目录不再列出 →
+		* 需给出可读降级提示（而非静默失败）。按模型名小写子串匹配，
+		* 因为 provider 前缀与具体版本后缀（如 -exp）在不同部署下写法不一。
+		*/
+		const DELISTED_MODEL_MARKERS = ["v4-flash"];
+		/**
+		* 配置指向的模型是否已被官方下架（G7）。
+		*
+		* 语义：仅当确实指定了 model（非空 = 非自动路由）且命中下架标识时返回 true。
+		* 空 model 表示「自动取首个可用模型」，不构成问题，故不提示。
+		* @author ddj 2026年09月18号
+		* @param model 配置中的模型标识（可空）
+		* @returns 是否已下架
+		*/
+		function isDelistedModel(model) {
+			const text = typeof model === "string" ? model.trim().toLowerCase() : "";
+			if (!text) return false;
+			return DELISTED_MODEL_MARKERS.some((marker) => text.includes(marker));
+		}
+		/**
 		* 按 AI_PREFIX_MAX/AI_SUFFIX_MAX 裁剪前后缀（client 侧发请求前调用）。
 		* @author ddj
 		* @param prefix 光标前全文
@@ -7356,6 +7432,16 @@ window.__ModuleLoader__.load({
 		let inFlight = null;
 		let debounceTimer = null;
 		const cache$1 = /* @__PURE__ */ new Map();
+		/**
+		* 补全 provider 注销器的全局挂点名。
+		*
+		* 为什么挂 window 而不是只靠模块级 registered：DSH 0.1.6-alpha.2 起支持插件运行时
+		* 卸载/重载，而 `window.monaco` 由 loader 注入后**跨重载存活**，模块级状态却会随
+		* bundle 重新求值而复位 —— 只判 registered 会在每次重载后再注册一次 provider，
+		* 导致同一编辑器出现重复补全。故注销器落 window，重载时命中即跳过注册。
+		* @author ddj 2026年09月18号
+		*/
+		const AI_INLINE_GLOBAL = "__edrvAiInlineDisposer__";
 		/** 上次开关状态（configUpdate 后经事件刷新，关闭时立即静默）。 */
 		let enabled = false;
 		/** 供设置面板保存后同步开关状态（不重载页面即时生效）。 */
@@ -7406,8 +7492,13 @@ window.__ModuleLoader__.load({
 		*/
 		function registerAiInline(monaco) {
 			if (registered$1 || !monaco?.languages?.registerInlineCompletionsProvider) return;
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host && host[AI_INLINE_GLOBAL]) {
+				registered$1 = true;
+				return;
+			}
 			registered$1 = true;
-			monaco.languages.registerInlineCompletionsProvider("*", {
+			const inlineDisposer = monaco.languages.registerInlineCompletionsProvider("*", {
 				async provideInlineCompletions(model, position, context, token) {
 					const t0 = Date.now();
 					if (!enabled || token?.isCancellationRequested) return { items: [] };
@@ -7493,6 +7584,36 @@ window.__ModuleLoader__.load({
 				},
 				freeInlineCompletions() {}
 			});
+			if (host) host[AI_INLINE_GLOBAL] = inlineDisposer;
+		}
+		/**
+		* 卸载 AI 内联补全：注销 provider 并复位模块状态（插件重载/卸载时调用）。
+		*
+		* 复位 registered 让重装后能重新注册；清 window 挂点避免新实例被旧注销器误判为「已注册」。
+		* 同时作废在飞请求与去抖定时器，防止卸载后仍有回调写状态。
+		* @author ddj 2026年09月18号
+		*/
+		function disposeAiInline() {
+			const host = typeof window === "undefined" ? void 0 : window;
+			const inlineDisposer = host ? host[AI_INLINE_GLOBAL] : void 0;
+			if (inlineDisposer && typeof inlineDisposer.dispose === "function") try {
+				inlineDisposer.dispose();
+			} catch {}
+			if (host) delete host[AI_INLINE_GLOBAL];
+			registered$1 = false;
+			seq += 1;
+			if (debounceTimer) {
+				clearTimeout(debounceTimer);
+				debounceTimer = null;
+			}
+			if (inFlight) {
+				try {
+					inFlight.abort();
+				} catch {}
+				inFlight = null;
+			}
+			cache$1.clear();
+			monacoRef = null;
 		}
 		/** 缓存写入（超限整体清空，LRU 简化）。 */
 		function cacheSet(key, items) {
@@ -7582,6 +7703,16 @@ window.__ModuleLoader__.load({
 		let cacheAt = 0;
 		let pending = null;
 		let registered = false;
+		let disposer = null;
+		/**
+		* 片段 provider 注销器的全局挂点名。
+		*
+		* 为什么挂 window：`window.monaco` 由 loader 注入后**跨插件重载存活**，而模块级
+		* registered/disposer 会随 bundle 重新求值复位 —— 只判 registered 会在每次重载后
+		* 重复注册补全 provider（同一编辑器出现重复候补）。故注销器落 window 供跨代认领与清理。
+		* @author ddj 2026年09月18号
+		*/
+		const SNIPPET_GLOBAL = "__edrvSnippetsDisposer__";
 		/** 当前会话 id（补全按会话工作区叠加项目片段；EditorView 装配时注入）。 */
 		let sessionId = null;
 		/**
@@ -7653,11 +7784,16 @@ window.__ModuleLoader__.load({
 		*/
 		function registerSnippetProvider(monaco) {
 			if (registered || !monaco?.languages?.registerCompletionItemProvider) return;
+			const host = typeof window === "undefined" ? void 0 : window;
+			if (host && host[SNIPPET_GLOBAL]) {
+				registered = true;
+				return;
+			}
 			const snippetKind = monaco.languages.CompletionItemKind?.Snippet;
 			const asSnippet = monaco.languages.CompletionItemInsertTextRule?.InsertAsSnippet;
 			if (typeof snippetKind !== "number" || typeof asSnippet !== "number") return;
 			registered = true;
-			monaco.languages.registerCompletionItemProvider("*", { async provideCompletionItems(model, position) {
+			disposer = monaco.languages.registerCompletionItemProvider("*", { async provideCompletionItems(model, position) {
 				const entries = await loadEntries();
 				if (!entries.length) return { suggestions: [] };
 				const items = entriesForLanguage(entries, model?.getLanguageId?.());
@@ -7680,6 +7816,7 @@ window.__ModuleLoader__.load({
 					range
 				})).filter((item) => Boolean(item.label)) };
 			} });
+			if (host) host[SNIPPET_GLOBAL] = disposer;
 		}
 		/**
 		* 装配：Monaco 就绪后注册 provider（幂等）。
@@ -7690,6 +7827,22 @@ window.__ModuleLoader__.load({
 			registerSnippetProvider(monaco);
 		}
 		/**
+		* 卸载：注销 provider 并复位状态（插件热重载/卸载时调用）。
+		* 兼容上一代 bundle 遗留的 window 注销器（模块级 disposer 为空时仍能清干净）。
+		* @author ddj 2026年09月10号 / 2026年09月18号
+		*/
+		function disposeSnippets() {
+			const host = typeof window === "undefined" ? void 0 : window;
+			const target = (typeof disposer === "function" ? disposer : null) ?? (host ? host[SNIPPET_GLOBAL] : null);
+			if (target && typeof target.dispose === "function") try {
+				target.dispose();
+			} catch {}
+			if (host) delete host[SNIPPET_GLOBAL];
+			disposer = null;
+			registered = false;
+			invalidateSnippets();
+		}
+		/**
 		* 读取可插入条目（「插入代码片段」命令用；含无前缀条目）。
 		* @author ddj 2026年09月10号
 		* @param languageId 当前模型语言（缺省返回全语言 + 该语言条目）
@@ -8258,23 +8411,50 @@ window.__ModuleLoader__.load({
 		/**
 		* 归一化持久化的页签数据：兼容旧版 `string[]`、去重、固定分区。
 		* 损坏项（非字符串/非对象/无 path）直接丢弃。
-		* @author ddj 2026年09月11号
+		*
+		* G9：传入 cwd 时把每个路径收敛为**页签规范形态**（工作区相对路径），
+		* 以迁移历史持久化数据里残留的绝对路径（见 {@link tabPathOf}）。
+		* @author ddj 2026年09月11号 / 2026年09月18号
 		* @param raw localStorage 解析结果（任意形状）
+		* @param cwd 会话工作区目录（可选；给出时同步归一化路径形态）
 		* @returns 归一化后的页签数组
 		*/
-		function normalizeTabs(raw) {
+		function normalizeTabs(raw, cwd) {
 			if (!Array.isArray(raw)) return [];
 			const seen = /* @__PURE__ */ new Set();
 			const out = [];
 			for (const item of raw) {
 				const tab = tabOf(item);
-				if (!tab || seen.has(tab.path)) continue;
-				seen.add(tab.path);
-				out.push(tab);
+				if (!tab) continue;
+				const path = tabPathOf(tab.path, cwd);
+				if (!path || seen.has(path)) continue;
+				seen.add(path);
+				out.push(tab.pinned === true ? {
+					path,
+					pinned: true
+				} : { path });
 			}
 			return pinnedFirst(out);
 		}
 		/**
+		* 页签规范形态 = 工作区相对路径（G9）。
+		*
+		* 为什么需要：差异记录路径取自工具结果 `target.displayPath`（官方恒为绝对拼写），
+		* 而资源管理器树给出的是工作区相对路径。两者进页签后，地址栏形态不一致，且
+		* `insertTab` 按原串去重 → 同一文件可能出两个页签；绝对路径还会被
+		* `isTreeRevealable` 判为不可定位，「在资源管理器视图中显示」对差异入口失效。
+		* 统一经 {@link relativeOf} 收敛后，页签/地址栏/去重/持久化/`sameFile` 口径一致。
+		*
+		* 工作区外文件（全局片段/规则）由 relativeOf 自然回退为原绝对路径，语义不变。
+		* @author ddj 2026年09月18号
+		* @param path 原始路径（绝对或相对，两种分隔符均可）
+		* @param cwd 会话工作区目录（可空；无 cwd 时仅做分隔符归一）
+		* @returns 页签规范路径
+		*/
+		function tabPathOf(path, cwd) {
+			return relativeOf(path, cwd);
+		}
+		/**
 		* 解释单条持久化页签：字符串 = 路径（旧版），对象取 path/pinned。
 		* @author ddj 2026年09月11号
 		* @param item 原始条目
@@ -11410,6 +11590,32 @@ window.__ModuleLoader__.load({
 				if (select) setActive(path);
 			};
 			/**
+			* 页签规范路径（G9）：统一收敛为工作区相对路径后再进页签。
+			*
+			* 差异记录路径取自工具结果 `target.displayPath`（官方恒绝对），而资源管理器树给相对路径；
+			* 不归一会导致地址栏形态不一致、同文件出现两个页签（insertTab 按原串去重）、
+			* 且绝对路径被 isTreeRevealable 判为不可定位（「在资源管理器视图中显示」失效）。
+			* 工作区外文件由 relativeOf 回退原绝对路径，语义不变。
+			* @author ddj 2026年09月18号
+			* @param path 原始路径（绝对或相对）
+			* @returns 页签规范路径
+			*/
+			const tabPath = (path) => tabPathOf(path, cwd);
+			/**
+			* 打开文件入口的统一收敛（G9）：所有「进页签」路径都经此归一，避免逐点打补丁。
+			* @author ddj 2026年09月18号
+			* @param path 原始路径
+			* @param select 是否设为活动页签
+			* @returns 归一后的路径（空值返回 null）
+			*/
+			const addTabNorm = (path, select) => {
+				if (!path) return null;
+				const normalized = tabPath(path);
+				if (!normalized) return null;
+				addTab(normalized, select);
+				return normalized;
+			};
+			/**
 			* 保存当前活动文件的视图状态（光标/滚动/折叠）到工作区作用域缓存。
 			* @author ddj 2026年08月28号
 			* @param path 要保存的文件路径（缺省 = 当前 active）
@@ -11495,7 +11701,7 @@ window.__ModuleLoader__.load({
 				flushSave();
 				saveViewState(active);
 				navPendingRef.current = entry;
-				addTab(entry.path, true);
+				addTabNorm(entry.path, true);
 				setFocusRequest((value) => value + 1);
 			};
 			/**
@@ -11978,22 +12184,24 @@ window.__ModuleLoader__.load({
 				const onOpen = (e) => {
 					const p = e?.detail?.path;
 					if (!p) return;
+					const normalized = tabPath(p);
+					if (!normalized) return;
 					if (e?.detail?.focusDiff === true) {
 						recordNav();
 						pendingFocusRef.current = {
-							path: p,
+							path: normalized,
 							region: null
 						};
 						setFocusRequest((value) => value + 1);
-						addTab(p, true);
+						addTab(normalized, true);
 						return;
 					}
 					if (e?.detail?.line != null) {
-						openFileAt(p, e?.detail?.line, e?.detail?.column, e?.detail?.endLine, e?.detail?.endColumn);
+						openFileAt(normalized, e?.detail?.line, e?.detail?.column, e?.detail?.endLine, e?.detail?.endColumn);
 						return;
 					}
 					recordNav();
-					addTab(p, true);
+					addTab(normalized, true);
 				};
 				const onShowLauncher = (event) => {
 					const tab = event?.detail?.tab;
@@ -12077,10 +12285,11 @@ window.__ModuleLoader__.load({
 					const raw = localStorage.getItem(CACHE_KEY.editor + String(scope)) ?? localStorage.getItem(CACHE_KEY.editorLegacy + String(scope));
 					if (raw) {
 						const saved = JSON.parse(raw);
-						const restored = normalizeTabs(saved?.tabs);
+						const restored = normalizeTabs(saved?.tabs, cwd);
 						if (restored.length) {
 							setTabs(restored);
-							setActive(pickActive(restored, saved?.active));
+							const wanted = typeof saved?.active === "string" ? tabPathOf(saved.active, cwd) : saved?.active;
+							setActive(pickActive(restored, wanted));
 						}
 					}
 				} catch (e) {}
@@ -13818,9 +14027,9 @@ window.__ModuleLoader__.load({
 				if (!path) return;
 				setSvnDiff(null);
 				recordNav();
-				addTab(path, true);
-				if (focusDiff) pendingFocusRef.current = {
-					path,
+				const normalized = addTabNorm(path, true);
+				if (focusDiff && normalized) pendingFocusRef.current = {
+					path: normalized,
 					region: null
 				};
 			};
@@ -13837,9 +14046,10 @@ window.__ModuleLoader__.load({
 			const openFileAt = (path, line, column, endLine, endColumn) => {
 				if (!path) return;
 				recordNav();
-				addTab(path, true);
+				const normalized = addTabNorm(path, true);
+				if (!normalized) return;
 				pendingFocusRef.current = {
-					path,
+					path: normalized,
 					region: null,
 					line: line ?? null,
 					column: column ?? 1,
@@ -14075,7 +14285,7 @@ window.__ModuleLoader__.load({
 					onClick: keepLocal
 				}, "保留本地"));
 			};
-			const otherFiles = sum.pendingFiles.filter((f) => f.path !== active);
+			const otherFiles = sum.pendingFiles.filter((f) => !sameFile(f.path, active));
 			/**
 			* 渲染编辑器/文件加载进度面板。
 			* @author ddj 2026年08月22号
@@ -14995,6 +15205,110 @@ window.__ModuleLoader__.load({
 		/** file 资源类型的 kind（与页类型 edrvEditor 区分：同 kind 只允许一份 extension）。 */
 		const OFFICIAL_FILE_KIND = "edrvEditorFile";
 		/**
+		* Office 文档后缀：官方 `dsh-client-ui-sidebar-documentpreview` 的 Office 渲染器
+		* 声明 `doc/docx/xls/xlsx/ppt/pptx`，并在 alpha.2 起提供侧栏 Office 预览。
+		* 本插件让位官方（不认领），否则会把这些文件路由进 Monaco 而丢掉 Office 预览。
+		*/
+		const OFFICE_EXT = [
+			"doc",
+			"docx",
+			"xls",
+			"xlsx",
+			"ppt",
+			"pptx",
+			"odt",
+			"ods",
+			"odp",
+			"pages",
+			"numbers"
+		];
+		/**
+		* 官方「不可预览二进制容器」清单（`UNVIEWABLE_BINARY_EXTENSIONS`，逐项取自
+		* `dsh-client-ui-sidebar-documentpreview/lib/client.js` 的 `UNVIEWABLE_BINARY_EXTENSIONS`）。
+		* 这些后缀官方会给出「无法预览」提示；本插件让位官方，避免把二进制当文本读成乱码。
+		*
+		* ⚠️ 刻意例外：官方清单含 `avif`，但本插件 {@link IMAGE_MIME} 支持 avif 图片预览
+		* （浏览器原生解码），故从本表**移除** `avif` —— 保留本插件的图片预览优于官方的「不可预览」。
+		* @author ddj 2026年09月18号
+		*/
+		const BLIND_EXT = [
+			"mp4",
+			"mov",
+			"avi",
+			"mkv",
+			"webm",
+			"flv",
+			"wmv",
+			"m4v",
+			"mp3",
+			"wav",
+			"flac",
+			"ogg",
+			"m4a",
+			"aac",
+			"wma",
+			"opus",
+			"zip",
+			"gz",
+			"tgz",
+			"bz2",
+			"xz",
+			"zst",
+			"7z",
+			"rar",
+			"tar",
+			"jar",
+			"exe",
+			"dll",
+			"so",
+			"dylib",
+			"bin",
+			"o",
+			"class",
+			"pyc",
+			"wasm",
+			"ttf",
+			"otf",
+			"woff",
+			"woff2",
+			"eot",
+			"dmg",
+			"iso",
+			"img",
+			"sqlite",
+			"db",
+			"psd",
+			"ai",
+			"sketch",
+			"tiff",
+			"tif",
+			"heic",
+			"heif"
+		];
+		/** 让位判定用后缀集合（模块级构建一次；小写、无前导点）。 */
+		const DEFER_EXT_SET = /* @__PURE__ */ new Set([...OFFICE_EXT, ...BLIND_EXT]);
+		/**
+		* 取 path 的 basename 后缀（小写、无点）；无后缀/隐藏文件返回 ''。
+		* @author ddj 2026年09月18号
+		* @param path 文件路径（`/` 或 `\` 分隔均可）
+		* @returns 小写后缀或 ''
+		*/
+		function suffixOf(path) {
+			const base = String(path ?? "").replace(/\\/g, "/").split("/").pop() ?? "";
+			const dot = base.lastIndexOf(".");
+			return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+		}
+		/**
+		* 该路径是否应让位官方查看器（Office 文档 + 官方不可预览的二进制容器）。
+		* 命中即不认领 `dsh-resource://file/**`，回落官方预览/提示。
+		* @author ddj 2026年09月18号
+		* @param path 文件路径（工作区相对或绝对）
+		* @returns 是否让位官方
+		*/
+		function deferToOfficial(path) {
+			return DEFER_EXT_SET.has(suffixOf(path));
+		}
+		/**
 		* 结构化探测官方右侧 Sidebar 服务（可选依赖：缺失/降级返回 undefined）。
 		* 服务仅存在于 DSH 0.1.5-alpha.1+，探测命中 ≡ 版本判定成立。
 		* @author ddj 2026年09月09号
@@ -15208,7 +15522,10 @@ window.__ModuleLoader__.load({
 		* 注册官方 file 资源地址认领（extension 档接管 `dsh-resource://file/**`，
 		* 聊天文件链接/文件树打开改落本插件编辑器；注销后官方 textpreview 自动恢复）。
 		* 认领与否由「文件链接使用工具」设置驱动（见 fileOpeners.shouldClaimFiles）。
-		* @author ddj 2026年09月09号
+		*
+		* 让位规则（DSH 0.1.6-alpha.2 起）：Office 文档与官方「不可预览」二进制容器不认领，
+		* 回落官方查看器（Office 侧栏预览 / 「无法预览」提示），见 {@link deferToOfficial}。
+		* @author ddj 2026年09月09号 / 2026年09月18号
 		* @param options 装配参数（探测命中的注册表 + slots + 正文组件）
 		* @returns 卸载器（反注册类型与正文）；类型注册抛错返回 null（回落官方查看器）
 		*/
@@ -15221,7 +15538,11 @@ window.__ModuleLoader__.load({
 					kind: OFFICIAL_FILE_KIND,
 					patterns: [OFFICIAL_FILE_PATTERN],
 					priority: "extension",
-					canOpen: (address) => parseOfficialFileAddress(address) !== null,
+					canOpen: (address) => {
+						const parsed = parseOfficialFileAddress(address);
+						if (parsed === null) return false;
+						return !deferToOfficial(parsed.path);
+					},
 					title: (address) => officialFileTitle(address)
 				});
 			} catch (error) {
@@ -16793,7 +17114,8 @@ window.__ModuleLoader__.load({
 			};
 			if (!cfg) return react.default.createElement("div", { className: "vsm-mcp-empty" }, error || "正在读取 AI 补全配置…");
 			const modelValue = cfg.provider && cfg.model ? cfg.provider + "/" + cfg.model : "";
-			return react.default.createElement("section", { className: "vsm-lsp-card" }, react.default.createElement("h3", null, "AI 自动补全（实验）"), react.default.createElement("p", { className: "vsm-lsp-note" }, "编辑停顿后由模型生成内联建议（ghost text），Tab 接受，Alt+\\ 手动触发。每次补全是一次模型调用；建议选择非推理模型，且思考强度选「跟随默认」或最低档以获得更快响应。"), react.default.createElement("div", { className: "vsm-lsp-row" }, react.default.createElement("button", {
+			const delisted = isDelistedModel(cfg.model);
+			return react.default.createElement("section", { className: "vsm-lsp-card" }, react.default.createElement("h3", null, "AI 自动补全（实验）"), react.default.createElement("p", { className: "vsm-lsp-note" }, "编辑停顿后由模型生成内联建议（ghost text），Tab 接受，Alt+\\ 手动触发。每次补全是一次模型调用；建议选择非推理模型，且思考强度选「跟随默认」或最低档以获得更快响应。"), delisted ? react.default.createElement("div", { className: "vsm-mcp-error vsm-mcp-banner" }, "当前模型「" + cfg.model + "」已从 DSH 默认模型列表移除（0.1.6-alpha.2 起）。该模型可能不再可用；将「模型」改回「自动」即可使用第一个可用模型（现有配置不会被自动改动）。") : null, react.default.createElement("div", { className: "vsm-lsp-row" }, react.default.createElement("button", {
 				className: cfg.enabled ? "vsm-primary" : "",
 				disabled: busy,
 				onClick: toggle
@@ -21476,6 +21798,137 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/sessionScope.ts
+		/** 对象窄化（非对象返回 undefined，供后续安全取字段）。 */
+		function asRecord(value) {
+			return value && typeof value === "object" ? value : void 0;
+		}
+		/** 非空字符串取值（其他类型一律视为缺失）。 */
+		function strOf(value) {
+			return typeof value === "string" && value ? value : void 0;
+		}
+		/**
+		* 从 `uiSession.current` 快照读出 sessionId。
+		* 兼容两种形态：绑定源本身（`{ key }`）与其包裹形态（`{ value: { key } }`）——
+		* 官方 `createBindingSource` 的 `getSnapshot()` 返回绑定值本身，但跨版本包裹层存在差异，
+		* 故两者都尝试。
+		* @author ddj 2026年09月18号
+		* @param snapshot `uiSession.current` 的 `getSnapshot()` 结果（任意形状）
+		* @returns sessionId，或 undefined
+		*/
+		function uiSessionIdOf(snapshot) {
+			const binding = asRecord(snapshot);
+			if (!binding) return void 0;
+			return strOf(binding.key) ?? strOf(asRecord(binding.value)?.key);
+		}
+		/**
+		* 从 `sessions.list` 快照读出 sessionId。
+		* 先取旧版 `current`；缺失时回退 `byId` 中 `retainedBy.mainView > 0` 的首行
+		* （与官方 ui-session 的 publishMain 同判据，故新版行为与官方视图一致）。
+		* @author ddj 2026年09月18号
+		* @param list `sessions.list` 的 `getSnapshot()` 结果（任意形状）
+		* @returns sessionId，或 undefined
+		*/
+		function listSessionId(list) {
+			const snap = asRecord(list);
+			if (!snap) return void 0;
+			const current = strOf(snap.current);
+			if (current) return current;
+			const byId = asRecord(snap.byId);
+			if (!byId) return void 0;
+			for (const [id, row] of Object.entries(byId)) {
+				const mainView = asRecord(asRecord(row)?.retainedBy)?.mainView;
+				if (typeof mainView === "number" && mainView > 0) return id;
+			}
+		}
+		/**
+		* 三级取值链（纯函数）：决定当前会话 id 与其 cwd。
+		* 优先级 uiSession > list.current > list.byId.retainedBy > fallback。
+		* @author ddj 2026年09月18号
+		* @param sources 候选来源集合
+		* @returns 会话作用域（字段缺失即省略该键，不写 undefined 占位）
+		*/
+		function pickSessionScope(sources) {
+			const sessionId = uiSessionIdOf(sources.uiSession) ?? listSessionId(sources.list) ?? strOf(sources.fallbackSessionId);
+			if (!sessionId) return {};
+			const cwd = strOf(asRecord(asRecord(asRecord(sources.list)?.byId)?.[sessionId])?.cwd);
+			return cwd ? {
+				sessionId,
+				cwd
+			} : { sessionId };
+		}
+		/** 读 `ctx.get(name)`（缺失/异常返回 undefined，不抛错）。 */
+		function safeGet(ctx, name) {
+			try {
+				return ctx.get(name);
+			} catch {
+				return;
+			}
+		}
+		/** 取 `uiSession.current` 快照（服务或订阅面缺失时返回 undefined）。 */
+		function uiCurrentSnapshot(ctx) {
+			const current = asRecord(asRecord(safeGet(ctx, "uiSession"))?.current);
+			const getSnapshot = current?.getSnapshot;
+			if (typeof getSnapshot !== "function") return void 0;
+			try {
+				return getSnapshot.call(current);
+			} catch {
+				return;
+			}
+		}
+		/** 取 `sessions.list` 快照（服务缺失时返回 undefined）。 */
+		function listSnapshot(ctx) {
+			const list = asRecord(asRecord(safeGet(ctx, "sessions"))?.list);
+			const getSnapshot = list?.getSnapshot;
+			if (typeof getSnapshot !== "function") return void 0;
+			try {
+				return getSnapshot.call(list);
+			} catch {
+				return;
+			}
+		}
+		/**
+		* 读当前会话作用域（服务面取值 + 三级链）。
+		* @author ddj 2026年09月18号
+		* @param ctx 客户端根上下文（只需 `get`）
+		* @param fallbackSessionId 槽位注入的 sessionId（可选）
+		* @returns 会话作用域
+		*/
+		function readSessionScope(ctx, fallbackSessionId) {
+			return pickSessionScope({
+				uiSession: uiCurrentSnapshot(ctx),
+				list: listSnapshot(ctx),
+				fallbackSessionId
+			});
+		}
+		/**
+		* 订阅会话切换（同时挂 `uiSession.current` 与新/旧 `sessions.list`）。
+		* 旧版无 `uiSession`，新版 `list` 不再变（切会话只动 uiSession），故两条都要挂；
+		* 回调可能因两条源先后触发而重复，调用方按上一次 sessionId 自行去重。
+		* @author ddj 2026年09月18号
+		* @param ctx 客户端根上下文（只需 `get`）
+		* @param listener 变更回调
+		* @returns 取消订阅函数（幂等）
+		*/
+		function subscribeScope(ctx, listener) {
+			const disposers = [];
+			const attach = (owner) => {
+				const subscribe = asRecord(owner)?.subscribe;
+				if (typeof subscribe !== "function") return;
+				try {
+					const disposer = subscribe.call(owner, listener);
+					if (typeof disposer === "function") disposers.push(disposer);
+				} catch {}
+			};
+			attach(asRecord(asRecord(safeGet(ctx, "uiSession"))?.current));
+			attach(asRecord(asRecord(safeGet(ctx, "sessions"))?.list));
+			return () => {
+				for (const disposer of disposers.splice(0)) try {
+					disposer();
+				} catch {}
+			};
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/**
 		* dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
@@ -21539,46 +21992,37 @@ window.__ModuleLoader__.load({
 			const workspaces = ctx.get("workspaces");
 			const sessions = ctx.get("sessions");
 			setupExtOpen(ctx);
-			const monacoList = sessions?.list;
-			if (typeof window !== "undefined" && monacoList && typeof monacoList.subscribe === "function") {
-				const list = monacoList;
+			if (typeof window !== "undefined") {
 				const schedulePreload = () => {
 					const preload = () => loadMonaco(() => {}).then((m) => setupLsp(m)).catch(() => {});
 					if (typeof window.requestIdleCallback === "function") window.requestIdleCallback(preload, { timeout: 2e3 });
 					else schedule(preload, 300);
 				};
-				const onSessionEnter = () => {
-					const current = list.getSnapshot()?.current;
-					if (!current) return;
-					setSession(current);
+				let preloadedFor;
+				const onScopeChange = () => {
+					const scope = readSessionScope(ctx);
+					setSession(scope.sessionId);
+					if (!scope.sessionId || scope.sessionId === preloadedFor) return;
+					preloadedFor = scope.sessionId;
 					schedulePreload();
 				};
-				ctx.effect(() => list.subscribe(onSessionEnter), "vscode-mode: monaco session trigger");
-				onSessionEnter();
-			}
-			if (monacoList && typeof monacoList.subscribe === "function") {
-				const list = monacoList;
-				ctx.effect(() => list.subscribe(() => {
-					setSession(list.getSnapshot()?.current);
-				}), "vscode-mode: lsp session sync");
-			}
-			if (monacoList && typeof monacoList.subscribe === "function") {
-				const list = monacoList;
-				ctx.effect(() => {
-					let lastCurrent = list.getSnapshot?.()?.current;
-					const check = () => {
-						const current = list.getSnapshot?.()?.current;
-						if (!current || current === lastCurrent) return;
-						lastCurrent = current;
-						if (!isEditorTabActive() || officialService === void 0) return;
-						try {
-							officialService.service.openTabIn?.(current, OFFICIAL_TAB_KIND, {});
-						} catch {}
-						restoreEditorTab(officialService.service, schedule);
-					};
-					return list.subscribe(() => schedule(check, 0));
-				}, "vscode-mode: editor tab restore");
+				ctx.effect(() => subscribeScope(ctx, onScopeChange), "vscode-mode: monaco session trigger");
+				onScopeChange();
 			}
+			ctx.effect(() => {
+				let lastCurrent = readSessionScope(ctx).sessionId;
+				const check = () => {
+					const current = readSessionScope(ctx).sessionId;
+					if (!current || current === lastCurrent) return;
+					lastCurrent = current;
+					if (!isEditorTabActive() || officialService === void 0) return;
+					try {
+						officialService.service.openTabIn?.(current, OFFICIAL_TAB_KIND, {});
+					} catch {}
+					restoreEditorTab(officialService.service, schedule);
+				};
+				return subscribeScope(ctx, () => schedule(check, 0));
+			}, "vscode-mode: editor tab restore");
 			const originalOpenPath = workspaces?.openPath;
 			const binder = pickSettingsBinder(ctx);
 			const settings = binder.scope;
@@ -21587,15 +22031,8 @@ window.__ModuleLoader__.load({
 			let remoteOpenInstalled = false;
 			/** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter；统一走插件日志器）。 */
 			const routeLogger = (message) => log.warn(message);
-			/** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
-			const openContext = () => {
-				const current = sessions?.list?.getSnapshot?.();
-				const sessionId = current?.current;
-				return {
-					sessionId,
-					cwd: (sessionId ? current?.byId?.[sessionId] : void 0)?.cwd
-				};
-			};
+			/** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd（跨版本取值链）。 */
+			const openContext = () => readSessionScope(ctx);
 			/** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
 			let sideService = detectSidebarService(ctx);
 			/** 可选探测官方右侧 Sidebar（DSH 0.1.5-alpha.1+；探测命中 ≡ 版本判定，不进 inject 同上）。 */
@@ -21849,12 +22286,11 @@ window.__ModuleLoader__.load({
 							sessions
 						})),
 						activeSession: () => {
-							const snapshot = sessions?.list?.getSnapshot?.();
-							const sessionId = snapshot?.current;
-							if (!sessionId) return void 0;
+							const scope = readSessionScope(ctx);
+							if (!scope.sessionId) return void 0;
 							return {
-								sessionId,
-								cwd: snapshot?.byId?.[sessionId]?.cwd
+								sessionId: scope.sessionId,
+								cwd: scope.cwd
 							};
 						},
 						registerLegacyFallback: registerLegacyTab
@@ -21925,6 +22361,17 @@ window.__ModuleLoader__.load({
 				openerRegistry: registry,
 				compatSummary
 			})));
+			ctx.effect(() => () => {
+				try {
+					disposeSnippets();
+				} catch {}
+				try {
+					disposeAiInline();
+				} catch {}
+				try {
+					disposeLsp();
+				} catch {}
+			}, "vscode-mode: monaco providers teardown");
 		}
 		//#endregion
 		exports.apply = apply;