dsh-vscode-mode 0.1.25 → 0.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

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

@@ -12,9 +12,11 @@ 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
 
 /**
  * 目录树面板主体。
@@ -36,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
@@ -98,10 +102,36 @@ export function FileExplorer(props) {
     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)

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/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
@@ -163,8 +200,33 @@ export function EditorView(props) {
     }).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) => {
@@ -289,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) {
@@ -435,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])
 
@@ -447,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()
@@ -625,7 +690,7 @@ export function EditorView(props) {
 
   const reloadFile = (skipStale) => {
     if (!active) return
-    loadContent(active, sessionId)
+    loadContent(active, sessionId, true)
     refreshRecords(skipStale === true)
   }
 
@@ -835,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()

package/src/routes.ts

@@ -3,7 +3,7 @@
  * 迁移自原 src/index.ts 的路由部分，路径/行为一字不改。
  * 作者 ddj 2026-08-20
  */
-import { readFile } from 'node:fs/promises'
+import { readFile, stat } from 'node:fs/promises'
 import { dirname, extname, join, normalize, resolve, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { ROUTE_PREFIX, noteOwnRoute, resetOwnRoutes, routeConflict } from './compat.js'
@@ -124,10 +124,11 @@ export function registerRoutes(
   }
 
   // Monaco Editor AMD 构建：/edrv/vendor/* → assets/vendor/*（路径穿越防护 + 按扩展名 MIME）
+  // ETag 协商缓存：弱 etag（mtime+size），配合 max-age 让浏览器 304 复用，插件升级内容变化自动失效。
   ctx.effect(() => guarded({
     kind: 'prefix',
     path: VENDOR_PREFIX,
-    handler: async (req: { method?: string; url?: string }, res: { statusCode?: number; setHeader: (k: string, v: string) => void; end: (b?: string | Uint8Array) => void }) => {
+    handler: async (req: { method?: string; url?: string; headers?: Record<string, string | string[] | undefined> }, res: { statusCode?: number; setHeader: (k: string, v: string) => void; end: (b?: string | Uint8Array) => void }) => {
       try {
         if (req.method !== 'GET' && req.method !== 'HEAD') {
           res.statusCode = 405
@@ -143,10 +144,25 @@ export function registerRoutes(
           res.end()
           return
         }
+        const info = await stat(target).catch(() => null)
+        if (!info || !info.isFile()) { res.statusCode = 404; res.end(); return }
+        const etag = 'W/"' + info.mtimeMs.toString(16) + '-' + info.size.toString(16) + '"'
+        const reqEtag = (() => {
+          const raw = req.headers?.['if-none-match']
+          if (Array.isArray(raw)) return raw[0]
+          return raw
+        })()
+        if (reqEtag === etag) {
+          res.statusCode = 304
+          res.setHeader('etag', etag)
+          res.end()
+          return
+        }
         const body = await readFile(target)
         res.statusCode = 200
         res.setHeader('content-type', VENDOR_MIME[extname(target)] ?? 'application/octet-stream')
         res.setHeader('cache-control', 'public, max-age=3600')
+        res.setHeader('etag', etag)
         res.end(body)
       } catch (error) {
         res.statusCode = 404