☁️ Data Sync

Data sync is one of the important features of WiseMindAI, allowing users to backup application settings and user data to local directories or cloud storage for recovery when needed. This feature addresses real user needs such as device migration, multi-device synchronization, and scheduled data backups.

💡 Why Do We Need Data Sync?

This is a feature that many users have been requesting for a long time. Previously, WiseMindAI insisted on local-first data storage, but users do have several real needs:

• What about changing computers? When switching to a new device, how to quickly migrate all data?
• How to sync across multiple devices? When using on multiple devices, how to keep data consistent?
• Can data be backed up regularly to prevent accidents? How to prevent data loss and ensure data security?

Now, all these questions have answers.

✨ Core Features

1. Local Backup: More Reliable

• One-click Backup: Backup all data to a local folder with one click
• Automatic Backup: Support automatic backup (e.g., every 24 hours)
• Backup History: Set the maximum number of historical backups to keep
• Exit Backup: Support automatic backup when closing the application (optional)

2. Cloud Backup: More Convenient

• WebDAV Support: Support WebDAV protocol, can connect to various WebDAV services
• Nutstore Support: Support Nutstore WebDAV service
• S3 Compatible Storage: Will support S3-compatible storage in the future
• Complete Recovery: Backup files are complete and can be fully restored

📦 Backup Content

You may be concerned about what content is backed up. Here's what will be backed up:

User Settings

User settings include all configuration information of the application, including:

• System Settings: Language, auto-update, data path, auto-start, etc.
• Profile: Avatar, nickname, theme, license information, etc.
• Model Configuration: LLM model settings, OCR configuration, Embedding configuration, etc.
• Document Settings: PDF loading method, auto-analysis, word selection menu, etc.
• Note Settings: Image hosting configuration, word limit, AI features, etc.
• Shortcut Settings: All custom shortcut configurations
• Other Settings: Plugin configuration, prompt style, immersive translation, etc.

User Data

User data includes all business data in the application, obtained through database export, including:

• File Data: All uploaded file records, file tags, file statistics, etc.
• Note Data: All note content, note tags, etc.
• Knowledge Base Data: Knowledge bases, knowledge documents, knowledge summaries, etc.
• Knowledge Card Data: Card sets, folders, cards, learning records, etc.
• Chat Data: Chat sessions, chat messages, etc.
• Poster Data: All created posters
• Search Records: Search history
• Other Data: All business data stored in the database

One restore, completely return to your familiar state. Whether it's changing devices, reinstalling the system, or long-term data security, this version finally gives you peace of mind.

📖 User Guide

Local Backup

Manual Backup

1. Open WiseMindAI Settings
2. Go to the "Data Sync" page
3. Click the "Backup Now" button
4. Select backup save location (optional, if default path is configured)
5. Wait for backup to complete

Backup file naming format: WiseMind_Backup_YYYY_MM_DD_HH_mm_ss.zip

Automatic Backup Configuration

1. Enable "Automatic Backup" on the "Data Sync" page
2. Set backup interval (e.g., every 24 hours)
3. Set backup save path
4. Set maximum number of backups to keep (optional)
5. Enable "Backup on Exit" (optional)

Cloud Backup

WebDAV Backup

1. Select "Cloud Backup" on the "Data Sync" page
2. Select backup type as "WebDAV"
3. Configure WebDAV server information:
   • URL: WebDAV server address (e.g., https://example.com/dav)
   • Username: WebDAV username
   • Password: WebDAV password
   • Path: Backup file storage path (e.g., /backup)
4. Click "Test Connection" to verify configuration
5. Enable "Automatic Backup" and set backup interval

Nutstore Backup

1. Select "Cloud Backup" on the "Data Sync" page
2. Select backup type as "Nutstore"
3. Configure Nutstore information:
   • Server: https://dav.jianguoyun.com/dav/ (pre-filled)
   • Username: Nutstore account
   • Password: Application password (not login password, needs to be generated in Nutstore settings)
   • Path: Backup file storage path (e.g., /WiseMindAI/backup)
4. Click "Test Connection" to verify configuration
5. Enable "Automatic Backup" and set backup interval

How to Get Nutstore Application Password:

1. Log in to Nutstore web version
2. Go to "Account Information" → "Security Options"
3. Generate application password in "Third-party Application Management"
4. Use the generated application password (not login password) for configuration

S3 Compatible Storage Backup (Coming Soon)

Future versions will support S3-compatible storage, including:

• Amazon S3
• Alibaba Cloud OSS
• Tencent Cloud COS
• Other S3-compatible services

Restore Data

Restore from Local Backup

1. Click "Restore Data" on the "Data Sync" page
2. Select "Restore from Local Backup"
3. Select backup file (.zip format)
4. Confirm restore operation (Note: Restore will overwrite current data)
5. Wait for restore to complete
6. Restart the application for settings to take effect

Restore from Cloud Backup

1. Click "Restore Data" on the "Data Sync" page
2. Select "Restore from Cloud Backup"
3. Select cloud backup type (WebDAV/Nutstore)
4. The system will automatically download the latest backup file
5. Confirm restore operation (Note: Restore will overwrite current data)
6. Wait for restore to complete
7. Restart the application for settings to take effect

🎯 Use Cases

1. Scheduled Backup

Set up automatic backup to regularly save data and prevent accidental loss.

Recommended Configuration:

• Enable automatic backup
• Set backup interval to 24 hours
• Set maximum number of backups to keep to 10

2. Data Migration

Migrate application data between different devices and quickly restore complete state on new devices.

Steps:

1. Create backup on original device
2. Transfer backup file to new device
3. Restore backup on new device

3. Data Recovery

Restore backup when data is lost to quickly return to previous state.

Notes:

• Restore will overwrite current data, please operate with caution
• It is recommended to backup current data before restoring

4. Version Management

Keep data snapshots at multiple time points, allowing you to return to a specific time point at any time.

📝 Notes

1. Backup File Size

User data may be large, and backup files may reach tens of MB or even larger. Please ensure:

• Local backup has sufficient storage space
• Cloud backup has sufficient storage quota
• Network connection is stable (for cloud backup)

2. Network Stability

Cloud backup requires a stable network connection. It is recommended:

• Perform backup when network is stable
• Keep network connection during large file backup
• Check network and configuration when backup fails

3. Security

Backup files contain all user data. It is recommended:

• Keep backup files safe
• Do not share backup files with others
• Consider encrypting backup files (future feature)

4. Restore Impact

Restoring data will overwrite current data. Please:

• Confirm that current data is backed up before restoring
• Carefully select the backup file to restore
• Check data integrity after restore

5. Version Compatibility

Backup files contain version information. When restoring, please note:

• It is recommended to restore with the same or compatible version
• Cross-version restore may have issues
• Check if functions are normal after restore

6. Nutstore Application Password

When using Nutstore backup, you must use an application password (not login password):

• Application password is generated in Nutstore web version
• Each application password can only be used for one application
• Application password can be revoked at any time

🚀 Technical Implementation

Implementation Solution

The data sync feature completely reuses the existing export logic in the settings dialog:

User Settings Export

• Reuse getSetting() to get settings data
• Directly use exported settings data

User Data Export

• Reuse exportUserData() to get database export
• Directly use exported user data

Core Advantages

1. Code Reuse: Fully utilize existing export functionality, reducing code duplication
2. Data Consistency: Use the same export logic to ensure backup data is consistent with manually exported data
3. Easy Maintenance: Export logic is centrally managed, only need to update one place when modifying
4. Complete Functionality: Support multiple backup methods locally and in the cloud, meeting different needs

🔮 Future Improvements

1. Incremental Backup: Only backup changed data, reducing backup file size
2. Backup Encryption: Encrypt backup files to improve security
3. Backup Compression: Compress backup files to reduce storage space
4. Backup History: Record backup history, support restoring from specific time points
5. Automatic Backup Optimization: Implement scheduled tasks to automatically execute backups according to configuration
6. Multi-device Sync: Support data synchronization between multiple devices
7. S3 Compatible Storage: Support more cloud storage services

💡 Usage Recommendations

1. Regular Backup: It is recommended to set up automatic backup to regularly save data
2. Multiple Backups: Use both local backup and cloud backup for double protection
3. Backup Verification: Regularly verify that backup files are complete and usable
4. Version Management: Keep backups at multiple time points for easy rollback
5. Secure Storage: Keep backup files safe and do not leak them to others

The launch of the data sync feature allows WiseMindAI to maintain local-first data storage while also meeting user needs for device migration, multi-device synchronization, and scheduled backups, providing better data security.