WeKnora能力指南：把分散文档变成可问答、可推理、可自动维护的知识库

WeKnora能力指南：把分散文档变成可问答、可推理、可自动维护的知识库

【免费下载链接】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

WeKnora 是一个开源的 LLM 知识平台，把分散的文档变成可查询的知识资产。它把 RAG 文档问答、可自主调用工具的 ReAct Agent 和自动维护的 Wiki 放在同一套系统里，既适合把内部手册、产品文档变成可提问系统的团队，也适合想私有化部署一套知识问答服务的个人开发者。

WeKnora 解决什么问题

很多团队的文档散落在网盘、飞书、Notion 和个人电脑里，想找答案时只能靠人工翻找。WeKnora 的做法是把文档统一收进来：先解析和切块，再建立向量与关键词索引，之后就能直接提问。

它不只是一个问答盒子。除了快速问答，它还能让 Agent 自主决定何时检索、何时调用工具、何时联网搜索，并且可以把原始文档自动整理成带链接的 Markdown 知识库。整个流程模块化设计，大模型、向量库、对象存储都可以替换，支持本地和私有云部署，数据留在自己手里。

核心能力一览

• RAG 快速问答：基于知识库回答日常问题，答案带引用来源
• ReAct Agent 推理：多步规划，自主编排知识检索、MCP 工具与网络搜索
• Wiki 模式：Agent 从原始文档生成结构化、相互链接的 Wiki 页面和知识图谱，支持人工编辑、版本历史与回滚
• 多源文档接入：支持 PDF、Word、Excel、Markdown、EPUB、图片等十余种格式，可从飞书知识库、Notion、语雀、RSS 等数据源自动同步
• 多入口使用：Web 界面、REST API、weknora命令行、Chrome 插件、网站嵌入 Widget、微信小程序，以及企业微信、飞书、Slack、Telegram 等 IM 频道
• 多模型兼容：可接入 OpenAI、DeepSeek、Qwen、智谱、混元、Gemini、Ollama 等二十余家模型厂商
• 可观测与治理：Langfuse 全链路追踪、任务队列面板、空间级 RBAC 权限与审计日志

一个问题如何得到答案

从使用者视角看，流程分三步。文档入库时，系统完成解析（含 OCR 与图片描述）、分块、摘要与嵌入，按配置决定是否构建知识图谱，最后写入向量索引。你提问时，系统先对查询做改写并带入历史上下文，再用 BM25 关键词召回、向量召回和图谱增强等多路策略做混合检索，然后重排序。最后由大模型基于筛出的片段生成回答，并在对话中标注引用来源，你可以点开核对原文。

这套流程的好处是每一环都可调：分块方式、检索阈值、重排模型、解析引擎都能按知识库配置，答得不准时可以针对性调整，而不是只能换模型碰运气。

三种使用方式：从快速问答到知识沉淀

RAG 快速问答适合"查一下"的场景，响应快，答案直接给出引用。

Agent 模式适合需要多步操作的复杂任务。它会自主决定先查知识库还是先调工具，过程中会展示每一次工具调用和中间结果，便于核对推理过程是否合理。

Wiki 模式偏长期沉淀。系统从文档中提炼出相互链接的 Wiki 页面，并生成可视化知识图谱，页面支持在浏览器里直接编辑、查看行级 diff、按版本回滚。文档更新后 Wiki 会随之维护，相当于给知识库配了一个自动写编者。

界面上能看到什么

知识库管理页按列表展示各个知识库的名称、类型（文档型或问答型）、条目数量和更新时间，支持新建、批量选择与打标签、重新归档等操作。上传文件夹会保留原目录结构，形成侧边树形导航，检索片段也能直接在线编辑并保留版本历史。

设置页集中管理模型厂商、向量数据库、对象存储和 Web 搜索等组件，均为可替换的独立配置项，适合按团队环境逐项调整。

适合哪些场景

• 企业内部问答：把产品手册、规章制度、运维文档接入后，通过 Web 或 IM 频道直接提问，答案带出处
• 知识持续沉淀：用 Wiki 模式把大量原始文档变成结构化的可读知识库，新人上手更快
• 外部站点集成：通过嵌入 Widget 或 REST API，把智能问答挂到已有网站上
• 私有化部署：对数据合规要求高的场景，整套系统可跑在本地或私有云
• 编码 Agent 的知识源：通过官方 MCP 服务器（mcp-server/，29 个工具），把检索和问答能力接入其他 Agent 体系

从哪里开始

• 完整功能与接口说明：docs/、website-docs/
• 知识图谱配置：docs/KnowledgeGraph.md
• 多空间权限模型：docs/RBAC说明.md
• MCP 服务器接入：mcp-server/
• 版本变更记录：CHANGELOG.md

本地部署需要 Docker 与 Docker Compose，克隆仓库后按.env配置启动即可，具体步骤见 README_CN.md：

git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora

如果只想快速了解能力边界，建议先看架构说明与快速开始章节，再挑一个真实文档集试跑一次问答和 Wiki 生成，比通读文档更有体感。

【免费下载链接】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