LFN Knowledge｜企业知识中心

项目定位

LFN Knowledge 是 LFN Cloud 内的企业知识中心，面向操作手册、产品规则与内部文档。它要解决的不只是“能否搜到”，还包括谁可以使用这份知识、当前生效的是哪个版本、回答依据能否回到原文。员工通过检索页面查资料，Agent 则通过同一套受控接口获得知识，两者共享权限与发布规则。

从原始资料到已发布知识

1. 管理知识范围：按租户、应用和用途创建知识空间，设置可见性与成员角色。服务端会重新校验空间权限，页面上的入口不作为授权依据。
2. 导入并保留版本：维护者编辑 Markdown，或导入 Markdown、TXT、PDF、Office 等文件。原件经 System 文件服务受控获取；每次修改形成不可变的正文版本，保留来源与审核记录。
3. 异步构建索引：文档按标题、章节和段落切分，生成带原文位置的切片；全文索引与向量索引分别构建。索引任务可恢复，新索引代在后台准备，失败时保留上一代可用索引。
4. 审核后发布：编辑者提交版本，由不同人员审核。只有审核通过且索引就绪的版本才能发布；新版本处理中，旧发布版本继续提供检索。下架或权限变更会影响后续查询资格。

这条流程把资料导入、机器处理和对外可用区分开来，避免未经审核或尚未索引完成的内容进入回答。

检索结果能回到哪里

Knowledge 使用独立的 PostgreSQL 数据库保存文档、版本和切片，pgvector 负责语义召回。查询同时走全文关键词与向量召回，再用 RRF 融合候选；可选的 Cross-Encoder Rerank 只处理已通过权限过滤的有限结果。返回引用包含文档、版本、切片及来源位置，读者可以从答案回查原文。

检索范围先由当前用户、租户、应用、用途和空间权限确定，再限定为已发布、索引就绪的版本。这样即使同一句话出现在不同权限的空间中，也不会因为语义相近而越过访问边界。

让知识可更新、可评测

索引代际记录解析、切片和 Embedding 模型等信息。新一代索引可以先构建并评测，再切换活动指针；评测拒绝或构建失败时保留旧代，必要时可回滚。评测集覆盖召回、无答案、权限和引用等场景，为后续调整切片、模型与排序策略提供对照依据。

在原文之外，模块也建设 Wiki、FAQ 和实体关系等派生知识。模型生成的内容先成为带逐条来源证据的草稿，仍须人工复核、审核和发布；来源换版或下架后，依赖它的派生内容会标记失效。图谱关系用于扩展检索线索，最终结论仍回到可访问的原文。图谱与社区摘要已有可治理、可评测的代码基线，实际增益和上线范围仍需真实数据验证。

与 Agent 的边界

Agent 通过 knowledge_search 工具按当前用户身份调用 Knowledge，而不是直接访问知识数据库。它可以在受限预算内选择检索模式、补充查询并引用证据；实时业务状态和业务操作则由相应服务的授权 API 处理，知识文本不会自动变成业务执行指令。

当前进展与下一步

空间、文档、审核发布、异步索引、混合检索、来源引用及 Vben 管理页面已有代码实现；Wiki、图谱和评测能力也已形成试点链路。下一步继续用目标环境的真实模型与业务语料验证检索质量、引用准确性、跨模块联调和使用体验，再决定高级检索能力的启用范围。