SuperAPI AI 工具集

convex-tanstack

通用与其它

查看项目

更新于 10-15 23:23

技能介绍

用途:为使用 Convex(响应式后端即服务)与 TanStack Start(全栈 React 元框架)构建实时、响应式全栈应用提供指导,适用于实现 Convex 查询/变更/动作、配置 Better Auth 认证、设置 TanStack Router 路由与加载器、编写 schema 与索引、数据获取模式、文件存储、调度与 cron、以及用 @convex-dev/agent 构建 AI 智能体,也用于排查 SSR 与水合问题。

主要能力与用法:数据获取推荐从 convex-helpers/react/cache 引入 useQuery,变更与动作从 convex/react 引入;SSR 配合 @tanstack/react-query 的 useSuspenseQuery 与 @convex-dev/react-query 的 convexQuery。禁止条件调用 Hook,改用 "skip" 模式;查询按三态处理(undefined 加载、null 未找到、否则成功)。后端函数需带 returns 校验器,索引名包含全部字段且查询字段顺序一致,避免 .filter() 全表扫描。后端认证用 authComponent.getAuthUser(ctx) 校验。核心原则:读用查询、函数保持快速(<100ms、少量记录)、优先查询/变更而非动作、始终用索引、减少客户端状态。

参考文件按任务加载:01-setup、02-router、03-auth、04-data-fetching、05-backend、06-types、07-storage、08-scheduling、09-agents、10-frontend、11-permissions、12-deployment、13-quick-reference。

限制:资料未提供具体收费、价格、平台支持范围与效果数据,暂未提供。