@ant-design/cli 6.3.5 → 6.3.7

package/README.md

@@ -26,7 +26,7 @@ Query component knowledge, analyze project usage, and guide migrations — fully
 
 ## 🤔 Why
 
-Code agents (Claude Code, Codex, Gemini CLI) write better antd code when they have instant access to the right API data. This CLI gives them exactly that — **every prop, token, demo, and changelog entry for antd v4 / v5 / v6**, bundled locally, queryable in milliseconds.
+Code agents (Claude Code, Codex, Gemini CLI) write better antd code when they have instant access to the right API data. This CLI gives them exactly that — **every prop, token, demo, and changelog entry for antd v3 / v4 / v5 / v6**, bundled locally, queryable in milliseconds.
 
 ```bash
 npx skills add ant-design/ant-design-cli    # install as an agent skill
@@ -37,7 +37,7 @@ npx skills add ant-design/ant-design-cli    # install as an agent skill
 ## ✨ Highlights
 
 - 📦 **Fully offline** — All metadata ships with the package. No network calls, no latency, no API keys.
-- 🎯 **Version-accurate** — 55+ per-minor snapshots across v4/v5/v6. Query the exact API surface of `antd@5.3.0`, not just "latest v5".
+- 🎯 **Version-accurate** — 55+ per-minor snapshots across v3/v4/v5/v6. Query the exact API surface of `antd@5.3.0`, not just "latest v5".
 - 🤖 **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.
@@ -104,13 +104,18 @@ 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 3 4                    # v3 → v4 migration guide
 antd migrate 4 5 --apply ./src      # Agent-ready migration prompt
 ```
 
@@ -338,13 +343,17 @@ 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.
+v3→v4 covers 15+ migration steps; v4→v5 covers 25+ migration steps; v5→v6 covers 30+. Each step includes component name, breaking flag, search pattern, and before/after code.
 
 ```bash
+antd migrate 3 4                    # v3 → v4 migration
 antd migrate 4 5                    # full checklist
 antd migrate 4 5 --component Select # component-specific
 antd migrate 4 5 --apply ./src      # generate agent migration prompt
@@ -394,6 +403,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

@@ -26,7 +26,7 @@
 
 ## 🤔 为什么
 
-Code Agent（Claude Code、Codex、Gemini CLI）在拥有即时 API 数据访问能力时，能写出更好的 antd 代码。这个 CLI 正是为此而生 — **antd v4 / v5 / v6 的每个 Prop、Token、Demo 和 Changelog 条目**，本地打包，毫秒级查询。
+Code Agent（Claude Code、Codex、Gemini CLI）在拥有即时 API 数据访问能力时，能写出更好的 antd 代码。这个 CLI 正是为此而生 — **antd v3 / v4 / v5 / v6 的每个 Prop、Token、Demo 和 Changelog 条目**，本地打包，毫秒级查询。
 
 ```bash
 npx skills add ant-design/ant-design-cli    # 安装为 Agent Skill
@@ -37,7 +37,7 @@ npx skills add ant-design/ant-design-cli    # 安装为 Agent Skill
 ## ✨ 亮点
 
 - 📦 **完全离线** — 所有元数据随包安装，无需网络请求，无延迟，无 API Key。
-- 🎯 **版本精确** — 跨 v4/v5/v6 的 55+ 小版本快照。查询 `antd@5.3.0` 的精确 API，而非仅 "最新 v5"。
+- 🎯 **版本精确** — 跨 v3/v4/v5/v6 的 55+ 小版本快照。查询 `antd@5.3.0` 的精确 API，而非仅 "最新 v5"。
 - 🤖 **Agent 优化** — 所有命令支持 `--format json`。结构化错误码与修复建议。stdout/stderr 严格分离。
 - 🌍 **双语输出** — 每个组件名、描述和文档均有中英文。通过 `--lang zh` 切换。
 - 🔮 **智能纠错** — 输入 `Buttn`？CLI 基于 Levenshtein 距离建议 `Button`，优先匹配首字母相同的候选。
@@ -104,13 +104,18 @@ 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 3 4                    # v3 → v4 迁移指南
 antd migrate 4 5 --apply ./src      # 生成 Agent 迁移提示
 ```
 
@@ -338,13 +343,17 @@ 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+。每个步骤包含组件名、破坏性标记、搜索正则和前后代码对比。
+v3→v4 包含 15+ 迁移步骤，v4→v5 包含 25+ 迁移步骤，v5→v6 包含 30+。每个步骤包含组件名、破坏性标记、搜索正则和前后代码对比。
 
 ```bash
+antd migrate 3 4                    # v3 → v4 迁移
 antd migrate 4 5                    # 完整迁移清单
 antd migrate 4 5 --component Select # 指定组件
 antd migrate 4 5 --apply ./src      # 生成 Agent 迁移提示
@@ -394,6 +403,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.5",
+    "6.3": "6.3.7",
     "6.0": "6.0.1",
     "6.1": "6.1.4",
     "6.2": "6.2.3"