Windows 原生高负载开发环境与空间深度守护套件 · 系统级防误杀 · Agent IDE 代理防线
专注攻克 Dism++ 盲区 · 着色器与现代开发缓存精准治理 · 幽灵代理穿透自愈 · 25H2 蓝屏观察期防护
简体中文 • English
DiskGuardian(磁盘守护者)不是另一款随处可见的系统垃圾清理器,它是为现代软件工程师与高负载 Windows 工作站量身打造的原生系统与空间守护套件。
传统的系统清理工具(如 Dism++、CCleaner 等)最初设计于传统 Windows 时代,在面对现代开发技术栈与复杂网络环境时暴露出了明显缺陷:
- 清理盲区大:Dism++ 的规则库专注于
WinSxS与系统更新备份,对庞大的现代开发缓存完全无感——如 NVIDIADXCache/GLCache(可达 10~30 GB)、Go 编译缓存、Rusttarget、前端node_modules,往往越清磁盘越告急; - 误删核心引发反向膨胀与排障灾难:盲目勾选「.NET 程序集缓存」会导致 NGEN 在后台静默重建引发 CPU 飙升与反吃 4GB+ 空间;误删 Windows 事件日志(
winevt)或崩溃转储(MEMORY.DMP/dedicateddumpfile.sys)会导致蓝屏排障证据直接灭失; - 清理大量临时小文件卡死系统回收站:把数千个 Shader/Temp 小碎片一次性推入回收站,导致 Windows 资源管理器创建成千上万个
$I/$R节点发生严重假死与索引崩溃; - 网络代理穿透与 Agent IDE 断网痛点:代理软件(FlClash、Clash Verge 等)退出或卸载后在 WinINET 留下底层幽灵标记,或 VS Code、Cursor、WorkBuddy、Trae、Windsurf 等开发工具因缺少
http.proxySupport强行走直连,导致自定义海外 AI 模型(DeepSeek、Claude、OpenAI、TokenHarbor)高频遭遇“连接失败”或 10061 拒绝连接。
DiskGuardian 纯 C# WinUI 3 原生重写,代码化固化安全硬禁区,补齐盲区,杜绝误杀。
graph TD
subgraph 用户交互层
GUI["WinUI 3 原生桌面端 (Fluent Mica 材质)"]
CLI["CLI 极速运维端 (disk-guardian.exe)"]
LNK["规范桌面快捷方式 (.lnk 自动生成)"]
end
subgraph 核心守护与诊断引擎["DiskGuardian.Core 核心守护引擎"]
direction TB
DENY["HARD_DENY 核心硬禁区拦截器<br/>(winevt / dmp / WinSxS / NGEN 代码级硬锁定)"]
RULE["CleanerEngine 规则治理引擎<br/>(双清理通道 · 碎片智能流控)"]
DISC["ProjectDiscoverer 动态项目探测<br/>(Cargo.toml / package.json 精准识别 · 排除 Electron)"]
PROXY["ProxyDoctor 代理医生<br/>(WinINET 二进制Flags · Git全局代理 · Agent IDE 代理防线)"]
EXPLORER["ExplorerDoctor 外壳医生<br/>(Win11多标签页 · 现代Fluent命令栏 · 阻断自愈)"]
end
subgraph 下游环境与目标宿主
STORAGE["物理磁盘存储 (C 盘 / D 盘代码仓)"]
IDE_ENV["主流 Agent IDE (VS Code / Cursor / Trae / WorkBuddy / Windsurf)"]
WININET["Windows 注册表与网络子系统 (免杀 Explorer 广播刷新)"]
SHELL["Windows 桌面外壳与资源管理器 (多标签页宿主 / 进程策略)"]
end
GUI --> DENY
CLI --> DENY
DENY --> RULE
DENY --> DISC
GUI --> PROXY
CLI --> PROXY
GUI --> EXPLORER
CLI --> EXPLORER
RULE --> STORAGE
DISC --> STORAGE
PROXY --> IDE_ENV
PROXY --> WININET
EXPLORER --> SHELL
- Dism++ 盲区全面覆盖:自动精准探测系统级 Shader 着色器缓存(DXCache/GLCache)、Go 编译缓存、Playwright 二进制与开发包;
- Rust target / Node modules 细化展开:
- 告别以往“要么全删要么全留”的黑盒机制;
- 自动逐项统计各个子工程的独立占用(按体积从大到小智能排序,如
tern (target) 20.5GB排在最前); - 每个子工程配备独立 CheckBox,支持按需去勾选,绝不误删当前正在编写调试的核心项目;
- 提供一键【定位】按钮,原生调起文件资源管理器秒级核验。
- WinINET 底层二进制 Flags 取证:
- 精准揪出表面 DWORD
ProxyEnable=0但DefaultConnectionSettings二进制第 8 字节仍留有0x02手动代理标志的幽灵残留; - 免重启、坚决不杀
explorer.exe,通过 Win32 WinINET 原生 API 广播生效;
- 精准揪出表面 DWORD
- Git 全局代理 (
~/.gitconfig) 死锁检测:- 探测
http.proxy是否指向未在监听的本地死端口,根治开发者高频遭遇的git clone Connection refused (10061)绝症;
- 探测
- 主流 Agent IDE 代理防线一键打通:
- 通用覆盖 VS Code、Cursor、Trae、Windsurf、WorkBuddy、ZCode 等;
- 诊断
http.proxySupport状态,自动识别因 IDE 缺省判定直连导致海外自定义模型(DeepSeek、Claude、OpenAI、TokenHarbor、TokenRouter)断网连接失败的弱点; - 支持一键安全注入代理与加固(带自动
.bak备份),重启 IDE 秒级畅通。
- 根治 Win11 标签页丢失与 Win10 经典回退:
- 自动探测注册表
Shell Extensions\Blocked是否恶意屏蔽了 Windows 11 现代 Fluent 命令栏 (CLSID {e2bf9676-...}); - 深度排查
SeparateProcess(在单独的进程中打开文件夹)设置冲突,防止多标签页宿主脱轨; - 检测当前运行会话的提权状态,提示管理员权限下的 Win32 回退风险;
- 自动探测注册表
- 一键安全恢复 Win11 原生状态:
- 一键清理注册表拦截键并重置进程策略,通过 Win32 API 广播外壳刷新;
- 严格遵守系统桌面安全准则:严禁暴力强杀
explorer.exe,杜绝 DeskBox 与第三方微件塌陷。
- 蓝屏观察期防护:代码级硬编码锁定
%SystemRoot%\winevt(事件日志证据链)、MEMORY.DMP、Minidump与专用转储文件dedicateddumpfile.sys,即使规则写错或手滑也绝无可能越界误杀; - NGEN 与系统核心保护:阻断
%SystemRoot%\assembly(防止清空后后台重建反向吃光磁盘)与WinSxS; - 严格排除运行时误触:同级清单识别严格阻断 Electron 运行时内置目录(如
resources/app),绝不影响日常办公软件。
- 双清理模式分流:
- 【直接永久清理 (极速模式)】:针对 Shader/Temp 等数千个零碎临时文件,跳过系统回收站直接文件系统物理级抹除,绝不阻塞系统回收站;
- 【移入回收站 (可撤销)】:用于重要工程与文件,支持两步确认与随时撤销还原;
- 智能碎片流控:检测到单次清理文件数 > 500 时,弹窗智能提示分流建议,避免 Windows 回收站假死;
- 极简便携架构:
- 原生 Win32 C 启动器(仅 18 KB,零依赖),解压后根目录下仅有
DiskGuardian.exe、rules.json、专属图标与收纳整洁的app/依赖库; - 彻底废除
.bat临时脚本,主界面右上角原生支持一键在真实桌面创建标准 Windows 快捷方式(.lnk)。
- 原生 Win32 C 启动器(仅 18 KB,零依赖),解压后根目录下仅有
- 从 Releases 页面 下载
disk-guardian-winui3-win-x64.zip; - 解压至任意目录,直接双击根目录的
DiskGuardian.exe; - 创建桌面快捷方式:在界面右上角点击【创建桌面快捷方式】,系统将自动在桌面生成带专属图标的标准快捷方式;
- 一键打通 IDE 代理:在仪表盘点击【加固 Agent IDE 代理】,一键让 VS Code / Cursor / WorkBuddy 的自定义模型走通代理;
- 空间规则清理:切至「空间规则清理」,勾选需要清理的规则,点击【开始扫描勾选项】,展开项目子项确认后执行清理。
适合自动化脚本、日常运维与快速体检:
# 1. 运行 21 项核心安全硬禁区自测
disk-guardian --check-rules
# 2. 检查网络系统代理、Git 全局代理与 Agent IDE 代理防线
disk-guardian --check-proxy
# 3. 一键加固已安装的所有 Agent IDE 代理支持 (自动绑定活跃代理)
disk-guardian --harden-ide-proxy
# 4. 安全清洗幽灵代理残留并广播生效 (绝不杀 explorer.exe)
disk-guardian --fix-proxy
# 5. 一键切回纯净直连模式 (退出后台托盘代理、重置注册表为 0、刷新 DNS,游戏无阻直连)
disk-guardian --direct
# 6. 体检 Windows 资源管理器与外壳健康状态 (检测 Win11 标签页阻断)
disk-guardian --check-shell
# 7. 一键安全恢复 Windows 11 现代多标签页原生外壳
disk-guardian --fix-shell
# 8. 在用户桌面创建规范快捷方式
disk-guardian --create-shortcut
# 9. 安全防卡死清空回收站
disk-guardian --purge| 参数标志 | 模式说明 | 行为说明 |
|---|---|---|
--check-rules |
核心安全自检 | 运行 18 项 HARD_DENY 硬断言 + 3 项项目发现断言,出现任何漏洞直接 fail-fast 阻断 |
--check-proxy |
网络与代理体检 | 结构化输出 WinINET 标志位、回环端口连通性延迟、后台常驻代理进程、Git 代理、IDE 代理配置 |
--direct |
切换纯净直连 | 专为打游戏设计:安全退出后台代理客户端、清空系统代理为 0、WinINET 广播、刷新 DNS 缓存 |
--harden-ide-proxy |
Agent IDE 加固 | 扫描 VS Code/Cursor/Trae/WorkBuddy 等,自动注入 http.proxySupport 与活跃代理 |
--fix-proxy |
幽灵代理安全清洗 | 自动备份注册表,清洗 DefaultConnectionSettings 手动位,WinINet 广播生效 |
--check-shell |
桌面外壳体检 | 检测 Win11 现代 Fluent 命令栏 Blocked 拦截、SeparateProcess 进程冲突与提权上下文 |
--fix-shell |
恢复 Win11 原生外壳 | 解除注册表命令栏阻断,重置进程隔离策略为 0,广播 WM_SETTINGCHANGE 设置刷新 |
--create-shortcut |
快捷方式生成 | 动态解析当前桌面路径,调用 Win32 原生 COM 接口生成 DiskGuardian.lnk |
--level <1/2/3> |
清理安全级别 | 默认 1(纯快速安全缓存);2 级需重下构建产物;3 级需确认关键数据 |
--apply |
执行清理操作 | 默认安全移入回收站(两步可撤销) |
--purge |
安全清空回收站 | 分批次安全物理清空 $Recycle.Bin,单文件容错,跳过锁定项,绝不卡死 |
在工程设计中,安全禁区绝不依赖外部 json 规则,全部固化在 C# 静态断言库中。每次启动自检均会执行完整断言链:
=== disk-guardian C# 核心自检 | mode=check | level<=1 ===
--- HARD_DENY self-test (18 条安全断言) ---
[SELF-TEST PASS] blocked C:\windows\WinSxS 删它会连带删掉受保护项 c:\windows\winsxs
[SELF-TEST PASS] blocked C:\windows\assembly 删它会连带删掉受保护项 c:\windows\assembly
[SELF-TEST PASS] blocked C:\windows\winevt\Logs 位于硬禁区 c:\windows\winevt 之内
[SELF-TEST PASS] blocked C:\windows\System32 删它会连带删掉受保护项 c:\windows\system32
[SELF-TEST PASS] blocked C:\Users\36230\AppData\Local\CrashDumps 删它会连带删掉受保护项 c:\users\36230\appdata\local\crashdumps
[SELF-TEST PASS] blocked D:\dedicateddumpfile.sys 命中系统关键文件名保护
...
--- ProjectDiscoverer self-test (3 条发现断言) ---
[SELF-TEST PASS] discover: 项目合法依赖被成功发现
[SELF-TEST PASS] discover: Electron 运行时应用被严格排除
[SELF-TEST PASS] discover: 无包清单目录被安全跳过
--- end self-test ---
ALL 21 SELF-TEST ASSERTIONS PASSED! 核心安全与防误杀机制运行正常。
项目使用标准 .NET 9.0 SDK 与原生 MinGW/GCC 构建极简绿色包:
# 执行一键构建与打包流水线 (生成带图标绿色便携 ZIP)
powershell -ExecutionPolicy Bypass -File build_release.ps1构建产物将输出至 dist/ 目录。
本项目基于 MIT 许可证 开源。欢迎提交 Issue 与 Pull Request 共同完善开发者清理规则与安全防线!