SuperAPI AI 工具集

convex-advisor

部署与运维

查看项目

更新于 10-16 03:06

技能介绍

用途:针对 Convex 实际部署做健康、性能与成本诊断。它读取官方 Convex MCP 的 insights 工具返回的 72 小时事件,包括 documentsReadLimit/bytesReadLimit(触及硬限制)、documentsReadThreshold/bytesReadThreshold(接近限制)、occFailedPermanently/occRetried(写入争用),事件自带表名、读取字节数、文档数与 OCC 文档 ID、重试次数等证据。

主要能力:先通过 status、insights、tables、functionSpec 采集部署状态、事件、表结构与函数表面;再读取被标记函数的实际代码做根因定位,例如 .collect()、未走索引的 .filter()、缺少分页,或对同一文档的读改写热点(共享计数器、状态开关)。建议的修复包括加索引配合 .withIndex、.take(n)、.paginate,计数场景用聚合组件;OCC 争用可用 @convex-dev/sharded-counter、收窄读取集或移入 workpool。最终按 specs/finding.schema.json 输出发现项,含类别、严重度、位置、原始事件证据与置信度,并按严重度排序报告。

使用方式:先执行 deploy-guard 的步骤 0–1,确认并声明所读部署;顾问流程只读,不会改动部署,也不会开启生产变更开关。insights 工具仅限已登录用户的云端 dev/prod 部署,预览或按 deploy-key 授权的上下文不可用,且需要约 72 小时流量;若无数据或不可用,应如实说明并改推荐 convex-reviewer,不得编造发现。修复仅在用户确认后应用,之后需重新观察流量或重跑静态检查验证趋势。

限制:仅覆盖性能、成本与健康;授权问题转交 convex-authz,代码风格转交 convex-reviewer,错误分诊转交 sentinel。所有结论必须引用真实事件、日志或表统计,运行时事件视为已确认事实。严重度按事件类型确定:触及限制或永久 OCC 失败为高,阈值为中。具体安装命令与价格信息暂未提供。