小浣熊 🦝 清理工作手册
浣熊吃东西之前,会先洗一洗。你删文件之前,先看缓存地图。
铁律(违反任何一条就停下来)
- 第一轮只读。 只用
du、ls、pgrep收集信息,输出报告。用户没确认之前,一个字节都不删。 - 地图优先。 删除任何路径前,先查
references/cache-map.md。地图上没有的路径:先搞清楚它属于哪个应用、存的是什么,查官方文档或源码,确认是"可再生缓存"且不在任何禁止清单里,才可以提交给用户。查不清楚就报告为"未知,不建议动"。 - 状态神圣。 登录态、消息数据库、聊天记录、钥匙串、配置文件,永远不碰。只动"删掉后应用会自动重新生成或重新下载"的东西。
- 先退场再动手。 目标应用正在运行就先退出(
pkill优雅退出,失败再-9),避免边删边重建。 - 可恢复优先。 用户目录下的内容进
~/.Trash(shutil.move),不直接rm -rf。系统级路径(/Library)删除需要 sudo,生成命令让用户自己跑,不代跑。 - 删除前报数。 报告里每项写清楚:路径、大小、属于什么应用、安全等级、删除后果。让用户勾选。
工作流
第一轮:体检(只读)
依次扫描并汇总(存在才扫,不存在的跳过):
# 磁盘总量
df -h /
# 缓存地图上的候选路径(见 references/cache-map.md 全表)
du -sh ~/.cache 2>/dev/null
du -sh ~/Library/Caches 2>/dev/null
du -sh ~/Library/Group Containers/*Telegram* 2>/dev/null
du -sh ~/Library/Application\ Support/LarkShell 2>/dev/null
du -sh ~/Library/Application\ Support/Google/Chrome 2>/dev/null
du -sh ~/Library/Developer/Xcode/DerivedData 2>/dev/null
du -sh ~/Library/Containers/com.tencent.xinWeChat 2>/dev/null
对可疑目录,下钻一层找大头:du -sh <dir>/* | sort -rh | head。
第二轮:判断
把每个发现对照缓存地图,标注:
- ✅ 安全:可再生缓存,直接可清
- ⚠️ 注意:部分可清(写明只清哪个子目录、保留哪个)
- 🚫 别碰:说明为什么
第三轮:确认与执行
输出报告等用户确认。执行时:
- 退出目标应用(
pkill,等 2 秒确认) - 按地图指定的范围删(用
python3 shutil.rmtree/move,部分 agent 的rm -rf有安全护栏) - 删完复测
du -sh和df -h,报战果 - 提醒用户重建成本(如浏览器缓存重建会慢一次)
与 Mole 的关系
用户装了 Mole(终端执行 mole)可以用它做扫描定位,但删除决策仍然走本 skill 的缓存地图和确认流程。Mole 的清单是参考,不是授权。