Skip to main content

笔记 (Notes)

Open WebUI 中的 笔记 (Notes) 功能为内容创作和知识管理提供了一个专用工作区。虽然 Open WebUI 中的普通聊天保留了您的线性对话，但 笔记 允许您策划独立于任何单一对话而存在的特定内容，例如长篇草稿或代码备忘单。这些笔记可以使用您的 LLM 进行编写和增强，并无缝地作为上下文注入到新的聊天中。

笔记编辑器​

笔记界面是一个全功能的写作环境，支持 Markdown 和富文本。

悬浮格式工具栏​

笔记使用上下文相关的 悬浮工具栏 进行格式化，而不是屏幕顶部的静态工具栏。

  • 点击空白处：工具栏将出现在您的光标位置，允许您开始新的元素，如标题或列表。
  • 双击文本：高亮显示或双击现有文本会召唤工具栏以应用样式选项。

工具栏选项：

  • 标题：H1、H2、H3 用于文档结构。
  • 列表：项目符号 (·) 和编号列表 (1.)。
  • 任务列表：用于待办事项列表的交互式复选框 (☑)。
  • 样式：粗体、斜体、下划线和 删除线。
  • 代码：内联代码格式 </>。

拖放列表重排序​

列表项可以通过拖动来重新排序。悬停在列表项上时会出现视觉拖动手柄，方便重新组织内容。

虽然此工具栏是笔记工作区原生的，但也可以为标准聊天启用。

要在主聊天输入框中看到此工具栏：
  1. 转到 设置 > 界面。
  2. 将 聊天富文本输入 切换为开启。
  3. 将 显示格式工具栏 切换为开启。

输入工具与指标​

  • 指标：顶部页眉显示实时的 字数 和 字符数，这对于起草有长度限制的内容非常有用。
  • 语音听写：点击左下角的 麦克风 图标，使用语音转文本直接将文本听写到笔记中。

AI 集成​

LLM 直接与您的笔记集成，将编辑器转变为 AI 辅助的工作区。点击屏幕右下角的 AI (星光/星星) 按钮即可访问这些功能。

1. 增强 (Enhance)​

增强 功能允许您将 AI 用作就地编辑器。

  1. 高亮显示特定的文本部分（或不选择任何内容以针对整个笔记）。
  2. 点击 增强。
  3. LLM（在笔记控制中选择）将以增强为目标直接在编辑器中重写您的文本。
自定义控制

如果您需要特定的风格或语气（例如，“将此重写得更专业”），请改用 聊天 侧边栏：

  1. 选择您的文本。
  2. 点击 聊天 按钮。
  3. 如果您需要手动修改上下文，请开启 编辑 开关。
  4. 指示 AI 根据您的特定需求重写所选内容。

2. 聊天 (侧边栏)​

聊天 按钮会打开一个专门针对笔记内容的侧边栏对话。这是一种“与数据聊天”模式。

  • 您可以要求 AI 总结笔记、提取特定数据或批评您的写作。
  • 编辑开关：在聊天侧边栏内有一个 编辑 开关。这允许您在按下发送 之前 手动修改发送给 LLM 的高亮上下文，从而让您对查询进行细粒度控制。

撤销 / 重做​

撤销/重做 箭头（右上角）跟踪所有更改。关键的是，这包括 AI 所做的更改。如果 增强 功能产生的结果让您不满意，您只需点击撤销即可恢复到原始文本。

在聊天中使用笔记​

您可以将笔记的内容注入到标准的聊天会话中，为 AI 提供上下文。

如何附加笔记​

  1. 转到主 聊天输入 栏。
  2. 点击 + (更多) 按钮。
  3. 选择 附加笔记。
  4. 从列表中选择所需的笔记。

该笔记的全部内容将被加载到该对话的上下文窗口中。

管理与共享​

Open WebUI 提供了几种通过右上角的 更多 (...) 菜单导出和管理笔记的方法。

下载​

您可以以标准格式导出您的笔记：

  • 纯文本 (.txt)：原始文本内容。
  • 纯文本 (.md)：保留 Markdown 结构（标题、代码块等）。
  • PDF 文档 (.pdf)：应用了视觉格式的渲染文档。深色模式样式会自动检测并应用。

共享​

  • 复制链接：将特定笔记的直接 URL 复制到剪贴板（便于稍后返回笔记）。
  • 复制到剪贴板：将笔记的整个 内容（文本）复制到剪贴板，以便粘贴到其他应用程序中。

删除​

您可以从两个位置永久删除笔记：

  1. 从笔记仪表板：在列表视图中点击单个笔记卡片上的 更多 (...) 按钮并选择 删除。
  2. 从编辑器中：在打开的笔记内部，点击屏幕右上角的 更多 (...) 按钮并选择 删除。

通过 URL 快速创建笔记​

可以通过导航到具有可选查询参数的 /notes/new 来直接创建笔记：

  • /notes/new — 打开一个空白笔记
  • /notes/new?title=My%20Title&content=Initial%20text — 预填充标题和内容

这实现了用于快速创建笔记的书签和快捷方式。

从搜索中创建笔记​

您也可以直接从全局搜索栏创建笔记：

  1. 使用键盘快捷键 (Cmd+K / Ctrl+K) 或点击搜索图标打开搜索。
  2. 输入您的初始笔记内容。
  3. 从操作列表中选择 “创建一个新笔记”。
  4. 这将立即打开一个以您的搜索文本为内容的新笔记。

导入笔记​

您可以将现有的 Markdown (.md) 文件导入到您的笔记工作区：

  • 拖放：只需将 .md 文件直接拖动到笔记列表视图即可导入它们。

查看选项​

笔记仪表板提供了组织内容的不同方式：

  • 过滤：在 由您创建（您的私人/共享笔记）和 与您共享（他人共享的笔记）之间切换。
  • 布局：在 列表 和 网格 视图之间切换以满足视觉偏好。

共享权限​

管理员可以通过环境变量或管理员面板控制共享功能：

  • 内部共享：USER_PERMISSIONS_NOTES_ALLOW_SHARING（控制与服务器上的其他用户/组共享）。
  • 公共共享：USER_PERMISSIONS_NOTES_ALLOW_PUBLIC_SHARING（控制生成公共外部链接）。

这些也可以在 管理员面板 > 设置 > 用户 > 默认权限 中配置。

使用场景​

虽然 Open WebUI 拥有专门的 提示词（用于斜杠命令）和 文档（用于 RAG），但 笔记 在迭代工作和精确控制方面提供了一个独特的中间地带。

1. “活的”草稿 (迭代写作)​

与静态提示词或上传的文档不同，笔记是一个工作区。

  • 场景：您正在写一篇博客文章或文档。您起草大纲，使用 增强 工具将要点扩展成段落，并使用 聊天 侧边栏集思广益标题。笔记变成了最终产品，而不仅仅是参考。

2. 高保真代码暂存​

RAG（文档）使用向量搜索，这是概率性的——它可能会遗漏大文件中的关键一行代码。

  • 场景：您有来自不同文件的三个特定函数，需要一起重构。将它们复制/粘贴到聊天中很乱。相反，将它们粘贴到笔记中。当您附加笔记时，您可以保证 LLM 看到该代码的 100%，正如您排列的那样，而没有 RAG 的“模糊”猜测。

3. 瞬态数据脱敏​

有时您需要分析数据（如错误日志），但需要先清理它。

  • 场景：您有一个包含敏感 API 密钥的服务器错误日志。将日志粘贴到笔记中，手动删除密钥或使用 增强 来“匿名化此文本”，然后 将脱敏后的笔记附加到聊天中以向 AI 寻求解决方案。这可以防止将敏感数据泄漏到您的主聊天历史记录或嵌入中。

局限性​

了解笔记与其他功能（如“文档”）在技术上的运作差异非常重要。

上下文注入 vs. 向量搜索​

  • 文档 (RAG)：当您将文件上传到“文档”时，系统会使用向量搜索根据您的查询找到文件的相关 片段。这是概率性的。
  • 笔记 (确定性)：当您附加笔记时，您正在执行 手动上下文注入。系统不会猜测；它强制 LLM 阅读 整个 笔记。这保证了模型能看到信息，但需要您手动选择正确的笔记。

上下文窗口占用​

因为附加笔记会将全文注入到聊天中：

  • 如果您有一个非常大的笔记（例如 10,000 字）并将其附加到上下文窗口较小（例如 8k token）的模型，模型可能会耗尽内存或“忘记”对话的开头。

只读上下文​

当您将笔记附加到标准聊天时，对于 AI 来说它是 只读 的。

  • 主聊天中的 AI 无法自动更新笔记文件中的文本。如果 AI 对您的项目提出了修改建议，您必须手动将这些更改复制回笔记编辑器。