Quivr 是什么?3.9 万星的 RAG 项目重写成 Go,界面和用户体系全砍了(基础篇)

Quivr 是什么?3.9 万星的 RAG 项目重写成 Go,界面和用户体系全砍了(基础篇)

10 月 29 日,Quivr 发了 2.0.0。这个在 GitHub 上攒了 39.6K 星、被无数「第二大脑」教程引用过的项目,没有在原代码上继续加功能,而是把 main 分支换成了一个用 Go 重写的引擎:没有聊天界面,没有用户账号,没有 SaaS 后台。你以前收藏的 pip install 教程,现在只能去 v1-final 这个 tag 里找。

官方给的定位也换了词:不是 RAG 框架,是「一个处理持续到来内容的开源引擎」——存下来、搜得到、盯住你关心的话题。

它到底是干什么的

Quivr 最早是 Stan Girard 团队做的「你的第二大脑」,YC W24 出身,现在挂在 The Vibe Company 名下。仓库 2023 年 5 月建,2,886 次提交,39.6K 星、3,729 个 fork,许可证从 v1 的 Apache 2.0 换成了 MIT。

2.0 的数据流很短:内容从 RSS/Atom、Microsoft 365 邮箱、X 列表定时拉,或者你的应用直接推;api 收下后先写进 PostgreSQL 和 S3 兼容对象存储,然后才回执;worker 在后台读文件、切段落、算向量、比对告警;Weaviate 索引负责关键词加语义的混合检索;命中结果带着文档、版本、字符位置返回,告警则连「为什么命中」一起记下来,通过签名 webhook 或变更流送出去。

整个 quivr 是一个二进制:api、worker、migrate、插件工具、search、mcp 都在里面,长任务交给 Temporal 调度和重试。

Quivr 2 的文档路径:内容源和你的应用把文档送进 api,落盘到 PostgreSQL 与对象存储,worker 调插件切块算向量,写进 Weaviate 索引,最后供应用和 Agent 检索并推送告警
Quivr 2 的文档路径。api 先落盘再回执,加工全在后台,索引只是可以重建的副本(点开图看原尺寸)。

它跟一般知识库最大的区别是「契约」写得细:文档落盘才确认,服务挂了只延迟不丢;每个写请求带幂等键,超时重发不会变两份;改稿是新版本,旧版仍可读,搜索等新版本准备好才切;索引坏了能从库和对象存储重建;搜索依赖的服务挂了就报错,不会假装「没找到」;webhook 至少送一次,接收端自己去重。

对 Agent 来说,quivr mcp 是入口:Agent 搜到的是段落加出处,自己组织答案。

上手

环境要求写在 README 里:Linux x86_64 或 Apple Silicon 的 Mac,Docker Compose v2,go.mod 里的 Go 版本,Python 3.12 加 venv,jq,首次启动约 1GB 下载。

git clone https://github.com/The-Vibe-Company/quivr.git && cd quivr
make dev
eval "$(make -s env)"

然后按 Quickstart 走,大约 15 分钟:建一个 collection、塞一篇文章、分别用关键词和语义搜一次、再设一个告警看它怎么匹配。想看界面就跑 make demo,127.0.0.1:5183 上有个法语界面的监控台示例,纯前端,只调公开 API。

这里得泼一盆冷水:发布镜像是 linux/amd64,官方只承诺 x86_64 和 Apple Silicon。A7Z 这类 ARM64 板子别指望 docker compose up 就完事,Go 本身能交叉编译,但 Weaviate、Temporal、SeaweedFS 这些依赖镜像要自己兜底,出了问题不在官方支持范围里,自托管的 arm64 账我去年就吃过一遍。

实话

第一,它不是「装个带界面的知识库问答」。没有账号、配额、计费,一个 API key 属于组织不属于人,用户体系、限额、收费全是你应用的事。

第二,只处理文本。没有 OCR,扫描版 PDF 能存进去但搜不到;M365 的附件也只存不抽。

第三,关键词不做词形还原,strike 匹配不到 strikes。要么改用语义告警,要么把各种写法都列进去。告警也不回溯,开启之前的老文档不会补判,只能先 preview 看看「本来会抓到什么」。

第四,限额很硬:单文档 1 MiB,一批 100 篇、10 MiB,单文件 1 GiB 且要 15 分钟内传完,单版本只索引 256 KiB,一次搜索最多 16 个 collection、50 条结果还不能翻页,query 上限 8192 字符,默认语义模型只吃 256 token。

第五,官方说单套跑过约 100 万篇新闻,1000 万一个 collection 还没测。alpha 升 2.0 不支持原地升级,得重装重灌;2.x 之间才能 migrate 后滚动。

第六,也是我最在意的一点:所谓「单二进制」只是应用层单二进制,底下 Postgres、对象存储、Weaviate、Temporal 加五个插件一个不少,运维面比名字听起来重。插件挂了会等会重试,不丢件,但你得知道它在等。

那它适合谁?适合要做「内容进来、有出处地搜、命中就通知」这类产品的人:媒体监控、行业情报、研究助手、给 Agent 配一个能引用的证据库。不适合只想要一个上传 PDF 就能聊天的界面,那种需求去看 RAGFlow 更省事;也别忽略前车之鉴,Flowise 五万多星照样归档,星数和能不能长期用是两回事。

一句话:Quivr 2 把 RAG 项目最容易做错的那部分——版本、幂等、索引重建、带原因的告警——写成了可以依赖的契约,代价是你得自己造产品、自己运维,还得接受它只做文本。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注