Repository navigation
v0.62.3 — 总命中为空时的保底召回
0.62.3 — 总命中为空时的保底召回(2026-11-14)
- 问题(实测,中文库 + bge-m3):改写问法会同时擦掉两路准入门槛,整条漏召回。
'手机还剩多少存储空间'与目标记忆余弦 0.4995(vector.minScore默认 0.5,
差 0.0005 被砍)、词法覆盖率 0.1066(长查询自适应 floor 0.153);
'磁盘剩余空间'余弦 0.4830、词法 0.0000。用户看到「没有找到相关记忆」,
模型只能重新踩坑 —— 正是记忆系统要避免的事。 - 根因(两处方向叠加):①
lexicalScore是 IDF 加权覆盖率,长查询把分母撑大、
覆盖率被稀释,而adaptiveThreshold对长查询反而收紧(base + 0.1);
② 向量侧minScore=0.5是绝对余弦门槛,而 BGE CLS 无关文本对的实测地板是 ~0.42,
落在 0.45–0.5 这条窄带里的真命中被误杀。 - 修复:新增
retrieval.vector.recallFallback(默认开)。只在两路都零命中时
放宽一次:floor = max(noiseFloor, minScore − relax)(默认 0.42 / 0.05,仍拒绝
纯噪声);纯词法库退化为收「有 ≥2 字真实词面重叠(hasStrongHit)」的最佳记录。
保底命中在结果整形阶段显式豁免shaping.floor,否则会被地板分二次砍掉。 - 边界:有命中的正常路径分毫不动;
recallFallback.enabled:false可完整回退到
0.62.2 行为;余弦 0.40 的无关文本仍然不召回(有回归用例锁定)。 - 新增回归用例 5 例:用假 OpenAI 兼容嵌入服务精确复现「0.4995 擦线」场景,覆盖
向量保底 / 关闭开关 / 噪声地板 / 纯词法保底 / 无重叠不硬凑。
测试:1102 例 / 1101 pass / 1 skip / 0 fail。