dsh-vscode-mode 0.19.2 → 0.20.1

package/src/client/ui/EditorView.ts

@@ -22,6 +22,10 @@ import { acceptsLoad, receiptErrorFor, receiptPath, receiptReadyFor, receiptTabP
 import { bindPanelCommand } from '../panelCommands.js'
 import { dbg, isDebug, rpc } from '../rpc.js'
 import { refreshFeed, subscribeErrors, subscribeRecords } from '../state/recordsFeed.js'
+import { subscribeReview, refreshReview } from '../state/reviewFeed.js'
+import { runReviewBatch } from '../reviewBatch.js'
+import { reviewRegions } from '../../shared/reviewRegions.js'
+import { diffSummary, officialPath } from '../state/diffSummary.js'
 import { emitFileChanged, emitRefresh } from '../events.js'
 import { langOf, loadMonaco, snippetLanguageOf } from '../monaco/loader.js'
 import { bindEditActions, runEditAction } from '../monaco/editActions.js'
@@ -256,6 +260,12 @@ export function EditorView(props) {
   const [monaco, setMonaco] = React.useState(null)
   const [monacoErr, setMonacoErr] = React.useState(null)
   const [records, setRecords] = React.useState({})
+  const [review, setReview] = React.useState({ page: null, error: '' })
+  React.useEffect(() => {
+    setReview({ page: null, error: '' })
+    if (!sessionId) return undefined
+    return subscribeReview(sessionId, setReview)
+  }, [sessionId])
   const [tabs, setTabs] = React.useState([])
   const [active, setDiskActive] = React.useState(null)
   const [planTabs, setPlanTabs] = React.useState([])
@@ -434,6 +444,13 @@ export function EditorView(props) {
   const hoverEditorRef = React.useRef(false) // 鼠标是否仍在编辑器命中区
   const hoverPanelRef = React.useRef(false) // 鼠标是否已进入 Keep/Undo 浮层
   const batchBusyRef = React.useRef(false) // 批量 Keep All/Undo All 防重入
+  const [reviewBatchBusy, setReviewBatchBusy] = React.useState(false)
+  const reviewLifeRef = React.useRef(null)
+  React.useEffect(() => {
+    const token = { live: true }
+    reviewLifeRef.current = token
+    return () => { token.live = false }
+  }, [sessionId])
   const menuHandlersRef = React.useRef(null) // 右键菜单动作的最新闭包（Monaco addAction 空依赖回调读取）
   const svnMenuDisposersRef = React.useRef([]) // Monaco 右键 SVN 组当前 disposables（同步时先注销旧组）
   // 调试（DAP）：store 订阅 tick 驱动重渲 + gutter/F9 切换闭包（ensureEditor 空依赖读取）
@@ -531,11 +548,49 @@ export function EditorView(props) {
   const currentRecords = React.useMemo(() => {
     const list = []
     for (const rec of Object.values(records)) {
-      if (rec.archived === true) continue
+      if (rec.archived === true || officialPath(rec.path, review.page)) continue
       if (sameFile(rec.path, active)) list.push(rec)
     }
     return list
-  }, [records, active, cwd])
+  }, [records, active, cwd, review.page])
+
+  const reviewOpsRef = React.useRef(new Map())
+  const [officialDetail, setOfficialDetail] = React.useState(null)
+  const [officialRecords, setOfficialRecords] = React.useState([])
+  const [selectedReview, setSelectedReview] = React.useState(null)
+  // Only switching file/session/selection invalidates the visible source immediately.
+  // Background metadata refresh must not remove and recreate the current Monaco zones.
+  React.useEffect(() => {
+    setOfficialDetail(null)
+    setOfficialRecords([])
+  }, [sessionId, active, selectedReview])
+  React.useEffect(() => {
+    const controller = new AbortController()
+    if (!active || !review.page?.overview?.coveredPaths.some((path) => sameFile(path, active))) {
+      setOfficialDetail(null)
+      setOfficialRecords([])
+      return () => controller.abort()
+    }
+    /** @private @author ddj 2026年10月27号 Load the active file independently of the global history page. */
+    async function loadReview() {
+      try {
+        // Tabs use workspace-relative paths; the metadata index owns the backend identity.
+        const reviewPath = review.page?.overview?.coveredPaths.find((path) => sameFile(path, active)) ?? active
+        const page = await rpc('edrv.review.list', { sessionId, path: reviewPath }, controller.signal)
+        if (controller.signal.aborted) return
+        if (!page.ok) throw new Error(page.error)
+        const selected = page.page.items.find((item) => item.id === selectedReview) ?? page.page.items[0]
+        if (!selected) { setOfficialRecords([]); setOfficialDetail(null); return }
+        const result = await rpc('edrv.review.detail', { sessionId, id: selected.id }, controller.signal)
+        if (controller.signal.aborted) return
+        if (!result.ok) throw new Error(result.error)
+        setOfficialRecords((previous) => JSON.stringify(previous) === JSON.stringify(page.page.items) ? previous : page.page.items)
+        setOfficialDetail((previous) => JSON.stringify(previous) === JSON.stringify(result.detail) ? previous : result.detail)
+      } catch (cause) { if (!controller.signal.aborted) setError('官方差异读取失败：' + String(cause)) }
+    }
+    void loadReview()
+    return () => controller.abort()
+  }, [sessionId, active, review.page, selectedReview, sameFile])
 
   const contentReady = content !== null && contentPath === active
   // 当前 tab 是否处于图片预览模式（与 loadContent 的分派条件同源；SVG 文本模式时为 false）
@@ -550,14 +605,16 @@ export function EditorView(props) {
     const trace = isDebug() && contentReady && currentRecords.length > 0
     const start = trace ? performance.now() : 0
     // #endregion
-    const next = diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded)
+    const next = officialDetail
+      ? reviewRegions(officialDetail.diff, officialDetail.item.id, officialDetail.blocks ?? [], contentReady ? content : null)
+      : diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded)
     // #region debug log
     if (trace) {
       try { dbg(sessionId, `[DEBUG diffRegions] records=${currentRecords.length} bytes=${content.length} regions=${next.length} ms=${(performance.now() - start).toFixed(1)}`) } catch (e) { /* 诊断不可影响渲染 */ }
     }
     // #endregion
     return next
-  }, [currentRecords, content, contentPath, active])
+  }, [currentRecords, content, contentPath, active, officialDetail])
   // useMemo 稳定引用：否则 hover 等重渲染会让 view zone effect 反复重建（- 号闪烁）
   const pendingRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && !r.stale), [regions])
   const staleRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && r.stale), [regions])
@@ -575,7 +632,7 @@ export function EditorView(props) {
     return map
   }, [pendingRegions])
   lineRegionMapRef.current = lineRegionMap
-  const sum = React.useMemo(() => summarize(Object.values(records)), [records])
+  const sum = React.useMemo(() => diffSummary(Object.values(records), review.page), [records, review.page])
 
   /** @private @author ddj 2026年10月08号 @param path Disk path. @param select Select tab. @param preview Optional explicit Markdown mode. */
   function addTab(path, select, preview) {
@@ -2521,7 +2578,7 @@ export function EditorView(props) {
       if (!line || !map.size) { hoverEditorRef.current = false; hideSoon(); return }
       const hit = map.get(line)
       if (!hit) { hoverEditorRef.current = false; hideSoon(); return }
-      const key = callIdAttr(hit.callId, hit.idx)
+      const key = hit.sourceKind === 'official' ? hit.recordId + ':' + hit.id : callIdAttr(hit.callId, hit.idx)
       const top = Math.max(0, ed.getTopForLineNumber(Math.max(1, hit.start)) - ed.getScrollTop())
       const layout = ed.getLayoutInfo()
       const minimapLeft = layout.minimap?.minimapLeft || 0
@@ -3005,6 +3062,7 @@ export function EditorView(props) {
    * @returns Promise<boolean> 是否成功
    */
   const actHunk = (region, reject, silent) => {
+    if (region.sourceKind === 'official') return decideOfficial(reject, region.id)
     const method = reject ? 'edrv.reject' : 'edrv.accept'
     // #region debug log
     const trace = isDebug()
@@ -3105,7 +3163,38 @@ export function EditorView(props) {
    */
   const itemOf = (r, reject) => ({ callId: r.callId, scope: r.create ? 'call' : 'hunk', hunkIndex: r.idx, decision: reject ? 'rejected' : 'accepted' })
 
+  /** @private @author ddj 2026年10月27号 @param reject Undo instead of Keep. @param blockId Optional contiguous block. @returns Persisted decision result; never reloads over a dirty buffer. */
+  async function decideOfficial(reject, blockId) {
+    if (!officialDetail || batchBusyRef.current) return false
+    if (reject && (dirtyRef.current[active] || savingRef.current.has(active) || saveTimerRef.current.isPending())) {
+      setError('存在未保存或正在保存的修改，请等待完成后重试'); return false
+    }
+    batchBusyRef.current = true
+    const source = officialDetail.item
+    const undoPath = active
+    const undoModel = editorRef.current?.getModel?.()
+    const undoVersion = undoModel?.getVersionId?.()
+    const opKey = JSON.stringify([sessionId, source.id, source.seq, source.revision, blockId, reject])
+    let operationId = reviewOpsRef.current.get(opKey)
+    if (!operationId) { operationId = crypto.randomUUID(); reviewOpsRef.current.set(opKey, operationId) }
+    try {
+      const result = await rpc('edrv.review.decide', { sessionId, id: source.id, seq: source.seq,
+        revision: source.revision, operationId, scope: blockId ? 'hunk' : 'file', blockId,
+        decision: reject ? 'rejected' : 'accepted' })
+      if (!result.ok) throw new Error(result.error)
+      reviewOpsRef.current.delete(opKey)
+      if (reject && activeRef.current === undoPath && !dirtyRef.current[undoPath]
+        && !savingRef.current.has(undoPath) && undoModel?.getVersionId?.() === undoVersion) reloadFile(true)
+      else if (reject) setError('Undo 已完成，编辑器在等待期间变化；未覆盖当前缓冲区，请核对磁盘后刷新')
+      refreshReview(sessionId)
+      setStatus(reject ? '已 Undo 选中差异' : '已 Keep 选中差异')
+      return true
+    } catch (cause) { setError(String(cause)); return false }
+    finally { batchBusyRef.current = false }
+  }
+
   const acceptFile = () => {
+    if (officialDetail) return decideOfficial(false)
     if (batchBusyRef.current || !decideRegions.length) return
     batchBusyRef.current = true
     actMany(decideRegions.map((r) => itemOf(r, false))).then((result) => {
@@ -3117,6 +3206,7 @@ export function EditorView(props) {
     }).catch(() => { batchBusyRef.current = false })
   }
   const undoFile = () => {
+    if (officialDetail) return decideOfficial(true)
     if (batchBusyRef.current || !decideRegions.length) return
     batchBusyRef.current = true
     actMany([...decideRegions].reverse().map((r) => itemOf(r, true))).then((result) => {
@@ -3132,7 +3222,7 @@ export function EditorView(props) {
   const allPending = React.useMemo(() => {
     const out = []
     for (const rec of Object.values(records)) {
-      if (rec.superseded === true) continue
+      if (rec.superseded === true || officialPath(rec.path, review.page)) continue
       const perHunk = Array.isArray(rec.decisions?.perHunk) ? rec.decisions.perHunk : []
       const hunks = Array.isArray(rec.hunks) ? rec.hunks : []
       for (let i = 0; i < hunks.length; i++) {
@@ -3141,7 +3231,7 @@ export function EditorView(props) {
       }
     }
     return out
-  }, [records])
+  }, [records, review.page])
 
   /**
    * 批量处理所有差异文件：采纳全部 / 不采纳全部。不采纳按 at 降序（新改先回滚）排序后一次 RPC。
@@ -3153,7 +3243,7 @@ export function EditorView(props) {
     batchBusyRef.current = true
     const list = reject ? [...allPending].sort((a, b) => (a.at < b.at ? 1 : a.at > b.at ? -1 : b.idx - a.idx)) : allPending
     const paths = [...new Set(list.map((r) => records[r.callId]?.path).filter(Boolean))]
-    actMany(list.map((r) => itemOf(r, reject))).then((result) => {
+    return actMany(list.map((r) => itemOf(r, reject))).then((result) => {
       batchBusyRef.current = false
       reloadFile(true)
       emitRefresh({ scope, paths: paths.length ? paths : undefined, kind: 'structure' })
@@ -3161,8 +3251,58 @@ export function EditorView(props) {
       if (result.fail) setError(result.fail + ' 处差异处理失败（可能已被后续修改影响），可刷新后重试')
     }).catch(() => { batchBusyRef.current = false })
   }
-  const acceptAllFiles = () => actAllPending(false)
-  const undoAllFiles = () => actAllPending(true)
+  /** @private @author ddj 2026年10月27号 @param reject Undo requires every local buffer to be saved. @param token Starting session lifetime. @returns Throws before the next mutation when unsafe. */
+  function guardReviewAll(reject, token) {
+    if (!token?.live) throw new Error('编辑器或会话已切换，批量操作已停止')
+    if (reject && (Object.values(dirtyRef.current).some(Boolean) || savingRef.current.size || saveTimerRef.current.isPending())) {
+      throw new Error('存在未保存或正在保存的文件，未执行下一项 Undo，请保存后重试')
+    }
+  }
+
+  /** @private @author ddj 2026年10月27号 @param detail Frozen official revision. @param reject Undo action. @returns Stable retry ID shared with single-file decisions. */
+  function batchOperation(detail, reject) {
+    const source = detail.item
+    const key = JSON.stringify([sessionId, source.id, source.seq, source.revision, undefined, reject])
+    let operationId = reviewOpsRef.current.get(key)
+    if (!operationId) { operationId = crypto.randomUUID(); reviewOpsRef.current.set(key, operationId) }
+    return operationId
+  }
+
+  /** @private @author ddj 2026年10月27号 @param reject Undo or Keep all workspace pending records, including previous rounds. @returns Explicit partial results; legacy proceeds only when official stage fully succeeds. */
+  async function actReviewAll(reject) {
+    if (batchBusyRef.current) return
+    if (!review.page?.overview) { setError('官方待审列表尚未就绪，未执行批量操作'); return }
+    const count = sum.pendingFiles.length
+    if (!count) return
+    if (!window.confirm(`${reject ? 'Undo All' : 'Keep All'}：处理当前工作区全部 ${count} 个待审差异文件（含其他轮次）？${reject ? '\n撤销会改写磁盘；逐项安全校验，遇到冲突停止，已完成项不会自动恢复。' : '\n只标记待审修改为保留，不改写文件。'}`)) return
+    const token = reviewLifeRef.current
+    const undoPath = activeRef.current
+    const undoModel = editorRef.current?.getModel?.()
+    const undoVersion = undoModel?.getVersionId?.()
+    batchBusyRef.current = true; setReviewBatchBusy(true)
+    setStatus(reject ? '正在检查并 Undo 全部待审记录…' : '正在 Keep 全部待审记录…')
+    try {
+      const result = await runReviewBatch({
+        list: async (cursor) => { const res = await rpc('edrv.review.list', { sessionId, cursor }); if (!res.ok) throw new Error(res.error); return res.page },
+        detail: async (id) => { const res = await rpc('edrv.review.detail', { sessionId, id }); if (!res.ok) throw new Error(res.error); return res.detail },
+        decide: (detail, undo, operationId) => rpc('edrv.review.decide', { sessionId, id: detail.item.id, seq: detail.item.seq, revision: detail.item.revision, operationId, scope: 'file', decision: undo ? 'rejected' : 'accepted' }),
+        guard: () => guardReviewAll(reject, token), operation: batchOperation,
+      }, reject)
+      if (!token?.live) return
+      refreshReview(sessionId)
+      if (reject && result.paths.some((path) => sameFile(path, undoPath)) && activeRef.current === undoPath
+        && !dirtyRef.current[undoPath] && !savingRef.current.has(undoPath) && undoModel?.getVersionId?.() === undoVersion) reloadFile(true)
+      if (result.paths.length) emitRefresh({ scope, paths: result.paths, kind: 'structure' })
+      setStatus(`${reject ? 'Undo All' : 'Keep All'}：官方记录已完成 ${result.completed} / ${result.total}`)
+      if (result.error) { setError(`批量已停止，已完成 ${result.completed} 项，其余未处理。${result.error}`); return }
+      guardReviewAll(reject, token)
+      // Official-owned paths are excluded from allPending; never run legacy writes for official history.
+      if (allPending.length) { batchBusyRef.current = false; await actAllPending(reject) }
+    } catch (cause) { if (token?.live) setError(String(cause)) }
+    finally { batchBusyRef.current = false; if (token?.live) setReviewBatchBusy(false) }
+  }
+  const acceptAllFiles = () => actReviewAll(false)
+  const undoAllFiles = () => actReviewAll(true)
   const rollbackFile = () => {
     if (!active) return
     if (!window.confirm('回滚当前文件到修改前状态？（相关差异将归档）')) return
@@ -4310,7 +4450,10 @@ export function EditorView(props) {
         },
       },
         React.createElement('button', { className: 'edrv-pill edrv-pill-keep', onClick: () => { dismissHover(); actHunk(hoverAct.region, false) } }, '✓ Keep'),
-        React.createElement('button', { className: 'edrv-pill edrv-pill-undo', onClick: () => { dismissHover(); actHunk(hoverAct.region, true) } }, '↩ Undo'))
+        React.createElement('button', { className: 'edrv-pill edrv-pill-undo',
+          disabled: hoverAct.region.sourceKind === 'official' && !officialDetail?.capability.undo,
+          title: hoverAct.region.sourceKind === 'official' ? officialDetail?.capability.reason : undefined,
+          onClick: () => { dismissHover(); actHunk(hoverAct.region, true) } }, '↩ Undo'))
     : null
 
   /**
@@ -4318,8 +4461,13 @@ export function EditorView(props) {
    * @author ddj 2026年09月29号
    * @returns 含布局及操作回调的差异快照
    */
+  const officialFile = review.page?.overview?.coveredPaths.find((path) => sameFile(path, active))
   const buildDockSnapshot = () => ({
     mode: editorDockMode(active),
+    official: officialFile ? { sessionId, page: review.page, path: officialFile,
+      pending: sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0,
+      detail: officialDetail, records: officialRecords, onSelect: setSelectedReview } : null,
+    reviewError: review.error || error,
     layout,
     pendingRegions,
     staleRegions,
@@ -4328,7 +4476,9 @@ export function EditorView(props) {
     onUndoFile: undoFile,
     onAcceptAllFiles: acceptAllFiles,
     onUndoAllFiles: undoAllFiles,
-    allPendingCount: allPending.length,
+    allPendingCount: allPending.length + (review.page?.pending ?? 0),
+    reviewBatchBusy,
+    batchUnavailable: !review.page?.overview ? '官方待审列表尚未就绪' : undefined,
     onRollback: rollbackFile,
     onJump: jumpTo,
     otherFiles,

package/src/client/ui/OfficialDiffBar.tsx

@@ -0,0 +1,112 @@
+import React from 'react'
+import { Button, Menu } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { ReviewDetail, ReviewItem, ReviewPage } from '../../shared/review.js'
+import { ReviewLedger } from './OfficialReview.js'
+
+export interface OfficialBarProps {
+  official: { sessionId: string; path: string; pending: number; detail?: ReviewDetail; records?: ReviewItem[]; page: ReviewPage; onSelect: (id: string) => void }
+  activePath: string
+  pendingRegions?: unknown[]
+  staleRegions?: unknown[]
+  diffIdx?: number
+  fileTotal?: number
+  fileIdx?: number
+  allPendingCount?: number
+  reviewBatchBusy?: boolean
+  batchUnavailable?: string
+  onAcceptAllFiles?: () => void
+  onUndoAllFiles?: () => void
+  onPrevFile: () => void
+  onNextFile: () => void
+  onPrevDiff: () => void
+  onNextDiff: () => void
+  onAcceptFile: () => void
+  onUndoFile: () => void
+  onOpenLauncher: (tab: string) => void
+  reviewError?: string
+}
+
+type Mark = 'left' | 'right' | 'up' | 'down' | 'check' | 'undo' | 'more' | 'file'
+const marks: Record<Mark, string> = {
+  left: 'm10 4-5 4 5 4', right: 'm6 4 5 4-5 4', up: 'm4 10 4-5 4 5', down: 'm4 6 4 5 4-5',
+  check: 'm3 8 3 3 7-7', undo: 'M5 3 2 6l3 3M2 6h7a4 4 0 0 1 0 8',
+  more: 'M3 8h.01M8 8h.01M13 8h.01', file: 'M9 2H4v12h8V5L9 2Zm0 0v4h3M6 9h4M6 11h3',
+}
+
+/** @private @author ddj 2026年10月27号 @param mark Toolbar action. @returns Decorative consistent-stroke icon; labels live on buttons. */
+function barIcon(mark: Mark): React.ReactElement {
+  return <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth={1.5} strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"><path d={marks[mark]} /></svg>
+}
+
+/** @private @author ddj 2026年10月27号 @param props Global workspace counts and bulk handlers. @returns Persistent global review controls, distinct from current-file actions. */
+function ReviewAllRow(props: OfficialBarProps): React.ReactElement {
+  const total = props.fileTotal ?? 0
+  const current = total && (props.fileIdx ?? -1) >= 0 ? (props.fileIdx ?? 0) + 1 : 0
+  const disabled = props.reviewBatchBusy || !!props.batchUnavailable || !props.allPendingCount
+  return <div className="edrv-review-global" role="group" aria-label="全部待审文件">
+    <Button size="sm" variant="ghost" className="edrv-review-total" onClick={() => props.onOpenLauncher('pending')} title="打开当前工作区全部待审差异文件">差异文件 <strong>{current} / {total}</strong></Button>
+    <span className="edrv-review-all-actions">
+      <Button size="sm" variant="ghost" onClick={props.onAcceptAllFiles} disabled={disabled || !props.onAcceptAllFiles} title={props.batchUnavailable || 'Keep 当前工作区全部待审文件（含其他轮次），不改写磁盘'}>Keep All</Button>
+      <Button size="sm" variant="ghost" className="edrv-review-undo" onClick={props.onUndoAllFiles} disabled={disabled || !props.onUndoAllFiles} title={props.batchUnavailable || '检查全部待审记录后逐项 Undo；缺少证据或遇到冲突停止，不强制覆盖'}>Undo All</Button>
+    </span>
+  </div>
+}
+
+/** @public @author ddj 2026年10月27号 @param props Existing review callbacks and immutable record metadata. @returns Responsive review toolbar; no disk or decision side effects until an explicit action. */
+export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
+  const { official, pendingRegions = [], staleRegions = [], diffIdx = 0 } = props
+  const [expanded, setExpanded] = React.useState(false)
+  const [menu, setMenu] = React.useState<'records' | 'more' | null>(null)
+  const name = String(props.activePath || '').split(/[\\/]/).pop() || '当前文件'
+  const detail = official.detail
+  const records = official.records ?? []
+  const count = pendingRegions.length
+  const position = count ? `${Math.min(diffIdx + 1, count)} / ${count}` : '—'
+
+  /** @private @author ddj 2026年10月27号 @returns Close current popup without changing selection. */
+  function closeMenu(): void { setMenu(null) }
+  /** @private @author ddj 2026年10月27号 @param id Immutable record ID. @returns Select record and dismiss popup. */
+  function selectRecord(id: string): void { official.onSelect(id); closeMenu() }
+  /** @private @author ddj 2026年10月27号 @param tab Existing launcher tab. @returns Open existing overview, never create another review entry. */
+  function openOverview(tab: string): void { props.onOpenLauncher(tab); closeMenu() }
+  /** @private @author ddj 2026年10月27号 @param mark Navigation icon. @param label Accessible action. @param action Existing callback. @param disabled Whether navigation is unavailable. @returns Compact keyboard-focusable navigation control. */
+  function navButton(mark: Mark, label: string, action: () => void, disabled: boolean): React.ReactElement {
+    return <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label={label} title={label} disabled={disabled} onClick={action}>{barIcon(mark)}</Button>
+  }
+
+  const recordTrigger = <Button size="sm" variant="ghost" className="edrv-review-record" aria-label="选择官方差异记录" aria-haspopup="menu" aria-expanded={menu === 'records'} disabled={!records.length} onClick={() => setMenu(menu === 'records' ? null : 'records')}>
+    {detail ? `轮次 ${detail.item.turn}` : '选择记录'}{barIcon('down')}
+  </Button>
+  const moreTrigger = <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label="更多审查操作" title="更多审查操作" aria-haspopup="menu" aria-expanded={menu === 'more'} onClick={() => setMenu(menu === 'more' ? null : 'more')}>{barIcon('more')}</Button>
+
+  return <div className="edrv-diffbar edrv-diffbar-dock edrv-reviewbar" data-edrv-diffbox="1" data-edrv-diff-source="official" role="region" aria-label="文件差异审查">
+    <ReviewAllRow {...props} />
+    {props.reviewBatchBusy ? <div className="edrv-review-notice" role="status">正在处理全部待审记录…</div> : null}
+    <div className="edrv-review-heading">
+      <span className="edrv-review-filemark">{barIcon('file')}</span>
+      <span className="edrv-review-filename" title={props.activePath}>{name}</span>
+      <span className="edrv-review-pending" title={`${official.pending} 条官方待审记录`}>待审 <strong>{official.pending}</strong></span>
+      <Menu open={menu === 'records'} anchor={recordTrigger} items={records.map((item) => ({ id: item.id, label: `轮次 ${item.turn} / 事件 ${item.seq}` }))} selectedId={detail?.item.id} onSelect={selectRecord} onClose={closeMenu} side="top" align="end" portal compact autoFocus />
+    </div>
+    <div className="edrv-review-tools">
+      <div className="edrv-review-nav" role="group" aria-label="文件导航">
+        {navButton('left', '上一个差异文件', props.onPrevFile, !props.fileTotal)}
+        {navButton('right', '下一个差异文件', props.onNextFile, !props.fileTotal)}
+      </div>
+      <div className="edrv-review-nav edrv-review-blocknav" role="group" aria-label="差异导航">
+        {navButton('up', '上一个差异', props.onPrevDiff, !count)}
+        <span className="edrv-review-position" aria-live="polite">{position}</span>
+        {navButton('down', '下一个差异', props.onNextDiff, !count)}
+      </div>
+      <div className="edrv-review-actions">
+        <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={props.reviewBatchBusy || !detail?.capability.undo} title={detail?.capability.reason}>Undo</Button>
+        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={props.reviewBatchBusy || !detail?.capability.keep} title="保留当前记录的未处理修改">Keep</Button>
+        <Button size="sm" variant="ghost" className="edrv-review-details" onClick={() => setExpanded(!expanded)} aria-expanded={expanded} aria-label={expanded ? '收起差异' : '展开差异'} title={expanded ? '收起差异' : '展开差异'}>详情{barIcon(expanded ? 'up' : 'down')}</Button>
+        <Menu open={menu === 'more'} anchor={moreTrigger} items={[{ id: 'pending', label: '差异总览' }, { id: 'archive', label: '归档 / 历史' }]} onSelect={openOverview} onClose={closeMenu} side="top" align="end" portal compact autoFocus />
+      </div>
+    </div>
+    {detail && staleRegions.length > 0 ? <div className="edrv-review-notice" role="status">{staleRegions.length} 处历史差异无法定位，展开详情查看原始增删。</div> : null}
+    {props.reviewError ? <div className="edrv-review-notice edrv-review-error" role="alert">{props.reviewError}</div> : null}
+    {expanded ? <div className="edrv-review-body"><ReviewLedger key={`${official.sessionId}:${official.path}`} sessionId={official.sessionId} first={official.page} path={official.path} /></div> : null}
+  </div>
+}

package/src/client/ui/OfficialReview.ts

@@ -0,0 +1,93 @@
+/** Official immutable patch ledger; current files use the existing editor. @author ddj 2026年10月26号 */
+import React from 'react'
+import { rpc } from '../rpc.js'
+import { openEditorView } from '../events.js'
+import { refreshReview } from '../state/reviewFeed.js'
+import type { ReviewDetail, ReviewItem, ReviewPage } from '../../shared/review.js'
+const h = React.createElement
+/** @private @author ddj 2026年10月26号 @param props Latest first-page metadata. @returns Paginated rows independent of expanded historical patch. */
+export function ReviewLedger(props: { sessionId: string; first: ReviewPage | null; history?: boolean; path?: string }) {
+  const [page, setPage] = React.useState<ReviewPage | null>(props.first)
+  const [history, setHistory] = React.useState(props.history ?? false)
+  const [cursor, setCursor] = React.useState(0)
+  const [detail, setDetail] = React.useState<ReviewDetail | null>(null)
+  const [error, setError] = React.useState('')
+  const selected = React.useRef<AbortController | null>(null)
+  React.useEffect(() => () => selected.current?.abort(), [])
+  React.useEffect(() => {
+    const controller = new AbortController()
+    if (!history && !props.path && cursor === 0) { setPage(props.first); return () => controller.abort() }
+    void rpc('edrv.review.list', { sessionId: props.sessionId, history, cursor, path: props.path }, controller.signal).then((result) => {
+      if (controller.signal.aborted) return
+      if (result.ok) { setPage(result.page); setError('') }
+      else setError(result.error)
+    }).catch((cause) => { if (!controller.signal.aborted) setError(String(cause)) })
+    return () => controller.abort()
+  }, [props.sessionId, props.first, props.path, cursor, history])
+
+  /** @private @author ddj 2026年10月26号 @param item Frozen version identity; patch is never built from disk. */
+  async function select(item: ReviewItem): Promise<void> {
+    selected.current?.abort()
+    const controller = new AbortController()
+    selected.current = controller
+    try {
+      const result = await rpc('edrv.review.detail', { sessionId: props.sessionId, id: item.id }, controller.signal)
+      if (controller.signal.aborted) return
+      if (result.ok) { setDetail(result.detail); setError('') }
+      else setError(result.error)
+    } catch (cause) { if (!controller.signal.aborted) setError(String(cause)) }
+  }
+  return h('div', { style: { marginTop: 8 } },
+    h('label', null, h('input', { type: 'checkbox', checked: history, onChange: () => { setHistory(!history); setCursor(0) } }), '显示已处理及被替换的历史'),
+    page?.gaps.map((gap) => h('div', { key: `${gap.sessionId}:${gap.seq}`, role: 'status' }, `轮次 ${gap.turn} 采集不完整：${gap.error}`)),
+    error ? h('div', { role: 'alert' }, error) : null,
+    !page ? h('p', { role: 'status' }, '正在读取官方审查记录…') : null,
+    page && !page.items.length ? h('p', null, history ? '暂无已落盘历史。' : '没有待处理的官方记录；可切换查看历史。') : null,
+    h('div', { style: { maxHeight: 210, overflow: 'auto' } }, page?.items.map((item) => h('button', {
+      key: item.id, type: 'button', onClick: () => { void select(item) },
+      style: { display: 'block', width: '100%', textAlign: 'left', padding: '6px 4px' },
+    }, `轮次 ${item.turn} · ${item.display}  +${item.added} −${item.deleted} · ${item.decision}${item.current ? '' : '（已被同轮新版本替换）'}`))),
+    cursor > 0 ? h('button', { type: 'button', onClick: () => setCursor(Math.max(0, cursor - 50)) }, '上一页') : null,
+    page?.nextCursor !== null && page?.nextCursor !== undefined ? h('button', { type: 'button', onClick: () => setCursor(page.nextCursor!) }, '下一页') : null,
+    detail ? h(PatchDetail, { key: detail.item.id, sessionId: props.sessionId, detail, onChanged: () => { setDetail(null); refreshReview(props.sessionId) } }) : null)
+}
+
+/** @private @author ddj 2026年10月26号 @param props Immutable patch and current review revision. @returns Read-only source with explicit capability gates. */
+function PatchDetail(props: { sessionId: string; detail: ReviewDetail; onChanged(): void }) {
+  const [error, setError] = React.useState('')
+  const [busy, setBusy] = React.useState(false)
+  const [operationId] = React.useState(() => crypto.randomUUID())
+  const lifetime = React.useRef<AbortController | null>(null)
+  React.useEffect(() => {
+    lifetime.current = new AbortController()
+    return () => lifetime.current?.abort()
+  }, [])
+  const { item, diff, capability } = props.detail
+  /** @private @author ddj 2026年10月26号 Marks reviewed only; never writes disk. Stable operation id survives retries while mounted. */
+  async function keep(): Promise<void> {
+    setBusy(true)
+    try {
+      const result = await rpc('edrv.review.decide', { sessionId: props.sessionId, id: item.id, seq: item.seq, revision: item.revision,
+        operationId, decision: 'accepted' }, lifetime.current?.signal)
+      if (lifetime.current?.signal.aborted) return
+      if (result.ok) props.onChanged()
+      else setError(result.error)
+    } catch (cause) { if (!lifetime.current?.signal.aborted) setError(String(cause)) }
+    finally { if (!lifetime.current?.signal.aborted) setBusy(false) }
+  }
+  return h('article', { style: { marginTop: 10, borderTop: '1px solid var(--border-color, #d9dee7)', paddingTop: 8 } },
+    h('strong', null, `${item.display} · 轮次 ${item.turn} / 事件 ${item.seq}`),
+    h('div', null, `来源会话 ${item.sessionId} · 采集于 ${props.detail.capturedAt}`),
+    h('p', null, capability.reason),
+    diff.kind === 'text' ? h('div', null,
+      h('div', null, `${diff.before ? '原文件存在' : '原文件不存在'} / ${diff.after ? '结果文件存在' : '结果文件不存在'}${diff.coarse ? ' · 粗粒度比较' : ''}`),
+      h('pre', { style: { overflow: 'auto', maxHeight: 400, fontSize: 11, lineHeight: 1.6 }, 'aria-label': '官方历史差异（只读）' },
+        diff.hunks.map((chunk, index) => h('div', { key: index },
+          h('div', null, `@@ -${chunk.oldStart},${chunk.oldLines} +${chunk.newStart},${chunk.newLines} @@`),
+          chunk.lines.map((line, position) => h('div', { key: position, style: { background: line.startsWith('+') ? 'light-dark(#e5f5e8, #173522)' : line.startsWith('-') ? 'light-dark(#fce9e9, #452323)' : undefined } }, line)))))
+    ) : h('p', null, diff.kind === 'binary' ? '二进制文件：官方不提供文本差异。' : '文件超过官方大小限制：没有差异内容。'),
+    error ? h('div', { role: 'alert' }, error) : null,
+    h('button', { type: 'button', disabled: busy || !capability.keep, onClick: () => { void keep() } }, '标记已审（不改文件）'),
+    h('button', { type: 'button', disabled: true, title: capability.reason }, '拒绝写回不可用'),
+    h('button', { type: 'button', onClick: () => openEditorView(item.currentPath) }, '编辑当前文件'))
+}

package/src/client-primitives.d.ts

@@ -7,6 +7,28 @@
  * 作者 ddj 2026-09-10
  */
 declare module '@deepseek-ai/dsh-client-ui-primitives' {
+  /** Compact theme-backed button; mirrors official Button.d.ts. @author ddj 2026年10月27号 */
+  export const Button: import('react').ComponentType<import('react').ButtonHTMLAttributes<HTMLButtonElement> & {
+    variant?: 'primary' | 'ghost' | 'outline' | 'toolbar'
+    size?: 'md' | 'sm'
+    icon?: import('react').ReactNode
+  }>
+
+  /** Anchored selectable menu; mirrors the subset used from official Menu.d.ts. @author ddj 2026年10月27号 */
+  export const Menu: import('react').ComponentType<{
+    open: boolean
+    anchor: import('react').ReactNode
+    items: readonly { id: string; label: import('react').ReactNode; disabled?: boolean }[]
+    selectedId?: string
+    onSelect: (id: string) => void
+    onClose: () => void
+    side?: 'top' | 'bottom' | 'right'
+    align?: 'start' | 'end'
+    portal?: boolean
+    compact?: boolean
+    autoFocus?: boolean
+  }>
+
   /** 图标组件通用 props（官方 Icon* 组件与 FileTypeIcon 共用形状）。 */
   export interface EdrvIconProps {
     /** 图标边长（px）；省略时用图标自带尺寸。 */

package/src/index.ts

@@ -1,6 +1,8 @@
 /** dsh-vscode-mode Host composition. @author ddj 2026年09月28号 */
 import { registerRoutes } from './routes.js'
 import { captureToolResult } from './capture.js'
+import { installCapture } from './officialCapture.js'
+import { installEvidence } from './reviewCapture.js'
 import { closeArchiveDbs } from './archiveDb.js'
 import { handleRpc, integrationBaseUrlOf } from './rpc.js'
 import { newSearcher } from './search/orchestrator.js'
@@ -67,6 +69,8 @@ function createRuntime(ctx: Ctx, config: unknown) {
  * @param runtime Managers created by this instance.
  */
 function attachRuntime(ctx: Ctx, runtime: Runtime): void {
+  const evidence = installEvidence(ctx)
+  const stopCapture = installCapture(ctx, (cwd, snapshot) => { evidence.persist(cwd, snapshot); return true })
   /** @author ddj 2026年09月28号 @param exec Tool execution. @param result Tool result. */
   function onResult(exec: unknown, result: unknown): void {
     void captureToolResult(ctx, runtime.registry, exec, result)
@@ -84,6 +88,8 @@ function attachRuntime(ctx: Ctx, runtime: Runtime): void {
   }
   /** @author ddj 2026年09月28号 Release every manager even if another cleanup rejects. */
   async function cleanup(): Promise<void> {
+    await stopCapture()
+    evidence.dispose()
     runtime.fileVersions.dispose()
     closeArchiveDbs()
     disposeAllServers()

package/src/model.ts

@@ -277,11 +277,15 @@ export function fileMaxBatch(records: Map<string, DiffRecord>, path: string): nu
   return m
 }
 
-/** 记录桶裁剪：超出 MAX_RECORDS 时剔除最旧的。 */
+/** @public @author ddj 2026年10月26号 @param map Legacy records. @param max Cache target, never a pending retention limit. */
 export function prune(map: Map<string, DiffRecord>, max = MAX_RECORDS): void {
   if (map.size <= max) return
-  const sorted = [...map.values()].sort((a, b) => (a.at < b.at ? -1 : 1))
-  for (let i = 0; i < sorted.length - max; i++) map.delete(sorted[i].callId)
+  const sorted = [...map.values()].filter((record) => record.archived && recordResolved(record))
+    .sort((a, b) => (a.at < b.at ? -1 : 1))
+  for (const record of sorted) {
+    if (map.size <= max) break
+    map.delete(record.callId)
+  }
 }
 
 /** 按批次分组记录。 */