WeKnora 上手指南：从本地部署到 RAG 文档问答的实操路径

WeKnora 上手指南从本地部署到 RAG 文档问答的实操路径【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora手头的 PDF、Word、产品手册散落各处想按内容提问却只能全文搜索碰运气。WeKnora 是一个开源的 LLM 知识平台把这些原始文档变成可问答的 RAG 知识库文档解析、向量入库、混合检索、大模型作答整条链路都在它里面。这篇笔记带你从克隆仓库走到能问出带引用的答案再顺手解锁知识图谱和多模态检索。先把服务跑起来git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env.env决定 LLM 和 Embedding 模型怎么连本地 Ollama 或远程 API 都行文件里有注释。模型配置没把握的话可以跳过初始化向导里也能填。./scripts/start_all.sh这条命令会把镜像拉齐、容器全部启动等终端打印出成功提示即可。打开浏览器访问http://localhost后端 API 在http://localhost:8080。首次访问会进初始化向导按左侧导航把 Ollama 状态、LLM、Embedding 逐项配完——这一步别急Embedding 维度和模型名填错后面所有文档都会解析失败。服务跑起来只是热身接下来才是有意思的部分。核心能力走一遍把文档喂进去进左侧「知识库」建库、上传文件。WeKnora 会把解析、OCR、分块、向量化、入库整条流水线自动跑完上传的文件夹结构也会原样保留方便你像文件管理器一样组织文档。解析进度在文档卡片上实时可见处理完的条目会亮出摘要。直接编辑分块文档入库后检索命中的其实是分块而不是整篇。某个分块切得不好不用重传文档在文档详情里直接编辑改完自动重建索引每份分块还有版本历史和 diff改坏了能回滚。提问并核对引用切到「对话」选知识库、输入问题。WeKnora 会先做查询改写和混合检索BM25 加向量召回融合策略在 retriever 目录再交给 LLM 基于找到的片段生成答案。回答上方能看到检索完成引用了 N 篇文档和每步耗时答案里的引用点开就能跳回原文核对检索阈值也可以在这条流水线旁边直接调。进阶玩法图谱增强检索怎么开动机纯关键词加向量有时会漏掉跨文档的关联比如报销流程和产品序列号填写规则分属两份文档字面不相关、业务强相关。WeKnora 用 Neo4j 知识图谱补这一刀# .env 中开启图谱 NEO4J_ENABLEtrue NEO4J_URIbolt://neo4j:7687 docker compose --profile neo4j up -d重启服务后进知识库设置勾上「实体抽取」和「关系抽取」。文档入库时就会自动把概念节点连成网提问时检索结果不再只靠字面命中还能沿关联路径扩展到相关片段。多模态图片检索动机文档里的架构图、截图默认只有文件问不到内容。WeKnora 会把图片抠出来用 VLM 生成文字描述再向量化之后按内容检索就能命中。docker compose --profile minio up -dMinIO 存解析产物.env里配好多模态 VLM 模型即可对象存储换 COS、S3 也支持。效果上架构图里哪个组件负责解析这种问题就能直接答出并把对应图片带出来。踩坑实录现象服务起来了文档却一直解析失败。先跑docker compose logs -f app docreader看 ERROR。九成是.env里 Embedding 或 LLM 配置不完整——用远程 API 时BASE_URL和API_KEY漏配最常见。根因是向量入库依赖 Embedding 模型它不通整条流水线就卡死在入库环节。现象多模态开了图片却显示无效链接。检查两点MinIO 是否真的在跑以及MINIO_PUBLIC_ENDPOINT是否还配着http://localhost:9000。跨设备访问时 localhost 指向的是你当前这台机器不是 WeKnora 所在机器改成真实 IP 即可顺路看一眼 bucket 权限。⚠️ 这个坑排查的人最多。现象开了知识图谱图里一个节点都没有。先确认知识库设置里抽取开关勾没勾再确认文档解析已完成——抽取是入库后自动触发的解析没跑完之前图里就是空的具体步骤见 知识图谱开启指南。继续往下挖website-docs/官方文档站按入门、架构、功能、API 等板块组织从快速开始读到接口细节一篇就够你跑通。docs/QA.md官方排障手册上传失败、OCR、图片显示这些高频问题都有现成路径。mcp-server/官方 MCP 服务器29 个工具让你的 AI 客户端直接对知识库做检索和问答。【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考