Skip to content

v0.1.0 — 首个公开版本 / First public release

Choose a tag to compare

@matou1118 matou1118 released this 28 Sep 18:09
· 8 commits to main since this 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 等。

完整说明见 README / CHANGELOG。