文件夹与项目
文件夹与项目
Open WebUI 提供强大的基于文件夹的组织能力，可将简单的聊天容器升级为完整的项目工作区。文件夹不仅能分组相关对话，还能为其中所有聊天统一定义上下文、系统提示词和知识库。
启用文件夹
文件夹默认启用。管理员可通过以下方式控制该功能：
- 管理面板：文件夹功能与其他功能一起进行全局控制
- 环境变量：
ENABLE_FOLDERS- 设为True（默认）启用，设为False禁用
核心功能
创建文件夹
创建一个新文件夹来组织你的对话：
- 在侧边栏中点击 “聊天” 旁边的 + 按钮，或在聊天列表中右键
- 选择 "新建文件夹"
- 输入文件夹名称
- 点击 保存
将对话移动到文件夹中
你可以把现有聊天整理到文件夹中：
- 拖拽：在侧边栏中将任意对话拖入某个文件夹
- 右键菜单：右键某个对话并选择 "移至文件夹"
嵌套文件夹
文件夹可以嵌套在其他文件夹中，形成层级结构：
- 从菜单创建子文件夹：右键（或点击三点菜单 ⋯）任意文件夹，选择 "创建文件夹"，即可直接在其中创建子文件夹
- 拖拽：把一 个文件夹拖到另一个文件夹上，即可把它变成子文件夹
- 通过上下文菜单移动：右键某个文件夹并使用移动选项，将它迁移到另一个父文件夹下
- 文件夹可展开或折叠，以显示 / 隐藏其内容
- 同一父文件夹下，子文件夹名称必须唯一；若输入重复名称，系统会自动追加编号（例如 "Notes 1"）
在文件夹中开始聊天
当你点击侧边栏中的某个文件夹时，它会成为你的当前工作区：
- 在侧边栏点击任意文件夹将其选中
- 聊天界面会显示该文件夹当前处于激活状态
- 此后你新建的任何聊天都会自动创建在该文件夹中
- 新聊天会继承该文件夹的设置（系统提示词与知识库）
文件夹设置（项目配置）
文件夹可以被配置为完整的项目工作区，拥有独立的 AI 行为和上下文。要编辑文件夹设置：
- 将鼠标悬停在侧边栏中的某个文件夹上
- 点击三点菜单（⋯）
- 选择 "编辑" 打开文件夹设置弹窗
文件夹名称
你可以修改文件夹名称，使其更准确地反映用途或项目内容。
文件夹背景图
你可以上传背景图来自定义文件夹的视觉外观，从而更直观地区分工作区中的不同项目。
系统提示词
你可以为文件夹指定专属 系统提示词，它会自动应用到该文件夹中的所有对话：
- 该系统提示词会预置到在此文件夹中新建的每个对话中
- 这可让 AI 针对特定任务或 persona 采取定制行为
- 系统提示词是可选的；即使不设置，文件夹仍可纯粹用于组织
只有当你拥有设置系统提示词的权限时（由管理员设置控制），系统提示词字段才会显示。
附加知识
你可以将知识库和文件关联到文件夹：
- 所有关联文件和知识库都会自动作为上下文注入该文件夹中的每次聊天
- 这使得该文件夹中的所有对话都具备 RAG（Retrieval Augmented Generation）能力
- 知识库也是可选的；即使不附加文件，文件夹依旧可仅用于组织
示例用例
假设你正在进行一个 Python 开发项目：
-
创建一个文件夹，命名为 "Python Expert"
-
编辑该文件夹，并设置系统提示词：
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.
-
附加知识，例如关联你项目的技术规格 PDF 或库文档
-
点击该文件夹，将其设为当前激活工作区
-
开始聊天 —— 每个新对话都会自动具备：
- Python 专家角色
- 访问项目文档的能力
- 自动归档到该文件夹中
标签（补充性组织方式）
除文件夹外，标签也提供了一种灵活的对话标记方式：
- 添加标签：根据内容或用途，为对话添加关键词标签
- 按标签搜索：通过搜索功能按标签筛选对话
- 灵活组织：标签可随时添加或移除，且不会影响文件夹结构
如果你经常讨论“marketing”或“development”等主题，可以用这些词给对话打标签。这样当你搜索某个标签时，无论这些对话位于哪个文件夹，都能被快速找到。
相关配置
| 配置项 | 说明 |
|---|---|
ENABLE_FOLDERS | 全局启用 / 禁用文件夹功能（默认：True） |
USER_PERMISSIONS_FEATURES_FOLDERS | 控制用户层面对文件夹功能的访问权限（默认：True） |