Update README.md for enhanced clarity on features and usage; include technical details and improve descriptions.

README.md

@@ -1,36 +1,49 @@
 ![UFF Banner](assets/uff_banner.jpeg)
 
-# UFF Search
+# UFF Search - Unsorted Folder Full-Text Search
 
-UFF Search is a desktop application for Windows that allows you to perform fast, fuzzy full-text searches on your local files.
+UFF Search is a powerful desktop application for Windows that allows you to perform fast, intelligent, and fuzzy full-text searches on your local files, including searching inside ZIP archives.
 
-It builds a search index for the folders you specify, allowing you to quickly find documents even with typos in your search query.
+It builds a local search index for the folders you specify, allowing you to quickly find documents based on their meaning (semantic search) and specific keywords, even with typos in your search query.
 
-## Features
+## Key Features
 
-*   **Local Full-Text Search:** Indexes and searches the content of files in your selected folders.
+*   **Hybrid Search:** Combines state-of-the-art **semantic search** (understanding the *meaning* of your query) with traditional **keyword search** (finding exact words). This delivers more relevant results than simple text matching.
+*   **ZIP Archive Search:** Indexes and searches the content of files *inside* `.zip` archives.
 *   **Fuzzy Search:** Finds relevant files even if your search term has typos, powered by `rapidfuzz`.
-*   **Wide File Type Support:** Extracts text from PDFs, and various plain text formats (`.txt`, `.md`, `.py`, `.json`, `.csv`, `.html`, `.log`, `.ini`, `.xml`).
+*   **Wide File Type Support:** Extracts text from:
+    *   PDFs (`.pdf`)
+    *   Plain text formats (`.txt`, `.md`, `.py`, `.json`, `.csv`, `.html`, `.log`, `.ini`, `.xml`)
 *   **Simple UI:** An easy-to-use interface to manage your indexed folders and view search results.
-*   **Click to Open:** Search results can be clicked to open the file directly.
+*   **Click to Open:** Search results can be clicked to open the file directly (or the containing ZIP archive).
-*   **Self-Contained:** Stores its index in your local application data folder.
+*   **Self-Contained:** Stores its index and all data in your local application data folder for privacy and portability.
+
+## How It Works
+
+UFF Search uses a two-pronged approach for searching:
+
+1.  **Semantic Search:** When you search, your query is converted into a numerical representation (a vector) using the `all-MiniLM-L6-v2` sentence-transformer model. The application finds files whose content is semantically similar to your query.
+2.  **Keyword Search:** The application also uses a traditional full-text search (SQLite FTS5) and fuzzy matching to find files containing the exact keywords in your query.
+
+A hybrid scoring system ranks the results, giving you the best of both worlds.
 
 ## Installation
 
 ### Windows Installer
-A pre-built installer (`UFF_Search_Installer_v3.exe`) is available for easy installation.
+A pre-built installer (`UFF_Search_Installer_v3.exe`) is available for easy installation. This is the recommended method for most users.
 
 ### From Source
-To run the application from the source code, you'll need Python and the following dependencies:
+To run the application from the source code, you'll need Python 3 and the following dependencies:
 
 1.  **Clone the repository:**
     ```bash
-    git clone <repository-url>
+    git clone https://github.com/your-username/unsorted-folder-full-text-search.git
     cd unsorted-folder-full-text-search
     ```
+    *(Note: You might need to update the repository URL)*
 
 2.  **Install dependencies:**
-    It is recommended to use a virtual environment.
+    It is highly recommended to use a virtual environment.
     ```bash
     pip install -r requirements.txt
     ```
@@ -45,10 +58,20 @@ To run the application from the source code, you'll need Python and the followin
 1.  Start the application.
 2.  Click **" + Hinzufügen"** (Add) to select a folder you want to index. The application will start scanning it immediately.
 3.  Once indexing is complete, type your search query into the search bar and press Enter or click **"Suchen"** (Search).
-4.  Results will appear below. Click on any result to open the file.
+4.  Results will appear below. Click on any result to open the file. If the file is inside a ZIP archive, the ZIP file will be opened.
 5.  To re-scan a folder for changes, select it from the list and click **"↻ Neu scannen"** (Rescan).
 6.  To remove a folder, select it and click **" - Entfernen"** (Remove).
 
+## Technical Details
+
+*   **Framework:** PyQt6
+*   **Database:** SQLite with FTS5 for full-text indexing.
+*   **Search Technology:**
+    *   `sentence-transformers` (specifically `all-MiniLM-L6-v2`) for semantic search.
+    *   `rapidfuzz` for fuzzy string matching.
+*   **File Processing:** `pdfplumber` for PDF text extraction.
+*   **Index Location:** The search index database (`uff_index.db`) is stored in `%LOCALAPPDATA%\UFF_Search` on Windows.
+
 ## License
 
 This project is licensed under the GNU Affero General Public License v3.0. See the [LICENSE](LICENSE) file for details.