我在使用NocoBase 的使用部分用户会上传错误的附件然后删除,都是云存储其实没有删除这个插件就是找到那些没有被使用或者可以重复使用的附件进行空间的优化;
本地文件丢失,又不想手动删除重新上传,就可以使用替换功能进行全部替换
NocoBase 插件:附件智能清理与生命周期管理 (Plugin Attachment Cleaner)
@nocobase/plugin-attachment-cleaner 是专为 NocoBase 2.x 设计的企业级附件全生命周期管理插件。通过深度遍历业务表引用关系,智能扫描孤立(未引用)附件与重复冗余文件,提供多级安全隔离回收站、智能去重合并、自动化定时物理清理与完备的操作审计日志,助力企业大幅降低对象存储与磁盘成本。
核心特性
1.
全库附件深度分析与智能扫描 (Deep Scan & Analysis)
- 业务引用关系反向穿透:全自动扫描全库所有数据表(Collections)及所有附件字段(Attachment Field),精确建立文件引用映射拓扑。
- 孤儿/闲置附件识别 (Orphaned Attachments):精准检测由于业务记录被删除、字段清空、图片替换等原因遗留在存储中的无主附件。
- 重复文件指纹识别 (Duplicate Detection):基于文件特征智能分组识别完全相同的冗余文件,计算潜在可节省的存储容量。
- 存储概览大盘:实时统计全站总附件数量、总存储空间占用、未引用附件占用及回收站占用。
2.
多级安全隔离机制与回收站 (Recycle Bin)
- 非破坏性软隔离:检测到的未引用孤立附件不会被直接物理删除,而是安全移入“附件回收站”,保障业务零风险。
- 一键无损还原:回收站文件支持随时一键撤销并还原回原始附件库,恢复正常访问。
- 单条/批量彻底擦除 (Purge):在确认无误后,支持手动对回收站中的文件进行物理擦除,释放底层磁盘或云对象存储(Local / OSS / S3 / COS)空间。
3.
智能去重与引用重定向 (Smart Deduplication)
- 保留策略定制:支持针对重复附件组指定“优先保留的存储空间 (Preferred Storage)”或按引用频次/创建时间智能决策。
- 全库引用自动重定向:每组重复附件只保留 1 份主文件,其余副本自动移入回收站,同时自动更新改写全库所有业务记录中的外键引用,确保业务数据无缝衔接且不丢失显示。
4.
自动化定时巡检与生命周期策略 (Scheduled Auto-Cleaning)
- 内置 Cron 调度任务:每日凌晨(
0 2 * * *)自动执行超期附件清理任务。 - 灵活保留期配置:支持自定义回收站保留天数阈值(如默认 30 天),超期文件自动执行物理擦除。
- 支持后台热配置:无需重启服务即可即时启停自动清理开关或调整保留天数。
5.
完备的操作审计与追踪 (Audit Trail)
- 全操作审计记录:记录扫描分析、移入回收站、还原附件、物理擦除、智能去重等所有关键操作。
- 详细操作快照:包含操作人、动作类型、影响条数、参数及执行时间。
- 自动滚动裁剪:内置日志上限自动归档机制,避免审计表无限膨胀。
6.
现代化可视化管理控制台与 CLI 支持
- 直观易用的前端 UI:内置仪表盘、未引用列表、重复文件管理、回收站及设置面板。
- 强大的 CLI 命令行:支持在无头服务器或 CI/CD 流程中通过终端直接触发扫描、清理与去重。
