Skip to Content

多媒体资源管理

随着项目的上线与业务的运行,用户会在前端小程序或网页中大量上传图片(如商品图、评论晒单)、视频、或 PDF 等文件附件。这些文件全部存放于 Zion 项目绑定的云端对象存储中。

资源管理器是内置于 Zion 平台中的集中式多媒体浏览器。您可以利用它集中审查项目的存储空间占用、追踪特定图片被哪些数据库记录所引用,以及安全清理不再需要的垃圾冗余资源。


1. 浏览与精准筛选多媒体

在编辑器中打开方式:点击顶部导航切换至 “数据” 标签页,在左侧菜单栏选择 “资源”

资源管理器支持按 图片 (IMAGE)视频 (VIDEO)文件 (FILE) 三个独立的页签进行资源归类展示。您可以通过工具栏进行精细化查找与分类:

  • 数据筛选:支持构建规则来缩小媒体文件列表范围。
    • 图片视频 页签:仅支持按 ID 字段进行查询过滤。
    • 文件 页签:支持按 IDName(文件名)Size(文件大小) 进行多维度过滤。其中,数值字段(如大小)支持等于、大于、小于、区间等符号;文本字段支持 likeilike 模糊查找。
  • 统计总数:列表默认采用分页加载以保障编辑器流畅度。点击 “统计总数” 可以快速计算出符合当前过滤条件下的媒体文件总量与物理存储累积大小。
  • 数据刷新与分页:支持一键重新加载当前标签页,并可自定义每页展示的记录条数。

2. 审查与追踪“被引用”关系

列表中的 Referenced(引用情况) 是您判断该图片或视频是否可以直接被安全删除的最关键依据:

  • Yes (N)(是)—— 意味着该资源正被 N 条数据库表中的字段所强绑定引用(例如该图片是某件在售商品的封面图)。
  • No(否)—— 意味着在当前的数据库表中,没有任何一条有效记录在指向该文件,即该资源目前属于处于游离态的 “孤立资源(Orphan File)”
⚠️

富文本 (Rich Text, RTF) 的引用局限性:
对象存储的自动引用追踪是通过物理数据表的“图片”和“文件”字段进行逆向检测的。如果您直接在富文本组件的编辑器中插入、上传了图片,由于其 URL 是被打包嵌在长 HTML 字符串中,系统的字段检测器无法追踪到此种情况。因此,仅在富文本内容中出现的图片,其引用情况仍会显示为 No

追溯引用的具体步骤

打开详情面板

点击列表中任意一行资源,右侧会自动滑出该资源的属性详情面板,展示物理 ID、文件名称及物理大小。

展开“被引用”表 (Referrers)

在详情面板下查看 “被引用 (Referrers)” 区域。系统会以表格形式列出该文件所有的外键依赖。表格列名以英文显示:

  • :引用它的具体数据表名。
  • 字段:引用它的具体字段。
  • 引用数:具体引用该文件的记录行数。

精准定位记录

点击引用行前的展开图标,即可直接打开只读数据预览板,直接查看是哪一条具体的数据表记录正在使用该图片。您可以在此处快速跳转,清理这些记录后再来删除图片。


3. 安全清理冗余文件以释放空间

随着云端对象存储空间的消耗,您需要定期对“孤立资源”进行清理。Zion 提供了两种安全清理手段:

3.1 勾选物理删除(删除特定项)

  • 机制:勾选单行或多行资源,点击“删除”。
  • 安全保护:如果被选中的资源中包含标记为 Yes (N) 的有效图片,系统会自动跳过这些被引用的文件,只物理删除其中显示为 No 的孤儿文件。这确保了您的线上已发布应用绝对不会因为后台误操作出现图片破裂(404)。

3.2 批量清理孤立资源 (Clean Up Orphans)

  • 机制:点击工具栏上的 “清理孤立资源”,系统会一次性扫描当前页签下所有显示为 No 的游离资源并执行物理清除。非常适合在大规模下架商品、删除文章后执行一键空间回收。
⚠️

永久性与不可恢复性红线:

  1. 所有资源的物理删除操作一经确认即永久擦除,绝不可恢复
  2. 在执行“一键清理孤立资源”前,请务必核对是否有仅用于富文本编辑器中的图片,防止其作为孤立资源被误删除导致富文本排版出现缺漏。
Last updated on