WxCleaner

项目简介

WxCleaner 是一款专为清理微信接收文件而设计的轻量级桌面工具。微信长期使用后，WeChat Files 目录中往往堆积了大量重复的图片、视频和文档，白白占用磁盘空间。WxCleaner 能够高效扫描指定目录，通过智能哈希算法精准识别重复文件，并提供可视化的清理界面，帮助用户一键释放磁盘空间。它基于 Python 与 ttkbootstrap 构建，界面简洁现代，删除操作会将文件移至系统回收站，最大程度避免误删。

核心特性

• 三级智能扫描 — 采用"文件大小 → 头部哈希 → 全量哈希"的三级筛选策略，极速识别重复文件，确保准确率
• 可视化预览 — 清晰展示重复文件的路径、大小、修改时间，并支持一键打开文件所在位置
• 自动标记 — 扫描完成后自动标记重复项（默认保留路径最短的文件），支持一键全选
• 安全清理 — 文件不直接永久删除，而是移动至系统回收站，并在删除前提供二次确认
• 现代化界面 — 基于 ttkbootstrap 构建，简洁美观，支持深色 / 浅色主题切换
• 免安装运行 — Windows 用户可直接下载打包好的 WxCleaner.exe，无需配置 Python 环境

安装方法

方式一：Windows 用户从 GitHub Releases 下载最新的 WxCleaner.exe，双击即可运行，无需安装 Python。

方式二：源码运行（需 Python 3.8+）：

git clone https://github.com/yqxie1991/WxCleaner.git
cd WxCleaner
pip install -r requirements.txt
python main.py

使用指南

• 选择路径 — 点击"浏览"选择微信文件存储目录（通常位于 Documents/WeChat Files 下）
• 开始扫描 — 点击"开始扫描"，程序自动分析目录下的所有文件
• 查看结果 — 红色高亮表示建议删除的重复项，绿色表示保留项，可手动调整勾选
• 执行清理 — 确认无误后点击"移至回收站"，二次确认即可完成清理

使用场景

• 微信瘦身 — 清理长期接收堆积的重复图片、视频和文档，释放磁盘空间
• 磁盘整理 — 在大目录中快速定位完全相同的冗余文件
• 安全清理 — 借助回收站机制放心删除，避免误删重要文件