@ant-design/cli 6.3.5-beta.0 → 6.3.6

package/README.md

@@ -14,6 +14,7 @@ Query component knowledge, analyze project usage, and guide migrations — fully
 [![npm version](https://img.shields.io/npm/v/@ant-design/cli?color=blue&label=npm)](https://www.npmjs.com/package/@ant-design/cli)
 [![npm downloads](https://img.shields.io/npm/dm/@ant-design/cli?color=blue)](https://www.npmjs.com/package/@ant-design/cli)
 [![CI](https://github.com/ant-design/ant-design-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/ant-design/ant-design-cli/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/ant-design/ant-design-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/ant-design/ant-design-cli)
 [![install size](https://packagephobia.com/badge?p=@ant-design/cli)](https://packagephobia.com/result?p=@ant-design/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 
@@ -40,7 +41,7 @@ npx skills add ant-design/ant-design-cli    # install as an agent skill
 - 🤖 **Agent-optimized** — `--format json` on every command. Structured errors with codes and suggestions. Clean stdout/stderr separation.
 - 🌍 **Bilingual** — Every component name, description, and doc has both English and Chinese. Switch with `--lang zh`.
 - 🔮 **Smart matching** — Typo `Buttn`? The CLI suggests `Button` using Levenshtein distance, with first-letter preference.
-- 🧩 **14 commands** — From prop lookup to project-wide lint, from design token queries to cross-version API diffing.
+- 🧩 **15 commands** — From prop lookup to project-wide lint, from design token queries to cross-version API diffing.
 - 🔌 **MCP server** — `antd mcp` starts a stdio server for native IDE integration (Claude Desktop, Cursor).
 
 <br>
@@ -103,12 +104,16 @@ This exposes 7 tools (`antd_list`, `antd_info`, `antd_doc`, `antd_demo`, `antd_t
 ## 🚀 Quick Start
 
 ```bash
+antd list                           # All components with versions
 antd info Button                    # Component props, types, defaults
+antd doc Button                     # Full markdown documentation
 antd demo Select basic              # Runnable demo source code
 antd token DatePicker               # Design Token values (v5+)
 antd semantic Table                 # classNames / styles structure
 antd changelog 4.24.0 5.0.0 Select  # API diff across versions
 antd doctor                         # Diagnose project issues
+antd env                            # Collect env info for bug reports
+antd usage ./src                    # Analyze antd imports in project
 antd lint ./src                     # Check deprecated APIs & best practices
 antd migrate 4 5 --apply ./src      # Agent-ready migration prompt
 ```
@@ -134,6 +139,7 @@ antd migrate 4 5 --apply ./src      # Agent-ready migration prompt
 | Command | Description |
 |---|---|
 | [`antd doctor`](#antd-doctor) | 10 diagnostic checks: React compat, duplicates, peer deps, SSR, babel plugins |
+| [`antd env [dir]`](#antd-env-dir) | Collect all antd-related environment info for bug reporting or AI diagnosis |
 | [`antd usage [dir]`](#antd-usage-dir) | Import stats, sub-component breakdown (`Form.Item`), non-component exports |
 | [`antd lint [target]`](#antd-lint-target) | Deprecated APIs, accessibility gaps, performance issues, best practices |
 | [`antd migrate <from> <to>`](#antd-migrate-from-to) | Migration checklist with auto-fixable/manual split and `--apply` agent prompt |
@@ -271,6 +277,55 @@ antd doctor
 antd doctor --format json
 ```
 
+### `antd env [dir]`
+
+Collect all antd-related environment information — system, Node, package managers, browsers, dependencies, ecosystem packages (`@ant-design/*`, `rc-*`), and build tools — in one shot.
+
+```bash
+antd env                            # text output (paste into GitHub Issues)
+antd env --format json              # structured JSON for AI consumption
+antd env --format markdown          # markdown tables
+antd env ./my-project               # scan a specific project directory
+```
+
+<details>
+<summary>Example output</summary>
+
+```text
+Environment
+
+  System:
+    OS        macOS 15.3
+
+  Binaries:
+    Node      20.11.0
+    pnpm      9.1.0
+    Registry  https://registry.npmmirror.com/
+
+  Browsers:
+    Chrome    131.0.6778.86
+    Safari    18.3
+
+  Dependencies:
+    antd                 5.22.0
+    react                18.3.1
+    react-dom            18.3.1
+    dayjs                1.11.13
+    @ant-design/cssinjs  1.22.1
+    @ant-design/icons    5.5.2
+
+  Ecosystem:
+    @ant-design/pro-components  2.8.1
+    rc-field-form               2.7.0
+
+  Build Tools:
+    umi         4.3.0
+    typescript  5.6.3
+    less        4.2.0
+```
+
+</details>
+
 ### `antd usage [dir]`
 
 ```bash
@@ -287,8 +342,11 @@ Four rule categories: `deprecated`, `a11y`, `performance`, `best-practice`. Depr
 antd lint ./src
 antd lint ./src --only deprecated
 antd lint ./src --only a11y
+antd lint ./src --only deprecated --format json --antd-alias @shared-components
 ```
 
+Use `--antd-alias <source>` to treat additional package names as aliases of `antd`. Repeat the flag for multiple wrapper packages; `antd` remains enabled by default.
+
 ### `antd migrate <from> <to>`
 
 v4→v5 covers 25+ migration steps; v5→v6 covers 30+. Each step includes component name, breaking flag, search pattern, and before/after code.
@@ -343,6 +401,14 @@ antd bug-cli --title "..." --submit
 
 **Version auto-detection**: `--version` flag → `node_modules/antd` → `package.json` dependencies → fallback `5.24.0`
 
+### Environment Variables
+
+| Variable | Description |
+|---|---|
+| `ANTD_NO_AUTO_REPORT=1` | Disable bug-reporting suggestions from AI agents (see [#82](https://github.com/ant-design/ant-design-cli/issues/82)) |
+| `NO_UPDATE_CHECK=1` | Skip the silent version update check |
+| `CI=1` | Skip the silent version update check (same as `NO_UPDATE_CHECK=1`) |
+
 <br>
 
 ## 📄 License

package/README.zh-CN.md

@@ -14,6 +14,7 @@
 [![npm version](https://img.shields.io/npm/v/@ant-design/cli?color=blue&label=npm)](https://www.npmjs.com/package/@ant-design/cli)
 [![npm downloads](https://img.shields.io/npm/dm/@ant-design/cli?color=blue)](https://www.npmjs.com/package/@ant-design/cli)
 [![CI](https://github.com/ant-design/ant-design-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/ant-design/ant-design-cli/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/ant-design/ant-design-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/ant-design/ant-design-cli)
 [![install size](https://packagephobia.com/badge?p=@ant-design/cli)](https://packagephobia.com/result?p=@ant-design/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 
@@ -40,7 +41,7 @@ npx skills add ant-design/ant-design-cli    # 安装为 Agent Skill
 - 🤖 **Agent 优化** — 所有命令支持 `--format json`。结构化错误码与修复建议。stdout/stderr 严格分离。
 - 🌍 **双语输出** — 每个组件名、描述和文档均有中英文。通过 `--lang zh` 切换。
 - 🔮 **智能纠错** — 输入 `Buttn`？CLI 基于 Levenshtein 距离建议 `Button`，优先匹配首字母相同的候选。
-- 🧩 **14 条命令** — 从 Prop 查询到项目级 Lint，从 Design Token 到跨版本 API 对比。
+- 🧩 **15 条命令** — 从 Prop 查询到项目级 Lint，从 Design Token 到跨版本 API 对比。
 - 🔌 **MCP 服务** — `antd mcp` 启动 stdio 服务，原生集成 Claude Desktop、Cursor 等 IDE。
 
 <br>
@@ -103,12 +104,16 @@ Agent 会自动完成 `npm install`、`npx skills add`，并开始使用 CLI。
 ## 🚀 快速开始
 
 ```bash
+antd list                           # 所有组件及版本信息
 antd info Button                    # 组件 Props、类型、默认值
+antd doc Button                     # 完整 Markdown 文档
 antd demo Select basic              # 可运行的 Demo 源码
 antd token DatePicker               # Design Token 值（v5+）
 antd semantic Table                 # classNames / styles 结构
 antd changelog 4.24.0 5.0.0 Select  # 跨版本 API 差异对比
 antd doctor                         # 诊断项目配置问题
+antd env                            # 收集环境信息用于 Bug 报告
+antd usage ./src                    # 分析项目中的 antd 导入
 antd lint ./src                     # 检查废弃 API 和最佳实践
 antd migrate 4 5 --apply ./src      # 生成 Agent 迁移提示
 ```
@@ -134,6 +139,7 @@ antd migrate 4 5 --apply ./src      # 生成 Agent 迁移提示
 | 命令 | 说明 |
 |---|---|
 | [`antd doctor`](#antd-doctor) | 10 项诊断检查：React 兼容性、重复安装、peer 依赖、SSR、babel 插件 |
+| [`antd env [dir]`](#antd-env-dir) | 一键收集 antd 相关环境信息，用于 Bug 报告或 AI 辅助诊断 |
 | [`antd usage [dir]`](#antd-usage-dir) | 导入统计、子组件分布（`Form.Item`）、非组件导出 |
 | [`antd lint [target]`](#antd-lint-target) | 废弃 API、无障碍缺陷、性能问题、最佳实践 |
 | [`antd migrate <from> <to>`](#antd-migrate-from-to) | 迁移清单，区分自动修复/手动处理，`--apply` 生成 Agent 提示 |
@@ -271,6 +277,55 @@ antd doctor
 antd doctor --format json
 ```
 
+### `antd env [dir]`
+
+一键收集 antd 相关的所有环境信息 — 系统、Node、包管理器、浏览器、依赖包、生态包（`@ant-design/*`、`rc-*`）和构建工具。
+
+```bash
+antd env                            # 文本输出（粘贴到 GitHub Issue）
+antd env --format json              # 结构化 JSON，供 AI 消费
+antd env --format markdown          # Markdown 表格输出
+antd env ./my-project               # 扫描指定项目目录
+```
+
+<details>
+<summary>示例输出</summary>
+
+```text
+Environment
+
+  System:
+    OS        macOS 15.3
+
+  Binaries:
+    Node      20.11.0
+    pnpm      9.1.0
+    Registry  https://registry.npmmirror.com/
+
+  Browsers:
+    Chrome    131.0.6778.86
+    Safari    18.3
+
+  Dependencies:
+    antd                 5.22.0
+    react                18.3.1
+    react-dom            18.3.1
+    dayjs                1.11.13
+    @ant-design/cssinjs  1.22.1
+    @ant-design/icons    5.5.2
+
+  Ecosystem:
+    @ant-design/pro-components  2.8.1
+    rc-field-form               2.7.0
+
+  Build Tools:
+    umi         4.3.0
+    typescript  5.6.3
+    less        4.2.0
+```
+
+</details>
+
 ### `antd usage [dir]`
 
 ```bash
@@ -287,8 +342,11 @@ antd usage -f Button                # 过滤特定组件
 antd lint ./src
 antd lint ./src --only deprecated
 antd lint ./src --only a11y
+antd lint ./src --only deprecated --format json --antd-alias @shared-components
 ```
 
+使用 `--antd-alias <source>` 可以把额外包名视为 `antd` 的别名；可重复传入多个包装包名，且默认仍会匹配 `antd`。
+
 ### `antd migrate <from> <to>`
 
 v4→v5 包含 25+ 迁移步骤，v5→v6 包含 30+。每个步骤包含组件名、破坏性标记、搜索正则和前后代码对比。
@@ -343,6 +401,14 @@ antd bug-cli --title "..." --submit
 
 **版本自动检测**：`--version` 参数 → `node_modules/antd` → `package.json` 依赖声明 → 回退 `5.24.0`
 
+### 环境变量
+
+| 变量 | 说明 |
+|---|---|
+| `ANTD_NO_AUTO_REPORT=1` | 禁用 AI Agent 的 Bug 上报建议（详见 [#82](https://github.com/ant-design/ant-design-cli/issues/82)） |
+| `NO_UPDATE_CHECK=1` | 跳过静默版本更新检查 |
+| `CI=1` | 跳过静默版本更新检查（同 `NO_UPDATE_CHECK=1`） |
+
 <br>
 
 ## 📄 开源协议

package/data/versions.json

@@ -1,4 +1,7 @@
 {
+  "v3": {
+    "3.26": "3.26.20"
+  },
   "v4": {
     "4.24": "4.24.16",
     "4.0": "4.0.4",
@@ -59,7 +62,7 @@
     "5.9": "5.9.4"
   },
   "v6": {
-    "6.3": "6.3.4",
+    "6.3": "6.3.6",
     "6.0": "6.0.1",
     "6.1": "6.1.4",
     "6.2": "6.2.3"