dsh-config-manager 0.1.32 → 0.1.34

package/lib/client.d.ts

@@ -574,6 +574,10 @@ interface DownloadResult {
   streamed: boolean;
   bytes: number;
 }
+/** 下载选项：saveDialog=true 才弹系统保存对话框（需用户手势）；缺省自动下载到浏览器下载目录 */
+interface DownloadOptions {
+  saveDialog?: boolean;
+}
 /**
  * Config Manager 浏览器半的唯一数据入口。
  * 同时实现 `ExportPort`（export-flow 用）与 `ImportPort`（import-wizard 用）。
@@ -594,10 +598,13 @@ declare class ConfigManagerApi {
    * 带 AbortController 超时：宿主若卡死，客户端得到明确错误而不是永远停在进度条。 */
   export(options: ExportOptions): Promise<ExportResponse>;
   /**
-   * 把导出的 ZIP 下载到本机。优先 File System Access API 流式落盘
-   * （不占整文件内存），不可用时回退内存 Blob（dsh-ssh downloadFile 同款策略）。
+   * 把导出的 ZIP 下载到本机。
+   * - 默认（saveDialog 缺省/false）：读取为 Blob 后用 <a download> 触发浏览器
+   *   静默下载到「下载」目录，无需用户额外操作（导出完成即可自动调用）；
+   * - saveDialog: true：优先 File System Access API 流式落盘（不占整文件内存），
+   *   用户可在系统保存对话框中选择位置；不可用/取消时回退 Blob 下载。
    */
-  download(zipPath: string, onProgress?: (received: number, total: number) => void): Promise<DownloadResult>;
+  download(zipPath: string, opts?: DownloadOptions, onProgress?: (received: number, total: number) => void): Promise<DownloadResult>;
   /** 上传用户选择的 ZIP 到 Host 受控临时目录，返回可引用的 zipPath（dsh-ssh 同款原始字节上传） */
   upload(file: File): Promise<UploadResponse>;
   /** ImportPort.analyzeImport：零写入分析（校验/兼容性/差异/路径/秘密检测） */
@@ -663,14 +670,15 @@ type SyncTransportType = 'git' | 'webdav';
 /** GET /sync/status 响应：配置/凭据/上次同步的只读事实（无任何 secret 值） */
 interface SyncStatusResponse {
   ok: boolean;
-  /** 是否已保存过仓库/通道配置（sync-config.json） */
+  /** 是否已保存过仓库/通道配置（sync-config.json；任一通道配置过即为 true） */
   configured: boolean;
-  /** git 通道：上次使用的仓库地址（不含 token，可回显） */
+  /** git 通道：已配置的仓库地址（不含 token，可回显；与当前通道无关，配置过即返回） */
   repoUrl?: string;
   /** git 通道：DSH credentials 中是否已存在 token（describe 只报状态，值永不返回） */
   credentialConfigured: boolean;
   credentialWritable: boolean;
-  /** webdav 通道：配置状态（url 可回显，username 非敏感；password 值永不返回） */
+  /** webdav 通道：配置状态（url 可回显，username 非敏感；password 值永不返回；
+   *  与当前通道无关，配置过即返回，供 git ↔ webdav 切换时回填表单） */
   webdav?: WebDavStatusResponse;
   /** sync-state.lastSyncAt；'' = 从未同步 */
   lastSyncAt?: string;
@@ -692,6 +700,10 @@ interface SyncSelectionPayload {
   mode: 'default' | 'advanced';
   /** 高级模式勾选分区；default 模式可为空数组 */
   sections: SectionId[];
+  /** 手动推送默认加密快照（密码每次推送输入，不持久化） */
+  encrypt?: boolean;
+  /** 手动推送默认导出真实凭据值（必须同时 encrypt） */
+  includeSecrets?: boolean;
 }
 /** webdav 通道状态字段（无任何 secret 值；password 只报 passwordConfigured 布尔） */
 interface WebDavStatusResponse {
@@ -704,6 +716,19 @@ interface WebDavStatusResponse {
   /** DSH credentials 中是否已存在密码（值永不返回） */
   passwordConfigured: boolean;
 }
+/** POST /sync/config 响应：保存成功后的轻量凭据状态（无 secret 值；UI 直接合并刷新徽章）。 */
+interface SyncConfigSaveResponse {
+  ok: boolean;
+  configured: boolean;
+  transport: SyncTransportType;
+  /** git 通道：token 是否已配置（值永不返回） */
+  credentialConfigured: boolean;
+  /** webdav 通道：username/password 是否已配置（值永不返回；git 通道为 undefined） */
+  webdav?: {
+    usernameConfigured: boolean;
+    passwordConfigured: boolean;
+  };
+}
 /** 可同步分区条目（status.syncSections 项）。只含 portable —— 与 SyncEngine 同步通道一致。 */
 interface SyncSectionInfo {
   id: SectionId;
@@ -716,7 +741,8 @@ interface SyncSectionInfo {
  *  扁平形状与 Host parseSyncBody 一致：git 携带 repoUrl/token；
  *  webdav 携带 url/username/password（顶层，不嵌套 webdav 对象）。
  *  git 可执行文件固定使用系统 PATH 中的 git，不再接受自定义路径。
- *  sections 可选（高级/自定义导出模式）：只推送勾选分区；缺省 = 默认模式全部推荐分区。 */
+ *  sections 可选（高级/自定义导出模式）：只推送勾选分区；缺省 = 默认模式全部推荐分区。
+ *  encrypt/encryptPassword/includeSecrets：加密快照（含可选密钥导出；密码仅内存传输，绝不落盘）。 */
 interface SyncPushPayload {
   /** 通道类型；缺省 'git' */
   transport?: SyncTransportType;
@@ -728,11 +754,20 @@ interface SyncPushPayload {
   password?: string;
   /** 仅同步指定分区（缺省 = 全部 portable 推荐分区；即「默认/快速导出」vs「高级/自定义导出」） */
   sections?: SectionId[];
-}
-/** pull 请求体（strategy 缺省 merge：冲突保留待决策；snapshotId 缺省 = 最新） */
+  /** 加密快照（sections 载荷整体加密；开启时必须提供 encryptPassword） */
+  encrypt?: boolean;
+  /** 加密密码（仅本次请求体内存传输，Host 绝不落盘/落日志；encrypt=true 时必填） */
+  encryptPassword?: string;
+  /** 导出真实凭据值（必须同时 encrypt=true，否则 Host 拒绝：密钥绝不明文进同步通道） */
+  includeSecrets?: boolean;
+}
+/** pull 请求体（strategy 缺省 merge：冲突保留待决策；snapshotId 缺省 = 最新；
+ *  decryptPassword 可选：拉取加密快照时提供，仅内存传输）。 */
 interface SyncPullPayload extends SyncPushPayload {
   strategy?: 'merge' | 'replace' | 'skipExisting';
   snapshotId?: string;
+  /** 解密密码（拉取/一键同步遇到加密快照时提供；仅内存传输，绝不落盘） */
+  decryptPassword?: string;
 }
 /** GET /sync/snapshots-list 响应：远端历史快照列表（按 createdAt 倒序）。 */
 interface SyncSnapshotsListResponse {
@@ -948,6 +983,9 @@ declare class SyncApi {
   /** 保存同步分区选择（POST /sync/selection）：模式 + 勾选分区持久化到 Host。
    *  自动同步调度器与手动 push 共用此配置（刷新/重启后仍然生效）。 */
   saveSelection(payload: SyncSelectionPayload): Promise<SyncSelectionPayload>;
+  /** 保存同步通道配置（POST /sync/config）：url/username/password（git: repoUrl/token）持久化。
+   *  password/token 经 Host 写入 DSH credentials（值永不回传）；返回凭据布尔供 UI 刷新徽章。 */
+  saveConfig(payload: SyncPushPayload): Promise<SyncConfigSaveResponse>;
   /** 一键回滚：按 restoreId 调用 backup→rollback */
   rollback(payload: {
     restoreId: string;
@@ -1097,6 +1135,7 @@ declare const zh$2: {
   readonly 'view.snapshots': "快照恢复";
   readonly 'view.sync': "远程同步";
   readonly 'view.market': "配置市场";
+  readonly 'view.about': "关于";
   readonly 'common.close': "关闭";
   readonly 'common.cancel': "取消";
   readonly 'common.back': "上一步";
@@ -1124,6 +1163,7 @@ declare const zh$2: {
   readonly 'export.run': "开始导出";
   readonly 'export.running': "正在导出…";
   readonly 'export.download': "下载备份文件";
+  readonly 'export.saved': "已保存到下载目录：{name}";
   readonly 'export.selectionWarnings': "以下分区为设备相关数据，跨设备导入时可能不适用：";
   readonly 'export.group.unknown': "其他";
   readonly 'export.included': "已包含";
@@ -1220,6 +1260,19 @@ declare const zh$2: {
   readonly 'report.needsRestart': "插件 / MCP 变更将在重启 DSH 后生效。";
   readonly 'error.title': "操作失败";
   readonly 'error.hint': "错误消息已自动脱敏，不会泄露任何密钥信息。";
+  readonly 'about.title': "关于 DSH Config Manager";
+  readonly 'about.subtitle': "插件信息、作者与反馈入口";
+  readonly 'about.official': "官方";
+  readonly 'about.version': "版本 {version}";
+  readonly 'about.dshVersion': "DSH {version}";
+  readonly 'about.links': "相关链接";
+  readonly 'about.star': "⭐ 在 GitHub 上点赞";
+  readonly 'about.repo': "GitHub 仓库";
+  readonly 'about.docs': "使用文档";
+  readonly 'about.issues': "反馈问题";
+  readonly 'about.authorLabel': "作者";
+  readonly 'about.loading': "正在获取版本信息…";
+  readonly 'about.retryStatus': "重新获取";
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type ConfigManagerKey = keyof typeof zh$2;
@@ -1241,6 +1294,9 @@ declare const zh$1: {
   readonly 'config.tokenHint': "将安全写入 DSH credentials（引用名 {ref}），不会写入同步文件或日志。留空表示沿用已保存的凭据。";
   readonly 'config.tokenSaved': "凭据已配置";
   readonly 'config.tokenPlaceholder': "ghp_…（可选）";
+  readonly 'config.save': "保存配置";
+  readonly 'config.saving': "保存中…";
+  readonly 'config.saveHint': "表单改动会自动保存（密码/token 安全写入 DSH credentials，不会写入同步文件或日志）；也可点击按钮立即保存。";
   readonly 'channel.title': "同步通道";
   readonly 'channel.hint': "选择远程同步通道：Git 私有仓库或 WebDAV 服务器。";
   readonly 'channel.git': "Git 私有仓库";
@@ -1324,6 +1380,18 @@ declare const zh$1: {
   readonly 'mode.sectionPortable': "可移植";
   readonly 'mode.sectionRecommended': "推荐";
   readonly 'mode.persistHint': "模式与分区选择已保存到本机：自动同步和手动推送都会使用此配置（重启后仍生效）。";
+  readonly 'mode.security': "加密与密钥导出（安全选项）";
+  readonly 'mode.encrypt': "加密备份";
+  readonly 'mode.encryptHint': "用密码加密同步快照（AES-256-GCM）。密码仅本次推送使用、绝不落盘；自动同步无法解密加密快照，会自动跳过并在同步历史中提示。";
+  readonly 'mode.password': "加密密码";
+  readonly 'mode.passwordConfirm': "确认密码";
+  readonly 'mode.passwordMismatch': "两次输入的密码不一致";
+  readonly 'mode.passwordRequired': "加密必须设置密码";
+  readonly 'mode.includeSecrets': "导出密钥";
+  readonly 'mode.includeSecretsHint': "把真实凭据值写入加密快照（勾选时自动选中加密；密钥绝不进入未加密快照）。";
+  readonly 'mode.encryptAutosyncNotice': "加密快照仅通过手动推送/拉取使用；自动同步无密码，遇到加密快照会跳过并在历史中提示。";
+  readonly 'mode.decryptPassword': "解密密码（加密快照拉取/同步用，可选）";
+  readonly 'mode.decryptPasswordHint': "拉取或一键同步遇到加密快照时输入；不输入则加密快照无法读取（自动同步会跳过并在历史中提示）。";
   readonly 'autosync.title': "自动同步";
   readonly 'autosync.description': "开启后，DSH 在后台保持配置一致：本地配置有改动时自动上传，检测到远端有新快照时才自动拉取合并；定时器仅作兜底轮询，无变化不重复动作。仅在无冲突且无需人工干预时才自动写入本地。";
   readonly 'autosync.enable': "启用自动同步";
@@ -1469,6 +1537,12 @@ interface MarketPanelProps {
   t: TranslateNS<'config-manager-market'>;
 }
 //#endregion
+//#region src/client/about/AboutPanel.d.ts
+interface AboutPanelProps {
+  api: ConfigManagerApi;
+  t: TranslateNS<'config-manager'>;
+}
+//#endregion
 //#region src/client/index.d.ts
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface LocaleNamespaceMap {
@@ -1488,7 +1562,7 @@ declare const inject: string[];
  */
 declare function apply(ctx: ClientContext): void;
 //#endregion
-export { type ConfigManagerApiError, type ConfigManagerKey, type ConfigManagerSectionProps, type DownloadResult, type ExportViewProps, type ImportWizardViewProps, type MarketKey, type MarketPanelProps, type ServiceStatus, type SyncKey, type SyncSettingsViewProps, type UploadResponse, apply, inject };
+export { type AboutPanelProps, type ConfigManagerApiError, type ConfigManagerKey, type ConfigManagerSectionProps, type DownloadResult, type ExportViewProps, type ImportWizardViewProps, type MarketKey, type MarketPanelProps, type ServiceStatus, type SyncKey, type SyncSettingsViewProps, type UploadResponse, apply, inject };
 
 		return module.exports;
 	}