dsh-vscode-mode 0.19.2 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.19.2",
+  "version": "0.20.0",
   "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/archiveDb.ts

@@ -33,7 +33,7 @@ type Row = Record<string, string | number | null>
  * @param cwd 工作区绝对路径
  * @returns 已缓存连接
  */
-function dbFor(cwd: string): DatabaseSync {
+export function dbFor(cwd: string): DatabaseSync {
   const existing = connections.get(cwd)
   if (existing) return existing
   const file = archiveDbFile(cwd)
@@ -44,7 +44,7 @@ function dbFor(cwd: string): DatabaseSync {
     db.exec('CREATE TABLE IF NOT EXISTS metadata (name TEXT PRIMARY KEY, value TEXT NOT NULL)')
     const version = db.prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row | undefined
     const workspace = db.prepare("SELECT value FROM metadata WHERE name='cwd'").get() as Row | undefined
-    if ((version && version.value !== '2' && version.value !== '3') || (workspace && workspace.value !== cwd)) throw new Error('归档数据库 schema/工作区不匹配')
+    if ((version && version.value !== '2' && version.value !== '3' && version.value !== '4') || (workspace && workspace.value !== cwd)) throw new Error('归档数据库 schema/工作区不匹配')
     if (!!version !== !!workspace) throw new Error('归档数据库元数据不完整')
     if (!version) {
       const other = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name<>'metadata' LIMIT 1").get()
@@ -81,7 +81,7 @@ function dbFor(cwd: string): DatabaseSync {
         throw error
       }
     }
-    if (version?.value === '3') {
+    if (version && (version.value === '3' || version.value === '4')) {
       const active = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='active_records'").get()
       const source = db.prepare("SELECT value FROM metadata WHERE name='active_source'").get()
       if (!active || !source) throw new Error('活跃记录数据库元数据不完整')
@@ -105,7 +105,7 @@ function dbFor(cwd: string): DatabaseSync {
 export async function migrateActive(cwd: string, source: string | null, confirm: () => Promise<string | null>): Promise<Map<string, DiffRecord>> {
   const db = dbFor(cwd)
   const version = String((db.prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value)
-  if (version === '3') return readActive(cwd)
+  if (version === '3' || version === '4') return readActive(cwd)
   const digest = source === null ? 'absent' : createHash('sha256').update(source).digest('hex')
   let recs: Record<string, DiffRecord> = {}
   if (source !== null) {
@@ -148,7 +148,7 @@ export async function migrateActive(cwd: string, source: string | null, confirm:
  * @returns 迁移完成返回 true
  */
 export function activeReady(cwd: string): boolean {
-  return (dbFor(cwd).prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value === '3'
+  return ['3', '4'].includes(String((dbFor(cwd).prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value))
 }
 
 /**
@@ -173,7 +173,7 @@ export function checkActiveSource(cwd: string, source: string | null): void {
  */
 export function readActive(cwd: string): Map<string, DiffRecord> {
   const db = dbFor(cwd)
-  if ((db.prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value !== '3') throw new Error('工作区活跃记录未迁移')
+  if (!activeReady(cwd)) throw new Error('工作区活跃记录未迁移')
   const rows = db.prepare('SELECT payload FROM active_records ORDER BY rowid').all() as Row[]
   const recs = rows.map((row) => JSON.parse(String(row.payload)) as DiffRecord)
   return new Map(recs.map((rec) => [rec.callId, rec]))
@@ -189,7 +189,7 @@ export function readActive(cwd: string): Map<string, DiffRecord> {
  */
 export function commitActive(cwd: string, changes: ActiveChange, entries: ArchiveBatch[] = []): number {
   const db = dbFor(cwd)
-  if ((db.prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value !== '3') throw new Error('工作区活跃记录未迁移')
+  if (!activeReady(cwd)) throw new Error('工作区活跃记录未迁移')
   const upsert = db.prepare(`INSERT INTO active_records(call_id,payload,path,archived,pending,at) VALUES(?,?,?,?,?,?)
     ON CONFLICT(call_id) DO UPDATE SET payload=excluded.payload,path=excluded.path,
       archived=excluded.archived,pending=excluded.pending,at=excluded.at`)
@@ -218,7 +218,7 @@ export function commitActive(cwd: string, changes: ActiveChange, entries: Archiv
  */
 export function activeSummary(cwd: string): { active: number; pendingByFile: { path: string; pending: number }[] } {
   const db = dbFor(cwd)
-  if ((db.prepare("SELECT value FROM metadata WHERE name='schema'").get() as Row).value !== '3') throw new Error('工作区活跃记录未迁移')
+  if (!activeReady(cwd)) throw new Error('工作区活跃记录未迁移')
   const active = Number((db.prepare('SELECT count(*) AS n FROM active_records WHERE archived=0').get() as Row).n)
   const rows = db.prepare('SELECT path, sum(pending) AS pending FROM active_records WHERE archived=0 AND pending>0 GROUP BY path ORDER BY pending DESC').all() as Row[]
   return { active, pendingByFile: rows.map((row) => ({ path: String(row.path), pending: Number(row.pending) })) }

package/src/capture.ts

@@ -30,7 +30,7 @@ interface CaptureExec {
 /** 捕获所需的工具结果最小形状（tools/result 的结构子集）。 */
 interface CaptureResult {
   isError?: unknown
-  value?: { path?: unknown; before?: unknown; after?: unknown } | null
+  value?: { path?: unknown; before?: unknown; after?: unknown; operation?: unknown } | null
   meta?: { diffs?: unknown }
 }
 
@@ -90,7 +90,7 @@ function buildLocalRecord(exec: CaptureExec, args: Record<string, unknown>, resu
   if (typeof path !== 'string' || !path) return null
   const before = value && typeof value.before === 'string' ? value.before : null
   const after = value && typeof value.after === 'string' ? value.after : (typeof args.content === 'string' ? args.content : null)
-  const create = exec.name === 'write' && !!value && value.before === null
+  const create = exec.name === 'write' && value?.operation === 'create'
   const callHunk = exec.name === 'edit' && typeof args.old_string === 'string' && typeof args.new_string === 'string'
     ? { oldText: args.old_string, newText: args.new_string }
     : null

package/src/client/state/diffSummary.ts

@@ -0,0 +1,30 @@
+/** Source-aware metadata projection; official patches never become legacy hunks. @author ddj 2026年10月26号 */
+import type { ReviewPage } from '../../shared/review.js'
+import type { RecordView } from '../../shared/types.js'
+import type { FileSummary, Summary } from './records.js'
+import { summarize } from './records.js'
+
+export interface DiffFile extends FileSummary { sourceKind: 'official' | 'legacy' }
+export interface DiffSummary extends Summary { files: DiffFile[]; pendingFiles: DiffFile[] }
+
+/** @public @author ddj 2026年10月26号 @param path Functional local or remote identity. @returns Comparison key without rewriting remote case. */
+export function diffPathKey(path: string): string {
+  if (/^[a-z]+:\/\//i.test(path)) return path
+  const normalized = path.replace(/\\/g, '/')
+  return /^[a-z]:\//i.test(normalized) ? normalized.toLowerCase() : normalized
+}
+
+/** @public @author ddj 2026年10月26号 @param path Current editor file. @param page Authoritative metadata, including decided paths. @returns Whether legacy actions must be hidden for this file. */
+export function officialPath(path: string, page: ReviewPage | null): boolean {
+  const key = diffPathKey(path)
+  return !!page?.overview?.coveredPaths.some((candidate) => diffPathKey(candidate) === key)
+}
+
+/** @public @author ddj 2026年10月26号 @param records Tool-call history. @param page Official file navigation, never only its first 50 rows. @returns Official-first file counts; legacy paths remain explicitly labelled. */
+export function diffSummary(records: RecordView[], page: ReviewPage | null): DiffSummary {
+  const legacy = summarize(records.filter((record) => !officialPath(record.path, page)))
+  const files: DiffFile[] = (page?.overview?.files ?? []).map((file) => ({ ...file, recs: [] }))
+  for (const file of legacy.files) files.push({ ...file, sourceKind: 'legacy' })
+  const pendingFiles = files.filter((file) => file.pending > 0)
+  return { files, pendingFiles, totalFiles: pendingFiles.length }
+}

package/src/client/state/reviewFeed.ts

@@ -0,0 +1,60 @@
+/** One official metadata request loop per viewed session, lazy historical patches. @author ddj 2026年10月26号 */
+import { rpc } from '../rpc.js'
+import type { ReviewPage } from '../../shared/review.js'
+
+export interface ReviewFeed { page: ReviewPage | null; error: string }
+type Listener = (feed: ReviewFeed) => void
+interface Entry { listeners: Set<Listener>; value: ReviewFeed; controller: AbortController; timer?: ReturnType<typeof setTimeout>; loading: boolean; again: boolean; onRefresh: () => void }
+const feeds = new Map<string, Entry>()
+
+/** @private @author ddj 2026年10月26号 @param entry Shared feed. Notify mounted observers only. */
+function notify(entry: Entry): void { for (const listener of entry.listeners) listener(entry.value) }
+
+/** @private @author ddj 2026年10月26号 @param sessionId Scope. @param entry Current generation. @returns First-page metadata update; no overlap or late publication. */
+async function refresh(sessionId: string, entry: Entry): Promise<void> {
+  if (entry.controller.signal.aborted) return
+  if (entry.loading) { entry.again = true; return }
+  clearTimeout(entry.timer)
+  entry.loading = true
+  entry.again = false
+  try {
+    const result = await rpc('edrv.review.list', { sessionId }, entry.controller.signal)
+    if (!entry.controller.signal.aborted) entry.value = result.ok
+      ? { page: result.page, error: result.page.overview ? '' : 'Host 尚未提供官方文件导航，请重启加载新版插件；当前仅可浏览已返回的官方历史，角标不含官方记录。' }
+      : { ...entry.value, error: result.error }
+  } catch (error) { if (!entry.controller.signal.aborted) entry.value = { ...entry.value, error: String(error) } }
+  finally {
+    entry.loading = false
+    if (!entry.controller.signal.aborted) {
+      notify(entry)
+      if (entry.again) void refresh(sessionId, entry)
+      else entry.timer = setTimeout(() => { void refresh(sessionId, entry) }, 5000)
+    }
+  }
+}
+
+/** @public @author ddj 2026年10月26号 @param sessionId Live scope. @param listener Mounted observer. @returns Cleanup cancelling requests and timers when unused. */
+export function subscribeReview(sessionId: string, listener: Listener): () => void {
+  let entry = feeds.get(sessionId)
+  if (!entry) {
+    /** @private @author ddj 2026年10月26号 Refresh the shared official metadata after edits/decisions. */
+    const onRefresh = (): void => refreshReview(sessionId)
+    entry = { listeners: new Set(), value: { page: null, error: '' }, controller: new AbortController(), loading: false, again: false, onRefresh }
+    feeds.set(sessionId, entry)
+    if (typeof window !== 'undefined') window.addEventListener('edrv:refresh', onRefresh)
+    void refresh(sessionId, entry)
+  }
+  entry.listeners.add(listener); listener(entry.value)
+  return () => {
+    entry.listeners.delete(listener)
+    if (entry.listeners.size) return
+    entry.controller.abort(); clearTimeout(entry.timer); feeds.delete(sessionId)
+    if (typeof window !== 'undefined') window.removeEventListener('edrv:refresh', entry.onRefresh)
+  }
+}
+
+/** @public @author ddj 2026年10月26号 @param sessionId Refresh metadata after a decision; does not alter legacy or disk. */
+export function refreshReview(sessionId: string): void {
+  const entry = feeds.get(sessionId)
+  if (entry) { clearTimeout(entry.timer); void refresh(sessionId, entry) }
+}

package/src/client/ui/ConversationDiffDock.ts

@@ -7,7 +7,8 @@
  */
 import React from 'react'
 import { openDiffView } from '../events.js'
-import { summarize } from '../state/records.js'
+import { diffSummary } from '../state/diffSummary.js'
+import { subscribeReview } from '../state/reviewFeed.js'
 import { subscribeRecords } from '../state/recordsFeed.js'
 import { nextDiffPath } from '../diffDock.js'
 import { dockInLayout, readDiffDock, subscribeDiffDock } from '../diffDockStore.js'
@@ -33,9 +34,10 @@ export function ConversationDiffDock(props) {
       return undefined
     }
 
-    return subscribeRecords(sessionId, (records) => {
-      setSummary(summarize(records))
-    })
+    let records = [], page = null
+    const offRecords = subscribeRecords(sessionId, (next) => { records = next; setSummary(diffSummary(records, page)) })
+    const offReview = subscribeReview(sessionId, (feed) => { page = feed.page; setSummary(diffSummary(records, page)) })
+    return () => { offRecords(); offReview() }
   }, [sessionId])
 
   React.useEffect(() => {
@@ -73,11 +75,8 @@ export function ConversationDiffDock(props) {
   }
 
   return React.createElement(React.Fragment, null,
+    palette,
     renderDock(React.createElement(DiffBox, {
-      mode: 'chat',
-      dock: true,
-      fileTotal: paths.length,
-      onOpenNextFile: click,
-    }), sessionId || 'chat'),
-    palette)
+      mode: 'chat', dock: true, fileTotal: paths.length, onOpenNextFile: click,
+    }), sessionId || 'chat'))
 }

package/src/client/ui/DiffBadge.ts

@@ -7,7 +7,8 @@
 import React from 'react'
 import { appUrl } from '../../shared/appUrl.js'
 import { openEditorView, emitShowLauncher } from '../events.js'
-import { summarize } from '../state/records.js'
+import { diffSummary } from '../state/diffSummary.js'
+import { subscribeReview } from '../state/reviewFeed.js'
 import { subscribeRecords } from '../state/recordsFeed.js'
 
 /**
@@ -23,13 +24,14 @@ export function DiffBadge(props) {
       return undefined
     }
 
-    return subscribeRecords(sessionId, (records) => {
-      setSummary(summarize(records))
-    })
+    let records = [], page = null
+    const offRecords = subscribeRecords(sessionId, (next) => { records = next; setSummary(diffSummary(records, page)) })
+    const offReview = subscribeReview(sessionId, (feed) => { page = feed.page; setSummary(diffSummary(records, page)) })
+    return () => { offRecords(); offReview() }
   }, [sessionId])
 
   const n = summary?.totalFiles ?? 0
-  if (!n) return null
+  if (!sessionId) return null
 
   const click = () => {
     // 侧栏形态：带首个待处理文件路径（内容打开自动展开面板）；旧形态行为不变
@@ -39,7 +41,7 @@ export function DiffBadge(props) {
 
   return React.createElement('button', {
     onClick: click,
-    title: n + ' 个文件有差异，点击在编辑区查看',
+    title: '差异审查：' + n + ' 个待处理文件；点击查看总览与历史',
     style: { position: 'relative', display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: 30, height: 30, padding: 0, background: 'transparent', border: 'none', borderRadius: 6, cursor: 'pointer' },
   },
     React.createElement('img', { src: appUrl('/edrv/assets/compare-select.png'), alt: '差异', style: { width: 22, height: 22, display: 'block' } }),

package/src/client/ui/DiffBox.ts

@@ -8,6 +8,7 @@ import React from 'react'
 import { callIdAttr } from '../state/records.js'
 import { canDecideFile, diffDockText } from '../diffDock.js'
 import { badgeOf } from './shared.js'
+import { ReviewLedger } from './OfficialReview.js'
 
 /**
  * 折叠控制使用任务栏同尺寸的 chevron 轮廓，避免依赖未声明的运行时图标包。
@@ -65,6 +66,23 @@ export function DiffBox(props) {
         }, diffDockText(fileTotal))))
   }
 
+  if (props.official) {
+    const official = props.official
+    return React.createElement('div', { className: 'edrv-diffbar edrv-diffbar-dock', 'data-edrv-diffbox': '1', 'data-edrv-diff-source': 'official' },
+      React.createElement('div', { className: 'edrv-diffbar-row' },
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: onPrevFile, disabled: !fileTotal }, '←'),
+        React.createElement('span', null, base + ' · ' + official.pending + ' 条官方待审记录'),
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: onNextFile, disabled: !fileTotal }, '→'),
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => setExpanded(!expanded), 'aria-expanded': expanded }, expanded ? '收起差异' : '查看差异 / 标记已审'),
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', disabled: true, title: '官方仅提供差异块，缺少可验证全文，不能安全回滚。' }, 'Undo 不可用'),
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => onOpenLauncher('pending') }, '差异总览'),
+        React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => onOpenLauncher('archive') }, '归档 / 历史')),
+      props.reviewError ? React.createElement('div', { role: 'alert' }, props.reviewError) : null,
+      expanded ? React.createElement('div', { className: 'edrv-diffbar-body' },
+        React.createElement(ReviewLedger, { key: official.sessionId + ':' + official.path, sessionId: official.sessionId,
+          first: official.page, path: official.path })) : null)
+  }
+
   let bodyEl = null
   if (expanded) {
     const rows = pendingRegions.map((r) => {

package/src/client/ui/DiffLauncher.ts

@@ -7,6 +7,8 @@
 import React from 'react'
 import { rpc } from '../rpc.js'
 import { MONO, btn } from './shared.js'
+import { ReviewLedger } from './OfficialReview.js'
+import { subscribeReview } from '../state/reviewFeed.js'
 
 /**
  * 文件与批次共同标识归档卡片，避免同文件多批次共用展开状态。
@@ -57,6 +59,12 @@ export function DiffLauncher(props) {
   const detailRef = React.useRef(0)
   const moreRef = React.useRef(false)
   const [error, setError] = React.useState(null)
+  const [source, setSource] = React.useState('official')
+  const [review, setReview] = React.useState({ page: null, error: '' })
+  React.useEffect(() => {
+    setReview({ page: null, error: '' })
+    return subscribeReview(sessionId, setReview)
+  }, [sessionId])
 
   /** @author ddj 2026年09月30号 @description 仅加载一个归档摘要页并丢弃失效响应。 */
   const loadArchives = (cursor = null) => {
@@ -92,16 +100,22 @@ export function DiffLauncher(props) {
     moreRef.current = false
     setMoreBusy(false)
     setArchiveDetail(null); setArchivePath(null); setArchiveErr(null)
-    if (tab === 'archive') loadArchives()
+    if (tab === 'archive' && source === 'legacy') loadArchives()
     else { setArchives(null); setNextCursor(null) }
     return () => { requestRef.current++; detailRef.current++ }
-  }, [tab, sessionId])
+  }, [tab, sessionId, source])
 
   let body
-  if (tab === 'pending') {
-    body = (sum.pendingFiles.length === 0
+  const legacyFiles = sum.pendingFiles.filter((file) => file.sourceKind !== 'official')
+  if (source === 'official') {
+    body = React.createElement(React.Fragment, null,
+      React.createElement('div', { className: 'edrv-search-empty' }, '官方轮次净差异 · 原始历史只读；编辑按钮打开当前文件，保存不代表已审。'),
+      review.error ? React.createElement('div', { role: 'alert' }, review.error) : null,
+      React.createElement(ReviewLedger, { key: sessionId + ':' + tab, sessionId, first: review.page, history: tab === 'archive' }))
+  } else if (tab === 'pending') {
+    body = (legacyFiles.length === 0
       ? React.createElement('div', { className: 'edrv-search-empty' }, '暂无待处理差异（已全部处理）')
-      : sum.pendingFiles.map((f) => React.createElement('div', { key: f.path, className: 'edrv-launch-row', title: '打开并跳转到差异 ' + (f.label ?? f.path), onClick: () => onOpenFile(f.path) },
+      : legacyFiles.map((f) => React.createElement('div', { key: f.path, className: 'edrv-launch-row', title: '打开并跳转到差异 ' + (f.label ?? f.path), onClick: () => onOpenFile(f.path) },
           React.createElement('span', { className: 'edrv-launch-path' }, f.label ?? f.path),
           React.createElement('span', { className: 'edrv-launch-cnt' }, '待处理 ' + f.pending + ' 处'),
           React.createElement('button', { className: 'edrv-btn-mini edrv-btn-keep', onClick: (e) => { e.stopPropagation(); onOpenFile(f.path) } }, '打开'))))
@@ -178,6 +192,8 @@ export function DiffLauncher(props) {
       React.createElement('span', { style: { fontSize: 12, fontWeight: 600, color: 'var(--dsw-alias-label-primary,#eee)', marginRight: 4 } }, '差异'),
       React.createElement('button', { className: 'edrv-launch-tab' + (tab === 'pending' ? ' on' : ''), onClick: () => setTab('pending') }, '待处理' + (sum.totalFiles ? ' (' + sum.totalFiles + ')' : '')),
       React.createElement('button', { className: 'edrv-launch-tab' + (tab === 'archive' ? ' on' : ''), onClick: () => setTab('archive') }, '归档'),
+      React.createElement('button', { className: 'edrv-launch-tab' + (source === 'official' ? ' on' : ''), onClick: () => setSource('official') }, '官方净差异'),
+      React.createElement('button', { className: 'edrv-launch-tab' + (source === 'legacy' ? ' on' : ''), onClick: () => setSource('legacy') }, '旧工具记录'),
       React.createElement('span', { style: { flex: 1 } }),
       (error ? React.createElement('span', { style: { fontSize: 11, color: 'var(--dsw-alias-state-error-primary,#d9534f)', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', maxWidth: '40%' } }, '错误：' + String(error)) : null),
       React.createElement('button', { onClick: onClose, style: btn(false) }, '✕ 关闭')),

package/src/client/ui/EditorView.ts

@@ -22,6 +22,8 @@ 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 } from '../state/reviewFeed.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 +258,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([])
@@ -531,11 +539,11 @@ 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 contentReady = content !== null && contentPath === active
   // 当前 tab 是否处于图片预览模式（与 loadContent 的分派条件同源；SVG 文本模式时为 false）
@@ -575,7 +583,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) {
@@ -3132,7 +3140,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 +3149,7 @@ export function EditorView(props) {
       }
     }
     return out
-  }, [records])
+  }, [records, review.page])
 
   /**
    * 批量处理所有差异文件：采纳全部 / 不采纳全部。不采纳按 at 降序（新改先回滚）排序后一次 RPC。
@@ -4318,8 +4326,12 @@ 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 } : null,
+    reviewError: review.error,
     layout,
     pendingRegions,
     staleRegions,

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

@@ -1,6 +1,7 @@
 /** 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 { closeArchiveDbs } from './archiveDb.js'
 import { handleRpc, integrationBaseUrlOf } from './rpc.js'
 import { newSearcher } from './search/orchestrator.js'
@@ -67,6 +68,7 @@ function createRuntime(ctx: Ctx, config: unknown) {
  * @param runtime Managers created by this instance.
  */
 function attachRuntime(ctx: Ctx, runtime: Runtime): void {
+  const stopCapture = installCapture(ctx)
   /** @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 +86,7 @@ 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()
     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)
+  }
 }
 
 /** 按批次分组记录。 */