Clyan — 给 AI Agent 用的磁盘清理工具

一个由 AI agent 驱动的命令行磁盘清理工具。你可以通过 CLI 或 MCP 协议与它交互，说一句话就能完成全盘扫描、垃圾识别、空间释放。

功能

• 26+ 缓存检测器：npm / pip / cargo / Go / Docker / IDE 缓存 / 浏览器缓存 / Windows 系统缓存 / 开发垃圾

• 重复文件检测：三步检测（按大小分组 → BLAKE2b 部分哈希 → 全量哈希）

• Windows 深度清理：WinSxS 组件存储、Windows.old 旧系统、DriverStore 驱动备份、Delivery Optimization 缓存、DISM 清理

• 三级安全体系：Safe（安全可删）/ Caution（谨慎，可能需重建）/ Unsafe（不可删，含配置/凭据），配合保护路径系统和豁免规则

• 回收站 + 历史回溯：默认走回收站，SQLite 记录每次操作，支持按 ID 撤销

• MCP 服务器：AI agent 可通过 Model Context Protocol 直接调用所有工具（无需 CLI subprocess）

• 并行高速模式：ThreadPoolExecutor 并发删除 + ProcessPoolExecutor 并发扫描

• 安全边界：%APPDATA%\npm 等全局包管理器目录受保护，不被误清理

Related MCP server: MCP Filesystem Server

快速开始

pip install -e .
# 全盘快速体检
clyan scan quick C:\
# 只看大件开发垃圾
clyan scan dev-garbage C:\ --min-size-mb 100
# 预览清理结果
clyan clean --items items.json --dry-run
# 执行清理（大文件直接删，不走回收站）
clyan clean --items items.json --fast

命令

MCP 服务器

启动 MCP 服务器后，AI agent 可以通过 stdio 传输协议直接调用所有功能：

clyan mcp

暴露的 MCP 工具：

• scan_quick / scan_dev_garbage / scan_browsers / scan_system / scan_duplicates

• clean_preview / clean_execute

• history

安全体系

采用 三层危险等级 + 保护路径 + 豁免规则 的组合策略：

保护路径（31条）：C:\Windows、C:\Program Files、%APPDATA%\npm、Desktop、Documents、.ssh、.git……

豁免规则（34条）：node_modules/（排除全局 npm）、Temp/、.cache/、assembly/、dist/（排除 npm 内）……

参考项目

Clyan 的设计和实现参考了以下开源项目：