WxCleaner 专为清理微信接收文件而设计的轻量级、跨平台桌面工具 | 极客的赛博空间

根据 WxCleaner 的官方仓库，这是一个专为清理微信接收文件而设计的轻量级、跨平台桌面工具，通过智能哈希算法快速识别重复文件并提供可视化清理界面。以下是基于其文档整理的部署与使用教程。

🧭 核心功能与定位

WxCleaner 主要用于解决微信长期使用后，接收文件大量重复占用磁盘空间的问题。其核心特点包括：

智能扫描：采用“文件大小初筛 → 头部哈希 → 全量哈希”三级策略，平衡速度与准确率，确保 100% 准确识别重复文件。
跨平台兼容：原生支持 Windows、macOS 和 Linux，并针对各平台自适应界面字体和文件管理器集成。
安全清理：删除操作通过 send2trash 库将文件移至系统回收站/废纸篓，支持二次确认，防止误删。
可视化界面：基于 ttkbootstrap 构建的现代化界面，清晰展示重复文件组，支持预览、排序和右键定位文件位置。

📦 部署与安装

WxCleaner 无需任何云服务或复杂配置，完全是本地工具。

方式一：运行 Windows 可执行文件（最简单）

从项目的 GitHub Releases 页面下载最新的 WxCleaner.exe，双击即可运行，无需安装 Python 环境。

方式二：从源码运行（跨平台）

1. 环境要求

Python 3.8+。
Tkinter（Python 的 GUI 库）。如果运行时报错，需根据系统安装：
- macOS (Homebrew)：brew install python-tk
- Ubuntu/Debian：sudo apt-get install python3-tk
- Fedora/RHEL：sudo dnf install python3-tkinter
- Arch Linux：sudo pacman -S tk

2. 克隆与安装

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

# 推荐创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows 用 venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

3. 运行程序

1	python main.py

🚀 使用指南

选择路径：
- 程序启动后会自动尝试探测并预填各平台微信的默认文件存储目录。
- 你也可以点击“浏览”按钮手动选择目标文件夹（如 Windows 下的 WeChat Files 文件夹）。
开始扫描：
- 点击 “开始扫描”，程序将在后台异步分析所选目录下的所有文件，并实时显示扫描进度。
查看与确认结果：
- 扫描完成后，列表会清晰展示所有重复文件组。
- 红色高亮的行是建议删除的冗余副本，绿色是建议保留的原始文件。
- 你可以通过右键点击任意文件，选择在系统文件管理器中打开位置，以确认文件内容。
执行清理：
- 勾选你想要删除的冗余文件（可点击“全选重复项”快速选择）。
- 点击 “移至回收站” 按钮。
- 在二次确认弹窗中确认后，文件会被安全地移动到系统回收站/废纸篓。

⚙️ 自定义打包（Windows EXE）

如果你希望自行打包生成单文件可执行程序：

1 2	pip install pyinstaller pyinstaller WxCleaner.spec

打包完成后，WxCleaner.exe 会出现在 dist/ 目录下。

❓ 常见问题与注意事项

扫描速度如何？ 采用三级哈希策略，速度较快。扫描速度取决于文件数量和磁盘性能。
文件会被永久删除吗？ 不会。所有删除操作都是移至系统回收站，可以在回收站中恢复。
Linux 下无法运行？ 请确保已安装 Tkinter 和必要的系统依赖（如 python3-tk）。
扫描结果中保留哪个文件？ 程序默认保留路径较短的文件（通常为原始文件），但你可以在清理前手动调整勾选状态。
安全警告：虽然工具提供了回收站机制，但执行大规模清理前，建议先备份重要数据。作者不对误操作导致的数据丢失承担责任。

总结

WxCleaner 是一款实用、安全、易于使用的微信文件清理工具。对于 Windows 用户，最简单的方式是直接下载 Releases 中的 .exe 文件运行，无需任何环境配置。对于 macOS 和 Linux 用户，或希望查看源码的用户，可从源码运行。该工具专注于解决微信重复文件问题，操作直观，风险可控。在使用大规模清理功能前，建议先预览结果并确认文件重要性。项目采用 MIT 许可证，自由开源。