用途:这是 TanStack DB 的技能手册,面向需要在客户端构建响应式数据层的开发者,帮助按主题快速定位实时查询、乐观变更、集合配置、Schema 校验与 ElectricSQL 同步等用法。
主要能力:TanStack DB 是 API 的响应式客户端存储,提供亚毫秒级实时查询、即时乐观更新,并可与 REST API 及 ElectricSQL 等同步引擎集成。手册按目录组织:live-queries/ 覆盖过滤、连接、聚合、groupBy、orderBy、子查询与响应式更新;mutations/ 覆盖插入/更新/删除、乐观更新、事务、节流变更与错误处理;collections/ 覆盖 QueryCollection、ElectricCollection、本地集合、同步模式与生命周期;schemas/ 覆盖 Schema 定义、TInput/TOutput 类型、转换、默认值与校验错误;electric/ 覆盖 shapes、txid 匹配、实时同步与代理。
使用方式:核心包为 @tanstack/db,React 适配为 @tanstack/react-db(提供 useLiveQuery 等钩子),另有 Vue、Angular、Svelte、Solid 适配包;REST 集成用 @tanstack/query-db-collection,ElectricSQL 同步用 @tanstack/electric-db-collection。典型流程是先 createCollection 定义数据源,再用 useLiveQuery 做响应式查询,最后通过 collection.update 等方法做乐观变更。
适用场景:需要客户端实时查询、跨集合连接与聚合、乐观写入与回滚、与 REST 或 ElectricSQL 同步的前端应用。
限制:资料未提供具体版本要求、性能基准、收费或许可信息,也未给出完整安装命令与详细 API 参数,实际使用需参考官方文档。