dsh-config-manager 0.1.13 → 0.1.14

package/README.md

@@ -35,6 +35,7 @@ DSH is your AI assistant workbench — it holds your settings: model configs, pl
 | 🔒 | **Secret safety** | API Keys are never exported; re-enter them after import |
 | ↩️ | **Automatic rollback** | Failed import restores everything automatically |
 | 📸 | **Snapshot restore** | Undo an import: whole-file restore + uninstall added plugins (CLI & GUI) |
+| 🔄 | **Remote Sync** | Push/pull portable config via a private Git repo (secrets never sync) |
 | 🗂️ | **Profiles** | Save multiple setups (Work / Personal) and switch anytime |
 
 ---

package/README.zh-CN.md

@@ -35,6 +35,7 @@ DSH 是你的 AI 助手工作台，里面存着你的各种设置：模型配置
 | 🔒 | **密钥安全** | API Key 默认不导出；导入后提醒你重新填写 |
 | ↩️ | **自动回滚** | 导入失败自动恢复原样，不会弄坏现有配置 |
 | 📸 | **快照恢复** | 撤销一次导入：整文件还原 + 卸载新增插件（CLI 与 GUI 均支持） |
+| 🔄 | **远程同步** | 通过 Git 私有仓库推送 / 拉取可移植配置（密钥永不参与同步） |
 | 🗂️ | **配置档案 Profiles** | 保存多套配置（工作 / 个人），随时切换 |
 
 ---

package/lib/client.d.ts

@@ -353,10 +353,83 @@ declare class ConfigManagerApi {
   restoreSnapshot(snapshotId: string, dryRun: boolean): Promise<RestoreResponse>;
 }
 //#endregion
+//#region src/sync/sync-engine.d.ts
+interface SyncPushReport {
+  ok: boolean;
+  snapshotId: string;
+  /** 实际进入同步的 portable 分区 */
+  sections: SectionId[];
+  /** 分区级告警（单项失败不拖垮整体，§34.17 语义） */
+  warnings: string[];
+  message?: string;
+}
+/** 差异报告中的单个变更项（PlanItem 摘要，不含敏感细节） */
+interface PullChange {
+  id: string;
+  adapter: SectionId;
+  kind: PlanItemKind;
+  description: string;
+  severity: PlanItem['severity'];
+}
+interface SyncPullReport {
+  ok: boolean;
+  snapshotId: string;
+  changes: PullChange[];
+  /** 是否存在需要人工决策的项（Conflict / MissingSecret / MissingDependency / Install / 路径问题） */
+  needsReview: boolean;
+  message?: string;
+}
+//#endregion
+//#region src/client/sync/sync-api.d.ts
+/** GET /sync/status 响应：配置/凭据/上次同步的只读事实（无任何 secret 值） */
+interface SyncStatusResponse {
+  ok: boolean;
+  /** 是否已保存过仓库配置（sync-config.json） */
+  configured: boolean;
+  /** 上次使用的仓库地址（不含 token，可回显） */
+  repoUrl?: string;
+  gitBin?: string;
+  /** DSH credentials 中是否已存在 token（describe 只报状态，值永不返回） */
+  credentialConfigured: boolean;
+  credentialWritable: boolean;
+  /** sync-state.lastSyncAt；'' = 从未同步 */
+  lastSyncAt?: string;
+  /** sync-state.sections 条目数 */
+  sectionCount: number;
+  transport?: {
+    type: string;
+    ref: string;
+  };
+}
+/** push 请求体（token 可选：非空则 Host 先写入 DSH credentials 再使用） */
+interface SyncPushPayload {
+  repoUrl: string;
+  gitBin?: string;
+  token?: string;
+}
+/** pull 请求体（strategy 缺省 merge：冲突保留待决策；snapshotId 缺省 = 最新） */
+interface SyncPullPayload extends SyncPushPayload {
+  strategy?: 'merge' | 'replace' | 'skipExisting';
+  snapshotId?: string;
+}
+/** 远程同步浏览器半数据入口（备份与迁移页第 4 个 tab 的注入业务面） */
+declare class SyncApi {
+  /** 读取同步状态（配置 / 凭据 / 上次同步时间 / 分区数） */
+  status(): Promise<SyncStatusResponse>;
+  /** 推送：导出 portable 分区 → 提交到私有 Git 仓库 → 更新 sync-state */
+  push(payload: SyncPushPayload): Promise<SyncPushReport>;
+  /** 拉取差异预览：拉取远端最新快照 → 只读分析（绝不执行导入） */
+  pull(payload: SyncPullPayload): Promise<SyncPullReport>;
+}
+//#endregion
 //#region src/client/client-types.d.ts
 /** 本插件 Client 半的注入业务面：每个 settings.section 注册项都拿到同一个 api 实例 */
 interface ConfigManagerSectionInjected {
   api: ConfigManagerApi;
+  /** 远程同步 API（备份与迁移页第 4 个 tab 使用，主 section 注册时注入） */
+  syncApi: SyncApi;
+  /** 远程同步 locale（config-manager-sync 命名空间，主 section 注册时注入） */
+  syncT: import('@deepseek-ai/dsh-client-ui-slots').TranslateNS<'config-manager-sync'>;
 }
 //#endregion
 //#region src/client/locales.d.ts
@@ -371,6 +444,7 @@ declare const zh$1: {
   readonly 'view.export': "导出备份";
   readonly 'view.import': "导入恢复";
   readonly 'view.snapshots': "快照恢复";
+  readonly 'view.sync': "远程同步";
   readonly 'common.close': "关闭";
   readonly 'common.cancel': "取消";
   readonly 'common.back': "上一步";
@@ -532,82 +606,11 @@ interface ImportWizardViewProps {
   t: TranslateNS<'config-manager'>;
 }
 //#endregion
-//#region src/sync/sync-engine.d.ts
-interface SyncPushReport {
-  ok: boolean;
-  snapshotId: string;
-  /** 实际进入同步的 portable 分区 */
-  sections: SectionId[];
-  /** 分区级告警（单项失败不拖垮整体，§34.17 语义） */
-  warnings: string[];
-  message?: string;
-}
-/** 差异报告中的单个变更项（PlanItem 摘要，不含敏感细节） */
-interface PullChange {
-  id: string;
-  adapter: SectionId;
-  kind: PlanItemKind;
-  description: string;
-  severity: PlanItem['severity'];
-}
-interface SyncPullReport {
-  ok: boolean;
-  snapshotId: string;
-  changes: PullChange[];
-  /** 是否存在需要人工决策的项（Conflict / MissingSecret / MissingDependency / Install / 路径问题） */
-  needsReview: boolean;
-  message?: string;
-}
-//#endregion
-//#region src/client/sync/sync-api.d.ts
-/** GET /sync/status 响应：配置/凭据/上次同步的只读事实（无任何 secret 值） */
-interface SyncStatusResponse {
-  ok: boolean;
-  /** 是否已保存过仓库配置（sync-config.json） */
-  configured: boolean;
-  /** 上次使用的仓库地址（不含 token，可回显） */
-  repoUrl?: string;
-  gitBin?: string;
-  /** DSH credentials 中是否已存在 token（describe 只报状态，值永不返回） */
-  credentialConfigured: boolean;
-  credentialWritable: boolean;
-  /** sync-state.lastSyncAt；'' = 从未同步 */
-  lastSyncAt?: string;
-  /** sync-state.sections 条目数 */
-  sectionCount: number;
-  transport?: {
-    type: string;
-    ref: string;
-  };
-}
-/** push 请求体（token 可选：非空则 Host 先写入 DSH credentials 再使用） */
-interface SyncPushPayload {
-  repoUrl: string;
-  gitBin?: string;
-  token?: string;
-}
-/** pull 请求体（strategy 缺省 merge：冲突保留待决策；snapshotId 缺省 = 最新） */
-interface SyncPullPayload extends SyncPushPayload {
-  strategy?: 'merge' | 'replace' | 'skipExisting';
-  snapshotId?: string;
-}
-/** 远程同步浏览器半数据入口（settings.section: config-manager-sync 的注入业务面） */
-declare class SyncApi {
-  /** 读取同步状态（配置 / 凭据 / 上次同步时间 / 分区数） */
-  status(): Promise<SyncStatusResponse>;
-  /** 推送：导出 portable 分区 → 提交到私有 Git 仓库 → 更新 sync-state */
-  push(payload: SyncPushPayload): Promise<SyncPushReport>;
-  /** 拉取差异预览：拉取远端最新快照 → 只读分析（绝不执行导入） */
-  pull(payload: SyncPullPayload): Promise<SyncPullReport>;
-}
-//#endregion
 //#region src/client/sync/SyncSettingsView.d.ts
-interface SyncSettingsSectionInjected {
+interface SyncSettingsViewProps {
   api: SyncApi;
-}
-type SyncSettingsViewProps = PropsRuntime<'settings.section'> & SyncSettingsSectionInjected & {
   t: TranslateNS<'config-manager-sync'>;
-};
+}
 //#endregion
 //#region src/client/index.d.ts
 declare module '@deepseek-ai/dsh-client-ui-slots' {