dsh-vscode-mode 0.1.22 → 0.1.25

package/src/client/ui/EditorView.ts

@@ -19,17 +19,22 @@ 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({})
@@ -51,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)
@@ -75,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(() => {
@@ -121,6 +131,25 @@ export function EditorView(props) {
     })
   }
 
+  /**
+   * 轮询去重：前后记录内容一致时返回原引用，React 跳过重渲染，
+   * 阻断 5s 轮询 → memo 链 → diff 重渲染/日志 的空转。
+   * @author ddj 2026年08月26号
+   * @param prev 当前 records
+   * @param next 轮询新结果
+   * @returns 内容一致返回 true
+   */
+  const sameRecords = (prev, next) => {
+    const pk = Object.keys(prev)
+    const nk = Object.keys(next)
+    if (pk.length !== nk.length) return false
+    for (const k of pk) {
+      if (!(k in next)) return false
+      if (JSON.stringify(prev[k]) !== JSON.stringify(next[k])) return false
+    }
+    return true
+  }
+
   const refreshRecords = (skipStale) => {
     if (!sessionId) return
     rpc('edrv.list', { sessionId, ...(skipStale ? { skipStale: true } : {}) }).then((res) => {
@@ -130,7 +159,7 @@ export function EditorView(props) {
         if (r.archived === true) continue
         map[r.callId] = r
       }
-      setRecords(map)
+      setRecords((prev) => (sameRecords(prev, map) ? prev : map))
     }).catch((e) => setError('list异常:' + String(e)))
   }
 
@@ -195,10 +224,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
@@ -249,7 +283,7 @@ export function EditorView(props) {
       window.removeEventListener('resize', scheduleUpdate)
       root.style.removeProperty('--edrv-editor-height')
     }
-  }, [sessionId])
+  }, [sessionId, layout])
 
   // localStorage v2 恢复页签
   React.useEffect(() => {
@@ -273,11 +307,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)
@@ -285,14 +320,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(() => {
@@ -431,6 +466,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',
@@ -438,7 +474,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,
@@ -448,7 +484,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(() => {
@@ -901,36 +937,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
@@ -982,11 +1023,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, {
@@ -1001,8 +1059,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/client/ui/menuPosition.ts

@@ -0,0 +1,63 @@
+/**
+ * dsh-vscode-mode client — 右键菜单 viewport 定位纯函数。
+ * 将目标行锚点与视口边界计算从 React 渲染层拆出，便于复用和单测。
+ * 作者 ddj 2026-08-28
+ */
+
+export interface MenuPosition {
+  left: number
+  top: number
+}
+
+export interface MenuAnchorRect {
+  top: number
+  right: number
+  width: number
+  height: number
+}
+
+/**
+ * 将菜单坐标限制在 viewport 内。
+ * @author ddj 2026年08月28号
+ * @param x 期望的 viewport x 坐标
+ * @param y 期望的 viewport y 坐标
+ * @param viewportWidth viewport 宽度
+ * @param viewportHeight viewport 高度
+ * @param menuWidth 菜单估算宽度
+ * @param menuHeight 菜单估算高度
+ * @returns 限制后的菜单位置
+ */
+export function clampMenuPosition(
+  x: number,
+  y: number,
+  viewportWidth: number,
+  viewportHeight: number,
+  menuWidth: number,
+  menuHeight: number,
+): MenuPosition {
+  const maxLeft = Math.max(4, viewportWidth - menuWidth)
+  const maxTop = Math.max(4, viewportHeight - menuHeight)
+  return {
+    left: Math.max(4, Math.min(x, maxLeft)),
+    top: Math.max(4, Math.min(y, maxTop)),
+  }
+}
+
+/**
+ * 将文件树行右键菜单锚定到目标行右侧；无法测量时回退到鼠标坐标。
+ * @author ddj 2026年08月28号
+ * @param rect 目标行的布局矩形
+ * @param fallbackX 鼠标 viewport x 坐标
+ * @param fallbackY 鼠标 viewport y 坐标
+ * @returns 菜单初始位置
+ */
+export function rowMenuPosition(
+  rect: MenuAnchorRect | null | undefined,
+  fallbackX: number,
+  fallbackY: number,
+): MenuPosition {
+  if (!rect || rect.width <= 0 || rect.height <= 0) {
+    return { left: fallbackX, top: fallbackY }
+  }
+  return { left: rect.right + 4, top: rect.top }
+}

package/src/rpc.ts

@@ -34,6 +34,8 @@ import { revealInExplorer } from './reveal.js'
 
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = new Map<string, Promise<void>>()
+/** debug 日志单文件上限：超限截断保留尾部，防文件无限增长拖慢每次追加。 */
+const DEBUG_LOG_CAP = 512 * 1024
 
 /** 记录 → 客户端视图（不含 before 全文，仅长度）。 */
 function recView(record: DiffRecord): RecordView {
@@ -300,7 +302,11 @@ export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearch
           const target = await fs.resolve('.dsh-edit-review-debug.log', { cwd: sc.cwd })
           const old = await fs.readText(target).catch(() => '')
           const line = new Date().toISOString() + ' ' + text + '\n'
-          await fs.writeText(target, (old || '') + line, void 0, void 0, policyOf(ctx, sc.session))
+          // 超上限时截断保留尾部：单文件体积有界，每次追加的读改写成本不随会话时长增长
+          const next = old.length + line.length > DEBUG_LOG_CAP
+            ? old.slice(-Math.floor(DEBUG_LOG_CAP / 2)) + line
+            : old + line
+          await fs.writeText(target, next, void 0, void 0, policyOf(ctx, sc.session))
         } catch (e) { /* 写日志失败忽略 */ }
       })
       debugWriteQueues.set(sc.cwd, task)