Skip to content
Back to search

disk-cleanup

SkillWorks with Claude CodeGitHub

C 盘空间体检与清理。扫描占用点,清理可再生成的缓存、日志、已装软件的旧安装包。 Use when the user says "C盘没空间了"、"帮我清理磁盘"、"磁盘满了"、"看看什么能删"、 "清理C盘"、"磁盘清理"、"D盘也不够了"、"空间不够用了",或报告磁盘空间不足。 也用于排查空间黑洞(-Deep 定位已知类别之外的大头)。 Do NOT use for: 删除单个文件/文件夹(直接用文件工具)、卸载软件(用系统卸载程序)、 整理用户文档或照片(那是用户数据,不是缓存)、磁盘分区或格式化。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hujinlong989--disk-cleanup/badge.svg)](/listings/hujinlong989--disk-cleanup)

HTML

<a href="/listings/hujinlong989--disk-cleanup"><img src="/api/listings/hujinlong989--disk-cleanup/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 119 lines
  1. ---
  2. name: disk-cleanup
  3. description: |
  4. C 盘空间体检与清理。扫描占用点,清理可再生成的缓存、日志、已装软件的旧安装包。
  5. Use when the user says "C盘没空间了"、"帮我清理磁盘"、"磁盘满了"、"看看什么能删"、
  6. "清理C盘"、"磁盘清理"、"D盘也不够了"、"空间不够用了",或报告磁盘空间不足。
  7. 也用于排查空间黑洞(-Deep 定位已知类别之外的大头)。
  8. Do NOT use for: 删除单个文件/文件夹(直接用文件工具)、卸载软件(用系统卸载程序)、
  9. 整理用户文档或照片(那是用户数据,不是缓存)、磁盘分区或格式化。
  10. descriptions:
  11. zh-Hans: "C 盘空间体检与清理:只删可再生成的缓存,字体与登录态数据绝不碰"
  12. displayNames:
  13. zh-Hans: "C 盘清理"
  14. ---
  15. # C 盘清理
  16. 用 `scripts/disk-clean.ps1` 做体检与清理。脚本已内置安全护栏,删不到有影响的东西。
  17. ## 核心原则
  18. **只删「删了会自动重建」的东西**:浏览器离线缓存、磁盘缓存、应用更新安装包、过期日志、已装软件的旧安装包。
  19. **绝不碰**:字体、浏览器登录态数据(IndexedDB / Cookies / Local Storage / Bookmarks / History)、用户文档照片视频桌面、数据库本体、虚拟磁盘镜像、项目源码与依赖、应用配置。
  20. 脚本里有两层护栏:`Test-ProtectedPath` 会拦截受保护路径与文件名的候选,`Remove-ToTrash` 只把通过护栏的文件送回收站。即使分类逻辑写错,这些路径也进不了删除流程。
  21. ## 默认不用问
  22. 用户说"帮我清理"就是要清理。**直接体检 + 直接清安全类,不要先问一遍再动手**。只有以下情况才停下来问:
  23. - 用户明确说了"先别删"或"只看一下"
  24. - 报告里出现 `Review` 类且体积可观 → 清之前用一句话告知,让用户确认
  25. - 删除后释放空间远低于预期 → 说明有占用或权限问题,需要排查而非继续删
  26. ## Procedure
  27. 1. 跑体检,拿到精简结论。
  28. ```powershell
  29. pwsh -File <skill>/scripts/disk-clean.ps1
  30. ```
  31. 输出是分类表格,不吐明细。把它作为后续判断的唯一依据,不要自己去递归扫全盘 —— 那会浪费大量时间和 token。
  32. 2. 读结论,判断要不要深挖。
  33. 若「安全类合计」不足 1 GB,而用户说空间紧张,或用户想知道"到底什么占了地方",加 `-Deep` 定位已知类别之外的大头:
  34. ```powershell
  35. pwsh -File <skill>/scripts/disk-clean.ps1 -Deep
  36. ```
  37. 3. 执行清理。
  38. ```powershell
  39. pwsh -File <skill>/scripts/disk-clean.ps1 -Clean
  40. ```
  41. 这一步会清掉全部安全类(含浏览器离线缓存),自动关闭并重开 Edge / Chrome / ego。
  42. 文件进回收站,**脚本不自动清空回收站** —— 清空不可逆,会连带抹掉用户自己手动删的文件。空间此刻还没真正释放,脚本会报告回收站当前占用,由用户自己决定何时清空。
  43. 只清某几类:`-Category Updater,Temp`。
  44. 4. 验证并汇报。
  45. 跑一次不带 `-Clean` 的体检确认剩余项,对比清理前后可用空间,向用户报告:释放了多少、动了哪几类、跳过了多少(被占用)、还有哪些大项没清及原因。
  46. 脚本会把本次删除的完整路径清单写到 `%TEMP%\disk-cleanup-logs\deleted-<时间戳>.txt`,汇报时把这个路径给用户 —— 万一删错了可以照着找回来。
  47. ## 汇报格式
  48. 简短结论,不要复述脚本原始输出:
  49. ```
  50. C 盘 20.1G → 34.8G,释放 14.7G
  51. - Edge 离线缓存 8.19G(关闭后重开,登录态保留)
  52. - Chrome 离线缓存 2.81G
  53. - updater 安装包 1.92G
  54. 回收站现有 14.5G,手动清空后空间才会真正释放。
  55. 删除清单:%TEMP%\disk-cleanup-logs\deleted-20261118-170530.txt
  56. ```
  57. 「本次释放」是文件离开原位的大小;文件在回收站里占着 C 盘,所以要提醒用户清空回收站才真正腾出空间。
  58. ## 读 -Deep 输出的注意事项
  59. `-Deep` 的用户目录统计已排除 NTFS junction(`.mavis`、`Local Settings`、`Application Data` 等指向 AppData 的联接点),不会重复计数。
  60. 但脚本只排除了这几个已知联接点。若输出里出现无法解释的大目录,用 `Get-Item <路径> -Force` 查 `LinkType` 和 `Target`,确认是不是联接点再汇报 —— 避免把重复计数当成新的占用。
  61. ## 用户专属约定
  62. - **字体不删**。用户明确说过「字体不用删除了」,脚本里字体不在任何类别中,永远不会被清理。
  63. - **D 盘也有需求**时,`-Deep` 的根目录扫描会覆盖到,但脚本本身只操作 C 盘的用户目录;其他盘建议建议用户手动迁移而不是自动搬移。
  64. ## Failure handling
  65. - **部分文件删除失败**(报告里"跳过 N"):通常是文件被运行中程序占用。属正常,不重试;告诉用户重启后可再清一次。
  66. - **释放远低于报告值**:正常现象 —— 文件进了回收站,空间尚未释放。脚本会报告回收站占用;用户想立即腾出空间就手动清空回收站,不要代为执行(清空不可逆,会连带抹掉用户自己手动删的文件)。
  67. - **`-Clean` 后浏览器没回来**:脚本按原路径重启;若失败,手动启动对应 exe(Edge: `C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe`)。
  68. - **脚本报权限错误**:需要管理员权限的命令(如 DISM 清理 WinSxS)不要自己尝试提权,报告给用户让他用管理员终端跑。
  69. ## Windows (win32) platform notes
  70. 脚本是 PowerShell,Windows 专用。在 PowerShell 7 (`pwsh`) 和 Windows PowerShell 5.1 下都能跑。
  71. 调用时用 `pwsh -File <绝对路径>`。如果当前 shell 已经是 PowerShell,直接 `& <绝对路径>` 调用脚本即可,不要嵌套 `powershell -Command`。
  72. 输出含中文,读取脚本输出时用 `-Encoding UTF8`。写入文件用 UTF8 避免中文乱码。
  73. ## Examples
  74. **Input**: 「C盘没空间了,帮我清理一下」
  75. → 体检 → `-Clean` → 汇报释放量与剩余大项。不问确认。
  76. **Input**: 「看看 C 盘什么占地方」
  77. → 体检 + `-Deep` → 只报告,不删除。
README · README · 38 lines
  1. disk-cleanup
  2. ===========
  3. Windows 磁盘空间体检与清理 skill —— 给 MiniMax Code / Claude Code 用。
  4. 它扫描磁盘占用点,清理「删了会自动重建」的东西(浏览器离线缓存、应用更新
  5. 安装包、过期日志、临时文件),并且把「不能删」的东西用代码护栏钉死:
  6. 用户字体、浏览器登录态(IndexedDB / Cookies / Local Storage / Bookmarks /
  7. History)、用户文档照片桌面、数据库本体、虚拟磁盘镜像、项目源码与依赖。
  8. 所有删除走 Windows 回收站,可恢复;脚本不自动清空回收站,由你决定何时清。
  9. 安装(仓库根目录即 skill 本体,克隆后直接可用):
  10. git clone --depth 1 https://github.com/hujinlong989/disk-cleanup.git "$env:USERPROFILE\.minimax\skills\disk-cleanup"
  11. git clone --depth 1 https://github.com/hujinlong989/disk-cleanup.git "$env:USERPROFILE\.claude\skills\disk-cleanup"
  12. 装好后对 AI 说「C盘没空间了,帮我清理一下」即触发。也可以手动跑:
  13. pwsh -File scripts/disk-clean.ps1 # 体检
  14. pwsh -File scripts/disk-clean.ps1 -Clean # 清理
  15. pwsh -File scripts/disk-clean.ps1 -Deep # 深挖
  16. pwsh -File scripts/disk-clean.ps1 -Json # JSON 输出
  17. 完整说明(效果数据、安全设计三层、参数表、边界与已知问题)见 docs/README.md。
  18. 目录结构:
  19. SKILL.md skill 主体:触发条件 + 操作流程 + 汇报格式
  20. scripts/disk-clean.ps1 执行脚本:体检 / 清理 / 深挖 / JSON
  21. references/categories.md 类别清单与护栏边界(判定有疑问时才读)
  22. docs/README.md 完整人类文档
  23. LICENSE MIT
  24. 注意:根目录的 README 是纯文本占位(skill 目录不允许放 README.md,
  25. 会触发 skill-creator 的 lint 报错),带格式的完整文档在 docs/ 下。
  26. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.