FileNeatAI 智能文件整理工具
========================

🎯 产品简介
FileNeatAI 是一款基于人工智能的文件整理工具，能够自动分析和整理您的文件，提高工作效率。


💻 系统要求
==========

【Windows 用户】
推荐系统：Windows 10/11 (64位)
最低要求：Windows 7 SP1 (64位)

必需组件：
• Visual C++ 2015-2022 运行时库
• Universal CRT (Windows 7/8 需手动安装 KB2999226)

⚠️ 注意：不支持 Windows Vista 及更早版本

【macOS 用户】
推荐系统：macOS 10.14 (Mojave) 或更高版本
支持架构：Intel (x86_64) 和 Apple Silicon (arm64)


🚀 快速上手
==========

【Windows 用户】
1. 双击 main.exe 启动程序
   📌 Windows 7/8 用户首次启动会看到系统环境检测提示
   📌 按照提示操作，确保系统组件齐全
2. 选择要整理的文件夹
3. 设置整理规则（按类型、日期、大小等）
4. 开启 AI 智能分析模式
5. 一键执行整理操作

【macOS 用户】
1. 双击打开 DMG 文件，将 FileNeatAI 拖入 Applications 文件夹
2. 首次打开应用（⚠️ 重要，请仔细阅读）：
   
   📌 由于应用未经 Apple 公证，首次打开时会提示"无法打开，因为无法验证开发者"
   
   解决方法：
   ① 打开「系统设置」→「隐私与安全性」
   ② 向下滚动找到安全性部分
   ③ 您会看到"FileNeatAI 已被阻止，因为它不是来自已识别的开发者"
   ④ 点击「仍要打开」按钮
   ⑤ 在弹出的确认对话框中点击「打开」
   
   或者使用快捷方式：
   ① 在 Applications 文件夹中找到 FileNeatAI
   ② 按住 Control 键并点击应用图标（或右键点击）
   ③ 选择「打开」
   ④ 在弹出对话框中点击「打开」
   
3. 应用成功启动后，后续打开将不再需要上述步骤
4. 选择要整理的文件夹，开始使用

💡 使用建议
==========
• 首次使用建议先备份重要文件
• 可设置多个预设规则便于重复使用  
• 支持批处理模式处理大量文件
• 定期更新获得最新AI算法优化

🔒 隐私安全
==========
• 本地模型所有文件处理均在本地完成
• 不上传任何个人文件到云端

📋 日志位置
==========
如果遇到问题需要反馈，请提供日志文件帮助我们快速定位问题：

【日志文件位置】
• 运行日志：程序目录/logs/app.log
• 崩溃日志：程序目录/logs/crash.log

【如何查看日志】
1. 打开程序设置页面
2. 点击右下角的「📋 查看日志」按钮
3. 在弹出的对话框中选择「打开日志文件夹」

【反馈问题时请附带】
• crash.log（如果程序闪退）
• app.log（最近的日志记录）
• 问题发生时的操作步骤
• 系统信息（Windows/macOS版本）


❓ 常见问题
==========

【macOS 常见问题】

Q: macOS 提示"无法打开，因为无法验证开发者"怎么办？
A: 这是 macOS 的安全机制（Gatekeeper），解决方法：
   
   方法一：通过系统设置（推荐）
   1. 打开「系统设置」→「隐私与安全性」
   2. 滚动到下方的"安全性"区域
   3. 找到被阻止的应用提示，点击「仍要打开」
   4. 输入密码确认，然后点击「打开」
   
   方法二：右键打开
   1. 在 Finder 中找到 FileNeatAI.app
   2. 按住 Control 键点击（或右键点击）
   3. 选择「打开」
   4. 在弹窗中点击「打开」
   
   ✅ 首次打开后，以后可以正常双击启动

Q: macOS 提示"应用已损坏，无法打开"怎么办？
A: 这通常是因为应用的扩展属性问题，请在终端运行：
   sudo xattr -cr /Applications/FileNeatAI.app
   输入密码后回车，然后重新打开应用即可。

Q: macOS 上应用闪退或无法启动？
A: 请尝试以下步骤：
   1. 在终端中运行应用查看错误信息：
      /Applications/FileNeatAI.app/Contents/MacOS/FileNeatAI
   2. 确保 macOS 版本在 10.14 或以上
   3. 如果是 Apple Silicon (M1/M2/M3) Mac，请确保使用 arm64 版本

【Windows 常见问题】

Q: Windows 7/8 用户首次启动会看到什么？
A: 程序已内置智能检测功能！
   - 启动时会自动检测您的系统环境
   - 如果缺少必要组件，会弹出友好提示
   - 您可以选择：
     1️⃣ 【推荐】点击"立即修复"自动安装（需管理员权限）
     2️⃣ 点击"查看指南"手动按步骤操作
     3️⃣ 点击"忽略"继续运行（可能会遇到错误）
   
   Windows 10/11 用户通常不会看到这个提示，可以直接使用！

Q: 启动时提示 "Failed to load Python DLL" 或 "找不到指定的模块"
A: 这是因为缺少系统运行库，请按以下步骤解决：
   【快速修复】（推荐）
   1. 双击运行 一键修复运行环境.bat
   2. 等待自动安装完成
   3. 重启程序
   
   【手动安装】
   1. 下载并安装 Visual C++ 2015-2022 运行时库
      64位系统：https://aka.ms/vs/17/release/vc_redist.x64.exe
   2. 安装后重启电脑
   3. 如仍有问题，运行 check_deps.exe 检查环境
   
   详细说明请查看"运行环境问题完全解决方案.txt"

Q: 提示缺少 "api-ms-win-core-path-l1-1-0.dll" 或类似 DLL
A: 这是 Universal CRT 缺失问题，主要影响 Windows 7/8 用户：
   【自动修复】（最简单）
   1. 程序启动时如果检测到问题，会自动提示
   2. 点击"立即修复"按钮
   3. 等待安装完成后重启程序
   
   【手动解决】
   1. 安装 Visual C++ 2015-2022 运行时库
   2. Windows 7/8 还需安装 KB2999226 更新
      下载地址：https://www.microsoft.com/zh-cn/download/details.aspx?id=49984
   3. 重启电脑后再试
   
   详细步骤请查看"Windows7-8用户必读.txt"

【通用问题】

Q: 卡在某个进度不继续了
A: 1. 可能是你这边网络问题导致，关掉重启即可。 
   2. 一次性不要整理太多文件，建议一次性不超过500个文件

Q: 会不会误删文件？
A: 本工具只进行移动和重命名操作，不会删除文件。

Q: 杀毒软件报毒怎么办？（Windows）
A: 这是误报。请将软件添加到杀毒软件白名单中。
   我们的软件是开源的，不含任何恶意代码。


📞 技术支持
==========
• 官方网站：https://fileneatai.com
• 邮箱支持：hacktext@163.com
• 微信：evalshell


感谢选择 FileNeat AI！ 