# 文件与工作区

附加材料、预览交付物，并区分本机文件与服务端工作区。

## 文件的保存位置

工作区（Workspace）是保存任务文件的目录，保存输入、过程文件和交付物。桌面任务通常在本机执行，Web 任务在服务器执行。网页所在的电脑与运行任务的机器可能不同。

| 操作 | 文件在哪里 |
| --- | --- |
| 附加本机文件到 Web 会话 | 上传后的材料进入服务端工作上下文 |
| Agent 生成一份报告 | 保存在它使用的工作区或指定可访问目录 |
| 在网页中预览 | 查看运行环境中的文件 |
| 下载交付物 | 将文件保存到浏览器所在电脑 |

## 提供材料

在输入区使用附件入口选择材料，等待附件就绪后再发送。说明每份文件的用途，以及是否允许修改原件。Web 会话需要上传本机材料，服务器无法通过本机路径读取文件。

```text
请读取附加的需求说明，保留原文件不动。
把问题清单写入 workspace 中的 review-notes.md，并返回文件链接。
```

上传前去除与任务无关的凭据和个人信息。文件内容可能进入模型请求，具体边界见[数据与凭据](/docs/data-privacy)。

## 挂载桌面本地文件夹

桌面端可以从当前会话输入区挂载多个本地工作文件夹。挂载给会话增加可工作的目录，不等于把整个目录上传为一条附件。确认读写范围后再交给 Agent；Web 版没有同等的访问者本机挂载能力。

单个消息附件上限为 20 MB。超过时先按任务需要拆分材料，或在桌面端使用可访问的工作目录。

## 打开和验收交付

![官网交互演示中的会话、文件预览与工作区列表](/images/docs/workbench.png)

*官网交互演示截图，使用演示材料说明文件预览布局。*

从回复文件链接或工作区列表打开产物。Nexus 按文件类型提供对应预览；无法预览时可以下载并使用本机应用查看。预览失败不一定代表文件不存在。

检查文件名、内容与更新时间，特别是 Agent 修改已有文件时。用于发布的文件还应核对图片、链接和格式；代码应核对差异和适当的验证结果。

## Room 的共享材料

Room 可以使用公共附件支持共同工作，但每个成员仍有自己的工作上下文。明确给出共享材料与最终交付位置，避免多个成员各自生成同名文件却没有汇总。

需要多人同时修改时，以文件或步骤划分职责。同一文件需要安排修改顺序，避免覆盖其他成员的结果。

## 路径与访问失败

文件找不到时，先确认当前 Agent、会话、运行机器与路径。权限不足时，检查 Agent 的审批模式和宿主允许访问的范围。也可以将所需材料复制到允许访问的目录。

同一用户下的不同 Agent 目录用于组织工作，不代表彼此不可访问。跨用户隔离依赖宿主的权限与运行环境，参见[数据与凭据](/docs/data-privacy)。

## 保留重要成果

将重要交付下载或纳入自己的版本管理。备份需要覆盖完整 Nexus 状态，而不仅是当前文件列表，详见[备份与恢复](/docs/backup)。