Media Library

媒体库是存放你上传的每一张图片的唯一位置。上传到这里的资源可供你网站中的任何字段、区块或页面使用，并且每个资源都会通过 CDN 提供服务。

从管理后台侧边栏的 媒体 中打开，或前往 /admin/<websiteId>/media。

上传资源

点击页眉中的 上传新资源（或空状态中的按钮），打开 上传媒体 对话框。

1. 将文件拖到拖放区域，或点击该区域选择文件。
2. 检查待上传列表——每一行显示文件类型、尺寸和大小，并可使用 × 按钮移除文件。
3. 点击 上传 N 个文件。

在你确认之前不会上传任何文件，因此你可以先准备一批文件并进行筛选。文件会逐个上传，并显示进度提示；批次完成后，网格会刷新。

• 支持的格式：PNG、JPG、WEBP
• 最大大小：每个文件 10 MB

查找资源

网格上方的筛选栏包含四个控件：

• 搜索 — 按文件名匹配，并带有短暂的防抖时间。在页面任意位置按 ⌘K（Windows 和 Linux 上按 Ctrl+K）可跳转到该字段，使用 × 按钮可清除搜索内容。
• 类型 — 全部、PNG、JPG 或 WEBP。每个按钮都会显示该类型的资源数量。
• 排序 — 按最新或最旧优先、名称 A–Z 或 Z–A、大小从大到小或从小到大排序。
• 视图 — 网格视图。列表视图尚不可用。

更改筛选条件或排序方式会返回第一页，并清除当前选择。

页脚会对结果进行分页，并允许你选择每页显示 5、10、25 或 50 个资源。页码和每页数量会保存在 URL 中，因此筛选后的视图可以收藏或分享。

选择资源

点击资源只会选中该资源，并在右侧面板中显示其详细信息。若要选择多个资源，请在点击时按住 ⌘/Ctrl 或 Shift，也可以使用每个磁贴角落的复选框。

至少选择一个资源后，选择工具栏会提供 下载、复制 URL 和 删除，以及 清除选择。选中多个资源后进行复制时，剪贴板中会为每个资源放置一行 URL。

资源详情

右侧面板会反映当前的选择：

• 未选择任何资源 — 显示提示你选择资源的占位内容。
• 单个资源 — 显示预览、文件名、类型、大小、尺寸、上传日期和 CDN URL，并提供 下载、复制 URL 和 重命名 操作。
• 多个资源 — 显示已选择的数量，并提供 下载所选资源 和 复制资源 URL。

删除功能位于面板底部的 危险区域 中。

重命名资源

选择单个资源，然后选择 重命名。名称是媒体库和搜索中使用的显示标签——它不属于存储文件路径的一部分，因此重命名绝不会更改资源的 CDN URL，也不会破坏已经引用该资源的页面。

名称在你的组织内必须唯一，且最多为 255 个字符。如果其他人在你的对话框打开期间更改了该资源，重命名会被拒绝；对话框会保持打开状态并保留你输入的文本，以便你刷新后重试。

删除资源

选择一个或多个资源，点击 删除，然后确认。删除操作是软删除：资源会从媒体库中消失，并且 撤销 提示会给你 30 秒 的时间将其恢复。超过这段时间后，撤销将不再适用。一次操作最多可删除 50 个资源。

删除不会改写已经指向该资源的页面，因此在移除图片之前，请先检查它的使用位置。