dsh-vscode-mode 0.20.1 → 0.20.3

package/package.json

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

@@ -2,11 +2,16 @@
 import { rpc } from './rpc.js'
 import type { McpSessionStatus } from '../shared/mcp.js'
 
-export interface SessionMcpView { status?: McpSessionStatus; stale: boolean }
+export interface SessionMcpView {
+  status?: McpSessionStatus
+  stale: boolean
+  /** Query lifecycle only; never a connection failure classification. */
+  reason?: 'pending' | 'paused' | 'unavailable'
+  /** Browser receipt time of the last accepted snapshot, in epoch milliseconds. */
+  observedAt?: number
+}
 type Snapshot = { sessions: McpSessionStatus[]; sampledAt: number }
 type FetchStatus = (signal: AbortSignal) => Promise<Snapshot>
-const unavailable: SessionMcpView = { stale: true }
-const inactive: SessionMcpView = { stale: false }
 
 /** One poller for all mounted row/hover consumers; never retains or activates sessions. */
 export class McpSessionState {
@@ -15,14 +20,14 @@ export class McpSessionState {
   private timer?: ReturnType<typeof setTimeout>
   private request?: AbortController
   private epoch = 0
-  private stale = true
+  private fallback: SessionMcpView = { stale: true, reason: 'pending' }
   private disposed = false
 
   /** @public @author ddj 2026年10月20号 @param fetchStatus Authenticated read-only query. @param page Visibility boundary, omitted for server tests. */
   constructor(private readonly fetchStatus: FetchStatus, private readonly page?: Document) {}
 
   /** @public @author ddj 2026年10月20号 @param sessionId Row identity. @returns Stable view until the next observation. */
-  get(sessionId: string): SessionMcpView { return this.views.get(sessionId) ?? (this.stale ? unavailable : inactive) }
+  get(sessionId: string): SessionMcpView { return this.views.get(sessionId) ?? this.fallback }
 
   /** @public @author ddj 2026年10月20号 @param sessionId Row identity. @param listener React invalidation. @returns Idempotent unsubscribe; the last consumer stops polling. */
   subscribe(sessionId: string, listener: () => void): () => void {
@@ -33,7 +38,8 @@ export class McpSessionState {
     this.listeners.set(sessionId, listeners)
     if (first) {
       this.page?.addEventListener('visibilitychange', this.visibility)
-      void this.poll()
+      if (this.page?.hidden) this.markStale('paused')
+      else void this.poll()
     }
     return () => {
       listeners.delete(listener)
@@ -54,7 +60,7 @@ export class McpSessionState {
     clearTimeout(this.timer)
     this.timer = undefined
     this.request?.abort()
-    this.publish(undefined)
+    this.markStale('paused')
   }
 
   /** @private @author ddj 2026年10月20号 Cleans listener lifetime as well as timers. */
@@ -66,32 +72,53 @@ export class McpSessionState {
   /** @public @author ddj 2026年10月20号 Permanently disposes HMR-owned polling. */
   dispose(): void { this.disposed = true; this.pause(); this.listeners.clear(); this.views.clear() }
 
-  /** @private @author ddj 2026年10月20号 @param snapshot Fresh ledger, or undefined to mark all previous observations stale. */
-  private publish(snapshot?: Snapshot): void {
-    this.stale = snapshot === undefined
-    if (snapshot) this.views = new Map(snapshot.sessions.map((status) => [status.sessionId, { status, stale: false }]))
-    else for (const [id, view] of this.views) this.views.set(id, { ...view, stale: true })
+  /** @private @author ddj 2026年10月27号 @param snapshot Fresh ledger. Records browser receipt time without changing the host protocol. */
+  private publish(snapshot: Snapshot): void {
+    const observedAt = Date.now()
+    this.fallback = { stale: false, observedAt }
+    this.views = new Map(snapshot.sessions.map((status) => [status.sessionId, { status, stale: false, observedAt }]))
+    this.notify()
+  }
+
+  /** @private @author ddj 2026年10月27号 @param reason Query lifecycle, never a claim about connection health. Preserves stable references for unchanged observations. */
+  private markStale(reason: NonNullable<SessionMcpView['reason']>): void {
+    if (this.fallback.stale && this.fallback.reason === reason) return
+    this.fallback = { ...this.fallback, stale: true, reason }
+    for (const [id, view] of this.views) this.views.set(id, { ...view, stale: true, reason })
+    this.notify()
+  }
+
+  /** @private @author ddj 2026年10月27号 Notifies mounted row and hover consumers after an observation changes. */
+  private notify(): void {
     for (const listeners of this.listeners.values()) for (const listener of listeners) listener()
   }
 
   /** @private @author ddj 2026年10月20号 Queries once, with a 10-second deadline and a 2.5-second gap after settlement. */
   private async poll(): Promise<void> {
     if (this.disposed || this.request || !this.listeners.size || this.page?.hidden) return
+    clearTimeout(this.timer)
+    this.timer = undefined
+    if (this.fallback.reason === 'paused') this.markStale('pending')
+
     const request = new AbortController()
     const epoch = this.epoch
     this.request = request
     /** @author ddj 2026年10月20号 Marks overdue responses unusable even if a transport ignores cancellation. */
-    const expire = (): void => { request.abort(); if (epoch === this.epoch) this.publish(undefined) }
+    const expire = (): void => { request.abort(); if (epoch === this.epoch) this.markStale('unavailable') }
     const deadline = setTimeout(expire, 10000)
     try {
       const snapshot = await this.fetchStatus(request.signal)
       if (epoch === this.epoch && !request.signal.aborted) this.publish(snapshot)
     } catch {
-      if (epoch === this.epoch) this.publish(undefined)
+      if (epoch === this.epoch) this.markStale('unavailable')
     } finally {
       clearTimeout(deadline)
       this.request = undefined
-      if (!this.disposed && this.listeners.size && !this.page?.hidden) this.timer = setTimeout(() => { void this.poll() }, 2500)
+      // A visibility/subscription change resumes promptly, but only after the old transport settles.
+      if (!this.disposed && this.listeners.size && !this.page?.hidden) {
+        const delay = epoch === this.epoch ? 2500 : 0
+        this.timer = setTimeout(() => { void this.poll() }, delay)
+      }
     }
   }
 }

package/src/client/reviewBar.ts

@@ -0,0 +1,85 @@
+/**
+ * 官方差异栏派生视图：位置、导航提示、失效说明与 Keep 提示的唯一来源。
+ * 计数口径分离：待审是「记录数」，可跳转是「块数」，两者不同源，
+ * 全部块失效时必须给出可操作叙事，不能只留一句「无法定位」。
+ * 作者 ddj 2026年10月27号
+ */
+
+/** 官方差异栏输入：全部来自 EditorView dock 快照，不读取磁盘或 RPC。 */
+export interface ReviewBarInput {
+  /** 可定位（非 stale）的差异块数 */
+  jumps: number
+  /** 无法定位的历史差异块数 */
+  stale: number
+  /** 当前差异块索引（0 基） */
+  index: number
+  /** 编辑器内容是否已就绪；未就绪时不得断言差异失效 */
+  ready: boolean
+  /** 当前文件的官方待审记录数 */
+  pendingRecords: number
+  /** 当前记录是否可 Keep（detail.capability.keep） */
+  canKeep: boolean
+}
+
+/** 官方差异栏派生文案；调用方只负责渲染，不再自行拼装计数与提示。 */
+export interface ReviewBarView {
+  /** 差异位置文案，如 `2 / 6`、`无可跳转`、`载入中` */
+  position: string
+  /** 上一个差异按钮提示（兼作禁用原因） */
+  navPrevTitle: string
+  /** 下一个差异按钮提示（兼作禁用原因） */
+  navNextTitle: string
+  /** 失效说明，空串表示不显示 */
+  notice: string
+  /** 说明级别：warn 表示需要用户决策 */
+  noticeTone: 'info' | 'warn'
+  /** Keep 按钮提示 */
+  keepHint: string
+  /** 待审计数提示 */
+  pendingTitle: string
+}
+
+/** @private @author ddj 2026年10月27号 @param value 任意计数输入 @returns 非负整数，NaN/负数/非数字归零 */
+function safeCount(value: unknown): number {
+  const parsed = Number(value)
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0
+}
+
+/** @private @author ddj 2026年10月27号 @returns 无差异可跳转时的 Keep 提示 */
+function fullStaleKeepHint(): string {
+  return '保留该记录的全部改动并结案：这些改动已不在文件中，记录将被标记为已采纳（不改写磁盘）'
+}
+
+/**
+ * 派生差异栏文案。
+ * @public
+ * @author ddj 2026年10月27号
+ * @param input 差异计数、就绪状态与 Keep 能力
+ * @returns 栏内位置、导航提示与失效说明
+ */
+export function reviewBarView(input: ReviewBarInput): ReviewBarView {
+  const jumps = safeCount(input.jumps)
+  const stale = safeCount(input.stale)
+  const index = safeCount(input.index)
+  const pendingTitle = `${safeCount(input.pendingRecords)} 条官方待审记录` + (input.ready ? `，本文件可跳转 ${jumps} 处` : '')
+  const keepHint = jumps === 0 && stale > 0 && input.canKeep ? fullStaleKeepHint() : '保留当前记录的未处理修改'
+
+  // 载入期所有块天然 stale，此时只能报告进度，不能断言改动已失效。
+  if (input.ready !== true) {
+    return { position: '载入中', navPrevTitle: '文件载入中', navNextTitle: '文件载入中', notice: '', noticeTone: 'info', keepHint, pendingTitle }
+  }
+
+  if (jumps > 0) {
+    const at = Math.min(index + 1, jumps)
+    const notice = stale > 0 ? `${stale} 处历史差异无法定位（其余 ${jumps} 处可跳转），展开详情查看原始增删。` : ''
+    return { position: `${at} / ${jumps}`, navPrevTitle: '上一个差异', navNextTitle: '下一个差异', notice, noticeTone: 'info', keepHint, pendingTitle }
+  }
+
+  if (stale > 0) {
+    const reason = '该记录的改动已不在当前文件中，无可跳转差异'
+    const notice = `本记录 ${stale} 处改动均已不在当前文件中（被后续编辑覆盖或已撤销）；可点 Keep 结案（只标记已采纳，不改写磁盘），或展开详情核对原始增删。`
+    return { position: '无可跳转', navPrevTitle: reason, navNextTitle: reason, notice, noticeTone: 'warn', keepHint, pendingTitle }
+  }
+
+  return { position: '—', navPrevTitle: '当前文件没有可定位差异', navNextTitle: '当前文件没有可定位差异', notice: '', noticeTone: 'info', keepHint, pendingTitle }
+}

package/src/client/sessionError.ts

@@ -36,3 +36,15 @@ export function sessionMissingDetail(): string {
   return '该会话可能正被其他 DSH 实例（桌面端 / Web 端）占用，或尚未在当前实例激活。' +
     '请在持有该会话的一端查看，或在本端打开该会话后重试。'
 }
+
+/**
+ * 把任意错误文本归一为可展示文案：会话缺失类替换为终态提示，其余原样返回。
+ * 差异栏等狭窄区域共用，避免裸「会话不存在」与业务提示混排。
+ * @author ddj 2026年10月27号
+ * @param text 任意错误文本（host 业务 error、异常 message 等原始形态）
+ * @returns 会话缺失为「标题：详情」，其他错误为原文本，空值返回空串
+ */
+export function sessionErrorText(text: unknown): string {
+  if (isSessionMissingError(text)) return sessionMissingTitle() + '：' + sessionMissingDetail()
+  return String(text ?? '')
+}

package/src/client/styles/editor.css

@@ -304,6 +304,7 @@
 [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-notice-warn { color: var(--dsw-alias-state-warning-primary, #a86a1f); }
 [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; }

package/src/client/ui/EditorView.ts

@@ -24,6 +24,7 @@ import { dbg, isDebug, rpc } from '../rpc.js'
 import { refreshFeed, subscribeErrors, subscribeRecords } from '../state/recordsFeed.js'
 import { subscribeReview, refreshReview } from '../state/reviewFeed.js'
 import { runReviewBatch } from '../reviewBatch.js'
+import { ReviewAllConfirm } from './ReviewAllConfirm.js'
 import { reviewRegions } from '../../shared/reviewRegions.js'
 import { diffSummary, officialPath } from '../state/diffSummary.js'
 import { emitFileChanged, emitRefresh } from '../events.js'
@@ -126,7 +127,10 @@ import { buildBpMenu } from '../dap/bpMenu.js'
 import { clampToolbarPosition, loadToolbarPosition, saveToolbarPosition } from '../dap/toolbarDrag.js'
 import { editorModelPathOf } from '../dap/modelPath.js'
 import { dapTrace } from '../dap/trace.js'
-import { isSessionMissingError, sessionMissingDetail, sessionMissingTitle } from '../sessionError.js'
+import { isSessionMissingError, sessionErrorText, sessionMissingDetail, sessionMissingTitle } from '../sessionError.js'
+
+/** 官方差异读取失败前缀：仅用于清理同源陈旧错误，不吞并保存类错误。@author ddj 2026年10月27号 */
+const REVIEW_LOAD_ERROR = '官方差异读取失败：'
 
 /**
  * 只在 Lua 注解类型槽开启注释自动建议；跨文件/离开类型槽立即恢复默认。
@@ -445,6 +449,7 @@ export function EditorView(props) {
   const hoverPanelRef = React.useRef(false) // 鼠标是否已进入 Keep/Undo 浮层
   const batchBusyRef = React.useRef(false) // 批量 Keep All/Undo All 防重入
   const [reviewBatchBusy, setReviewBatchBusy] = React.useState(false)
+  const [reviewAllPrompt, setReviewAllPrompt] = React.useState(null)
   const reviewLifeRef = React.useRef(null)
   React.useEffect(() => {
     const token = { live: true }
@@ -586,7 +591,9 @@ export function EditorView(props) {
         if (!result.ok) throw new Error(result.error)
         setOfficialRecords((previous) => JSON.stringify(previous) === JSON.stringify(page.page.items) ? previous : page.page.items)
         setOfficialDetail((previous) => JSON.stringify(previous) === JSON.stringify(result.detail) ? previous : result.detail)
-      } catch (cause) { if (!controller.signal.aborted) setError('官方差异读取失败：' + String(cause)) }
+        // 读取成功后清除同源陈旧错误，避免会话恢复后仍挂着上一次失败提示。
+        setError((previous) => (typeof previous === 'string' && previous.startsWith(REVIEW_LOAD_ERROR) ? null : previous))
+      } catch (cause) { if (!controller.signal.aborted) setError(REVIEW_LOAD_ERROR + String(cause)) }
     }
     void loadReview()
     return () => controller.abort()
@@ -3272,9 +3279,7 @@ export function EditorView(props) {
   async function actReviewAll(reject) {
     if (batchBusyRef.current) return
     if (!review.page?.overview) { setError('官方待审列表尚未就绪，未执行批量操作'); return }
-    const count = sum.pendingFiles.length
-    if (!count) return
-    if (!window.confirm(`${reject ? 'Undo All' : 'Keep All'}：处理当前工作区全部 ${count} 个待审差异文件（含其他轮次）？${reject ? '\n撤销会改写磁盘；逐项安全校验，遇到冲突停止，已完成项不会自动恢复。' : '\n只标记待审修改为保留，不改写文件。'}`)) return
+    if (!sum.pendingFiles.length) return
     const token = reviewLifeRef.current
     const undoPath = activeRef.current
     const undoModel = editorRef.current?.getModel?.()
@@ -3301,8 +3306,28 @@ export function EditorView(props) {
     } catch (cause) { if (token?.live) setError(String(cause)) }
     finally { batchBusyRef.current = false; if (token?.live) setReviewBatchBusy(false) }
   }
-  const acceptAllFiles = () => actReviewAll(false)
-  const undoAllFiles = () => actReviewAll(true)
+  /** @private @author ddj 2026年10月27号 @param reject Whether to undo pending files. @description Open a DSH confirmation without starting any mutations. */
+  function askReviewAll(reject) {
+    if (batchBusyRef.current || !sum.pendingFiles.length) return
+    if (!review.page?.overview) { setError('官方待审列表尚未就绪，未执行批量操作'); return }
+    setReviewAllPrompt({ reject, count: sum.pendingFiles.length, token: reviewLifeRef.current })
+  }
+
+  /** @private @author ddj 2026年10月27号 @description Dismiss the pending confirmation without changing review state. */
+  function cancelReviewAll() {
+    setReviewAllPrompt(null)
+  }
+
+  /** @private @author ddj 2026年10月27号 @description Confirm only within the session lifetime that opened the modal. @returns The guarded batch operation, if still valid. */
+  function confirmReviewAll() {
+    const prompt = reviewAllPrompt
+    setReviewAllPrompt(null)
+    if (!prompt?.token?.live || prompt.token !== reviewLifeRef.current) return
+    return actReviewAll(prompt.reject)
+  }
+
+  const acceptAllFiles = () => askReviewAll(false)
+  const undoAllFiles = () => askReviewAll(true)
   const rollbackFile = () => {
     if (!active) return
     if (!window.confirm('回滚当前文件到修改前状态？（相关差异将归档）')) return
@@ -4462,12 +4487,13 @@ export function EditorView(props) {
    * @returns 含布局及操作回调的差异快照
    */
   const officialFile = review.page?.overview?.coveredPaths.find((path) => sameFile(path, active))
+  const rawReviewError = review.error || error
   const buildDockSnapshot = () => ({
     mode: editorDockMode(active),
     official: officialFile ? { sessionId, page: review.page, path: officialFile,
       pending: sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0,
       detail: officialDetail, records: officialRecords, onSelect: setSelectedReview } : null,
-    reviewError: review.error || error,
+    reviewError: rawReviewError ? sessionErrorText(rawReviewError) : undefined,
     layout,
     pendingRegions,
     staleRegions,
@@ -4487,6 +4513,7 @@ export function EditorView(props) {
     onRefresh: reloadFile,
     activePath: active,
     diffIdx: contentReady ? diffIdx : 0,
+    contentReady,
     diffTotal: displayDiffTotal(contentReady, pendingRegions.length, sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0),
     fileIdx,
     fileTotal: sum.pendingFiles.length,
@@ -5015,5 +5042,11 @@ export function EditorView(props) {
         snippetPickerEl,
         dapBpMenuEl,
         dapBpEditEl)
-  return rootEl
+  const reviewAllEl = reviewAllPrompt?.token?.live && reviewAllPrompt.token === reviewLifeRef.current
+    ? React.createElement(ReviewAllConfirm, {
+        reject: reviewAllPrompt.reject, count: reviewAllPrompt.count,
+        onCancel: cancelReviewAll, onConfirm: confirmReviewAll,
+      })
+    : null
+  return React.createElement(React.Fragment, null, rootEl, reviewAllEl)
 }

package/src/client/ui/McpSessionStatus.ts

@@ -20,7 +20,7 @@ function useMcpView({ sessionId, store }: McpRowProps): SessionMcpView {
 
 /** @public @author ddj 2026年10月20号 @param view Current observation. @returns Accessible row label; steady states deliberately do not occupy the leading slot. */
 export function mcpRowLabel(view: SessionMcpView): string | undefined {
-  if (view.stale) return '项目 MCP 状态暂不可用（上次状态已过期）'
+  if (view.stale) return undefined
   if (!view.status || (!busy.has(view.status.phase) && view.status.phase !== 'error')) return undefined
   return '项目 MCP：' + labels[view.status.phase]
 }
@@ -30,7 +30,7 @@ export function McpSessionIcon(props: McpRowProps): React.ReactElement | null {
   const view = useMcpView(props)
   const label = mcpRowLabel(view)
   if (!label) return null
-  const warning = view.stale || view.status?.phase === 'error'
+  const warning = view.status?.phase === 'error'
   return React.createElement('span', {
     role: 'img', 'aria-label': label, title: label,
     style: { display: 'inline-flex', width: 16, height: 16, alignItems: 'center', justifyContent: 'center',
@@ -41,6 +41,13 @@ export function McpSessionIcon(props: McpRowProps): React.ReactElement | null {
 /** @private @author ddj 2026年10月20号 @param start Stage start. @param end Stage finish or local clock. @returns Human-readable elapsed time, without claiming a timeout. */
 function elapsed(start: number, end: number): string { return Math.max(0, (end - start) / 1000).toFixed(1) + ' 秒' }
 
+/** @private @author ddj 2026年10月27号 @param view Query observation. @returns Query-only explanation, separate from initialization health. */
+function queryMessage(view: SessionMcpView): string {
+  if (view.reason === 'paused') return '状态查询已暂停'
+  if (view.reason === 'pending') return '正在查询项目 MCP 状态'
+  return '状态查询暂不可用，不代表 MCP 初始化失败'
+}
+
 /** @public @author ddj 2026年10月20号 @param props Official hover sessionId and poller. @returns Project-only diagnostic detail, never transport credentials. */
 export function McpSessionDetail(props: McpRowProps): React.ReactElement {
   const view = useMcpView(props)
@@ -53,10 +60,18 @@ export function McpSessionDetail(props: McpRowProps): React.ReactElement {
   }, [status, view.stale])
 
   const children: React.ReactNode[] = [React.createElement('strong', { key: 'title' }, '项目 MCP')]
-  if (view.stale) children.push(React.createElement('div', { key: 'stale', role: 'status' }, '状态暂不可用；以下如有记录，为上次观测结果'))
-  if (!status) children.push(React.createElement('div', { key: 'empty' }, view.stale ? '等待状态查询' : '当前无活跃 MCP 实例'))
-  else {
-    const end = status.finishedAt ?? now
+  if (view.stale) {
+    children.push(React.createElement('div', { key: 'stale', role: 'status' }, queryMessage(view)))
+    if (status) children.push(React.createElement('div', { key: 'history' }, '以下为上次观测结果，不代表当前状态'))
+    if (view.observedAt !== undefined) children.push(React.createElement('div', { key: 'observed' },
+      '上次观测时间：' + new Date(view.observedAt).toLocaleString()))
+  }
+  if (!status && !view.stale) children.push(React.createElement('div', { key: 'empty' }, '当前无活跃 MCP 实例'))
+  if (status) {
+    // Unobserved time must not look like continued initialization, including per-server timing.
+    let observedNow = now
+    if (view.stale) observedNow = view.observedAt ?? status.phaseAt
+    const end = status.finishedAt ?? observedNow
     const completed = status.servers.filter((server) => server.phase === 'ready').length
     const slow = !view.stale && busy.has(status.phase) && now - status.phaseAt > 10000
     children.push(React.createElement('div', { key: 'phase' }, labels[status.phase], slow ? '（耗时较长，不代表失败）' : ''))
@@ -64,7 +79,7 @@ export function McpSessionDetail(props: McpRowProps): React.ReactElement {
     if (status.configMs !== undefined) children.push(React.createElement('div', { key: 'config' }, `配置准备 ${elapsed(0, status.configMs)}`))
     if (status.error) children.push(React.createElement('div', { key: 'error' }, status.error))
     for (const server of status.servers) children.push(React.createElement('div', { key: 'server:' + server.serverName },
-      `${server.serverName}：${labels[server.phase]}${server.reused ? ' · 复用已有连接' : ''}${server.phase === 'idle' ? '' : ' · ' + elapsed(server.startedAt, server.finishedAt ?? now)}`,
+      `${server.serverName}：${labels[server.phase]}${server.reused ? ' · 复用已有连接' : ''}${server.phase === 'idle' ? '' : ' · ' + elapsed(server.startedAt, server.finishedAt ?? observedNow)}`,
       server.queuedMs === undefined ? '' : ' · 排队 ' + elapsed(0, server.queuedMs),
       server.connectMs === undefined ? '' : ' · 初始化 ' + elapsed(0, server.connectMs),
       server.firstCallMs === undefined ? '' : ' · 首次工具执行 ' + elapsed(0, server.firstCallMs),

package/src/client/ui/OfficialDiffBar.tsx

@@ -2,6 +2,7 @@ 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'
 
 export interface OfficialBarProps {
   official: { sessionId: string; path: string; pending: number; detail?: ReviewDetail; records?: ReviewItem[]; page: ReviewPage; onSelect: (id: string) => void }
@@ -9,6 +10,8 @@ export interface OfficialBarProps {
   pendingRegions?: unknown[]
   staleRegions?: unknown[]
   diffIdx?: number
+  /** 编辑器内容是否就绪；未就绪时不得断言差异失效 */
+  contentReady?: boolean
   fileTotal?: number
   fileIdx?: number
   allPendingCount?: number
@@ -61,7 +64,8 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
   const detail = official.detail
   const records = official.records ?? []
   const count = pendingRegions.length
-  const position = count ? `${Math.min(diffIdx + 1, count)} / ${count}` : '—'
+  const view = reviewBarView({ jumps: count, stale: staleRegions.length, index: diffIdx, ready: props.contentReady === true,
+    pendingRecords: official.pending, canKeep: detail?.capability.keep === true })
 
   /** @private @author ddj 2026年10月27号 @returns Close current popup without changing selection. */
   function closeMenu(): void { setMenu(null) }
@@ -69,9 +73,9 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
   function selectRecord(id: string): void { official.onSelect(id); closeMenu() }
   /** @private @author ddj 2026年10月27号 @param tab Existing launcher tab. @returns Open existing overview, never create another review entry. */
   function openOverview(tab: string): void { props.onOpenLauncher(tab); closeMenu() }
-  /** @private @author ddj 2026年10月27号 @param mark Navigation icon. @param label Accessible action. @param action Existing callback. @param disabled Whether navigation is unavailable. @returns Compact keyboard-focusable navigation control. */
-  function navButton(mark: Mark, label: string, action: () => void, disabled: boolean): React.ReactElement {
-    return <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label={label} title={label} disabled={disabled} onClick={action}>{barIcon(mark)}</Button>
+  /** @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. */
+  function navButton(mark: Mark, label: string, action: () => void, disabled: boolean, title?: string): 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')}>
@@ -85,7 +89,7 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
     <div className="edrv-review-heading">
       <span className="edrv-review-filemark">{barIcon('file')}</span>
       <span className="edrv-review-filename" title={props.activePath}>{name}</span>
-      <span className="edrv-review-pending" title={`${official.pending} 条官方待审记录`}>待审 <strong>{official.pending}</strong></span>
+      <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">
@@ -94,18 +98,18 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
         {navButton('right', '下一个差异文件', props.onNextFile, !props.fileTotal)}
       </div>
       <div className="edrv-review-nav edrv-review-blocknav" role="group" aria-label="差异导航">
-        {navButton('up', '上一个差异', props.onPrevDiff, !count)}
-        <span className="edrv-review-position" aria-live="polite">{position}</span>
-        {navButton('down', '下一个差异', props.onNextDiff, !count)}
+        {navButton('up', '上一个差异', props.onPrevDiff, !count, view.navPrevTitle)}
+        <span className="edrv-review-position" aria-live="polite">{view.position}</span>
+        {navButton('down', '下一个差异', props.onNextDiff, !count, view.navNextTitle)}
       </div>
       <div className="edrv-review-actions">
         <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={props.reviewBatchBusy || !detail?.capability.undo} title={detail?.capability.reason}>Undo</Button>
-        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={props.reviewBatchBusy || !detail?.capability.keep} title="保留当前记录的未处理修改">Keep</Button>
+        <Button size="sm" variant="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 && staleRegions.length > 0 ? <div className="edrv-review-notice" role="status">{staleRegions.length} 处历史差异无法定位，展开详情查看原始增删。</div> : null}
+    {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="edrv-review-notice edrv-review-error" role="alert">{props.reviewError}</div> : null}
     {expanded ? <div className="edrv-review-body"><ReviewLedger key={`${official.sessionId}:${official.path}`} sessionId={official.sessionId} first={official.page} path={official.path} /></div> : null}
   </div>

package/src/client/ui/ReviewAllConfirm.ts

@@ -0,0 +1,35 @@
+import React from 'react'
+import { Button, Modal } from '@deepseek-ai/dsh-client-ui-primitives'
+
+interface ReviewAllProps {
+  reject: boolean
+  count: number
+  onCancel: () => void
+  onConfirm: () => void
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月27号
+ * @description Confirm workspace-wide review through the DSH modal; dismissing never applies a decision.
+ * @param props Pending file count, action and explicit confirmation callbacks.
+ * @returns DSH-themed confirmation with distinct Keep and Undo safety descriptions.
+ */
+export function ReviewAllConfirm(props: ReviewAllProps): React.ReactElement {
+  const action = props.reject ? 'Undo All' : 'Keep All'
+  const warning = props.reject
+    ? '撤销会改写磁盘；逐项安全校验，遇到冲突停止，已完成项不会自动恢复。'
+    : '只标记待审修改为保留，不改写文件。'
+  const footer = React.createElement(React.Fragment, null,
+    React.createElement(Button, { variant: 'ghost', onClick: props.onCancel, autoFocus: true }, '取消'),
+    React.createElement(Button, { variant: 'primary', onClick: props.onConfirm }, '确认 ' + action))
+
+  return React.createElement(Modal, {
+    open: true,
+    title: action + ' 确认',
+    closeLabel: '取消',
+    onClose: props.onCancel,
+    description: `处理当前工作区全部 ${props.count} 个待审差异文件（含其他轮次）？`,
+    footer,
+  }, React.createElement('p', null, warning))
+}

package/src/client-primitives.d.ts

@@ -14,6 +14,18 @@ declare module '@deepseek-ai/dsh-client-ui-primitives' {
     icon?: import('react').ReactNode
   }>
 
+  /** Centered body-portaled dialog; mirrors official Modal.d.ts. @author ddj 2026年10月27号 */
+  export const Modal: import('react').ComponentType<{
+    open: boolean
+    onClose: () => void
+    title: string
+    description?: string
+    children?: import('react').ReactNode
+    footer?: import('react').ReactNode
+    className?: string
+    contentClassName?: string
+  } & ({ headless: true; closeLabel?: never } | { headless?: false; closeLabel: string })>
+
   /** Anchored selectable menu; mirrors the subset used from official Menu.d.ts. @author ddj 2026年10月27号 */
   export const Menu: import('react').ComponentType<{
     open: boolean