moai-platform-convex

用途：作为 Convex 实时后端专项技能，指导构建 TypeScript 优先、具备实时响应与乐观更新的应用，如文档、白板、聊天等协作场景，适用于需要即时 UI 更新而无需手动重新取数的项目和端到端类型安全需求。主要能力：涵盖响应式查询（数据变化自动重执行、基于索引查询、搜索索引、分页与 React useQuery 集成、乐观更新）；服务端函数（查询、写入 mutation、调用外部 API 的 action、内部函数、cron 定时任务与 HTTP webhook 端点）；认证集成（Clerk、Auth0、服务端鉴权、基于角色的访问控制、会话管理）；文件存储（上传流程、URL 生成、带进度客户端上传、文件展示与管理）。技能按模块组织在 modules/ 下的 reactive-queries.md、server-functions.md、auth-integration.md、file-storage.md。使用方式：用 npm create convex@latest 初始化项目，用 npx convex dev 启动开发服务器；可用 mcp__context7__resolve-library-id 解析 "convex" 库 ID，再用 mcp__context7__get-library-docs 获取最新文档。项目含 convex 目录（_generated、schema.ts、functions 子目录、可选 http.ts 与 crons.ts）及 src 下的 ConvexProvider.tsx。最佳实践：为所有过滤查询建索引，大数据量用分页查询，全文检索用搜索索引；mutation 保持聚焦原子，多步操作用内部 mutation，用 v 模块校验输入并始终检查授权；用 ConvexError 处理错误，加载期处理 undefined，处理乐观更新回滚。限制：资料未提供收费、价格与具体平台细节，暂未提供。