Skill: zx0018/c-cleaner-zx (version 1.0.5)

# 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 制作


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)