数据库适配器
适配器决定数据在哪执行、怎么持久化、什么时候跟远端交换。选型先分清你要的是本地数据库能力还是远端同步入口。
按目的选
| 适配器 | 用途 |
|---|---|
| SQLite | 默认的本地数据库方案，覆盖大多数结构化数据场景 |
| SQLite WASM | 需要全文搜索插件或更多 VFS 选项时选它 |
| SQLiteAI | 需要本地 AI / 向量检索能力时选它 |
| PGlite | 要更强的 SQL / PostgreSQL 兼容能力时选它 |
| Supabase | 把本地模型与远端 PostgreSQL 同步起来 |
| 字段加密 | 为任意本地适配器叠加 AES-GCM-256 字段加密 |
一句话决策：先看 SQLite，需要全文搜索换 SQLite WASM，SQL 复杂度上去了换 PGlite，要同步再叠加 Supabase，敏感字段加 encrypted。
包对应关系
浏览器端入门首选 @aiao/rxdb-adapter-wa-sqlite。其他 SQLite 变体供特定环境使用：
| 包 | 文档 | 说明 |
|---|---|---|
@aiao/rxdb-adapter-wa-sqlite | SQLite | 浏览器 Worker SQLite（wa-sqlite），推荐 |
@aiao/rxdb-adapter-sqlite-wasm | SQLite WASM | 跨平台 SQLite WASM，支持 FTS5 / 全文搜索 |
@aiao/rxdb-adapter-sqliteai | SQLiteAI | SQLite + AI 向量扩展 |
@aiao/rxdb-adapter-pglite | PGlite | PGlite，PostgreSQL 浏览器版 |
@aiao/rxdb-adapter-supabase | Supabase | Supabase 远端同步 |
@aiao/rxdb-adapter-encrypted | 字段加密 | AES-GCM-256 字段级加密，叠加在本地适配器上 |
@aiao/rxdb-adapter-sqlite-core | — | SQLite 共享核心代码（内部依赖） |
先记住三个边界
- SQLite 是浏览器内的真实执行层,不是缓存封装
- Supabase 适配器是同步接入方案,不等于托管云服务本身
- OPFS 是 SQLite 路径里的持久化增强,不是独立的适配器