mcpField
G
Geek-skills-c-drive-cleaner

Geek-skills-c-drive-cleaner

github.com/staruhubProductivity73165 installsUpdated 11w ago
Repository

About Geek-skills-c-drive-cleaner

A disk-cleanup skill for Windows users that analyzes usage, previews proposed cleanup, then verifies results after execution. It separates eligible files from protected system paths and leaves decisions about personal large files to the user.

Key features

  1. 01Analyze directory usage and large files
  2. 02Preview cleanup by default
  3. 03Require confirmation before deletion
  4. 04Verify freed space afterward
  5. 05Skip critical system directories

Use cases

  1. 01Find directories using substantial disk space
  2. 02Preview temporary-file and cache cleanup
  3. 03Check actual space freed after cleanup

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/staruhub/claudeskills --skill geek-skills-c-drive-cleaner

After installing, type/geek-skills-c-drive-cleanerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
windows_cleanup_guide.md
scripts/
analyze_disk.py
find_large_files.py
clean_temp.py

Details

From the project README

C盘清理大师

安全导向的 Windows 磁盘清理：分析 → 模拟 → 执行 → 验证，破坏性操作永远先预览。

验收标准（清理任务完成前自查）

  • 实际删除前完成过一次模拟运行，并把预览结果给用户看过
  • --execute 前用户明确确认过（清理不经过回收站，不可恢复）
  • 已提醒用户创建系统还原点和关闭浏览器（清缓存时）
  • 未触碰"禁删清单"中的任何目录
  • 清理后重跑分析,回报实际释放的空间数字,不是"应该清理了"
  • 用户个人大文件（视频/压缩包等）只报告位置与大小，删除由用户自己决定

禁删清单（碰到即停）

  • C:\Windows\System32 — 核心系统文件
  • C:\Windows\WinSxS — Windows 组件存储（要瘦身走 DISM，不许直接删）
  • C:\Program Files / C:\ProgramData — 已装程序及数据
  • C:\Windows\Prefetch — 预读取文件，删了拖慢启动
  • 休眠文件与虚拟内存 — 走系统设置调整，不手动删文件

工作流程

1. 分析占用
python scripts/analyze_disk.py C:\ 2 20    # 路径 深度 显示前N项
2. 查找大文件（只报告，不删）
python scripts/find_large_files.py C:\ 100 50            # 路径 最小MB 最大结果数
python scripts/find_large_files.py C:\Users 200 100 .mp4,.avi,.mkv   # 按类型过滤

常见大文件类型：视频 .mp4,.mkv,.mov；安装包 .iso,.exe,.msi；压缩包 .zip,.rar,.7z；备份 .bak,.sql。

3. 清理（默认模拟模式）
python scripts/clean_temp.py             # 模拟：只预览
python scripts/clean_temp.py --execute   # 实际执行：需二次确认

覆盖范围：%TEMP%、C:\Windows\Temp、浏览器缓存（Chrome/Edge/Firefox）、.log/.etl/.old 日志、回收站。

4. 验证

重跑 analyze_disk.py，对比前后数字回报实际效果。

已知陷阱

陷阱具体表现应对
无权限静默漏扫非管理员运行，扫描结果偏小误导判断提示以管理员身份运行；脚本会跳过无权目录并计数
浏览器缓存清理失败浏览器进程占用文件先关闭所有浏览器窗口再清
清完没效果临时文件本来就不大，大头是个人文件或程序回到大文件报告和目录排行,引导用户决策(卸载/转移)
误以为可恢复脚本删除不经回收站执行前明确告知不可恢复,这也是模拟先行的原因
SSD 清到贴满追求 100% 利用率SSD 保留 15-20% 空间维持性能;低于 20% 时才建议清理

权限与配套

  • 部分系统文件需管理员权限（右键"以管理员身份运行"）
  • 可配合系统自带工具：cleanmgr、存储感知、DISM 组件清理
  • 深入的垃圾文件位置、清理命令、安全实践：references/windows_cleanup_guide.md

脚本说明

脚本功能安全特性
scripts/analyze_disk.py目录占用排行 + 大文件列表只读；自动跳过无权目录
scripts/find_large_files.py按大小/类型查找文件只读；显示访问时间辅助判断
scripts/clean_temp.py清理临时文件/缓存/日志/回收站默认模拟；--execute 二次确认；跳过系统关键目录

Comments

Markdown supported