返回更新记录
v1.4.0

检索遥测与知识健康回路:让知识库的维护有数可依 (v1.4.0)

每次检索的引用血缘旁路落库(异步、不拖慢检索)、opt-in 查询原文记录、知识库「健康」面板(空召回率、零召回查询、沉睡内容、内容动态),以及删除前引用预警、强制重爬入口与检索结果新鲜度元数据——把"库还好吗"从猜测变成可验证的闭环。

遥测知识运营Web ConsoleREST

企业知识库最大的敌人从来不是建库,而是维护:内容悄悄过期、没人知道哪些该更新、哪些该删。v1.4.0 不发明新的检测机制——网页源的内容指纹、飞书源的增量游标、本地文件的版本记录,这些事实早已落库——它做的是补上回路的另一半:把”内容被怎么使用”记录下来,聚合成管理员看得懂、可行动、可验证的面板。

记录:检索发生了什么,从此不再用完即弃

每次检索返回给调用方的每一条证据(精确到分块修订级别、含排名)都会被异步记录下来。写入走进程内有界缓冲批量落库:缓冲满了就丢批并计数(有指标可查),任何情况下都不会拖慢检索本身——故障注入测试证明遥测链路整体失效时,检索结果逐位不变。

查询原文是可选的:默认关闭;知识库管理员显式开启后,查询原文才会被记录(保留期 30 天,仅管理员可读,随时可关)。SearchRun 元数据继续零明文——这是 v0.9.0 就立下的隐私边界,v1.4.0 没有破坏它分毫。

洞察:「健康」面板回答四个问题

知识库工作台新增第六个页签,四张卡片 + 三个面板:

  • 空召回率(北极星指标):多少比例的检索空手而归,与上一周期相比是好转还是恶化——口径明确:管理台调试流量不计入,失败请求不计入分母;
  • 零召回查询 Top N:用户反复在问、库里却没有的内容,按提问频次排序;开启原文记录后直接看到具体问法,一键带着原文跳去新建 FAQ;
  • 沉睡内容:索引了 30 天以上、从未出现在任何检索结果里的文档——归档候选清单。检索样本不足 10 次时拒绝出清单(零流量的库不该把全部内容误判为沉睡);
  • 内容动态:源同步、内容新版本、人工修订、删除,四类事件统一时间线,覆盖网页/飞书/本地文件/FAQ 全部来源。

行动与护栏:每个信号都接着出口,删除前先看引用

  • 零召回 → 创建 FAQ(问题栏预填该查询原文);
  • 沉睡内容 → 查看详情;删除永远走既有的删除流,但删除确认框现在会告诉你”这份内容近 30 天在 N 次检索中被返回过”——被依赖的内容不再无声消失;
  • 网页源新增「强制重爬」入口(忽略变更检测全量重抓,带成本确认);
  • 检索结果(REST 与 MCP)透出文档更新时间与网页抓取时间,让下游 agent 自己判断证据新旧。

对抗自己

这版交付本身也过了一轮完整的对抗性代码评审:评审在实现完成、全部测试通过的代码里抓出了一个致命接线缺陷(清理循环收了参数但从未调用,查询原文会无限期保留)、一批口径与性能问题,全部修复后才发版。清空搜索框之外,没有已知的遗留。

升级即得:标准迁移,无破坏性协议变更;查询原文记录默认关闭,不需要任何配置动作。