feat: prepare RAG evidence and compatible chat requests

This commit is contained in:
2026-10-16 20:01:00 +08:00
committed by saint
parent ed8780cacc
commit d91a6808a9
16 changed files with 1066 additions and 5 deletions
+7
View File
@@ -49,3 +49,10 @@
状态:后端分支实现,待审阅。基于已合入的向量快照,新增正文 BM25 的 chunk 基线,与向量模式使用同一文本发布及分类范围;保留条目关键词接口作为独立口径。两路候选各限 candidate_k,使用从 1 起的排名、固定 k=60、等权倒数排名融合,缺席一路贡献为零。保存候选全排名、原始分数、两路贡献和配置,确保实验准备可复核;不把 BM25 与余弦原始分数直接相加。
公式与常数参考 [RRF 原论文](https://cormack.uwaterloo.ca/cormacksigir09-rrf.pdf),本项目尚未依据核验领域问题集调优。同步精确计算限制 2000 chunks,固定配置、版本一致性、历史兼容与回滚见 [HYBRID_API.md](HYBRID_API.md)。
## ADR-012 先固定证据与 Chat Completions 契约
状态:T08 分支实现,待审阅。用户要求模型选择暂缓,先按 OpenAI 通用格式开发。选择纯 `model/messages` 请求构造及非流式单候选响应解析,不配置服务、凭据或默认生成模型;参数兼容通过显式 role/token 字段选项表达,不暗中降级。供应商可替换,真实调用验证另行开展。
上下文只接受服务端 chunk 检索记录,在当前性锁内复核证据,完整保留原文和出处;重叠和超预算片段明确排除,不截断正文。引用校验只能确认编号存在,不能证明事实受到支持。准备快照通过独立表持久化,不把协议 fixture 或准备结果标记为真实模型回答。完整边界见 [RAG_CONTEXT_API.md](RAG_CONTEXT_API.md)。