> 👤 作者名片：本技能由 老登（SkillHub @user_11d2869f）开发维护。
> 作者作品集：📚 第二大脑操作系统 · 交付就绪进化器 · 技能编排交付 · 调研Master · 多AI协作Loop+Graph · 多智能体社会模拟器 · 招商引资工作台 · 券商研报搜索与解读 · 工作台资源管家
> 喜欢本技能请点 ⭐ 收藏；欢迎留言反馈与定制需求，作者持续更新中。
工作台资源管家 · 防烧穿机制（Agent 产物安全自清 v1.0）
> 一句话：只清「agent 自己生的垃圾」，绝不碰你的个人文件。默认只读报告，真要删先备份进回收站，且必须你确认。
> 防烧穿机制（核心）：自主 agent 长期跑会不断生成 __pycache__/*.pyc、日志、运行记录、构建产物，不清理会持续吃系统盘，最终「烧穿硬盘」。本管家用三重保险阻断这件事——
> 1. 每周自动巡检（scan-only 自动化）：盘满前就出报告预警，防未然；
> 2. 窄口径扫描：只认 agent 自生成产物，个人目录与关键配置在禁区名单里硬拦截；
> 3. 可恢复清理：真要清，先 move 进回收站目录再删，绝不用 rm -rf，误清可找回。
为什么需要它
自主 agent 跑久了会在工作区里堆积 __pycache__/、.pyc、旧 *.log、过期的运行记录 JSON、构建/分发目录等自生成产物。这些不删会慢慢吃磁盘（所谓「code 烧穿硬盘」）。但个人目录（桌面/文档/下载/图片…）和 agent 的关键配置（skills/memory/secrets）绝不能动——所以本 skill 走「窄口径 + 安全优先」路线。
铁律（最高优先级，违反即中止）
- 禁区硬拦截：以下路径及其任何子路径一律跳过、绝不触碰：
- 个人目录：Desktop/Documents/Downloads/Pictures/Music/Videos
- 关键配置：~/.workbuddy整个根目录（运行时+所有配置，一刀切不碰，比只列子目录更稳）
- 关键文件：MEMORY.md/IDENTITY.md/SOUL.md/USER.md/mcp.json/llm_keys.env/china_baseline.json等 - 默认只读：不加
--clean只出报告，不删任何东西。 - 先备份再清：真清理时，SAFE 类先
shutil.move进<回收站目录>\<时间戳>\，可恢复；不用rm -rf、不进系统回收站以外的不可恢复删除。 - 需确认才动：CAUTION 类（日志/构建目录/运行记录）只报告，必须用户显式说「清」「批准」「--approve-caution」才处理。
- 小批量：单批移动 ≤ 10 项，批后核对，失败即停。
分类口径
| 类别 | 命中 | 处理 |
|---|---|---|
| SAFE（纯可再生） | __pycache__/、.pytest_cache/、.mypy_cache/、*.pyc、*.pyo |
先备份进回收站再清（需 --approve-safe） |
| CAUTION（可再生但可能丢信息） | *.log、build/、dist/、node_modules/、out/、run_*.json 等运行记录 |
仅报告；显式 --approve-caution 才清 |
| BLOCK（永不碰） | 禁区根 + 关键文件 + 个人目录 | 跳过 |
用法
1. 只读巡检（默认，最常用）
python scripts/scan.py --root "<你的工作台根目录>" --report "<报告输出目录>.md"
输出 Markdown 报告：每类命中数、总大小、样例路径、根盘剩余空间与烧穿预警（低于 --warn-gb 默认 20GB 时告警）。不删任何东西。
2. 安全清理（SAFE 类）
python scripts/scan.py --root "<你的工作台根目录>" --clean --approve-safe
把 SAFE 类先移进回收站目录再清。仍不动 CAUTION。
3. 含 CAUTION 清理（需你拍板）
python scripts/scan.py --root "<你的工作台根目录>" --clean --approve-safe --approve-caution
连日志/构建/运行记录一起清。必须经你明确批准才用此命令。
4. 回收站自清（防工具自身变垃圾源）
python scripts/scan.py --root "<你的工作台根目录，如 ~/WorkBuddy/Claw>" --gc-trash-days 30
删除超过 30 天的旧备份目录（默认每次运行都先自清，无需单独调用）。避免清理工具自己堆积成新垃圾源。
可移植性（可上架）
- 个人目录与禁区均用
os.path.expanduser("~")动态获取，不写死用户名/盘符，换机器、换账号照样生效； - 回收站放在扫描根的同级目录
.self-cleanup-trash，不在扫描根内（避免重复扫描），跨盘/跨用户都可移植； - 该目录名已列入禁区，自身永不被二次清理。
与「智能文件管家」的区别
duplicate-file-cleaner（智能文件管家）：针对个人文件去重/释放空间，面广。- 本 skill：只管 agent 工作区自生成产物，口径更窄、更专、更不容易误伤关键配置。两者互补，不重叠。
每周巡检
已配自动化（scan-only），每周生成报告；不自动删除，等你确认。详见自动化配置。
