SuperAPI AI 工具集

function-creator

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:在 Convex 后端中创建新的查询、变更和动作函数,并新增 API 端点,按最佳实践生成安全、类型安全的函数。\n\n主要能力与函数类型:查询(只读,运行于事务、结果可缓存并可响应式更新,不能改数据或调用外部 API);变更(可在 ACID 事务中读写数据库,不能调用外部 API);动作(可调用外部 API 如 fetch、AI,可通过 ctx.runMutation 调用变更,不能直接访问数据库;需要 Node.js API 时在文件顶部加 "use node")。查询与变更应放在不含 "use node" 的文件中,需要 Node.js 的动作放单独文件。\n\n必需组件:用校验器定义 args;定义 returns 校验返回类型;公开函数中调用 ctx.auth.getUserIdentity() 并做认证检查;做所有权/权限授权检查;await 所有 Promise;使用带索引的查询而非 .filter();提供描述性错误信息;定时函数调用使用 internal.* 而非 api.*;使用 Node.js API 时文件顶部加 "use node",且该文件只能含动作。此外可为后端内部函数使用 internalMutation 等内部函数。\n\n限制与说明:资料未提供安装命令、具体平台定价、版本兼容或性能数据,这些暂未提供。