fix(sync): preserve personalization across devices

Fixes #815

Author: Nagi-ovo

docs/en/guide/cloud-sync.md

@@ -4,13 +4,14 @@ Voyager Cloud Sync backs up your folders, prompt library, and starred messages t
 
 ## What Gets Synced
 
-| Data Type            | Synced | Details                                                    |
-| -------------------- | ------ | ---------------------------------------------------------- |
-| Folder structure     | Yes    | All folders, nesting, colors, and conversation assignments |
-| Prompt library       | Yes    | All saved prompts with tags and folder organization        |
-| Starred messages     | Yes    | Timeline bookmarks from any conversation                   |
-| Extension settings   | No     | Settings remain local to each browser                      |
-| Conversation content | No     | Chat content stays on Google's servers                     |
+| Data Type            | Synced | Details                                                                      |
+| -------------------- | ------ | ---------------------------------------------------------------------------- |
+| Folder structure     | Yes    | All folders, nesting, colors, and conversation assignments                   |
+| Prompt library       | Yes    | All saved prompts with tags and folder organization                          |
+| Starred messages     | Yes    | Timeline bookmarks from any conversation                                     |
+| Extension settings   | Yes    | Cross-device preferences such as sorting, colors, and input behavior         |
+| Plugin configuration | Yes    | Install/enable state and plugin settings; site permissions remain per-device |
+| Conversation content | No     | Chat content stays on Google's servers                                       |
 
 ## Features
 
@@ -19,7 +20,7 @@ Voyager Cloud Sync backs up your folders, prompt library, and starred messages t
 - **Flexible Sync**: Support for manual uploading and downloading/merging of data.
 
 ::: info
-**Coming Soon**: The next version will support syncing starred conversations.
+Device identifiers, access tokens, caches, viewport coordinates, and temporary runtime state are intentionally not synced as personalization settings.
 :::
 
 ## How to Use
@@ -58,8 +59,8 @@ While Cloud Sync offers great convenience, we strongly recommend that you also p
 ## How It Works
 
 1. **Authorization**: You sign in with Google and grant Voyager the `drive.file` permission — the most restrictive Drive scope available. Voyager can only see files it created.
-2. **Upload**: When you click "Upload to Cloud," Voyager serializes your folders, prompts, and stars into a JSON file and writes it to a dedicated folder in your Google Drive.
-3. **Download & Merge**: When you click "Download & Merge" on another device, Voyager reads the JSON file and intelligently merges it with your local data. New folders and prompts are added; existing ones are updated without duplicating.
+2. **Upload**: When you click "Upload to Cloud," Voyager writes separate JSON files for folders, prompts, stars, forks, timeline hierarchy, personalization settings, and plugin configuration to a dedicated folder in your Google Drive. Highlight data is included when highlight cloud sync is enabled.
+3. **Download & Merge**: When you click "Download & Merge" on another device, Voyager reads those files and merges them by data type. New folders and prompts are added without duplication, cloud preferences are restored, and plugin entries are merged by plugin ID.
 4. **No background sync**: Sync is manual and on-demand. Voyager never syncs without your explicit action.
 
 ## Supported Platforms

docs/guide/cloud-sync.md

@@ -5,7 +5,7 @@
 ## 功能特点
 
 - **多端同步**：利用 Google Drive 云端存储，在多台电脑上同步您的配置。
-- **全面覆盖**：支持同步 **文件夹结构**、**提示词库 (Prompts)** 等核心数据。
+- **全面覆盖**：支持同步文件夹、提示词库、星标、分支、时间线层级、高亮、个性化设置和插件配置。
 - **数据安全**：数据存储在您自己的 Google Drive 空间中，不经过第三方服务器，确保隐私安全。
 - **灵活同步**：支持手动上传、下载合并数据。
 
@@ -16,6 +16,16 @@
 3. 点击 **使用 Google 登录** 并完成授权。
 4. 授权成功后，点击 **上传到云端** 将本地数据同步到云端，或点击 **从云端下载合并** 将云端数据同步到本地。
 
+## 同步内容
+
+Voyager 会把不同类型的数据保存为独立 JSON 文件，避免大文件中的某一类数据覆盖其他内容：
+
+- `gemini-voyager-settings.json`：跨设备的个性化设置，例如会话排序、文件夹字号、颜色和输入行为。
+- `gemini-voyager-plugins.json`：插件安装、启用状态及插件内部设置。插件所需的网站权限仍需在每台设备上单独授权。
+- 文件夹、提示词、星标、分支、时间线层级和高亮分别使用各自的同步文件；高亮内容仅在开启高亮云同步后上传。
+
+窗口坐标、缓存、访问令牌、设备 ID 和临时任务状态不会写入个性化设置文件。
+
 ### 💡 极速同步
 
 最简单的方法是在左侧侧边栏的**文件夹区域顶部**，直接点击“上传到云端”或“下载并合并”按钮。

src/core/services/GoogleDriveSyncService.ts

@@ -7,6 +7,8 @@
  * Stores folders, prompts, and other sync data as separate files:
  * - gemini-voyager-folders.json
  * - gemini-voyager-prompts.json
+ * - gemini-voyager-settings.json
+ * - gemini-voyager-plugins.json
  * - gemini-voyager-starred.json
  * - gemini-voyager-highlights.json (account-scoped; independent from legacy sync data)
  */
@@ -17,6 +19,7 @@ import type {
   ForkExportPayload,
   ForkNodesDataSync,
   HighlightExportPayload,
+  PluginStateExportPayload,
   PromptExportPayload,
   PromptItem,
   SettingsExportPayload,
@@ -33,11 +36,13 @@ import { DEFAULT_SYNC_STATE } from '@/core/types/sync';
 import { isBrave } from '@/core/utils/browser';
 import { hashString } from '@/core/utils/hash';
 import { EXTENSION_VERSION } from '@/core/utils/version';
+import type { PluginStateMap } from '@/features/plugins/storage/pluginState';
 
 const FOLDERS_FILE_NAME = 'gemini-voyager-folders.json';
 const AISTUDIO_FOLDERS_FILE_NAME = 'gemini-voyager-aistudio-folders.json';
 const PROMPTS_FILE_NAME = 'gemini-voyager-prompts.json';
 const SETTINGS_FILE_NAME = 'gemini-voyager-settings.json';
+const PLUGINS_FILE_NAME = 'gemini-voyager-plugins.json';
 const STARRED_FILE_NAME = 'gemini-voyager-starred.json';
 const FORKS_FILE_NAME = 'gemini-voyager-forks.json';
 const TIMELINE_HIERARCHY_FILE_NAME = 'gemini-voyager-timeline-hierarchy.json';
@@ -69,6 +74,7 @@ export class GoogleDriveSyncService {
   private aistudioFoldersFileId: string | null = null;
   private promptsFileId: string | null = null;
   private settingsFileId: string | null = null;
+  private pluginsFileId: string | null = null;
   private starredFileId: string | null = null;
   private forksFileId: string | null = null;
   private timelineHierarchyFileId: string | null = null;
@@ -140,6 +146,7 @@ export class GoogleDriveSyncService {
     this.aistudioFoldersFileId = null;
     this.promptsFileId = null;
     this.settingsFileId = null;
+    this.pluginsFileId = null;
     this.starredFileId = null;
     this.forksFileId = null;
     this.timelineHierarchyFileId = null;
@@ -169,6 +176,7 @@ export class GoogleDriveSyncService {
     accountScope: SyncAccountScope | null = null,
     timelineHierarchyAccountScope: SyncAccountScope | null = null,
     settings: Record<string, unknown> | null = null,
+    plugins: PluginStateMap | null = null,
   ): Promise<boolean> {
     try {
       this.updateState({ isSyncing: true, error: null });
@@ -212,6 +220,15 @@ export class GoogleDriveSyncService {
           }
         : null;
 
+      const pluginsPayload: PluginStateExportPayload | null = plugins
+        ? {
+            format: 'gemini-voyager.plugins.v1',
+            exportedAt: now.toISOString(),
+            version: EXTENSION_VERSION,
+            data: plugins,
+          }
+        : null;
+
       // Upload folders file (platform-specific)
       const foldersBaseFileName =
         platform === 'aistudio' ? AISTUDIO_FOLDERS_FILE_NAME : FOLDERS_FILE_NAME;
@@ -235,6 +252,11 @@ export class GoogleDriveSyncService {
         console.log('[GoogleDriveSyncService] Settings uploaded successfully');
       }
 
+      if (pluginsPayload) {
+        const pluginsFileId = await this.ensureFileId(token, PLUGINS_FILE_NAME, 'plugins');
+        await this.uploadFileWithRetry(token, pluginsFileId, pluginsPayload);
+      }
+
       // Upload starred messages file (only for Gemini platform)
       if (platform === 'gemini' && starred) {
         // Truncate content in starred messages to save storage space
@@ -315,6 +337,7 @@ export class GoogleDriveSyncService {
         1 +
         (prompts.length > 0 ? 1 : 0) +
         (settingsPayload ? 1 : 0) +
+        (pluginsPayload ? 1 : 0) +
         (platform === 'gemini' && starred ? 1 : 0) +
         (platform === 'gemini' && forks ? 1 : 0) +
         (platform === 'gemini' && timelineHierarchy ? 1 : 0);
@@ -513,6 +536,7 @@ export class GoogleDriveSyncService {
     folders: FolderExportPayload | null;
     prompts: PromptExportPayload | null;
     settings: SettingsExportPayload | null;
+    plugins: PluginStateExportPayload | null;
     starred: StarredExportPayload | null;
     forks: ForkExportPayload | null;
     timelineHierarchy: TimelineHierarchyExportPayload | null;
@@ -557,6 +581,12 @@ export class GoogleDriveSyncService {
         console.log('[GoogleDriveSyncService] Settings downloaded');
       }
 
+      let plugins: PluginStateExportPayload | null = null;
+      const pluginsFileId = await this.findFile(token, PLUGINS_FILE_NAME);
+      if (pluginsFileId) {
+        plugins = await this.downloadFileWithRetry(token, pluginsFileId);
+      }
+
       // Download starred messages file (only for Gemini platform)
       let starred: StarredExportPayload | null = null;
       if (platform === 'gemini') {
@@ -592,7 +622,15 @@ export class GoogleDriveSyncService {
         }
       }
 
-      if (!folders && !prompts && !settings && !starred && !forks && !timelineHierarchy) {
+      if (
+        !folders &&
+        !prompts &&
+        !settings &&
+        !plugins &&
+        !starred &&
+        !forks &&
+        !timelineHierarchy
+      ) {
         console.log(`[GoogleDriveSyncService] No sync files found for ${platform}`);
         this.updateState({ isSyncing: false });
         return null;
@@ -607,7 +645,7 @@ export class GoogleDriveSyncService {
       }
       await this.saveState();
 
-      return { folders, prompts, settings, starred, forks, timelineHierarchy };
+      return { folders, prompts, settings, plugins, starred, forks, timelineHierarchy };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : 'Download failed';
       console.error('[GoogleDriveSyncService] Download failed:', error);
@@ -904,6 +942,7 @@ export class GoogleDriveSyncService {
       | 'aistudio-folders'
       | 'prompts'
       | 'settings'
+      | 'plugins'
       | 'starred'
       | 'forks'
       | 'timeline-hierarchy'
@@ -959,6 +998,7 @@ export class GoogleDriveSyncService {
       | 'aistudio-folders'
       | 'prompts'
       | 'settings'
+      | 'plugins'
       | 'starred'
       | 'forks'
       | 'timeline-hierarchy'
@@ -978,6 +1018,9 @@ export class GoogleDriveSyncService {
       case 'settings':
         this.settingsFileId = fileId;
         break;
+      case 'plugins':
+        this.pluginsFileId = fileId;
+        break;
       case 'starred':
         this.starredFileId = fileId;
         break;