仓库地址ChenAI-TGF/windows-c-drive-cleaner类型AI Agent Skill 可独立运行的 PowerShell 工具许可MIT先说效果一般来说第一次使用可以一下清理20-30G的C盘空间 并且不容易“反弹”写在前面C 盘为什么总是莫名其妙变满很多人装软件都默认装在 C 盘时间一长就会遇到这些情况系统提示磁盘空间不足更新、编译、下载动不动失败「存储」里看不出到底是谁占的空间随手用清理软件要么清得不彻底要么误删重要文件开发环境尤其夸张包管理器缓存、IDE 缓存、浏览器内核、文档软件插件……用着用着又涨回来传统做法通常是打开一切、WinDirStat、磁盘清理再凭经验一个个删。效率低还容易踩坑。windows-c-drive-cleaner想解决的是另一件事把「扫描 → 解释 → 确认 → 清理 → 汇报」做成一套可复用的 Agent Skill。你只要用自然语言说「C 盘满了帮我看看」支持SKILL.md的 AI Agent例如 Cursor、Claude Code 等就能按规范流程帮你处理不想用 Agent 时也可以直接跑自带的 PowerShell 脚本。它是什么简单说这是一个面向Windows C 盘可再生缓存的清理工具包包含三部分SKILL.md给 AI Agent 看的操作说明书何时启用、先扫后删、危险项如何二次确认config/targets.json可编辑的清理白名单不同电脑可以改scripts/Invoke-CDriveCleanup.ps1真正执行扫描/清理的引擎输出分项结果和 JSON 摘要定位不是「一键格式化 C 盘」而是优先清理可再生成的缓存先扫描、再确认、后删除高风险目标默认关闭必须多步确认才动适合谁用解决什么问题典型用户开发者 / 学生本机装了 Python、uv、各种 IDE、WPS、Notion……缓存回潮很快需要稳定腾出几 GB十几 GB但不想乱删系统目录的人已经在用 AI 编程助手希望「说句话就能清盘」的人想把清理流程标准化、拷到多台电脑复用的人核心功能详解1. 先扫描不瞎删Agent 工作流强制要求加载配置Scan 模式只统计不删除把结果做成清单给你看你确认后再 Clean扫描会告诉你每一项多大、属于哪一档safe / caution / dangerous、路径在不在、C 盘当前还剩多少空间。2. 可配置白名单跨电脑可改清理目标写在config/targets.json里不是写死在代码里。你可以打开/关闭某一项enabled改路径支持%LOCALAPPDATA%、%APPDATA%、%USERPROFILE%、%TEMP%调整风险档位tier标记是否需要管理员权限requiresAdmin配置清理前执行的命令、需要结束的进程/服务换一台电脑、换一个用户名一般不用改死路径因为用的是环境变量。内置覆盖的常见目标包括可按机器增删开发相关uv cache、Playwright 浏览器缓存、损坏的 Python 包残留等办公/效率WPS 插件与缓存、Notion 缓存、百度网盘临时目录等编辑器部分 IDE 的 snapshots / workspaceStorage / 小缓存、VS Code Crashpad 等系统侧用户 Temp、Windows Temp、Package Cache、Windows Update 下载缓存、传递优化缓存等3. 三级风险safe / caution / dangerous档位含义默认策略safe可再生缓存清了通常会再长回来扫描后确认一次即可建议清理caution一般可清但可能影响修复安装/更新下载需要你明确点名同意dangerous可能丢数据或弄坏应用默认关闭必须多步确认并讲清利害例如uv-cache、Notion/WPS 缓存、临时目录 → 多半是 safePackage Cache、Windows Update Download → caution清了以后修复/更新可能要重新下载IDE 主状态库、WPS 文档备份、整棵 TeX Live → dangerous默认不动4. 管理员权限能提权就提权失败就降级有些目录如C:\ProgramData\Package Cache、更新下载目录普通权限删不掉。脚本支持-Elevate需要时弹 UAC。如果用户点了「否」仍然清理不需要管理员的部分明确报告哪些项是need-admin给出可复制的提权命令不会假装「已经全部清干净」。5. 分项账本 合计 日志清理时会尽量给出每个目标清理前 / 清理后 / 释放量分项释放合计C 盘空闲空间变化before → after可选桌面日志文件方便回看脚本控制台输出用英文减少中文 Windows 下乱码Agent 再按你的语言写成中文简报。6. 安全红线写进规范Skill 明确禁止或严格限制这些行为不手动乱删WinSxS/ 系统目录不在未扫描、未确认的情况下直接 Clean不把用户桌面项目源码目录当缓存清掉大软件优先建议迁移/联接/卸载而不是上来递归删除dangerous 目标必须说明风险 → 问备份 → 确认 id → 最终确认语缺一步就中止7. 两种用法Agent 或独立脚本走 Agent推荐日常装进对应工具的 skills 目录然后自然语言对话即可。独立运行# 只扫描powershell-NoProfile-ExecutionPolicy Bypass-File.\scripts\Invoke-CDriveCleanup.ps1-Mode Scan# 清理 safe必要时 UACpowershell-NoProfile-ExecutionPolicy Bypass-File.\scripts\Invoke-CDriveCleanup.ps1-Mode Clean-Tiers safe-Elevate# 只清指定 idpowershell-NoProfile-ExecutionPolicy Bypass-File.\scripts\Invoke-CDriveCleanup.ps1-Mode Clean-Idsuv-cache,wps-addons-Elevate也可以双击scripts\Scan.batscripts\Clean-Safe.bat推荐工作流Agent 版一次完整对话大致是这样你C 盘快满了帮我看看能清什么。Agent运行 Scan列出 safe/caution/dangerous 占用。你先清所有 safecaution 里只清 Windows Update 下载。Agent执行 Clean需要时弹 UAC给出分项释放量和 C 盘空闲变化。Agent要不要我根据这台电脑生成一个以后能双击复用的清理脚本这个「先沟通再动手」是设计重点比盲目一键清理更适合长期用在真机上。怎么安装作为 Agent Skill把仓库放到你使用的 Agent 的 skills 目录名称以各工具文档为准例如工具常见个人目录Cursor%USERPROFILE%\.cursor\skills\windows-c-drive-cleaner\Claude Code%USERPROFILE%\.claude\skills\windows-c-drive-cleaner\从 GitHub 安装示例git clone https://github.com/ChenAI-TGF/windows-c-drive-cleaner.git$env:USERPROFILE\.cursor\skills\windows-c-drive-cleaner然后重启 Agent 或新开对话直接说My C: drive is almost full. Scan caches and suggest what to clean.C 盘满了用 windows-c-drive-cleaner 帮我扫描只用脚本克隆仓库后进入目录运行上面的 PowerShell / bat 即可不必安装到 skills 目录。和「普通清理软件」差在哪对比点常见清理软件windows-c-drive-cleaner交互勾选一堆项目点清理可先扫后聊按你的选择清可定制规则较固定JSON 白名单每台电脑可改风险控制看软件良心三级档位 dangerous 多步确认写死在 skill 里自动化一般是 GUIAgent 可对话驱动脚本可复用开发环境不一定覆盖 uv / IDE 缓存等面向常见开发与办公缓存它不是要取代所有清理工具而是把「可解释、可配置、可对话」的 C 盘缓存治理流程标准化。使用建议第一次只用 Scan看清单是否符合你的机器。先清 safe观察几天软件是否正常。caution 项安装包缓存、更新下载确认你不介意重新下载再清。dangerous 项没把握就保持关闭真要动先备份。缓存会回潮尤其包管理器、办公软件插件隔一段时间再扫一次很正常。C 盘长期吃紧时除了清缓存还应考虑大软件迁盘、换更大系统盘、把文档/微信目录改到其他盘。小结windows-c-drive-cleaner帮你做的是一件很具体的事在 Windows 上安全、可配置、可对话地清理 C 盘可再生缓存并把结果算清楚。如果你经常被 C 盘空间折磨又已经在用 AI Agent可以把这个 skill 装上试一次扫描如果只想要脚本仓库里的 PowerShell 工具同样能单独用。GitHubhttps://github.com/ChenAI-TGF/windows-c-drive-cleaner协议MIT欢迎 Star、Fork按自己的机器改targets.json
)
