dsh-vscode-mode 0.19.2 → 0.20.1

package/package.json

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

@@ -5,7 +5,7 @@ import { detectColorScheme, officialThemeOf, themeNameOf } from './theme.js'
 // #region 显示数据
 /** @private @author ddj 2026年10月09号 @param regions 待显示区域 @returns 内容敏感且无分隔符碰撞的展示键 */
 function renderKey(regions) {
-  return JSON.stringify(regions.map((r) => [r.callId, r.idx, r.start, r.end, r.oldStart, r.create, r.oldLines, r.newLines]))
+  return JSON.stringify(regions.map((r) => [r.recordId ?? r.callId, r.id ?? r.idx, r.start, r.end, r.oldStart, r.create, r.oldLines, r.newLines]))
 }
 
 /** @private @author ddj 2026年10月09号 @param node 接收样式的节点 @param colors Monaco 颜色 @returns 设置插件局部变量；不覆盖官方令牌 */
@@ -48,7 +48,7 @@ function marginRow(line) {
 function zoneOf(region) {
   const domNode = document.createElement('div')
   domNode.className = 'edrv-del-zone'
-  domNode.dataset.edrvHunk = String(region.callId) + ':' + region.idx
+  domNode.dataset.edrvHunk = String(region.recordId ?? region.callId) + ':' + (region.id ?? region.idx)
   const marginDomNode = document.createElement('div')
   marginDomNode.className = 'edrv-del-margin'
   const rows = []

package/src/client/reviewBatch.ts

@@ -0,0 +1,64 @@
+/** Official bulk decisions use persisted metadata, never the visible history page. @author ddj 2026年10月27号 */
+import type { ReviewDetail, ReviewItem, ReviewPage, ReviewResult } from '../shared/review.js'
+
+export interface BatchPort {
+  list: (cursor?: number) => Promise<ReviewPage>
+  detail: (id: string) => Promise<ReviewDetail>
+  decide: (detail: ReviewDetail, reject: boolean, operationId: string) => Promise<ReviewResult<{ revision: number }>>
+  guard: () => void
+  operation: (detail: ReviewDetail, reject: boolean) => string
+}
+export interface BatchResult { completed: number; total: number; paths: string[]; error: string }
+
+/** @public @author ddj 2026年10月27号 @param port Authenticated RPC adapter. @returns Frozen complete pending set; aborts before any decision if pagination shifts. @throws Incomplete or changing pages. */
+export async function loadPending(port: Pick<BatchPort, 'list'>): Promise<ReviewItem[]> {
+  const items: ReviewItem[] = []
+  const seen = new Set<string>()
+  const cursors = new Set<number>()
+  let cursor: number | undefined
+  let expected: number | undefined
+  do {
+    const page = await port.list(cursor)
+    expected ??= page.pending
+    if (page.pending !== expected) throw new Error('待审记录在分页期间变化，请刷新后重试')
+    for (const item of page.items) {
+      if (seen.has(item.id) || !item.current || item.decision !== 'pending') throw new Error('待审分页发生重复或版本变化，请刷新后重试')
+      seen.add(item.id); items.push(item)
+    }
+    if (page.nextCursor === null) break
+    if (cursors.has(page.nextCursor) || page.items.length === 0) throw new Error('待审分页未完整返回，请刷新后重试')
+    cursor = page.nextCursor; cursors.add(cursor)
+  } while (true)
+  if (items.length !== expected) throw new Error('待审记录数量不完整，未执行批量操作')
+  return items
+}
+
+/** @public @author ddj 2026年10月27号 @param port Guarded existing per-file decision adapter. @param reject Undo instead of Keep. @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback. */
+export async function runReviewBatch(port: BatchPort, reject: boolean): Promise<BatchResult> {
+  const result: BatchResult = { completed: 0, total: 0, paths: [], error: '' }
+  try {
+    port.guard()
+    const items = await loadPending(port)
+    result.total = items.length
+    const details: ReviewDetail[] = []
+    // Preflight the entire frozen set before the first mutation. Disk CAS remains authoritative at execution.
+    for (const item of items) {
+      port.guard()
+      const detail = await port.detail(item.id)
+      if (!detail.item.current || detail.item.seq !== item.seq || detail.item.revision !== item.revision
+        || !detail.capability.keep) throw new Error(`${item.display}：审查版本变化，请刷新后重试`)
+      if (reject && !detail.capability.undo) throw new Error(`${item.display}：${detail.capability.reason}`)
+      details.push(detail)
+    }
+    // Reverse chronological snapshots allow a newer round's result to expose the previous round's endpoint.
+    details.sort((left, right) => right.capturedAt.localeCompare(left.capturedAt) || right.item.seq - left.item.seq)
+    for (const detail of details) {
+      port.guard()
+      const reply = await port.decide(detail, reject, port.operation(detail, reject))
+      if (!reply.ok) throw new Error(`${detail.item.display}：${reply.error}`)
+      result.completed++
+      result.paths.push(detail.item.currentPath)
+    }
+  } catch (cause) { result.error = cause instanceof Error ? cause.message : String(cause) }
+  return result
+}

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,64 @@
+/** 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, force = false): Promise<void> {
+  if (entry.controller.signal.aborted) return
+  if (entry.loading) { entry.again = true; return }
+  clearTimeout(entry.timer)
+  entry.loading = true
+  entry.again = false
+  const previous = entry.value
+  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) {
+      // Polling returns fresh JSON objects even when nothing changed. Preserve identity so
+      // editors do not tear down Monaco zones and reload file details every five seconds.
+      if (!force && JSON.stringify(previous) === JSON.stringify(entry.value)) entry.value = previous
+      else notify(entry)
+      if (entry.again) void refresh(sessionId, entry, true)
+      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, true) }
+}

package/src/client/styles/editor.css

@@ -271,6 +271,45 @@
 [data-edrv-view] .edrv-side-diff-dock .edrv-diffbar-body { max-height: min(180px, 25vh); max-width: 100%; }
 [data-edrv-view] .edrv-side-diff-dock .edrv-diff-details { max-height: min(260px, 35vh); overflow-y: auto; }
 
+/* Official review: file context above, navigation/actions below. Theme-owned surfaces; no neon status outlines. @author ddj 2026年10月27号 */
+[data-edrv-diff-dock-shell] .edrv-reviewbar {
+  width: 520px; max-width: 100%; min-width: 0; box-sizing: border-box;
+  color: var(--dsw-alias-label-primary, #26313d); font-family: var(--dsw-font-family, sans-serif);
+  font-size: 12px; line-height: 1.4; container: edrv-review / inline-size;
+}
+[data-edrv-diff-dock-shell] .edrv-review-global { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 4px; padding: 6px 8px; border-bottom: 1px solid var(--dsw-alias-border-l1, #e5e9ef); }
+[data-edrv-diff-dock-shell] .edrv-review-all-actions { display: flex; align-items: center; gap: 4px; }
+[data-edrv-diff-dock-shell] .edrv-review-total strong { font-variant-numeric: tabular-nums; }
+[data-edrv-diff-dock-shell] .edrv-review-heading {
+  display: flex; align-items: center; gap: 8px; min-width: 0; padding: 10px 12px 8px;
+  border-bottom: 1px solid var(--dsw-alias-border-l1, #e5e9ef);
+}
+[data-edrv-diff-dock-shell] .edrv-review-filemark { display: inline-flex; flex: none; color: var(--dsw-alias-label-tertiary, #697586); }
+[data-edrv-diff-dock-shell] .edrv-review-filename { min-width: 0; flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 13px; font-weight: 600; }
+[data-edrv-diff-dock-shell] .edrv-review-pending { flex: none; display: inline-flex; gap: 5px; align-items: center; color: var(--dsw-alias-label-secondary, #697586); font-size: 11px; white-space: nowrap; }
+[data-edrv-diff-dock-shell] .edrv-review-pending strong { font-size: 12px; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--dsw-alias-label-primary, #26313d); }
+[data-edrv-diff-dock-shell] .edrv-review-tools { display: flex; flex-wrap: wrap; align-items: center; gap: 6px; padding: 7px 8px; }
+[data-edrv-diff-dock-shell] .edrv-review-nav { display: flex; align-items: center; flex: none; gap: 1px; }
+[data-edrv-diff-dock-shell] .edrv-review-blocknav { border-left: 1px solid var(--dsw-alias-border-l1, #e5e9ef); padding-left: 6px; }
+[data-edrv-diff-dock-shell] .edrv-review-position { min-width: 32px; text-align: center; font-size: 11px; font-variant-numeric: tabular-nums; color: var(--dsw-alias-label-secondary, #697586); }
+[data-edrv-diff-dock-shell] .edrv-review-actions { display: flex; align-items: center; flex: none; gap: 4px; margin-left: auto; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button { height: 28px; min-height: 28px; padding: 0 8px; border-radius: 6px; font-family: inherit; font-size: 12px; font-weight: 500; white-space: nowrap; gap: 5px; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button.edrv-review-icon { width: 28px; min-width: 28px; padding: 0; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button.edrv-review-record { padding: 0 6px; font-size: 11px; color: var(--dsw-alias-label-secondary, #697586); }
+[data-edrv-diff-dock-shell] .edrv-review-record svg { width: 12px; height: 12px; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button.edrv-review-keep { background: var(--dsw-alias-brand-primary, #3b63d9); color: var(--dsw-alias-label-primary-inverted, #fff); border: 1px solid transparent; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button.edrv-review-keep:hover:not(:disabled) { filter: brightness(.94); }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button.edrv-review-undo:hover:not(:disabled) { color: var(--dsw-alias-state-error-primary, #b64043); }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button:disabled { opacity: .4; cursor: not-allowed; }
+[data-edrv-diff-dock-shell] .edrv-reviewbar button:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary, #3b63d9); outline-offset: 2px; }
+[data-edrv-diff-dock-shell] .edrv-review-notice { padding: 7px 12px; border-top: 1px solid var(--dsw-alias-border-l1, #e5e9ef); color: var(--dsw-alias-label-secondary, #697586); font-size: 11px; overflow-wrap: anywhere; }
+[data-edrv-diff-dock-shell] .edrv-review-error { color: var(--dsw-alias-state-error-primary, #b64043); }
+[data-edrv-diff-dock-shell] .edrv-review-body { border-top: 1px solid var(--dsw-alias-border-l1, #e5e9ef); max-height: min(240px, 30vh); overflow: auto; padding: 8px 12px; }
+@container edrv-review (max-width: 420px) {
+  .edrv-reviewbar .edrv-review-heading { gap: 6px; padding-inline: 10px; }
+  .edrv-reviewbar .edrv-review-actions { justify-content: flex-end; flex: 1 0 100%; border-top: 1px solid var(--dsw-alias-border-l1, #e5e9ef); padding-top: 6px; }
+}
+
 /* ===== 侧边栏（活动栏 + 面板区 + 文件树） ===== */
 [data-edrv-view] .edrv-editor-row { display: flex; flex: 1 1 auto; min-width: 0; min-height: 0; overflow: hidden; }
 [data-edrv-view] .edrv-main-col { box-sizing: border-box; min-width: 0; min-height: 0; overflow: hidden; }

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 { OfficialDiffBar } from './OfficialDiffBar.js'
 
 /**
  * 折叠控制使用任务栏同尺寸的 chevron 轮廓，避免依赖未声明的运行时图标包。
@@ -65,6 +66,8 @@ export function DiffBox(props) {
         }, diffDockText(fileTotal))))
   }
 
+  if (props.official) return React.createElement(OfficialDiffBar, props)
+
   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) }, '✕ 关闭')),