用途:为 Convex 项目提供“版本对齐”的文档新鲜度层。插件的既有知识适合稳定用法,但组件新增导出、CLI 参数变化、API 改名等容易过时之处需要实时核对,此能力即用于这些场景。
工作流:
- 锁定版本:读取实际安装的 convex 版本(如 node -p "require('./node_modules/convex/package.json').version" 或 package.json),以及相关 @convex-dev/* 组件版本;所信任的文档必须与这些版本一致,版本错配是错误 Convex 代码的最大来源。
- 新鲜度优先级(从成本最低且正确开始):a) 若有已提供的文档工具或 MCP 的 search_convex_docs,优先使用;b) 否则以 markdown 形式请求具体文档页(docs.convex.dev/<path>,站点支持 .md/markdown 时优先),或读取锁定版本下的组件 README;c) 最后才回退到通用网络搜索,并将其版本视为未经验证。
- 必要时用已安装包验证:对不确定是否存在的组件导出,检查 node_modules/@convex-dev/<x>/ 的 package.json exports 与 .d.ts,安装类型是当前版本的权威依据,优先于任何文档页。
- 窄幅使用获取到的事实:套用当前签名或参数,标注来源(页面与版本),把具体写法交回 convex-expert 以惯用风格落地。convex-docs 提供新鲜事实,convex-expert 提供惯用写法。
规则与限制:当新鲜度存疑时,不要凭模型记忆编写不熟悉或可能已改名的 Convex/组件 API;遵循上述新鲜度层级,优先 markdown 而非 HTML 以减少 token;版本不匹配的构建错误应视为新鲜度问题,重新锁定版本并抓取当前 API,而不是猜测其他拼写。本能力是新鲜度补充层,不替代既有知识。资料未提供具体支持的命令行参数、定价或平台范围。