用途:给 ~/projects 做一次体检,找出三个月以上没动的沉睡项目与可重建的构建产物,产出处置清单,用户圈选确认后再动手。
主要能力:并行采集两类信号,一是最后提交时间(git -C "<项目>" log -1 --format='%cr | %cd' --date=short 2>/dev/null,非 git 仓退回文件 mtime),二是磁盘占用(du -sh "<项目>" 及项目内 node_modules、.next、dist、build、target、.venv 等大头目录)。先给出只读现状表,再按保留、归档、可删三档分类并写明依据。价值信号(付费客户、线上业务、已部署站点、基础设施配置或凭证、被依赖项)命中时不机械归档,标为待核并先询问。
使用方式:/ray-cleanup 全量扫;/ray-cleanup net 只扫某类别目录;/ray-cleanup ~/projects/apps/foo 只体检单个项目;/ray-cleanup --slim 只找可删构建产物,不碰项目归档。
限制:破坏性操作前必须停下。任何 rm/mv 之前先列完整清单(路径、大小、动作、依据),用户逐项确认后才执行;归档是默认,删除是例外;绝不删源码、数据、配置、密钥、.env、.git;动手前确认目标名实相符,发现异常先报告。判断可删范围查 references/safe-to-delete.md,归档规范查 references/archive-protocol.md。归档前需确认无未提交改动,删前确认没有运行中的 dev server。未确认的步骤一律停在原地等待。该技能的具体安装方式与收费信息暂未提供。