用途
convex-crons 是一个用于 Convex 应用的技能,作用是向应用中添加周期性定时任务(crons)。它适用于需要在后端按固定周期自动执行任务的场景,例如定期维护、清理或后台作业。
主要能力
- 指导在 convex/crons.ts 中使用 cronJobs() 定义重复执行的任务。
- 调度内部函数(internal.),而不是公开 API(api.)。
- 要求为任务设置合理的执行间隔。
- 强调处理函数保持幂等,即重复运行也安全。
- 建议保持每次 cron 处理函数的运行逻辑小而精简。
使用方式
该技能给出的工作流程为:
- 创建 convex/crons.ts,使用 cronJobs()。
- 按正确的间隔调度内部函数(绝不要调度公开的 api.*)。
- 使处理函数幂等(可安全重复运行);保持每次运行的任务量小。
- 验证该任务是否出现在仪表盘的 schedule 中。
规则
- 调度 internal.* 函数,绝不调度 api.*。
- 保持 cron 处理函数小而幂等。
- 不要对订阅可以推送的内容使用高频间隔轮询。
适用场景
适用于需要在 Convex 后端添加周期性定时任务的开发场景,帮助避免调度公开 API、编写非幂等处理函数或用轮询替代订阅推送等常见问题。
限制
当前资料未提供更多关于平台支持范围、版本要求或收费方式的信息,暂未提供。