使用手册

素材与资源管理

素材上传、素材库、工程文件与资源归档的日常操作说明。

业务目标

素材与资源管理模块负责统一接住视频、音频、图片、字幕、工程文件和其他资料，确保它们能按项目归档、检索和追溯。

当前实现口径

当前仓库里的素材库是“目录驱动”方案，不再依赖 project_id 作为主组织方式：

  • library_entries 负责目录树元数据
  • library 负责素材文件主数据
  • 上传成功后把文件写入共享盘，并把元数据写入 library

这意味着目录结构本身就是业务语义的一部分，不能随意改名或挪动。

常见入口

  • 上传素材
  • 素材库
  • 上传工程文件
  • 工程文件库

素材上传建议

上传前先确认：

  • 资源归属的项目或业务对象已经存在
  • 文件命名能体现内容、日期或用途
  • 上传人知道后续审核或使用人是谁

上传后要重点检查：

  • 文件是否落到正确目录
  • 素材类型是否正确
  • 关键字段和标签是否齐全
  • 状态是否已经变成可用

上传素材标准动作

  1. 进入上传页面
  2. 选择目标目录
  3. 如目录不存在，先创建目录
  4. 选择待上传文件
  5. 补充必要信息后提交
  6. 等待上传完成
  7. 到素材库确认文件是否已入库

上传页只负责“把文件送进系统”，后续的重命名、移动、删除和回收站管理应优先在素材库完成。

素材库日常操作

素材库通常用于：

  • 按项目、名称、类型、状态筛选
  • 查看资源详情与元数据
  • 补充标签、备注和业务归属
  • 跟踪资源是否可用于下游制作

遇到“搜不到资源”时，优先检查：

  1. 是否选错项目或时间范围
  2. 状态是否仍处于上传中或同步中
  3. 当前账号是否具备该资源的数据权限

目录与回收站规则

  • 删除目录时，目录树和目录下素材会整批进入回收状态
  • 删除单个文件时，只回收该文件
  • 回收站通常展示目录根记录，不重复展开整批子文件
  • 恢复或彻底删除目录时，以目录根记录为准处理整批数据

因此，删除目录前一定要确认它下面没有仍在被业务使用的资源。

工程文件管理

工程文件和普通素材不同，要求更强的版本追踪。

日常维护原则：

  • 工程文件必须归属项目
  • 版本号保持递增，避免覆盖历史记录
  • 开始编辑和结束编辑要有明确登记
  • 修改说明尽量可追溯，不要只写“已修改”

常见状态与排查

素材状态常见口径包括：

  • pending
  • uploading
  • stored
  • syncing
  • available
  • failed
  • archived

如果资源迟迟不可用，建议按这个顺序查：

  1. 上传任务是否成功
  2. 共享盘目标路径是否存在
  3. 本地网关或接收服务是否异常
  4. 素材状态是否卡在中间态

路径与共享盘

系统侧保存的通常是业务记录和相对路径，本地完整路径会根据所属地区或网关节点拼接。业务人员看到路径异常时，优先联系管理员确认共享盘映射和本地网关状态。

继续阅读