Geek-skills-c-drive-cleaner
- Repo stars 445
- Author repo ClaudeSkills
C盘清理大师
专业的Windows C盘清理和磁盘空间管理工具,帮助用户安全高效地释放磁盘空间。
核心功能
- 磁盘空间分析 - 分析目录结构,找出占用空间最大的文件和目录
- 临时文件清理 - 清理Windows临时文件、浏览器缓存、系统日志
- 大文件查找 - 快速定位磁盘中的大文件,支持按类型过滤
- 安全清理 - 模拟模式预览,避免误删重要文件
使用流程
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
参考文档包含:
- 常见垃圾文件位置和清理建议
- 不应删除的系统目录列表
- 磁盘空间分析和优化建议
- 常用清理命令和高级技巧
- 文件类型和扩展名参考
- 安全注意事项和最佳实践
使用建议
推荐工作流程
分析阶段
# 分析C盘整体占用 python scripts/analyze_disk.py C:\ # 查找大文件 python scripts/find_large_files.py C:\ 500 30清理阶段
# 先模拟运行,查看效果 python scripts/clean_temp.py # 确认无误后执行实际清理 python scripts/clean_temp.py --execute验证阶段
# 清理后再次分析,确认效果 python scripts/analyze_disk.py C:\
定期维护建议
| 频率 | 操作 | 脚本 |
|---|---|---|
| 每周 | 清理临时文件 | clean_temp.py |
| 每月 | 查找大文件 | find_large_files.py |
| 每季度 | 完整分析 | analyze_disk.py |
安全注意事项
清理前必做
- 创建系统还原点 - 在控制面板创建还原点
- 备份重要数据 - 确保关键文件已备份
- 关闭相关程序 - 清理浏览器缓存前关闭浏览器
- 使用模拟模式 - 先预览清理内容再执行
不要做的事
❌ 绝对不要手动删除这些目录:
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
- 功能: 清理临时文件、缓存、日志、回收站
- 特点: 模拟模式安全预览,二次确认机制,详细清理报告
- 输出: 清理前预览,清理过程,释放空间统计
最佳实践
- 渐进式清理: 先从临时文件开始,逐步深入
- 定期维护: 建立定期清理计划,避免空间危机
- 空间规划: 合理规划C盘空间,程序和数据分离
- 监控预警: 当C盘空间低于20%时及时清理
- 系统工具结合: 配合Windows磁盘清理工具使用
性能提示
- 大文件查找可能需要较长时间,可使用 Ctrl+C 中断
- 首次分析建议深度设为1-2层,避免过度扫描
- 清理浏览器缓存时关闭浏览器可加快速度
- SSD硬盘建议保留15-20%空间以维持性能
相关工具
除了本skill提供的脚本,还可以使用:
- Windows磁盘清理:
cleanmgr - 存储感知: Windows 10/11内置功能
- DISM清理: 清理Windows组件存储
- TreeSize: 第三方磁盘分析工具
- CCleaner: 第三方清理工具
总结
C盘清理大师提供了一套完整的Windows磁盘管理解决方案,通过分析、查找、清理三步走策略,帮助用户安全高效地释放磁盘空间。使用时请遵循安全注意事项,先分析后清理,保持定期维护习惯。
- Fluxly category
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 92 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @staruhub · v1.0.0 · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Guided setup
- External API key
- No requirement detected
- Detected OS requirements
- Windows
- Runtime requirements
- Python
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 磁盘空间分析 - 分析目录结构,找出占用空间最大的文件和目录 临时文件清理 - 清理Windows临时文件、浏览器缓存、系统日志 大文件查找 - 快速定位磁盘中的大文件,支持按类型过滤
使用流程
在执行清理之前,先分析磁盘空间占用情况,了解哪些目录占用空间最多: 参数说明: C:\ - 要分析的目录路径
使用大文件查找工具定位可能可以删除的大文件: 参数说明: C:\ - 搜索路径
清理脚本默认在模拟模式下运行,不会实际删除文件: 清理内容包括: Windows临时文件 (%TEMP%, C:\Windows\Temp)
如需了解更多Windows清理知识,查看参考文档: 参考文档包含: 常见垃圾文件位置和清理建议
# C盘清理大师
专业的Windows C盘清理和磁盘空间管理工具,帮助用户安全高效地释放磁盘空间。
## 核心功能
1. **磁盘空间分析** - 分析目录结构,找出占用空间最大的文件和目录
2. **临时文件清理** - 清理Windows临时文件、浏览器缓存、系统日志
3. **大文件查找** - 快速定位磁盘中的大文件,支持按类型过滤
4. **安全清理** - 模拟模式预览,避免误删重要文件
## 使用流程
### 1. 首先分析磁盘占用
在执行清理之前,先分析磁盘空间占用情况,了解哪些目录占用空间最多:
```bash
python scripts/analyze_disk.py C:\ 2 20
```
**参数说明**:
- `C:\` - 要分析的目录路径
- `2` - 扫描深度(默认2层)
- `20` - 显示前N个最大项(默认20)
**输出示例**:
- 前20个最大目录及其大小
- 大于100MB的文件列表
- 总计扫描空间
### 2. 查找大文件
使用大文件查找工具定位可能可以删除的大文件:
```bash
python scripts/find_large_files.py C:\ 100 50
```
**参数说明**:
- `C:\` - 搜索路径
- `100` - 最小文件大小(MB)
- `50` - 最大返回结果数
**按文件类型查找**:
```bash
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. 执行清理
清理脚本默认在**模拟模式**下运行,不会实际删除文件:
```bash
# 模拟模式 - 预览将要清理的内容
python scripts/clean_temp.py
# 实际执行 - 需要确认
python scripts/clean_temp.py --execute
```
**清理内容包括**:
- Windows临时文件 (`%TEMP%`, `C:\Windows\Temp`)
- 浏览器缓存 (Chrome, Edge, Firefox)
- 系统日志文件 (`.log`, `.etl`, `.old`)
- 回收站内容
**安全特性**:
- 默认模拟模式,预览清理结果
- 使用 `--execute` 需要二次确认
- 自动跳过系统关键目录
- 详细显示清理过程和结果
## 详细参考文档
如需了解更多Windows清理知识,查看参考文档:
```bash
view references/windows_cleanup_guide.md
```
**参考文档包含**:
- 常见垃圾文件位置和清理建议
- 不应删除的系统目录列表
- 磁盘空间分析和优化建议
- 常用清理命令和高级技巧
- 文件类型和扩展名参考
- 安全注意事项和最佳实践
## 使用建议
### 推荐工作流程
1. **分析阶段**
```bash
# 分析C盘整体占用
python scripts/analyze_disk.py C:\
# 查找大文件
python scripts/find_large_files.py C:\ 500 30
```
2. **清理阶段**
```bash
# 先模拟运行,查看效果
python scripts/clean_temp.py
# 确认无误后执行实际清理
python scripts/clean_temp.py --execute
```
3. **验证阶段**
```bash
# 清理后再次分析,确认效果
python scripts/analyze_disk.py C:\
```
### 定期维护建议
| 频率 | 操作 | 脚本 |
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> 核心功能 → 使用流程 → 1. 首先分析磁盘占用 → 2. 查找大文件 → 3. 执行清理 → 详细参考文档
terms -> 磁盘空间分析 · 临时文件清理 · 大文件查找 · 安全清理 · 参数说明 · 输出示例 · 按文件类型查找 · 常见大文件类型
files/cmd -> C:\ · 100 · .mp4,.avi,.mkv,.mov,.wmv · .iso,.exe,.msi · .zip,.rar,.7z · .bak,.sql · %TEMP% · C:\Windows\Temp
body sha256 -> f6a193385719
Decide Fit First
Design Intent
How To Use It
Boundaries And Review