fandhe-vector-db 是 Rust 编写的本地优先（local-first）向量专用查询数据库，由两个 crate 组成工作区：fandhe-vector-db-engine（核心引擎，含 SQL 表层、HNSW/BM25/hybrid 检索、redb 持久化、RLS）与 fandhe-vector-db-wire-server（PostgreSQL wire protocol v3 兼容二进制）。可从未经改造的 psql / psycopg / pg 客户端连接，执行含 USING PLAN / USING OPERATION_ID 扩展语法的 SQL。目标版本为两 crate 的 crates.io 0.1.0，无 tag/release，固定 commit SHA 7022d112e79760dca916480599553fcac256b5fb。公开来源为 GitHub 仓库 Fandhe-AI/vector-db 的 README、docs/design/ ADR 及 crate 源码（docs.rs source view）。
主要覆盖内容按目录划分：getting-started（crate 结构、features、依赖、VectorCore/EngineCore API、ErrorClass/WireError 映射、开发环境与 Makefile）、sql（词法、语义绑定、AST 允许列表、USING PLAN 等扩展语法、recall/precision 模式、EXPLAIN）、sql-execution（执行计划 RLS→SCALAR→DISTANCE、聚合与 GROUP BY、表达式编译、标量二级索引、UDF 调用与各类缓存）、search（HNSW 近似最近邻、BM25 倒排索引、RRF hybrid 融合、重排序、评分增强、precision 门控、查询规划）、storage（redb 持久化、行编码、模式目录、事务与恢复、增量索引、向量 arena、缓冲池）、security（租户边界、RLS 隐式应用与可见行限定检索）、wire-server（CLI 参数、握手与认证 Argon2id、消息分帧、简单查询、错误响应、超时与并发限制）、performance（SIMD 检测与调度、wgpu GPU 批处理、CPU-SIMD 回退、并行 Top-k、f16/SQ8 量化）、extensions（WASM UDF 沙箱、声明式过滤、嵌入转换、分块、词典抽取），另有 samples（启动、psql/psycopg/node-pg 连接示例、三客户端 e2e、Docker Compose）与 scripts（安装、Makefile、运行命令）。
使用方式为按任务查映射表定位类别，再读对应 references/{category}/README.md 找到具体页面。限制：官方文档站不存在，规格的 source of truth 在非公开仓库 Fandhe-AI/vector-db-spec，无法访问，内容仅限公开源与公开 ADR 可追踪范围；仅剩私有 spec 参照 ID 的行为在 Notes 中标注为未记载；与 upstash、supabase、mssql、drizzle 等客户端/ORM 性质不同，nvidia-cuda 等 GPU 运行时层也不属于本技能范围；安装命令、收费、平台支持等资料暂未提供。