DiskSweeper 磁盘清道夫

磁盘满了，但不知道删什么

C 盘告警、备份盘塞满、项目目录膨胀——常见困境不是「没有清理工具」，而是不知道空间被谁占走、重复拷贝是否安全删、以及误删系统文件的风险。本技能面向这类运维与桌面场景：在对话里说明目录与目标（腾空间、找重复、清临时文件），由 Agent 调用 scripts/tool.py 中的纯 Python 函数处理，全程标准库（os.walk、hashlib），无额外依赖。

核心能力与工作流程

• scan_duplicates(directory)：两轮策略——先按文件大小分组，再对候选组计算哈希（资料中支持按名称、大小、MD5 匹配），输出可对照的重复文件列表，便于你决定保留哪一份。
• analyze_disk_space(directory, top_n)：遍历目录统计占用，返回 Top N 大文件，先把「大块」找出来再谈清理。
• clean_temp_files(directory)：针对 .tmp、.log、.cache 等模式清理临时文件；技能描述还覆盖 Windows 系统垃圾、浏览器缓存（Chrome/Edge/Firefox）等场景，具体范围以实际函数实现为准。

函数返回 JSON 结构化结果（文件信息、空间统计、统一错误格式），并按可释放空间排序，方便 Agent 优先建议高收益操作。大文件哈希采用采样策略，在性能与准确度之间折中。

适用边界与注意点

• 本技能是 分析与清理辅助，删除前应利用「预览再确认」流程，避免误删仍在使用的配置或数据。
• 权限不足、目录不存在等异常会以统一错误格式返回，需要以管理员身份或调整目标路径后重试。
• 浏览器与系统级清理依赖你指定的目录与平台环境；跨盘符、网络挂载盘扫描可能较慢，宜先缩小 directory 范围再全量扫。