---
title: "文件管理"
description: "在 Console 中上传参考资料、下载 Agent 产物，并管理 Agent 的持久文件。"
url: "https://ankole.agentbull.com/zh-Hans-CN/docs/file-management/"
lang: "zh-Hans-CN"
---

> 面向 AI Agent 的文档索引：https://ankole.agentbull.com/zh-Hans-CN/llms.txt

# 文件管理

**多数情况下，你不需要使用本页介绍的文件浏览器。在对话中直接向 Agent 发送文件，即可创建、读取、修改、整理或传输文件。仅当需要找回未送达的产物、检查中间输出或手动整理目录时，才使用 Console 文件浏览器。**

Agent 在 Worker 的持久文件系统中读取资料、保存工作过程和产出文件。你可以在 Console 中上传参考资料，下载报告、图片或数据文件，也可以重命名和删除不再需要的内容。

## 找到 Agent 的文件

1. 打开 Console 的**工作节点**。
2. 选择一个可用的 Worker，再选择**浏览文件**。
3. 选择 Agent。
4. 选择要查看的文件范围：

| 范围 | 内容 | 常见操作 |
|---|---|---|
| **用户文件** | 人为提供给 Agent 的参考资料、模板和输入文件 | 上传、下载、重命名、删除 |
| **Agent 会话** | Agent 在聊天会话中产生的工作文件 | 下载产物，必要时清理旧文件 |
| **Agent 已安装技能** | 当前 Agent 可以读取的 Skill 文件 | 查看是否已经同步；通常不在这里手工修改 |

列表按 Worker 打开，但正式部署中的 Agent 持久存储应由所有 Worker 共享。Docker Compose 使用本机持久卷；Kubernetes 使用可多节点读写的共享卷。若不同 Worker 看到的文件不一致，应先检查存储挂载，而不是重复上传。

## 上传参考资料

1. 进入**用户文件**。
2. 打开目标目录，或在上传时填写子目录。
3. 选择**上传**并添加文件。
4. 回到聊天中告诉 Agent 文件名、所在目录和要完成的任务。

子目录会在上传时自动创建。用稳定、清楚的名称，例如 `customer-research/2026-q3-interviews.pdf`；不要把所有文件都放在根目录，也不要仅用 `final-v2-new.pdf` 这类无法判断内容的名字。

上传文件只表示 Agent 可以读取它，不会自动开始处理。要立即使用，请在聊天中明确告诉 Agent；要长期吸收为知识，请从长期记忆的**学习资料**入口提交。

## 下载 Agent 的产物

Agent 在会话中生成文件后，可以从**Agent 会话**中找到并下载。若文件很多，先按会话目录缩小范围，再搜索文件名或类型。

如果聊天里已经收到附件，直接从聊天下载即可。Console 主要用于找回没有成功投递的产物、检查中间文件，或批量整理长期保留的结果。

## 重命名和删除

选择文件右侧的操作菜单可以重命名或删除。重命名不会修改文件内容。

删除文件和目录是永久操作，没有回收站。删除目录时会连同子目录一起移除。清理前先确认 Agent 没有正在使用这些文件；重要内容应先下载，或确认已经包含在 [备份](https://ankole.agentbull.com/zh-Hans-CN/docs/backup-and-restore/index.md) 中。

不要直接编辑**Agent 已安装技能**中的文件。Skill 的启用状态通过 [Agent 能力库](https://ankole.agentbull.com/zh-Hans-CN/docs/skills/index.md) 管理；Skill 内容应在它的来源中修改，再重新同步。

## 哪些内容会保留

用户文件、Agent 会话文件和已安装 Skill 都位于持久存储中，Worker 重启后仍会保留。Worker 的临时目录不属于这里，重启后可能消失。

Agent 的 `MISSION`、`SOUL` 和 `DESIGN` 文档由 Console 的 Agent 编辑页管理。它们会投影到 Worker，但不应当通过文件浏览器修改。如何配置这些文档见 [Agent](https://ankole.agentbull.com/zh-Hans-CN/docs/agents/index.md)。

## 常见问题

- **列表为空**：确认选择了正确的 Worker、Agent 和文件范围，并检查 Worker 是否处于可用状态。
- **上传后 Agent 找不到文件**：确认文件在该 Agent 的**用户文件**中，并在消息里提供准确的相对路径。
- **文件只在部分 Worker 出现**：检查所有 Worker 是否挂载同一个持久卷。
- **无法下载生成结果**：确认任务已完成，并在正确的会话目录中查找。
- **列表提示已截断**：进入更具体的子目录后再搜索。