> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 批量操作

> 一次性处理大量 QR Codes：用表格创建、替换网址、重命名、换装、整理、删除，或导出为单个 ZIP。

**Bulk Operations**（`/bulk-operations`）用于一次性处理大量 QR Codes，而不必逐个打开。这里的一切都以后台任务运行，启动后即可离开——任务列表中会出现进度卡片，完成时还会收到邮件。

它是侧边栏中的顶级条目，[Media Library](#media-library) 嵌套在其下。

## 任务列表

首页是该账户运行过的所有批量任务的记录，顶部有四个计数器：**Total**（累计）、**In Progress**（正在运行）、**Completed**（近期完成）和 **Failed**（需要处理）。

每一行显示**任务**名称、**类型**与类别、**状态**、**进度**条、**开始**时间，以及运行该任务的**用户**。已完成并生成了文件的任务，会在其所在行显示下载控件。

任务启动后可能需要约一分钟才会出现在这里，而且页面不会自动刷新——在断定任务没有进入队列之前，请先重新加载。

## 启动一个任务

**New Operation** 会打开一个选择界面，其中有七种任务类型，分为最常用的四种和下方的另外三种：

| 任务                  | 作用                                        |
| :------------------ | :---------------------------------------- |
| **Create QR Codes** | 依据表格批量生成新的 QR Codes                       |
| **Update QR Codes** | 修改码的指向——通过表格批量替换网址                        |
| **Update Details**  | 重命名和重新打标签，而不改动网址                          |
| **Download**        | 将 QR Code 图像以 PNG、SVG、PDF 或 EPS 导出为一个 ZIP |
| **Apply Design**    | 用已保存的设计预设为大量码重新换装                         |
| **Organize**        | 在文件夹之间移动码，或添加与移除标签                        |
| **Delete**          | 归档或彻底删除多个码                                |

这一区分在选择时很关键：**Update QR Codes** 改变目标地址，**Update Details** 则刻意不改。重命名一百个码，不会动到其中任何一个的指向。

## 批量创建 QR Codes

创建流程是一个四步向导：**Category → Spreadsheet → Settings → Review**。

<Steps>
  <Step title="选择类别">
    批量创建支持四种类别：**Website URL**、**Business Card**、**Custom Page** 和 **GS1**。同一个任务中的所有码共用此处所选的类别，因此混合批次意味着要分成多个任务。
  </Step>

  <Step title="下载模板，填好后上传">
    下载示例表格，每个 QR Code 填写一行，然后上传回来。上传支持 **CSV 或 XLSX，最大 10 MB**。

    **模板与所选类别相对应**——Website URL 表格带有 `name`、`tags`、`custom_slug` 以及目标网址等列，而 Business Card 表格要求填写联系方式字段。请在选定类别之后再下载，而不要沿用之前任务的表格。
  </Step>

  <Step title="按需选择设置">
    这里的一切都是可选的——页面标题即已说明——五项全部关闭时任务同样能正常运行。

    | 设置                            | 对任务中每个码的作用                                            |
    | :---------------------------- | :---------------------------------------------------- |
    | **Add design**                | 来自 **In-built Templates** 或您的 **Saved Templates** 的设计 |
    | **Add custom domain**         | 用您自己的域名替代默认的 `scnv.io` 短链接                            |
    | **Auto-organize into folder** | 将任务生成的所有码放入的文件夹                                       |
    | **Scheduling**                | 启用与停用的时间                                              |
    | **Tracking parameters**       | 追加到每个短链接的 UTM 参数                                      |
  </Step>

  <Step title="命名、核对摘要并启动">
    **Job name** 虽为可选，但值得填写——日后正是靠它在任务列表中查找，而默认的批次名称只是一串时间戳。

    下方的摘要会显示类别、已上传的文件，以及五项设置各自为 On、Off 还是 None，便于您在运行前确认。**Start generation** 会将任务加入队列。
  </Step>
</Steps>

## 批量导出图像

**Download** 是一个三步向导——**Select codes → Format → Review**——最终生成单个 ZIP。您可以使用与 QR Codes 列表相同的搜索和筛选来选择码，也可以直接选中符合某个筛选条件的全部结果，而不必逐行勾选。

## Media Library

**Media Library**（`/media`）集中存放您上传到账户中的一切内容，而不是分散在各个 QR Code 之下。

您可以在其中搜索，按 **Type** 和 **Source** 筛选，在列表与网格视图之间切换，也可以直接上传新文件。侧边栏将它嵌套在 Bulk Operations 之下，但它有自己的路由。

## 相关内容

* [Folders, tags & bulk operations](/zh/qr-codes/manage/folders-tags-bulk-operations) — QR Codes 列表上的批量操作栏，适用于无需建任务的小批量
* [Download QR Code images](/qr-codes/manage/download) — 导出单个码及可用格式
* [Custom QR Code design](/qr-codes/manage/custom-design) — 保存 Apply Design 所使用的设计预设
* [Bulk endpoints](/zh/api-reference/management-api/bulk-operation/list) — 通过 API 运行同样的任务