dsh-vscode-mode 0.1.59 → 0.1.60

package/README.md

@@ -4,11 +4,16 @@
 
 仿 VSCode 的 **Agent 文件编辑器 + 差异审查** DSH 插件：
 
-- **侧边栏「文件编辑」Tab**（v0.1.23，推荐）：检测到 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)
-  （`ctx.betterSidebar` 服务）时，编辑器注册为右侧栏 Tab——**AI 对话（中央）与文件编辑（右侧栏）同屏**，
-  类主流 Code Agent 布局；Tab 可拖到下方成底部面板（全宽）、支持分栏；文件打开/差异跳转自动展开面板。
-  **可选依赖**：未安装 dsh-better-sidebar 时自动回退旧「中央文件编辑页签」形态（插件零新依赖仍完整可用），
-  并在编辑器顶部与设置页「兼容性」子 Tab 引导安装（`dsh plugin --profile web add dsh-better-sidebar`）。
+- **侧边栏「文件编辑」Tab**（v0.1.60，推荐）：检测到 **DSH 0.1.5+ 官方右侧 Sidebar**（`ctx.sidebarRightTabs` /
+  `ctx.sidebarRight` 服务）时，编辑器注册为官方侧边栏 Tab——**AI 对话（中央）与文件编辑（右侧栏）同屏**，
+  类主流 Code Agent 布局；支持官方多标签/分栏/浮出/全屏，打开路由即开即展开；官方 Sidebar 引导页提供入口。
+  **优先级**：官方侧边栏与 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 同时可用时**官方优先**
+  （better-sidebar 桥已归档，仅作旧版 DSH 回退，不再新增能力）。旧版 DSH（< 0.1.5）沿用 better-sidebar 侧栏形态，
+  两者皆缺时回退旧「中央文件编辑页签」形态（插件零新依赖仍完整可用），
+  编辑器顶部与设置页「兼容性」子 Tab 会给出对应引导。
+  **文件链接（DSH 0.1.5+）**：聊天/文件树的文件链接经官方 `ctx.sidebarRight.openResource` 直达右侧栏——
+  「文件链接使用工具」为 自动/VSCodeMode 时本插件以 extension 档认领 `dsh-resource://file/**`（链接在本插件
+  Monaco 编辑器打开，含行号定位）；为「官方侧边栏」档时走官方文本查看器（不认领）；畸形地址自动回落官方查看器。
   文件页签（脏点/关闭/「+」打开）+ `Ctrl+P` 快速打开（QuickOpen）+ **Monaco Editor**
   （语法高亮/行号/`Ctrl+F`/`Ctrl+G`/`Ctrl+S`/700ms 防抖自动保存）+ 顶部工具栏（路径/语言/Ln,Col/保存状态/差异/侧边栏/刷新）
   + **导航历史**（后退/前进：跨文件恢复焦点位置，工具栏 `←`/`→` 按钮、键盘 `Alt+←/→` 与 `Ctrl+Alt+-`/`Ctrl+Shift+-`、
@@ -65,7 +70,8 @@
 
 ![侧边栏编辑形态：AI 对话与文件编辑同屏](docs/screenshots/img1.png)
 
-> dsh-vscode-mode 侧边栏编辑形态：betterSidebar 右侧栏内的 Monaco 文件编辑器与中央 AI 对话同屏，
+> dsh-vscode-mode 侧边栏编辑形态：右侧栏（DSH 0.1.5+ 官方 Sidebar / 旧版 betterSidebar）内的
+> Monaco 文件编辑器与中央 AI 对话同屏，
 > 差异条统一挂在对话输入框上方的原生 dock（编辑器未打开=「差异 N 个文件 · 查看下一个」，
 > 打开后=完整 Keep / Undo 操作条）。
 
@@ -148,9 +154,11 @@ src/
 ├── rpc.ts              Host RPC 分发表（类型化 handler 表替代巨型 switch，含 compat）
 ├── routes.ts           Host webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*，带冲突护栏）
 └── client/
-    ├── index.ts        Client 入口：slot 注册（inject=['slots','timer']）；betterSidebar 探测分流（侧栏 Tab / 旧页签回退）
+    ├── index.ts        Client 入口：slot 注册（inject=['slots','timer']）；官方/betterSidebar/中央页签三形态互斥分流（官方优先）
     ├── compat.ts       ★ Client 兼容层：设置桥三级降级（webUiSettings→settingsScope）、slot 安全注册、openPath 链式补丁、外部插件常量
-    ├── sidebarBridge.ts ★ 侧边栏编辑区桥：可选探测 ctx.betterSidebar、注册「文件编辑」Tab、打开路由/角标计数（纯函数可单测）
+    ├── sidebarBridge.ts ★ 侧边栏编辑区桥（归档）：可选探测 ctx.betterSidebar、注册「文件编辑」Tab、打开路由/角标计数（纯函数可单测）
+    ├── officialSidebar.ts ★ 官方右侧 Sidebar 桥（DSH 0.1.5+，唯一维护面）：探测 sidebarRightTabs/sidebarRight、
+    │                   两段式注册（类型定义 + keyed slot 正文）、openTab 路由（纯函数可单测）
     ├── rpc.ts          Client 类型化 fetch 包装 + 诊断日志
     ├── events.ts       窗口事件助手（edrv:refresh/open-editor/show-launcher；侧栏路由优先、旧页签回退）
     ├── state/          records.ts（摘要/计数/空差异）+ regions.ts（差异区域/行裁剪）纯函数
@@ -164,7 +172,8 @@ src/
     │                   + types.ts（SidebarPanelDef/SidebarCtx）+ panels/FileExplorer.ts（文件树面板 #1）
     │                   + panels/SearchPanel.ts（搜索面板）+ panels/RulesPanel.ts（规则面板：用户/项目规则 + 开关）
     ├── styles/editor.css  编辑区样式（tsdown CSS-inline 注入；含侧栏形态/引导条）
-    └── ui/             EditorView（编排，tab/side 双形态）/ SideEditorTab（betterSidebar Tab 包装）/ QuickOpen
+    └── ui/             EditorView（编排，tab/side 双形态）/ OfficialSideTab（官方 Sidebar Tab 包装）
+                        / SideEditorTab（betterSidebar Tab 包装，归档）/ QuickOpen
                         / DiffBox（chat/editor 双模式）/ ConversationDiffDock / DiffBarEmpty / DiffLauncher
                         / DiffBadge / McpSettings（含「兼容性」子 Tab）
 ```
@@ -203,8 +212,9 @@ curl -s -X POST http://127.0.0.1:3080/edrv/rpc -H 'content-type: application/jso
 - **RPC**：静态包经 webServer 精确路由 `/edrv/rpc`，Client 同源 fetch；载荷形状由 `shared/rpc` 类型化。
 - **批次/融合/归档**：每次新 edit/write 递增文件 batch，早于最新批次的未归档差异自动"融合"归档；
   每条差异处理完成（采纳/拒绝/被覆盖）立即单条归档；DiffLauncher「归档」页按批次浏览 + 回滚。
-- **Client 挂点**：betterSidebar Tab `edrv-editor`（侧栏形态，未装 dsh-better-sidebar 时回退 `conversation.view` 页签
-  id `edrv-editor`）+ `conversation.session.header.utilities`（id `edrv-diff-badge`）+ `conversation.input.dock`
+- **Client 挂点**：官方右侧 Sidebar Tab（DSH 0.1.5+：类型定义 id `dsh-vscode-mode`、kind `edrvEditor`，
+  正文挂 keyed slot `sidebar.right.pane.tab`；优先级最高）> betterSidebar Tab `edrv-editor`（归档，仅旧版回退）
+  > `conversation.view` 页签（id `edrv-editor`）+ `conversation.session.header.utilities`（id `edrv-diff-badge`）+ `conversation.input.dock`
   （id `edrv-diff-dock`，唯一差异栏：编辑器未打开=紧凑按钮，打开后=完整操作条）。内部路由/slot/事件/CSS 前缀沿用 `edrv-*`（防回归），包身份为 `dsh-vscode-mode`。
 - **⚠️ Host 改动需重启 DSH 应用**（Node ESM 模块缓存）；Client 经 `dsh-client-hmr` 热重载。
 

package/lib/client.js

@@ -6343,7 +6343,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 +6883,254 @@ 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();
+			};
+		}
+		//#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 +7256,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 +9848,68 @@ 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);
+			react.default.useEffect(() => {
+				setSideEditorMounted(true);
+				return () => setSideEditorMounted(false);
+			}, []);
+			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) {
@@ -12232,8 +12564,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
@@ -12309,6 +12641,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 +12670,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 +12710,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 +12815,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 +12884,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();