文件管理

多数时候，你不需要打开本页介绍的文件浏览器。直接把文件发给 Agent，或者在对话中让它创建、读取、修改、整理和发送文件即可。只有需要找回没有成功发送的产物、检查中间文件或手工整理文件时，才需要进入 Console。

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

找到 Agent 的文件

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

列表按 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 没有正在使用这些文件；重要内容应先下载，或确认已经包含在备份中。

不要直接编辑Agent 已安装技能中的文件。Skill 的启用状态通过Agent 能力库管理；Skill 内容应在它的来源中修改，再重新同步。

哪些内容会保留

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

Agent 的 MISSION、SOUL 和 DESIGN 文档由 Console 的 Agent 编辑页管理。它们会投影到 Worker，但不应当通过文件浏览器修改。如何配置这些文档见 Agent。

常见问题

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