WeKnora 把企业里的 PDF、Word、网页和笔记整理成一个能检索、能追问、也能调用工具的知识库。它适合先解决一个很现实的问题：资料很多，但团队每次都要重新找。

知识库工具常见的难点不在“上传文件”，而在资料更新后还能不能继续用。腾讯开源的 WeKnora 将文档解析、RAG 问答、Agent 和 Wiki 放在同一套自托管系统中。它既能回答“制度里怎么规定”，也能把原始资料逐步沉淀成可浏览的知识页面。

一、它到底怎么用？

官网  

https://weknora.weixin.qq.com/

GitHub

https://github.com/Tencent/WeKnora

安装方式：需要 Docker、Docker Compose 与 Git。先克隆项目，复制环境变量文件，再用 Docker Compose 启动服务。

git clone https://github.com/Tencent/WeKnora.git cd WeKnora cp .env.example .env docker compose up -d

1. 先建一个小而明确的知识库

不要一开始就把所有文件都塞进去。先选一个场景，例如新人入职、产品 FAQ 或项目设计文档。上传几份最常被问到的资料，再用真实问题测试召回效果。

示例：把产品说明、报价规则和常见异议整理进一个知识库，再问“这个套餐能否开通试用”。

2. 用问答和 Wiki 两种方式消化资料

日常查资料可直接使用 RAG 问答；需要长期维护时，可用 Wiki Mode 把零散文档整理为相互关联的 Markdown 页面和知识图谱。前者适合快速回答，后者适合让资料形成更稳定的结构。

3. 再连接你的工作入口

WeKnora 支持多种文档来源，也能接入企业常用的沟通渠道和网页嵌入组件。实际使用时，先把知识库跑顺，再决定是否开放给客服、销售或内部协作场景。

二、作为 Skill 怎么使用？

WeKnora 提供官方 weknora CLI，可在终端或 AI Agent 中调用；命令默认输出稳定 JSON，也可用 weknora mcp serve 提供 MCP 工具。项目还随 CLI 提供 Agent Skills。

weknora profile add prod --host https://kb.example.com --use weknora auth login weknora kb list weknora doc upload notes.md weknora chat "summarise the design doc"

接入后可以这样交代任务：

把当前目录的会议纪要上传到“产品知识库”，并列出三条待确认事项。

从设计文档中总结上线风险；找不到依据时明确说明。

三、使用注意事项

模型、解析与检索质量要分开验证

答案不准时，不一定是模型的问题，也可能是文档解析、切分或召回没有命中。建议先用少量有标准答案的资料测试，再逐步扩大导入范围。

权限与敏感资料必须先划边界

WeKnora 面向企业知识场景，支持多工作区与权限控制。涉及合同、客户信息和内部制度时，应先设计访问范围、模型服务与密钥管理，别把“能检索”直接等同于“所有人都能看”。

四、它适合谁？

适合：

• 有大量内部文档，希望减少重复答疑的团队。
• 想把 RAG、Agent、MCP 与知识管理放在同一套系统里的技术团队。
• 需要自托管、可控权限与可追溯资料来源的企业场景。

不适合：

• 只想临时问一两个文件、且不愿部署服务的个人用户。
• 没有整理资料和权限规则，却希望系统自动给出可靠结论的场景。

五、最后总结

WeKnora 真正有价值的地方，不是多了一个聊天框，而是让文档从“存着”变成“能被团队持续使用”。

先用一个小知识库验证问题，再把它接进真正的工作流。