技能介绍

问题从哪来

C 盘被系统更新缓存、AppData 应用缓存、腾讯系与各类 AI 工具主目录日志占满时，常见做法是装多个清理工具或手删目录——容易误删聊天记录、用户数据，或清完出现文件夹/驱动器双击打不开、缩略图正常却报「找不到文件」等 Shell 注册表/缓存问题。

技能如何工作

本技能把「看清占用 → 分级清理 → 出事可修」串成一条流水线，核心能力包括：

全量磁盘清理：系统/应用/腾讯系/AI 缓存按 🟢可清、🟡需确认、🔴只报告处理；删前预览，默认可进隔离区 D:\.workbuddy-disk-cleanup-quarantine 恢复。
AI 工具主目录（配置驱动）：references/ai_tool_homes.json 覆盖 WorkBuddy、ZCode、QoderWork、Qoder CN 等；Python 与 PowerShell 共读一份配置，新工具改 JSON 即可。
scan → clean：优先 scan.ps1 看树图与占用，再 full_cleanup.ps1 -Mode Full 一次确认覆盖多模块；应急可用 -QuickKill 直清固化清单（可用 -WhatIf 预览）。
分析与迁移：大文件扫描（优先 Everything MFT）、微信/企微去重、大目录 Junction 迁出 C 盘且脚本跳过 ReparsePoint，不删链接本体。
系统修复安全网：-SystemRepair 诊断修复悬空 CLSID/shellbags（删前备份注册表）、轻量 thumbcache 修复等，与清理流程可分离。
沙箱只读：scan_readonly.py 在无管理员权限下只出 G/Y/R 报告与预估可回收量，不删除。

边界与注意

🔴 项（用户数据、大文件、微信聊天数据、迁移候选）只报告不删；默认保护各浏览器/微信等的 User Data。-ForceClose 可能丢未保存数据并闪烁桌面；Containers/Hibernate 等需管理员。完整参数与安全规范见技能内 references/implementation-details.md。

截图预览

使用场景

C 盘占用超过 90% 或告警，需要在几分钟内先释放数 GB，再决定是否做全量扫描与分级清理。
本地长期使用 WorkBuddy、ZCode、QoderWork 等，主目录日志与缓存暴涨，要按 `ai_tool_homes.json` 只清可再生项并保留用户数据。
刚卸载大型软件或 AI 客户端，怀疑 Program Files 与 AppData 仍有残留目录，要先扫描清单再决定是否删除。
微信与企业微信同步了同一批文件导致双份占用，需要在隔离区可恢复的前提下做去重腾空间。

适合人员

负责同事 Windows 工位、经常处理「C 盘红了」工单且必须删前预览、可进隔离区恢复的 IT 桌面支持。
在 Windows 上密集使用 Cursor、Claude、Ollama 等 AI 工具，用户目录缓存失控、需要注册表式批量规则或 `-UseAiToolRegistry` 清理的本地开发者。
微信/企业微信与浏览器 User Data 都在 C 盘，想把大目录 Junction 迁到 D 盘且路径不变、同时默认不碰聊天与书签数据的重度桌面用户。
无管理员权限或只能在沙箱里评估时，需要先跑只读 G/Y/R 报告与预估可回收量、再在真机执行 `full_cleanup -Mode Full` 的运维或安全审计人员。