Open WebUI 知识库适合反复查阅设备说明、项目笔记和个人教程。它与普通对话的区别，是先从资料里找相关内容，再组织回答。本文假定你已经运行 Ollama 与 Open WebUI，不重复安装过程，而是演示如何建立一个小型、可检查的文档库。还没部署环境，可先看Windows 本地 AI 安装教程。
一、先理解“本地”的范围
界面运行在本机，不代表所有环节都在本机。聊天模型、文档提取、嵌入模型和外部搜索，都可能各自连接不同服务。处理私人资料之前，检查管理员设置中的提供商与接口地址，关闭本练习不需要的联网工具。
本练习只使用虚构文本，不上传真实客户资料。确认模型、嵌入和解析都走本地之后，再评估是否能放入自己的文件；同时保护 Open WebUI 的账号、存储目录和备份。
二、准备一份有已知答案的资料
先建一个 UTF-8 文本文件，命名为 test-handbook-v1.txt，写入下列内容：
资料名称：演示设备维护手册
版本：v1，2026-10-22
设备代号：HOME-TEST-01
照片备份：每周六20:00执行。
恢复演练：每月第一个周日进行。
备份负责人：管理员A。
本文没有规定硬盘保修年限。
选这个例子，是因为它既有明确答案，也有明确缺失信息。不要一上来导入几百份扫描 PDF，否则很难分辨是提取、检索还是模型回答出了问题。
三、检查模型与嵌入配置
在 Ollama 中确认至少有一个本地聊天模型。嵌入模型的用途是把文本转成可检索的表示，不等同于聊天模型。若选用 Ollama 的 nomic-embed-text 示例，可先在宿主机下载：
ollama pull nomic-embed-text
ollama list
在 Open WebUI 的管理员文档设置中，确认嵌入引擎、模型与地址指向实际可访问的 Ollama。容器访问宿主机时不能直接把容器的 localhost 当成 Windows；沿用你已验证的连接地址。配置项名称随版本变化，以官方知识库说明为准。
更换嵌入模型后，旧文档向量通常需要重新处理。不要只改模型名字，就假设旧索引已经适配。
四、创建并关联 Open WebUI 知识库
进入 Workspace（工作区）→ Knowledge（知识库），创建“家庭设备演示”，上传测试文本并等待处理完成。打开文件，检查提取内容里是否仍有“每周六20:00”。
在对话里通过知识库选择器或 # 引用这个集合，也可以在模型配置中绑定集合。新版本的检索可能依赖模型的工具调用能力及知识库工具设置；如果资料已上传但从未触发检索，应检查这些选项，而不是只扩大上下文。
只依据关联的“家庭设备演示”知识库回答：
HOME-TEST-01什么时候备份，谁负责？
给出支持答案的原文引用。
另外，资料是否规定了硬盘保修年限？未说明就明确回答未说明。
不要用常识补充保修年限。
五、验收检索结果
合格回答应包含“每周六20:00、管理员A”，并指出没有保修年限信息。点击引用核对来源是否真的是 test-handbook-v1，而不是另一个文件。若答对但没有检索记录或引用，可能只是从对话上下文复述，不能证明知识库有效。
再问“恢复演练是哪一天”，测试另一个句子。把三道题保存为小型回归测试，以后更新模型和索引后重复提问。
六、更新与排错
把备份时间改为周五并保存 v2，重新上传或按界面重新索引；归档或移除测试集合里的 v1，避免两个版本同时被当成现行规则。随后重复已知问题，确认引用指向 v2。
上传成功，为什么总说找不到？
检查提取文本是否为空、处理是否结束、对话是否关联集合、检索工具是否可用。按这个顺序逐层排查。
扫描 PDF 能直接用吗？
取决于所配置的提取与 OCR 能力。先抽查提取文字，再处理整本文件，不要把空文本当成索引问题。
回答有引用就一定正确吗？
不一定。引用可能来自旧版本，或只支持部分结论。仍需核对来源上下文和适用范围。
后续可看资料脱敏与提示词小型评测。模型下载信息见 nomic-embed-text 模型页。
Pingback: NotebookLM 阅读 PDF：用问题清单和原文引用整理长文档
Pingback: 本地 AI 隐私检查：网页在自己电脑上，不代表资料都留在本机