Skip to content

Repository files navigation

🧹 WinSweep

Windows 系统垃圾清理与一站式优化工具 · v3.4

基于 Python 标准库 tkinter 编写,双击即用,零第三方依赖。集成 Win11Debloat(系统预装应用清理)与 Neon 优化包(系统性能调优),覆盖日常缓存清理、系统精简、性能优化全流程。

v3.4 为界面与显示重构版:单窗口多视图 + 可拖拽日志区 + 深色标题栏,修复了旧版窗口高度不足时底部按钮与状态栏被挤出可视区的问题。

⚠️ 绝大多数操作需要管理员权限,程序启动时未提权会自动弹出 UAC 请求。


功能概览

模块 说明
🧹 缓存清理 14 项清理项,支持快速 / 深度 / 自定义三种模式
📦 系统预装清理 集成 Win11Debloat,3 个快速预设 + 完整图形界面
🧰 系统优化 Neon 优化包 10 项,按危险等级分级,二次确认
🛠 系统工具 DISM / sfc / chkdsk / 磁盘清理 / 系统还原点
💽 磁盘信息 顶部常驻胶囊条,自动检测 Windows.old
🖥 界面 侧边导航 6 视图、日志级别过滤/搜索/导出、跑马灯进度与计时、字号缩放与布局记忆

✨ 功能详情

🧹 缓存清理

14 项清理项,执行前后自动对比磁盘空间,完成后状态栏常驻显示释放量。

分组 清理项
缓存清理 系统根目录临时文件、Windows 临时目录、用户临时文件、回收站、浏览器缓存、最近文档记录、缩略图缓存、DNS 缓存、Windows 错误报告、剪贴板
系统维护 Windows 更新缓存、内存转储文件、字体缓存
可选 ⚠️ 预读取文件(清理后首次冷启动略慢,Windows 自动重建,日常不建议勾选)

三种清理模式:

  • ⚡ 快速清理 — 一键执行 7 项常用安全缓存,日常使用推荐
  • 🚀 深度清理 — 全部 14 项 + Windows.old 残留检查
  • 🎯 自定义清理(「缓存清理」视图)— 分组勾选并附一句话风险说明,含「推荐 / 全选 / 清空」;推荐预设自动排除可选危险项;可选项以黄色标注并带「可选 · 谨慎」徽标

浏览器缓存动态检测: 自动扫描本机已安装浏览器,支持 Edge、Chrome、Brave、Opera、Opera GX、Vivaldi、INetCache 等,仅清理实际存在的路径,日志输出命中列表。


📦 系统预装清理

集成 Win11Debloat,一键移除 Windows 11 预装应用与隐私相关功能。

3 个快速预设(静默执行,含二次确认):

  1. 仅移除默认预装应用
  2. 禁用遥测、必应搜索、广告与建议
  3. 默认模式(官方常用组合:移除预装应用 + 隐私/任务栏/资源管理器优化)

完整图形界面入口: 打开 Win11DebloatGUI,精确勾选每一项执行内容。

  • 执行前自动备份 CustomAppsList / SavedSettingsdata/win11debloat_backup/(保留最近 5 份)
  • 记录最近一次清理时间,启动时显示在日志区
  • GUI 关闭后自动刷新磁盘信息

🧰 系统优化(Neon 优化包)

统一管理 resources/Optimization/ 下的 10 类优化资源,每项支持:

  • 📂 打开目录 — 在资源管理器中浏览相关文件
  • 📄 查看说明 — 用记事本打开说明文档(建议操作前必读)
  • 执行入口 — 一键运行(reg 导入 / bat·cmd 脚本 / ps1 脚本 / exe·lnk 启动)

所有执行操作均有二次确认弹窗,高危项会强化提示并引导先创建系统还原点。

优化项 危险等级 说明
系统备份(Dism++) 🟡 中危 系统镜像备份与还原
彻底关闭 WinDefender 🔴 高危 不可逆,务必先关实时保护与篡改防护
电源与 CPU 优化 🟡 中危 Neon 电源计划 / 注册表优化 / 大小核调度
设备管理 🟡 中危 DeviceCleanup 清理未使用设备
游戏性能优化 🟡 中危 注册表优化 / 禁用 Gamebar / N 卡高频 / DesktopHeap
键鼠优化 🟢 低危 响应注册表 / USB 轮询率
服务与更新管理 🔴 高危 关闭/开启 Windows 更新 / 禁用无用服务
内存 / 硬盘 / 网络优化 🟡 中危 PowerShell 一键脚本 + 注册表导入
中断机制与延迟优化 🔴 高危 关闭 HPET / USB 中断仲裁 / MSI 信号亲和
应用优先级 🟡 中危 进程优先级 / CPU 亲和性注册表

🛠 系统工具

工具 说明
🛡 创建系统还原点 支持自定义描述(默认含时间戳),Enter 快捷确认;执行高危操作前推荐先创建
🧹 磁盘清理(cleanmgr) 打开系统内置磁盘清理工具
🚿 DISM 组件清理 清理 WinSxS 组件存储,释放系统分区空间(耗时 15–30 分钟)
🩺 系统文件检查(sfc) 扫描并修复受损系统文件(耗时 15–30 分钟)
💿 磁盘错误检查(chkdsk) 安排下次重启时执行磁盘修复

💽 磁盘信息

  • 顶部信息条常驻:盘符 / 可用容量 / 总容量 + 磁盘胶囊使用率条(颜色随使用率变化:< 80% 绿 / < 92% 黄 / ≥ 92% 红,带 80% / 92% 阈值刻度)
  • 发现 Windows.old 或存在历史预装清理记录时,信息条自动弹出对应状态标签
  • 每秒刷新时钟,每 4 秒刷新磁盘;也可按 F5 手动刷新
  • 「概览」视图额外提供大字可用容量、使用率条与运行环境健康检查

🖥 界面与显示(v3.4)

单窗口多视图:左侧导航栏 6 个入口(概览 / 缓存清理 / 预装清理 / 系统优化 / 系统工具 / 关于),右侧内容区随选切换。旧版的 4 个弹窗(自定义清理、系统优化、预装清理、系统工具)已全部内嵌为视图,不再遮挡主窗口。

布局不再丢控件:主窗体为 grid 三段式(头部 / 主体 / 状态栏),主体用 Panedwindow 分隔内容区与日志区,两个分区各自保底高度;窗口缩到最小尺寸时头部、导航、内容、日志、状态栏仍然全部可见(修复旧版日志区 expand 抢占空间、底部按钮与状态栏被挤出窗口的缺陷)。

日志区

  • 级别过滤胶囊(全部 / 信息 / 成功 / 警告 / 错误,实时计数),关键词搜索,命中行数与总行数并排显示
  • 等宽时间戳 + 两字符级别列(.. 信息 / OK 成功 / !! 警告 / XX 错误),成功/警告/错误行带淡色底纹
  • 分区标题(━━━ 标题 ━━━)自动渲染为带底色的分隔行
  • 自动滚动:新日志到达时跟随底部;手动上翻则停止跟随并弹出「⤓ 跳到最新」,可勾选关闭自动滚动
  • 支持折叠 / 展开、拖动分隔条调高、Ctrl+S 导出到 data/logs/

进度与反馈

  • 可量化任务(逐项清理)显示百分比进度;长耗时外部任务(DISM / sfc / 还原点 / 预装清理 / 优化脚本)切换为跑马灯 + 已用时计时 + 旋转指示器,不再停在 0% 像卡死
  • 状态栏常驻:任务名 / 本次释放量 / 已用时 / 进度 / 本次会话累计释放与任务次数
  • 执行期间所有操作按钮自动禁用并明显变暗(退出与导航仍可用),结束后自动恢复

观感细节:深色标题栏与 Win11 圆角/边框配色(DWM)、按钮内容自适应宽度并自动换行(中文不再被截断)、悬停高亮、ToolTip 延迟出现且屏幕边缘自动翻转、滚动条按需显示、细滚动条 hover 变亮、高 DPI 优先 Per-Monitor V2。

偏好记忆:字号缩放、当前视图、日志区高度、窗口尺寸与自动滚动开关写入 data/settings.json,下次启动自动恢复。


📁 目录结构

WinSweep/
├── WinSweep.pyw              # 主程序(GUI,双击运行,无控制台窗口)
├── icon.ico                  # 应用图标(由 build.py 生成,可自行替换)
├── build.py                  # 打包脚本:exe + Inno Setup 安装包
├── README.md
├── requirements.txt
│
├── installer/                # 安装包脚本(Inno Setup 种子模板)
│   ├── WinSweep.iss          # 安装脚本:目录 / 快捷方式 / 卸载保留策略
│   └── languages/            # 安装向导界面语言(简体中文)
│
├── resources/                # 资源目录(可整体移动,路径自动适配)
│   ├── Optimization/         # Neon 系统优化包(10 类)
│   │   ├── 0 系统备份Dism++/
│   │   ├── 1 (可选)彻底关闭WinDefender/
│   │   ├── 2 电源与CPU优化/
│   │   ├── 3 设备管理/
│   │   ├── 6 游戏性能优化/
│   │   ├── 7 键鼠优化/
│   │   ├── 8 服务与更新管理/
│   │   ├── 9 内存硬盘网络优化/
│   │   ├── 10 中断机制与延迟优化/
│   │   └── 11 应用优先级/
│   └── Win11Debloat/         # 系统预装清理(自包含,含官方 README / 说明文档)
│
├── data/                     # 运行时数据(程序自动生成,勿手动修改)
│   ├── settings.json         # 界面偏好(字号 / 视图 / 布局 / 窗口尺寸)
│   ├── w11d_last.txt         # 最近一次系统预装清理时间戳
│   ├── logs/                 # Ctrl+S 导出的日志文件
│   └── win11debloat_backup/  # Win11Debloat 配置自动备份(保留最近 5 份)
│
└── archive/                  # 旧版本归档备份

resources/data/ 通过 RES_DIR / DATA_DIR 统一管理,整个目录可直接复制或移动,无需修改代码。


⚙️ 环境要求

项目 要求
操作系统 Windows 10 / 11(需支持 UAC 提权)
Python 3.8 +(官方安装包自带 tkinter,无需额外安装)
权限 管理员权限(程序启动时自动请求 UAC)
第三方依赖

🚀 使用方法

1. 确认已安装 Python 3.8+

前往 python.org 下载安装,安装时勾选「Add Python to PATH」。

2. 启动程序

直接双击 WinSweep.pyw,程序会自动弹出 UAC 请求管理员权限。
也可右键 → 「以管理员身份运行」。

3. 按需使用

入口 适用场景
概览 → 快速清理 日常使用,7 项安全缓存,一键完成
概览 → 深度清理 定期清理,全量 14 项 + Windows.old 检查
缓存清理视图 逐项查看风险说明后勾选执行(推荐 / 全选 / 清空)
预装清理视图 精简 Win11 预装应用 / 关闭遥测与广告
系统优化视图 性能调优(注意危险等级,高危操作先建还原点)
系统工具视图 还原点 / DISM / sfc / chkdsk / 磁盘清理

快捷键

快捷键 功能
F5 / Ctrl+R 刷新时间与磁盘信息
Alt + 1~6 切换 概览 / 缓存清理 / 预装清理 / 系统优化 / 系统工具 / 关于
Ctrl + L 清空日志区
Ctrl + C 复制日志(有选区只复制选区)
Ctrl + S 导出日志到 data/logs/
Ctrl + F 聚焦日志搜索框,Esc 清空搜索
Ctrl + J 折叠 / 展开日志区(也可直接拖动分隔条)
Ctrl + = / Ctrl + - 放大 / 缩小全局字号(85%~145%)

🧩 技术实现

  • 纯标准库:仅依赖 tkinter + Python 内置模块(os / shutil / subprocess / ctypes / threading / queue / tempfile / glob / json / math 等),无需 pip install
  • 线程化执行:清理任务在后台线程运行,主界面不卡顿;所有 UI 变更(日志、进度、按钮启用态、任务结束)均经 Queue 回主线程,工作线程不直接调用 root.after(否则 update() 循环下会抛 main thread is not in main loop 导致按钮卡在禁用态)
  • 布局安全:主窗体 grid 三段式 + ttk.Panedwindow 可拖拽分栏,两分区各自 minsize 保底;内容视图统一由 ScrollArea(Canvas + 按需滚动条 + 指针命中滚轮)承载,FlowFrame 负责按钮自动换行
  • 高 DPI 适配:优先 SetProcessDpiAwarenessContext(PER_MONITOR_AWARE_V2),失败逐级回退 shcore PerMonitor / System,缩放屏不模糊;界面字号可按 85%~145% 缩放
  • 主题与字体:配色与落地页 index.html 同一色阶;字体集中为命名字体(tkinter.font),改一处全局生效;标题栏深色与圆角由 DWM 属性设置,失败静默忽略
  • 性能优化:移除全盘 os.walk 扫描,改为固定路径 / 仅根目录扫描;服务 stop/start 合并为单次子进程调用,避免重复启停;磁盘信息每 4 秒刷新一次而非每帧
  • 日志防膨胀:内存保留最近 4000 条记录、界面最多渲染 1200 行,超限自动截断前半段;过滤/搜索基于记录列表重绘,长时运行不卡顿
  • 内置图标:无 icon.ico 时逐像素绘制扫帚图标,零外部依赖,开箱即用
  • 危险操作防护:系统优化项按低 / 中 / 高危分级标注,执行前强制二次确认弹窗;高危项引导先创建系统还原点;执行期间所有操作按钮自动禁用(退出与视图切换仍可用)
  • 资源自检:启动与刷新时检测 Win11Debloat 脚本、优化包目录与每个执行入口文件是否存在,缺失项在视图内标灰并提示,避免“点了才报错”
  • 浏览器动态检测:扫描 11 个候选路径,仅处理本机实际安装的浏览器,去重后输出命中列表
  • 还原点一键创建:PowerShell Checkpoint-Computer 封装,支持自定义描述,失败时详细回显并引导手动开启系统保护
  • 偏好持久化:字号 / 当前视图 / 日志区高度 / 窗口尺寸 / 自动滚动写入 data/settings.json,异常退出不影响(仅任务结束与关闭时写入)

⚠️ 注意事项

  1. 高危操作前务必备份
    关闭 Defender、禁用 Windows 更新、中断延迟优化等高危项,建议先通过「🛠 系统工具 → 🛡 创建系统还原点」备份,或使用 Dism++ 备份系统镜像。

  2. 系统预装清理部分操作不可逆
    移除的应用通常可从 Microsoft Store 重新安装,但部分隐私 / 注册表设置项删除后需手动恢复。执行前程序会自动备份 Win11Debloat 配置文件。

  3. DISM / sfc 耗时较长
    通常需要 15–30 分钟,请耐心等待,不要强制关闭程序或窗口。

  4. 部分清理需要重启生效
    chkdsk /f 需在下次重启时执行;浏览器缓存清理后建议重启浏览器;Win11Debloat 部分设置需重启系统。

  5. 更新缓存清理期间网络更新服务短暂中断
    程序会自动停止 wuauserv / bits 服务、清理后再重启,期间 Windows Update 相关功能暂时不可用。

  6. 请勿删除 resources/ 目录
    系统预装清理与系统优化功能依赖此目录,删除后对应功能不可用。整个项目目录支持直接复制或移动到任意位置使用。


📦 版本历史

v3.4(当前版本)— 界面与显示重构

  • 修复显示不全:日志区 expand 抢占空间导致「系统」按钮组与状态栏被挤出窗口 → 改为 grid 三段式 + Panedwindow 可拖拽分栏,各分区保底高度
  • 弹窗功能全部内嵌为侧边导航视图(概览 / 缓存清理 / 预装清理 / 系统优化 / 系统工具 / 关于),滚轮改为指针命中测试,不再全局抢占
  • 深色标题栏(DWM immersive dark mode)+ Win11 圆角/边框配色;磁盘胶囊条随窗口伸缩并带阈值刻度
  • 日志区:级别过滤 + 计数、关键词搜索、自动滚动与「跳到最新」、等宽时间戳/级别列对齐、行底色分级、Ctrl+S 导出
  • 进度反馈:长耗时外部任务改为跑马灯 + 已用时 + 旋转指示器;逐项清理显示百分比并统计失败项
  • 按钮改为内容自适应宽度 + 自动换行容器(旧版 width 按字符计,中文/emoji 混排会截断);禁用态压暗且取消 hover
  • 概览视图新增运行环境与健康检查(管理员 / DPI / 字体 / 浏览器检测 / 资源完整性 / 会话统计)
  • 系统优化与预装清理视图直接标注资源文件是否存在,缺失项按钮置灰并提示
  • 字号可缩放(Ctrl+= / Ctrl+-),视图、布局、窗口尺寸记忆到 data/settings.json
  • 任务执行中关闭窗口会二次确认;高 DPI 优先 Per-Monitor V2

v3.3 — UI 细节优化

  • 颜色系统扩充(BG4 / FG_DIM2 层次更分明)
  • ToolTip 延迟 400ms 出现,快速划过不再乱弹;边框样式更精致
  • 按钮禁用态视觉灰化,hover 检测 state 不触发加亮;退出按钮执行期间始终可点
  • 品牌栏右侧加 F5 / Ctrl+L / Ctrl+C 快捷键胶囊徽标
  • 信息栏管理员状态简化为「圆点 + 精简文字」,悬停显示详情;磁盘条改为 6px 圆角胶囊,颜色三档阈值
  • 日志区:左侧蓝色竖线标题装饰,timestamp 独立灰色小字渲染,行间距优化,success / error 加粗
  • 状态栏:进度条加厚至 10px;完成后 % 标签 3 次闪烁反馈;左侧常驻「↑ 释放 N MB」
  • 滚动条收窄至 8px,hover 状态亮一档

v3.2 — Bug 修复 + 功能补充

  • 修复 busy 双重重置 Bug
  • 预读取文件(prefetch)改为"可选",移出快速清理,自定义清理中黄色标注并附风险说明
  • 浏览器缓存动态检测:自动扫描 Edge / Chrome / Brave / Opera / Opera GX / Vivaldi 等 11 条候选路径
  • 新增「🛡 创建系统还原点」:系统工具菜单入口,支持自定义描述,Enter 快捷确认;高危操作确认弹窗同步引导至此

v3.1 — 系统预装清理 + 系统优化模块

  • 集成 Win11Debloat(3 个快速预设 + 完整 GUI 入口)
  • 新增「🧰 系统优化」统一入口(Neon 优化包 10 项,危险分级 + 二次确认)
  • 资源 / 数据 / 归档目录分层规范化(RES_DIR / DATA_DIR / archive/)
  • Win11Debloat 配置自动备份;启动失败检测并回显错误

v3.0 — 全新现代 UI

  • 全新深色界面:品牌栏 / 分组按钮 / 状态栏 + 进度条 / hover 反馈
  • 日志时间戳 + 行数上限(800 行)
  • 清理前后磁盘空间自动对比
  • 大幅提速:去全盘扫描、合并子进程调用、非递归清理临时文件
  • 高 DPI 适配

更早版本

  • 基础清理功能版本(archive/ 目录有 v2 备份)
  • 由 SysCleanTemp Pro 更名为 WinSweep

📦 构建与打包(开发者)

项目自带 build.py,一条命令产出免安装目录与安装包:

命令 作用
python build.py 全流程:图标 → exe → 安装包
python build.py --exe-only 只产出免安装运行目录
python build.py --installer-only 复用已有 exe,只重新编译安装包
python build.py --onefile exe 打成单文件(启动略慢,分发更简)
python build.py --icon-only 只生成 icon.ico
python build.py --clean 清理 build/dist/

产物:

路径 说明
dist/app/ 免安装运行目录,双击 WinSweep.exe 即可运行(自动请求管理员权限)
dist/installer/WinSweep-<版本>-setup.exe 安装包:开始菜单快捷方式、可选桌面图标、完整卸载

几点说明:

  • exe 是启动器,不是脚本容器。它读取同目录的 WinSweep.pyw,并以 __file__ = <安装目录>\WinSweep.pyw 执行, 使 resources/data/README.md 的定位与直接双击 .pyw 完全一致。 若把脚本直接打进单文件 exe,__file__ 会指向临时解压目录 —— 资源定位失效,且 data/ 每次运行被清空, 字号、视图、日志等偏好无法持久化。
  • 版本号取自 WinSweep.pywAPP_VERSION,无需在两处维护;也可用 --version 3.5 临时覆盖。
  • 首次构建会自动执行 pip install pyinstaller
  • 编译安装包需要 Inno Setup 6winget install JRSoftware.InnoSetup); 未安装时可先用 --exe-only 得到免安装目录。
  • dist/app/ 同时是安装包的唯一内容来源,安装内容与免安装目录完全一致,不会出现两处清单不一致。
  • 安装脚本 installer/WinSweep.iss 可作为其它项目的模板:改 MyAppName / MyAppId / MyAppExeName[Files] 的来源目录即可。

⚖️ 免责声明

本工具涉及修改系统设置与删除系统文件,请在充分了解每项操作含义后再执行。因使用本工具造成的数据丢失、系统不稳定或其他任何损失,作者不承担任何责任。

Win11Debloat 为第三方开源项目(MIT 许可证),其功能、已知问题及维护状态请参阅其自带的 LICENSEREADME.md

About

Windows 系统垃圾清理与优化工具

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages