用途:该技能面向 Convex 实时响应式后端开发,适合实时协作类应用(文档、白板、聊天)以及需要 UI 即时更新、端到端类型安全、复杂乐观更新的 TypeScript 项目。
主要能力:核心概念包括服务端函数(queries 读、mutations 写、actions 调用外部 API)、数据变化时自动重执行的响应式查询、服务端确认前即更新 UI 的乐观更新,以及带智能失效的自动查询缓存。技能按模块组织:响应式查询(基础查询、基于索引查询、搜索索引、分页、useQuery、乐观更新)、服务端函数(mutations、actions、内部函数、crons 定时任务、HTTP 端点)、认证集成(Clerk、Auth0、服务端认证、基于角色的访问控制、会话管理)、文件存储(上传流程、URL 生成、带进度客户端上传、展示组件、文件管理)。
使用方式:用 npm create convex@latest 初始化项目,用 npx convex dev 启动开发服务器。项目含 convex 目录(_generated 自动生成类型与 API、schema.ts、functions 子目录、可选 http.ts 与 crons.ts)及 src 目录下的 ConvexProvider.tsx。Schema 通过 defineSchema、defineTable 及 v 校验器定义,支持 index 与 searchIndex。React 端通过 ConvexProvider / ConvexProviderWithClerk、useQuery、useMutation 接入。文档检索可用 mcp__context7__resolve-library-id 与 mcp__context7__get-library-docs。
最佳实践与限制:为所有过滤查询建索引,大数据集优先分页,全文检索用搜索索引;mutations 保持聚焦原子,多步操作使用内部 mutation,用 v 模块校验输入并检查授权;用 ConvexError 处理错误,加载时处理 undefined,处理乐观更新回滚。资料未提供具体收费或价格信息。