WxCleaner 是一款专为清理微信接收文件而设计的轻量级桌面工具。它能够高效扫描指定目录，通过智能算法识别重复文件，并提供可视化的清理界面，帮助用户释放磁盘空间。

• 智能扫描: 采用 "文件大小 -> 头部哈希 -> 全量哈希" 三级筛选策略，极速识别重复文件，确保 100% 准确率。
• 可视化预览: 清晰展示重复文件的路径、大小、修改时间，支持打开文件所在位置。
• 自动标记: 扫描完成后自动标记重复项（默认保留路径最短的文件），支持一键全选。
• 安全清理:
  • 文件并非直接永久删除，而是移动至 系统回收站，防止误删。
  • 删除前提供二次确认，确保操作安全。
• 现代化 UI: 基于 ttkbootstrap 构建的现代化界面，简洁美观，支持深色/浅色主题。

• 语言: Python 3.8+
• GUI 框架: ttkbootstrap (基于 Tkinter)
• 核心库:
  • send2trash: 实现跨平台的安全删除（移至回收站）。
  • Pillow: 图像处理支持。

在 Releases 页面下载最新的 WxCleaner.exe，双击即可直接运行，无需安装 Python 环境。

1. 环境要求: 确保已安装 Python 3.8 或更高版本。
2. 克隆仓库:

   git clone https://github.com/yourusername/WxCleaner.git
   cd WxCleaner

3. 安装依赖:

   pip install -r requirements.txt

4. 运行程序:

   python main.py

1. 选择路径: 点击 "浏览" 按钮，选择您的微信文件存储目录（通常位于 Documents/WeChat Files 下）。
2. 开始扫描: 点击 "开始扫描"，程序将自动分析目录下的所有文件。
3. 查看结果: 扫描完成后，列表中会显示所有发现的重复文件组。红色高亮表示建议删除的重复项，绿色表示保留项。
4. 执行清理:
   • 您可以手动调整勾选状态。
   • 确认无误后，点击 "移至回收站"。
   • 确认弹窗提示，完成清理。

如果您想自行打包为 .exe 文件：

pyinstaller WxCleaner.spec

打包完成后，可执行文件将位于 dist/ 目录下。

本工具旨在帮助用户管理文件，虽然提供了安全删除机制（移至回收站），但建议在执行大规模清理前务必确认文件内容。作者不对因使用本工具导致的任何数据丢失承担责任。

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。