常见问题

AI FileSorter 是一款桌面应用，使用本地或远程 AI 模型来帮助整理混乱的文件夹。它侧重于实用的清理任务，如分类、更智能的文件名、以预览为先的排序，以及注重隐私的处理。

是的。AI File Sorter 支持完全离线使用，使用 本地模型，例如 Gemma 3 4B IT、Gemma 1.1 7B 和 Mistral 7B。它还可以使用受支持的视觉后端运行 本地图像分析，因此文件处理可以保留在您自己的机器上。

只有在您选择使用带有您自己的 OpenAI 或 Gemini API 密钥的 远程模型 时，才需要互联网连接。

可以。如果您更倾向于远程推理，您可以自带 OpenAI 或 Gemini 的 API 密钥，并选择基于云的模型而不是本地模型。

它可以处理：

• 通用文件和文件夹
• 支持的图片文件
• 支持的文档格式，例如 PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, 以及常见的文本文件
• 支持的音频和视频文件，用于基于元数据的文件名建议

是的。AI FileSorter 提供仅限预览的试运行，并带有 From/To 表格，因此您可以在确认任何移动或重命名前审查计划。

是的。该应用支持仅重命名的工作流和带有清晰状态标签的审核流程，因此您可以使用文件名建议而无需重新组织文件夹位置。

是的。AI FileSorter 包含持久撤销功能，会保存一个计划文件，这样即使关闭对话框也可以恢复最近一次排序。

AI FileSorter 可用于 Windows、macOS 和 Linux。

它的设计注重隐私的文件组织。如果你使用本地模型，数据会保留在你的设备上。如果你使用远程模型，你需要为你选择的服务提供自己的 API 密钥。

最好的起点是这篇指南：如何组织 PDF 文件与Office Documents 在不将它们上传到云端的情况下使用 AI 进行整理.

是的。打开 设置 -> 选择 LLM...，展开 下载，并在 模型存储 下选择不同的文件夹。

如果你已经下载了模型，你可以将现有的模型文件移动到新的存储文件夹，而不是重新下载。确保这些文件保持其 原始名称。

对于图像分析模型，请同时移动：

• 主 .gguf 模型文件
• 匹配的 mmproj 文件

你也可以将其他位置的 .gguf 文件作为 自定义本地模型 添加。

已跳过 表示 AI File Sorter 未对该文件运行该特定分析步骤。

例如：

• 如果视觉模型不可用、模型启动失败，或应用回退到基于文件名的排序，图像分析可能会被跳过
• 如果文件无法以文本方式读取或分析步骤失败，文档分析可能会被跳过

发生这种情况时，AI File Sorter 通常会继续使用最安全的可用回退方案，例如使用文件名、缓存结果或元数据。请查看进度信息以了解具体原因。

尚未支持。 AI File Sorter 可以在文档中已嵌入文本时分析基于文本的 PDF 文件，但扫描的 PDF 通常仅为图像文件，目前需要先进行 OCR。

已计划为扫描 PDF 提供 OCR 支持，将在未来的版本中推出。 目前，您可以使用其他工具运行 OCR，并将文件保存为可搜索的 PDF 或文本文件，然后再使用 AI File Sorter 进行分析。

可以，部分可以。AI File Sorter 可以通过自定义的 类别/子类别限制 来引导，例如使用 白名单，这样建议会更接近你想要的分类。

你可以使用分支白名单，在其中设置你自己的分类及相应的子分类。

尚未。 AI File Sorter 目前专注于分析、分类、移动文件，并可选择性地重命名文件。它目前不会检测或标记重复文件。

重复检测功能已在计划中，将会在未来版本中推出。

如果您的电脑在 AI File Sorter 分析文件时重启，当前运行不会自动恢复。您可以重新打开应用并再次开始分析。

根据上一次运行的进度以及本地缓存中保存的内容，部分结果可能会被重用，但应用可能需要重新分析某些文件。

尚未。 目前，请在确认之前查看结果，并手动取消选择任何您不想移动或重命名的文件。

计划在将来的版本中加入文件类型包含/忽略功能。

AI File Sorter 不会在分析过程中移动或重命名文件。分析步骤仅会准备类别和文件名建议。分析完成后，应会出现审阅并确认窗口。

只有在您通过点击 确认并排序 批准这些建议后，文件才会被移动或重命名。

如果应用在您确认之前被关闭、取消，或审阅窗口消失，则不会对任何文件进行更改。请在同一文件夹上重新运行分析；先前保存的分类结果可能会被重用，这样您可以更快地从审阅步骤继续。

要对图像进行重命名，必须启用 image analysis 并下载视觉模型文件。

打开 Settings -> Select LLM... 并检查 Image analysis models 部分。对于所选的视觉后端，这两个文件必须都已下载：

• 模型文件
• 匹配的 mmproj 文件

然后，在主屏幕上：

1. 启用 Analyze picture files by content.
2. 展开图片选项。
3. 启用 Offer to rename picture files.
4. 再次运行分析。

对于文档重命名，不需要视觉模型。请改为启用 Analyze document files by content 和 Offer to rename document files。

Review 屏幕上的灰显复选框是 rename-only 切换项。只有当运行包含受支持的图像/文档文件，并且在分析之前已启用相应的 Offer to rename... 选项时，它们才会被启用。

您可以传输 本地设置、分类缓存、自定义白名单 和 已学习的审核决定。首先，在两台计算机上都关闭 AI File Sorter。然后将应用设置文件夹从旧计算机复制到新计算机上的相同位置。

设置文件夹位置：

• Windows: %APPDATA%\AIFileSorter\
• macOS: ~/Library/Application Support/AIFileSorter/
• Linux: ~/.config/AIFileSorter/

如果存在，请复制以下文件：

• config.ini - 应用设置、所选 AI 提供商/模型、API 密钥、文件夹偏好设置
• categorization_results.db - 已缓存的分类结果
• user_learning.db - 从已批准的 Review 对话决定中学习到的行为
• whitelists.ini - 自定义类别/子类别白名单

可选附加项：

• review_history.sqlite - 审核/历史记录
• image_place_cache.db - 缓存的照片 GPS 地点查询

复制后，在新计算机上启动 AI File Sorter 并检查 设置。某些已保存的路径（例如源文件夹、目标文件夹或自定义本地模型路径）可能需要更新，因为 Windows、macOS 和 Linux 使用不同的文件夹格式。

已下载的本地 AI 模型单独存储。复制它们是可选的，但可以避免重新下载大型文件：

• Windows: 通常位于 %APPDATA%\aifilesorter\llms
• macOS: ~/Library/Application Support/aifilesorter/llms
• Linux: ~/.local/share/aifilesorter/llms

从下一个版本开始，AI File Sorter 将能够识别并处理现有的文件夹层次结构，包括嵌套的子文件夹。这使您可以使用已有的文件夹结构来组织文件，而无需从头重新创建。

此错误意味着 Windows 试图加载 AI File Sorter 的 CUDA 加速后端，但所需的 NVIDIA CUDA 运行时 DLL 不可用。

首先，请安装 最新 AI File Sorter 版本。较新的构建会在使用前验证 CUDA 后端，并在 CUDA 无法使用时自动回退到 Vulkan 或 CPU。

通常仅为使用 AI File Sorter 并不需要安装完整的 CUDA Toolkit。如果你并不特别需要 CUDA 加速，使用 Vulkan 或 CPU 即可。

请尝试以下步骤：

1. 将 AI File Sorter 更新到最新版本。
2. 从 NVIDIA 的网站更新你的 NVIDIA 显卡驱动。在本例中，cublas64_13.dll 指代 CUDA 13.x。
3. 如果你之前通过环境变量或高级设置强制启用 CUDA，请移除该覆盖，让应用自动选择。
4. 如果错误仍然出现，若可用请选择 Vulkan 或 CPU 加速。

如果在最新版上问题仍然存在，请通过 Contact -> Report issue 报告此问题。

AI File Sorter 会分析你选择的文件，并根据你选择的 排序模式 和 设置 提出一个整理后的结果。现有的文件夹并不会被自动视为必须保留的规则，但它们可根据工作流程提供有用的上下文。

在任何移动发生之前，你可以查看建议的更改。如果你想保留特定的文件夹结构，可以使用类别约束，例如 白名单，或者在包含更明确结构的较小文件夹上运行 AI File Sorter。

对于 图像支持，AI File Sorter 需要连接到一个支持视觉并暴露 OpenAI 兼容的 API 的 LM Studio 模型。在 LM Studio 中，确保视觉模型已加载且本地服务器/API 正在运行。

在 AI File Sorter 中，选择 LM Studio 作为 AI 提供者，并选择一个支持视觉功能的模型。如果应用仍然提示你下载模型，通常意味着通过配置的提供者，AI File Sorter 无法看到兼容的本地模型，即使 LM Studio 中已经加载了该模型。

检查以下内容：

• LM Studio 的本地服务器已启用。
• AI File Sorter 中的 server URL 与 LM Studio 的 API 地址一致。
• 已加载的模型支持 图像输入，而不是仅限文本的聊天。
• LM Studio 显示的模型名称与 AI File Sorter 配置使用的名称相匹配。

视频支持不同： AI File Sorter 不会像发送图像那样直接将整个视频发送到视觉模型。根据具体功能，视频分析可能需要受支持的内置工作流，或者可能仅限于基于文件名、元数据或提取帧的处理。

AI File Sorter 可以通过 Ollama server 使用 Ollama 模型，而不是直接从诸如 B:\OllamaApp 这样的文件夹读取模型文件。

使用方法：

1. 安装并运行 Ollama。
2. 拉取或创建你要使用的模型，例如使用 ollama pull llama3.1。
3. 确保 Ollama 在本地运行，通常在 http://localhost:11434。
4. 在 AI File Sorter 中，选择本地/Ollama AI 选项并选择或输入模型名称。

B:\OllamaApp 等文件夹路径只是 Ollama 存储其应用或模型数据的位置。AI File Sorter 不需要该路径；它通过 Ollama 的本地 API 与其通信。

是的，部分支持。AI File Sorter 让你通过选择类别应有的宽泛或详细程度来引导结构，并且当你希望结果遵循一组固定的文件夹时，你可以使用 类别约束，例如 白名单。

直接提示文件，例如带有你自己命名和文件夹规则的自定义 .md 文件，目前尚未作为内置工作流程。但这确实是未来版本的自然发展方向，尤其适用于那些已经有首选归档系统并希望 AI File Sorter 更加贴合该系统的用户。

是的。如果你对一个文件夹进行了排序，之后又添加了新文件并在该文件夹上再次运行 AI File Sorter，应用可以使用其本地分类缓存和已学会的审核决策来保持建议的一致性。当新文件在逻辑上与之前使用的类别和子文件夹相匹配时，AI File Sorter 应该会建议相同的结构。

在应用建议之前，你仍然可以对这些建议进行审核。为了获得最一致的结果，请在多次运行之间保持相同的设置、白名单和分类模式。

在 macOS 上，应用在首次打开时可能会被阻止，因为它是在 Mac App Store 之外分发的，且未使用 Apple 证书签名。

请使用下载页面上链接的 macOS 帮助页面，按照分步说明操作，包括 Settings -> Privacy & Security 的批准步骤。

对整个磁盘进行排序可能需要很长时间，因为 AI File Sorter 需要扫描大量文件，分析它们的文件名和元数据，有时还要对文件内容进行 AI 分析。

图像分析通常是最耗时的部分。其速度在很大程度上取决于你计算机的 GPU。配备大约 6 GB 或以上显存的独立 GPU 可以显著加快图像扫描速度。在显存不足的系统上，或应用回退到 CPU 处理时，图像分析会慢得多。

对于大规模清理，通常最好将图像与文档和其他文件分开排序。

通常不需要。AI File Sorter 在针对特定文件夹或批次使用时效果最佳，而不是一次性对整个磁盘进行操作。

推荐的起点有：

• Downloads
• 桌面清理文件夹
• 文档文件夹
• 图片文件夹
• 外部驱动器文件夹
• 项目归档

对于首次大规模清理，较小的批次更易于审查且通常更实用。含大量图片的文件夹通常最好单独处理。

如果该应用正在运行大规模分析且您的电脑响应变慢，最实用的选项是：

• 在不主动使用电脑时让运行继续进行
• 如果需要立即使用电脑，则停止或取消运行
• 稍后用更小的文件夹或批次重新启动
• 将图像与非图像文件分开处理

Windows 会在应用之间共享 CPU、GPU 和内存资源，但本地 AI 分析仍可能很吃资源，尤其是图像分析。

AI File Sorter 目前不包含专门的低资源或后台节流模式。

不。AI File Sorter 目前并未设计为后台服务运行。

它旨在作为批处理工具使用：

1. 选择一个文件夹。
2. 运行分析。
3. 审核建议的分类和重命名建议。
4. 批准更改。
5. 完成后关闭应用。

这样可以让你控制哪些更改会被应用到你的文件上。

在首次清理之后，大多数人应定期使用 AI File Sorter，而不是持续运行它。

一个实用的工作流程是：

• 在 Downloads 文件夹变得混乱时运行它
• 每周或每月运行一次，具体取决于你收集文件的数量
• 在导入大量文件后运行它
• 如有需要，对包含大量图像的文件夹单独运行

第一次大规模运行通常最耗时。后续运行可能更快，因为应用程序可以重用其对已处理文件的本地缓存。

是的。计划推出新版 AI File Sorter，采用更快的视觉 AI 模型，应该会减少对 GPU 视频内存的需求。

这将使图像分析对更多用户而言更快或更实用，尤其是在当前视觉模型要求过高的系统上。

卸载 AI File Sorter 只会移除该应用程序。它不会删除您用它整理的文件或文件夹。

Windows:

1. 关闭 AI File Sorter。
2. 打开 设置 > 应用 > 已安装应用。
3. 找到 AI File Sorter，选择三点菜单，然后选择 卸载。
4. 如果您使用的是便携式下载而不是安装程序，请删除 AI File Sorter 文件夹或 .exe 文件，并移除您创建的任何快捷方式。

macOS:

1. 关闭 AI File Sorter。
2. 在 Finder 中打开 应用程序。
3. 将 AI File Sorter 拖到废纸篓，然后如果想立即移除，请清空废纸篓。
4. 如果您仍保留下载的 .dmg 安装文件，也可以将其删除。

Linux:

1. 关闭 AI File Sorter。
2. 删除您安装的 AppImage、解压的应用程序文件夹或启动器。
3. 如果您是通过包管理器安装的，请使用相同的包管理器将其移除。

如果您还想删除 本地设置或缓存文件，请联系支持并告诉我们您正在使用的操作系统，以便我们为您提供具体的文件夹路径。