dsh-config-manager 0.1.0

package/lib/client.d.ts

@@ -0,0 +1,377 @@
+window.__ModuleLoader__.load({
+	id: "dsh-config-manager",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+
+import { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
+import { PropsRuntime, TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+
+//#region src/schema/types.d.ts
+/**
+ * 核心领域类型（Export Schema v1 的纯类型定义）。
+ *
+ * 对齐 Docs/design/architecture.md §13.1 —— m3/m5 的共同契约。
+ * 本文件只含与 DSH 运行时无关的纯数据形状；DSH Service 门面类型见 src/core/types.ts。
+ */
+/** 运行平台（等价 NodeJS.Platform，但保持类型自包含，可在浏览器侧引用） */
+type Platform = 'win32' | 'darwin' | 'linux' | 'freebsd' | 'openbsd' | 'aix' | 'sunos' | 'android' | 'cygwin' | 'haiku' | 'netbsd' | 'other';
+/**
+ * 分区标识，与 ZIP 目录结构、manifest.sections 键一一对应。
+ * 明确不实现的分区（keybindings/workflows/commands/rules）不在此列。
+ */
+type SectionId = 'settings' | 'ui' | 'providers' | 'plugins' | 'mcp' | 'prompts' | 'skills' | 'agentPresets' | 'workspaces' | 'pluginFiles' | 'credentialsStatus' | 'secrets' | 'sessions';
+/** 加密备份的算法参数（非秘密：salt/iv/authTag 仅用于解密与完整性校验） */
+interface EncryptionInfo {
+  algorithm: 'aes-256-gcm';
+  kdf: 'scrypt';
+  kdfParams: {
+    N: number;
+    r: number;
+    p: number;
+    keyLength: number;
+  };
+  salt: string;
+  iv: string;
+  authTag: string;
+  version: number;
+}
+/** 每个导出 ZIP 根部的 manifest.json */
+interface Manifest {
+  schemaVersion: number;
+  exporter: {
+    name: string;
+    version: string;
+  };
+  source: {
+    dshVersion: string;
+    platform: Platform;
+    arch: string;
+  };
+  exportedAt: string;
+  sections: Record<SectionId, boolean>;
+  security: {
+    containsSecrets: boolean;
+    encrypted: boolean;
+    encryption: EncryptionInfo | null;
+  };
+}
+//#endregion
+//#region src/core/types.d.ts
+interface ExportOptions {
+  /** 是否包含真实秘密（必须配合 encryption 提供者；缺省 false = 只导状态） */
+  includeSecrets: boolean;
+  /** 仅导出指定分区（缺省 = 全部默认包含分区） */
+  only?: SectionId[];
+  /** 导出文件路径（缺省自动生成 dsh-config-<date>.zip） */
+  outPath?: string;
+}
+type PlanItemKind = 'Create' | 'Update' | 'Skip' | 'Conflict' | 'Install' | 'MissingSecret' | 'MissingDependency' | 'PathMapping' | 'Warning' | 'Error';
+type ItemResolution = 'keepCurrent' | 'useImported' | 'review';
+type GlobalConflictStrategy = 'merge' | 'replace' | 'skipExisting';
+interface ConflictDecision {
+  itemId: string;
+  resolution: ItemResolution;
+}
+interface PathMapping {
+  oldPrefix: string;
+  newPrefix: string;
+  appliesTo: ('workspaces' | 'mcp' | 'pluginConfig' | 'skills')[];
+}
+interface PathIssue {
+  kind: 'missing' | 'platformMismatch' | 'homeMismatch';
+  value: string;
+  mappedTo?: string;
+}
+interface SnapshotTarget {
+  adapter: SectionId;
+  ref: string;
+}
+interface PlanItem {
+  id: string;
+  kind: PlanItemKind;
+  adapter: SectionId;
+  description: string;
+  detail?: string;
+  severity: 'info' | 'warning' | 'error';
+  conflict?: ConflictDecision;
+  pathMapping?: PathMapping;
+  missingDependency?: string;
+  target?: SnapshotTarget;
+}
+interface ImportAnalysis {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+  compatibility: 'excellent' | 'good' | 'partial' | 'unsupported';
+  sectionsInZip: SectionId[];
+  pluginSummary: {
+    installed: number;
+    toInstall: number;
+  };
+  pathIssues: PathIssue[];
+  secretCount: number;
+  dependencyIssues: {
+    item: string;
+    dependency: string;
+  }[];
+}
+interface ImportDecisions {
+  strategy: GlobalConflictStrategy;
+  resolutions: Record<string, ItemResolution>;
+  pathMappings: PathMapping[];
+}
+interface ImportPlan {
+  items: PlanItem[];
+  globalStrategy: GlobalConflictStrategy;
+  pathMappings: PathMapping[];
+  missingSecrets: {
+    ref: string;
+    required: boolean;
+  }[];
+  needsRestart: boolean;
+  estimatedActions: Record<SectionId, number>;
+}
+interface ExecutedItem {
+  itemId: string;
+  status: 'ok' | 'skipped' | 'failed';
+  message?: string;
+}
+interface ImportResult {
+  ok: boolean;
+  executed: ExecutedItem[];
+  needsRestart: boolean;
+  missingSecrets: string[];
+  warnings: string[];
+  rollback: RollbackReport | null;
+  snapshotId: string | null;
+}
+interface RollbackReport {
+  full: boolean;
+  restored: string[];
+  failed: {
+    item: string;
+    reason: string;
+    manualHint?: string;
+  }[];
+}
+interface ExportReport {
+  included: {
+    section: SectionId;
+    counts: Record<string, number>;
+  }[];
+  excluded: SectionId[];
+  security: {
+    secretsExcluded: boolean;
+    containsSecrets: boolean;
+    encrypted: boolean;
+    redactedHits: number;
+  };
+  file: {
+    name: string;
+    sizeBytes: number;
+  };
+  warnings: string[];
+}
+//#endregion
+//#region src/client/api.d.ts
+/** Host 半健康检查响应（plugin 版本 / DSH 版本 / 平台，用于主页横幅与兼容性说明） */
+interface ServiceStatus {
+  ready: boolean;
+  pluginVersion: string;
+  dshVersion: string;
+  platform: string;
+  arch: string;
+}
+/** export 端点响应（对齐 ExportFlow 的 ExportRunResult 前半部分） */
+interface ExportResponse {
+  zipPath: string;
+  manifest: Manifest;
+  report: ExportReport;
+}
+/** upload 端点响应：Host 把用户上传的 ZIP 存入受控临时目录，返回可被 analyze/plan/execute 引用的路径 */
+interface UploadResponse {
+  zipPath: string;
+  name: string;
+  sizeBytes: number;
+}
+/** 携带路由 JSON error 消息的错误类型 */
+declare class ConfigManagerApiError extends Error {
+  constructor(message: string);
+}
+/** 导出下载结果（流式落盘或内存 Blob 兜底） */
+interface DownloadResult {
+  blob?: Blob;
+  filename: string;
+  streamed: boolean;
+  bytes: number;
+}
+/**
+ * Config Manager 浏览器半的唯一数据入口。
+ * 同时实现 `ExportPort`（export-flow 用）与 `ImportPort`（import-wizard 用）。
+ */
+declare class ConfigManagerApi {
+  /**
+   * 加密备份密码（仅内存，默认 null = 普通备份）。
+   * ExportView 在 run 前设置；export 请求体携带给 Host 半做 AES-256-GCM 加密。
+   * 绝不写入 manifest / 任何 DSH 配置 / localStorage。
+   */
+  exportPassword: string | null;
+  /** 健康/版本检查（主页横幅：插件版本 / DSH 版本 / 平台） */
+  status(): Promise<ServiceStatus>;
+  /** ExportPort.export：调用 Host 侧导出编排（core Exporter）。加密密码随请求体传输（仅内存）。 */
+  export(options: ExportOptions): Promise<ExportResponse>;
+  /**
+   * 把导出的 ZIP 下载到本机。优先 File System Access API 流式落盘
+   * （不占整文件内存），不可用时回退内存 Blob（dsh-ssh downloadFile 同款策略）。
+   */
+  download(zipPath: string, onProgress?: (received: number, total: number) => void): Promise<DownloadResult>;
+  /** 上传用户选择的 ZIP 到 Host 受控临时目录，返回可引用的 zipPath（dsh-ssh 同款原始字节上传） */
+  upload(file: File): Promise<UploadResponse>;
+  /** ImportPort.analyzeImport：零写入分析（校验/兼容性/差异/路径/秘密检测） */
+  analyzeImport(zipPath: string): Promise<ImportAnalysis>;
+  /** ImportPort.createImportPlan：用用户决策（冲突/路径映射/策略）生成最终计划（Dry Run 零写入） */
+  createImportPlan(zipPath: string, decisions: ImportDecisions): Promise<ImportPlan>;
+  /** ImportPort.executeImportPlan：快照→分阶段 apply→validate→commit/rollback */
+  executeImportPlan(zipPath: string, plan: ImportPlan, opts: {
+    confirm: boolean;
+    secretInputs?: Record<string, string>;
+    rollbackOnError: boolean;
+  }): Promise<ImportResult>;
+}
+//#endregion
+//#region src/client/client-types.d.ts
+/** 本插件 Client 半的注入业务面：每个 settings.section 注册项都拿到同一个 api 实例 */
+interface ConfigManagerSectionInjected {
+  api: ConfigManagerApi;
+}
+//#endregion
+//#region src/client/locales.d.ts
+/**
+ * Config Manager 表面文案：zh 为源语言，en 镜像每个键。
+ * 字典 namespace 由 client/index.ts 注册（declare module 合并进 LocaleNamespaceMap）。
+ * 键集合通过 `ConfigManagerKey` 类型在注册处做编译期校验（缺键/多键即编译错误）。
+ */
+declare const zh: {
+  readonly 'section.label': "备份与迁移";
+  readonly 'section.description': "导出 / 导入 / 迁移 DSH 配置（备份不含密钥，加密备份可选）";
+  readonly 'view.export': "导出备份";
+  readonly 'view.import': "导入恢复";
+  readonly 'common.close': "关闭";
+  readonly 'common.cancel': "取消";
+  readonly 'common.back': "上一步";
+  readonly 'common.next': "下一步";
+  readonly 'common.done': "完成";
+  readonly 'common.retry': "重试";
+  readonly 'common.confirm': "确认";
+  readonly 'common.loading': "加载中…";
+  readonly 'common.unknownError': "未知错误";
+  readonly 'status.ready': "Config Manager 已就绪（插件 {version} · DSH {dsh} · {platform}）";
+  readonly 'status.unavailable': "Config Manager 服务未就绪，请确认插件已正确挂载。";
+  readonly 'export.mode.quick': "快速导出";
+  readonly 'export.mode.quickHint': "一键导出推荐分区（可迁移、不含设备专属数据），适合常规备份。";
+  readonly 'export.mode.custom': "自定义导出";
+  readonly 'export.mode.customHint': "按分组逐项勾选要导出的分区。";
+  readonly 'export.includeSecrets': "包含真实密钥（加密备份）";
+  readonly 'export.includeSecretsHint': "勾选后导出将包含密钥，并以密码加密（AES-256-GCM）。密码仅用于本次加密，不会写入备份或任何配置文件。";
+  readonly 'export.password': "备份加密密码";
+  readonly 'export.passwordConfirm': "确认密码";
+  readonly 'export.passwordMismatch': "两次输入的密码不一致";
+  readonly 'export.passwordRequired': "包含密钥时必须设置加密密码";
+  readonly 'export.run': "开始导出";
+  readonly 'export.running': "正在导出…";
+  readonly 'export.download': "下载备份文件";
+  readonly 'export.selectionWarnings': "以下分区为设备相关数据，跨设备导入时可能不适用：";
+  readonly 'export.group.unknown': "其他";
+  readonly 'export.included': "已包含";
+  readonly 'export.excluded': "未包含";
+  readonly 'import.select.title': "选择备份文件";
+  readonly 'import.select.hint': "选择本机导出的 dsh-config-*.zip 备份文件开始导入。分析阶段只读，不会修改任何配置。";
+  readonly 'import.select.browse': "选择 ZIP 文件";
+  readonly 'import.select.file': "已选择：{name}";
+  readonly 'import.analyzing': "正在分析备份…";
+  readonly 'import.compatibility.title': "兼容性";
+  readonly 'import.compatibility.score': "兼容性评分：{score}";
+  readonly 'import.compatibility.ok': "备份可导入";
+  readonly 'import.compatibility.fail': "备份分析失败：{reason}";
+  readonly 'import.preview.title': "导入预览";
+  readonly 'import.preview.willChange': "将变更 {count} 项";
+  readonly 'import.preview.unchanged': "已一致跳过 {count} 项";
+  readonly 'import.preview.settings': "设置更新 {count}";
+  readonly 'import.preview.plugins': "插件待安装 {count}";
+  readonly 'import.preview.mcp': "MCP 新增 {count}";
+  readonly 'import.preview.prompts': "提示词 {count}";
+  readonly 'import.preview.paths': "路径映射 {count}";
+  readonly 'import.preview.secrets': "密钥待补录 {count}";
+  readonly 'import.preview.conflicts': "冲突 {count}";
+  readonly 'import.preview.restart': "导入后需重启 DSH 生效";
+  readonly 'import.confirm.execute': "确认导入";
+  readonly 'import.confirm.warning': "导入将修改当前 DSH 配置；执行前会自动创建安全快照，失败时整体回滚。";
+  readonly 'import.rollbackOnError': "失败时整体回滚（推荐）";
+  readonly 'import.importing': "正在导入…";
+  readonly 'import.secrets.title': "补录密钥";
+  readonly 'import.secrets.hint': "以下凭据未随备份导出（安全设计）。如需在目标 DSH 使用，请手动补录；留空将跳过。";
+  readonly 'import.secrets.optional': "（可选）";
+  readonly 'import.secrets.required': "（必需）";
+  readonly 'import.conflicts.title': "解决冲突";
+  readonly 'import.conflicts.hint': "以下配置项在目标 DSH 已存在且与备份不同，请逐项决策。";
+  readonly 'import.conflicts.keepCurrent': "保留当前";
+  readonly 'import.conflicts.useImported': "使用备份";
+  readonly 'import.conflicts.review': "稍后决定";
+  readonly 'import.conflicts.unresolved': "还有 {count} 项未决策";
+  readonly 'import.paths.title': "路径映射";
+  readonly 'import.paths.hint': "备份中的绝对路径在目标机器可能不存在，请为每条路径指定新位置（留空将跳过该路径）。";
+  readonly 'import.paths.old': "原路径";
+  readonly 'import.paths.new': "新路径";
+  readonly 'import.paths.unresolved': "还有 {count} 条路径未映射";
+  readonly 'report.export.title': "导出完成";
+  readonly 'report.import.title': "导入结果";
+  readonly 'report.rollback.title': "回滚报告";
+  readonly 'report.action.fixIssues': "查看失败项";
+  readonly 'report.action.viewDetails': "查看详情";
+  readonly 'report.action.done': "完成";
+  readonly 'report.needsRestart': "插件 / MCP 变更将在重启 DSH 后生效。";
+  readonly 'error.title': "操作失败";
+  readonly 'error.hint': "错误消息已自动脱敏，不会泄露任何密钥信息。";
+};
+/** 字典键联合（注册处 compile-time 校验） */
+type ConfigManagerKey = keyof typeof zh;
+//#endregion
+//#region src/client/ConfigManagerSection.d.ts
+type ConfigManagerSectionProps = PropsRuntime<'settings.section'> & ConfigManagerSectionInjected & {
+  t: TranslateNS<'config-manager'>;
+};
+//#endregion
+//#region src/client/export/ExportView.d.ts
+interface ExportViewProps {
+  api: ConfigManagerApi;
+  t: TranslateNS<'config-manager'>;
+}
+//#endregion
+//#region src/client/import/ImportWizardView.d.ts
+interface ImportWizardViewProps {
+  api: ConfigManagerApi;
+  t: TranslateNS<'config-manager'>;
+}
+//#endregion
+//#region src/client/index.d.ts
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** Config Manager 表面文案。 */
+    'config-manager': ConfigManagerKey;
+  }
+}
+/** 必需服务（fiber inject 等待 —— slots/locale 必须先就绪）。 */
+declare const inject: string[];
+/**
+ * 注册 Config Manager 设置页。
+ * @param ctx - client root context（slots + locale 服务）。
+ */
+declare function apply(ctx: ClientContext): void;
+//#endregion
+export { type ConfigManagerApiError, type ConfigManagerKey, type ConfigManagerSectionProps, type DownloadResult, type ExportViewProps, type ImportWizardViewProps, type ServiceStatus, type UploadResponse, apply, inject };
+
+		return module.exports;
+	}
+});
+//# sourceMappingURL=client.d.ts.map