dsh-config-manager 0.1.32 → 0.1.33

package/lib/client.d.ts

@@ -692,6 +692,10 @@ interface SyncSelectionPayload {
   mode: 'default' | 'advanced';
   /** 高级模式勾选分区；default 模式可为空数组 */
   sections: SectionId[];
+  /** 手动推送默认加密快照（密码每次推送输入，不持久化） */
+  encrypt?: boolean;
+  /** 手动推送默认导出真实凭据值（必须同时 encrypt） */
+  includeSecrets?: boolean;
 }
 /** webdav 通道状态字段（无任何 secret 值；password 只报 passwordConfigured 布尔） */
 interface WebDavStatusResponse {
@@ -704,6 +708,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 +733,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 +746,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 +975,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;
@@ -1241,6 +1271,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 +1357,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': "启用自动同步";