Knowledge 本地知识库

给资料散落在笔记、说明书和 PDF 里的人:在自己的 Windows 电脑上建一个范围明确的小库,搜到关键词,就能看到它出自哪份资料的哪一段原文。资料留在本机,目前是个人试点中的原型;网页上的只读示例不用注册,用合成资料演示关键词检索。

状态
仅介绍· 可运行原型,个人试点中;网页上有只读示例可以不注册试用
更新
2026.10.14
技术
RAG · FastAPI · SQLite FTS5 · Chroma

试用示例检索(不用注册) ↗(在新窗口打开)

  1. 资料快照与解析
  2. 关键词索引 + 语义索引
  3. 混合召回
  4. 证据窗口
  5. 带引用的流式回答

Knowledge 在线示例:搜索“BM25”,结果高亮命中词,点“打开原文并定位”可以看到原文片段、版本和位置 在线示例:搜一个词,结果带着命中的片段,“打开原文并定位”能看到原文、版本和行号。示例只检索 9 篇虚构的合成文档。

为什么做

我的笔记分散在几个库里,问一个问题常常要翻好几处;这些资料又是私人的,不想交给在线服务。所以做了一个在本机运行的知识库:资料留在本机,回答必须带着能回到原文的引用。

方案

  • 两路召回:SQLite FTS5 负责精确术语,本地 384 维向量模型加 Chroma 负责同义表达,两路结果用 RRF 融合。
  • 证据窗口:按 token 预算保留完整的证据片段,回答里的引用编号能定位回原文位置。
  • 来源变更即失效:原件被修改、删除或无法读取时,旧版本和相关引用立即失效,历史回答会标出失效,不会悄悄回退到旧版本。
  • 本地优先:服务只绑定本机地址,模型外发和联网采集默认关闭;另有个人笔记、备份导出与恢复、只读 MCP,以及 Windows EXE 打包。

我负责的工作

把资料解析、检索、回答与引用拆成可验证的链路;为来源变更和本地权限设计明确行为;用冻结题集记录召回效果,同时标出尚未完成的验收。

怎么验证的

  • 在旧 wiki 基线上冻结了 40 道题:30 道有答案(精确术语、同义表达和跨文档),5 道无答案,5 道越权。10 道用于调参,30 道留作验收,只测一次。
  • 结果:保留集 20 个正例中,19 个在前 5 个片段里至少命中一篇预期文档,17 个找齐全部预期文档;越权结果为 0。
  • 这组数字的边界:它是词法检索基线,Hit@5 只表示前 5 个片段里有预期文档,不等于答案准确率;基于原始资料的新题集还没有冻结。
  • 权限边界、版本失效和备份恢复有回归测试覆盖。
  • 在线示例(2026-10-14,线上):四个示例问题检索的第一条结果都是预期的文档;管理、上传、对话路径返回 403;只做关键词检索。Safari、Firefox 和真机没有测。

现在做到哪

  • 已经可用:关键词检索、混合召回、流式多轮问答、来源引用与失效提示、个人笔记、备份导出与恢复。
  • 还没完成:语义链路的端到端验收、图片 OCR 自动入库、真实客户端的 MCP 联调、在干净电脑上的安装验收。
  • 分发与许可:采用 PolyForm Noncommercial 1.0.0,源码保持私有,尚无公开下载 Release。基础便携包用于内部验收,不包含本地模型;语义检索与生成需依赖、模型就绪。
  • 在线示例已开放:只读,不用注册,只做关键词检索,资料是 9 篇原创合成文档(发布前由维护者确认不含个人或第三方信息);不开放上传、登录或对话生成,没有向量检索,也不等同于本机完整程序。

继续了解

检索链路、失败定位与合成排名示例见RAG 混合检索实践;开发和验收方式见测试工程师转 AI 应用开发。

过程记录

回到产品列表