WeKnora

项目概述

WeKnora 是腾讯开源的、基于大语言模型的知识管理框架，面向企业级文档理解、语义检索与推理。它将团队分散的文档资源统一接入，支持检索、推理与持续更新。RAG 提供可追溯的问答，智能体承担多步任务，Wiki 负责知识结构化整理，三者共享同一套知识库。

核心能力

三种工作模式

• RAG 问答：基于混合检索、多模态解析与来源引用，给出可验证的回答。
• 智能体：通过多步推理、技能、沙箱、本地浏览器、MCP 工具与记忆完成复杂任务。
• Wiki：自动抽取人物、产品、概念生成结构化页面，配合知识图谱与版本回滚。

智能体工具箱

技能支持从 ClawHub、SkillHub、Git 或 ZIP 安装，在 Docker、E2B 或 Cube 沙箱中保持会话级持久化，并附带交互终端与图形桌面。通过 BrowserSkill 扩展可操控用户本地的 Chrome 或 Edge，并可逐个启用外部 MCP 服务（含 OAuth）。

记忆与数据

跨会话的长期记忆保存用户的画像、偏好与已确认事实；文件夹上传保留目录结构；检索切片支持编辑、对比与回滚。数据源自动同步覆盖飞书 Wiki、飞书文档、Confluence、GitLab、腾讯 IMA、Notion、语雀、钉钉文档、Seafile、RSS 等。文档格式支持 PDF、Word、图片、Excel、XMind 等十余种，Office 文件由 anydoc 进程内解析。

渠道与权限

问答可接入企业微信、飞书、Slack、Telegram 等 IM 平台；外部网站可使用嵌入组件；为 Cursor、Claude 等提供内置 MCP Server；通过作用域化的 API key 与主体模型支持程序化访问。权限模型支持多工作区 RBAC（四种角色、每资源所有权、每工作区审计日志）与多存储实例，配合基于 Langfuse 的链路追踪。

模型与部署

内置 29 家模型厂商，包括 OpenAI、DeepSeek、Qwen、智谱、混元、Gemini、MiniMax、NVIDIA、LiteLLM、Ollama 等。LLM、向量数据库与对象存储均可替换，支持本地或私有云部署。

快速开始

Docker Compose 部署

需要预先安装 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    # 启动核心服务

启动后访问 http://localhost 即可进入引导流程。本地使用 Ollama 模型时需先执行 ollama serve。

服务	地址
Web UI	http://localhost
后端 API	http://localhost:8080
Langfuse 追踪	http://localhost:3000

可选 profile 用于按需启用模块：neo4j 启用知识图谱、minio 启用对象存储、langfuse 启用追踪，多个 profile 可同时开启。

docker compose --profile neo4j --profile minio up -d

其他部署方式

• Kubernetes（Helm）：生产集群，Chart 位于 helm/ 目录。
• Lite 单文件版：本地或低资源场景，无外部依赖（SQLite + 内存队列）。
• 桌面应用：Lite 运行时加 GUI，需从源码构建。

升级时需在 .env 中将 WEKNORA_VERSION 设为目标版本号，然后重新拉取并重建容器。

安全提示

生产环境建议部署在内网或私有网络，避免直接暴露公网；配置防火墙与访问控制；定期升级至最新版本获取安全补丁。

技术架构

系统采用模块化流水线，从文档解析、向量化、检索到 LLM 推理各环节均可替换或扩展。客户端组件、整体 RAG 管道与 Wiki 共享同一知识管道，应用层调用运行时服务，数据存储于 PostgreSQL、Redis 及可选存储后端。

主要功能

• 问答与智能体：基于知识库与引用的快速问答；ReAct 智能体覆盖知识库、网页搜索、MCP 工具、技能与本地浏览器；支持会话引导、分叉、回退与跨会话长期记忆。
• Wiki：智能体自动生成互联的 Markdown 页面，配合知识图谱与可视化浏览器，支持修订差异与回滚。
• 技能与沙箱：从 ClawHub/SkillHub/Git/ZIP 安装技能；Docker/E2B/Cube 沙箱带网络策略；聊天旁附终端与图形桌面。
• 知识库：FAQ、文档、Wiki 三类；目录树；切片编辑含修订版本；每次上传可独立配置解析、切分与多模态参数；自动打标。
• 检索：关键词 + 向量混合检索、重排序、父块切片与 GraphRAG（基于 Neo4j）；端到端召回率与 BLEU/ROUGE 评测。
• 访问与安全：四角色 RBAC 与审计日志；作用域化 API key；OIDC；AES-256-GCM 凭据加密；SSRF 防护与白名单出站模式。
• 运维：Langfuse 追踪智能体步骤、Token 与管线；文档解析时间线；任务队列仪表盘与 Worker 池治理；升级自动迁移。

支持的后端

组件	选项
LLM	OpenAI、Azure OpenAI、Anthropic、DeepSeek、Qwen、智谱、混元、豆包、Gemini、MiniMax、NVIDIA、SiliconFlow、OpenRouter、LiteLLM、Ollama
向量数据库	PostgreSQL（pgvector）、Elasticsearch、OpenSearch、Milvus、Weaviate、Qdrant、Apache Doris、Tencent VectorDB
对象存储	本地、Tencent COS、MinIO、AWS S3、Volcengine TOS、Alibaba OSS、Kingsoft KS3、Huawei OBS
数据源	飞书 Wiki/文档、Lark、Confluence、GitLab、腾讯 IMA、Notion、语雀、钉钉文档、Seafile、RSS
IM 渠道	企业微信、飞书、Lark、QQBot、Slack、Telegram、钉钉、Mattermost、微信、Yunzhijia

客户端与集成

客户端	用途
weknora CLI	完整的命令行工具，提供精选 MCP 工具集与内置技能
内置 MCP Server	通过 Streamable HTTP 将知识库发布至 Cursor、Claude 等 MCP 客户端
Local Browser（BrowserSkill）	让智能体操控用户本地的 Chrome 或 Edge
Chrome 扩展	选中文档内容发起提问