WeKnora 产品、技术与文档地图

研究归档：本篇保留2026年9月30日前后的本地公开资料研究。开源版本、功能、许可和星数属于当时快照；技术决策应复核所列官方来源。架构与交付计划为参考设计。

研究基线为本地 原始归档资料 的 v0.8.2（提交 3e8b0bfc）。以下“已有”均指此版本源码或官方文档可核实的能力；“适用”是本方案的判断。

1. 官方资料从哪里读

WeKnora 旧 docs/ 中的一部分内容已经迁入 website-docs/，因此应以固定版本的新文档站及源码为主；docs/swagger.yaml 是生成的接口资料，不宜拿旧版 wiki 作为唯一依据。官方文档入口、源码文档说明。

2. 产品能力分层

1. 知识采集与整理：文件/URL/目录上传，飞书、钉钉、语雀、Notion、Confluence、GitLab、腾讯 IMA、RSS 等连接器；文档解析、分块编辑与版本历史；FAQ、Wiki、知识图谱。这些是官方已有能力，具体连接器要看版本与源端授权。数据源、知识库。
2. 检索与回答：向量和关键词混合检索、重排、引用、知识问答；不同知识库可设索引策略，评估模块覆盖检索与生成指标。RAG 管线、评估。
3. Agent 与渠道：ReAct Agent 可调用知识检索、MCP、联网搜索、技能和沙箱；可通过 REST、内置 MCP 端点、网站嵌入与 IM 渠道对外提供能力。Agent、MCP、IM。
4. 企业治理：工作空间承载知识库、模型、Agent、会话和配额；成员角色为 Owner/Admin/Contributor/Viewer；API Key 可按能力与知识库范围限制，平台管理员与空间 Owner 分离；有审计和 OIDC 能力。租户鉴权、API 总览。

3. 技术架构与源码入口

标准部署的核心是 Vue 3 前端、Go app 主服务、Python docreader 解析服务、PostgreSQL/ParadeDB 和 Redis。Go 主服务承载 API、RAG、Agent、异步任务及渠道；docreader 将复杂文档转换为 Markdown 与图片，再由 Go 侧分块、嵌入和索引。对象存储、图数据库、其他向量库和 Langfuse 属于按需增加的组件。官方总体架构、文档流水线。

4. 对本产品的边界判断

• 标准版而非 Lite：Lite 单空间且解析能力受限，适合个人验证，不宜作为多企业客户共用的产品底座。Lite 与标准版。
• 工作空间是应用级隔离：它不自动等于独立数据库或独立集群。高敏感客户是否要求独立实例，应由合同、客户 IT 和隔离测试决定。租户模型。
• 知识与实时业务数据分开：SOP、话术、产品手册入库；库存、价格、商机状态、排班通过实时系统 API 读取。后者是本产品架构约束，不是 WeKnora 的内置承诺。
• 版权：主项目声明 MIT，但仓库包含第三方组件条款；交付时需保留所需通知并核对发行物。LICENSE、第三方通知。