FilePilot AI – 本地優先的桌面文件管理器，支持可選的AI摘要

FilePilot AI 是一款專為本地文件管理設計的桌面應用程序，旨在幫助用户高效地掃描、索引、搜索、去重、總結和組織他們的文件。該工具強調本地優先的理念，確保用户的文件默認保留在其設備上，除非用户明確選擇使用雲AI提供商進行文件摘要。

主要功能

• **智能掃描**：支持遞歸目錄掃描，可控制深度，識別文件類型、類別、MIME和哈希值，並提取豐富的元數據，如大小、日期、尺寸、時長等。同時尊重隱藏文件和.gitignore過濾器。
• **快速本地搜索**：基於Whoosh引擎的全文索引，支持關鍵詞、模糊和布爾查詢，可按類型、日期範圍和文件大小篩選，並支持將結果導出為CSV。
• **AI摘要**：內置多種文件提取器（PDF、Markdown、代碼、圖片、DOCX、XLSX、PPTX），支持本地AI（Ollama、llama.cpp）或雲AI（OpenAI、Anthropic）提供商，可批量處理文件並提供統一的插件接口。
• **重複文件清理**：通過大小桶分組、部分哈希預過濾和完整SHA-256驗證，安全地將重複文件移至系統回收站（使用send2trash庫）。
• **安全組織**：可按文件類型、日期、擴展名或大小範圍組織文件，支持自定義重命名模板，預覽更改後再應用，並支持撤銷操作。
• **桌面工作流**：基於PySide6的原生桌面界面，支持亮色和暗色主題，系統托盤集成和後台文件監控，提供通知和18種UI語言支持。

快速開始

FilePilot AI 需要Python 3.10或更高版本，支持Windows、macOS和Linux。安裝過程簡單，通過git克隆倉庫後，創建虛擬環境並安裝依賴即可運行。項目還提供了CLI工具，支持掃描文件夾、查找重複文件、導出清單、分析磁盤使用和預覽組織計劃等操作。

AI提供商選擇

用户可以根據隱私需求選擇本地或雲AI提供商。本地選項包括Ollama、llama.cpp和LM Studio，雲選項包括OpenAI和Anthropic。默認情況下，本地文件掃描、索引、組織和重複檢測無需AI，只有用户選擇摘要的文件內容才會發送到雲提供商。API密鑰存儲在操作系統密鑰鏈中，並有加密後備存儲。

項目結構與開發

項目採用模塊化架構，核心服務包括文件掃描器、索引器、重複查找器、組織器和目錄監控器。AI層提供了靈活的提供者接口。測試和CI管道確保代碼質量，支持跨平台構建（Windows、macOS、Linux）並自動生成安裝包。項目還包含自動更新功能，每24小時檢查GitHub Release新版本。

隱私與安全

FilePilot AI 的設計注重隱私：所有本地操作（掃描、索引、去重、組織）均在本地執行；AI摘要默認使用本地模型或用户明確選擇的雲提供商；沒有遙測、跟蹤或後台回撥行為。刪除操作通過系統回收站進行，確保安全。

FilePilot AI 是一個開源項目，採用MIT許可證，歡迎社區貢獻。