SuperAPI AI 工具集

convex-crons

编程与开发

查看项目

更新于 10-16 16:04

技能介绍

用途

convex-crons 是一个用于 Convex 应用的技能,作用是向应用中添加周期性定时任务(crons)。它适用于需要在后端按固定周期自动执行任务的场景,例如定期维护、清理或后台作业。

主要能力

  • 指导在 convex/crons.ts 中使用 cronJobs() 定义重复执行的任务。
  • 调度内部函数(internal.),而不是公开 API(api.)。
  • 要求为任务设置合理的执行间隔。
  • 强调处理函数保持幂等,即重复运行也安全。
  • 建议保持每次 cron 处理函数的运行逻辑小而精简。

使用方式

该技能给出的工作流程为:

  1. 创建 convex/crons.ts,使用 cronJobs()。
  2. 按正确的间隔调度内部函数(绝不要调度公开的 api.*)。
  3. 使处理函数幂等(可安全重复运行);保持每次运行的任务量小。
  4. 验证该任务是否出现在仪表盘的 schedule 中。

规则

  • 调度 internal.* 函数,绝不调度 api.*。
  • 保持 cron 处理函数小而幂等。
  • 不要对订阅可以推送的内容使用高频间隔轮询。

适用场景

适用于需要在 Convex 后端添加周期性定时任务的开发场景,帮助避免调度公开 API、编写非幂等处理函数或用轮询替代订阅推送等常见问题。

限制

当前资料未提供更多关于平台支持范围、版本要求或收费方式的信息,暂未提供。