dsh-config-manager 0.1.71 → 0.1.73

package/src/client/sync/SyncSectionPickerDialog.tsx

@@ -20,6 +20,7 @@ import type { SelectionSection } from '../../ui/selection-model.ts'
 import {
   initialSessionPicks, pickedSessionIds, sessionPickerSelection,
 } from '../../ui/sync-settings-view.ts'
+import type { UiT } from '../../ui/i18n.ts'
 import { DEFAULT_SYNC_SESSIONS_LIMIT, syncSectionGroups } from './sync-view.ts'
 import type { SyncSectionOption } from './sync-view.ts'
 import css from '../config-manager.module.css'
@@ -30,8 +31,10 @@ import css from '../config-manager.module.css'
  * （与导出选择器一致的弹窗语义），因此底部只有「完成」—— 没有「取消」
  * （取消会让用户以为改动被丢弃）。
  */
-export function SyncSectionPickerDialog({ open, t, cmT, sectionName, catalog, sections, sessionsLimit, sessionsInclude, sessionNode, sessionPending, sessionFailed, onToggleSection, onSessionsLimit, onSessionsInclude, onClose }: {
+export function SyncSectionPickerDialog({ open, t, cmT, uiT, sectionName, catalog, sections, sessionsLimit, sessionsInclude, sessionNode, sessionPending, sessionFailed, onToggleSection, onSessionsLimit, onSessionsInclude, onClose }: {
   t: TranslateNS<'config-manager-sync'>
+  /** ui 命名空间的翻译器（UiT）：分区描述与分组说明的**字典键**由它解析（英文界面零中文） */
+  uiT: UiT
   /** config-manager 命名空间的翻译器：ContentPicker 的搜索/全选/合计文案来自它 */
   cmT: TranslateNS<'config-manager'>
   open: boolean
@@ -119,7 +122,7 @@ export function SyncSectionPickerDialog({ open, t, cmT, sectionName, catalog, se
           /* 分组勾选目录：与「导出备份·自定义模式」同构（分组 Card + 名称/描述/徽章），
              分区名走 section-labels 单一映射 —— 与导出选择器显示**同一个中文名**。 */
           <div className={css.groupList}>
-            {syncSectionGroups(catalog).map((g) => (
+            {syncSectionGroups(catalog, uiT).map((g) => (
               <Card key={g.group} className={css.groupCard}>
                 <div className={css.groupHeader}>
                   <span className={css.groupLabel}>{g.label}</span>
@@ -137,9 +140,15 @@ export function SyncSectionPickerDialog({ open, t, cmT, sectionName, catalog, se
                             <span className={css.categoryName}>{sectionName(s.id)}</span>
                             <span className={css.categoryDesc}>{s.description}</span>
                             {s.portability === 'portable' && <Badge kind="info">{t('mode.sectionPortable')}</Badge>}
+                            {s.portability === 'platformSpecific' && (
+                              <Badge kind="warn">{t('mode.sectionPlatformSpecific')}</Badge>
+                            )}
                             {s.portability === 'deviceSpecific' && (
                               <Badge kind="warn">{t('mode.sectionDeviceSpecific')}</Badge>
                             )}
+                            {/* issue #78：MCP 的机器相关内容（绝对路径 command / cwd、缺运行时）走 ⓘ，
+                                与「机制说明进 InfoHint」的同一条纪律（见 info-hint-guard）。 */}
+                            {s.id === 'mcp' && <InfoHint text={t('mode.mcpHint')} label={t('common.infoHint')} />}
                             {s.defaultIncluded && <Badge kind="ok">{t('mode.sectionRecommended')}</Badge>}
                           </span>
                         }

package/src/client/sync/SyncSettingsView.test.ts

@@ -60,6 +60,8 @@ test('t42: 组件按职责物理拆分成独立文件（各自导出 + 主文件
     ['SecurityOptionsCard', 'SecurityOptionsCard.tsx'],
     ['DecryptPasswordCard', 'DecryptPasswordCard.tsx'],
     ['AutosyncCard', 'AutosyncCard.tsx'],
+    // issue #79：工作副本卡（含确认弹窗 + 宿主调用 + 回执）自成文件，主文件只装配 —— 行数棘轮因此不必上调
+    ['WorkDirCard', 'WorkDirCard.tsx'],
   ]
   for (const [name, file] of units) {
     // 主文件：必须 import 并渲染该单元
@@ -92,7 +94,10 @@ test('t42: 组件按职责物理拆分成独立文件（各自导出 + 主文件
   //   · 云端点表单 12 个字段进出 state（校验 / 组装 / 就绪判定都已下沉 ui 层，这里是 state 通道）；
   //   · 多两张通道卡；对话框改为收单个 form 快照后，调用点反而少了几行；
   //   · /sync/status → 四通道回填 + 云端点非密字段回填。
-  assert.ok(viewLines <= 1580, '主文件行数必须保持在拆分后的量级（实际 ' + viewLines + ' 行）')
+  // 1580 → 1585（t3：英文界面零中文）。增量是**装配接线**：分区选择弹窗新增 uiT 注入
+  //   （分区描述 / 分组说明改为字典键后，弹窗内需要 ui 字典翻译器才能解析；判定逻辑在 ui 层）。
+  //   同一轮把 11 处 toast 的「全角冒号 + 详情」拼接改为 t('common.labelSeparator')，行数不变。
+  assert.ok(viewLines <= 1585, '主文件行数必须保持在拆分后的量级（实际 ' + viewLines + ' 行）')
 })
 
 test('t42: 通道卡必须是渲染函数（内联组件 = 每次渲染新类型 → 子树重挂、Select 展开态清零）', () => {
@@ -106,6 +111,20 @@ test('t42: 通道卡必须是渲染函数（内联组件 = 每次渲染新类型
   assert.match(viewSource, /\{renderChannelCard\('webdav'\)\}/, 'webdav 通道卡必须经渲染函数调用')
 })
 
+test('工作副本「重建」按钮必须在请求在途时转加载态（用户报告：点了没有任何反馈）', () => {
+  // 真机用户报告：点「重新克隆工作副本」后整卡没有任何变化，只有结束时才跳出 toast —— reclone 要删目录 +
+  // 重新 clone（可达数十秒），期间用户无从判断是否在执行。守卫钉住三条：在途态由本卡自持、两个出口都转
+  // 加载态并互相禁用、失败也必须收掉加载态；任一条回退即变红。
+  const src = readSource(fileURLToPath(new URL('./WorkDirCard.tsx', import.meta.url)))
+  assert.match(src, /const \[pending, setPending\] = useState<'relink' \| 'reclone' \| null>\(null\)/, '在途态必须是本卡自持的 relink/reclone 判别式状态')
+  assert.match(src, /loading=\{pending === 'reclone'\}/, '重新克隆按钮必须在自身请求在途时显示加载态')
+  assert.match(src, /loading=\{pending === 'relink'\}/, '重指向按钮同理')
+  assert.match(src, /disabled=\{busy \|\| pending !== null\}/, '在途时必须同时禁用两个出口（防重复点击）')
+  const start = src.indexOf('const reset = async')
+  const body = src.slice(start, start + 900)
+  assert.match(body, /finally \{[\s\S]*setPending\(null\)/, '失败也必须收掉加载态（否则按钮会永远转圈）')
+})
+
 test('t42: 断开 git 通道必须同步复位内存登录态（令牌槽位被删 = 已登出，否则登录入口恒隐藏）', () => {
   // 真机用户报告：点「断开配置」删掉的是 SYNC_CREDENTIAL_REF —— 与 GitHub 登录**同一个槽位**，
   // 但 githubSignedIn 当时不复位，登录块恒隐藏，用户以为要重启 profile 才能重新登录。

package/src/client/sync/UnreadableSnapshotsBanner.tsx

@@ -28,7 +28,7 @@ export function UnreadableSnapshotsBanner({
     <Banner kind="warn">
       {t('snapshots.unreadableHint', {
         n: String(items.length),
-        files: items.map((u) => baseName(u.file)).join('、'),
+        files: items.map((u) => baseName(u.file)).join(t('common.listSeparator')),
       })}
     </Banner>
   )

package/src/client/sync/WorkDirCard.tsx

@@ -0,0 +1,112 @@
+/**
+ * 工作副本卡（issue #79；t42 物理拆分：渲染段自成文件，主文件只装配）。
+ *
+ * 为什么需要它：改仓库地址后同步失败时，App 内此前**没有任何自救路径** —— 只能手工
+ * `git remote set-url`，或删掉 `<dataDir>/sync/work` 重来。这里给出工作副本的只读事实
+ * （路径 / origin / 与配置地址是否一致）与两条出口：
+ *  - 「重指向仓库地址」= host 的 relink（非破坏性：只改 git 配置，不碰工作树与本地提交）；
+ *  - 「重新克隆工作副本」= host 的 reclone（**丢弃未上行的本地提交**）→ danger 二次确认。
+ *
+ * 约定（与 ChannelClearConfirmDialog 同族）：确认弹窗、宿主调用与终局回执都在本文件内自持，
+ * 调用方只传「渲染所需的数据 + 变更通知」；判定在 `src/ui/sync-settings-view.ts`（可测）。
+ */
+import { useState } from 'react'
+import type { TranslateNS } from '../client-types.ts'
+import type { SyncApi, SyncStatusResponse } from './sync-api.ts'
+import { Badge, Button, Card } from '../common/ui.tsx'
+import { InfoHint } from '../common/InfoHint.tsx'
+import { ConfirmDialog } from '../common/ConfirmDialog.tsx'
+import { toast } from '../common/toast-store.ts'
+import { redact } from '../../security/redaction.ts'
+import {
+  canRecloneWorkdir, formatSyncUrlPreview, needsWorkdirRelink, workdirStateBadgeKind, workdirStateKey,
+} from '../../ui/sync-settings-view.ts'
+import css from '../config-manager.module.css'
+
+export function WorkDirCard({ t, api, workDir, busy, onChanged }: {
+  t: TranslateNS<'config-manager-sync'>
+  api: SyncApi
+  /** GET /sync/status 的 workDir 字段（非 git 通道 / 未配置时 undefined） */
+  workDir: SyncStatusResponse['workDir']
+  busy: boolean
+  /** 重建成功后重拉状态（调用方负责它的状态源） */
+  onChanged: () => void
+}) {
+  /** 重新克隆的二次确认（破坏性：丢弃未上行的本地提交） */
+  const [recloneOpen, setRecloneOpen] = useState(false)
+  /** 本次发起的出口（relink / reclone）：请求在途时卡片按钮就地转加载态。
+   *  为什么必须有：reclone 要删目录 + 重新 clone（真机可达数十秒），此前点了只有 toast 在**结束**时才响，
+   *  用户无从判断是否正在执行，容易重复点击或以为没反应。 */
+  const [pending, setPending] = useState<'relink' | 'reclone' | null>(null)
+  const stateKey = workdirStateKey(workDir)
+  const badgeKind = workdirStateBadgeKind(stateKey)
+  const facts = workDir !== undefined && 'facts' in workDir ? workDir.facts : null
+
+  const reset = async (mode: 'relink' | 'reclone'): Promise<void> => {
+    setRecloneOpen(false)
+    setPending(mode)
+    try {
+      await api.workdirReset(mode === 'reclone' ? { mode, confirm: true } : { mode })
+      toast.ok(t(mode === 'relink' ? 'toast.workdirRelinked' : 'toast.workdirRecloned'))
+      onChanged()
+    } catch (err) {
+      toast.error(t('toast.workdirResetFailed') + t('common.labelSeparator') + redact(err instanceof Error ? err.message : String(err)))
+    } finally {
+      // 无论成功/失败都要收掉加载态，否则按钮会永远转圈（状态重拉由 onChanged 负责）
+      setPending(null)
+    }
+  }
+
+  return (
+    <Card>
+      <span className={css.groupLabel}>{t('workdir.title')} <InfoHint text={t('workdir.hint')} label={t('common.infoHint')} /></span>
+      {stateKey !== null && badgeKind !== null && (
+        <div className={css.statRow}>
+          <Badge kind={badgeKind}>{t(stateKey)}</Badge>
+        </div>
+      )}
+      {workDir === undefined ? (
+        <span className={css.categoryDesc}>{t('workdir.unknown')}</span>
+      ) : (
+        <div className={css.factGrid} style={{ marginTop: 8 }}>
+          <div className={css.factCell} style={{ gridColumn: '1 / -1' }}>
+            <span className={css.factLabel}>{t('workdir.path')}</span>
+            <span className={css.factValue}>
+              <span className={css.mono}>{formatSyncUrlPreview(facts?.path ?? t('workdir.unknown'))}</span>
+            </span>
+          </div>
+          <div className={css.factCell} style={{ gridColumn: '1 / -1' }}>
+            <span className={css.factLabel}>{t('workdir.origin')}</span>
+            <span className={css.factValue}>
+              <span className={css.mono}>
+                {facts === null || facts.origin === null ? t('workdir.unknown') : formatSyncUrlPreview(facts.origin)}
+              </span>
+            </span>
+          </div>
+        </div>
+      )}
+      <div className={css.actionRowTop}>
+        {needsWorkdirRelink(workDir) && (
+          <Button disabled={busy || pending !== null} loading={pending === 'relink'} onClick={() => { void reset('relink') }}>
+            {t('workdir.relink')}
+          </Button>
+        )}
+        {canRecloneWorkdir(workDir) && (
+          <Button variant="danger" disabled={busy || pending !== null} loading={pending === 'reclone'} onClick={() => { setRecloneOpen(true) }}>
+            {t('workdir.reclone')}
+          </Button>
+        )}
+      </div>
+      <ConfirmDialog
+        open={recloneOpen}
+        danger
+        title={t('workdir.recloneConfirmTitle')}
+        message={t('workdir.recloneConfirmMessage')}
+        confirmLabel={t('workdir.recloneConfirm')}
+        cancelLabel={t('common.cancel')}
+        onConfirm={() => reset('reclone')}
+        onCancel={() => { setRecloneOpen(false) }}
+      />
+    </Card>
+  )
+}

package/src/client/sync/history-model.test.ts

@@ -14,7 +14,8 @@ import type { SyncHistoryEntry } from './sync-api.ts';
 import { en as syncEn, zh as syncZh } from './sync-locales.ts';
 import {
   autosyncBadgeKind, autosyncStatusLabel, describeSkipReason, directionLabel, formatDateTime,
-  formatDateTimeFull, midEllipsis, projectAutosyncEntry, projectSyncHistoryEntries, summarizeSyncHistory,
+  formatDateTimeFull, midEllipsis, projectAutosyncEntry, projectSyncHistoryEntries, skipReasonKey,
+  summarizeSyncHistory,
 } from './history-model.ts';
 import type { AutosyncHistoryEntry } from './sync-api.ts';
 
@@ -79,17 +80,20 @@ test('directionLabel / autosyncStatusLabel：方向与状态映射（走字典
   assert.equal(autosyncStatusLabel('partial', enT), 'Partial');
 });
 
-test('describeSkipReason：已知原因走字典；未落字典的三类保持现状（F1 残留，见 findings.md）', () => {
+test('describeSkipReason：七类已知原因全部走字典（F1 收口：不再有硬编码中文）', () => {
   assert.equal(describeSkipReason('conflict', zhT), syncZh['history.autosyncReasonConflict']);
   assert.equal(describeSkipReason('no-remote', zhT), syncZh['history.autosyncReasonNoRemote']);
   assert.equal(describeSkipReason('not-configured', zhT), syncZh['history.autosyncReasonNotConfigured']);
   assert.equal(describeSkipReason('network', zhT), syncZh['history.autosyncReasonNetwork']);
   assert.equal(describeSkipReason('conflict', enT), syncEn['history.autosyncReasonConflict']);
-  // F1 残留（sync-locales.ts 在外部团队在改清单内，暂不能补键）—— 这三类的现状被钉住，
-  // 一旦补键就必须同时改这里，避免「悄悄漏掉一类」。
-  assert.equal(describeSkipReason('encrypted', zhT), '远端快照已加密，自动同步跳过（请手动同步）');
+  // F1 收口（t3）：encrypted / mutation-locked / 未知 三类也已补键，en 界面下不再透出中文
+  assert.equal(describeSkipReason('encrypted', zhT), syncZh['history.autosyncReasonEncrypted']);
+  assert.equal(describeSkipReason('encrypted', enT), syncEn['history.autosyncReasonEncrypted']);
+  assert.equal(describeSkipReason('mutation-locked', zhT), syncZh['history.autosyncReasonMutationLocked']);
+  assert.equal(describeSkipReason(undefined, zhT), syncZh['history.autosyncReasonUnknown']);
+  assert.equal(describeSkipReason(undefined, enT), syncEn['history.autosyncReasonUnknown']);
+  // 未知原因仍原样透出宿主回传的串（不吞信息）
   assert.equal(describeSkipReason('weird', zhT), 'weird');
-  assert.equal(describeSkipReason(undefined, zhT), '未知');
 });
 
 // issue #31：宿主统一以 'mutation-locked' 落历史（不细分 LOCKED/STALE）→ 界面不得透出裸 token。
@@ -217,16 +221,45 @@ test('client-F1：en 界面下自动同步行的三个标签必须全是英文
   assert.equal(row.status, 'Skipped');
 });
 
-test('client-F1 源码守卫：两个标签函数的函数体不得含中文字面量（文案只许来自字典）', () => {
+test('client-F1 源码守卫：标签函数体不得含中文字面量；跳过原因一律经 skipReasonKey 取字典键', () => {
   const src = fs.readFileSync(new URL('./history-model.ts', import.meta.url), 'utf8');
-  for (const fn of ['directionLabel', 'autosyncStatusLabel']) {
+  for (const fn of ['directionLabel', 'autosyncStatusLabel', 'describeSkipReason']) {
     const start = src.indexOf('export function ' + fn);
     assert.ok(start >= 0, fn + ' 必须存在（守卫需同步更新）');
     const end = src.indexOf('\n}', start);
     const body = src.slice(start, end < 0 ? src.length : end);
     assert.doesNotMatch(body, /[\u4e00-\u9fff]/, fn + ' 函数体内不得含中文字面量');
   }
+  // issue #79：映射抽到 skipReasonKey（历史行与自动同步状态行共用一份），守卫落点随之挪到它，
+  // 但硬约束不变：**文案只许来自字典**，且 describeSkipReason 不得再自带第二份 switch。
+  const mapStart = src.indexOf('export function skipReasonKey');
+  assert.ok(mapStart >= 0, 'skipReasonKey 必须存在（守卫需同步更新）');
+  const mapEnd = src.indexOf('\n}', mapStart);
+  const mapBody = src.slice(mapStart, mapEnd < 0 ? src.length : mapEnd);
   for (const key of ['history.autosyncReasonConflict', 'history.autosyncReasonNoRemote', 'history.autosyncReasonNotConfigured', 'history.autosyncReasonNetwork']) {
-    assert.ok(src.includes("t('" + key + "')"), 'describeSkipReason 必须走字典键 ' + key);
+    assert.ok(mapBody.includes("'" + key + "'"), 'skipReasonKey 必须映射字典键 ' + key);
   }
+  const reasonStart = src.indexOf('export function describeSkipReason');
+  const reasonEnd = src.indexOf('\n}', reasonStart);
+  const reasonBody = src.slice(reasonStart, reasonEnd < 0 ? src.length : reasonEnd);
+  assert.ok(reasonBody.includes('skipReasonKey('), 'describeSkipReason 必须经 skipReasonKey 取键');
+});
+
+/* ================================================================ issue #79 */
+
+test('issue #79：skipReasonKey —— 新旧码都映射到字典键，未知码返回 null（不猜）', () => {
+  assert.equal(skipReasonKey('conflict'), 'history.autosyncReasonConflict');
+  assert.equal(skipReasonKey('not-configured'), 'history.autosyncReasonNotConfigured');
+  // 宿主同一语义两处命名：历史写 'unconfigured'，两处必须同一文案
+  assert.equal(skipReasonKey('unconfigured'), 'history.autosyncReasonNotConfigured');
+  assert.equal(skipReasonKey('upToDate'), 'history.autosyncReasonUpToDate');
+  assert.equal(skipReasonKey('unchanged'), 'history.autosyncReasonUnchanged');
+  assert.equal(skipReasonKey('mutation-locked'), 'history.autosyncReasonMutationLocked');
+  assert.equal(skipReasonKey('future-code-from-newer-host'), null, '未知码不猜');
+  assert.equal(skipReasonKey(undefined), null);
+});
+
+test('issue #79：describeSkipReason 未知码保留宿主原串（不吞信息）', () => {
+  assert.equal(describeSkipReason('brand-new-reason', zhT), 'brand-new-reason');
+  assert.equal(describeSkipReason(undefined, zhT), syncZh['history.autosyncReasonUnknown']);
 });

package/src/client/sync/history-model.ts

@@ -6,6 +6,8 @@
  * + 自动同步 kind=autosync），投影需统一处理两源，并生成自动同步跳过冲突的可读明细。
  */
 import type { AutosyncHistoryEntry, SyncHistoryEntry } from './sync-api.ts'
+// 跳过原因码 → 字典键的映射键类型（**type-only**：不把 zh/en 目录按值带进本条 import）
+import type { SyncKey } from './sync-locales.ts'
 import type { TranslateNS } from '../client-types.ts'
 
 /** 同步命名空间翻译器（本文件的标签一律走它 —— 硬编码中文在英文界面下会原样透出）。 */
@@ -84,29 +86,42 @@ export function autosyncStatusLabel(status: AutosyncHistoryEntry['status'], t: S
 /**
  * 跳过原因 → 可读描述（host 透传语义；未知原因回退原串）。
  *
- * client-F1（部分修复）：conflict / no-remote / not-configured / network 四类走已存在的
- * history.autosyncReason* 字典键；encrypted / mutation-locked / 未知 三类**仍为字面中文**
- * —— 它们在 sync-locales.ts 里没有对应键，而该文件在外部团队在改清单内（不可写）。
- * 补键后这里一并字典化，见 findings.md 的 client-F1 defer 段。
+ * client-F1（本次收口）：conflict / no-remote / not-configured / network / encrypted /
+ * mutation-locked / 未知 **七类全部**走 history.autosyncReason* 字典键 —— 此前后三类是
+ * 硬编码中文（sync-locales.ts 当时不可写），英文界面下会原样透出。
  */
-export function describeSkipReason(reason: string | undefined, t: SyncTranslate): string {
+export function skipReasonKey(reason: string | undefined): SyncKey | null {
   switch (reason) {
-    case 'conflict': return t('history.autosyncReasonConflict');
-    case 'no-remote': return t('history.autosyncReasonNoRemote');
-    case 'not-configured': return t('history.autosyncReasonNotConfigured');
-    case 'network': return t('history.autosyncReasonNetwork');
-    // F1 残留（需新增 sync-locales 键 history.autosyncReasonEncrypted）
-    case 'encrypted': return '远端快照已加密，自动同步跳过（请手动同步）';
+    case 'conflict': return 'history.autosyncReasonConflict';
+    case 'no-remote': return 'history.autosyncReasonNoRemote';
+    case 'not-configured':
+    // issue #79：宿主同一语义两处命名（历史写 'unconfigured'，旧口径是 'not-configured'）→ 同一文案
+    case 'unconfigured': return 'history.autosyncReasonNotConfigured';
+    case 'network': return 'history.autosyncReasonNetwork';
+    case 'encrypted': return 'history.autosyncReasonEncrypted';
+    // issue #79：状态行新增两类（无变化 / 已是最新）——此前会落到 default 渲染裸码
+    case 'upToDate': return 'history.autosyncReasonUpToDate';
+    case 'unchanged': return 'history.autosyncReasonUnchanged';
     // issue #31：宿主侧的分类锁判定（LOCKED/STALE/UNKNOWN）统一以 'mutation-locked' 落历史，
     // 客户端拿不到细分 reason → 文案必须同时覆盖「活锁占用」与「残留锁需回收」两种可能，
     // 并给出可操作方向（否则界面只显示裸 token，用户无从判断要不要处理）。
-    // F1 残留（需新增 sync-locales 键 history.autosyncReasonMutationLocked）
-    case 'mutation-locked': return '环境锁被占用（另一项任务进行中，或存在需回收的残留锁）';
-    // F1 残留（需新增 sync-locales 键 history.autosyncReasonUnknown）
-    default: return reason ?? '未知';
+    case 'mutation-locked': return 'history.autosyncReasonMutationLocked';
+    // 未知原因：没有字典键（调用方决定回退策略）
+    default: return null;
   }
 }
 
+/**
+ * 跳过原因码 → 可读描述（历史行与自动同步状态行**共用同一份映射**）。
+ *
+ * 参数取「码 → 文案」的最小取词器（只要吃 SyncKey 即可），这样 UiT / 组件 t / 活目录
+ * 三种取词器都能直接传入，不必为了类型对齐再造一个包装。
+ */
+export function describeSkipReason(reason: string | undefined, t: (key: SyncKey) => string): string {
+  const key = skipReasonKey(reason);
+  return key === null ? (reason ?? t('history.autosyncReasonUnknown')) : t(key);
+}
+
 /** 把一条自动同步记录投影为展示行（摘要文本 + 可展开的被跳过冲突分区明细）。 */
 export interface AutosyncHistoryRow {
   id: string;