back
loading skill details...
安全扫描并分析 Windows C 盘空间和文件,支持临时文件清理、重复文件去重及大文件迁移,所有修改需用户确认。
# C 盘清理助手 (C-Cleaner) 🧹
Windows C 盘清理 Skill - 安全扫描、汇报、清理、迁移
---
## 🔐 安全原则(核心!)
**本 Skill 采用混合模式,严格遵守以下安全原则:**
| 操作类型 | 处理方式 |
|----------|----------|
| **扫描/分析/汇报** | ✅ 可以主动执行 |
| **删除文件** | ❌ **必须先问用户!** |
| **清理操作** | ❌ **必须先问用户!** |
| **移动文件** | ❌ **必须先问用户!** |
| **迁移文件** | ❌ **必须先问用户!** |
**任何删除/迁移操作前,Roxy 必须得到用户明确确认才能执行!**
---
## 📋 功能特性
### 阶段 1:扫描分析
- ✅ 磁盘空间分析(总容量、已用、可用)
- ✅ 目录大小扫描(Windows、Users、Program Files 等)
- ✅ 临时文件检测(Windows Temp、用户 Temp、回收站)
- ✅ 大文件扫描(可配置阈值)
- ✅ 重复文件扫描(基于文件名/哈希值)
### 阶段 2:删除和去重
- ⚠️ 临时文件清理(需确认)
- ⚠️ 回收站清空(需确认)
- ⚠️ Windows 更新缓存清理(需确认)
- ⚠️ 重复文件处理(需确认)
### 阶段 3:迁移大文件
- ⚠️ 大文件识别(需确认)
- ⚠️ 迁移到服务器(需确认)
- ⚠️ 原文件删除(需确认)
- ✅ 迁移日志记录
### 阶段 4:本地迁移目录管理
- ✅ 目录结构整理
- ✅ 索引生成
- ✅ 空间统计
---
## 🚀 使用方法
### 触发词
```
- 清理 C 盘
- 扫描 C 盘
- C 盘分析
- 查找大文件
- 查找重复文件
- 迁移大文件
- C 盘清理助手
```
### 命令模式
```bash
# 只扫描不删除(安全模式)
/c-cleaner scan --safe
# 扫描并汇报可清理项
/c-cleaner report
# 清理指定项目(需要确认)
/c-cleaner cleanup --target temp
# 迁移大文件
/c-cleaner migrate --size 100MB --target /migration/path
```
---
## 📁 配置说明
### 白名单目录(受保护,不能删除)
```json
{
"protectedPaths": [
"C:\\Windows\\System32",
"C:\\Program Files",
"C:\\Program Files (x86)",
"C:\\Users\\*\\Documents",
"C:\\Users\\*\\Desktop",
"C:\\Users\\*\\Pictures",
"C:\\Users\\*\\Videos"
]
}
```
### 迁移配置
```json
{
"migrationTarget": "/path/to/migration-target/",
"categories": {
"VMware": ["*.iso", "*.zip"],
"PDF": ["*.pdf"],
"Videos": ["*.mp4", "*.avi", "*.mkv"],
"Archive": ["*.zip", "*.rar", "*.7z"]
}
}
```
### 扫描阈值
```json
{
"largeFileSizeMB": 100,
"duplicateMinSizeMB": 1,
"tempFileMaxAgeDays": 30
}
```
---
## 📝 输出示例
### 扫描报告
```markdown
## 📊 C 盘扫描报告
### 磁盘总览
| 项目 | 大小 |
|------|------|
| 总容量 | 247.7 GB |
| 已使用 | 206.8 GB |
| 可用空间 | 40.9 GB (16.5%) |
### 可清理项目
| 项目 | 大小 | 建议 |
|------|------|------|
| Windows Temp | 6.5 MB | ✅ 可清理 |
| 用户 Temp | 472.4 MB | ✅ 可清理 |
| 回收站 | 0 GB | 已空 |
| Windows 更新缓存 | 164.9 MB | ✅ 可清理 |
### 大文件 TOP 5
| 文件 | 大小 | 位置 |
|------|------|------|
| xxx.iso | 4.5 GB | C:\Downloads\ |
| yyy.zip | 2.1 GB | C:\Users\USERNAME\Downloads\ |
```
### 删除确认提示
```
喵~Roxy 准备执行以下操作,请老师确认喵!🐾
【操作类型】删除临时文件
【影响范围】
- C:\Windows\Temp\* (6.5 MB)
- C:\Users\xxx\AppData\Local\Temp\* (472.4 MB)
【预计释放】约 479 MB
【风险提示】临时文件可安全删除,不影响系统运行
⚠️ 安全确认
根据安全原则,Roxy 必须得到老师明确确认才能执行删除操作!
请老师回复:
- "确认删除" → Roxy 开始删除
- "取消" → Roxy 跳过此操作
- "只删除 Temp" → Roxy 只删除指定项目
```
---
## ⚠️ 注意事项
### 安全原则
1. **任何删除操作必须先问用户!**
2. **白名单目录绝对不能动!**
3. **迁移前必须确认目标位置!**
4. **删除前必须备份或确认!**
5. **所有操作必须记录日志!**
### ⚠️ 数据迁移风险(重要!)
**本 Skill 的迁移功能会将文件从 Windows 主机传输到代理服务器:**
```
Windows 主机 (C:\) → 代理服务器 (/path/to/migration-target/)
```
**这意味着:**
- 📤 文件会离开原始 Windows 主机(数据导出)
- 🔐 代理服务器需要有足够的存储空间
- 🛡️ 确保你信任代理服务器和存储位置
- 🚫 如果不想让文件离开 Windows 主机,**不要使用迁移功能**
**安全使用建议:**
1. **只使用扫描模式** - `/c-cleaner scan --safe`
2. **不提供迁移凭证** - 不设置 `MIGRATION_TARGET` 环境变量
3. **审查日志** - 定期检查 `upload-log.jsonl` 了解文件传输情况
4. **限制权限** - 使用专用的 WinRM 账户,限制访问权限
---
## 📁 文件结构
```
c-cleaner/
├── SKILL.md # 本文件
├── README.md # 使用指南
├── _meta.json # 元数据
├── .gitignore # Git 忽略文件
├── scripts/
│ ├── scan.ps1 # 扫描脚本
│ ├── cleanup.ps1 # 清理脚本
│ ├── migrate.ps1 # 迁移脚本
│ └── dedup.ps1 # 去重脚本
├── config/
│ ├── whitelist.json # 白名单配置
│ ├── migration.json # 迁移配置
│ ├── thresholds.json # 阈值配置
│ └── credentials.example.json # 凭证配置示例
└── references/
├── safety-rules.md # 安全规则
└── path-assumptions.md # 路径假设说明
```
---
## 🔧 技术依赖
- **WinRM/PowerShell Remoting** - Windows 远程执行(HTTPS 推荐)
- **Python 3.x** - 服务器端脚本
- **wget/curl** - 文件传输
## 🔐 凭证配置
### 环境变量(推荐)
```bash
# Windows WinRM 凭证
export WINRM_HOST="WINDOWS_HOST_IP"
export WINRM_USER="WINDOWS_USER"
export WINRM_PASS="secure_password"
# 迁移目标配置
export MIGRATION_TARGET="/path/to/migration-target/"
```
### 安全建议
1. **不要明文存储密码** - 使用环境变量或密钥管理服务
2. **WinRM over HTTPS** - 不要使用 `AllowUnencrypted` 或 `Basic` 认证
3. **限制访问来源** - 配置 WinRM 只允许特定 IP 访问
4. **定期轮换凭证** - 定期更换 WinRM 密码
## 📁 路径说明
### Windows 目标路径
- `C:\` - 远程 Windows 主机的 C 盘(通过 WinRM 访问)
- `C:\Windows\Temp` - Windows 临时文件目录
- `C:\Users\*\AppData\Local\Temp` - 用户临时文件目录
### 迁移目标路径
- `/path/to/migration-target/` - **代理服务器上的路径**(Linux)
- 文件从 Windows 主机传输到代理服务器存储
- 需要确保代理服务器可访问且有写入权限
### 传输方式
- **WinRM** - 通过 PowerShell 远程复制文件
- **SCP/SFTP** - 通过 SSH 传输(如果 Windows 开启 SSH)
- **SMB** - 通过 SMB 共享挂载
---
_本 Skill 严格遵守 C 盘数据安全原则,任何删除/迁移操作都需要用户明确确认。_
🐾 Roxy 制作
don't have the plugin yet? install it then click "run inline in claude" again.