dsh-vscode-mode 0.21.3 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.21.3",
+  "version": "0.22.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/client/addToConversation.ts

@@ -281,28 +281,78 @@ interface SessionBridge {
   scope?: (id: string) => unknown
 }
 
-/** @private @author ddj 2026年10月28号 @param ctx Lifecycle owner. @param sessions Public Controller. @param id Fixed target. @param text Task body. @returns Acceptance; failures never retry another transport. @sideEffects Retains one generation until completion or unload. */
-async function sendOwned(ctx: CtxLike, sessions: SessionBridge, id: string, text: string): Promise<boolean> {
+/** Detailed admission evidence; none of these states proves task completion. */
+export interface TaskSendResult {
+  status: 'accepted' | 'rejected' | 'unavailable' | 'unknown' | 'submitted' | 'cancelled'
+  /** Historical boolean from this same attempt, not an admission marker. */
+  legacyOk: boolean
+}
+
+/** @private @author ddj 2026年10月29号 @param receipt Raw selected-channel receipt. @returns Explicit admission evidence and the historical boolean. */
+function taskReceipt(receipt: unknown): TaskSendResult {
+  const ok = (receipt as { ok?: unknown } | null)?.ok
+  if (ok === true) return { status: 'accepted', legacyOk: true }
+  if (ok === false) return { status: 'rejected', legacyOk: false }
+  return { status: 'unknown', legacyOk: false }
+}
+
+/** @private @author ddj 2026年10月29号 @param ctx Lifecycle owner. @param sessions Public Controller. @param id Fixed target. @param text Task body. @returns Admission evidence without switching transport. @sideEffects Retains and releases exactly one generation. */
+async function sendOwned(ctx: CtxLike, sessions: SessionBridge, id: string, text: string): Promise<TaskSendResult> {
   const controller = new AbortController()
   const reference = sessions.retain!(id, { source: 'controllerOperation', signal: controller.signal })
   let released = false
-  /** @private @author ddj 2026年10月28号 Cancel pending admission and release this exact generation once. */
+  let cleanupFailed = false
+  /** @private @author ddj 2026年10月29号 Cancels and releases this exact generation once; remembers unload cleanup failures. */
   function release(): void {
     if (released) return
     released = true
     controller.abort()
-    reference.release()
+    try { reference.release() } catch (error) { cleanupFailed = true; throw error }
   }
   let remove: (() => void) | undefined
+  let started = false
+  let result: TaskSendResult = { status: 'unavailable', legacyOk: false }
   try {
     remove = ctx.effect?.(() => release, 'vscode-mode: task session reference')
     const binding = await reference.ready
-    if (controller.signal.aborted) return false
-    return (await binding.session.prompt([{ type: 'text', text }], 'queue', controller.signal)).ok === true
-  } finally {
-    release()
-    remove?.()
+    if (controller.signal.aborted) result = { status: 'cancelled', legacyOk: false }
+    else {
+      started = true
+      result = taskReceipt(await binding.session.prompt([{ type: 'text', text }], 'queue', controller.signal))
+    }
+  } catch {
+    result = { status: started ? 'unknown' : 'unavailable', legacyOk: false }
+  }
+
+  // Snapshot cancellation before normal cleanup aborts our own signal.
+  const cancelled = controller.signal.aborted
+  try { release() } catch { cleanupFailed = true }
+  try { remove?.() } catch { cleanupFailed = true }
+  if (cleanupFailed) result = { status: started ? 'unknown' : 'unavailable', legacyOk: false }
+  if (cancelled) result = { status: 'cancelled', legacyOk: result.legacyOk }
+  return result
+}
+
+/** @private @author ddj 2026年10月29号 @param ctx Service owner. @param id Fixed target. @param text Task body. @returns One legacy-channel attempt; no cross-channel retry. */
+async function sendLegacy(ctx: CtxLike, id: string, text: string): Promise<TaskSendResult> {
+  const input = inputFor(ctx, id) as { setDraft?: (task: string) => void; submit?: () => void } | undefined
+  if (typeof input?.setDraft === 'function' && typeof input.submit === 'function') {
+    let submitted = false
+    try {
+      input.setDraft(text)
+      submitted = true
+      input.submit()
+      return { status: 'submitted', legacyOk: true }
+    } catch { return { status: submitted ? 'unknown' : 'unavailable', legacyOk: false } }
   }
+
+  const remote = ctx.get('remote.session') as { prompt?: (req: unknown) => Promise<unknown> } | undefined
+  if (typeof remote?.prompt !== 'function') return httpTaskResult(id, text)
+  try {
+    const payload = { sessionId: id, mode: 'queue', content: [{ type: 'text', text }] }
+    const receipt = await remote.prompt(slotArg(payload))
+    return taskReceipt((receipt as { result?: unknown } | null)?.result ?? receipt)
+  } catch { return { status: 'unknown', legacyOk: false } }
 }
 
 /** 新建会话结果（ok=false 供调用方降级回当前对话注入）。 */
@@ -386,6 +436,11 @@ async function apiSessionCreate(cwd: string | undefined): Promise<string> {
  * @returns 是否受理
  */
 export async function apiSessionPrompt(sessionId: string, text: string): Promise<boolean> {
+  return (await httpTaskResult(sessionId, text)).legacyOk
+}
+
+/** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns HTTP receipt evidence; errors after request entry are never safe rejection. */
+async function httpTaskResult(sessionId: string, text: string): Promise<TaskSendResult> {
   try {
     const payload = { sessionId, mode: 'queue', content: [{ type: 'text', text }] }
     const res = await fetch(appUrl(SESSION_PROMPT_PATH), {
@@ -399,9 +454,9 @@ export async function apiSessionPrompt(sessionId: string, text: string): Promise
       }),
     })
     const json = await res.json().catch(() => null) as { result?: { ok?: boolean } } | null
-    return json?.result?.ok === true
+    return taskReceipt(json?.result)
   } catch {
-    return false
+    return { status: 'unknown', legacyOk: false }
   }
 }
 
@@ -466,8 +521,10 @@ export interface AddToConversation {
   appendText(sessionId: string | undefined, text: string): Promise<AddOutcome>
   /** 新建独立会话并切换（旁路任务隔离；失败 ok:false 供降级回当前对话）。 */
   startDraftSession(cwd?: string): Promise<DraftSessionResult>
-  /** 发送任务给目标会话 agent（点击即发送；失败 false 供降级）。 */
+  /** Historical compatibility result, not proof that a task was accepted. */
   sendTask(sessionId: string | undefined, text: string): Promise<boolean>
+  /** Optional on older injected facades; detailed callers must not infer acceptance from sendTask. */
+  sendTaskResult?(sessionId: string | undefined, text: string): Promise<TaskSendResult>
 }
 
 /**
@@ -640,32 +697,22 @@ export function createAddToConversation(ctx: CtxLike): AddToConversation {
   /**
    * 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
    * 新版持有目标 Controller 到 prompt 结束；旧版按能力选择唯一通道，不跨通道重发。
-   * @author ddj 2026年09月23号 / 2026年10月28号
+   * @author ddj 2026年10月29号
    * @param sessionId 目标会话 id
    * @param text 任务文本
-   * @returns 是否受理
+   * @returns 同一次调用的历史boolean语义，不能作为受理事实
    */
-  const sendTask: AddToConversation['sendTask'] = async (sessionId, text) => {
-    if (!sessionId) return false
+  const sendTask: AddToConversation['sendTask'] = async (sessionId, text) => (await sendTaskResult(sessionId, text)).legacyOk
+
+  /** @private @author ddj 2026年10月29号 @param sessionId Fixed target. @param text Task body. @returns Detailed evidence from exactly one selected transport. */
+  async function sendTaskResult(sessionId: string | undefined, text: string): Promise<TaskSendResult> {
+    if (!sessionId) return { status: 'unavailable', legacyOk: false }
     try {
       const sessions = ctx.get('sessions') as SessionBridge | undefined
       if (typeof sessions?.retain === 'function') return await sendOwned(ctx, sessions, sessionId, text)
-
-      // Legacy composer remains an exclusive channel; never overwrite the draft and then retry elsewhere.
-      const input = inputFor(ctx, sessionId) as { setDraft?: (task: string) => void; submit?: () => void } | undefined
-      if (typeof input?.setDraft === 'function' && typeof input.submit === 'function') {
-        input.setDraft(text)
-        input.submit()
-        return true
-      }
-      const remote = ctx.get('remote.session') as { prompt?: (req: unknown) => Promise<unknown> } | undefined
-      if (typeof remote?.prompt === 'function') {
-        const payload = { sessionId, mode: 'queue', content: [{ type: 'text', text }] }
-        return rpcOk(await remote.prompt(slotArg(payload))).ok
-      }
-      return await apiSessionPrompt(sessionId, text)
-    } catch { return false }
+      return await sendLegacy(ctx, sessionId, text)
+    } catch { return { status: 'unavailable', legacyOk: false } }
   }
 
-  return { appendReference, appendText, startDraftSession, sendTask }
+  return { appendReference, appendText, startDraftSession, sendTask, sendTaskResult }
 }

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

@@ -39,6 +39,7 @@ import type { ContextMenuEntry } from '../../ui/ContextMenu.js'
 import { SvnAiPlanDialog } from '../../ui/SvnAiPlanDialog.js'
 import { budgetGroupsOf } from './svnListBudget.js'
 import type { SidebarCtx } from '../types.js'
+import type { DraftSessionResult, TaskSendResult } from '../../addToConversation.js'
 
 /** 未分组条目的分组键（changelist 为空）。 */
 const NO_CHANGELIST = '（未分组）'
@@ -845,10 +846,9 @@ export function SvnPanel(props) {
 
   /**
    * 深度分析入口（02-deep-session-prompt 修正版）：**新建独立会话**承载任务
-   * （不污染当前对话），草稿箱填入分析任务（变更清单由 agent 自跑只读 svn status
-   * 取数，prompt 定长）→ 用户在新会话发送 → agent 投递方案回面板收件箱。
-   * 降级：不支持自动新建会话时回落当前对话注入 + notify 注明。
-   * @author ddj 2026年09月23号
+   * （不污染当前对话），显式受理才等待方案；不明回执不重发或填入另一草稿。
+   * 未发送或明确拒绝时仅填当前草稿，提示用户手动发送，prompt使用实际草稿会话。
+   * @author ddj 2026年10月29号
    */
   const runDeepPlan = React.useCallback(() => {
     const live = ctxRef.current
@@ -858,34 +858,42 @@ export function SvnPanel(props) {
     const since = Date.now()
     const add = live?.addToConversation
     if (!add?.appendText) { live?.notify?.('无法填入任务（无会话或输入框不可用）'); return }
-    /** 降级：当前对话注入（不支持自动新建会话时兜底）。 */
-    const degrade = (prompt) => {
-      void add.appendText(sessionId, prompt).then((outcome) => {
-        if (outcome === 'ok' || outcome === 'busy') {
-          live?.notify?.('已填入当前对话（降级），任务已自动发送，请在本对话查看')
-          startDeepPoll(since)
-        } else {
-          live?.notify?.('发起失败：' + (outcome === 'unavailable' ? '无会话或输入框不可用' : '输入框忙，请重试'))
-        }
-      })
+
+    /** @private @author ddj 2026年10月29号 @returns Draft insertion only; never submits or starts a task poll. */
+    async function draftCurrent(): Promise<void> {
+      if (!sessionId) { live?.notify?.('无法填入任务（无会话或输入框不可用）'); return }
+      try {
+        const outcome = await add.appendText(sessionId, buildAgentPrompt(wcRoot, sessionId))
+        if (outcome === 'ok' || outcome === 'busy') live?.notify?.('已填入当前草稿，请手动发送')
+        else live?.notify?.('发起失败：' + (outcome === 'unavailable' ? '无会话或输入框不可用' : '输入框忙，请重试'))
+      } catch { live?.notify?.('草稿填入失败，请检查当前输入框') }
     }
-    /** 统一收尾（点击即发送方案）：create 后构建 prompt（内嵌新会话 id）→ 发送任务。 */
-    const sendAndWatch = (id) => {
-      const prompt = buildAgentPrompt(wcRoot, id || sessionId || '')
-      if (!id || typeof add.sendTask !== 'function') { degrade(prompt); return }
-      void add.sendTask(id, prompt).then((sent) => {
-        if (sent) {
-          live?.notify?.('已在新会话「AI 深度分析」发起任务并自动发送，请在左侧会话列表点开查看进度')
-          startDeepPoll(since)
-        } else {
-          degrade(prompt)
-        }
-      })
+    /** @private @author ddj 2026年10月29号 @param id Created target. @returns One detailed send decision; ambiguous receipts never retry. */
+    async function sendAndWatch(id): Promise<void> {
+      if (!id) { await draftCurrent(); return }
+      if (typeof add.sendTaskResult !== 'function') {
+        live?.notify?.('发送接口不支持受理确认，本次未自动发送，请手动处理')
+        return
+      }
+      let result: TaskSendResult | undefined
+      try { result = await add.sendTaskResult(id, buildAgentPrompt(wcRoot, id)) }
+      catch { result = { status: 'unknown', legacyOk: false } }
+      if (result?.status === 'accepted') {
+        live?.notify?.('已在新会话「AI 深度分析」受理任务，请在左侧会话列表点开查看进度')
+        startDeepPoll(since)
+      } else if (result?.status === 'rejected' || result?.status === 'unavailable') await draftCurrent()
+      else if (result?.status === 'cancelled') live?.notify?.('发送操作已取消，任务可能已提交，请检查目标会话：' + id)
+      else if (result?.status === 'submitted') live?.notify?.('已调用提交但受理未确认，请检查目标会话，不要重复发送：' + id)
+      else live?.notify?.('任务受理未确认，请检查目标会话，不要重复发送：' + id)
+    }
+    /** @private @author ddj 2026年10月29号 @returns Creates a target before sending; creation failure can only insert a manual draft. */
+    async function beginDeep(): Promise<void> {
+      let result: DraftSessionResult | undefined
+      try { result = await add.startDraftSession?.(wcRoot || undefined) }
+      catch { result = { ok: false } }
+      await sendAndWatch(result?.ok ? result.id : undefined)
     }
-    void (add.startDraftSession
-      ? add.startDraftSession(wcRoot || undefined)
-      : Promise.resolve({ ok: false })
-    ).then((result) => { sendAndWatch(result?.ok ? result.id : undefined) })
+    void beginDeep()
   }, [aiBusy, aiRun, deepWaiting, entries, sessionId, startDeepPoll])
 
   // --endregion

package/src/client/state/diffSummary.ts

@@ -1,10 +1,17 @@
 /** Source-aware metadata projection; official patches never become legacy hunks. @author ddj 2026年10月26号 */
+import { PENDING_PREFIX } from '../../shared/pendingReview.js'
 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 DiffFile extends FileSummary {
+  sourceKind: 'official' | 'legacy' | 'pending'
+  /** 待审行的增删行数；官方汇总行可能缺省。 */
+  added?: number
+  /** 待审行的删除行数。 */
+  deleted?: number
+}
 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. */
@@ -20,10 +27,42 @@ export function officialPath(path: string, page: ReviewPage | null): boolean {
   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. */
+/**
+ * @author ddj 2026年10月30号
+ * @description: 取出本页待审条目（id 带待审前缀）并折算成文件行。
+ * @param page 审查页
+ * @returns 待审文件行与它们覆盖的路径键
+ */
+function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Set<string> } {
+  const rows: DiffFile[] = []
+  const covered = new Set<string>()
+  for (const item of page?.items ?? []) {
+    if (!item.id.startsWith(PENDING_PREFIX)) continue
+    const path = item.currentPath || item.path
+    covered.add(diffPathKey(path))
+    rows.push({
+      path,
+      label: item.display || path,
+      recs: [],
+      pending: item.decision === 'pending' ? 1 : 0,
+      added: item.added,
+      deleted: item.deleted,
+      sourceKind: 'pending',
+    })
+  }
+  return { rows, covered }
+}
+
+/** @public @author ddj 2026年10月26号 @param records Tool-call history. @param page Official file navigation, never only its first 50 rows. @returns Pending first, then official; 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: [] }))
+  const pending = pendingRowsOf(page)
+  // 同一路径只留一个权威：待审接管后，官方汇总行与历史留痕行都让位。
+  const legacy = summarize(records.filter((record) => !pending.covered.has(diffPathKey(record.path)) && !officialPath(record.path, page)))
+  const files: DiffFile[] = [...pending.rows]
+  for (const file of page?.overview?.files ?? []) {
+    if (pending.covered.has(diffPathKey(file.path))) continue
+    files.push({ ...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/ui/DiffLauncher.ts

@@ -106,7 +106,7 @@ export function DiffLauncher(props) {
   }, [tab, sessionId, source])
 
   let body
-  const legacyFiles = sum.pendingFiles.filter((file) => file.sourceKind !== 'official')
+  const legacyFiles = sum.pendingFiles.filter((file) => file.sourceKind === 'legacy')
   if (source === 'official') {
     body = React.createElement(React.Fragment, null,
       React.createElement('div', { className: 'edrv-search-empty' }, '官方轮次净差异 · 原始历史只读；编辑按钮打开当前文件，保存不代表已审。'),

package/src/client/ui/EditorView.ts

@@ -26,6 +26,7 @@ import { subscribeReview, refreshReview } from '../state/reviewFeed.js'
 import { runReviewBatch } from '../reviewBatch.js'
 import { ReviewAllConfirm } from './ReviewAllConfirm.js'
 import { reviewRegions } from '../../shared/reviewRegions.js'
+import { PENDING_PREFIX } from '../../shared/pendingReview.js'
 import { diffSummary, officialPath } from '../state/diffSummary.js'
 import { emitFileChanged, emitRefresh } from '../events.js'
 import { langOf, loadMonaco, snippetLanguageOf } from '../monaco/loader.js'
@@ -579,7 +580,15 @@ export function EditorView(props) {
   }, [sessionId, active, selectedReview])
   React.useEffect(() => {
     const controller = new AbortController()
-    if (!active || !review.page?.overview?.coveredPaths.some((path) => sameFile(path, active))) {
+    // 待审条目也走同一条行内差异通道：它由累计基线投影而来，形状与官方条目一致，
+    // 因此编辑器里天然就能画行内差异与 Keep/Undo 药丸，不必另开一个窄面板。
+    const pendingPath = (review.page?.items ?? [])
+      .filter((item) => String(item.id).startsWith(PENDING_PREFIX))
+      .map((item) => item.currentPath || item.path)
+      .find((path) => sameFile(path, active))
+    const coveredPath = review.page?.overview?.coveredPaths.find((path) => sameFile(path, active))
+    const reviewPath = coveredPath ?? pendingPath
+    if (!active || !reviewPath) {
       setOfficialDetail(null)
       setOfficialRecords([])
       return () => controller.abort()
@@ -588,7 +597,6 @@ export function EditorView(props) {
     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)

package/src/client/ui/OfficialDiffBar.tsx

@@ -1,7 +1,6 @@
 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'
 import { reviewBarView } from '../reviewBar.js'
 import { ReviewAllRow } from './reviewAllRow.js'
 
@@ -55,11 +54,9 @@ export function barIcon(mark: Mark): React.ReactElement {
 /** @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 [menu, setMenu] = React.useState<'more' | null>(null)
   const name = String(props.activePath || '').split(/[\\/]/).pop() || '当前文件'
   const detail = official.detail
-  const records = official.records ?? []
   const count = pendingRegions.length
   const view = reviewBarView({ jumps: count, stale: staleRegions.length, index: diffIdx, ready: props.contentReady === true,
     pendingRecords: official.pending, canKeep: detail?.capability.keep === true,
@@ -67,8 +64,6 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
 
   /** @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. @param title Hover reason, defaults to the label. @returns Compact keyboard-focusable navigation control. */
@@ -76,9 +71,6 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
     return <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label={label} title={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="文件差异审查">
@@ -99,7 +91,6 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
       <span className="edrv-review-filemark">{barIcon('file')}</span>
       <span className="edrv-review-filename" title={props.activePath}>{name}</span>
       <span className="edrv-review-pending" title={view.pendingTitle}>待审 <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="文件导航">
@@ -114,12 +105,10 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
       <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={detail?.capability.keep ? view.keepHint : detail?.capability.reason}>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 && view.notice ? <div className={view.noticeTone === 'warn' ? 'edrv-review-notice edrv-review-notice-warn' : 'edrv-review-notice'} role="status">{view.notice}</div> : null}
     {props.reviewError ? <div className={props.reviewErrorTone === 'info' ? 'edrv-review-notice' : 'edrv-review-notice edrv-review-error'} role={props.reviewErrorTone === 'info' ? 'status' : '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

@@ -3,6 +3,7 @@ import React from 'react'
 import { rpc } from '../rpc.js'
 import { openEditorView } from '../events.js'
 import { refreshReview } from '../state/reviewFeed.js'
+import { PENDING_PREFIX } from '../../shared/pendingReview.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. */
@@ -37,18 +38,27 @@ export function ReviewLedger(props: { sessionId: string; first: ReviewPage | nul
       else setError(result.error)
     } catch (cause) { if (!controller.signal.aborted) setError(String(cause)) }
   }
+  const gaps = page?.gaps ?? []
   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 ? '' : '（已被同轮新版本替换）'}`))),
+      title: item.currentPath || item.path,
+      style: { display: 'block', width: '100%', textAlign: 'left', padding: '6px 4px', whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis' },
+    }, item.id.startsWith(PENDING_PREFIX)
+      ? `【待审】${item.display}  +${item.added} −${item.deleted} · ${item.decision}${item.kind === 'oversized' ? ' · 过大' : ''}`
+      : `轮次 ${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,
+    // 采集缺口是诊断信息，排在条目之后折叠起来：放最前面会把真正要点的待审条目挤出可视区。
+    gaps.length
+      ? h('details', { key: 'gaps', style: { marginTop: 6 } },
+        h('summary', { style: { cursor: 'pointer', fontSize: 11 } }, `采集不完整 ${gaps.length} 条（诊断信息）`),
+        gaps.map((gap) => h('div', { key: `${gap.sessionId}:${gap.seq}`, role: 'status', style: { fontSize: 11 } }, `轮次 ${gap.turn} 采集不完整：${gap.error}`)))
+      : null,
     detail ? h(PatchDetail, { key: detail.item.id, sessionId: props.sessionId, detail, onChanged: () => { setDetail(null); refreshReview(props.sessionId) } }) : null)
 }
 

package/src/client/ui/SidecarDiffBar.tsx

@@ -62,7 +62,6 @@ export interface SidecarBarProps {
 export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
   const pendingRegions = props.pendingRegions ?? []
   const staleRegions = props.staleRegions ?? []
-  const [expanded, setExpanded] = React.useState(false)
   const [menu, setMenu] = React.useState<'more' | null>(null)
   const name = String(props.activePath || '').split(/[\\/]/).pop() || '当前文件'
   const count = pendingRegions.length
@@ -85,25 +84,6 @@ export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
 
   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>
 
-  const body = expanded
-    ? <div className="edrv-review-body">
-        {pendingRegions.map((region) => {
-          const key = callIdAttr(region.callId, region.idx)
-          return <div key={key} className="edrv-diffrow" data-edrv-hunk={key} title={'跳转到 L' + (region.start ?? '?')} onClick={() => props.onJump?.(region)}>
-            <span className="edrv-diffrow-l">{'L' + (region.start ?? '?') + '-' + (region.end ?? '?')}</span>
-            {(region.oldLines?.length ?? 0) > 0 ? <span className="edrv-diffrow-o">{'-' + (region.oldLines?.length ?? 0)}</span> : null}
-            {(region.newLines?.length ?? 0) > 0 ? <span className="edrv-diffrow-n">{'+' + (region.newLines?.length ?? 0)}</span> : null}
-            {region.create ? <span className="edrv-diffrow-tag">新建</span> : null}
-          </div>
-        })}
-        {staleRegions.map((region) => <div key={'stale' + callIdAttr(region.callId, region.idx)} className="edrv-diffrow edrv-diffrow-stale" title="差异无法定位（文件可能已被手动修改）">
-          <span className="edrv-diffrow-l">{'L' + (region.start ?? '?') + ' 无法定位'}</span>
-          <span className="edrv-diffrow-tag">冲突/需刷新</span>
-          <span className="edrv-diffrow-tag">{badgeOf(region.status ?? '')}</span>
-        </div>)}
-      </div>
-    : null
-
   return <div className="edrv-diffbar edrv-diffbar-dock edrv-reviewbar" data-edrv-diffbox="1" data-edrv-diff-source="sidecar" role="region" aria-label="文件差异审查">
     <ReviewAllRow
       total={props.fileTotal ?? 0}
@@ -141,7 +121,6 @@ export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
       <div className="edrv-review-actions">
         <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={!canDecide} title={props.missingDeletion ? '恢复展示的完整历史快照（不会覆盖重新出现的文件）' : SIDECAR_UNDO_TITLE}>Undo</Button>
         <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={!canDecide} title={props.missingDeletion ? '保持文件删除并结清覆盖的待审历史记录，不写文件' : SIDECAR_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: '归档 / 历史' }, { id: 'rollback', label: '回滚当前文件' }, { id: 'refresh', label: '刷新' }]} onSelect={(id: string) => {
           if (id === 'rollback') { setMenu(null); props.onRollback?.(); return }
           if (id === 'refresh') { setMenu(null); props.onRefresh?.(); return }
@@ -151,6 +130,5 @@ export function SidecarDiffBar(props: SidecarBarProps): React.ReactElement {
     </div>
     {view.notice ? <div className={view.noticeTone === 'warn' ? 'edrv-review-notice edrv-review-notice-warn' : 'edrv-review-notice'} role="status">{view.notice}</div> : null}
     {props.reviewError ? <div className={props.reviewErrorTone === 'info' ? 'edrv-review-notice' : 'edrv-review-notice edrv-review-error'} role={props.reviewErrorTone === 'info' ? 'status' : 'alert'}>{props.reviewError}</div> : null}
-    {body}
   </div>
 }

package/src/index.ts

@@ -3,6 +3,9 @@ import { registerRoutes } from './routes.js'
 import { captureToolResult } from './capture.js'
 import { installCapture } from './officialCapture.js'
 import { installEvidence } from './reviewCapture.js'
+import { installPendingCapture } from './pending/capture.js'
+import { recordWrite } from './pending/store.js'
+import { trackPendingCover } from './pendingCompat.js'
 import { closeArchiveDbs } from './archiveDb.js'
 import { handleRpc, integrationBaseUrlOf } from './rpc.js'
 import { newSearcher } from './search/orchestrator.js'
@@ -71,6 +74,11 @@ function createRuntime(ctx: Ctx, config: unknown) {
 function attachRuntime(ctx: Ctx, runtime: Runtime): void {
   const evidence = installEvidence(ctx)
   const stopCapture = installCapture(ctx, (cwd, snapshot) => { evidence.persist(cwd, snapshot); return true })
+  // 待审累计基线：只有写后内容确实变化才落库，异常一律不打断用户工具调用
+  const pending = installPendingCapture(ctx, (write) => {
+    try { trackPendingCover(write.cwd, write.path, true) } catch { /* 内存登记失败不阻断采集 */ }
+    try { recordWrite(write) } catch (error) { log.warn('待审差异落库失败：' + String(error)) }
+  })
   /** @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)
@@ -90,6 +98,7 @@ function attachRuntime(ctx: Ctx, runtime: Runtime): void {
   async function cleanup(): Promise<void> {
     await stopCapture()
     evidence.dispose()
+    pending.dispose()
     runtime.fileVersions.dispose()
     closeArchiveDbs()
     disposeAllServers()