ClaudeSkills Geek-skills-c-drive-cleaner

Windows C盘清理和磁盘空间管理工具。当用户需要清理C盘、释放磁盘空间、查找大文件、分析磁盘占用、删除临时文件、清理缓存、管理Windows系统垃圾文件时使用此skill。适用于以下场景:(1)C盘空间不足需要清理;(2)查找和删除大文件;(3)分析磁盘空间占用;(4)清理系统临时文件和缓存;(5)清理浏览器缓存;(6)清理回收站;(7)清理系统日志;(8)优化Windows磁盘空间。

install
source · Clone the upstream repo
git clone https://github.com/staruhub/ClaudeSkills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/staruhub/ClaudeSkills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/Geek-skills-c-drive-cleaner" ~/.claude/skills/staruhub-claudeskills-geek-skills-c-drive-cleaner && rm -rf "$T"
manifest: skills/Geek-skills-c-drive-cleaner/SKILL.md
source content

C盘清理大师

专业的Windows C盘清理和磁盘空间管理工具,帮助用户安全高效地释放磁盘空间。

核心功能

  1. 磁盘空间分析 - 分析目录结构,找出占用空间最大的文件和目录
  2. 临时文件清理 - 清理Windows临时文件、浏览器缓存、系统日志
  3. 大文件查找 - 快速定位磁盘中的大文件,支持按类型过滤
  4. 安全清理 - 模拟模式预览,避免误删重要文件

使用流程

1. 首先分析磁盘占用

在执行清理之前,先分析磁盘空间占用情况,了解哪些目录占用空间最多:

python scripts/analyze_disk.py C:\ 2 20

参数说明:

  • C:\
    - 要分析的目录路径
  • 2
    - 扫描深度(默认2层)
  • 20
    - 显示前N个最大项(默认20)

输出示例:

  • 前20个最大目录及其大小
  • 大于100MB的文件列表
  • 总计扫描空间

2. 查找大文件

使用大文件查找工具定位可能可以删除的大文件:

python scripts/find_large_files.py C:\ 100 50

参数说明:

  • C:\
    - 搜索路径
  • 100
    - 最小文件大小(MB)
  • 50
    - 最大返回结果数

按文件类型查找:

python scripts/find_large_files.py C:\Users 200 100 .mp4,.avi,.mkv

常见大文件类型:

  • 视频:
    .mp4,.avi,.mkv,.mov,.wmv
  • 安装包:
    .iso,.exe,.msi
  • 压缩包:
    .zip,.rar,.7z
  • 数据库备份:
    .bak,.sql

3. 执行清理

清理脚本默认在模拟模式下运行,不会实际删除文件:

# 模拟模式 - 预览将要清理的内容
python scripts/clean_temp.py

# 实际执行 - 需要确认
python scripts/clean_temp.py --execute

清理内容包括:

  • Windows临时文件 (
    %TEMP%
    ,
    C:\Windows\Temp
    )
  • 浏览器缓存 (Chrome, Edge, Firefox)
  • 系统日志文件 (
    .log
    ,
    .etl
    ,
    .old
    )
  • 回收站内容

安全特性:

  • 默认模拟模式,预览清理结果
  • 使用
    --execute
    需要二次确认
  • 自动跳过系统关键目录
  • 详细显示清理过程和结果

详细参考文档

如需了解更多Windows清理知识,查看参考文档:

view references/windows_cleanup_guide.md

参考文档包含:

  • 常见垃圾文件位置和清理建议
  • 不应删除的系统目录列表
  • 磁盘空间分析和优化建议
  • 常用清理命令和高级技巧
  • 文件类型和扩展名参考
  • 安全注意事项和最佳实践

使用建议

推荐工作流程

  1. 分析阶段

    # 分析C盘整体占用
    python scripts/analyze_disk.py C:\
    
    # 查找大文件
    python scripts/find_large_files.py C:\ 500 30
    
  2. 清理阶段

    # 先模拟运行,查看效果
    python scripts/clean_temp.py
    
    # 确认无误后执行实际清理
    python scripts/clean_temp.py --execute
    
  3. 验证阶段

    # 清理后再次分析,确认效果
    python scripts/analyze_disk.py C:\
    

定期维护建议

频率操作脚本
每周清理临时文件
clean_temp.py
每月查找大文件
find_large_files.py
每季度完整分析
analyze_disk.py

安全注意事项

清理前必做

  1. 创建系统还原点 - 在控制面板创建还原点
  2. 备份重要数据 - 确保关键文件已备份
  3. 关闭相关程序 - 清理浏览器缓存前关闭浏览器
  4. 使用模拟模式 - 先预览清理内容再执行

不要做的事

绝对不要手动删除这些目录:

  • C:\Windows\System32
    - 核心系统文件
  • C:\Windows\WinSxS
    - Windows组件存储
  • C:\Program Files
    - 已安装程序
  • C:\ProgramData
    - 程序数据

不建议清理:

  • C:\Windows\Prefetch
    - 预读取文件,影响启动速度
  • 休眠文件和虚拟内存 - 应通过系统设置调整

权限要求

  • 清理某些系统文件需要管理员权限
  • 在PowerShell或CMD中右键选择"以管理员身份运行"
  • 脚本会自动跳过无权限访问的目录

故障排除

常见问题

Q: 脚本报告"无权限访问"

  • A: 以管理员身份运行命令行工具

Q: 清理后空间没有明显变化

  • A: 检查分析报告,可能需要手动删除大文件或卸载不需要的程序

Q: 浏览器缓存清理失败

  • A: 关闭所有浏览器窗口后重试

Q: 删除文件后能恢复吗

  • A: 删除的文件不经过回收站,建议清理前仔细检查

高级功能

自定义清理

可以修改

clean_temp.py
脚本添加自定义清理位置:

# 在 clean_temp_files() 函数中添加
temp_locations.append('C:\\自定义\\路径')

批量处理

创建批处理文件自动化清理任务:

@echo off
echo 开始分析磁盘...
python scripts/analyze_disk.py C:\

echo 查找大文件...
python scripts/find_large_files.py C:\ 500 20

echo 执行清理...
python scripts/clean_temp.py --execute

pause

脚本说明

analyze_disk.py

  • 功能: 分析目录结构,找出占用空间最大的目录和文件
  • 特点: 递归扫描,显示大文件,自动跳过无权限目录
  • 输出: 目录大小排行,大文件列表,总计空间

find_large_files.py

  • 功能: 查找指定大小以上的文件
  • 特点: 支持文件类型过滤,显示访问时间,按类型统计
  • 输出: 大文件列表,类型统计,时间信息

clean_temp.py

  • 功能: 清理临时文件、缓存、日志、回收站
  • 特点: 模拟模式安全预览,二次确认机制,详细清理报告
  • 输出: 清理前预览,清理过程,释放空间统计

最佳实践

  1. 渐进式清理: 先从临时文件开始,逐步深入
  2. 定期维护: 建立定期清理计划,避免空间危机
  3. 空间规划: 合理规划C盘空间,程序和数据分离
  4. 监控预警: 当C盘空间低于20%时及时清理
  5. 系统工具结合: 配合Windows磁盘清理工具使用

性能提示

  • 大文件查找可能需要较长时间,可使用 Ctrl+C 中断
  • 首次分析建议深度设为1-2层,避免过度扫描
  • 清理浏览器缓存时关闭浏览器可加快速度
  • SSD硬盘建议保留15-20%空间以维持性能

相关工具

除了本skill提供的脚本,还可以使用:

  • Windows磁盘清理:
    cleanmgr
  • 存储感知: Windows 10/11内置功能
  • DISM清理: 清理Windows组件存储
  • TreeSize: 第三方磁盘分析工具
  • CCleaner: 第三方清理工具

总结

C盘清理大师提供了一套完整的Windows磁盘管理解决方案,通过分析、查找、清理三步走策略,帮助用户安全高效地释放磁盘空间。使用时请遵循安全注意事项,先分析后清理,保持定期维护习惯。