Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

AIClue User Manual

Version: 26.11.209

AIClue is a local file finding and organizing tool for Windows computers. It helps you search, filter, view, and organize files already stored on your computer.

  • Local-first - Day-to-day scanning, search, filtering, and preview are mainly completed on your computer
  • You stay in control - Search, filtering, preview, and project workspaces do not change original files. Moving or cleaning up files always requires your confirmation
  • Windows support today - The current public release is for Windows computers

This manual is the shared source for the built-in help and the official website documentation.

Chapter 1 Product Introduction

1.1 What Is AIClue

AIClue is a local file finding and organizing tool for Windows computers. It does not replace File Explorer. Instead, it helps you search, view, filter, and organize files that are scattered across your computer.

AIClue is suitable for situations such as:

  • You have many folders and want to find a file quickly
  • You remember a few words inside a document, but not the file name
  • Materials for the same topic are scattered across multiple directories, and you want to view them by project
  • Your computer contains duplicate files, and you want to review them before cleaning them up
  • New files often accumulate in Downloads, Desktop, or temporary folders, and you want to organize them in one place

1.2 Main Features

FeatureWhat it helps you do
Fast searchSearch file names and common document content, with matching snippets to help you judge relevance
File filteringNarrow results by file type, created time, modified time, directory, and other conditions
File previewPreview common documents, spreadsheets, presentations, images, audio/video files, Markdown, code, and plain text in the app; files that are not suitable for built-in preview can be opened with the system default app
Project workspacePlace related files from different directories into the same workspace for project-based viewing and opening, without changing the source file locations
Duplicate file detectionFind files with identical content, so you can decide which copies can be moved to the system recycle bin
Related filesContinue from a file to view files in the same folder or with similar content, helping you complete a set of materials
Workbench cardsEnable the cards you need and keep everyday file tasks together on the Workbench
Account and accessSupport local trial, account login, and access synchronization for managing available features

1.3 Privacy and Safety

AIClue’s everyday file management capabilities are mainly local:

  • Scan directories you add are not uploaded
  • File records, search data, filter information, and workspace data are saved on your computer
  • Search, preview, filtering, and project workspaces do not modify, move, or copy source files
  • Account login, access synchronization, and automatic updates do not upload your original file content
  • Before duplicate cleanup or moving files to organize, the app shows a clear prompt

AIClue may access the network for updates, account login, and access synchronization. Without logging in, the core file management and search capabilities can still be used locally.

1.4 Relationship with the System File Manager

AIClue complements your system file manager:

  • Use File Explorer when you want to open, copy, move, or rename regular files
  • Use AIClue when you want to search across directories, filter, preview, find duplicate files, or view materials by project
  • Project workspaces in AIClue are file references only and do not change the original source file locations

1.5 System Requirements

PlatformMinimumRecommended
WindowsWindows 10 64-bit, 4GB RAMWindows 10/11 64-bit, 8GB+ RAM
Disk500MB free space (app + search data)1GB+ free space
NetworkRequired for downloading the app, automatic updates, account login, and access synchronizationDaily scanning, search, and preview can be used offline

Note: The current public release is for 64-bit Windows 10/11 computers. When you add many files for the first time, AIClue needs time to read file information and prepare search data. After that is complete, everyday search and browsing will be smoother.

Chapter 2 Quick Start

This chapter helps you get started: install AIClue, choose folders to manage, and find your first file.

2.1 Download and install

Download the Windows installer from the AIClue download page. When the download finishes, open the installer and follow the prompts.

The current public release is for 64-bit Windows 10/11 computers. If Windows asks for permission to install or add a required component, first make sure the installer came from the official website, then follow the prompt.

2.2 First launch

The first-use guide suggests common folders. You can:

  • Select folders you want AIClue to search;
  • Clear folders you do not want to include; or
  • Skip the guide and add folders later in Directory Management.

After you start, AIClue adds the selected folders and begins preparing them for search. Start with Documents, Desktop, or one project folder, then add more locations once you are comfortable.

2.3 Add a folder

If you skipped the guide, you can add a folder at any time:

  1. Open Directory Management in the sidebar.
  2. Select Add Directory.
  3. Choose a folder in the system dialog and confirm.
  4. Wait for the folder to appear in the list.

AIClue automatically starts processing the folder. It records file names, locations, sizes, dates, and types. For common documents it can read, it also prepares text search. Adding a folder never moves, renames, or changes the original files.

2.4 Wait for preparation

The first pass can take time when a folder contains many files. You can keep browsing and searching; the status bar shows file counts, progress, and result update notices.

Before preparation is complete, file name searches usually return results first. Searches based on document text become more complete as processing finishes. When the status bar says results may have changed, select Refresh or search again to update the list.

2.5 Know the main window

AreaWhat it does
SidebarOpens the Workbench, Project Workspaces, Plugin Market, Duplicates, Directory Management, Account, and Settings
Top barLets you enter keywords, choose a search mode, filter by tags or folders, and change the theme
Main areaShows Workbench cards, file lists, search results, previews, project content, or settings
Status barShows result counts, managed file counts, progress notices, and the version

When there is no search or filter, the Workbench shows enabled cards. When you search, filter, or open a project workspace, the main area shows the matching file list.

  1. Select the search box in the top bar.
  2. Enter at least two characters, such as contract, report, or invoice.
  3. Press Enter or select the search button.
  4. Review file names, locations, and text snippets in the result list.
  5. Select a file to preview it, or use Open File to open it fully.

Choose a search mode from the left side of the search box:

  • Filename: searches filenames and locations without searching file content; best when you remember a name or rough location.
  • Content: searches within file content; best when you remember words or a sentence inside a document.
  • Smart Search: searches filenames, locations, and content together; best for most searches.

2.7 Next steps

Chapter 3 Main Interface and Basic Operations

This chapter introduces the AIClue main interface and the most common everyday operations. Directory management, search, project workspaces, and function cards are explained in more detail in later chapters.

3.1 Main Interface Areas

AIClue’s main interface is divided into four areas:

AreaPurpose
Left sidebarSwitch major feature entries, such as Workbench, Project Workspace, Plugin Market, Duplicate Detection, Directory Management, Account, and Settings
Top barEnter search keywords, switch search modes from the left side of the search box, use tag or directory filters, and switch theme
Main content areaShow the current entry’s content, such as function cards, file lists, search results, file preview, or settings pages
Bottom status barShow the current search mode and result count, total file count, background processing progress, result update prompts, and the version number

In everyday use, you will spend most of your time in the Workbench. When there are no search or filter conditions, the Workbench shows enabled function cards. When you start searching, choose filter conditions, or open project content, the main content area automatically switches to file list and preview.

3.2 Left Sidebar

The left sidebar is AIClue’s main navigation. Current visible entries include:

EntryDescription
WorkbenchMain everyday entry. Used to view function cards, search results, file lists, and previews
Project WorkspaceManage files from different directories by project
Plugin MarketEnable or disable function cards that can be placed in the Workbench
Duplicate DetectionFind files with duplicate content and help clean up extra copies
Directory ManagementAdd, remove, rescan, or manage scan directories
AccountView login status, available features, and related prompts
SettingsAdjust app options and maintenance settings

After you click an entry in the left sidebar, the main content area switches to the corresponding page. The current entry is highlighted.

3.3 Top Bar

The top bar is mainly used to search and filter files.

Enter a keyword in the search box and press Enter to search files. The search mode entry is fixed on the left side inside the search box and supports three modes:

  • Filename: Search filenames and locations without searching file content. Use this when you remember a name or rough location
  • Content: Search within file content. Use this when you only remember a content fragment
  • Smart Search: Search filenames, locations, and content together. Suitable for everyday use

Smart Search is the default recommendation. When you select Filename or Content, the mode label uses a reminder color. When you enter a local absolute path or an @ project workspace, the search mode is not used and the entry is temporarily hidden. Your previous choice is kept when you return to keyword search.

The search box also shows recent search history for quick repeat searches.

3.3.2 Filter Entries

You can use tag or directory filters in the top bar. After filtering, the file list only shows files that match the conditions.

Common uses include:

  • View only files under a specific directory
  • View only files with a certain type of tag
  • Continue searching within the filtered scope

3.4 Main Content Area

The main content area automatically shows different content depending on your current action.

3.4.1 Function Cards

When you open the Workbench and there are no search or filter conditions, the main content area shows enabled function cards. To enable, disable, move, or remove cards, see Chapter 8 Workbench and Function Cards.

3.4.2 File List

When you search, filter, or open project content, the main content area shows a file list. The file list usually shows file name, location, type, size, modified time, and other information.

Click a file name, location, created time, modified time, or size header to change the current sort order. Location/Path is sorted by the full path. Keyword results use relevance by default. Clicking a header sorts the currently displayed search results; entering a new keyword, switching search modes, or changing filters restores relevance-first results. Managed file lists, local directories, and project file lists also support header sorting.

Click a file to open its right-hand details panel with Preview selected. The main search box and theme button stay above the list on the left. The list has no separate action column; use the file context menu or the details dropdown to open, locate, or copy its path.

3.4.3 File Preview

Some files can be previewed directly in AIClue. For files that are not suitable for built-in preview, you can still open them with the system default app.

3.5 Bottom Status Bar

The bottom status bar shows AIClue’s current state, including:

InformationDescription
File countKeyword search shows the current search mode and result count; total file count is shown as secondary information
Background processing progressProcessing progress while scanning directories or reading document content
Result update promptPrompts you to refresh when background file changes may affect the current results
Version numberCurrent app version

If you just added many files, background processing may take some time. You can keep browsing and searching during processing, and some new files may appear in results later.

When the status bar shows a result update prompt, click Refresh beside it to reload the list using the current search or filter conditions. Background changes that do not affect the current results do not interrupt the list you are viewing.

3.6 Common Operations

OperationMethod
Search filesEnter a keyword in the top search box and press Enter
View a fileClick the file in the file list
Open a fileDouble-click the file, or choose open from the context menu
Locate a fileChoose open file location from the context menu
Copy pathChoose copy path from the context menu
Switch feature entryClick the corresponding entry in the left sidebar
Change themeUse the theme button in the top bar
Show or hide the windowPress Alt+C to hide the focused foreground window to the tray, or restore and focus it otherwise; an existing window keeps its current page, while a closed window reopens on the main screen
Start a search from the trayRight-click the AIClue tray icon and select Quick Search

Press Esc to leave one layer at a time: full-screen or standalone preview → settings → file details sidebar → clear search → hide to tray. Open text menus or visible search suggestions close first. Holding the key does not dismiss multiple layers. On another feature page, a search retained from the file page is cleared before the next press hides the window.

Close buttons show “Press Esc to close”; the search clear button shows “Press Esc to clear”. Dismissed search suggestions do not reopen merely because the app window is restored.

3.7 Next Steps

After you are familiar with the main interface, continue with:

Chapter 4 Directory Management and File Scanning

This chapter explains how to tell AIClue which folders to manage, how to view scan progress and rescan directories, and how scan exclusion rules affect directory scanning.

4.1 What Is a Scan Directory

A scan directory is a folder you want AIClue to manage. After you add a directory, AIClue records file information in it and reads text content from common documents for later search and filtering.

AIClue does not move, rename, or modify your source files just because you add a scan directory. It only saves file records on your computer for search and display.

4.2 Add a Directory

Click Directory Management in the left sidebar, then add a directory:

  1. Click Add Directory
  2. Choose a folder in the system folder picker
  3. After confirmation, the directory appears in the directory list
  4. AIClue automatically starts scanning the newly added directory

For first use, start with 1-2 common directories, such as Documents, Desktop, or a project folder. After you are familiar with the app, add more directories gradually.

When adding an external drive or network location, note that:

  • Related files may temporarily fail to open after the external device is disconnected
  • Scanning speed for network locations depends on network connection quality
  • Removable drives and network paths may be skipped by scan exclusion settings. If you need to scan them, first check the switches in Settings > Scan Exclusions
  • On Windows, the system drive root, important system directories, and the AIClue app directory cannot be added as scan directories
  • A non-system fixed drive root on Windows can be added, but protected or excluded subdirectories are still skipped during scanning

4.3 View Directory Status

The Directory Management page lists added directories. Each directory usually shows:

InformationDescription
Directory pathThe directory’s location on your computer
File countNumber of files AIClue currently records
Processing stateWhether files are currently being scanned or processed
Last scan timeThe most recent scan time for this directory

After you add a directory, file counts and search results may not become complete immediately. Wait for background processing to finish, or watch the progress in the bottom status bar.

Click the processing status in the bottom bar to see directory scans, text extraction, image text recognition, and search updates. Index cleanup shows how many stale file entries are still waiting to be removed from the search index. This cleanup affects search data only. Your original files stay where they are.

If a file or subfolder is temporarily unreadable, AIClue keeps its existing search data, processes readable areas first, and automatically retries the unfinished scopes. The scan recovery list in Processing Status includes queued scopes and scopes waiting for a retry, with their actual paths, reasons, and retry times. You can retry an individual scope when needed. The directory status updates after recovery finishes.

4.4 Rescan Directories

AIClue automatically scans after a directory is added, and it also watches for changes in added directories while the app is running. Usually, you do not need to scan manually often.

You can manually rescan in these cases:

  • You just copied many files into an added directory
  • An expected file does not appear in search results
  • An external drive has been reconnected and you want to refresh the file list
  • You changed scan exclusion rules in Settings and need the new rules to take effect

Common operations include:

OperationWhen to use it
Scan AllRecheck all added directories
Scan This DirectoryRecheck one specific directory only
Rebuild Search DataReorganize data used for search when search results are clearly abnormal

Note: Maintenance actions only affect the local records AIClue saves for search. They do not affect your original files.

4.5 Remove a Directory

If you no longer want AIClue to manage a directory, remove it on the Directory Management page.

Removing a directory only deletes file records and search data related to that directory from AIClue. It does not delete source files on your computer. You can add the directory again later if needed.

AIClue shows a confirmation prompt before removal to prevent mistakes.

4.6 Understand Scan Exclusion Rules

Scan exclusion settings tell AIClue which folders or files to skip. They are useful for leaving out temporary files, system folders, and other content you do not want in search results.

Exclusion rules are maintained in Settings > Scan Exclusions. The Directory Management page mainly shows added directories, scan status, and related warnings.

Common exclusion settings include:

SettingPurposeExample
Property and location switchesDecide whether to skip hidden folders, hidden files, system files, removable drives, and network pathsSkip network paths or removable drives
Folder and location ruleExclude folders with a specified name, or one selected location and its contentsA temporary folder or a work folder you do not want to search
File ruleExclude files by filename prefix or extensionTemporary files, tmp, log
Protected ruleProtect important locations from being scanned by mistakeSystem directories, app directory

Some rules are protected by AIClue and cannot be changed. Default rules and custom rules can be adjusted in Settings.

After scan exclusion rules are saved, AIClue updates file records according to the new rules. Stricter rules may make existing results disappear from the file list. After a rule is relaxed or removed, matching files usually need to be rescanned before they appear again.

4.7 Clear and Rebuild Search Data

The Directory Management page also provides maintenance operations, usually used only for troubleshooting:

OperationDescription
Clear Search DataDelete file data recorded by AIClue, but keep added directories; rescanning is required afterward
Rebuild Search DataKeep directory settings and reorganize the data used for search

These operations do not delete your source files, but they may take a long time to process files again. In everyday use, you do not need to run them if search and file lists are working normally.

4.8 Supported File Types

AIClue can record most regular files and read text content from common documents and text files. Images, audio, video, and other media files can usually be found by file name, location, and file information, but may not support content search.

For the full support scope, see Appendix Supported File Formats and Data Notes.

4.9 Next Steps

After directories are added, continue with:

Chapter 5 Search and Filtering

This chapter explains how to use AIClue to find files, and how to narrow results by search mode, tags, directories, and project scope.

5.1 Start Searching

Enter a keyword in the top search box to find files. You can enter:

  • Part of a file name, such as contract or invoice
  • Words that appear in document content, such as acceptance notes or meeting notes
  • A project or material topic, such as annual report

Press Enter after typing, or click the search button to start searching. During search, the Workbench automatically switches to a file list. After you clear the search box, if there are no other filter conditions, it returns to the function card view.

5.2 Choose a Search Mode

You can switch search modes from the left side inside the search box:

Search modeBest for
FilenameSearch filenames and locations without searching file content; useful when you remember a name or rough location
ContentYou do not remember the file name, but remember content from the document
Smart SearchSearch filenames, locations, and content together; suitable for everyday use

Smart Search is the default recommendation. When you switch to Filename or Content, the mode label uses a reminder color. When you enter a local absolute path or an @ project workspace, the entry is temporarily hidden without clearing your previous mode selection.

If you just added a directory, AIClue may still be reading document content in the background. Filename usually shows results first. Content and Smart Search become more complete as file content is prepared.

For English and mixed Chinese-English documents, AIClue supports searches with Chinese or English keywords. Uppercase and lowercase English letters do not affect matching. For longer English phrases, results closer to the full phrase generally appear earlier.

Keyword results use relevance by default, placing files that are more likely to match your intent first. When there are many results, AIClue shows up to 1,000 of the most relevant results first. The status bar also shows the current search mode, result count, and total managed file count.

5.3 View Search Results

Search results are shown as a file list. The list usually displays:

  • File name
  • File location
  • File type
  • File size
  • Created time or modified time
  • Content snippet around the match, if the current search mode and file type support it

Click a file to view its preview or details. Double-click a file to open it with the system default app. The file row and more menu provide operations such as opening or locating the file. To copy the file path, select the file first, then use the copy path button at the top of the preview area.

5.4 Filter by Tags

Tag filtering is used to show only files that match a certain type of tag. You can select tags from the filter entry in the top bar or the file list header.

Common uses include:

  • View only a certain type of file
  • Further narrow results after entering a search keyword
  • Exclude tag ranges you do not want to see

Filter conditions affect the current file list and search results. After filters are cleared, the file list returns to a more complete scope.

5.5 Filter by Directory

Directory filtering is used to show only files under one directory or a group of directories. It is useful when there are many files.

Common uses include:

  • Search only the Documents directory
  • View only a specific project material folder
  • Exclude unrelated directories

Directory filtering does not change file locations on your computer. It only affects the current display and search scope in AIClue.

5.6 Search Within a Project Scope

If you have created project workspaces, enter @ in the search box. AIClue shows available project suggestions.

After you select a project, the file list switches to that project scope. You can continue viewing and filtering files within the project scope.

This is useful for:

  • Viewing files in a project material set
  • Bringing files from different directories into one focused scope
  • Temporarily focusing on a work topic

Project workspaces do not move source files. They only show related files together in AIClue.

5.7 Search History and Suggestions

When you click the search box or start typing, AIClue shows recent search history. You can choose a suggestion directly to repeat a previous search quickly.

If you no longer need a history item, delete it from the suggestion list.

When you enter @, the suggestion list prioritizes project workspace related results.

Entering a local absolute path switches the search box to path browsing instead of ordinary keyword search. @ project workspaces and local paths are not saved in search history. Ordinary keywords must contain at least two characters; add more text if the keyword is too short.

5.8 Sort and Narrow Results Further

In the file list, you can sort by list headers, such as file name, full path, created time, modified time, or size.

Keyword results use relevance by default. Clicking a header sorts the currently displayed search results; entering a new keyword, switching search modes, or changing tag or directory filters restores relevance-first results.

The managed file list after clearing the query reloads with the selected sort order. Local directory browsing and project workspace file lists sort the files currently shown.

If there are too many results, narrow the scope in this order:

  1. First switch to a suitable search mode
  2. Then choose a directory scope
  3. Then choose a tag scope
  4. Finally adjust sorting, prioritizing recently modified or more relevant files

5.9 When You Cannot Find a File

If an expected file is not found, check in this order:

CheckDescription
Whether the directory has been addedThe folder containing the file must first be added in Directory Management
Whether background processing is completeA newly added large directory may still be processing; try again later
Whether the search mode is suitableIf you only remember content, use Content or Smart Search
Whether filters are too narrowClear tag and directory filters, then search again
Whether the file is excludedFiles that match scan exclusion rules do not appear in results. You can use Settings > Scan Exclusions > Path Check to check a path
Whether the file type supports content readingUnsupported file types can still be found by file name

For the full list of supported file types, see Appendix Supported File Formats and Data Notes.

5.10 Next Steps

After finding files, continue with:

Chapter 6 File Viewing and File Operations

This chapter explains how to view file information in AIClue, preview file content, and perform common operations such as opening and locating files.

6.1 Start from the File List

After you search, filter, or open project content, AIClue shows a file list. The file list usually contains information such as file name, path, type, time, and size.

You can complete these operations from the file list:

OperationMethod
View fileClick the file row to open details on the right, with Preview selected by default
Open with the system default appDouble-click the file, or click Open at the top of its details
Open file locationUse the file context menu or the dropdown at the top of its details
Preview fileClick a file row, then select Preview in the details toolbar
Adjust visible columnsChoose columns from the list header menu
Adjust sortingClick the file name, full path, time, or size headers
Add to a project workspaceRight-click a file, then select an existing workspace or create one and add the file
Remove from the current workspaceIn a project workspace file list, right-click a file and select Remove from current workspace

Keyword results use relevance by default; clicking a header only sorts the results currently shown. Managed file lists after clearing the query, local directories, and project file lists also support these headers. Location/Path is compared by the full path.

Adding or removing a file from a project workspace changes only the workspace relationship in AIClue. It does not move, copy, or delete the original file.

6.2 Preview Files

Clicking a file opens its details on the right with Preview selected. The first row contains the filename and an Open dropdown. The next row shows the full file path and an expansion arrow. It starts collapsed; expand it to see modification time, creation time, and size. The main search box and theme button stay above the file list on the left.

Choose Preview to view the rendered file, or Text to read extracted content. Search in the toolbar finds text only in the active view. Previous and next match buttons locate matches; Enter/F3 and Shift+Enter/Shift+F3 also navigate them. PDF search can navigate across pages; spreadsheet preview searches the current sheet. If a preview has no text that can be located, a message explains this. Switch to Text to check for extracted content.

Applicable page and zoom controls appear at the bottom of the preview. Full-screen preview expands within the app; exit or press Esc to return to the same file in the right panel.

Content-related and Same-directory tabs are stacked vertically at the far right of the reading area, below the toolbar. A tab expands its file list to the left; click the active tab again to collapse it. When details first open, the related lists are collapsed; only one list expands at a time. Clicking a related file changes the current details file. The Open dropdown always acts on that file; use the file list context menu for multiple selected files.

Previews adjust to the window or sidebar width. Text, Word, and spreadsheet content supports selection with a Copy/Select All context menu. Dragging selected text or images inside a full preview does not start a workspace file drop.

Common previewable content includes:

  • Common documents and spreadsheets
  • Images
  • Audio and some video files
  • Plain text, Markdown, code, and log files
  • File lists inside ZIP archives

For files that are not suitable for built-in preview, AIClue prompts you to open them with the system default app.

Markdown preview shows safe local content by default. Remote images, restricted local image paths, and unsafe links may not load directly. When an external link needs to be opened, confirm the prompt before using the system browser.

For the full support scope, see Appendix Supported File Formats and Data Notes.

6.3 Open Files in the System

If you need to edit a file or view it with professional software, open it with the system default app.

Common methods include:

  • Double-click the file row
  • Choose Open File from the file context menu or the details dropdown
  • Use the open button in the preview area

AIClue opens the original file. File content changes are made by the corresponding external app.

6.4 Open File Location

If you want to locate a file in the system file manager, use Open File Location.

This is useful when:

  • You need to copy, move, or rename the source file
  • You want to view other files in the same directory
  • You need to drag the file into another app

AIClue only asks the system file manager to locate the file. It does not modify the file automatically.

6.5 View File Path and Basic Information

The file list and preview area show basic file information, such as:

  • File name
  • File path
  • File type
  • File size
  • Created time or modified time

If you need to copy a file path, first select the file, then choose Copy full path from the dropdown at the top of the details panel. After copying, the path is placed on the system clipboard so you can paste it into chats, documents, or other tools.

6.6 Use Content Snippets to Judge Results

When the search mode and file type support content reading, search results may show text snippets around the keyword. These snippets help you quickly judge whether a result is relevant.

If you do not see a content snippet, possible reasons include:

  • The file type does not support content reading
  • The file was just added and background processing has not finished
  • The current mode is Filename
  • The file content is too long or failed to read

No snippet does not mean the file cannot be opened. You can still judge file content by file name, path, and preview.

6.7 Large Files and Files Without Preview Support

Large files, damaged files, or some special formats may not preview immediately. In this case, you can:

  1. Wait a moment for AIClue to finish loading
  2. Open the file with the system default app
  3. Locate the file in the system file manager and handle it there

For audio and video files, playback also depends on file size, encoding format, and system capabilities.

6.8 Safety Notes

Viewing, previewing, searching, and locating files in AIClue usually does not modify source files. Operations that may actually change file content or location usually happen in the system file manager or an external app, such as editing, moving, renaming, or deleting.

When later chapters involve cleaning duplicate files, moving files, or maintaining data, AIClue shows a clear prompt before performing the operation.

6.9 Next Steps

After you are familiar with file viewing and operations, continue with:

Chapter 7 Project Workspace

Project workspaces let you view and manage related files from different directories in one project. They do not move, copy, or modify source files. AIClue only creates a group of file references.

7.1 What Is a Project Workspace

Often, materials for one project are not stored in the same folder. For example, contracts may be in Documents, images on Desktop, spreadsheets in Downloads, and meeting notes in another folder.

A project workspace brings these files into one project for unified viewing later.

Project workspaces are useful when:

  • Materials for one client or case are scattered across multiple directories
  • An event or topic includes documents, spreadsheets, images, and other file types
  • You want to temporarily collect a group of related files without moving source files
  • You often need to open the same group of files

7.2 Enter Project Workspace

Click Project Workspace in the left sidebar to open the project management page.

The page shows currently available project cards. Each project card usually displays:

  • Project name
  • Number of files in the project
  • Recent use time
  • Entries for adding files, batch opening, and more operations

If the current account or trial state does not support the feature, the page shows a corresponding prompt.

7.3 Create a Project Workspace

To create a project workspace:

  1. Click New Workspace
  2. Enter a project workspace name
  3. Confirm

After creation, the project appears in the project workspace list. The project name cannot be empty and cannot duplicate another active project name.

7.4 Add Files

After a project is created, you can add files to it.

Common methods include:

MethodDescription
Add from project cardClick the add file button on the project card, then choose one or more files
Add from project pageOpen the project, then use the add file entry in the top bar
Add from file context menuRight-click a file and choose Add to workspace… or Create workspace and add…
Drag to addDrag files into AIClue and choose the project workspace to add them to
Drag and create projectWhen dragging files in, choose to create a new project workspace and enter a project name

Adding files only creates project associations. It does not move or copy files.

7.5 Open a Project

Click a project card to open the file list for that project. After opening, the Workbench shows files in the project.

In the project file list, you can:

  • View files included in the project
  • Further narrow the scope with tag or directory filters
  • Click a file to preview it
  • Double-click a file to open it with the system default app
  • Use the add file entry to keep adding files to the project
  • Right-click a file to add it to another workspace or remove it from the current workspace

Note: After a project is opened, the search box shows a project-name scope marker. The current version mainly uses this to enter the project file list. If you continue typing regular keywords, AIClue returns to the normal search flow.

7.6 Batch Open Files

Project cards provide a batch open entry, letting you open files in the project with the system default apps at once.

If the project contains many files, AIClue shows a confirmation prompt first to avoid opening too many files at once and affecting computer usage.

Batch opening is useful when:

  • You open the same group of work files every day
  • You need to open project materials quickly before a meeting
  • You want to check multiple related files at the same time

7.7 Rename a Project

If a project name needs adjustment, choose Rename from the project card’s more operations.

Renaming only changes the project name in AIClue. It does not change file names or file locations.

7.8 Dissolve and Restore Projects

If you no longer need a project, choose Dissolve from the project card’s more operations.

Dissolving a project only clears the project associations in AIClue. It does not delete source files. A confirmation prompt appears before dissolving.

Dissolved projects can be viewed in Workspace History and restored when needed. After restoration, the project appears in the project workspace list again.

7.9 Usage Tips

  • Use clear business names for projects, such as 2026 Contract Archive, Client Materials, or Thesis References.
  • If you only need to temporarily view files under one directory, use directory filtering first. If files come from multiple directories, use a project workspace.
  • Project workspaces are suitable for managing “sets of related files”. They are not a replacement for system folders.
  • Before dissolving a project, confirm that you no longer need this set of associations. Source files are not deleted, but the workspace is removed from the project list.

7.10 Next Steps

After you are familiar with project workspaces, continue with:

Chapter 8 Workbench and Function Cards

This chapter only explains how to enable, disable, adjust, and remove function cards in the Workbench. The specific features of each card are not explained here.

8.1 Relationship Between Workbench and Plugin Market

The Workbench is the main entry for everyday use. When there are no search or filter conditions, the Workbench shows enabled function cards.

The Plugin Market manages which cards appear in the Workbench:

  • After you enable a card in the Plugin Market, the card appears in the Workbench
  • After you disable a card in the Plugin Market, the card is removed from the Workbench
  • After you remove a card from the Workbench, you can enable it again later from the Plugin Market

If no cards are currently enabled in the Workbench, an add-card entry is shown. Clicking it opens the Plugin Market.

8.2 Enter the Plugin Market

Click Plugin Market in the left sidebar to view available function cards.

Cards in the Plugin Market usually show:

  • Card name
  • Whether it is currently available
  • Whether it is currently enabled
  • Supported system or availability prompt

If a card is shown as unavailable, locked, or unsupported on the current system, it cannot be enabled in the current environment. The specific reason may relate to system, account state, or feature access.

8.3 Enable or Disable Cards

Each available card in the Plugin Market has an enable switch.

OperationResult
Enable cardThe card appears in the Workbench
Disable cardThe card is removed from the Workbench

Card enabled state is saved on this computer. The next time AIClue opens, the Workbench tries to restore the cards you previously enabled.

8.4 Adjust Workbench Cards

After returning to the Workbench, you can adjust the position and size of enabled cards.

Common operations include:

  • Drag a card to adjust its position
  • Drag a card edge or corner to resize it
  • Use the card menu in the upper-right corner to lock the card and avoid accidental movement
  • Unlock the card to move and resize it again

Card layout is saved automatically. The next time you enter the Workbench, AIClue tries to restore the previous layout.

8.5 Remove a Card

If you no longer need a card, remove it from the Workbench.

Steps:

  1. Find the card in the Workbench
  2. Click the card’s more button in the upper-right corner
  3. Choose Remove Card
  4. Confirm in the confirmation prompt

Removing a card only makes it disappear from the Workbench. It does not delete your files and does not affect other cards. You can enable it again later from the Plugin Market.

8.6 Card Menu

Some cards provide more operations in the upper-right corner. Menus may differ between cards. Common operations include:

OperationDescription
Lock cardFix the card position and size to avoid accidental changes
UnlockAllow moving and resizing the card again
Remove cardRemove the card from the Workbench
Card-specific operationSome cards provide their own operations, such as refresh, settings, or hide

Card-specific operations are decided by each card. This chapter only explains card management and does not explain the specific features of each card.

8.7 Card Feature Notes

This chapter only explains how to manage function cards in the Workbench. It does not describe the specific feature of each card.

Different cards may work differently. If a later version provides separate instructions in the Plugin Market, card menu, or card page, use the instructions shown in that corresponding entry.

8.8 When a Feature Is Unavailable

If the Workbench or Plugin Market shows a feature as unavailable, possible reasons include:

  • The current account or trial state does not support the feature
  • A card requires additional feature access
  • A card does not support the current operating system
  • Local authorization state failed to load, and you may need to restart the app

When this happens, first check the prompt on the page. For account and feature access information, see Chapter 11 Account and Feature Access.

8.9 Next Steps

After you are familiar with Workbench card management, continue with:

Chapter 9 Tags and Classification

This chapter explains how to filter files with tags and how to manage file type classification in Settings.

9.1 Purpose of Tags and Classification

Tags and classification in AIClue are mainly used to narrow the file scope and help you find target files faster.

Common uses include:

  • Filter by file type, such as documents, images, videos, or archives
  • Narrow search results by existing tags
  • Exclude tag ranges you do not want to see
  • Adjust the relationship between file types and extensions

Tags and classification only affect display, filtering, and search scope in AIClue. They do not modify source files.

9.2 Filter Files by Tags

Tag filter entries usually appear in the top bar or the file list header. After opening the filter panel, you can choose tag ranges to include or exclude.

Common operations include:

OperationDescription
Select tagShow only files that match this tag range
Exclude tagHide files that match this tag range
Clear filterRestore a more complete file list

Tag filtering can be used together with keyword search and directory filtering. For example, you can search contract first, then view only document files within the results.

9.3 Include and Exclude

Tag filtering supports two directions:

  • Include: Show only files that meet the condition
  • Exclude: Hide files that meet the condition

Hold Shift and click a tag to set that tag as an exclusion condition. Click a selected condition again to cancel that filter.

If multiple conditions are set at the same time, the file list refreshes according to the current combination. Too many filters may result in very few or no results. In that case, clear filters first, then add conditions gradually.

9.4 File Type Classification

File type classification decides which category certain extensions belong to in AIClue. For example, some video extensions can belong to Video, while some spreadsheet extensions can belong to Documents or another custom category.

Entry path:

  1. Open Settings
  2. Go to File Types
  3. View or adjust categories and extension bindings

9.5 Add and Adjust Classifications

On the File Types page, you can add or adjust classifications as needed.

Common operations include:

OperationDescription
Add classificationAdd a new category in the file type tree
Add itemAdd a specific type under a category
RenameRename a custom category or custom item
DeleteDelete a custom category or item you no longer need
Restore defaultsRestore file type settings to the default state

Some built-in system categories may not be renameable or deletable. This prevents common file types from being classified incorrectly.

9.6 Bind Extensions

Click a file type item to edit the extensions bound to it. Separate multiple extensions with commas.

For example, a Video type can bind:

mp4, avi, mkv

After saving, newly scanned files are classified according to the new extension rules. For files that have already been recorded, if the classification display does not change, rescan the related directories in Directory Management.

9.7 Usage Tips

  • If you are unsure about classification rules, use the default settings first.
  • Add custom classifications only when truly needed, to avoid making filtering difficult.
  • Before changing extension bindings, make sure the extension does not include a dot. Write pdf, not .pdf.
  • If a type of file is often hard to find, check whether its extension is bound to a suitable classification.

9.8 Use with Search and Directory Filtering

Tags and classification are usually used with search and directory filtering:

  1. Enter a keyword first to find the rough result set
  2. Use directory filtering to narrow the location scope
  3. Use tags or file type filters to narrow results further

If there are too few results, remove filter conditions one by one to identify which condition is limiting the results.

9.9 Next Steps

After you are familiar with tags and classification, continue with:

Chapter 10 Finding Duplicate Files

AIClue can find files with identical content among scanned files and display them by group, helping you decide which copies can be cleaned up.

Duplicate detection only applies to files AIClue has recorded. After adding directories, wait for directory scanning to finish before opening the duplicate detection page.

10.1 Enter Duplicate Detection

Click Duplicate Detection in the left sidebar to enter the duplicate file detection page.

If you have checked for duplicates before, the page immediately shows the previous results and when they were last updated. Opening the page does not check again automatically. Choose Find Duplicates the first time, and Check Again whenever you want to update the results.

While results are updating, you can keep reviewing, filtering, and selecting files in the previous results. Cleanup and shortcut replacement become available again after the update finishes. If the update fails, the previous results remain available.

If the results finish updating but cannot be shown temporarily, the page asks you to reopen it later instead of continuing to show an old file list that no longer matches.

10.2 View Duplicate Results

After scanning finishes, if duplicate files are found, the page displays results by duplicate group.

The top statistics area shows:

InformationDescription
Duplicate groupsNumber of duplicate file groups currently found
Duplicate filesTotal number of duplicate files in the current results
Cleanable spaceApproximate space that can be freed if only one file is kept in each group

Each duplicate group shows the number of files, single-file size, and the list of files in the group. Click the group title to expand or collapse the group.

When results span multiple pages, the page separately shows the current and total pages for duplicate groups and files within a group, with direct page-number navigation. These controls stay hidden when there is only one page.

When an expanded group contains many files, scroll within the group first. Continuing at the top or bottom naturally returns scrolling to the full duplicate results list.

10.3 Filter Results by Type

The top of the duplicate results provides type filters. You can view:

  • All
  • Images
  • Videos
  • Documents
  • Archives

Type filtering only affects the current duplicate result display. It does not delete files and does not change original file classification.

If a category cannot be loaded temporarily, the previous results remain on screen so you can try again later.

10.4 Choose Files to Clean Up

On the duplicate detection page, checked files are copies that will be deleted. Unchecked files are kept.

You can choose files in two ways:

OperationDescription
Select manuallyExpand a duplicate group, then click file rows or checkboxes one by one
Smart selectLet AIClue automatically choose extra copies in each group according to the current keep rule

Note that each duplicate group usually needs to keep at least one file. If all files in a group are checked, the page shows a warning. Confirm carefully before cleaning an entire group.

Cleanup controls are temporarily unavailable while your selection is updating. If a selection cannot be completed, AIClue restores the current selection. If it cannot be confirmed, reopen the page before cleaning up files.

10.5 Set Keep Rules

The Smart Select operation in the action bar lets you choose a keep rule. After you choose a rule, AIClue automatically checks the copies recommended for cleanup in each group.

Current rules include:

RuleDescription
Keep first in orderKeep the first file in the list
Keep earliestKeep the file with the earlier created time
Keep latestKeep the file with the later created time
Keep shortest pathKeep the file with a shorter, easier-to-recognize path

If you are unsure which one to keep, expand the duplicate group first and review file path, created time, and modified time before acting.

10.6 Preview, Open, and Locate Files

After expanding a duplicate group, move the mouse over a file row to use the action buttons on the right side:

OperationDescription
PreviewView file content or details in the preview area
Open file locationLocate the file in the system file manager
Open fileOpen the file with the system default app

These operations help you confirm whether a file can be cleaned up before deletion.

10.7 Delete Selected Copies

After confirming your selection, click Delete Selected to clean up the currently checked files. Deletion affects real files and moves them to the system recycle bin.

AIClue checks each file again before cleanup. Files that changed after duplicate detection are skipped so an outdated result cannot clean up a changed file.

The dropdown next to Delete Selected also provides:

OperationDescription
Move to recycle binDelete checked copies and move them to the system recycle bin
Replace with shortcutDelete checked copies and try to create shortcuts in their original locations pointing to the kept file

After deletion completes, cleaned files are automatically removed from the current results without checking again. If some files fail to delete, the page shows the failure count and keeps the files that could not be cleaned up.

If cleanup is interrupted, AIClue synchronizes the completed portion. Review the current results before trying again.

Important: Although files are moved to the system recycle bin, this is still a real deletion operation. Preview files or open their locations to confirm before cleaning them up.

10.8 No Duplicate Files Found

If no duplicate files are found, the page shows No duplicate files found this time.

If you just added or moved files, return to Chapter 4 Directory Management and File Scanning, confirm that related directories have finished scanning, then run duplicate detection again.

10.9 Usage Tips

  • Start by cleaning duplicate groups that take up more space.
  • Be careful with files in work directories, project directories, and system directories.
  • If unsure, use Open File Location first to confirm the file’s purpose.
  • Keep at least one file in each group to avoid deleting all copies by mistake.
  • If you discover a mistake after deletion, restore the file from the system recycle bin as soon as possible.

10.10 Next Steps

After you are familiar with duplicate detection, continue with:

Chapter 11 Account and Feature Access

Use Account Center to sign in, check your plan, manage orders and devices, and send feedback. Your app’s valid authorization determines current access.

11.1 Enter Account Center

Choose the account icon at the bottom of the sidebar. Check your email when signed in, or sign in or register first.

11.2 Account Center Page

PageWhat you can do
My accountCheck email, plan and expiry; upgrade, renew, recover an order, refresh benefits and sign out
OrdersCheck original amounts and payment/refund states; open details and copy an order ID
Signed-in devicesIdentify this device and confirm removal of another device
FeedbackDescribe a problem or suggestion, attach images and choose whether to include diagnostics

Help opens the manual in your language in the default browser. Learn about Pro opens this chapter without creating an order. Free builds can read the guide but do not provide purchase or order-history access. Purchasing also depends on your account and whether sales are open.

View my account in text recognition or phone access settings opens My account, after sign-in if required. Back to text recognition settings and Back to phone access settings return to the original page without enabling a feature, buying anything or changing shared folders. Ordinary sidebar navigation clears this return context.

11.3 User State

Anonymous users have a default 15-day trial. Existing free features remain available after registration. My account shows current free or valid Pro access and its expiry, or asks you to refresh when access cannot be verified. Lifetime access is shown as Pro lifetime.

A failed refresh does not automatically downgrade valid Pro access. If there is no current Pro access, the app shows Free without inferring expiry or revocation from past orders. Purchasing does not enable features unavailable in your app version.

11.4 Feature Access

About Pro

  • Text recognition inside documents: Search text in images embedded in PDF, Word and PowerPoint documents.
  • Access computer files from your phone: Search, read and download files from folders you have allowed your phone to access.

Basic file search and basic OCR remain free. The 30-day and lifetime plans include the same current local Pro features. Both are one-time purchases with no automatic renewal. Phone uploads, automatic two-way sync and MCP have not been delivered and are not currently available Pro features.

In My account, select Learn about Pro or View Pro details to open the feature comparison on the AIClue website. Feature availability depends on your app version and account access.

Pro Purchases and Orders

When sales are open, choose Upgrade to Pro or Renew Pro in My account to go straight to plan selection on the AIClue website. Review the account receiving access, the prices, and the terms, then choose a plan and create the order. You can renew more than seven days before expiry using Renew Pro. The link becomes more prominent within seven days. Lifetime access does not require renewal.

Confirming a plan creates an order. Before starting payment with a provider, use “Cancel unpaid order and change plan” to choose again. After paying with WeChat or Alipay, query the original order and refresh benefits in the app. Returning to a web page does not confirm payment. If payment is unknown, do not pay again. Recover pending requests from older clients through the original order. Closing the page or app does not cancel a submitted payment or an approved refund.

Orders retain their original amounts and server pagination order, including small historical transactions. Open the row with a mouse or keyboard to view the product, method, access period, refund facts, original terms and order ID. Creation time is not payment time; when payment time is absent, details show Not provided. Copying the old ID is disabled while another detail loads. Normal refund explanations are kept in details rather than repeated on every row.

A paid order does not necessarily mean your overall Pro access is currently active. Details distinguish future, ended and revoked access; separate gifts may still provide access.

11.5 Log In, Register, and Reset Password

In My account, choose Log In, Register or Reset Password. Labels appear above their fields. Move the horizontal slider below the verification image to align the piece, then release it. Instructions below the rail do not cover the image.

Login requires email and password. For registration or reset, enter your email and complete verification before requesting an email code. Enter the six-digit code and your password twice. Passwords contain 8–20 characters including letters and numbers. Sign in with the new password after resetting it.

Leaving the login page clears the current puzzle verification. Complete a new challenge when returning; a visually completed slider is not retained without a valid answer.

11.6 Manage Signed-in Devices

The list shows the current device, names, platforms and last use. Expand Device ID to distinguish matching names. The current computer cannot remove itself. Sign Out in My account ends login without freeing its bound computer slot.

Removing another computer frees its slot. Confirmation identifies the name, ID, platform, last use and consequences. Cancelling removes nothing; an error preserves the list for retry. Browsers do not consume computer slots. Removal revokes login credentials, but existing offline access may continue within its validity and grace period; immediate revocation is not promised.

11.7 Paid but Pro Has Not Appeared

  1. Check the original order to confirm payment. Do not pay again while the result is unknown.
  2. Choose Refresh benefits in My account. A new web order may not return its ID to the app; account access can still be refreshed.
  3. If payment is confirmed but the access source is uncertain, query or refresh. If expected access is still missing after a successful refresh, contact support with the order ID.

A historical paid order alone does not prove that Pro should be active now. Network errors preserve trusted state and allow retry. Sign in again if your session has expired. A damaged purchase-recovery record does not block independent benefit refresh.

Why Lifetime Access Still Needs Online Verification

Lifetime has no subscription end date, but periodic online verification still checks account and authorization state. Existing rules cover current and future local Pro features in the same product line; separate products and separately offered cloud services are not automatically included. Lifetime is purchased at full price without credit for previous 30-day payments. Refer to the terms displayed when purchasing.

11.8 Log Out

Choose Sign Out at the bottom of My account. This does not free a bound computer slot. Available features afterward depend on current valid authorization and the app’s prompts.

11.9 What to Do When a Feature Is Unavailable

Check whether your version supports the feature, then check sign-in and valid access and refresh if necessary. Neither a network failure nor an unsupported version is fixed merely by purchasing Pro. Check signed-in devices if slots are full, or read the FAQ.

11.10 Support, Refunds and Feedback

For purchases, refunds or account support, contact aiclue@boxai365.com with your account and order ID, never passwords or verification codes. Ordinary feedback is not a support or refund application. The app has no self-service refund button.

After support acceptance and administrator review, eligible paid Pro orders whose access has not ended at the recorded acceptance time, including future periods, are refunded in full to their original methods. Independent gifts and compensation remain. New purchases pause during processing and resume after completion. Eligibility, time limits and formal policy follow support verification and purchase terms; this guide creates no additional commercial promise.

Feedback stays in the app. Select Problem or Suggestion, enter up to 5,000 characters, and optionally paste or select PNG, JPEG, WebP or BMP images: up to five, 10 MiB each and 30 MiB total.

The visible diagnostics option controls upload: selected by default for problems, unselected for suggestions. After a manual choice, switching type does not override it. Open the privacy policy for details. Anonymous feedback asks for a puzzle after preparing the submission; upload starts only after completing the drag. Failure retains the draft for retry; success shows a feedback ID. Do not send payment passwords, verification codes or refund instructions through this form.

11.11 Next Steps

Chapter 12 Settings and Maintenance

The Settings page lets you adjust common AIClue behavior and clear saved search information when needed. Cleanup operations may affect search results or added folders, so confirm their effect before continuing.

12.1 Enter Settings

Click the Settings icon at the bottom of the left sidebar to open the Settings page. The left side of the Settings page contains these tabs:

TabPurpose
General SettingsLanguage, startup, tray, and file browser display
Phone linkChoose folders, enable access, add phones, and manage pairing and browser sign-in; see Chapter 14
AppearanceChoose the interface mode and set light and dark themes separately
Privacy SettingsBehavior logging and data cleanup
File TypesManage file type classification and extension bindings
Scan ExclusionsChoose folders and files to leave out of file lists and search

12.2 General Settings

General Settings lets you adjust startup and window behavior.

SettingDescription
Display languageSwitch interface language
Start on bootStart AIClue automatically when the computer starts
Minimize to trayKeep AIClue in the system tray when the window is minimized
Close to trayKeep AIClue running in the background when you click the close button
Global wake shortcutBring the window back and focus it while AIClue is in the background or system tray
Show hidden files in file browserShow hidden files and system files in the path browser

The default global shortcut is Alt+C. You can turn it off, change it, restore the default, and check whether it is enabled. If a new shortcut cannot be used or another app already uses it, AIClue keeps the previous shortcut. Pressing it while the window is focused in the foreground hides it to the tray. Otherwise it restores and focuses the window, keeping the current page; a closed window reopens on the main screen. The shortcut does not start a search.

The Incoming card settings now use one watched-folder list for system presets and manually added paths. Preset folders can also be removed and added again; removed folders are not automatically re-enabled. Upgrades preserve previous enabled and disabled choices.

The system tray menu contains these entries:

EntryWhat it does
Open AIClueRestore an existing window and keep its current page, or reopen the main screen if the window was closed
Quick SearchRestore the window, open file search, and select the search box
SettingsRestore the window and open Settings
Quit AIClueUse the existing confirmation before exiting AIClue

Left-clicking the tray icon works like Open AIClue. Only Quick Search opens file search, so it is different from Alt+C.

Choose Quit AIClue from the tray menu to open the quit confirmation. If you choose Keep Running, you can restore the window from the tray later. AIClue tries to restore a missing Windows tray icon. The main window opens if the tray is unavailable at silent startup or if the icon stays unavailable while AIClue runs in the background.

The top bar keeps a theme shortcut. For more control, use Appearance to choose system, light, or dark mode and select themes for light and dark modes separately.

12.2.1 Image text recognition

Image text recognition is off by default and can be enabled in Settings → Image text recognition. The model ships with the app and runs offline. No separate model download or source-file upload is required.

Under Hardware acceleration on the same page, choose Automatic to let AIClue try GPU acceleration on compatible Windows devices. AIClue continues recognition on the CPU if GPU acceleration is unavailable. Choose No hardware acceleration to always use the CPU.

When this build supports recognition within documents but the account lacks access, use View my account. Authorization that needs verification offers Refresh benefits; signed-out users sign in first. Return from the account page to the same settings tab without automatically enabling recognition. Narrow windows use horizontally scrolling settings tabs, keep the active tab visible, and scroll content separately.

AIClue processes ordinary text first, then images, PDF pages, and pictures in DOCX, PPTX, and XLSX files. Recognized text becomes searchable. Each image’s recognized text is enclosed by triple-backtick fences in the text preview. Results depend on image clarity, text size, and layout.

Turning the feature off retains recognition results, stops further recognition, and updates the search index. Wait for Updating image text search to finish before checking that image text is excluded. Turning it on again reuses results that are still valid.

An individual image failure does not affect ordinary text search. File details show partial recognition and provide a retry action for failed images. Text exceeding the search text budget is reported separately. Unsupported encodings such as EMF and WMF are reported as recognition failures; source files are not modified.

12.3 Appearance

The Appearance page controls the interface mode and theme. With System selected, AIClue follows the system light or dark mode. You can also keep the interface in light or dark mode.

Light and dark themes are saved separately. When you switch modes, AIClue uses the theme selected for that mode.

12.4 Privacy Settings

Privacy Settings includes behavior logging and local data cleanup.

12.4.1 Behavior Logging

Behavior logging is used to improve the in-app experience and recommendation effects. You can choose a recording level:

LevelDescription
OffDo not record behavior
LowRecord only file clicks inside the app
MediumRecord target app names during drag-and-drop
HighRecord external window titles for more complete usage scenario analysis

If behavior logging is enabled, you can fill in app names you do not want recorded in the App blacklist. Separate multiple app names with commas, such as keepass,1password,wechat.

12.4.2 Desktop Activity Analytics

While the AIClue process is running, it automatically reports daily activity. Signed-out activity is counted by anonymous installation and signed-in activity is counted by account. This provides total, account, and signed-out activity trends. Activity before and after sign-in may be counted separately, so the total is not a strictly deduplicated person count. Each identity type is recorded successfully at most once per UTC date. This analytics behavior has no off switch.

When signed in, the account identity is confirmed by the existing login credential. The report does not include the host name, files, paths, search content, feature clicks, usage duration, or hardware information. Clear all data inside the app does not change the anonymous installation number used for signed-out analytics. For the complete processing scope and 60-day retention rule, see the AIClue Privacy Policy.

12.5 Data Management

Data management operations are provided near the bottom of the Privacy Settings page. A confirmation prompt appears before execution.

OperationScope
Clear AI analysis resultsClear file summaries and keywords, while keeping added directories and file records
Clear Search DataClear scanned files, tags, and duplicate results while keeping app settings; you can scan your folders again afterward
Clear all dataClear file records, directories, project workspaces, and user settings
Reset main settings to defaultsRestore managed main settings to defaults; this is not a file cleanup entry

These operations do not actively delete source files on disk, but they affect results shown inside AIClue. After clearing data, rescan related directories if you need to continue using search and filtering.

Important: Data management operations cannot be undone. Confirm that you no longer need these records before continuing.

12.6 File Type Settings

The File Types page manages file classification and extension bindings. For example, you can adjust whether certain extensions belong to documents, images, videos, or custom categories.

For detailed file type operations, see Chapter 9 Tags and Classification.

12.7 Scan Exclusions

The Scan Exclusions page controls which folders and files AIClue leaves out of search. It affects newly checked files and may also remove matching files from existing results.

12.7.1 Scan Exclusion Switches

The top of the page provides common switches:

SwitchDescription
Ignore hidden foldersSkip hidden folders during scanning
Ignore removable drivesSkip removable drives such as USB drives
Ignore network locationsSkip folders shared over a network
Ignore hidden filesSkip hidden files
Ignore system filesSkip system files

If you need to add a removable drive or network location, first confirm that the corresponding switch allows scanning that type of path.

To exclude files and folders that match a project’s .gitignore, turn on Respect Git ignore rules in Settings → Scan Exclusions and save. This option is off by default and works without Git installed. The rules also apply to files tracked by Git. When rules change, AIClue automatically updates the affected search data and leaves your original files and .gitignore intact. Use Path Check below to see whether a path matches a rule.

12.7.2 Exclusion Types

Scan exclusion settings can come from three places:

SourceDescription
Protected rulesBuilt-in protections for important locations, such as system directories, the Windows system drive root, and the AIClue app directory. These rules cannot be modified
Default rulesCommon default exclusions provided by AIClue, such as cache folders or dependency folders
Custom rulesRules you add or edit yourself

Protected rules are used to reduce accidental scanning of system or app directories. In normal use, you only need to adjust default rules and custom rules.

12.7.3 Directory, Path, and File Rules

You can add these types of custom rules:

TypeDescription
Folder name ruleExclude folders with a specified name, such as a temporary folder
Selected location ruleExclude one selected location and everything inside it
Filename prefix ruleExclude files whose names start with a specified prefix
Extension ruleExclude files with specified extensions

Directory rules only affect folders. Filename prefix and extension rules only affect files.

After you save rules, AIClue may show a confirmation prompt. Stricter rules may clean up existing records that are now excluded. Looser rules may trigger a background rescan so matching files can appear again later.

12.7.4 Path Check

The Path Check tool helps you confirm whether a file or folder location will be searched:

  1. Open Settings > Scan Exclusions.
  2. Enter or paste a file or folder location in Path Check.
  3. Check whether AIClue says the path will be scanned or excluded.
  4. If the path is excluded, review the matched rule and decide whether the rule needs to be adjusted.

Directory Management still shows directory status and scan warnings. Rule editing and path checking are handled on the Scan Exclusions page in Settings.

For more directory operations, see Chapter 4 Directory Management and File Scanning.

12.8 Updates and Version

AIClue shows the current version number in the bottom status bar.

If a new version is detected, the interface shows an update prompt. You can handle it later or upgrade immediately. If the update package is ready, you can also click Restart now to install update at the top of the Settings page.

12.9 Maintenance Tips

  • When directory contents change often, rescan related directories in Directory Management first.
  • When search results are clearly unexpected, first confirm that directory scanning has finished, then consider clearing search data.
  • After changing file types or scan exclusion rules, if old file results do not change, rescan related directories or wait for the background rescan.
  • Before clearing all data, confirm that you no longer need current directory, project workspace, and settings records.

12.10 Next Steps

After you are familiar with settings and maintenance, continue with:

Chapter 13 FAQ and Troubleshooting

This chapter collects common AIClue questions and troubleshooting methods. When you encounter a problem, first confirm that directories have finished scanning, then check the current search, filter, account, and settings states.

13.1 Installation and Startup

Q: Where can I download AIClue?

Download the Windows installer from the AIClue download page.

Q: What should I do if AIClue cannot start after installation?

Check in this order:

  1. Confirm that the computer has enough free space.
  2. Restart the computer and open AIClue again.
  3. If the system shows a security block, confirm that the installer source is trusted, then allow it to run according to the system prompt.
  4. If it still cannot start, record the error message for later troubleshooting.

If the prompt says the current runtime environment is not suitable, install and run the app on the computer’s internal drive first.

13.2 Directories and Scanning

Q: Why does the file list not appear after I add a directory?

After a directory is added, AIClue starts scanning automatically. If there are many files, results may take some time to appear gradually.

Check:

  1. Enter Directory Management from the left sidebar and confirm that the directory is in the list.
  2. Check whether the directory is still scanning.
  3. Wait for background processing to finish, then return to the Workbench.

For more information, see Chapter 4 Directory Management and File Scanning.

Q: Why did adding a directory fail?

Common reasons include:

  • The directory does not exist, or the current user does not have access permission.
  • The directory has already been added, or it overlaps with an added parent or child directory.
  • On Windows, the selected path is the system drive root, an important system directory, or the AIClue app directory.
  • The selected path is on a network location or removable drive, and the corresponding scan exclusion switch is enabled.

On Windows, a non-system fixed drive root can be added. AIClue still skips protected or excluded subfolders during scanning. If you are unsure whether a location can be scanned, use Settings > Scan Exclusions > Path Check.

Q: Why were some files not scanned?

Common reasons include:

  • The directory containing the file has not been added to the directory list.
  • The file is under a path or file type covered by scan exclusion rules.
  • The file is inside a hidden folder, network path, removable drive, system location, or other area skipped by scan exclusion switches.
  • The file type is not in the current support scope.
  • The file is occupied by the system or another program and cannot be read temporarily.
  • The file was just added and background processing has not completed.

If you confirm the file should be scanned, use Settings > Scan Exclusions > Path Check to check its location first. After adjusting settings if needed, rescan the related folder in Directory Management, or wait for AIClue to finish checking again.

Q: Does removing a directory delete files on disk?

No. Removing a directory only makes AIClue stop managing records for that directory. It does not delete source files on disk.

13.3 Search and Filtering

Q: What should I do if I cannot find a file?

Troubleshoot in this order:

  1. Confirm that the directory containing the file has been added and scanned.
  2. Try searching with a short keyword from the file name first.
  3. Clear tag filters, directory filters, and exclusion conditions, then try again.
  4. Check whether the file is excluded in Settings > Scan Exclusions > Path Check.
  5. Check whether this file type is within the support scope.
  6. If the file was just modified or moved, rescan the related directory.

Ordinary keywords must contain at least two characters. A single letter, number, or Chinese character does not start a keyword search. Entering a file or folder location on your computer opens location browsing, and entering @ shows project workspace suggestions.

Search modes and filter entries are explained in Chapter 5 Search and Filtering.

Q: Why are there fewer search results than expected?

Filter conditions may be limiting the results. Check these items in the top bar or file list header:

  • Tag filter
  • Directory filter
  • File type filter
  • Current search mode

If you are unsure which item is affecting results, clear all filters first, then add conditions one by one.

Q: Why are there more search results than expected?

Try:

  • Use a more complete keyword.
  • Switch search mode.
  • Add directory filters or tag filters.
  • Use file type filtering to narrow the scope.

13.4 File Viewing and File Operations

Q: What should I do if a file cannot be previewed?

Possible reasons include:

  • The current file type does not support built-in preview.
  • The file is large and needs more time to load.
  • The file is damaged, encrypted, or requires dedicated software.
  • The file has been moved, deleted, or occupied by another program.

Try using Open File to open it with the system default app, or use Open File Location to confirm that the file still exists.

Q: Why is copy path not in the more menu?

The copy path entry is at the top of the preview area after you select a file. The file list more menu currently mainly provides operations such as opening the file and reading its content again.

Q: What does reading file content again do?

When file content has just changed, preview information is incomplete, or search results have not updated yet, you can ask AIClue to read that file again. Large files may take some time to process.

13.5 Tags, Classification, and File Types

Q: How do I exclude a type of file with tag filtering?

In the tag filter panel, hold Shift and click a tag to set that tag as an exclusion condition. Click a selected condition again to cancel the filter.

Q: Why did old files not change after I changed file type settings?

Newly scanned files are classified according to the new extension rules. For files that have already been recorded, if the classification display does not change, rescan the related directories in Directory Management.

For more information, see Chapter 9 Tags and Classification.

13.6 Finding Duplicate Files

Q: Why were no duplicate files found?

Possible reasons include:

  • Directory scanning has not finished.
  • The directory containing duplicate files has not been added to AIClue.
  • The file content is not exactly the same, even if file names are similar.
  • The current type filter hides some duplicate results.

Clear the type filters on the duplicate detection page, then choose Check Again.

Q: Are checked files kept or deleted on the duplicate detection page?

Checked files are copies that will be deleted. Unchecked files are kept.

Before deleting, expand duplicate groups and confirm that each group keeps at least one needed file.

Q: Can I restore files after duplicate cleanup?

Duplicate cleanup moves selected files to the system recycle bin. If you discover a mistake, restore them from the system recycle bin as soon as possible.

13.7 Account and Feature Access

Q: What should I do after the anonymous trial ends?

Open Account Center to register or log in. Account Center shows the current user state, remaining trial time, and available features.

Q: What should I do if a feature is unavailable?

Handle it in this order:

  1. Enter Account Center and check the current user state.
  2. Click Refresh benefits to update feature access.
  3. If the prompt says login state expired, log in again.
  4. If the prompt says the account service cannot be reached, check the network and try again later.

For more information, see Chapter 11 Account and Feature Access.

Q: What should I do if I forgot my password?

Open the Account tab in Account Center and select Reset Password. Enter your email and complete the security verification shown on the page, then click Send verification code. After you receive the code, enter and confirm a new password. Request another code if the current one is invalid or expired.

13.8 Settings and Maintenance

Q: Does clearing search data delete source files?

No. Clearing search data only clears the file records saved by AIClue. It does not delete source files on disk. After clearing, rescan related directories if you need to continue searching these files.

Q: What does clearing all data affect?

Clearing all data clears file records, directories, project workspaces, and user settings. This operation cannot be undone. Confirm that you no longer need these records before running it.

Q: Why did old results not change immediately after I changed file types or scan exclusion rules?

Some settings first affect later scans or later file changes. If scan exclusion rules become stricter, AIClue may clean up existing records that are now excluded. If rules become looser, matching files may need a background rescan or a manual rescan before they appear again. If file type changes need to apply to existing files, rescan related directories in Directory Management or wait for the background rescan to finish.

Q: How can I reduce background resource usage?

When there are many files, wait for the current scan to finish before running other heavy tasks. If search results are still changing, check directory scan status before repeatedly clearing data and rescanning.

13.9 Uninstall and Data

Q: How do I uninstall AIClue?

In Windows, open Settings > Apps > Installed apps, find AIClue, choose Uninstall, and follow the prompts. If you also no longer need AIClue’s saved folders, search history, and settings, first clear all data in Settings > Privacy Settings > Data Management.

Q: Does uninstalling delete scanned source files?

No. AIClue manages file records and search data. It does not delete source files on your disk because of uninstallation.

Q: Where is AIClue data stored?

AIClue saves directory records, settings, search data, and some usage state on this computer. For full details, see Appendix Supported File Formats and Data Notes.

13.10 What If the Problem Still Cannot Be Solved?

If the methods in this chapter still do not solve the problem, record:

  • Current operation steps
  • Error message shown
  • Whether you just added directories, changed settings, or updated the app before the problem appeared
  • Related file type and directory

This information helps locate the problem faster.

Chapter 14 Accessing Computer Files from Your Phone

Mobile access lets you search, read, and download allowed files while away from your computer. The computer must be awake, online, and running AIClue. This feature cannot wake it remotely.

In versions with phone access available, the same account needs active Pro; sync access on the computer first. Both 30-day and lifetime Pro include current search, text reading and downloads, with the initial necessary connection and relay service. Purchasing does not activate the feature in versions where it is unavailable. Online access stops through existing access checks after expiry or refund. You can still close access and manage existing logins.

If Pro ends or phone access is unavailable in the current version, the page shows “Phone access is paused”. You can still turn off the saved access switch. Once turned off, access stays off after Pro returns until you explicitly turn it on again.

If current authorization does not allow phone access, choose View my account to check the account; sign in first if needed. Back to phone access settings returns here without changing the access switch or shared folders. An unavailable build or a network fault is not presented as something purchasing will fix.

14.1 Enable Access on Your Computer

  1. Sign in to AIClue on your computer and open Settings → Phone link.
  2. Enable the managed folders you want to make available, then turn on phone access. If access is unavailable or no folders are selected, the switch explains why and leaves access off.
  3. Optionally change the computer name so you can recognize it on your phone. Use Restore default to return to the automatic name.
  4. Choose Add phone to open a five-minute pairing window on your computer. Open the provided link on your phone or scan the URL QR code, then sign in to the same account. The code opens the website; it does not sign you in or grant file access.
  5. Select the computer on your phone and choose Start pairing. Compare all six digits on both devices. If they match, confirm on your phone, then approve on your computer; cancel if they differ. Connect after pairing succeeds. A paired browser normally does not need to compare numbers again. Closing the pairing window keeps existing pairings.

Search and download are limited to files managed by AIClue within the allowed folders. Turning off a folder or mobile access may end the connection and require reconnection. Files already saved on your phone cannot be recalled.

14.2 Sign In and Return Later

Open AIClue mobile access in your phone’s browser, sign in with the same account as your computer, and select a computer to connect.

Keep me signed in on this browser is off by default. Without it, refreshing the same tab can restore your session, while a new page session requires sign-in. Restoring an old tab may preserve its page session. Enable persistent sign-in only on a phone you trust. Different browsers and installed windows may use separate sign-in storage, so the first launch may require signing in again.

Restoring sign-in refreshes the computer list. It does not connect automatically. If a computer is offline, check that it is awake, running AIClue, and online. Some restricted networks may prevent connections.

Connection progress can be cancelled. If the connection ends, restore the network or computer, then retry from the current page without switching computers first. The direct or relay label describes the current connection path; it does not grant additional access or guarantee connectivity on every network.

14.3 Search, Read, and Save

After connecting, search by file name, text, or the combined search option. Locations, dates, and snippets help distinguish files with the same name.

Computers that support reading provide Read text. This displays extracted text rather than the full Office layout. Continue reading long documents and return to the retained search results. If the file or access permissions change, search again.

Keep the page in the foreground while downloading. Files can be up to 50 MiB, with one download at a time. Once received, choose Save file or, when available, Share, then select a destination or another app in the system interface. Receiving a file does not save it automatically. Starting a save or share action does not confirm that the other app finished processing it.

Switching apps, locking the screen, or leaving the page may interrupt an unfinished download. Download again after returning; persistent resume is not supported. Downloading the original does not require readable extracted text. Phone-to-computer uploads, automatic two-way synchronization, folder browsing, and batch transfers are not available.

14.4 Add AIClue to Your Home Screen

The sign-in page and account menu both include Add to Home Screen.

  • Android Chrome: choose Install or Install app when offered to open AIClue in its own window. Choose Create shortcut if you prefer to open it in the browser.
  • iPhone or iPad: choose Add to Home Screen from the Share menu in a supported browser. If Open as Web App is shown, you can turn it on before adding. Try Safari if the option is missing.
  • vivo Browser may use a different home screen icon. Chrome installation is an alternative. Adding a shortcut does not guarantee a standalone window.

Automatic reminders appear at most once per tab session. Later prevents another reminder when you refresh. Don’t remind me again saves only a reminder preference; it does not confirm installation. The account menu retains the instructions. Installation does not provide offline search or background downloads.

14.5 Manage Phones and Browsers

On your computer, open Settings → Phone link → Phones and browsers to check pairing and sign-in separately. Signing in does not grant pairing, and a record does not mean the device is online. Refresh before acting on an unconfirmed status.

Open Manage for the relevant record and choose the action you need:

  • Revoke file access removes that browser’s pairing authorization for this computer. Access requires pairing again; other browsers remain paired.
  • Sign out browser ends account sign-in on all AIClue pages in that browser. The account password is required again. This does not replace revoking file access. Other browsers and computers remain signed in.

If you lose a phone or stop using a browser, revoke file access and sign out as needed. Manage files already downloaded separately on the phone or in the receiving app.

Appendix Supported File Formats and Data Notes

This appendix explains AIClue’s support scope for file records, content search, built-in preview, and local data storage. The support scope differs by capability: a file that can appear in the file list may not necessarily support content reading or built-in preview.

A.1 File Record Scope

After you add a directory, AIClue scans regular files in the directory and records information such as file name, path, size, time, and file type.

These files may not enter results, or may be skipped:

  • Files or directories covered by scan exclusion rules
  • Files inside the app’s own directory
  • Temporary downloads, temporary cache, or system cache files
  • Files that cannot be read, are damaged, or are restricted by system permissions
  • Files occupied by another program and temporarily unreadable

If a file can enter the file list, it can usually be found or filtered by file name, path, directory, and file type. Whether it can be searched by content depends on whether the file supports content reading.

A.2 File Type Classification

AIClue binds file type classifications based on extensions. Default classifications include:

ClassificationCommon extension examples
Word documentsdoc, docx, wps, odt
Spreadsheetsxls, xlsx, xlsm, xlsb, et, csv, ods
Presentationsppt, pptx, odp
PDFpdf
Plain texttxt, md, markdown, rtf
E-booksepub, mobi, azw3
Design filespsd, ai, sketch, fig, xd, dwg, dxf
Mind mapsxmind, mm, emmx, enex, opml
Imagesjpg, jpeg, png, gif, bmp, webp, svg, ico, tiff, tif
Audiomp3, wav, flac, aac, ogg, wma, m4a
Videomp4, avi, mkv, mov, wmv, flv, webm, m4v
Archiveszip, rar, 7z, tar, gz, bz2, xz
Code filesjs, ts, jsx, tsx, vue, py, java, cpp, c, rs, go, php
Config and data filesjson, xml, yaml, yml, toml, ini, conf, sql, sqlite, db
Certificate-related filespem, crt, key

File type classification can be adjusted on the File Types page in Settings. After extension bindings are changed, newly scanned files use the new rules. If recorded files do not change, rescan the related directories.

Content search means AIClue can try to read file content and use readable text for search.

Current common supported types include:

TypeExtensions
Text documentstxt, md, rtf, log, csv
Config and web textjson, html, css
Code filesjs, ts, vue, rs, py, java, c, cpp, go, php
Word documentsdocx, doc
Spreadsheetsxlsx, xlsm, xlsb, xls, et, ods
Presentationspptx, ppt
E-booksepub
PDFpdf

The following situations may cause content reading to fail or be incomplete:

  • The file is too large and exceeds the current version’s reading limit
  • The file is damaged, encrypted, or password-protected
  • The file format does not match its extension
  • The file mainly contains images or scanned pages whose text recognition has not completed, or unreadable binary data
  • The file is occupied by another program and cannot currently be read

When content reading fails, the file may still appear in the file list, but content search will not match its text.

For English and mixed Chinese-English content, AIClue supports searches with Chinese or English keywords. Uppercase and lowercase English letters do not affect matching, and results closer to a longer English phrase generally appear earlier. Actual results still depend on whether the file type supports content reading and whether the file has been scanned successfully.

A.4 File Types That Support Built-in Preview

Built-in preview means the file can be opened directly in the AIClue preview area. Current common support includes:

TypeExtensions
PDFpdf
Word documentsdocx
Spreadsheetsxlsx, csv, tsv
Presentationspptx
Imagesjpg, jpeg, png, gif, webp, avif, svg, bmp, ico
Audiomp3, wav, flac, aac, ogg, opus, oga, weba, m4a
Videomp4, m4v, webm, ogv, mov, flv, ts, mkv, m2ts
ZIP archiveszip, showing the file list only
Text and codetxt, md, markdown, json, xml, html, css, js, ts, tsx, jsx, vue, py, java, c, cpp, h, rs, go, cs, csv, log, ini, env, rtf, sh, bat, cmd, ps1, yaml, yml, toml, sql, php, rb, swift, kt, kts, dart, scala, mjs, cjs, cts, mts, conf, properties

Some files may prompt you to open them with the system default app, for example:

  • avi, wmv, rmvb
  • heic, tif, tiff
  • psd, ai, cdr, sketch
  • Older Office documents, such as doc, xls, ppt, and wps

Preview support is also affected by system capabilities, file encoding, whether the file is damaged, audio/video encoding, and other factors. If preview is unavailable, use Open File to open the file with the system default app.

Markdown preview restricts remote images, restricted local image paths, and unsafe links to protect local content. Confirm the prompt before opening an external link.

A.5 Relationship Between Search Data and Source Files

AIClue saves local data used for search and filtering, but it does not move source files into the app.

Common data includes:

DataPurpose
Directory listRecords which scan directories you have added
File recordsSaves file name, path, size, time, extension, and classification information
Content search dataSaves processed text from readable files for content search
Tag and classification dataSaves file type tags, filter relationships, and custom classifications
Project workspace dataSaves project workspace names, states, and associated files
SettingsSaves language, startup, tray, privacy, file type, and scan exclusion settings
Search historySaves searched keywords for search suggestions
Duplicate detection helper dataSaves records needed to identify duplicate files
Account stateSaves login state, sync time, and feature access state on the current device

This data allows AIClue to complete search, filtering, preview, duplicate detection, and workspace management on your computer.

A.6 Behavior Logging Data

If behavior logging is enabled in Settings, AIClue may save some usage behavior on this computer to improve recent files, Workbench cards, or related feature effects.

Behavior logging level can be adjusted in Settings > Privacy Settings:

  • Off: Do not record behavior
  • Low: Record file clicks inside the app
  • Medium: Record drag-and-drop target app names
  • High: Record external window titles

If behavior logging is enabled, use the app blacklist to exclude apps you do not want recorded.

AIClue file scanning, content reading, and regular search are completed on your computer.

These features may require a network connection:

  • Account login, registration, and access synchronization
  • Checking or installing software updates
  • Online download channels or services that may be added later

File content is not automatically uploaded because you add a directory or run a local search. Network requests related to accounts or updates are only used to complete the corresponding feature.

A.8 Clearing and Uninstalling

In Settings > Privacy Settings > Data Management, you can clear some local data:

OperationDescription
Clear file analysis resultsClear file summaries and keywords, while keeping folders and file records
Clear Search DataClear file records and tag data, while keeping app settings
Clear all dataClear directories, file records, project workspaces, and user settings

These operations do not actively delete source files on disk. Uninstalling the app also does not delete source files that you originally stored in each directory. If you no longer need AIClue’s saved folders, search history, and settings, clear all data in Data Management before uninstalling the app.