腾讯 2025 年 7 月开源的 WeKnora(维娜拉),到今天已经 35,892 星、4,877 个 fork,v0.9.0 也刚在 10 月 29 日发出。它不跟 Dify 抢“低代码搭应用”,也不跟 n8n 抢“连几千个 SaaS”,只干一件事:把一家公司散装的文档,变成能检索、能推理、还能自己整理成 Wiki 的知识底座。
一、三件套,共用一个库
官方定位是“开源 LLM 知识平台”,落到界面上是三种用法。
RAG 问答:文档解析入库后提问,回答带引用,点开能翻回原文那一段。这是基本盘。
Agent:内置 ReAct 智能体,工具是 search_knowledge、read_document、list_documents、wiki_search、data_analysis,CSV/Excel 能直接跑 SQL;外部接 MCP,认证支持 API Key、Bearer、OAuth 2.0;技能可以从 ClawHub、SkillHub、Git、ZIP 安装,跑在 Docker / Cube / E2B 沙箱里,对话旁边还能开终端和图形桌面。
Wiki:把库里的文档抽成互链页面,带来源引用和知识图谱,页面能直接编辑,改动有 diff、能回滚。
关键在最后一句:这三样吃的是同一个知识库。一份 PDF 传进去,RAG 拿它回答,Agent 拿它当工具查,Wiki 把它拆成词条。跟“知识库 + 另买一个 Agent 平台”拼起来比,省掉的是同步和对齐。
二、数据怎么流
入口两条:手动上传(PDF、Word、PPT、Excel、Markdown、HTML、EPUB、XMind、图片、音频),和定时同步(飞书/Lark、Notion、Confluence、语雀、钉钉、腾讯 IMA、GitLab、RSS)。
解析交给独立的 Python 服务 docreader,gRPC 通信,负责版式分析、扫描件 OCR、表格抽取、图片 VLM 描述、音频 ASR,统一转成 Markdown;按文件类型可以挂不同引擎,MinerU、OpenDataLoader 都行。
索引默认落在 ParadeDB(PostgreSQL 17 + BM25/向量扩展),分块 512 字、重叠 50;Qdrant、Milvus、Weaviate、Doris 可以通过 RETRIEVE_DRIVER 换掉,知识图谱要开 neo4j profile。
检索是混合的:向量 + BM25,RRF 融合,再 Rerank。默认值偏保守——向量召回 30 条、相似度阈值 0.2,关键词阈值 0.3,重排后留 30 条、阈值 0.3,查询改写和扩展默认开着。后端 Go + Gin,前端 Vue 3,队列 Redis,链路追踪接 Langfuse。
企业向的东西也没省:多租户、Owner/Admin/Contributor/Viewer 四级角色、审计日志默认留 90 天、OIDC 单点登录、敏感字段 AES-256 落盘加密、SSRF 白名单。
三、上手
标准版四行:
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env
docker compose up -d
Web 在 80,API 在 8080,Langfuse 在 3000。启动前务必填好 .env 里的 JWT_SECRET 和 SYSTEM_AES_KEY:后者必须 32 字节,丢了已加密的模型 key、向量库凭证就找不回来,多副本还得用同一个值。
只想先看效果,用 Lite:单二进制、零依赖、不用注册、数据只在本机,默认只监听本地。代价是单空间、只有 Simple 解析器、没有共享空间。macOS 还有桌面版。
模型不绑厂商:Ollama 本地能跑,也能接 OpenAI 兼容、Anthropic Messages、Gemini 原生协议,LLM / Embedding / Rerank / VLM / ASR 分开管。界面有简中、繁中、英、日、韩、俄六种。
四、实话
它不是自动化平台。 没有几千个连接器,不会替你把 CRM 和邮件串起来,强项是“文档到可引用的答案”。要做 SaaS 串联,去看 n8n 或 Make。
标准版是重容器。 app、frontend、docreader、ParadeDB、Redis 是起步,开 full profile 还要加 sandbox、SearXNG、Langfuse,上图谱再叠 Neo4j。按这套组件,2C4G 会很紧张;单文档处理默认超时 2 小时,几百页的扫描件要有心理准备。
版本比文档快。 仓库里 736 个 open issue,官方文档页脚还写着“基于 v0.8.3 源码整理”,代码已经到 v0.9.0。这版新增了能按你身份干活的助手(建 Agent、排定时任务、改配置,执行权限分只读、改前确认、自动三档,删除仍要批)、多智能体并行、周期自动化;升级要跑 PostgreSQL 000119–000134 的迁移,先备份数据库和文件目录。
生态偏腾讯系。 飞书、IMA、微信小程序、本机 Chrome/Edge 接管这一套最顺,离开这个圈子,数据源和客户端的优势要打折。
谁适合
手上有几百上千份内部文档、要求私有化、答案必须能溯源,还想顺手让 Agent 跑多步任务的团队,值得花一个下午部署试试。它和 Dify 不冲突:Dify 强在把应用发布成 API 和产品,WeKnora 强在把文档当一等公民,认真做知识库,两个都装也不奇怪。
只想连表格和邮件做自动化,别为难它。