3个月拿下 3000 star，只因我们比 MinerU 多做了这件事

5 月的时候，我们把 Knowhere 的完整技术栈开源了。 到现在3个月左右，GitHub 已经收获了近 3000 Star 。对一个偏基础设施、偏工程落地的项目来说，这个速度让我们挺意外，也挺兴奋的。 因为 Knowhere 做的并不是一个看起来特别“炫”的东西。它没有更新大模型，也没有做一个新的办公助手，它专注的是 RAG 和 AI Agent 落地里最脏、最累、也最容易被低估的一环： 文档怎么变成 Agent 真正能用的知识。 很多人第一次看 Knowhere，都会问同一个问题： “这不就是文档解析吗？和 MinerU 有什么区别？” 这个问题问得很好。因为 Knowhere 和 MinerU 的关系，正好解释了我们为什么要做这个项目。 MinerU 做解析，Knowhere 还做解析之后的事 MinerU 是一个很优秀的文档解析工具。它能把 PDF 里的文字、标题、表格、图片等内容提取出来，并转换成 Markdown。 但问题在于：解析成 Markdown，并不等于文档已经能被 Agent 理解。 你拿到一份 Markdown 后，通常还要做这些事： 把它切成 Chunk，扔进向量库，然后让 Agent 或 RAG 系统去检索。 听起来很顺，但真正做过的人都知道，坑就在这里。 一份复杂 PDF 原本有章节、有层级、有表格、有图片、有跨页引用。解析成 Markdown 之后，这些结构信息会变弱；再经过切片，每个 Chunk 更像是被切下来的孤立文本片段。 它可能不知道自己属于哪一章，前后文是什么，旁边那张表格在说明什么，相关图片和正文是什么关系。 于是 Agent 检索时，拿到的只是几个“看起来相似”的片段。它不知道"第3章第2节有一张对比表格，刚才检索到的那段文字其实是对这张表格的说明"。它只能把几个相似度最高的碎片拼在一起，交给 LLM 凑出答案。 这就是为什么很多团队用 MinerU 搭 RAG 之后，效果并不是很满意。不是 MinerU 的问题，是文档被打平之后丢失的结构信息，没人帮它找回来。 而 Knowhere ，就是想要解决这个问题。 它不是要做“下一个 MinerU”，它想做的是补上 MinerU 没做到的那一步： 把解析出来的文本，继续变成 Agent 可以导航、可以引用、可以推理的长期记忆。 Knowhere 是怎么做的？ Knowhere 的定位是： 复杂、脏乱文档和 AI Agent 之间的 Memory Layer。 它不是简单地把文档解析成文本，而是把文档处理成一套可持续使用的结构化记忆。 在解析和向量化之间，Knowhere 插入了一个结构重建的流水线： 第一，重建文档层级。 Knowhere 会用树形结构算法恢复文档里的章节关系。每个 Chunk 不再只是一个孤立文本块，而是知道自己在哪个标题下、处于哪一层级、上下文路径是什么。 第二，处理多模态内容。 图片、表格不再只是“附件”或者“丢失的信息”。Knowhere 会对图片做 OCR 和描述，对表格做摘要和结构化处理，并把它们和来源 Chunk 关联起来。这样 Agent 检索时，不只是检索文字，也能拿到相关图表证据。 第三，构建轻量记忆图谱。 当文档被拆成 Chunk 后，Knowhere 会保存导航树、摘要、图谱链接等信息，让文档不再是平铺文本，而是一张可以被 Agent 走动和追踪的知识结构。当你上传多份文档，Knowhere 会在文档之间建立关联，形成一张可导航的跨文档知识图谱。 第四，提供 Agentic Retrieval。 传统 RAG 更多是向量相似度检索，拿几个片段就交给 LLM。Knowhere 的检索会融合关键词、路径、内容和语义信号，让 Agent 先发现相关区域，再沿着章节树和图谱链接继续深入，最后返回可溯源的结果。 第五，保留原始页面作为证据。 有些资料不适合被强行压成文字，比如扫描件、复杂表格、工程图纸，所以 Knowhere 还做了纯视觉页面理解路线 VISION-MAP。它会完整保留原始图像页面，再按照文档原生的章节、主题和内容关系，将页面组织成可以跨文档导航的层级图谱与关系网络，方便 Agent 检索和定位，并让视觉模型直接核对源页面。 文本轨负责高效地读，视觉轨负责完整地看；两条轨道最后仍汇入同一张文档地图。 这就是那件“比 MinerU 多做的事”。 MinerU 只把 PDF 变成 Markdown。 Knowhere 则会把 Markdown 进一步变成 Agent 能用的记忆。 Knowhere 比 MinerU 多做的不是一个小功能，而是把“解析后的文档如何进入 RAG/Agent 系统”这整条链路补齐了。 效果怎么样？ 我们做过内部评测：在相同的 Agentic RAG 任务里，让 Agent 分别基于原始文档、普通 parser 输出，以及 Knowhere 处理后的结构化记忆来完成搜索、修改、问答等任务。 结果很直接： 首次准确率提升 36%召回率提升 11%有反馈时准确率达到 79%，而直接使用原始文档大约会卡在 53% 左右Agent 循环次数更少，Token 消耗更低，完成任务更快 原因也不复杂。 如果 Agent 面对的是一整坨文本，那它只能盲找。 但如果 Agent 面对的是一棵树、一张图、一组带来源路径的 Chunk，它就可以像人读文档一样：先看目录，再定位章节，再进入细节。 这就是结构带来的差异。 Knowhere 能用来做什么？ 如果你的 AI 应用需要从文档里拿信息，Knowhere 就有用。 比如企业内部知识库—— 产品手册、操作规程、FAQ、培训资料，很多都不是简单文本，而是 PDF、Word、PPT、Excel 混在一起。Knowhere 可以把这些文档处理成 Agent 可检索的结构化记忆。 比如技术文档助手—— 设备说明书、API 文档、工程图纸、维护手册，经常又长又复杂。Knowhere 已经支持超长 PDF 和 atlas-style documents，几百页的技术手册、图纸集合也能走专门的布局感知 parser。 比如合同和报告分析—— 法律文件、财报、招投标文件、研究报告都非常依赖上下文，如果只靠平铺切片，很多引用关系和章节逻辑会丢。Knowhere 的章节路径和证据引用能让结果更稳。 比如工程审计助手—— 对于扫描合同、工程图纸、复杂表格和图文混排报告，Knowhere 可以通过 VISION-MAP 直接理解原始页面，核对数字、表格、图纸标注或版式关系，再把审核结果带回，显著增强 Agent 检索与回答过程的透明度、可解释性和可审计性。 比如 Agentic RAG —— 很多团队现在不是只做“问答”，而是希望 Agent 能基于文档完成多步任务，那就更需要文档本身是可导航的，而不是一堆碎片。 和 MinerU 相比，Knowhere 的优势在哪里？ 准确说，Knowhere 不是 MinerU 的替代品，而是 MinerU 的更进一步。 MinerU 擅长文档解析，它把 PDF 里的文字、标题、表格、图片等内容提取出来，生成 Markdown 或结构化结果。对很多开发者来说，这一步已经非常有价值。 但