dsh-vscode-mode 0.18.0 → 0.19.0

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

@@ -0,0 +1,106 @@
+/** File explorer fixed-height row model. @author ddj 2026年10月22号 */
+import type { TreeEntry } from '../../../shared/rpc.js'
+import { updateRange } from '../../ui/svnUpdateModel.js'
+
+/** Fixed geometry shared with file and loading row CSS. */
+export const TREE_ROW_HEIGHT = 24
+
+export interface TreeRow {
+  key: string
+  depth: number
+  e?: TreeEntry
+  isDir?: boolean
+  isOpen?: boolean
+  text?: string
+}
+
+export interface TreeViewport {
+  top: number
+  height: number
+}
+
+/**
+ * @public @author ddj 2026年10月22号
+ * @description Preserve the first visible path when rows above it expand or collapse.
+ * @param previous Previous complete model.
+ * @param rows New complete model.
+ * @param top Previous scroll offset.
+ * @returns Anchored offset, or original offset for subsequent clamping if path disappeared.
+ */
+export function treeAnchorTop(previous: TreeRow[], rows: TreeRow[], top: number): number {
+  const index = Math.floor(Math.max(0, top) / TREE_ROW_HEIGHT)
+  const anchor = previous[index]?.key
+  if (!anchor) return top
+  const nextIndex = rows.findIndex((row) => row.key === anchor)
+  if (nextIndex < 0) return top
+  return nextIndex * TREE_ROW_HEIGHT + top % TREE_ROW_HEIGHT
+}
+
+/**
+ * @public @author ddj 2026年10月22号
+ * @description Flatten all expanded entries in their supplied order, including metadata files.
+ * @param entriesOf Directory snapshot lookup; null means unavailable.
+ * @param expanded Current directory expansion flags.
+ * @param loading Current loading flags.
+ * @returns Complete row model, independent of viewport mounting.
+ */
+export function flattenTree(entriesOf: (rel: string) => TreeEntry[] | null,
+  expanded: Record<string, boolean>, loading: Record<string, boolean>): TreeRow[] {
+  const rows: TreeRow[] = []
+  const pending: { rel: string; depth: number; entry?: TreeEntry }[] = [{ rel: '', depth: 0 }]
+  while (pending.length) {
+    const current = pending.pop()!
+    const entry = current.entry
+    if (entry) {
+      const isDir = entry.type === 'directory'
+      const isOpen = expanded[entry.path] === true
+      rows.push({ key: entry.path, e: entry, depth: current.depth, isDir, isOpen })
+      if (isDir && isOpen) pending.push({ rel: entry.path, depth: current.depth + 1 })
+      continue
+    }
+
+    const entries = entriesOf(current.rel)
+    if (!entries) {
+      rows.push({ key: current.rel + ':loading', depth: current.depth,
+        text: loading[current.rel] ? '加载中…' : '无法加载' })
+      continue
+    }
+    // Stack reverses insertion order; push backwards to preserve host sorting.
+    for (let index = entries.length - 1; index >= 0; index--) {
+      pending.push({ rel: current.rel, depth: current.depth, entry: entries[index] })
+    }
+  }
+  return rows
+}
+
+/**
+ * @public @author ddj 2026年10月22号
+ * @description Clamp scroll state before reusing the existing fixed-height range calculation.
+ * @param count Complete row count.
+ * @param viewport Latest scroll position and measured viewport height.
+ * @returns Clamped scroll offset and overscanned exclusive row range.
+ */
+export function treeWindow(count: number, viewport: TreeViewport) {
+  const height = Math.max(0, viewport.height)
+  const top = Math.min(Math.max(0, viewport.top), Math.max(0, count * TREE_ROW_HEIGHT - height))
+  return { top, ...updateRange(count, top, height, TREE_ROW_HEIGHT) }
+}
+
+/**
+ * @public @author ddj 2026年10月22号
+ * @description Locate an unmounted row using model indices, without querying row DOM.
+ * @param rows Complete flattened model.
+ * @param path Requested relative file path.
+ * @param viewport Current viewport geometry.
+ * @returns New scroll offset, or null while ancestors/viewport are unavailable.
+ */
+export function treeRevealTop(rows: TreeRow[], path: string, viewport: TreeViewport): number | null {
+  if (viewport.height <= 0) return null
+  const index = rows.findIndex((row) => row.e?.path === path)
+  if (index < 0) return null
+  const current = treeWindow(rows.length, viewport).top
+  const rowTop = index * TREE_ROW_HEIGHT
+  if (rowTop >= current && rowTop + TREE_ROW_HEIGHT <= current + viewport.height) return current
+  return treeWindow(rows.length, { top: rowTop - (viewport.height - TREE_ROW_HEIGHT) / 2,
+    height: viewport.height }).top
+}

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

@@ -27,6 +27,8 @@ interface RevealOptions {
   activePath: string | null
   treeRef: React.RefObject<HTMLElement>
   prepare: (path: string) => void
+  /** Optional virtual-list locator; success does not depend on mounted row DOM. */
+  locate?: (path: string) => boolean
 }
 interface RevealTarget {
   scope: string
@@ -60,12 +62,13 @@ export function useExplorerReveal(options: RevealOptions) {
     setTarget(next)
     if (next) current.prepare(next.path)
   }
-  /** @private @author ddj 2026年10月14号 Attempts the latest target after row commit or container resize. Consumes only a successful, current request. */
+  /** @private @author ddj 2026年10月22号 Attempts virtual data-index location or the original mounted-row fallback after commit/resize; consumes only a successful current request. */
   function tryReveal(): void {
     const next = pending.current
     const current = latest.current
     if (!next || next.scope !== current.scope || next.active !== current.activePath) return
-    if (!revealTreeRow(current.treeRef.current, next.path)) return
+    const located = current.locate ? current.locate(next.path) : revealTreeRow(current.treeRef.current, next.path)
+    if (!located) return
     pending.current = null
     setRevealPath(next.path)
     clearHighlight()

package/src/client/sidebar/registry.ts

@@ -28,8 +28,11 @@ function panelRegister(entries: Map<string, SidebarPanelDef>, notify: () => void
 export function createSidebarPanelRegistry(): SidebarPanelRegistry {
   const entries = new Map<string, SidebarPanelDef>()
   const listeners = new Set<() => void>()
+  /** @private @author ddj 2026年10月22号 @description Isolate subscribers and snapshot notification membership against reentrant changes. */
   const notify = (): void => {
-    for (const listener of listeners) listener()
+    for (const listener of [...listeners]) {
+      try { listener() } catch { /* One extension must not block other subscribers or registration teardown. */ }
+    }
   }
   const list = (): readonly SidebarPanelDef[] =>
     [...entries.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100))

package/src/client/styles/editor.css

@@ -305,6 +305,14 @@
 [data-edrv-view] .edrv-side-btn { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-secondary, #52606d); font-size: 12px; cursor: pointer; flex-shrink: 0; }
 [data-edrv-view] .edrv-side-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-tree { flex: 1; min-height: 0; overflow: auto; padding: 4px 6px 12px; font-size: 12px; }
+/* Virtual rows and placeholders share the same geometry as treeWindow.ts. @author ddj 2026年10月22号 */
+[data-edrv-view] .edrv-tree.edrv-tree-virtual { padding-top: 0; padding-bottom: 0; }
+[data-edrv-view] .edrv-tree-virtual .edrv-tree-row,
+[data-edrv-view] .edrv-tree-virtual .edrv-tree-loading { height: 24px; min-height: 24px; box-sizing: border-box; }
+[data-edrv-view] .edrv-tree-virtual .edrv-tree-loading { line-height: 24px; }
+[data-edrv-view] .edrv-large-text { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; }
+[data-edrv-view] .edrv-large-text-toolbar { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+[data-edrv-view] .edrv-large-text-content { margin: 0; flex: 1; min-height: 0; overflow: auto; white-space: pre; font-family: var(--ds-font-family-code, ui-monospace, monospace); user-select: text; }
 [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)); }

package/src/client/textPages.ts

@@ -0,0 +1,135 @@
+import { TEXT_PAGE_BYTES, TEXT_VIEW_BYTES, TEXT_VIEW_LINES } from '../shared/textPages.js'
+import type { TextPageArgs, TextPageResult } from '../shared/textPages.js'
+
+export interface TextPagerState {
+  text: string
+  loading: boolean
+  eof: boolean
+  capped: boolean
+  error: string | null
+  offset: number
+  size: number
+  lines: number
+  partialLine: boolean
+}
+export type TextPageLoader = (args: TextPageArgs) => Promise<TextPageResult>
+
+/**
+ * Own one preview identity and one in-flight request; no polling or automatic continuation.
+ * @public @author ddj 2026年10月22号
+ * @param load Authorized RPC loader. @param changed Snapshot observer.
+ * @returns Pager lifecycle and explicit load controls.
+ */
+export function createTextPager(load: TextPageLoader, changed: (state: TextPagerState) => void) {
+  let generation = 0
+  let disposed = false
+  let target: TextPageArgs | null = null
+  let cursor: string | undefined
+  let version: string | undefined
+  let inFlight = false
+  let retainedBytes = 0
+  let state = emptyState()
+
+  /** @private @author ddj 2026年10月22号 @returns Publish immutable snapshot. */
+  function publish(): void { changed({ ...state }) }
+
+  /** @public @author ddj 2026年10月22号 @param args New file/session identity. @returns Reset state; old responses are ignored. */
+  function reset(args: TextPageArgs): void {
+    generation++
+    target = { sessionId: args.sessionId, path: args.path }
+    cursor = undefined
+    version = undefined
+    retainedBytes = 0
+    state = emptyState()
+    state.loading = inFlight
+    if (!disposed) publish()
+  }
+
+  /** @public @author ddj 2026年10月22号 @returns Explicitly load one page, or no-op when busy/finished. */
+  async function loadNext(): Promise<void> {
+    if (disposed || !target || inFlight || state.eof || state.capped) return
+    state.error = null
+    const requestGeneration = generation
+    const request = { ...target, cursor }
+    inFlight = true
+    state.loading = true
+    publish()
+
+    try {
+      const page = await load(request)
+      if (disposed || requestGeneration !== generation) return
+      if (!page.ok) { state.error = page.error; return }
+      if (!validPage(page, state.offset, version)) { state.error = 'Invalid or stale text page'; return }
+      appendPage(page)
+    } catch (error) {
+      if (!disposed && requestGeneration === generation) state.error = String(error)
+    } finally {
+      inFlight = false
+      if (!disposed) { state.loading = false; publish() }
+    }
+  }
+
+  /** @private @author ddj 2026年10月22号 @param page Verified page. @returns Append only within byte/line limits. */
+  function appendPage(page: Extract<TextPageResult, { ok: true }>): void {
+    let text = page.text
+    const encoded = new TextEncoder().encode(text)
+    const remaining = TEXT_VIEW_BYTES - retainedBytes
+    if (encoded.length > remaining) {
+      // A UTF-8 suffix may straddle the cap; never retain a replacement character.
+      let end = remaining
+      while (end > 0 && (encoded[end]! & 0xc0) === 0x80) end--
+      text = new TextDecoder('utf-8', { fatal: true }).decode(encoded.subarray(0, end))
+      state.capped = true
+    }
+    let lines = state.lines
+    for (let index = 0; index < text.length; index++) {
+      if (text[index] !== '\n' && (text[index] !== '\r' || text[index + 1] === '\n')) continue
+      if (lines >= TEXT_VIEW_LINES) {
+        const end = text[index] === '\n' && text[index - 1] === '\r' ? index - 1 : index
+        text = text.slice(0, end); state.capped = true; break
+      }
+      lines++
+    }
+    retainedBytes += new TextEncoder().encode(text).length
+    state.text += text
+    state.lines = lines
+    state.offset = page.offset
+    state.size = page.size
+    state.eof = page.eof
+    state.partialLine = page.partialLine || state.capped
+    state.capped ||= page.offset >= TEXT_VIEW_BYTES || retainedBytes >= TEXT_VIEW_BYTES || lines >= TEXT_VIEW_LINES
+    version = page.version
+    cursor = page.nextCursor ?? undefined
+  }
+
+  /** @public @author ddj 2026年10月22号 @returns Invalidate identity while retaining the transport lock. */
+  function invalidate(): void { generation++; target = null; state = emptyState() }
+
+  /** @public @author ddj 2026年10月22号 @returns Invalidate pending responses and release preview content. */
+  function dispose(): void { disposed = true; invalidate() }
+
+  return { reset, loadNext, invalidate, dispose, getState: () => ({ ...state }) }
+}
+
+/** @private @author ddj 2026年10月22号 @returns Empty bounded preview state. */
+function emptyState(): TextPagerState {
+  return { text: '', loading: false, eof: false, capped: false, error: null, offset: 0, size: 0, lines: 1, partialLine: false }
+}
+
+/**
+ * Validate the RPC envelope before retaining any content.
+ * @private @author ddj 2026年10月22号
+ * @param page Server page. @param offset Previous byte position. @param version Bound version.
+ * @returns Whether bounds and continuation invariants hold.
+ */
+function validPage(page: Extract<TextPageResult, { ok: true }>, offset: number, version?: string): boolean {
+  return typeof page.text === 'string' && typeof page.version === 'string'
+    && (version === undefined || version === page.version)
+    && Number.isSafeInteger(page.offset) && Number.isSafeInteger(page.size)
+    && page.size >= 0 && page.offset >= offset && page.offset <= page.size
+    && (page.offset > offset || page.eof) && page.offset - offset <= TEXT_PAGE_BYTES
+    && new TextEncoder().encode(page.text).length <= TEXT_PAGE_BYTES + 1
+    && page.encoding === 'utf-8' && typeof page.partialLine === 'boolean'
+    && typeof page.eof === 'boolean' && (page.eof ? page.nextCursor === null : typeof page.nextCursor === 'string' && page.nextCursor.length > 0)
+    && (page.eof === (page.offset === page.size))
+}

package/src/client/ui/EditorView.ts

@@ -9,8 +9,10 @@
  */
 import React from 'react'
 import { createPortal } from 'react-dom'
+import { createRoot } from 'react-dom/client'
 import { EditorPane, EditorSplit, PassiveEditor, GroupPathbar } from './EditorPane.js'
 import { FloatingEditor } from './FloatingEditor.js'
+import { LargeTextView } from './LargeTextView.js'
 import { FloatingWindow } from './FloatingWindow.js'
 import { createLayout, parseLayout, syncTabs, ownerOf, focusGroup, moveTab, returnGroup, GROUP_LIMIT, MAIN_GROUP } from '../state/editorLayout.js'
 import { createTabDrag, hitTarget } from '../tabDrag.js'
@@ -318,6 +320,11 @@ export function EditorView(props) {
   const aiStatusTimer = React.useRef(null)
   const [error, setError] = React.useState(null)
   const [loadError, setLoadError] = React.useState(null)
+  const [largeCandidate, setLargeCandidate] = React.useState(null)
+  const [pagedFile, setPagedFile] = React.useState(null)
+  const [pageChanged, setPageChanged] = React.useState(null)
+  const pageIdentity = JSON.stringify([scope, sessionId, active])
+  const paging = pagedFile === pageIdentity
   const [loadStage, setLoadStage] = React.useState({ progress: 0, message: '准备加载编辑器…' })
   const [openInput, setOpenInput] = React.useState(false)
   const [pathDraft, setPathDraft] = React.useState('')
@@ -1013,6 +1020,9 @@ export function EditorView(props) {
     const seq = ++loadSeqRef.current
     setReceiptLoad({ path, cwd, sessionId: sid, sequence: seq, status: 'loading' })
     setLoadError(null)
+    setLargeCandidate(null)
+    setPagedFile(null)
+    setPageChanged(null)
     /**
      * 记下磁盘版本基线；markRead=true 表示本次真的从磁盘读了内容
      * （已读版本台账随之失效，下一轮轮询按新版本重新比对）。
@@ -1064,6 +1074,7 @@ export function EditorView(props) {
         setLoadStage((prev) => ({ progress: Math.max(84, prev.progress), message: '文件已读取，准备创建编辑器…' }))
         setStatus('已加载')
       } else {
+        if (res?.code === 'file-too-large') setLargeCandidate(JSON.stringify([scope, sid, path]))
         const base = res?.error ? String(res.error) : '读取失败'
         dapTrace('read-failed', { path, error: base, resolvedPath: res?.resolvedPath, cwd })
         // 带出 host 解析后的真实路径：跳转失败时一眼看出是路径解析错还是目标不存在
@@ -1222,7 +1233,7 @@ export function EditorView(props) {
    * @author ddj 2026年09月15号
    * @param change 轮询判定出的外部变更
    */
-  const onDiskChange = (change) => {
+  function onDiskChange(change) {
     if (!change || !change.path) return
     // 文件树同步：目录缓存按该路径失效并强制重列（外部新增/删除/改名都能看到）
     const eventId = emitFileChanged(change.path, { scope, kind: change.kind === 'deleted' ? 'structure' : 'text' })
@@ -1242,6 +1253,14 @@ export function EditorView(props) {
       }).catch(() => {})
       return
     }
+    if (change.kind === 'modified' && (paging || pageChanged === pageIdentity) && change.path === activeRef.current) {
+      // Invalidates the old page cursor immediately; retain an identity-scoped notice until explicit reread.
+      loadContent(change.path, sessionId, true)
+      setPageChanged(pageIdentity)
+      setStatus('文件已变化，请重新读取')
+      emitRefresh({ scope, paths: [change.path], kind: 'text', eventId })
+      return
+    }
     if (change.kind === 'modified') {
       // 干净缓冲：强制从磁盘重读（跳过 model 复用），差异标记随之重算
       loadContent(change.path, sessionId, true)
@@ -1264,7 +1283,10 @@ export function EditorView(props) {
    * @param path 文件路径
    * @returns 比对结果；模型不可用/读失败 → null（按「需要重载」处理）
    */
-  const readDiskCompare = (path) => {
+  function readDiskCompare(path) {
+    // A read-only page has no full Monaco buffer to compare. Acknowledge the observed
+    // version as changed so polling advances its baseline instead of invalidating every reread.
+    if (path === activeRef.current && (paging || pageChanged === pageIdentity)) return Promise.resolve({ equal: false })
     const model = modelsRef.current?.get(path)
     if (!model || typeof model.getValue !== 'function') return Promise.resolve(null)
     return rpc('edrv.read', { sessionId, path }).then((res) => {
@@ -3764,7 +3786,8 @@ export function EditorView(props) {
     }
   }, [])
 
-  const openPath = () => {
+  /** @private @author ddj 2026年10月22号 @description Probe a typed path; let oversized files enter the existing read-only paging flow. @returns Probe completion. */
+  function openPath() {
     const p = (pathDraft || '').trim()
     if (!p) return
     // 图片/PDF 文件跳过文本读探测（二进制会被 host 拒绝），直接进 tab 由专用预览接管
@@ -3774,8 +3797,9 @@ export function EditorView(props) {
       return
     }
     setStatus('打开中…')
-    rpc('edrv.read', { sessionId, path: p }).then((res) => {
-      if (res && res.ok) {
+    return rpc('edrv.read', { sessionId, path: p }).then((res) => {
+      // Only the explicit size-limit response may bypass the probe; other failures must remain visible.
+      if (res && (res.ok || res.code === 'file-too-large')) {
         openFile(p, false)
         setOpenInput(false); setPathDraft(''); setStatus('已打开'); setError(null)
       } else { setStatus('打开失败'); setError(res?.error ? String(res.error) : '打开失败') }
@@ -3907,9 +3931,19 @@ export function EditorView(props) {
     host.addEventListener('contextmenu', onCtx, true)
     return () => { unsubscribeBp?.(); host.removeEventListener('contextmenu', onCtx) }
   }
+  /** @private @author ddj 2026年10月22号 @param args Read-only page request. @returns Current Host capability result. */
+  function loadTextPage(args) { return rpc('edrv.textPage', args) }
+  /** @private @author ddj 2026年10月22号 @description Never replace a dirty or saving document with partial text. */
+  function openTextPages() {
+    if (largeCandidate !== pageIdentity || dirtyRef.current[active] || savingRef.current.has(active)) return
+    flushSave()
+    if (dirtyRef.current[active] || savingRef.current.has(active)) return
+    setPageChanged(null)
+    setPagedFile(pageIdentity)
+  }
   /** @private @author ddj 2026年10月16号 @param host Passive body. @param path Canonical file. @param groupId Owning group id（find 快照按组隔离）. @returns View-only cleanup, models remain workbench-owned. */
   function mountPassive(host, path, groupId) {
-    let disposed = false, keeper = null, subscription = null, observer = null, unbindGutter = null
+    let disposed = false, keeper = null, subscription = null, observer = null, unbindGutter = null, pageRoot = null
     const focus = () => { const owner = ownerOf(benchRef.current, path); if (owner) selectGroup(owner.id, path) }
     host.addEventListener('pointerdown', focus)
     if (isPdfPath(path) && pdfNodes.current.has(path)) {
@@ -3923,7 +3957,27 @@ export function EditorView(props) {
     void request.then((result) => {
       if (disposed) return
       host.textContent = ''
-      if (!result?.ok) { host.textContent = result?.error || '文件加载失败'; return }
+      if (!result?.ok) {
+        host.textContent = result?.error || '文件加载失败'
+        if (result?.code === 'file-too-large' && !binary) {
+          const button = document.createElement('button')
+          button.textContent = '只读分段查看'
+          /** @author ddj 2026年10月22号 @param event Pointer event. @description Do not focus and unmount the passive group before click. */
+          button.onpointerdown = (event) => event.stopPropagation()
+          /** @author ddj 2026年10月22号 @description Keep partial text out of passive models, autosave and editing commands. */
+          button.onclick = () => {
+            if (disposed || dirtyRef.current[path] || savingRef.current.has(path)) return
+            flushSave()
+            if (dirtyRef.current[path] || savingRef.current.has(path)) return
+            host.textContent = ''
+            host.removeEventListener('pointerdown', focus)
+            pageRoot = createRoot(host)
+            pageRoot.render(React.createElement(LargeTextView, { sessionId, path, loadPage: loadTextPage }))
+          }
+          host.appendChild(button)
+        }
+        return
+      }
       if (binary) {
         const image = document.createElement(isPdfPath(path) ? 'div' : 'img')
         if (isPdfPath(path)) image.textContent = 'PDF · 点击此编辑组继续查看和编辑'
@@ -3948,7 +4002,7 @@ export function EditorView(props) {
       observer = new ResizeObserver(() => editor.layout())
       observer.observe(host)
     }).catch((failure) => { if (!disposed) host.textContent = '文件加载失败：' + String(failure) })
-    return () => { disposed = true; host.removeEventListener('pointerdown', focus); unbindGutter?.(); observer?.disconnect(); subscription?.dispose(); keeper?.dispose(); paneEditors.current.delete(path) }
+    return () => { disposed = true; pageRoot?.unmount(); host.removeEventListener('pointerdown', focus); unbindGutter?.(); observer?.disconnect(); subscription?.dispose(); keeper?.dispose(); paneEditors.current.delete(path) }
   }
   const passiveOps = React.useRef(mountPassive)
   passiveOps.current = mountPassive
@@ -3976,7 +4030,7 @@ export function EditorView(props) {
     return React.createElement(EditorPane, { key: id, group, focused, dirty: dirtyMap, suppressActive: hideDiskActive, tabsRef: chrome ? tabsHostRef : undefined, extras: chrome ? planTabExtras : undefined, tools: chrome ? rowTools : undefined, onSelect: selectGroup, onClose: closeTab, onMenu: paneMenu, onDrag: dragTab, consumeClick: consumeDrag },
       focused ? React.createElement('div', { className: 'edrv-full-slot', ref: mountFull }) : React.createElement(React.Fragment, null,
         React.createElement(GroupPathbar, { path: group.active, onFocus: () => selectGroup(id) }),
-        React.createElement(PassiveEditor, { key: String(scope) + ':' + group.active, path: group.active, groupId: id, mount: passiveMount })))
+        React.createElement(PassiveEditor, { key: JSON.stringify([scope, sessionId, group.active]), path: group.active, groupId: id, mount: passiveMount })))
   }
   /** @private @author ddj 2026年10月14号 @param node Layout subtree. @returns Recursive resizable panes. */
   function renderTree(node) {
@@ -4176,6 +4230,12 @@ export function EditorView(props) {
       : React.createElement('pre', { className: 'edrv-mdview-pre' }, text)
     body = React.createElement('div', { className: 'edrv-mdview', ref: planHostRef, 'data-plan-address': activePlan.address },
       React.createElement('div', { className: 'edrv-mdview-stage' }, React.createElement('div', { className: 'edrv-mdview-doc' }, render)))
+  } else if (pageChanged === pageIdentity && largeCandidate === pageIdentity) {
+    body = React.createElement('div', { className: 'edrv-empty', role: 'status' },
+      React.createElement('div', null, '文件已变化，请重新读取'),
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: openTextPages }, '重新读取首段'))
+  } else if (paging) {
+    body = React.createElement(LargeTextView, { key: pageIdentity, sessionId, path: active, loadPage: loadTextPage })
   } else if (!monaco && !monacoErr) {
     body = loadingBody(loadStage.message, loadStage.progress)
   } else if (monacoErr) {
@@ -4200,13 +4260,13 @@ export function EditorView(props) {
         loadContent(active, sessionId)
       } }, '重试'))
   } else if (content === null && loadError) {
-    body = loadingBody('文件加载失败：' + loadError, 0, () => {
+    body = React.createElement(React.Fragment, null, loadingBody('文件加载失败：' + loadError, 0, () => {
       setLoadError(null)
       setContent(null)
       setContentPath(null)
       setLoadStage({ progress: 10, message: '重新读取文件…' })
       loadContent(active, sessionId)
-    })
+    }), largeCandidate === pageIdentity && React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: openTextPages }, '只读分段查看'))
   } else if (isImageActive && imageSrc) {
     body = imagePanel()
   } else if (isImageActive) {

package/src/client/ui/LargeTextView.ts

@@ -0,0 +1,94 @@
+import React from 'react'
+import * as Primitives from '@deepseek-ai/dsh-client-ui-primitives'
+import { createTextPager } from '../textPages.js'
+import type { TextPageLoader, TextPagerState } from '../textPages.js'
+
+export interface LargeTextViewProps {
+  sessionId: string
+  path: string
+  loadPage: TextPageLoader
+}
+const Button = (Primitives as unknown as { Button: React.ComponentType<{
+  children?: React.ReactNode; disabled?: boolean; onClick?: () => void
+}> }).Button
+
+/**
+ * Read-only paged text surface: never creates a Monaco model or exposes a save action.
+ * @public @author ddj 2026年10月22号
+ * @param props Exact session/file identity and authorized page loader.
+ * @returns Bounded selectable text with explicit continuation and status.
+ */
+export function LargeTextView(props: LargeTextViewProps): React.ReactElement {
+  const [snapshot, setSnapshot] = React.useState<TextPagerState | null>(null)
+  const [identity, setIdentity] = React.useState('')
+  const pagerRef = React.useRef<ReturnType<typeof createTextPager> | null>(null)
+  const loaderRef = React.useRef(props.loadPage)
+  const mountedRef = React.useRef(false)
+  const firstPending = React.useRef(false)
+  loaderRef.current = props.loadPage
+  const currentIdentity = JSON.stringify([props.sessionId, props.path])
+
+  /** @private @author ddj 2026年10月22号 @param args Request identity. @returns Current injected loader response. */
+  function loadPage(args: Parameters<TextPageLoader>[0]): ReturnType<TextPageLoader> {
+    return loaderRef.current(args)
+  }
+  /** @private @author ddj 2026年10月22号 @param state Latest pager snapshot. @returns Publish only while mounted. */
+  function onSnapshot(state: TextPagerState): void {
+    if (!mountedRef.current) return
+    setSnapshot(state)
+    if (!state.loading && firstPending.current) queueMicrotask(loadFirst)
+  }
+
+  /** @private @author ddj 2026年10月22号 @description Start only the new identity's deferred first page, never automatic continuation. */
+  function loadFirst(): void {
+    const pager = pagerRef.current
+    if (!mountedRef.current || !firstPending.current || !pager || pager.getState().loading
+      || (typeof document !== 'undefined' && document.hidden)) return
+    firstPending.current = false
+    void pager.loadNext()
+  }
+
+  /** @private @author ddj 2026年10月22号 @returns Bind identity without replacing the single transport lock. */
+  function mountPager(): () => void {
+    mountedRef.current = true
+    if (!pagerRef.current) pagerRef.current = createTextPager(loadPage, onSnapshot)
+    const pager = pagerRef.current
+    setIdentity(currentIdentity)
+    firstPending.current = true
+    pager.reset({ sessionId: props.sessionId, path: props.path })
+    loadFirst()
+    if (typeof document !== 'undefined') document.addEventListener('visibilitychange', loadFirst)
+    /** @private @author ddj 2026年10月22号 @returns Release retained text and ignore pending responses. */
+    function unmountPager(): void {
+      mountedRef.current = false
+      firstPending.current = false
+      if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', loadFirst)
+      pager.invalidate()
+    }
+    return unmountPager
+  }
+  React.useEffect(mountPager, [props.sessionId, props.path])
+
+  /** @private @author ddj 2026年10月22号 @returns Load exactly one additional page on user intent. */
+  function loadNext(): void {
+    if (typeof document !== 'undefined' && document.hidden) return
+    if (firstPending.current) { loadFirst(); return }
+    void pagerRef.current?.loadNext()
+  }
+
+  const state = identity === currentIdentity ? snapshot : null
+  let status = '正在加载只读文本…'
+  if (state?.error) status = state.error
+  else if (state?.capped) status = '已达预览上限（8 MiB / 50,000 行），请使用外部编辑器查看完整文件'
+  else if (state?.eof) status = '文件末尾 · 只读'
+  else if (state) status = `已读取 ${state.offset.toLocaleString()} / ${state.size.toLocaleString()} 字节 · 只读`
+  if (state?.partialLine) status += ' · 末行尚未完整'
+
+  return React.createElement('section', { className: 'edrv-large-text', 'aria-label': '大文件只读预览' },
+    React.createElement('div', { className: 'edrv-large-text-toolbar' },
+      React.createElement('span', { role: 'status' }, status),
+      React.createElement(Button, { onClick: loadNext,
+        disabled: !state || state.loading || state.eof || state.capped },
+      state?.loading ? '加载中…' : (state?.error ? '重试本段' : '加载下一段'))),
+    React.createElement('pre', { className: 'edrv-large-text-content', tabIndex: 0 }, state?.text ?? ''))
+}