shared.py

概述

retrieval/retrieverModules/shared.py 它是将其他多个搜索（混合、向量、词频）可能都会必须用到的某些共享的数据模型类结构、针对问题字符串清理标准化工具、特殊的配置结构对象定义（超参数 Top_k ，各种归一化权重等）抽取至一处存放避免各部件交叉引用甚至循环引用死锁的公共依赖基础设施提供仓库。

主要暴露依赖物对象

normalize_score(score: float, min_val, max_val) -> float

经常在多套异构模型合拢打分榜的前级进行的针对某个打分体系边界进行缩放或者转换让大家在一个水平面上进行混合（如 RRF 之类的分数转换辅助）机制实现单元配置点。

class BaseRetriever(...)

很可能定义一个标准的约定基类，强制约束那些子检索组装或者模型派生器应该继承的具有固定契约和统一调用口 def retrieve(query: str) -> list 的抽象或者接口壳的结构存放处。