WeKnora 介绍

# WeKnora：企业级知识管理框架介绍

一款开源的、基于大语言模型（LLM）的知识管理框架，专为企业级文档理解、语义检索与智能推理场景打造。

# 项目简介

WeKnora（维娜拉） (opens new window) 是腾讯开源的一款企业级知识管理框架，基于大语言模型构建，专注于文档理解、语义检索与智能推理场景。

与传统知识库不同，WeKnora 不仅仅是存储和检索文档，更是通过 AI 能力让知识"活"起来——支持智能问答、多步推理、自动生成 Wiki 知识页面，真正实现从"存文档"到"用知识"的转变。

# 核心能力

# 三大核心模式

模式	说明	适用场景
RAG 快速问答	基于知识库的检索增强生成，快速准确地回答问题	日常知识查询、FAQ 问答
ReAct Agent 智能推理	自主编排知识检索、MCP 工具与网络搜索，完成复杂多步任务	复杂问题分析、跨数据源推理
Wiki 模式	Agent 从原始文档中自动生成相互链接的 Markdown 知识库与可视化知识图谱	知识体系构建、文档结构化

# 知识管理能力

多数据源导入：支持飞书知识库、飞书云盘、Notion、语雀、RSS 等平台自动同步
多格式支持：PDF、Word、Markdown、HTML、Excel、PPT、图片等十余种格式
文件夹树管理：保留上传目录结构，支持重命名、重新归档
分块编辑与版本历史：可视化编辑检索分块，支持 diff 比对与一键回滚

# 集成与扩展

类型	支持内容
模型厂商	OpenAI、DeepSeek、Qwen、智谱、混元、Gemini、MiniMax、Ollama 等 20+ 厂商
向量数据库	PostgreSQL (pgvector)、Milvus、Weaviate、Qdrant、Elasticsearch 等
IM 集成	企业微信、飞书、Slack、Telegram、钉钉、微信、QQBot 等
对象存储	腾讯云 COS、AWS S3、阿里云 OSS、MinIO、本地存储等

# 架构特点

# 模块化设计

从文档解析、向量化、检索到大模型推理，全流程模块化解耦：

文档上传 → 解析引擎 → 分块处理 → 向量化 → 存储
                                           ↓
用户提问 → 检索召回 → 重排序 → LLM 推理 → 输出答案

1
2
3

每个环节都可以独立配置和替换，支持本地或私有云部署，数据完全自主可控。

# 企业级能力

权限控制：空间 RBAC 四级角色矩阵（Owner / Admin / Contributor / Viewer）
审计日志：每空间审计日志，支持活动追踪
安全加密：API Key 与数据源凭据 AES-256-GCM 加密
可观测性：集成 Langfuse 全链路追踪

# 快速部署

# 环境要求

Docker & Docker Compose
Git

# 一键启动

# 克隆项目
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora

# 配置环境变量
cp .env.example .env

# 拉取镜像并启动
docker compose pull
docker compose up -d

1
2
3
4
5
6
7
8
9
10

启动成功后访问 http://localhost 即可使用。

# 可选组件

# 启动知识图谱 (Neo4j)
docker compose --profile neo4j up -d

# 启动对象存储 (MinIO)
docker compose --profile minio up -d

# 启动链路追踪 (Langfuse)
docker compose --profile langfuse up -d

1
2
3
4
5
6
7
8

# 特色功能

# 1. Wiki 自动生成

Agent 可以从原始文档中自动生成结构化、相互链接的 Markdown Wiki 页面，并构建可视化知识图谱。支持浏览器内人工编辑、版本历史与一键回滚。

# 2. 分块编辑

在界面直接编辑检索分块，保留逐版本快照，编辑后自动重建索引。让检索片段可以像文档一样被修改、比对与回滚。

通过嵌入 Widget 将智能体发布到外部站点，支持域名白名单、限流与安全模式 Token 交换。

# 4. MCP 工具集成

官方提供 PyPI 包 tencent-weknora-mcp，包含 29 个工具，支持 stdio / SSE / HTTP 三种传输方式。

# 客户端支持

客户端	说明
Web UI	完整管理界面
RESTful API	全功能 API 接口
命令行工具	weknora CLI
Chrome 插件	网页内容一键采集
微信小程序	移动端轻量访问
ClawHub Skill	Agent 技能集成

# 开发指南

# 快速开发模式

如果需要频繁修改代码，可以使用开发模式避免重复构建镜像：

# 启动基础设施
make dev-start

# 启动后端（新终端）
make dev-app

# 启动前端（新终端）
make dev-frontend

1
2
3
4
5
6
7
8

优势：

前端修改自动热重载
后端修改快速重启（支持 Air 热重载）
支持 IDE 断点调试

# 本地文档预览

官方文档位于 website-docs/ 目录，可本地预览：

cd website-docs
npm install
npm run dev