SuperAPI AI 工具集

convex-pro

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:作为 Convex.dev 的后端架构技能,指导构建低延迟实时应用,强调响应式数据库设计、类型安全的全栈同步与强化授权。

主要能力与规范:先写 convex/schema.ts 定义数据模型;每个公开函数必须校验 ctx.auth.getUserIdentity();禁止对无界数据集使用 .filter(),应定义并使用 .withIndex();相关数据库操作合并到单个 mutation 以保证一致性。授权上采用函数边界显式授权,未授权时抛出带结构化数据的 ConvexError,敏感查询使用不可猜测 ID 或来自 getUserIdentity() 的 userId。查询默认响应式,应缩小返回数据面;预计超过 100 条的列表查询使用 paginationOpts。Convex 使用乐观并发控制,mutation 需幂等,修改或删除前检查文档当前状态。

用法要点:本地开发使用 npx convex dev,除非明确要求否则不要用 npx convex deploy;不要在查询处理器中对大数据集用 Array.filter();不要把 userId 作为普通参数从客户端传入用于安全判断;若逻辑可合并为单个 mutation,不要在 action 内使用 ctx.runQuery 或 ctx.runMutation;始终指定返回校验器。

适用场景:实时应用、类型安全全栈同步、需要强化授权的 Convex 后端。限制:资料未提供具体收费、价格与平台支持信息。