索引工件化范式
底层范式是把索引当作可交付工件：构建阶段产出可持久化索引文件与元数据，查询阶段只加载与执行，便于在多环境复现与回归。
zvec 把向量检索拆成可维护的“索引构建 + 查询执行”两段式工程：离线阶段将 embedding 向量压进可持久化的索引结构，在线阶段以可控的召回/延迟预算执行近似最近邻查询，并把吞吐优化（批处理、并行、SIMD）放到核心路径里。它适合做成业务服务的底层组件：在不引入完整向量数据库的前提下，把 ANN 检索能力嵌入你的检索链路、推荐召回或多模态应用中，并通过版本化配置与索引工件，让质量与性能迭代可回归、可对比。
| ✕传统痛点 | ✓创新方案 |
|---|---|
| 把向量检索堆在业务代码里，索引格式、参数与性能调优不可复现，线上回归很难定位。 | zvec 以“索引工件化”将构建与查询解耦：索引可持久化、可版本化，线上只负责加载与执行，回归更可控。 |
| 直接上完整向量数据库会引入额外运维面与数据通路改造，对轻量召回场景反而过重。 | 以 ANN 为核心，把吞吐与延迟优化前置到查询执行层，并提供可配置的召回/性能折中，适合嵌入式落地。 |
1git clone https://github.com/alibaba/zvec.git && cd zvec1# 示例：按仓库说明执行构建命令（如 cargo build --release 或 cmake --build）1# 示例：zvec build-index --input embeddings.bin --output index.zv --config config.yaml1# 示例：zvec query --index index.zv --vector query.bin --topk 101# 固定一组查询向量与期望topK，保存指标与输出，用于后续版本对比| 核心场景 | 目标人群 | 解决方案 | 最终收益 |
|---|---|---|---|
| 语义检索的可嵌入 ANN 召回层 | 搜索/知识库团队 | 把 embedding 的近邻召回嵌入现有检索链路 | 在可控延迟内提升召回与相关性，并支持可回归调参 |
| 推荐系统的向量召回与AB迭代 | 推荐/增长团队 | 离线构建索引、在线低延迟召回候选 | 把召回策略变成可版本化组件，AB更可控、回滚更稳 |
| 多模态应用的本地向量检索组件 | 多模态/内容理解团队 | 在内网或边缘环境做向量检索 | 数据边界清晰、成本可控，吞吐可按硬件水平扩展 |
