用途:在 Convex 项目开发中,当检测到用户代码或需求重复实现了已有 Convex 组件功能时,主动提示更合适的组件,减少重复造轮子。
主要能力:通过匹配检测规则识别常见模式,例如邮件/SMTP 对应 resend、推送通知对应 expo-push、setInterval/cron 对应 @convex-dev/crons、并发自增计数对应 @convex-dev/sharded-counter、.collect().length 扫描对应 @convex-dev/aggregate、多步骤长任务对应 @convex-dev/workflow、受限并发对应 @convex-dev/workpool、数据库限流计数对应 @convex-dev/rate-limiter、文件写入/S3 上传对应 Convex Storage、Elasticsearch/Algolia 对应内置全文搜索、在线状态/输入中对应 @convex-dev/presence、Pinecone/外部向量库对应 @convex-dev/rag、协同编辑对应 @convex-dev/prosemirror-sync。
使用方式:被动观察 codeSnippets 与用户需求,不打断当前任务;完成当前任务后只给出一个建议,说明组件名、引用触发它的具体代码或表述、解释为何更合适。用户同意后运行 /add <component> 或按检测器给出的 installHint 安装。用户拒绝或忽略则放弃,不重复同一建议。
限制:一次只建议一个组件,除非用户主动要求;不得在未获明确同意时安装;不对已安装组件重复建议;不对与 Convex 无关的通用编程问题(如数组排序、写 CSS)触发。具体检测规则见 generators/suggest-detector.mjs,其余安装细节以官方资料为准。