dsh-vscode-mode 0.1.59 → 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,
@@ -6343,7 +6524,7 @@ window.__ModuleLoader__.load({
 			const copyInstallCmd = () => {
 				if (navigator.clipboard?.writeText) navigator.clipboard.writeText(SIDEBAR_INSTALL_CMD).catch(() => {});
 			};
-			const sideHintEl = layout === "tab" && sideHint && !hintDismissed ? react.default.createElement("div", { className: "edrv-side-hint" }, react.default.createElement("span", { className: "edrv-side-hint-text" }, "安装 dsh-better-sidebar 后可启用侧边栏编辑（对话+编辑同屏）："), react.default.createElement("code", { className: "edrv-side-hint-cmd" }, SIDEBAR_INSTALL_CMD), react.default.createElement("button", {
+			const sideHintEl = layout === "tab" && sideHint && !hintDismissed ? react.default.createElement("div", { className: "edrv-side-hint" }, react.default.createElement("span", { className: "edrv-side-hint-text" }, "DSH 0.1.5+ 自带官方右侧侧边栏（升级即用）；旧版可安装 dsh-better-sidebar 启用侧边栏编辑（对话+编辑同屏）："), react.default.createElement("code", { className: "edrv-side-hint-cmd" }, SIDEBAR_INSTALL_CMD), react.default.createElement("button", {
 				className: "edrv-pill edrv-pill-ghost",
 				title: "复制安装命令",
 				onClick: copyInstallCmd
@@ -6883,14 +7064,307 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/officialSidebar.ts
+		/**
+		* dsh-vscode-mode client — 官方右侧 Sidebar 桥：探测 DSH 0.1.5-alpha.1+ 的
+		* ctx.sidebarRightTabs / ctx.sidebarRight 服务，两段式注册「文件编辑」Tab
+		* （类型定义进注册表，正文进 keyed slot sidebar.right.pane.tab）。
+		* 可选依赖模式：服务缺失时调用方回退 better-sidebar / 中央页签；本模块不注册任何东西。
+		* 维护约定：官方侧边栏（DSH 0.1.5+）是侧边栏编辑形态的唯一维护面；
+		* dsh-better-sidebar 桥（sidebarBridge.ts）已归档，仅作旧版 DSH 回退，不再新增能力。
+		* 纯逻辑（探测/导航参数解析）可单测，注册装配仅存在于 install 路径。
+		* 作者 ddj 2026年09月09号
+		*/
+		/** 官方 Tab 类型注册表服务名（ctx.get 用；不进 inject——旧版 DSH 无此包，inject 会停等）。 */
+		const OFFICIAL_TABS_SERVICE = "sidebarRightTabs";
+		/** 官方导航控制器服务名（ctx.get 用）。 */
+		const OFFICIAL_SERVICE = "sidebarRight";
+		/** 官方 keyed slot 名（Tab 正文挂点，由官方侧边栏的 rightbar seat 声明）。 */
+		const OFFICIAL_SLOT_NAME = "sidebar.right.pane.tab";
+		/** 本插件 Tab 类型定义 id（官方约定用包名；正文 slot 的 key 与之相同）。 */
+		const OFFICIAL_TAB_ID = "dsh-vscode-mode";
+		/** 本插件 Tab 的类型判别符（ctx.sidebarRight.openTab 的 kind）。 */
+		const OFFICIAL_TAB_KIND = "edrvEditor";
+		/** Tab 标题（与 better-sidebar 形态一致）。 */
+		const OFFICIAL_TAB_TITLE = "文件编辑";
+		/** file 地址认领的 patterns（extension 档接管官方 textpreview 的 fallback 认领，注销自动回落）。 */
+		const OFFICIAL_FILE_PATTERN = "dsh-resource://file/**";
+		/** file 资源类型的定义 id（正文 slot 的 key）。 */
+		const OFFICIAL_FILE_TAB_ID = "dsh-vscode-mode/file";
+		/** file 资源类型的 kind（与页类型 edrvEditor 区分：同 kind 只允许一份 extension）。 */
+		const OFFICIAL_FILE_KIND = "edrvEditorFile";
+		/**
+		* 结构化探测官方右侧 Sidebar 服务（可选依赖：缺失/降级返回 undefined）。
+		* 服务仅存在于 DSH 0.1.5-alpha.1+，探测命中 ≡ 版本判定成立。
+		* @author ddj 2026年09月09号
+		* @param ctx 客户端服务上下文
+		* @returns 注册表与控制器对，或 undefined
+		*/
+		function detectOfficial(ctx) {
+			try {
+				const tabs = ctx.get(OFFICIAL_TABS_SERVICE);
+				const service = ctx.get(OFFICIAL_SERVICE);
+				if (!tabs || typeof tabs.register !== "function") return void 0;
+				if (!service || typeof service.openTab !== "function") return void 0;
+				return {
+					tabs,
+					service
+				};
+			} catch {
+				return;
+			}
+		}
+		/**
+		* 从官方导航参数安全解析打开请求（缺字段/坏类型一律降级为空请求，不抛错）。
+		* @author ddj 2026年09月09号
+		* @param params openTab 传入的 params（正文经 navigation.params 读回）
+		* @returns 待打开路径与是否聚焦首个差异
+		*/
+		function resolveNavOpen(params) {
+			const value = params ?? {};
+			return {
+				path: typeof value?.openPath === "string" && value.openPath ? value.openPath : null,
+				focusDiff: value?.focusDiff === true
+			};
+		}
+		/** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
+		function decodeSegment(raw) {
+			if (raw === void 0) return null;
+			try {
+				return decodeURIComponent(raw);
+			} catch {
+				return null;
+			}
+		}
+		/**
+		* 解析官方 file 资源地址（镜像 dsh-util-workspace-path 的 parseFileAddress 语法，不 import 官方包）。
+		* session 域：`dsh-resource://file/session/<sessionId>/<逐段编码的相对路径>`；
+		* absolute 域：`dsh-resource://file/absolute/<去前导 / 的绝对路径>`（POSIX 补回前导 /，
+		* Windows 盘符 `C:/` 原样，UNC 保留空首段 `//server/share`）。
+		* @author ddj 2026年09月09号
+		* @param address 候选地址
+		* @returns 文件路径（session 域附带 sessionId）；非 file 地址/畸形/解码失败返回 null
+		*/
+		function parseOfficialFileAddress(address) {
+			if (typeof address !== "string" || !address.startsWith("dsh-resource://file/")) return null;
+			const [scope, ...tail] = address.slice(20).split("/");
+			const kind = decodeSegment(scope);
+			if (kind === "session") {
+				const sessionId = decodeSegment(tail[0]);
+				const segments = tail.slice(1).map(decodeSegment);
+				if (!sessionId || segments.length === 0 || segments.some((s) => s === null)) return null;
+				const path = segments.join("/");
+				return path ? {
+					path,
+					sessionId
+				} : null;
+			}
+			if (kind === "absolute") {
+				const unc = tail[0] === "" && tail.length > 1;
+				const segments = (unc ? tail.slice(1) : tail).map(decodeSegment);
+				if (segments.length === 0 || segments[0] === "" || segments.some((s) => s === null)) return null;
+				const list = segments;
+				if (unc) return { path: "//" + list.join("/") };
+				if (/^[A-Za-z]:$/.test(list[0])) return { path: list.join("/") };
+				return { path: "/" + list.join("/") };
+			}
+			return null;
+		}
+		/**
+		* file 地址的 Tab chip 标题：解码后的 basename（解码失败回退原始串切片）。
+		* @author ddj 2026年09月09号
+		* @param address file 资源地址
+		* @returns 标题文本
+		*/
+		function officialFileTitle(address) {
+			const source = parseOfficialFileAddress(address)?.path ?? (typeof address === "string" ? address : "");
+			const normalized = source.replace(/\\/g, "/");
+			return normalized.slice(normalized.lastIndexOf("/") + 1) || source;
+		}
+		/** component 编码一段（对齐官方 encodeSegment：盘符冒号保持字面）。 */
+		function encodeSegment(segment) {
+			return encodeURIComponent(segment).replace(/%3A/gi, ":");
+		}
+		/**
+		* 构造官方 file 资源地址（镜像 fileAddressFor 的分派：绝对路径→absolute 域，相对→session 域）。
+		* @author ddj 2026年09月09号
+		* @param path 绝对或工作区相对路径（两种分隔符均可）
+		* @param sessionId 会话 id（相对路径必需；绝对路径可省）
+		* @returns `dsh-resource://file/…` 地址
+		* @throws 路径为空，或相对路径缺 sessionId
+		*/
+		function buildFileAddress(path, sessionId) {
+			const posix = (typeof path === "string" ? path : "").replace(/\\/g, "/");
+			if (!posix.trim()) throw new Error("buildFileAddress：路径为空");
+			if (posix.startsWith("/") || posix.startsWith("//") || /^[A-Za-z]:[/\\]/.test(posix)) {
+				const unc = posix.startsWith("//");
+				const body = posix.replace(/^\/+/, "");
+				return "dsh-resource://file/absolute/" + (unc ? "/" : "") + body.split("/").map(encodeSegment).join("/");
+			}
+			if (!sessionId) throw new Error("buildFileAddress：相对路径需要会话 id");
+			const relative = posix.replace(/^(?:\.\/)+/, "").replace(/^\/+/, "");
+			return "dsh-resource://file/session/" + encodeSegment(sessionId) + "/" + relative.split("/").map(encodeSegment).join("/");
+		}
+		/**
+		* 注册官方 Tab 正文（keyed slot，key=定义 id；slots.inject 等待 rightbar seat 声明）。
+		* @author ddj 2026年09月09号
+		* @param slots slots 服务
+		* @param key 正文注册键（= 类型定义 id）
+		* @param renderTab 正文组件（包装后的 OfficialSideTab）
+		* @returns 注销函数；注册抛错返回 null
+		*/
+		function registerBodySlot(slots, key, renderTab) {
+			try {
+				const disposer = slots.inject(OFFICIAL_SLOT_NAME, () => slots.register({
+					name: OFFICIAL_SLOT_NAME,
+					key
+				}, renderTab));
+				return typeof disposer === "function" ? disposer : null;
+			} catch (error) {
+				log.warn("官方侧边栏正文 slot 注册失败（" + String(error) + "）");
+				return null;
+			}
+		}
+		/**
+		* 注册官方右侧 Sidebar「文件编辑」Tab 并接管打开路由（两段式 + 路由）。
+		* 调用方须把返回值挂进 ctx.effect；类型注册抛错时返回 null，由调用方回退旧形态。
+		* @author ddj 2026年09月09号
+		* @param options 装配参数（探测命中的一对服务 + slots + 正文组件 + guide 文案）
+		* @returns 卸载器（反注册类型与正文 + 撤销路由）；类型注册失败返回 null
+		*/
+		function installOfficial(options) {
+			const { tabs, service, slots, renderTab, guide } = options;
+			const open = (path, focusDiff) => {
+				try {
+					service.openTab(OFFICIAL_TAB_KIND, { params: {
+						openPath: path || void 0,
+						focusDiff
+					} });
+				} catch (error) {
+					log.warn("官方侧边栏打开失败（" + String(error) + "）");
+					return false;
+				}
+				return true;
+			};
+			let typeDisposer = null;
+			try {
+				typeDisposer = tabs.register({
+					id: OFFICIAL_TAB_ID,
+					kind: OFFICIAL_TAB_KIND,
+					priority: "extension",
+					title: () => OFFICIAL_TAB_TITLE,
+					guide: [{
+						order: 20,
+						title: guide.title,
+						description: guide.description
+					}]
+				});
+			} catch (error) {
+				log.warn("官方侧边栏 Tab 类型注册失败（" + String(error) + "），回退旧形态");
+				return null;
+			}
+			setEnsureSideEditor(open);
+			const bodyDisposer = registerBodySlot(slots, OFFICIAL_TAB_ID, renderTab);
+			return () => {
+				if (typeof typeDisposer === "function") typeDisposer();
+				if (typeof bodyDisposer === "function") bodyDisposer();
+				setEnsureSideEditor(null);
+			};
+		}
+		/**
+		* 注册官方 file 资源地址认领（extension 档接管 `dsh-resource://file/**`，
+		* 聊天文件链接/文件树打开改落本插件编辑器；注销后官方 textpreview 自动恢复）。
+		* 认领与否由「文件链接使用工具」设置驱动（见 fileOpeners.shouldClaimFiles）。
+		* @author ddj 2026年09月09号
+		* @param options 装配参数（探测命中的注册表 + slots + 正文组件）
+		* @returns 卸载器（反注册类型与正文）；类型注册抛错返回 null（回落官方查看器）
+		*/
+		function registerOfficialFileClaim(options) {
+			const { tabs, slots, renderTab } = options;
+			let typeDisposer = null;
+			try {
+				typeDisposer = tabs.register({
+					id: OFFICIAL_FILE_TAB_ID,
+					kind: OFFICIAL_FILE_KIND,
+					patterns: [OFFICIAL_FILE_PATTERN],
+					priority: "extension",
+					canOpen: (address) => parseOfficialFileAddress(address) !== null,
+					title: (address) => officialFileTitle(address)
+				});
+			} catch (error) {
+				log.warn("官方 file 地址认领注册失败（" + String(error) + "），链接走官方查看器");
+				return null;
+			}
+			const bodyDisposer = registerBodySlot(slots, OFFICIAL_FILE_TAB_ID, renderTab);
+			return () => {
+				if (typeof typeDisposer === "function") typeDisposer();
+				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
 		/**
 		* dsh-vscode-mode client — 文件打开器注册表与自动选择。
-		* @author ddj 2026年08月24号
+		* @author ddj 2026年08月24号 / 2026年09月09号
 		*/
 		const AUTO_OPEN_TOOL = "auto";
 		const VSCODE_OPEN_TOOL = "dsh-vscode-mode";
 		const SIDEBAR_OPEN_TOOL = SIDEBAR_PLUGIN;
+		/** 官方右侧侧边栏打开器 id（「文件链接使用工具」下拉的官方选项；DSH 0.1.5+）。 */
+		const OFFICIAL_OPEN_TOOL = "dsh-official-sidebar";
 		/**
 		* 写入外部打开器并触发注册表通知。
 		* @author ddj 2026年08月24号
@@ -7016,6 +7490,36 @@ window.__ModuleLoader__.load({
 			const normalized = path.replace(/\\/g, "/");
 			return normalized.slice(normalized.lastIndexOf("/") + 1) || path;
 		}
+		/**
+		* 文件链接是否由本插件认领官方 file 地址：自动/VSCodeMode 档接管（链接进本插件编辑器），
+		* 官方侧边栏/system/better-sidebar 档不认领（官方查看器或旧版路由生效）。
+		* @author ddj 2026年09月09号
+		* @param selected 「文件链接使用工具」当前值
+		* @returns 是否认领
+		*/
+		function shouldClaimFiles(selected) {
+			return selected === "auto" || selected === "dsh-vscode-mode";
+		}
+		/**
+		* 创建「官方侧边栏」文件打开器（DSH 0.1.5+，经 ctx.sidebarRight.openResource 打开官方查看器）。
+		* 仅官方服务探测命中时注册；下拉选项随注册动态出现（McpSettings 动态渲染）。
+		* @author ddj 2026年09月09号
+		* @param service 官方导航控制器
+		* @returns 文件打开器
+		*/
+		function officialSidebarOpener(service) {
+			return {
+				id: OFFICIAL_OPEN_TOOL,
+				label: "官方侧边栏",
+				description: "在 DSH 官方右侧侧边栏查看器中打开（0.1.5+）",
+				priority: 90,
+				isAvailable: () => typeof service.openResource === "function",
+				open: (path, context) => {
+					if (typeof service.openResource !== "function") throw new Error("官方侧边栏 openResource 能力不可用");
+					service.openResource(buildFileAddress(path, context.sessionId));
+				}
+			};
+		}
 		//#endregion
 		//#region src/client/settingsContext.ts
 		/**
@@ -9578,6 +10082,83 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/ui/OfficialSideTab.ts
+		/**
+		* dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」Tab 正文包装。
+		* 双用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff）打开；
+		* file 资源类型 Tab（edrvEditorFile，认领 dsh-resource://file/**）经 navigation.address
+		* 解码出真实路径并透传 params.line 行号定位。派发既有 edrv:open-editor 事件复用
+		* EditorView 打开流；按会话 key 保证切会话干净重建。
+		* Tab 正文切换后重挂载时按最新导航恢复打开（对齐 better-sidebar 形态的种子行为）。
+		* 作者 ddj 2026年09月09号
+		*/
+		/**
+		* 官方侧边栏 Tab 正文组件（keyed slot sidebar.right.pane.tab 装配）。
+		* @param props slot 框架注入（useTabInfo/sessionId）+ 装配依赖（schedule 等）
+		* @returns EditorView 侧栏形态
+		*/
+		function OfficialSideTab(props) {
+			const sessionId = props?.sessionId;
+			const useTabInfo = props?.useTabInfo;
+			let navigation;
+			if (typeof useTabInfo === "function") try {
+				navigation = useTabInfo()?.tab?.navigation;
+			} catch {
+				navigation = void 0;
+			}
+			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);
+				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;
+				revisionRef.current = revision;
+				if (revision <= 0) return;
+				const fileHit = parseOfficialFileAddress(navigation?.address);
+				if (fileHit) {
+					const line = navigation?.params?.line;
+					window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+						path: fileHit.path,
+						line: typeof line === "number" ? line : void 0
+					} }));
+					return;
+				}
+				const request = resolveNavOpen(navigation?.params);
+				window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
+					path: request.path,
+					focusDiff: request.focusDiff
+				} }));
+			});
+			return react.default.createElement(EditorView, {
+				key: sessionId,
+				sessionId,
+				layout: "side",
+				schedule: props?.schedule,
+				addToConversation: props?.addToConversation,
+				sidebarPanels: props?.sidebarPanels,
+				outlineSources: props?.outlineSources,
+				fileMenuItems: props?.fileMenuItems,
+				sessions: props?.sessions
+			});
+		}
+		//#endregion
 		//#region src/client/sidebar/registry.ts
 		/** 校验面板定义并写入注册表（缺 id/render 抛 TypeError）。 */
 		function panelRegister(entries, notify, panel) {
@@ -9771,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;
 		/**
 		* 归一化展开路径：去空白、反斜杠→斜杠、去首尾斜杠，`..` 段拒绝。
@@ -9843,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
@@ -9928,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;
@@ -9940,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
@@ -10047,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 ?? {};
@@ -10067,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;
@@ -10107,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) => {
@@ -10160,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) {
@@ -10170,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
 					});
@@ -10194,7 +10776,7 @@ window.__ModuleLoader__.load({
 			}, [
 				expanded,
 				root,
-				sessionId
+				scope
 			]);
 			react.default.useEffect(() => {
 				const onRefresh = () => refreshRef.current?.();
@@ -10202,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;
@@ -10348,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("");
@@ -10387,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);
@@ -10402,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,
@@ -10419,7 +11002,7 @@ window.__ModuleLoader__.load({
 					}));
 				} catch (e) {}
 			}, [
-				sessionId,
+				scope,
 				query,
 				matchCase,
 				wholeWord,
@@ -12232,8 +12815,8 @@ window.__ModuleLoader__.load({
 		//#region src/client/index.ts
 		/**
 		* dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
-		* 挂点：betterSidebar「文件编辑」Tab（侧边栏形态，对话+编辑同屏；未装 dsh-better-sidebar 时
-		* 回退 conversation.view 中央页签）+ conversation.input.dock 差异条 + header 差异角标。
+		* 挂点：官方右侧 Sidebar「文件编辑」Tab（DSH 0.1.5+，对话+编辑同屏）> betterSidebar Tab
+		* （归档，仅旧版 DSH 回退）> conversation.view 中央页签 + conversation.input.dock 差异条 + header 差异角标。
 		* 与 Host 通信：同源 fetch('/edrv/rpc')（shared/rpc 契约）。
 		*
 		* ⚠️ 跨版本 slot 装配（2026-08-21）：新版 DSH 的 slots 系统要求 slot 必须由父 entry
@@ -12290,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;
@@ -12309,6 +12909,10 @@ window.__ModuleLoader__.load({
 			};
 			/** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
 			let sideService = detectSidebarService(ctx);
+			/** 可选探测官方右侧 Sidebar（DSH 0.1.5-alpha.1+；探测命中 ≡ 版本判定，不进 inject 同上）。 */
+			let officialService = detectOfficial(ctx);
+			/** 官方 file 地址认领的当前注销器（null=未认领；由 syncFileClaim 依设置值切换）。 */
+			let claimDisposer = null;
 			/** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
 			const addToConversation = createAddToConversation(ctx);
 			/** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
@@ -12334,9 +12938,19 @@ window.__ModuleLoader__.load({
 					note: registry.get("dsh-better-sidebar") !== void 0 ? "已注册（优先级 80）" : "未检测到侧边栏打开能力"
 				},
 				{
-					name: "侧边栏编辑区（dsh-better-sidebar）",
+					name: "侧边栏编辑区（官方 Sidebar）",
+					active: officialService !== void 0,
+					note: officialService !== void 0 ? "编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）" : "官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）"
+				},
+				{
+					name: "侧边栏编辑区（dsh-better-sidebar，归档）",
 					active: sideService !== void 0,
-					note: sideService !== void 0 ? "编辑区=侧边栏 Tab（对话+编辑同屏）" : "未检测到；安装 dsh-better-sidebar 后刷新启用侧边栏形态（" + SIDEBAR_INSTALL_CMD + "）"
+					note: sideService !== void 0 ? "编辑区=侧边栏 Tab（旧版 DSH 回退形态）" : "未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（" + SIDEBAR_INSTALL_CMD + "）"
+				},
+				{
+					name: "文件链接官方认领（dsh-resource://file）",
+					active: claimDisposer !== null,
+					note: claimDisposer !== null ? "聊天文件链接由本插件编辑器接管（官方侧边栏内打开）" : "链接走官方查看器或旧版路由（未认领）"
 				}
 			];
 			ctx.provide("fileOpeners", registry);
@@ -12364,12 +12978,39 @@ window.__ModuleLoader__.load({
 				const sidebar = scanSidebar(ctx);
 				return sidebar ? registry.register(sidebar) : void 0;
 			}, "vscode-mode: sidebar file opener");
+			const officialRenderTab = (props) => react.default.createElement(OfficialSideTab, Object.assign({}, props, {
+				schedule,
+				addToConversation,
+				sidebarPanels,
+				outlineSources,
+				fileMenuItems,
+				sessions
+			}));
+			/** 官方 file 地址认领同步：自动/VSCodeMode 档认领（链接进本插件编辑器），其余交官方查看器。 */
+			const syncFileClaim = () => {
+				const official = officialService;
+				const want = official !== void 0 && shouldClaimFiles(selected);
+				if (want && claimDisposer === null && official) {
+					const disposer = registerOfficialFileClaim({
+						tabs: official.tabs,
+						slots: ctx.slots,
+						renderTab: officialRenderTab
+					});
+					if (disposer !== null) claimDisposer = ctx.effect(() => disposer, "vscode-mode: official file claim");
+					return;
+				}
+				if (!want && claimDisposer !== null) {
+					claimDisposer();
+					claimDisposer = null;
+				}
+			};
 			ctx.effect(() => {
 				if (!settings) return void 0;
 				const sync = () => {
 					const snapshot = settings.getSnapshot();
 					if (snapshot.status === "loading") return;
 					selected = autoValue(snapshot.value?.fileOpenTool);
+					syncFileClaim();
 					window.dispatchEvent(new CustomEvent("edrv:file-open-tool-change", { detail: { value: selected } }));
 				};
 				sync();
@@ -12442,11 +13083,50 @@ window.__ModuleLoader__.load({
 					sessions
 				})));
 			};
+			let officialDisposer = null;
 			let sideDisposer = null;
 			let legacyDisposer = null;
+			const installOfficialForm = () => {
+				const official = officialService;
+				if (officialDisposer !== null || !official) return;
+				if (sideDisposer !== null) {
+					sideDisposer();
+					sideDisposer = null;
+				}
+				if (legacyDisposer !== null) {
+					legacyDisposer();
+					legacyDisposer = null;
+				}
+				const outcome = installOfficial({
+					tabs: official.tabs,
+					service: official.service,
+					slots: ctx.slots,
+					renderTab: officialRenderTab,
+					guide: {
+						title: () => OFFICIAL_TAB_TITLE,
+						description: () => "Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）"
+					}
+				});
+				if (outcome === null) {
+					officialService = void 0;
+					applySideForm();
+					return;
+				}
+				officialDisposer = ctx.effect(() => outcome, "vscode-mode: official sidebar editor tab");
+				if (typeof official.service.openResource === "function") ctx.effect(() => registry.register(officialSidebarOpener(official.service)), "vscode-mode: official sidebar opener");
+				syncFileClaim();
+			};
 			const applySideForm = () => {
+				if (officialService) {
+					installOfficialForm();
+					return;
+				}
 				if (sideService) {
 					if (sideDisposer !== null) return;
+					if (officialDisposer !== null) {
+						officialDisposer();
+						officialDisposer = null;
+					}
 					if (legacyDisposer !== null) {
 						legacyDisposer();
 						legacyDisposer = null;
@@ -12472,28 +13152,41 @@ window.__ModuleLoader__.load({
 						},
 						registerLegacyFallback: registerLegacyTab
 					}), "vscode-mode: sidebar editor tab");
-				} else {
-					if (legacyDisposer !== null) return;
-					if (sideDisposer !== null) {
-						sideDisposer();
-						sideDisposer = null;
-					}
-					setEnsureSideEditor(null);
-					legacyDisposer = registerLegacyTab();
+					return;
 				}
+				if (legacyDisposer !== null) return;
+				if (officialDisposer !== null) {
+					officialDisposer();
+					officialDisposer = null;
+				}
+				if (sideDisposer !== null) {
+					sideDisposer();
+					sideDisposer = null;
+				}
+				setEnsureSideEditor(null);
+				legacyDisposer = registerLegacyTab();
 			};
 			applySideForm();
 			let sideRetries = 0;
 			const retrySideService = () => {
-				if (sideService !== void 0 || sideRetries >= 15) return;
+				if (officialService !== void 0 || sideRetries >= 15) return;
 				sideRetries += 1;
 				schedule(() => {
-					if (sideService !== void 0) return;
-					sideService = detectSidebarService(ctx);
-					if (sideService !== void 0) {
-						log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态");
+					if (officialService !== void 0) return;
+					officialService = detectOfficial(ctx);
+					if (officialService !== void 0) {
+						log.info("检测到官方右侧 Sidebar（DSH 0.1.5+），切换官方侧边栏编辑形态");
 						applySideForm();
-					} else retrySideService();
+						return;
+					}
+					if (sideService === void 0) {
+						sideService = detectSidebarService(ctx);
+						if (sideService !== void 0) {
+							log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态（官方未探测到，后续仍优先官方）");
+							applySideForm();
+						}
+					}
+					retrySideService();
 				}, 2e3);
 			};
 			retrySideService();