用途:移除 RLM Summary Ledger 中失效(stale)或孤立(orphaned)的条目。当某条目对应的文件已不存在或已移动时即视为失效,定期运行可保持账本准确。
主要能力:按 profile 清理条目;通过 cleanup_cache.py 支持 dry-run 预演与 --apply 实际写入;用 inventory.py 校验清理后的覆盖率。
使用方式:先配置 profile,若未配置需先运行 rlm-init 技能。执行时先确认要清理哪些 profile(默认全部,含 project 与 tools);先做 dry run 展示将被删除的内容,例如 python ./scripts/cleanup_cache.py --profile project --dry-run,以及 --profile tools --dry-run,并报告发现的 N 个失效条目及路径列表;用户确认后再用 --apply 应用,再运行 python ./scripts/inventory.py --profile project 验证并报告新的覆盖率。依赖安装命令:pip-compile ./requirements.in 与 pip install -r ./requirements.txt。
适用场景:删除或重命名曾被总结的文件后;大规模重构移动目录后;inventory.py 报告存在磁盘无对应文件的条目时;合并等定期清理场景。
限制与规则:这是写操作,必须始终先 dry-run,未向用户展示将删除内容前不得 apply;禁止直接编辑 _cache/.md,必须使用 cleanup_cache.py;需声明清理了哪些 profile 及移除条目数。技能要求 Python 3.8+ 且仅用标准库,依赖锁文件当前为空。其余细节暂未提供。