当一段 Convex 后端逻辑需要拥有自己的表、函数和持久化流程,或者未来要在多个应用复用时,convex-create-component 帮你把它做成边界清楚的组件。一次性业务逻辑和不需要数据库的普通工具,不必套这个结构。
先决定组件是只服务当前应用,还是要打包共享;默认可以从本地组件开始。组件自己拥有 `convex.config.ts`、`schema.ts` 和函数文件,函数从组件自己的 `_generated/server` 导入;应用通过 `app.use(...)` 安装,再用 `components.<name>` 调用。认证和环境变量留在应用侧,经过边界的父表 ID 用字符串传入。
需要给 React 或公开 API 使用时,在应用里写 wrapper,不要直接暴露组件函数。查询字段建索引,不要查完再 filter;公共函数补齐 args 和 returns 校验。最后按 codegen、codegen 全局、`npx convex dev` 的顺序验证,遇到登录或部署配置缺失就停在具体阻塞点。