Geek-skills-c-drive-cleaner - Claude MCP Skill

# 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:\
   ```

### 定期维护建议

| 频率 | 操作 | 脚本 |
|------|------|------|
| 每周 | 清理临时文件 | `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` 脚本添加自定义清理位置:

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

### 批量处理

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

```batch
@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磁盘管理解决方案,通过分析、查找、清理三步走策略,帮助用户安全高效地释放磁盘空间。使用时请遵循安全注意事项,先分析后清理,保持定期维护习惯。