dsh-vscode-mode 0.1.60 → 0.1.61

package/lib/client.js

@@ -3058,7 +3058,7 @@ window.__ModuleLoader__.load({
 		* 浏览器不涉 ~/.dsh 文件系统，这里只管键名 + shared 路由常量。
 		* 作者 ddj 2026-09-01
 		*/
-		/** localStorage 键前缀表（按功能隔离；均按会话拼接）。 */
+		/** localStorage 键前缀表（按功能隔离；与 scopeStore 作用域键拼接：工作区优先，无 cwd 回退会话）。 */
 		const CACHE_KEY = {
 			/** 展开状态（explorerCache v1，当前使用）。 */
 			expanded: "edrv.cache.explorer.v1.",
@@ -3072,7 +3072,7 @@ window.__ModuleLoader__.load({
 			sidebar: "edrv.sidebar.",
 			/** 搜索面板条件（SearchPanel v1）。 */
 			search: "edrv.search.v1.",
-			/** 侧边栏提示已关闭标记（全局，无会话）。 */
+			/** 侧边栏提示已关闭标记（全局，无作用域）。 */
 			sideHint: "edrv.side-hint-dismissed",
 			/** 「性能优化」页工作区栏目展开状态（workspaceFoldCache v1，全局不按会话）。 */
 			workspaceFold: "edrv.ws-fold.v1.",
@@ -3088,7 +3088,7 @@ window.__ModuleLoader__.load({
 		* 键前缀统一走 paths.ts PathConst（CACHE_KEY.viewstate）。
 		* 作者 ddj 2026-08-28
 		*/
-		/** localStorage 键前缀（按会话隔离）。 */
+		/** localStorage 键前缀（按工作区作用域隔离，无 cwd 会话回退会话键）。 */
 		const KEY_PREFIX$2 = CACHE_KEY.viewstate;
 		/**
 		* 判断对象是否为合法的 Monaco view state（保守形状校验，非深校验）。
@@ -3160,29 +3160,173 @@ window.__ModuleLoader__.load({
 			return next;
 		}
 		/**
-		* 读取某会话的视图状态缓存（localStorage 不可用 → 空映射）。
+		* 读取某作用域的视图状态缓存（localStorage 不可用 → 空映射）。
 		* @author ddj 2026年08月28号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @returns path → viewState 映射
 		*/
-		function viewStatesLoad(sessionId) {
+		function viewStatesLoad(scope) {
 			try {
-				return parseViewStates(window.localStorage.getItem(KEY_PREFIX$2 + String(sessionId))) ?? {};
+				return parseViewStates(window.localStorage.getItem(KEY_PREFIX$2 + String(scope))) ?? {};
 			} catch (error) {
 				return {};
 			}
 		}
 		/**
-		* 写入某会话的视图状态缓存（损坏/配额满 → 忽略）。
+		* 写入某作用域的视图状态缓存（损坏/配额满 → 忽略）。
 		* @author ddj 2026年08月28号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @param states path → viewState 映射
 		*/
-		function viewStatesSave(sessionId, states) {
+		function viewStatesSave(scope, states) {
 			try {
-				window.localStorage.setItem(KEY_PREFIX$2 + String(sessionId), serializeViewStates(states));
+				window.localStorage.setItem(KEY_PREFIX$2 + String(scope), serializeViewStates(states));
 			} catch (error) {}
 		}
+		//#endregion
+		//#region src/client/state/scopeStore.ts
+		/**
+		* dsh-vscode-mode client — 编辑区状态作用域键（scope key）。
+		* 编辑区 UI 状态（页签/展开树/视图状态/侧边栏等）按「工作区」隔离：同一工作区下
+		* 切换对话恢复同一份状态，无体感差别；会话没有 cwd 时回退按会话隔离（旧行为）。
+		* 另提供旧「会话键」数据到「工作区键」的一次性迁移（只复制不删除，幂等）。
+		* 键前缀统一走 paths.ts PathConst（CACHE_KEY），本模块只产出拼接用的作用域串。
+		* 作者 ddj 2026-09-09
+		*/
+		/** Windows 盘符绝对路径（如 D:/ 或 d:\），大小写不敏感。 */
+		const WIN_DRIVE_RE = /^[a-z]:\//i;
+		/**
+		* 归一化工作区路径：trim、反斜杠→斜杠、去尾部斜杠；
+		* Windows 盘符绝对路径整体小写（文件系统大小写不敏感），POSIX 路径保留大小写。
+		* @author ddj 2026年09月09号
+		* @param cwd 工作区目录（sessions 快照 byId[sessionId].cwd）
+		* @returns 归一化路径；空值返回 ''
+		*/
+		function normalizeWsPath(cwd) {
+			const s = String(cwd ?? "").trim().replace(/\\/g, "/").replace(/\/+$/, "");
+			if (!s) return "";
+			return WIN_DRIVE_RE.test(s) ? s.toLowerCase() : s;
+		}
+		/**
+		* 计算编辑区状态作用域键：有 cwd → 'ws:' + 归一化路径（同工作区共享）；
+		* 无 cwd → 'sid:' + sessionId（回退按会话隔离，对齐旧行为）。
+		* @author ddj 2026年09月09号
+		* @param cwd 工作区目录（可为 null/undefined）
+		* @param sessionId 会话 id（cwd 缺失时的隔离键）
+		* @returns 作用域键字符串
+		*/
+		function workspaceScopeOf(cwd, sessionId) {
+			const ws = normalizeWsPath(cwd);
+			if (ws) return "ws:" + ws;
+			return "sid:" + String(sessionId ?? "");
+		}
+		/** 参与迁移的 localStorage 键前缀（编辑区全部按会话持久化的旧键）。 */
+		const MIGRATE_PREFIXES = [
+			CACHE_KEY.editor,
+			CACHE_KEY.viewstate,
+			CACHE_KEY.sidebar + "side.",
+			CACHE_KEY.sidebar,
+			CACHE_KEY.search,
+			CACHE_KEY.expanded,
+			CACHE_KEY.entries
+		];
+		/** 已迁移过的 scope+sessionId 组合（按 storage 实例分组；每页生命周期只跑一次）。 */
+		const migratedPairs = /* @__PURE__ */ new WeakMap();
+		/**
+		* 把旧「前缀+sessionId」键的数据一次性复制到「前缀+scope」键（目标已存在则跳过）。
+		* 只复制不删除旧键；幂等，可安全重复调用。升级后首个工作区键为空时兜底恢复旧数据。
+		* @author ddj 2026年09月09号
+		* @param scope 目标作用域键
+		* @param sessionId 旧数据所属会话 id
+		* @param storage localStorage 注入口（缺省 window.localStorage，测试可传内存桩）
+		*/
+		function migrateScopedKeys(scope, sessionId, storage) {
+			if (!scope || !sessionId) return;
+			let store = null;
+			try {
+				store = storage ?? window.localStorage;
+			} catch (error) {
+				return;
+			}
+			if (!store) return;
+			let pairs = migratedPairs.get(store);
+			if (!pairs) {
+				pairs = /* @__PURE__ */ new Set();
+				migratedPairs.set(store, pairs);
+			}
+			const pair = scope + "|" + sessionId;
+			if (pairs.has(pair)) return;
+			pairs.add(pair);
+			const legacy = String(sessionId);
+			for (const prefix of MIGRATE_PREFIXES) {
+				const target = prefix + scope;
+				try {
+					if (store.getItem(target) !== null) continue;
+					const raw = store.getItem(prefix + legacy);
+					if (raw === null) continue;
+					store.setItem(target, raw);
+				} catch (error) {}
+			}
+		}
+		/** scope →（path → model）缓存表。 */
+		const caches = /* @__PURE__ */ new Map();
+		/** 当前激活作用域（切换时释放上一个）。 */
+		let activeScope = null;
+		/** 模型是否仍附着在某个编辑器实例上（缺方法视为未附着）。 */
+		function isAttached(model) {
+			const fn = model?.isAttachedToEditor;
+			return typeof fn === "function" ? fn.call(model) === true : false;
+		}
+		/** 释放模型（仅未附着编辑器时真正 dispose；附着中的保留给编辑器自毁）。 */
+		function disposeIfFree(model) {
+			if (!model || isAttached(model)) return;
+			try {
+				model.dispose();
+			} catch {}
+		}
+		/**
+		* 取（或切）某作用域的 model 缓存：同作用域重复调用复用同一 Map（跨挂载存活）；
+		* 作用域变化时释放上一作用域的模型（未附着的 dispose，附着中的仅移出缓存）。
+		* @author ddj 2026年09月09号
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
+		* @returns 该作用域的 path → model Map
+		*/
+		function modelsForScope(scope) {
+			const existing = caches.get(scope);
+			if (existing && activeScope === scope) return existing;
+			if (activeScope !== null && activeScope !== scope) {
+				const prev = caches.get(activeScope);
+				if (prev) {
+					for (const model of prev.values()) disposeIfFree(model);
+					prev.clear();
+					caches.delete(activeScope);
+				}
+			}
+			activeScope = scope;
+			if (existing) return existing;
+			const map = /* @__PURE__ */ new Map();
+			caches.set(scope, map);
+			return map;
+		}
+		/**
+		* 记入模型并刷新 LRU 序（先删后插保证最新），超上限逐出最旧（未附着才 dispose）。
+		* @author ddj 2026年09月09号
+		* @param map 作用域缓存 Map
+		* @param path 工作区相对路径
+		* @param model Monaco model（或测试桩）
+		*/
+		function rememberModel(map, path, model) {
+			if (!path || !model) return;
+			map.delete(path);
+			map.set(path, model);
+			while (map.size > 40) {
+				const oldest = map.keys().next().value;
+				if (oldest === void 0) break;
+				const evicted = map.get(oldest);
+				map.delete(oldest);
+				disposeIfFree(evicted);
+			}
+		}
 		let currentMin = 300;
 		/**
 		* 归一化最小宽度：非法（NaN/非有限/负数）回退默认，越界夹取到 [180, 560]。
@@ -3213,6 +3357,8 @@ window.__ModuleLoader__.load({
 		function getSidebarMinWidth() {
 			return currentMin;
 		}
+		/** scope → 导航历史实例（同工作区跨会话复用同一份历史）。 */
+		const scopeHistories = /* @__PURE__ */ new Map();
 		/** 路径一致（容忍相对路径大小写差异，对齐既有 sameFile 语义常用写法）。 */
 		function samePath(a, b) {
 			if (a === b) return true;
@@ -3276,6 +3422,26 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
+		/**
+		* 取（或建）某工作区作用域的导航历史实例：同 scope 跨会话复用同一实例，
+		* 后退/前进历史在切换对话后保留（对齐「同一工作区同一编辑区」体感）。
+		* 超出 NAV_SCOPE_CAP 时逐出最旧的实例（Map 插入序近似 LRU）。
+		* @author ddj 2026年09月09号
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
+		* @param cap 后退栈容量上限（透传 createNavHistory）
+		* @returns 导航历史实例
+		*/
+		function navHistoryFor(scope, cap = 200) {
+			const existing = scopeHistories.get(scope);
+			if (existing) return existing;
+			const created = createNavHistory(cap);
+			scopeHistories.set(scope, created);
+			if (scopeHistories.size > 6) {
+				const oldest = scopeHistories.keys().next().value;
+				if (typeof oldest === "string") scopeHistories.delete(oldest);
+			}
+			return created;
+		}
 		//#endregion
 		//#region src/client/addToConversation.ts
 		/** 把追加引用结果映射为可读文案（ok 用 okText；busy 提示已降级纯文本；unavailable 提示不可用）。
@@ -4399,6 +4565,8 @@ window.__ModuleLoader__.load({
 		* dsh-vscode-mode client — EditorView：中央 VSCode 式文件编辑器（编排层）。
 		* 迁移自原 src/client/index.ts 的 EditorView，语义不改；差异自绘已抽到 monaco/diffRender。
 		* 职责：页签/QuickOpen/Monaco 编辑器/差异审查（DiffBox/Launcher/Badge 事件装配）/状态栏/自动保存。
+		* 状态作用域：页签/视图状态/侧边栏/展开树等 UI 状态按工作区作用域（cwd）隔离，
+		* 同一工作区切换对话恢复同一份状态；无 cwd 会话回退按会话隔离（scopeStore）。
 		* 作者 ddj 2026-08-20
 		*/
 		/**
@@ -4415,6 +4583,13 @@ window.__ModuleLoader__.load({
 			const addToConversation = props.addToConversation;
 			const layout = props?.layout === "side" ? "side" : "tab";
 			const sideHint = props?.sideHint;
+			const sessionsList = props?.sessions?.list;
+			const cwd = react.default.useSyncExternalStore(react.default.useCallback((onStoreChange) => typeof sessionsList?.subscribe === "function" ? sessionsList.subscribe(onStoreChange) : () => {}, [sessionsList]), () => sessionsList?.getSnapshot?.()?.byId?.[sessionId]?.cwd ?? null, () => null);
+			const scope = react.default.useMemo(() => {
+				const s = workspaceScopeOf(cwd, sessionId);
+				migrateScopedKeys(s, sessionId);
+				return s;
+			}, [cwd, sessionId]);
 			const [monaco, setMonaco] = react.default.useState(null);
 			const [monacoErr, setMonacoErr] = react.default.useState(null);
 			const [records, setRecords] = react.default.useState({});
@@ -4469,15 +4644,16 @@ window.__ModuleLoader__.load({
 			const editorRef = react.default.useRef(null);
 			const viewRootRef = react.default.useRef(null);
 			const monacoRef = react.default.useRef(null);
-			const modelsRef = react.default.useRef(/* @__PURE__ */ new Map());
+			const modelsRef = react.default.useRef(null);
+			if (!modelsRef.current) modelsRef.current = modelsForScope(scope);
 			const viewStatesRef = react.default.useRef({});
 			const saveTimerRef = react.default.useRef(null);
 			const loadSeqRef = react.default.useRef(0);
 			const programmaticRef = react.default.useRef(false);
-			const bootRef = react.default.useRef(false);
+			const restoredScopeRef = react.default.useRef(null);
 			const pendingFocusRef = react.default.useRef(null);
 			const navRef = react.default.useRef(null);
-			if (!navRef.current) navRef.current = createNavHistory();
+			if (!navRef.current) navRef.current = navHistoryFor(scope);
 			const navPendingRef = react.default.useRef(null);
 			const navCursorTimerRef = react.default.useRef(null);
 			const navBackRef = react.default.useRef(null);
@@ -4494,6 +4670,7 @@ window.__ModuleLoader__.load({
 			const batchBusyRef = react.default.useRef(false);
 			const menuHandlersRef = react.default.useRef(null);
 			const doSaveRef = react.default.useRef(null);
+			const saveViewStateRef = react.default.useRef(null);
 			const diffRendererRef = react.default.useRef(null);
 			const layoutRef = react.default.useRef(layout);
 			layoutRef.current = layout;
@@ -4533,7 +4710,7 @@ window.__ModuleLoader__.load({
 				if (select) setActive(path);
 			};
 			/**
-			* 保存当前活动文件的视图状态（光标/滚动/折叠）到会话缓存。
+			* 保存当前活动文件的视图状态（光标/滚动/折叠）到工作区作用域缓存。
 			* @author ddj 2026年08月28号
 			* @param path 要保存的文件路径（缺省 = 当前 active）
 			*/
@@ -4545,9 +4722,10 @@ window.__ModuleLoader__.load({
 					const state = ed.saveViewState();
 					if (!state) return;
 					viewStatesRef.current = upsertViewState(viewStatesRef.current, target, state);
-					viewStatesSave(sessionId, viewStatesRef.current);
+					viewStatesSave(scope, viewStatesRef.current);
 				} catch (e) {}
 			};
+			saveViewStateRef.current = saveViewState;
 			/**
 			* 恢复指定文件的视图状态（内容就绪、setModel 后调用；恢复后即消费删除）。
 			* @author ddj 2026年08月28号
@@ -5038,11 +5216,12 @@ window.__ModuleLoader__.load({
 				};
 			}, [sessionId, layout]);
 			react.default.useEffect(() => {
-				if (bootRef.current || !sessionId) return;
-				bootRef.current = true;
-				viewStatesRef.current = viewStatesLoad(sessionId);
+				if (!sessionId || restoredScopeRef.current === scope) return;
+				restoredScopeRef.current = scope;
+				modelsRef.current = modelsForScope(scope);
+				viewStatesRef.current = viewStatesLoad(scope);
 				try {
-					const raw = localStorage.getItem(CACHE_KEY.editor + String(sessionId));
+					const raw = localStorage.getItem(CACHE_KEY.editor + String(scope));
 					if (raw) {
 						const saved = JSON.parse(raw);
 						if (Array.isArray(saved.tabs) && saved.tabs.length) {
@@ -5051,20 +5230,20 @@ window.__ModuleLoader__.load({
 						}
 					}
 				} catch (e) {}
-			}, [sessionId]);
+			}, [sessionId, scope]);
 			react.default.useEffect(() => {
-				navRef.current = createNavHistory();
+				navRef.current = navHistoryFor(scope);
 				navPendingRef.current = null;
 				if (navCursorTimerRef.current) {
 					clearTimeout(navCursorTimerRef.current);
 					navCursorTimerRef.current = null;
 				}
 				setNavTick((v) => v + 1);
-			}, [sessionId]);
+			}, [scope]);
 			react.default.useEffect(() => {
 				if (!sessionId) return;
 				try {
-					localStorage.setItem(CACHE_KEY.editor + String(sessionId), JSON.stringify({
+					localStorage.setItem(CACHE_KEY.editor + String(scope), JSON.stringify({
 						tabs: tabs.map((t) => t.path),
 						active
 					}));
@@ -5072,9 +5251,10 @@ window.__ModuleLoader__.load({
 			}, [
 				tabs,
 				active,
-				sessionId
+				sessionId,
+				scope
 			]);
-			const sidebarKey = CACHE_KEY.sidebar + (layout === "side" ? "side." : "") + String(sessionId);
+			const sidebarKey = CACHE_KEY.sidebar + (layout === "side" ? "side." : "") + String(scope);
 			react.default.useEffect(() => {
 				if (!sessionId) return;
 				try {
@@ -5259,8 +5439,9 @@ window.__ModuleLoader__.load({
 				const cache = modelsRef.current;
 				let model = cache.get(path);
 				if (!model) {
-					model = window.monaco.editor.createModel(text ?? "", langOf(path), window.monaco.Uri.parse("edrv:///" + encodeURI(path)));
-					cache.set(path, model);
+					const uri = window.monaco.Uri.parse("edrv:///" + encodeURI(path));
+					model = window.monaco.editor.getModel(uri) || window.monaco.editor.createModel(text ?? "", langOf(path), uri);
+					rememberModel(cache, path, model);
 				} else if (text !== void 0 && model.getValue() !== text) {
 					programmaticRef.current = true;
 					model.setValue(text);
@@ -5382,14 +5563,13 @@ window.__ModuleLoader__.load({
 			]);
 			react.default.useEffect(() => () => {
 				flushSave();
-				saveViewState(active);
+				flushNavCursor();
+				saveViewStateRef.current?.();
 				diffRendererRef.current?.dispose?.();
 				if (editorRef.current) {
 					editorRef.current.dispose();
 					editorRef.current = null;
 				}
-				for (const m of modelsRef.current.values()) m.dispose();
-				modelsRef.current.clear();
 				for (const ctl of pdfCtlRef.current.values()) ctl.destroy();
 				pdfCtlRef.current.clear();
 				const root = editorRef.current && editorRef.current.getDomNode ? editorRef.current.getDomNode() : null;
@@ -6317,7 +6497,8 @@ window.__ModuleLoader__.load({
 			const sidebarPanels = props.sidebarPanels;
 			const sidebarCtx = {
 				sessionId,
-				cwd: props.sessions?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd ?? null,
+				cwd: cwd ?? null,
+				scope,
 				openFile: (p) => openFile(p, false),
 				openFileAt,
 				activePath: active,
@@ -7120,6 +7301,59 @@ window.__ModuleLoader__.load({
 				if (typeof bodyDisposer === "function") bodyDisposer();
 			};
 		}
+		/** 编辑 Tab 是否处于激活态（正文挂载 = 激活；模块级，跨会话存活）。 */
+		let editorTabActive = false;
+		/** 正文挂载纪元（每次挂载自增；延迟判定期间有新挂载则放弃清除）。 */
+		let mountEpoch = 0;
+		/**
+		* 标记编辑 Tab 激活并推进挂载纪元（正文挂载时调用）。
+		* @author ddj 2026年09月09号
+		*/
+		function markEditorMounted() {
+			mountEpoch += 1;
+			markEditorActive$1(true);
+		}
+		/**
+		* 直接设置激活标记（正文卸载延迟判定用；测试 also 用作状态编排入口）。
+		* @author ddj 2026年09月09号
+		* @param active 是否激活
+		*/
+		function markEditorActive$1(active) {
+			editorTabActive = active;
+		}
+		/**
+		* 读编辑 Tab 激活标记（会话切换时决定是否自动恢复编辑栏）。
+		* @author ddj 2026年09月09号
+		* @returns 上次标记的激活状态
+		*/
+		function isEditorTabActive() {
+			return editorTabActive;
+		}
+		/**
+		* 读当前挂载纪元（卸载延迟判定用：纪元已推进 = 有新正文接管，不清标记）。
+		* @author ddj 2026年09月09号
+		* @returns 当前纪元
+		*/
+		function editorMountEpoch() {
+			return mountEpoch;
+		}
+		/**
+		* 在挂载会话恢复编辑 Tab：已激活跳过（官方幂等）；seat 未就绪抛错时有界重试。
+		* openTab 官方语义「打开即展开侧栏」，一次调用同时完成展开 + 激活。
+		* @author ddj 2026年09月09号
+		* @param service 官方 sidebarRight 服务（缺失/未装配直接返回）
+		* @param schedule 延时调度（ctx.timeout；重试节拍）
+		* @param attempts 剩余尝试次数（默认 10 次 × 150ms ≈ 1.5s 窗口）
+		*/
+		function restoreEditorTab(service, schedule, attempts = 10) {
+			if (!service || typeof service.openTab !== "function" || !editorTabActive) return;
+			try {
+				if (service.active?.()?.kind === "edrvEditor") return;
+				service.openTab(OFFICIAL_TAB_KIND, {});
+			} catch {
+				if (attempts > 1) schedule(() => restoreEditorTab(service, schedule, attempts - 1), 150);
+			}
+		}
 		//#endregion
 		//#region src/client/fileOpeners.ts
 		/**
@@ -9874,9 +10108,24 @@ window.__ModuleLoader__.load({
 			}
 			const revision = typeof navigation?.revision === "number" ? navigation.revision : -1;
 			const revisionRef = react.default.useRef(-1);
+			const sessionIdRef = react.default.useRef(sessionId);
+			sessionIdRef.current = sessionId;
 			react.default.useEffect(() => {
 				setSideEditorMounted(true);
-				return () => setSideEditorMounted(false);
+				markEditorMounted();
+				return () => {
+					setSideEditorMounted(false);
+					const epoch = editorMountEpoch();
+					const self = sessionIdRef.current;
+					const schedule = props?.schedule;
+					const decide = () => {
+						if (editorMountEpoch() !== epoch) return;
+						const current = props?.sessions?.list?.getSnapshot?.()?.current;
+						markEditorActive(current === self);
+					};
+					if (typeof schedule === "function") schedule(decide, 0);
+					else decide();
+				};
 			}, []);
 			react.default.useEffect(() => {
 				if (revision === revisionRef.current) return;
@@ -10103,7 +10352,7 @@ window.__ModuleLoader__.load({
 		* 键前缀统一走 paths.ts PathConst（CACHE_KEY.expanded）。
 		* 作者 ddj 2026-08-28
 		*/
-		/** localStorage 键前缀（按会话隔离）。 */
+		/** localStorage 键前缀（按工作区作用域隔离，无 cwd 会话回退会话键）。 */
 		const KEY_PREFIX$1 = CACHE_KEY.expanded;
 		/**
 		* 归一化展开路径：去空白、反斜杠→斜杠、去首尾斜杠，`..` 段拒绝。
@@ -10175,27 +10424,27 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/**
-		* 读取某会话的展开状态缓存（localStorage 不可用 → null）。
+		* 读取某作用域的展开状态缓存（localStorage 不可用 → null）。
 		* @author ddj 2026年08月28号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @returns 缓存数据或 null
 		*/
-		function explorerLoad(sessionId) {
+		function explorerLoad(scope) {
 			try {
-				return parseExplorer(window.localStorage.getItem(KEY_PREFIX$1 + String(sessionId)));
+				return parseExplorer(window.localStorage.getItem(KEY_PREFIX$1 + String(scope)));
 			} catch (error) {
 				return null;
 			}
 		}
 		/**
-		* 写入某会话的展开状态缓存（损坏/配额满 → 忽略）。
+		* 写入某作用域的展开状态缓存（损坏/配额满 → 忽略）。
 		* @author ddj 2026年08月28号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @param data 缓存数据
 		*/
-		function explorerSave(sessionId, data) {
+		function explorerSave(scope, data) {
 			try {
-				window.localStorage.setItem(KEY_PREFIX$1 + String(sessionId), serializeExplorer(data));
+				window.localStorage.setItem(KEY_PREFIX$1 + String(scope), serializeExplorer(data));
 			} catch (error) {}
 		}
 		//#endregion
@@ -10260,9 +10509,9 @@ window.__ModuleLoader__.load({
 				return null;
 			}
 		}
-		/** sessionId → 缓存镜像（同步读，避免每次渲染 parse）。 */
+		/** scope → 缓存镜像（同步读，避免每次渲染 parse）。 */
 		const mirrors = /* @__PURE__ */ new Map();
-		/** sessionId → 落盘防抖计时器。 */
+		/** scope → 落盘防抖计时器。 */
 		const saveTimers = /* @__PURE__ */ new Map();
 		/** 单调时钟：连续 put 的 ts 严格递增（同毫秒不并列，逐出顺序可预期）。 */
 		let clock = 0;
@@ -10272,82 +10521,82 @@ window.__ModuleLoader__.load({
 			return clock;
 		}
 		/** localStorage 读取（不可用 → null）。 */
-		function readRaw(sessionId) {
+		function readRaw(scope) {
 			try {
-				return window.localStorage.getItem(KEY_PREFIX + sessionId);
+				return window.localStorage.getItem(KEY_PREFIX + scope);
 			} catch (error) {
 				return null;
 			}
 		}
 		/** localStorage 写入（配额/隐私模式失败静默）。 */
-		function writeRaw(sessionId, text) {
+		function writeRaw(scope, text) {
 			try {
-				window.localStorage.setItem(KEY_PREFIX + sessionId, text);
+				window.localStorage.setItem(KEY_PREFIX + scope, text);
 			} catch (error) {}
 		}
-		/** 取（或建）会话缓存镜像。 */
-		function mirrorOf(sessionId) {
-			const existing = mirrors.get(sessionId);
+		/** 取（或建）作用域缓存镜像。 */
+		function mirrorOf(scope) {
+			const existing = mirrors.get(scope);
 			if (existing) return existing;
-			const data = entriesParse(readRaw(sessionId)) ?? {
+			const data = entriesParse(readRaw(scope)) ?? {
 				v: 2,
 				root: null,
 				dirs: {}
 			};
-			mirrors.set(sessionId, data);
+			mirrors.set(scope, data);
 			return data;
 		}
 		/** 调度防抖落盘（重置已有计时器）。 */
-		function scheduleSave(sessionId) {
-			const prev = saveTimers.get(sessionId);
+		function scheduleSave(scope) {
+			const prev = saveTimers.get(scope);
 			if (prev) clearTimeout(prev);
-			saveTimers.set(sessionId, setTimeout(() => {
-				saveTimers.delete(sessionId);
-				const data = mirrors.get(sessionId);
-				if (data) writeRaw(sessionId, entriesSerialize(entriesTrim(data)));
+			saveTimers.set(scope, setTimeout(() => {
+				saveTimers.delete(scope);
+				const data = mirrors.get(scope);
+				if (data) writeRaw(scope, entriesSerialize(entriesTrim(data)));
 			}, 300));
 		}
 		/**
 		* 读某目录缓存条目（无 → null；展示不受新鲜度限制）。
 		* @author ddj 2026年08月31号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @param rel 目录相对路径（'' = 根）
 		* @returns 缓存条目或 null
 		*/
-		function entriesCacheGet(sessionId, rel) {
-			if (!sessionId) return null;
-			const dir = mirrorOf(sessionId).dirs[rel];
+		function entriesCacheGet(scope, rel) {
+			if (!scope) return null;
+			const dir = mirrorOf(scope).dirs[rel];
 			if (!dir || !dir.entries.length) return null;
 			return dir.entries;
 		}
 		/**
 		* 某目录缓存是否新鲜（预取去重用）。
 		* @author ddj 2026年08月31号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @param rel 目录相对路径
 		* @returns 新鲜返回 true
 		*/
-		function entriesCacheIsFresh(sessionId, rel) {
-			if (!sessionId) return false;
-			const dir = mirrorOf(sessionId).dirs[rel];
+		function entriesCacheIsFresh(scope, rel) {
+			if (!scope) return false;
+			const dir = mirrorOf(scope).dirs[rel];
 			return Boolean(dir && Date.now() - dir.ts < 3e4);
 		}
 		/**
 		* 写入某目录缓存条目（内存镜像 + 防抖落盘；单目录条目截断）。
 		* @author ddj 2026年08月31号
-		* @param sessionId 会话 id
+		* @param scope 作用域键（scopeStore.workspaceScopeOf 产物）
 		* @param rel 目录相对路径
 		* @param entries 目录条目
 		*/
-		function entriesCachePut(sessionId, rel, entries) {
-			if (!sessionId) return;
-			const data = mirrorOf(sessionId);
+		function entriesCachePut(scope, rel, entries) {
+			if (!scope) return;
+			const data = mirrorOf(scope);
 			data.dirs[rel] = {
 				ts: nextTs(),
 				entries: entries.slice(0, 500)
 			};
 			data.dirs = entriesTrim(data).dirs;
-			scheduleSave(sessionId);
+			scheduleSave(scope);
 		}
 		//#endregion
 		//#region src/client/sidebar/panels/FileExplorer.ts
@@ -10379,6 +10628,7 @@ window.__ModuleLoader__.load({
 		function FileExplorer(props) {
 			const ctx = props?.ctx;
 			const sessionId = ctx?.sessionId;
+			const scope = ctx?.scope ?? workspaceScopeOf(null, sessionId);
 			const openFile = ctx?.openFile;
 			const activePath = ctx?.activePath ?? null;
 			const pendingByPath = ctx?.pendingByPath ?? {};
@@ -10399,14 +10649,14 @@ window.__ModuleLoader__.load({
 			const loadDirRef = react.default.useRef(null);
 			const refreshRef = react.default.useRef(null);
 			/** 渲染取数：内存态 → 本地条目缓存 → null（显示加载态）。 */
-			const entriesOf = (rel) => dirsRef.current[rel] ?? entriesCacheGet(sessionId, rel) ?? null;
+			const entriesOf = (rel) => dirsRef.current[rel] ?? entriesCacheGet(scope, rel) ?? null;
 			/** 预取子目录：≤4 个、排除重型目录、缓存新鲜跳过、已加载跳过、不级联。 */
 			const prefetchDirs = (rel, entries) => {
 				const want = [];
 				for (const e of entries) {
 					if (e.type !== "directory") continue;
 					if (PREFETCH_EXCLUDED.has(e.name)) continue;
-					if (entriesCacheIsFresh(sessionId, e.path)) continue;
+					if (entriesCacheIsFresh(scope, e.path)) continue;
 					if (dirsRef.current[e.path] !== void 0) continue;
 					want.push(e.path);
 					if (want.length >= PREFETCH_MAX) break;
@@ -10439,7 +10689,7 @@ window.__ModuleLoader__.load({
 					if (res && res.ok && Array.isArray(res.entries)) {
 						setDirs((prev) => Object.assign({}, prev, { [rel]: res.entries }));
 						if (res.root) setRoot((prev) => prev || res.root);
-						entriesCachePut(sessionId, rel, res.entries);
+						entriesCachePut(scope, rel, res.entries);
 						if (doPrefetch) prefetchDirs(rel, res.entries);
 					} else if (!entriesOf(rel)) setErrors((prev) => Object.assign({}, prev, { [rel]: res?.error ? String(res.error) : "读取目录失败" }));
 				}).catch((e) => {
@@ -10492,7 +10742,7 @@ window.__ModuleLoader__.load({
 				setErrors({});
 				setMenu(null);
 				setRoot(null);
-				const cached = sessionId ? explorerLoad(sessionId) : null;
+				const cached = scope ? explorerLoad(scope) : null;
 				const restored = cached?.expanded ?? [];
 				if (cached?.root) setRoot(cached.root);
 				if (restored.length) {
@@ -10502,17 +10752,17 @@ window.__ModuleLoader__.load({
 				}
 				loadDir("", { prefetch: true });
 				for (const rel of restored) if (rel) loadDir(rel, { prefetch: true });
-			}, [sessionId]);
+			}, [scope]);
 			react.default.useEffect(() => {
 				if (saveTimerRef.current) {
 					clearTimeout(saveTimerRef.current);
 					saveTimerRef.current = null;
 				}
-				if (!sessionId) return;
+				if (!scope) return;
 				saveTimerRef.current = setTimeout(() => {
 					saveTimerRef.current = null;
 					const expandedList = Object.keys(expanded).filter((k) => expanded[k] === true);
-					explorerSave(sessionId, {
+					explorerSave(scope, {
 						root,
 						expanded: expandedList
 					});
@@ -10526,7 +10776,7 @@ window.__ModuleLoader__.load({
 			}, [
 				expanded,
 				root,
-				sessionId
+				scope
 			]);
 			react.default.useEffect(() => {
 				const onRefresh = () => refreshRef.current?.();
@@ -10534,14 +10784,14 @@ window.__ModuleLoader__.load({
 				return () => window.removeEventListener("edrv:refresh", onRefresh);
 			}, []);
 			react.default.useEffect(() => {
-				if (!sessionId) return;
+				if (!scope) return;
 				const timer = setInterval(() => {
 					const open = Object.keys(expandedRef.current).filter((k) => expandedRef.current[k] === true);
 					if (!open.length) return;
 					for (const rel of open) loadDirRef.current?.(rel, {});
 				}, FOLLOW_INTERVAL_MS);
 				return () => clearInterval(timer);
-			}, [sessionId]);
+			}, [scope]);
 			const rootName = root ? String(root).split(/[\\/]/).pop() || root : "";
 			const rowEl = (e, depth, isDir, isOpen) => {
 				const pending = isDir ? 0 : pendingByPath[e.path] ?? 0;
@@ -10680,6 +10930,7 @@ window.__ModuleLoader__.load({
 		function SearchPanel(props) {
 			const ctx = props?.ctx;
 			const sessionId = ctx?.sessionId;
+			const scope = ctx?.scope ?? workspaceScopeOf(null, sessionId);
 			const openFileAt = ctx?.openFileAt ?? (() => {});
 			const activePath = ctx?.activePath ?? null;
 			const [query, setQuery] = react.default.useState("");
@@ -10719,9 +10970,9 @@ window.__ModuleLoader__.load({
 				exclude: excludeOn ? splitGlobs(excludeText) : []
 			};
 			react.default.useEffect(() => {
-				if (!sessionId) return;
+				if (!scope) return;
 				try {
-					const saved = JSON.parse(localStorage.getItem(CACHE_KEY.search + String(sessionId)) || "null");
+					const saved = JSON.parse(localStorage.getItem(CACHE_KEY.search + String(scope)) || "null");
 					if (saved && typeof saved === "object") {
 						if (typeof saved.query === "string") setQuery(saved.query);
 						if (typeof saved.matchCase === "boolean") setMatchCase(saved.matchCase);
@@ -10734,11 +10985,11 @@ window.__ModuleLoader__.load({
 						if (typeof saved.sectionOpen === "boolean") setSectionOpen(saved.sectionOpen);
 					}
 				} catch (e) {}
-			}, [sessionId]);
+			}, [scope]);
 			react.default.useEffect(() => {
-				if (!sessionId) return;
+				if (!scope) return;
 				try {
-					localStorage.setItem(CACHE_KEY.search + String(sessionId), JSON.stringify({
+					localStorage.setItem(CACHE_KEY.search + String(scope), JSON.stringify({
 						query,
 						matchCase,
 						wholeWord,
@@ -10751,7 +11002,7 @@ window.__ModuleLoader__.load({
 					}));
 				} catch (e) {}
 			}, [
-				sessionId,
+				scope,
 				query,
 				matchCase,
 				wholeWord,
@@ -12622,6 +12873,23 @@ window.__ModuleLoader__.load({
 					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");
+			}
 			const originalOpenPath = workspaces?.openPath;
 			const binder = pickSettingsBinder(ctx);
 			const settings = binder.scope;