用途:antdv 是 @antdv-next/cli 提供的本地 CLI,内置 antdv-next 当前最新版本的组件元数据,用于查询组件知识、分析项目、指导迁移,数据离线、无需联网。
主要能力:查询组件 props/事件/插槽/语义类名/设计令牌与完整文档;获取可运行示例;查看整体设计语言;扫描项目组件使用统计与最佳实践违规;对比版本间 API 变化;收集环境快照;预览并提交 antdv-next 或 CLI 缺陷报告;升级 CLI;作为 MCP 服务器暴露知识查询工具。
使用方式:首次使用前检查是否安装,未安装则执行 which antdv || npm install -g @antdv-next/cli。命令建议加 --format json 便于解析,如 antdv info Button --format json、antdv demo Button basic --format json、antdv doc Table --lang zh、antdv env --format json、antdv lint ./src --format json、antdv changelog 1.2.2 1.5.2 Select --format json、antdv list --format json、antdv upgrade。若输出含 Update available 提示,先运行 antdv upgrade。作为 MCP 服务器时配置 command 为 antdv、args 为 mcp --version 1.5.0,提供 8 个工具与 2 个提示。
适用场景:编写或调试 antdv-next 组件代码、排查项目配置问题、分析组件使用情况、评估版本升级、准备缺陷报告。
限制:知识查询支持 antdv-next v1.x;建议先查询再写代码,按用户版本核对 API,改动后运行 lint;提交缺陷前需预览并获用户确认;设置环境变量 ANTDV_NO_AUTO_REPORT=1 可跳过自动报告建议。具体收费与平台支持范围暂未提供。