hyperfield/ai-file-sorter

Cross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.

What it solves

AI File Sorter 是一款跨平台桌面应用,旨在通过自动组织文件并建议更具描述性、易读的文件名来消除数字杂乱。它解决了下载文件夹、外部硬盘和 NAS 存储中文件名通用或不一致的问题(例如 IMG_2048.jpg)。

How it works

该应用使用本地或远程的大型语言模型(LLM)分析文件,并针对不同文件类型采用特定策略:

  • Images:使用视觉 LLM(如 Gemma 3 4B IT)分析图像实际内容,并建议描述性名称(例如 clouds_over_lake.jpg)。
  • Documents:从支持的格式(PDF、Office、纯文本)提取文本,使用文本 LLM 摘要内容并建议文件名。
  • Audio/Video:读取嵌入的 metadata 标签(artist、album、year),生成干净的库式文件名。
  • Categorization:结合 LLM 输出与分类法匹配、白名单以及本地缓存,将文件分组到文件夹。

用户在确认更改前,可在表格中查看所有建议的分类和重命名,确保未经过许可不会移动或重命名文件。

Who it’s for

适用于想要整理大量文件的用户,支持 Windows、macOS 与 Linux,尤其是注重隐私(仅本地执行)或管理大型媒体和文档档案的用户。

Highlights

  • Privacy-First:可完全离线运行,使用本地 GGUF 模型(如 Gemma 3、Mistral),不收集遥测数据。
  • Visual Analysis:内置视觉 LLM 支持,能够描述图像内容,并对截图和 UI 捕获进行专门处理。
  • Flexible Categorization:提供 “More Refined” 或 “More Consistent” 模式,并允许使用自定义分类白名单。
  • Safety Features:包括排序预览、dry‑run 模式以及持久化的 “Undo last run” 功能。
  • Broad Compatibility:支持多种文档、音频和视频格式,跨多个操作系统均可使用。