跳到主要内容

文件夹与项目

Open WebUI 提供了强大的基于文件夹的分组功能，可将简单的对话容器转化为功能齐全的项目工作区（Project Workspaces）。文件夹不仅能让您对相关对话进行分组，还能定义适用于其中所有对话的特定上下文、System Prompt 和知识库。

启用文件夹​

文件夹功能默认启用。管理员可以通过以下方式控制此功能：

  • 管理员面板（Admin Panel）：文件夹功能与其他功能一起由全局统一控制。
  • 环境变量：ENABLE_FOLDERS - 设置为 True（默认）启用，或设置为 False 禁用。

核心功能​

创建文件夹​

创建一个新文件夹来整理您的对话：

  1. 在侧边栏中，点击“对话（Chats）”旁边的 + 按钮，或者在对话列表中右键点击。
  2. 选择 “新建文件夹（New Folder）”。
  3. 输入文件夹名称。
  4. 点击 保存（Save）。

将对话移入文件夹​

通过将现有对话移入文件夹来对其进行整理：

  • 拖拽（Drag and Drop）：在侧边栏中点击并拖拽任何对话到指定文件夹中。
  • 右键菜单：右键点击一个对话并选择“移至文件夹”。

嵌套文件夹​

文件夹可以嵌套在其他文件夹中，以创建层级组织结构：

  • 从菜单创建子文件夹：右键点击（或点击三点菜单 ⋯）任意文件夹，然后选择 “创建文件夹（Create Folder）” 以直接在其中创建一个新的子文件夹。
  • 拖拽：将一个文件夹拖拽到另一个文件夹上使其成为子文件夹。
  • 通过右键菜单移动：右键点击一个文件夹并使用移动选项将其重新定位到不同的父文件夹下。
  • 文件夹可以展开或折叠以显示/隐藏其内容。
  • 子文件夹的名称在同一个父文件夹下必须是唯一的。如果输入了重复的名称，系统会自动追加数字（例如，“Notes 1”）。

在文件夹中开始对话​

当您在侧边栏中点击一个文件夹时，它将成为您的活动工作区（Active Workspace）：

  1. 在侧边栏中点击任意文件夹以选中它。
  2. 对话界面将显示该文件夹处于活动状态。
  3. 您开始的任何新对话都将自动在此文件夹中创建。
  4. 新的对话将继承该文件夹的设置（System Prompt 和关联知识库）。

文件夹设置（项目配置）​

文件夹可以配置为拥有专属 AI 行为和上下文的完整项目工作区。要编辑文件夹设置：

  1. 鼠标悬停在侧边栏的文件夹上。
  2. 点击 三点菜单（⋯）。
  3. 选择 “编辑（Edit）” 以打开文件夹设置弹窗。

文件夹名称​

更改文件夹 of 名称，以更好地反映其用途或项目主题。

文件夹背景图片​

通过上传背景图片来自定义文件夹的视觉外观。这有助于在工作区中直观地区分不同的项目。

System Prompt​

为文件夹分配专用的 System Prompt，该提示词会自动应用到其中的所有对话：

  • System Prompt 会附加到文件夹中创建的每个新对话的开头。
  • 这为特定的任务或角色定制了 AI 的行为。
  • System Prompt 是可选的 —— 您可以纯粹将文件夹用于组织整理而不设置它。
信息

仅当您拥有设置系统提示词的权限（由管理员设置控制）时，System Prompt 字段才可见。

关联知识库​

将知识库和文件关联到您的文件夹：

  • 所有关联的文件 and 知识库都会自动作为文件夹中每个对话的上下文（Context）。
  • 这为文件夹内的所有对话启用了 RAG（Retrieval Augmented Generation，检索增强生成）。
  • 关联知识库是可选的 —— 没有任何附加文件时，文件夹同样可以用于组织整理。

示例使用场景​

创建“Python 专家”项目

假设您正在开发一个 Python 项目：

  1. 创建一个文件夹并命名为 “Python Expert”。
  2. 编辑文件夹并设置 System Prompt： 
    You are an expert Python developer. You provide clean, efficient, and well-documented code. When asked for code, prioritize clarity and adherence to PEP 8 standards.
  3. 通过关联项目的技术规范 PDF 或库文档来关联知识库。
  4. 点击该文件夹将其选为您的活动工作区。
  5. 开始对话 —— 每个新对话都将具备：
    • Python 专家角色（Persona）
    • 对您项目文档的访问权限
    • 在文件夹中自动归档整理

标签（辅助分类）​

除了文件夹之外，标签（Tags） 为对话提供了一种灵活的标记系统：

  • 添加标签：根据内容或用途为对话应用关键字标签。
  • 通过标签搜索：使用搜索功能按标签过滤对话。
  • 灵活的组织方式：标签可以随时添加或删除，不影响文件夹结构。
按主题打标签

如果您经常讨论 “营销（Marketing）” 或 “开发（Development）” 等话题，可以使用这些词汇对对话进行标记。当您搜索特定标签时，所有相关的对话都会被快速检索到，而不管它们位于哪个文件夹中。

设置描述
ENABLE_FOLDERS全局启用/禁用文件夹功能（默认：True）
USER_PERMISSIONS_FEATURES_FOLDERS控制用户级别的文件夹功能访问权限（默认：True）
This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.