> ## Documentation Index
> Fetch the complete documentation index at: https://guide.moyostory.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 素材库
> 上传和整理图片、音频与视频，并为变量媒体绑定准备稳定的素材名称。
点击编辑器顶部“素材库”，可以管理作品使用的图片、音频和视频。
## 文件夹
素材库左侧按文件夹整理内容。常见分类包括 UI 元素、背景图片、背景音乐、角色头像和音效。
* 点击“新建文件夹”添加分类；
* 选择文件夹后，右侧只显示其中的素材；
* 删除文件夹会同时删除该文件夹内的素材。
删除素材或文件夹后无法恢复。先检查变量配置中的媒体绑定是否仍在使用它们。
## 上传文件
选择目标文件夹，点击右上角“上传文件”。上传器支持图片、音频和视频，并允许一次选择多个文件。
上传前可以编辑每个文件的素材 ID。素材 ID 用于媒体绑定和条件匹配，应保持简短、稳定、容易识别。
素材 ID 不能包含空格、斜杠或反斜杠。同一作品中不能有重复 ID；上传器会提示新文件是否覆盖已有素材。
## 重命名和删除
把鼠标移到素材卡片上，可以重命名或删除。重命名后，使用旧素材 ID 的媒体绑定需要重新检查。
素材库操作在完成后直接保存，包括：
* 上传和覆盖文件；
* 新建或删除文件夹；
* 重命名素材 ID；
* 删除单个素材或批量删除。
这些操作不会等待顶部“保存作品”。
## 上传后怎样显示在作品里
上传只让素材进入当前作品的素材库。页面显示素材还需要完成媒体绑定：
```mermaid theme={null}
flowchart LR
A[素材库
上传文件] --> B[变量配置
联动素材库]
B --> C[触发器规则
写入素材条件值]
C --> D[页面代码
读取变量并显示或播放]
```
具体配置见[State 变量、Frame 变量与媒体绑定](/editor/variables-and-media)。
## 命名建议
素材 ID 应描述用途或状态：
* `美术馆夜景`
* `沈砚_平静`
* `沈砚_认真`
* `开门音效`
同一角色的多张立绘使用一致前缀。指令取值、触发器规则和媒体条件可以直接沿用这些名称。
MoMo：素材 ID 重命名后，立即检查变量配置中的媒体绑定和指令的取值约束。旧名称不会自动更新。