clean-c-drive

Claude 磁盘清理器

⚠️ 免责声明（请先读我）：本技能与文档由 AI（Claude Fable 5）自行编写完成，项目实控人未做人工审查（我也不一定全部看得懂）。请使用者仔细阅读本文档和程序源码，充分理解后再使用，以减少使用风险。

🧹 人机协作磁盘清理工具

利用 WizTree 快速扫描 + AI 智能分析，高效清理磁盘空间。

English Documentation · 更新日志

---

为什么做这个？

C 盘爆满，却不敢清理？

大部分电脑使用者都有这样的困扰：

• C 盘用了一两年后越来越满，但不敢轻易清理
• 不知道哪些文件能删、哪些不能删，怕删错导致系统崩溃
• 找收费软件清理，或者网上找人帮忙（几十到一两百不等）

根本原因是：

1. 我们普通人不是电脑专家，不知道哪些能清理、哪些不能清理
2. 不知道哪些文件占用空间大

解决思路：

• 如果能快速找出占用大的文件
• 再让专业的人来判断能不能清理
• 这个问题就解决了！

这就是这个工具的做法：

WizTree 快速扫描（3-5秒）
        ↓
    导出磁盘占用数据
        ↓
    AI 专业分析：哪些占用大、哪些能清理
        ↓
    （为了安全，初级版本暂时）避开系统文件，列出可清理目录
        ↓
    用户确认后，执行清理

现在，普通用户也能安全、简单地自行清理 C 盘了。

---

核心理念

安全 · 简单 · 给权限就全自动

┌─────────────────────────────────────────────────┐
│  给管理员权限  →  AI 全自动：扫描→分析→清理     │
│  不给权限      →  AI 分析 + 人工执行清理脚本    │
└─────────────────────────────────────────────────┘

---

关于 Agent Skills

什么是 Agent Skills？

Agent Skill 是一种 极简巧妙的AI Agent架构设计理念，通过模块化、可复用的"技能"封装来扩展 AI通用模型的能力。本质上，它是将复杂的业务逻辑、操作流程、专业知识打包成标准化的 Markdown 指令和脚本，让用户通过简单命令（如 /clean-c-drive）触发完整的自动化工作流。 Agent Skills 代表了 AI 应用架构从"大而全的通用模型"向"精而专的模块化能力"演进的重要趋势。它通过渐进式披露解决了上下文窗口的限制，通过文件系统标准化实现了知识的可发现与可组合，最终让 AI Agent 从"能做"进化到"擅长做"，从"工具"升级为"专家"。 总体说来，从MCP、claude code cli、Agent Skills到最新发布的claude cowork来看，Anthropic司在最大化销售自家token的水平上，是专业的，是值得关注和学习的。

核心设计理念

1. 渐进式信息加载

• 启动时仅加载技能元数据（几百 tokens）
• 匹配任务时才加载完整指令（几千 tokens）
• 执行时按需加载脚本和资源
• 结果：相比传统方案，上下文消耗降低 95%+，大幅降低成本

2. 模块化与可组合

• 每个 Skill 是独立的目录结构（SKILL.md + 脚本 + 资源）
• 技能之间互不干扰，可独立验证
• 支持多个技能组合解决复杂问题
• 易于在团队、项目间共享和复用

3. 文件系统即知识网络

• 文件结构本身就构成了知识图谱
• AI Agent 可自主发现可用技能
• 理解技能间的依赖关系

核心优势

在本项目中的应用

这个清理工具正是 Agent Skill 设计理念的实践：

用户执行 /clean-c-drive
        ↓
  AI Agent 加载 Skill 指令和脚本
        ↓
  根据权限自动调整工作流（全自动 或 半自动）
        ↓
  调用 WizTree 扫描、AI 分析、执行清理

通过 Agent Skill，一个原本需要多个脚本、复杂参数、人工配置的任务，现在用户只需一条命令。

更多信息： 详见 Agent Skills 官方文档

---

特性

• ⚡ 极速扫描：使用 WizTree 的 MFT 扫描技术，秒级完成
• 🤖 AI 分析：智能识别可清理目录，按优先级分类
• 🎯 优先级分类：高/中/低三级清理建议
• 🔒 安全清理：永不删除系统文件和用户数据
• 🤝 人机协作：两种模式满足不同用户需求

两种模式

模式一：普通权限 CLI

👤 人类：扫描 + 导出数据
🤖 AI：分析 + 生成清理脚本
👤 人类：执行清理脚本

适合：注重安全的用户

模式二：管理员权限 CLI（推荐）

👤 人类：只需说"帮我清理C盘"
🤖 AI：自动扫描 + 分析 → 你确认方案 → 自动清理

适合：追求效率的用户

快速开始

前置要求

• WizTree - 免费磁盘空间分析器
• Claude Code CLI - Anthropic 的 CLI 工具
• Python 3.x

推荐使用 Opus 模型 本技能涉及文件系统操作和复杂的分析任务，建议使用 Claude Opus 模型以获得最佳效果。 在 Claude Code 中使用 /model opus 切换模型。

安装

1. 克隆仓库：

   git clone https://github.com/iziqing/-disk-cleaner.git
   cd -disk-cleaner
   

2. 将 WizTree 放入 WizTree/ 目录（或修改配置中的路径）

3. 安装为 Agent Skill（v1.1 起为标准 SKILL.md 结构）：

   # 用户级安装（推荐，所有项目可用）
   mkdir -p ~/.claude/skills/clean-c-drive
   cp -r SKILL.md scan.py analyze.py backup.py references ~/.claude/skills/clean-c-drive/
   # 或项目级：复制到 你的项目/.claude/skills/clean-c-drive/
   

使用方法

管理员权限模式（推荐）：

# 以管理员身份打开终端
claude

# 输入命令：
/clean-c-drive

普通权限模式：

1. 以管理员身份运行 WizTree，扫描并导出 CSV
2. 保存到 skills/clean-c-drive/data/
3. 在 Claude Code 中运行 /clean-c-drive

清理内容

高优先级（安全清理）

中优先级（谨慎清理）

低优先级（需确认）

安全红线（永不清理）

系统还原点、Windows\Installer、Package Cache / InstallerCache（删了软件无法修复/卸载）、驱动库 DriverStore、用户文档/桌面/图片、微信QQ数据（Tencent Files / xwechat_files）、.ssh 等凭据目录。完整清单见 references/knowledge.md。

💡 清理完成后建议保留备份 7 天观察期——有些问题（如某应用下次启动才报错）当场看不出来。

工作原理

┌─────────────────────────────────────────────────────────────┐
│                      工作流程                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │
│  │  WizTree    │───▶│  AI Agent   │───▶│   执行清理   │     │
│  │  快速扫描    │    │  智能分析    │    │             │     │
│  └─────────────┘    └─────────────┘    └─────────────┘     │
│        │                  │                  │              │
│        ▼                  ▼                  ▼              │
│   MFT 扫描          智能模式识别         安全删除           │
│   (秒级完成)         优先级分类          确认后执行          │
│                                                             │
└─────────────────────────────────────────────────────────────┘

配置

自定义清理规则

编辑 analyze.py：

CLEANABLE_PATTERNS = {
    "high": {
        "patterns": [
            {"pattern": "你的模式", "name": "描述", "safe": True},
        ]
    }
}

WizTree 路径

v1.1 起 scan.py 自动探测：环境变量 WIZTREE_PATH → 技能目录 WizTree\ → Program Files → PATH。也可直接指定：

$env:WIZTREE_PATH = "你的路径\WizTree64.exe"

贡献

欢迎提交 Pull Request！

许可证

MIT License - 详见 LICENSE

致谢

• WizTree - 世界上最快的磁盘空间分析器
• Claude Code - AI 驱动的 CLI 工具

免责声明

⚠️ 使用风险自负。 请在确认删除前仔细查看清理报告。作者不对任何数据丢失负责。