Operation Guidesrefreshdatabasefile changes

Refresh the Database

When files in indexed folders are added, deleted, renamed, or changed, refresh the database to sync the file list and search data.

Assist Local Image Search Team2026-08-284 min read
Refresh the Database

When files in indexed folders are added, deleted, renamed, or changed, refresh the database to sync the file list and search data.

Use refresh when the contents of already indexed folders have changed. The app checks files, updates records, and regenerates the selected search data when needed.

Steps

  1. Open the refresh database dialog.
  2. Choose the refresh scope: the whole database or selected folders.
  3. Choose whether to detect modified files.
  4. Select the features that should be refreshed.
  5. Start the task and wait for it to finish.

Choosing the Refresh Scope

  • Whole database: best when many folders have changed.
  • Selected folder: faster when only one folder or project changed.

Right-clicking an indexed folder and choosing **Refresh folder** opens the same dialog with that folder selected.

Should "Detect File Changes" Be Enabled?

Enable it when files may have been replaced without changing names. The app checks size and modification time first, then performs deeper checks only when necessary.

If you only added new files or removed old files, refresh can usually run faster.

Choosing Refresh Features

  • Image search: refresh visual search data for new or changed images, PDFs, spreadsheets, videos, and screenshots.
  • Semantic search: refresh text-prompt search data.
  • Pose search: refresh human skeleton and body-pose feature data.
  • Face search: refresh face detection and recognition data.
  • OCR search: refresh recognized text.

Only one refresh feature can be selected per run. Color data belongs to the **Image search** feature and follows its configured image strategies. Duplicate detection has no separate option in this dialog; it follows the independent duplicate setting.

Difference from Add and Rebuild

  • Add folder indexes a new folder.
  • Refresh syncs changes in folders that are already indexed.
  • Rebuild repairs or regenerates strategy data for existing records.

Common Cases

  • If newly copied files do not appear, refresh the folder.
  • If a replaced file still shows old thumbnails or metadata, enable file-change detection.
  • If search results look abnormal even after refresh, use rebuild database indexes.