项目地址：https://github.com/yqxie1991/WxCleaner

微信用久后，WeChat Files目录常会堆积大量图片、视频和文档。同一文件可能因重复接收、转发或另存出现多份，占用不少磁盘空间。开源项目WxCleaner瞄准这个痛点：扫描微信文件目录，找出内容相同的文件，再让用户选择清理。

它怎样判断文件重复
WxCleaner没有一上来就计算所有文件的完整哈希，而是采用三级筛选：先比较文件大小，排除明显不同的文件；再计算文件头哈希，缩小候选范围；最后计算完整哈希，确认内容是否完全一致。这种设计能减少不必要的磁盘读取，在速度与准确性之间取得平衡。

不只是命令行脚本
项目使用Python开发，界面基于Tkinter和ttkbootstrap，支持深色、浅色主题。扫描完成后，重复文件会按组展示，并列出路径、大小和修改时间。

程序默认保留路径较短的文件，把其余副本标记为待删除项。用户也可以打开文件所在位置，检查内容后再作决定。

安全性比“一键删除”更重要
WxCleaner不会直接永久删除文件，而是借助send2trash将文件移入系统回收站，操作前还会弹出二次确认。即使选错，通常仍能从回收站恢复。

不过，哈希相同只代表文件内容相同，不代表所有副本都没有保留价值。某些文件可能位于不同聊天对象或项目目录中，承担不同的整理用途。批量处理前仍应检查路径，重要资料最好提前备份。

如何使用

普通用户可到项目Releases页面下载WxCleaner.exe，无需安装Python。开发者也能从源码运行：

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

项目目前更像轻量实用工具，而非成熟的微信数据管理平台。公开Issue中已有Linux、macOS版本需求，也有人报告Python 3.9环境出现delete_selected属性错误。README里的部分下载和克隆链接仍保留yourusername占位符，使用时应进入真实仓库地址。

如果你只想找出微信目录中的重复文件，又不愿把私人聊天文件上传到云端，WxCleaner提供了一条本地、透明、可审查的解决路线。