☁️ 數據同步

數據同步是 WiseMindAI 的重要功能之一，允許用戶將應用的用戶設置和用戶數據備份到本地目錄或雲端存儲，以便在需要時進行恢復。該功能解決了用戶換電腦、多設備同步、數據定期備份等真實需求。

💡 為什麼需要數據同步？

這是很多用戶催了很久的功能。之前 WiseMindAI 一直堅持數據本地化優先，但大家也確實有幾個真實需求：

• 換電腦怎麼辦？ 換新設備時，如何快速遷移所有數據？
• 多設備怎麼同步？ 在多個設備上使用，如何保持數據一致？
• 數據能不能定期備份，防止意外？ 如何防止數據丟失，確保數據安全？

現在，這些問題都有答案了。

✨ 核心功能

1. 本地備份：更穩

• 一鍵備份：一鍵把所有數據備份到本地文件夾
• 自動備份：支援自動備份（例如每 24 小時）
• 歷史備份：可設置最多保留多少份歷史備份
• 關閉備份：支援關閉應用時自動備份（可選）

2. 雲端備份：更省心

• WebDAV 支援：支援 WebDAV 協議，可連接各種 WebDAV 服務
• 堅果雲支援：支援堅果雲 WebDAV 服務
• S3 兼容存儲：後續會支援 S3 兼容存儲
• 文件完整可恢復：備份文件完整，可完整恢復

📦 備份內容

大家可能會關心備份的內容有哪些，以下是會備份的內容：

用戶設置（User Settings）

用戶設置包括應用的所有配置信息，包括：

• 系統設置：語言、自動更新、數據路徑、自動啟動等
• 個人資料：頭像、暱稱、主題、許可證信息等
• 模型配置：LLM 模型設置、OCR 配置、Embedding 配置等
• 文檔設置：PDF 加載方式、自動分析、劃詞菜單等
• 筆記設置：圖床配置、字數限制、AI 功能等
• 快捷鍵設置：所有自定義快捷鍵配置
• 其他設置：插件配置、提示詞風格、沉浸式翻譯等

用戶數據（User Data）

用戶數據包括應用中的所有業務數據，通過數據庫導出獲取，包括：

• 文件數據：所有上傳的文件記錄、文件標籤、文件統計等
• 筆記數據：所有筆記內容、筆記標籤等
• 知識庫數據：知識庫、知識文檔、知識摘要等
• 知識卡片數據：卡片集、文件夾、卡片、學習記錄等
• 對話數據：聊天會話、聊天消息等
• 海報數據：所有創建的海報
• 搜索記錄：搜索歷史記錄
• 其他數據：所有存儲在數據庫中的業務數據

一次恢復，完整回到熟悉的狀態。 以後不管是換設備、重裝系統，還是長期數據安全，這一版終於可以放心了。

📖 使用指南

本地備份

手動備份

1. 打開 WiseMindAI 設置
2. 進入「數據同步」頁面
3. 點擊「立即備份」按鈕
4. 選擇備份保存位置（可選，如果已配置默認路徑）
5. 等待備份完成

備份文件命名格式：WiseMind_Backup_YYYY_MM_DD_HH_mm_ss.zip

自動備份配置

1. 在「數據同步」頁面啟用「自動備份」
2. 設置備份間隔（例如：每 24 小時）
3. 設置備份保存路徑
4. 設置最多保留備份數量（可選）
5. 啟用「關閉應用時自動備份」（可選）

雲端備份

WebDAV 備份

1. 在「數據同步」頁面選擇「雲端備份」
2. 選擇備份類型為「WebDAV」
3. 配置 WebDAV 服務器信息：
   • URL：WebDAV 服務器地址（例如：https://example.com/dav）
   • 用戶名：WebDAV 用戶名
   • 密碼：WebDAV 密碼
   • 路徑：備份文件存儲路徑（例如：/backup）
4. 點擊「測試連接」驗證配置
5. 啟用「自動備份」並設置備份間隔

堅果雲備份

1. 在「數據同步」頁面選擇「雲端備份」
2. 選擇備份類型為「堅果雲」
3. 配置堅果雲信息：
   • 服務器：https://dav.jianguoyun.com/dav/（已預填）
   • 用戶名：堅果雲賬號
   • 密碼：應用密碼（非登錄密碼，需要在堅果雲設置中生成）
   • 路徑：備份文件存儲路徑（例如：/WiseMindAI/backup）
4. 點擊「測試連接」驗證配置
5. 啟用「自動備份」並設置備份間隔

獲取堅果雲應用密碼：

1. 登錄堅果雲網頁版
2. 進入「賬戶信息」→「安全選項」
3. 在「第三方應用管理」中生成應用密碼
4. 使用生成的應用密碼（而非登錄密碼）進行配置

S3 兼容存儲備份（即將支援）

後續版本將支援 S3 兼容存儲，包括：

• Amazon S3
• 阿里雲 OSS
• 騰訊雲 COS
• 其他 S3 兼容服務

恢復數據

從本地備份恢復

1. 在「數據同步」頁面點擊「恢復數據」
2. 選擇「從本地備份恢復」
3. 選擇備份文件（.zip 格式）
4. 確認恢復操作（注意：恢復會覆蓋當前數據）
5. 等待恢復完成
6. 重啟應用使設置生效

從雲端備份恢復

1. 在「數據同步」頁面點擊「恢復數據」
2. 選擇「從雲端備份恢復」
3. 選擇雲端備份類型（WebDAV/堅果雲）
4. 系統會自動下載最新的備份文件
5. 確認恢復操作（注意：恢復會覆蓋當前數據）
6. 等待恢復完成
7. 重啟應用使設置生效

🎯 使用場景

1. 定期備份

設置自動備份，定期保存數據，防止意外丟失。

推薦配置：

• 啟用自動備份
• 設置備份間隔為 24 小時
• 設置最多保留 10 份歷史備份

2. 遷移數據

在不同設備間遷移應用數據，快速在新設備上恢復完整狀態。

操作步驟：

1. 在原設備上創建備份
2. 將備份文件傳輸到新設備
3. 在新設備上恢復備份

3. 數據恢復

在數據丟失時恢復備份，快速回到之前的狀態。

注意事項：

• 恢復會覆蓋當前數據，請謹慎操作
• 建議在恢復前先創建當前數據的備份

4. 版本管理

保留多個時間點的數據快照，可以隨時回到特定時間點的狀態。

📝 注意事項

1. 備份文件大小

用戶數據可能較大，備份文件可能達到幾十 MB 甚至更大。請確保：

• 本地備份有足夠的存儲空間
• 雲端備份有足夠的存儲配額
• 網絡連接穩定（雲端備份）

2. 網絡穩定性

雲備份需要穩定的網絡連接，建議：

• 在網絡穩定時進行備份
• 大文件備份時保持網絡連接
• 備份失敗時檢查網絡和配置

3. 安全性

備份文件包含所有用戶數據，建議：

• 妥善保管備份文件
• 不要將備份文件分享給他人
• 考慮對備份文件進行加密（未來功能）

4. 恢復影響

恢復數據會覆蓋當前數據，請：

• 在恢復前確認已備份當前數據
• 仔細選擇要恢復的備份文件
• 恢復後檢查數據完整性

5. 版本兼容性

備份文件包含版本信息，恢復時需注意：

• 建議使用相同或兼容版本恢復
• 跨版本恢復可能存在問題
• 恢復後檢查功能是否正常

6. 堅果雲應用密碼

使用堅果雲備份時，必須使用應用密碼（而非登錄密碼）：

• 應用密碼在堅果雲網頁版生成
• 每個應用密碼只能用於一個應用
• 可以隨時撤銷應用密碼

🚀 技術實現

實現方案

數據同步功能完全復用了設置彈框中已有的導出邏輯：

用戶設置導出

• 復用 getSetting() 獲取設置數據
• 直接使用導出的設置數據

用戶數據導出

• 復用 exportUserData() 獲取數據庫導出
• 直接使用導出的用戶數據

核心優勢

1. 代碼復用：充分利用現有導出功能，減少代碼重複
2. 數據一致性：使用相同的導出邏輯，確保備份數據與手動導出數據一致
3. 易於維護：導出邏輯集中管理，修改時只需更新一處
4. 功能完整：支援本地和雲端多種備份方式，滿足不同需求

🔮 未來改進方向

1. 增量備份：只備份變更的數據，減少備份文件大小
2. 備份加密：對備份文件進行加密，提高安全性
3. 備份壓縮：壓縮備份文件，減少存儲空間
4. 備份歷史：記錄備份歷史，支援選擇特定時間點的備份恢復
5. 自動備份優化：實現定時任務，按配置自動執行備份
6. 多設備同步：支援多設備間的數據同步
7. S3 兼容存儲：支援更多雲端存儲服務

💡 使用建議

1. 定期備份：建議設置自動備份，定期保存數據
2. 多重備份：同時使用本地備份和雲端備份，雙重保障
3. 備份驗證：定期驗證備份文件是否完整可用
4. 版本管理：保留多個時間點的備份，方便回滾
5. 安全存儲：妥善保管備份文件，不要洩露給他人

數據同步功能的推出，讓 WiseMindAI 在保持數據本地化優先的同時，也滿足了用戶換設備、多設備同步、定期備份等真實需求，讓數據安全更有保障。