dsh-config-manager 0.1.33 → 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;
@@ -1127,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': "上一步";
@@ -1154,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': "已包含";
@@ -1250,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;
@@ -1514,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 {
@@ -1533,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;
 	}