C 盘清理助手 (C-Cleaner) 🧹

Windows C 盘清理 Skill - 安全扫描、汇报、清理、迁移

🔐 安全原则（核心！）

本 Skill 采用混合模式，严格遵守以下安全原则：

任何删除/迁移操作前，Roxy 必须得到用户明确确认才能执行！

📋 功能特性

阶段 1：扫描分析

• ✅ 磁盘空间分析（总容量、已用、可用）
• ✅ 目录大小扫描（Windows、Users、Program Files 等）
• ✅ 临时文件检测（Windows Temp、用户 Temp、回收站）
• ✅ 大文件扫描（可配置阈值）
• ✅ 重复文件扫描（基于文件名/哈希值）

阶段 2：删除和去重

• ⚠️ 临时文件清理（需确认）
• ⚠️ 回收站清空（需确认）
• ⚠️ Windows 更新缓存清理（需确认）
• ⚠️ 重复文件处理（需确认）

阶段 3：迁移大文件

• ⚠️ 大文件识别（需确认）
• ⚠️ 迁移到服务器（需确认）
• ⚠️ 原文件删除（需确认）
• ✅ 迁移日志记录

阶段 4：本地迁移目录管理

• ✅ 目录结构整理
• ✅ 索引生成
• ✅ 空间统计

🚀 使用方法

触发词

- 清理 C 盘
- 扫描 C 盘
- C 盘分析
- 查找大文件
- 查找重复文件
- 迁移大文件
- C 盘清理助手

命令模式

# 只扫描不删除（安全模式）
/c-cleaner scan --safe

# 扫描并汇报可清理项
/c-cleaner report

# 清理指定项目（需要确认）
/c-cleaner cleanup --target temp

# 迁移大文件
/c-cleaner migrate --size 100MB --target /migration/path

📁 配置说明

白名单目录（受保护，不能删除）

{
  "protectedPaths": [
    "C:\\Windows\\System32",
    "C:\\Program Files",
    "C:\\Program Files (x86)",
    "C:\\Users\\*\\Documents",
    "C:\\Users\\*\\Desktop",
    "C:\\Users\\*\\Pictures",
    "C:\\Users\\*\\Videos"
  ]
}

迁移配置

{
  "migrationTarget": "/home/itadmin/windows-migration/",
  "categories": {
    "VMware": ["*.iso", "*.zip"],
    "PDF": ["*.pdf"],
    "Videos": ["*.mp4", "*.avi", "*.mkv"],
    "Archive": ["*.zip", "*.rar", "*.7z"]
  }
}

扫描阈值

{
  "largeFileSizeMB": 100,
  "duplicateMinSizeMB": 1,
  "tempFileMaxAgeDays": 30
}

📝 输出示例

扫描报告

## 📊 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\xxx\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:\) → 代理服务器 (/home/itadmin/windows-migration/)

这意味着：

• 📤 文件会离开原始 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 - 文件传输

🔐 凭证配置

环境变量（推荐）

# Windows WinRM 凭证
export WINRM_HOST="10.0.5.195"
export WINRM_USER="[email protected]"
export WINRM_PASS="secure_password"

# 迁移目标配置
export MIGRATION_TARGET="/home/itadmin/windows-migration/"

安全建议

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 - 用户临时文件目录

迁移目标路径

• /home/itadmin/windows-migration/ - 代理服务器上的路径（Linux）
• 文件从 Windows 主机传输到代理服务器存储
• 需要确保代理服务器可访问且有写入权限

传输方式

• WinRM - 通过 PowerShell 远程复制文件
• SCP/SFTP - 通过 SSH 传输（如果 Windows 开启 SSH）
• SMB - 通过 SMB 共享挂载

本 Skill 严格遵守 C 盘数据安全原则，任何删除/迁移操作都需要用户明确确认。

🐾 Roxy 制作