AIClue User Manual
Version: 26.8.12
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
| Feature | What it helps you do |
|---|---|
| Fast search | Search file names and common document content, with matching snippets to help you judge relevance |
| File filtering | Narrow results by file type, created time, modified time, directory, and other conditions |
| File preview | Preview 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 workspace | Place related files from different directories into the same workspace for project-based viewing and opening, without changing the source file locations |
| Duplicate file detection | Find files with identical content, so you can decide which copies can be moved to the system recycle bin |
| Related files | Continue from a file to view files in the same folder or with similar content, helping you complete a set of materials |
| Workbench cards | Enable the cards you need and keep everyday file tasks together on the Workbench |
| Account and access | Support 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
| Platform | Minimum | Recommended |
|---|---|---|
| Windows | Windows 10 64-bit, 4GB RAM | Windows 10/11 64-bit, 8GB+ RAM |
| Disk | 500MB free space (app + search data) | 1GB+ free space |
| Network | Required for downloading the app, automatic updates, account login, and access synchronization | Daily 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:
- Open Directory Management in the sidebar.
- Select Add Directory.
- Choose a folder in the system dialog and confirm.
- 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
| Area | What it does |
|---|---|
| Sidebar | Opens the Workbench, Project Workspaces, Plugin Market, Duplicates, Directory Management, Account, and Settings |
| Top bar | Lets you enter keywords, choose a search mode, filter by tags or folders, and change the theme |
| Main area | Shows Workbench cards, file lists, search results, previews, project content, or settings |
| Status bar | Shows 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.
2.6 Your first search
- Select the search box in the top bar.
- Enter at least two characters, such as
contract,report, orinvoice. - Press Enter or select the search button.
- Review file names, locations, and text snippets in the result list.
- 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: learn the common areas and actions.
- Chapter 4 Directory Management and File Scanning: manage folders and exclusions.
- Chapter 5 Search and Filtering: find files more precisely.
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:
| Area | Purpose |
|---|---|
| Left sidebar | Switch major feature entries, such as Workbench, Project Workspace, Plugin Market, Duplicate Detection, Directory Management, Account, and Settings |
| Top bar | Enter search keywords, switch search modes from the left side of the search box, use tag or directory filters, and switch theme |
| Main content area | Show the current entry’s content, such as function cards, file lists, search results, file preview, or settings pages |
| Bottom status bar | Show 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:
| Entry | Description |
|---|---|
| Workbench | Main everyday entry. Used to view function cards, search results, file lists, and previews |
| Project Workspace | Manage files from different directories by project |
| Plugin Market | Enable or disable function cards that can be placed in the Workbench |
| Duplicate Detection | Find files with duplicate content and help clean up extra copies |
| Directory Management | Add, remove, rescan, or manage scan directories |
| Account | View login status, available features, and related prompts |
| Settings | Adjust 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.
3.3.1 Search Box
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 view its preview or details. Right-click a file to use operations such as opening, locating, or copying the 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:
| Information | Description |
|---|---|
| File count | Keyword search shows the current search mode and result count; total file count is shown as secondary information |
| Background processing progress | Processing progress while scanning directories or reading document content |
| Result update prompt | Prompts you to refresh when background file changes may affect the current results |
| Version number | Current 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
| Operation | Method |
|---|---|
| Search files | Enter a keyword in the top search box and press Enter |
| View a file | Click the file in the file list |
| Open a file | Double-click the file, or choose open from the context menu |
| Locate a file | Choose open file location from the context menu |
| Copy path | Choose copy path from the context menu |
| Switch feature entry | Click the corresponding entry in the left sidebar |
| Change theme | Use the theme button in the top bar |
| Show or hide the window | Press 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 tray | Right-click the AIClue tray icon and select Quick Search |
Press Esc to leave one layer at a time: full 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: Learn how to add and manage scan directories
- Chapter 5 Search and Filtering: Learn how to find files faster
- Chapter 6 File Viewing and File Operations: Learn preview and file operation methods
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:
- Click Add Directory
- Choose a folder in the system folder picker
- After confirmation, the directory appears in the directory list
- 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:
| Information | Description |
|---|---|
| Directory path | The directory’s location on your computer |
| File count | Number of files AIClue currently records |
| Processing state | Whether files are currently being scanned or processed |
| Last scan time | The 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.
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:
| Operation | When to use it |
|---|---|
| Scan All | Recheck all added directories |
| Scan This Directory | Recheck one specific directory only |
| Rebuild Search Data | Reorganize 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:
| Setting | Purpose | Example |
|---|---|---|
| Property and location switches | Decide whether to skip hidden folders, hidden files, system files, removable drives, and network paths | Skip network paths or removable drives |
| Folder and location rule | Exclude folders with a specified name, or one selected location and its contents | A temporary folder or a work folder you do not want to search |
| File rule | Exclude files by filename prefix or extension | Temporary files, tmp, log |
| Protected rule | Protect important locations from being scanned by mistake | System 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:
| Operation | Description |
|---|---|
| Clear Search Data | Delete file data recorded by AIClue, but keep added directories; rescanning is required afterward |
| Rebuild Search Data | Keep 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: Learn how to find files quickly
- Chapter 6 File Viewing and File Operations: Learn how to preview, open, and locate files
- Chapter 12 Settings and Maintenance: Learn more maintenance entries
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
contractorinvoice - Words that appear in document content, such as
acceptance notesormeeting 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 mode | Best for |
|---|---|
| Filename | Search filenames and locations without searching file content; useful when you remember a name or rough location |
| Content | You do not remember the file name, but remember content from the document |
| Smart Search | Search 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:
- First switch to a suitable search mode
- Then choose a directory scope
- Then choose a tag scope
- 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:
| Check | Description |
|---|---|
| Whether the directory has been added | The folder containing the file must first be added in Directory Management |
| Whether background processing is complete | A newly added large directory may still be processing; try again later |
| Whether the search mode is suitable | If you only remember content, use Content or Smart Search |
| Whether filters are too narrow | Clear tag and directory filters, then search again |
| Whether the file is excluded | Files 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 reading | Unsupported 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: Learn how to preview, open, and locate files
- Chapter 7 Project Workspace: Learn how to manage files by project
- Chapter 9 Tags and Classification: Learn tag filtering and classification settings
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:
| Operation | Method |
|---|---|
| View file | Click the file row to open preview or details |
| Open with the system default app | Double-click the file, or choose Open File from the more menu |
| Open file location | Click the folder button in the file row |
| Preview file | Click the preview button in the file row |
| Adjust visible columns | Choose columns from the list header menu |
| Adjust sorting | Click the file name, full path, time, or size headers |
| Add to a project workspace | Right-click a file, then select an existing workspace or create one and add the file |
| Remove from the current workspace | In 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
After you click a file or the preview button, AIClue opens the preview area inside the app. Preview is useful for quickly judging file content without frequently switching to external apps.
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 row’s more menu
- 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 click the copy path button at the top of the preview area. 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:
- Wait a moment for AIClue to finish loading
- Open the file with the system default app
- 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: View files from different directories together in a project
- Chapter 9 Tags and Classification: Learn how to filter and classify files with tags
- Chapter 10 Finding Duplicate Files: Learn how to identify and handle duplicate files
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:
- Click New Workspace
- Enter a project workspace name
- 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:
| Method | Description |
|---|---|
| Add from project card | Click the add file button on the project card, then choose one or more files |
| Add from project page | Open the project, then use the add file entry in the top bar |
| Add from file context menu | Right-click a file and choose Add to workspace… or Create workspace and add… |
| Drag to add | Drag files into AIClue and choose the project workspace to add them to |
| Drag and create project | When 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, orThesis 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: Learn how to manage Workbench cards
- Chapter 9 Tags and Classification: Learn how to keep filtering files with tags
- Chapter 12 Settings and Maintenance: Learn account, access, and maintenance settings
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.
| Operation | Result |
|---|---|
| Enable card | The card appears in the Workbench |
| Disable card | The 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:
- Find the card in the Workbench
- Click the card’s more button in the upper-right corner
- Choose Remove Card
- 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:
| Operation | Description |
|---|---|
| Lock card | Fix the card position and size to avoid accidental changes |
| Unlock | Allow moving and resizing the card again |
| Remove card | Remove the card from the Workbench |
| Card-specific operation | Some 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: Learn how to keep filtering files with tags
- Chapter 11 Account and Feature Access: Learn common reasons why features may be unavailable
- Chapter 12 Settings and Maintenance: Learn more app settings and maintenance entries
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:
| Operation | Description |
|---|---|
| Select tag | Show only files that match this tag range |
| Exclude tag | Hide files that match this tag range |
| Clear filter | Restore 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:
- Open Settings
- Go to File Types
- 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:
| Operation | Description |
|---|---|
| Add classification | Add a new category in the file type tree |
| Add item | Add a specific type under a category |
| Rename | Rename a custom category or custom item |
| Delete | Delete a custom category or item you no longer need |
| Restore defaults | Restore 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:
- Enter a keyword first to find the rough result set
- Use directory filtering to narrow the location scope
- 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: Learn how to identify and handle duplicate files
- Chapter 12 Settings and Maintenance: Learn more settings and maintenance entries
- Appendix Supported File Formats and Data Notes: View file type support scope
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:
| Information | Description |
|---|---|
| Duplicate groups | Number of duplicate file groups currently found |
| Duplicate files | Total number of duplicate files in the current results |
| Cleanable space | Approximate 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:
| Operation | Description |
|---|---|
| Select manually | Expand a duplicate group, then click file rows or checkboxes one by one |
| Smart select | Let 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:
| Rule | Description |
|---|---|
| Keep first in order | Keep the first file in the list |
| Keep earliest | Keep the file with the earlier created time |
| Keep latest | Keep the file with the later created time |
| Keep shortest path | Keep 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:
| Operation | Description |
|---|---|
| Preview | View file content or details in the preview area |
| Open file location | Locate the file in the system file manager |
| Open file | Open 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:
| Operation | Description |
|---|---|
| Move to recycle bin | Delete checked copies and move them to the system recycle bin |
| Replace with shortcut | Delete 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: Learn account state and feature access prompts
- Chapter 12 Settings and Maintenance: Learn settings, maintenance, and troubleshooting entries
Chapter 11 Account and Feature Access
AIClue supports anonymous trial and registered accounts. Account Center is used to view current user state, remaining trial time, available features, and to log in, register, reset a password, sync access, or log out.
11.1 Enter Account Center
Click the account icon at the bottom of the left sidebar to enter the Account and Access page.
If you are already logged in, hovering over the account icon shows the current email address. If you are not logged in, it shows Account.
11.2 Account Center Page
Account Center has three tabs:
| Tab | Purpose |
|---|---|
| Overview | View current user state, remaining anonymous trial time, last sync time, unlocked features, and locked features |
| Feature Access | View whether each feature is enabled |
| Account | Log in, register, reset a password, sync access, log out, and manage signed-in devices |
The Sync Access button in the upper-right corner refreshes current account and feature access state. After login, if you just changed account state or some feature states are not updated in time, click Sync Access first.
11.3 User State
Account Center may show these states:
| State | Meaning |
|---|---|
| Anonymous user | The current device is using anonymous trial |
| Anonymous trial ended | The trial period has ended, and some features may be unavailable |
| Registered user | The current device is logged in to an account |
| Invalid access | Current feature access state is abnormal. Sync access first, and log in again if it remains abnormal |
Anonymous users can try the app for 15 days by default. After registration, major features in the current version can continue to be used.
11.4 Feature Access
The Feature Access tab lists currently available and unavailable features. Common features include:
| Feature | Description |
|---|---|
| Workbench | Use function cards and related entries in the Workbench |
| Project Workspace | Create, open, and manage project workspaces |
| Plugin Market | Browse and enable basic function cards |
| Advanced Plugins | Use function cards marked as advanced in the Plugin Market |
If a feature is unavailable, the related page may show Unavailable, Locked, or a trial-ended prompt. Open Account Center to view the exact access state, then log in, register, or sync access according to the prompt.
11.5 Log In, Register, and Reset Password
After entering the Account tab, switch between Log In, Register, and Reset Password. Complete the security verification shown on the page before submitting.
Login requires:
- Password
Registration requires:
- Email verification code
- Password
- Confirm password
For registration, enter your email and complete the security verification, then click Send verification code. After you receive the six-digit code, enter it with the password and confirmation, then submit the registration. Passwords must contain 8-20 characters and include both letters and numbers.
If you forget your password, switch to Reset Password, request an email code in the same way, then enter and confirm a new password. After the password is updated, use the new password to log in.
If the two password entries do not match, the page prompts you directly. After submission, the page also shows relevant prompts if account information is invalid, the email is already registered, a verification code is invalid or expired, the device limit is reached, or the account service is temporarily unavailable.
11.6 Manage Signed-in Devices
After you sign in with a registered account, the Account tab shows the devices currently signed in to the account. You can remove devices you no longer use. A removed device must sign in again before it can use account features.
11.7 Sync Access
Sync Access retrieves the current account’s feature state again. Try syncing in these cases:
- After login or registration, the page state does not change immediately
- After switching accounts or reopening the app
- You see Login state expired, please log in again
- A feature page says unavailable, but you believe the current account should have access
If the prompt still says login has expired after syncing, log in again.
11.8 Log Out
When logged in, the Account tab shows the current email, last sync time, Sync Access, and Log Out.
After you click Log Out, the current device leaves the account state. Account Center then returns to anonymous trial or logged-out state. Whether a feature is available depends on the access state shown on the page.
11.9 What to Do When a Feature Is Unavailable
If the Workbench, Project Workspace, or a function card is unavailable, check in this order:
- Enter Account Center and check whether the anonymous trial has ended.
- Click Sync Access to refresh current feature access.
- If the prompt says login state expired, log in again.
- If the prompt says the device limit is reached, check whether the same account has been used on other devices.
- If the prompt says the account service cannot be reached, try again later or check the network connection.
11.10 Next Steps
After learning about account and feature access, continue with:
- Chapter 12 Settings and Maintenance: Learn app settings, maintenance, and common state handling
- Chapter 13 FAQ and Troubleshooting: View account, scanning, search, and duplicate detection questions
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:
| Tab | Purpose |
|---|---|
| General Settings | Language, startup, tray, and file browser display |
| Appearance | Choose the interface mode and set light and dark themes separately |
| Privacy Settings | Behavior logging and data cleanup |
| File Types | Manage file type classification and extension bindings |
| Scan Exclusions | Choose folders and files to leave out of file lists and search |
12.2 General Settings
General Settings lets you adjust startup and window behavior.
| Setting | Description |
|---|---|
| Display language | Switch interface language |
| Start on boot | Start AIClue automatically when the computer starts |
| Minimize to tray | Keep AIClue in the system tray when the window is minimized |
| Close to tray | Minimize to tray when the close button is clicked, instead of exiting |
| Global wake shortcut | Bring the window back and focus it while AIClue is in the background or system tray |
| Show hidden files in file browser | Show 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:
| Entry | What it does |
|---|---|
| Open AIClue | Restore an existing window and keep its current page, or reopen the main screen if the window was closed |
| Quick Search | Restore the window, open file search, and select the search box |
| Settings | Restore the window and open Settings |
| Quit AIClue | Use 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.
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.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:
| Level | Description |
|---|---|
| Off | Do not record behavior |
| Low | Record only file clicks inside the app |
| Medium | Record target app names during drag-and-drop |
| High | Record 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.
| Operation | Scope |
|---|---|
| Clear AI analysis results | Clear file summaries and keywords, while keeping added directories and file records |
| Clear Search Data | Clear scanned files, tags, and duplicate results while keeping app settings; you can scan your folders again afterward |
| Clear all data | Clear file records, directories, project workspaces, and user settings |
| Reset main settings to defaults | Restore 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:
| Switch | Description |
|---|---|
| Ignore hidden folders | Skip hidden folders during scanning |
| Ignore removable drives | Skip removable drives such as USB drives |
| Ignore network locations | Skip folders shared over a network |
| Ignore hidden files | Skip hidden files |
| Ignore system files | Skip 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.
12.7.2 Exclusion Types
Scan exclusion settings can come from three places:
| Source | Description |
|---|---|
| Protected rules | Built-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 rules | Common default exclusions provided by AIClue, such as cache folders or dependency folders |
| Custom rules | Rules 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:
| Type | Description |
|---|---|
| Folder name rule | Exclude folders with a specified name, such as a temporary folder |
| Selected location rule | Exclude one selected location and everything inside it |
| Filename prefix rule | Exclude files whose names start with a specified prefix |
| Extension rule | Exclude 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:
- Open Settings > Scan Exclusions.
- Enter or paste a file or folder location in Path Check.
- Check whether AIClue says the path will be scanned or excluded.
- 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: View common problem handling methods
- Appendix Supported File Formats and Data Notes: Learn file format and local data notes
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:
- Confirm that the computer has enough free space.
- Restart the computer and open AIClue again.
- If the system shows a security block, confirm that the installer source is trusted, then allow it to run according to the system prompt.
- 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:
- Enter Directory Management from the left sidebar and confirm that the directory is in the list.
- Check whether the directory is still scanning.
- 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:
- Confirm that the directory containing the file has been added and scanned.
- Try searching with a short keyword from the file name first.
- Clear tag filters, directory filters, and exclusion conditions, then try again.
- Check whether the file is excluded in Settings > Scan Exclusions > Path Check.
- Check whether this file type is within the support scope.
- 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:
- Enter Account Center and check the current user state.
- Click Sync Access to refresh feature access.
- If the prompt says login state expired, log in again.
- 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.
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:
| Classification | Common extension examples |
|---|---|
| Word documents | doc, docx, wps, odt |
| Spreadsheets | xls, xlsx, xlsm, xlsb, et, csv, ods |
| Presentations | ppt, pptx, odp |
pdf | |
| Plain text | txt, md, markdown, rtf |
| E-books | epub, mobi, azw3 |
| Design files | psd, ai, sketch, fig, xd, dwg, dxf |
| Mind maps | xmind, mm, emmx, enex, opml |
| Images | jpg, jpeg, png, gif, bmp, webp, svg, ico, tiff, tif |
| Audio | mp3, wav, flac, aac, ogg, wma, m4a |
| Video | mp4, avi, mkv, mov, wmv, flv, webm, m4v |
| Archives | zip, rar, 7z, tar, gz, bz2, xz |
| Code files | js, ts, jsx, tsx, vue, py, java, cpp, c, rs, go, php |
| Config and data files | json, xml, yaml, yml, toml, ini, conf, sql, sqlite, db |
| Certificate-related files | pem, 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.
A.3 File Types That Support Content Search
Content search means AIClue can try to read file content and use readable text for search.
Current common supported types include:
| Type | Extensions |
|---|---|
| Text documents | txt, md, rtf, log, csv |
| Config and web text | json, html, css |
| Code files | js, ts, vue, rs, py, java, c, cpp, go, php |
| Word documents | docx, doc |
| Spreadsheets | xlsx, xlsm, xlsb, xls, et, ods |
| Presentations | pptx, ppt |
| E-books | epub |
pdf |
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 content is mainly images, scanned pages, or 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:
| Type | Extensions |
|---|---|
pdf | |
| Word documents | docx |
| Spreadsheets | xlsx, csv, tsv |
| Presentations | pptx |
| Images | jpg, jpeg, png, gif, webp, avif, svg, bmp, ico |
| Audio | mp3, wav, flac, aac, ogg, opus, oga, weba, m4a |
| Video | mp4, m4v, webm, ogv, mov, flv, ts, mkv, m2ts |
| ZIP archives | zip, showing the file list only |
| Text and code | txt, 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,rmvbheic,tif,tiffpsd,ai,cdr,sketch- Older Office documents, such as
doc,xls,ppt, andwps
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:
| Data | Purpose |
|---|---|
| Directory list | Records which scan directories you have added |
| File records | Saves file name, path, size, time, extension, and classification information |
| Content search data | Saves processed text from readable files for content search |
| Tag and classification data | Saves file type tags, filter relationships, and custom classifications |
| Project workspace data | Saves project workspace names, states, and associated files |
| Settings | Saves language, startup, tray, privacy, file type, and scan exclusion settings |
| Search history | Saves searched keywords for search suggestions |
| Duplicate detection helper data | Saves records needed to identify duplicate files |
| Account state | Saves 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.
A.7 Network-Related Data
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:
| Operation | Description |
|---|---|
| Clear file analysis results | Clear file summaries and keywords, while keeping folders and file records |
| Clear Search Data | Clear file records and tag data, while keeping app settings |
| Clear all data | Clear 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.