WeKnora 是什么?

WeKnora 是腾讯开源的知识平台,把文档摄入、混合检索、RAG 问答、ReAct Agent、自动 Wiki 和知识图谱放在一套可自托管服务中。v0.8.0 还加入按会话持久的 Skill 沙箱与跨会话记忆。

⭐ 18,120 Stars 🍴 2,477 Forks Go NOASSERTION 作者: Tencent
来源:github.com/Tencent/WeKnora 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库采用 MIT 主许可,没有 WeKnora 自有充值、订阅额度或付费托管漏斗,且 2026 年 9 月发布 v0.8.0 并持续维护,因此暂不因零流量隔离,先完成高质量教程后观察。

来源:github.com/Tencent/WeKnora

核心功能

RAG、Agent 与 Wiki

Quick Q&A 做知识库检索问答,ReAct Agent 编排检索、MCP、Skill 沙箱和网络搜索,Wiki Mode 把原始文档整理成可编辑、可回滚的互链页面。

来源:github.com/Tencent/WeKnora
多源与多后端

支持飞书、GitLab、腾讯 IMA、Notion、语雀及 10 多种文档格式,可更换 LLM、向量数据库和对象存储。

来源:github.com/Tencent/WeKnora
Skill 沙箱

v0.8.0 支持 Docker、E2B 与 Cube 后端,每个会话有持久工作区和网络策略;旧的本机进程后端已移除。

来源:github.com/Tencent/WeKnora/blob/main/CHANGELOG.md
多租户与可观测

平台提供 RBAC、OIDC、凭据加密、审计及 Langfuse 链路观测,并能通过 IM、CLI、MCP 和 Chrome 扩展访问知识库。

来源:github.com/Tencent/WeKnora

技术架构

默认 Compose 启动 frontend、Go app、docreader、PostgreSQL 与 Redis 等核心服务;可选 profile 增加 Neo4j、MinIO、Langfuse 和其他向量库。app 协调文档解析、知识库、检索、Agent、MCP、记忆和沙箱。Docker Skill 后端默认关闭,因为挂载 docker.sock 等同宿主 root;也可接 E2B 或 Cube 并配置租户网络策略。

来源:github.com/Tencent/WeKnora/blob/main/docker-compose.yml

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Docker Compose v2.24+ 与 GitDocker Compose… PostgreSQL、RedisPostgreSQL、Re… LLM 与 embedding/rerank 模型LLM 与 embeddi… 可选 Neo4j、MinIO、Langfuse、Qdrant、Milvus、Weaviate可选 Neo4j、Min… 可选 Docker/E2B/Cube Skill sandbox可选 Docker/E2… RAG、Agent 与 Wiki 多源与多后端 Skill 沙箱 多租户与可观测 WeKnora 项目本体 核心功能 关键依赖

技术栈

语言Go 服务端、Web 前端、Python docreader/MCP框架Docker Compose 模块化知识平台
Docker Compose v2.24+ 与 GitPostgreSQL、RedisLLM 与 embedding/rerank 模型可选 Neo4j、MinIO、Langfuse、Qdrant、Milvu…可选 Docker/E2B/Cube Skill sandbox
默认 Web UI 为 http://localhost,API 为 localhost:8080;不同 profile 会增加端口和常驻容器,模型与数据源凭据写入 .env 或租户配置
来源:github.com/Tencent/WeKnora

快速上手

检出 v0.8.0,复制 .env.example 为 .env,把 WEKNORA_VERSION 固定为 v0.8.0并替换 JWT、AES、数据库、对象存储及模型占位凭据。先执行 docker compose pull,再执行 docker compose up -d 启动核心服务;只导入一份非敏感样本文档验证问答和引用。Neo4j、Langfuse、外部数据源与 Skill 沙箱逐项开启。
来源:github.com/Tencent/WeKnora

使用场景

适合把企业文档做成可引用问答、维护 Wiki、跨知识库检索或让 Agent 在受控沙箱调用工具的团队。只需要轻量单机向量检索时,核心服务和可选 profile 的运维成本可能过高;涉及企业数据时应先定义租户、保留、删除和模型传输政策。

来源:github.com/Tencent/WeKnora

优势与局限

优势

  • 问答、Agent、Wiki、知识图谱和修订历史在同一平台
  • 多数据源、多模型和多向量后端可替换
  • v0.8.0 删除本机进程沙箱并加入网络策略
  • 主项目为 MIT,第三方组件许可单独列出

局限

  • 默认和可选 profile 涉及多种数据库、存储与端口
  • docker.sock 一旦挂入 app 就等同宿主 root,官方因此默认关闭 Docker sandbox
  • 公开 resource URL、IM、MCP、网页抓取和外部模型都会扩大数据边界
  • WEKNORA_VERSION=latest 与只执行 compose up 可能造成版本漂移或 UI 不一致
  • 检索质量仍取决于解析、切分、embedding、rerank 和数据质量
  • GitHub 元数据无法识别组合 LICENSE,分发时仍需检查 THIRD_PARTY_NOTICES 与 licenses 目录
来源:github.com/Tencent/WeKnora

最新版本

截至 2026-09-23,最新 release 是 v0.8.0,发布于 2026-09-03。该版加入 Skill 沙箱、租户 Skill 目录、跨会话记忆、anydoc、GitLab/腾讯 IMA 数据源、LiteLLM、更多搜索服务以及 OIDC 和安全加固。

来源:github.com/Tencent/WeKnora/releases/tag/v0.8.0

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、CHANGELOG、LICENSE、.env.example、docker-compose.yml 与 GitHub Releases  |  limitations: 未拉取镜像,未启动前后端、数据库、docreader、向量库、Langfuse 或 sandbox,未导入文档,也未配置模型、数据源和 IM 凭据  |  observed_output: 最新 release 为 v0.8.0,发布于 2026-09-03;核心启动要求 Docker、Compose 和 Git,Web UI 默认端口 80、API 8080;LICENSE 声明项目主体 MIT,第三方组件按各自条款

来源:github.com/Tencent/WeKnora/releases/tag/v0.8.0

同类项目对比

RAGFlow 同样提供文档解析、检索增强生成、Agent 和自托管,官方重点是可视化文档理解、RAG 流程与 Agent;WeKnora 另有自维护 Wiki、页面修订、租户 Skill 目录、会话沙箱和跨会话记忆。以复杂文档解析和 RAG 流程为主可先看 RAGFlow;需要 Wiki 与 Skill 沙箱组合时再评估 WeKnora。

来源:github.com/infiniflow/ragflow

总结评价

适合把企业文档做成可引用问答、维护 Wiki、跨知识库检索或让 Agent 在受控沙箱调用工具的团队。只需要轻量单机向量检索时,核心服务和可选 profile 的运维成本可能过高;涉及企业数据时应先定义租户、保留、删除和模型传输政策。采用前需要核对:默认和可选 profile 涉及多种数据库、存储与端口。

来源:github.com/Tencent/WeKnora

常见问题

WeKnora 升级后为什么界面版本没有变化?

只运行 docker compose up -d 会复用本地缓存镜像。先把 WEKNORA_VERSION 固定为目标标签,再执行 docker compose pull 和 docker compose up -d,并在系统信息页核对版本。

WeKnora 的 Docker Skill 沙箱为什么默认关闭?

官方指出 app 挂载 docker.sock 后等同拥有宿主 root 权限。只有在隔离主机上确认镜像、网络策略、资源配额和租户权限后才应开启,也可改用受控的 E2B 或 Cube 后端。

WeKnora 接本地 Ollama 后模型不可达怎么办?

容器内的 localhost 不是宿主机。先确认宿主已运行 ollama serve,再按官方网络说明设置容器可访问的宿主地址,并从 app 容器检查 DNS、端口和模型名。

WeKnora 首次验证应该导入企业文档吗?

不应该。先用无敏感信息的样本文档检查解析、切分、引用、删除和备份,再确认模型、对象存储、日志、Langfuse、IM 和外部数据源的数据边界。

WeKnora 和 RAGFlow 怎样选?

RAGFlow 更侧重复杂文档解析和可视化 RAG 流程;WeKnora 还提供自维护 Wiki、修订历史、租户 Skill 目录、会话沙箱和长期记忆。应按文档类型、权限模型和运维成本实测。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件