用途:该指南介绍 Convex 官方工具库 convex-helpers,帮助开发者在 Convex 后端复用常见模式与工具,避免重复造轮子。
主要能力:关系助手(getOneFrom、getManyFrom、getManyVia)用于类型安全地跨表加载关联数据;自定义函数(customQuery/customMutation)是官方推荐的数据保护方式,用于给所有函数自动注入鉴权和访问控制,支持多租户与 RBAC;filter 助手在 TypeScript 中执行复杂过滤;sessions 支持未登录/匿名用户跟踪;Zod 校验可用 Zod schema 替代 Convex 校验器;还提供 RLS 风格助手(官方更推荐自定义函数),以及 migrations、triggers、aggregation 等。
使用方式:先执行 npm install convex-helpers,再按需从对应路径导入子模块,如 convex-helpers/server/relationships、convex-helpers/server/customFunctions、convex-helpers/server/filter、convex-helpers/react/sessions、convex-helpers/server/zod、convex-helpers/server/migrations、convex-helpers/server/triggers。迁移可通过 npx convex run migrations:addDefaultPriority 运行。
限制与注意:文档建议优先使用索引而非 filter,filter 仅适合复杂逻辑或小结果集;对数据保护,官方推荐自定义函数而非 RLS 风格助手;使用前需确认项目中各模块的可用性与版本兼容性,本资料未提供定价、平台或性能数据。