资讯详情

如何快速上手 AI File Sorter:Windows/macOS/Linux 三平台安装完整教程

📅 2026/10/11 21:59:31 | 华诺云谱 👁 阅读
如何快速上手 AI File Sorter:Windows/macOS/Linux 三平台安装完整教程
AI 应用大模型本地部署桌面应用【免费下载链接】ai-file-sorterCross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.项目地址https://gitcode.com/gh_mirrors/ai/ai-file-sorter点击查看免费下载AI File Sorter 是一款跨平台的AI 文件整理工具能通过人工智能自动为图片、文档和音视频文件分类、归档并建议更清晰的文件名。本教程将带你完成AI File Sorter 安装Windows、macOS、Linux 三平台并演示如何安全地跑通第一次 AI 文件整理——全程本地处理、可预览、可撤销新手也能零风险上手。AI File Sorter 是什么AI File Sorter 是一个基于 Qt6 的桌面应用核心能力包括AI 智能分类根据文件名、文件类型、文件夹上下文和过往整理结果把杂乱的 Downloads、外置硬盘、NAS 中的文件自动归入分类文件夹图片内容识别视觉大模型IMG_2048.jpg这类无意义文件名可以被理解并建议改为clouds_over_lake.jpg文档内容分析读取 PDF、Office 等文档的文本内容总结并建议更好的文件名音视频元数据改名把内嵌的标签年份、艺术家、专辑、曲目转换成2024_artist_album_title.mp3这样的规范文件名隐私优先使用本地模型时文件、图片与元数据全部保留在你的电脑上不发送任何遥测也无需联网 它不会偷偷动你的文件所有移动和重命名都要先在Review审阅对话框中由你确认后才执行。先看效果30 秒理解 AI 文件整理流程整理前一个典型的 Downloads 文件夹可能长这样——安装包、截图、文档、图片混在一起运行一次 AI File Sorter 后同样的文件夹被自动归类为 Documents、Images、Software 等清晰的目录整个工作流程只有 4 步把 AI File Sorter 指向一个文件夹选定的本地或远程大模型分析文件包括图片内容如适用生成分类与重命名建议你审阅并调整之后才会真正创建文件夹、移动文件Windows 安装两种方式任选方式一官方安装程序推荐新手这是最快的手动安装路径无需任何编译环境从官方发布渠道下载 Windows 安装程序.exe或.msi双击运行安装向导按默认选项一路下一步安装完成后直接启动aifilesorter.exe安装程序会自动完成 GPU 后端检测优先使用CUDA其次Vulkan都没有则自动回退CPU无需手动配置。方式二从源码编译适合开发者如果你希望参与开发或定制构建需要以下工具链Visual Studio 2022含使用 C 的桌面开发工作负载CMake 3.21与vcpkgQt 6MSVC 套件或 Qt 在线安装器编译步骤PowerShell# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/ai/ai-file-sorter cd ai-file-sorter git submodule update --init --recursive # 2. 构建 llama.cpp 本地模型运行时CPU 版本示例 app\scripts\build_llama_windows.ps1 cudaoff vulkanoff # 3. 编译 Qt6 应用 app\build_windows.ps1 -Configuration Release主要入口脚本为 app/build_windows.ps1构建产物位于app\build-windows\Release详细的依赖说明vcpkg、OpenBLAS、CUDA 可选配置见 README.md 的 Windows 章节与 app/vcpkg.json。macOS 安装与源码构建macOS 支持两种途径下载官方 macOS 构建包解压后把 AI File Sorter 拖入 Applications 即可Apple SiliconM 系列与 macOS 15 均受支持。源码构建Homebrew 流程# 1. 安装命令行工具 xcode-select --install # 2. 安装依赖 brew install qt curl jsoncpp sqlite openssl fmt spdlog mediainfo cmake git pkgconfig libffi # 3. 克隆仓库并构建 git clone https://gitcode.com/gh_mirrors/ai/ai-file-sorter cd ai-file-sorter git submodule update --init --recursive ./app/scripts/build_llama_macos.sh --arm64 # Apple Silicon 本地模型运行时 cd app make -j8可执行文件生成于app/bin/aifilesorter。构建脚本见 app/scripts/build_llama_macos.sh完整依赖清单见 README.md 的 macOS 章节。Linux 安装apt 一键安装与源码编译方式一Debian/Ubuntu 预编译包推荐# 1. 安装运行依赖Qt6、网络、数学库、Vulkan sudo apt update sudo apt install -y \ libqt6widgets6 libcurl4 libjsoncpp25 libfmt9 libopenblas0-pthread \ libvulkan1 mesa-vulkan-drivers patchelf # 2. 安装 .deb 包 sudo apt install ./aifilesorter_*.deb使用apt install而非dpkg -i可自动补齐缺失依赖。Debian 13 的包名略有不同如libjsoncpp26、libfmt10详见 README.md 的 Linux 章节。方式二源码编译Debian/Ubuntu/Fedora/Archsudo apt install -y build-essential cmake git qt6-base-dev qt6-base-dev-tools \ qt6-tools-dev-tools libcurl4-openssl-dev libjsoncpp-dev libsqlite3-dev \ libssl-dev libfmt-dev libspdlog-dev libmediainfo-dev zlib1g-dev patchelf git clone https://gitcode.com/gh_mirrors/ai/ai-file-sorter cd ai-file-sorter git submodule update --init --recursive # 按目标 GPU 后端构建 llama 运行时CPU / CUDA / Vulkan 三选一 ./app/scripts/build_llama_linux.sh cudaoff vulkanoff # 编译应用 cd app make -j4二进制输出在app/bin/aifilesorterLinux 启动脚本run_aifilesorter.sh会在启动时自动按CUDA → Vulkan → CPU的优先级选择最佳 GPU 后端。可选打包命令./app/scripts/package_deb.sh.deb或./app/scripts/create_rpm.shRPM见 app/scripts/。安装后第一件事选择 AI 模型打开Settings → Select LLM即可配置模型三种选择模型类型是否需要联网是否需要 API Key适合场景本地模型Gemma 3 4B IT 等否否隐私敏感、批量整理完全免费ChatGPT / Gemini远程是是追求更强理解能力自定义 OpenAI 兼容 APILM Studio、Ollama 等视情况视情况自建推理服务本地模型在 Select LLM 对话框中点击对应后端旁的下载按钮即可首次下载后永久复用图像分析需要额外下载一个mmproj投影文件远程模型粘贴你的 OpenAI 或 Gemini API Key密钥只保存在本地配置config.ini中清除输入框即可删除系统兼容性检测安装好本地模型后可通过File → System compatibility check…快速评估你的电脑跑分类、文档分析和图像分析的速度档位安全上手指南Dry Run 预览与撤销第一次使用 AI File Sorter强烈建议从官方推荐的安全首跑开始用 20–50 个文件的小文件夹做试验别一上来就扫整个硬盘在主窗口勾选所需选项如 Analyze picture files by content、Analyze document files by content点击Analyze folder在结果中开启Dry run (preview only, do not move files)预览每一条 From → To 计划确认无误后点击Confirm Sort!执行整理万一整理后想反悔使用Edit → Undo last run即使关闭过软件撤销计划也会持久保存。常见问题 FAQQ本地模型真的完全免费吗A是的。基于本地 LLM 的文件分类完全免费无需联网、无需 API Key。只有选择远程模型ChatGPT/Gemini时才需要自备密钥。Q没有显卡能用吗A可以。应用会自动回退到 CPU 模式OpenBLAS。不过有 8GB 显存的显卡在 Vulkan/CUDA 卸载下体验会更流畅4GB 显存通常只能部分卸载。Q误把源码工程文件整理坏了怎么办A递归扫描会自动跳过 Unity、Unreal、Godot、Blender、Git 仓库等结构化项目根目录保护项目内相对路径不被破坏详见 ProtectedProjectDetector.hpp。Q界面支持中文吗A支持简体中文在内的 15 种界面语言以及多种分类语言。设置入口在Settings → Category language。Q遇到问题去哪找日志A应用写入core.log、db.log、ui.log三个轮转日志Windows 位于%APPDATA%\AIFileSorter\logsLinux 位于~/.cache/AIFileSorter/logs。更多排查建议见 TROUBLESHOOTING.md。延伸学习文档与源码导航资源路径官方架构文档docs/architecture.md配置与环境变量docs/configuration-and-environment.md分类行为说明docs/categorization-behavior.md无头运行时契约docs/headless-runtime-contract.md更新器契约docs/updater-contract.md测试指南docs/testing.md 与 TESTS.md核心应用源码app/lib/单元测试tests/unit/完整更新日志CHANGELOG.md跟着本教程走完安装、选模型、Dry Run 预览四步你就已经掌握了 AI File Sorter 的全部核心用法。接下来不妨打开Help → Quick Start Guide查看应用内的本地化引导或者挑选一个真正凌乱的文件夹让 AI 帮你彻底清爽它。赞分享AI 应用大模型本地部署桌面应用【免费下载链接】ai-file-sorterCross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.项目地址https://gitcode.com/gh_mirrors/ai/ai-file-sorter点击查看免费下载相关推荐如何快速安装Codex-XWindows/macOS/Linux三平台安装完整指南如何快速安装Codex XWindows/macOS/Linux三平台安装完整指南 Codex X 是一款面向 OpenAI Codex 桌面端 / Code桌面应用开发者工具AI 应用Sudachi快速上手教程Windows/Linux/macOS/Android多平台安装指南Sudachi快速上手教程Windows/Linux/macOS/Android多平台安装指南 Sudachi是一款支持Android、Linux、macOS桌面应用移动开发虚拟化如何快速安装broot5分钟搞定 Linux/macOS/Windows 三平台部署教程如何快速安装broot5分钟搞定 Linux/macOS/Windows 三平台部署教程 broot 是一款免费开源的目录树导航与文件搜索工具用模糊搜索在终开发工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑