dsh-vscode-mode 0.1.23 → 0.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.23",
+  "version": "0.1.26",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
@@ -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/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,10 +10,13 @@
 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 { explorerLoad, explorerSave } from '../../state/explorerCache.js'
 import type { SidebarCtx } from '../types.js'
 
 const DIR_CAP = 4000
+const SAVE_DEBOUNCE_MS = 300
 
 /**
  * 目录树面板主体。
@@ -35,6 +38,8 @@ export function FileExplorer(props) {
   // expanded 的 ref 镜像：edrv:refresh 监听用首次渲染闭包，但需读到最新展开态
   const expandedRef = React.useRef({})
   expandedRef.current = expanded
+  // 展开状态防抖写回计时器
+  const saveTimerRef = React.useRef(null)
 
   const loadDir = (rel) => {
     const token = (tokensRef.current[rel] || 0) + 1
@@ -74,6 +79,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,11 +100,38 @@ export function FileExplorer(props) {
     setExpanded({})
     setLoading({})
     setError(null)
+    setMenu(null)
     setRoot(null)
+    // 恢复上次展开状态（对齐 VSCode：持久化展开路径，目录条目实时拉取）
+    const cached = sessionId ? explorerLoad(sessionId) : null
+    const restored = cached?.expanded ?? []
+    if (cached?.root) setRoot(cached.root)
+    if (restored.length) {
+      const next = {}
+      for (const rel of restored) next[rel] = true
+      setExpanded(next)
+    }
     void loadDir('')
+    for (const rel of restored) {
+      if (rel) void loadDir(rel)
+    }
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [sessionId])
 
+  // 展开状态防抖写回 localStorage（重启后恢复展开结构）
+  React.useEffect(() => {
+    if (saveTimerRef.current) { clearTimeout(saveTimerRef.current); saveTimerRef.current = null }
+    if (!sessionId) return
+    saveTimerRef.current = setTimeout(() => {
+      saveTimerRef.current = null
+      const expandedList = Object.keys(expanded).filter((k) => expanded[k] === true)
+      explorerSave(sessionId, { root, expanded: expandedList })
+    }, SAVE_DEBOUNCE_MS)
+    return () => {
+      if (saveTimerRef.current) { clearTimeout(saveTimerRef.current); saveTimerRef.current = null }
+    }
+  }, [expanded, root, sessionId])
+
   React.useEffect(() => {
     const onRefresh = () => refresh()
     window.addEventListener('edrv:refresh', onRefresh)
@@ -111,17 +144,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 +196,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/state/explorerCache.ts

@@ -0,0 +1,112 @@
+/**
+ * dsh-vscode-mode client — 资源管理栏展开状态持久化（纯函数，可单测）。
+ * 对齐 VSCode：只持久化展开路径集合，不缓存目录条目数据（条目实时 listDir）。
+ * 作者 ddj 2026-08-28
+ */
+
+/** localStorage 键前缀（按会话隔离）。 */
+const KEY_PREFIX = 'edrv.cache.explorer.v1.'
+
+/** 展开路径容量上限：超出丢弃最旧（按写入顺序近似 LRU）。 */
+export const EXPANDED_CAP = 500
+
+/** 展开状态缓存内容。 */
+export interface ExplorerCacheData {
+  root: string | null
+  expanded: string[]
+}
+
+/**
+ * 归一化展开路径：去空白、反斜杠→斜杠、去首尾斜杠，`..` 段拒绝。
+ * @author ddj 2026年08月28号
+ * @param rel 目录相对路径（'' = 根）
+ * @returns 归一化路径，非法返回 null
+ */
+export function normalizeExpanded(rel: string | undefined | null): string | null {
+  const s = String(rel ?? '').trim().replace(/\\/g, '/').replace(/^\/+|\/+$/g, '')
+  if (!s) return ''
+  const segs = s.split('/').filter((seg) => seg !== '.')
+  if (!segs.length) return ''
+  for (const seg of segs) {
+    if (seg === '..') return null
+  }
+  return segs.join('/')
+}
+
+/**
+ * 裁剪展开路径集：去重、丢弃非法路径、超容量丢弃尾部（保持传入顺序）。
+ * @author ddj 2026年08月28号
+ * @param expanded 原始展开路径集合
+ * @returns 规范化后的路径数组
+ */
+export function sanitizeExpanded(expanded: unknown): string[] {
+  if (!Array.isArray(expanded)) return []
+  const seen = new Set<string>()
+  const out: string[] = []
+  for (const item of expanded) {
+    const rel = normalizeExpanded(typeof item === 'string' ? item : null)
+    if (rel === null || seen.has(rel)) continue
+    seen.add(rel)
+    out.push(rel)
+    if (out.length >= EXPANDED_CAP) break
+  }
+  return out
+}
+
+/**
+ * 序列化缓存数据（JSON；root 为 null 时省略，减小体积）。
+ * @author ddj 2026年08月28号
+ * @param data 缓存数据
+ * @returns JSON 字符串
+ */
+export function serializeExplorer(data: ExplorerCacheData): string {
+  const payload = data.root === null || data.root === undefined
+    ? { v: 1, expanded: data.expanded }
+    : { v: 1, root: data.root, expanded: data.expanded }
+  return JSON.stringify(payload)
+}
+
+/**
+ * 解析缓存文本；损坏/格式不符 → null。
+ * @author ddj 2026年08月28号
+ * @param text localStorage 原文
+ * @returns 解析后的缓存数据，非法返回 null
+ */
+export function parseExplorer(text: string | null): ExplorerCacheData | null {
+  if (!text) return null
+  try {
+    const data = JSON.parse(text)
+    if (!data || typeof data !== 'object') return null
+    const root = typeof data.root === 'string' && data.root ? data.root : null
+    const expanded = sanitizeExpanded(data.expanded)
+    return { root, expanded }
+  } catch (error) {
+    return null
+  }
+}
+
+/**
+ * 读取某会话的展开状态缓存（localStorage 不可用 → null）。
+ * @author ddj 2026年08月28号
+ * @param sessionId 会话 id
+ * @returns 缓存数据或 null
+ */
+export function explorerLoad(sessionId: string): ExplorerCacheData | null {
+  try {
+    return parseExplorer(window.localStorage.getItem(KEY_PREFIX + String(sessionId)))
+  } catch (error) {
+    return null
+  }
+}
+
+/**
+ * 写入某会话的展开状态缓存（损坏/配额满 → 忽略）。
+ * @author ddj 2026年08月28号
+ * @param sessionId 会话 id
+ * @param data 缓存数据
+ */
+export function explorerSave(sessionId: string, data: ExplorerCacheData): void {
+  try {
+    window.localStorage.setItem(KEY_PREFIX + String(sessionId), serializeExplorer(data))
+  } catch (error) { /* 配额满/隐私模式忽略 */ }
+}

package/src/client/state/viewStateCache.ts

@@ -0,0 +1,119 @@
+/**
+ * dsh-vscode-mode client — 编辑器视图状态持久化（纯函数，可单测）。
+ * 对齐 VSCode workbench.editor.restoreViewState：恢复每个文件的光标/滚动/折叠位置。
+ * 视图状态 = Monaco editor.saveViewState() 返回值（JSON 可序列化），按 path 存储。
+ * 作者 ddj 2026-08-28
+ */
+
+/** localStorage 键前缀（按会话隔离）。 */
+const KEY_PREFIX = 'edrv.cache.viewstate.v1.'
+
+/** 视图状态条目容量上限。 */
+export const VIEWSTATE_CAP = 50
+
+/** 视图状态序列化体积上限（单条目，防止超大选区/折叠数据撑爆配额）。 */
+export const VIEWSTATE_BYTES_CAP = 64 * 1024
+
+/**
+ * 判断对象是否为合法的 Monaco view state（保守形状校验，非深校验）。
+ * @author ddj 2026年08月28号
+ * @param value 待校验对象
+ * @returns 是否可接受
+ */
+export function isViewStateLike(value: unknown): boolean {
+  if (!value || typeof value !== 'object') return false
+  const v = value as Record<string, unknown>
+  // 至少含光标状态与视口滚动信息之一；无内容时拒绝（空对象无恢复价值）
+  return Array.isArray(v.cursorState) || typeof v.viewState === 'object'
+    || Array.isArray(v.contributionsState)
+}
+
+/**
+ * 序列化视图状态映射（path → viewState）。
+ * @author ddj 2026年08月28号
+ * @param states path → viewState 映射
+ * @returns JSON 字符串
+ */
+export function serializeViewStates(states: Record<string, unknown>): string {
+  return JSON.stringify({ v: 1, states })
+}
+
+/**
+ * 解析视图状态文本；损坏/格式不符 → null。
+ * @author ddj 2026年08月28号
+ * @param text localStorage 原文
+ * @returns path → viewState 映射，非法返回 null
+ */
+export function parseViewStates(text: string | null): Record<string, unknown> | null {
+  if (!text) return null
+  try {
+    const data = JSON.parse(text)
+    if (!data || typeof data !== 'object') return null
+    const states = (data as Record<string, unknown>).states
+    if (!states || typeof states !== 'object' || Array.isArray(states)) return null
+    const out: Record<string, unknown> = {}
+    for (const [path, state] of Object.entries(states)) {
+      if (typeof path !== 'string' || !path) continue
+      if (!isViewStateLike(state)) continue
+      out[path] = state
+    }
+    return out
+  } catch (error) {
+    return null
+  }
+}
+
+/**
+ * 把新视图状态并入既有映射：同 path 覆盖、按写入顺序裁剪到容量上限。
+ * @author ddj 2026年08月28号
+ * @param states 既有映射
+ * @param path 文件路径
+ * @param state 视图状态
+ * @returns 新映射（容量裁剪后）
+ */
+export function upsertViewState(
+  states: Record<string, unknown>,
+  path: string,
+  state: unknown,
+): Record<string, unknown> {
+  if (!path || !isViewStateLike(state)) return states
+  try {
+    if (JSON.stringify(state).length > VIEWSTATE_BYTES_CAP) return states
+  } catch (error) {
+    return states
+  }
+  const next = Object.assign({}, states)
+  delete next[path] // 先删后加，保证该 path 排到最末（近似 LRU：最新写入）
+  next[path] = state
+  const keys = Object.keys(next)
+  if (keys.length > VIEWSTATE_CAP) {
+    for (const k of keys.slice(0, keys.length - VIEWSTATE_CAP)) delete next[k]
+  }
+  return next
+}
+
+/**
+ * 读取某会话的视图状态缓存（localStorage 不可用 → 空映射）。
+ * @author ddj 2026年08月28号
+ * @param sessionId 会话 id
+ * @returns path → viewState 映射
+ */
+export function viewStatesLoad(sessionId: string): Record<string, unknown> {
+  try {
+    return parseViewStates(window.localStorage.getItem(KEY_PREFIX + String(sessionId))) ?? {}
+  } catch (error) {
+    return {}
+  }
+}
+
+/**
+ * 写入某会话的视图状态缓存（损坏/配额满 → 忽略）。
+ * @author ddj 2026年08月28号
+ * @param sessionId 会话 id
+ * @param states path → viewState 映射
+ */
+export function viewStatesSave(sessionId: string, states: Record<string, unknown>): void {
+  try {
+    window.localStorage.setItem(KEY_PREFIX + String(sessionId), serializeViewStates(states))
+  } catch (error) { /* 配额满/隐私模式忽略 */ }
+}

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

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/EditorView.ts

@@ -20,6 +20,7 @@ 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'
+import { upsertViewState, viewStatesLoad, viewStatesSave } from '../state/viewStateCache.js'
 
 /**
  * 中央编辑区：文件页签（脏点/关闭/打开路径）+ Ctrl+P 搜索 + Monaco 编辑器 +
@@ -67,6 +68,8 @@ export function EditorView(props) {
   const viewRootRef = React.useRef(null)
   const monacoRef = React.useRef(null)
   const modelsRef = React.useRef(new Map())
+  // 视图状态缓存（path → Monaco viewState；重启后恢复光标/滚动/折叠位置）
+  const viewStatesRef = React.useRef({})
   const saveTimerRef = React.useRef(null)
   const loadSeqRef = React.useRef(0)
   const programmaticRef = React.useRef(false)
@@ -120,8 +123,42 @@ export function EditorView(props) {
     if (select) setActive(path)
   }
 
+  /**
+   * 保存当前活动文件的视图状态（光标/滚动/折叠）到会话缓存。
+   * @author ddj 2026年08月28号
+   * @param path 要保存的文件路径（缺省 = 当前 active）
+   */
+  const saveViewState = (path) => {
+    const ed = editorRef.current
+    const target = path ?? active
+    if (!ed || !target) return
+    try {
+      const state = ed.saveViewState()
+      if (!state) return
+      viewStatesRef.current = upsertViewState(viewStatesRef.current, target, state)
+      viewStatesSave(sessionId, viewStatesRef.current)
+    } catch (e) { /* 视图状态保存失败忽略 */ }
+  }
+
+  /**
+   * 恢复指定文件的视图状态（内容就绪、setModel 后调用；恢复后即消费删除）。
+   * @author ddj 2026年08月28号
+   * @param path 文件路径
+   */
+  const restoreViewState = (path) => {
+    const ed = editorRef.current
+    if (!ed || !path) return
+    const saved = viewStatesRef.current[path]
+    if (!saved) return
+    const next = Object.assign({}, viewStatesRef.current)
+    delete next[path]
+    viewStatesRef.current = next
+    try { ed.restoreViewState(saved) } catch (e) { /* 恢复失败忽略（行号越界自动兜底） */ }
+  }
+
   const closeTab = (path) => {
     flushSave()
+    if (path === active) saveViewState(path)
     setTabs((prev) => {
       const idx = prev.findIndex((t) => t.path === path)
       if (idx < 0) return prev
@@ -131,6 +168,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) => {
@@ -140,12 +196,37 @@ 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)))
   }
 
-  const loadContent = (path, sid) => {
+  /**
+   * 加载文件内容（对齐 VSCode model 复用：会话内已打开的 model 直接秒显，
+   * 后台静默 RPC 校验防陈旧；首次打开走原读取流程）。
+   * @author ddj 2026年08月28号
+   * @param path 文件路径
+   * @param sid 会话 id
+   * @param force 强制走 RPC（reloadFile 用，跳过 model 复用）
+   */
+  const loadContent = (path, sid, force) => {
     const seq = ++loadSeqRef.current
+    const cachedModel = force ? null : modelsRef.current.get(path)
+    if (cachedModel) {
+      // model 命中：直接显示其内容（切 tab 零等待），后台静默校验
+      setContent(cachedModel.getValue())
+      setContentPath(path)
+      setLoadStage((prev) => ({ progress: Math.max(84, prev.progress), message: '文件已读取，准备创建编辑器…' }))
+      setStatus('已加载')
+      rpc('edrv.read', { sessionId: sid, path }).then((res) => {
+        if (seq !== loadSeqRef.current || path !== active) return
+        if (res && res.ok && res.content !== cachedModel.getValue()) {
+          saveViewState(path) // 内容更新前保留当前视图位置
+          setContent(res.content)
+          setStatus('已加载')
+        }
+      }).catch(() => { /* 校验失败保留缓存内容 */ })
+      return
+    }
     setLoadError(null)
     setLoadStage({ progress: monaco ? 72 : 12, message: '读取文件内容…' })
     rpc('edrv.read', { sessionId: sid, path }).then((res) => {
@@ -270,6 +351,7 @@ export function EditorView(props) {
   React.useEffect(() => {
     if (bootRef.current || !sessionId) return
     bootRef.current = true
+    viewStatesRef.current = viewStatesLoad(sessionId)
     try {
       const raw = localStorage.getItem('edrv.editor.v2.' + String(sessionId))
       if (raw) {
@@ -416,6 +498,7 @@ export function EditorView(props) {
     const ed = editorRef.current
     const model = getModel(active, content)
     if (ed.getModel() !== model) ed.setModel(model)
+    restoreViewState(active)
     setLoadStage((prev) => ({ progress: Math.max(96, prev.progress), message: '创建编辑器视图…' }))
   }, [monaco, active, content])
 
@@ -428,6 +511,7 @@ export function EditorView(props) {
 
   React.useEffect(() => () => {
     flushSave()
+    saveViewState(active)
     diffRendererRef.current?.dispose?.()
     if (editorRef.current) { editorRef.current.dispose(); editorRef.current = null }
     for (const m of modelsRef.current.values()) m.dispose()
@@ -606,7 +690,7 @@ export function EditorView(props) {
 
   const reloadFile = (skipStale) => {
     if (!active) return
-    loadContent(active, sessionId)
+    loadContent(active, sessionId, true)
     refreshRecords(skipStale === true)
   }
 
@@ -816,7 +900,7 @@ export function EditorView(props) {
       key: t.path,
       className: 'edrv-tab' + (t.path === active ? ' edrv-tab-active' : ''),
       title: t.path,
-      onClick: () => { if (t.path !== active) { flushSave(); setActive(t.path) } },
+      onClick: () => { if (t.path !== active) { flushSave(); saveViewState(active); setActive(t.path) } },
       onContextMenu: (e) => {
         e.preventDefault()
         e.stopPropagation()