用途:帮助代理在本地代码库中定位 Vendure 问题的原因,适用于服务器或 worker 无法启动、迁移失败或待执行、@vendure/* 版本不一致、插件不兼容、资源上传与预览异常、邮件未发送或渲染错误、升级到 3.x 次版本后出错等场景。基于开源 Vendure 包与 Vendure CLI(@vendure/cli),无需 Vendure Console 账号或付费计划。
主要能力:按症状匹配支持案例文件,包括 cases/startup.md、cases/migrations.md、cases/version-mismatch.md、cases/assets.md、cases/email.md、cases/upgrade.md。先按 context.md 收集上下文,只读取文件并做静态检查,不启动应用、不连接数据库。按案例文件给定顺序执行检查,找到原因即停止。
使用方式:构建 CLI 命令可参考 vendure-cli 技能,按其说明使用项目包管理器(bunx、pnpm exec、yarn、npx)运行。需要修改文件、依赖或数据库的补救措施,须经用户批准后执行;每个补救措施对应一个 CLI 命令或文档页。案例文件无法回答时,可查询 Vendure 文档 MCP(https://docs.vendure.io/mcp)。search_docs 与 get_doc_page 为公开工具,无需登录;get_vendure_workflow 与 get_vendure_pattern 需要登录 Vendure Console 并关联 Project,可先运行 vendure auth login,再在项目中运行 vendure console link(写入 .vendure/project.json),无 Project 时可在 https://console.vendure.io 免费创建。未关联项目也可正常使用公开工具与本技能。
限制:不得读取或发送密钥,不得打开 .env、凭据文件、除 project.json 外的 .vendure/ 文件或 CLI 登录文件 auth.json;不得查询数据库或复制数据库内容;仅在用户提供日志时读取日志。上下文仅随请求发送,不存储、不上传,不写入项目文件。无法从文件识别插件或版本时写“unknown”并说明原因,不得猜测。不要启动长时间运行进程(如 vendure dev、vendure start),应请用户启动或提供启动输出。本技能不涵盖商业 Vendure Platform 包,也不得建议购买作为补救措施。