Feat/native macos quicklook

.gitignore

@@ -1,4 +1,12 @@
 /target
+/src-tauri/target
+/node_modules
+/dist
 /doc
 /logs
 /data
+/node_modules/
+/dist/
+/src-tauri/target/
+/src-tauri/gen/
+.DS_Store

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "machunt"
-version = "0.1.0"
+version = "0.2.2"
 edition = "2021"
 
 [dependencies]

README.md

@@ -1,131 +1,234 @@
 # MacHunt
 
-macOS Global File Search Tool - Similar to Windows' Everything
+A fully local macOS search tool for files and folders, with both CLI and native GUI (Tauri + React). No HTTP backend service is required.
 
 [中文文档](README_zh.md)
 
-## Features
-
-- ⚡ **High Performance**: Search entire disk in seconds
-- 🔍 **Real-time Monitoring**: Monitor file changes in real-time
-- 📂 **Flexible Search**: Support substring, regex, folder/file filtering
-- 🔄 **Incremental Indexing**: Fast rebuild with event ID persistence
-- 🗄️ **Persistent Storage**: SQLite-based index storage
-
-## Requirements
+## Version
+
+- GUI: `v1.1.0` (base release)
+- CLI/Core: `v0.2.2` (base release)
+
+## Latest Branch Updates (after v1.1.0)
+
+- Window close behavior changed to **hide to background** (`Cmd+W` / red close button), while `Cmd+Q` still quits.
+- Hidden window now switches to macOS accessory mode, so it does **not appear in Cmd+Tab**.
+- Added configurable global shortcut to toggle window visibility.
+- Showing window by shortcut auto-focuses the search input.
+- Settings page now supports vertical scrolling.
+- Clicking blank area in result list clears current selection.
+- Clipboard copy in bundled builds is now hardened with multi-path fallback.
+- Settings now include **Launch at Login** and **Silent Startup** options.
+- Launch-at-login now integrates with macOS **Login Items** (not only background items).
+- Startup settings card now has complete dark-theme styling.
+
+## Core Capabilities
+
+### CLI
+
+- Build / rebuild local index
+- Search by substring or wildcard pattern
+- File-only / folder-only filtering
+- Path-prefix filtering
+- `watch` mode with FSEvents incremental updates
+- `optimize --vacuum` for DB maintenance
+
+### GUI
+
+- Instant local search (no server)
+- Regex toggle + case-sensitive toggle
+- Path filter: manual input + suggestion dropdown + Finder picker
+- Auto watcher start on app launch
+- Build / rebuild controls
+- Multi-tab category filter (all/files/folders/documents/images/media/code/archives)
+- Click-to-sort on table headers (name/path/type/size/modified)
+- Draggable column splitters with persisted widths
+- Single/multi selection (`Shift` range, `Cmd` additive)
+- Keyboard row navigation (`ArrowUp/ArrowDown`)
+- Space-triggered Quick Look preview (multi-selection supported)
+- Double-click to open files/folders
+- Context menu actions:
+  - Open
+  - Open With... (Finder / QSpace Pro / Terminal / WezTerm)
+  - Copy name / path
+  - Copy all selected names / paths
+  - Move to Trash
+- Theme settings (system/light/dark)
+- Language settings (zh/en)
+- Global shortcut settings for show/hide window
+- Startup settings: launch at login + silent startup (applies to auto-launch only)
+
+## Tech Stack
+
+- Core: Rust
+- CLI: Clap
+- GUI frontend: React 18 + TypeScript + Vite
+- GUI container: Tauri 2
+- Global shortcut: `tauri-plugin-global-shortcut`
+- Storage: SQLite (`rusqlite`, WAL mode)
+- In-memory index: `DashMap<String, Vec<PathBuf>>`
+- Scanner: WalkDir + Crossbeam channels
+- Watcher: macOS FSEvents (CoreServices)
+
+## Architecture Overview
+
+- `src/`: shared core engine used by both CLI and GUI
+- `src-tauri/`: Tauri backend commands and window/menu lifecycle
+- `src/App.tsx`: GUI application logic and interactions
+
+Detailed architecture and optimization notes:
+
+- [doc/PROJECT_ARCHITECTURE_CN.md](doc/PROJECT_ARCHITECTURE_CN.md)
+
+## Build and Run
+
+### Requirements
 
 - macOS 10.15+
 - Rust 1.70+
+- Node.js 18+
+- npm 9+
 
-## Installation
+### Install
 
 ```bash
 git clone https://github.com/dacj4n/MacHunt.git
 cd MacHunt
-cargo build --release
 ```
 
-## Usage
-
-### First-time Setup
+### CLI
 
 ```bash
-# Build file index (required before first use)
-machunt build          # Full disk scan, ~15-20 seconds
-
-# Or build index for specific path
-machunt build --path "/Volumes/Tools"
+cargo build --release
+./target/release/machunt --help
 ```
 
-### Search
+### GUI (dev)
 
 ```bash
-# Search for files/folders containing "test"
-machunt "test"
+npm install
+npm run tauri dev
+```
 
-# Search only files
-machunt --file "test"
+### GUI (package)
 
-# Search only folders
-machunt --folder "test"
+```bash
+npm run build
+npm run tauri build
 ```
 
-### Regex Search
+## Build Command Difference
 
-```bash
-# Search all pdf files
-machunt --regex "*.pdf"
+### `npm run build`
 
-# Search pdf and docx files
-machunt --regex "*.{pdf,docx}"
+- Only builds frontend assets (TypeScript + Vite)
+- Outputs static files to `dist/`
+- Does **not** compile Rust backend
+- Does **not** produce `.app` / `.dmg`
 
-# Search files with specific pattern
-machunt --regex "*.mp{3,4}"
-```
+### `npm run tauri build`
+
+- Builds the full desktop app package
+- Runs `beforeBuildCommand` in `src-tauri/tauri.conf.json` first (currently `npm run build`)
+- Compiles Rust code under `src-tauri/`
+- Generates installable artifacts such as `.app` / `.dmg`
 
-### Path Filtering
+## App Icon Generation (Tauri)
+
+Use the following command to generate multi-size app icons from a 1024x1024 source image:
 
 ```bash
-# Search in specific directory
-machunt --path "/Volumes/Tools" "test"
+npm run tauri icon src-tauri/icons/app-icon-1024.png
 ```
 
-### Real-time Monitoring
+Notes:
 
-```bash
-# Start real-time monitoring (keep running in background)
-machunt watch
+- The source image should be square, preferably `1024x1024`.
+- This command generates platform icon assets under `src-tauri/icons/`.
+- After regeneration, `npm run tauri build` will bundle the updated icons automatically (as referenced by `src-tauri/tauri.conf.json`).
 
-# Then search from anywhere
-machunt "test"
-```
+## CLI Reference
 
-## Permissions
+Syntax:
 
-**Important**: To monitor all directories, you need to grant Full Disk Access to your terminal:
+```bash
+machunt [OPTIONS] [QUERY] [COMMAND]
+```
 
-1. Go to **System Settings → Privacy & Security → Full Disk Access**
-2. Click the lock icon and enter your password
-3. Click **+** and add your terminal app (Terminal.app, iTerm2, etc.)
-4. Restart your terminal
+Top-level options:
 
-Without this permission, monitoring will only work for `/Users` directory.
+- `-p, --path <PATH>`: path prefix filter (`.` means none)
+- `-r, --regex`: wildcard pattern mode
+- `--folder`: folders only
+- `--file`: files only
+- `--logs`: write logs to `~/.machunt/logs`
+- `[QUERY]`: search query when no subcommand is used
 
-## Wildcard Rules
+Selection rule:
 
-- `*` - Match any characters (excluding `/`)
-- `**` - Match any characters (including `/`)
-- `?` - Match single character (excluding `/`)
-- `{a,b}` - Match `a` or `b`
+- no `--file` and no `--folder` => include both files and folders
+- only `--file` => files only
+- only `--folder` => folders only
 
-## Examples
+Subcommands:
+
+### `build`
 
 ```bash
-# Search for all video files
-machunt --regex "*.{mp4,mov,avi}"
+machunt build [OPTIONS]
+```
 
-# Search for large files
-machunt --regex ".*\.pdf"
+- `-p, --path <PATH>`: build only this scope
+- `--rebuild`: clear old index first
+- `--include-dirs <true|false>`: include directories (default `true`)
 
-# Search for test files in specific path
-machunt --path "/Volumes/工作" "测试"
+### `watch`
 
-# Monitor file changes
+```bash
 machunt watch
 ```
 
-## Performance
+- Starts FSEvents watcher
+- Replays from last EventID when available
+- Enters interactive search loop
+
+### `optimize`
+
+```bash
+machunt optimize [--vacuum]
+```
+
+- Always runs WAL checkpoint
+- Optional `--vacuum` to reclaim DB file space
 
-- Index building: ~10-15 seconds for 2M files
-- Search response: <50ms for typical queries
-- Memory usage: ~200-300MB for 2M files
+Wildcard rules (`--regex`):
 
-## Architecture
+- `*` => any chars except `/`
+- `**` => any chars including `/`
+- `?` => one char except `/`
+- `{a,b}` => `a` or `b`
 
-- **Index Storage**: SQLite database with WAL mode
-- **File Monitoring**: FSEvents API for macOS
-- **Concurrent Access**: DashMap for lock-free access
-- **Parallel Processing**: Crossbeam for multi-threaded scanning
+## Runtime Data
+
+- DB: `~/.machunt/data/index.db`
+- GUI settings: `~/.machunt/gui/settings.json` (shortcut + launch-at-login + silent-start)
+- Logs: `~/.machunt/logs/`
+
+## Why DB Can Be Large
+
+Common reasons:
+
+- Large file count (often millions)
+- Directory indexing enabled by default
+- Long path strings dominate storage
+- `dirs + files` relational structure still stores large cardinality
+- WAL files (`index.db-wal`) can temporarily become large during writes
+
+Maintenance:
+
+```bash
+machunt optimize --vacuum
+```
 
 ## License