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許可證，歡迎社群貢獻。