fandhe-db
fandhe-db
fandhe-db は Rust 製のローカルファースト vector 特化クエリ DB。fandhe-db-engine（コアエンジン、SQL 表層・HNSW/BM25/hybrid 検索・redb 永続化・RLS）と fandhe-db-wire-server（PostgreSQL wire protocol v3 互換のバイナリ）の 2 crate workspace で構成され、無改造の psql / psycopg / pg クライアントから接続し、USING PLAN / USING OPERATION_ID 拡張構文を含む SQL を実行できる。0.2.0 の表層は次のとおり。
- SQL: DDL（
CREATE/ALTER/DROPの TABLE・VIEW・INDEX・TYPE、制約）、JOIN / CTE / サブクエリ / 集合演算 / ウィンドウ関数 - wire: 明示トランザクション・カーソル・
COPY・拡張クエリプロトコル、TLS 1.3・SCRAM-SHA-256 - NoSQL:
--surface nosqlで有効化する HTTP/1.1 JSON NoSQL 表層（POST /v1/session/POST /v1/query）
対象バージョンは fandhe-db-engine / fandhe-db-wire-server とも crates.io 0.2.0（2026-10-08 公開、旧名 fandhe-vector-db-* 0.1.0 からの改名後初版。tag / release なし、publish commit SHA dc888f6ea146d3078153d64a6848f5c8cf044431 で pin）。旧名 fandhe-vector-db-engine / fandhe-vector-db-wire-server の 0.1.0 は crates.io に残るが更新されない。crate 名・環境変数名・ValidatedInsert / BoundInsertForm の移行は references/getting-started/migration-0-2.md を参照。lib 名 engine / wire_server とバイナリ名 wire-server は不変。
公式ドキュメントサイトは存在せず、出典は公開リポジトリ https://github.com/Fandhe-AI/fandhe-db の README・CHANGELOG・docs/design/ ADR と、crates.io の .crate tarball（一次ソース）。docs.rs の fandhe-db-engine/0.2.0 はレンダリング済み rustdoc ページも取得可能だが、シグネチャの根拠は tarball の src/ に置く。
仕様の位置づけ — 仕様の source of truth は private リポジトリ Fandhe-AI/fandhe-db-spec（非公開）にあり、本スキルはそこへアクセスできないため、公開ソース・公開 ADR から追跡できる範囲に限定している。crate ソースの doc comment（rustdoc）は日本語で書かれており、references 本文はそれを日本語で要約し、シグネチャ（型・識別子）部分は英語 verbatim で転記している。private spec 参照 ID のみが残る挙動は各ページ ## Notes に「spec 非公開のため未記載」と明記している。
他スキルとの使い分け — upstash は @upstash/vector のマネージド SaaS クライアント（REST ベクター API）、supabase は pgvector 拡張・Postgres RLS のクライアント利用であり、いずれもベクター DB エンジン本体ではない。mssql / drizzle / supabase は SQL クライアント / ORM であり、本スキルの SQL 表層（USING PLAN 等の拡張構文、DDL・JOIN・CTE・トランザクションの DB 側実装）とは別物。nosql-surface/ の HTTP JSON 表層は DB エンジンが提供する API であり、upstash（SaaS の REST クライアント）や fandhe-backend（Rust HTTP サーバーフレームワーク）とは別物。本スキルの performance/ は CPU SIMD（isa / dispatch）と wgpu 経由の GPU バッチカーネルを扱い、nvidia-cuda / apple-silicon / amd-rocm が担う GPU 言語・ランタイム層（CUDA / MSL / HIP）のリファレンスではない。fandhe-ai / fandhe-backend / fandhe-frontend は同じ fandhe org の別ライブラリで API は無関係、ベクター DB エンジン本体を調べる場合は本スキル（fandhe-db）を参照すること。