clean-artifacts · 清理过程文件

清理评审、采集和测试留下的过程文件，解决反复进入 Git 的问题，并区分工作树、当前版本和历史对象的占用。没有仓库参数时使用当前项目；多个仓库只处理用户指定的集合，逐仓核对。

范围与约束

按用途判定，不按名字或大小猜删。 目录叫 logs、文件被忽略、文件很旧或图片很大，都不能单独证明可清理。先找生成工具、报告或采集清单，区分可清理、必须保留和用途不明。
保留独有内容与续接能力。 源码、业务数据、设计稿、目标图、测试基线和 fixtures 保留。UI 评审的目标包、报告、修复记录、capture.md、各位评审原文、judge.md、round.json、packet 和循环索引默认保留；不能整目录删除 .ui-captures/，不改分数、证据 hash、目标或轮次来掩盖缺证。活动进程正在写入的日志、复审仍依赖的截图保留原位置，取消 Git 跟踪可以保留其本地副本。需要跨机共享或审计的证据遵从仓库约定。
已有授权覆盖的确认集合直接处理。 用途不明、会损失独有内容或影响现有证据要求的项保留，完成其他项后再请用户决定。命令因脏文件、占用或冲突拒绝时重新核对，不自动加 --force，不批量 git clean -fdx。
当前版本清理不等于历史瘦身。 默认执行当前版本清理，保留本地文件；“仅盘点”不改工作树、索引、引用或配置。“回收磁盘”才处理本地文件，先确认可丢弃或已有核验过的仓外副本。“仓库太大”本身不授权改写历史或强推。

读取目标仓规则，确认 Git 仓根、worktree/共享 Git 目录、工作树与暂存区改动。记录候选文件占用及 git count-objects -vH；必要时测 Git 目录的实际磁盘占用。非 Git 目录仍可盘点和处理获准的本地文件，不执行索引或历史操作。
从报告、采集清单和生成工具定位范围。UI 评审优先查 <前缀>.ui-captures/r<n>/ 内的实拍 PNG、运行 .log 和 logs/ 下已确认的控制台、请求、服务日志；其他测试产物必须先核实来源。不要把同目录的状态文件、基线图或手工附件并入清单。
用 Git 枚举已跟踪、未跟踪和已忽略的候选；包含已经从工作树删除、仍留在提交中的历史路径。路径列表用 NUL 分隔或结构化参数，避免按空格、换行或 shell 通配符拆文件名。检查候选自身的已暂存和未暂存改动、符号链接及仓外指向，不跟随链接删除外部文件。
按实际文件或同用途的小组列出：路径、用途依据、文件数量/大小、Git 跟踪状态、是否被引用/占用、建议动作与保留原因。体积不足以解释仓库大小、或用户指定历史瘦身时，再按历史瘦身盘点历史；只读任务在仓外临时副本分析，不在原仓生成分析文件。