- 🎨 现代化界面 - 基于 Fluent Design 设计语言，美观易用
- 🚀 高效清理 - 快速扫描并清理系统垃圾文件
- 🔍 智能分类 - 自动识别并分类不同类型的垃圾文件
- 🛡️ 安全可靠 - 管理员权限运行，确保清理效果
- 🌙 深色模式 - 支持亮色/深色主题切换
- 📊 详细报告 - 清晰展示清理前后的空间变化
- ⚙️ 自定义配置 - 支持自定义扫描路径和清理规则
- 🔄 自动更新 - 内置更新检查功能
- Windows 10/11
- Python 3.8 或更高版本
- 管理员权限（用于清理系统文件）
-
克隆仓库
git clone https://github.com/Kaede221/Windows-Clearner.git cd Windows-Clearner -
创建虚拟环境（推荐）
python -m venv .venv .venv\Scripts\activate
-
安装依赖
pip install -r requirements.txt
-
运行程序
python main.py
使用 PyInstaller 打包为独立的 .exe 文件.
pyinstaller --noconsole --onefile --name="WindowsCleaner" --icon="icon.ico" --add-data="icon.svg;." --collect-all=qfluentwidgets main.py打包后的文件位于 dist 目录中。
- 启动程序 - 以管理员身份运行程序（程序会自动请求权限）
- 扫描垃圾 - 点击"开始扫描"按钮，等待扫描完成
- 查看结果 - 查看扫描到的垃圾文件分类和大小
- 清理文件 - 选择要清理的类别，点击"开始清理"
- 查看报告 - 清理完成后查看详细的清理报告
- 自定义扫描路径 - 在设置中添加自定义文件夹进行扫描
- 主题切换 - 支持亮色/深色主题，自动适应系统设置
- 自动更新 - 程序会自动检查并提示可用更新
程序支持清理以下类型的垃圾文件：
- 🗑️ 临时文件
- 🌐 浏览器缓存
- 📦 系统缓存
- 🔄 更新残留
- 📝 日志文件
- 🎮 游戏缓存
- 💾 回收站
- UI 框架: PySide6 (Qt for Python)
- 设计系统: QFluentWidgets (Fluent Design)
- 系统交互: psutil
- 测试框架: pytest, hypothesis
- 打包工具: PyInstaller
windows-cleaner/
├── src/ # 源代码目录
│ ├── ui/ # UI 组件
│ ├── scanner.py # 文件扫描器
│ ├── cleaner.py # 文件清理器
│ ├── models.py # 数据模型
│ └── ...
├── config/ # 配置文件
├── logs/ # 日志文件
├── main.py # 主程序入口
├── requirements.txt # 依赖列表
└── build.bat # 打包脚本
欢迎贡献代码、报告问题或提出建议！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
# 安装开发依赖
pip install -r requirements.txt
# 运行测试
pytest
# 运行带控制台的调试版本
python main.py查看 Git Commit 了解版本更新历史。
- 请在清理前仔细检查要删除的文件
- 建议定期备份重要数据
- 某些系统文件需要管理员权限才能清理
- 清理后可能需要重启某些应用程序
如果这个项目对你有帮助，欢迎请我喝杯咖啡！你的支持是我持续开发的动力 ❤️
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
Kaede221
- GitHub: @Kaede221
- 仓库: Windows-Clearner
- 感谢 PySide6 提供强大的 UI 框架
- 感谢 QFluentWidgets 提供精美的 Fluent Design 组件
- 感谢所有贡献者和支持者
如果这个项目帮到了你，别忘了给个 ⭐ Star！
Made with ❤️ by Kaede221