业务赋能中心
资源下载与交付记录
素材、成片、合集、剪辑任务附件和 TTS 输出的下载票据、交付追踪和排障说明。
页面定位
资源下载与交付记录用于回答一个实际业务问题：文件到底有没有被正确交给需要的人，失败时应该排查哪里。
StudioX 的下载不是简单拼一个文件链接。素材、成片、合集、剪辑任务附件、脚本分镜片段和 TTS 输出可能都要经过权限判断、下载票据、本地网关和共享盘路径解析。
支持的下载场景
- 素材单文件下载。
- 成片单文件下载。
- 素材合集下载。
- 素材或成片批量下载。
- 剪辑任务关联素材下载。
- 脚本分镜拆解片段下载。
- TTS 输出音频下载。
- 远程打印文件的临时中转下载。
- 外网审片 480p 预览播放。
下载票据怎么理解
下载票据是系统为一次下载动作生成的临时访问凭证。它通常包含资源、权限、有效期、下载方式和本地网关访问链路。
使用票据的好处是：
- 不把真实共享盘路径直接暴露给浏览器。
- 能在下载前判断当前账号是否有权限。
- 能区分预览、附件下载、批量压缩包和合集下载。
- 便于后续统计下载次数和交付记录。
外网预览和下载的区别
外网预览用于审片和协作，默认播放本地网关生成的 480p 低码率预览。它不等同于原片下载，也不作为最终画质验收依据。
原片下载和批量下载仍然应走下载票据、本地网关和共享盘读取链路。外网预览失败时，不要直接判断原片丢失；先看资源是否有预览缓存、目标网关是否在线、媒体入口是否可达，以及资源是否已经同步到可承接的网关。
标准下载流程
- 用户在资源页面点击下载。
- 云端校验资源权限和业务状态。
- 云端生成下载票据或下载任务。
- 前端打开本地网关下载地址。
- 本地网关读取共享盘文件或生成压缩包。
- 下载成功后，业务页面可更新下载次数或保留记录。
常见异常
页面提示没有下载地址
优先检查资源是否有真实文件路径、当前账号是否有下载权限、本地网关访问链路是否解析成功。
浏览器打不开下载链接
优先检查当前电脑是否能访问目标地区本地网关。如果电脑开了 VPN、TUN 或全局代理，需要把网关域名加入直连规则。
如果是外网环境，优先检查是否应该走 media.studiox-mkt.com 的外网媒体入口，而不是办公室内网网关域名。
批量下载很慢
批量下载可能需要网关先生成压缩包。文件越多、体积越大、共享盘越慢，等待时间越长。不要在压缩包生成期间重复点击多次。
下载成功但记录没有变化
先确认这次下载是否走的是平台下载票据。如果直接访问旧链接、外部分享或手工拷贝共享盘文件，平台不一定能统计到。
交付建议
- 客户交付前，优先使用平台入口下载或合集下载，保留可追溯记录。
- 对外发送文件前，确认成片审核状态、平台卡审状态和版本是否正确。
- 内部交接工程文件时，建议同时保留项目、目录、标签和任务来源。
- 对 TTS 输出、脚本分镜片段等衍生资产，建议回到对应业务记录确认来源。
- 外网审片时只用预览完成协作动作，最终交付前仍建议确认原片、最终版本和下载记录。