📦 磁盘垃圾清理大师 — 磁盘垃圾清理助手

自动扫描磁盘，找出老文件、大文件、垃圾临时文件，生成 垃圾桶.md 供用户审核，确认后才执行清理。

工作流程

整个流程分为 3 个阶段，必须严格按顺序执行：

Phase 1: 扫描 → Phase 2: 生成垃圾桶.md → Phase 3: 用户确认后清理

Phase 1: 扫描磁盘

• 询问用户要扫描的路径（如 C:\Users\UncleC），如果用户未指定，默认扫描用户主目录
• 询问扫描参数（可选，提供默认值）：

• 运行扫描脚本：

   C:\Python314\python.exe "{SKILL_DIR}/scripts/scan_disk.py" "<扫描路径>" --old-days <天数> --large-mb <阈值MB> [--quick] [--exclude "关键词1,关键词2"] -o "<输出JSON路径>"
   

• 读取扫描结果 JSON，进入 Phase 2

Phase 2: 生成垃圾桶.md

根据扫描结果，在桌面生成 垃圾桶.md。

生成规则（按实操经验优化）：

• 路径必须是 Windows 绝对路径格式（如 C:\Users\...）
• 每个路径独占一行，放在表格中
• 智能分组归类：属于同一项目的多个文件应合并为一组（如 hfish 蜜罐工具的整个 3.3.6 目录），标注项目名称和总大小
• 分类展示：缓存目录 → 垃圾临时文件 → 老文件（按项目分组） → 大文件（按用途分组） → 空文件夹
• 每类标注数量和总大小
• 大文件应按用途进一步分组：已安装的安装包 / 临时中间数据 / 测试环境缓存 / 视频缓存等
• 排除项区域：底部必须增加 ⚠️ 已排除 区域，列出被排除的文件及原因
• 系统文件排除：Windows 系统文件（desktop.ini、ntuser.dat.LOG、.regtrans-ms 等）不要列入清理列表，放入排除项区域

垃圾桶.md 格式模板：

# 🗑️ 垃圾桶 - 待清理清单
⚠️ 请仔细审核以下内容！删除前请确认这些文件确实不再需要。
修改规则：删除不想清理的行（整行删掉即可），保留的要清理的行不动。
修改完保存后，告诉我"确认清理"即可执行。
扫描时间：YYYY-MM-DD HH:MM
扫描路径：C:\Users\XXX
潜在可回收空间：X.XGB
📦 缓存目录（共 X 个，占 X.XX GB）
路径
大小
天数

🗂️ 垃圾临时文件（共 X 个，占 X.XX KB）
路径
大小
修改时间

⏰ 老文件（超过 180 天未访问，共 X 组，占 X.XX GB）
📁 项目名称（~XXXMB，XXX天）
路径
大小
说明

🐋 大文件（超过 100MB，共 X 个，占 X.XX GB）
🔧 已安装的安装包（可安全删除，约 X.XGB）
路径
大小
修改时间
天数
说明

🗃️ 临时/中间数据文件（约 X.XGB）
路径
大小
修改时间
天数
说明

🧪 测试环境缓存（约 X.XGB）
路径
大小
修改时间
天数
说明

🎬 视频/音频缓存（约 X.XGB）
路径
大小
修改时间
天数
说明

🫙 空文件夹（共 X 个）
路径

⚠️ 已排除（不清理）
排除项
原因
XXX 相关文件
用户要求保留
Windows 系统文件（desktop.ini、ntuser.dat.LOG 等）
系统关键文件

关键规则：

• 垃圾桶.md 必须包含完整的绝对路径，每行一个路径
• 路径不能模糊，必须精确到文件/文件夹级别
• 同一项目的多个文件必须合并展示（如 3.3.6 目录下的几十个文件归为一组）
• 缓存目录和大文件要特别标注，引起用户注意
• 告知用户：修改垃圾桶.md，删除不想清理的行，保留要清理的行

Phase 3: 用户确认后清理

• 等待用户修改垃圾桶.md 并回复"确认清理"（或类似意思）
• 如果用户要求排除某些文件/项目：

   C:\Python314\python.exe "{SKILL_DIR}/scripts/delete_trash.py" "<垃圾桶.md路径>" --output "<结果JSON路径>"
   

C:\Python314\python.exe "{SKILL_DIR}/scripts/scan_disk.py" "C:\Users\UncleC" --old-days 180 --large-mb 100 -o "scan_result.json"