跳到主要内容

📝 Notes 笔记

身旁有 AI 相伴的写作、思考与提炼。

您在搜索、在探索、在综合提炼。Notes 便是将这些过程转化为持久知识的理想阵地。它是一个专属的工作区,用于存放那些存在于单一对话之外的内容:草稿、备忘单、调研结果、项目简报。这些是您随时间不断积累、与 AI 共同提炼,并在未来的聊天中作为上下文注入的内容。

标准的聊天是线性的且具有临时性,而 Notes 则不同,它们是可供您随时返回、编辑和共享的持久化文档。Notes 也不同于传统的文档(RAG,它通过向量搜索来寻找相关的文本块),Notes 会将它们的完整内容直接注入到上下文窗口中,从而让您能够精准控制 AI 看到的内容。


为什么选择 Notes?

内置 AI 辅助写作

选中一段文本并点击 Enhance(增强),即可让 AI 原位重写该段内容。或者,您可以打开 Chat sidebar(聊天侧边栏),在无需离开编辑器的情况下,通过针对性的对话来进行头脑风暴、批评或扩写。

精确的上下文注入

当您将一个 Note 附加到聊天中时,AI 会逐字逐句地阅读整篇文档。这里没有文本分块,没有向量搜索,也无需猜测。您可以精准控制模型所能看到的内容。

持久存在,而非一次性

Notes 独立存在于聊天对话之外。您可以编写一份代码参考指南,在几周内不断充实提炼它,并在有需要的任何时候将其附加到任何对话中。

AI 可读写您的笔记

在启用了 原生函数调用 的情况下,模型可以自主搜索、读取、创建和更新您的笔记,从而将 Notes 转化为一种动态的长期记忆。


核心功能

✍️ 富文本编辑器支持 Markdown 与富文本,并带有悬浮格式化工具栏
🤖 AI 增强原位重写或改进选中的文本
💬 聊天侧边栏针对笔记内容进行专注的 AI 对话
📎 上下文注入将笔记附加到任何聊天中以提供高保真上下文
📌 固定到侧边栏固定常用笔记,以便从侧边栏快速访问
🔍 智能代理访问模型可以自主搜索、读取和更新笔记
📤 导出下载为 .txt.md.pdf 格式

编辑器

Notes 使用一个上下文相关的悬浮工具栏来进行格式化:

  • 点击空白处以开始撰写新的标题、列表或任务列表
  • 双击文本以应用粗体、斜体、下划线、删除线或行内代码
  • 拖放列表项以进行重新排序

顶部栏可以实时显示字数和字符数统计,且点击麦克风图标可以启用语音听写。

聊天中的富文本

该编辑器也可以在标准聊天中启用:转到 Settings > Interface > Rich Text Input for Chat 并勾选 Show Formatting Toolbar


AI 集成

点击AI 按钮(右下角)以访问:

增强 (Enhance)

选中部分文本(如果不选择任何内容,则默认应用于整篇笔记),然后点击 Enhance。AI 会使用该笔记控制选项中所选的模型来原位重写该内容。

聊天侧边栏

打开一个专注于该笔记内容的专属对话。您可以要求 AI 对特定章节进行总结、提取数据、提出批评或进行重写。在提交之前,使用 Edit toggle(编辑切换开关)可以手动修改发送给 AI 的上下文。

所有由 AI 带来的改动均支持通过 Undo/Redo(撤销/重做,位于右上角)进行追踪,因此您随时可以还原到之前的状态。


在聊天中使用 Notes

  1. 转到聊天输入
  2. 点击 + (更多) 按钮
  3. 选择 Attach Notes(附加笔记)
  4. 选择要附加的笔记

该笔记的全部内容都会被注入到当前对话的上下文窗口中。


智能代理式笔记管理

在启用了 原生函数调用 的情况下,模型可以自主操作您的笔记:

工具 (Tool)用途
search_notes按标题和内容搜索您的笔记
view_note读取笔记的完整内容
write_note创建一个新笔记
replace_note_content更新一个已有笔记

您: 搜索我的 “Project X” 笔记,找到数据库 Schema 表结构。

您: 往我的 “Weekly Todo” 笔记中添加一个关于审查 PR 的新任务。


固定笔记

您可以将重要的笔记固定到侧边栏以供快速访问。固定后的笔记将显示在侧边栏专属的 Notes 文件夹中,就像被固定的聊天对话一样。

如何固定

  • Notes 列表中:点击任何笔记上的 菜单并选择 Pin to Sidebar(固定到侧边栏)
  • Note 编辑器中:点击右上角的 菜单并选择 Pin to Sidebar(固定到侧边栏)

如何取消固定

  • 侧边栏中:将鼠标悬停在已固定的笔记上并点击 按钮
  • Notes 列表编辑器中:点击 菜单并选择 Unpin(取消固定)

侧边栏的 Notes 文件夹只有在至少有一篇笔记被固定且启用了 Notes 功能时才会显示。

固定仅对个人生效

固定笔记只会影响您的侧边栏 —— 拥有该笔记访问权限的其他协作者可以各自独立固定或取消固定它,这不会改变您侧边栏的显示。固定的笔记按固定时间的倒序排列(最新的排在最前)。切换固定状态不再计为一次编辑,因此不会更新该笔记的 “Updated” 时间戳。在此次变更前已经存在的固定状态将只为笔记所有者保留;其他共享用户需要重新固定他们想要显示在侧边栏的笔记。


管理与共享

通过右上角 更多 (...) 菜单访问管理选项。

导出

  • 导出为 纯文本 (.txt)Markdown (.md) 以获取原始文本内容
  • 导出为 PDF (.pdf) 并附带视觉格式排版(自动检测深色模式)

共享

  • Copy Link(复制链接)以共享该笔记的 URL
  • Copy to Clipboard(复制到剪贴板)以将内容粘贴到其他地方

管理员可以通过环境变量或管理员面板来控制共享权限:

  • 使用 USER_PERMISSIONS_NOTES_ALLOW_SHARING 开启内部共享
  • 使用 USER_PERMISSIONS_NOTES_ALLOW_PUBLIC_SHARING 开启公开链接共享

这些也可以在 Admin Panel > Settings > Users > Default Permissions 中进行配置。

快速创建

  • 访问 /notes/new 直接打开一个空白笔记
  • 添加查询参数:/notes/new?title=My%20Title&content=Initial%20text
  • 从全局搜索(Cmd+K / Ctrl+K)中选择 “Create a new note” 来创建
  • 直接将 .md 文件拖拽到 Notes 列表中以进行导入

视图选项

Created by you(由您创建)和 Shared with you(与您共享)过滤器之间进行切换,并可在 List(列表)和 Grid(网格)布局之间进行切换。

管理员可见性

Notes 是工作区(workspace)的条目。默认情况下(BYPASS_ADMIN_ACCESS_CONTROL=True),管理员可以看到所有用户的笔记。将 BYPASS_ADMIN_ACCESS_CONTROL 设置为 False 可以限制这一行为。详情请参阅 环境配置文档


使用场景

活动草稿

在 Notes 中起草一些内容,使用 Enhance 将核心要点扩展为丰富段落,并使用 Chat sidebar 碰撞出好题目。此时 Note 是最终生成的成果物,而不仅仅是一份参考。

高保真代码上下文

传统的 RAG 采用概率性的向量搜索,可能会漏掉某行至关重要的代码。您可以直接将具体的函数粘贴到 Note 中并附加它,以此确保模型能 100% 看到您的真实代码,且代码的排列方式完全一致。

数据脱敏

将包含敏感数据的服务器日志粘贴到 Note 中,脱敏删除其中的密钥(或使用 Enhance 执行“将此文本匿名化”),然后将脱敏后的 Note 附加到聊天中。这可以防止敏感数据泄漏到您的对话历史记录中。


局限性

上下文窗口占用

附加笔记会注入其全部文本内容。如果将过大的笔记附加到上下文窗口较小的模型上,可能会导致模型丢失早期的对话上下文。

写入权限

当手动附加时,笔记是只读的。在原生模式(Native Mode)且启用了 replace_note_content 工具时,模型可以自主修改您的笔记。此时请留意审查修改内容,并在需要时使用 Undo/Redo 进行回滚。

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.