用途:系统化清理仓库中的杂物,包括构建产物、重复文件、临时文件,以及将分散目录合并到标准位置。版本 2.2.0,要求 Python 最低 3.10,无依赖,已在 Windows、Linux、macOS 上测试(Python 3.10–3.13)。\n\n主要能力:按类别清理。构建产物(.egg-info/、pycache/、.pytest_cache/、build/、dist/、.pyc、.pyo);日志(.log、LogFile.txt、轮转日志、debug.log);临时文件(.tmp、.temp/、cache/、.bak、.swp、*~);覆盖率报告(htmlcov/、.coverage、coverage.xml);IDE 产物;基准测试产物。合并模式:将分散的 agent 目录合并到 .claude/agents/,原型代码放入 examples/prototypes/,测试输出放入 tests/outputs/,基准测试夹具移入 tests/fixtures/,完成计划归档到 specs/archive/。\n\n使用方式:先用 find、du、git status --porcelain、md5sum 等命令发现与核对文件,再删除或合并。已跟踪文件用 git rm,未跟踪文件用 rm。删除前用 git clean -n -d 做 dry run。合并冲突时重命名加后缀、放入子目录或保留到专用文件夹。用 git ls-files 统计文件数验证无丢失,最后更新 .gitignore 并单独提交清理。\n\n限制与注意:删除前务必核验,某些 IDE 设置可能被有意跟踪,需先查看 .gitignore;不要混入功能提交;大文件可能需要 Git LFS。仓库中提及的参考链接:Git clean(https://git-scm.com/docs/git-clean)、Git rm(https://git-scm.com/docs/git-rm)、Gitignore(https://git-scm.com/docs/gitignore)。
repo-cleanup
部署与运维
更新于 10-16 04:32