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许可证，欢迎社区贡献。