dsh-config-manager 0.1.71 → 0.1.72

package/src/client/chat/sidebar-slots.ts

@@ -0,0 +1,37 @@
+/**
+ * DSH 右侧栏槽位在本仓库的**类型镜像**（只声明我们真的用的那一个位）。
+ *
+ * 为什么需要镜像：`ctx.slots.register({ name })` 的 name 必须落在 ui-slots 的 `SlotMap` 里，
+ * 而本仓库的依赖里没有 `@deepseek-ai/dsh-client-ui-sidebar-right`（与 chat-slots.ts 同一处境）。
+ *
+ * 镜像来源（逐条核过真机 app.asar 0.2.0-rc.2 的 ui-sidebar-right/client.js）：
+ *  · 正文位 = `sidebar.right.pane.tab`，**keyed / session** 位，key = tab 类型的**实现 id**
+ *    （自带的文本预览注册 key 就是它的包名；我们的是 `config-manager.rollback-diff`）；
+ *  · 每个正文组件由 seat 注入 `useTabInfo()`（给出 `tab.contentId` = 打开时用的资源地址），
+ *    这正是「同一个文件开两个标签各看各的」的依据 —— 我们**不**用全局变量记目标；
+ *  · 旧版 DSH（0.1.x）没有这个槽位 ⇒ 装配点做形态探测后**不注册**（只丢这一个能力）。
+ */
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface SlotMap {
+    /**
+     * 右侧栏一个 pane 的 tab 正文位（keyed / session scope）。
+     * 本插件只注册自己的实现 id：`config-manager.rollback-diff`。
+     */
+    'sidebar.right.pane.tab': {
+      kind: 'keyed'
+      scope: 'session'
+      keyProps: {
+        'config-manager.rollback-diff': {
+          /** 侧栏 seat 注入的 tab 信息钩子（资源地址在这里；拿不到时如实说读不出来）。 */
+          useTabInfo?: () => { tab?: { contentId?: unknown } }
+        }
+      }
+      owner: {
+        /** 该位由 seat 组合出来的通用 props（我们只读 tab 信息钩子）。 */
+        useTabInfo?: () => { tab?: { contentId?: unknown } }
+      }
+    }
+  }
+}

package/src/client/common/ConfirmDialog.tsx

@@ -16,7 +16,7 @@
  *
  * 安全：message 由调用方传入（渲染前已 redact 兜底）；本组件不触碰任何凭据。
  */
-import { useRef, useState } from 'react'
+import { useId, useRef, useState } from 'react'
 import { Button } from './ui.tsx'
 import { Modal } from './Modal.tsx'
 import css from '../config-manager.module.css'
@@ -60,6 +60,10 @@ export function ConfirmDialog({
   const handleBackdropClose = backdropClose ?? onCancel
   /** 取消按钮 ref：Radix 打开时把初始焦点重定向到此（危险确认不默认落破坏性的确认按钮） */
   const cancelRef = useRef<HTMLButtonElement | null>(null)
+  /** 正文说明的 DOM id：交由 Modal 设 aria-describedby。
+   *  只设 aria-label 时读屏只会播报标题（如「删除档案」），而**后果说明**不会在打开时被读出。 */
+  const messageId = useId()
+  const hasMessage = message !== undefined && message !== ''
 
   const handleConfirm = (): void => {
     if (busy) return
@@ -77,10 +81,10 @@ export function ConfirmDialog({
   }
 
   return (
-    <Modal open={open} onClose={handleBackdropClose} title={title} busy={busy} onOpenAutoFocus={onOpenAutoFocus}>
+    <Modal open={open} onClose={handleBackdropClose} title={title} busy={busy} onOpenAutoFocus={onOpenAutoFocus} describedById={hasMessage ? messageId : undefined}>
       <Modal.Header title={title} />
       <Modal.Body scroll>
-        {message !== undefined && message !== '' && <div>{message}</div>}
+        {hasMessage && <div id={messageId}>{message}</div>}
         {children}
       </Modal.Body>
       <Modal.Footer>

package/src/client/common/ContentPicker.tsx

@@ -7,6 +7,11 @@
  * 与 SectionComposition 的分工：那个是只读的「分区构成」网格（总览页「分区构成」卡 /
  * 导出页「本次将导出」数据块共用），这个是可交互的选择器。两者不是替代关系，禁止合并。
  *
+ * 惰性清单（2026-10-12 用户反馈）：条目的清单由调用方**逐分区惰性拉取**（导出页只预取已勾选分区）。
+ * 所以「未读」是一个必须被表达出来的状态 —— 未读分区照常渲染展开控件，展开时才经 onRequestUnits
+ * 触发读取，并且**不显示「已选 0/0」**（那会被读成「这条分区是空的」）。判定全部在
+ * src/ui/selection-model.ts（sectionExpandable / sectionCountState），本组件只装配。
+ *
  * 职责边界：本组件**只渲染与转发交互**，全部选择语义（稀疏排除集、原子组联动、
  * 三态判定、请求参数换算）都在 `src/ui/selection-model.ts` 里，node 可测。
  */
@@ -17,7 +22,8 @@ import type { TranslateNS } from '../client-types.ts'
 import {
   applySessionParentCoupling,
   applySessionWorkspaceCoupling,
-  filterSections, groupPickState, groupSelectedCount, groupUnits, tailWeightedEllipsis, pickerSummary, sectionPickState,
+  filterSections, groupPickState, groupSelectedCount, groupUnits, tailWeightedEllipsis, pickerSummary,
+  sectionCountState, sectionExpandable, sectionPickState,
   selectAll, selectedUnitCount, toggleSection, toggleUnit, toggleUnitGroup, unitChecked, visibleUnits,
   type Selection, type SelectionSection, type SelectionUnit, type SessionParentChange, type SessionWorkspaceCouplingFocus,
 } from '../../ui/selection-model.ts'
@@ -39,7 +45,10 @@ function unitsId(section: SectionId): string {
 }
 
 export interface ContentPickerProps {
-  /** 分区 + 可勾选单元（由 /export-preview 的 items 派生；units 为空 = 不可细分） */
+  /**
+   * 分区 + 可勾选单元（由 /export-preview 的 items 派生）。
+   * `units` 为空有两种事实：不可细分（整体开关）与**尚未读取**（`unitsUnread === true`，见 SelectionSection）。
+   */
   nodes: SelectionSection[]
   value: Selection
   onChange: (next: Selection) => void
@@ -54,6 +63,14 @@ export interface ContentPickerProps {
    * 并**不显示**会误导的「已选 0/0」—— 引擎对清单缺失的分区按整体导出处理（UI-07）。
    */
   failedSections?: SectionId[]
+  /**
+   * 请求读取某分区的清单（**惰性**；调用方自行去重与并发保护）。
+   *
+   * 触发时机 = 用户展开一个「尚未读取」的分区。为什么把入口挂在展开动作上：清单只对**已勾选分区**
+   * 预取，于是未勾选的分区此前既没有展开控件、也没有条目可选 —— 用户必须先勾上整个分区才能展开与
+   * 逐项挑选（2026-10-12 用户反馈）。改成展开即读之后，sessions 这类大分区依然不会被预读。
+   */
+  onRequestUnits?: (id: SectionId) => void
   /**
    * 正在读取清单（任意分区）。true 时在列表上加**遮罩 + 加载动画** ——
    * 勾选大分区（如 sessions）要读很久，没有反馈会被当成卡死。
@@ -87,7 +104,7 @@ export interface ContentPickerProps {
 
 export function ContentPicker({
   nodes, value, onChange, t, sectionLabel, loading = false, failedSections = [], mode = 'export',
-  busy = false, pendingSections = [], highRisk, unitBadge,
+  busy = false, pendingSections = [], highRisk, unitBadge, onRequestUnits,
 }: ContentPickerProps) {
   const [query, setQuery] = useState('')
   const [expanded, setExpanded] = useState<Record<string, boolean>>({})
@@ -164,6 +181,18 @@ export function ContentPicker({
             const open = expanded[node.section] === true
             const picked = selectedUnitCount(value, node)
             const total = node.units.length === 0 ? node.count : node.units.length
+            /** 展开控件：有清单可展开；**清单未读**同样可展开（展开即触发读取，见 onRequestUnits） */
+            const expandable = sectionExpandable(node)
+            /** 计数区状态（未读**不得**显示 0/0；判定在 ui 纯函数里） */
+            const countState = sectionCountState(node, {
+              pending: pendingSections.includes(node.section),
+              failed: failedSections.includes(node.section),
+            })
+            /** 展开 = 先按需读清单（仅在「未读且即将展开」时触发一次；收起不读） */
+            const onToggleExpand = (): void => {
+              if (!open && node.unitsUnread === true) onRequestUnits?.(node.section)
+              setExpanded({ ...expanded, [node.section]: !open })
+            }
             /** 本帧要渲染的单元（默认前 N 条；UI-15） */
             const units = visibleUnits(node.units, showAllUnits[node.section] === true)
             return (
@@ -172,7 +201,7 @@ export function ContentPicker({
                   {/* 级联树：展开控件在选择框**左边**（点它只展开本节点的子树，不展开别人的）。
                       用原生 button（共享 Button 原语不透传 aria-* 属性，UI-22）；图标走**形变层** ——
                        展开态切换本身携带信息，让「变了」可见（common/Icon.tsx 的 ExpandChevron）。 */}
-                  {node.units.length > 0 ? (
+                  {expandable ? (
                     <button
                       type="button"
                       className={css.iconBtn}
@@ -181,7 +210,7 @@ export function ContentPicker({
                       aria-controls={unitsId(node.section)}
                       aria-label={open ? t('picker.collapse') : t('picker.expand')}
                       title={open ? t('picker.collapse') : t('picker.expand')}
-                      onClick={() => { setExpanded({ ...expanded, [node.section]: !open }) }}
+                      onClick={onToggleExpand}
                     >
                       <ExpandChevron open={open} />
                     </button>
@@ -209,16 +238,20 @@ export function ContentPicker({
                         {/* 三态：读取中 / 读取失败 / 已选 n/m。
                             没读到清单（在途或失败）时**不要**显示 0/0 —— 那会被读成
                             「这一项没有内容」；失败态必须显式说明「将整体导出」（UI-07）。 */}
-                        {pendingSections.includes(node.section) ? (
+                        {countState === 'pending' ? (
                           <span className={css.pickerCount}>{t('picker.loadingSection')}</span>
-                        ) : failedSections.includes(node.section) ? (
+                        ) : countState === 'failed' ? (
                           /* 失败态用 warn 语义色（DESIGN.md「状态即语义」）：中性的 .pickerCount
                              会让「读取失败」读起来像一条普通说明，而不是需要用户注意的状态 */
                           <span className={`${css.pickerCount} ${css.warnText}`}>{t('picker.sectionLoadFailed')}</span>
-                        ) : (
+                        ) : countState === 'count' ? (
                           <span className={css.pickerCount}>
                             {t('picker.selectedOf', { selected: String(picked), total: String(total) })}
                           </span>
+                        ) : (
+                          /* 未读（惰性）：**不渲染 0/0** —— 「已选 0/0」会被读成「这条分区没有内容」，
+                             而事实是「还没去读」。数字等展开（= 触发读取）之后再给。 */
+                          null
                         )}
                         {node.sizeBytes > 0 && (
                           <span className={`${css.sectionSize} ${css.mono}`}>{formatBytes(node.sizeBytes)}</span>
@@ -257,8 +290,13 @@ export function ContentPicker({
                               onChange={(checked) => { commit(toggleUnit(value, nodes, u.id, checked), focusOf(node.section), { unitId: u.id, checked }) }}
                               label={
                                 <span className={css.categoryItem}>
-                                  {/* 中段省略（保留尾部时间戳等区分信息）+ title 全文（UI-16，DESIGN.md §9.5） */}
-                                  <span className={css.pickerUnitName} title={safeLabel}>{tailWeightedEllipsis(safeLabel, UNIT_NAME_MAX)}</span>
+                                  {/* 空白会话（从未提问过）：DSH 自己显示「新会话」—— 这里同样用本地化占位名，
+                                      目录名仍进 title（悬停可核对）。其余单元照旧中段省略 + title 全文（UI-16，DESIGN.md §9.5）。 */}
+                                  {u.blank === true ? (
+                                    <span className={css.pickerUnitName} title={safeLabel}>{t('picker.blankSession')}</span>
+                                  ) : (
+                                    <span className={css.pickerUnitName} title={safeLabel}>{tailWeightedEllipsis(safeLabel, UNIT_NAME_MAX)}</span>
+                                  )}
                                   {u.lockedWith !== undefined && (
                                     <span title={t('picker.lockedHint')}><Badge kind="warn">{t('picker.locked')}</Badge></span>
                                   )}

package/src/client/common/DiffTable.tsx

@@ -0,0 +1,97 @@
+/**
+ * 双栏差异表（共享渲染原语）——「快照恢复计划」与「回滚点 · 查看」共用同一副骨架。
+ *
+ * 为什么是共享原语（AGENTS.md Reuse Before Creating）：两处要画的是**同一件事**
+ * （hunks → 左右对照：左 = before / 当前，右 = after / 目标），差别只在列头与截断文案；
+ * 复制第二份渲染代码必然从视觉与截断口径开始漂移。
+ *
+ * 分工：行对对齐 / 块头 / 行号列宽全部来自 `src/ui/diff-view.ts`（纯函数、node 单测）；本组件只画。
+ * 安全：单元格文本是磁盘 / 宿主原文 ⇒ 展示前**必须**过调用方传进来的 sanitize（本该是 redact）。
+ */
+import { Fragment } from 'react'
+import { redact } from '../../security/redaction.ts'
+import { countSideRows, maxLineDigits, toSideBySide, type SideBySideRow } from '../../ui/diff-view.ts'
+import type { DiffHunk } from '../../utils/line-diff.ts'
+import css from '../config-manager.module.css'
+
+/** 单文件最多渲染多少行对：diff 上限 6000 行，全量渲染会卡住弹窗（数据完整，只是没画出来）。 */
+export const DIFF_ROW_CAP = 400
+
+export interface DiffTableProps {
+  hunks: readonly DiffHunk[]
+  /** 左侧列头（before = 当前） */
+  beforeLabel: string
+  /** 右侧列头（after = 目标 / 快照） */
+  afterLabel: string
+  /** 被渲染上限截断时的说明文案（由调用方按自己的字典出话；缺省 = 不提示） */
+  truncatedNotice?: (shown: number, total: number) => string
+  /** 单元格文本安全化（**缺省就是 redact**：调用方只能换成别的脱敏器，换不成不脱敏） */
+  sanitize?: (text: string) => string
+  /** 渲染上限（缺省 DIFF_ROW_CAP） */
+  rowCap?: number
+}
+
+/** 左侧单元格：成对修改 / 纯删除 → 红底；上下文 → 中性。 */
+function leftCellClass(kind: SideBySideRow['kind']): string {
+  return kind === 'change' || kind === 'del' ? css.diffCell + ' ' + css.diffCellDel : css.diffCell ?? ''
+}
+
+/** 右侧单元格：成对修改 / 纯新增 → 绿底；上下文 → 中性。 */
+function rightCellClass(kind: SideBySideRow['kind']): string {
+  return kind === 'change' || kind === 'add' ? css.diffCell + ' ' + css.diffCellAdd : css.diffCell ?? ''
+}
+
+/** 左右双栏逐行对照（表头 + 块头 + 行号 + 单元格）。 */
+export function DiffTable({ hunks, beforeLabel, afterLabel, truncatedNotice, sanitize, rowCap = DIFF_ROW_CAP }: DiffTableProps) {
+  const cell = sanitize ?? ((text: string): string => redact(text))
+  const groups = toSideBySide(hunks)
+  const total = countSideRows(groups)
+  // 行号列宽 = 实际出现的最大行号位数（1–3/4/5/6+ 位四档 ch），内容列平分剩余空间
+  const digits = maxLineDigits(hunks)
+  const noColClass = digits <= 3 ? css.diffNoColW3 : digits === 4 ? css.diffNoColW4 : digits === 5 ? css.diffNoColW5 : css.diffNoColW6
+  let rendered = 0
+  const capped = total > rowCap
+  const notice = capped && truncatedNotice !== undefined ? truncatedNotice(rowCap, total) : null
+  return (
+    <>
+      {notice !== null && <div className={css.hint}>{notice}</div>}
+      <div className={css.diffScroll}>
+        <table className={css.diffTable}>
+          <colgroup>
+            <col className={noColClass} />
+            <col />
+            <col className={noColClass} />
+            <col />
+          </colgroup>
+          <thead>
+            <tr>
+              <th className={css.diffNoHead} colSpan={2}>{beforeLabel}</th>
+              <th className={css.diffNoHead} colSpan={2}>{afterLabel}</th>
+            </tr>
+          </thead>
+          <tbody>
+            {groups.map((group) => {
+              const rows = capped ? group.rows.slice(0, Math.max(0, rowCap - rendered)) : group.rows
+              rendered += rows.length
+              return (
+                <Fragment key={group.header}>
+                  <tr className={css.diffHunkRow}>
+                    <td colSpan={4}>{group.header}</td>
+                  </tr>
+                  {rows.map((row, index) => (
+                    <tr key={group.header + '-' + String(index)}>
+                      <td className={css.diffNo}>{row.left?.oldNo ?? ''}</td>
+                      <td className={leftCellClass(row.kind)}>{row.left === null ? '' : cell(row.left.text)}</td>
+                      <td className={css.diffNo}>{row.right?.newNo ?? ''}</td>
+                      <td className={rightCellClass(row.kind)}>{row.right === null ? '' : cell(row.right.text)}</td>
+                    </tr>
+                  ))}
+                </Fragment>
+              )
+            })}
+          </tbody>
+        </table>
+      </div>
+    </>
+  )
+}

package/src/client/common/ErrorBanner.tsx

@@ -8,7 +8,7 @@
 import { useMemo } from 'react'
 import { toActionableError } from '../../ui/errors.ts'
 import { redact } from '../../security/redaction.ts'
-import { zhUiT, type UiT } from '../../ui/i18n.ts'
+import type { UiT } from '../../ui/i18n.ts'
 import { Button } from './ui.tsx'
 import { ArrowRightIcon } from './Icon.tsx'
 import css from '../config-manager.module.css'
@@ -20,8 +20,8 @@ export interface ErrorBannerProps {
   onRetry?: () => void
   /** 重试中的 loading 态 */
   retrying?: boolean
-  /** 展示层翻译器（缺省 zh；ErrorBanner 为通用组件，不绑定 settings 命名空间字典） */
-  t?: UiT
+  /** 展示层翻译器（**必传**：英文界面不得回落中文；通用组件，不绑定 settings 命名空间字典） */
+  t: UiT
 }
 
 /**
@@ -29,7 +29,7 @@ export interface ErrorBannerProps {
  * 文本在渲染前再经 redact() 兜底（双保险），Reason 以等宽块展示。
  * 重试按钮：进行中（retrying）时显示 Spinner 并禁用（防重复点击）。
  */
-export function ErrorBanner({ error, onRetry, retrying, t = zhUiT }: ErrorBannerProps) {
+export function ErrorBanner({ error, onRetry, retrying, t }: ErrorBannerProps) {
   /**
    * UI-20：解析结果必须由 `error` **派生**（useMemo），不能是只在挂载时求值一次的 useState ——
    * 同一横幅上 error 被替换后（如连续两次失败原因不同），标题/原因/建议动作/可重试判定会

package/src/client/common/Icon.tsx

@@ -29,6 +29,7 @@ import Copy from 'lucide-react/dist/esm/icons/copy.mjs'
 import DatabaseBackup from 'lucide-react/dist/esm/icons/database-backup.mjs'
 import Download from 'lucide-react/dist/esm/icons/download.mjs'
 import Eye from 'lucide-react/dist/esm/icons/eye.mjs'
+import File from 'lucide-react/dist/esm/icons/file.mjs'
 import FolderInput from 'lucide-react/dist/esm/icons/folder-input.mjs'
 import HardDriveDownload from 'lucide-react/dist/esm/icons/hard-drive-download.mjs'
 import History from 'lucide-react/dist/esm/icons/history.mjs'
@@ -66,6 +67,7 @@ const ICONS = {
   pencil: Pencil,
   close: X,
   delete: Trash2,
+  file: File,
   download: Download,
   inspect: Search,
   view: Eye,

package/src/client/common/Modal.tsx

@@ -68,6 +68,10 @@ export interface ModalProps {
   /** Radix 打开时的初始焦点重定向（如 ConfirmDialog 把焦点派发到取消按钮）。
    *  Radix 传入的是可 preventDefault 的 DOM Event。 */
   onOpenAutoFocus?: (e: Event) => void
+  /** 说明文本节点的 id（Radix Content 据此设 aria-describedby）：
+   *  确认框的「后果说明」必须被屏幕阅读器读到 —— 只设 aria-label 时打开弹窗只播报标题。
+   *  传 id 而不是文本，是为了让可见正文本身就是被描述的那一段（不重复渲染、不动视觉）。 */
+  describedById?: string
   /** 卡片额外内联样式（如 ReleaseNotes 的自定义宽度/最大高度）；常规布局仍走 CSS 类 */
   cardStyle?: CSSProperties
   children?: ReactNode
@@ -76,7 +80,7 @@ export interface ModalProps {
 /**
  * 统一弹窗容器（Radix Dialog）。busy 时禁用 Esc 与遮罩关闭。
  */
-export function Modal({ open, onClose, title, wide, busy, onOpenAutoFocus, cardStyle, children }: ModalProps) {
+export function Modal({ open, onClose, title, wide, busy, onOpenAutoFocus, cardStyle, describedById, children }: ModalProps) {
   /**
    * Portal 容器解析 —— 三条纪律（顺序即重要性，别改回 useEffect）：
    *
@@ -114,6 +118,9 @@ export function Modal({ open, onClose, title, wide, busy, onOpenAutoFocus, cardS
           className={`${css.dialogContentCenter} ${css.dialogCard}${wide === true ? ` ${css.dialogWide}` : ''}`}
           style={cardStyle}
           aria-label={title}
+          // 说明文本（危险确认的后果）必须进无障碍树：Radix 只在存在 Dialog.Description 时
+          // 自动接 aria-describedby，而我们的正文由调用方自渲染 —— 因此显式传 id（视觉零变化）。
+          aria-describedby={describedById}
           // 「这是我们自己的弹窗卡片」标记：Select 的弹层据此决定挂载点 —— 弹层**必须**进弹窗内容子树，
           // 否则会被 radix 的 body{pointer-events:none}、外部交互判定与 RemoveScroll 滚动锁挡死
           // （2026-10-04 用户反馈「选项点不动」；见 common/Select.tsx 的 resolveMenuHost）。

package/src/client/common/ProgressBar.tsx

@@ -13,6 +13,7 @@
  */
 import { computeProgressView, progressBarMode } from './progress-view.ts'
 import type { RunProgress } from './progress-view.ts'
+import type { UiT } from '../../ui/i18n.ts'
 import { redact } from '../../security/redaction.ts'
 import css from '../config-manager.module.css'
 
@@ -23,6 +24,11 @@ export interface ProgressBarProps {
   active: boolean
   /** 已结束且结论为失败：结束态不得渲染成「成功绿」（导出页不传，行为不变） */
   failed?: boolean
+  /**
+   * 展示层翻译器（**必传**：阶段文案要按当前语言渲染；英文界面不得回落中文）。
+   * 此前组件内隐式用 zhUiT 缺省值，切到英文后进度文案恒为中文。
+   */
+  t: UiT
 }
 
 /**
@@ -32,8 +38,8 @@ export interface ProgressBarProps {
  * 无百分比且在跑 → 不定态动画；**无百分比且已结束 → 静止条**（这条是 bugfix：
  * 此前「已完成」的任务因为没有百分比也走不定态分支，动画永不停 → 看起来一直在加载）。
  */
-export function ProgressBar({ event, active, failed }: ProgressBarProps) {
-  const view = computeProgressView(event)
+export function ProgressBar({ event, active, failed, t }: ProgressBarProps) {
+  const view = computeProgressView(event, t)
   const mode = progressBarMode(view, active)
   const fillClass = active
     ? css.progressBar

package/src/client/common/ReportView.tsx

@@ -23,7 +23,7 @@ import {
 } from '../../ui/report.ts'
 import type { ImportSectionStat } from '../../ui/types.ts'
 import { redact } from '../../security/redaction.ts'
-import { zhUiT, type UiT } from '../../ui/i18n.ts'
+import type { UiT } from '../../ui/i18n.ts'
 import { Badge, Button } from './ui.tsx'
 import css from '../config-manager.module.css'
 
@@ -37,8 +37,8 @@ export interface ReportViewProps {
   onDownload?: () => void
   /** 下载进行中（导出报告场景：下载按钮 spinner + 禁用，防重复下载） */
   downloadBusy?: boolean
-  /** 展示层翻译器（缺省 zh；与 ErrorBanner 同策略，不绑定 settings 命名空间） */
-  t?: UiT
+  /** 展示层翻译器（**必传**：英文界面不得回落中文；不绑定 settings 命名空间，故用 UiT） */
+  t: UiT
   /**
    * 分区显示名（SectionId → 文案）。导出报告的分区清单**必须**传 section-labels 的
    * sectionLabeler(t)（分区名的单一映射）；缺省回退裸 id，只允许用于非 UI 场合
@@ -230,7 +230,7 @@ function ImportSectionTable({ stats, labelOf, t }: {
  * （ImportWizardView 的 .resultFooter）——原先埋在报告卡底部，被
  * `flex + overflow:hidden` 的挤压布局裁掉，用户报告「导入完成后没有完成按钮」。
  */
-export function ReportView({ kind, exportReport, importResult, onDownload, downloadBusy = false, t = zhUiT, sectionLabel }: ReportViewProps) {
+export function ReportView({ kind, exportReport, importResult, onDownload, downloadBusy = false, t, sectionLabel }: ReportViewProps) {
   const importStats = kind === 'import' && importResult !== undefined
     ? importSectionStats(importResult.executed)
     : []

package/src/client/common/RunsCenter.tsx

@@ -209,6 +209,7 @@ export function RunsCenter({ api, recoveryApi, t, defaultRollbackOnError }: Runs
               active={card.status === 'running'}
               // 失败的任务绝不能渲染成「成功绿」（结束态的默认色是 success）
               failed={card.status === 'failed'}
+              t={api.t}
             />
             {card.counts !== null && (
               <div className={css.runsCounts}>

package/src/client/common/client-route-parity.test.ts

@@ -34,6 +34,7 @@ import {
   MARKET_API,
   MY_CONFIGS_API,
   RECOVERY_API,
+  ROLLBACK_POINT_ROUTES,
   SYNC_API,
 } from './routes.ts';
 
@@ -67,8 +68,44 @@ const PREFIX_ROUTED = new Set<string>([
   // （`segments[0] === 'sessions'` 下的 `repair` / `rollback` 子路径），不新增宿主注册路由条目。
   RECOVERY_API.sessionsRepair,
   RECOVERY_API.sessionsRollback,
+  // S7：rollback-points（工作区 + 会话回滚，两态）—— 由 recovery prefix 路由内部按 path 分发
+  // （`segments[0] === 'rollback-points'` 下的 storage / <id>/{preview,rewind,delete}），
+  // 不新增宿主注册路由条目，因此 route-parity 的 79 条快照不变。
+  RECOVERY_API.rollbackPoints,
+  RECOVERY_API.rollbackPointsStorage,
 ]);
 
+/**
+ * rollback-points 族的**端点 ↔ RecoveryApi 方法**一一对账（S7 / T2）。
+ *
+ * `<id>` 是占位符（不是可直接请求的路径），所以这些子路径不进 `RECOVERY_API`（也就不进
+ * `clientPaths()` 的宿主字面量对账）；但「客户端声明了哪 7 条端点、实现了哪 7 个方法」必须
+ * 两边都齐 —— 少了 = 界面点了 404，多了 = 死代码或改错方向。
+ */
+const ROLLBACK_POINT_ENDPOINTS: readonly string[] = [
+  RECOVERY_API.rollbackPoints,
+  RECOVERY_API.rollbackPointsStorage,
+  `${RECOVERY_API.rollbackPoints}/<id>`,
+  `${RECOVERY_API.rollbackPoints}/<id>/preview`,
+  `${RECOVERY_API.rollbackPoints}/<id>/file-diff`,
+  `${RECOVERY_API.rollbackPoints}/<id>/rewind`,
+  `${RECOVERY_API.rollbackPoints}/<id>/delete`,
+];
+
+/** 客户端 api 文件（对账对象；与 http-usage-guard 的收敛范围同源）。 */
+const RECOVERY_API_FILE = 'src/client/recovery/recovery-api.ts';
+
+function readClientSource(rel: string): string {
+  return fs.readFileSync(path.join(ROOT, rel), 'utf8');
+}
+
+/** 源码里声明的异步方法名（`async name(`）。 */
+function declaredAsyncMethods(source: string): string[] {
+  const out: string[] = [];
+  for (const match of source.matchAll(/^\s*async\s+([A-Za-z0-9_]+)\s*\(/gm)) out.push(match[1] as string);
+  return out;
+}
+
 const ROUTE_LITERAL = /'(\/api\/dsh-config-manager[^']*)'/g;
 
 /** 从宿主源码提取路由字面量（行级；注释整行/同行注释后都不采信）。 */
@@ -174,6 +211,47 @@ test('parity-03 prefix 路由（recovery）确有宿主前缀字面量覆盖', (
   }
 });
 
+test('parity-05 rollback-points 族：7 条端点与 RecoveryApi 方法一一对账（两个方向）', () => {
+  const entries = Object.values(ROLLBACK_POINT_ROUTES);
+  assert.equal(entries.length, 7, 'rollback-points 族必须恰好 7 条端点（6 条冻结契约 + 只读 file-diff）');
+  assert.deepEqual(
+    entries.map((entry) => entry.path).sort(),
+    [...ROLLBACK_POINT_ENDPOINTS].sort(),
+    '端点清单必须与冻结契约逐字一致（多一条=死代码，少一条=界面打不出去）',
+  );
+
+  // ① 每条端点都必须是 recovery prefix 下的子路径（\`<id>\` 占位符只能是 id 段，不能拼错层级）
+  const literals = hostRouteLiterals();
+  for (const entry of entries) {
+    assert.ok(
+      entry.path === RECOVERY_API.rollbackPoints
+        || entry.path === RECOVERY_API.rollbackPointsStorage
+        || entry.path.startsWith(RECOVERY_API.rollbackPoints + '/<id>'),
+      '端点 ' + entry.path + ' 不在 rollback-points 族下（拼错即 404）',
+    );
+    assert.ok(prefixCovered(entry.path, literals), '端点 ' + entry.path + ' 没有宿主 recovery 前缀字面量覆盖');
+  }
+
+  // ② 正向：每个方法都必须真的在 RecoveryApi 里实现（名字改了/删了就红）
+  const source = readClientSource(RECOVERY_API_FILE);
+  const declared = declaredAsyncMethods(source);
+  for (const entry of entries) {
+    assert.ok(
+      declared.includes(entry.method),
+      'RecoveryApi 里没有 ' + entry.method + '() —— 端点 ' + entry.path + ' 缺少实现',
+    );
+  }
+
+  // ③ 反向：rollback-points 族的方法不得游离在表外（死代码 / 改错名）
+  const tableMethods = new Set(entries.map((entry) => entry.method));
+  const familyMethods = declared.filter((name) => /^(rollbackPoint|restoreRollbackPoint|removeRollbackPoint)/.test(name));
+  assert.deepEqual(
+    [...familyMethods].sort(),
+    [...tableMethods].sort(),
+    'rollback-points 族方法与 \`ROLLBACK_POINT_ROUTES\` 必须一一对应（旧 checkpoint* 方法不在本族内）',
+  );
+});
+
 test('parity-04 未精确命中的客户端路由必须已在 PREFIX_ROUTED 显式登记', () => {
   const literals = hostRouteLiterals();
   const unregistered = clientPaths().filter((p) => !literals.has(p) && !PREFIX_ROUTED.has(p));