用途:在修改 Convex 应用前快速、准确地生成架构地图,避免逐一通读大量函数文件。它读取两类可靠来源:schema(数据模型)与函数表面(functionSpec 或导出的 query/mutation/action)。定位为描述性技能,只说明代码实际呈现的内容,不做审计或修改。
主要能力:\n1. 检测应用:识别 convex/ 目录、schema.ts,以及是否存在部署;有部署时经官方 MCP 读取 functionSpec/tables 作为权威实时表面,否则直接读源码。任何部署读取均为只读。\n2. 数据模型:列出每个表及其字段,重点说明关系,即 v.id("other") 指向哪里、存在哪些索引,并用文字描述外键图。\n3. 函数表面:枚举所有导出函数,分为公开(query/mutation/action)与内部(internalQuery 等),每个给出一行说明其行为与所触及数据。\n4. 认证/归属模型:说明身份如何建立、归属如何校验,并明确指出是否存在认证基础,但不做漏洞审计。\n5. 组件与外部边界:列出已安装的 @convex-dev/* 组件、HTTP 路由、定时任务及 actions 中的外部调用与环境变量。\n6. 流程追踪:选取一到两条代表性端到端路径,串联客户端调用、校验、写入与读回。
使用方式:作为优化或自愈会话的第一步,或用于重新解释当前架构;输出为可扫描的地图,按数据模型、公开/内部函数、认证模型、组件与边界、流程的顺序呈现。结尾会指向后续动作,如审计、评分或扩展。
限制:只读,不修改应用;不评估安全性或质量;不臆测代码未展示的行为,遇到歧义会明确说明而非猜测。官方未提供具体收费、价格、平台支持或安装命令等信息。