SuperAPI AI 工具集

threejs-game-artifact-cleanup

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:在 three.js 项目中清理过期或未使用的记录文件与中间产物。以 threejs-game-workflow-control 为唯一任务范围、风险门和状态权威,不建立第二套状态机,也不直接修改审批账本。

主要能力:盘点并处理本任务产生的临时日志、临时导出、失败候选、重复预览、可再生成构建或缓存;建立保留集合,从仍保留的 Work Item、实施包、审批/返工记录、证据清单、资源清单、加载入口、构建/测试配置与交付清单追踪引用并递归保留依赖;逐文件记录路径、类别、大小、SHA-256、判定依据与再生成方式。

判定边界:过期需有保留策略、用户指定期限或已被替代的事实,修改时间早不等于过期;未使用需完整引用检查和明确归属,文本搜索零匹配不等于无引用。任务完成、证据失效、被 Git 忽略、未跟踪或内容重复都不能单独作为删除依据。

使用方式:先限定范围并读取保留策略,记录 Git 状态与并行任务;建立保留集合后列出候选并执行前复核(控制面 check 与 preflight),需批准的对象提交精确 pending;逐对象清理,只操作复核清单中的具体文件,不递归删除记录目录,不执行 git clean、git reset 或批量历史清理。Windows 下使用 PowerShell 7 与 -LiteralPath 逐文件 Remove-Item -LiteralPath <已复核绝对路径>。清理后验证保留文件与引用存在、内容满足要求,并运行控制面 check 及受影响资源检查/构建。

适用场景:用户要求清理、阶段收尾时处理本任务临时产物、整理重复候选。限制:不可恢复删除与外部删除按控制面逐对象批准,授权只覆盖批准清单;范围外候选仅报告;不把移动伪称为释放空间,缺少可靠字节统计时不宣称释放空间;无法确认的引用或不可读的引用记录一律保留;不按扩展名、目录名含 output/temp 或体积大小批量判断;清单生成后内容或依赖变化时重新判定。