---
title: 文件夹
description: 将链接归入文件夹。文件夹本身也是一个链接，拥有自己的短网址，并列出访问者可以打开的内容。
sidebar:
  label: 文件夹
  order: 6
---
文件夹是一种链接，其内容就是你放入其中的条目列表。和其他链接一样，它拥有自己的 slug、访问级别、分享网址、密码、生效与过期时间、打开次数上限、暂停状态、域名、社交预览、二维码和统计数据。

## 文件夹的工作方式

- **条目彼此独立。** 文件夹中的每个条目仍是一个独立的链接，拥有各自的网址、密码、时间安排、变体和分析数据。
- **每个条目只属于一个文件夹。** 一个链接或文件夹最多只能位于一个文件夹中。文件夹可以包含文件夹，最多嵌套 32 层。
- **文件夹页面显示访问者可以打开的内容。** 文件夹页面（即它的分享网址；文件夹为公开时也可以是 `lida.sh/<folder-id>`）会先应用文件夹自身的访问限制和密码，然后列出其中访问者当前可以打开的条目。已暂停、尚未生效、已过期和次数已用完的条目会被隐藏。文件夹排在最前，其余条目按从新到旧排列。
- **条目的打开位置。** 每个条目如果是公开的，就在其短网址打开，否则在其分享网址打开。条目自身的密码、时间安排和变体仍然生效。
- **分享和访问权限覆盖其中的内容。** 将文件夹分享给某人，就会把其中的所有内容（包括各级子文件夹，以及之后添加的条目）一并分享。设置为"任何拥有链接的人"或公开的文件夹，会向任何拥有链接的人开放其中的所有内容，即使是受限条目也不例外。将条目移出文件夹后，它会恢复自身的访问权限。参见[分享与访问](/zh/sharing)。
- **名称。** 文件夹名称会在文件夹页面上公开显示。链接名称保持私密：条目会显示其预览名称，如果没有则显示文件名。
- **统计。** 打开一个文件夹会为该文件夹计入一次打开和一次访问。

## 在控制台中

**资料库**标签页取代了 Links。其他人分享给你的条目位于 **权限 → 与我共享**下。打开一个文件夹即可浏览其中的内容（网址会跟随路径变化，例如 `/dashboard/library/<folder>/<folder>`），你可以在网格视图和表格视图之间切换，并通过面包屑导航返回上一级。使用 **新建文件夹**创建文件夹，将条目拖到文件夹上或使用 **移动到…**进行归档。

## 一次上传多个文件

在资料库或任意文件夹中点击 **上传文件**，或将电脑上的文件拖放到页面任意位置，或使用 ⌘V / Ctrl+V 粘贴。每个文件都会成为当前文件夹中的一个独立条目。

- **整批共用一组设置。** 访问级别、密码、过期时间、打开次数上限和标签会应用到每个文件。每个条目以其文件名命名；上传前可以在列表中重命名。上传后可像其他链接一样单独修改某个条目的设置。
- **上传到新文件夹** 会将整批文件放入当前文件夹内的一个新文件夹中，因此你可以用一个链接分享全部内容。你选择的访问级别会设置在文件夹上，其中的文件随之生效。
- **先检查限制。** 文件必须能放入你剩余的存储空间，每个文件计为一次事件。每批最多 500 个文件；拖入的文件夹会被跳过，因此请拖入其中的文件。
- **失败不影响其余文件。** 同时上传四个文件。上传失败的文件会显示原因并提供重试按钮，其余文件继续上传。

你在文件夹中以编辑者身份被分享时，同样可以上传；文件归文件夹的所有者所有，由所有者设置其密码和访问级别。

## 下载文件夹

在文件夹的菜单中选择 **下载**，或在别人分享给你的文件夹上选择该项，即可保存其中的全部内容（包括子文件夹）：

- **文件** 保持原样，以其条目名称命名。
- **文本片段** 保存为 `.txt` 文件。
- **URL 链接** 列在每个文件夹中的 `Links.txt` 里，包括名称、目标地址和短网址。

选择保存方式：

- **单独的文件**会将每个文件单独保存，适合手机使用：照片和视频会进入相册。
  - **大多数浏览器**中，每个文件都会作为普通下载保存，出现在浏览器的下载列表中；在 Android 上，照片和视频会出现在相册中。子文件夹中的文件命名为 `Subfolder - file.jpg`。浏览器可能会询问一次是否允许多个下载。
  - **iPhone 和 iPad** 会先准备好文件，然后点击 **保存** 打开分享面板，其中的照片和视频会存入「照片」。较大的文件夹会分成几部分，每部分需点击一次。
- **.zip 压缩包**会保存为一个文件，并保留所有子文件夹，适合包含大量文件夹的情况。它同样是普通的浏览器下载。在 Chrome、Edge 和 Firefox 中，它会边打包边保存，因此即使是很大的文件夹也不会占满内存。

在控制台中下载不会打开任何内容，也不计入打开次数或事件。分享给他人的文件夹，接收者只能下载其在控制台中可以打开的内容；受密码保护的条目会被排除，下载结果会说明排除了多少个。

文件夹页面对访问者也提供同样的 **下载** 按钮，无论文件夹是受限、对拥有链接者开放还是公开。它会在应用文件夹自身的访问限制和密码后，保存页面所列的内容（包括子文件夹）。每个条目的打开方式与其自身链接相同，因此其变体、时间安排和打开次数上限同样生效，并计入打开次数；拥有各自密码的条目会被排除。

单次下载最多包含 2,000 个条目；如果文件夹更大，请逐个下载其子文件夹。

## 复制

**创建副本**（`links copy`、`POST /v1/links/:id/copy`、`links_copy`）会创建一个新链接，其内容、密码、访问限制、预览、标签和域名均与原链接相同。存储的文件会被复制一份，并计入存储用量。副本会获得一个新的随机 slug，位于同一个文件夹中，名称后会加上 ` (copy)`。副本保留原有的访问级别，但拥有自己的分享网址；原链接分享过的人不会被复制。打开次数和分析数据从零开始。文件夹不能被复制。

## 删除文件夹

删除文件夹时，系统会询问如何处理其中的条目：

- **保留条目**（默认选项）会将条目移到上一级文件夹，或移到顶层。
- **全部删除**会删除其中的条目以及各级子文件夹。

在 CLI 中使用 `links delete <id>` 或 `links delete <id> --with-contents`；通过 HTTP 使用 `DELETE /v1/links/:id?contents=keep|delete`；在 MCP 中使用 `links_delete` 并传入 `contents`。

## 通过 CLI、API 和 MCP 操作

```bash
linkdash links create --folder "Q4 launch" --slug q4
linkdash links create --file ./deck.pdf --in q4
linkdash links move k3m9xq --in q4
linkdash links list --in q4
```

| CLI | HTTP | MCP |
| --- | --- | --- |
| `links create --folder <name>` | `POST /v1/links`，传入 `{ "kind": "folder", "name" }` | `links_create`，传入 `kind: "folder"` |
| `links create … --in <folder-id>` | `POST /v1/links`，传入 `folder` | `links_create`，传入 `folder` |
| `links list --in <folder-id\|root>` | `GET /v1/links?folder=<slug>\|root` | `links_list`，传入 `folder` |
| `links move <id> --in <folder-id>` / `--root` | `POST /v1/links/:id/move` | `links_move` |
| `links copy <id>` | `POST /v1/links/:id/copy` | `links_copy` |

移动和复制各计为一次事件。CSV 导出和导入包含 `folder` 列。如需分享文件夹，请参见[分享与访问](/zh/sharing#通过-cliapi-和-mcp-操作)。详细信息：[CLI](/zh/cli#文件夹)、[HTTP API](/zh/api#文件夹)、[MCP](/zh/mcp#文件夹)。
