Repository navigation
v0.1.0 — 首个公开版本 / First public release
首个公开版本。Windows 本地清理工具,原生 PySide6 单文件 exe,离线可用,不依赖浏览器 / Node / Java。
10 类扫描(本机实测可回收 2.22 GB)
| 分类 | 判据 | 实测 |
|---|---|---|
| 已安装软件的安装包 | 剥版本/平台/角色后缀得产品名,再用进程名 + 安装目录 + 卸载注册表三重证据确认「已装」 | 6 项 / 1.51 GB |
| 传统垃圾文件 | 缩略图、跳转列表、浏览器缓存、着色器缓存、崩溃转储、Windows 更新缓存 | 5 项 / 51.6 MB |
| 过期临时文件 | 超过 N 天未动;目录里有 exe 在跑则标为需确认 | 0 项 |
| GitHub 残留 | gh CLI / GitHub Desktop / Copilot 缓存;无远程的本地 clone | 0 项 |
| AI Agent / Skill 缓存 | 不在 opencode.jsonc 的 plugin 列表里的包;X 与 X@latest 并存时的旧版本 |
1 项 / 79.6 MB |
| 更新器残留 | *@*-updater\pending\*、*\updates\executors\* |
1 项 / 87.2 MB |
| 构建产物 / 开发垃圾 | *.spec 同级的 build/;__pycache__、.pytest_cache 等 |
6 项 / 248 MB |
| Python 环境与缓存 | .venv(需有 pyvenv.cfg)、pip 缓存、配置里追加的任何目录 |
5 项 / 182 MB |
| 注册表 | 卸载命令指向不存在 exe 的卸载项与启动项;可安全重置的 MRU 键 | 1 项 / 466 项 |
| 空文件 / 空目录 / 断链 | 0 字节项,自动跳过 .gitkeep / *.lock / desktop.ini / Thumbs.db |
1 项 / 4369 项 |
安全设计
- 文件删除走
SHFileOperationW+FOF_ALLOWUNDO→ 进回收站,可还原 - 注册表先写
.reg备份,导出成功才删;导出失败拒绝删除 - 断链用
os.rmdir/os.unlink只删链接本身 - 扫描前检查占用,被进程占用的跳过
- 「需确认」项不自动勾选
- 有 remote 的 Git 仓库绝不进可删列表
- 失效程序只认「卸载命令里的 exe 不存在」
界面
- 原生窗口,无浏览器 / 无 WebView / 无控制台
- 打开即自动扫描;分类默认全折叠,10 个分类一屏放得下
- 6 套配色主题,实时切换并写回配置
- 注册表/空文件类按条目数显示,不拿字节数糊弄人
已知限制
- 删
HKLM下的键需要管理员权限 - 界面文案硬编码中文(英文文档齐全,界面 i18n 尚未做)
- 注册表清理基本不省空间(本机全部加起来 15 KB)—— 价值是清死引用
- 空文件扫描要全量遍历,约占一半扫描时间
验证
38 项自检,python test_app.py。CI 在 Python 3.10~3.13 上跑,含注册表完整往返(建键→备份→删除→reg import 还原→校验一致)、批量空文件真删且 .gitkeep 不被误删、主色与设计稿逐字一致、7 组对比度达 WCAG AA 等。