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

# 将文档关联到项目

> 把文档加入项目上下文——通过上传、拖放，或从文件库关联

## 概览

只有当一份文档被关联到某个项目后，它的内容才会出现在该项目的检索结果中。有三种方式把文档加进来——同一个文件也可以同时服务于多个项目。

## 添加文档的方式

### 直接上传

在项目的**文件**标签页中，将文件（或整个文件夹——目录结构会被保留）拖放到页面上，或使用上传按钮。文件会进入您的文件库，并在同一步中完成与项目的关联。

### 在对话中附加

在 Playground 消息中附加文件（或把文件分享给已连接的 Agent——OpenClaw 插件会自动上传）。它会被自动上传到该项目的上下文中。

### 从文件库关联

文件已经在别处上传过，或是通过[连接器](/zh/features/memorylake/connectors/overview)挂载进来的？

<Steps>
  <Step title="打开文件标签页">
    进入项目并点击**添加文档**。
  </Step>

  <Step title="在树形结构中选择">
    弹窗会以树形结构展示您的文件库并带有勾选框——可以选择单个文件、整个文件夹（包含全部内容；半选状态表示部分选中），也可以混合选择。连接器空间（WPS Space、Lark Space）同样会出现在这里。
  </Step>

  <Step title="确认">
    所选条目会与项目建立关联并进入处理流程。

    <Check>
      文档会出现在文件标签页中，并显示处理状态。
    </Check>
  </Step>
</Steps>

## 处理状态

| 状态          | 含义           |
| ----------- | ------------ |
| **Pending** | 已排队等待解析和建立索引 |
| **Running** | 正在处理         |
| **Okay**    | 内容已可在该项目中搜索  |
| **Error**   | 处理失败——展开查看详情 |

## 移除文档

取消关联某份文档（文件标签页中的移除操作）会将其从该项目的上下文中移出。**文件本身仍保留在您的文件库中**——也仍保留在其他关联了它的项目中。相比之下，从文件库中删除文件会在所有地方移除它。

## 最佳实践

* 只关联与项目用途相符的内容——聚焦的项目检索效果更好
* 用文件夹关联一次性引入相关文件
* 添加后检查处理状态；内容在变为 `okay` 之前无法被检索
* 定期审核并移除过时文档——陈旧的来源会产出陈旧的答案

## 后续步骤

<CardGroup cols={2}>
  <Card title="文档管理" icon="folder" href="/zh/features/memorylake/document-management/overview">
    文件库：上传、文件夹与文件操作
  </Card>

  <Card title="记忆" icon="brain" href="/zh/features/memorylake/memories/overview">
    内容处理完成之后会发生什么
  </Card>
</CardGroup>