# C Drive Cleaner **Repository Path**: j326598/c-drive-cleaner ## Basic Information - **Project Name**: C Drive Cleaner - **Description**: No description available - **Primary Language**: Python - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-07 - **Last Updated**: 2026-07-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 极简C盘清理工具 v1.2.1 `极简C盘清理工具` 是一个面向 Windows 的本地清理工具，强调 **界面清爽、操作直接、风险可控**。 它将常见的系统整理需求拆分为两部分： - **垃圾清理**：处理缓存、日志、临时文件、缩略图、回收站等常见占用 - **进程优化**：识别高内存占用的普通用户进程，便于按需处理 这个项目追求的不是“删得越多越好”，而是让每一次清理都 **更直观、更克制，也更安心**。 --- ## 项目特点 - **桌面单文件运行**：支持打包为 `exe`，双击即可启动 - **无广告、无捆绑**：纯本地工具，不依赖在线服务 - **风险分级清晰**：区分低风险、中风险、高风险项 - **默认偏保守**：优先展示适合日常处理的安全项 - **操作界面现代化**：Web UI + 桌面壳，交互直观 --- ## 当前功能一览 ### 垃圾清理 当前版本可扫描或处理以下内容： - **系统临时文件**：Windows 临时目录、当前用户临时目录 - **浏览器缓存**：Chrome、Edge、Firefox 缓存目录 - **聊天工具缓存**：微信、QQ 常见缓存目录 - **缩略图缓存**：Windows 缩略图与图标缓存数据库 - **回收站**：统计并清空回收站内容 - **系统日志与转储**：日志目录、崩溃转储、`MEMORY.DMP` - **开发工具缓存**：VS Code、JetBrains 等缓存目录 - **Windows 更新缓存**：`SoftwareDistribution/Download` ### 辅助识别项 以下项目主要用于提示或进阶处理，风险更高： - **进程优化**：结束高内存占用的普通用户进程 - **C盘无用目录**：启发式识别长期未使用、内容较少的旧目录 - **卸载残留目录**：结合注册表已安装软件信息识别疑似残留 - **下载文件夹**：仅统计大小，**不自动删除** - **休眠文件**：仅统计 `hiberfil.sys` 大小，**不自动删除** --- ## 风险说明 并不是所有扫描结果都适合直接一键清理，所以当前版本采用的是 **分级展示 + 谨慎默认** 的策略： - **低风险**：适合日常清理，如临时文件、缓存、缩略图、日志 - **中风险**：需要你确认后再处理，如回收站、更新缓存、部分残留目录 - **高风险**：更建议人工确认，如进程结束、根目录旧文件夹、休眠文件相关项 如果你只是想做一次稳妥清理，建议优先处理： - **系统临时文件** - **浏览器缓存** - **聊天工具缓存** - **缩略图缓存** - **系统日志与转储** - **开发工具缓存** --- ## 运行环境 - **操作系统**：Windows 10 / Windows 11 - **Python**：推荐 Python 3.10+ - **运行权限**：普通扫描可直接运行；部分系统目录清理建议管理员权限 --- ## 安装依赖 先安装项目依赖： ```bash pip install -r requirements.txt ``` 当前依赖包括： - `flask` - `pywebview` - `pyinstaller` 如果你准备直接本地调试源码运行，也建议安装： ```bash pip install psutil ``` --- ## 启动方式 ### 方式一：桌面版启动 直接运行： ```bash python cleaner_webview.py ``` 这会： - 启动本地 Flask 服务 - 创建桌面窗口 - 使用 `pywebview` 加载界面 ### 方式二：Web 调试模式 直接运行后端： ```bash python app.py ``` 然后在浏览器打开本地地址进行调试。 --- ## 打包 EXE 项目已提供 Windows 打包脚本：`build_exe.bat` ### 一键打包 直接双击 `build_exe.bat`，或在终端运行： ```bash pyinstaller --noconfirm --clean --onefile --windowed --name "极简C盘清理工具_v1.2.1" --add-data "templates;templates" --add-data "static;static" cleaner_webview.py ``` 打包完成后，产物位于： - `dist/极简C盘清理工具_v1.2.1.exe` ### 自定义内容 你可以按下面方式修改生成结果： - **修改 EXE 文件名**：编辑 `build_exe.bat` 中的 `APP_NAME` - **修改窗口标题**：编辑 `cleaner_webview.py` 中 `create_window()` 的 `title` - **修改界面显示版本**：编辑 `app.py` 与 `cleaner_webview.py` 中的 `APP_VERSION` ### 关于图标 项目根目录当前包含 `app_icon.ico`，但此前打包时已确认它的格式 **不够标准**，可能导致 `PyInstaller` 构建异常。 所以当前默认打包脚本里 **暂时没有启用 `--icon` 参数**，目的是优先保证能稳定生成完整可用的 `exe`。 如果你后续换成一个标准的 `.ico` 文件，可以再把图标参数加回去。 --- ## 项目结构 ```text cdisk-cleaner-main/ ├─ app.py # Flask 后端与清理逻辑 ├─ cleaner_webview.py # 桌面窗口入口 ├─ build_exe.bat # Windows 打包脚本 ├─ requirements.txt # Python 依赖 ├─ templates/ │ └─ index.html # 主界面模板 ├─ static/ │ ├─ app.js # 前端交互逻辑 │ └─ style.css # 界面样式 └─ dist/ # 打包产物输出目录 ``` --- ## 适用场景 这个工具更适合你在下面这些场景中使用： - 想快速清理 C 盘里常见的缓存、日志和临时文件 - 不喜欢传统清理工具里广告过多、界面杂乱 - 希望先看清项目内容和风险，再决定是否处理 - 希望将这类工具直接打包成 Windows 本地桌面程序使用 如果你更需要的是下面这些能力： - 注册表深度修复 - 驱动层系统优化 - 全量开机项管理 - 更细粒度的磁盘占用分析 那这个项目就不是那种“系统调校型工具”的路线，它更偏向 **轻量、直接、够用**。 --- ## 使用说明 - 某些目录如果正被系统或其他软件占用，实际释放量可能会小于扫描值 - 部分操作依赖 Windows 权限与系统当前状态，必要时请使用管理员方式运行 - `下载文件夹` 与 `休眠文件` 当前仅提供体积提示，不会自动删除 - `进程优化` 会尝试结束高内存占用的普通进程，执行前请先保存好正在处理的内容 --- ## 开发说明 当前项目采用： - **后端**：`Flask` - **桌面壳**：`pywebview` - **前端**：原生 `HTML + CSS + JavaScript` - **打包**：`PyInstaller` 整体结构比较轻，适合继续迭代以下方向： - 更细的扫描项分类 - 更完善的白名单 / 黑名单策略 - 清理前预览与二次确认 - 扫描结果导出 - 更稳定的图标与版本资源注入 --- ## 开源协议 本项目基于 `MIT License` 开源，详见 `LICENSE`。