DevClean

DevClean 是面向 Windows 11 x64 的磁盘扫描与垃圾清理工具。最终用户直接运行 单文件 DevClean.exe，不需要安装 Python。

它按“产品承担技术判断、用户只决定个人取舍、未知默认保护”的顺序处理扫描结果：

• 只有经过源码/厂商语义审计、并且本地边界可以精确证明的对象，才进入“可以删除” 列表；默认勾选，但真正执行仍由用户点击清理。
• 只有技术语义已经明确、但是否保留确实取决于个人用途的对象，才进入“需要判断” 列表，例如某些精确识别的可重新下载模型/包。用户无需判断技术上“能不能删”； 只需决定自己是否还想保留。拿不准时可以主动选中文件再交给 AI。
• 仅凭 cache/tmp/build/log 等名称、文件后缀、年龄或大小无法证明安全的对象，以及工具 真正无法识别的对象，默认保护并且不进入删除/AI 队列。一次性的未知 AI 猜测不会 给目录或硬保护对象制造删除权限；但经过确认并沉淀的文件级 DELETE/KEEP 规则可以 作为后续默认知识，而且只对文件生效。

界面会直接提醒：AI 判断不一定准确，使用外部或付费模型可能产生费用。导出时， 同一目录下证据一致的生成型文件名会保守地合并成一个判断，并把代表范围和统计 信息写入请求；导入后组内每个已观察文件都会分别保存精确结论。普通文件名、 不同目录或风险条件不同的文件仍分别询问。导出包含本机完整路径，界面会提醒 用户只交给自己信任的模型。

用户可以选择“移到回收站”或“彻底删除”。某一项删除失败时会记录失败并继续 下一项，再次点击清理可以重试仍存在的项目；双击左右任意一行可以直接在资源 管理器中打开目录或选中文件，便于手工处理占用、权限等原因留下的项目。

直接使用

下载 release/DevClean.exe 后运行。程序首次启动会在 EXE 旁创建 DevClean-data。规则、默认备份、AI 导入索引和有界删除日志都集中在 这里，不写入 AppData；删除 EXE 和这个文件夹就会移除程序及其全部运行状态。 如果下载的是含许可证文本的完整发布目录，直接删除整个目录即可。其中三份可编辑 规则位于 DevClean-data\rules\：

• DevClean-data\rules\scan-rules.json
• DevClean-data\rules\delete-rules.json
• DevClean-data\rules\keep-rules.json

规则支持精确路径、路径前缀、通配符和正则表达式。程序内置规则编辑界面，并 提供默认规则备份与恢复功能。AI/用户结论中的用户目录会保存成 Windows 环境 变量，日期、UUID、哈希和生成型数字标识会在条件允许时形成同类路径规则，避免 换账号、换电脑或文件名变化后重复询问 AI。详细操作见 docs/使用说明.md。

从源码构建

构建环境只使用 Python 3.13：

uv sync --frozen --python 3.13
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_windows_exe.ps1

产物位于 artifacts\windows-exe\dist\：DevClean.exe 和 licenses\ 下四份 许可证文本。仓库中的 release\ 是供用户直接下载的同一套发布副本。构建脚本会 检查 EXE 体积、GUI 构造、打包规则资源、许可证文件和发布目录白名单。

当前 DevClean 本地功能门禁与主 CI 一致：

uv lock --check
uv sync --frozen --python 3.13
uv pip check
uv run --frozen --python 3.13 ruff check src scripts tests
uv run --frozen --python 3.13 python -m mypy
uv run --frozen --python 3.13 pytest
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_windows_exe.ps1

这些测试只覆盖现在的扫描、规则、AI 导入、删除编排和有界日志，不包含已删除的 Reclaimer 旧架构测试。

项目结构

• src/devclean/ui/：Windows 图形界面
• src/devclean/scanner/：只读文件扫描
• src/devclean/core/：分类、AI 合同、规则与删除编排
• src/devclean/platform/windows/：Windows 文件身份核对、回收站和永久删除
• src/devclean/config/：三份默认规则模板

架构说明见 docs/架构与部署.md。

许可证

DevClean 使用 GNU GPL v3 或更高版本。