用途:为使用 Convex 构建全栈 TypeScript 应用提供专家级指导,覆盖服务端函数、数据模型、认证、文件存储、实时更新、前端集成、测试与部署。
主要能力:三类服务端函数——query(只读、自动响应式)、mutation(写入、事务)、action(调用外部 API);数据库 CRUD 与查询方法(collect、first、unique、paginate);用 defineSchema/defineTable 定义 schema 与索引;React 与 Next.js App Router 集成(ConvexProvider、useQuery、useMutation、preloadQuery、usePreloadedQuery);Clerk 认证;文件上传下载删除;HTTP 端点与 webhook;定时任务(cronJobs、scheduler.runAfter/runAt);结构化错误 ConvexError;用 convex-test 与 vitest 测试。
使用方式:新项目运行 npm create convex@latest 与 npx convex dev;已有项目运行 npm install convex 与 npx convex dev;在 https://dashboard.convex.dev 查看面板。生产部署用 npx convex deploy,可加 --cmd 'npm run build',并设置 CONVEX_DEPLOY_KEY。
适用场景:需要实时同步、类型安全、服务端逻辑与前端紧密集成的 TypeScript 全栈应用。
限制与注意:查询避免用 .filter(),应使用索引或在应用代码中过滤;避免多次顺序 runQuery/runMutation,应合并调用;受保护函数需校验认证;大数据集应分页;函数未找到时运行 npx convex dev 重新生成类型。资料未提供具体收费、价格与平台限制信息。