dsh-vscode-mode 0.14.6 → 0.14.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.14.6",
+  "version": "0.14.8",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [

package/src/capture.ts

@@ -13,7 +13,7 @@ import { dirname } from 'node:path'
 import type { DiffRecord, Hunk } from './shared/types.js'
 import { annotateHunks, fingerprint } from './shared/diff.js'
 import type { Ctx, Session } from './store.js'
-import { READ_CAP, loadBucket, saveBucket } from './store.js'
+import { READ_CAP, archiveCanceled, loadBucket, saveBucket } from './store.js'
 import { fileMaxBatch, prune } from './model.js'
 import type { Registry } from './registry.js'
 import { cwdOf } from './registry.js'
@@ -253,6 +253,9 @@ async function persistRecord(ctx: Ctx, registry: Registry, session: Session, cwd
     for (const [callId, rec] of prior) bucket.set(callId, rec)
     throw error
   }
+  // 先保存再独立归档：优化失败不得撤回已捕获的记录，下次列表维护可重试。
+  try { await archiveCanceled(ctx, session, cwd, bucket, record) }
+  catch (error) { log.warn('archive canceled edits failed: ' + String(error)) }
 }
 
 /**

package/src/client/events.ts

@@ -49,9 +49,13 @@ export function openDiffView(path: string): void {
   }, 80)
 }
 
-/** 差异状态变化：触发角标/DiffBox 重拉。 */
-export function emitRefresh(): void {
-  window.dispatchEvent(new CustomEvent('edrv:refresh'))
+export interface RefreshNotice { scope?: string; paths?: string[]; eventId?: string; kind?: 'text' | 'structure' | 'svn' | 'unknown' }
+let refreshSeq = 0
+/** @public @author ddj 2026年10月10号 @param notice Scope/path/id; absent detail means legacy unknown/full. @returns Shared id for multi-channel deduplication. */
+export function emitRefresh(notice: RefreshNotice = {}): string {
+  const eventId = notice.eventId ?? 'change-' + Date.now() + '-' + (++refreshSeq)
+  window.dispatchEvent(new CustomEvent('edrv:refresh', { detail: { ...notice, eventId } }))
+  return eventId
 }
 
 /**
@@ -60,9 +64,11 @@ export function emitRefresh(): void {
  * @author ddj 2026年09月15号
  * @param path 发生变化的文件路径
  */
-export function emitFileChanged(path: string): void {
+export function emitFileChanged(path: string, notice: RefreshNotice = {}): string | undefined {
   if (!path) return
-  window.dispatchEvent(new CustomEvent('edrv:file-changed', { detail: { path } }))
+  const eventId = notice.eventId ?? 'change-' + Date.now() + '-' + (++refreshSeq)
+  window.dispatchEvent(new CustomEvent('edrv:file-changed', { detail: { ...notice, path, paths: notice.paths ?? [path], eventId } }))
+  return eventId
 }
 
 /** 打开指定路径到编辑区页签。 */

package/src/client/openFlow.ts

@@ -10,7 +10,7 @@ import { rpc } from './rpc.js'
 import { chooseWorkspace } from './chooseDialog.js'
 import { requestOpen } from './openReceipt.js'
 import { toastDom } from './externalOpen.js'
-import { createAddToConversation } from './addToConversation.js'
+import { createAddToConversation, newDraftSession } from './addToConversation.js'
 import type { AddOutcome, CtxLike } from './addToConversation.js'
 import type { OpenParams } from '../shared/externalOpen.js'
 
@@ -307,12 +307,42 @@ function realDeps(ctx: unknown, overrides: Partial<OpenDeps> = {}): OpenDeps {
       const snap = (service('sessions')?.list?.getSnapshot?.() ?? {}) as { ids?: string[]; byId?: Record<string, SessionRow>; phase?: string }
       return { ids: snap.ids ?? [], byId: snap.byId ?? {}, ready: snap.phase !== 'pending' }
     },
-    createSession: async (opts) => await service('sessions').create(opts),
+    createSession: async (opts) => {
+      // 桌面端 sessions 服务面缺 create（实证缺 open；create 同代面可能缺）——
+      // 直连 create 不可用时回落 newDraftSession 的多通道建会话（宽松解析 id）。
+      const sessions = service('sessions') as { create?: (o: object) => unknown } | undefined
+      if (typeof sessions?.create === 'function') {
+        try {
+          const created = await sessions.create(opts)
+          const id = typeof created === 'string' && created ? created
+            : typeof (created as { id?: unknown } | null)?.id === 'string' ? (created as { id: string }).id
+            : typeof (created as { sessionId?: unknown } | null)?.sessionId === 'string' ? (created as { sessionId: string }).sessionId
+            : ''
+          if (id) return id
+        } catch { /* 回落下一通道 */ }
+      }
+      const draft = await newDraftSession(ctx as CtxLike, opts.cwd)
+      if (draft.ok && draft.id) return draft.id
+      throw new Error('新建会话失败')
+    },
     createWorkspace: async (path) => {
       const ws = await service('workspaces').create({ path })
       return { workspaceId: ws.workspaceId, title: ws.title }
     },
-    openSession: (id) => service('sessions').open(id),
+    openSession: (id) => {
+      // 桌面端 sessions 服务面缺 .open（实证 TypeError）——按 startDraftSession 同款
+      // 多面切换：materializeScope 铸 scope → manager.select 切会话 → open 兜底，缺面静默。
+      try {
+        const sessions = service('sessions') as {
+          materializeScope?: (id: string) => unknown
+          manager?: { select?: (id: string) => void }
+          open?: (id: string) => void
+        } | undefined
+        sessions?.materializeScope?.(id)
+        void sessions?.manager?.select?.(id)
+        void sessions?.open?.(id)
+      } catch { /* 面能力缺失不致命：打开失败由 openChecked 抛错兜底 */ }
+    },
     reference: async (sessionId, path, appearance) => {
       const outcome: AddOutcome = await add.appendReference(sessionId, path, undefined, appearance)
       // ok/busy（纯文本降级）都算已落点；unavailable/failed 交给 settleRef 继续重试

package/src/client/rpc.ts

@@ -4,6 +4,7 @@
  * 诊断开关运行时化：内存缓存 + localStorage 持久（日志弹窗开关即改即生效，免刷新）。
  * 作者 ddj 2026-08-20 / 2026-09-17
  */
+import { svnNotice } from './svnNotice.js'
 import { appUrl } from '../shared/appUrl.js'
 import { RPC_PATH } from '../shared/rpc.js'
 import type { RpcMethod, RpcRequestMap, RpcResult } from '../shared/rpc.js'
@@ -45,6 +46,15 @@ export function setDebugEnabled(on: boolean): void {
  * @returns A validated business result; transport failures reject with a readable error.
  */
 export async function rpc<M extends RpcMethod>(method: M, args: RpcRequestMap[M], signal?: AbortSignal): Promise<RpcResult<M>> {
+  try {
+    const out = await rpcFetch(method, args, signal)
+    svnNotice(method, args, out.ok)
+    return out
+  } catch (error) { svnNotice(method, args, false); throw error }
+}
+
+/** @private @author ddj 2026年10月10号 @param method Typed method. @param args Request. @param signal Fetch lifetime. @returns Validated authenticated business response. @throws Transport/format errors. */
+async function rpcFetch<M extends RpcMethod>(method: M, args: RpcRequestMap[M], signal?: AbortSignal): Promise<RpcResult<M>> {
   const res = await fetch(appUrl(RPC_PATH), {
     method: 'POST',
     credentials: 'same-origin',

package/src/client/sidebar/menuItems.ts

@@ -126,9 +126,10 @@ async function fsCall<M extends RpcMethod>(method: M, args: RpcRequestMap[M]): P
  * @param ctx 面板上下文
  * @param okText 成功反馈文案
  */
-function fsDone(ctx: SidebarCtx, okText: string): void {
+let fsSequence = 0
+function fsDone(ctx: SidebarCtx, okText: string, paths: string[]): void {
   ctx.notify?.(okText)
-  emit('edrv:refresh', {})
+  emit('edrv:refresh', { scope: ctx.scope, paths, kind: 'structure', eventId: 'fs-' + Date.now() + '-' + (++fsSequence) })
   ctx.refreshSvnChanges?.()
 }
 
@@ -176,7 +177,7 @@ async function createEntry(target: TreeMenuTarget, ctx: SidebarCtx, kind: 'file'
     return
   }
   if (kind === 'file') ctx.openFile(path)
-  fsDone(ctx, (kind === 'file' ? '已新建文件 ' : '已新建文件夹 ') + path)
+  fsDone(ctx, (kind === 'file' ? '已新建文件 ' : '已新建文件夹 ') + path, [path])
 }
 
 /**
@@ -205,7 +206,7 @@ async function renameEntry(target: TreeMenuTarget, ctx: SidebarCtx): Promise<voi
     return
   }
   if (res.to !== res.from) emit('edrv:path-renamed', { from: res.from, to: res.to })
-  fsDone(ctx, '已重命名')
+  fsDone(ctx, '已重命名', [res.from, res.to])
 }
 
 /**
@@ -227,7 +228,7 @@ async function deleteEntry(target: TreeMenuTarget, ctx: SidebarCtx): Promise<voi
     return
   }
   emit('edrv:path-deleted', { path: target.path })
-  fsDone(ctx, (dirTarget ? '已永久删除「' : '已删除「') + name + '」')
+  fsDone(ctx, (dirTarget ? '已永久删除「' : '已删除「') + name + '」', [target.path])
 }
 
 /**
@@ -252,7 +253,7 @@ async function pasteInto(target: TreeMenuTarget, ctx: SidebarCtx): Promise<void>
     clearFileClip()
     emit('edrv:path-renamed', { from: res.from, to: res.to })
   }
-  fsDone(ctx, (cut ? '已移动到 ' : '已复制到 ') + (target.path || '工作区根目录'))
+  fsDone(ctx, (cut ? '已移动到 ' : '已复制到 ') + (target.path || '工作区根目录'), cut ? [res.from, res.to] : [res.to])
 }
 
 // --endregion

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

@@ -6,8 +6,9 @@
  * 保留旧条目强制后台重列（force）；每次用户发起加载后预取 ≤4 个子目录（排除重型
  * 目录、缓存新鲜跳过、不级联）；10s 轻量跟随已展开目录（命中索引，RPC 近零成本）。
  * 差异角标/右键菜单/展开状态持久化行为不变；行图标用官方原语（文件夹图标 + 文件类型图标）。
- * SVN 状态徽标（P2）：行尾方形字母，数据来自 ctx.svnChangeMap（客户端合成，不改 listDir 契约）。
- * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10 / 2026-09-16
+ * SVN 图标叠加：受控正常绿色对勾、本地修改红色感叹号；目录聚合后代状态。
+ * 远端更新箭头由显式只读检查提供，与本地状态并存，不执行更新。
+ * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10 / 2026-09-16 / 2026-10-09
  */
 import React from 'react'
 import { IconFolderClose16, IconFolderOpen16, IconRefreshOutline16, fileIconEl } from '../../ui/icons.js'
@@ -19,7 +20,10 @@ import { entriesCacheGet, entriesCacheIsFresh, entriesCachePut } from '../../sta
 import { workspaceScopeOf } from '../../state/scopeStore.js'
 import { ancestorDirsOf } from '../../tabActions.js'
 import { refreshSvnChanges, refreshSvnStatus } from '../../svnStatus.js'
-import { SVN_STATUS_TONE, svnBadgeOf, svnBadgeTitle } from '../../../shared/svn.js'
+import { Button } from '@deepseek-ai/dsh-client-ui-primitives'
+import { emitRefresh } from '../../events.js'
+import { svnOverlayEl, viewOverlayOf } from '../../ui/SvnOverlay.js'
+import { useExplorerSvn } from './useExplorerSvn.js'
 import type { SidebarCtx } from '../types.js'
 
 const DIR_CAP = 4000
@@ -73,6 +77,26 @@ function refreshIconEl() {
 }
 // --endregion
 
+/** @private @author ddj 2026年10月10号 @param props Stable primitive row fields and compact mark. @returns Official file icon with independently fresh SVN evidence. */
+function rowView(props) {
+  const { path, name, type, depth, isDir, isOpen, pending, active, context, reveal, mark, remote, onSelect, onContext } = props
+  /** @private @author ddj 2026年10月10号 Handle row activation. */
+  function select() { onSelect(path, isDir) }
+  /** @private @author ddj 2026年10月10号 @param event Context trigger. */
+  function menu(event) { onContext(path, type, event) }
+  return React.createElement('div', {
+    className: 'edrv-tree-row' + (active ? ' edrv-tree-active' : '') + (context ? ' edrv-tree-context' : '')
+      + (reveal ? ' edrv-tree-reveal' : '') + (mark?.stale ? ' edrv-tree-stale' : ''),
+    title: path + (mark?.stale ? '；SVN 状态陈旧，等待确认' : ''), 'data-edrv-path': path,
+    style: { paddingLeft: 6 + depth * 14 }, onClick: select, onContextMenu: menu,
+  },
+    React.createElement('span', { className: 'edrv-tree-chev' }, isDir ? (isOpen ? '▾' : '▸') : ''),
+    React.createElement('span', { className: 'edrv-tree-iconbox' }, rowIconEl({ name }, isDir, isOpen), svnOverlayEl(viewOverlayOf(mark), remote)),
+    React.createElement('span', { className: 'edrv-tree-name' + (type === 'other' ? ' edrv-tree-dim' : '') }, name),
+    pending > 0 ? React.createElement('span', { className: 'edrv-tree-badge' }, String(pending)) : null)
+}
+const ExplorerRow = React.memo(rowView)
+
 /**
  * 转义 CSS 属性选择器的值（路径含引号/反斜杠时避免选择器语法错误）。
  * @author ddj 2026年09月11号
@@ -92,10 +116,11 @@ export function FileExplorer(props) {
   const sessionId = ctx?.sessionId
   // 状态作用域：展开树/条目缓存按工作区隔离（同工作区切对话恢复同一份），无 cwd 回退会话
   const scope = ctx?.scope ?? workspaceScopeOf(null, sessionId)
+  const scopeRef = React.useRef(scope)
+  scopeRef.current = scope
   const openFile = ctx?.openFile
   const activePath = ctx?.activePath ?? null
   const pendingByPath = ctx?.pendingByPath ?? {}
-  const svnChangeMap = ctx?.svnChangeMap ?? {}
   const [root, setRoot] = React.useState(null)
   const [dirs, setDirs] = React.useState({}) // rel → 最新条目（本会话内存态）
   const [expanded, setExpanded] = React.useState({})
@@ -239,7 +264,9 @@ export function FileExplorer(props) {
   }
   revealInTreeRef.current = revealInTree
 
-  const refresh = () => {
+  const refresh = (event) => {
+    if (event?.detail?.scope && event.detail.scope !== scope) return
+    if (event?.detail?.paths?.length) { for (const path of event.detail.paths) onFileChanged(path); return }
     const keep = Object.keys(expandedRef.current).filter((k) => expandedRef.current[k] === true)
     tokensRef.current = {}
     setMenu(null)
@@ -274,7 +301,7 @@ export function FileExplorer(props) {
     if (typeof path !== 'string' || !path) return
     const rel = path.replace(/\\/g, '/').replace(/^\.\//, '')
     const parts = rel.split('/').filter(Boolean)
-    if (parts.length > 1) changedRelRef.current.add(parts.slice(0, -1).join('/'))
+    changedRelRef.current.add(parts.slice(0, -1).join('/'))
     // 绝对路径（或已在更深层目录）：补上所有已展开的祖先目录
     for (const dir of ancestorDirsOf(rel)) {
       if (expandedRef.current[dir] === true) changedRelRef.current.add(dir)
@@ -293,7 +320,10 @@ export function FileExplorer(props) {
 
   // edrv:file-changed（外部改动同步）：按变化路径强制重列对应目录（去抖合并）
   React.useEffect(() => {
-    const handler = (event) => onFileChanged(event?.detail?.path)
+    const handler = (event) => {
+      if (event?.detail?.scope && event.detail.scope !== scopeRef.current) return
+      for (const path of event?.detail?.paths ?? [event?.detail?.path]) onFileChanged(path)
+    }
     window.addEventListener('edrv:file-changed', handler)
     return () => {
       window.removeEventListener('edrv:file-changed', handler)
@@ -343,7 +373,7 @@ export function FileExplorer(props) {
 
   // edrv:refresh（差异决策/回滚后）：保留旧条目，强制后台重列
   React.useEffect(() => {
-    const onRefresh = () => refreshRef.current?.()
+    const onRefresh = (event) => refreshRef.current?.(event)
     window.addEventListener('edrv:refresh', onRefresh)
     return () => window.removeEventListener('edrv:refresh', onRefresh)
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -367,6 +397,7 @@ export function FileExplorer(props) {
   React.useEffect(() => {
     if (!scope) return
     const timer = setInterval(() => {
+      if (document.visibilityState === 'hidden') return
       const open = Object.keys(expandedRef.current).filter((k) => expandedRef.current[k] === true)
       if (!open.length) return
       for (const rel of open) loadDirRef.current?.(rel, {})
@@ -375,69 +406,49 @@ export function FileExplorer(props) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [scope])
 
-  const rootName = root ? String(root).split(/[\\/]/).pop() || root : ''
-
-  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'
-    // SVN 状态徽标：客户端由变更清单合成的查表（未加载/干净/未版本控制被过滤时不出徽标）
-    const svnEntry = svnChangeMap[e.path]
-    const svnLetter = svnEntry ? svnBadgeOf(svnEntry) : ''
-    return React.createElement('div', {
-      key: e.path,
-      className: 'edrv-tree-row'
-        + (active ? ' edrv-tree-active' : '')
-        + (contextTarget ? ' edrv-tree-context' : '')
-        + (revealPath === e.path ? ' edrv-tree-reveal' : ''),
-      title: e.path,
-      'data-edrv-path': e.path,
-      style: { paddingLeft: 6 + depth * 14 },
-      onClick: () => { if (isDir) toggle(e.path); else openFile(e.path) },
-      onContextMenu: (ev) => {
-        ev.preventDefault()
-        ev.stopPropagation()
-        // 菜单左上角对齐鼠标点击位置（视口坐标，ContextMenu 内再做 viewport clamp）
-        setMenu({ x: ev.clientX, y: ev.clientY, target: { path: e.path, type: e.type } })
-      },
-    },
-      React.createElement('span', { className: 'edrv-tree-chev' },
-        isDir ? (isOpen ? '▾' : '▸') : ''),
-      rowIconEl(e, isDir, isOpen),
-      React.createElement('span', { className: 'edrv-tree-name' + (dim ? ' edrv-tree-dim' : '') },
-        e.name),
-      (svnLetter
-        ? React.createElement('span', {
-            className: 'edrv-tree-svn edrv-svn-ch-' + (SVN_STATUS_TONE[svnEntry.status] ?? 'plain'),
-            title: 'SVN ' + svnBadgeTitle(svnEntry),
-          }, svnLetter)
-        : null),
-      (pending > 0
-        ? React.createElement('span', { className: 'edrv-tree-badge' }, String(pending))
-        : null))
+  /** @private @author ddj 2026年10月10号 @returns Expanded tree descriptors; icon refreshes never re-walk the tree. */
+  function flatten() {
+    const result = []
+    /** @private @author ddj 2026年10月10号 @param rel Directory. @param depth Indent level. Appends only expanded rows and placeholders. */
+    function visit(rel, depth) {
+      const entries = dirs[rel] ?? entriesCacheGet(scope, rel)
+      if (!entries) { result.push({ key: rel + ':loading', depth, text: loading[rel] ? '加载中…' : '无法加载' }); return }
+      for (const e of entries) {
+        const isDir = e.type === 'directory', isOpen = expanded[e.path] === true
+        result.push({ key: e.path, e, depth, isDir, isOpen })
+        if (isDir && isOpen) visit(e.path, depth + 1)
+      }
+      if (entries.length >= DIR_CAP) result.push({ key: rel + ':cap', depth, text: '目录条目过多，仅显示前 ' + DIR_CAP + ' 项' })
+    }
+    visit('', 0)
+    return result
+  }
+  const treeRows = React.useMemo(flatten, [dirs, expanded, loading, scope])
+  /** @private @author ddj 2026年10月10号 @returns Stable RPC row projection, independent of icon-only renders. */
+  function projectRows() { return treeRows.filter((row) => row.e).map((row) => ({ path: row.e.path, isDir: row.isDir })) }
+  const svnRows = React.useMemo(projectRows, [treeRows])
+  const svn = useExplorerSvn(ctx, svnRows)
+  /** @private @author ddj 2026年10月10号 @param path Row path. @param isDir Row kind. Routes selection through latest callback. */
+  function selectRow(path, isDir) { if (isDir) toggle(path); else openFile?.(path) }
+  const selectRef = React.useRef(selectRow)
+  selectRef.current = selectRow
+  /** @private @author ddj 2026年10月10号 @param path Row path. @param type Entry type. @param event Context trigger. */
+  function contextRow(path, type, event) {
+    event.preventDefault(); event.stopPropagation()
+    setMenu({ x: event.clientX, y: event.clientY, target: { path, type } })
   }
+  const onSelect = React.useCallback((path, isDir) => selectRef.current(path, isDir), [])
+  const onContext = React.useCallback(contextRow, [])
+  const rootName = root ? String(root).split(/[\\/]/).pop() || root : ''
 
-  const rowsOf = (rel, depth) => {
-    const entries = entriesOf(rel)
-    if (!entries) {
-      return [React.createElement('div', { key: rel + ':loading', className: 'edrv-tree-loading', style: { paddingLeft: 6 + depth * 14 } },
-        loading[rel] ? '加载中…' : '无法加载')]
-    }
-    const rows = []
-    const cap = entries.length
-    for (let i = 0; i < cap; i++) {
-      const e = entries[i]
-      const isDir = e.type === 'directory'
-      const isOpen = expanded[e.path] === true
-      rows.push(rowEl(e, depth, isDir, isOpen))
-      if (isDir && isOpen) rows.push(...rowsOf(e.path, depth + 1))
-    }
-    if (cap >= DIR_CAP) {
-      rows.push(React.createElement('div', { key: rel + ':cap', className: 'edrv-tree-loading', style: { paddingLeft: 6 + depth * 14 } },
-        '目录条目过多，仅显示前 ' + DIR_CAP + ' 项'))
-    }
-    return rows
+  /** @private @author ddj 2026年10月10号 @param row Flat descriptor. @returns Memo row; unaffected status objects retain identity. */
+  function renderRow(row) {
+    if (!row.e) return React.createElement('div', { key: row.key, className: 'edrv-tree-loading', style: { paddingLeft: 6 + row.depth * 14 } }, row.text)
+    const { e, depth, isDir, isOpen } = row
+    return React.createElement(ExplorerRow, { key: e.path, path: e.path, name: e.name, type: e.type, depth, isDir, isOpen,
+      pending: isDir ? 0 : pendingByPath[e.path] ?? 0, active: !isDir && e.path === activePath,
+      context: Boolean(menu && menuEntries.length && menu.target.path === e.path), reveal: revealPath === e.path,
+      mark: svn.local?.get(e.path), remote: svn.remote?.get(e.path) ?? 0, onSelect, onContext })
   }
 
   // 面板区右键（空白处）→ 工作区根目录菜单；行内右键已在 rowEl 阻止冒泡。
@@ -467,14 +478,20 @@ export function FileExplorer(props) {
       React.createElement('span', { className: 'edrv-side-title' }, '资源管理器'),
       React.createElement('span', { className: 'edrv-side-root', title: root || '' }, rootName),
       React.createElement('span', { style: { flex: 1 } }),
-      React.createElement('button', { className: 'edrv-side-btn', title: '刷新目录树', onClick: refresh }, refreshIconEl())),
+      ctx?.svn?.managed ? React.createElement(Button, {
+        variant: 'toolbar', size: 'sm', disabled: !svn.canCheck || svn.busy,
+        title: '检查仓库更新（只读；不会执行 svn update）', onClick: svn.checkRemote,
+        'aria-label': '检查仓库更新',
+      }, svn.busy ? '…' : '↓') : null,
+      React.createElement('button', { className: 'edrv-side-btn', title: '刷新目录树', onClick: () => emitRefresh({ scope, kind: 'unknown' }) }, refreshIconEl())),
+    svn.message ? React.createElement('div', { className: 'edrv-tree-status', role: 'status' }, svn.message) : null,
     React.createElement('div', { className: 'edrv-tree', ref: treeRef },
       (errorText
         ? React.createElement('div', { className: 'edrv-tree-error' },
             React.createElement('span', null, String(errorText)),
-            React.createElement('button', { className: 'edrv-side-btn', onClick: () => refresh() }, '重试'))
+            React.createElement('button', { className: 'edrv-side-btn', onClick: () => emitRefresh({ scope, kind: 'unknown' }) }, '重试'))
         : null),
-      rowsOf('', 0)),
+      treeRows.map(renderRow)),
     (menu && menuEntries.length
       ? React.createElement(ContextMenu, { x: menu.x, y: menu.y, entries: menuEntries, onClose: () => setMenu(null) })
       : null))

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

@@ -0,0 +1,165 @@
+/** Compact explorer lifecycle, independently testable without browser/React. @author ddj 2026年10月10号 */
+import type { SvnRefreshReason, SvnViewMark, SvnViewPayload, SvnViewRequest, SvnViewRow } from '../../../shared/svnExplorer.js'
+
+export interface ExplorerNotice { scope?: string; paths?: string[]; eventId?: string; kind?: 'text' | 'structure' | 'svn' | 'unknown' }
+export interface ExplorerView extends Omit<SvnViewPayload, 'rows'> { marks: Map<string, SvnViewMark> }
+type ViewResult = ({ ok: true } & SvnViewPayload) | { ok: false; error: string }
+type ViewFetch = (args: SvnViewRequest, signal: AbortSignal) => Promise<ViewResult>
+const EMPTY: ExplorerView = { scopeId: '', prefix: '.', revision: 0, generation: 0, observedGeneration: 0, confirmedAt: 0,
+  complete: false, refreshing: false, scanMs: 0, error: '', mismatch: false, marks: new Map() }
+let nextClient = 0
+
+/** @public @author ddj 2026年10月10号 @param previous Stable row objects. @param rows Compact projection. @returns Same map when unchanged; otherwise replaces only changed marks. */
+export function applyViewRows(previous: Map<string, SvnViewMark>, rows: readonly SvnViewMark[]): Map<string, SvnViewMark> {
+  const next = new Map<string, SvnViewMark>()
+  let changed = previous.size !== rows.length
+  for (const row of rows) {
+    const old = previous.get(row.path)
+    const equal = old && old.kind === row.kind && old.count === row.count && old.stale === row.stale
+    next.set(row.path, equal ? old : row)
+    if (!equal) changed = true
+  }
+  return changed ? next : previous
+}
+/** @private @author ddj 2026年10月10号 @param path Row. @param root Changed path. @returns Segment-bound overlap incl. ancestors. */
+function overlaps(path: string, root: string): boolean {
+  const a = path.replace(/\\/g, '/').toLowerCase(), b = root.replace(/\\/g, '/').toLowerCase()
+  return a === b || a.startsWith(b + '/') || b.startsWith(a + '/')
+}
+
+// --region Single-flight client projection
+/** @public @author ddj 2026年10月10号 Owns fetch/debounce/calibration; does not own or cancel shared Host scans. */
+export class ExplorerViewClient {
+  private view: ExplorerView = { ...EMPTY, marks: new Map() }
+  private rows: SvnViewRow[] = []
+  private paths = new Set<string>()
+  private reason: SvnRefreshReason = 'read'
+  private pending = false
+  private since = 0
+  private last = 0
+  private timer: ReturnType<typeof setTimeout> | null = null
+  private controller: AbortController | null = null
+  private stopped = false
+  private visible = true
+  private rowEpoch = 0
+  private sequence = 0
+  private readonly clientId = 'explorer-' + Date.now() + '-' + (++nextClient)
+  private readonly events = new Set<string>()
+  private lastNotice = 0
+  sessionId?: string
+
+  /** @public @author ddj 2026年10月10号 @param scope Workspace UI key. @param fetch Authenticated compact RPC. @param publish State callback. @param remoteDrop Evidence invalidation callback. */
+  constructor(readonly scope: string, private readonly fetch: ViewFetch, private readonly publish: (view: ExplorerView) => void,
+    private readonly remoteDrop: () => void) {}
+
+  /** @public @author ddj 2026年10月10号 @param rows Expanded/displayed paths. Updates projection only, never forces a scan. */
+  setRows(rows: readonly SvnViewRow[]): void {
+    this.rows = [...rows]; this.rowEpoch++
+    this.enqueue('read', 0)
+  }
+  /** @public @author ddj 2026年10月10号 @param notice Optional scope/path/id and evidence kind. Ignore another scope; repeated IDs do not dirty twice. */
+  notify(notice: ExplorerNotice = {}): void {
+    if (notice.scope && notice.scope !== this.scope) return
+    if (notice.eventId && this.events.has(notice.eventId)) return
+    if (notice.eventId) { this.events.add(notice.eventId); if (this.events.size > 512) this.events.delete(this.events.values().next().value!) }
+    this.lastNotice = Date.now()
+    if (notice.kind !== 'text') this.remoteDrop()
+    const paths = notice.paths?.filter(Boolean)
+    const invalid = paths?.some((path) => typeof path !== 'string' || path.length > 1024 || /^[\\/]|^[A-Za-z]:|[\x00-\x1f]/.test(path)
+      || path.replace(/\\/g, '/').split('/').includes('..'))
+    if (!paths?.length || invalid) this.reason = 'full'
+    else for (const path of paths) this.paths.add(path)
+    if (this.paths.size > 256) this.reason = 'full'
+    if (this.reason !== 'full') this.reason = 'paths'
+    if (this.reason === 'full') this.paths.clear()
+    this.stale(this.reason === 'full' ? null : paths!)
+    this.enqueue(this.reason, 300)
+  }
+  /** @public @author ddj 2026年10月10号 Unknown-origin changes-list replacement requests one calibration, not reference-driven full scan. */
+  changes(): void { if (Date.now() - this.lastNotice > 1000) this.enqueue('calibrate', 300) }
+  /** @public @author ddj 2026年10月10号 @param visible Page visibility. Hide clears automatic work, show/focus calibrates only after five seconds. */
+  visibility(visible: boolean): void {
+    this.visible = visible
+    if (!visible) { if (this.timer) clearTimeout(this.timer); this.timer = null; return }
+    if (Date.now() - this.view.confirmedAt > 5000) this.enqueue('calibrate', 0)
+    else this.enqueue('read', 0)
+  }
+  /** @public @author ddj 2026年10月10号 Explicit offline full refresh; remote evidence no longer trusted. */
+  refresh(): void { this.notify({ kind: 'unknown' }) }
+
+  /** @private @author ddj 2026年10月10号 @param paths Dirty paths or unknown/full. Mark stale immediately, retain independent rows and anomalous evidence. */
+  private stale(paths: readonly string[] | null): void {
+    const rows = [...this.view.marks.values()].map((row) => !paths || paths.some((path) => overlaps(row.path, path)) ? { ...row, stale: true } : row)
+    this.view = { ...this.view, complete: false, refreshing: true, marks: applyViewRows(this.view.marks, rows) }
+    this.publish(this.view)
+  }
+  /** @private @author ddj 2026年10月10号 @param reason Requested work. @param delay Tail wait, bounded by one second. */
+  private enqueue(reason: SvnRefreshReason, delay: number): void {
+    if (this.stopped) return
+    if (this.reason === 'read' || (reason === 'full')) this.reason = reason
+    if (!this.pending) this.since = Date.now()
+    this.pending = true; this.last = Date.now()
+    if (this.timer) clearTimeout(this.timer)
+    this.timer = null
+    if (this.controller || !this.visible) return
+    const wait = Math.max(0, Math.min(this.last + delay, this.since + 1000) - Date.now())
+    this.timer = setTimeout(() => { this.timer = null; void this.read() }, wait)
+  }
+  /** @private @author ddj 2026年10月10号 @param args First page carries idempotent invalidation. @param signal Fetch only cancellation. @returns Version-consistent pages, bounded retries. */
+  private async pages(args: SvnViewRequest, signal: AbortSignal): Promise<SvnViewPayload> {
+    for (let attempt = 0; attempt < 3; attempt++) {
+      let snapshot: SvnViewPayload | null = null
+      const rows: SvnViewMark[] = []
+      for (let offset = 0; offset < Math.max(1, this.rows.length); offset += 1000) {
+        const out = await this.fetch({ ...args, rows: this.rows.slice(offset, offset + 1000),
+          revision: snapshot?.revision, generation: snapshot?.generation }, signal)
+        if (!out.ok) throw new Error(out.error)
+        if (out.mismatch) { snapshot = null; break }
+        if (snapshot && snapshot.scopeId !== out.scopeId) throw new Error('SVN 工作区范围发生变化')
+        snapshot = out; rows.push(...out.rows)
+      }
+      if (snapshot) return { ...snapshot, rows }
+    }
+    throw new Error('SVN 状态正在变化，稍后重新投影')
+  }
+  /** @private @author ddj 2026年10月10号 Apply compact results; notices during fetch retain dirtiness and receive one follow-up request. */
+  private async read(): Promise<void> {
+    if (this.stopped || this.controller) return
+    const controller = new AbortController(), epoch = this.rowEpoch
+    this.controller = controller
+    const reason = this.reason, paths = [...this.paths]
+    const args: SvnViewRequest = { sessionId: this.sessionId, rows: [], reason, paths,
+      clientId: this.clientId, eventId: String(++this.sequence) }
+    this.reason = 'read'; this.paths.clear(); this.pending = false
+    try {
+      const out = await this.pages(args, controller.signal)
+      if (this.stopped || controller.signal.aborted) return
+      if (epoch !== this.rowEpoch) { this.enqueue('read', 0); return }
+      this.view = { ...out, marks: applyViewRows(this.view.marks, out.rows) }
+      if (this.pending && this.reason !== 'read') this.stale(this.reason === 'paths' ? [...this.paths] : null)
+      else this.publish(this.view)
+    } catch (error) {
+      if (this.stopped || controller.signal.aborted) return
+      this.stale(null)
+      this.view = { ...this.view, refreshing: false, error: String(error) }; this.publish(this.view)
+    } finally {
+      this.controller = null
+      if (!this.stopped) this.follow()
+    }
+  }
+  /** @private @author ddj 2026年10月10号 Schedule merged notices, short read-only polls, or completion-based adaptive offline calibration; hidden pages never poll. */
+  private follow(): void {
+    if (this.pending) { this.enqueue(this.reason, 300); return }
+    if (!this.visible) return
+    const reason = this.view.refreshing ? 'read' : 'calibrate'
+    const delay = this.view.refreshing ? 250 : Math.max(30_000, 20 * this.view.scanMs)
+    this.timer = setTimeout(() => { this.timer = null; this.enqueue(reason, 0) }, delay)
+  }
+  /** @public @author ddj 2026年10月10号 Release UI work; does not terminate shared Host scan. */
+  dispose(): void {
+    this.stopped = true
+    if (this.timer) clearTimeout(this.timer)
+    this.controller?.abort(); this.events.clear(); this.paths.clear()
+  }
+}
+// --endregion