官网 / Official site: https://www.ttread.cn/
Windows 本地清理工具。原生窗口（PySide6），单文件 exe，离线可用，不依赖浏览器、Node、Java 或任何外部运行时。
当前版本 v0.2.0 · English · 📖 使用说明 · 📷 全部截图 · 更新日志 · 贡献 · 安全
打开即自动扫描。分类默认全部折叠，一屏就能看完所有分类和它们的大小；要细看某一项再展开，或点「全部展开」。
| 分类 | 判据 | 本机实测产出 |
|---|---|---|
| 已安装软件的安装包 | 文件名剥掉版本/平台/角色后缀得到产品名，再用进程名 + 安装目录 + 卸载注册表三重证据确认「已装」 | 6 项 / 1.51 GB |
| 传统垃圾文件 | 缩略图、跳转列表、浏览器缓存、着色器缓存、崩溃转储、Windows 更新缓存… | 5 项 / 51.6 MB |
| 过期临时文件 | 超过 N 天未动的临时项；目录里有 exe 在跑则标为需确认 | 0 项 |
| GitHub 残留 | gh CLI / GitHub Desktop / Copilot 缓存；无远程的本地 clone（无 remote + 长期未动 + 无未提交改动） | 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、.ruff_cache 等 |
6 项 / 248 MB |
| Python 环境与缓存 | .venv（有 pyvenv.cfg 才算）、pip 缓存、以及你在配置里加的任何目录 |
5 项 / 182 MB |
| 注册表 | 卸载命令指向不存在 exe 的卸载项、指向不存在 exe 的启动项；以及可安全重置的 MRU 键 | 1 项 / 466 项 |
| 空文件 / 空目录 / 断链 | 0 字节项，自动跳过 .gitkeep / *.lock / desktop.ini / Thumbs.db 等 |
1 项 / 4369 项 |
- 注册表清理基本不省空间。 本机全部注册表垃圾加起来只有 15 KB。它的价值是清掉指向已不存在程序的死引用，不是腾空间。所以界面上它按条目数显示，不按字节。
- 空文件/空目录同理。 这类项体积是 0。它的价值是整洁，不是腾空间。
- Git 仓库默认只读，不提供删除。 没有任何信号能可靠区分「临时 clone」和「你的在用项目」。只有同时满足无远程仓库 + 超过 60 天未动 + 无未提交改动三条才会进入可删列表；其余全部进只读清单（附带 remote URL，一眼能看出哪个是临时的）。
只认卸载命令里的 exe 确实不存在这一个信号。
早期版本还额外要求 InstallLocation 指向的目录不存在，结果误报了一大片 —— 微信和 Visual Studio Installer 的 Uninstall.exe 明明还在，只是 InstallLocation 指向了旧路径。删掉活程序的卸载项 = 以后再也卸不掉它，代价远大于清掉几个 KB 的收益。
现在这类程序一律不报。测试里有两个用例专门盯这条：一个「卸载命令有效 + InstallLocation 失效」必须不被报，一个「卸载命令失效」必须被报出来。
| 类型 | 行为 |
|---|---|
| 普通文件 | 移入本地备份目录 %LOCALAPPDATA%\DevCleaner\file_backups\<会话>\，7 天内一键回滚；启动时自动清理过期会话。v0.1.0 走的是回收站，v0.2.0 起不再走 |
| 系统目录 | to_recycle_bin 纵深防御：%SystemRoot%、%ProgramFiles%、%ProgramFiles(x86)% 下的文件一律拒绝删除，路径取自环境变量（Windows 装在 D 盘同样生效） |
| 断链 | 用 os.rmdir/os.unlink 只删链接本身（它没有内容） |
| 注册表 | 先写 .reg 备份，导出成功才删；导出失败就拒绝删除 |
| 批量项 | 确认弹窗会显示条目数，并逐条列出前 40 项 |
| 需确认项 | 不会自动勾选，必须手动勾 |
| 软件卸载 | 运行软件自带卸载程序 → 自动扫描残留（文件夹/快捷方式/注册表）→ 残留可清理（文件类走备份+回滚，注册表只列出不自动删） |
文件备份目录：%LOCALAPPDATA%\DevCleaner\file_backups\<会话>\，每会话带 manifest.json。
回滚：界面里选会话一键还原；原路径已有文件时该项跳过并报出来，不会覆盖。全部条目都还原成功才删掉该会话目录，失败的话会话保留，可以再试。
注册表备份目录：%LOCALAPPDATA%\DevCleaner\registry_backups\<时间戳>_<类型>\
还原：对该目录里的 .reg 执行 reg import "路径"。
.reg 文件是本工具自己生成的（不调 reg.exe export）——reg.exe 的命令行引号规则在含空格路径下会报「无效语法」，直接生成更可控也更快。测试里有一轮完整的「建键 → 备份 → 删除 → reg import 还原 → 校验数据一致」。
- 不碰 Windows Temp 里的新文件。 本机 Temp 有 770 MB，但全部在 7 天内，其中 121 MB 是正在运行的 PyInstaller 解包目录。按天龄过滤在这里收益≈0 还会误删，所以默认阈值 7 天且跳过被占用的目录。
- 不碰 Prefetch。 删了会让下次启动变慢，负收益。
- 不扫系统目录。
C:/Windows、C:/Program Files、C:/Program Files (x86)默认进白名单。 - 有 remote 的 Git 仓库绝不进可删列表，测试里专门盯这条。
下载 Releases 里的 DevCleaner.exe，双击即可。打开即自动开始扫描，关闭即退出。
需要 Python 3.10+ 才能从源码运行或重新打包。
pip install -r requirements.txt
python app.py --version # 0.2.0
python app.py # 无界面：跑一次扫描并打印结果
python app.py --json # JSON 输出（给脚本用）
python app.py -c "注册表" # 只跑某一类
python gui.py # 原生界面
python test_app.py # 76 项自检
build.bat # 自检 -> 清理 -> PyInstaller onefile -> 复制 settings.yamlsettings.yaml 放在 exe 同目录（找不到就用包内内置副本），改完重启程序生效，不用重新打包。
theme: "Ink" # 上次选的主题
scan_roots: # 需要递归遍历的根（.venv / Git / 构建产物）
- "%USERPROFILE%"
installer_roots: [] # 留空 = 自动从 Windows 已知文件夹取 Downloads + Desktop
exclude_dirs: # 完全不进结果
- "C:/Windows"
exclude_globs:
- "**/node_modules/**"
min_installer_age_days: 14 # 「未确认已装」的安装包至少要放这么多天
temp_min_age_days: 7
stale_clone_days: 60
installed_aliases: # 卸载注册表匹配不到时的别名
OfficeAce: ["OfficeClaw"]
custom_cache: # 加任何目录进来就是一条规则，零代码
- name: "pip 下载缓存"
path: "%LOCALAPPDATA%/pip/Cache"
risk: safe
note: "删了重新下载即可。"
extra_junk: [] # 追加传统垃圾目录risk 取 safe（默认勾选）或 caution（默认不勾，需二次确认）。
内置 6 套色板，来自 docs/palette-directions.html（原始设计稿）：
| 方向 | 深色 | 浅色 |
|---|---|---|
| Studio — Linear / Vercel / Raycast 那一脉 | Studio Dark | Studio Light |
| Editorial — 杂志印刷质感，暖纸墨色 | Ink | Paper |
| Curated — 社区成熟色板 | Tokyo Night | Rosé Pine |
界面右上角实时切换，选择会写回 settings.yaml 的 theme: 键，重启仍是同一套。改色值请改设计稿或 app.py 里的 _PALETTES，其余字段会自动推导。
设计稿给了 7 个主色。次级/三级文字色、分割线亮度、强调色上的文字色都是按 WCAG 公式算出来的，不是手抄的 —— 这样你改主色时它们会跟着走。
其中「强调色上的文字」取白字和底色字里对比度更高的一个。这复现了设计稿在 Studio / Paper / Rosé Pine / Tokyo Night 上的选择，唯一偏离是 Ink：设计稿用白字（3.3:1），这里改成底色字（5.3:1），因为 13px 粗体文字按 WCAG AA 要 4.5:1。
测试里有一项专门量这个，每套主题 7 组对比度都必须达标（正文 ≥ 4.5:1，三级文字和警示色 ≥ 3:1）。
在 app.py 里继承 Scanner，实现 scan()，然后塞进 SCANNERS 列表。界面会自动多出一个折叠分组，不用改 UI 代码。
class MyScanner(Scanner):
category, icon = "我的分类", "\U0001f9f0"
def scan(self) -> List[Item]:
return [mk(self.category, Path("C:/some/cache"), "名称", "safe",
note="说明")]Item.unit 填 "count" 时，界面按条目数而非字节显示，且不参与 min_size_bytes 过滤。
见 CHANGELOG.md 的「计划中」。优先级最高的：
- 按需只扫描选中的分类（现在是全盘扫一遍）
- 扫描结果导出为报告文件
- 界面文案 i18n（目前硬编码中文）
欢迎提 Issue 认领其中一条。
Q：会删掉我的项目源码吗？ Git 仓库默认只读，不提供删除。只有同时满足「无远程仓库 + 60 天未动 + 无未提交改动」才进可删列表。
Q：误删了怎么恢复？
文件备份在 %LOCALAPPDATA%\DevCleaner\file_backups\，界面上选会话一键回滚，7 天内有效。注册表备份在 %LOCALAPPDATA%\DevCleaner\registry_backups\，用 reg import 还原。超过 7 天的备份在启动时自动清掉，那时只能靠系统还原点或文件恢复工具了。
Q：为什么只扫到 2 GB，明明 Temp 有 770 MB？ Temp 里的东西全部在 7 天内，其中 121 MB 是正在运行的 PyInstaller 解包目录。按天龄过滤收益≈0 还会误删，所以默认跳过。
Q：注册表清理才 15 KB，值得做吗？ 它的价值不是省空间，是清掉指向已不存在程序的死引用。界面按条目数显示，不拿字节数糊弄你。
Q：能扫别的盘吗？
改 settings.yaml 的 scan_roots 和 installer_roots。注意递归扫描的根加多了会明显变慢。
- 需要管理员权限才能删
HKLM下的键（系统级卸载项、Run分支）。普通用户运行会看到「权限不足」，这是预期行为。 - 只读清单里的 Git 仓库不提供「一键删除」，需要你自己判断。
- 注册表扫描固定只看
HKCU的 10 个 MRU 键和三个Uninstall/Run分支。刻意不去遍历HKCR\CLSID之类的地方 —— 那里的误删代价是系统装不上程序。 - 扫描耗时随磁盘和文件数增长，本机 24 盘约 25 秒（其中空文件/空目录那一项要全量遍历，占 11 秒）。
- 批量空文件项是聚合成一行的（4000 多行没法看），清理时会展开成逐条删除。
- 界面文案硬编码中文。
如果它省了你的时间：
- ⭐ Star 一下，让更多人看到
- 🐛 提 Issue 报 bug 或要新分类
- 💬 分享给同样被安装包和临时文件烦到的人
- 💰 爱发电 支持维护
打赏的钱用来续服务器和换开发设备。 作者是用自己的机器踩坑、把过程写进 决策记录 的，本来就是为了省自己的事。如果它帮到你了，一个 Star 或一条反馈比打赏更有用。
CC BY-NC 4.0 — 署名（Matou1118）· 禁商用
- 可以改、可以二次开发、可以做成自己的版本
- 必须署名原作者 Matou1118，保留许可声明，注明是否修改
- 不能商用 —— 不收费的修改版随便用；收费、打包进付费产品、接广告都不行
- 拿不准就开个 issue 问