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

# 附件

> 用于在记录中保存图片、PDF、文档和其他文件，支持预览、下载和批量下载。

附件字段用于在记录中保存一个或多个文件。常见场景包括上传合同、图片、发票、设计稿、简历、报告，或者保存 AI 字段生成的图片。

## 适用场景

| 场景      | 适合内容              |
| ------- | ----------------- |
| 文件归档    | 合同、发票、报告、简历等业务文件  |
| 图片和素材管理 | 产品图片、活动素材、设计稿、截图  |
| 表单收集资料  | 应聘简历、报销凭证、客户提交的文件 |
| AI 图片输出 | AI 字段生成的图片结果      |

## 创建和设置

<Steps>
  <Step title="选择字段类型">
    在表格中点击 `+` 添加字段，选择字段类型 **附件**。
  </Step>

  <Step title="填写字段名称">
    输入字段名称，比如“文件”、“图片”或“合同附件”。
  </Step>

  <Step title="保存字段">
    点击 `保存` 后，每条记录都可以在该字段中上传一个或多个附件。
  </Step>
</Steps>

## 使用附件字段

### 上传和查看

附件字段可以保存图片、PDF、文档、压缩包等文件。

* **上传文件**：在单元格或记录详情中点击附件区域，选择本地文件上传。
* **保存多个附件**：同一个附件单元格可以包含多个文件。
* **预览文件**：图片和部分文件类型可以直接在单元格或记录详情中预览。
* **下载单个附件**：打开附件后，可以下载对应文件。

<Note>
  附件字段保存的是文件，不是普通文本。将文本类字段转换为附件字段时，原文本内容无法自动转换为文件。字段转换前请先确认数据是否需要备份。
</Note>

### 批量下载附件

在附件字段的字段菜单中，可以把当前字段里的附件批量下载为 ZIP 文件。下载范围会跟随当前表格的搜索结果：

* 如果当前没有搜索条件，会下载该附件字段中可下载的附件。
* 如果当前表格正在搜索并隐藏不匹配的行，只会下载匹配记录中的附件。

下载 ZIP 时，可以选择附件名前缀：

| 前缀方式         | 说明                               |
| ------------ | -------------------------------- |
| **默认序号**     | 使用系统生成的序号作为前缀，便于区分文件顺序           |
| **选择字段作为前缀** | 使用某个字段值作为文件名前缀，适合按编号、客户名或项目名整理附件 |
| **无前缀**      | 尽量保留原始文件名                        |

如果 ZIP 中出现重名文件，Teable 会自动追加后缀，保证文件名唯一。

## 扩展使用

### 与 AI 字段配合使用

AI 字段可以读取附件，也可以把生成的图片写入附件字段。

* **读取附件**：在 AI 字段设置中，把附件字段添加为输入字段。是否能识别图片或文件内容，取决于所选模型。
* **保存图片**：把 AI 字段的输出设置为附件字段，生成的图片会保存到该附件字段中。

更多信息请参阅 [AI 字段](/zh/basic/field/ai/ai-field)。

### 通过 API 上传附件

附件上传 API 支持上传本地文件，也支持通过 URL 上传文件。新附件会追加到指定记录的附件字段末尾。

请参阅 [上传附件 API](/zh/api-doc/record/upload-attachment)。