Documents
CHANGELOG.zh-CN
CHANGELOG.zh-CN
Type
External
Status
Published
Created
Jun 12, 2026
Updated
Jun 15, 2026
Updated by
Dosu Bot
Source
View

更新日志#

6.4.4 (2026-06-12)#

新功能#

  • 新增 antd design.md 命令,输出 antd 设计语言规范(颜色、字体、间距、圆角及设计原则),兼容 design.md 格式,可被 Figma Make、Stitch 等 AI 设计工具直接使用,同时提供 antd_design_md MCP 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)

安全#

  • 修复构建脚本中潜在的命令注入风险 (#137, #134)
  • 升级 qs 至 6.15.2,修复 CVE-2026-8723 安全漏洞 (#121)

其他变更#

  • 排除 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-levenshteinfast-glob 包替换手写的 Levenshtein 距离计算和递归目录遍历 (#109)
  • 提取公共 fetchWithTimeoutfetchFirstJson 辅助函数,消除重复的 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)#

6.4.1 (2026-05-14)#

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)#

6.3.6 (2026-04-17)#

新功能#

  • 新增 antd v3 支持 — antd listantd infoantd docantd demoantd 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)

其他变更#

  • 同步 antd 元数据 (v6@6.3.6)
  • 最低 Node.js 版本要求提升至 20(Commander v14 兼容性) (#76)

6.3.5#

新功能#

  • 新增 antd env 命令 — 输出完整的环境快照,包括 Node.js、操作系统、浏览器、antd 版本、包管理器和构建工具,方便提交 Bug 报告或为 AI Agent 提供上下文

Bug 修复#

  • 修复 antd lint 报告的行号始终为 0 的问题 (#65)

其他变更#

  • 同步 antd 元数据 (v6@6.3.5)
  • 将所有依赖打包进 dist,安装后 node_modules 中不再出现 180+ 个传递依赖 (#64)

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 获取完整文档、方法和 FAQ
  • antd doc <Component> — 输出完整的组件 API 文档(Markdown 格式)
  • antd demo <Component> [name] — 获取组件示例源码,可直接运行
  • antd token [component] — 查询全局和组件级 Design Token(v5+)
  • antd semantic <Component> — 展示组件 classNamesstyles 语义化定制结构
  • 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_modulespackage.json → 回退默认)
  • 🤖 所有命令支持 --format json|text|markdown--lang en|zh 双语输出
  • 🔮 基于 Levenshtein 距离的模糊匹配,输入错误时提供「你是不是想找?」建议
  • 🔀 跨大版本 API 对比,支持智能重命名检测
  • 🔗 内置 Skill 文件,一键集成到各类 Code Agent
  • 🛡️ 标准错误格式,包含错误码和可操作的修复建议