# 我的全景素材
> 素材库列表页，支持目录层级管理、关键词与条件筛选、批量管理（移动/删除）、素材预览/下载/重命名/替换/更新 CDN，并为作品发布提供素材来源。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/media/media-list
- 所属模块：素材与模型
- 页面用途：电脑端的全景素材管理页，集中查看与管理当前账号上传的素材。支持目录层级管理、关键词与筛选条件查询、卡片浏览、批量移动/删除，以及对单个素材预览、下载原素材、重命名、替换、更新 CDN、分享链接。可作为作品发布时的素材来源。
- 适用用户：管理自己全景素材的登录创作者
- 访问条件：需登录后访问

## 2. 功能说明

- 目录层级与面包屑导航，右键菜单进入/重命名/删除目录，可创建目录
- 关键词与筛选条件查询、清空条件、展开/收起搜索面板、刷新列表
- 批量管理模式：全选、移动到目录、批量删除
- 单个素材：复制名称、下载原素材（仅全景图片）、更新 CDN、链接、预览、重命名、替换、删除
- 状态标签：使用中、制作中、重新制作、原素材、CDN
- 原素材下载弹窗、素材移动/替换/分享链接组件
- 可带作品标识只看某作品的素材；无限滚动加载（InfiniteLoader）

## 3. 业务说明

### 素材与作品

素材是构成全景的基本要素，一个全景作品由多个素材组成，同一素材可被多个作品引用。

### 使用与删除

被作品使用的素材会标记“使用中”且禁止删除；CDN 来源素材在列表删除后还需在自定义 CDN 服务器手动删除。

### 制作状态

素材有“制作中/重新制作/原素材/CDN”等状态。制作失败可触发重新制作，成功后通过服务端消息回填素材状态与缩略图。

### 表单字段

| 字段 | 类型 | 是否必填 | 取值来源 | 默认值 | 限制与说明 | 影响费用 |
| --- | --- | --- | --- | --- | --- | --- |
| 素材名称 | 文本 | 选填 | 用户输入 |  | 支持模糊搜索 | 未核实（视实际规则） |
| 筛选条件 | 下拉选择 | 选填 | 平台筛选配置 | 全部 |  | 未核实（视实际规则） |

## 4. 使用说明

1. 进入列表（可带 tour_id 只看某作品素材）
2. 按目录或条件筛选定位素材
3. 对单个素材预览/下载/重命名/替换/删除
4. 或切换批量管理模式批量移动/删除
5. 需要新素材时跳转发素材页

## 5. 规则与限制

- 被全景作品使用的素材无法删除
- CDN 来源素材删除后需手动在自定义 CDN 服务器删除
- 仅全景图片素材支持下载原素材
- 重新制作需先通过素材文件校验，无法重制时提示替换或删除后重新发布

## 6. 状态与异常

- 加载中显示“正在加载素材列表...”，全部加载完显示“已经全部加载完成”
- 无素材时显示“暂无任何素材哦~”并提供去发布入口
- 制作中素材点击预览提示稍后再试
- 删除正在使用的素材会失败并提示先删除使用它的全景作品
- 重新制作校验失败时提示无法重制
- 更新 CDN 地址需通过旋转验证码后保存

## 7. 相关文档

- [素材播放](https://9kvr.cn/site/tour/media/play.md)
- [发布全景素材](https://9kvr.cn/site/tour/send/send-media.md)
- [我的作品列表](https://9kvr.cn/site/tour/workbench/work.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验