更新日志#
6.4.4 (2026-06-12)#
新功能#
- 新增
antd design.md命令,输出 antd 设计语言规范(颜色、字体、间距、圆角及设计原则),兼容 design.md 格式,可被 Figma Make、Stitch 等 AI 设计工具直接使用,同时提供antd_design_mdMCP tool (#147, ant-design#57701) - 新增
antd upgrade命令,在终端内一键升级 CLI 到最新版本 (#123) - 所有命令新增
--format markdown输出格式和--lang zh中文显示支持 (#146) antd info输出中新增所有组件通用属性(className/style/rootClassName)的说明 (#139)
Bug 修复#
- 修复未安装 antd 时版本自动检测错误回退到 v5 而非最新 v6 的问题 (#150)
antd mcp在终端中直接运行时现在会显示友好提示,不再静默挂起 (#154)- 修复部分组件(仅有子组件属性的组件)在
antd info中无法正常显示的问题 (#152) - 修复 v5/v6 中部分组件的属性元数据和 Token 数据缺失或格式错误的问题 (#138, #132, #122, #125)
- 修复 Markdown 表格输出中特殊字符转义不正确的问题 (#136)
- 修复传入无效的
--format或--lang值时被静默忽略而未报错的问题 (#141) - 修复版本解析、
antd upgrade版本比较和antd semantic --lang zh崩溃等问题 (#127)
安全#
其他变更#
- 排除 skills 的 node_modules,减小包体积 (#144)
- 新增 Codex 及 OpenAI Agents 支持 (#151)
- 提升数据同步流程的稳定性 (#155, #156, #135, #133)
- 升级依赖 (#149, #148, #130, #119, #117)
- 同步 antd 元数据至 v6.4.4 (diff)
6.4.3 (2026-05-18)#
Bug 修复#
- 修复异步
postAction钩子未被正确等待的问题 — 使用parseAsync()替代同步parse()(#113) - 修复 semver OR 范围(
||)在 peerDependency 检查中的误报以及^0.x次版本锁定行为不正确的问题,改用semver包替换手写解析 (#109) - 修复表格输出中 CJK 字符宽度导致的列对齐问题(如
antd list --lang zh),使用string-width处理 (#109) - 修复
compare()对 null/undefined 输入返回错误结果的问题 (#111)
其他变更#
- 使用
fast-levenshtein和fast-glob包替换手写的 Levenshtein 距离计算和递归目录遍历 (#109) - 提取公共
fetchWithTimeout和fetchFirstJson辅助函数,消除重复的 HTTP 请求模式 (#109) - 同步内置的 antd CLI Skill 文件至当前命令集 (#114)
- 清理 7 个过时的 v6 快照并防止再次积累,包体积减少约 4.3 MB(29.6 MB → 25.3 MB) (#107)
- 将 e2e 测试改为进程内执行以提升性能 (#112)
- 测试覆盖率达到 100% 的行、语句和函数覆盖 (#115, #116)
- 同步 antd 元数据 (v6@6.4.3)
6.4.2 (2026-05-14)#
- 同步 antd 元数据 (v6@6.4.2)
6.4.1 (2026-05-14)#
- 同步 antd 元数据 (v6@6.4.1)
6.4.0 (2026-05-14)#
新功能#
doctor命令新增已知 Bug 检查,会检测当前安装的 antd 版本是否存在已知问题并显示相关 Issue 链接 (#89)
Bug 修复#
- 修复
Checkbox.Group/Radio.Group内 lint 误报 —Checkbox.Group内的value属性和Radio.Group内的optionType属性不再被错误警告 (#93, closes #91) - 修复 lint 性能规则误判 locale 默认导入(如
import enUS from 'antd/locale/en_US')为通配符导入,并改进建议信息使用实际组件名而非固定显示Button(#104, closes #99, #101)
其他变更#
- 重构更新检查逻辑,并发查询多个来源以加快版本检测 (#89)
- 同步 antd 元数据 (v6@6.4.0)
- 配置 Dependabot 分组更新及 npm 生态系统 (#102)
- 升级依赖并修复安全告警 (#103, #105)
6.3.7 (2026-04-27)#
- 同步 antd 元数据 (v4@4.24.16, v5@5.29.3, v6@6.3.7)
6.3.6 (2026-04-17)#
新功能#
- 新增 antd v3 支持 —
antd list、antd info、antd doc、antd demo、antd migrate 3 4现可用于 v3 项目 (#77) antd lint新增--antd-alias参数,支持识别二次封装的 import 来源 (#81)antd env增强为完整的环境信息输出 (#75)- MCP 工具新增 annotations,改善 IDE 集成体验 (#79)
Bug 修复#
- 修复
antd token在无组件 token 时输出纯文本而非有效 JSON 的问题 (#80) - 修复同步工作流无法检测 antd 新版本的问题 (#83)
- 修复 AI 助手主动建议提交 Bug 报告的问题;Bug 报告改为仅用户主动触发,新增
ANTD_NO_AUTO_REPORT=1环境变量可完全关闭提示 (#85, closes #82)
其他变更#
6.3.5#
新功能#
- 新增
antd env命令 — 输出完整的环境快照,包括 Node.js、操作系统、浏览器、antd 版本、包管理器和构建工具,方便提交 Bug 报告或为 AI Agent 提供上下文
Bug 修复#
- 修复
antd lint报告的行号始终为 0 的问题 (#65)
其他变更#
6.3.5-beta.0 (2026-03-25)#
新功能#
- 新增
antd mcp命令 — 提供 7 个工具和 2 个提示词的 MCP 服务器,支持 IDE 集成 (#38)
Bug 修复#
- 修复使用
-V时不触发更新检查的问题 (#42) - 重写 lint 规则,基于 oxc-parser AST 分析 (#40)
- 修复废弃属性规则对无关组件的误报 (#36)
其他变更#
- 重构:从 7 个命令模块中提取核心函数 (#38)
- 将 JSON 数据保留在 git 中,通过 .npmignore 排除 (#41)
- CI:新增 npm 包体积检测和 badge (#39)
- 更新 Skill 文件,指导 Code Agent 在出现更新提示时自动更新 CLI (#42)
6.3.4 (2026-03-24)#
Bug 修复#
- 修复 info 命令输出缺少 nameZh 和 since 字段的问题 (#5)
- 修复 token 命令 globalTokens 缺少 name 字段的问题 (#10)
其他变更#
- 同步 antd 元数据 (v4@4.24.16, v5@5.29.3, v6@6.3.4)
- CI:切换到 GitHub Actions OIDC 发布 (#7)
- CI:迁移到 semantic-release 自动版本管理 (#14)
- 简化同步工作流 (#11)
- 移除未使用的 sample-data 目录 (#12)
6.3.3 (2026-03-24)#
@ant-design/cli 首个版本发布。面向 AI 编程助手(Claude Code、Cursor、Copilot 等)的 Ant Design 命令行工具,支持组件知识查询与项目分析,提供结构化输出。
📚 知识查询#
antd list— 列出所有 antd 组件,展示双语名称、描述和分类antd info <Component>— 查询组件 API,包括 Props、类型、默认值;--detail获取完整文档、方法和 FAQantd doc <Component>— 输出完整的组件 API 文档(Markdown 格式)antd demo <Component> [name]— 获取组件示例源码,可直接运行antd token [component]— 查询全局和组件级 Design Token(v5+)antd semantic <Component>— 展示组件classNames和styles语义化定制结构antd changelog [v1] [v2] [component]— 查看更新日志或对比跨版本 API 差异
🔍 项目分析#
antd doctor— 诊断项目配置问题(React 兼容性、重复安装、主题配置、SSR 等 10 项检查)antd usage [dir]— 扫描项目文件,统计组件使用情况、子组件分布和非组件导出antd lint [file/dir]— 检查 antd 使用最佳实践(废弃 API、无障碍、性能、编码规范)antd migrate <from> <to>— 版本迁移指南,包含破坏性变更、代码示例和自动修复支持
🐛 问题反馈#
antd bug— 向 ant-design/ant-design 报告 Bug,自动收集环境信息antd bug-cli— 向 ant-design/ant-design-cli 报告 Bug
✨ 亮点#
- 🧩 14 条命令,覆盖知识查询、项目分析和问题反馈
- 📦 内置 antd v4 /v5 /v6 全版本元数据,完全离线运行
- 🎯 按小版本快照存储,精确匹配任意 antd 版本的 API 数据
- 🔄 自动检测项目 antd 版本(
node_modules→package.json→ 回退默认) - 🤖 所有命令支持
--format json|text|markdown和--lang en|zh双语输出 - 🔮 基于 Levenshtein 距离的模糊匹配,输入错误时提供「你是不是想找?」建议
- 🔀 跨大版本 API 对比,支持智能重命名检测
- 🔗 内置 Skill 文件,一键集成到各类 Code Agent
- 🛡️ 标准错误格式,包含错误码和可操作的修复建议