📌 项目地址：Tencent/WeKnora | ⭐ 15,748 颗星 | 🔧 Go | 📜 NOASSERTION
WeKnora在解决什么问题
企业文档管理的现状通常是这样的：PDF、Word、Excel、图片散落在飞书、Notion、语雀各个平台，找一份参数要翻好几个目录，新人入职要读几十份文档才能上手。
WeKnora把这件事变了一个思路——不让人类去适应文档结构，让AI去理解文档内容。它用RAG做快速检索，用ReAct Agent做多步推理，用Wiki Mode(Auto-Wiki)自动把原始文档提炼成交互式知识图谱。三个能力可以单独使用，也可以组合运行。
仓库地址：Tencent/WeKnora
核心亮点：三层能力拆解
读完README，我觉得最有价值的是它的架构设计——”可拆可合”是真正能落地的方式。
第一层：RAG快速问答
支持10+种文档格式，包括PDF、Word、图片、Excel。日常查参数、查条款，直接提问返回答案。这一层做的中规中矩，但足够实用。
第二层：ReAct Agent
这是真正拉开差距的地方。Agent用ReAct模式（思考-行动-观察循环）自己决定执行步骤。比如”比较上季度和本季度收益，顺便查竞品新闻，给一份摘要”，它自己决定先调哪个知识库、用哪个MCP工具、需不需要联网搜索。你不需要提前设计流程。
第三层：Wiki模式（v0.6.0新增）
我觉得这才是he项目的杀手级功能。Agent把原始文档自动提炼成相互链接的Markdown知识库，同时生成交互式知识图谱。README原话是”a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph”。
新文档加入后，Agent会主动修复过时链接、补充新条目。知识库不是一次性产物，而是持续维护的活系统。
三层可以组合使用。比如用Wiki模式管理团队知识库，Retrieval或Agent直接调取答案。
企业级功能交代得清清楚楚
很多开源项目在”企业级”三个字上画饼，WeKnora的v0.6.x版本已经把功能做出来了。
多租户RBAC
四级角色矩阵：Owner / Admin / Contributor / Viewer。每个知识库有明确归属，每个租户的操作都记录审计日志。多工作空间和成员管理也一并上线。这对需要严格权限控制的企业部署来说，是硬要求。
加密与通信安全
敏感凭证用AES-256-GCM加密，docreader通信走gRPC TLS加Token验证。README有明确说明。
可观测性集成Langfuse
v0.6.1新增了文档解析的span树（和Langfuse风格一致），每步进度可视化，支持中途停止解析任务。这意味着Agent的推理过程、Token用量、流水线耗时都可以追踪。
这些功能都在已发布的版本里，不是roadmap。
模块化架构的可替换性
WeKnora的模块设计让更换组件很方便：
- LLM提供商：20+种，包括OpenAI、DeepSeek、通义千问、智谱、混元、Gemini、MiniMax、NVIDIA、Ollama。v0.6.1加了per-model thinking-mode配置，可以按模型单独开关CoT(Chain-of-Thought)输出。
- 向量数据库：默认ChromaDB，v0.6.1新增OpenSearch驱动。
- 存储后端：支持本地磁盘和私有云，数据完全企业自己控制。
- 文档解析：PaddleOCR-VL、OpenDataLoader（v0.6.1新增）。
- 数据源：自动同步飞书、Notion、语雀（更多在接入）。
- IM渠道：企业微信、飞书、Slack、Telegram。
- MCP服务器：支持stdio、SSE、HTTP三种传输协议（v0.6.1）。
这一点对企业部署非常关键——你可以用Ollama做本地推理，搭配ChromaDB和本地存储，连公网都不用碰。
版本关键更新汇总
基于README的CHANGELOG.md：
v0.6.2
- 上传确认对话框，支持Process配置
- 文档重新解析（携带process_config）
- CLI v0.9：挂载Agent Skills、session stop、auth/profile统一
- 知识库多选
- HNSW索引支持（pgvector 1024维）
- 聊天资源store重构
- 仅保留Langfuse追踪（移除Jaeger）
v0.6.1
- 文档解析trace timeline（Langfuse风格span树，支持阶段展示+停止）
- OpenSearch向量数据库驱动
- Declarative built-in models via YAML
- 系统管理员平台设置+审计日志
- 新用户引导指南
- UI重新设计
- CLI v0.7/v0.8：agent-first wire contract、NDJSON、–dry-run
- OpenDataLoader + PaddleOCR-VL
- MCP server multi-transport
- Per-model thinking-mode
- Tencent LKEAP rerank + native Gemini embeddings + MiniMax-M3
v0.6.0
- 多租户RBAC（4级角色矩阵）
- 成员管理
- 多工作空间UI
完整更新记录见CHANGELOG.md。
上手流程
README有完整的Getting Started、API Reference和Developer Guide。部署方式支持Docker一键启动，也支持纯本地运行（Ollama + ChromaDB组合，无需公网）。
CLI工具weknora的几个关键点：
- v0.4增加
mcp serve命令 - v0.7/v0.8改进agent优先的wire合约、NDJSON输出、–dry-run
- v0.9挂载Agent Skills
文档分块支持三档自适应策略，解析时可以实时预览分块效果。
WeKnora解决的是”企业文档多、知识靠人搜”的老问题，但解决方式比较务实——RAG、ReAct Agent、Auto-Wiki三个齿轮可以单独用，也可以组合跑。权限、加密、可观测性做到了产品级。
如果你的团队正面临”文档散在各平台、新人上手慢、知识更新靠人工”的问题，值得花半小时看一遍README的Getting Started。