SuperAPI AI 工具集

convex-advisor

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:对 Convex 线上部署做健康、性能与成本诊断。静态审查只能猜,部署本身知道答案——该技能通过官方 Convex MCP 的 insights 工具获取每个函数的 72 小时健康事件,再把事件落到具体代码上完成根因分析。

主要能力:读取 typed 事件,包括 documentsReadLimit / bytesReadLimit(触达硬限额)、documentsReadThreshold / bytesReadThreshold(接近限额)、occFailedPermanently / occRetried(写入争用),每条事件带证据,如 table_name、bytes_read、documents_read、OCC 文档 id 与重试次数;读取被标记函数的实际代码完成根因定位,并按 specs/finding.schema.json 输出 finding,便于后续派发修复与评估上线就绪度。

典型工作流:先执行 deploy-guard 第 0-1 步,确认并声明所读部署;生产环境只允许只读访问,不得开启可变写权限。随后确定性采集:status 选部署、insights 取 72 小时事件、tables 取 schema 与行数、functionSpec 取公开/内部接口。逐条根因:读限额类事件对应 .collect()、无索引 .filter()、缺分页,可用索引 + .withIndex、.take(n) 或 .paginate,计数场景可用 aggregate 组件;OCC 类对应共享计数器等读改写热点,可用 @convex-dev/sharded-counter、收窄读取集或迁到 workpool;日志中反复失败则归类为 cron 崩溃循环、validator 拒绝或未处理错误。输出 finding 时给出类别、严重级别、位置与原始事件证据,report 按严重度排序,列运行时证据、带 file:line 的代码根因和具体修复,确认后才应用,再用最新流量重跑 insights 验证趋势。

限制:insights 工具仅在登录个人账号的云 dev/prod 部署可用,preview 或 deploy-key 受限环境不可用,且需要约 72 小时流量;无数据或不可用时应如实说明并回退到 convex-reviewer,不得编造发现。该技能仅做健康/性能/成本,鉴权问题交给 convex-authz,代码风格交给 convex-reviewer,错误分诊交给 sentinel;运行期事件视为事实,置信度为 confirmed。具体安装方式与价格资料暂未提供。