Changelog#

6.6.7 (2026-10-20)#

• Update antd metadata (v6@6.6.7)

6.6.6 (2026-10-12)#

• Update antd metadata (v6@6.6.6)

6.6.5 (2026-09-20)#

• Update antd metadata (v6@6.6.5)

6.6.4 (2026-09-14)#

• Update antd metadata (v6@6.6.4)

6.6.3 (2026-09-07)#

• Update antd metadata (v6@6.6.3)

6.6.2 (2026-08-28)#

• Update antd metadata (v6@6.6.2)

6.6.1 (2026-08-17)#

• Update antd metadata (v6@6.6.1)

6.6.0 (2026-08-10)#

Security#

• Resolve the remaining dependency security alerts by upgrading @modelcontextprotocol/sdk, @hono/node-server, postcss, and body-parser (#208)

Other Changes#

• Update antd metadata (v6@6.6.0)

安全#

• 升级 @modelcontextprotocol/sdk、@hono/node-server、postcss 和 body-parser，修复剩余的依赖安全告警 (#208)

其他变更#

• 同步 antd 元数据 (v6@6.6.0)

6.5.4 (2026-08-07)#

Other Changes#

• Update antd metadata (v6@6.5.4)

其他变更#

• 同步 antd 元数据 (v6@6.5.4)

6.5.3 (2026-07-31)#

Security#

• Upgrade fast-uri from 3.1.2 to 3.1.4 to include its latest security fixes (#206)

Other Changes#

• Upgrade hono from 4.12.26 to 4.12.32 (#207)
• Update antd metadata (v6@6.5.3)

安全#

• 将 fast-uri 从 3.1.2 升级至 3.1.4，纳入最新安全修复 (#206)

其他变更#

• 将 hono 从 4.12.26 升级至 4.12.32 (#207)
• 同步 antd 元数据 (v6@6.5.3)

6.5.2 (2026-07-24)#

Documentation#

• Expand the v6.5.0 and v6.5.1 release notes and align the English and Chinese changelogs (#202)

Other Changes#

• Update antd metadata (v6@6.5.2)

文档#

• 补充 v6.5.0 和 v6.5.1 发布说明，并对齐中英文 changelog (#202)

其他变更#

• 同步 antd 元数据 (v6@6.5.2)

6.5.1 (2026-07-13)#

Features#

• Add a branded banner to the root help output (#184)
• Add antd lint --diff [base] and --staged, report skipped files, and cover Ant Design v5 usage patterns (#188, #189, #192)
• Extend antd setup with GitHub Actions CI configuration (#190)

Bug Fixes#

• Ignore non-JavaScript asset imports in the lint performance rule (#186)
• Preserve historical metadata, dotted semantic keys, prerelease ordering, and a bounded metadata cache (#194, #195, #198, #199)
• Improve changelog extraction by preserving emoji and ownership, avoiding guessed prop renames, and validating inferred component names (#196, #197, #201)

Security#

• Prevent shell injection in release tag handling while keeping sync commands portable on Windows (#193)

Other Changes#

• Allow package-size reporting to continue when GitHub comment permissions are unavailable (#187)
• Bump dependencies (#183, #191)
• Update antd metadata (v6@6.5.1)

新功能#

• 为根帮助信息新增品牌化 Banner (#184)
• 新增 antd lint --diff [base] 和 --staged，报告跳过的文件，并覆盖 Ant Design v5 使用规则 (#188, #189, #192)
• 扩展 antd setup，支持配置 GitHub Actions CI (#190)

Bug 修复#

• lint 性能规则不再误报非 JavaScript 资源导入 (#186)
• 保留历史元数据、点号语义键和预发布版本顺序，并限制元数据缓存大小 (#194, #195, #198, #199)
• 改进 changelog 提取，保留 emoji 与归属关系，不再猜测属性重命名，并校验推断出的组件名 (#196, #197, #201)

安全#

• 防止发布 tag 处理中的 shell 注入，同时保持同步命令在 Windows 上可用 (#193)

其他变更#

• GitHub 评论权限不可用时，包体积报告流程仍可继续 (#187)
• 升级依赖 (#183, #191)
• 同步 antd 元数据 (v6@6.5.1)

6.5.0 (2026-06-27)#

Documentation#

• Expand the v6.4.5 release notes (#181)

Other Changes#

• Update antd metadata (v6@6.5.0)

文档#

• 补充 v6.4.5 发布说明 (#181)

其他变更#

• 同步 antd 元数据 (v6@6.5.0)

6.4.5 (2026-06-22)#

Features#

• New antd setup command for initializing Ant Design projects and configuration (#165)
• antd migrate can now scan a directory and generate targeted migration prompts from actual usage (#159)

Bug Fixes#

• Fix sync release authentication and recovery paths so missing or failed publish artifacts are detected and repaired reliably (#180, #179, #178, #177, #176)
• Harden the sync workflow against missing release tags, corrupted version indexes, stale token metadata, and data-only sync changes (#174, #173, #172, #171, #170, #169, #168)
• Keep doctor bug checks offline so tests and normal runs do not make network calls (#164)
• Count antd subpath default imports in usage analysis (#163)
• Avoid stack traces for invalid global options (#162)

Security#

• Resolve Dependabot security alerts (#167)

Other Changes#

• Bump dependencies (#175, #160, #157)
• Keep update-check cache tests safely mocked (#161)
• Add Chinese release notes for v6.4.4 (#158)
• Update antd metadata (v6@6.4.5)

新功能#

• 新增 antd setup 命令，用于初始化 Ant Design 项目和相关配置 (#165)
• antd migrate 现在可以扫描目录，并基于实际使用情况生成更有针对性的迁移提示词 (#159)

Bug 修复#

• 修复同步发布流程的鉴权与恢复路径，确保缺失或失败的发布产物能被可靠检测和修复 (#180, #179, #178, #177, #176)
• 增强同步流程，覆盖 release tag 缺失、版本索引损坏、Token 元数据过期和纯数据同步变更等场景 (#174, #173, #172, #171, #170, #169, #168)
• 保持 doctor bug 检查离线执行，避免测试和普通运行触发网络请求 (#164)
• usage 分析现在会统计 antd 子路径的默认导入 (#163)
• 传入无效全局选项时不再输出堆栈信息 (#162)

安全#

• 修复 Dependabot 安全告警 (#167)

其他变更#

• 升级依赖 (#175, #160, #157)
• 保持升级检查缓存相关测试使用安全 mock (#161)
• 为 v6.4.4 补充中文发布说明 (#158)
• 同步 antd 元数据 (v6@6.4.5)

6.4.4 (2026-06-12)#

Features#

• New antd design.md command — outputs antd's design language specification (colors, typography, spacing, radius, and design principles) in design.md format, ready for AI design tools like Figma Make and Stitch. Also available as antd_design_md MCP tool (#147, ant-design#57701)
• New antd upgrade command — update the CLI to the latest version without leaving your terminal (#123)
• All commands now support --format markdown output and --lang zh for Chinese labels (#146)
• antd info now shows a note about common props (className / style / rootClassName) shared by all components (#139)

Bug Fixes#

• Fix version auto-detection defaulting to v5 instead of v6 when antd is not installed locally (#150)
• antd mcp now shows a helpful message when run directly in a terminal instead of silently hanging (#154)
• Fix some components (e.g. those with only sub-component props) failing to display in antd info (#152)
• Fix missing or malformed prop metadata and token data for some components across v5/v6 (#138, #132, #122, #125)
• Fix markdown table output with special characters being incorrectly escaped (#136)
• Fix invalid --format or --lang values being silently ignored instead of showing an error (#141)
• Fix version parsing, antd upgrade comparison, and antd semantic --lang zh crash (#127)

Security#

• Fix potential shell injection in build scripts (#137, #134)
• Upgrade qs to 6.15.2 to resolve CVE-2026-8723 (#121)

Other Changes#

• Reduce npm package size by excluding skills node_modules (#144)
• Add Codex and OpenAI Agents support (#151)
• Improve sync workflow reliability (#155, #156, #135, #133)
• Bump dependencies (#149, #148, #130, #119, #117)
• Update antd metadata to v6.4.4 (diff)

新功能#

• 新增 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 Fixes#

• Fix async postAction hook not being properly awaited — use parseAsync() instead of synchronous parse() (#113)
• Fix semver OR-range (||) false positives in peer dependency checks and incorrect ^0.x minor-locking behavior by replacing hand-rolled semver parser with the semver package (#109)
• Fix CJK character width misalignment in table output (e.g. antd list --lang zh) using string-width (#109)
• Fix compare() returning incorrect results for null/undefined inputs (#111)

Other Changes#

• Replace custom Levenshtein distance and recursive directory walker with fast-levenshtein and fast-glob packages (#109)
• Extract shared fetchWithTimeout and fetchFirstJson helpers to eliminate duplicated HTTP patterns (#109)
• Sync bundled antd CLI skill with current command surface (#114)
• Remove stale v6 snapshots and prevent re-accumulation, reducing package size by ~4.3 MB (29.6 MB → 25.3 MB) (#107)
• Convert e2e tests to in-process execution for better performance (#112)
• Reach 100% line, statement, and function test coverage (#115, #116)
• Update antd metadata (v6@6.4.3)

6.4.2 (2026-05-14)#

• Update antd metadata (v6@6.4.2)

6.4.1 (2026-05-14)#

• Update antd metadata (v6@6.4.1)

6.4.0 (2026-05-14)#

New Features#

• doctor command now checks for known bugs in the installed antd version and displays related issue links (#89)

Bug Fixes#

• Fix lint false positives for Checkbox.Group/Radio.Group — value on Checkbox inside Checkbox.Group and optionType on Radio inside Radio.Group are no longer incorrectly warned (#93, closes #91)
• Fix lint performance rule incorrectly flagging locale default imports like import enUS from 'antd/locale/en_US' and improve suggestion to use actual component names instead of always suggesting Button (#104, closes #99, #101)

Other Changes#

• Refactor update check to query multiple sources concurrently (#89)
• Update antd metadata (v6@6.4.0)
• Configure Dependabot for grouped updates as npm ecosystem (#102)
• Bump dependencies and resolve security alerts (#103, #105)

6.3.7 (2026-04-27)#

• Update antd metadata (v4@4.24.16, v5@5.29.3, v6@6.3.7)

6.3.6 (2026-04-17)#

New Features#

• Add antd v3 support — antd list, antd info, antd doc, antd demo, antd migrate 3 4 now work with v3 projects (#77)
• Add --antd-alias flag to antd lint for recognizing wrapper import sources (#81)
• Enhance antd env with full envinfo output (#75)
• Add MCP tool annotations for better IDE integration (#79)

Bug Fixes#

• Fix antd token outputting plain text instead of valid JSON when no tokens available (#80)
• Fix sync workflow never detecting new antd versions (#83)
• Fix AI assistant proactively suggesting bug reports; bug reporting is now user-initiated only, with ANTD_NO_AUTO_REPORT=1 to fully opt out (#85, closes #82)

Other Changes#

• Update antd metadata (v6@6.3.6)
• Require Node.js >= 20 (Commander v14 compatibility) (#76)

6.3.5 (2026-03-30)#

New Features#

• Add antd env command — prints a full environment snapshot including Node.js, OS, browser, antd version, package manager, and build tool. Useful for bug reports and AI agent context.

Bug Fixes#

• Fix antd lint reporting incorrect line numbers (always showing line 0) (#65)

Other Changes#

• Update antd metadata (v6@6.3.5)
• Bundle all dependencies into the package — eliminates 180+ transitive packages from your node_modules (#64)

6.3.5-beta.0 (2026-03-25)#

New Features#

• feat: add antd mcp command — MCP server with 7 tools and 2 prompts for IDE integration (#38)

Bug Fixes#

• fix: run update check when using -V flag (#42)
• fix(lint): rewrite all rules with oxc-parser AST analysis (#40)
• fix(lint): avoid false positives for deprecated prop rule on unrelated components (#36)

Other Changes#

• refactor: extract core functions from 7 command modules (#38)
• chore: keep JSON in git, exclude from npm via .npmignore (#41)
• ci: add npm pack size detection workflow and badge (#39)
• Update skill to instruct code agents to auto-update CLI when "Update available" notice appears (#42)

6.3.4 (2026-03-24)#

Bug Fixes#

• fix: show nameZh and since in info command output (#5)
• fix: restore missing name field in globalTokens for token command (#10)

Other Changes#

• Update antd metadata (v4@4.24.16, v5@5.29.3, v6@6.3.4)
• ci: switch to GitHub Actions OIDC publishing, remove NPM_TOKEN (#7)
• ci: migrate to semantic-release for automated versioning and publishing (#14)
• chore: simplify sync workflow (#11)
• chore: remove unused sample-data directory (#12)

6.3.3 (2026-03-24)#

First release of @ant-design/cli. A CLI tool for querying Ant Design component knowledge and analyzing antd usage in projects. Designed for AI code agents (Claude Code, Cursor, Copilot, etc.) with structured output support.

📚 Knowledge Query#

• antd list — List all antd components with descriptions and categories
• antd info <Component> — Query component API: props, types, default values; --detail for full docs, methods, FAQ
• antd doc <Component> — Output full API documentation in markdown
• antd demo <Component> [name] — Browse and retrieve demo source code
• antd token [component] — Query global and component-level Design Tokens (v5+)
• antd semantic <Component> — Show classNames and styles keys for semantic customization
• antd changelog [v1] [v2] [component] — View changelog entries or diff APIs across versions

🔍 Project Analysis#

• antd doctor — Diagnose project configuration issues (React compat, duplicate installs, theme config, SSR)
• antd usage [dir] — Scan project for component usage statistics and sub-component breakdown
• antd lint [file/dir] — Check antd best practices (deprecated APIs, a11y, performance)
• antd migrate <from> <to> — Version migration guide with breaking changes and auto-fix support

🐛 Issue Reporting#

• antd bug — Report a bug to ant-design/ant-design with auto-collected environment info
• antd bug-cli — Report a bug to ant-design/ant-design-cli

✨ Highlights#

• 🧩 14 commands covering knowledge query, project analysis, and issue reporting
• 📦 Multi-version support: bundled metadata for antd v4, v5, v6 — fully offline
• 🎯 Per-minor-version snapshots for precise API data at any antd version
• 🔄 Auto-detect project antd version from node_modules or package.json
• 🤖 All commands support --format json|text|markdown and --lang en|zh
• 🔮 Fuzzy matching with "Did you mean?" suggestions on typos
• 🔀 Cross-version API diffing (e.g. v4 vs v5)
• 🔗 Skill file for seamless integration with code agents (npx skills add ant-design/ant-design-cli)
• 🛡️ Standard error format with error codes and actionable suggestions