dsh-config-manager 0.1.64 → 0.1.65

package/lib/client.d.ts

@@ -195,6 +195,15 @@ interface PathIssue {
   kind: 'missing' | 'platformMismatch' | 'homeMismatch';
   value: string;
   mappedTo?: string;
+  /**
+   * 这条路径来自哪个分区（目前只有 workspaces / mcp 会被探测出路径问题）。
+   *
+   * 为什么要有它：导入向导的路径映射页必须**只问这次真的会写盘的路径** ——
+   * 用户没勾「工作区」时不该被要求为工作区路径指定新位置（真机反馈：明明没选工作区，
+   * 却被列了 7 条工作区路径）。core 只负责如实标注来源，是否要问由调用方结合本次选择决定。
+   * 缺省 = 来源未知（旧宿主未回传该字段）→ 调用方按「保守显示」处理。
+   */
+  section?: SectionId;
 }
 interface SnapshotTarget {
   adapter: SectionId;
@@ -652,21 +661,61 @@ interface DshProfileDetail extends DshProfileMeta {
   /** cordis.patch.yml 原文（不可读或过大 = null） */
   patch: string | null;
 }
-/** 「下次启动」标记的解析结果。 */
-interface DshProfileSelection {
+/**
+ * 「用该档案启动」（独立实例）的结果。
+ *
+ * 为什么需要它：DSH 自身没有「默认 / 下次启动 profile」状态（profile 只由 `--profile` 决定），
+ * 所以「切换档案」唯一真正可用的形态是**另起一个实例**——本结构就是那条路径的回执。
+ */
+interface DshProfileLaunchResult {
+  /** 被启动的档案名 */
   name: string;
-  /** 目标 profile 是否仍然存在（被删除后 = false，UI 应提示重新选择） */
-  exists: boolean;
-  /** 目标是否就是当前运行中的 profile（= 无需重启） */
-  isCurrent: boolean;
+  /** 目前只支持 web 形态（有浏览器 GUI） */
+  mode: 'web';
+  /** 新实例监听的端口（自动挑的空闲端口） */
+  port: number;
+  /** 带进程 token 的认证 URL（从子进程启动日志里抓；没抓到 = null，绝不臆造裸 URL） */
+  url: string | null;
+  /** 子进程 pid（拿不到 = null） */
+  pid: number | null;
+  /** 子进程日志文件绝对路径（未就绪时用户据此自查） */
+  logFile: string;
+  /** HTTP 探活是否已就绪 */
+  ready: boolean;
+  /** 非致命告警（UI 按码映射文案） */
+  warnings: DshProfileLaunchWarning[];
 }
-/** GET /profiles 的响应负载（列表 + 当前运行 + 下次启动 + 模板清单）。 */
+/**
+ * 「运行中实例」的**合并视图**（UI 唯一消费形状）：台账（本插件启动的） ∪ 心跳（任何在跑的实例）。
+ *
+ * 为什么必须合并：只认台账时，手动 `dsh web` 起来的实例对插件不可见 → 会在别的档案里被**再次启动**
+ * （用户实测：从 web 启动 cmtest 后，在 cmtest 里还能再启动 web，同名多开）。心跳让每个实例互相可见。
+ */
+interface DshProfileRunningView {
+  name: string;
+  /** 实例 pid（停止用；缺心跳 pid 时为 null） */
+  pid: number | null;
+  /** web 端口（心跳/台账里记的；未知 = null） */
+  port: number | null;
+  /** 带 token 的认证 URL（**只有本插件启动的**才有：别人的 token 绝不落盘/回传） */
+  url: string | null;
+  startedAt: string;
+  /** 本插件启动的（台账里有它）→ 本 UI 负责停止 */
+  owned: boolean;
+  /** 就是当前正在跑本界面的这个实例（自己不能停自己） */
+  current: boolean;
+}
+/** 停止实例的结果码（gracious = 自己退了 / killed = 强杀 / already-stopped = 早就不在了）。 */
+type DshProfileStopOutcome = 'graceful' | 'killed' | 'already-stopped';
+/** 启动回执里的非致命告警码。 */
+type DshProfileLaunchWarning = 'notReady' | 'urlNotFound';
+/** GET /profiles 的响应负载（列表 + 当前运行 + 运行中实例 + 模板清单）。 */
 interface DshProfilesSnapshot {
   profiles: DshProfileMeta[];
   /** 当前运行中的 profile 名（宿主从 config/argv 解析） */
   current: string;
-  /** 「下次启动」标记（无 = null） */
-  selection: DshProfileSelection | null;
+  /** 在跑的实例（台账 ∪ 心跳；空数组 = 没有。UI 据此把「启动」换成「停止」/「当前运行」） */
+  running: DshProfileRunningView[];
   /** 可选的起步模板（新建档案时用） */
   templates: DshProfileTemplate[];
 }
@@ -677,6 +726,27 @@ interface DshProfileTemplate {
   bundles: string[];
   patchReload: DshProfilePatchReload;
 }
+/** 复制档案的非致命告警码（UI 按码映射文案，绝不静默）。 */
+type DshProfileCopyWarning =
+/** 副本没有 node_modules 却声明了依赖：直接启动会解析不到 bundle，必须先装依赖 */
+'depsNotInstalled';
+/**
+ * 「复制档案」的回执（UI 横幅用）：副本名 + 是否带 node_modules + 耗时 + 告警。
+ *
+ * 为什么把 warnings 一路带回前端：includeNodeModules=false 出来的副本**不能直接启动**
+ * （bundles 里的树外插件解析不到），这条必须显式告诉用户并给出安装命令 —— 静默成功等于骗人。
+ */
+interface DshProfileCopyResult {
+  /** 副本档案名 */
+  name: string;
+  /** 源档案名 */
+  sourceName: string;
+  /** 是否一并复制了 node_modules */
+  includeNodeModules: boolean;
+  /** 宿主侧实际耗时（毫秒；大档案含 node_modules 时可达数十秒） */
+  durationMs: number;
+  warnings: DshProfileCopyWarning[];
+}
 //#endregion
 //#region src/core/run-registry.d.ts
 /** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份 / 快照恢复 / 配置档案切换 / recovery 恢复。 */
@@ -991,7 +1061,6 @@ declare const uiZh: {
   readonly 'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态';
   readonly 'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试';
   readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态';
-  readonly 'error.lifecycleTimeout': '灾备请求超时（{minutes} 分钟）：撤销/重做未完成，请重试；若反复超时请检查 DSH 状态';
   readonly 'error.settingsConflict.title': '配置已被并发修改';
   readonly 'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。';
   readonly 'error.notConfirmed.title': '导入未确认';
@@ -1499,20 +1568,46 @@ declare class ConfigManagerApi {
   setSnapshotPinned(snapshotId: string, pinned: boolean): Promise<{
     pinned: boolean;
   }>;
-  /** 列出 DSH profile：列表 + 当前运行 + 「下次启动」标记 + 起步模板。 */
+  /** 列出 DSH profile：列表 + 当前运行 + 在跑的实例（台账 ∪ 心跳）+ 起步模板。 */
   profilesList(): Promise<DshProfilesSnapshot>;
   /** 单个档案详情（package.json / cordis.patch.yml 原文；大文件原文截断为 null）。 */
   profileDetail(name: string): Promise<DshProfileDetail>;
   /** 新建档案（在 $DSH_HOME/profiles/<name> 写标准 profile 三件套；template = base/web/headless/sdk/…）。 */
   profileCreate(name: string, template: string): Promise<DshProfileMeta>;
+  /**
+   * 复制档案：整份拷贝成新档案（package.json 的 name 跟随改写）。
+   * includeNodeModules 缺省 true —— 副本立刻可用，但 285 MB 级档案实测要三十秒上下（走长操作档位）；
+   * 传 false 只拷清单与 patch（秒级），回执 copy.warnings 会带 depsNotInstalled，调用方必须如实展示。
+   */
+  profileCopy(name: string, newName: string, opts?: {
+    includeNodeModules?: boolean;
+  }): Promise<{
+    profile: DshProfileMeta;
+    copy: DshProfileCopyResult;
+  }>;
   /** 重命名档案（目录级移动；当前运行中的档案被 host 拒绝）。 */
   profileRename(name: string, newName: string): Promise<DshProfileMeta>;
   /** 物理删除档案目录（不可恢复；当前运行中的档案需显式 allowCurrent=true）。 */
   profileDelete(name: string, opts?: {
     allowCurrent?: boolean;
   }): Promise<void>;
-  /** 记录「下次启动」用哪个档案（name=null 清除标记）。DSH 不支持运行中切换，重启由用户完成。 */
-  profileSelect(name: string | null): Promise<DshProfileSelection | null>;
+  /**
+   * 停掉该档案的实例：本插件启动的走台账，**别处/手动启动的**走心跳（同样按 pid 停）。
+   * 返回停止后的运行中实例列表 —— UI 据此把该行按钮换回「启动」。
+   */
+  profileStop(name: string): Promise<{
+    result: DshProfileStopOutcome;
+    running: DshProfileRunningView[];
+  }>;
+  /**
+   * 用该档案启动一个**独立 DSH 实例**（"切换档案"真正可用的形态；DSH 没有默认 profile 状态）。
+   * 只支持 web 形态档案；host 要等子进程起来（最长 20s 探活）→ 长操作档位。
+   * 同时返回启动后的 running 列表：UI 立刻把该行按钮换成「停止」，不必再 GET 一次。
+   */
+  profileLaunch(name: string): Promise<{
+    launch: DshProfileLaunchResult;
+    running: DshProfileRunningView[];
+  }>;
   /** 读取定时备份配置（enabled / interval / 上次运行状态；无敏感字段）。 */
   backupSchedule(): Promise<BackupScheduleStatus>;
   /** 保存定时备份设置（enabled + interval）；Host 校验后原子写 + 重排调度器。 */
@@ -2588,50 +2683,7 @@ declare class HistoryApi {
   private buildExportUrl;
 }
 //#endregion
-//#region src/client/lifecycle/lifecycle-api.d.ts
-/** 配置快照种类（与 core/undo.ts 的 ConfigSnapshotKind 同构）。 */
-type LifecycleSnapshotKind = 'manual' | 'auto' | 'undo' | 'pre-restore' | 'baseline';
-/** 单个配置状态快照的元信息（列表展示用；不含分区数据）。 */
-interface LifecycleSnapshotMeta {
-  id: string;
-  createdAt: string;
-  kind: LifecycleSnapshotKind;
-  reason: string;
-  trigger: string | null;
-  sections: string[];
-  totalBytes: number;
-  note: string | null;
-  tags: string[];
-  pinned: boolean;
-}
-/** GET /lifecycle/status 响应。 */
-interface LifecycleStatus {
-  canUndo: boolean;
-  canRedo: boolean;
-  total: number;
-  lastAutoAt: string | null;
-  watching: boolean;
-  snapshots: LifecycleSnapshotMeta[];
-}
-/** 撤销/重做的结果。失败时 `reason` 是稳定的枚举码（如 'already-at-state'），供 UI 分流文案。 */
-interface LifecycleOutcome {
-  ok: boolean;
-  targetId: string | null;
-  reason: string | null;
-  report: {
-    applied?: string[];
-    skipped?: string[];
-    failed?: {
-      item: string;
-      reason: string;
-    }[];
-    invalidSections?: {
-      section: string;
-      reason: string;
-    }[];
-    needsRestart?: boolean;
-  } | null;
-}
+//#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 同构）。 */
@@ -2642,13 +2694,16 @@ interface CrashReport {
   crashReason: CrashKind | null;
   lastGoodAt: string | null;
   advice: CrashAdvice;
-  lastGoodSnapshotId: string | null;
 }
-/** GET /rescue 响应。`stale` 为家目录指纹不匹配（换机/重建 home）后的自动降级标记。 */
+/**
+ * GET /rescue 响应。stale 为家目录指纹不匹配（换机 / 重建 home）后的自动降级标记；
+ * applied = 救援已在当前进程生效（本进程启动于进入救援之后，即用户已经重启过）。
+ */
 interface RescueStatus {
   active: boolean;
   stale: boolean;
   enteredAt: string | null;
+  applied: boolean;
 }
 /** POST /rescue 响应。 */
 interface RescueActionResult {
@@ -2660,47 +2715,20 @@ interface RescueActionResult {
   code?: string;
   message?: string;
 }
-/** 新建快照的请求参数（全部可选）。 */
-interface SnapshotRequest {
-  reason?: string;
-  note?: string;
-  tags?: string[];
-}
-/** 灾备浏览器半数据入口。 */
-declare class LifecycleApi {
+/** 事故恢复（崩溃归因 + 救援模式）浏览器半数据入口。 */
+declare class IncidentApi {
   readonly t: UiT;
   constructor(t?: UiT);
-  /** GET /lifecycle/status：撤销/重做可用性 + 快照列表 + 自动快照状态。 */
-  status(): Promise<LifecycleStatus>;
-  /** POST /lifecycle/snapshot：立即保存一份手动快照。 */
-  snapshot(req?: SnapshotRequest): Promise<{
-    ok: boolean;
-    id: string;
-    kind: string;
-    totalBytes: number;
-  }>;
-  /**
-   * POST /lifecycle/undo：回退到内容不同的最近快照。
-   * 引擎会在撤销前自动落一份「撤销前存档」，因此该动作可重做。
-   */
-  undo(): Promise<LifecycleOutcome>;
-  /** POST /lifecycle/redo：重做上一次撤销（仅当撤销后没有新变更时可成功）。 */
-  redo(): Promise<LifecycleOutcome>;
-  /** POST /lifecycle/remove：删除单个配置状态快照。 */
-  remove(id: string): Promise<{
-    ok: boolean;
-    removed: boolean;
-  }>;
-  /** GET /crash：上次启动是否异常 + 归因 + 建议动作 + 最后正常快照 id。 */
+  /** GET /crash：上次启动是否异常 + 归因 + 建议动作 + 最后正常时刻。 */
   crash(): Promise<CrashReport>;
   /** GET /rescue：救援模式状态。 */
   rescueStatus(): Promise<RescueStatus>;
   /**
-   * POST /rescue {action:'on', confirm:true}：进入救援模式。
+   * POST /rescue {action:on, confirm:true}：进入救援模式。
    * confirm 必须由调用方在显式确认弹窗后传入 —— 本层绝不代填。
    */
   rescueOn(): Promise<RescueActionResult>;
-  /** POST /rescue {action:'off'}：退出救援模式（从备份还原）。 */
+  /** POST /rescue {action:off}：退出救援模式（从备份完整还原）。 */
   rescueOff(): Promise<RescueActionResult>;
 }
 //#endregion
@@ -2724,8 +2752,8 @@ interface ConfigManagerSectionInjected {
   recoveryT: import('@deepseek-ai/dsh-client-ui-slots').TranslateNS<'config-manager-recovery'>;
   /** Migration History API（Phase 6：统一审计史；主 section 注册时注入） */
   historyApi: HistoryApi;
-  /** Phase 1 灾备 API（自动快照 / 撤销 / 重做 / 救援模式 / 崩溃归因；主 section 注册时注入） */
-  lifecycleApi: LifecycleApi;
+  /** 事故恢复 API（崩溃归因 + 救援模式；主 section 注册时注入，RecoveryPanel 消费） */
+  incidentApi: IncidentApi;
   /** Migration History locale（config-manager-history 命名空间，主 section 注册时注入） */
   historyT: import('@deepseek-ai/dsh-client-ui-slots').TranslateNS<'config-manager-history'>;
 }
@@ -3047,6 +3075,9 @@ declare const zh$3: {
   readonly 'backupSchedule.interval.7d': '每 7 天';
   readonly 'backupSchedule.interval.custom': '自定义（每周固定时刻）';
   readonly 'backupSchedule.customHint': '每周在选定星期与时刻各执行一次全量备份（错过的时间点不补跑）';
+  readonly 'backupSchedule.weekday': '星期';
+  readonly 'backupSchedule.hour': '小时';
+  readonly 'backupSchedule.minute': '分钟';
   readonly 'backupSchedule.weekday.sunday': '周日';
   readonly 'backupSchedule.weekday.monday': '周一';
   readonly 'backupSchedule.weekday.tuesday': '周二';
@@ -3130,6 +3161,8 @@ declare const zh$3: {
   readonly 'about.repo': 'GitHub 仓库';
   readonly 'about.docs': '使用文档';
   readonly 'about.issues': '反馈问题';
+  readonly 'about.feedbackHint': '遇到界面问题？复制环境信息，粘进 issue 就行';
+  readonly 'about.copyEnv': '复制环境信息（插件版本 / DSH 版本 / 平台）';
   readonly 'about.authorLabel': '作者';
   readonly 'about.loading': '正在获取版本信息…';
   readonly 'about.retryStatus': '重新获取';
@@ -3162,17 +3195,40 @@ declare const zh$3: {
   readonly 'profiles.empty': '还没有任何档案。用「新建档案」创建第一个。';
   readonly 'profiles.refresh': '刷新';
   readonly 'profiles.current': '当前运行';
-  readonly 'profiles.nextLaunch': '下次启动';
-  readonly 'profiles.select': '设为下次启动';
-  readonly 'profiles.selectClear': '取消下次启动设置';
-  readonly 'profiles.selectDone': '已把「{name}」设为下次启动档案';
-  readonly 'profiles.selectCleared': '已取消下次启动档案设置';
-  readonly 'profiles.selectHint': 'DSH 无法在运行中切换档案：这里只记录下次启动用哪个，重启由你手动完成。';
-  readonly 'profiles.selectPending': '下次启动将使用「{name}」。重启命令：';
-  readonly 'profiles.selectCurrent': '「{name}」就是当前运行的档案，无需重启。';
-  readonly 'profiles.selectMissing': '下次启动设置指向的「{name}」已不存在，请重新选择。';
+  readonly 'profiles.running.title': '运行状态';
+  readonly 'profiles.running.none': '当前没有任何档案实例在跑。点档案行的「启动」会用该档案另起一个独立实例（自动挑空闲端口 + 自动打开浏览器）；已经在跑的档案（含手动启动的）不会再被启动。';
+  readonly 'profiles.running.port': '端口 {port}';
+  readonly 'profiles.running.open': '打开';
+  readonly 'profiles.running.badge': ':{port} 运行中';
+  readonly 'profiles.running.originCurrent': '当前实例';
+  readonly 'profiles.running.originOwned': '本插件启动';
+  readonly 'profiles.running.originExternal': '其他实例';
+  readonly 'profiles.running.badgePlain': '运行中';
+  readonly 'profiles.stop': '停止';
+  readonly 'profiles.stopping': '停止中…';
+  readonly 'profiles.stop.hint': '停止本插件启动的这个实例（先请它自己退出，优雅期超时才强制终止进程树）';
+  readonly 'profiles.stop.hintExternal': '该档案的实例由另一个 DSH 实例（或手动启动）运行——停止会结束那个进程';
+  readonly 'profiles.stop.currentHint': '这就是你正在用的这个实例：不能在它自己的界面里停自己，请关闭该窗口/终端（或到启动它的那个实例里停止）';
+  readonly 'profiles.stopMessageExternal': '确认停止档案「{name}」的实例（端口 {port}）？它由另一个 DSH 实例（或手动启动）运行，停止会关闭那个实例。';
+  readonly 'profiles.stopTitle': '停止实例';
+  readonly 'profiles.stopMessage': '确认停止档案「{name}」的实例（端口 {port}）？该实例里正在进行的会话会被中断。';
+  readonly 'profiles.stop.done': '已停止档案「{name}」的实例';
+  readonly 'profiles.stop.forced': '已停止档案「{name}」的实例（进程未在优雅期内退出，已结束其进程树）';
+  readonly 'profiles.stop.gone': '档案「{name}」的实例早已不在（残留记录已清理）';
   readonly 'profiles.copy': '复制命令';
   readonly 'profiles.copied': '已复制重启命令';
+  readonly 'profiles.launch': '启动';
+  readonly 'profiles.launching': '启动中…';
+  readonly 'profiles.launch.hint': '用该档案另起一个独立 DSH 实例（自动挑空闲端口、自动打开浏览器）；当前实例不受影响。只支持 Web 形态档案。';
+  readonly 'profiles.launch.notWeb': '「{name}」不是 Web 形态（bundles 里没有 @deepseek-ai/dsh-web-app），没有浏览器界面，无法作为独立实例启动。请在终端运行：';
+  readonly 'profiles.launch.started': '已启动档案「{name}」的独立实例（端口 {port}）';
+  readonly 'profiles.launch.pending': '档案「{name}」的进程已启动（端口 {port}），但 {seconds} 秒内未确认就绪 —— 请看日志确认：';
+  readonly 'profiles.launch.open': '打开新实例';
+  readonly 'profiles.launch.copyUrl': '复制 URL';
+  readonly 'profiles.launch.copiedUrl': '已复制认证 URL';
+  readonly 'profiles.launch.warn.notReady': '未能确认 Web 服务已就绪（可能仍在启动，或启动失败）';
+  readonly 'profiles.launch.warn.urlNotFound': '没能从启动日志里抓到带 token 的认证 URL — 请从日志里复制 URL 打开';
+  readonly 'profiles.launch.log': '日志';
   readonly 'profiles.create.title': '新建档案';
   readonly 'profiles.create.hint': '在 $DSH_HOME/profiles/<name> 下创建标准 profile（package.json + cordis.patch.yml + pnpm-workspace.yaml）；第三方插件需要在该档案里单独安装。';
   readonly 'profiles.create.nameLabel': '档案名';
@@ -3223,12 +3279,31 @@ declare const zh$3: {
   readonly 'profiles.delete.done': '已删除档案「{name}」';
   readonly 'profiles.deleteCurrentWarning': '这是当前运行中的档案：删除后本次运行仍可用，但重启会失败。';
   readonly 'profiles.deleteCurrentConfirm': '仍要删除当前档案';
+  readonly 'profiles.duplicate': '复制';
+  readonly 'profiles.duplicateHint': '把该档案整份复制成一份新档案（清单 / patch 层 / 依赖声明 / pnpm 锁文件；可连同已装的 node_modules 一起拷）';
+  readonly 'profiles.duplicateTitle': '复制档案';
+  readonly 'profiles.duplicateMessage': '把档案「{name}」复制成一份新档案：';
+  readonly 'profiles.duplicate.nameLabel': '副本档案名';
+  readonly 'profiles.duplicate.includeModules': '同时复制 node_modules（副本立刻可用）';
+  readonly 'profiles.duplicate.includeModulesHint': '带上 node_modules，副本启动时才能解析到树外插件；代价是与原档案同体积、耗时较长（实测 285 MB ≈ 30 秒）。不勾选只复制清单与 patch（秒级完成），副本启动前需要先装依赖。';
+  readonly 'profiles.duplicate.onlyManifest': '该档案还没有 node_modules：只会复制清单文件与 patch 层。';
+  readonly 'profiles.duplicate.done': '已复制为档案「{name}」';
+  readonly 'profiles.duplicate.warn.depsNotInstalled': '副本没有带 node_modules：直接启动会因解析不到 bundle 而失败，先在副本目录安装依赖：';
+  readonly 'profiles.duplicate.copiedInstall': '已复制安装命令';
+  readonly 'profiles.error.copyFailed': '复制档案失败';
   readonly 'profiles.error.exists': '同名档案已存在';
   readonly 'profiles.error.notFound': '档案不存在（可能已被删除）';
   readonly 'profiles.error.currentProfile': '该操作不能作用于当前运行中的档案';
   readonly 'profiles.error.invalidName': '档案名不合法';
   readonly 'profiles.error.reservedName': 'DSH 保留名不能手动创建';
   readonly 'profiles.error.unknownTemplate': '未知的起步模板';
+  readonly 'profiles.error.notLaunchable': '该档案不是 Web 形态，没有浏览器界面（请用终端运行 dsh --profile <名>）';
+  readonly 'profiles.error.launcherUnavailable': '定位不到 dsh 启动器（非标准启动方式），请手动运行 dsh --profile <名>';
+  readonly 'profiles.error.launchFailed': '档案实例启动失败';
+  readonly 'profiles.error.alreadyRunning': '该档案的实例已经在运行（先停止再启动）';
+  readonly 'profiles.error.notRunning': '该档案没有正在运行的实例（可能已被手动关闭）';
+  readonly 'profiles.error.stopFailed': '停止实例失败';
+  readonly 'profiles.error.instanceRunning': '该档案的实例正在运行，请先停止再删除';
   readonly 'profiles.error.generic': '操作失败：{message}';
   readonly 'import.compatibility.sections': '{count} 个分区';
   readonly 'import.compatibility.plugins': '已装 {installed} · 待装 {toInstall}';
@@ -3246,58 +3321,6 @@ declare const zh$3: {
   readonly 'nav.sync': '同步';
   readonly 'nav.market': '市场';
   readonly 'nav.profiles': '档案';
-  readonly 'nav.recovery': '灾备';
-  readonly 'lifecycle.autoOn': '自动快照已开启';
-  readonly 'lifecycle.autoOff': '自动快照未开启';
-  readonly 'lifecycle.lastAuto': '最近自动快照';
-  readonly 'lifecycle.never': '从未';
-  readonly 'lifecycle.undo': '撤销';
-  readonly 'lifecycle.redo': '重做';
-  readonly 'lifecycle.undoTitle': '撤销上一步配置变更（回退到内容不同的最近快照）';
-  readonly 'lifecycle.redoTitle': '重做上一次撤销（仅在撤销后没有新变更时可用）';
-  readonly 'lifecycle.undoConfirm': '撤销会回滚配置到上一个不同状态。撤销前会自动保存当前状态，可随时重做。是否继续？';
-  readonly 'lifecycle.undoOk': '已撤销到 {id}';
-  readonly 'lifecycle.redoOk': '已重做到 {id}';
-  readonly 'lifecycle.undoNone': '没有可撤销的变化';
-  readonly 'lifecycle.redoNone': '没有可重做的撤销';
-  readonly 'lifecycle.snapshotNow': '立即快照';
-  readonly 'lifecycle.snapshotReason': '快照原因（可选）';
-  readonly 'lifecycle.snapshotCreated': '已创建快照 {id}';
-  readonly 'lifecycle.snapshots': '配置状态快照';
-  readonly 'lifecycle.empty': '还没有配置状态快照。开启自动快照后，配置变更会自动存档。';
-  readonly 'lifecycle.kind.auto': '自动';
-  readonly 'lifecycle.kind.manual': '手动';
-  readonly 'lifecycle.kind.undo': '撤销';
-  readonly 'lifecycle.kind.baseline': '基线';
-  readonly 'lifecycle.kind.pre-restore': '撤销前存档';
-  readonly 'lifecycle.sections': '{count} 个分区';
-  readonly 'lifecycle.delete': '删除';
-  readonly 'lifecycle.deleteConfirm': '删除快照 {id}？该快照将无法再用于回退。';
-  readonly 'lifecycle.crash.title': '上次启动未正常完成';
-  readonly 'lifecycle.crash.lastGood': '最后正常状态：{time}';
-  readonly 'lifecycle.crash.restoreLastGood': '回退到最后正常状态';
-  readonly 'lifecycle.crash.reason.session-corrupt': '会话文件损坏';
-  readonly 'lifecycle.crash.reason.bundle-check': '插件 bundle 无法解析';
-  readonly 'lifecycle.crash.reason.patch-tree': '插件加载失败（挂载树冲突）';
-  readonly 'lifecycle.crash.reason.unknown': '原因未知';
-  readonly 'lifecycle.crash.advice.restore-last-good': '建议回退到最后正常状态。';
-  readonly 'lifecycle.crash.advice.repair-session': '建议先用会话扫描修复损坏的会话文件。';
-  readonly 'lifecycle.crash.advice.check-bundles': '建议进入救援模式，或检查 package.json 的 dsh.profile.bundles。';
-  readonly 'lifecycle.crash.advice.check-patch-tree': '建议进入救援模式禁用插件后逐个排查。';
-  readonly 'lifecycle.rescue.title': '救援模式';
-  readonly 'lifecycle.rescue.desc': 'DSH 因插件起不来时，把插件挂载收窄到「DSH 核心 + 本插件」：改写两层 cordis.patch.yml，并把 dsh.profile.bundles 里的其它用户插件临时移出。不卸载任何包，退出时从备份完整还原。';
-  readonly 'lifecycle.rescue.active': '救援模式已开启（{time}）—— 请重启 DSH 使其生效。';
-  readonly 'lifecycle.rescue.enter': '进入救援模式';
-  readonly 'lifecycle.rescue.exit': '退出救援模式';
-  readonly 'lifecycle.rescue.restartHint': '操作后需要重启 DSH 才能生效。';
-  readonly 'lifecycle.rescue.confirm': '进入救援模式会改写 profile 的 cordis.patch.yml、置空 home 的 cordis.patch.yml，并把 dsh.profile.bundles 收窄为 DSH 核心与本插件（其它用户插件本次启动不挂载；包本身不删除）。退出时会从备份逐字节还原。请重启 DSH 使其生效。是否继续？';
-  readonly 'lifecycle.rescue.on': '已进入救援模式';
-  readonly 'lifecycle.rescue.off': '已退出救援模式';
-  readonly 'lifecycle.rescue.inactive': '救援模式未开启';
-  readonly 'lifecycle.rescue.stale': '救援标记已失效（换机或重建 home）';
-  readonly 'lifecycle.guided.title': '需要更完整的恢复流程？';
-  readonly 'lifecycle.guided.desc': '本页是一键回退（撤销/重做）。若 DSH 因中断的事务或崩溃而无法正常恢复，请用「备份」页的恢复向导逐步确认后执行 —— 它会先预览影响、再校验结果。';
-  readonly 'lifecycle.guided.action': '打开恢复向导';
   readonly 'nav.refresh': '刷新';
   readonly 'shell.status.idle': '就绪';
   readonly 'shell.status.running': '{count} 个任务进行中';
@@ -3927,6 +3950,33 @@ declare const zh: {
   readonly 'recovery.lock.refused': '未判定为残留锁，已拒绝回收（未做任何改动）';
   readonly 'recovery.lock.confirmTitle': '回收残留配置锁';
   readonly 'recovery.lock.confirmMessage': '将再次确认该锁的持有进程确已不存在，然后原子移除这把锁。若无法确认（例如锁仍被活跃进程持有），操作会被拒绝且不做任何改动。';
+  readonly 'recovery.crash.title': '上次启动未正常完成';
+  readonly 'recovery.crash.lastGood': '最后正常状态：{time}';
+  readonly 'recovery.crash.guidance': '处置建议：进入救援模式让 DSH 先起来，随后到「备份文件」用最近一次备份恢复。';
+  readonly 'recovery.crash.reason.session-corrupt': '会话文件损坏';
+  readonly 'recovery.crash.reason.bundle-check': '插件 bundle 无法解析';
+  readonly 'recovery.crash.reason.patch-tree': '插件加载失败（挂载树冲突）';
+  readonly 'recovery.crash.reason.unknown': '原因未知';
+  readonly 'recovery.crash.advice.none': '本模块没有额外建议动作。';
+  readonly 'recovery.crash.advice.restore-last-good': '建议回到最后正常状态（灾备快照已下线，改用最近一次备份恢复）。';
+  readonly 'recovery.crash.advice.repair-session': '建议先用会话扫描修复损坏的会话文件。';
+  readonly 'recovery.crash.advice.check-bundles': '建议进入救援模式，或检查 package.json 的 dsh.profile.bundles。';
+  readonly 'recovery.crash.advice.check-patch-tree': '建议进入救援模式禁用插件后逐个排查。';
+  readonly 'recovery.rescue.title': '救援模式';
+  readonly 'recovery.rescue.desc': 'DSH 因插件起不来时，把插件挂载收窄到「DSH 核心 + 本插件」：改写两层 cordis.patch.yml，并把 dsh.profile.bundles 里的其它用户插件临时移出。不卸载任何包，退出时从备份完整还原。';
+  readonly 'recovery.rescue.inactive': '救援模式未开启';
+  readonly 'recovery.rescue.activeBadge': '已开启';
+  readonly 'recovery.rescue.active': '救援模式已开启（{time}）—— 请重启 DSH 使其生效。';
+  readonly 'recovery.rescue.applied': '救援模式已开启（{time}）—— 本次启动只挂载了 DSH 核心与本插件。';
+  readonly 'recovery.rescue.appliedHint': '其它用户插件本次未加载；退出救援模式后同样需要重启 DSH 才会恢复。';
+  readonly 'recovery.rescue.restartHint': '操作后需要重启 DSH 才能生效。';
+  readonly 'recovery.rescue.enter': '进入救援模式';
+  readonly 'recovery.rescue.exit': '退出救援模式';
+  readonly 'recovery.rescue.confirmTitle': '进入救援模式';
+  readonly 'recovery.rescue.confirm': '进入救援模式会改写 profile 的 cordis.patch.yml、置空 home 的 cordis.patch.yml，并把 dsh.profile.bundles 收窄为 DSH 核心与本插件（其它用户插件本次启动不挂载；包本身不删除）。退出时会从备份逐字节还原。请重启 DSH 使其生效。是否继续？';
+  readonly 'recovery.rescue.on': '已进入救援模式';
+  readonly 'recovery.rescue.off': '已退出救援模式';
+  readonly 'recovery.rescue.stale': '救援标记已失效（换机或重建 home）';
 };
 /** 字典键联合（注册处 compile-time 校验）。 */
 type RecoveryKey = keyof typeof zh;