09_vector_retrievalGPU 向量检索引擎/张磊

[zhang200210-neu]

GPU Vector Search Engine (vsearch)
一个面向 RAG / 推荐 / 多模态检索场景的 CUDA 向量检索演示引擎，支持：

exact：GPU 精确检索 baseline（全量距离 + 分块归并 Top-K），支持 L2 / inner product / cosine；
ivf_flat：IVF（倒排文件）+ Flat 向量距离；
ivf_pq：IVF + Product Quantization（ADC 距离表 + 压缩码本；默认对 top-256 候选做原始向量精排，设 pq_rerank = 0 可切换为纯 ADC）；
fp16 / fp32 二进制向量库读取（内存统一按 fp32 计算）；
索引保存 / 加载，避免每次查询重新建索引；
批量查询、K=1/10/50/100、CPU 参考实现、结果/性能/质量日志；
主机与 GPU 正确性测试。
程序可在四个 GPU 平台构建与运行：

平台 构建方式 验证情况
NVIDIA CMake + nvcc RTX 4090 上构建、主机/GPU 测试与 bench 全部通过
天数智芯 CoreX make -f Makefile.corex（clang -x ivcore） MR-V100（IX-ML 4.4.0）上全部通过
沐曦 MetaX make -f Makefile.maca（cucc + -lmcblas） MXC500（MACA 3.5.3）上全部通过
摩尔线程 MUSA make -f Makefile.musa（mcc -x musa + -lmublas） MUSA 5.1.0 上全部通过
四平台最近一次回归均通过（test_host + test_gpu 全部 PASS，端到端 bench 正常）。 四平台使用同一套检索算法与 kernel 实现，差异仅体现为构建脚本与少量编译期分支。 代表性结果见文末与 REPORT.md。