dsh-config-manager 0.1.76 → 0.1.78

package/lib/client.d.ts

@@ -185,6 +185,24 @@ interface ExportUnit {
    * 只下发**事实**，不下发文案 —— 界面按当前语言显示（与 DSH 同口径），绝不用 uuid 冒充标题。
    */
   blank?: boolean;
+  /**
+   * 该插件**声明的第三方数据区域**（只有 \`plugin:<包名>\` 单元可能有值；导出选择器「按插件看」用）。
+   *
+   * 用途：选择器要在**不读任何数据目录**的前提下画出「插件 → 数据目录 / 大文件」的树骨架 ——
+   * 区域清单来自来源注册表（内置来源表 + 插件自述 dsh.dataDirs），是静态知识，零额外 I/O；
+   * 体积与「实际有没有内容」等该分区的清单到货后再填。
+   *
+   * 语义：**纯展示**，不参与勾选/导出契约（契约只认 id）。这里是「注册表说它应该在哪儿」，
+   * **不是**「磁盘上确实有」—— 界面必须把两者分开渲染（unread / 无内容 / 已读到）。
+   */
+  relatedAreas?: readonly PluginAreaRef[];
+}
+/** 插件数据区域引用（pluginData / pluginAssets；只读展示用，不参与勾选契约）。 */
+interface PluginAreaRef {
+  section: 'pluginData' | 'pluginAssets';
+  /** home 相对 POSIX 路径 —— 就是该分区单元的 id 后缀（\`pluginData:.mnemon/runtime\` 的末段） */
+  relPath: string;
+  role: 'config' | 'assets';
 }
 type PlanItemKind = 'Create' | 'Update' | 'Skip' | 'Conflict' | 'Install' | 'MissingSecret' | 'MissingDependency' | 'PathMapping' | 'Warning' | 'Error';
 type ItemResolution = 'keepCurrent' | 'useImported' | 'review';
@@ -1954,10 +1972,10 @@ declare const uiZh: {
   readonly 'export.category.settings': 'DSH 全局设置（namespace 分区，redacted）';
   readonly 'export.category.providers': 'LLM Provider / Model / 默认模型 / BaseURL';
   readonly 'export.category.plugins': '已安装插件清单与启用状态（不含二进制）';
-  readonly 'export.category.pluginFiles': '其他插件放在 ~/.dsh 根下的零散配置文件（白名单 + plugin-config/ 目录，整文件复制）';
-  readonly 'export.category.self': '本插件自身配置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）';
-  readonly 'export.category.pluginData': '其他插件在系统主目录下的数据（如 ~/.dsh-wallpaper-engine、~/.mnemon 的配置与状态；可再生成缓存绝不收录）';
-  readonly 'export.category.pluginAssets': '其他插件的大体积文件（上传的壁纸、本地数据库等；默认不勾选）';
+  readonly 'export.category.pluginFiles': '插件放在 ~/.dsh 根下的配置文件（白名单 + plugin-config/ 目录，整文件复制）';
+  readonly 'export.category.self': '配置管理器自身的设置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）';
+  readonly 'export.category.pluginData': '插件在系统主目录下的数据（如 ~/.dsh-wallpaper-engine、~/.mnemon 的配置与状态；可再生成缓存绝不收录）';
+  readonly 'export.category.pluginAssets': '插件的大体积文件（上传的壁纸、本地数据库等；默认不勾选）';
   readonly 'export.category.mcp': 'MCP 服务器组合配置（需重启生效）';
   readonly 'export.category.prompts': 'System Prompt / Plan Mode 提示';
   readonly 'export.category.skills': '用户技能文件（~/.dsh/skills）';
@@ -4164,6 +4182,23 @@ interface RollbackPreviewFile {
   removed: number | null;
   /** true = 本次没有可信行数（added/removed 均为 null）。**宁可说「不知道」，也绝不谎报行数。** */
   truncated: boolean;
+  /**
+   * true = 该文件在留点**之后**是**别的会话**写的（写入归属台账证明；见 core/rollback-attribution.ts）。
+   * 界面据此默认不勾选它（用户仍可勾上）。缺字段 / false = **没有归属证据**，
+   * 而不是「本会话写的」——「未判定」与「确知是本会话」必须分开。
+   */
+  foreign?: boolean;
+  /** 那些「别的会话」的会话 id（仅当 foreign 为 true） */
+  foreignSessionId?: string;
+  /** 那次写入的时间（毫秒；仅当 foreign 为 true） */
+  foreignAt?: number;
+  /**
+   * true = 这次回退**不会改动它**（与其它对话的改动冲突 / 无法安全合并）。行级统计为 null ——
+   * 「不改动」不是「0 行变化」，界面必须分开说。
+   */
+  skipped?: boolean;
+  /** 不改动的机器原因（界面映射成字典键，绝不裸渲染） */
+  mergeReason?: string;
 }
 interface RollbackWorkspacePreview {
   /** 将被写回（覆盖）的条目数 */
@@ -4285,6 +4320,12 @@ interface RollbackFileDiffResult {
   identical: boolean;
   degraded: boolean;
   reason?: RollbackFileDiffReason;
+  /** true = 「回退后」一侧显示的是三方合并的结果（不是记录里的原文） */
+  merged?: boolean;
+  /** true = 这次回退不会改动它（冲突 / 无法安全合并）——此时两侧相同 */
+  mergeSkipped?: boolean;
+  /** 不改动的机器原因（界面映射成字典键） */
+  mergeReason?: string;
 }
 interface RollbackSegmentResult {
   state: string;
@@ -4310,6 +4351,22 @@ interface RollbackSegmentResult {
   createdRefusedReason?: string | null;
   /** 工作区段：实际写回的字节数（宿主回传才有） */
   writtenBytes?: number;
+  /** 因归属隔离（B）跳过的记录条目数：该文件在留点后被**别的会话**写过（宿主回传才有） */
+  foreignSkipped?: number;
+  /** 因路径选择（A）跳过的记录条目数（宿主回传才有） */
+  selectionSkipped?: number;
+  /** 三方合并成功、写回「撤销本会话 + 保留对方改动」的条目数（宿主回传才有） */
+  mergedCount?: number;
+  mergedPaths?: string[];
+  /** 冲突：两侧改到同一处 ⇒ 未写（宿主回传才有） */
+  conflictCount?: number;
+  conflictPaths?: string[];
+  /** 无法安全撤销 ⇒ 未写（宿主回传才有） */
+  unavailableCount?: number;
+  unavailablePaths?: string[];
+  /** 写入前发现又被改过（并发）⇒ 未写（宿主回传才有） */
+  concurrentCount?: number;
+  concurrentPaths?: string[];
   /** 兼容形态：宿主只回传计数时也算得出来 */
   createdAfter?: RollbackCount;
   createdAfterTruncated?: boolean;
@@ -4348,6 +4405,13 @@ interface RollbackRewindOptions {
   segments?: readonly RollbackState[];
   allowPartial?: boolean;
   preRewindGuard?: RollbackGuardPolicy;
+  /**
+   * 路径级选择性恢复（2026-10-17 定案 A）：只恢复这些路径。
+   *
+   * 缺省 = 全量口径（一字不变）。**空数组是无效输入**（宿主 400）—— 「一个都没勾」由界面拦住，
+   * 绝不让它变成「整次回退静默 noop」。
+   */
+  onlyPaths?: readonly string[];
 }
 /** 端口：由 src/client/recovery/recovery-api.ts 实现（Partial 消费，缺失时界面如实说能力缺失）。 */
 interface RollbackPointPort {
@@ -4689,20 +4753,20 @@ declare const zh$4: {
   readonly 'section.settings': '设置';
   readonly 'section.ui': 'UI 偏好';
   readonly 'section.providers': 'Provider 与模型';
-  readonly 'section.plugins': '插件';
+  readonly 'section.plugins': '插件清单';
   readonly 'section.mcp': 'MCP 服务器';
   readonly 'section.prompts': '提示词';
   readonly 'section.skills': '技能';
   readonly 'section.agentPresets': 'Agent 预设';
   readonly 'section.agentInstructions': '全局指令';
   readonly 'section.workspaces': '工作区';
-  readonly 'section.pluginFiles': '其他插件零散文件';
+  readonly 'section.pluginFiles': '插件散落配置';
   readonly 'section.credentialsStatus': '凭据状态';
   readonly 'section.secrets': '密钥';
   readonly 'section.sessions': '历史会话';
-  readonly 'section.self': '本插件自身配置';
-  readonly 'section.pluginData': '其他插件数据';
-  readonly 'section.pluginAssets': '其他插件大文件';
+  readonly 'section.self': '配置管理器设置';
+  readonly 'section.pluginData': '插件数据目录';
+  readonly 'section.pluginAssets': '插件大文件';
   readonly 'view.about': '关于';
   readonly 'about.snippet.environment': '### 环境 / Environment';
   readonly 'about.releaseNotes.rateLimited': 'GitHub API 速率限制（Rate limit exceeded），请稍后再试或直接在 GitHub 上查看。';
@@ -4842,6 +4906,26 @@ declare const zh$4: {
   readonly 'picker.sensitive': '敏感';
   readonly 'picker.showAll': '显示全部（共 {count} 条）';
   readonly 'picker.summaryImport': '将导入 {sections} 个分区 · {units} 个条目';
+  readonly 'picker.pluginRoot': '插件';
+  readonly 'picker.pluginLeafPlugin': '插件清单条目';
+  readonly 'picker.pluginLeafConfig': '数据目录（配置）';
+  readonly 'picker.pluginLeafAssets': '大文件（壁纸 / 数据库）';
+  readonly 'picker.pluginAreaUnread': '未读取';
+  readonly 'picker.pluginAreaAbsent': '无内容';
+  readonly 'picker.pluginViewEmpty': '插件清单还没读到，先读取「插件」分区。';
+  readonly 'picker.bucketPlugins': '插件分区的其他条目（补丁行 / pnpm-workspace.yaml）';
+  readonly 'picker.bucketLooseFiles': '未归属到插件的配置（~/.dsh 根）';
+  readonly 'picker.bucketHint': '这些条目没有可证明的插件归属，不猜；展开可逐条勾选。';
+  readonly 'picker.groupHint.extensions': '这一组里的插件分区合并成一棵按插件分组的树：默认只显示一个「插件」区块，展开它才列出各个插件，插件名下面是它的清单条目、数据目录与大文件。只显示能证明的归属（内置来源表 + 插件自述 dsh.dataDirs）——「插件散落配置」没有包名信息，因此留在「未归属」里；带「设备相关」的分区默认不勾选，跨设备导入时可能不适用。';
+  readonly 'group.general': '通用';
+  readonly 'group.ai': 'AI';
+  readonly 'group.extensions': '插件与扩展';
+  readonly 'group.mcp': 'MCP / 工具';
+  readonly 'group.customization': '定制';
+  readonly 'group.automation': '自动化';
+  readonly 'group.workspace': '工作区';
+  readonly 'group.ui': '界面';
+  readonly 'group.optional': '可选数据';
   readonly 'import.nothingSelected': '当前没有勾选任何要导入的内容，请把需要导入的分区或条目勾上。';
   readonly 'import.excludedByUser': '本次有 {count} 项被你取消勾选：未导入，也未进快照。';
   readonly 'import.consult.hint': '只读分析：先看结论与依据，确认后再选择要导入的内容。';
@@ -6529,6 +6613,14 @@ declare const zh$1: {
   readonly 'rollback.preview.notice.skipped': '{n} 项在留点时被跳过（未记录；已计入证明名单 ⇒ 不参与删除判据）';
   readonly 'rollback.preview.notice.truncated': '该点捕获被上限截断（超单文件上限 / 字节预算 / 文件数预算）；删除判据另看证明名单（路径索引）是否完整';
   readonly 'rollback.preview.files.title': '将被回退的文件：';
+  readonly 'rollback.preview.select.foreign': '其它对话改过';
+  readonly 'rollback.preview.select.toggle': '「{path}」：勾上则这次回退恢复它';
+  readonly 'rollback.result.foreignSkipped': '{n} 个文件在留点后被其它对话改过，这次没有回退它们';
+  readonly 'rollback.result.merged': '{n} 个文件已合并：撤销本次对话的改动，保留其它对话的改动';
+  readonly 'rollback.result.conflict': '{n} 个文件两侧改到同一处，已保持原样 —— 需要你手工处理';
+  readonly 'rollback.result.unavailable': '{n} 个文件无法安全撤销（缺少中间版本 / 二进制 / 差异过大），已保持原样';
+  readonly 'rollback.result.concurrent': '{n} 个文件在回退过程中又被改过，已保持原样';
+  readonly 'rollback.result.selectionSkipped': '{n} 个文件按你的勾选跳过了';
   readonly 'rollback.preview.files.empty': '工作区与该回退点一致，无需恢复';
   readonly 'rollback.preview.files.unavailable': '该回退点的工作区态没有可用的记录（原因：{reason}），无需恢复';
   readonly 'rollback.preview.files.unavailableSession': '该回退点的工作区态没有可用的记录（原因：{reason}）；会话仍会回退到该点之前';
@@ -6538,6 +6630,9 @@ declare const zh$1: {
   readonly 'rollback.preview.file.removed': '−{n}';
   /** 整文件删除（用户 2026-10-12 第 6 条）：写「删除」而不是 `+0 −N` —— 那是两件事。 */
   readonly 'rollback.preview.file.deleted': '删除';
+  readonly 'rollback.preview.file.skipped': '不会改动（与其它对话的改动冲突，或无法安全合并）';
+  readonly 'rollback.diff.merged': '下面是合并后的结果：撤销本对话的改动、保留其它对话的改动';
+  readonly 'rollback.diff.skipped': '这次回退不会改动它（与其它对话的改动冲突，或无法安全合并）';
   readonly 'rollback.preview.file.unknown': '行数未统计';
   readonly 'rollback.preview.file.unknownHint': '这些文件的行数没有统计出来（文件过大、不是文本或内容副本读不出来）—— 回退仍会照常覆盖它们。';
   readonly 'rollback.diff.viewHint': '查看差异：{path}';