dsh-config-manager 0.1.78 → 0.1.79

package/lib/client.d.ts

@@ -6,7 +6,6 @@ window.__ModuleLoader__.load({
 
 import { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
 import { PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
-//#region src/schema/types.d.ts
 /**
  * 核心领域类型（Export Schema v1 的纯类型定义）。
  *
@@ -36,6 +35,44 @@ interface EncryptionInfo {
   authTag: string;
   version: number;
 }
+/**
+ * **外部来源包**的溯源块（manifest.foreign，2026-10-18 新增，纯 additive）。
+ *
+ * 为什么需要它：外部来源（Claude Code / Hermes / …）合成的包是**标准 bundle v1**，
+ * 落盘后与 DSH 自产备份**逐字同构** —— 事后无法复核「这包从哪来」。本块把来源标识、
+ * 读取位置、项目根、插件元数据与跳过聚合写进 manifest，供用户与界面核对。
+ *
+ * 三条纪律（与 src/foreign/types.ts 的 ForeignOrigin 同口径）：
+ *  ① **只放标识与计数，绝不放值**（凭据只有引用名，诊断只有机器码，无一字配置内容）；
+ *  ② 向后兼容：旧包没有该字段 ⇒ 缺省即合法；本字段的存在**绝不能**让旧/新包被拒；
+ *  ③ 缺字段即「不知道」，绝不填默认值假装知道。
+ */
+interface ManifestForeignOrigin {
+  /** 来源 agent id（稳定机器标识，如 claude-code / hermes；不随文案变化） */
+  agent: string;
+  /** 实际读取的位置（相对 home 的 POSIX 路径；不含任何值） */
+  locations?: string[];
+  /** 来源侧版本标记（读不到即省略） */
+  sourceVersion?: string;
+  /** 被扫描的项目根绝对路径（仅溯源，供用户核对；绝不进任何分区载荷） */
+  projects?: string[];
+  /** 插件清单（名称 / 版本 / 市场 / 来源仓库 / ref / 组件种类；**不含凭据**） */
+  plugins?: {
+    name: string;
+    version?: string;
+    marketplace?: string;
+    repo?: string;
+    ref?: string;
+    components?: string[];
+  }[];
+  /** 跳过与诊断汇总（机器码 + 条数，**不含任何值**） */
+  skipped?: {
+    code: string;
+    count: number;
+  }[];
+  /** 需要用户在目标机补录的凭据引用名（只有名字，**没有任何值**） */
+  credentialRefs?: string[];
+}
 /** 每个导出 ZIP 根部的 manifest.json */
 interface Manifest {
   schemaVersion: number;
@@ -59,6 +96,12 @@ interface Manifest {
    * 宽容读取：非字符串/缺失一律按「未知」处理（不重定基，不报错）。
    */
   sourceHome?: string;
+  /**
+   * **外部来源包的溯源块**（见 ManifestForeignOrigin）；DSH 自产备份没有该字段。
+   *
+   * 宽容读取：缺省 = 旧包（合法）；存在但形状/字段类型不对 = 仅 warning（绝不因此拒绝导入）。
+   */
+  foreign?: ManifestForeignOrigin;
   sections: Record<SectionId, boolean>;
   security: {
     containsSecrets: boolean;
@@ -66,8 +109,6 @@ interface Manifest {
     encryption: EncryptionInfo | null;
   };
 }
-//#endregion
-//#region src/schema/tombstones.d.ts
 /**
  * 删除墓碑（tombstone）机制（F4）：记录用户明确删除的条目，
  * 导入/恢复时据此过滤，防止「旧备份复活已删条目」。
@@ -84,8 +125,6 @@ interface Manifest {
  */
 /** 墓碑条目类型：插件 / 技能（skills 分区文件）/ 整个分区 / 其他文件（agentPresets 等文件类分区） */
 type TombstoneKind = 'plugin' | 'skill' | 'section' | 'file';
-//#endregion
-//#region src/core/types.d.ts
 interface ExportOptions {
   /** 是否包含真实秘密（必须配合 encryption 提供者；缺省 false = 只导状态） */
   includeSecrets: boolean;
@@ -569,8 +608,6 @@ interface ExportReport {
   };
   warnings: string[];
 }
-//#endregion
-//#region src/core/restore.d.ts
 type RestoreActionKind = 'hostFileRestore' | 'hostFileRemove' | 'pluginRemove' | 'fileRestore' | 'fileRemove' | 'credentialHint' | 'skip';
 interface RestoreAction {
   kind: RestoreActionKind;
@@ -650,8 +687,6 @@ interface SnapshotMeta {
   /** 置顶标记（P1-⑧）：置顶快照不参与自动保留清理（最多保留 N 个时的淘汰豁免） */
   pinned?: boolean;
 }
-//#endregion
-//#region src/utils/line-diff.d.ts
 /**
  * 行级文本 diff 内核（零依赖纯函数，node 可测）。
  *
@@ -694,8 +729,6 @@ interface DiffHunk {
   newCount: number;
   lines: DiffLine[];
 }
-//#endregion
-//#region src/core/snapshot-diff.d.ts
 /** 读取 / 统计上限（常量导出供测试与 UI 文案引用同一口径）。 */
 declare const SNAPSHOT_DIFF_LIMITS: {
   /** 完整 diff：单侧参与逐行对比的字节上限（超出 → 只报体积，不逐行对比） */
@@ -777,8 +810,6 @@ interface SnapshotFileDiff {
   reason?: SnapshotFileDiffReason;
   limits: typeof SNAPSHOT_DIFF_LIMITS;
 }
-//#endregion
-//#region src/profiles/dsh-profile-shared.d.ts
 /**
  * DSH profile 的**零依赖共享层**（host 与 client 双端复用）。
  *
@@ -938,8 +969,6 @@ interface DshProfileCopyResult {
   durationMs: number;
   warnings: DshProfileCopyWarning[];
 }
-//#endregion
-//#region src/core/run-registry.d.ts
 /** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份 / 快照恢复 / 配置档案切换 / recovery 恢复。 */
 type RunKind = 'export' | 'import' | 'autosync' | 'sync-apply' | 'backup-schedule' | 'restore' | 'profile-switch' | 'recovery';
 /** run 状态：进行中 / 完成 / 失败。 */
@@ -983,8 +1012,6 @@ interface RunState {
   createdAt: number;
   updatedAt: number;
 }
-//#endregion
-//#region src/core/migration-consult.d.ts
 type ConsultSourceType = 'export-zip' | 'local-snapshot' | 'remote-snapshot';
 type HealthVerdict = 'healthy' | 'needs-attention' | 'critical';
 type Recommendation = 'proceed' | 'review' | 'block';
@@ -1045,8 +1072,6 @@ interface ConsultReport {
   };
   generatedAt: string;
 }
-//#endregion
-//#region src/sync/retention-policy.d.ts
 /**
  * m-retention：保留策略（GFS 分层）纯函数层。
  *
@@ -1081,8 +1106,6 @@ interface RetentionPolicy {
   /** 每年保留份数（按 UTC 日历年分组，每年至多保留最新 1 份，最多覆盖 N 年） */
   keepYearly: number;
 }
-//#endregion
-//#region src/sync/backup-schedule-config.d.ts
 /** 定时备份间隔档位（全量备份无需太频繁；默认 24h）。
  *  - '6h' | '12h' | '24h' | '7d'：固定间隔；
  *  - 'custom'：每周固定时刻（见 customSchedule）。 */
@@ -1101,8 +1124,6 @@ interface BackupWeeklySchedule {
 }
 /** 最近一次定时备份执行状态 */
 type BackupRunStatus = 'success' | 'skipped' | 'failed';
-//#endregion
-//#region src/sync/backup-scheduler.d.ts
 interface BackupRunResult {
   status: BackupRunStatus;
   zip?: string;
@@ -1112,8 +1133,6 @@ interface BackupRunResult {
   error?: string;
   consecutiveFailures: number;
 }
-//#endregion
-//#region src/ui/backup-schedule.d.ts
 /** 设置草稿（表单编辑态：总开关 + 间隔档位 + 自定义周档 + 保留策略）。 */
 interface BackupScheduleDraft {
   enabled: boolean;
@@ -1136,8 +1155,6 @@ interface BackupScheduleStatus {
   lastRunStatus?: BackupRunStatus;
   lastRunMessage?: string;
 }
-//#endregion
-//#region src/utils/shared-constants.d.ts
 /**
  * 插件自更新（POST /update-apply）的失败码（**唯一声明处**：宿主 core/self-update.ts 与
  * 客户端关于页弹窗共用同一份字面量）。
@@ -1180,12 +1197,8 @@ type S3CompatProvider = (typeof S3_COMPAT_PROVIDERS)[number];
 declare const GIST_PROVIDER: 'gist';
 /** Gist 通道类型 */
 type GistProvider = typeof GIST_PROVIDER;
-//#endregion
-//#region src/security/container-kind.d.ts
 /** 备份容器形态。 */
 type BackupContainerKind = 'zip' | 'encrypted';
-//#endregion
-//#region src/sync/backup-files.d.ts
 /** 备份文件来源（UI Badge 展示） */
 type BackupFileSource = 'auto' | 'manual';
 /** 备份文件元信息（列表行数据；无敏感字段） */
@@ -1210,8 +1223,6 @@ interface BackupFileMeta {
    */
   containerType?: BackupContainerKind;
 }
-//#endregion
-//#region src/core/disk-usage.d.ts
 /** 体检子区（顺序即报告/展示顺序：先备份产物，再缓存/暂存，末位为只读保护的附加区） */
 declare const DISK_USAGE_AREAS: readonly ["exports", "snapshots", "sync", "marketCache", "marketWork", "tmp", "logs", "bootState", "migrationHistory", "transactions", "locks", "vault", "rollback-points"];
 /** 全部体检子区 id（= `DISK_USAGE_AREAS` 的元素类型） */
@@ -1293,12 +1304,8 @@ interface DiskUsageReport {
     latestBackupAt: string | null;
   };
 }
-//#endregion
-//#region src/core/session-health.d.ts
 /** 严重级（数组顺序 = 由重到轻；排序与展示都用这一份）。 */
 type SessionHealthSeverity = 'blocksStartup' | 'unloadable' | 'nextRequestFails' | 'invisible' | 'ok';
-//#endregion
-//#region src/ui/session-inventory-view.d.ts
 /** 路由返回的一行（与宿主 session-health 的 SessionHealthRow 同构；此处只取展示所需）。 */
 interface SessionHealthRowView {
   unitId: string;
@@ -1451,8 +1458,6 @@ interface SessionRepairRollbackResult {
   unitId?: string;
   sessionId?: string;
 }
-//#endregion
-//#region src/ui/i18n.d.ts
 /**
  * 客户端展示层（src/ui/*、src/client/common/*）的渲染文案目录（zh 源语言 / en 镜像）。
  *
@@ -1963,6 +1968,14 @@ declare const uiZh: {
   readonly 'foreign.skip.legacy-rules-file': '旧式规则文件：DSH 无对等结构，只报告';
   readonly 'foreign.skip.instructions-merged': '多份指令源被合并为一个全局指令文件';
   readonly 'foreign.skip.instructions-override-selected': '命中更高优先级的指令文件（override），按它导入';
+  readonly 'foreign.skip.unsupported-permissions': '权限规则（allow/ask/deny）未迁移：DSH 没有权限规则文件的对等结构，这些规则不在本包内，导入后不会生效';
+  readonly 'foreign.skip.unsupported-settings-keys': 'settings.json 里其余未迁移的顶层键：只记录键名与条数，键值一律不读取，也不会写进本包';
+  readonly 'foreign.skip.unsupported-agents': '.claude/agents/*.md 子代理定义未迁移：DSH 的子代理是运行时 provider 注册制，没有文件级对等结构';
+  readonly 'foreign.skip.unsupported-rules': '.claude/rules/*.md（带 frontmatter 作用域）未迁移：并入全局指令会丢掉作用域，故只报告不合并';
+  readonly 'foreign.skip.unsupported-plugins': 'Claude Code 插件本体未迁移：插件的 hooks / 命令靠 Claude 运行时执行，DSH 无法加载，插件代码一律不复制；插件自带的 skills 与 .mcp.json 里的 MCP 定义另行迁移';
+  readonly 'foreign.skip.session-id-mismatch': '会话记录里的 sessionId 与文件名不一致：DSH 按目录名/文件名定位会话，本次以文件名为准，记录里的 id 未采用';
+  readonly 'foreign.skip.mcp-server-id-conflict': '同名 MCP server 在多处出现（全局 / 项目级 / 插件）：先到先得，其余同名项只报告未迁移';
+  readonly 'foreign.skip.project-scan-truncated': '项目较多：项目级扫描只覆盖了上限内的项目，其余项目本次未读取，其配置不在本包内';
   readonly 'foreign.lossy.file-section-secrets.title': '文件类分区的明文不做剥离';
   readonly 'foreign.lossy.file-section-secrets.detail': '技能 / Agent 预设 / 全局指令 / 插件文件 / 历史会话 / 插件自身配置这六个文件类分区承载的是原始文件内容：命中的明文原样进包（导入侧只报告、不改写；本页的产包路径连扫描都不做）。「默认不含秘密」只对结构化分区成立，对这类分区不成立 —— 需要保密请先清理源文件。';
   readonly 'foreign.lossy.entry-backslash.title': '条目名中段反斜杠：跨平台落点可能不同';
@@ -2004,8 +2017,6 @@ declare const uiZh: {
 type UiTextKey = keyof typeof uiZh;
 /** UI 翻译函数：key → 当前语言文案（{param} 插值；未知键回退 zh/键名）。 */
 type UiT = (key: UiTextKey, params?: Record<string, string | number>) => string;
-//#endregion
-//#region src/ui/types.d.ts
 /**
  * GET /update-check 的结果。
  *
@@ -2085,6 +2096,22 @@ interface RecoveryIncident {
   reason: string;
   createdAt: string;
 }
+/**
+ * 正在**正常执行中**的操作（GET /recovery/status 的 `live`，加法字段）。
+ *
+ * 与 `incidents` 互斥：同一条 active journal 要么是「正在跑」（GLOBAL 锁由它持有、
+ * 且 journal.ownerInstanceId 与锁持有者一致），要么是「一次未正常完成的操作」。
+ * 判别只发生在宿主侧（single source = recovery-orchestrator 的 isLiveInFlight），
+ * 客户端只负责如实展示。
+ *
+ * 旧宿主不返回 → undefined（面板按「无进行中操作」处理）。
+ */
+interface RecoveryActiveOperation {
+  operationId: string;
+  operationType: string;
+  state: string;
+  startedAt: string;
+}
 /** GET /recovery/status 响应。 */
 interface RecoveryStatus {
   incidents: RecoveryIncident[];
@@ -2092,6 +2119,11 @@ interface RecoveryStatus {
     runId: string;
     status: string;
   }[];
+  /**
+   * 正在正常执行的操作（不是 incident）。用途：面板要能解释「为什么现在什么都点不动」——
+   * 此前这类操作被误报成事故，「执行恢复」永久灰、放弃恢复一直 423，用户拿不到任何原因。
+   */
+  live?: RecoveryActiveOperation[];
   /**
    * 环境锁状态摘要（issue #31）。纯残留锁**不是** journal：进程在 op 期间被杀时
    * `journalId: null`、`transactions/active/` 为空，incidents 恒为 []，而 423 文案却
@@ -2270,8 +2302,6 @@ interface RecoveryPort {
   /** POST /recovery/sessions/rollback（T8）：按台账里的 repairId 回滚一次修复（客户端不传路径）。 */
   rollbackSessionRepair(repairId: string): Promise<SessionRepairRollbackResult>;
 }
-//#endregion
-//#region src/client/session-export/session-export-view.d.ts
 /**
  * 「下载原始日志 (ZIP)」入口的**纯展示模型**（F-2，框架无关、node 可测）。
  *
@@ -2303,8 +2333,6 @@ interface SessionExportProbe {
   /** 探测时刻（ISO） */
   checkedAt: string;
 }
-//#endregion
-//#region src/foreign/types.d.ts
 /** 未能迁移的外部内容（响亮失败：宁可在计划里报出来，也不静默丢） */
 interface ForeignSkip {
   /** 稳定机器码（UI 用它映射文案；禁止渲染裸枚举） */
@@ -2381,9 +2409,23 @@ type ForeignSkipCode =
  * 该来源**没有自动根**（竞品 `defaultRoots.chatgpt = null`）—— 必须由用户显式给出导出文件
  * 路径；本机自动探测永远不会命中，如实报码而不是假装「未安装」。
  */
-'source-needs-explicit-path';
-//#endregion
-//#region src/ui/foreign-view.d.ts
+'source-needs-explicit-path' |
+/** settings.json 的 permissions（allow/ask/deny）：DSH 无权限规则文件对等结构，只报告条数 */
+'unsupported-permissions' |
+/** settings.json 里其余未迁移的顶层键（只记键名与条数，**值一律不读**） */
+'unsupported-settings-keys' |
+/** .claude/agents/*.md 子代理定义：DSH 的 subagent 是运行时 provider 注册制，无文件级对等结构 */
+'unsupported-agents' |
+/** .claude/rules/*.md 带 frontmatter 作用域：合并进全局指令会丢作用域，故只报告 */
+'unsupported-rules' |
+/** Claude Code 插件本体（插件 API / hooks / commands 的执行面）：DSH 无法加载，**绝不复制其代码** */
+'unsupported-plugins' |
+/** 会话记录里的 sessionId 与文件名 stem 不一致（DSH 以目录/文件名定位会话，故以文件名为准并如实报码） */
+'session-id-mismatch' |
+/** 同名 MCP server 在多处出现（全局 / 项目级 / 插件）：先到先得，其余只报告 */
+'mcp-server-id-conflict' |
+/** 项目级扫描触顶（maxProjects）：**不静默**，如实报码 */
+'project-scan-truncated';
 /** `GET /foreign-sources` 返回的一条来源检测结果（与宿主 ForeignSourceStatus 同构） */
 interface ForeignSourceStatusInput {
   id: string;
@@ -2400,8 +2442,6 @@ interface ForeignSourcesResponse$1 {
   projectScoped?: boolean;
   sources: readonly ForeignSourceStatusInput[];
 }
-//#endregion
-//#region src/client/common/http.d.ts
 /** 携带路由 JSON error 消息的错误类型（客户端所有请求错误的唯一类型）。 */
 declare class ConfigManagerApiError extends Error {
   /**
@@ -2416,8 +2456,6 @@ declare class ConfigManagerApiError extends Error {
   readonly code?: string;
   constructor(message: string, status?: number, code?: string);
 }
-//#endregion
-//#region src/client/api.d.ts
 /** Host 半健康检查响应（plugin 版本 / DSH 版本 / 平台，用于主页横幅与兼容性说明） */
 interface ServiceStatus {
   ready: boolean;
@@ -2877,8 +2915,6 @@ declare class ConfigManagerApi {
    *  返回分析 + 与当前配置的差异计划摘要（"装/导这个备份会动你什么"）。 */
   inspectBackup(zipPath: string): Promise<BackupInspectResult>;
 }
-//#endregion
-//#region src/sync/sync-engine.d.ts
 interface SyncPushReport {
   ok: boolean;
   snapshotId: string;
@@ -2887,6 +2923,12 @@ interface SyncPushReport {
   /** 分区级告警（单项失败不拖垮整体，§34.17 语义） */
   warnings: string[];
   message?: string;
+  /**
+   * 本次推送**被前置检测拒绝**（远端已被其它设备推进）：未写远端、未记基线、未改 sync-state。
+   * 这是「需要先合并远端」的冲突态，不是通道/凭据故障 —— 调用方（自动同步 / 路由）应按冲突处理，
+   * 而不是记成「同步失败」。
+   */
+  conflict?: boolean;
 }
 /** 差异报告中的单个变更项（PlanItem 摘要，不含敏感细节） */
 interface PullChange {
@@ -2927,8 +2969,6 @@ interface SyncPushPreview {
   credentialsIncluded: boolean;
   message?: string;
 }
-//#endregion
-//#region src/sync/sync-config.d.ts
 /** 同步通道类型（由 SYNC_CHANNELS 派生；host 侧与 client 半统一引用）。 */
 type SyncTransportType$1 = (typeof SYNC_CHANNELS)[number];
 /** S3 兼容系通道的回传视图：**只带 secretStored 标记，绝不带密钥值**。 */
@@ -2951,8 +2991,6 @@ interface CloudGistChannelView {
   filePrefix: string;
   secretStored: boolean;
 }
-//#endregion
-//#region src/client/sync/sync-api.d.ts
 /**
  * 远程同步通道类型：git（默认）或 webdav。
  * **唯一来源** = 宿主 src/sync/sync-config.ts 的 SYNC_CHANNELS（此处仅 type-only 别名：
@@ -2962,6 +3000,11 @@ type SyncTransportType = SyncTransportType$1;
 /** GET /sync/status 响应：配置/凭据/上次同步的只读事实（无任何 secret 值） */
 interface SyncStatusResponse {
   ok: boolean;
+  /**
+   * 方案 A：是否存在同步基线（本地祖先指针；宿主只回布尔，绝不回快照 id）。
+   * **缺省 undefined = 未知 → 一律按「无基准」处理**，走老导入确认路径（fail-safe）。
+   */
+  hasBaseline?: boolean;
   /** 是否已保存过仓库/通道配置（sync-config.json；任一通道配置过即为 true） */
   configured: boolean;
   /** git 通道：已配置的仓库地址（不含 token，可回显；与当前通道无关，配置过即返回） */
@@ -3030,6 +3073,8 @@ interface SyncWorkDirFacts {
   ahead: number | null;
   /** 工作树是否有未提交改动（仅 detail 自检时给出，否则 null） */
   dirty: boolean | null;
+  /** 远端分支上的快照数（仅 detail 自检时给出，否则 null；issue #104 建议 3） */
+  remoteSnapshots: number | null;
 }
 /** 同步密码的保存状态（只回布尔；密码值永不回传浏览器）。 */
 interface SyncPasswordState {
@@ -3188,6 +3233,37 @@ interface SyncPullPayload extends SyncPushPayload {
   /** 解密密码（拉取/一键同步遇到加密快照时提供；仅内存传输，绝不落盘） */
   decryptPassword?: string;
 }
+/**
+ * POST /sync/probe 结果。
+ *
+ * **失败也是正常返回**（HTTP 200 + \`ok:false\`）：测试连接是**预期会失败**的诊断动作，
+ * 用 5xx 表达会被界面当成基础设施崩溃。\`message\` / \`hint\` 由通道层本地化并脱敏后原样带回。
+ */
+interface SyncProbeSuccess {
+  ok: true;
+  transport: string;
+  /** 结论（可直接展示的成功文案） */
+  message: string;
+  /** 附加提醒（例如「该 S3 兼容端点应把 region 填成 xxx」），有值时界面按 warn 级展示 */
+  hint?: string;
+  /** 远端已有快照数（取得时回传） */
+  snapshotCount?: number;
+  /** 自检过程中**自动创建**的远端目录（webdav 幂等 MKCOL；界面须逐条说明，绝不静默写远端） */
+  createdCollections?: string[];
+}
+/** 自检失败（诊断动作的预期结果，不是异常） */
+interface SyncProbeFailure {
+  ok: false;
+  error: string;
+  /**
+   * **能力边界标记**：该通道不提供连通性自检（传输层未实现 probe）。
+   *
+   * 与故障**严格区分**：true = 这个通道没有这项能力（中性提示，同步功能不受影响）；
+   * 缺省/undefined = 真的没连通（按故障展示）。界面据此选 info 而不是「操作失败」。
+   */
+  unsupported?: boolean;
+}
+type SyncProbeResult = SyncProbeSuccess | SyncProbeFailure;
 /** GET /sync/snapshots-list 响应：远端历史快照列表（按 createdAt 倒序）。 */
 interface SyncSnapshotsListResponse {
   ok: boolean;
@@ -3213,6 +3289,14 @@ interface SyncSnapshotLite {
   sectionCount: number;
   platform: string;
   dshVersion: string;
+  /**
+   * cloud-sync 借鉴项 ⑥：推送方设备身份（宿主从快照 manifest 读出）。
+   * **旧快照没有这两个字段** —— 界面必须据此不显示设备行，绝不把 undefined 渲染成文案、
+   * 也不显示空串占位。
+   */
+  deviceName?: string;
+  /** 稳定设备 id（换主机名/改机器名都不变；用于认出「同一台设备」）。 */
+  deviceId?: string;
 }
 /** POST /sync/sync 请求体（一键同步第一步：拉取 → 差异确认会话）。 */
 interface SyncStartPayload extends SyncPushPayload {
@@ -3343,14 +3427,117 @@ interface SyncRollbackFailedItem {
   reason: string;
   manualHint?: string;
 }
+/**
+ * 合并冲突成因（对齐宿主 src/sync/merge.ts 的 MergeConflictReason）。
+ * 未在本联合里的字符串照样可能从宿主回传 —— 界面侧一律经 merge-view.ts 的
+ * mergeReasonKey() 映射，未知值按 both-modified 措辞，**绝不渲染裸枚举**。
+ */
+type MergeConflictReason = 'both-modified' | 'modify-delete' | 'delete-modify' | 'no-ancestor' | 'binary' | 'format' | 'array' | 'section';
+/** 分区级合并决策（'conflict' = 双侧改动重叠，必须由用户裁决）。 */
+type MergeSectionDecision = 'useRemote' | 'keepLocal' | 'merge' | 'skip' | 'conflict';
+/** 单条冲突的三列预览（已由宿主脱敏/序列化，界面负责截断）。 */
+interface MergePreviewConflict {
+  /** 冲突位置：JSON 分区是 top-level key；FilesSection 是 relativePath。 */
+  path: string;
+  kind: 'key' | 'file';
+  reason?: MergeConflictReason;
+  localPreview: string;
+  remotePreview: string;
+  ancestorPreview: string;
+}
+/** 单个分区的合并预览。 */
+interface MergePreviewSection {
+  id: SectionId;
+  decision: MergeSectionDecision;
+  /** 自动合并并入的变更点数量（仅自动合并成功时有意义） */
+  autoMerged?: number;
+  conflictCount: number;
+  conflicts: MergePreviewConflict[];
+}
+/** 预览摘要（可自动应用 / 待裁决 / 冲突条目 / 无变化）。 */
+interface MergePreviewSummary {
+  auto: number;
+  review: number;
+  conflicts: number;
+  skipped: number;
+}
+/** POST /sync/merge-preview 请求体（只读；密码仅内存传输，绝不落盘/落日志）。 */
+interface MergePreviewPayload {
+  /** 远端快照 id；缺省 = 最新 */
+  snapshotId?: string;
+  /** 解密密码（仅当远端快照加密时使用；缺省 = 已保存的 DECRYPT 凭据） */
+  decryptPassword?: string;
+  /** 跨机路径映射（与一键同步同一口径） */
+  pathMappings?: PathMapping[];
+}
+/** POST /sync/merge-preview 响应（只读三方合并结果）。 */
+interface MergePreviewResponse {
+  ok: boolean;
+  snapshotId: string;
+  /** 是否存在共同基准快照（false = 退化为两方比较，双侧不一致一律按冲突） */
+  hasAncestor: boolean;
+  sections: MergePreviewSection[];
+  summary: MergePreviewSummary;
+  /** 失败/降级原因（仅在 ok=false 等场景出现） */
+  message?: string;
+}
+/** 单条裁决动作。 */
+type MergeResolutionActionWire = 'keepLocal' | 'useRemote' | 'useMerged' | 'skip';
+/** 单条裁决：id = 分区 id（分区级）或 `分区id::冲突路径`（冲突级，见 merge-view.ts）。 */
+interface MergeResolution {
+  id: string;
+  action: MergeResolutionActionWire;
+}
+/** POST /sync/apply-merge 请求体（写动作；过 mutation gate）。 */
+interface MergeApplyPayload extends MergePreviewPayload {
+  resolutions: MergeResolution[];
+}
+/** POST /sync/apply-merge 响应（字段与 /sync/apply-items 同风格 + pendingConflicts）。 */
+interface MergeApplyResponse {
+  ok: boolean;
+  applied: string[];
+  skipped: string[];
+  needsRestart?: boolean;
+  warnings: string[];
+  /** 执行前快照 id（界面一键回滚用） */
+  restoreId?: string;
+  /** 任一失败是否整体回滚 */
+  rolledBack?: boolean;
+  /** 整体回滚是否完整（false = 有项未恢复，见 warnings；缺省 = 旧宿主未回传） */
+  rollbackFull?: boolean;
+  /** 执行后仍待裁决的分区（下次同步仍会出现） */
+  pendingConflicts: SectionId[];
+  failed?: {
+    itemId: string;
+    message?: string;
+  }[];
+  ineffective?: {
+    itemId: string;
+    adapter: string;
+    message?: string;
+  }[];
+  historyWriteError?: string;
+}
 /** 统一间隔类型。 */
 type AutosyncInterval = '5m' | '15m' | '30m' | '60m' | '6h' | '12h' | '24h';
 /** 最近一次自动同步执行状态。 */
 type AutosyncRunStatus = 'success' | 'skipped' | 'failed' | 'partial';
+/** 自动应用的最高风险等级（low = 只自动落低风险分区；medium = plugins/mcp 也自动落盘）。 */
+type AutosyncAutoApplyTier = 'low' | 'medium';
+/** 双侧都改（真冲突）时的策略（ask = 保留冲突待人工裁决；local = 保留本机并推上去）。 */
+type AutosyncConflictPolicy = 'ask' | 'local';
 /** GET/POST /sync/autosync 响应：自动同步状态。 */
 interface AutosyncStatusResponse {
   enabled: boolean;
   interval: AutosyncInterval;
+  /** 真·自动同步：本地改动即时触发（缺省 true；host 读取层已补缺省） */
+  realtime?: boolean;
+  /** realtime 下的远端轮询间隔（ms；缺省 60000） */
+  remoteCheckMs?: number;
+  /** 自动应用的最高风险等级（缺省 medium：plugins/mcp 也自动落盘） */
+  autoApplyTier?: AutosyncAutoApplyTier;
+  /** 双侧都改时的策略（缺省 local：保留本机并推上去） */
+  conflictPolicy?: AutosyncConflictPolicy;
   lastRunAt?: string;
   lastRunStatus?: AutosyncRunStatus;
   lastRunMessage?: string;
@@ -3374,6 +3561,14 @@ interface AutosyncUpdatePayload {
   enabled: boolean;
   interval?: AutosyncInterval;
   startupMinIntervalMs?: number;
+  /** 本地改动即时触发（缺省 true） */
+  realtime?: boolean;
+  /** realtime 下的远端轮询间隔（ms；宿主 clamp 到 15s–1h） */
+  remoteCheckMs?: number;
+  /** 自动应用等级（缺省 medium） */
+  autoApplyTier?: AutosyncAutoApplyTier;
+  /** 冲突策略（缺省 local） */
+  conflictPolicy?: AutosyncConflictPolicy;
 }
 /** 自动同步执行记录（§3.7 AutosyncHistoryEntry）。 */
 interface AutosyncHistoryEntry {
@@ -3487,12 +3682,14 @@ declare class SyncApi {
    * 重建 git 工作副本（issue #79 的自救入口）。
    *
    * - `relink`：只把 origin / push URL 重指向当前配置地址（非破坏性，不碰工作树与本地提交）；
+   * - `adopt`：把当前地址的远端历史合并进工作副本（issue #104：换仓库 / 远端历史被重写后两条历史
+   *   不相交，pull --ff-only 永远失败）。不改写本地提交、可 `git revert`，冲突由 host 自动 `merge --abort`；
    * - `reclone`：删除工作副本后重新 clone（**丢弃未上行的本地提交**）→ 必须带 `confirm: true`。
    *
    * 写动作：host 侧过 mutation gate（SAFE MODE / 环境锁）。
    */
   workdirReset(payload: {
-    mode: 'relink' | 'reclone';
+    mode: 'relink' | 'adopt' | 'reclone';
     confirm?: boolean;
   }): Promise<{
     ok: boolean;
@@ -3501,6 +3698,13 @@ declare class SyncApi {
       facts: SyncWorkDirFacts;
     };
   }>;
+  /**
+   * cloud-sync 借鉴项 ②：连通性自检（**只读**）。
+   *
+   * 失败回 \`ok:false\` 而非抛错 —— 调用方必须按 \`result.ok\` 分流，把失败当**结论**展示，
+   * 不要落进 catch（否则「连不上」会被渲染成崩溃）。
+   */
+  probe(payload: SyncPushPayload): Promise<SyncProbeResult>;
   /**
    * 分区条目清单（复用 /export-preview；**只读**，不写任何内容）。
    *
@@ -3597,6 +3801,20 @@ declare class SyncApi {
   rollback(payload: {
     restoreId: string;
   }): Promise<SyncRollbackResponse>;
+  /**
+   * T-ui-merge：远程合并**只读**预览（三方合并 + 冲突清单 + 摘要），零写入。
+   *
+   * 与 /sync/sync 的区别：这里不做导入计划、不登记同步会话，只回答「远端与本地差在哪、
+   * 哪些分区需要我裁决」；密码只在请求体内传输（宿主绝不回传/落日志）。
+   */
+  mergePreview(payload?: MergePreviewPayload): Promise<MergePreviewResponse>;
+  /**
+   * T-ui-merge：按逐项裁决执行合并（写动作，宿主侧过 mutation gate）。
+   *
+   * 返回 pendingConflicts = 执行后**仍**待裁决的分区：界面据此告诉用户
+   * 「跳过 ≠ 已解决，下次同步仍会出现」，而不是把一次带 skip 的执行报成「已解决」。
+   */
+  applyMerge(payload: MergeApplyPayload): Promise<MergeApplyResponse>;
   /** Phase 7 迁移前咨询（只读健康评分 + 建议）：对远端快照生成咨询报告。 */
   consult(input: {
     type: 'remote-snapshot';
@@ -3604,8 +3822,6 @@ declare class SyncApi {
     snapshotId?: string;
   }): Promise<ConsultReport>;
 }
-//#endregion
-//#region src/market/types.d.ts
 /**
  * 发布模式（F6 迁移/分享双模式，借鉴 dsh-packer config.personalPatterns 同源设计）：
  *  - 'migrate'（缺省）：迁移模式，同一份数据全带（只受 BANNED 分区与字面量凭据扫描约束）；
@@ -3749,8 +3965,6 @@ interface MarketPrepareResponse {
   /** 供应链警示（恒生成：发布即公开、未经审核） */
   warnings: string[];
 }
-//#endregion
-//#region src/client/market/market-api.d.ts
 /** 配置市场浏览器半数据入口（备份与迁移页第 5 个 tab 的注入业务面） */
 declare class MarketApi {
   readonly t: UiT;
@@ -3773,8 +3987,6 @@ declare class MarketApi {
   /** 发布包下载 URL（受控临时区 zip；经宿主 /download 端点，无凭据、无写操作） */
   downloadPublishUrl(zipPath: string): string;
 }
-//#endregion
-//#region src/market/my-repo.d.ts
 /** 条目收录状态：未收录（本地独有）｜ PR 待审核（带 PR 链接）｜ 已收录（官方市场 index 含该 id） */
 type MyItemStatus = 'not-listed' | 'pr-pending' | 'listed';
 /** 上传表单：仅用户填写的描述性内容；id/author/version/updatedAt/repoUrl 全自动 */
@@ -3865,8 +4077,6 @@ interface MyItemEntry {
   /** 用户公开仓库（<login>/dsh-configs）的 star 数（仓库级；undefined = 无数据） */
   stars?: number;
 }
-//#endregion
-//#region src/client/market/my-configs-api.d.ts
 /**
  * POST /me/status 响应：登录态 + 用户配置仓库状态（设计文档 §4.2）。
  * 仅非敏感展示位：login 用户名可回显；token 值永不回传浏览器。
@@ -3926,8 +4136,6 @@ declare class MyConfigsApi {
   /** 删除条目（同步删本地索引+文件；已收录自动后台提下架 PR；待审核自动关闭收录 PR） */
   meDelete(itemId: string): Promise<DeleteResult>;
 }
-//#endregion
-//#region src/core/session-repair.d.ts
 /** 单条会话的修复原因（机器可读；文案由 CLI 输出层决定）。 */
 type SessionRepairReason =
 /** header 里没有 cwd（DSH 的 _no-cwd 会话）：无法判定目标目录 */
@@ -3969,8 +4177,6 @@ interface SessionRepairSummary {
   /** 受影响的重复 id 条数（同一 id 的多份只算一次） */
   duplicates: number;
 }
-//#endregion
-//#region src/ui/session-layout-view.d.ts
 /** E1 计划里的一条动作（**不含绝对路径**：身份 = `<fromProjectKey>/<sessionId>`）。 */
 interface SessionLayoutPlanItemView {
   unitId: string;
@@ -4025,8 +4231,6 @@ interface SessionLayoutApplyView {
  * 判别：执行结果带 `results` 数组，计划带 `actions`/`needsKeep`。
  */
 type SessionLayoutResponse = SessionLayoutPlanView | SessionLayoutApplyView;
-//#endregion
-//#region src/ui/rollback-view.d.ts
 /** 只保留两态（S2）：工作区 + 会话。 */
 declare const ROLLBACK_STATES: readonly ['workspace', 'session'];
 type RollbackState = (typeof ROLLBACK_STATES)[number];
@@ -4364,6 +4568,12 @@ interface RollbackSegmentResult {
   /** 无法安全撤销 ⇒ 未写（宿主回传才有） */
   unavailableCount?: number;
   unavailablePaths?: string[];
+  /**
+   * **落点无人认领**（时间窗证据表明那一刻没有任何会话活跃：手改 / 外部工具 / 另一个进程）
+   * ⇒ 未写（宿主回传才有）。与 unavailableCount 分开：成因不同，用户要做的事也不同。
+   */
+  externalCount?: number;
+  externalPaths?: string[];
   /** 写入前发现又被改过（并发）⇒ 未写（宿主回传才有） */
   concurrentCount?: number;
   concurrentPaths?: string[];
@@ -4440,8 +4650,6 @@ interface RollbackPointPort {
     includeGuards: boolean;
   }): Promise<RollbackPurgeResult>;
 }
-//#endregion
-//#region src/client/recovery/recovery-api.d.ts
 /** Recovery 浏览器半数据入口（实现 RecoveryPort 契约 + rollback-points 族）。 */
 declare class RecoveryApi implements RecoveryPort, RollbackPointPort {
   readonly t: UiT;
@@ -4573,8 +4781,6 @@ declare class RecoveryApi implements RecoveryPort, RollbackPointPort {
    */
   clearSafeMode(userConfirmed: boolean): Promise<RecoverySafeModeClearResult>;
 }
-//#endregion
-//#region src/core/migration-history.d.ts
 /** 合法 kind 集合（§5 COMPLETE 清单 + 评审补 'profile-import'）。 */
 declare const MIGRATION_KINDS: readonly ['import', 'restore', 'rollback', 'profile-create', 'profile-select', 'profile-switch', 'profile-delete', 'profile-rename', 'profile-save', 'profile-import', 'sync-apply', 'autosync', 'recovery', 'backup', 'backup-manual', 'snapshot-delete', 'snapshot-prune'];
 /** §5 覆盖的操作 kind（COMPLETE 不变量；常量枚举，天然非敏感）。 */
@@ -4619,8 +4825,6 @@ interface MigrationHistoryStats {
   byKind: Partial<Record<MigrationKind, number>>;
   byResult: Partial<Record<MigrationResult, number>>;
 }
-//#endregion
-//#region src/client/history/history-api.d.ts
 /** 列表查询返回体。 */
 interface HistoryListResult {
   ok: boolean;
@@ -4660,8 +4864,6 @@ declare class HistoryApi {
   }>;
   private buildExportUrl;
 }
-//#endregion
-//#region src/client/recovery/incident-api.d.ts
 /** 崩溃归因分类（与 core/crash-report.ts 的 CrashKind 同构）。 */
 type CrashKind = 'session-corrupt' | 'bundle-check' | 'patch-tree' | 'unknown';
 /** 建议动作（与 core/crash-report.ts 的 CrashAdvice 同构）。 */
@@ -4709,8 +4911,6 @@ declare class IncidentApi {
   /** POST /rescue {action:off}：退出救援模式（从备份完整还原）。 */
   rescueOff(): Promise<RescueActionResult>;
 }
-//#endregion
-//#region src/client/client-types.d.ts
 /** 本插件 Client 半的注入业务面：每个 settings.section 注册项都拿到同一个 api 实例 */
 interface ConfigManagerSectionInjected {
   api: ConfigManagerApi;
@@ -4740,8 +4940,6 @@ interface ConfigManagerSectionInjected {
    */
   uiT: UiT;
 }
-//#endregion
-//#region src/client/locales.d.ts
 /**
  * Config Manager 表面文案：zh 为源语言，en 镜像每个键。
  * 字典 namespace 由 client/index.ts 注册（declare module 合并进 LocaleNamespaceMap）。
@@ -5521,6 +5719,7 @@ declare const zh$4: {
   readonly 'library.kind.snapshot': '本机快照';
   readonly 'library.kind.backupFile': '备份文件';
   readonly 'library.kind.remote': '远端快照';
+  readonly 'library.remoteDevice': '由 {device} 推送';
   readonly 'library.kind.market': '市场配置';
   readonly 'library.title': '产物库';
   readonly 'library.refresh': '刷新';
@@ -5647,8 +5846,6 @@ declare const zh$4: {
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type ConfigManagerKey = keyof typeof zh$4;
-//#endregion
-//#region src/client/sync/sync-locales.d.ts
 /**
  * 远程同步设置区块（config-manager-sync）表面文案：zh 为源语言，en 镜像每个键。
  * 独立命名空间、独立文件：不触碰共享的 locales.ts（并行会话已改），零冲突。
@@ -5696,11 +5893,18 @@ declare const zh$3: {
   readonly 'workdir.missing': '尚未创建（首次同步时克隆）';
   readonly 'workdir.unknown': '读不出工作副本状态';
   readonly 'workdir.relink': '重指向仓库地址';
+  readonly 'workdir.adopt': '采纳远端历史';
+  readonly 'workdir.adoptHint': '把远端的提交历史合并进本机工作副本（用于「换了仓库或远端历史被重写」后无法合并的情况）。不会改写本地提交，合并后可 git revert 撤销；一旦冲突会自动撤销这次合并，工作副本回到操作前。';
   readonly 'workdir.reclone': '重新克隆工作副本';
   readonly 'workdir.recloneConfirmTitle': '重新克隆工作副本？';
   readonly 'workdir.recloneConfirmMessage': '将删除本机工作副本目录并从远端重新克隆。本机配置与远端快照都不受影响，但工作副本里尚未推送的本地提交会被丢弃 —— 需要时请先在同步页执行一次推送。';
   readonly 'workdir.recloneConfirm': '重新克隆';
+  readonly 'workdir.ahead': '未上传的本地提交';
+  readonly 'workdir.remoteSnapshots': '远端快照数';
+  readonly 'workdir.backlogAhead': '有本地提交还没上传到远端';
+  readonly 'workdir.backlogNeverSynced': '本地领先，但远端从未收到过快照 —— 这条通道可能一直没在真正备份';
   readonly 'toast.workdirRelinked': '工作副本已重指向当前仓库地址';
+  readonly 'toast.workdirAdopted': '已采纳远端历史（本地提交未改写，已生成一次合并提交）';
   readonly 'toast.workdirRecloned': '工作副本已重新克隆';
   readonly 'toast.workdirResetFailed': '重建工作副本失败';
   readonly 'syncStatus.lastSync': '上次同步';
@@ -5771,7 +5975,9 @@ declare const zh$3: {
   readonly 'warnings.title': '分区告警';
   readonly 'syncflow.title': '一键同步';
   readonly 'syncflow.button': '一键同步';
+  readonly 'syncflow.upToDate': '已是最新，无需同步';
   readonly 'syncflow.syncing': '正在同步…';
+  readonly 'syncflow.checkingRemote': '正在检查远端变更…';
   readonly 'syncflow.syncFailed': '同步失败';
   readonly 'syncflow.snapshotOption': '（{date} · {count} 分区）';
   readonly 'syncflow.selectSnapshot': '选择历史快照';
@@ -5865,7 +6071,17 @@ declare const zh$3: {
   readonly 'autosync.description': '开启后，DSH 在后台保持配置一致：本地配置有改动时自动上传，检测到远端有新快照时才自动拉取合并；定时器仅作兜底轮询，无变化不重复动作。仅在无冲突且无需人工干预时才自动写入本地。';
   readonly 'autosync.enable': '启用自动同步';
   readonly 'autosync.interval': '兜底轮询间隔';
-  readonly 'autosync.intervalHint': '间隔到点 / DSH 启动时检查远端是否有新快照，有才拉取合并（不上传本地）；本地配置改动会触发上传。';
+  readonly 'autosync.intervalHint': '兜底检查节奏：间隔到点 / DSH 启动时检查远端是否有新快照，有才拉取合并。启用「本地改动即时同步」后，保存配置会立刻触发一轮，不必等这里。';
+  readonly 'autosync.realtime': '本地改动即时同步';
+  readonly 'autosync.realtimeHint': '监听本机可同步的配置（settings.yaml、cordis.patch.yml、skills、profiles 下的插件清单等），保存后立即上传；关闭则只在兜底间隔到点时检查。';
+  readonly 'autosync.autoApplyTier': '自动应用范围';
+  readonly 'autosync.autoApplyTierHint': '决定远端改动能自动写回本机的范围：「仅低风险分区」= settings / ui / providers / prompts / skills 等；「含 plugins 与 mcp」= 连中风险分区也自动落盘（缺省）。凭据、插件数据类分区永不自动写入。';
+  readonly 'autosync.tierLow': '仅低风险分区';
+  readonly 'autosync.tierMedium': '含 plugins 与 mcp（推荐）';
+  readonly 'autosync.conflictPolicy': '双侧都改时';
+  readonly 'autosync.conflictPolicyHint': '本机与远端都改了同一分区时：「保留本机并推上去」= 本机版本成为新的远端最新（被覆盖的远端快照仍在历史里，可回滚）；「保留冲突待我确认」= 上下行都停下，等你在同步页裁决。';
+  readonly 'autosync.conflictLocal': '保留本机并推上去';
+  readonly 'autosync.conflictAsk': '保留冲突待我确认';
   readonly 'autosync.interval5m': '5 分钟';
   readonly 'autosync.interval15m': '15 分钟';
   readonly 'autosync.interval30m': '30 分钟';
@@ -5908,6 +6124,7 @@ declare const zh$3: {
   readonly 'history.autosyncReasonEncrypted': '远端快照已加密，自动同步跳过（请手动同步）';
   readonly 'history.autosyncReasonMutationLocked': '环境锁被占用（另一项任务进行中，或存在需回收的残留锁）';
   readonly 'history.autosyncReasonUnknown': '未知';
+  readonly 'history.autosyncReasonConflictKeptLocal': '已按策略保留本机并覆盖远端';
   readonly 'history.autosyncReasonUpToDate': '无变化（本地与远端一致）';
   readonly 'history.autosyncReasonUnchanged': '远端无新快照，无需合并';
   readonly 'history.autosyncConflicted': '跳过冲突分区：{sections}';
@@ -6014,11 +6231,96 @@ declare const zh$3: {
   readonly 'cloud.apiBaseUrlInvalid': 'API 根地址必须是 http(s) 且不含用户名/密码';
   readonly 'cloud.secretWriterRequired': '宿主未提供凭据写入通道，无法保存密钥';
   readonly 'cloud.credentialsWriteFailed': '密钥写入 DSH 凭据失败（配置未保存）';
+  readonly 'merge.title': '远程合并';
+  readonly 'merge.subtitle': '读取远端快照做三方合并（本地 / 远端 / 共同基准），列出需要你裁决的分区；预览阶段零写入。';
+  readonly 'merge.entry': '检查远程合并';
+  readonly 'merge.entryHint': '只读：先看远端与本地差在哪、哪些分区需要裁决。不会写任何内容。';
+  readonly 'merge.loading': '正在读取远端快照并合并…';
+  readonly 'merge.reload': '重新预览';
+  readonly 'merge.empty': '没有需要合并的内容';
+  readonly 'merge.emptyHint': '远端与本地一致，或当前没有分区参与同步。';
+  readonly 'merge.noAncestor': '没有共同基准快照：合并退化为两方比较，两侧不一致的分区一律按冲突处理，需要你逐个裁决。';
+  readonly 'merge.summary.auto': '可自动应用';
+  readonly 'merge.summary.review': '待裁决';
+  readonly 'merge.summary.conflicts': '冲突';
+  readonly 'merge.summary.skipped': '无变化';
+  readonly 'merge.section.title': '分区裁决';
+  readonly 'merge.scopeNotice': '冲突按分区整体裁决（本版不做逐条裁决）。';
+  readonly 'merge.skipNotice': '跳过 ≠ 已解决：跳过的冲突不会推进同步基线，下次同步仍会出现。';
+  readonly 'merge.decision.useRemote': '采用远端';
+  readonly 'merge.decision.keepLocal': '保留本地';
+  readonly 'merge.decision.merge': '自动合并';
+  readonly 'merge.decision.skip': '无变化';
+  readonly 'merge.decision.conflict': '需裁决';
+  readonly 'merge.kind.key': '键';
+  readonly 'merge.kind.file': '文件';
+  readonly 'merge.reason.bothModified': '两侧都改动了同一位置';
+  readonly 'merge.reason.modifyDelete': '一侧改动、另一侧删除';
+  readonly 'merge.reason.deleteModify': '一侧删除、另一侧改动';
+  readonly 'merge.reason.noAncestor': '没有共同基准，无法判断谁改动了';
+  readonly 'merge.reason.binary': '二进制内容无法安全合并';
+  readonly 'merge.reason.format': '内容格式不支持自动合并';
+  readonly 'merge.reason.array': '数组无法按位置合并';
+  readonly 'merge.reason.section': '整个分区冲突';
+  readonly 'merge.conflictCount': '{n} 处冲突';
+  readonly 'merge.autoMergedCount': '已自动并入 {n} 处改动';
+  readonly 'merge.col.path': '冲突位置';
+  readonly 'merge.col.local': '本地';
+  readonly 'merge.col.remote': '远端';
+  readonly 'merge.col.ancestor': '基准';
+  readonly 'merge.preview.empty': '（空）';
+  readonly 'merge.action.useLocal': '采用本地';
+  readonly 'merge.action.useRemote': '采用远端';
+  readonly 'merge.action.useMerged': '采用自动合并';
+  readonly 'merge.action.useMergedDisabled': '该分区没有可用的自动合并结果（两侧改动重叠），只能采用一侧或跳过。';
+  readonly 'merge.action.skip': '跳过';
+  readonly 'merge.action.current': '当前裁决';
+  readonly 'merge.bulk.keepLocal': '全部采用本地';
+  readonly 'merge.bulk.useRemote': '全部采用远端';
+  readonly 'merge.bulk.useMerged': '全部采用自动合并';
+  readonly 'merge.bulk.autoOnly': '仅处理无冲突项';
+  readonly 'merge.bulk.leavePending': '冲突留到下次';
+  readonly 'merge.bulk.hint': '「全部采用自动合并」只对真有自动合并结果的分区生效；「冲突留到下次」把需要你裁决的分区全部移出本次操作（不写入、不推进基线），下次同步它们还会出现。';
+  readonly 'merge.bulk.title': '批量';
+  readonly 'merge.apply': '执行合并';
+  readonly 'merge.applying': '执行中…';
+  readonly 'merge.apply.nothing': '当前没有会产生写入的裁决：所有待裁决分区都停在「跳过」。';
+  readonly 'merge.apply.summary': '已裁决 {decided} / 待裁决 {needs} 个分区';
+  readonly 'merge.apply.skips': '其中 {n} 个是「跳过」（不会推进同步基线）';
+  readonly 'merge.apply.undecided': '还有 {n} 个分区未裁决（未裁决不会被执行，等同跳过）。';
+  readonly 'merge.apply.pendingHint': '还有 {n} 个分区待裁决：本次不会应用它们，下次同步仍会出现。';
+  readonly 'merge.apply.nothingPending': '所有分区都没有变化，本次不需要执行合并。';
+  readonly 'merge.apply.willApply': '本次会应用 {n} 个分区';
+  readonly 'merge.result.title': '合并结果';
+  readonly 'merge.result.applied': '已应用分区';
+  readonly 'merge.result.skipped': '已跳过';
+  readonly 'merge.result.warnings': '警告';
+  readonly 'merge.result.restoreId': '回滚点';
+  readonly 'merge.result.rolledBack': '已整体回滚';
+  readonly 'merge.result.rollbackIncomplete': '整体回滚不完整：有项未恢复（见警告）';
+  readonly 'merge.result.none': '没有分区被改动';
+  readonly 'merge.result.pending': '仍有 {n} 个分区待裁决（跳过 ≠ 已解决，下次同步仍会出现）';
+  readonly 'merge.result.rollback': '一键回滚';
+  readonly 'merge.result.rollingBack': '回滚中…';
+  readonly 'merge.result.rolledBackTo': '已回滚到 {id}';
+  readonly 'merge.result.failed': '{n} 项失败';
+  readonly 'merge.result.ineffective': '{n} 项未生效';
+  readonly 'merge.error.previewFailed': '合并预览失败';
+  readonly 'merge.toast.applyFailed': '执行合并失败';
+  readonly 'merge.toast.applied': '合并已执行';
+  readonly 'merge.toast.rollbackFailed': '回滚失败';
+  readonly 'merge.toast.previewFailed': '读取远程合并预览失败';
+  readonly 'probe.run': '测试连接';
+  readonly 'probe.running': '正在测试连接…';
+  readonly 'probe.hint': '只读自检：凭据 / 端点 / 目标容器 / 目录可达。WebDAV 通道可能幂等创建上级目录（那正是它要修的故障）；不会推送或改动任何快照。';
+  readonly 'probe.createdCollections': '已在远端自动创建目录：{list}';
+  readonly 'probe.snapshotCount': '远端现有快照：{count} 份';
+  readonly 'probe.unsupported': '该通道不提供连通性自检';
+  readonly 'probe.unsupportedHint': '这是能力边界，不是故障：该通道的同步功能不受影响，只是没有自检这项能力。';
+  readonly 'syncflow.snapshotDevice': '由 {device} 推送';
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type SyncKey = keyof typeof zh$3;
-//#endregion
-//#region src/client/market/market-locales.d.ts
 /**
  * 配置市场区块（config-manager-market）表面文案：zh 为源语言，en 镜像每个键。
  * 独立命名空间、独立文件：与 config-manager / config-manager-sync 平行，不触碰共享字典。
@@ -6218,8 +6520,6 @@ declare const zh$2: {
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type MarketKey = keyof typeof zh$2;
-//#endregion
-//#region src/client/recovery/recovery-locales.d.ts
 /**
  * Recovery 区块（config-manager-recovery）表面文案：zh 为源语言，en 镜像每个键。
  * 独立命名空间、独立文件：不触碰共享的 locales.ts（并行会话已改），零冲突。
@@ -6240,7 +6540,7 @@ declare const zh$1: {
   readonly 'recovery.banner': '配置修改已被保护：存在未完成的恢复事项。请先处理后继续。';
   readonly 'recovery.bannerAction': '去处理';
   readonly 'recovery.required': '需要恢复';
-  readonly 'recovery.requiredHint': '检测到一次操作未正常完成，为安全起见已暂停所有会修改配置的操作。请处理以下恢复事项以恢复正常。';
+  readonly 'recovery.requiredHint': '存在需要处理的恢复事项（残留锁、未完成的操作或中断的复制）。处理完这些事项即恢复正常。';
   readonly 'recovery.rollbackRecommended': '建议回滚';
   readonly 'recovery.rollbackContinue': '续跑回滚';
   readonly 'recovery.inProgress': '恢复进行中';
@@ -6267,6 +6567,12 @@ declare const zh$1: {
   readonly 'recovery.verify.verdict.unknown': '未知';
   readonly 'recovery.currentState.title': '当前状态';
   readonly 'recovery.currentState.safeMode': '已进入安全模式（会修改配置的操作已暂停）';
+  readonly 'recovery.currentState.itemsOnly': '存在需要处理的恢复事项（写操作未被暂停）';
+  readonly 'recovery.live.title': '正在执行的操作';
+  readonly 'recovery.live.hint': '这些操作正在正常执行中，不是未完成的恢复事项；结束后会自动消失。';
+  readonly 'recovery.incident.liveBlocked': '该操作仍在进行中，现在不能恢复也不能放弃，请等它结束。';
+  readonly 'recovery.incident.blockReason.noSnapshot': '本次操作没有绑定可信恢复快照，因此无法执行恢复。';
+  readonly 'recovery.incident.blockReason.needsAttention': '该事项被判定为需要人工处理，无法自动恢复。';
   readonly 'recovery.currentState.hasSnapshot': '存在可信恢复快照';
   readonly 'recovery.currentState.noSnapshot': '无可信恢复快照';
   readonly 'recovery.snapshot.title': '恢复快照';
@@ -6620,6 +6926,7 @@ declare const zh$1: {
   readonly 'rollback.result.conflict': '{n} 个文件两侧改到同一处，已保持原样 —— 需要你手工处理';
   readonly 'rollback.result.unavailable': '{n} 个文件无法安全撤销（缺少中间版本 / 二进制 / 差异过大），已保持原样';
   readonly 'rollback.result.concurrent': '{n} 个文件在回退过程中又被改过，已保持原样';
+  readonly 'rollback.result.unclaimed': '{n} 个文件无法判定属于哪个对话（改动时没有任何对话在运行），已保持原样';
   readonly 'rollback.result.selectionSkipped': '{n} 个文件按你的勾选跳过了';
   readonly 'rollback.preview.files.empty': '工作区与该回退点一致，无需恢复';
   readonly 'rollback.preview.files.unavailable': '该回退点的工作区态没有可用的记录（原因：{reason}），无需恢复';
@@ -6773,16 +7080,12 @@ declare const zh$1: {
 };
 /** 字典键联合（注册处 compile-time 校验）。 */
 type RecoveryKey = keyof typeof zh$1;
-//#endregion
-//#region src/client/history/history-locales.d.ts
 type KindKey = `history.kind.${MigrationKind}`;
 type ResultKey = `history.result.${MigrationResult}`;
 type CommonKey = 'view.history' | 'history.title' | 'history.subtitle' | 'history.empty' | 'history.loading' | 'history.corruptedBanner' | 'history.corruptedCount' | 'history.stats.total' | 'history.stats.success' | 'history.stats.failed' | 'history.stats.skipped' | 'history.filter.kind' | 'history.filter.result' | 'history.filter.recent' | 'history.filter.recent.all' | 'history.filter.recent.50' | 'history.filter.recent.200' | 'history.filter.sections' | 'history.filter.title' | 'history.search.placeholder' | 'history.export.json' | 'history.export.markdown' | 'history.exported' | 'history.exporting' | 'history.exportError' | 'history.loadError' | 'history.reload' | 'history.table.time' | 'history.table.kind' | 'history.table.result' | 'history.table.sections' | 'history.table.summary' | 'history.updatedAt' | 'history.refresh' |
 /** ⓘ 说明按钮的可访问名（与主字典 / market / sync / recovery 同口径，见 info-hint-guard t6-4） */
 'common.infoHint';
 type HistoryKey = KindKey | ResultKey | CommonKey;
-//#endregion
-//#region src/client/chat/chat-locales.d.ts
 /**
  * 聊天内「↺ 回退」入口（config-manager-chat）的独立字典：zh 为源语言，en 镜像每个键。
  * 独立命名空间、独立文件：不触碰共享的 locales.ts，也不与 recovery 字典混住。
@@ -6893,27 +7196,19 @@ declare const zh: {
   readonly 'chat.entry.disabled.turnUnknown': '这个回合的收尾状态未知，暂不可回退';
 };
 type ChatKey = keyof typeof zh;
-//#endregion
-//#region src/client/ConfigManagerSection.d.ts
 type ConfigManagerSectionProps = PropsRuntime<'settings.section'> & ConfigManagerSectionInjected & {
   t: TranslateNS<'config-manager'>;
 };
-//#endregion
-//#region src/client/export/ExportView.d.ts
 interface ExportViewProps {
   api: ConfigManagerApi;
   t: TranslateNS<'config-manager'>;
 }
-//#endregion
-//#region src/client/import/ImportWizardView.d.ts
 interface ImportWizardViewProps {
   api: ConfigManagerApi;
   t: TranslateNS<'config-manager'>;
   uiT?: UiT;
   onOpenForeignImport?: () => void;
 }
-//#endregion
-//#region src/client/sync/SyncPanel.d.ts
 interface SyncPanelProps {
   api: SyncApi;
   t: TranslateNS<'config-manager-sync'>;
@@ -6923,8 +7218,6 @@ interface SyncPanelProps {
    */
   cmT: TranslateNS<'config-manager'>;
 }
-//#endregion
-//#region src/client/market/MarketPanel.d.ts
 interface MarketPanelProps {
   api: MarketApi;
   /** 「我的配置」API（/me/* 端点：登录态/一键上传/查看已上传/一键更新；登录复用 SyncApi.github*） */
@@ -6950,14 +7243,10 @@ interface MarketPanelProps {
    */
   initialSubView?: 'browse' | 'myconfigs';
 }
-//#endregion
-//#region src/client/about/AboutPanel.d.ts
 interface AboutPanelProps {
   api: ConfigManagerApi;
   t: TranslateNS<'config-manager'>;
 }
-//#endregion
-//#region src/client/index.d.ts
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface LocaleNamespaceMap {
     /** Config Manager 表面文案。 */
@@ -6981,7 +7270,6 @@ export declare const inject: string[];
  * @param ctx - client root context（slots + locale 服务）。
  */
 export declare function apply(ctx: ClientContext): void;
-//#endregion
 export type { AboutPanelProps, ChatKey, ConfigManagerApiError, ConfigManagerKey, ConfigManagerSectionProps, DownloadResult, ExportViewProps, HistoryKey, ImportWizardViewProps, MarketKey, MarketPanelProps, RecoveryKey, ServiceStatus, SyncKey, SyncPanelProps, UploadResponse };
 
 		return module.exports;