dsh-vscode-mode 0.1.21 → 0.1.23

package/src/client/styles/editor.css

@@ -69,6 +69,8 @@
 [data-edrv-view] .edrv-ctxmenu-item { display: flex; align-items: center; gap: 8px; font-size: 12px; line-height: 18px; padding: 7px 10px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-primary, #1f2933); cursor: pointer; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 [data-edrv-view] .edrv-ctxmenu-item:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-ctxmenu-item.edrv-ctxmenu-danger { color: var(--dsw-alias-state-error-primary, #d9534f); }
+[data-edrv-view] .edrv-ctxmenu-item:disabled,
+[data-edrv-view] .edrv-ctxmenu-item.edrv-ctxmenu-disabled { color: var(--dsw-alias-label-disabled, #b0b7c0); cursor: default; background: transparent; }
 [data-edrv-view] .edrv-ctxmenu-sep { height: 1px; margin: 3px 4px; background: var(--dsw-alias-border-l1, #e0e6e8); }
 [data-edrv-view] .edrv-diffbar-body { max-height: 130px; max-width: min(560px, calc(100vw - 40px)); overflow: auto; padding: 4px 8px 8px; display: flex; flex-direction: column; gap: 4px; border-top: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
 [data-edrv-view] .edrv-diffrow { display: flex; align-items: center; gap: 8px; padding: 3px 6px; border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); border-radius: 6px; background: var(--dsw-alias-bg-layer-2, #f0f4f4); cursor: pointer; flex-wrap: wrap; }
@@ -201,7 +203,7 @@
 [data-edrv-view] .edrv-rail-icon { font-size: 15px; line-height: 1; }
 [data-edrv-view] .edrv-rail-badge { position: absolute; top: 2px; right: 2px; min-width: 14px; height: 14px; padding: 0 3px; border-radius: 999px; background: var(--dsw-alias-brand-primary, #0f9d58); color: #fff; font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; }
 [data-edrv-view] .edrv-side-body { flex: 1; min-width: 0; min-height: 0; display: flex; overflow: hidden; }
-[data-edrv-view] .edrv-side-panel { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; }
+[data-edrv-view] .edrv-side-panel { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; position: relative; }
 [data-edrv-view] .edrv-side-head { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px 0 12px; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); flex-shrink: 0; }
 [data-edrv-view] .edrv-side-title { font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-primary, #1f2933); white-space: nowrap; }
 [data-edrv-view] .edrv-side-root { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
@@ -230,3 +232,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

@@ -0,0 +1,82 @@
+/**
+ * dsh-vscode-mode client — 通用浮动右键菜单（createElement 风格、类型化）。
+ * 全屏 backdrop（点击/右键/Esc 关闭）+ 固定定位（viewport clamp 防越界），
+ * 条目支持 danger/disabled/separator，复用既有 edrv-ctxmenu* 样式类。
+ * 作者 ddj 2026-08-27
+ */
+import React from 'react'
+
+/** 单条菜单项（展示层形状；业务侧由 buildTreeMenu 映射而来）。 */
+export interface ContextMenuEntry {
+  id: string
+  label: string
+  danger?: boolean
+  disabled?: boolean
+  /** 前置分隔线。 */
+  separator?: boolean
+  onClick?: () => void
+}
+
+export interface ContextMenuProps {
+  x: number
+  y: number
+  entries: ContextMenuEntry[]
+  onClose: () => void
+}
+
+/** 菜单估算宽高（clamp 防越出视口，与 EditorView menuPos 常量对齐）。 */
+const MENU_W = 224
+const MENU_H = 176
+
+/**
+ * 浮动右键菜单。
+ * @param props.x 视口 x 坐标
+ * @param props.y 视口 y 坐标
+ * @param props.entries 菜单项列表
+ * @param props.onClose 关闭回调（backdrop 点击/右键/Esc/点击项后触发）
+ */
+export function ContextMenu(props: ContextMenuProps): React.ReactElement {
+  const { x, y, entries, onClose } = props
+
+  React.useEffect(() => {
+    const onKey = (e: KeyboardEvent): void => {
+      if (e.key === 'Escape') onClose()
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, 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 children: React.ReactNode[] = []
+  for (const entry of entries) {
+    if (entry.separator) {
+      children.push(React.createElement('div', { key: 'sep-' + entry.id, className: 'edrv-ctxmenu-sep' }))
+      continue
+    }
+    const cls = 'edrv-ctxmenu-item'
+      + (entry.danger ? ' edrv-ctxmenu-danger' : '')
+      + (entry.disabled ? ' edrv-ctxmenu-disabled' : '')
+    children.push(React.createElement('button', {
+      key: entry.id,
+      className: cls,
+      disabled: entry.disabled,
+      onClick: () => {
+        if (!entry.disabled) {
+          entry.onClick?.()
+          onClose()
+        }
+      },
+    }, 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))
+}

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)
   }
 

package/src/client/ui/EditorView.ts

@@ -18,17 +18,23 @@ import { SidebarView } from '../sidebar/SidebarView.js'
 import { clearDiffDock, publishDiffDock } from '../diffDockStore.js'
 import { displayDiffTotal, editorDockMode } from '../diffDock.js'
 import { editorHeight } from '../editorLayout.js'
+import { revealInExplorer as revealPathInExplorer } from '../fileReveal.js'
+import { setSidePending, SIDEBAR_INSTALL_CMD } from '../sidebarBridge.js'
 
 /**
  * 中央编辑区：文件页签（脏点/关闭/打开路径）+ Ctrl+P 搜索 + Monaco 编辑器 +
  * 底部差异条（DiffBox/空态）+ 全局差异下拉（DiffLauncher）+ 状态栏。
  * @param props.sessionId 会话 id
  * @param props.schedule 延时调度（ctx.timeout）
+ * @param props.layout 布局形态：'tab'（中央页签，默认）| 'side'（侧边栏面板）
+ * @param props.sideHint 旧页签形态下显示侧边栏引导（安装命令）
  */
 export function EditorView(props) {
   const sessionId = props?.sessionId
   const schedule = props.schedule
   const addToConversation = props.addToConversation
+  const layout = props?.layout === 'side' ? 'side' : 'tab'
+  const sideHint = props?.sideHint
   const [monaco, setMonaco] = React.useState(null)
   const [monacoErr, setMonacoErr] = React.useState(null)
   const [records, setRecords] = React.useState({})
@@ -50,10 +56,13 @@ export function EditorView(props) {
   const [diffIdx, setDiffIdx] = React.useState(0) // 当前文件内差异位置（x/x 显示）
   const [fileIdx, setFileIdx] = React.useState(0) // 全局差异文件位置（x/x 文件 显示）
   const [tabMenu, setTabMenu] = React.useState(null) // Tab 右键菜单 { x,y,path }（编辑区右键走 Monaco 原生菜单，无此浮层）
-  const [sidebarOn, setSidebarOn] = React.useState(true) // 侧边栏显隐
+  const [sidebarOn, setSidebarOn] = React.useState(layout !== 'side') // 侧边栏显隐（侧栏形态默认收起）
   const [sidebarW, setSidebarW] = React.useState(240) // 侧边栏宽度
   const [activePanel, setActivePanel] = React.useState('explorer') // 激活面板 id
   const [focusRequest, setFocusRequest] = React.useState(0) // 外部差异聚焦请求版本
+  const [hintDismissed, setHintDismissed] = React.useState(() => {
+    try { return localStorage.getItem('edrv.side-hint-dismissed') === '1' } catch { return false }
+  }) // 侧边栏引导条是否已关闭
   const editorRef = React.useRef(null)
   const viewRootRef = React.useRef(null)
   const monacoRef = React.useRef(null)
@@ -74,6 +83,8 @@ export function EditorView(props) {
   const batchBusyRef = React.useRef(false) // 批量 Keep All/Undo All 防重入
   const menuHandlersRef = React.useRef(null) // 右键菜单动作的最新闭包（Monaco addAction 空依赖回调读取）
   const diffRendererRef = React.useRef(null)
+  const layoutRef = React.useRef(layout) // ensureEditor 空依赖闭包读取的稳定布局
+  layoutRef.current = layout
   if (!diffRendererRef.current) diffRendererRef.current = createDiffRenderer((sid, t) => dbg(sid, t))
 
   const currentRecords = React.useMemo(() => {
@@ -194,10 +205,15 @@ export function EditorView(props) {
 
   // 对话输入区的唯一差异 dock 读取此会话快照；编辑器卸载时只清理自己的发布者令牌。
   const dockSourceRef = React.useRef({})
-  React.useEffect(() => () => clearDiffDock(sessionId, dockSourceRef.current), [sessionId])
+  React.useEffect(() => () => {
+    clearDiffDock(sessionId, dockSourceRef.current)
+    if (layout === 'side') setSidePending(sessionId, 0)
+  }, [sessionId])
 
   // DSH composer 保持原生布局；编辑区只读取几何边界并同步自己的高度。
+  // 侧栏形态：面板容器自带高度，跳过 composer 几何同步（面板内无会话滚动区）。
   React.useLayoutEffect(() => {
+    if (layout === 'side') return
     const root = viewRootRef.current
     const scroll = root?.closest?.('[data-conversation-scroll]')
     if (!root || !scroll) return
@@ -248,7 +264,7 @@ export function EditorView(props) {
       window.removeEventListener('resize', scheduleUpdate)
       root.style.removeProperty('--edrv-editor-height')
     }
-  }, [sessionId])
+  }, [sessionId, layout])
 
   // localStorage v2 恢复页签
   React.useEffect(() => {
@@ -272,11 +288,12 @@ export function EditorView(props) {
     catch (e) { /* 忽略 */ }
   }, [tabs, active, sessionId])
 
-  // 侧边栏状态：恢复（显隐/宽度/激活面板）
+  // 侧边栏状态：恢复（显隐/宽度/激活面板）；侧栏形态独立键（默认收起，不共享页签形态偏好）
+  const sidebarKey = 'edrv.sidebar.' + (layout === 'side' ? 'side.' : '') + String(sessionId)
   React.useEffect(() => {
     if (!sessionId) return
     try {
-      const raw = localStorage.getItem('edrv.sidebar.' + String(sessionId))
+      const raw = localStorage.getItem(sidebarKey)
       if (raw) {
         const saved = JSON.parse(raw)
         if (typeof saved.on === 'boolean') setSidebarOn(saved.on)
@@ -284,14 +301,14 @@ export function EditorView(props) {
         if (typeof saved.panel === 'string') setActivePanel(saved.panel)
       }
     } catch (e) { /* 损坏忽略 */ }
-  }, [sessionId])
+  }, [sessionId, sidebarKey])
 
   // 侧边栏状态持久化
   React.useEffect(() => {
     if (!sessionId) return
-    try { localStorage.setItem('edrv.sidebar.' + String(sessionId), JSON.stringify({ on: sidebarOn, width: sidebarW, panel: activePanel })) }
+    try { localStorage.setItem(sidebarKey, JSON.stringify({ on: sidebarOn, width: sidebarW, panel: activePanel })) }
     catch (e) { /* 忽略 */ }
-  }, [sidebarOn, sidebarW, activePanel, sessionId])
+  }, [sidebarOn, sidebarW, activePanel, sessionId, sidebarKey])
 
   // Ctrl+B 切换侧边栏（capture 抢占，避免与 DSH 全局冲突）
   React.useEffect(() => {
@@ -430,6 +447,7 @@ export function EditorView(props) {
     }
     if (editorRef.current || !monacoRef.current) return
     const m = monacoRef.current
+    const side = layoutRef.current === 'side'
     const ed = m.editor.create(node, {
       value: '',
       language: 'plaintext',
@@ -437,7 +455,7 @@ export function EditorView(props) {
       fontFamily: 'var(--ds-font-family-code, ui-monospace, monospace)',
       fontSize: 13,
       lineHeight: 20,
-      minimap: { enabled: true, scale: 1 },
+      minimap: { enabled: !side, scale: 1 },
       glyphMargin: true,
       lineDecorationsWidth: 16,
       automaticLayout: true,
@@ -447,7 +465,7 @@ export function EditorView(props) {
       renderWhitespace: 'selection',
       smoothScrolling: true,
       cursorBlinking: 'smooth',
-      padding: { top: 8 },
+      padding: { top: side ? 6 : 8 },
     })
     ed.addCommand(m.KeyMod.CtrlCmd | m.KeyCode.KeyS, () => { flushSave(); doSave(false) })
     ed.onDidChangeModelContent(() => {
@@ -491,6 +509,12 @@ export function EditorView(props) {
         if (s && p) menuHandlers()?.addRefToChat(p, { startLine: s.startLine, endLine: s.endLine })
       },
     })
+    // 在 OS 文件浏览器中打开/定位当前活动文件（与文件管理栏右键菜单同源能力）。
+    ed.addAction({
+      id: 'edrv.revealInExplorer', label: '在文件浏览器中打开', contextMenuGroupId: '1_edrv',
+      precondition: 'editorTextFocus',
+      run: (edx) => menuHandlers()?.openInExplorer(pathOf(edx)),
+    })
     // hover 差异块 → 浮出 Keep/Undo（req：鼠标移到编辑区差异块时显示）
     // 防闪烁：① 区域不变不 setState（浮窗锚定差异块起始行，不跟随鼠标）；② 延迟隐藏；
     // ③ 浮窗自身 onMouseEnter 取消隐藏计时（鼠标在浮窗与编辑器间移动不闪）。
@@ -751,8 +775,23 @@ export function EditorView(props) {
     addToConversation.appendReference(sessionId, path, range).then((o) => setStatus(statusOfAdd(o, '已添加文件引用')))
   }
 
+  /**
+   * 在 OS 文件浏览器中打开/定位路径（Monaco 右键菜单用，状态栏反馈）。
+   * @author ddj 2026年08月27号
+   * @param path 工作区相对路径（可能为 null）
+   */
+  const openInExplorer = (path) => {
+    if (!path) { setStatus('无活动文件'); return }
+    if (!sessionId) { setStatus('无活动会话'); return }
+    setStatus('正在打开文件浏览器…')
+    revealPathInExplorer(sessionId, path).then((outcome) => {
+      setStatus(outcome.ok ? '已在文件浏览器中打开' : '打开失败')
+      if (!outcome.ok && outcome.error) setError(outcome.error)
+    })
+  }
+
   // 供 Monaco 原生右键菜单 addAction 读取的最新动作闭包（空依赖回调不随渲染重建）
-  menuHandlersRef.current = { addRefToChat }
+  menuHandlersRef.current = { addRefToChat, openInExplorer }
 
   const openFile = (path, focusDiff) => {
     if (!path) return
@@ -879,36 +918,41 @@ export function EditorView(props) {
         React.createElement('button', { className: 'edrv-pill edrv-pill-undo', onClick: () => { dismissHover(); actHunk(hoverAct.region, true) } }, '↩ Undo'))
     : null
 
+  /** 组装差异 dock 快照（发布给 conversation.input.dock 的唯一 DiffBox 实例）。 */
+  const buildDockSnapshot = () => ({
+    mode: editorDockMode(active),
+    pendingRegions,
+    staleRegions,
+    onAct: actHunk,
+    onAcceptFile: acceptFile,
+    onUndoFile: undoFile,
+    onAcceptAllFiles: acceptAllFiles,
+    onUndoAllFiles: undoAllFiles,
+    allPendingCount: allPending.length,
+    onRollback: rollbackFile,
+    onJump: jumpTo,
+    otherFiles,
+    onOpenOther: (path) => openFile(path, true),
+    onOpenLauncher: (tab) => { setLauncherTab(tab || 'pending'); setLauncherOpen(true) },
+    onRefresh: reloadFile,
+    activePath: active,
+    diffIdx: contentReady ? diffIdx : 0,
+    diffTotal: displayDiffTotal(contentReady, pendingRegions.length, sum.files.find((file) => file.path === active)?.pending ?? 0),
+    fileIdx,
+    fileTotal: sum.pendingFiles.length,
+    onPrevDiff: () => gotoDiff(-1),
+    onNextDiff: () => gotoDiff(1),
+    onPrevFile: () => gotoFile(-1),
+    onNextFile: () => gotoFile(1),
+    onOpenNextFile: openNextFile,
+  })
+
   React.useEffect(() => {
     if (!sessionId) return
-    const mode = editorDockMode(active)
-    publishDiffDock(sessionId, {
-      mode,
-      pendingRegions,
-      staleRegions,
-      onAct: actHunk,
-      onAcceptFile: acceptFile,
-      onUndoFile: undoFile,
-      onAcceptAllFiles: acceptAllFiles,
-      onUndoAllFiles: undoAllFiles,
-      allPendingCount: allPending.length,
-      onRollback: rollbackFile,
-      onJump: jumpTo,
-      otherFiles,
-      onOpenOther: (path) => openFile(path, true),
-      onOpenLauncher: (tab) => { setLauncherTab(tab || 'pending'); setLauncherOpen(true) },
-      onRefresh: reloadFile,
-      activePath: active,
-      diffIdx: contentReady ? diffIdx : 0,
-      diffTotal: displayDiffTotal(contentReady, pendingRegions.length, sum.files.find((file) => file.path === active)?.pending ?? 0),
-      fileIdx,
-      fileTotal: sum.pendingFiles.length,
-      onPrevDiff: () => gotoDiff(-1),
-      onNextDiff: () => gotoDiff(1),
-      onPrevFile: () => gotoFile(-1),
-      onNextFile: () => gotoFile(1),
-      onOpenNextFile: openNextFile,
-    }, dockSourceRef.current)
+    publishDiffDock(sessionId, buildDockSnapshot(), dockSourceRef.current)
+    // 侧栏形态同步 Tab 角标计数（仅本形态写入；页签形态清零避免残留）
+    if (layout === 'side') setSidePending(sessionId, sum.totalFiles)
+    else setSidePending(sessionId, 0)
   })
 
   const overlay = launcherOpen
@@ -951,6 +995,8 @@ export function EditorView(props) {
     refreshRecords: () => refreshRecords(),
     editor: () => editorRef.current,
     outlineSources: props.outlineSources,
+    fileMenuItems: props.fileMenuItems,
+    notify: (message) => setStatus(message),
   }
 
   // 主编辑列（侧边栏右侧）：pathBar + tabRow + 编辑/差异区（底部整条留给 DSH 对话输入栏）
@@ -958,11 +1004,28 @@ export function EditorView(props) {
     body,
     hoverEl,
     overlay)
+  // 侧边栏引导条（仅旧页签形态且未装 betterSidebar 时显示；可复制安装命令、可关闭）
+  const dismissHint = () => {
+    setHintDismissed(true)
+    try { localStorage.setItem('edrv.side-hint-dismissed', '1') } catch (e) { /* 忽略 */ }
+  }
+  const copyInstallCmd = () => {
+    if (navigator.clipboard?.writeText) navigator.clipboard.writeText(SIDEBAR_INSTALL_CMD).catch(() => {})
+  }
+  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('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 }, '×'))
+    : null
   const mainCol = React.createElement('div', { className: 'edrv-main-col', style: { flex: 1, minWidth: 0, minHeight: 0, display: 'flex', flexDirection: 'column', overflow: 'hidden' } },
     pathBar,
     tabRow,
+    sideHintEl,
     editorArea)
   // 编辑器根节点按 composer 顶部边界动态限高，底部对话区域继续由 DSH 原生渲染。
+  // 侧栏形态由面板容器给高（100%），不做 composer 几何同步。
   const editorRow = React.createElement('div', { className: 'edrv-editor-row' },
     (sidebarOn && sidebarPanels
       ? React.createElement(SidebarView, {
@@ -977,8 +1040,15 @@ export function EditorView(props) {
       : null),
     mainCol)
 
-  return React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', style: { height: 'var(--edrv-editor-height, 100%)', maxHeight: 'var(--edrv-editor-height, 100%)', minHeight: 0, display: 'flex', flexDirection: 'column', background: 'var(--dsw-alias-bg-base,transparent)', overflow: 'hidden' } },
-    editorRow,
-    menuBackdrop,
-    tabMenuEl)
+  const baseStyle = { minHeight: 0, display: 'flex', flexDirection: 'column', background: 'var(--dsw-alias-bg-base,transparent)', overflow: 'hidden' }
+  const rootEl = layout === 'side'
+    ? React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', 'data-edrv-layout': 'side', className: 'edrv-view-side', style: Object.assign({}, baseStyle, { height: '100%' }) },
+        editorRow,
+        menuBackdrop,
+        tabMenuEl)
+    : React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', style: Object.assign({}, baseStyle, { height: 'var(--edrv-editor-height, 100%)', maxHeight: 'var(--edrv-editor-height, 100%)' }) },
+        editorRow,
+        menuBackdrop,
+        tabMenuEl)
+  return rootEl
 }

package/src/client/ui/SideEditorTab.ts

@@ -0,0 +1,48 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — SideEditorTab：betterSidebar「文件编辑」Tab 的组件包装。
+ * 把 TabComponentProps（scope/tab/visible）映射为 EditorView 侧栏形态 props，
+ * 并按会话 key 保证切会话状态干净重建；创建种子的初始打开在挂载后投递一次。
+ * 作者 ddj 2026年08月25号
+ */
+import React from 'react'
+import { EditorView } from './EditorView.js'
+import { resolveInitialOpen, setSideEditorMounted, takePendingSideOpen } from '../sidebarBridge.js'
+
+/**
+ * 侧边栏 Tab 组件（TabDescriptor.component 装配）。
+ * @param props TabComponentProps（scope.sessionId、tab.path/meta 等）
+ * @returns EditorView 侧栏形态
+ */
+export function SideEditorTab(props) {
+  const sessionId = props?.scope?.sessionId
+  const initial = React.useMemo(() => resolveInitialOpen(props?.tab), [props?.tab])
+  const dispatchedRef = React.useRef(false)
+
+  React.useEffect(() => {
+    setSideEditorMounted(true)
+    return () => setSideEditorMounted(false)
+  }, [])
+
+  React.useEffect(() => {
+    if (dispatchedRef.current) return
+    dispatchedRef.current = true
+    // 待消费打开（挂载前暂存的聚焦请求）优先于创建种子；两者都走同事件，EditorView 幂等处理
+    const pending = takePendingSideOpen(sessionId)
+    const request = pending ?? initial
+    window.dispatchEvent(new CustomEvent('edrv:open-editor', {
+      detail: { path: request?.path ?? null, focusDiff: request?.focusDiff === true },
+    }))
+  }, [initial.path, initial.focusDiff, sessionId])
+
+  return React.createElement(EditorView, {
+    key: sessionId,
+    sessionId,
+    layout: 'side',
+    schedule: props?.schedule,
+    addToConversation: props?.addToConversation,
+    sidebarPanels: props?.sidebarPanels,
+    outlineSources: props?.outlineSources,
+    fileMenuItems: props?.fileMenuItems,
+  })
+}

package/src/compat.ts

@@ -52,10 +52,12 @@ export function detectExternal(ctx: Ctx, depsAvailable: boolean): CompatAdapter[
   const mcpCount = entriesOf(ctx).length
   const settings = ctx.get('settings') as { describe?: unknown; update?: unknown } | undefined
   const hasSettings = Boolean(settings?.describe || settings?.update)
+  const sub = ctx.get('subprocess') as { spawn?: unknown } | undefined
   return [
     { name: MCP_PACKAGE, active: mcpCount > 0, note: mcpCount > 0 ? mcpCount + ' 个 MCP 服务条目' : '未检测到 MCP 条目（MCP 管理页显示为空）' },
     { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装' : '未安装：fileOpenTool 持久化降级为配置值' },
     { name: 'settings 服务', active: hasSettings, note: hasSettings ? '可读写设置' : '不可用（设置读写走配置回退）' },
+    { name: '文件浏览器打开（subprocess 服务）', active: typeof sub?.spawn === 'function', note: typeof sub?.spawn === 'function' ? '可定位/打开 OS 文件浏览器' : '不可用（右键「在文件浏览器中打开」将提示失败）' },
   ]
 }
 

package/src/reveal.ts

@@ -0,0 +1,64 @@
+/**
+ * dsh-vscode-mode host — 在 OS 文件浏览器中打开/定位路径（reveal 能力）。
+ * 纯函数 revealCommand 平台分发 + revealInExplorer 经 ctx.subprocess.spawn 发射
+ * （argv 数组、无 shell 插值，沿 workspace/revert 的 subprocess 契约）。
+ * 文件 → 资源管理器选中定位；目录 → 打开目录；Linux 无通用定位协议 → 打开所在目录。
+ * 作者 ddj 2026-08-27
+ */
+import { dirname } from 'node:path'
+import type { Ctx } from './store.js'
+
+/** reveal 结果（沿 revert.ts 的 Result 风格）。 */
+export type RevealResult = { ok: true } | { ok: false; error: string }
+
+/**
+ * 构造平台 opener 的 argv（纯函数，platform 可注入便于单测）。
+ * @author ddj 2026年08月27号
+ * @param absPath 绝对路径
+ * @param isDir 是否为目录
+ * @param platform 目标平台（缺省当前进程平台）
+ * @returns opener argv（无 shell 插值）
+ */
+export function revealCommand(absPath: string, isDir: boolean, platform: NodeJS.Platform = process.platform): { argv: string[] } {
+  switch (platform) {
+    case 'darwin':
+      return { argv: ['open', '-R', absPath] }
+    case 'win32':
+      // 文件 → 定位并选中；目录 → 直接打开该目录
+      return isDir
+        ? { argv: ['explorer.exe', absPath] }
+        : { argv: ['explorer.exe', '/select,', absPath] }
+    default:
+      // Linux 无通用 select 协议：文件打开所在目录、目录打开自身（KISS，对齐 better-sidebar）
+      return { argv: ['xdg-open', isDir ? absPath : dirname(absPath)] }
+  }
+}
+
+/**
+ * 经 host subprocess 服务发射 opener（fire-and-forget 语义）。
+ * Explorer 为 GUI 分离进程，非零退出码不视为失败；仅 spawn 级错误回失败。
+ * @author ddj 2026年08月27号
+ * @param ctx DSH host 上下文
+ * @param absPath 绝对路径
+ * @param isDir 是否为目录
+ * @returns 成功或失败原因
+ */
+export async function revealInExplorer(ctx: Ctx, absPath: string, isDir: boolean): Promise<RevealResult> {
+  const sub = ctx.get('subprocess')
+  if (!sub || typeof sub.spawn !== 'function') {
+    return { ok: false, error: '打开文件浏览器不可用：缺少 subprocess 服务' }
+  }
+  const { argv } = revealCommand(absPath, isDir)
+  try {
+    const handle = sub.spawn({
+      argv,
+      cwd: dirname(absPath),
+      stdio: { stdout: { maxBytes: 1 << 16 }, stderr: { maxBytes: 1 << 16 }, stdin: 'ignore' },
+      graceMs: 10000,
+    })
+    await handle.done
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: '打开失败：' + String(error) }
+  }
+}

package/src/rpc.ts

@@ -30,6 +30,7 @@ import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from
 import { buildReport } from './compat.js'
 import { readDevForm, setDevForm } from './devForm.js'
 import { normalizeRel, toTreeEntries } from './tree.js'
+import { revealInExplorer } from './reveal.js'
 
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = new Map<string, Promise<void>>()
@@ -336,6 +337,26 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
         return { ok: false, error: '读取目录失败：' + String(error) }
       }
     },
+    'edrv.revealInExplorer': async (args) => {
+      // 在 OS 文件浏览器中打开/定位路径（树行/编辑器右键菜单用），相对工作区解析。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const fs = ctx.get('fs')
+      if (!fs) return { ok: false, error: '缺少 fs' }
+      try {
+        const rel = normalizeRel(args.path)
+        if (rel === null) return { ok: false, error: '路径不合法' }
+        const target = await fs.resolve(rel || '.', { cwd: sc.cwd })
+        const info = await fs.stat(target)
+        if (!info) return { ok: false, error: '路径不存在' }
+        const abs = fs.processPath(target)
+        const outcome = await revealInExplorer(ctx, abs, info.type === 'directory')
+        if (!outcome.ok) return { ok: false, error: outcome.error }
+        return { ok: true, revealed: abs }
+      } catch (error) {
+        return { ok: false, error: '打开失败：' + String(error) }
+      }
+    },
     'mcp.list': async () => ({ ok: true, ...listMcp(ctx) }),
     'mcp.save': async (args) => {
       try { return { ok: true, server: await saveMcp(ctx, args.config) } }

package/src/shared/rpc.ts

@@ -60,6 +60,7 @@ export interface RpcRequestMap {
   'edrv.debug': { sessionId?: string; text: string }
   'edrv.searchFiles': { sessionId?: string; query: string }
   'edrv.listDir': { sessionId?: string; path: string }
+  'edrv.revealInExplorer': { sessionId?: string; path: string }
   'mcp.list': {}
   'mcp.save': { config: MpcConfig }
   'mcp.remove': { id: string }
@@ -94,6 +95,7 @@ export interface RpcOkMap {
   'edrv.debug': object
   'edrv.searchFiles': { files: string[]; truncated: boolean }
   'edrv.listDir': { root: string; path: string; entries: TreeEntry[] }
+  'edrv.revealInExplorer': { revealed: string }
   'mcp.list': { servers: MpcServer[] }
   'mcp.save': { server: MpcServer }
   'mcp.remove': object