| 常见默认 | 文本 embedding 用余弦，或归一化后的内积 |
|---|---|
| 库差异 | Milvus 支持 COSINE/IP/L2；pgvector 用算子显式选择 |
| 一致性 | 入库、查询、索引、评测四处必须使用同一度量 |
一致性检查清单
一致性检查清单
索引构建时的度量：______
查询端计算方式：______
评测脚本的相似度函数：______
（三者不一致时，评测结论与线上行为不符）迁移向量库时度量不一致是最常见的静默错误：流程能跑通，但检索质量悄悄变差。
本包目录（229 条）
架构与流程30 条解析与切分33 条
Embedding 与检索50 条
- Embedding 向量化基础
- 混合检索（向量 + BM25）
- 中文 Embedding 模型选型
- BM25 排序算法
- HNSW 图索引与参数
- OpenAI Embeddings API 用法
- Sentence-Transformers 本地向量化
- 余弦相似度（Cosine Similarity）
- RRF 倒数排名融合
- 前置过滤与后置过滤
- 切分粒度与召回效果
- 度量选择与索引一致性
- IVF 倒排索引（nlist / nprobe）
- top-k 选取与重排配套
- BGE-M3 多语言多粒度模型
- 向量归一化与度量等价
- Recall@k 与命中率评估
- E5 模型的查询/段落前缀
- 内积（Dot Product）与检索
- 中文分词与 BM25 效果
- 学习式稀疏向量（SPLADE）
- 相似度阈值与 No-Answer 判定
- 元数据过滤加速召回
- 查询指令与非对称检索
- 批量向量化与限流处理
- 乘积量化（PQ）压缩向量
- efSearch 召回与延迟调优
- 多路召回合并与去重
- 向量维度与存储成本
- 超长文本的截断与池化
- 用小评测集选择 Embedding 模型
- 欧氏距离（L2）
- 加权分数融合与归一化
- nprobe 与 IVF 召回权衡
- 建立可回归的检索基线
- MTEB / C-MTEB 榜单使用
- 锁定 Embedding 模型版本
- MRR 与 NDCG 排序质量
- 向量索引常见问题清单
- 向量库基础概念与 CRUD
- Embedding 领域微调
- 向量化结果缓存
- Cohere Embed 与 input_type
- 标量量化与二值量化（SQ / BQ）
- Embedding 模型升级与索引重建
- 批量检索与服务并发
- 相似度分布诊断
- 用 LLM 判定召回的补充评估
- NumPy 矩阵化相似度计算
- 余弦检索实现细节与坑
度量选择与索引一致性
度量（COSINE / IP / L2）要与模型用法和索引配置匹配；索引按度量构建，切换度量通常需要重建索引，评测脚本与线上库也必须一致。
易错点
- 评测用余弦、线上库用内积，评测结论不可迁移
- 更换度量后未重建索引，结果异常但报错为零
数据来源与参考
- Milvus 官方文档（度量类型）
- Qdrant 官方文档（Distance）
- pgvector README（距离算子）