dsh-vscode-mode 0.1.59 → 0.1.60

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.59",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
+  "version": "0.1.60",
+  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
     "dsh-plugin",

package/src/client/fileOpeners.ts

@@ -1,13 +1,16 @@
 /**
  * dsh-vscode-mode client — 文件打开器注册表与自动选择。
- * @author ddj 2026年08月24号
+ * @author ddj 2026年08月24号 / 2026年09月09号
  */
 import { SIDEBAR_PLUGIN } from './compat.js'
+import { buildFileAddress } from './officialSidebar.js'
 
 export const AUTO_OPEN_TOOL = 'auto'
 export const SYSTEM_OPEN_TOOL = 'system'
 export const VSCODE_OPEN_TOOL = 'dsh-vscode-mode'
 export const SIDEBAR_OPEN_TOOL = SIDEBAR_PLUGIN
+/** 官方右侧侧边栏打开器 id（「文件链接使用工具」下拉的官方选项；DSH 0.1.5+）。 */
+export const OFFICIAL_OPEN_TOOL = 'dsh-official-sidebar'
 
 export interface FileOpenContext {
   sessionId?: string
@@ -171,3 +174,40 @@ export function baseName(path: string): string {
   const normalized = path.replace(/\\/g, '/')
   return normalized.slice(normalized.lastIndexOf('/') + 1) || path
 }
+
+/** 官方 sidebarRight.openResource 的最小结构面（结构性使用，不 import 官方类型）。 */
+export interface OfficialOpenResourceService {
+  openResource?: (address: string, options?: { params?: unknown }) => void
+}
+
+/**
+ * 文件链接是否由本插件认领官方 file 地址：自动/VSCodeMode 档接管（链接进本插件编辑器），
+ * 官方侧边栏/system/better-sidebar 档不认领（官方查看器或旧版路由生效）。
+ * @author ddj 2026年09月09号
+ * @param selected 「文件链接使用工具」当前值
+ * @returns 是否认领
+ */
+export function shouldClaimFiles(selected: unknown): boolean {
+  return selected === AUTO_OPEN_TOOL || selected === VSCODE_OPEN_TOOL
+}
+
+/**
+ * 创建「官方侧边栏」文件打开器（DSH 0.1.5+，经 ctx.sidebarRight.openResource 打开官方查看器）。
+ * 仅官方服务探测命中时注册；下拉选项随注册动态出现（McpSettings 动态渲染）。
+ * @author ddj 2026年09月09号
+ * @param service 官方导航控制器
+ * @returns 文件打开器
+ */
+export function officialSidebarOpener(service: OfficialOpenResourceService): FileOpener {
+  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))
+    },
+  }
+}

package/src/client/index.ts

@@ -1,7 +1,7 @@
 /**
  * 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
@@ -22,7 +22,7 @@ import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
 import { rpc } from './rpc.js'
 import { loadMonaco } from './monaco/loader.js'
-import { createFileOpenerRegistry, scanSidebar, type FileOpenContext } from './fileOpeners.js'
+import { createFileOpenerRegistry, scanSidebar, officialSidebarOpener, shouldClaimFiles, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
 import { patchRemoteOpen, probeRemoteOpen } from './remoteOpenRouter.js'
@@ -30,7 +30,9 @@ import { setupExtOpen } from './externalOpen.js'
 import { SettingsContext } from './settingsContext.js'
 import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
 import { detectSidebarService, installSideEditor, setEnsureSideEditor, SIDEBAR_INSTALL_CMD } from './sidebarBridge.js'
+import { detectOfficial, installOfficial, registerOfficialFileClaim, OFFICIAL_TAB_TITLE } from './officialSidebar.js'
 import { SideEditorTab } from './ui/SideEditorTab.js'
+import { OfficialSideTab } from './ui/OfficialSideTab.js'
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
@@ -113,6 +115,10 @@ export function apply(ctx: any): void {
   }
   /** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
   let sideService = detectSidebarService(ctx)
+  /** 可选探测官方右侧 Sidebar（DSH 0.1.5-alpha.1+；探测命中 ≡ 版本判定，不进 inject 同上）。 */
+  let officialService = detectOfficial(ctx)
+  /** 官方 file 地址认领的当前注销器（null=未认领；由 syncFileClaim 依设置值切换）。 */
+  let claimDisposer: (() => void) | null = null
   /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
   const addToConversation = createAddToConversation(ctx)
 
@@ -122,7 +128,9 @@ export function apply(ctx: any): void {
     { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开（0.1.2 及更早 DSH 的对话文件链接主路径）' },
     { name: '会话文件链接路由（remote.session.openWorkspacePath）', active: remoteOpenInstalled, note: '0.1.3+ 对话文件引用/产物打开优先走插件打开器，失败回退系统打开' },
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
-    { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（对话+编辑同屏）' : '未检测到；安装 dsh-better-sidebar 后刷新启用侧边栏形态（' + SIDEBAR_INSTALL_CMD + '）' },
+    { name: '侧边栏编辑区（官方 Sidebar）', active: officialService !== undefined, note: officialService !== undefined ? '编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）' : '官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）' },
+    { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '，归档）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（旧版 DSH 回退形态）' : '未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（' + SIDEBAR_INSTALL_CMD + '）' },
+    { name: '文件链接官方认领（dsh-resource://file）', active: claimDisposer !== null, note: claimDisposer !== null ? '聊天文件链接由本插件编辑器接管（官方侧边栏内打开）' : '链接走官方查看器或旧版路由（未认领）' },
   ]
 
   ctx.provide('fileOpeners', registry)
@@ -157,12 +165,29 @@ export function apply(ctx: any): void {
     const sidebar = scanSidebar(ctx)
     return sidebar ? registry.register(sidebar) : undefined
   }, 'vscode-mode: sidebar file opener')
+  // 官方侧边栏正文组件装配（页类型与 file 认领两类 Tab 共用同一 EditorView 形态）
+  const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions }))
+  /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（链接进本插件编辑器），其余交官方查看器。 */
+  const syncFileClaim = (): void => {
+    const official = officialService
+    const want = official !== undefined && 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 undefined
     const sync = (): void => {
       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()
@@ -222,8 +247,8 @@ export function apply(ctx: any): void {
   }
   retryRemoteOpen()
 
-  // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态可用时编辑器住 betterSidebar Tab，
-  // 本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。
+  // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态（官方/better-sidebar）可用时
+  // 编辑器住侧边栏 Tab，本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。
   const registerLegacyTab = (): (() => void) | null => {
     return registerSlotSafely(ctx, {
       name: 'conversation.view',
@@ -234,16 +259,51 @@ export function apply(ctx: any): void {
     }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions })))
   }
 
-  // 侧边栏/中央页签两形态互斥切换：sideDisposer（侧边栏 Tab）与 legacyDisposer（中央页签）只保留其一。
-  // ⚠️ betterSidebar 服务由 dsh-better-sidebar 的 client bundle（1MB+）在页面加载时提供，本插件
-  // bundle 较小往往先执行完启动检测——一次性探测会误报「未检测到」并永久停在中央页签形态（实测
-  // 竞态：better-sidebar 已装，但「文件编辑」Tab 未注册）。故启动后按 2s 间隔重试（窗口 ~30s），
-  // 命中即自动切换侧边栏形态；始终未命中则保持中央页签回退。
+  // 侧边栏三形态互斥切换：官方（DSH 0.1.5+）> better-sidebar（归档，仅旧版回退）> 中央页签。
+  // officialDisposer / sideDisposer / legacyDisposer 任一时刻只保留其一（避免双实例 Monaco 抢占）。
+  // ⚠️ 两个可选服务都可能晚于本插件就绪（better-sidebar bundle 1MB+ 后加载；官方服务旧 DSH
+  // 不存在），一次性探测会误报——故启动后按 2s 间隔重试（窗口 ~30s）：每 tick 先探官方再探
+  // better-sidebar；better-sidebar 先命中而官方后到时自动切换（官方优先），窗口结束仍未命中
+  // 则保持中央页签回退。
+  let officialDisposer: (() => void) | null = null
   let sideDisposer: (() => void) | null = null
   let legacyDisposer: (() => void) | null = null
+  const installOfficialForm = (): void => {
+    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) {
+      // 官方类型注册失败（API 变更等）：撤下官方标记，回退旧形态链
+      officialService = undefined
+      applySideForm()
+      return
+    }
+    officialDisposer = ctx.effect(() => outcome, 'vscode-mode: official sidebar editor tab')
+    // 官方打开器（下拉「官方侧边栏」选项，动态出现；openResource 能力缺失时跳过）+ 按当前设置同步 file 地址认领
+    if (typeof official.service.openResource === 'function') {
+      ctx.effect(() => registry.register(officialSidebarOpener(official.service)), 'vscode-mode: official sidebar opener')
+    }
+    syncFileClaim()
+  }
   const applySideForm = (): void => {
+    if (officialService) {
+      installOfficialForm()
+      return
+    }
     if (sideService) {
       if (sideDisposer !== null) return
+      if (officialDisposer !== null) { officialDisposer(); officialDisposer = null }
       if (legacyDisposer !== null) { legacyDisposer(); legacyDisposer = null }
       sideDisposer = ctx.effect(() => installSideEditor({
         service: sideService as NonNullable<typeof sideService>,
@@ -256,27 +316,35 @@ export function apply(ctx: any): void {
         },
         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 = (): void => {
-    if (sideService !== undefined || sideRetries >= 15) return
+    if (officialService !== undefined || sideRetries >= 15) return
     sideRetries += 1
     schedule(() => {
-      if (sideService !== undefined) return
-      sideService = detectSidebarService(ctx)
-      if (sideService !== undefined) {
-        log.info('检测到 ' + SIDEBAR_PLUGIN + '，切换侧边栏编辑形态')
+      if (officialService !== undefined) return
+      officialService = detectOfficial(ctx)
+      if (officialService !== undefined) {
+        log.info('检测到官方右侧 Sidebar（DSH 0.1.5+），切换官方侧边栏编辑形态')
         applySideForm()
-      } else {
-        retrySideService()
+        return
+      }
+      if (sideService === undefined) {
+        sideService = detectSidebarService(ctx)
+        if (sideService !== undefined) {
+          log.info('检测到 ' + SIDEBAR_PLUGIN + '，切换侧边栏编辑形态（官方未探测到，后续仍优先官方）')
+          applySideForm()
+        }
       }
+      retrySideService()
     }, 2000)
   }
   retrySideService()

package/src/client/officialSidebar.ts

@@ -0,0 +1,281 @@
+/**
+ * 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号
+ */
+
+import { log } from './log.js'
+import { setEnsureSideEditor } from './sidebarBridge.js'
+
+/** 官方 Tab 类型注册表服务名（ctx.get 用；不进 inject——旧版 DSH 无此包，inject 会停等）。 */
+export const OFFICIAL_TABS_SERVICE = 'sidebarRightTabs'
+/** 官方导航控制器服务名（ctx.get 用）。 */
+export const OFFICIAL_SERVICE = 'sidebarRight'
+/** 官方 keyed slot 名（Tab 正文挂点，由官方侧边栏的 rightbar seat 声明）。 */
+export const OFFICIAL_SLOT_NAME = 'sidebar.right.pane.tab'
+/** 本插件 Tab 类型定义 id（官方约定用包名；正文 slot 的 key 与之相同）。 */
+export const OFFICIAL_TAB_ID = 'dsh-vscode-mode'
+/** 本插件 Tab 的类型判别符（ctx.sidebarRight.openTab 的 kind）。 */
+export const OFFICIAL_TAB_KIND = 'edrvEditor'
+/** Tab 标题（与 better-sidebar 形态一致）。 */
+export const OFFICIAL_TAB_TITLE = '文件编辑'
+/** 官方 file 资源地址前缀（0.1.5+ 聊天文件链接/文件树打开的统一地址语法）。 */
+export const OFFICIAL_FILE_PREFIX = 'dsh-resource://file/'
+/** file 地址认领的 patterns（extension 档接管官方 textpreview 的 fallback 认领，注销自动回落）。 */
+export const OFFICIAL_FILE_PATTERN = 'dsh-resource://file/**'
+/** file 资源类型的定义 id（正文 slot 的 key）。 */
+export const OFFICIAL_FILE_TAB_ID = 'dsh-vscode-mode/file'
+/** file 资源类型的 kind（与页类型 edrvEditor 区分：同 kind 只允许一份 extension）。 */
+export const OFFICIAL_FILE_KIND = 'edrvEditorFile'
+
+/** 官方 Tab 打开参数（官方运行时不校验的 JSON，正文经 navigation.params 读回）。 */
+export interface OfficialTabParams {
+  openPath?: string
+  focusDiff?: boolean
+}
+
+/** sidebarRightTabs 服务的最小结构面（结构性探测，不 import 官方类型）。 */
+export interface SidebarRightTabsLike {
+  register: (definition: unknown) => () => void
+}
+
+/** sidebarRight 服务的最小结构面（openTab 页路由 + openResource 资源路由）。 */
+export interface SidebarRightServiceLike {
+  openTab: (kind: string, options?: { params?: unknown }) => void
+  openResource?: (address: string, options?: { params?: unknown }) => void
+}
+
+/** slots 服务的最小结构面（等待声明 + 注册）。 */
+export interface SlotsLike {
+  inject: (name: string, register: () => unknown) => unknown
+  register: (spec: object, render: unknown) => unknown
+}
+
+/** 探测命中的一对官方服务。 */
+export interface OfficialSidebar {
+  tabs: SidebarRightTabsLike
+  service: SidebarRightServiceLike
+}
+
+/**
+ * 结构化探测官方右侧 Sidebar 服务（可选依赖：缺失/降级返回 undefined）。
+ * 服务仅存在于 DSH 0.1.5-alpha.1+，探测命中 ≡ 版本判定成立。
+ * @author ddj 2026年09月09号
+ * @param ctx 客户端服务上下文
+ * @returns 注册表与控制器对，或 undefined
+ */
+export function detectOfficial(ctx: { get: (name: string) => unknown }): OfficialSidebar | undefined {
+  try {
+    const tabs = ctx.get(OFFICIAL_TABS_SERVICE) as SidebarRightTabsLike | undefined
+    const service = ctx.get(OFFICIAL_SERVICE) as SidebarRightServiceLike | undefined
+    if (!tabs || typeof tabs.register !== 'function') return undefined
+    if (!service || typeof service.openTab !== 'function') return undefined
+    return { tabs, service }
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 从官方导航参数安全解析打开请求（缺字段/坏类型一律降级为空请求，不抛错）。
+ * @author ddj 2026年09月09号
+ * @param params openTab 传入的 params（正文经 navigation.params 读回）
+ * @returns 待打开路径与是否聚焦首个差异
+ */
+export function resolveNavOpen(params: unknown): { path: string | null; focusDiff: boolean } {
+  const value = (params ?? {}) as OfficialTabParams
+  const path = typeof value?.openPath === 'string' && value.openPath ? value.openPath : null
+  return { path, focusDiff: value?.focusDiff === true }
+}
+
+/** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
+function decodeSegment(raw: string | undefined): string | null {
+  if (raw === undefined) 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
+ */
+export function parseOfficialFileAddress(address: unknown): { path: string; sessionId?: string } | null {
+  if (typeof address !== 'string' || !address.startsWith(OFFICIAL_FILE_PREFIX)) return null
+  const [scope, ...tail] = address.slice(OFFICIAL_FILE_PREFIX.length).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 as string[]).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 as string[])[0] === '' || segments.some((s) => s === null)) return null
+    const list = segments as string[]
+    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 标题文本
+ */
+export function officialFileTitle(address: unknown): string {
+  const parsed = parseOfficialFileAddress(address)
+  const source = parsed?.path ?? (typeof address === 'string' ? address : '')
+  const normalized = source.replace(/\\/g, '/')
+  return normalized.slice(normalized.lastIndexOf('/') + 1) || source
+}
+
+/** component 编码一段（对齐官方 encodeSegment：盘符冒号保持字面）。 */
+function encodeSegment(segment: string): string {
+  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
+ */
+export function buildFileAddress(path: string, sessionId?: string): string {
+  const posix = (typeof path === 'string' ? path : '').replace(/\\/g, '/')
+  if (!posix.trim()) throw new Error('buildFileAddress：路径为空')
+  const isAbsolute = posix.startsWith('/') || posix.startsWith('//') || /^[A-Za-z]:[/\\]/.test(posix)
+  if (isAbsolute) {
+    const unc = posix.startsWith('//')
+    const body = posix.replace(/^\/+/, '')
+    return OFFICIAL_FILE_PREFIX + 'absolute/' + (unc ? '/' : '') + body.split('/').map(encodeSegment).join('/')
+  }
+  if (!sessionId) throw new Error('buildFileAddress：相对路径需要会话 id')
+  const relative = posix.replace(/^(?:\.\/)+/, '').replace(/^\/+/, '')
+  return OFFICIAL_FILE_PREFIX + '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: SlotsLike, key: string, renderTab: unknown): (() => void) | null {
+  try {
+    const disposer = slots.inject(OFFICIAL_SLOT_NAME, () => slots.register(
+      { name: OFFICIAL_SLOT_NAME, key },
+      renderTab,
+    ))
+    return typeof disposer === 'function' ? (disposer as () => void) : 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
+ */
+export function installOfficial(options: {
+  tabs: SidebarRightTabsLike
+  service: SidebarRightServiceLike
+  slots: SlotsLike
+  renderTab: unknown
+  guide: { title: () => string; description: () => string }
+}): (() => void) | null {
+  const { tabs, service, slots, renderTab, guide } = options
+  const open = (path: string | null, focusDiff: boolean): boolean => {
+    try {
+      // 官方语义：打开即展开侧栏；seat 未挂载（无会话画面）时抛错，降级其他打开器
+      service.openTab(OFFICIAL_TAB_KIND, { params: { openPath: path || undefined, focusDiff } })
+    } catch (error) {
+      log.warn('官方侧边栏打开失败（' + String(error) + '）')
+      return false
+    }
+    return true
+  }
+  let typeDisposer: (() => void) | null = null
+  try {
+    // extension 档（默认且最高）：与官方内置类型同 kind 时接管，卸载后官方恢复
+    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（回落官方查看器）
+ */
+export function registerOfficialFileClaim(options: {
+  tabs: SidebarRightTabsLike
+  slots: SlotsLike
+  renderTab: unknown
+}): (() => void) | null {
+  const { tabs, slots, renderTab } = options
+  let typeDisposer: (() => void) | null = null
+  try {
+    typeDisposer = tabs.register({
+      id: OFFICIAL_FILE_TAB_ID,
+      kind: OFFICIAL_FILE_KIND,
+      patterns: [OFFICIAL_FILE_PATTERN],
+      priority: 'extension',
+      // 畸形/解码失败地址否决：回落官方 textpreview，不产生白屏 Tab
+      canOpen: (address: string) => parseOfficialFileAddress(address) !== null,
+      title: (address: string) => 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()
+  }
+}

package/src/client/ui/EditorView.ts

@@ -1713,7 +1713,7 @@ export function EditorView(props) {
   }
   const sideHintEl = (layout === 'tab' && sideHint && !hintDismissed)
     ? React.createElement('div', { className: 'edrv-side-hint' },
-        React.createElement('span', { className: 'edrv-side-hint-text' }, '安装 dsh-better-sidebar 后可启用侧边栏编辑（对话+编辑同屏）：'),
+        React.createElement('span', { className: 'edrv-side-hint-text' }, 'DSH 0.1.5+ 自带官方右侧侧边栏（升级即用）；旧版可安装 dsh-better-sidebar 启用侧边栏编辑（对话+编辑同屏）：'),
         React.createElement('code', { className: 'edrv-side-hint-cmd' }, SIDEBAR_INSTALL_CMD),
         React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', title: '复制安装命令', onClick: copyInstallCmd }, '复制命令'),
         React.createElement('button', { className: 'edrv-side-hint-close', title: '关闭提示', 'aria-label': '关闭提示', onClick: dismissHint }, '×'))

package/src/client/ui/OfficialSideTab.ts

@@ -0,0 +1,73 @@
+// @ts-nocheck
+/**
+ * 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号
+ */
+import React from 'react'
+import { EditorView } from './EditorView.js'
+import { setSideEditorMounted } from '../sidebarBridge.js'
+import { parseOfficialFileAddress, resolveNavOpen } from '../officialSidebar.js'
+
+/**
+ * 官方侧边栏 Tab 正文组件（keyed slot sidebar.right.pane.tab 装配）。
+ * @param props slot 框架注入（useTabInfo/sessionId）+ 装配依赖（schedule 等）
+ * @returns EditorView 侧栏形态
+ */
+export function OfficialSideTab(props) {
+  const sessionId = props?.sessionId
+  const useTabInfo = props?.useTabInfo
+  let navigation
+  // useTabInfo 是 slot 框架按组件实例生成的 hook，须在组件顶层无条件调用
+  if (typeof useTabInfo === 'function') {
+    try {
+      navigation = useTabInfo()?.tab?.navigation
+    } catch {
+      navigation = undefined
+    }
+  }
+  const revision = typeof navigation?.revision === 'number' ? navigation.revision : -1
+  const revisionRef = React.useRef(-1)
+
+  React.useEffect(() => {
+    setSideEditorMounted(true)
+    return () => setSideEditorMounted(false)
+  }, [])
+
+  React.useEffect(() => {
+    if (revision === revisionRef.current) return
+    revisionRef.current = revision
+    // revision 0 = 无地址打开（种子/撤销恢复），没有可执行的打开请求
+    if (revision <= 0) return
+    // file 资源 Tab：地址即文件（解码出真实路径，透传 params.line 行号定位）
+    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 : undefined },
+      }))
+      return
+    }
+    // 页类型 Tab：params 携带打开请求
+    const request = resolveNavOpen(navigation?.params)
+    window.dispatchEvent(new CustomEvent('edrv:open-editor', {
+      detail: { path: request.path, focusDiff: request.focusDiff },
+    }))
+  })
+
+  return React.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,
+  })
+}