综合介绍
Local File Organizer 是一个由 AI 驱动的本地文件管理工具，旨在帮助用户整理和分类计算机上的文件。该工具利用先进的 AI 模型，如 Llama3.2 3B 和 Llava v1.6，通过 Nexa SDK 实现文件的智能扫描、重组和分类，确保用户隐私的同时提供高效的文件管理体验。
简单来说，本地文件整理器会扫描你指定的文件夹，根据文件的内容，自动给它们打标签、分类、生成新的文件名，还能放到对应的文件夹里。
全程不用联网，所有的处理都在你自己的设备上完成。
只要你输入两个路径，一个是需要整理的文件夹路径，另一个是想保存整理后文件的文件夹路径，AI就会开始工作。
功能列表
- 文件扫描：自动扫描指定目录下的所有文件。
- 内容分析：使用语言模型和视觉语言模型分析文件内容。
- 文件分类：根据内容、日期和类型对文件进行分类。
- 文件重命名：生成相关描述和文件名。
- 隐私保护：所有操作均在本地完成，无需联网。
- 多种文件支持：支持文本、图片、PDF、Excel、PPT、CSV 等多种文件格式。
- 实时进度条：显示文件分析的实时进度。
- 静默模式：保存所有日志到文本文件，减少操作噪音。
- 干运行模式：在提交更改前检查排序结果。
使用帮助
安装 🛠
对于 SDK 安装和模型相关问题，请在 这里 发布。
1. 安装 Python
在安装本地文件组织器之前，请确保您的系统上已安装 Python。我们建议使用 Python 3.12 或更高版本。
您可以从官方网站下载 Python。
请按照您操作系统的安装说明进行操作。
2. 克隆代码库
使用 Git 将此代码库克隆到您的本地机器：
git clone https://github.com/QiuYannnn/Local-File-Organizer.git
或者将代码库下载为 ZIP 文件并提取到您希望的位置。
3. 设置 Python 环境
创建一个名为 local_file_organizer 的新 Conda 环境，使用 Python 3.12：
conda create --name local_file_organizer python=3.12
激活该环境：
conda activate local_file_organizer
4. 安装 Nexa SDK ️
CPU 安装
要安装 Nexa SDK 的 CPU 版本，请运行：
pip install nexaai --prefer-binary --index-url https://nexaai.github.io/nexa-sdk/whl/cpu --extra-index-url https://pypi.org/simple --no-cache-dir
GPU 安装 (Metal - macOS)
要安装支持 Metal (macOS) 的 GPU 版本，请运行：
CMAKE_ARGS="-DGGML_METAL=ON -DSD_METAL=ON" pip install nexaai --prefer-binary --index-url https://nexaai.github.io/nexa-sdk/whl/metal --extra-index-url https://pypi.org/simple --no-cache-dir
有关支持 CUDA 和 AMD GPU 的 Nexa SDK 的详细安装说明，请参阅主 README 中的 安装部分。
5. 安装依赖
- 确保您在项目目录中：
cd path/to/Local-File-Organizer将
path/to/Local-File-Organizer替换为您克隆或提取项目的实际路径。 - 安装所需的依赖：
pip install -r requirements.txt
注意： 如果您在任何包上遇到问题，请单独安装它们：
pip install nexa Pillow pytesseract PyMuPDF python-docx
在激活环境并安装依赖后，使用以下命令运行脚本：
6. 运行脚本 🎉
python main.py
使用流程
- 指定输入目录： 在运行程序后，输入需要整理的文件夹路径，例如：
/home/user/documents/input_files - 指定输出目录： 输入整理后文件存放的文件夹路径，或按 Enter 使用默认路径：
/home/user/documents/organized_folder - 查看进度： 程序会显示文件路径加载时间和目录树，用户可以实时查看文件分析进度。
- 文件分类和重命名： 程序会根据文件内容生成相关描述、文件夹名称和文件名，并显示在终端。
- 完成整理： 整理完成后，用户可以在指定的输出目录查看分类后的文件。
高级功能
- 静默模式： 在运行程序时添加
--silent参数，保存所有日志到文本文件：python main.py --silent - 干运行模式： 在运行程序时添加
--dry-run参数，检查排序结果而不提交更改：python main.py --dry-run - 更改模型： 用户可以通过 CLI 更改使用的 AI 模型：
python main.py --model Llama3.2
