dsh-vscode-mode 0.1.22 → 0.1.25

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.22",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 中央编辑器（文件页签/QuickOpen/状态栏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
+  "version": "0.1.25",
+  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -51,13 +51,16 @@
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0",
     "cordis": ">=4.0.0-rc <5",
     "react": "^18.2.0",
+    "react-dom": "^18.2.0",
     "schemastery": "^3.18.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
     "@types/node": "^24.13.3",
     "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.5",
     "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "schemastery": "3.18.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.0",

package/src/client/events.ts

@@ -1,11 +1,13 @@
 /**
  * dsh-vscode-mode client — 跨组件/跨 slot 的窗口事件助手。
- * 迁移自原 src/client/index.ts 的 openEditorView 与事件派发，语义不改。
+ * 迁移自原 src/client/index.ts 的 openEditorView 与事件派发，语义不改；
+ * 侧边栏形态（sidebarBridge 已注册路由）优先，否则回退 DOM 页签点击。
  * 作者 ddj 2026-08-20
  */
+import { routeSideEditor } from './sidebarBridge.js'
 
 /**
- * 选择中央「文件编辑」页签（DOM 级，无需 store actions）。
+ * 选择中央「文件编辑」页签（DOM 级，无需 store actions）。仅旧页签形态使用。
  * @author ddj 2026年08月26号
  */
 function selectEditorTab(): void {
@@ -19,11 +21,12 @@ function selectEditorTab(): void {
 }
 
 /**
- * 打开中央「文件编辑」页签。
+ * 打开「文件编辑」：侧边栏形态路由优先，旧形态回退中央页签。
  * @author ddj 2026年08月26号
  * @param path 要打开的路径（可空）
  */
 export function openEditorView(path: string | null): void {
+  if (routeSideEditor(path ?? null, false)) return
   selectEditorTab()
   const target = path ?? null
   setTimeout(() => {
@@ -32,11 +35,12 @@ export function openEditorView(path: string | null): void {
 }
 
 /**
- * 打开文件编辑页并聚焦指定文件的首个差异。
+ * 打开文件编辑页并聚焦指定文件的首个差异（侧边栏形态自动展开面板）。
  * @author ddj 2026年08月26号
  * @param path 待聚焦的差异文件路径
  */
 export function openDiffView(path: string): void {
+  if (routeSideEditor(path, true)) return
   selectEditorTab()
   setTimeout(() => {
     window.dispatchEvent(new CustomEvent('edrv:open-editor', {

package/src/client/index.ts

@@ -1,6 +1,7 @@
 /**
  * dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
- * 挂点：conversation.view「文件编辑」页签（中央 Monaco 编辑器）+ conversation.input.dock 差异条 + header 差异角标。
+ * 挂点：betterSidebar「文件编辑」Tab（侧边栏形态，对话+编辑同屏；未装 dsh-better-sidebar 时
+ * 回退 conversation.view 中央页签）+ conversation.input.dock 差异条 + header 差异角标。
  * 与 Host 通信：同源 fetch('/edrv/rpc')（shared/rpc 契约）。
  *
  * ⚠️ 跨版本 slot 装配（2026-08-21）：新版 DSH 的 slots 系统要求 slot 必须由父 entry
@@ -25,6 +26,8 @@ import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.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 { SideEditorTab } from './ui/SideEditorTab.js'
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
@@ -72,6 +75,8 @@ export function apply(ctx: any): void {
   const binder = pickSettingsBinder(ctx)
   const settings = binder.scope
   let selected = autoValue('auto')
+  /** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
+  const sideService = detectSidebarService(ctx)
   /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
   const addToConversation = createAddToConversation(ctx)
 
@@ -80,6 +85,7 @@ export function apply(ctx: any): void {
     { name: '设置桥', active: settings !== undefined, note: settings !== undefined ? '使用 ' + binder.service + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用）' },
     { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开' },
     { 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 + '）' },
   ]
 
   ctx.provide('fileOpeners', registry)
@@ -134,14 +140,35 @@ export function apply(ctx: any): void {
     }), 'vscode-mode: file link routing')
   }
 
-  // 中央「文件编辑」页签：类 VSCode 编辑器（顶部=文件页签+搜索框，左侧=侧边栏，差异 UI=文件底部圆角悬浮框）
-  registerSlotSafely(ctx, {
-    name: 'conversation.view',
-    id: 'edrv-editor',
-    order: 5,
-    label: '文件编辑',
-    inject: (sessionId: string) => ({ sessionId }),
-  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })))
+  // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态可用时编辑器住 betterSidebar Tab，
+  // 本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。
+  const registerLegacyTab = (): void => {
+    registerSlotSafely(ctx, {
+      name: 'conversation.view',
+      id: 'edrv-editor',
+      order: 5,
+      label: '文件编辑',
+      inject: (sessionId: string) => ({ sessionId }),
+    }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })))
+  }
+
+  if (sideService) {
+    // 侧边栏形态：注册「文件编辑」Tab（单实例、可按会话持久化、内容打开自动展开面板）
+    ctx.effect(() => installSideEditor({
+      service: sideService,
+      renderTab: (props: Record<string, unknown>) => React.createElement(SideEditorTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })),
+      activeSession: () => {
+        const snapshot = sessions?.list?.getSnapshot?.() as { current?: string; byId?: Record<string, { cwd?: string }> } | undefined
+        const sessionId = snapshot?.current
+        if (!sessionId) return undefined
+        return { sessionId, cwd: snapshot?.byId?.[sessionId]?.cwd }
+      },
+      registerLegacyFallback: registerLegacyTab,
+    }), 'vscode-mode: sidebar editor tab')
+  } else {
+    setEnsureSideEditor(null)
+    registerLegacyTab()
+  }
 
   // 对话输入框上方差异 dock：普通对话显示单文案按钮，文件编辑页由 EditorView 隐藏
   registerSlotSafely(ctx, {

package/src/client/monaco/diffRender.ts

@@ -21,6 +21,9 @@ export function createDiffRenderer(log) {
    * @param sessionId 会话 id
    */
   const render = (monaco, editor, pendingRegions, sessionId) => {
+    // 空渲染且无残留（5s 轮询 setRecords 常触发）：无需清理时直接跳过，
+    // 不打 begin 日志、不做无谓 DOM 操作；有 zone/decoration 残留时仍需走清理。
+    if (!pendingRegions.length && viewZoneIds.length === 0 && decorations.length === 0) return
     const renderT0 = Date.now()
     const callIdAttr = (callId, idx) => String(callId) + ':' + String(idx)
     log(sessionId, '[diff-render] begin regs=' + pendingRegions.length + ' ' + pendingRegions.map((r) => callIdAttr(r.callId, r.idx) + '@' + (r.start ?? '?') + '-' + (r.end ?? '?') + '(-' + (r.oldLines ? r.oldLines.length : 0) + '/+' + (r.newLines ? r.newLines.length : 0) + ')').join('|'))

package/src/client/sidebar/panels/FileExplorer.ts

@@ -10,6 +10,7 @@
 import React from 'react'
 import { rpc } from '../../rpc.js'
 import { ContextMenu } from '../../ui/ContextMenu.js'
+import { rowMenuPosition } from '../../ui/menuPosition.js'
 import { buildTreeMenu } from '../contextMenu.js'
 import type { SidebarCtx } from '../types.js'
 
@@ -74,6 +75,7 @@ export function FileExplorer(props) {
   const refresh = () => {
     const keep = Object.keys(expandedRef.current).filter((k) => expandedRef.current[k] === true)
     tokensRef.current = {}
+    setMenu(null)
     setDirs({})
     setLoading({})
     setError(null)
@@ -94,6 +96,7 @@ export function FileExplorer(props) {
     setExpanded({})
     setLoading({})
     setError(null)
+    setMenu(null)
     setRoot(null)
     void loadDir('')
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -111,17 +114,22 @@ export function FileExplorer(props) {
   const rowEl = (e, depth, isDir, isOpen) => {
     const pending = isDir ? 0 : (pendingByPath[e.path] ?? 0)
     const active = !isDir && e.path === activePath
+    const contextTarget = Boolean(menu && menuEntries.length && menu.target.path === e.path)
     const dim = e.type === 'other'
     return React.createElement('div', {
       key: e.path,
-      className: 'edrv-tree-row' + (active ? ' edrv-tree-active' : ''),
+      className: 'edrv-tree-row'
+        + (active ? ' edrv-tree-active' : '')
+        + (contextTarget ? ' edrv-tree-context' : ''),
       title: e.path,
       style: { paddingLeft: 6 + depth * 14 },
       onClick: () => { if (isDir) toggle(e.path); else openFile(e.path) },
       onContextMenu: (ev) => {
         ev.preventDefault()
         ev.stopPropagation()
-        setMenu({ x: ev.clientX, y: ev.clientY, target: { path: e.path, type: e.type } })
+        const rect = ev.currentTarget?.getBoundingClientRect?.()
+        const position = rowMenuPosition(rect, ev.clientX, ev.clientY)
+        setMenu({ x: position.left, y: position.top, target: { path: e.path, type: e.type } })
       },
     },
       React.createElement('span', { className: 'edrv-tree-chev' },
@@ -158,6 +166,8 @@ export function FileExplorer(props) {
   // 面板区右键（空白处）→ 工作区根目录菜单；行内右键已在 rowEl 阻止冒泡。
   const onPanelContext = (ev) => {
     ev.preventDefault()
+    ev.stopPropagation()
+    if (!ev.currentTarget.contains(ev.target)) return
     setMenu({ x: ev.clientX, y: ev.clientY, target: { path: '', type: 'directory' } })
   }
   // 当前右键目标的可视菜单项（构建时过滤/排序，registry 变化下次打开生效）。

package/src/client/sidebarBridge.ts

@@ -0,0 +1,247 @@
+/**
+ * dsh-vscode-mode client — 侧边栏编辑区桥：可选探测 dsh-better-sidebar 的
+ * ctx.betterSidebar 服务，并注册「文件编辑」Tab（单实例）。
+ * 可选依赖模式：服务缺失时调用方回退到中央页签形态；本模块不注册任何东西。
+ * 纯逻辑（探测/初始打开解析/角标计数）可单测，DOM/事件仅存在于 install 路径。
+ * 作者 ddj 2026年08月25号
+ */
+
+import React from 'react'
+
+/** betterSidebar 服务名（ctx.get 用；不要加进 inject——缺失会让插件停靠等待）。 */
+export const BETTER_SIDEBAR_SERVICE = 'betterSidebar'
+/** 本插件在侧边栏注册的 Tab 类型 id（亦是 SidebarTab.type）。 */
+export const SIDE_TAB_ID = 'edrv-editor'
+/** 侧边栏 Tab 标题。 */
+export const SIDE_TAB_TITLE = '文件编辑'
+/** 推荐安装命令（提示条/兼容性报告共用）。 */
+export const SIDEBAR_INSTALL_CMD = 'dsh plugin --profile web add dsh-better-sidebar'
+
+/** Tab 元数据（openTab 种子随 Tab 持久化，创建路径用它恢复初始打开）。 */
+export interface SideEditorMeta {
+  /** 待打开的工作区相对/绝对路径。 */
+  openPath?: string
+  /** 打开后聚焦首个差异。 */
+  focusDiff?: boolean
+}
+
+/**
+ * betterSidebar 服务的最小结构面（结构性探测，不 import 第三方类型）。
+ */
+export interface SidebarServiceLike {
+  registerTab: (descriptor: unknown) => () => void
+  openTab: (seed: { type: string; title?: string; path?: string; meta?: unknown }, scope?: { sessionId: string; cwd?: string }) => void
+  isTabEnabled?: (id: string) => boolean
+  features?: readonly string[]
+}
+
+/**
+ * 解析 Tab 挂载时的初始打开请求（创建路径读 tab.path/meta，聚焦路径走窗口事件）。
+ * @author ddj 2026年08月25号
+ * @param tab 侧边栏 Tab（path/meta 为可选字段）
+ * @returns 待打开路径与是否聚焦差异
+ */
+export function resolveInitialOpen(tab: { path?: string; meta?: unknown } | null | undefined): { path: string | null; focusDiff: boolean } {
+  const meta = (tab?.meta ?? {}) as SideEditorMeta
+  const path = typeof tab?.path === 'string' && tab.path ? tab.path : (typeof meta?.openPath === 'string' ? meta.openPath : null)
+  return { path: path || null, focusDiff: meta?.focusDiff === true }
+}
+
+/** 会话级待处理差异文件数缓存（Tab 角标同步读取；EditorView 侧栏形态写入）。 */
+const sidePending = new Map<string, number>()
+
+/**
+ * 写入会话的待处理差异文件数（0 视为清除，不显示角标）。
+ * @author ddj 2026年08月25号
+ * @param sessionId 会话 id
+ * @param count 待处理差异文件数
+ */
+export function setSidePending(sessionId: string, count: number): void {
+  if (!sessionId) return
+  const value = Number.isFinite(count) ? Math.max(0, Math.floor(count)) : 0
+  if (value > 0) sidePending.set(sessionId, value)
+  else sidePending.delete(sessionId)
+}
+
+/**
+ * 读取会话的待处理差异文件数（角标用）。
+ * @author ddj 2026年08月25号
+ * @param sessionId 会话 id
+ * @returns 非负计数
+ */
+export function getSidePending(sessionId?: string): number {
+  if (!sessionId) return 0
+  return sidePending.get(sessionId) ?? 0
+}
+
+/** 模块级侧栏打开路由（events.ts 优先走它；未注册 = 旧页签形态）。 */
+let ensureSideEditor: ((path: string | null, focusDiff: boolean) => boolean) | null = null
+
+/** 待消费的初始打开（Tab 组件尚未挂载时暂存；按会话匹配，挂载时取走）。 */
+let pendingOpen: { sessionId: string; path: string | null; focusDiff: boolean } | null = null
+/** Tab 组件当前是否有挂载实例（有则直接投递窗口事件，无则暂存待消费）。 */
+let sideEditorMounted = false
+
+/**
+ * 注册/撤销侧栏打开路由。
+ * @author ddj 2026年08月25号
+ * @param fn 路由函数或 null
+ */
+export function setEnsureSideEditor(fn: ((path: string | null, focusDiff: boolean) => boolean) | null): void {
+  ensureSideEditor = fn
+}
+
+/**
+ * 标记侧栏编辑器组件挂载状态（SideEditorTab 挂载/卸载时调用）。
+ * @author ddj 2026年08月25号
+ * @param mounted 是否已挂载
+ */
+export function setSideEditorMounted(mounted: boolean): void {
+  sideEditorMounted = mounted
+}
+
+/**
+ * 暂存指定会话的待消费初始打开（Tab 组件未挂载时由 install 路径调用）。
+ * @author ddj 2026年08月25号
+ * @param sessionId 会话 id
+ * @param path 待打开路径（可空）
+ * @param focusDiff 是否聚焦首个差异
+ */
+export function stagePendingSideOpen(sessionId: string, path: string | null, focusDiff: boolean): void {
+  if (!sessionId) return
+  pendingOpen = { sessionId, path: path || null, focusDiff: focusDiff === true }
+}
+
+/**
+ * 取走指定会话的待消费初始打开（SideEditorTab 挂载时读取；不存在返回 null）。
+ * @author ddj 2026年08月25号
+ * @param sessionId 会话 id
+ * @returns 待打开请求或 null
+ */
+export function takePendingSideOpen(sessionId?: string): { path: string | null; focusDiff: boolean } | null {
+  if (!pendingOpen || !sessionId || pendingOpen.sessionId !== sessionId) return null
+  const value = { path: pendingOpen.path, focusDiff: pendingOpen.focusDiff }
+  pendingOpen = null
+  return value
+}
+
+/**
+ * 打开/聚焦侧栏编辑器（打开路径可选；返回是否已被侧栏形态接管）。
+ * @author ddj 2026年08月25号
+ * @param path 待打开路径（可空）
+ * @param focusDiff 是否聚焦首个差异
+ * @returns 是否路由成功
+ */
+export function routeSideEditor(path: string | null, focusDiff: boolean): boolean {
+  if (typeof ensureSideEditor !== 'function') return false
+  try {
+    return ensureSideEditor(path, focusDiff) === true
+  } catch (error) {
+    console.warn('[dsh-vscode-mode] 侧栏编辑器打开失败（' + String(error) + '），已回退')
+    return false
+  }
+}
+
+/**
+ * 结构化探测 betterSidebar 服务（可选依赖：缺失/降级返回 undefined）。
+ * @author ddj 2026年08月25号
+ * @param ctx 客户端服务上下文
+ * @returns 服务结构面或 undefined
+ */
+export function detectSidebarService(ctx: { get: (name: string) => unknown }): SidebarServiceLike | undefined {
+  try {
+    const service = ctx.get(BETTER_SIDEBAR_SERVICE) as SidebarServiceLike | undefined
+    if (!service || typeof service.registerTab !== 'function' || typeof service.openTab !== 'function') return undefined
+    return service
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 注册侧边栏「文件编辑」Tab 并接管打开路由。
+ * Tab 被用户在 better-sidebar 设置里禁用时，打开路由降级为回退回调（中央页签）。
+ * @author ddj 2026年08月25号
+ * @param options 装配参数（组件依赖 + 活动会话解析 + 回退注册）
+ * @returns 卸载器（反注册 Tab + 撤销路由）
+ */
+export function installSideEditor(options: {
+  service: SidebarServiceLike
+  renderTab: (props: Record<string, unknown>) => unknown
+  activeSession: () => { sessionId?: string; cwd?: string } | undefined
+  registerLegacyFallback: () => void
+}): () => void {
+  const { service, renderTab, activeSession, registerLegacyFallback } = options
+  let fallbackInstalled = false
+  const open = (path: string | null, focusDiff: boolean): boolean => {
+    if (typeof service.isTabEnabled === 'function' && !service.isTabEnabled(SIDE_TAB_ID)) {
+      if (!fallbackInstalled) {
+        fallbackInstalled = true
+        try { registerLegacyFallback() } catch (error) { console.warn('[dsh-vscode-mode] 回退注册失败（' + String(error) + '）') }
+      }
+      return false
+    }
+    const scope = activeSession()
+    const sessionId = scope?.sessionId
+    if (!sessionId) return false
+    try {
+      service.openTab({
+        type: SIDE_TAB_ID,
+        title: SIDE_TAB_TITLE,
+        ...(path ? { path } : {}),
+        meta: { openPath: path || undefined, focusDiff },
+      }, { sessionId, cwd: scope?.cwd })
+    } catch (error) {
+      console.warn('[dsh-vscode-mode] openTab 失败（' + String(error) + '）')
+      return false
+    }
+    if (sideEditorMounted) {
+      // 已挂载：窗口事件直达 EditorView 监听器
+      window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: { path, focusDiff } }))
+    } else {
+      // 未挂载（面板折叠卸载/首次创建）：暂存待消费，挂载时由 SideEditorTab 取走
+      stagePendingSideOpen(sessionId, path, focusDiff)
+    }
+    return true
+  }
+  let tabDisposer: (() => void) | null = null
+  try {
+    tabDisposer = service.registerTab({
+      id: SIDE_TAB_ID,
+      title: SIDE_TAB_TITLE,
+      icon: codeIcon,
+      single: true,
+      badge: (_ctx: unknown, scope: { sessionId?: string }) => getSidePending(scope?.sessionId) || null,
+      component: renderTab,
+    })
+  } catch (error) {
+    console.warn('[dsh-vscode-mode] 侧边栏 Tab 注册失败（' + String(error) + '）')
+    // 注册失败 = 侧栏形态不可用：立即回退中央页签，不接管打开路由
+    if (!fallbackInstalled) {
+      fallbackInstalled = true
+      try { registerLegacyFallback() } catch (inner) { console.warn('[dsh-vscode-mode] 回退注册失败（' + String(inner) + '）') }
+    }
+    return () => {}
+  }
+  setEnsureSideEditor(open)
+  return () => {
+    if (typeof tabDisposer === 'function') tabDisposer()
+    setEnsureSideEditor(null)
+  }
+}
+
+/**
+ * 侧边栏 Tab 图标（内联 SVG 代码括号，不依赖图标包）。
+ * @author ddj 2026年08月25号
+ * @param size 边长（px）
+ * @returns 图标元素
+ */
+function codeIcon(size: number): unknown {
+  return React.createElement('svg', {
+    width: size, height: size, viewBox: '0 0 16 16', fill: 'none', 'aria-hidden': true, focusable: false,
+  },
+    React.createElement('path', {
+      d: 'M5.5 4.5 2.5 8l3 3.5M10.5 4.5 13.5 8l-3 3.5',
+      stroke: 'currentColor', strokeWidth: 1.4, strokeLinecap: 'round', strokeLinejoin: 'round',
+    }))
+}

package/src/client/styles/editor.css

@@ -213,6 +213,7 @@
 [data-edrv-view] .edrv-tree-row { display: flex; align-items: center; gap: 4px; height: 22px; padding-right: 6px; border-radius: 5px; color: var(--dsw-alias-label-primary, #1f2933); cursor: pointer; white-space: nowrap; }
 [data-edrv-view] .edrv-tree-row:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-tree-row.edrv-tree-active { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.14)); }
+[data-edrv-view] .edrv-tree-row.edrv-tree-context { box-shadow: inset 0 0 0 1px var(--dsw-alias-brand-primary, #0f9d58); background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); }
 [data-edrv-view] .edrv-tree-chev { width: 12px; flex-shrink: 0; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 10px; text-align: center; }
 [data-edrv-view] .edrv-tree-name { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
 [data-edrv-view] .edrv-tree-name.edrv-tree-dim { color: var(--dsw-alias-label-tertiary, #9aa5b1); }
@@ -232,3 +233,13 @@
 [data-edrv-view] .edrv-side-resize:hover { background: var(--dsw-alias-brand-primary, #0f9d58); opacity: .35; }
 [data-edrv-view] .edrv-chip-btn.edrv-chip-on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); color: var(--dsw-alias-label-primary, #1f2933); }
 
+/* ===== 侧栏形态（betterSidebar 面板内编辑区） ===== */
+[data-edrv-view][data-edrv-layout='side'] { box-sizing: border-box; height: 100%; }
+
+/* ===== 侧边栏引导条（旧页签形态、未装 betterSidebar 时） ===== */
+[data-edrv-view] .edrv-side-hint { display: flex; align-items: center; gap: 8px; flex: 0 0 auto; flex-wrap: wrap; padding: 6px 12px; font-size: 12px; color: var(--dsw-alias-label-secondary, #52606d); background: var(--dsw-specific-tip, var(--dsw-alias-bg-layer-2, #f0f4f4)); border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
+[data-edrv-view] .edrv-side-hint-text { white-space: nowrap; }
+[data-edrv-view] .edrv-side-hint-cmd { font-size: 11px; padding: 2px 6px; border-radius: 6px; background: var(--dsw-alias-bg-layer-1, #ffffff); border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); color: var(--dsw-alias-label-primary, #1f2933); white-space: nowrap; }
+[data-edrv-view] .edrv-side-hint-close { margin-left: auto; border: none; background: transparent; color: var(--dsw-alias-label-tertiary, #9aa5b1); cursor: pointer; font-size: 14px; line-height: 1; padding: 2px 6px; border-radius: 6px; flex-shrink: 0; }
+[data-edrv-view] .edrv-side-hint-close:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); color: var(--dsw-alias-label-primary, #1f2933); }
+

package/src/client/ui/ContextMenu.ts

@@ -1,10 +1,13 @@
 /**
  * dsh-vscode-mode client — 通用浮动右键菜单（createElement 风格、类型化）。
- * 全屏 backdrop（点击/右键/Esc 关闭）+ 固定定位（viewport clamp 防越界），
+ * 非阻塞式关闭：window capture 监听（点击菜单外/右键菜单外/Esc 关闭），
+ * 不拦截菜单外事件，允许同一事件内由发起方切换/重开菜单。
  * 条目支持 danger/disabled/separator，复用既有 edrv-ctxmenu* 样式类。
  * 作者 ddj 2026-08-27
  */
 import React from 'react'
+import { createPortal } from 'react-dom'
+import { clampMenuPosition } from './menuPosition.js'
 
 /** 单条菜单项（展示层形状；业务侧由 buildTreeMenu 映射而来）。 */
 export interface ContextMenuEntry {
@@ -37,17 +40,43 @@ const MENU_H = 176
  */
 export function ContextMenu(props: ContextMenuProps): React.ReactElement {
   const { x, y, entries, onClose } = props
+  const menuRef = React.useRef<HTMLDivElement | null>(null)
 
   React.useEffect(() => {
     const onKey = (e: KeyboardEvent): void => {
       if (e.key === 'Escape') onClose()
     }
+    const onPointerDown = (e: PointerEvent): void => {
+      if (e.button !== 0) return
+      if (menuRef.current && menuRef.current.contains(e.target as Node)) return
+      onClose()
+    }
+    const onContextMenu = (e: MouseEvent): void => {
+      if (menuRef.current && menuRef.current.contains(e.target as Node)) {
+        e.preventDefault()
+      }
+      onClose()
+    }
     window.addEventListener('keydown', onKey, true)
-    return () => window.removeEventListener('keydown', onKey, true)
+    window.addEventListener('pointerdown', onPointerDown, true)
+    window.addEventListener('contextmenu', onContextMenu, true)
+    return () => {
+      window.removeEventListener('keydown', onKey, true)
+      window.removeEventListener('pointerdown', onPointerDown, true)
+      window.removeEventListener('contextmenu', onContextMenu, true)
+    }
   }, [onClose])
 
-  const left = Math.max(4, Math.min(x, (window.innerWidth || 800) - MENU_W))
-  const top = Math.max(4, Math.min(y, (window.innerHeight || 600) - MENU_H))
+  const safeX = Number.isFinite(x) ? x : 4
+  const safeY = Number.isFinite(y) ? y : 4
+  const position = clampMenuPosition(
+    safeX,
+    safeY,
+    window.innerWidth || 800,
+    window.innerHeight || 600,
+    MENU_W,
+    MENU_H,
+  )
 
   const children: React.ReactNode[] = []
   for (const entry of entries) {
@@ -71,12 +100,8 @@ export function ContextMenu(props: ContextMenuProps): React.ReactElement {
     }, entry.label))
   }
 
-  return React.createElement(React.Fragment, null,
-    React.createElement('div', {
-      className: 'edrv-ctxmenu-backdrop',
-      style: { position: 'fixed', inset: 0, zIndex: 70 },
-      onClick: onClose,
-      onContextMenu: (e: React.MouseEvent) => { e.preventDefault(); onClose() },
-    }),
-    React.createElement('div', { className: 'edrv-ctxmenu', style: { left, top } }, ...children))
+  const overlay = React.createElement('div', { 'data-edrv-view': '1' },
+    React.createElement('div', { className: 'edrv-ctxmenu', ref: menuRef, style: position }, ...children))
+
+  return typeof document === 'undefined' ? overlay : createPortal(overlay, document.body)
 }

package/src/client/ui/DiffBadge.ts

@@ -14,7 +14,7 @@ import { summarize } from '../state/records.js'
  */
 export function DiffBadge(props) {
   const sessionId = props?.sessionId
-  const [n, setN] = React.useState(0)
+  const [summary, setSummary] = React.useState(null)
   const seq = React.useRef(0)
 
   const load = React.useCallback(() => {
@@ -22,7 +22,7 @@ export function DiffBadge(props) {
     const s = ++seq.current
     rpc('edrv.list', { sessionId }).then((res) => {
       if (s !== seq.current || !res || !res.ok || !Array.isArray(res.records)) return
-      setN(summarize(res.records).totalFiles)
+      setSummary(summarize(res.records))
     }).catch(() => {})
   }, [sessionId])
 
@@ -34,10 +34,12 @@ export function DiffBadge(props) {
     return () => { clearInterval(t); window.removeEventListener('edrv:refresh', onRefresh) }
   }, [load])
 
+  const n = summary?.totalFiles ?? 0
   if (!n) return null
 
   const click = () => {
-    openEditorView(null)
+    // 侧栏形态：带首个待处理文件路径（内容打开自动展开面板）；旧形态行为不变
+    openEditorView(summary?.pendingFiles?.[0]?.path ?? null)
     setTimeout(() => { emitShowLauncher() }, 120)
   }