WeKnora是什么
WeKnora 是腾讯开源的企业级知识管理框架,支持私有化部署。框架基于 RAG 技术,将 PDF、Word、飞书、Notion 等资料构建为可检索知识库,提供带引用溯源的智能问答;内置 ReAct Agent 可调用 MCP 工具、技能沙箱与联网搜索执行多步任务;能自动将文档整理成相互链接的 Wiki 页面与知识图谱。系统由 Go 后端、Vue 前端和 Python 文档解析服务组成,支持 Docker Compose、Helm、Lite 单二进制及桌面应用四种部署方式。
WeKnora的主要功能
- 文档接入:支持 PDF、Word、Excel、图片、音频等 10+ 格式上传,以及飞书、Lark、Notion、语雀、GitLab、RSS 等平台的持续同步。
- 文档理解:docreader 服务提供 PDF 版式分析、扫描件 OCR、表格抽取、图片多模态描述和音频转写。
- 智能分块:支持固定分块、父子分块与自适应策略,分块可编辑并带版本历史,修改后自动重建索引。
- 混合检索:向量 + BM25 关键词双路召回,RRF 融合排序,可选 Rerank 重排与查询改写,支持向量库(Qdrant/Milvus 等)灵活替换。
- RAG 问答:流式 SSE 回答带原文引用,点击可溯源核对。
- Agent 引擎:内置 ReAct 智能体,可编排知识检索、网页搜索、MCP 工具与数据分析等多步任务。
- 技能与沙箱:空间级技能目录,可从 ClawHub、Git 等安装技能,在 Docker/E2B/Cube 沙箱中执行脚本并生成文件。
- 自动 Wiki:从文档生成相互链接的主题页面与知识图谱,支持浏览、编辑和一键版本回滚。
- 多模型支持:模型抽象层兼容 Ollama 本地模型与 OpenAI 兼容 API,覆盖 LLM、Embedding、Rerank、VLM、ASR 五类。
- 团队协作:多租户工作空间 + 四级 RBAC 角色,支持组织跨空间共享知识库与邀请机制。
- 多渠道接入:提供 REST API、CLI、Go SDK、微信小程序、桌面客户端、Chrome 插件,以及企业微信/飞书/Slack/Telegram 等 IM 集成和网页嵌入。
- 安全与治理:敏感凭证 AES-256 加密、审计日志、SSRF 防护、OIDC 单点登录与细粒度 API Key 权限。
- 可观测性:集成 Langfuse 全链路追踪,覆盖 LLM 调用、token 统计与运行时任务队列监控。
如何使用WeKnora
- 部署:任选 Docker Compose(
make start-all)、Helm、Lite 单二进制(make run-lite)或桌面应用之一启动服务,然后访问http://localhost。 - 准备模型:至少配置一个对话模型(LLM)和一个向量模型(Embedding),可用本地 Ollama(地址
http://host.docker.internal:11434)或任意 OpenAI 兼容 API。 - 注册账号:打开前端注册登录(首次注册自动创建个人工作空间并设为 Owner,Lite/桌面版免注册)。
- 创建知识库:在「知识库」页新建 document 或 faq 类型知识库,并在初始化向导中为该库选好模型、测试连接后保存。
- 上传资料:拖入 PDF、Word、图片、音频等文件或粘贴网页 URL,支持批量打标签与调整解析选项,文档异步解析完成即可检索。
- 开始问答:进入对话页选择知识库提问,快速问答用于日常检索,智能推理(Agent)用于多步任务、联网搜索与文件生成,回答均带可溯源引用。
- 进阶配置:按需接入飞书/Notion/RSS 数据源持续同步、配置技能与 MCP 沙箱、开启自动 Wiki,或通过 IM/网页嵌入/API Key 对外提供服务。
WeKnora的核心优势
- 混合检索更准:向量 + BM25 双路召回经 RRF 融合与 Rerank 重排,解决单一向量检索召回不稳的问题。
- 文档解析能力强:支持 PDF 版式分析、扫描件 OCR、表格抽取、图片 VLM 描述和音频转写,可接入 MinerU/Docling 等解析引擎。
- 模型完全中立:抽象层同时兼容 Ollama 本地模型与 20+ 家 OpenAI 兼容远程 API,LLM/Embedding/Rerank/VLM/ASR 可自由替换,不被单一厂商锁定。
- Agent 能力完整:内置 ReAct 智能体,支持 MCP 工具、网页搜索、技能沙箱(Docker/E2B/Cube)执行脚本,还能在对话中直接生成并预览 Word/PPT/PDF 等文件。
- 知识自动沉淀:独创 Wiki 模式将文档自动整理为相互链接的页面与知识图谱,带版本历史可编辑回滚,让知识库自我演进。
- 部署形态灵活:从生产级 Docker Compose/Helm 到零依赖 Lite 单二进制、桌面应用,个人到企业全场景覆盖。
WeKnora的项目地址
- 项目官网:https://weknora.weixin.qq.com/
- GitHub仓库:https://github.com/Tencent/WeKnora
WeKnora的同类竞品对比
| 对比维度 | WeKnora(腾讯) | RAGFlow(InfiniFlow) |
|---|---|---|
| 产品定位 | 企业级知识管理框架:RAG 问答 + Agent 任务 + 自动 Wiki 三位一体 | 专注深度文档理解的 RAG 引擎,主打”优质进、优质出”的知识提取 |
| 开源协议 | MIT License,无多租户运营限制 | Apache 2.0,同样可自由商用 |
| 技术栈 | Go(Gin)+ Vue 3 + Python docreader,可选单二进制 | Python 后端(v0.27 起 Go 后端对齐重构)+ 自研文档引擎 |
| 文档解析 | 独立 docreader 微服务:PDF 版式分析、扫描件 OCR、VLM 图片描述、ASR 转写,可接 MinerU/Docling | 自研 DeepDoc 模型为核心竞争力,模板化分块可视化、可人工干预,以复杂 PDF 解析见长 |
| 检索引擎 | 向量 + BM25 混合检索,RRF 融合 + Rerank,默认 ParadeDB 单库 | 向量 + BM25 混合检索 + 自定义评分 + Rerank,基于自研 Infinity 引擎 |
| 知识沉淀 | 自动 Wiki 页面(相互链接 + 版本回滚)+ Neo4j 知识图谱 | v0.27 推出知识编译(Knowledge Compilation):Wiki、Graph、Tree、PageIndex、思维导图、时间线等多形态,旧版 GraphRAG/RAPTOR 已废弃 |
| Agent 能力 | 内置 ReAct 引擎 + 技能目录 + 沙箱文件生成 | Agentic RAG 四档思考模式(Low/Medium/High/Ultra)+ 可视化工作流编排 |
| 沙箱与技能 | 技能目录(ClawHub/Git 安装)+ Docker/E2B/Cube 会话沙箱,可生成 Word/PPT/PDF 文件 | 多沙箱机制(本地 gVisor、阿里云),代码执行组件 + 图表生成 |
| 长期记忆 | 跨会话长期记忆(资料/偏好/事实/事项/兴趣,自动提取需确认) | 记忆管理 API(HTTP + Python),2025 年 12 月上线 |
| 部署形态 | Docker Compose / Helm / Lite 单二进制 / 桌面应用(Wails) | Docker 部署为主(docker run -p 9380:9380),无单二进制形态
|
| 渠道生态 | 企业微信/飞书/Slack/Telegram/钉钉 IM + 微信小程序 + 网页嵌入 + MCP Server | 飞书/Discord/Telegram/Line 等聊天渠道 + OpenClaw Skill 接入 |
WeKnora的应用场景
- 企业知识管理:帮助员工快速检索内部文档、规章制度和操作手册,提升知识查找效率,降低培训成本。
- 科研文献分析:加速论文、研究报告和学术资料的检索与分析,助力科研人员高效开展研究工作。
- 产品技术支持:提供产品手册问答和技术文档检索服务,帮助用户快速解决技术问题,提升客户服务质量。
- 法律合规审查:支持合同条款检索、法规政策查询和案例分析,提高法律合规效率,降低法律风险。
- 医疗知识辅助:辅助医学文献检索、诊疗指南查询和病例分析,提升医疗决策的科学性和准确性。