# 作品素材管理
> 管理作品中用到的全景素材：添加、删除、改名、排序，并按分组归类，决定底部素材导航的展示顺序与分组方式。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「作品素材管理」。面板分为「内容管理」和「分组管理」两个模式：内容管理用于增删素材、改素材名称、拖拽或手动排序；分组管理用于新增、编辑、删除分组。设置完成后点击底部「保存修改」，并重新发布作品对外生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 添加素材：从素材库选择全景素材加入作品
- 删除素材、修改素材名称、预览素材缩略图
- 搜索素材名称或描述，快速定位素材
- 拖拽排序或手动填写排序值（1 到 999）调整素材顺序
- 分组管理：新增、编辑、删除分组，批量把素材移动到指定分组
- 分组样式设置：自定义分组背景颜色、文字颜色与分组宽度

## 3. 业务说明

### 配置区域

面板顶部为「内容管理 / 分组管理」两个模式。内容管理包含搜索框、分组标签、素材列表（勾选、缩略图、素材名称、素材介绍、删除）与底部的批量移动条；分组管理包含分组列表（拖拽手柄、分组名、素材数量、编辑、删除）。底部导航条提供关闭退出、新增分组、添加素材、素材排序、分组宽度、保存修改。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 搜索素材 | 按素材名称或描述筛选当前列表 | 输入框 | 非必填 |
| 分组标签 | 在分组之间切换素材列表 | 标签页，默认分组 + 自建分组 | 默认包含一个默认分组 |
| 素材名称 | 显示在作品缩略图下方的名称 | 点击后弹窗输入，建议不超过 6 个汉字 | 必填，且只能为汉字 |
| 素材介绍 | 素材的补充说明 | 只读展示，未填写显示「暂无素材介绍…」 | 非必填 |
| 删除 | 从作品中移除该素材 | 按钮，需在弹窗中确认 | 至少保留一张素材 |
| 移动到分组 | 把勾选的素材批量移动到目标分组 | 下拉选择目标分组，需先勾选素材 | 批量为空时不可确认 |
| 新增分组 | 创建一个新分组 | 弹窗输入分组名称，建议不超过 5 个汉字 | 分组名不能为空 |
| 分组背景颜色 | 分组标签的背景色 | 颜色值输入 | 默认 #30BF41 |
| 分组文字颜色 | 分组标签的文字颜色 | 颜色值输入 | 默认 #FFFFFF |
| 分组宽度 | 分组标签的显示宽度 | 输入数字（像素），超出自动显示省略 | 默认 90px |
| 素材排序 | 调整素材在作品中的先后顺序 | 拖拽排序，或手动填写 1 到 999 的整数 | 非必填 |

### 保存与生效

所有改动需点击底部「保存修改」并确认后写入作品，提示「保存成功」；素材顺序、分组与分组样式在重新发布作品后对外生效。删除素材会使其关联的热点、场景跳转、导览、沙盘等失效，官方建议优先使用「替换素材」而非删除。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「作品素材管理」
2. 在「内容管理」查看当前素材，点击「添加素材」从素材库选择并加入
3. 按需点击素材名称改名、点击缩略图预览、或点击「删除」移除素材
4. 需要排序时点击「素材排序」，拖拽图标或填写排序值调整顺序
5. 在「分组管理」新增、编辑、删除分组；在内容管理中勾选素材并「移动到分组」
6. 按需点击「分组宽度」设置分组标签宽度
7. 点击底部「保存修改」并确认，再重新发布作品

## 5. 规则与限制

- 素材名称只能为汉字，不能包含特殊字符，否则全景可能无法打开浏览
- 修改素材名称后，所有关联的场景素材名称都会被一起修改
- 至少需要保留一张素材，且删除素材会导致其关联配置失效
- 分组名称建议不超过 5 个汉字，否则外部展示时会被省略
- 某个分组内容为空时不允许保存，需要删除该分组或先补入素材
- 排序值必须是 1 到 999 的整数

## 6. 状态与异常

- 打开面板时读取当前作品素材列表，加载期间显示「请稍等…」
- 勾选素材后底部出现批量移动条，显示已选素材数量
- 切换分组后会清空当前勾选状态
- 素材名称为空：提示「素材名称不能为空」
- 分组名为空：提示「分组名称不能为空」
- 删除时分组内还有素材：提示「分组内还有素材，请移出后再删除」
- 排序值非法：提示「排序值必须是 1 到 999 的整数」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [基础设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/basic.md)
- [作品封面设置](https://9kvr.cn/site/tour/editor/config/basic/thumb.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验