用途：把 Convex 部署运行时的 72 小时 insights 事件翻译成有代码依据的性能/成本结论。静态审查靠猜测，部署本身知道真相，本工具据此逐条根因分析。
主要能力：通过官方 Convex MCP 采集 status（部署选择器）、insights（带类型的 72 小时事件）、tables（schema 与行数）、functionSpec（公开/内部接口）。事件类型包括 documentsReadLimit/bytesReadLimit（触顶）、documentsReadThreshold/bytesReadThreshold（接近）、occFailedPermanently/occRetried（写争用），每条带 table_name、bytes_read、documents_read、occ 文档 id 与重试次数等证据。每个事件都到被标记函数的实际代码中定位根因，并按 specs/finding.schema.json 输出发现（class、severity、locus、evidence、confidence、fixCapability、autofixable）。
典型根因与修复方向：读阈值/上限事件常对应 .collect()、未走索引的 .filter() 或缺分页，修复为索引加 .withIndex、.take(n) 或 .paginate，计数场景可用 aggregate 组件；OCC 重试/永久失败常对应某文档的读改写热点（共享计数器、状态切换），可用 @convex-dev/sharded-counter、收窄读取集或迁移到 workpool；日志中反复失败（status: failure）则归类为 cron 崩溃循环、validator 拒绝或未处理错误形态。
使用方式：遵守 deploy-guard 第 0-1 步，先识别并声明所读取的部署；insights 仅在以用户身份登录云 dev/prod 部署时可用（不支持 preview 或 deploy-key 范围），且需约 72 小时流量，否则应说明并改推 convex-reviewer，不得编造发现。insights 仅只读；顾问流程绝不修改部署，也不开启生产变更开关。按严重度排序报告，每条给出运行时证据一行、代码级根因（file:line）、具体修复与适用能力；仅在确认后应用修复，之后重跑 insights 验证趋势或立即重跑静态检查。
严重度：触顶/永久 OCC 失败为高，阈值/重试为中。范围仅限性能、成本与健康；鉴权交 convex-authz，代码风格交 convex-reviewer，错误分诊交 sentinel，只发出指针型发现而不重复其工作。
限制：依赖官方 MCP、登录用户身份与足够的 72 小时流量；无证据时不给结论。具体安装命令、收费与价格信息暂未提供。