disk-cleaner 是一个跨平台磁盘空间管理工具包，以技能（Skill）形式提供给 AI IDE 与智能体使用。根据资料，它要求 Python 3.7+，可与所有 AI IDE（如 Cursor、Windsurf、Continue、Aider、Claude Code 等）配合，支持 Windows、macOS、Linux，且不依赖外部组件。
用途 主要用于磁盘空间分析、垃圾文件清理、重复文件查找、磁盘增长趋势分析、文件归档整理以及磁盘使用监控。它面向需要管理大容量磁盘、多用户目录或大量文件的场景，尤其适合由 AI 智能体自动执行磁盘分析任务。
主要能力
- 渐进式扫描：针对大磁盘（>100GB）提供快速采样（约 1 秒估算磁盘大小与扫描时间）、渐进扫描（约 30 秒获得部分结果）、智能时间限制、每 2 秒进度反馈、可 Ctrl+C 中断并保留部分结果。
- 智能引导：自动搜索 20+ 常见技能包位置，支持 DISK_CLEANER_SKILL_PATH 环境变量覆盖，自动导入 diskcleaner 模块，跨平台检测 python 与 python3。
- 性能优化：QuickProfiler 快速采样、ConcurrentScanner 多线程 I/O（3-5 倍加速）、os.scandir() 优化、IncrementalCache 缓存、内存监控、提前停止、增强缓存检测（26+ 缓存路径）。
- v2.2+ 新功能：重复文件检测与删除、增长趋势分析与磁盘满预测、交互式清理向导、文件归档整理（4 种策略）、增强扫描限制（500K 文件、120 秒超时）、深度扫描模式 --deep-scan、Windows 目录支持 --include-windows。
- 安全与可靠性：check_skill.py 诊断工具、ASCII 安全输出、清理默认 --dry-run、保护系统目录与可执行文件、错误优雅降级、兼容 GBK/UTF-8。
- 多智能体加速：支持通过子智能体或并行子进程对多个顶层目录、多个用户配置文件进行并行扫描，资料给出 3-4 个智能体为较优平衡，并说明并非所有 AI IDE 都支持子智能体，不支持时可回退到并行子进程。
使用方式 资料列出 13+ 脚本，包括：analyze_disk.py（磁盘分析，支持 --sample、--file-limit、--time-limit）、analyze_progressive.py（渐进扫描，--max-seconds）、find_duplicates.py（重复文件检测）、analyze_growth.py（增长趋势分析）、clean_disk.py（安全清理垃圾文件）、interactive_wizard.py（交互式清理向导）、organize_files.py（文件归档整理）、monitor_disk.py（磁盘监控）、check_skill.py（诊断）、skill_bootstrap.py（引导模块）、package_skill.py（打包工具）、scheduler.py（自动调度）。
典型流程：先运行 check_skill.py 诊断，再运行 --sample 快速采样，根据估算时间选择完整扫描、限时扫描或渐进扫描；清理时先使用 --dry-run 预览，获得用户确认后再执行。
macOS QQ 媒体清理 提供 scripts/qq_cleanup_macos.zsh，用于 QQ 图片或表情占用过多空间且需保留聊天记录的场景。支持 audit 审计、clean --older-than-days 90 --categories Pic,Emoji 预览，需用户明确批准后加 --execute 执行；脚本仅接受 Pic 和 Emoji，默认预览，QQ 运行中拒绝执行，并警告删除的本地媒体可能无法在旧会话中再查看。
适用场景
- 大容量磁盘或多磁盘的快速空间分析。
- 多用户配置文件、大量文件（>100K）的并行扫描。
- 安全清理垃圾文件、重复文件与缓存。
- 磁盘使用趋势跟踪与容量预测。
- macOS 上 QQ 图片/表情的定向清理。
限制
- 需要 Python 3.7+，资料未提供无 Python 环境下的完整替代方案（仅提及 NO_PYTHON_GUIDE.md）。
- 脚本输出禁止使用 emoji，以保证跨平台兼容；面向人类的报告建议使用 emoji。
- 多智能体并行依赖 AI IDE 是否支持子智能体，不支持时需回退到并行子进程。
- 清理操作默认安全预览，实际删除需用户确认。
- 资料未提供具体收费、价格、平台商店信息或效果保证。