# 云盘

「云盘」是组织的文件管理与共享中心。每位成员拥有专属的「我的文件」与「智能体生成」空间，组织提供公用的「组织共享」空间，管理员与拥有权限的成员还可以自建空间。云盘支持多版本管理、文件回收站、同事与部门共享，以及生成组织外免登录访问的公开链接。

## 谁能用

进入云盘的有效访问能力由组织授予的云盘权限与具体空间的成员名单（或内部分享记录）共同决定（有效访问 = 云盘权限 ∧ 空间名单/内部分享）。如果你对某个文件或文件夹没有读取权限，系统直接按不存在处理；如果你能读取但没有修改权限，操作时将提示没有权限。

在组织未自定义业务角色时，系统默认权限分配如下：

| 权限点 | 默认谁有 | 能做什么 |
|---|---|---|
| 「查看文件」 | 成员、分析员、审计员、管理员 | 浏览、预览、下载有权访问的空间里的文件 |
| 「上传与新建」 | 成员、管理员 | 上传文件、上传新版本、新建文件夹；助手为本人保存生成内容也需要此权限 |
| 「改名、移动、标签」 | 成员、管理员 | 修改文件或文件夹的名称、存放位置、标签与描述 |
| 「删除」 | 成员、管理员 | 将文件或文件夹移入回收站、从回收站恢复、彻底删除 |
| 「分享给同事」 | 成员、管理员 | 将文件或文件夹分享给组织内的成员或部门 |
| 「创建公开链接」 | 仅管理员 | 生成组织外无需登录即可访问的公开链接（同时需要「分享给同事」权限） |
| 「管理空间与设置」 | 仅管理员 | 新建空间、管理空间成员、开启或关闭公开链接总开关 |

根据你的权限不同，界面会自动隐藏部分入口：
- 没有「删除」权限：顶栏隐藏「回收站」页签。
- 没有「分享给同事」权限：顶栏隐藏「我的分享」页签。
- 没有「管理空间与设置」权限：顶栏隐藏齿轮「设置」按钮。

空间内设有独立的访问级别：
- 「可查看」：浏览与下载文件。
- 「可编辑」：上传、修改、删除与分享文件。
- 「可管理」：拥有编辑权限，且能管理空间成员。

> **提示**
>
> 个人的「我的文件」与「智能体生成」空间具有严格私密性。即使是组织管理员也无法查看你存放在这两个空间中的文件，除非你主动将其分享出去。
> 业务角色的云盘权限由管理员在「我的组织 → 权限 → 业务角色」（参见[角色与权限](/admin/roles)）中统一配置。

## 怎么打开

1. 在[工作台](/guide/workspace)进入「知识与文件」套件，点击「云盘」。在套件中本应用为可选应用（用途为「文件的存放与分享」）。
2. 在浏览器中直接输入地址访问：`https://storage.apps.{域名}/`。

进入应用后，顶栏页签包括「文件」「与我共享」「智能体生成」；有权限时还有「我的分享」「回收站」。右侧齿轮「设置」用于管理空间与配置。页面支持「列表」与「网格」视图切换；在窄屏或手机上打开文件抽屉时，同样提供「预览」「信息」「版本」「分享」「活动」五个页签。

## 界面一览

![「云盘」的「文件」页](/shots/storage-files.webp)

图：「云盘」的「文件」页

1. 「文件」页签：当前空间里的文件夹和文件
2. 「新建文件夹」
3. 「上传」：单个最大 50 MB
4. 「空间」：在「我的文件」、组织共享等之间切换
5. 按名称、描述或标签搜索

| 页面 / 区域 | 主要内容与功能 |
|---|---|
| 「文件」页签 | 云盘主页面。顶部显示当前空间名称（或「搜索结果」「智能体生成」「文件」）与空间权限描述；提供「空间」选择下拉框（占位符为「选择空间」）与「当前位置」面包屑；支持切换「列表」或「网格」视图；包含「成员」「新建文件夹」以及「上传」/「上传文件」按钮；提供搜索框、类型筛选、来源筛选与标签筛选；勾选文件后展示批量操作栏。 |
| 「与我共享」页签 | 展示同事或部门分享给你的文件与文件夹。列表包含「名称」「分享人」「权限」（「可查看」或「可编辑」；部门分享会标注部门名称）「分享时间」「操作」。空态提示「还没有人与你共享」。 |
| 「智能体生成」页签 | 专用于存放助手为你生成并保存的内容，固定在该空间展示，界面与「文件」页相同，但不提供空间切换下拉框与来源筛选。空间描述提示「助手为你生成并保存的内容都在这里，只有你能看到；可以移动到别的空间或分享出去。」。空态提示「助手还没有保存过文件」「在工作台让助手「保存到云盘」。」。 |
| 「我的分享」页签 | 管理你主动分享出去的内容。包含「人员与部门」和「公开链接」两个子页签。「人员与部门」展示「名称」「分享给」「权限」「时间」，可执行「取消分享」；「公开链接」展示「文件」「状态」「有效至」「访问」，带「有密码」「仅预览」徽标，支持「撤销」。 |
| 「回收站」页签 | 展示已删除的文件与文件夹。顶部提示默认保留 30 天后自动彻底删除；列表包含「名称」「原位置」「删除时间」「剩余」（显示剩余天数）「操作」；支持单项或批量「恢复」与「彻底删除」。空态提示「回收站是空的」。 |
| 「设置」页 | 管理员配置中心。包含返回「文件」链接；提供「空间」/「空间管理」（引导「管理空间」）；展示「用量（组织）」或「用量（你）」；提供「公开链接」总开关；展示「存储位置」及存储桶信息。 |
| 「空间」列表 | 空间管理入口。展示空间「名称」「成员条目」「你的权限」「更新」及「默认」徽标；提供「新建空间」按钮。空态提示「没有你能管理的空间」「新建一个空间。」「请联系空间管理者。」。 |
| 空间详情页 | 展示空间基本信息与成员权限配置。包含「打开空间」按钮、「基本信息」（名称与说明）表单、「成员与权限」编辑器，以及底部的「危险操作」（「删除空间」）。 |
| 文件抽屉 | 点击文件后在右侧滑出（窄屏为全屏面板）。顶栏包含「下载」「分享」与「更多操作」菜单（「重命名」「标签与描述」「移动到…」「复制到…」「上传新版本」「在工作台里引用」「删除」）；主体包含「预览」「信息」「版本」「分享」「活动」五个页签。 |

## 常用操作

### 上传文件

1. 在空间下拉框中选择目标空间，或进入目标文件夹。
2. 点击顶栏的「上传」（或「上传文件」），从本地选取文件；也可以直接将文件拖入窗口中的文件夹区域。拖入时界面提示「松开即可上传」并显示目标位置。
3. 界面弹出上传队列面板，显示正在上传的文件数量与进度。若上传失败会提示具体原因（如单文件「超过 50 MB」或「名称不能为空」）。
4. 上传完成后面板提示「已上传」与「上传完成」，文件列表自动刷新。你可以点击「关闭上传列表」关闭浮层。

> **注意**
>
> 云盘单个文件大小上限为 50 MB。若你只有「可查看」权限，文件夹空态将提示「你在这里只能查看。」，无法上传文件。

### 新建文件夹

![「新建文件夹」对话框](/shots/storage-new-folder.webp)

图：「新建文件夹」对话框

1. 对话框标题
2. 「名称」：文件夹名
3. 「新建」

1. 在文件列表中进入需要新建子文件夹的位置。
2. 点击顶栏的「新建文件夹」按钮。
3. 在弹出的「新建文件夹」对话框中输入文件夹「名称」。
4. 点击「新建」完成创建。

### 浏览、预览与下载

1. 点击文件行或卡片，右侧弹出文件抽屉，默认停留在「预览」页签。
2. 在「预览」页签查看内容：
   - 图片与常见文档支持直接预览。
   - 网页文件在隔离框架中显示，其中的脚本不会运行。
   - 文本文件较大时，仅显示开头的 512 KB，完整内容需下载查看。
   - 表格文件过大时，仅显示前 300 行；空表格提示「表格是空的。」。
   - 文件过大或遇到不支持的格式时，系统提示「文件太大，不在这里预览。」或「这种文件不能在这里预览。」。
   - PDF 文件在抽屉内提示「PDF 无法在面板内显示，请在新标签页中查看。」，点击「在新标签页中查看」可在浏览器新标签页中打开，或直接点击「下载」。
3. 点击抽屉顶部的「下载」按钮，即可将文件下载到本地设备。

### 搜索与筛选

1. 搜索关键词：在顶部搜索框输入文字（提示「搜索名称、描述或标签」；在智能体生成空间提示「搜索智能体生成的文件」），搜索时显示「正在搜索…」，完成后标题切换为「搜索结果」，并展示匹配的项数。
2. 类型筛选：点击类型下拉菜单，可按「全部类型」「文件夹」「图片」「PDF」「文本与代码」「办公文档」「视频」「音频」「压缩包」进行过滤。
3. 来源筛选：点击来源下拉菜单，可切换「全部来源」「上传的」「智能体生成」。
4. 标签筛选：点击标签筛选条件，筛选框显示「标签：」及对应标签名。
5. 清除条件：点击「清除」或「清除筛选」可重置所有筛选条件。若无匹配内容，空态提示「没有找到」「换个关键词，或清除筛选。」。

### 批量操作

1. 鼠标悬停并勾选文件或文件夹前的多选框，顶栏显示「已选 」项数与「 项」（例如 已选 3 项）。
2. 批量移动：点击「移动」，在弹出面板中选择目标文件夹，点击「移到这里」。
3. 批量复制：点击「复制」，在弹出面板中选择目标文件夹，点击「复制到这里」。
4. 批量删除：点击「删除」，系统弹出确认提示，确认后将选中的项统一移入回收站。
5. 取消选择：点击「取消选择」即可清空勾选状态。

> **注意**
>
> 单次批量操作最多支持 200 项；复制包含子级目录时最多支持 500 项。

### 分享给同事与部门

1. 点击文件抽屉中的「分享」按钮，或在文件行操作中点击「分享」。
2. 系统弹出分享对话框（标题显示为分享加上书名号包住的文件名），默认处于「人员与部门」页签。
3. 在「搜索成员或部门」输入框中输入同事姓名或部门名称进行搜索（部门会标注「（部门，含下级）」）。
4. 在权限下拉框中选择访问级别：
   - 「可查看」：仅能浏览和下载该文件。
   - 「可编辑」：可以上传、修改、删除和继续分享。
5. 点击「分享」，系统提示「已分享」，下方「已分享给」列表中会列出被分享对象。
6. 被分享人登录后，可以在云盘顶栏的「与我共享」页签中看到该文件，并在[消息中心](/guide/messages)收到分享通知。
7. 取消分享：进入「我的分享」页签下的「人员与部门」列表，找到对应记录，点击右侧的「取消分享」。

### 创建与管理公开链接

1. 打开需要公开分享的文件抽屉，点击「分享」，在弹窗中切换到「公开链接」页签。
2. 填写公开链接参数：
   - 「有效期」：设置有效天数（1–90 天，默认 7 天）。
   - 「下载次数上限」：输入允许下载的最大次数，留空表示不限。
   - 「密码（可选）」：设置访问密码，至少 4 个字符。
   - 「允许下载」：开启或关闭开关。关闭后，外部访问者只能在线预览，无法下载文件。
3. 点击「创建链接」。
4. 创建成功后弹出「链接已创建」面板，显示完整的公开链接地址。
5. 复制链接：系统提示「链接只显示这一次，请现在复制。」；若设置了密码，提示「记得把密码另外告诉对方。」。请立即复制保存，关闭面板后将无法再次查看该链接。
6. 撤销链接：进入「我的分享」页签下的「公开链接」列表，查看链接状态（显示为「有效」「已过期」「已撤销」或「次数已用完」）；找到目标链接点击「撤销」，链接即刻失效，外部无法再打开。

> **注意**
>
> 公开链接只能分享单个文件，不能分享文件夹。
> 创建公开链接需要管理员授予「创建公开链接」和「分享给同事」权限；若组织在设置中关闭了「允许创建和打开公开链接」，所有已有链接将立即失效。

### 管理历史版本

1. 点击文件打开文件抽屉，切换到「版本」页签。
2. 系统最多保留最近 50 个版本。
3. 上传新版本：点击顶部的「上传新版本」按钮，选取本地的新文件上传，系统将自动生成新版本编号（如第 2 版）并标记为「当前」。
4. 恢复历史版本：在版本列表中找到历史版本，点击右侧的「恢复」。系统会将旧版本的内容提取并保存为最新的一个版本，不会覆盖既有的版本历史记录。
5. 下载旧版本：在版本列表中点击对应版本的「下载」按钮，即可将历史版本文件导出到本地。

### 重命名、标签与描述

1. 重命名：在文件抽屉点击「更多操作」选择「重命名」（或在文件夹菜单点击「重命名文件夹」），输入新「名称」，点击「保存」，系统提示「已重命名」。
2. 标签与描述：在文件抽屉点击「更多操作」选择「标签与描述」。
   - 在「标签」输入框填写标签，标签用逗号分隔，单个文件最多添加 20 个标签，每个标签最多 40 个字符。
   - 在「描述」输入框填写说明（最多 2000 个字）。
   - 点击「保存」，系统提示「已保存」。

### 移到回收站、恢复与彻底删除

1. 移到回收站：在文件抽屉「更多操作」或列表操作中点击「删除」。系统弹出确认提示，说明会移到回收站并在 30 天内可以恢复（若包含文件夹会提示「文件夹里的内容会一起移走。」）。点击确认后系统提示「已移到回收站」。
2. 查看回收站：在顶栏点击「回收站」页签，列表会列出文件名、原位置、删除时间以及剩余天数（显示为「 · 剩 X 天」）。
3. 恢复文件：在回收站列表中找到文件，点击「恢复」，或批量勾选后点击批量栏中的「恢复」，文件将恢复到原位置。
4. 彻底删除：在回收站列表中找到文件点击「彻底删除」，或批量勾选后点击「彻底删除」。系统弹出二次确认提示「删除后不能恢复，所有版本、分享和公开链接都会一起删除。」，点击「彻底删除」后永久清除。

> **危险**
>
> 文件移入回收站后，其所有的内部分享和公开链接会立即失效！
> 「彻底删除」操作不可撤销，文件所有历史版本、分享记录与公开链接将永久销毁。若文件夹内包含超过 5 000 个文件，系统不支持整文件夹直接删除。

### 管理空间与成员权限

![「空间」列表](/shots/storage-spaces.webp)

图：「空间」列表

1. 可管理的空间列表（个人空间不在这里）
2. 「新建空间」：你将成为管理者
3. 列：名称、成员条目、你的权限
4. 「默认」：组织共享空间

1. 点击顶栏右侧齿轮「设置」，进入设置页面。
2. 在「空间」或「空间管理」区域点击「管理空间」，进入空间列表。
3. 新建空间：
   - 点击右上角「新建空间」按钮。
   - 填写空间「名称」（最多 80 个字）与「说明」（最多 500 个字）。
   - 在「成员」中添加需要使用该空间的人员、部门或角色，选择访问级别（「可查看」「可编辑」「可管理」）。创建者会自动成为该空间的管理者。
   - 点击「新建」。
4. 修改空间信息：在空间列表中点击空间进入详情，在「基本信息」栏修改「名称」和「说明」，点击「保存」。
5. 管理空间成员：在空间详情的「成员与权限」区域点击「添加成员」，选择添加对象（「成员」「部门」「角色」或「所有人」），设置权限级别（「可查看」「可编辑」「可管理」），点击「添加」，修改完成后点击「保存成员」。
6. 删除空间：进入空间详情底部的「危险操作」区域，点击「删除空间」。

> **注意**
>
> - **防锁出保护**：修改空间成员时，若移除了自己的管理权限，系统会弹出警告：「保存后你会失去这个空间的管理权限。请保留一个让你仍是「可管理」的条目。」。
> - **删除空空间**：系统只能删除空空间。删除前必须先移走空间内的所有文件并清空该空间的回收站。
> - **默认空间保护**：系统内置的「组织共享」空间不可删除。

## 状态说明

云盘的状态流转涵盖文件生命周期、公开链接状态与分享权限：

```
文件生命周期：
正常 ⇄ 回收站（保留 30 天，可恢复） → 彻底删除（不可恢复）

公开链接状态：
有效 → 已过期 / 已撤销 / 次数已用完（失效后统一显示为「已不可用」）

分享权限：
可查看 / 可编辑（取消分享后立即失效）
```

| 状态类型 | 状态名称 | 说明 |
|---|---|---|
| 文件生命周期 | 正常 | 处于空间目录树中，可正常查看、编辑或分享。 |
| 文件生命周期 | 回收站 | 处于回收站中。关联的分享与公开链接立即失效；默认保留 30 天，逾期自动彻底删除。期间可随时「恢复」。 |
| 文件生命周期 | 彻底删除 | 文件、历史版本、分享记录与公开链接全部永久销毁，无法恢复。 |
| 公开链接状态 | 「有效」 | 链接在有效期内，且未达到下载次数上限，外部访问者可正常打开。 |
| 公开链接状态 | 「已过期」 | 超过了创建时设定的有效天数，链接已无法打开。 |
| 公开链接状态 | 「已撤销」 | 被创建者或管理员手动撤销，链接已无法打开。 |
| 公开链接状态 | 「次数已用完」 | 下载次数已达到设定的上限，链接已无法继续访问。 |
| 公开链接状态 | 「已不可用」 | 链接因过期、撤销或次数用尽而失效的统一状态显示。 |
| 文件来源 | 「上传」 / 「上传的」 | 由成员手动上传到云盘的文件。 |
| 文件来源 | 「智能体」 / 「智能体生成」 | 由助手执行任务时自动生成并保存到云盘的文件。 |

## 让助手帮你做

你可以呼出[助手](/agent/overview)，通过自然对话管理云盘文件。默认情况下，助手为你生成并保存的内容会自动存入「智能体生成」空间中，只有你能看到。

助手的写操作受到风控保护：
- **起草**（生成[草稿](/agent/drafts)待你确认）：新建文件、新建文件夹、修改文件信息、新建空间、修改空间信息。
- **直接执行动作**：移动文件、从回收站恢复文件。
- **需要你[确认](/agent/confirm)**：复制文件、上传新版本、恢复版本、将文件移到回收站（系统提示「移到回收站后，这个文件的分享和公开链接立即失效；30 天内可以从回收站恢复，之后自动清除。」）、分享给同事、取消分享、创建公开链接（系统提示「创建后，组织外任何拿到这个链接的人都能打开文件（不需要登录），直到它过期或被撤销。」，且密码只能由你本人填写）、撤销公开链接、设置空间成员、删除空间（系统提示「空间和它的成员设置会被删除，不能恢复。」）。
- **高危操作（确认并再次验证身份）**：彻底删除文件、修改云盘设置。

你可以对助手说：
> 把这份纪要保存到云盘
> 在组织共享里新建文件夹叫制度
> 把预算表分享给财务部可查看
> 把过期合同移到回收站
> 给这个 PDF 建一个 7 天公开链接
> 新建一个研发资料空间

**助手权限说明**

助手受到严格的权限边界限制：
- 助手无法绕过空间访问权限规则。
- 助手无法查看或修改他人未主动分享的「我的文件」。
- 助手创建公开链接时，不能代你生成或填写密码，必须由你本人设置。
- 助手无法绕过界面直接写入。

## 设置

点击顶栏右侧齿轮「设置」进入设置界面（仅管理员或拥有「管理空间与设置」权限的成员可见）。

![云盘「设置」](/shots/storage-settings.webp)

图：云盘「设置」

1. 设置页：空间、用量与公开链接
2. 「空间管理」：打开空间列表
3. 「公开链接」总开关：关掉后已有链接立即失效
4. 「存储位置」：平台存储或组织自己的桶

| 设置项 | 作用 | 取值范围 | 默认值 | 谁能修改 |
|---|---|---|---|---|
| 「允许创建和打开公开链接」 | 控制组织范围内是否允许创建和访问公开链接。关闭后所有已有的公开链接立即失效，重新打开后恢复。 | 开 / 关 | 以组织当前设置为准 | 组织管理员（需「管理空间与设置」权限） |
| 空间「名称」「说明」与成员 | 配置空间的名称（最多 80 个字）、说明（最多 500 个字）以及成员名单（最多 200 条） | 文本与成员名单 | 创建时指定 | 空间管理者（拥有该空间「可管理」权限） |
| 存储位置 | 查看文件实际存放在哪里。单个文件最多 50 MB。 | 「平台存储」 / 「组织自己的存储桶」 / 「不可用」 | 组织存储配置 | 组织管理员（本页为只读展示，需点击「组织 → 存储」跳转至[存储设置](/deploy/storage)修改） |

### 用量统计
在设置页中展示「用量（组织）」或「用量（你）」统计面板。统计范围包含历史版本和回收站里的文件，具体指标包含：
- 「已用空间」：统计当前使用的总存储容量。
- 「文件」：常规空间文件占用的容量。
- 「智能体生成」：助手生成文件占用的容量。
- 「回收站」：暂存在回收站中的文件占用的容量。

## 注意事项

- **单文件规格与目录深度**：单文件最大支持 50 MB；文件夹层级最多支持 20 层。当文件夹内部文件总数超过 5 000 个时，不支持整文件夹删除。
- **历史版本限制**：每个文件最多保留最近 50 个版本，超出后会自动轮替。
- **回收站保留周期**：文件移入回收站后默认保留 30 天，30 天后系统自动彻底删除。
- **标签与描述规格**：单文件最多设置 20 个标签，每个标签最多 40 个字符；文件描述最多支持 2 000 个字符。
- **名单与链接上限**：每个空间成员上限为 200 条；单个文件或文件夹最多分享给 100 个成员或部门；单个文件最多创建 20 个公开链接。
- **公开链接参数限制**：公开链接有效期为 1–90 天（默认 7 天）；访问密码至少 4 个字符。
- **批量操作限制**：单次批量操作最多选择 200 项；复制文件夹时子树最多包含 500 项。
- **存储配额说明**：云盘没有硬性存储容量配额上限，设置页仅统计实际已用空间。
- **不可恢复操作**：彻底删除文件和删除空间属于不可撤销操作；文件一旦移入回收站，其关联的内部分享和公开链接会即刻失效。
- **私密隔离保护**：成员的「我的文件」与「智能体生成」空间默认仅本人可见，管理员也无法越权查看。
- **与其他应用关联**：[资料库](/apps/library)依赖云盘运行，资料目录即为云盘中的文件夹；[分析](/apps/analysis)可将云盘文件表作为数据源；在[知识库](/apps/wiki)或[文档](/apps/doc)中通过 `@` 引用文件后，抽屉「信息」页签会展示反向引用记录。

## 目前不支持

- 断点续传与分段下载。
- 存储配额硬性上限限制。
- 按文件类型白名单限制上传。
- 在工作台面板内直接内联预览 PDF 文件（已改为在新标签页中打开查看）。

## 常见问题

### 组织管理员能查看我保存在「我的文件」里的文件吗？
不能。个人的「我的文件」与「智能体生成」空间受到严格的私密保护。即使是组织管理员，也无法直接查看或搜索你未主动分享的内容。

### 为什么在顶栏看不到「回收站」或「设置」入口？
入口的显示由组织授予你的权限决定：
- 如果你没有「删除」权限，界面会隐藏「回收站」页签。
- 如果你没有「分享给同事」权限，界面会隐藏「我的分享」页签。
- 如果你没有「管理空间与设置」权限，界面会隐藏齿轮「设置」按钮。

### 文件移入回收站后，之前发给同事的链接还能打开吗？
不能。文件一旦被移入回收站，其所有的内部分享和公开链接都会立即失效。即使随后从回收站恢复了该文件，已失效的分享关系和公开链接也不会自动恢复，需要重新进行分享或生成新链接。

### 为什么公开链接只显示了一次，之后找不到链接地址了？
出于安全考虑，公开链接创建成功后只会在弹窗中展示一次。如果你关闭了弹窗且未复制保存，系统不会再次提供该链接的明文地址。你可以在「我的分享」页签下的「公开链接」列表中将旧链接「撤销」，然后重新生成一个新的公开链接。

### 为什么无法删除某个空间？
系统规定只能删除空空间。如果空间内还存在文件，或者该空间的回收站中仍有未清理的文件，系统不允许删除。你必须先移走或彻底删除该空间内的所有文件，并清空对应的回收站。此外，系统预设的「组织共享」空间为全员公共空间，不允许删除。