用途:面向 Unity 项目的清理与审计,帮助给项目瘦身、排查重复或孤立资源,并在发布前做检查。
主要能力:cleaner_find_unused_assets 按类型查找可能未被引用的资源;cleaner_find_duplicates 按 MD5 哈希查找重复文件并统计浪费空间;cleaner_find_missing_references 查找缺失脚本或空引用;cleaner_get_asset_usage 查询某资源的引用来源;cleaner_find_empty_folders 查找空文件夹;cleaner_find_large_assets 按文件大小列出最大资源;cleaner_get_dependency_tree 获取资源依赖树;cleaner_fix_missing_scripts 就地移除 GameObject 上缺失的脚本组件;cleaner_delete_assets 与 cleaner_delete_empty_folders 用于删除。
使用方式:通过 call_skill 调用,例如 cleaner_find_unused_assets(assetType="Material")、cleaner_find_duplicates(assetType="Texture2D")、cleaner_find_large_assets(limit=10, minSizeBytes=1048576)。删除资源需两步:先不带 confirmToken 预览,再用返回的 confirmToken 在 5 分钟内确认。
限制:cleaner_delete_assets 与 cleaner_delete_empty_folders 属删除操作,在 Approval/Auto 模式下返回 MODE_FORBIDDEN,仅在 Bypass 模式或用户管理的 Allowlist 下可用;cleaner_fix_missing_scripts 在 Approval 模式仍需授权握手。cleaner_delete、cleaner_remove、cleaner_fix、cleaner_scan、cleaner_find_unused 等名称不存在。实际删除资源应使用 asset 模块的 asset_delete / asset_delete_batch,项目校验应使用 validation 模块。精确签名以 GET /skills/schema 或 unity_skills.get_skill_schema() 为准。