dsh-config-manager 0.1.69 → 0.1.71

package/lib/client.d.ts

@@ -217,6 +217,13 @@ interface PathIssue {
 interface SnapshotTarget {
   adapter: SectionId;
   ref: string;
+  /**
+   * patch 行类目标的**所在层**（相对 homeDir 的 POSIX 路径，见 core/patch-layers.ts）。
+   *
+   * 为什么必须带上：patch 行有两层（home 层 + profile 层），同一 `ref`（lineId）在两层的
+   * 原值不同、写入位置也不同。缺省 = 用户层（`cordis.patch.yml`），保持旧调用方行为不变。
+   */
+  file?: string;
 }
 interface PlanItem {
   id: string;
@@ -571,6 +578,17 @@ interface RestorePlan {
   };
   /** beforePlugins 基线是否可用（undefined=旧快照无基线 → 不计划任何插件卸载） */
   pluginBaselineConfirmed: boolean;
+  /**
+   * 快照记录的来源 DSH 版本（F-4；**可选**：旧快照没有该字段是常态，此时为 undefined）。
+   * 只承载事实，判定与展示在调用方（UI/CLI）；恢复绝不因它而拒绝。
+   */
+  snapshotDshVersion?: string;
+  /**
+   * 本机当前 DSH 版本（F-4；**可选**：无法判定时不猜，保持 undefined 且不产出版本告警）。
+   * 来源优先级：调用方注入的 `RestoreOptions.currentDshVersion`（宿主权威，桌面端取 installAnchor）
+   * → profile 依赖树里实际落盘的 `@deepseek-ai/dsh` 版本（离线 best-effort）。
+   */
+  currentDshVersion?: string;
 }
 interface RestoreReport {
   snapshotId: string;
@@ -762,6 +780,15 @@ interface DshProfileMeta {
   patchBytes: number;
   /** 是否当前正在运行的 profile */
   isCurrent: boolean;
+  /**
+   * cross-F3：该条目是**中断的档案复制**留下的半截副本（无 package.json，只有进行中标记）。
+   * 界面据此把它渲染成「未完成的副本」并给出去向（`dir`）+ 删除入口，而不是当成正常档案。
+   */
+  incomplete?: true;
+  /** 半截副本的来源档案名（仅 incomplete 时有值） */
+  copiedFrom?: string;
+  /** 半截副本的复制开始时刻（ISO；仅 incomplete 时有值） */
+  copyStartedAt?: string;
   issues: DshProfileIssue[];
   /** package.json 的 mtime（毫秒）；不可读 = null */
   updatedAtMs: number | null;
@@ -1077,6 +1104,50 @@ interface BackupScheduleStatus {
   lastRunMessage?: string;
 }
 //#endregion
+//#region src/utils/shared-constants.d.ts
+/**
+ * 插件自更新（POST /update-apply）的失败码（**唯一声明处**：宿主 core/self-update.ts 与
+ * 客户端关于页弹窗共用同一份字面量）。
+ *
+ * 为什么抽到这里：客户端要据码映射**本地化**文案（绝不直接渲染宿主返回的英文细节）；
+ * 若两侧各写一份联合类型，「宿主加了码而界面回落成英文」不会红。全部落在本文件的
+ * 常量 + 派生类型上，客户端只 import 类型（零运行时依赖）。
+ */
+declare const SELF_UPDATE_FAILURE_CODES: readonly ['invalid-version', 'profile-unknown', 'unsupported-profile', 'non-registry-install', 'not-newer', 'install-failed'];
+/** 自更新失败码（联合类型由上面的常量派生） */
+type SelfUpdateFailureCode = (typeof SELF_UPDATE_FAILURE_CODES)[number];
+/**
+ * 同步通道清单（**零依赖**：宿主与 client 半都可运行时 import）。
+ *
+ * 为什么放在这里（而不是 `src/sync/sync-config.ts`）：sync-config.ts import 了
+ * node:fs / node:path，client 半**运行时** import 它会把 node 模块带进浏览器产物
+ * （DSH loader 报 missed the module table，整个插件不加载）。通道清单是「纯常量」，
+ * 与 ENCRYPTED_CONTAINER_CODE 同一处置：常量放这里，读写实现留在 sync-config.ts。
+ *
+ * 宿主侧 sync-config.ts **re-export** 它，仍是全仓唯一事实源（类型 SyncTransportType 由它派生）。
+ *
+ * 通道与「云端点具体兼容商」的关系：`s3` 是一条通道（配置里带 `provider` 区分
+ * s3 / oss / cos / minio / kodo 五家），`gist` 是一条通道（provider 恒 gist）。
+ */
+declare const SYNC_CHANNELS: readonly ['git', 'webdav', 's3', 'gist'];
+/**
+ * S3 兼容系通道清单（**唯一声明处**，t88；先例 = 上面的 SYNC_CHANNELS）。
+ *
+ * 为什么也放这里：宿主 `sync/sync-config.ts` 与客户端镜像（`ui/sync-settings-view.ts` 的 `S3_PROVIDERS`、
+ * `client/sync/sync-view.ts` 的 provider 文案表）必须同值 —— 两侧各写一份字面量时，「宿主加了兼容商而界面少一个选项」
+ * 这类静默漂移**不会红**（客户端只能靠 `satisfies` 穷尽检查拦「新增」，拦不住「改名 / 删除 / 顺序」）。
+ * 放到零依赖模块后，两侧都 import 它；`sync-config.ts` 只 re-export（宿主沿用既有 import 路径）。
+ *
+ * 与通道清单的关系：`s3` 是**一条通道**（配置里用 `provider` 区分这五家），`gist` 是另一条通道（provider 恒 gist）。
+ */
+declare const S3_COMPAT_PROVIDERS: readonly ['s3', 'oss', 'cos', 'minio', 'kodo'];
+/** S3 兼容系通道类型 */
+type S3CompatProvider = (typeof S3_COMPAT_PROVIDERS)[number];
+/** 非 S3 系的云端点通道（GitHub Gist，走 REST） */
+declare const GIST_PROVIDER: 'gist';
+/** Gist 通道类型 */
+type GistProvider = typeof GIST_PROVIDER;
+//#endregion
 //#region src/security/container-kind.d.ts
 /** 备份容器形态。 */
 type BackupContainerKind = 'zip' | 'encrypted';
@@ -1237,6 +1308,33 @@ interface SessionRepairActionView {
   lossy: boolean;
   rows: number;
 }
+/**
+ * 写后**真 codec 复验结论**的展示视图（src/ui 内部定义的结构化类型）。
+ *
+ * 为什么不直接 import utils/session-verify.ts 的 SessionVerifyResult：src/ui 会被打进 **client bundle**
+ * （浏览器半），而那个模块经 utils/zstd-frame.ts 间接依赖 `node:zlib` —— bundle 里一旦出现对 node: 内建模块的
+ * 引用，DSH loader 会报 missed the module table，**整个插件不加载**（本项目实测过）。
+ * 所以这里只**逐字段镜像**宿主回传的形状（结构化鸭子类型），判定逻辑落在本模块的纯函数里。
+ *
+ * 语义（与 utils/session-verify.ts 的 SessionVerifyResult 逐字同源，**不许曲解**）：
+ *  · verified && equivalentToReadPath   → 「现役读盘可读」（header 版本 = 本机现役代际）；
+ *  · verified && !equivalentToReadPath  → 「迁移链可还原」（pre-v4 日志），**不等于**现役读盘可读；
+ *  · !verified                          → 「**未验证**」（本机跑不了真 codec 门），**不等于**已验证。
+ */
+interface SessionVerifyView {
+  verified: boolean;
+  /** verified 时解出的事件数 */
+  events?: number;
+  /** !verified 时的机器可读原因（unavailable / invalid-header / decode-failed / finish-failed） */
+  reason?: string;
+  /** !verified 时的补充详情（机器可读码 + 候选标签，**不含路径**） */
+  detail?: string;
+  /** 额外的「已安装 build 语义校验」结论（不参与判定） */
+  strong?: boolean;
+  strongDetail?: string;
+  /** 是否等价于 DSH 现役读盘路径（未验证时恒 false = 「没有任何可声称的现役等价」） */
+  equivalentToReadPath: boolean;
+}
 /** 修复预览 / 应用结果（POST /recovery/sessions/repair）。 */
 interface SessionRepairResult {
   ok: boolean;
@@ -1265,6 +1363,16 @@ interface SessionRepairResult {
   lossy?: boolean;
   /** 保留的行数 */
   keptRows?: number;
+  /**
+   * 写后真 codec 复验结论（**应用期才有**）。调用方必须据它区分三态；
+   * 缺省 = 没回传复验结论（预览路径）—— **绝不**当成「已验证」。
+   */
+  verify?: SessionVerifyView;
+  /**
+   * 确定性失败（reason=`verify-failed`）时：自动回滚是否成功。
+   * false = 目标当前仍是「修复后字节」（危险态，必须可见）；缺省 = 服务层没回传（不猜）。
+   */
+  rolledBack?: boolean;
 }
 /** 回滚结果（POST /recovery/sessions/rollback）。 */
 interface SessionRepairRollbackResult {
@@ -1300,6 +1408,24 @@ type PluginUpdateCheckResult = {
   /** 失败原因（网络 / 超时 / 响应畸形；可读、可重试、无敏感信息） */
   error: string;
 };
+/**
+ * POST /update-apply 的结果（关于页「立即更新」）。
+ *
+ * 语义：用户**显式点击**后，宿主经官方 `dsh plugin` 通道把本插件安装为**钉住的精确版本**；
+ * 成功只表示文件已换新，必须重启 DSH 才生效（needsRestart）。
+ * 失败码与宿主共用同一份字面量（utils/shared-constants.ts），界面据码映射本地化文案，
+ * 只有未知码才回落到宿主返回的原始错误文本。
+ */
+type PluginUpdateApplyResult = {
+  ok: true;
+  version: string;
+  command: string;
+  needsRestart: true;
+} | {
+  ok: false;
+  code: SelfUpdateFailureCode;
+  error: string;
+};
 /** 手动清理可点选的动作：可重建区（tmp + 市场缓存/工作副本）/ 已到期的导出产物。 */
 type DiskUsageCleanCategory = 'tmp' | 'expired-exports';
 /** POST /disk-usage/cleanup 的回执（回执里带刷新后的报告，避免界面再发一次 GET）。 */
@@ -1359,6 +1485,34 @@ interface RecoveryStatus {
    * 旧宿主不返回 → undefined（面板按「未阻断」处理，不误报保护）。
    */
   safeMode?: RecoverySafeModeStatus;
+  /**
+   * 中断的档案复制残留（cross-F3 / t54）：目标目录带 `.dcm-copy-in-progress.json` 标记、
+   * 却没有 package.json 的半截副本。它们既不在档案列表里、删除又报 notFound ——
+   * 用户此前在「事故恢复」里既看不到、也没有任何处置入口。
+   * 旧宿主不返回 → undefined（按「无残留」处理，不误报）。
+   */
+  incompleteCopies?: RecoveryIncompleteCopy[];
+  /**
+   * t89：残留**枚举失败**（读 profiles 目录失败）时为 true —— 与「确实没有残留」
+   * （字段缺省）区分开：此前两者在响应里完全同形（都是 `incompleteCopies: []`），
+   * 界面便把「读不到」渲染成「暂无残留」。
+   * 旧宿主不返回 → undefined（按「读到了」处理，绝不误报失败）。
+   */
+  incompleteCopiesUnreadable?: boolean;
+}
+/**
+ * 中断的档案复制残留（cross-F3 / t54）：**只允许删除**。
+ * 形态恒为 generic ⇒ 不可启动（没有 package.json，spawn 出去只会得到一个起不来的实例）。
+ */
+interface RecoveryIncompleteCopy {
+  /** 目标档案名（= 目录名） */
+  name: string;
+  /** 目标目录绝对路径（界面渲染前过 `redact()`） */
+  dir: string;
+  /** 来源档案名（标记不可解析时为 null —— 界面不臆造） */
+  sourceName: string | null;
+  /** 复制开始时刻（ISO；标记不可解析时为 null） */
+  startedAt: string | null;
 }
 /** SAFE MODE 阻断态摘要（只暴露结论与是否可解除）。 */
 interface RecoverySafeModeStatus {
@@ -1495,6 +1649,118 @@ interface RecoveryPort {
   rollbackSessionRepair(repairId: string): Promise<SessionRepairRollbackResult>;
 }
 //#endregion
+//#region src/client/session-export/session-export-view.d.ts
+/**
+ * 「下载原始日志 (ZIP)」入口的**纯展示模型**（F-2，框架无关、node 可测）。
+ *
+ * 本模块**不做任何 I/O 与 React**：输入是宿主探测回来的结构化事实，输出是组件直接渲染的三件事 ——
+ * 是否可用、给用户看的原因、按钮的交互状态。判定集中在这里的原因很实在：这条入口最容易犯的错
+ * **不是**功能错，而是**显隐判据错**（生态竞品普遍用已过时的 `status !== 501` 探测，在本机 DSH 上
+ * 会因为服务缺失返 500 而**几乎恒显示**）。判据只能有一份，且必须可单测。
+ *
+ * 三态语义（与宿主 src/routes/session-export.ts 的 `SessionExportAvailability` 同源）：
+ *  - `available`  → 显示并可用；
+ *  - `unavailable` → **显示但禁用**，并给出可读原因（绝不静默、也绝不直接消失让用户以为没这功能）；
+ *  - `unknown`    → **保守显示为可用**（拿不到状态码时绝不猜成「不支持」——那会藏掉一个其实能用的功能）。
+ *
+ * 为什么 `unavailable` 是「禁用 + 说明」而不是「隐藏」：隐藏会让用户无从判断「是这台机器不支持」
+ * 还是「插件没做这个功能」；禁用 + 一句话原因把这句话说清楚（与仓库「绝不静默」的既有取向一致）。
+ */
+/** 可用性三态（与宿主 src/routes/session-export.ts 的判定同源）。 */
+type SessionExportAvailability = 'available' | 'unavailable' | 'unknown';
+/** 成因（机器可读；界面映射成文案，**绝不渲染裸码**）。 */
+type SessionExportReason = 'service-missing' | 'auth-required' | 'read-failed' | 'network-error' | 'unexpected-status';
+/** 宿主探测回来的结构化事实（与 GET /session-export 的响应字段一一对应）。 */
+interface SessionExportProbe {
+  availability: SessionExportAvailability;
+  reason?: SessionExportReason;
+  /** DSH 返回的状态码（0 = 没拿到响应） */
+  status: number;
+  /** 探测的路径（诊断用） */
+  path: string;
+  /** 探测时刻（ISO） */
+  checkedAt: string;
+}
+//#endregion
+//#region src/foreign/types.d.ts
+/** 未能迁移的外部内容（响亮失败：宁可在计划里报出来，也不静默丢） */
+interface ForeignSkip {
+  /** 稳定机器码（UI 用它映射文案；禁止渲染裸枚举） */
+  code: ForeignSkipCode;
+  /** 外部侧位置（server 名 / skill 名 / 文件名；**不含任何值**） */
+  origin?: string;
+  /** 机器可读的细分原因（如 no-frontmatter / yaml-error），同样交给 UI 映射 */
+  detail?: string;
+  /** 同码聚合时的条数 */
+  count?: number;
+}
+type ForeignSkipCode =
+/** settings.json 的 hooks：DSH 无对等结构 */
+'unsupported-hooks' |
+/** commands/*.md（斜杠命令）：与 DSH prompts 不是同一语义，本期不搬 */
+'unsupported-commands' |
+/** settings.json 的 env 里出现凭据名：只计数与记名，**值不读** */
+'credentials-not-migrated' |
+/** SKILL.md 缺失 */
+'skill-missing-file' |
+/** frontmatter 不是合法 YAML / 缺 name|description（DSH 会**静默丢弃**该 skill，这里必须报） */
+'skill-invalid-frontmatter' |
+/** 目录名/文件相对路径非法（含分隔符、.. 等），无法作为 skill 单元 */
+'skill-invalid-name' |
+/** MCP 条目既无 command 也无 url */
+'mcp-server-empty' |
+/** MCP type=sse（DSH 只支持 stdio / streamable-http）→ 按带 url 的 http 处理 */
+'mcp-type-sse-coerced' |
+/** MCP 值里发现凭据字段（值已丢弃，只留字段名与引用名） */
+'mcp-credential-redacted' |
+/** 外部文件读不到 / 超限 / 解析失败 */
+'source-unreadable' |
+/** 会话：目标机未提供 DSH 会话格式版本（不猜版本，宁可整批不转） */
+'session-format-version-unknown' |
+/** 会话：目标机格式版本不是本模块已实现的行式 */
+'session-format-unsupported' |
+/** 会话：记录里没有 cwd（DSH 要求「日志位置 == projectKey(cwd)/id」，没有 cwd 无法归位） */
+'session-missing-cwd' |
+/** 会话：文件名不能自证是安全路径段 */
+'session-unsafe-id' |
+/** 会话：没有任何可迁移的事件 */
+'session-empty' |
+/** 会话：存在解析不出来的行 */
+'session-unparsable' |
+/** 会话：某类 Claude 记录本期不迁移（sidechain / attachment / queue-operation / system …） */
+'unsupported-session-record' |
+/** 同 id 会话（包内重复 / 目标机已存在，含「另一 projectKey 下同 id」）：**不覆盖、跳过并报码**（用户决策，§8.4） */
+'session-id-conflict' |
+/** 外部技能重名（压平分类后同名，或两次来源同名）：先到先得，其余跳过并报码（§8.4） */
+'skill-id-conflict' |
+/** 该来源的对话存储形态本版不迁移（如 Hermes 的 SQLite state.db）：只报告，绝不产出 sessions 分区 */
+'sessions-not-migrated' |
+/** 记忆文件只报告不导入（如 Hermes memories/MEMORY.md、USER.md）：用户决策，正文绝不进包 */
+'memory-report-only' |
+/** 外部技能带分类层级（如 Hermes skills/<分类>/<技能>）：压平为 DSH 单层 <技能>/SKILL.md 并报码 */
+'skill-category-flattened' |
+/** 旧式规则文件（如 .cursorrules）：DSH 无对等结构，只报告 */
+'legacy-rules-file' |
+/** 多份指令源被合并为单个 AGENTS.md（DSH 只读一个全局指令文件）：如实报告合并来源数 */
+'instructions-merged' |
+/** 命中更高优先级的指令文件（如 Codex 的 AGENTS.override.md 优先于 AGENTS.md）：报告被选中的那一个 */
+'instructions-override-selected' |
+/** 配置文件存在但为 0 字节（如实测的 Antigravity mcp_config.json）：报码，绝不产出空分区 */
+'source-empty-file' |
+/** 配置目录位置被环境变量/命令行覆盖（CLAUDE_CONFIG_DIR / HERMES_HOME / CODEX_HOME / COPILOT_HOME） */
+'source-location-overridden' |
+/**
+ * 会话 cwd 由**源侧路径/编码目录名推导**（记录里没有 cwd 字段），且推导结果在本机**真实存在**
+ * —— 才允许落盘（存在性检查把「猜」变成「有证据的推断」）；不存在的推导一律按
+ * `session-missing-cwd` 跳过，绝不产出一条指向不存在目录的会话。
+ */
+'session-cwd-derived' |
+/**
+ * 该来源**没有自动根**（竞品 `defaultRoots.chatgpt = null`）—— 必须由用户显式给出导出文件
+ * 路径；本机自动探测永远不会命中，如实报码而不是假装「未安装」。
+ */
+'source-needs-explicit-path';
+//#endregion
 //#region src/ui/i18n.d.ts
 /**
  * 客户端展示层（src/ui/*、src/client/common/*）的渲染文案目录（zh 源语言 / en 镜像）。
@@ -1865,6 +2131,7 @@ declare const uiZh: {
   readonly 'diskUsage.clean.expiredExportsDesc': '只删已超过保留期的导出 ZIP（定时备份不在此列）。';
   readonly 'diskUsage.clean.done': '已释放 {size}，删除 {count} 项';
   readonly 'diskUsage.clean.nothing': '没有可释放的内容';
+  readonly 'diskUsage.clean.nothingAbsent': '没有需要清理的内容（目标目录不存在或已为空）';
   readonly 'diskUsage.clean.failed': '清理完成，但有 {count} 项失败（已跳过）';
   readonly 'diskUsage.clean.excluded': '本次未包含：{items}';
   readonly 'diskUsage.clean.excludedExpiredExports': '回收过期备份文件';
@@ -1929,11 +2196,105 @@ declare const uiZh: {
   readonly 'library.value.plainZip': '明文 ZIP';
   readonly 'library.summary.count': '共 {count} 个';
   readonly 'library.summary.encrypted': '{count} 个加密';
+  readonly 'foreign.source.claude-code': 'Claude Code';
+  readonly 'foreign.source.hermes': 'Hermes';
+  readonly 'foreign.source.cursor': 'Cursor';
+  readonly 'foreign.source.codex': 'Codex CLI';
+  readonly 'foreign.source.copilot': 'GitHub Copilot CLI';
+  readonly 'foreign.source.antigravity': 'Google Antigravity';
+  readonly 'foreign.source.gemini': 'Gemini CLI';
+  readonly 'foreign.source.reasonix': 'Reasonix';
+  readonly 'foreign.source.opencode': 'OpenCode';
+  readonly 'foreign.source.mimocode': 'MimoCode';
+  readonly 'foreign.source.zcode': 'ZCode';
+  readonly 'foreign.source.grokbuild': 'Grok Build';
+  readonly 'foreign.source.openclaw': 'OpenClaw';
+  readonly 'foreign.source.pi': 'Pi';
+  readonly 'foreign.source.kimi': 'Kimi CLI';
+  readonly 'foreign.source.kilocode': 'Kilo Code';
+  readonly 'foreign.source.qoder': 'Qoder';
+  readonly 'foreign.source.chatgpt': 'ChatGPT';
+  readonly 'foreign.source.workbuddy': 'WorkBuddy';
+  readonly 'foreign.source.qwen': '千问办公';
+  readonly 'foreign.source.continue': 'Continue';
+  readonly 'foreign.source.cline': 'Cline';
+  readonly 'foreign.source.goose': 'Goose';
+  readonly 'foreign.source.dsh4': 'DSH 会话日志（V4 代次）';
+  readonly 'foreign.source.zed': 'Zed';
+  readonly 'foreign.source.crush': 'Crush';
+  readonly 'foreign.source.teleagent': 'TeleAgent';
+  readonly 'foreign.source.trae': 'Trae';
+  readonly 'foreign.source.vibe': 'Vibe';
+  readonly 'foreign.source.dsh': 'DSH 会话日志（V0-V3 代次）';
+  readonly 'foreign.source.unknown': '未识别的来源';
+  readonly 'foreign.found.yes': '已检测到';
+  readonly 'foreign.found.no': '未检测到';
+  readonly 'foreign.paths': '命中路径：{paths}';
+  readonly 'foreign.pathsNone': '没有命中任何真值表路径';
+  readonly 'foreign.skipped.total': '未迁移 {count} 项';
+  readonly 'foreign.skipped.empty': '没有未迁移的内容';
+  readonly 'foreign.credentialRefs': '需补录凭据 {count} 项：{refs}';
+  readonly 'foreign.credentialRefs.none': '无需补录凭据';
+  readonly 'foreign.sections.none': '没有可导入的分区';
+  readonly 'foreign.reportOnly': '只报告、不导入：{detail}';
+  readonly 'foreign.skip.unsupported-hooks': 'settings 的 hooks：DSH 无对等结构，未迁移';
+  readonly 'foreign.skip.unsupported-commands': '斜杠命令：与 DSH 提示词不是同一语义，本次未迁移';
+  readonly 'foreign.skip.credentials-not-migrated': '凭据字段只记录名字，值不读取也不迁移';
+  readonly 'foreign.skip.skill-missing-file': '技能目录缺少 SKILL.md，未迁移';
+  readonly 'foreign.skip.skill-invalid-frontmatter': '技能 frontmatter 非法，DSH 会静默丢弃，故未迁移';
+  readonly 'foreign.skip.skill-invalid-name': '技能名含非法字符或路径穿越，未迁移';
+  readonly 'foreign.skip.mcp-server-empty': 'MCP 条目既无 command 也无 url，未迁移';
+  readonly 'foreign.skip.mcp-type-sse-coerced': 'MCP type=sse：按带 url 的 http 处理';
+  readonly 'foreign.skip.mcp-credential-redacted': 'MCP 值里发现凭据字段：值已丢弃，只保留字段名与引用名';
+  readonly 'foreign.skip.source-unreadable': '外部文件读不到、超限或解析失败';
+  readonly 'foreign.skip.source-empty-file': '配置文件存在但为空（0 字节）：如实上报，不产出空分区';
+  readonly 'foreign.skip.source-location-overridden': '配置位置被环境变量覆盖，按覆盖后的位置读取';
+  readonly 'foreign.skip.session-cwd-derived': '会话记录里没有 cwd：按源侧目录名推导出工作目录，且该目录在本机确实存在（推不出来的一律按「缺少 cwd」跳过）';
+  readonly 'foreign.skip.source-needs-explicit-path': '该来源没有自动探测位置：必须显式提供导出文件路径（自动探测永远不会命中）';
+  readonly 'foreign.skip.session-format-version-unknown': '本机 DSH 会话格式版本未知：不猜版本，整批会话未迁移';
+  readonly 'foreign.skip.session-format-unsupported': '本机 DSH 会话格式版本不受支持，该会话未迁移';
+  readonly 'foreign.skip.session-missing-cwd': '会话记录缺少 cwd，无法归位到工作区';
+  readonly 'foreign.skip.session-unsafe-id': '会话文件名不能作为安全路径段，未迁移';
+  readonly 'foreign.skip.session-empty': '会话没有任何可迁移的事件';
+  readonly 'foreign.skip.session-unparsable': '会话存在解析不出来的行，未迁移';
+  readonly 'foreign.skip.unsupported-session-record': '该类型的会话记录本版不迁移';
+  readonly 'foreign.skip.session-id-conflict': '同 id 会话已存在：不覆盖，跳过并保留本机既有的那条';
+  readonly 'foreign.skip.skill-id-conflict': '技能重名：先到先得，其余跳过';
+  readonly 'foreign.skip.sessions-not-migrated': '该来源的对话存储形态本版不迁移';
+  readonly 'foreign.skip.memory-report-only': '记忆文件只报告、不导入（正文不进备份包）';
+  readonly 'foreign.skip.skill-category-flattened': '技能带分类层级：已压平为 DSH 的单层技能目录';
+  readonly 'foreign.skip.legacy-rules-file': '旧式规则文件：DSH 无对等结构，只报告';
+  readonly 'foreign.skip.instructions-merged': '多份指令源被合并为一个全局指令文件';
+  readonly 'foreign.skip.instructions-override-selected': '命中更高优先级的指令文件（override），按它导入';
+  readonly 'foreign.lossy.file-section-secrets.title': '文件类分区的明文不做剥离';
+  readonly 'foreign.lossy.file-section-secrets.detail': '技能 / Agent 预设 / 全局指令 / 插件文件 / 历史会话 / 插件自身配置这六个文件类分区承载的是原始文件内容：命中的明文原样进包（导入侧只报告、不改写；本页的产包路径连扫描都不做）。「默认不含秘密」只对结构化分区成立，对这类分区不成立 —— 需要保密请先清理源文件。';
+  readonly 'foreign.lossy.entry-backslash.title': '条目名中段反斜杠：跨平台落点可能不同';
+  readonly 'foreign.lossy.entry-backslash.detail': 'ZIP 条目名里出现在中段的反斜杠不会被拒绝：同一个包在 Windows 目标上会被当作路径分隔符（落成多级目录），在 POSIX 目标上只是一个普通字符。本实现刻意不改这一格式行为；界面无法逐条检查条目名，跨平台导入后请核对这类文件是否落在预期位置。';
+  readonly 'foreign.lossy.prompt-persona-reshape.title': 'prompts 的 systemPrompt 形状变化';
+  readonly 'foreign.lossy.prompt-persona-reshape.detail': '源里的 systemPrompt 是字符串，导入落盘时写成带 persona 字段的对象：persona 文本无损，字段形状改变。兼容性评分不会为这一条给出原因 —— 它不改变内容，只改变形态。';
 };
 type UiTextKey = keyof typeof uiZh;
 /** UI 翻译函数：key → 当前语言文案（{param} 插值；未知键回退 zh/键名）。 */
 type UiT = (key: UiTextKey, params?: Record<string, string | number>) => string;
 //#endregion
+//#region src/ui/foreign-view.d.ts
+/** `GET /foreign-sources` 返回的一条来源检测结果（与宿主 ForeignSourceStatus 同构） */
+interface ForeignSourceStatusInput {
+  id: string;
+  /** 宿主给的字典键（如 foreign.source.claude-code）；**只作为兜底**，正常走 id 映射 */
+  labelKey?: string;
+  found: boolean;
+  /** 命中位置（相对 home 的 POSIX 路径；宿主保证绝不是绝对路径） */
+  paths: readonly string[];
+  skipped?: readonly ForeignSkip[];
+}
+/** `GET /foreign-sources` 响应 */
+interface ForeignSourcesResponse$1 {
+  conflictPolicy?: string;
+  projectScoped?: boolean;
+  sources: readonly ForeignSourceStatusInput[];
+}
+//#endregion
 //#region src/client/common/http.d.ts
 /** 携带路由 JSON error 消息的错误类型（客户端所有请求错误的唯一类型）。 */
 declare class ConfigManagerApiError extends Error {
@@ -1971,6 +2332,41 @@ interface ServiceStatus {
   /** dsh.profile.bundles 声明（非空即替换默认插件栈） */
   bundles?: string[];
 }
+/**
+ * 外部 agent 来源发现响应（`GET /foreign-sources`）。
+ *
+ * 复用 `src/ui/foreign-view.ts` 的输入类型 —— 响应形状的**唯一权威**在那边（视图模型只读它）。
+ * 路径刻意在本文件重导出，避免组件同时 import 两处（同 `UploadResponse` 的做法）。
+ */
+type ForeignSourcesResponse = ForeignSourcesResponse$1;
+/**
+ * 外部来源 → bundle 的响应（`POST /foreign-import`）。
+ *
+ * `zipPath`：受控临时目录里的标准 bundle v1 ZIP，直接喂给既有导入向导的 `analyzeImport`。
+ * `skipped` / `credentialRefs` **绝不含凭据值**（值在转换层已被剥离）。
+ */
+interface ForeignImportResponse {
+  zipPath: string;
+  name: string;
+  /** 来源 id（六来源之一） */
+  source: string;
+  /** 来源显示名的字典键（如 foreign.source.hermes） */
+  labelKey: string;
+  /** 产物字节数（读不到时为 0，界面按「未知」处理） */
+  sizeBytes: number;
+  /** 本次产出包内的分区（空分区不会被写入，也不出现在这里） */
+  sections: SectionId[];
+  /** 各分区的条目计数（机器可读；键形如 `mcp.servers`） */
+  counts: Record<string, number>;
+  /** 未迁移项（只有机器码 + 位置名 + 条数） */
+  skipped: ForeignSkip[];
+  /** 凭据**引用名**（形如 `mcp:gitnexus:GITHUB_TOKEN`）；导入后由用户补录值 */
+  credentialRefs: string[];
+  /** 检测到的本机位置（相对 home；绝不回传绝对路径） */
+  detectedPaths: string[];
+  /** 冲突策略（用户决策：同 id 不覆盖、跳过并报码） */
+  conflictPolicy: string;
+}
 /** export 端点响应（对齐 ExportFlow 的 ExportRunResult 前半部分；runId 为 m1 run 注册表标识） */
 interface ExportResponse {
   zipPath: string;
@@ -2297,12 +2693,70 @@ declare class ConfigManagerApi {
    * —— 界面显示可重试提示，不当作错误横幅。
    */
   checkUpdate(force?: boolean): Promise<PluginUpdateCheckResult>;
+  /**
+   * 执行插件自更新（POST /update-apply）—— **只在用户显式点「立即更新」后**调用。
+   *
+   * 宿主经官方 dsh plugin 通道安装钉住的精确版本（见 core/self-update.ts）；成功后必须
+   * 重启 DSH 才生效。安装可能较慢（慢网络下分钟级），故用独立的长超时档位。
+   */
+  applyUpdate(version: string): Promise<PluginUpdateApplyResult>;
   /** 迁移前咨询（只读健康评分 + 建议）：对 4 种可迁移源生成统一咨询报告。 */
   consult(input: {
     type: 'export-zip' | 'local-snapshot' | 'remote-snapshot' | 'profile';
     id: string;
     snapshotId?: string;
   }): Promise<ConsultReport>;
+  /**
+   * GET /foreign-sources：六来源的本机检测结果（**只读**，零写入）。
+   *
+   * 未安装是正常状态（found=false），不是错误 —— 界面照常列出全部六条，
+   * 用户才知道「哪些查过了、本机确实没有」。
+   */
+  foreignSources(opts?: {
+    projectDir?: string;
+  }): Promise<ForeignSourcesResponse>;
+  /**
+   * POST /foreign-import：把本机某个外部 agent 的配置翻译成标准 bundle v1 ZIP，
+   * 落到宿主受控临时目录并返回 zipPath —— 之后**完全复用既有导入向导**
+   * （analyzeImport → createImportPlan → executeImportPlan），不新建第二套向导。
+   *
+   * 为什么必须由宿主产包：转换要读本机文件系统并写 ZIP，浏览器半做不了
+   * （此前该能力只在 CLI 里，GUI 会在「点导入」之后断链）。
+   *
+   * `projectDir`：项目级真值位置（Cursor/Codex 的 <项目>/.cursor/**）。**缺省不传 = 不扫项目级** ——
+   * 宿主进程的 cwd 不是用户的项目，绝不猜。
+   *
+   * 响应**绝不含凭据值**：只有 skipped 机器码与凭据**引用名**（值在转换层已被剥离）。
+   */
+  foreignImport(source: string, opts?: {
+    projectDir?: string;
+  }): Promise<ForeignImportResponse>;
+  /**
+   * GET /session-export（**只读**）：探测 DSH 官方 session.export 端的可用性。
+   *
+   * 为什么由宿主代探而不是浏览器直接打 DSH：见 src/routes/session-export.ts 的文件头 ——
+   * 该端点挂在带浏览器认证的 `/api` 前缀下，浏览器侧「401 / 404 / 连不上」分不开，
+   * 而「路由没注册」与「持久化后端缺服务」的处理方式**完全不同**（前者保守显示、后者隐藏入口）。
+   *
+   * 返回三态（**绝不二值化**）：`available` 显示 / `unavailable` 禁用并说明原因 / `unknown` 保守显示。
+   */
+  sessionExportProbe(): Promise<SessionExportProbe>;
+  /** F-2：原始日志 ZIP 的代理下载地址（探测与下载同一条路由，query 决定形态）。 */
+  sessionExportUrl(sessionId: string, opts?: {
+    includeDescendants?: boolean;
+  }): string;
+  /**
+   * F-2：把某条会话的原始日志 ZIP 下载到本机（由 DSH 自己打包，含子会话与附件）。
+   *
+   * 复用**既有**的流式下载链路（openStream + saveDownloaded，与导出产物同一条）：
+   *  - 大 ZIP 不整本驻留内存（流式写优先，不可用时才 Blob 兜底）；
+   *  - 正文阶段是**空闲超时**（每读一块重置）—— 宿主卡死时明确失败而非永久转圈；
+   *  - 失败时把上游（DSH）的状态码与正文如实抛出（代理路由原样透传，见 src/routes/session-export.ts）。
+   *
+   * 为什么走本插件的代理而不是直连 DSH 的 `/api/session.export`：`openStream` 认得本插件的
+   * 错误信封；直连 DSH 时 401/404 只是一次没有解释的失败（而 404 也可能是「拼错路径」）。
+   */
+  downloadSessionExport(sessionId: string, opts?: DownloadOptions, onProgress?: (received: number, total: number) => void): Promise<DownloadResult>;
   /** 「查看备份内容」：对 exports 目录内的备份文件做只读分析（reuse /analyze，零写入）。
    *  返回分析 + 与当前配置的差异计划摘要（"装/导这个备份会动你什么"）。 */
   inspectBackup(zipPath: string): Promise<BackupInspectResult>;
@@ -2359,17 +2813,28 @@ interface SyncPushPreview {
 }
 //#endregion
 //#region src/sync/sync-config.d.ts
-/**
- * 同步通道枚举（**唯一声明处**，t32）：所有「有哪些通道 / 通道列表 / 通道判定」的唯一事实源。
- *
- * 为什么要单一来源：此前 SyncTransportType 在 sync-config / ui-prefs / client sync-api /
- * client sync-view 各自声明一遍，通道数组也在 autosync-scheduler 里写了两遍 ——「改一处漏一处」
- * 的表现是某个通道**静默**不再排期 / 不再落盘，而不是报错。新增通道只改这里：typecheck 会在
- * 所有 Record<SyncTransportType, X> 的构造处与穷尽检查处报错。
- */
-declare const SYNC_CHANNELS: readonly ['git', 'webdav'];
 /** 同步通道类型（由 SYNC_CHANNELS 派生；host 侧与 client 半统一引用）。 */
 type SyncTransportType$1 = (typeof SYNC_CHANNELS)[number];
+/** S3 兼容系通道的回传视图：**只带 secretStored 标记，绝不带密钥值**。 */
+interface CloudS3ChannelView {
+  provider: S3CompatProvider;
+  endpoint: string;
+  region: string;
+  bucket: string;
+  prefix: string;
+  accessKeyId: string;
+  pathStyle: boolean;
+  /** 密钥已在 credentials 里（只回布尔） */
+  secretStored: boolean;
+}
+/** Gist 通道的回传视图：**只带 secretStored 标记，绝不带 token 值**。 */
+interface CloudGistChannelView {
+  provider: GistProvider;
+  gistId: string;
+  apiBaseUrl: string;
+  filePrefix: string;
+  secretStored: boolean;
+}
 //#endregion
 //#region src/client/sync/sync-api.d.ts
 /**
@@ -2391,6 +2856,15 @@ interface SyncStatusResponse {
   /** webdav 通道：配置状态（url 可回显，username 非敏感；password 值永不返回；
    *  与当前通道无关，配置过即返回，供 git ↔ webdav 切换时回填表单） */
   webdav?: WebDavStatusResponse;
+  /**
+   * 云端点通道 s3 的非密配置视图（**只有 secretStored 布尔，绝无 AccessKey Secret 值**）。
+   * 配置过即返回（与当前活动通道无关），供表单在各通道间切换时回填。
+   */
+  s3?: CloudS3ChannelView;
+  /** 云端点通道 gist 的非密配置视图（**只有 secretStored 布尔，绝无 token 值**）。 */
+  gist?: CloudGistChannelView;
+  /** 已保存的云端点 provider 清单（只有名字；切换 provider 时回填用） */
+  cloudSavedProviders?: string[];
   /** sync-state.lastSyncAt；'' = 从未同步 */
   lastSyncAt?: string;
   /** sync-state.sections 条目数 */
@@ -2478,6 +2952,9 @@ interface SyncConfigSaveResponse {
     usernameConfigured: boolean;
     passwordConfigured: boolean;
   };
+  /** 云端点通道保存后的非密视图（只带 secretStored 布尔，绝无密钥值） */
+  s3?: CloudS3ChannelView;
+  gist?: CloudGistChannelView;
 }
 /** POST /sync/config 且 clear:true 的响应：断开一条通道配置后的轻量事实（无任何 secret 值）。 */
 interface SyncChannelClearResponse {
@@ -2534,6 +3011,31 @@ interface SyncPushPayload {
   encryptPassword?: string;
   /** 导出真实凭据值（必须同时 encrypt=true，否则 Host 拒绝：密钥绝不明文进同步通道） */
   includeSecrets?: boolean;
+  /** s3：具体兼容商（s3 / oss / cos / minio / kodo） */
+  provider?: string;
+  endpoint?: string;
+  region?: string;
+  bucket?: string;
+  /** 对象键前缀（缺省 = 根前缀） */
+  prefix?: string;
+  /** AccessKey ID（标识符，可回显；不是密钥） */
+  accessKeyId?: string;
+  /** path-style 寻址（缺省跟随兼容商变体） */
+  pathStyle?: boolean;
+  /** 显式覆盖签名方言（高级覆盖；宿主忽略非法值） */
+  dialectId?: 'aws4' | 'oss4';
+  /** gist：目标 gist id */
+  gistId?: string;
+  /** gist：GitHub API 根（缺省 https://api.github.com） */
+  apiBaseUrl?: string;
+  /** gist：文件名前缀（缺省 dsh-sync） */
+  filePrefix?: string;
+  /**
+   * 云端点密钥（s3 的 AccessKey Secret / gist 的 token）：**只写**。
+   * 仅请求体内存传输；宿主写入 DSH credentials 槽位（cloudSecretRef）后即丢弃。
+   * 响应、配置文件与日志里永远只有 `secretStored` 布尔。
+   */
+  secret?: string;
 }
 /** pull 请求体（strategy 缺省 merge：冲突保留待决策；snapshotId 缺省 = 最新；
  *  decryptPassword 可选：拉取加密快照时提供，仅内存传输）。 */
@@ -2769,6 +3271,33 @@ interface GithubValidateResponse {
   /** GitHub 登录名（valid=true 时；非敏感展示位） */
   login?: string;
 }
+/** 仓库列表条目（宿主 `GitHubRepoSummary` 的投影；token 等秘密永不在此出现）。 */
+interface GithubRepositorySummary {
+  /** owner/name */
+  fullName: string;
+  /** 仓库主页（展示用） */
+  htmlUrl: string;
+  /** 提交值：clone URL（https 形态，不含凭据） */
+  cloneUrl: string;
+  defaultBranch: string;
+  private: boolean;
+  fork: boolean;
+  /** 最近一次 push（ISO 8601；空仓库 → 空串） */
+  pushedAt: string;
+  /** 最近一次更新（ISO 8601；缺字段 → 空串） */
+  updatedAt: string;
+}
+/** GET /sync/github/repositories 响应：当前 GitHub 用户可见的仓库（按最近更新排序）。 */
+interface GithubRepositoriesResponse {
+  ok: boolean;
+  repos: GithubRepositorySummary[];
+}
+/** POST /sync/github/repositories 响应：新建的仓库。
+ *  **恒定私有** —— 宿主强制 private:true，客户端无法请求公开仓库。 */
+interface GithubCreateRepositoryResponse {
+  ok: boolean;
+  repo: GithubRepositorySummary;
+}
 /** 远程同步浏览器半数据入口（备份与迁移页第 4 个 tab 的注入业务面） */
 declare class SyncApi {
   readonly t: UiT;
@@ -2825,6 +3354,12 @@ declare class SyncApi {
   /** GitHub token 有效性校验（判定「是否已登录」：token 存在且 GitHub API 接受；
    *  401 → valid:false 引导重新登录；非 401 错误向上抛，UI 兜底不误判登出） */
   githubValidate(): Promise<GithubValidateResponse>;
+  /** 列出当前 GitHub 用户可见的仓库（供「选择已有仓库」下拉；只读，不改任何状态）。
+   *  未登录 / token 失效 → 401，由调用方按「先登录」引导处理。 */
+  githubListRepositories(): Promise<GithubRepositoriesResponse>;
+  /** 新建仓库并返回其信息（供「新建仓库」表单；**宿主强制私有**，
+   *  描述为空则不传该字段）。名称非法 / 已存在 → 422，由调用方展示原因。 */
+  githubCreateRepository(name: string, description?: string): Promise<GithubCreateRepositoryResponse>;
   /** 同步历史：列出本地祖先快照 + 自动同步执行记录（按 createdAt 倒序合并）。 */
   history(): Promise<SyncHistoryResponse>;
   /** 远端历史快照列表（供「选择历史快照」下拉）。 */
@@ -3006,11 +3541,9 @@ interface MarketPreparePayload {
   /** 发布模式：'migrate'（缺省，迁移全带）| 'share'（分享：自动排除敏感分区 + 强制隐私拦截） */
   mode?: MarketPublishMode;
 }
-/** POST /market/prepare 响应：条目包生成结果（manifest 文本 + 校验摘要 + 发布目录） */
+/** POST /market/prepare 响应：条目包生成结果（manifest 文本 + 校验摘要） */
 interface MarketPrepareResponse {
   ok: boolean;
-  /** 发布目录（受控临时区，含 items/<id>/manifest.json + config.zip；懒 GC 与下载临时区同款） */
-  dir: string;
   /** 发布目录打包 zip 路径（受控临时区，供 /download 端点下载；懒 GC 清理） */
   zipPath: string;
   /** items/<id>/manifest.json 内容（pretty JSON，可直接复制/写入） */
@@ -3200,6 +3733,105 @@ declare class MyConfigsApi {
   meDelete(itemId: string): Promise<DeleteResult>;
 }
 //#endregion
+//#region src/core/session-repair.d.ts
+/** 单条会话的修复原因（机器可读；文案由 CLI 输出层决定）。 */
+type SessionRepairReason =
+/** header 里没有 cwd（DSH 的 _no-cwd 会话）：无法判定目标目录 */
+'no-cwd' |
+/** 同一会话的多份 generation 的 cwd 不一致：不猜哪份为准 */
+'inconsistent-generations' |
+/** 目录内有 session.lock：可能正被使用 */
+'locked' |
+/** 位置已经正确 */
+'already-placed' |
+/** 需要搬家（header 未变） */
+'needs-move' |
+/** 需要先改写首帧 cwd（路径映射命中）再搬家 */
+'needs-rewrite-move' |
+/** 同一 id 出现在多个 projectKey 目录 */
+'duplicate-id';
+/** 一条动作的类别（决定 CLI 做什么）。 */
+type SessionRepairActionKind =
+/** 无需动作 */
+'ok' |
+/** 搬目录到正确 projectKey 段 */
+'move' |
+/** 改写首帧 cwd 后再搬目录 */
+'rewrite-move' |
+/** 只报告，不动（缺 cwd / 加锁 / 多 generation 不一致） */
+'skip' |
+/** 重复 id 里按 --keep 保留的那一份 */
+'keep' |
+/** 重复 id 里被移到隔离目录的那一份 */
+'quarantine';
+interface SessionRepairSummary {
+  scanned: number;
+  ok: number;
+  move: number;
+  rewriteMove: number;
+  skip: number;
+  keep: number;
+  quarantine: number;
+  /** 受影响的重复 id 条数（同一 id 的多份只算一次） */
+  duplicates: number;
+}
+//#endregion
+//#region src/ui/session-layout-view.d.ts
+/** E1 计划里的一条动作（**不含绝对路径**：身份 = `<fromProjectKey>/<sessionId>`）。 */
+interface SessionLayoutPlanItemView {
+  unitId: string;
+  sessionId: string;
+  kind: SessionRepairActionKind;
+  fromProjectKey: string;
+  toProjectKey?: string;
+  /** 面板入口不支持路径映射 ⇒ 恒缺席（这里保留字段只为与宿主同形） */
+  rewrite?: {
+    from: string;
+    to: string;
+  };
+  reason: SessionRepairReason;
+  applies: boolean;
+}
+interface SessionLayoutPlanView {
+  ok: boolean;
+  readOnly: boolean;
+  /** 会话根读不出来时的机器码（`sessions-root-unreadable`） */
+  reason?: string;
+  summary: SessionRepairSummary;
+  actions: SessionLayoutPlanItemView[];
+  needsAttention: boolean;
+  /** 有重复 id 但**还没选定保留哪一份**的 sessionId（面板据此要求用户选） */
+  needsKeep: string[];
+}
+interface SessionLayoutApplyItemView {
+  unitId: string;
+  sessionId: string;
+  action: SessionRepairActionKind;
+  ok: boolean;
+  reason?: string;
+  /** 隔离去向（**相对** `<home>/sessions`；可直接渲染） */
+  quarantineDir?: string;
+  /** 归位后的新身份 */
+  movedUnitId?: string;
+  /** 失败后是否已成功回滚（true = 已回到原状态；false = **回滚也没成功**，危险态） */
+  rolledBack?: boolean;
+  needsAttention?: boolean;
+}
+interface SessionLayoutApplyView {
+  ok: boolean;
+  applied: number;
+  failed: number;
+  skipped: number;
+  results: SessionLayoutApplyItemView[];
+  /** 整体未执行：`reindex-unavailable`（宿主没给索引刷新端口）/ `sessions-root-unreadable` */
+  reason?: string;
+}
+/**
+ * 这条路由的两种响应（apply=false → 计划；apply=true → 执行结果）。
+ * 判别：执行结果带 `results` 数组，计划带 `actions`/`needsKeep`。
+ */
+type SessionLayoutResponse = SessionLayoutPlanView | SessionLayoutApplyView;
+//#endregion
 //#region src/client/recovery/recovery-api.d.ts
 /** Recovery 浏览器半数据入口（实现 RecoveryPort 契约）。 */
 declare class RecoveryApi implements RecoveryPort {
@@ -3228,6 +3860,19 @@ declare class RecoveryApi implements RecoveryPort {
   }, allowLossy?: boolean): Promise<SessionRepairResult>;
   /** POST /recovery/sessions/rollback（T8）：按台账 repairId 回滚（客户端不传路径）。 */
   rollbackSessionRepair(repairId: string): Promise<SessionRepairRollbackResult>;
+  /**
+   * POST /recovery/sessions/layout（E2）：**布局归位 / 重复 id 隔离**（写入口）。
+   *
+   * apply=false = **只读计划**（宿主不拿锁、不过门、零写入；响应带 needsKeep，界面据此要求用户
+   * 选定保留哪一份）；apply=true = 应用（过 SAFE MODE + mutation lock；keep 必须覆盖全部 needsKeep，
+   * 否则该 id 被显式拒绝而不是静默跳过）。
+   *
+   * 安全口径（**必须与界面文案一致**）：本入口在 **DSH 运行时**执行，与离线 CLI
+   * `dcm sessions repair --fix` 的「须先停 DSH」不同 —— 靠宿主侧逐目标门前置 + 每次移动后
+   * **索引刷新必须成功** + 失败逐条回滚兜底。任何拒绝都以 `ok:false + reason`（或逐条 reason 码）
+   * 表达，**不是** HTTP 错误，界面必须逐条如实说明。
+   */
+  layoutRepairSessions(apply: boolean, keep?: Record<string, string>): Promise<SessionLayoutResponse>;
   /** GET /recovery/:operationId/preview：只读恢复预览（restore plan + verification plan）。 */
   preview(operationId: string): Promise<RecoveryPreview>;
   /** POST /recovery/:operationId/confirm：确认恢复（journal 保持 NEEDS_ATTENTION）。 */
@@ -3454,6 +4099,12 @@ declare const zh$3: {
   readonly 'common.retry': '重试';
   readonly 'common.loading': '加载中…';
   readonly 'common.unknownError': '未知错误';
+  readonly 'common.parens': '（{text}）';
+  readonly 'about.cli.help': '列出全部 CLI 命令与用法（离线可用）';
+  readonly 'about.cli.snapshots': '列出本机回滚快照（无需 DSH 运行）';
+  readonly 'about.cli.restore': '恢复到导入前状态（离线）';
+  readonly 'about.cli.reinstall': '一键重装 DSH（救援）';
+  readonly 'common.listSeparator': '、';
   readonly 'toast.copied': '已复制到剪贴板';
   readonly 'toast.copyFailed': '复制失败，请手动选择文本复制';
   readonly 'toast.refreshed': '已刷新';
@@ -3527,7 +4178,6 @@ declare const zh$3: {
   readonly 'export.includeSecrets': '导出密钥';
   readonly 'export.includeSecretsHint': '把真实密钥（凭据值）写入备份。密钥必须以加密形式保存：勾选时会自动选中「加密备份」；取消「加密备份」会同时取消「导出密钥」。';
   readonly 'export.run': '开始导出';
-  readonly 'export.previewSkipped': '{count} 个分区导出失败已跳过';
   readonly 'export.running': '正在导出…';
   readonly 'export.download': '下载备份文件';
   readonly 'export.saved': '已保存到下载目录：{name}';
@@ -3660,10 +4310,7 @@ declare const zh$3: {
   readonly 'import.paths.unresolved': '还有 {count} 条路径未映射（留空将跳过该路径，可以继续）';
   readonly 'import.paths.empty': '无需映射路径';
   readonly 'snapshots.title': '备份与快照';
-  readonly 'snapshots.subTab.restore': '安全快照';
-  readonly 'snapshots.subTab.files': '备份文件';
-  readonly 'snapshots.subTab.schedule': '定时备份';
-  readonly 'snapshots.subTab.recovery': '事故恢复';
+  readonly 'home.schedule.title': '定时备份';
   readonly 'snapshots.empty.title': '尚无安全快照';
   readonly 'snapshots.empty.body': '安全快照在导入 / 恢复前自动创建，用于一键回滚；也可立即手动创建一个。';
   readonly 'snapshots.empty.viewFiles': '查看备份文件';
@@ -3925,6 +4572,13 @@ declare const zh$3: {
   readonly 'profiles.shape.web': 'Web';
   readonly 'profiles.shape.headless': 'Headless';
   readonly 'profiles.shape.generic': '自定义';
+  readonly 'profiles.shape.incomplete': '未完成的副本';
+  readonly 'profiles.incomplete.from': '从「{name}」复制';
+  readonly 'profiles.incomplete.startedAt': '开始于 {time}';
+  readonly 'profiles.incomplete.dir': '目录 {path}';
+  readonly 'profiles.incomplete.hint': '这是一次被中断的档案复制：没有 package.json，无法启动。确认不需要后可直接删除（只删这个目录，不影响其它档案）。';
+  readonly 'profiles.list.incompleteCount': '未完成的副本 {count} 个（不可启动，可直接删除）';
+  readonly 'profiles.delete.incompleteMessage': '确认删除未完成的副本「{name}」？将物理删除整个目录（含已拷入的部分文件），不可恢复。';
   readonly 'profiles.issue.manifestInvalid': 'package.json 损坏';
   readonly 'profiles.issue.patchTooLarge': 'patch 文件过大（未展示原文）';
   readonly 'profiles.bundles': '插件层（bundles）';
@@ -3989,7 +4643,7 @@ declare const zh$3: {
   readonly 'import.compatibility.score.partial': '部分兼容';
   readonly 'import.compatibility.score.unsupported': '不支持';
   readonly 'import.compatibility.sectionsTitle': '备份包含的分区';
-  readonly 'nav.overview': '总览';
+  readonly 'nav.home': '首页';
   readonly 'nav.backups': '备份';
   readonly 'nav.export': '导出';
   readonly 'nav.import': '导入';
@@ -3997,6 +4651,7 @@ declare const zh$3: {
   readonly 'nav.market': '市场';
   readonly 'nav.profiles': '档案';
   readonly 'nav.refresh': '刷新';
+  readonly 'shell.running.restore': '快照恢复';
   readonly 'shell.status.idle': '就绪';
   readonly 'shell.status.running': '{count} 个任务进行中';
   readonly 'shell.status.recovery': '恢复待处理';
@@ -4063,18 +4718,6 @@ declare const zh$3: {
   readonly 'overview.result.skipped': '跳过';
   readonly 'overview.activity.copy': '复制';
   readonly 'overview.activity.redacted': '（文件名已脱敏）';
-  readonly 'overview.location.title': '备份位置';
-  readonly 'overview.location.dir': '备份目录';
-  readonly 'overview.location.totalSize': '备份总体积';
-  readonly 'overview.location.retention': '快照保留';
-  readonly 'overview.location.retentionValue': '{used} / {limit}';
-  readonly 'overview.location.schedule': '定时备份';
-  readonly 'overview.location.scheduleOff': '未开启';
-  readonly 'overview.location.nextRun': '下次备份';
-  readonly 'overview.location.lastRun': '上次备份';
-  readonly 'overview.sections.title': '分区构成';
-  readonly 'overview.sections.hint': '按当前配置估算（只读预览，零写入）';
-  readonly 'overview.sections.total': '合计';
   readonly 'overview.sections.entries': '{count} 项';
   readonly 'overview.quick.exportTitle': '生成可迁移的 ZIP 备份文件并下载';
   readonly 'overview.quick.importTitle': '从备份文件恢复或迁移到本机';
@@ -4105,6 +4748,26 @@ declare const zh$3: {
   readonly 'about.update.noCommand': '未识别到当前档案，或该档案由桌面端独占管理 —— 请在 DSH 的插件页更新本插件。';
   readonly 'about.update.check': '检查更新';
   readonly 'about.update.recheck': '重新检查';
+  readonly 'about.update.apply': '立即更新';
+  readonly 'about.update.applied': '已更新到 {version}，重启 DSH 后生效';
+  readonly 'about.update.dialog.title': '更新到 {version}';
+  readonly 'about.update.dialog.from': '当前版本 {current}';
+  readonly 'about.update.dialog.loadingNotes': '正在获取更新说明…';
+  readonly 'about.update.dialog.notesFailed': '获取更新说明失败：{error}（不影响更新）';
+  readonly 'about.update.dialog.noNotes': '未找到 v{version} 的发布说明，可直接更新。';
+  readonly 'about.update.dialog.notExact': '未找到 v{version} 的发布说明，以下为最新一条发布内容。';
+  readonly 'about.update.dialog.viewOnGithub': '在 GitHub 查看全部版本';
+  readonly 'about.update.dialog.viewReleaseOnGithub': '在 GitHub 查看此版本';
+  readonly 'about.update.dialog.install': '立即更新';
+  readonly 'about.update.dialog.installing': '正在更新，请稍候…';
+  readonly 'about.update.dialog.done': '更新完成：已安装 v{version}。';
+  readonly 'about.update.dialog.restart': '请重启 DSH 使新版本生效（完全退出后重新启动；正在运行的进程仍是旧版本）。';
+  readonly 'about.update.code.invalidVersion': '版本号无效，未能更新。';
+  readonly 'about.update.code.profileUnknown': '无法识别当前档案，请在 DSH 的插件页更新本插件。';
+  readonly 'about.update.code.unsupportedProfile': '桌面端档案由桌面应用独占管理，请在 DSH 的插件页更新本插件。';
+  readonly 'about.update.code.nonRegistryInstall': '当前是本机/开发来源安装（link/file/git），不会用 registry 版本覆盖它 —— 请在来源目录更新。';
+  readonly 'about.update.code.notNewer': '目标版本不高于当前版本，无需更新。';
+  readonly 'about.update.code.installFailed': '更新失败：{error}';
   readonly 'palette.group.action': '动作';
   readonly 'palette.group.library': '产物库';
   readonly 'palette.group.navigate': '前往';
@@ -4171,10 +4834,104 @@ declare const zh$3: {
   readonly 'palette.view.activity': '活动记录';
   readonly 'palette.view.about': '关于';
   readonly 'palette.rescue.recovery': '事故恢复';
+  readonly 'palette.rescue.mode': '救援模式';
   readonly 'import.reason.schemaUnsupported': '包内 schema 版本 v{version} 超出本插件支持范围';
   readonly 'import.reason.missingSections': '备份声明但包内缺失 {count} 个分区：{sections}';
   readonly 'import.reason.sourceNewer': '备份来自更新的 DSH（{source} → 本机 {target}）：可能有本机不认识的配置';
   readonly 'import.reason.sourceOlder': '备份来自更旧的 DSH（{source} → 本机 {target}）：向后兼容';
+  readonly 'foreign.source.title': '从其它 agent 导入';
+  readonly 'foreign.source.hint': '读取本机已装的其它 agent 配置，先看清将导入什么，再交给既有的导入向导（分析只读，零写入）。';
+  readonly 'foreign.source.selectTitle': '选择来源';
+  readonly 'foreign.source.loading': '正在检测本机配置…';
+  readonly 'foreign.source.empty': '未检测到任何可导入的其它 agent 配置。';
+  readonly 'foreign.source.unknown': '未识别的来源。';
+  readonly 'foreign.source.found': '已检测到';
+  readonly 'foreign.source.notFound': '未检测到';
+  readonly 'foreign.source.paths': '路径';
+  readonly 'foreign.source.locationOverridden': '位置由环境变量覆盖';
+  readonly 'foreign.source.detectFailed': '检测失败：{reason}';
+  readonly 'foreign.source.claude-code': 'Claude Code';
+  readonly 'foreign.source.hermes': 'Hermes';
+  readonly 'foreign.source.cursor': 'Cursor';
+  readonly 'foreign.source.codex': 'Codex CLI';
+  readonly 'foreign.source.copilot': 'GitHub Copilot CLI';
+  readonly 'foreign.source.antigravity': 'Google Antigravity';
+  readonly 'foreign.source.gemini': 'Gemini CLI';
+  readonly 'foreign.source.reasonix': 'Reasonix';
+  readonly 'foreign.source.opencode': 'OpenCode';
+  readonly 'foreign.source.mimocode': 'MimoCode';
+  readonly 'foreign.source.zcode': 'ZCode';
+  readonly 'foreign.source.grokbuild': 'Grok Build';
+  readonly 'foreign.source.openclaw': 'OpenClaw';
+  readonly 'foreign.source.pi': 'Pi';
+  readonly 'foreign.source.kimi': 'Kimi CLI';
+  readonly 'foreign.source.kilocode': 'Kilo Code';
+  readonly 'foreign.source.qoder': 'Qoder';
+  readonly 'foreign.source.chatgpt': 'ChatGPT';
+  readonly 'foreign.source.workbuddy': 'WorkBuddy';
+  readonly 'foreign.source.qwen': '千问办公';
+  readonly 'foreign.source.continue': 'Continue';
+  readonly 'foreign.source.cline': 'Cline';
+  readonly 'foreign.source.goose': 'Goose';
+  readonly 'foreign.source.dsh4': 'DSH 会话日志（V4 代次）';
+  readonly 'foreign.source.zed': 'Zed';
+  readonly 'foreign.source.crush': 'Crush';
+  readonly 'foreign.source.teleagent': 'TeleAgent';
+  readonly 'foreign.source.trae': 'Trae';
+  readonly 'foreign.source.vibe': 'Vibe';
+  readonly 'foreign.source.dsh': 'DSH 会话日志（V0-V3 代次）';
+  readonly 'foreign.action.import': '开始导入';
+  readonly 'foreign.action.preview': '查看将导入的内容';
+  readonly 'foreign.action.refresh': '重新检测';
+  readonly 'foreign.action.retry': '重试';
+  readonly 'foreign.action.close': '关闭';
+  readonly 'foreign.loading': '正在读取外部配置…';
+  readonly 'foreign.importing': '正在转换外部配置…';
+  readonly 'foreign.importFailed': '导入失败：{reason}';
+  readonly 'foreign.previewTitle': '将导入的内容';
+  readonly 'foreign.previewEmpty': '该来源没有可导入的配置项。';
+  readonly 'foreign.previewSections': '包含分区：{sections}';
+  readonly 'foreign.previewCounts': '共 {count} 项计划动作';
+  readonly 'foreign.previewDryRun': '只读预览：不会写入任何配置。';
+  readonly 'foreign.previewReset': '来源或检测结果已变化：上一次的产包结果已作废，请重新点击「开始导入」生成新的包。';
+  readonly 'foreign.lossy.title': '已知有损（导入前必读）';
+  readonly 'foreign.lossy.hint': '下面三条是「外部配置 → bundle → 导入」这条流水线的既有行为：都不阻断导入，兼容性评分也不会为它们给出原因。';
+  readonly 'foreign.lossy.applies': '本包适用';
+  readonly 'foreign.lossy.notApplies': '本包不涉及';
+  readonly 'foreign.credentialRefs': '需补录凭据 {count} 项（值未随导入带出，请在本机补录）';
+  readonly 'foreign.credentialRefsNone': '无需补录凭据';
+  readonly 'foreign.reportOnly': '只报告、不导入：{detail}';
+  readonly 'foreign.skipped': '未迁移 {count} 项';
+  readonly 'foreign.skip.unsupported-hooks': 'settings 的 hooks：DSH 无对等结构，未迁移';
+  readonly 'foreign.skip.unsupported-commands': '斜杠命令：与 DSH 提示词不是同一语义，本次未迁移';
+  readonly 'foreign.skip.credentials-not-migrated': '凭据字段只记录名字，值不读取也不迁移';
+  readonly 'foreign.skip.skill-missing-file': '技能目录缺少 SKILL.md，未迁移';
+  readonly 'foreign.skip.skill-invalid-frontmatter': '技能 frontmatter 非法（缺 name/description 或不是合法 YAML），DSH 会静默丢弃，故未迁移';
+  readonly 'foreign.skip.skill-invalid-name': '技能名含非法字符或路径穿越，未迁移';
+  readonly 'foreign.skip.mcp-server-empty': 'MCP 条目既无 command 也无 url，未迁移';
+  readonly 'foreign.skip.mcp-type-sse-coerced': 'MCP type=sse：按带 url 的 http 处理';
+  readonly 'foreign.skip.mcp-credential-redacted': 'MCP 值里发现凭据字段：值已丢弃，只保留字段名与引用名';
+  readonly 'foreign.skip.source-unreadable': '外部文件读不到、超限或解析失败';
+  readonly 'foreign.skip.source-empty-file': '配置文件存在但为空（0 字节）：如实上报，不产出空分区';
+  readonly 'foreign.skip.source-location-overridden': '配置位置被环境变量覆盖，按覆盖后的位置读取';
+  readonly 'foreign.skip.session-cwd-derived': '会话记录里没有 cwd：按源侧目录名推导出工作目录，且该目录在本机确实存在（推不出来的一律按「缺少 cwd」跳过）';
+  readonly 'foreign.skip.source-needs-explicit-path': '该来源没有自动探测位置：必须显式提供导出文件路径（自动探测永远不会命中）';
+  readonly 'foreign.skip.session-format-version-unknown': '本机 DSH 会话格式版本未知：不猜版本，整批会话未迁移';
+  readonly 'foreign.skip.session-format-unsupported': '本机 DSH 会话格式版本不受支持，该会话未迁移';
+  readonly 'foreign.skip.session-missing-cwd': '会话记录缺少 cwd，无法归位到工作区';
+  readonly 'foreign.skip.session-unsafe-id': '会话文件名不能作为安全路径段，未迁移';
+  readonly 'foreign.skip.session-empty': '会话没有任何可迁移的事件';
+  readonly 'foreign.skip.session-unparsable': '会话存在解析不出来的行，未迁移';
+  readonly 'foreign.skip.unsupported-session-record': '该类型的会话记录本版不迁移';
+  readonly 'foreign.skip.session-id-conflict': '同 id 会话已存在：不覆盖，跳过并保留本机既有的那条';
+  readonly 'foreign.skip.skill-id-conflict': '技能重名：先到先得，其余跳过';
+  readonly 'foreign.skip.sessions-not-migrated': '该来源的对话存储形态本版不迁移（只报告，不产出会话分区）';
+  readonly 'foreign.skip.memory-report-only': '记忆文件只报告、不导入（正文不进备份包）';
+  readonly 'foreign.skip.skill-category-flattened': '技能带分类层级：已压平为 DSH 的单层技能目录';
+  readonly 'foreign.skip.legacy-rules-file': '旧式规则文件：DSH 无对等结构，只报告';
+  readonly 'foreign.skip.instructions-merged': '多份指令源被合并为一个全局指令文件';
+  readonly 'foreign.skip.instructions-override-selected': '命中更高优先级的指令文件（override），按它导入';
+  readonly 'foreign.conflict.policy': '同 id 冲突：不覆盖本机既有内容，跳过并在报告里逐条说明';
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type ConfigManagerKey = keyof typeof zh$3;
@@ -4203,9 +4960,13 @@ declare const zh$2: {
   readonly 'channel.title': '同步通道';
   readonly 'channel.git': 'Git 私有仓库';
   readonly 'channel.webdav': 'WebDAV 服务器';
-  readonly 'channel.perChannelHint': 'GitHub 与 WebDAV 通道的自动同步、同步模式、加密与远端快照各自独立配置。';
+  readonly 'channel.s3': '对象存储（S3 兼容）';
+  readonly 'channel.gist': 'GitHub Gist';
+  readonly 'channel.perChannelHint': '每条通道（Git / WebDAV / 对象存储 / Gist）的自动同步、同步模式、加密与远端快照各自独立配置。';
   readonly 'channel.open': '配置同步通道';
   readonly 'channel.openHint': '远程同步通过「同步通道」进行：Git 私有仓库或 WebDAV 服务器。点击按钮在弹窗中配置或修改。';
+  readonly 'channel.expand': '展开通道详情';
+  readonly 'channel.collapse': '收起通道详情';
   readonly 'channel.clear': '断开配置';
   readonly 'channel.clearConfirmTitle': '断开同步通道配置？';
   readonly 'channel.clearConfirmMessage': '将删除「{channel}」的本机配置、已保存的凭据与自动同步开关。远端快照与本机备份不受影响；断开后可重新配置。';
@@ -4236,6 +4997,29 @@ declare const zh$2: {
   readonly 'github.userCode': '一次性授权代码';
   readonly 'github.openAuth': '打开 GitHub 授权页面';
   readonly 'github.clientIdHint': '需要插件配置 githubClientId（GitHub OAuth App 的 client_id）才能使用 GitHub 登录。';
+  readonly 'repoPicker.label': '从我的仓库中选择';
+  readonly 'repoPicker.hint': '列出你 GitHub 账号下**已有的私有仓库**（按最近更新排序），选中即填入下方仓库地址；也可以直接在下方手填地址（ssh / 本地路径 / 不在列表里的仓库）。列表需要先登录 GitHub；新建的仓库一律为私有 —— 公开仓库会公开你的配置内容。';
+  readonly 'repoPicker.placeholder': '手动填写地址（或从上方选择）';
+  readonly 'repoPicker.refresh': '刷新列表';
+  readonly 'repoPicker.refreshing': '刷新中…';
+  readonly 'repoPicker.forkBadge': 'Fork';
+  readonly 'repoPicker.empty': '没有可用的私有仓库，可选「新建私有仓库」。';
+  readonly 'repoPicker.loadFailed': '仓库列表加载失败，可重试或直接手填地址。';
+  readonly 'repoPicker.updatedAt': '更新于 {time}';
+  readonly 'repoPicker.create': '＋ 新建私有仓库…';
+  readonly 'repoPicker.createTitle': '新建私有仓库';
+  readonly 'repoPicker.name': '仓库名';
+  readonly 'repoPicker.namePlaceholder': '如 dsh-configs';
+  readonly 'repoPicker.description': '描述';
+  readonly 'repoPicker.descriptionPlaceholder': '可选，如「我的配置仓库（dsh-config-manager 自动发布）」';
+  readonly 'repoPicker.createSubmit': '创建并选用';
+  readonly 'repoPicker.creating': '创建中…';
+  readonly 'repoPicker.createCancel': '取消';
+  readonly 'repoPicker.created': '已创建私有仓库 {name}，地址已填入。';
+  readonly 'repoPicker.createFailed': '新建仓库失败';
+  readonly 'repoPicker.nameRequired': '请填写仓库名。';
+  readonly 'repoPicker.nameInvalid': '仓库名只能包含字母、数字、点、下划线、连字符（最长 100 字符，不能以点开头）。';
+  readonly 'repoPicker.privateOnly': '新建的仓库固定为私有：公开仓库会公开你的配置内容。';
   readonly 'status.title': '同步状态';
   readonly 'status.never': '从未同步';
   readonly 'action.push': '推送到远端';
@@ -4424,6 +5208,56 @@ declare const zh$2: {
   readonly 'syncflow.compat.good': '兼容性：良好（备份来自更旧的 DSH）';
   readonly 'syncflow.compat.partial': '兼容性：部分兼容（跨平台 / 分区缺失 / 版本超前，需人工确认）';
   readonly 'syncflow.compat.unsupported': '兼容性：不受支持（格式版本超出范围）';
+  readonly 'cloud.s3Title': '对象存储（S3 兼容）';
+  readonly 'cloud.gistTitle': 'GitHub Gist';
+  readonly 'cloud.provider': '兼容商';
+  readonly 'cloud.providerHint': '五家共用同一套 SigV4 签名实现；端点与寻址风格按兼容商取缺省。';
+  readonly 'cloud.provider.s3': 'AWS S3';
+  readonly 'cloud.provider.oss': '阿里云 OSS';
+  readonly 'cloud.provider.cos': '腾讯云 COS';
+  readonly 'cloud.provider.minio': 'MinIO';
+  readonly 'cloud.provider.kodo': '七牛 Kodo';
+  readonly 'cloud.endpoint': '端点 Endpoint';
+  readonly 'cloud.endpointHint': '不含桶名与凭据，例如 https://s3.us-east-1.amazonaws.com。';
+  readonly 'cloud.region': '区域 Region';
+  readonly 'cloud.regionHint': 'V4 签名作用域，例如 us-east-1 / cn-hangzhou。';
+  readonly 'cloud.bucket': '存储桶 Bucket';
+  readonly 'cloud.bucketHint': '3-63 位小写字母、数字、点或连字符，首尾须为字母或数字。';
+  readonly 'cloud.prefix': '对象键前缀（可选）';
+  readonly 'cloud.prefixHint': '留空 = 根前缀；首尾斜杠会被忽略。';
+  readonly 'cloud.accessKeyId': 'AccessKey ID';
+  readonly 'cloud.accessKeyIdHint': '标识符（非密钥，会写入配置文件）；Secret 请填在下方密钥框。';
+  readonly 'cloud.pathStyle': '使用 path-style 寻址';
+  readonly 'cloud.pathStyleHint': 'MinIO 等自建服务通常需要；不勾选则跟随兼容商缺省。';
+  readonly 'cloud.secret': 'Secret AccessKey';
+  readonly 'cloud.secretHint': '值只写入 DSH 凭据槽位（{ref}）：不进配置文件、不进日志、不回传浏览器；留空表示沿用已保存的密钥。';
+  readonly 'cloud.secretSaved': '密钥已保存';
+  readonly 'cloud.secretPlaceholder': '••••••••';
+  readonly 'cloud.gistId': 'Gist ID';
+  readonly 'cloud.gistIdHint': 'gist 地址末段的十六进制 id（如 https://gist.github.com/<用户>/<id>）。';
+  readonly 'cloud.apiBaseUrl': 'API 根地址（可选）';
+  readonly 'cloud.apiBaseUrlHint': '留空 = https://api.github.com；GitHub Enterprise 可改为自建地址。';
+  readonly 'cloud.filePrefix': '文件名前缀（可选）';
+  readonly 'cloud.filePrefixHint': 'gist 内的文件名前缀，留空 = dsh-sync。';
+  readonly 'cloud.token': 'Gist token';
+  readonly 'cloud.tokenHint': '值只写入 DSH 凭据槽位（{ref}）：不进配置文件、不进日志、不回传浏览器；留空表示沿用已保存的 token。';
+  readonly 'cloud.tokenSaved': 'token 已保存';
+  readonly 'cloud.tokenPlaceholder': 'ghp_… 或 gho_…';
+  readonly 'cloud.invalidTitle': '还有必填项或格式问题没解决：';
+  readonly 'cloud.providerUnknown': '兼容商不在支持列表内';
+  readonly 'cloud.endpointRequired': '请填写端点地址';
+  readonly 'cloud.endpointInvalid': '端点地址必须是 http(s) 且不含空白 / 查询串 / 锚点';
+  readonly 'cloud.endpointUserinfo': '端点地址不得包含用户名或密码';
+  readonly 'cloud.regionRequired': '请填写区域（region）';
+  readonly 'cloud.bucketRequired': '请填写存储桶名';
+  readonly 'cloud.bucketInvalid': '桶名不合规：3-63 位小写字母、数字、点或连字符，首尾为字母或数字，且不得含 “..”';
+  readonly 'cloud.prefixInvalid': '对象键前缀不得含反斜杠、“//” 或 “..”';
+  readonly 'cloud.accessKeyIdRequired': '请填写 AccessKey ID';
+  readonly 'cloud.gistIdRequired': '请填写 Gist ID';
+  readonly 'cloud.gistIdInvalid': 'Gist ID 必须是 5-64 位十六进制串';
+  readonly 'cloud.apiBaseUrlInvalid': 'API 根地址必须是 http(s) 且不含用户名/密码';
+  readonly 'cloud.secretWriterRequired': '宿主未提供凭据写入通道，无法保存密钥';
+  readonly 'cloud.credentialsWriteFailed': '密钥写入 DSH 凭据失败（配置未保存）';
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type SyncKey = keyof typeof zh$2;
@@ -4773,7 +5607,7 @@ declare const zh: {
   readonly 'recovery.rescue.stale': '救援标记已失效（换机或重建 home）';
   readonly 'sessions.title': '会话体检';
   readonly 'sessions.readOnly': '扫描只读';
-  readonly 'sessions.desc': '扫描本机存量会话，找出「读不出来 / 下次请求会失败 / 看不见」的对话。扫描本身只读；对「重放重复行」这一类可零损失修复的问题，本页可直接修复（先预览、自动备份、可回滚）。其余损坏类别仍只能走离线 CLI。';
+  readonly 'sessions.desc': '扫描本机存量会话，按四档严重级逐条给出结论：会让 DSH 起不来 / 会话读不出来（无法加载）/ 下次请求会失败 / 看不见。扫描本身只读，不改动任何字节。应用内可修的只有两类：零损失 —— 重放重复行、可证明的合成收尾块（丢弃即恢复）；有损 —— 序列空洞、不可解析行（会截断，必须逐条显式确认，绝不批量）。两类都先预览、自动备份、可回滚。其余类别的真实出路有三条：① 会话布局归位（会话目录与首帧 cwd 不一致时搬回正确位置）；② 重复 id 隔离（保留哪一份由你指定，其余移入隔离目录）—— 这两类既可在本面板直接执行（会话体检弹窗里的「会话布局归位」入口 —— 在 DSH 运行时执行、靠门前置与逐条回滚兜底），也可以用离线 dcm sessions repair --fix；③ 容器或首帧读不出来、格式超前、未登记工作区、子代理缺父 —— 本工具不修（离线 CLI 也修不了），需人工处置或 DSH 侧动作。';
   readonly 'common.infoHint': '查看说明';
   readonly 'sessions.scanning': '体检中…';
   readonly 'sessions.scan': '开始体检';
@@ -4800,7 +5634,7 @@ declare const zh: {
   readonly 'sessions.subagent': '子代理';
   readonly 'sessions.truncated': '列表已截断：还有 {count} 条未显示（重新体检或按需缩小范围）。';
   readonly 'sessions.repair.title': '怎么修';
-  readonly 'sessions.repair.desc': '容器非法 / header 不可读 / 格式超前这类**应用内不动**的问题，先在终端预览再落盘；需要写入时建议先关闭 DSH。';
+  readonly 'sessions.repair.desc': '容器非法 / header 不可读 / 格式超前这类应用内不动的问题，先在终端预览再落盘；需要写入时建议先关闭 DSH。';
   readonly 'sessions.repair.copy': '复制命令';
   readonly 'recovery.safeMode.done': '已解除安全模式，配置修改已恢复';
   readonly 'recovery.safeMode.refused': '仍有未处理的恢复事项，已拒绝解除（请先处理下方事项）';
@@ -4810,7 +5644,7 @@ declare const zh: {
   readonly 'recovery.safeMode.action': '解除安全模式';
   readonly 'recovery.safeMode.confirmTitle': '解除安全模式';
   readonly 'recovery.safeMode.confirmMessage': '解除后，会修改配置的操作（同步 / 导入 / 保存设置）立即恢复可用。仅当该次中断确实已被放弃、且没有其他未处理的恢复事项时才应解除。是否继续？';
-  readonly 'sessions.repair.none': '本次没有可应用内修复的会话。应用内可修：重放重复行 / 可证明的合成收尾块（零损失）、seq 空洞与不可解析行（**截断，有损**，需确认）；其余问题见下方离线命令。';
+  readonly 'sessions.repair.none': '本次没有可应用内修复的会话。应用内可修：重放重复行 / 可证明的合成收尾块（零损失）、seq 空洞与不可解析行（截断，有损，需确认）；其余问题见下方离线命令。';
   readonly 'common.close': '关闭';
   readonly 'sessions.dialog.open': '打开会话体检';
   readonly 'sessions.dialog.hint': '打开后扫描本机存量会话：哪些读不出来、哪些能应用内修复，都在弹窗里处理（扫描只读）。';
@@ -4827,7 +5661,7 @@ declare const zh: {
   readonly 'sessions.repair.actionLossless': '零损失';
   readonly 'sessions.repair.actionLossy': '有损';
   readonly 'sessions.repair.applyLossy': '截断并修复';
-  readonly 'sessions.repair.plan.lossy': '这个计划含**有损**动作：截断点之后的事件会被丢弃（无法从日志里恢复，但备份可以一键回滚）。确认后再点「截断并修复」。';
+  readonly 'sessions.repair.plan.lossy': '这个计划含有损动作：截断点之后的事件会被丢弃（无法从日志里恢复，但备份可以一键回滚）。确认后再点「截断并修复」。';
   readonly 'sessions.repair.plan.title': '修复计划：{session}';
   readonly 'sessions.repair.plan.summary': '将丢弃 {rows} 行重放重复事件（{before} → {after}）；其余字节原样保留。';
   readonly 'sessions.repair.plan.backup': '写入前会自动时间戳备份；应用后可在下方「修复记录」里一键回滚。';
@@ -4843,6 +5677,16 @@ declare const zh: {
   readonly 'sessions.repair.history.rolledBack': '已回滚';
   readonly 'sessions.repair.history.dropped': '丢弃 {rows} 行';
   readonly 'sessions.repair.history.unreadable': '修复台账读不出来，本次无法显示或回滚历史修复（备份文件仍在会话目录里）。';
+  readonly 'sessions.zip.action': '下载原始日志 (ZIP)';
+  readonly 'sessions.zip.hint': '由 DSH 自己打包这条会话的原始日志（含子会话与附件）；不经过本插件，孤儿/多代日志一并带上。';
+  readonly 'sessions.zip.checking': '正在检查导出能力…';
+  readonly 'sessions.zip.reason.serviceMissing': '当前 DSH 的会话导出通道不可用：持久化后端缺少必需的服务（session-query / session-persistence / attachments）。这条入口已停用（状态 {status}）。';
+  readonly 'sessions.zip.reason.authRequired': '无法确认导出通道的可用性：本机自请求被认证挡在门外（状态 {status}）。这不代表本机不支持导出 —— 请重启 DSH 后再试。';
+  readonly 'sessions.zip.reason.readFailed': '导出通道在线，但这条会话的日志读取失败（状态 {status}）。请先用上方体检/修复处理这条会话。';
+  readonly 'sessions.zip.reason.networkError': '探测导出通道时拿不到响应（连不上或超时）。入口保持可用：真正点下载时若仍失败，会由 DSH 给出具体原因。';
+  readonly 'sessions.zip.reason.unexpectedStatus': '导出通道返回了未预期的状态（{status}）。入口保持可用，但下载可能失败。';
+  readonly 'sessions.zip.done': '已开始下载：{name}';
+  readonly 'sessions.zip.failed': '下载失败';
   readonly 'sessions.repair.reason.unknownUnit': '这条会话在会话库里找不到了（可能刚被移动或删除）。';
   readonly 'sessions.repair.reason.notFound': '会话日志文件不在了。';
   readonly 'sessions.repair.reason.locked': '会话目录里有 session.lock —— 可能正被使用，已拒绝写入。';
@@ -4856,13 +5700,145 @@ declare const zh: {
   readonly 'sessions.repair.reason.tornTail': '只有末尾撕裂帧（DSH 自己会截断自愈），无需修复。';
   readonly 'sessions.repair.reason.invalidHeader': '首帧 header 不是合法单行 JSON —— 应用内不重建 header。';
   readonly 'sessions.repair.reason.nothingToFix': '没有发现可零损失修复的重放重复行。';
-  readonly 'sessions.repair.reason.lossyRequired': '这条会话只能做**有损**修复（截断），需要你显式确认后才会执行。';
+  readonly 'sessions.repair.reason.lossyRequired': '这条会话只能做有损修复（截断），需要你显式确认后才会执行。';
   readonly 'sessions.repair.reason.verificationRefused': '写前校验未通过，已拒绝修复。';
   readonly 'sessions.repair.reason.writeFailed': '写入失败（临时文件 / 备份 / 换入出错），原文件未改动。';
   readonly 'sessions.repair.reason.postcheckFailed': '写后复验未通过，已用备份还原。';
   readonly 'sessions.repair.reason.backupInvalid': '备份不可用或不可信，已拒绝回滚。';
   readonly 'sessions.repair.reason.unknown': '修复未成功（原因未知），原文件保持原样。';
+  readonly 'sessions.repair.reason.verifyFailed': '写后真 codec 复验未通过：这次修复没有被接受（是否已自动回滚见下方复验结论）。';
+  readonly 'sessions.repair.reason.targetChanged': '回滚前发现目标又被改过（指纹不一致），已拒绝覆盖 —— 绝不覆盖别人的内容。';
+  readonly 'sessions.repair.verify.current': '复验通过：DSH 现役读盘路径此刻就能直接读这条会话。';
+  readonly 'sessions.repair.verify.migrated': '复验通过：只有迁移链能还原它（不是 DSH 的现役读盘路径）——「迁移链可还原」不等于「现役读盘可读」。';
+  readonly 'sessions.repair.verify.unverified': '未验证：本机跑不了真 codec 复验，所以 DSH 现在能否读它并没有被证明 —— 未验证不等于已验证（写入是否生效另说）。';
+  readonly 'sessions.repair.verify.rollbackFailed': '危险态：复验失败后自动回滚没有成功，目标当前仍是修复后的字节，需要人工处理。';
   readonly 'sessions.repair.rejectedNext': '原文件没有被改动。可以再点一次「开始体检」看最新状态；如果原因与「文件被改过/正在被写入」有关，等这条会话安静下来再试。';
+  readonly 'checkpoint.code.storage-unavailable': '检查点存储不可用';
+  readonly 'checkpoint.code.ledger-write-failed': '检查点台账写不进去';
+  readonly 'checkpoint.code.confirmation-required': '需要显式确认才能回滚';
+  readonly 'checkpoint.code.record-not-found': '找不到该检查点';
+  readonly 'checkpoint.code.protected-checkpoint': '该检查点受保护：不可回滚、不可删除';
+  readonly 'checkpoint.code.record-incomplete': '该检查点三态不全，缺省不允许回滚';
+  readonly 'checkpoint.code.guard-failed': '回滚前的保护点没能拍下来，已中止（零写入）';
+  readonly 'checkpoint.code.invalid-input': '请求参数不合法';
+  readonly 'checkpoint.code.no-chunks': '没有给出工作区路径分块';
+  readonly 'checkpoint.code.chunk-not-absolute': '工作区分块必须是绝对路径';
+  readonly 'checkpoint.code.chunk-not-found': '工作区分块不存在或不可用';
+  readonly 'checkpoint.code.no-session-input': '没有指定会话（unitId 或 sessionLogPath）';
+  readonly 'checkpoint.code.session-missing': '会话日志不存在';
+  readonly 'checkpoint.code.session-out-of-root': '会话日志不在本机会话根内，已拒绝';
+  readonly 'checkpoint.code.session-too-large': '会话日志超过副本上限：只记下了游标，该态不能自动回滚';
+  readonly 'checkpoint.code.session-active': '会话日志刚被写过，为避免覆盖正在进行的对话而拒绝';
+  readonly 'checkpoint.code.session-diverged': '会话日志比捕获游标还短（被别的路径改写或截断过），拒绝覆盖';
+  readonly 'checkpoint.code.capture-degraded': '该态捕获不完整（有链接或读不到的内容被跳过，已逐条留痕）';
+  readonly 'checkpoint.code.capture-truncated': '该态捕获到达上限被截断（已如实标注）';
+  readonly 'checkpoint.code.capture-failed': '该态捕获失败';
+  readonly 'checkpoint.code.nothing-to-restore': '该检查点没有可恢复的内容';
+  readonly 'checkpoint.code.invalid-path': '记录里的路径越界（不在捕获分块内），已拒绝该条';
+  readonly 'checkpoint.code.object-missing': '内容副本缺失，已拒绝该条';
+  readonly 'checkpoint.code.object-hash-mismatch': '内容副本与记录指纹不一致，已拒绝该条';
+  readonly 'checkpoint.code.restore-failed': '恢复失败（详见逐条细节）';
+  readonly 'checkpoint.warn.ledgerUnreadable': '检查点台账读不出来（已按空台账继续，未静默）';
+  readonly 'checkpoint.warn.trackMissing': '有一态没捕获到：该态本次不能回滚';
+  readonly 'checkpoint.warn.trackDegraded': '有一态捕获不完整（回滚可能不完整）';
+  readonly 'checkpoint.warn.protected': '该检查点受保护：不可回滚、不可删除';
+  readonly 'checkpoint.warn.guardFailed': '回滚前的保护点没拍成（已记告警后继续）';
+  readonly 'checkpoint.guidance.mountStorage': '检查点存储栈缺失：把 @deepseek-ai/dsh-storage、dsh-storage-json、dsh-storage-domain 组合进当前 profile 后重试';
+  readonly 'checkpoint.guidance.fixDataDir': '插件数据目录不可写：{detail}';
+  readonly 'checkpoint.guidance.readOnlyFallback': '存储不可用期间：捕获与回滚都会干净失败，但现状列表仍可查看（不会崩，也不会假装成功）';
+  readonly 'checkpoint.guidance.probeDetail': '探测细节：{detail}';
+  readonly 'checkpoint.guidance.sessionOffline': '该会话日志超上限或副本缺失：请用离线命令处理（路径见 detail）';
+  readonly 'checkpoint.guidance.sessionRewritten': '已就地写回会话日志（路径见 detail）；日志格式与目录位置不变';
+  readonly 'checkpoint.guidance.workspacePartial': '工作区可能已部分恢复：后续段（配置/会话）本次未执行';
+  readonly 'checkpoint.title': '检查点（会话 / 工作区 / 配置 三态同点）';
+  readonly 'checkpoint.desc': '一次捕获记下三态的 capturedAt 与指纹，「同点」按跨度可核验；回滚只覆盖捕获过的内容，检查点之后新建的文件一律不删。';
+  readonly 'checkpoint.capture': '拍一个检查点';
+  readonly 'checkpoint.capture.chunks': '工作区路径（每行一个，绝对路径）';
+  readonly 'checkpoint.capture.session': '关联会话';
+  readonly 'checkpoint.capture.protect': '保护这个检查点（不可回滚、不可删除）';
+  readonly 'checkpoint.list.empty': '还没有检查点';
+  readonly 'checkpoint.col.time': '时间';
+  readonly 'checkpoint.col.states': '三态';
+  readonly 'checkpoint.col.spread': '同点跨度';
+  readonly 'checkpoint.samePoint.yes': '同点（跨度 {ms} 毫秒）';
+  readonly 'checkpoint.samePoint.no': '非同点：{reason}';
+  readonly 'checkpoint.state.workspace': '工作区';
+  readonly 'checkpoint.state.session': '会话游标';
+  readonly 'checkpoint.state.config': '插件配置';
+  readonly 'checkpoint.preview': '预览回滚';
+  readonly 'checkpoint.rewind': '回滚到此处';
+  readonly 'checkpoint.rewind.confirm': '我确认：将用该检查点覆盖工作区 / 配置 / 会话（新建的文件不会被删除）';
+  readonly 'checkpoint.delete': '删除检查点';
+  readonly 'checkpoint.legacy.guard': '回滚前的保护点';
+  readonly 'recovery.incomplete.title': '未完成的档案副本';
+  readonly 'recovery.incomplete.hint': '这些目录带「复制进行中」标记但没有 package.json，是复制被中断留下的半截副本；不能启动，只能删除（只列出有标记的目录 —— 用户手工建的目录不会出现在这里）。';
+  readonly 'recovery.incomplete.from': '来源：{name}';
+  readonly 'recovery.incomplete.startedAt': '开始于 {time}';
+  readonly 'recovery.incomplete.dir': '目录：{dir}';
+  readonly 'recovery.incomplete.delete': '删除残留';
+  readonly 'recovery.incomplete.deleteConfirm': '我确认：物理删除该残留目录（不可恢复）';
+  readonly 'recovery.incomplete.locked': '安全模式正在阻断写操作，删除未执行：{reason}';
+  readonly 'recovery.incomplete.unlock': '解除安全模式';
+  readonly 'recovery.incomplete.unreadable.title': '未能读取残留列表';
+  readonly 'recovery.incomplete.unreadable.hint': '本次枚举残留目录失败 —— 这不等于「没有残留」。请确认档案目录可读后重试。';
+  readonly 'sessions.layout.title': '会话布局归位（写动作）';
+  readonly 'sessions.layout.desc': '修复「会让 DSH 起不来」的两类问题：会话目录与首帧 cwd 不一致时把会话搬回正确位置（只搬目录，不改写首帧），以及同一会话 id 出现在多个目录时只保留你选定的那一份、其余移入隔离目录（可人工找回）。';
+  readonly 'sessions.layout.runtimeNote': '本入口在 DSH 运行时执行 —— 与离线 CLI 的「须先停 DSH」不同：靠门前置（SAFE MODE / 无 session.lock / 不在写入静止期）+ 每次移动后刷新会话索引 + 失败逐条回滚；索引刷新能力缺失时一条也不执行。';
+  readonly 'sessions.layout.quarantineNote': '重复 id 必须由你选定保留哪一份；其余副本移入隔离目录（.cm-repair-quarantine-*，可人工找回），本入口不删除任何会话。';
+  readonly 'sessions.layout.preview': '预览计划';
+  readonly 'sessions.layout.previewing': '预览中…';
+  readonly 'sessions.layout.planEmpty': '计划里没有需要执行的动作。';
+  readonly 'sessions.layout.apiMissing': '当前接口不支持布局归位（缺少 layoutRepairSessions）；请更新插件后重试 —— 本机未做任何改动。';
+  readonly 'sessions.layout.planTitle': '布局归位计划（只读，尚未改动任何文件）';
+  readonly 'sessions.layout.planReadOnly': '计划只读：确认前零写入。';
+  readonly 'sessions.layout.noCandidates': '本机没有「布局归位 / 重复 id 隔离」这一档的问题会话：扫描结果里既没有需要归位的目录，也没有重复 id。';
+  readonly 'sessions.layout.summary': '将归位 {move} 条、隔离 {quarantine} 条';
+  readonly 'sessions.layout.planSkipped': '另有 {count} 条只报告（缺 cwd / 会话被锁 / 多份 generation 的 cwd 不一致）—— 本入口不动它们。';
+  readonly 'sessions.layout.onlyReported': '只报告（不执行）';
+  readonly 'sessions.layout.keepTitle': '重复 id：请选定保留哪一份';
+  readonly 'sessions.layout.keepHint': '选中的那一份本轮不动；其余副本移入隔离目录。未选定之前不能执行。';
+  readonly 'sessions.layout.keepMissing': '还有 {count} 个重复 id 未选定保留哪一份。';
+  readonly 'sessions.layout.apply': '执行布局归位';
+  readonly 'sessions.layout.applying': '执行中…';
+  readonly 'sessions.layout.resultTitle': '布局归位结果';
+  readonly 'sessions.layout.done': '归位 {moved} 条、隔离 {quarantined} 条；失败 {failed} 条、只报告 {skipped} 条。';
+  readonly 'sessions.layout.refreshHint': '执行后会重新扫描列表；失败项已逐条尝试回滚（回滚失败的项会单独标红，绝不显示为已复原），可重试或改用离线 CLI。';
+  readonly 'sessions.layout.close': '关闭';
+  readonly 'sessions.layout.kind.ok': '位置已正确';
+  readonly 'sessions.layout.kind.move': '搬目录归位';
+  readonly 'sessions.layout.kind.rewriteMove': '改写首帧后归位（离线 CLI 路径）';
+  readonly 'sessions.layout.kind.skip': '只报告';
+  readonly 'sessions.layout.kind.keep': '保留（不动）';
+  readonly 'sessions.layout.kind.quarantine': '隔离副本';
+  readonly 'sessions.layout.kind.unknown': '未知动作';
+  readonly 'sessions.layout.status.moved': '已归位';
+  readonly 'sessions.layout.status.quarantined': '已隔离';
+  readonly 'sessions.layout.status.kept': '已保留';
+  readonly 'sessions.layout.status.skipped': '只报告（未执行）';
+  readonly 'sessions.layout.status.failed': '失败（未改动）';
+  readonly 'sessions.layout.status.rolledBack': '失败，已回滚到原状态';
+  readonly 'sessions.layout.status.rollbackFailed': '失败，且回滚未成功（需人工处理）';
+  readonly 'sessions.layout.reason.noCwd': '首帧没有 cwd，无法判定目标目录';
+  readonly 'sessions.layout.reason.inconsistentGenerations': '同一会话多份 generation 的 cwd 不一致（不猜哪份为准）';
+  readonly 'sessions.layout.reason.locked': '会话目录里有 session.lock（可能正被使用）';
+  readonly 'sessions.layout.reason.alreadyPlaced': '位置已经正确';
+  readonly 'sessions.layout.reason.needsMove': '需要搬目录';
+  readonly 'sessions.layout.reason.needsRewriteMove': '需要先改写首帧 cwd 再搬（离线 CLI 路径）';
+  readonly 'sessions.layout.reason.duplicateId': '同一会话 id 出现在多个目录';
+  readonly 'sessions.layout.reason.busy': '日志最近 30 秒内被写过（可能在活跃使用中）';
+  readonly 'sessions.layout.reason.missingKeep': '没有选定保留哪一份，已拒绝执行（其余副本一律不动）';
+  readonly 'sessions.layout.reason.keepNotACandidate': '选定的那一份不在扫描到的副本里，已拒绝执行';
+  readonly 'sessions.layout.reason.targetExists': '目标位置已经有这个会话，未搬动';
+  readonly 'sessions.layout.reason.quarantineExists': '隔离目录里已有同名副本，未搬动';
+  readonly 'sessions.layout.reason.rewriteFailed': '改写首帧 cwd 失败，因此没有搬目录';
+  readonly 'sessions.layout.reason.missingTargetKey': '计划里缺少目标 projectKey，未搬动';
+  readonly 'sessions.layout.reason.moveFailed': '搬目录失败';
+  readonly 'sessions.layout.reason.reindexFailed': '会话索引刷新失败（已回滚该条）';
+  readonly 'sessions.layout.reason.notFound': '会话目录或日志已不在了';
+  readonly 'sessions.layout.reason.ioError': '读写失败';
+  readonly 'sessions.layout.reason.reindexUnavailable': '当前宿主没有提供索引刷新能力，因此一条也没有执行（未做任何改动）';
+  readonly 'sessions.layout.reason.sessionsRootUnreadable': '会话根读不出来，无法规划（未做任何改动）';
+  readonly 'sessions.layout.reason.unknown': '未知原因（未做任何改动）';
 };
 /** 字典键联合（注册处 compile-time 校验）。 */
 type RecoveryKey = keyof typeof zh;
@@ -4888,6 +5864,8 @@ interface ExportViewProps {
 interface ImportWizardViewProps {
   api: ConfigManagerApi;
   t: TranslateNS<'config-manager'>;
+  uiT?: UiT;
+  onOpenForeignImport?: () => void;
 }
 //#endregion
 //#region src/client/sync/SyncPanel.d.ts
@@ -4921,6 +5899,11 @@ interface MarketPanelProps {
    * 缺省（页面路径、从「逛市场」按钮进入）= 只打开列表，行为不变。
    */
   openItemId?: string;
+  /**
+   * 直达的「市场子视图」（v3）：⌘K「发布到市场」与产物库「发布到市场」把 payload 带进来，
+   * 面板挂载时直接落在「我的配置」。缺省 = 按上次持久化的子视图（行为不变）。
+   */
+  initialSubView?: 'browse' | 'myconfigs';
 }
 //#endregion
 //#region src/client/about/AboutPanel.d.ts