📁 文件管理
Open WebUI 提供了一个全面的文件管理系统，允许您在知识库（Knowledge Bases）和 RAG 等各种功能中上传、组织和利用您的文档。
集中式文件管理器
集中式文件管理器提供了一个统一的界面，用于查看、搜索和管理您上传到 Open WebUI 实例的每个文件，无论它是直接上传到聊天中还是上传到知识库中。
访问文件管理器
- 点击左下角的个人资料名称或头像。
- 从菜单中选择 Settings（设置）。
- 导航到 Data Controls（数据控制）标签页。
- 找到 Manage Files（管理文件）行，然后点击 Manage（管理）按钮。
关键功能
文件管理器弹窗提供了几种用于维护数据的强大工具：
- 通用搜索：使用集成的搜索栏，通过文件名快速查找任何文件。
- 高级排序：按以下方式组织您的文件列表：
- 文件名：按字母顺序排序以寻找特定的文档。
- 创建时间 ：查看您最近上传的文件或寻找较旧的文件。
- 文件详情：一目了然地查看重要信息，包括：
- 文件大小：查看每个文档占用了多少空间（例如 KB、MB）。
- 上传日期：追踪每个文件添加到实例中的时间。
- 内置查看器：点击任何文件以打开 File Item Viewer（文件项查看器），它会显示文件的元数据和具体详情（如大小和类型）。
- 安全删除：轻松移除您不再需要的文件。
- :::info 知识库清理 当您通过文件管理器删除文件时，Open WebUI 会自动执行深度清理。它会从所有关联的知识库中移除该文件，并删除其对应的向量嵌入（vector embeddings），以确保您的数据库保持干净和高效。 :::
在 Open WebUI 中使用文件
文件是平台各项高级能力的核心：
1. 检索增强生成 (RAG)
通过上传文档（PDF、Word 文档、文本文件等），您可以将 AI 的回答置于您自己的数据中。
- 聊天上传：只需将文件拖放到聊天中，或使用上传图标。
- 知识库：将文件添加到结构化集合中，以实现更持久和有条理的检索。
2. 文件元数据
每个文件都带有元数据，帮助您和 AI 理解其上下文。这包括内容类型、原始文件名和大小。
最佳实践
- 命名规范：使用清晰、描述性的文件名。这可以提高文件管理器搜索的准确性，并帮助您识别特定文档。
- 定期审计：定期使用 Manage Files 仪表板来删除陈旧或冗余的文档。这可以节省磁盘/数据库空间，并通过确保仅保留相关数据来提高系统的性能。
常见问题
Q: 如果我删除了一个文件，它会从我的聊天中消失吗？
A: 会的。通过文件管理器删除文件会将其从系统中彻底移除。任何使用 RAG 引用该文件的聊天都将无法再从中获取信息。
Q: 我可以从文件管理器中将我的文件下载回来吗？
A: 目前，文件管理器主要专注于元数据查看和管理（删除）。要下载文件，您通常应该从使用该文件的原始聊天或知识库中进行访问。
Q: 我可以管理的文件数量有限制吗？
A: Open WebUI 中没有硬编码的限制。可扩展性取决于您的存储（磁盘/S3）以及您的向 量数据库（Vector Database，例如 ChromaDB, PGVector）。
Q: 管理文件需要管理员（Admin）权限吗？
A: 普通用户可以管理他们自己上传的文件。管理员拥有额外的工具，可以通过 Admin Panel（管理员面板）管理全局文件和配置。