核心功能概述
WeKnora 是一款面向企业用户的知识库管理 API 工具，提供从文档上传到智能检索的完整知识管理闭环。其核心能力涵盖三大维度：文档导入（文件上传、网页抓取、Markdown 手动录入）、知识解析（自动分块、多模态处理、状态追踪）以及混合检索（向量语义搜索 + 关键词匹配）。
显著优点
1. 多源接入能力：原生支持 PDF、Office 套件、Markdown、HTML 等主流格式，同时提供 URL 自动抓取和手动 Markdown 编辑，覆盖结构化与非结构化数据场景。
2. 混合检索机制：独创的 hybrid-search 端点融合向量语义相似度与传统关键词匹配，兼顾召回率与精准度，支持跨知识库的语义搜索。
3. 状态驱动架构：每个知识条目具备完整的生命周期状态机（pending → processing → completed/failed），配合 enable_status 实现上线前的内容审核机制。
4. 企业级扩展性：支持多知识库隔离、分页浏览、自定义嵌入模型，以及 enable_multimodel 多模态解析选项，满足大规模文档处理需求。
潜在局限
- 自托管依赖：需自行部署 WeKnora 服务端并维护基础设施，无托管 SaaS 选项，技术门槛较高。
- 异步处理复杂度：文档解析为异步流程，需客户端实现轮询逻辑，增加集成复杂度。
- 检索无分页：混合搜索返回固定数量结果，海量数据场景下需客户端二次过滤。
适用人群
适合拥有技术团队的中大型企业、需构建私有化知识库的研发组织、以及将文档智能纳入产品能力的 ISV 开发者。
常规风险
- 凭证泄露风险：API Key 以环境变量形式配置，存在误提交至代码仓库的可能。
- 数据驻留问题：自托管模式下需自行保障数据安全合规。
- 解析失败处理：大文件或复杂格式可能导致解析失败，需实现重试机制（
POST /knowledge/:id/reparse）。