@ant-design/cli 6.5.0 → 6.5.2

package/dist/index.js

@@ -7310,7 +7310,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve2.call(this, root, ref);
+      let _sch = resolve3.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a2 = root.localRefs) === null || _a2 === void 0 ? void 0 : _a2[ref];
         const { schemaId } = this.opts;
@@ -7337,7 +7337,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve2(root, ref) {
+    function resolve3(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -7968,55 +7968,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve2(baseURI, relativeURI, options) {
+    function resolve3(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent2(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent2(base, relative2, options, skipNormalization) {
+    function resolveComponent2(base, relative3, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative2 = parse3(serialize(relative2, options), options);
+        relative3 = parse3(serialize(relative3, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative2.scheme) {
-        target.scheme = relative2.scheme;
-        target.userinfo = relative2.userinfo;
-        target.host = relative2.host;
-        target.port = relative2.port;
-        target.path = removeDotSegments(relative2.path || "");
-        target.query = relative2.query;
+      if (!options.tolerant && relative3.scheme) {
+        target.scheme = relative3.scheme;
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
-          target.userinfo = relative2.userinfo;
-          target.host = relative2.host;
-          target.port = relative2.port;
-          target.path = removeDotSegments(relative2.path || "");
-          target.query = relative2.query;
+        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+          target.userinfo = relative3.userinfo;
+          target.host = relative3.host;
+          target.port = relative3.port;
+          target.path = removeDotSegments(relative3.path || "");
+          target.query = relative3.query;
         } else {
-          if (!relative2.path) {
+          if (!relative3.path) {
             target.path = base.path;
-            if (relative2.query !== void 0) {
-              target.query = relative2.query;
+            if (relative3.query !== void 0) {
+              target.query = relative3.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative2.path[0] === "/") {
-              target.path = removeDotSegments(relative2.path);
+            if (relative3.path[0] === "/") {
+              target.path = removeDotSegments(relative3.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative2.path;
+                target.path = "/" + relative3.path;
               } else if (!base.path) {
-                target.path = relative2.path;
+                target.path = relative3.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative2.query;
+            target.query = relative3.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -8024,7 +8024,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative2.fragment;
+      target.fragment = relative3.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -8226,7 +8226,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve2,
+      resolve: resolve3,
       resolveComponent: resolveComponent2,
       equal,
       serialize,
@@ -15546,12 +15546,18 @@ function loadMetadata(majorVersion) {
     };
   }
 }
+var MAX_METADATA_CACHE_ENTRIES = 32;
 var metadataCache = /* @__PURE__ */ new Map();
 function loadMetadataForVersion(version2) {
   const cached2 = metadataCache.get(version2);
   if (cached2) return cached2;
   const result = loadMetadataForVersionUncached(version2);
   metadataCache.set(version2, result);
+  while (metadataCache.size > MAX_METADATA_CACHE_ENTRIES) {
+    const oldestKey = metadataCache.keys().next().value;
+    if (oldestKey === void 0) break;
+    metadataCache.delete(oldestKey);
+  }
   return result;
 }
 function loadMetadataForVersionUncached(version2) {
@@ -15748,15 +15754,6 @@ function parsePropsFromDoc(comp) {
 function backfillFromMajor(comp, majorStore) {
   const majorComp = findComponent(majorStore, comp.name);
   if (!majorComp) return;
-  if (comp.props.length === 0 && majorComp.props.length > 0) {
-    comp.props = [...majorComp.props];
-    if (!comp.subComponentProps && majorComp.subComponentProps) {
-      comp.subComponentProps = { ...majorComp.subComponentProps };
-      for (const key of Object.keys(comp.subComponentProps)) {
-        comp.subComponentProps[key] = [...majorComp.subComponentProps[key]];
-      }
-    }
-  }
   if (!comp.description && majorComp.description) {
     comp.description = majorComp.description;
   }
@@ -15766,8 +15763,8 @@ function backfillFromMajor(comp, majorStore) {
 }
 function resolveComponent(component, version2) {
   const store = loadMetadataForVersion(version2);
-  const comp = findComponent(store, component);
-  if (!comp) {
+  const storedComp = findComponent(store, component);
+  if (!storedComp) {
     const names = getAllComponentNames(store);
     const suggestion = fuzzyMatch(component, names);
     return createError(
@@ -15776,6 +15773,7 @@ function resolveComponent(component, version2) {
       suggestion ? `Did you mean '${suggestion}'?` : void 0
     );
   }
+  const comp = { ...storedComp };
   const majorVersion = `v${version2.split(".")[0]}`;
   if (comp.props.length === 0 && comp.doc) {
     const parsed = parsePropsFromDoc(comp);
@@ -15786,7 +15784,7 @@ function resolveComponent(component, version2) {
       }
     }
   }
-  const needsMajorBackfill = comp.props.length === 0 || !comp.description || !comp.descriptionZh;
+  const needsMajorBackfill = !comp.description || !comp.descriptionZh;
   if (needsMajorBackfill) {
     const majorStore = loadMetadata(majorVersion);
     backfillFromMajor(comp, majorStore);
@@ -15893,8 +15891,8 @@ function toMajor(version2) {
   return `v${major}`;
 }
 function compare(a, b) {
-  const sa = semver.coerce(a);
-  const sb = semver.coerce(b);
+  const sa = semver.parse(a) ?? semver.coerce(a, { includePrerelease: true });
+  const sb = semver.parse(b) ?? semver.coerce(b, { includePrerelease: true });
   if (!sa || !sb) return null;
   return semver.compare(sa, sb);
 }
@@ -16542,10 +16540,7 @@ function diffProps(oldProps, newProps) {
   }
   for (const [name, prop] of oldMap) {
     if (!newMap.has(name)) {
-      const possibleRename = [...newMap.values()].find(
-        (p) => p.type === prop.type && !oldMap.has(p.name)
-      );
-      removed.push({ name, type: prop.type, replacement: possibleRename?.name });
+      removed.push({ name, type: prop.type });
     }
   }
   return { added, removed, changed };
@@ -16693,10 +16688,7 @@ function printApiDiff(result, format, lang = "en") {
   for (const diff of result.diffs) {
     console.log(`  ${diff.component}:`);
     for (const p of diff.added) console.log(`    + ${p.name}: ${p.type}`);
-    for (const p of diff.removed) {
-      const note = p.replacement ? ` (replaced by ${p.replacement})` : "";
-      console.log(`    - ${p.name}: ${p.type}${note}`);
-    }
+    for (const p of diff.removed) console.log(`    - ${p.name}: ${p.type}`);
     for (const p of diff.changed) console.log(`    ~ ${p.name}: ${p.change}`);
     console.log("");
   }
@@ -17458,7 +17450,9 @@ Non-component antd exports (${nonComponents.length}):`,
 }
 
 // src/commands/lint.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync7, statSync as statSync2 } from "fs";
+import { execFileSync } from "child_process";
+import { dirname as dirname4, extname, join as join5, relative, resolve } from "path";
 import { parseSync as parseSync2, Visitor as Visitor2 } from "oxc-parser";
 function getDeprecatedProps(store) {
   const result = /* @__PURE__ */ new Map();
@@ -17513,6 +17507,51 @@ function getObjectExpressionKeys(attrs, name) {
   }
   return [];
 }
+function getMemberPath(node) {
+  if (!node) return [];
+  if (node.type === "Identifier") return [node.name];
+  if (node.type === "ChainExpression") return getMemberPath(node.expression);
+  if (node.type === "MemberExpression" || node.type === "OptionalMemberExpression") {
+    const objectPath = getMemberPath(node.object);
+    if (objectPath.length === 0) return [];
+    let propertyName;
+    if (node.property?.type === "Identifier" && !node.computed) {
+      propertyName = node.property.name;
+    } else if (node.property?.type === "Literal" && typeof node.property.value === "string") {
+      propertyName = node.property.value;
+    }
+    return propertyName ? [...objectPath, propertyName] : [];
+  }
+  return [];
+}
+function collectPatternNames(pattern, names = []) {
+  if (!pattern) return names;
+  if (pattern.type === "Identifier") {
+    names.push(pattern.name);
+  } else if (pattern.type === "AssignmentPattern") {
+    collectPatternNames(pattern.left, names);
+  } else if (pattern.type === "RestElement") {
+    collectPatternNames(pattern.argument, names);
+  } else if (pattern.type === "ArrayPattern") {
+    for (const element of pattern.elements ?? []) collectPatternNames(element, names);
+  } else if (pattern.type === "ObjectPattern") {
+    for (const property of pattern.properties ?? []) {
+      if (property.type === "Property") {
+        collectPatternNames(property.value, names);
+      } else if (property.type === "RestElement") {
+        collectPatternNames(property.argument, names);
+      }
+    }
+  } else if (pattern.pattern) {
+    collectPatternNames(pattern.pattern, names);
+  }
+  return names;
+}
+var STATIC_FEEDBACK_METHODS = {
+  message: ["open", "success", "error", "info", "warning", "warn", "loading"],
+  notification: ["open", "success", "error", "info", "warning", "warn"],
+  Modal: ["confirm", "info", "success", "error", "warning", "warn"]
+};
 function createLineMapper(source) {
   let lastOffset = 0;
   let lastLine = 1;
@@ -17540,25 +17579,108 @@ function isLocalePath(source, antdAliases) {
     (alias) => source.startsWith(`${alias}/locale/`) || source.startsWith(`${alias}/es/locale/`) || source.startsWith(`${alias}/lib/locale/`)
   );
 }
+var MODULE_EXTENSIONS = /* @__PURE__ */ new Set(["js", "jsx", "ts", "tsx", "mjs", "cjs", "mts", "cts"]);
+function isNonModuleSource(source) {
+  const match = /\.([^./]+)$/.exec(source);
+  if (!match) return false;
+  return !MODULE_EXTENSIONS.has(match[1].toLowerCase());
+}
 function mayContainAntdAlias(content, antdAliases) {
   return antdAliases.some((antdAlias) => content.includes(antdAlias));
 }
 function collectAntdAlias(source, previous) {
   return [...previous, source];
 }
-function lintFile(filePath, deprecatedMap, antdAliases, only) {
+function execGit(cwd, args) {
+  const options = { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] };
+  try {
+    return execFileSync("git", args, options);
+  } catch (error2) {
+    const stderr = typeof error2.stderr === "string" ? error2.stderr.trim() : "";
+    throw new Error(stderr || (error2 instanceof Error ? error2.message : "git command failed"));
+  }
+}
+function getGitRoot(targetPath) {
+  const absoluteTarget = resolve(targetPath);
+  if (!existsSync5(absoluteTarget)) {
+    throw new Error(`Lint target not found: ${targetPath}`);
+  }
+  let gitCwd = absoluteTarget;
+  try {
+    if (statSync2(absoluteTarget).isFile()) {
+      gitCwd = dirname4(absoluteTarget);
+    }
+  } catch {
+    gitCwd = absoluteTarget;
+  }
+  return execGit(gitCwd, ["rev-parse", "--show-toplevel"]).trim();
+}
+function getPathspec(repoRoot, targetPath) {
+  const rel = relative(repoRoot, resolve(targetPath));
+  return rel === "" ? "." : rel.replace(/\\/g, "/");
+}
+function isLintableSource(filePath, gitPath = filePath) {
+  if (!existsSync5(filePath)) return false;
+  try {
+    if (!statSync2(filePath).isFile()) return false;
+  } catch {
+    return false;
+  }
+  if (!SCAN_EXTENSIONS.has(extname(filePath))) return false;
+  return !gitPath.split(/[\\/]/).some((segment) => SKIP_DIRS.has(segment) || segment.startsWith(".umi"));
+}
+function resolveDiffBase(repoRoot, diff) {
+  if (typeof diff === "string" && diff.trim()) {
+    const requested = diff.trim();
+    try {
+      return execGit(repoRoot, ["merge-base", requested, "HEAD"]).trim() || requested;
+    } catch {
+      return requested;
+    }
+  }
+  try {
+    return execGit(repoRoot, ["merge-base", "origin/main", "HEAD"]).trim();
+  } catch {
+    return "HEAD";
+  }
+}
+function collectGitFiles(targetPath, mode, diff) {
+  const repoRoot = getGitRoot(targetPath);
+  const pathspec = getPathspec(repoRoot, targetPath);
+  const args = mode === "staged" ? ["diff", "--name-only", "--cached", "--diff-filter=ACMR", "--", pathspec] : ["diff", "--name-only", "--diff-filter=ACMR", resolveDiffBase(repoRoot, diff), "--", pathspec];
+  return execGit(repoRoot, args).split("\n").map((file2) => file2.trim()).filter(Boolean).filter((file2) => isLintableSource(join5(repoRoot, file2), file2)).map((file2) => join5(repoRoot, file2));
+}
+function lintFile(filePath, deprecatedMap, antdAliases, antdMajor, only) {
   let content;
   try {
     content = readFileSync7(filePath, "utf-8");
-  } catch {
-    return [];
+  } catch (error2) {
+    return {
+      issues: [],
+      skipped: {
+        file: filePath,
+        reason: "read-error",
+        message: error2 instanceof Error ? error2.message : "Failed to read file"
+      }
+    };
   }
-  if (!mayContainAntdAlias(content, antdAliases)) return [];
+  if (!mayContainAntdAlias(content, antdAliases)) return { issues: [] };
   const result = parseSync2(filePath, content);
-  if (result.errors.length > 0) return [];
+  if (result.errors.length > 0) {
+    return {
+      issues: [],
+      skipped: {
+        file: filePath,
+        reason: "parse-error",
+        message: result.errors[0]?.message ?? "Failed to parse file"
+      }
+    };
+  }
   const issues = [];
   const importedComponents = /* @__PURE__ */ new Set();
+  const antdImportLocals = /* @__PURE__ */ new Map();
   const offsetToLine = createLineMapper(content);
+  const enableV5UsageRules = antdMajor >= 5;
   const lineOf = (node) => {
     if (typeof node.start === "number") return offsetToLine(node.start);
     return node.loc?.start?.line ?? 0;
@@ -17570,7 +17692,47 @@ function lintFile(filePath, deprecatedMap, antdAliases, only) {
   const isInsideComponent = (name) => jsxAncestorStack.includes(name);
   const pendingPerformanceIssues = [];
   const namespaceMemberUsage = /* @__PURE__ */ new Map();
+  const scopeStack = [/* @__PURE__ */ new Set()];
+  const declarePattern = (pattern) => {
+    const currentScope = scopeStack[scopeStack.length - 1];
+    for (const name of collectPatternNames(pattern)) {
+      currentScope.add(name);
+    }
+  };
+  const isShadowed = (name) => scopeStack.some((scope) => scope.has(name));
+  const pushFunctionScope = (node) => {
+    scopeStack.push(/* @__PURE__ */ new Set());
+    for (const param of node.params ?? []) declarePattern(param);
+  };
   const visitor = new Visitor2({
+    BlockStatement() {
+      scopeStack.push(/* @__PURE__ */ new Set());
+    },
+    "BlockStatement:exit"() {
+      scopeStack.pop();
+    },
+    FunctionDeclaration: pushFunctionScope,
+    "FunctionDeclaration:exit"() {
+      scopeStack.pop();
+    },
+    FunctionExpression: pushFunctionScope,
+    "FunctionExpression:exit"() {
+      scopeStack.pop();
+    },
+    ArrowFunctionExpression: pushFunctionScope,
+    "ArrowFunctionExpression:exit"() {
+      scopeStack.pop();
+    },
+    CatchClause(node) {
+      scopeStack.push(/* @__PURE__ */ new Set());
+      if (node.param) declarePattern(node.param);
+    },
+    "CatchClause:exit"() {
+      scopeStack.pop();
+    },
+    VariableDeclarator(node) {
+      declarePattern(node.id);
+    },
     JSXElement(node) {
       const elName = getJSXElementName(node.openingElement?.name);
       jsxAncestorStack.push(elName);
@@ -17586,24 +17748,39 @@ function lintFile(filePath, deprecatedMap, antdAliases, only) {
         if (spec.type === "ImportSpecifier") {
           if (spec.importKind === "type") continue;
           const name = spec.imported?.name || spec.local?.name;
+          const localName = spec.local?.name || name;
           if (name) importedComponents.add(name);
+          if (name && localName) antdImportLocals.set(localName, name);
         }
         if (!only || only === "performance") {
-          const isNonLocaleNamespace = spec.type === "ImportNamespaceSpecifier" && !isLocalePath(source, antdAliases);
-          const isNonLocaleDefault = spec.type === "ImportDefaultSpecifier" && !isLocalePath(source, antdAliases);
-          if (isNonLocaleNamespace || isNonLocaleDefault) {
+          const isNamespace = spec.type === "ImportNamespaceSpecifier";
+          const isDefault = spec.type === "ImportDefaultSpecifier";
+          if ((isNamespace || isDefault) && !isLocalePath(source, antdAliases) && !isNonModuleSource(source)) {
             const localName = spec.local?.name ?? "";
             pendingPerformanceIssues.push({
               line: lineOf(node),
               source,
               localName,
-              kind: isNonLocaleNamespace ? "namespace" : "default"
+              kind: isNamespace ? "namespace" : "default"
             });
             namespaceMemberUsage.set(localName, /* @__PURE__ */ new Set());
           }
         }
       }
     },
+    CallExpression(node) {
+      if (only && only !== "usage") return;
+      if (!enableV5UsageRules) return;
+      const path7 = getMemberPath(node.callee);
+      if (path7.length < 2) return;
+      const importedName = antdImportLocals.get(path7[0]);
+      const method = path7[1];
+      const callName = path7.join(".");
+      const line = lineOf(node);
+      if (importedName && !isShadowed(path7[0]) && STATIC_FEEDBACK_METHODS[importedName]?.includes(method)) {
+        report("usage", "warning", line, `Static antd feedback API \`${callName}\` cannot consume ConfigProvider context. Use App.useApp() instead.`);
+      }
+    },
     JSXOpeningElement(node) {
       const compName = getJSXElementName(node.name);
       if (!compName) return;
@@ -17720,6 +17897,21 @@ function lintFile(filePath, deprecatedMap, antdAliases, only) {
             report("usage", "warning", line, "TreeSelect `multiple={false}` is ignored when `treeCheckable` is true");
           }
         }
+        if (enableV5UsageRules && (compName === "Upload" || compName === "Upload.Dragger") && importedComponents.has("Upload")) {
+          if (hasAttr(attrs, "fileList") && hasAttr(attrs, "defaultFileList")) {
+            report("usage", "warning", line, "Upload should not use both controlled `fileList` and uncontrolled `defaultFileList`");
+          } else if (hasAttr(attrs, "fileList") && !hasAttr(attrs, "onChange")) {
+            report("usage", "warning", line, "Upload with controlled `fileList` should provide `onChange`");
+          }
+        }
+        if (enableV5UsageRules && importedComponents.has("Select")) {
+          if (compName === "Select.Option") {
+            report("usage", "warning", line, "Select.Option children are not recommended in antd v5+. Use the `options` prop instead.");
+          }
+          if (compName === "Select.OptGroup") {
+            report("usage", "warning", line, "Select.OptGroup children are not recommended in antd v5+. Use grouped `options` instead.");
+          }
+        }
       }
       if (!only || only === "performance") {
         if (compName === "Select" && importedComponents.has("Select") || compName === "TreeSelect" && importedComponents.has("TreeSelect")) {
@@ -17738,47 +17930,57 @@ function lintFile(filePath, deprecatedMap, antdAliases, only) {
     const suggestion = memberList ? `Use named imports: \`import { ${memberList} } from '${pending.source}'\`` : "Use named imports instead";
     report("performance", "error", pending.line, `Avoid ${importKind} import from ${pending.source}. ${suggestion}`);
   }
-  return issues;
+  return { issues };
+}
+function printSkippedFiles(skippedFiles) {
+  for (const skipped of skippedFiles) {
+    console.log(`  - ${skipped.file} [${skipped.reason}] ${skipped.message}`);
+  }
 }
 function registerLintCommand(program2) {
-  program2.command("lint [target]").description("Check antd usage against best practices").option("--only <category>", "Only check specific category (deprecated, a11y, usage, performance)").option("--antd-alias <source>", "Treat additional package names as aliases of antd imports", collectAntdAlias, []).action((target, cmdOpts) => {
+  program2.command("lint [target]").description("Check antd usage against best practices").option("--only <category>", "Only check specific category (deprecated, a11y, usage, performance)").option("--antd-alias <source>", "Treat additional package names as aliases of antd imports", collectAntdAlias, []).option("--diff [base]", "Only lint files changed from a git diff base (default: origin/main, fallback: HEAD)").option("--staged", "Only lint staged git files").action((target, cmdOpts) => {
     const opts = program2.opts();
     const targetPath = target || ".";
+    if (cmdOpts.diff && cmdOpts.staged) {
+      program2.error("--diff and --staged cannot be used together");
+    }
     const versionInfo = detectVersion(opts.version);
     const store = loadMetadataForVersion(versionInfo.version);
     const deprecatedMap = getDeprecatedProps(store);
     const antdAliases = normalizeAntdAliases(cmdOpts.antdAlias);
-    const files = collectFiles(targetPath);
+    let files;
+    try {
+      files = cmdOpts.staged ? collectGitFiles(targetPath, "staged") : cmdOpts.diff ? collectGitFiles(targetPath, "diff", cmdOpts.diff) : collectFiles(targetPath);
+    } catch (error2) {
+      program2.error(error2 instanceof Error ? error2.message : String(error2));
+    }
     const allIssues = [];
+    const skippedFiles = [];
     for (const file2 of files) {
-      allIssues.push(...lintFile(file2, deprecatedMap, antdAliases, cmdOpts.only));
+      const result = lintFile(file2, deprecatedMap, antdAliases, parseInt(versionInfo.majorVersion.slice(1), 10), cmdOpts.only);
+      allIssues.push(...result.issues);
+      if (result.skipped) skippedFiles.push(result.skipped);
     }
     const summary = {
       total: allIssues.length,
       deprecated: allIssues.filter((i) => i.rule === "deprecated").length,
       a11y: allIssues.filter((i) => i.rule === "a11y").length,
       usage: allIssues.filter((i) => i.rule === "usage").length,
-      performance: allIssues.filter((i) => i.rule === "performance").length
+      performance: allIssues.filter((i) => i.rule === "performance").length,
+      skipped: skippedFiles.length
     };
     if (opts.format === "json") {
-      output({ issues: allIssues, summary }, "json");
-      return;
-    }
-    if (allIssues.length === 0) {
-      console.log(localize(
-        `Scanned ${files.length} files. No issues found.`,
-        `\u626B\u63CF\u4E86 ${files.length} \u4E2A\u6587\u4EF6\uFF0C\u672A\u53D1\u73B0\u95EE\u9898\u3002`,
-        opts.lang
-      ));
+      output({ issues: allIssues, skippedFiles, partial: skippedFiles.length > 0, summary }, "json");
       return;
     }
     const summaryParts = [
       localize(`${summary.deprecated} deprecated`, `${summary.deprecated} \u5DF2\u5E9F\u5F03`, opts.lang),
       localize(`${summary.a11y} a11y`, `${summary.a11y} \u65E0\u969C\u788D`, opts.lang),
       localize(`${summary.usage} usage`, `${summary.usage} \u7528\u6CD5`, opts.lang),
-      localize(`${summary.performance} performance`, `${summary.performance} \u6027\u80FD`, opts.lang)
+      localize(`${summary.performance} performance`, `${summary.performance} \u6027\u80FD`, opts.lang),
+      localize(`${summary.skipped} skipped`, `${summary.skipped} \u5DF2\u8DF3\u8FC7`, opts.lang)
     ].join(", ");
-    if (opts.format === "markdown") {
+    if (opts.format === "markdown" && (allIssues.length > 0 || skippedFiles.length > 0)) {
       console.log(`## ${localize("Lint Results", "Lint \u7ED3\u679C", opts.lang)}`);
       console.log("");
       console.log(localize(
@@ -17787,18 +17989,50 @@ function registerLintCommand(program2) {
         opts.lang
       ));
       console.log("");
-      const headers = [
-        localize("Rule", "\u89C4\u5219", opts.lang),
-        localize("Severity", "\u7EA7\u522B", opts.lang),
-        localize("Message", "\u4FE1\u606F", opts.lang),
-        localize("File", "\u6587\u4EF6", opts.lang)
-      ];
-      const rows = allIssues.map((i) => [i.rule, i.severity, i.message, `${i.file}:${i.line}`]);
-      console.log(formatTable(headers, rows, "markdown"));
+      if (allIssues.length > 0) {
+        const headers = [
+          localize("Rule", "\u89C4\u5219", opts.lang),
+          localize("Severity", "\u7EA7\u522B", opts.lang),
+          localize("Message", "\u4FE1\u606F", opts.lang),
+          localize("File", "\u6587\u4EF6", opts.lang)
+        ];
+        const rows = allIssues.map((i) => [i.rule, i.severity, i.message, `${i.file}:${i.line}`]);
+        console.log(formatTable(headers, rows, "markdown"));
+      }
+      if (skippedFiles.length > 0) {
+        console.log("");
+        console.log(`### ${localize("Skipped Files", "\u8DF3\u8FC7\u6587\u4EF6", opts.lang)}`);
+        console.log("");
+        console.log(formatTable(
+          [
+            localize("Reason", "\u539F\u56E0", opts.lang),
+            localize("Message", "\u4FE1\u606F", opts.lang),
+            localize("File", "\u6587\u4EF6", opts.lang)
+          ],
+          skippedFiles.map((file2) => [file2.reason, file2.message, file2.file]),
+          "markdown"
+        ));
+      }
       console.log("");
       console.log(`**${localize("Summary:", "\u6458\u8981\uFF1A", opts.lang)}** ${summaryParts}`);
       return;
     }
+    if (allIssues.length === 0) {
+      console.log(localize(
+        `Scanned ${files.length} files. No issues found.`,
+        `\u626B\u63CF\u4E86 ${files.length} \u4E2A\u6587\u4EF6\uFF0C\u672A\u53D1\u73B0\u95EE\u9898\u3002`,
+        opts.lang
+      ));
+      if (skippedFiles.length > 0) {
+        console.log(localize(
+          `Skipped ${skippedFiles.length} file${skippedFiles.length > 1 ? "s" : ""}:`,
+          `\u8DF3\u8FC7 ${skippedFiles.length} \u4E2A\u6587\u4EF6\uFF1A`,
+          opts.lang
+        ));
+        printSkippedFiles(skippedFiles);
+      }
+      return;
+    }
     console.log(localize(
       `Scanned ${files.length} files. Found ${allIssues.length} issues:`,
       `\u626B\u63CF\u4E86 ${files.length} \u4E2A\u6587\u4EF6\uFF0C\u53D1\u73B0 ${allIssues.length} \u4E2A\u95EE\u9898\uFF1A`,
@@ -17809,13 +18043,18 @@ function registerLintCommand(program2) {
       console.log(`  ${icon} ${issue2.file}:${issue2.line} [${issue2.rule}]`);
       console.log(`    ${issue2.message}`);
     }
+    if (skippedFiles.length > 0) {
+      console.log(`
+${localize("Skipped files:", "\u8DF3\u8FC7\u6587\u4EF6\uFF1A", opts.lang)}`);
+      printSkippedFiles(skippedFiles);
+    }
     console.log(`
 ${localize("Summary:", "\u6458\u8981\uFF1A", opts.lang)} ${summaryParts}`);
   });
 }
 
 // src/commands/migrate.ts
-import { relative } from "path";
+import { relative as relative2 } from "path";
 
 // src/commands/migrate-v3-to-v4.ts
 var V3_TO_V4_STEPS = [
@@ -19113,7 +19352,7 @@ function formatApplyPrompt(from, to, steps, dir, format) {
   );
   const fixableSteps = relevantSteps.filter((s) => s.autoFixable && s.searchPattern);
   const manualSteps = relevantSteps.filter((s) => !s.autoFixable);
-  const relativePath = (file2) => relative(process.cwd(), file2);
+  const relativePath = (file2) => relative2(process.cwd(), file2);
   if (format === "json") {
     const componentSummary = {};
     for (const [name, files] of scan.componentFiles) {
@@ -19288,14 +19527,14 @@ function registerMigrateCommand(program2) {
 
 // src/utils/issue.ts
 import { platform, release } from "os";
-import { execFileSync } from "child_process";
-import { join as join5 } from "path";
+import { execFileSync as execFileSync2 } from "child_process";
+import { join as join6 } from "path";
 function getSystem() {
   return `${platform()} ${release()}`;
 }
 function collectAntdEnv(cwd, versionOverride) {
-  const antdPkg = readJson(join5(cwd, "node_modules", "antd", "package.json"));
-  const reactPkg = readJson(join5(cwd, "node_modules", "react", "package.json"));
+  const antdPkg = readJson(join6(cwd, "node_modules", "antd", "package.json"));
+  const reactPkg = readJson(join6(cwd, "node_modules", "react", "package.json"));
   return {
     antd: versionOverride || antdPkg?.version || "unknown",
     react: reactPkg?.version || "unknown",
@@ -19306,7 +19545,7 @@ function collectAntdEnv(cwd, versionOverride) {
 function collectCliEnv() {
   let cliVersion;
   try {
-    cliVersion = "6.5.0";
+    cliVersion = "6.5.2";
   } catch (err) {
     console.error("Failed to get CLI version:", err);
     cliVersion = "unknown";
@@ -19399,14 +19638,14 @@ ${extra}`;
 }
 function checkGhAvailable() {
   try {
-    execFileSync("gh", ["--version"], { stdio: "ignore" });
+    execFileSync2("gh", ["--version"], { stdio: "ignore" });
     return true;
   } catch {
     return false;
   }
 }
 function submitViaGh(repo, title, body) {
-  const result = execFileSync("gh", ["issue", "create", "--repo", repo, "--title", title, "--body", body], {
+  const result = execFileSync2("gh", ["issue", "create", "--repo", repo, "--title", title, "--body", body], {
     encoding: "utf-8",
     timeout: 3e4
   }).trim();
@@ -19579,8 +19818,8 @@ function registerBugCliCommand(program2) {
 
 // src/commands/env.ts
 import { readdirSync as readdirSync3 } from "fs";
-import { execFileSync as execFileSync2 } from "child_process";
-import { join as join6, isAbsolute } from "path";
+import { execFileSync as execFileSync3 } from "child_process";
+import { join as join7, isAbsolute } from "path";
 import stringWidth2 from "string-width";
 async function collectEnvinfo(cwd) {
   try {
@@ -19615,7 +19854,7 @@ async function collectEnvinfo(cwd) {
     }
     result.Binaries = result.Binaries || {};
     try {
-      const registry2 = execFileSync2("npm", ["config", "get", "registry"], {
+      const registry2 = execFileSync3("npm", ["config", "get", "registry"], {
         cwd,
         encoding: "utf-8",
         timeout: 5e3,
@@ -19634,7 +19873,7 @@ var CORE_DEPS = ["antd", "react", "react-dom", "dayjs", "@ant-design/cssinjs", "
 function collectDependencies(cwd) {
   const result = {};
   for (const dep of CORE_DEPS) {
-    const pkg = readJson(join6(cwd, "node_modules", dep, "package.json"));
+    const pkg = readJson(join7(cwd, "node_modules", dep, "package.json"));
     result[dep] = pkg?.version ?? null;
   }
   return result;
@@ -19642,24 +19881,24 @@ function collectDependencies(cwd) {
 function scanEcosystem(cwd) {
   const result = {};
   const coreSet = new Set(CORE_DEPS);
-  const scopeDir = join6(cwd, "node_modules", "@ant-design");
+  const scopeDir = join7(cwd, "node_modules", "@ant-design");
   try {
     const entries = readdirSync3(scopeDir);
     for (const entry of entries) {
       if (entry.startsWith(".")) continue;
       const fullName = `@ant-design/${entry}`;
       if (coreSet.has(fullName)) continue;
-      const pkg = readJson(join6(scopeDir, entry, "package.json"));
+      const pkg = readJson(join7(scopeDir, entry, "package.json"));
       if (pkg?.version) result[fullName] = pkg.version;
     }
   } catch {
   }
-  const nmDir = join6(cwd, "node_modules");
+  const nmDir = join7(cwd, "node_modules");
   try {
     const entries = readdirSync3(nmDir);
     for (const entry of entries) {
       if (!entry.startsWith("rc-")) continue;
-      const pkg = readJson(join6(nmDir, entry, "package.json"));
+      const pkg = readJson(join7(nmDir, entry, "package.json"));
       if (pkg?.version) result[entry] = pkg.version;
     }
   } catch {
@@ -19702,7 +19941,7 @@ var ENVINFO_ORDER = ["System", "Binaries", "Managers", "Utilities", "Servers", "
 function collectBuildTools(cwd) {
   const result = {};
   for (const tool of BUILD_TOOLS) {
-    const pkg = readJson(join6(cwd, "node_modules", tool, "package.json"));
+    const pkg = readJson(join7(cwd, "node_modules", tool, "package.json"));
     if (pkg?.version) result[tool] = pkg.version;
   }
   return result;
@@ -19763,7 +20002,7 @@ function formatMarkdown2(data) {
 function registerEnvCommand(program2) {
   program2.command("env [dir]").description("Collect antd-related environment information for bug reporting").action(async (dir) => {
     const opts = program2.opts();
-    const cwd = dir ? isAbsolute(dir) ? dir : join6(process.cwd(), dir) : process.cwd();
+    const cwd = dir ? isAbsolute(dir) ? dir : join7(process.cwd(), dir) : process.cwd();
     const data = {
       envinfo: await collectEnvinfo(cwd),
       dependencies: collectDependencies(cwd),
@@ -19784,7 +20023,7 @@ function registerEnvCommand(program2) {
 import { execFile, spawn } from "child_process";
 
 // src/utils/detect-pm.ts
-import { execFileSync as execFileSync3 } from "child_process";
+import { execFileSync as execFileSync4 } from "child_process";
 var PM_RULES = [
   { pm: "utoo", keywords: [".utoo", "utoo/global"] },
   { pm: "cnpm", keywords: [".cnpm", "cnpm/global"] },
@@ -19812,7 +20051,7 @@ function inferPackageManagerFromPath(binPath) {
 function detectPackageManager() {
   const isWin = process.platform === "win32";
   try {
-    const binPath = execFileSync3(isWin ? "where" : "which", ["antd"], {
+    const binPath = execFileSync4(isWin ? "where" : "which", ["antd"], {
       encoding: "utf-8",
       timeout: 5e3
     }).trim();
@@ -20199,7 +20438,7 @@ var retryifyAsync = (fn, options) => {
           throw error2;
         const delay = Math.round(interval * Math.random());
         if (delay > 0) {
-          const delayPromise = new Promise((resolve2) => setTimeout(resolve2, delay));
+          const delayPromise = new Promise((resolve3) => setTimeout(resolve3, delay));
           return delayPromise.then(() => attempt.apply(void 0, args));
         } else {
           return attempt.apply(void 0, args);
@@ -21519,7 +21758,7 @@ function printUpdateNotice(currentVersion, latestVersion) {
 }
 async function checkForUpdate() {
   if (process.env.CI || process.env.NO_UPDATE_CHECK) return;
-  const currentVersion = "6.5.0";
+  const currentVersion = "6.5.2";
   if (!valid(currentVersion)) return;
   const now = Date.now();
   const cache = cacheStore.get("updateCache") ?? null;
@@ -21554,7 +21793,7 @@ function formatUpgradeMarkdown(data, lang) {
 }
 var IS_WIN = process.platform === "win32";
 function runUpgrade(cmd, args) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const child = spawn(cmd, args, {
       stdio: "inherit",
       timeout: 12e4,
@@ -21563,7 +21802,7 @@ function runUpgrade(cmd, args) {
     });
     child.on("error", reject);
     child.on("close", (code, signal) => {
-      if (code === 0) resolve2();
+      if (code === 0) resolve3();
       else if (code !== null) reject(new Error(`Process exited with code ${code}`));
       else reject(new Error(`Process killed by signal ${signal ?? "unknown"}`));
     });
@@ -21572,7 +21811,7 @@ function runUpgrade(cmd, args) {
 function registerUpgradeCommand(program2) {
   program2.command("upgrade").description("Upgrade the CLI to the latest version").action(async () => {
     const opts = program2.opts();
-    const currentVersion = "6.5.0";
+    const currentVersion = "6.5.2";
     let latestVersion;
     try {
       latestVersion = await fetchLatestVersion();
@@ -21674,14 +21913,14 @@ function registerUpgradeCommand(program2) {
     }
     let newVersion = null;
     try {
-      newVersion = await new Promise((resolve2, reject) => {
+      newVersion = await new Promise((resolve3, reject) => {
         execFile("antd", ["--cli-version"], {
           timeout: 1e4,
           /* v8 ignore next -- Windows-only branch */
           ...IS_WIN ? { shell: true } : {}
         }, (error2, stdout) => {
           if (error2) reject(error2);
-          else resolve2(stdout.trim());
+          else resolve3(stdout.trim());
         });
       });
     } catch {
@@ -34518,7 +34757,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -34535,7 +34774,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -34613,7 +34852,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve2(parseResult.data);
+            resolve3(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -34874,12 +35113,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve2, interval);
+      const timeoutId = setTimeout(resolve3, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -35749,12 +35988,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       const json2 = serializeMessage(message);
       if (this._stdout.write(json2)) {
-        resolve2();
+        resolve3();
       } else {
-        this._stdout.once("drain", resolve2);
+        this._stdout.once("drain", resolve3);
       }
     });
   }
@@ -35991,9 +36230,7 @@ ${SHARED_TOOL_WORKFLOW}
 
 // src/commands/mcp.ts
 function registerMcpCommand(program2) {
-  program2.command("mcp").description(
-    'Start MCP (Model Context Protocol) server for AI assistant integration.\nNot meant to be run directly. Configure your AI tool with:\n  { "mcpServers": { "antd": { "command": "npx", "args": ["-y", "@ant-design/cli", "mcp"] } } }'
-  ).action(
+  program2.command("mcp").description("Start MCP server for AI assistant integration").action(
     /* v8 ignore start */
     async () => {
       if (process.stdin.isTTY) {
@@ -36021,7 +36258,7 @@ function registerMcpCommand(program2) {
       const opts = program2.opts();
       const versionInfo = detectVersion(opts.version);
       const server = new Server(
-        { name: "antd", version: "6.5.0" },
+        { name: "antd", version: "6.5.2" },
         { capabilities: { tools: {}, prompts: {} } }
       );
       const handleTool = createToolHandler({
@@ -36069,8 +36306,8 @@ function registerMcpCommand(program2) {
 }
 
 // src/commands/setup.ts
-import { cpSync, existsSync as existsSync5, mkdirSync, readFileSync as readFileSync8, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname4, join as join7, resolve } from "path";
+import { cpSync, existsSync as existsSync6, mkdirSync, readFileSync as readFileSync8, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname5, join as join8, resolve as resolve2 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 var CLIENTS = {
   claude: { file: ".mcp.json", serverKey: "mcpServers" },
@@ -36080,13 +36317,13 @@ var CLIENTS = {
 var INSTRUCTIONS_START = "<!-- antd-cli setup start -->";
 var INSTRUCTIONS_END = "<!-- antd-cli setup end -->";
 function isAgentClient(value) {
-  return value === "codex" || Object.prototype.hasOwnProperty.call(CLIENTS, value);
+  return value === "codex" || value === "github-actions" || Object.prototype.hasOwnProperty.call(CLIENTS, value);
 }
 function isMcpAgentClient(value) {
-  return value !== "codex";
+  return value !== "codex" && value !== "github-actions";
 }
 function isSetupMode(value) {
-  return value === "mcp" || value === "skill" || value === "both";
+  return value === "mcp" || value === "skill" || value === "both" || value === "ci";
 }
 function buildMcpArgs(opts) {
   const args = ["-y", "@ant-design/cli", "mcp"];
@@ -36099,7 +36336,7 @@ function buildMcpArgs(opts) {
   return args;
 }
 function readConfig(file2) {
-  if (!existsSync5(file2)) return {};
+  if (!existsSync6(file2)) return {};
   const content = readFileSync8(file2, "utf-8").trim();
   if (!content) return {};
   const parsed = JSON.parse(content);
@@ -36122,6 +36359,50 @@ function createMergedConfig(current, serverKey, globalOpts) {
     }
   };
 }
+function shellArg(value) {
+  return /^[A-Za-z0-9@._/:=-]+$/.test(value) ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
+function buildCliCommand(command, args, opts) {
+  const parts = ["npx", "-y", "@ant-design/cli", command, ...args];
+  if (opts.version) {
+    parts.push("--version", opts.version);
+  }
+  if (opts.lang && opts.lang !== "en") {
+    parts.push("--lang", opts.lang);
+  }
+  return parts.map(shellArg).join(" ");
+}
+function createGitHubActionsWorkflow(globalOpts) {
+  return [
+    "name: Ant Design CLI",
+    "",
+    "on:",
+    "  pull_request:",
+    "",
+    "permissions:",
+    "  contents: read",
+    "",
+    "jobs:",
+    "  antd:",
+    "    runs-on: ubuntu-latest",
+    "    steps:",
+    "      - uses: actions/checkout@v7",
+    "      - uses: actions/setup-node@v6",
+    "        with:",
+    "          node-version: 20",
+    "          cache: npm",
+    "      - run: npm ci",
+    "      - run: npm run build",
+    "      - name: Run antd doctor",
+    `        run: ${buildCliCommand("doctor", ["--format", "json"], globalOpts)}`,
+    "      - name: Run antd lint",
+    `        run: ${buildCliCommand("lint", ["./src", "--format", "json"], globalOpts)}`,
+    ""
+  ].join("\n");
+}
+function normalizeTextFile(content) {
+  return content.replace(/\r\n/g, "\n");
+}
 function stableJson(value) {
   return JSON.stringify(value, null, 2) + "\n";
 }
@@ -36143,8 +36424,8 @@ function createMcpInstructionsBlock() {
   ].join("\n");
 }
 function getSkillDir(projectDir, client) {
-  if (client === "claude") return join7(projectDir, ".claude", "skills", "antd");
-  return join7(projectDir, ".agents", "skills", "antd");
+  if (client === "claude") return join8(projectDir, ".claude", "skills", "antd");
+  return join8(projectDir, ".agents", "skills", "antd");
 }
 function getSkillInstructionsPath(client) {
   if (client === "claude") return ".claude/skills/antd/SKILL.md";
@@ -36181,11 +36462,12 @@ function createInstructionsBlock(mode, client) {
   return createMcpInstructionsBlock();
 }
 function chooseInstructionsFile(projectDir, client) {
-  return join7(projectDir, client === "claude" ? "CLAUDE.md" : "AGENTS.md");
+  if (client === "github-actions") return join8(projectDir, ".github", "workflows", "antd-cli.yml");
+  return join8(projectDir, client === "claude" ? "CLAUDE.md" : "AGENTS.md");
 }
 function writeInstructions(projectDir, dryRun, mode, client) {
   const file2 = chooseInstructionsFile(projectDir, client);
-  const current = existsSync5(file2) ? readFileSync8(file2, "utf-8") : "";
+  const current = existsSync6(file2) ? readFileSync8(file2, "utf-8") : "";
   const block = createInstructionsBlock(mode, client);
   const pattern = new RegExp(`${INSTRUCTIONS_START}[\\s\\S]*?${INSTRUCTIONS_END}`);
   const next = pattern.test(current) ? current.replace(pattern, block) : `${current.trimEnd()}${current.trimEnd() ? "\n\n" : ""}${block}
@@ -36197,13 +36479,13 @@ function writeInstructions(projectDir, dryRun, mode, client) {
   return { file: file2, changed };
 }
 function resolveBundledSkillDir() {
-  const here = dirname4(fileURLToPath4(import.meta.url));
+  const here = dirname5(fileURLToPath4(import.meta.url));
   const candidates = [
-    resolve(here, "../../skills/antd"),
-    resolve(here, "../skills/antd"),
-    resolve(process.cwd(), "skills/antd")
+    resolve2(here, "../../skills/antd"),
+    resolve2(here, "../skills/antd"),
+    resolve2(process.cwd(), "skills/antd")
   ];
-  const found = candidates.find((dir) => existsSync5(join7(dir, "SKILL.md")));
+  const found = candidates.find((dir) => existsSync6(join8(dir, "SKILL.md")));
   if (!found) {
     throw new Error("Bundled Ant Design skill not found");
   }
@@ -36212,11 +36494,11 @@ function resolveBundledSkillDir() {
 function installSkill(projectDir, dryRun, client) {
   const source = resolveBundledSkillDir();
   const target = getSkillDir(projectDir, client);
-  const sourceSkill = join7(source, "SKILL.md");
-  const targetSkill = join7(target, "SKILL.md");
-  const changed = !existsSync5(targetSkill) || readFileSync8(sourceSkill, "utf-8") !== readFileSync8(targetSkill, "utf-8");
+  const sourceSkill = join8(source, "SKILL.md");
+  const targetSkill = join8(target, "SKILL.md");
+  const changed = !existsSync6(targetSkill) || readFileSync8(sourceSkill, "utf-8") !== readFileSync8(targetSkill, "utf-8");
   if (changed && !dryRun) {
-    mkdirSync(dirname4(target), { recursive: true });
+    mkdirSync(dirname5(target), { recursive: true });
     cpSync(source, target, { recursive: true, force: true });
   }
   return { dir: target, changed };
@@ -36235,7 +36517,7 @@ function isMatchingServerEntry(actual, expected) {
 function checkInstructions(projectDir, mode, client) {
   const expected = createInstructionsBlock(mode, client);
   const file2 = chooseInstructionsFile(projectDir, client);
-  if (!existsSync5(file2)) {
+  if (!existsSync6(file2)) {
     return [mode === "mcp" ? "MCP instructions not found" : "Skill instructions not found"];
   }
   if (!readFileSync8(file2, "utf-8").includes(expected)) {
@@ -36245,18 +36527,20 @@ function checkInstructions(projectDir, mode, client) {
 }
 function checkSkill(projectDir, client) {
   const source = resolveBundledSkillDir();
-  const sourceSkill = join7(source, "SKILL.md");
-  const targetSkill = join7(getSkillDir(projectDir, client), "SKILL.md");
-  if (!existsSync5(targetSkill)) return ["Ant Design skill not installed"];
+  const sourceSkill = join8(source, "SKILL.md");
+  const targetSkill = join8(getSkillDir(projectDir, client), "SKILL.md");
+  if (!existsSync6(targetSkill)) return ["Ant Design skill not installed"];
   if (readFileSync8(sourceSkill, "utf-8") !== readFileSync8(targetSkill, "utf-8")) {
     return ["Ant Design skill does not match bundled skill"];
   }
   return [];
 }
 function checkAgent(client, projectDir, globalOpts, mode, shouldCheckInstructions = false) {
+  const isGitHubActions = client === "github-actions";
   const clientConfig = isMcpAgentClient(client) ? CLIENTS[client] : void 0;
-  const file2 = clientConfig ? resolve(projectDir, clientConfig.file) : chooseInstructionsFile(projectDir, client);
+  const file2 = isGitHubActions ? resolve2(projectDir, ".github", "workflows", "antd-cli.yml") : clientConfig ? resolve2(projectDir, clientConfig.file) : chooseInstructionsFile(projectDir, client);
   const targets = [
+    ...isGitHubActions ? [file2] : [],
     ...(mode === "mcp" || mode === "both") && clientConfig ? [file2] : [],
     ...mode === "skill" || mode === "both" ? [getSkillDir(projectDir, client)] : [],
     ...mode === "skill" || mode === "both" || shouldCheckInstructions ? [chooseInstructionsFile(projectDir, client)] : []
@@ -36265,8 +36549,29 @@ function checkAgent(client, projectDir, globalOpts, mode, shouldCheckInstruction
   const expected = clientConfig ? getServerEntry(expectedConfig, clientConfig.serverKey) : {};
   const problems = [];
   let actual;
+  if (isGitHubActions) {
+    const expectedWorkflow = createGitHubActionsWorkflow(globalOpts);
+    if (!existsSync6(file2)) {
+      problems.push("GitHub Actions workflow not found");
+    } else {
+      actual = normalizeTextFile(readFileSync8(file2, "utf-8"));
+      if (actual !== expectedWorkflow) {
+        problems.push("GitHub Actions workflow does not match expected config");
+      }
+    }
+    return {
+      client,
+      mode,
+      file: file2,
+      targets,
+      configured: problems.length === 0,
+      problems,
+      expected: { workflow: expectedWorkflow },
+      actual
+    };
+  }
   if ((mode === "mcp" || mode === "both") && clientConfig) {
-    if (!existsSync5(file2)) {
+    if (!existsSync6(file2)) {
       problems.push("Config file not found");
     } else {
       const current = readConfig(file2);
@@ -36383,8 +36688,26 @@ function getSetupErrorSuggestion(error2, lang) {
   );
 }
 function setup(client, projectDir, globalOpts, dryRun = false, mode = "mcp", shouldWriteInstructions = false) {
+  const isGitHubActions = client === "github-actions";
   const clientConfig = isMcpAgentClient(client) ? CLIENTS[client] : void 0;
-  const file2 = clientConfig ? resolve(projectDir, clientConfig.file) : chooseInstructionsFile(projectDir, client);
+  const file2 = isGitHubActions ? resolve2(projectDir, ".github", "workflows", "antd-cli.yml") : clientConfig ? resolve2(projectDir, clientConfig.file) : chooseInstructionsFile(projectDir, client);
+  if (isGitHubActions) {
+    const workflow = createGitHubActionsWorkflow(globalOpts);
+    const current2 = existsSync6(file2) ? normalizeTextFile(readFileSync8(file2, "utf-8")) : "";
+    const changed2 = current2 !== workflow;
+    if (!dryRun && changed2) {
+      mkdirSync(dirname5(file2), { recursive: true });
+      writeFileSync2(file2, workflow);
+    }
+    return {
+      client,
+      mode,
+      file: file2,
+      changed: changed2,
+      dryRun,
+      config: { workflow }
+    };
+  }
   const shouldWriteMcp = mode === "mcp" || mode === "both";
   const current = shouldWriteMcp && clientConfig ? readConfig(file2) : {};
   const config2 = shouldWriteMcp && clientConfig ? createMergedConfig(current, clientConfig.serverKey, globalOpts) : {};
@@ -36392,7 +36715,7 @@ function setup(client, projectDir, globalOpts, dryRun = false, mode = "mcp", sho
   let instructions;
   let skill;
   if (!dryRun && changed) {
-    mkdirSync(dirname4(file2), { recursive: true });
+    mkdirSync(dirname5(file2), { recursive: true });
     writeFileSync2(file2, stableJson(config2));
   }
   if (mode === "skill" || mode === "both") {
@@ -36419,7 +36742,7 @@ function setup(client, projectDir, globalOpts, dryRun = false, mode = "mcp", sho
   };
 }
 function registerSetupCommand(program2) {
-  program2.command("setup").description("Set up Ant Design MCP/Skill for AI agents").requiredOption("--client <client>", "Agent client: claude, cursor, vscode, or codex").option("--mode <mode>", "Setup mode: mcp, skill, or both").option("--project <dir>", "Project directory to write config into", process.cwd()).option("--dry-run", "Preview the config without writing files").option("--check", "Check whether the agent is already configured").option("--write-instructions", "Write agent instructions for using the antd MCP server").action((cmdOpts) => {
+  program2.command("setup").description("Set up Ant Design MCP/Skill for AI agents or GitHub Actions").requiredOption("--client <client>", "Agent client: claude, cursor, vscode, codex, or github-actions").option("--mode <mode>", "Setup mode: mcp, skill, both, or ci").option("--project <dir>", "Project directory to write config into", process.cwd()).option("--dry-run", "Preview the config without writing files").option("--check", "Check whether the agent is already configured").option("--write-instructions", "Write agent instructions for using the antd MCP server").action((cmdOpts) => {
     const opts = program2.opts();
     if (!isAgentClient(cmdOpts.client)) {
       const err = createError(
@@ -36430,8 +36753,8 @@ function registerSetupCommand(program2) {
           opts.lang
         ),
         localize(
-          "Use one of: claude, cursor, vscode, codex.",
-          "\u8BF7\u4F7F\u7528: claude, cursor, vscode, codex\u3002",
+          "Use one of: claude, cursor, vscode, codex, github-actions.",
+          "\u8BF7\u4F7F\u7528: claude, cursor, vscode, codex, github-actions\u3002",
           opts.lang
         )
       );
@@ -36448,8 +36771,8 @@ function registerSetupCommand(program2) {
           opts.lang
         ),
         localize(
-          "Use one of: mcp, skill, both.",
-          "\u8BF7\u4F7F\u7528: mcp, skill, both\u3002",
+          "Use one of: mcp, skill, both, ci.",
+          "\u8BF7\u4F7F\u7528: mcp, skill, both, ci\u3002",
           opts.lang
         )
       );
@@ -36457,7 +36780,7 @@ function registerSetupCommand(program2) {
       process.exitCode = 1;
       return;
     }
-    const mode = cmdOpts.mode ?? (cmdOpts.client === "codex" ? "skill" : "mcp");
+    const mode = cmdOpts.mode ?? (cmdOpts.client === "codex" ? "skill" : cmdOpts.client === "github-actions" ? "ci" : "mcp");
     if (cmdOpts.client === "codex" && mode !== "skill") {
       const err = createError(
         ErrorCodes.INVALID_ARGUMENT,
@@ -36476,6 +36799,42 @@ function registerSetupCommand(program2) {
       process.exitCode = 1;
       return;
     }
+    if (cmdOpts.client === "github-actions" && mode !== "ci") {
+      const err = createError(
+        ErrorCodes.INVALID_ARGUMENT,
+        localize(
+          "GitHub Actions setup only supports '--mode ci'",
+          "GitHub Actions setup \u76EE\u524D\u53EA\u652F\u6301 '--mode ci'",
+          opts.lang
+        ),
+        localize(
+          "Use `antd setup --client github-actions --mode ci` to write the workflow.",
+          "\u8BF7\u4F7F\u7528 `antd setup --client github-actions --mode ci` \u5199\u5165 workflow\u3002",
+          opts.lang
+        )
+      );
+      printError(err, opts.format);
+      process.exitCode = 1;
+      return;
+    }
+    if (cmdOpts.client !== "github-actions" && mode === "ci") {
+      const err = createError(
+        ErrorCodes.INVALID_ARGUMENT,
+        localize(
+          "'--mode ci' is only supported with --client github-actions",
+          "'--mode ci' \u4EC5\u652F\u6301\u4E0E --client github-actions \u4E00\u8D77\u4F7F\u7528",
+          opts.lang
+        ),
+        localize(
+          "Use `--mode mcp`, `--mode skill`, or `--mode both` for agent clients.",
+          "Agent \u5BA2\u6237\u7AEF\u8BF7\u4F7F\u7528 `--mode mcp`\u3001`--mode skill` \u6216 `--mode both`\u3002",
+          opts.lang
+        )
+      );
+      printError(err, opts.format);
+      process.exitCode = 1;
+      return;
+    }
     try {
       const result = cmdOpts.check ? checkAgent(cmdOpts.client, cmdOpts.project, opts, mode, Boolean(cmdOpts.writeInstructions)) : setup(
         cmdOpts.client,
@@ -36505,11 +36864,85 @@ function registerSetupCommand(program2) {
   });
 }
 
+// src/output/banner.ts
+import cfonts from "cfonts";
+
+// src/output/logo.ts
+var HELP_LOGO_TEXT = "       \u2584\u2588\u2588\u2584\n     \u2584\u2588\u2588\u2580\u2580\u2588\u2588\u2584\n   \u2584\u2588\u2588\u2580    \u2580\u2580 \u2584\n \u2584\u2588\u2588\u2580  \u2584\u2584\u2584\u2584  \u2580\u2588\u2588\u2584\n\u2588\u2588\u2588    \u2588\u2588\u2588\u2588    \u2588\u2588\u2588\n \u2580\u2588\u2588\u2584  \u2580\u2580\u2580\u2580  \u2584\u2588\u2588\u2580\n   \u2580\u2588\u2588\u2584    \u2584\u2584 \u2580\n     \u2580\u2588\u2588\u2584\u2584\u2588\u2588\u2580\n       \u2580\u2588\u2588\u2580";
+var HELP_LOGO_ANSI = "       \x1B[38;2;36;191;255m\u2584\x1B[39m\x1B[38;2;39;200;255m\x1B[48;2;37;192;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;40;201;255m\x1B[48;2;39;190;254m\u2580\x1B[39m\x1B[49m\x1B[38;2;44;182;251m\u2584\x1B[39m\n     \x1B[38;2;30;172;255m\u2584\x1B[39m\x1B[38;2;33;181;255m\x1B[48;2;30;173;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;34;183;255m\x1B[48;2;31;175;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;34;184;255m\u2580\x1B[39m\x1B[38;2;58;155;242m\u2580\x1B[39m\x1B[38;2;59;157;242m\x1B[48;2;57;162;244m\u2580\x1B[39m\x1B[49m\x1B[38;2;57;162;244m\x1B[48;2;56;167;245m\u2580\x1B[39m\x1B[49m\x1B[38;2;54;172;247m\u2584\x1B[39m\n   \x1B[38;2;24;153;255m\u2584\x1B[39m\x1B[38;2;27;162;255m\x1B[48;2;24;155;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;27;164;255m\x1B[48;2;25;156;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;28;165;255m\u2580\x1B[39m    \x1B[38;2;54;172;247m\u2580\x1B[39m\x1B[38;2;53;177;248m\u2580\x1B[39m \x1B[38;2;249;106;103m\u2584\x1B[39m\n \x1B[38;2;19;138;255m\u2584\x1B[39m\x1B[38;2;21;144;255m\x1B[48;2;19;139;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;21;145;255m\x1B[48;2;20;140;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;22;147;255m\u2580\x1B[39m  \x1B[38;2;248;87;98m\u2584\x1B[39m\x1B[38;2;248;94;102m\u2584\x1B[39m\x1B[38;2;248;100;104m\u2584\x1B[39m\x1B[38;2;248;100;104m\u2584\x1B[39m  \x1B[38;2;248;94;99m\u2580\x1B[39m\x1B[38;2;248;96;99m\x1B[48;2;248;84;95m\u2580\x1B[39m\x1B[49m\x1B[38;2;248;98;100m\x1B[48;2;248;86;96m\u2580\x1B[39m\x1B[49m\x1B[38;2;248;88;97m\u2584\x1B[39m\n\x1B[38;2;18;134;255m\x1B[48;2;18;131;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;19;135;255m\x1B[48;2;18;132;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;19;136;255m\x1B[48;2;18;131;255m\u2580\x1B[39m\x1B[49m    \x1B[38;2;247;71;89m\x1B[48;2;246;58;75m\u2580\x1B[39m\x1B[49m\x1B[38;2;247;76;92m\x1B[48;2;246;61;78m\u2580\x1B[39m\x1B[49m\x1B[38;2;247;80;95m\x1B[48;2;247;65;82m\u2580\x1B[39m\x1B[49m\x1B[38;2;248;85;97m\x1B[48;2;247;68;86m\u2580\x1B[39m\x1B[49m    \x1B[38;2;247;74;91m\x1B[48;2;247;65;82m\u2580\x1B[39m\x1B[49m\x1B[38;2;247;76;92m\x1B[48;2;247;67;85m\u2580\x1B[39m\x1B[49m\x1B[38;2;247;78;93m\x1B[48;2;247;69;87m\u2580\x1B[39m\x1B[49m\n \x1B[38;2;17;128;255m\u2580\x1B[39m\x1B[38;2;17;128;255m\x1B[48;2;16;125;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;17;128;255m\x1B[48;2;16;125;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;16;124;255m\u2584\x1B[39m  \x1B[38;2;246;48;64m\u2580\x1B[39m\x1B[38;2;246;48;64m\u2580\x1B[39m\x1B[38;2;246;51;67m\u2580\x1B[39m\x1B[38;2;246;56;73m\u2580\x1B[39m  \x1B[38;2;246;45;61m\u2584\x1B[39m\x1B[38;2;246;55;71m\x1B[48;2;246;47;63m\u2580\x1B[39m\x1B[49m\x1B[38;2;246;57;74m\x1B[48;2;246;49;66m\u2580\x1B[39m\x1B[49m\x1B[38;2;246;59;77m\u2580\x1B[39m\n   \x1B[38;2;15;121;255m\u2580\x1B[39m\x1B[38;2;16;121;255m\x1B[48;2;15;118;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;15;121;255m\x1B[48;2;15;118;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;15;118;255m\u2584\x1B[39m    \x1B[38;2;15;120;255m\u2584\x1B[39m\x1B[38;2;15;121;255m\u2584\x1B[39m \x1B[38;2;246;41;57m\u2580\x1B[39m\n     \x1B[38;2;14;114;255m\u2580\x1B[39m\x1B[38;2;14;115;255m\x1B[48;2;13;111;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;14;114;255m\x1B[48;2;13;111;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;13;111;255m\u2584\x1B[39m\x1B[38;2;13;111;255m\u2584\x1B[39m\x1B[38;2;14;116;255m\x1B[48;2;14;112;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;15;117;255m\x1B[48;2;14;113;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;15;117;255m\u2580\x1B[39m\n       \x1B[38;2;13;108;255m\u2580\x1B[39m\x1B[38;2;13;108;255m\x1B[48;2;12;104;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;13;108;255m\x1B[48;2;12;105;255m\u2580\x1B[39m\x1B[49m\x1B[38;2;13;109;255m\u2580\x1B[39m";
+
+// src/output/banner.ts
+var HELP_BANNER_GRADIENT = ["#1677ff", "#2dd9ff", "#ff4d4f"];
+var ANSI_ESCAPE_PATTERN = /^\u001b\[[0-9;]*m/;
+function shouldUseTerminalColor() {
+  if (process.env.FORCE_COLOR && process.env.FORCE_COLOR !== "0") {
+    return true;
+  }
+  return Boolean(process.stdout.isTTY && !process.env.NO_COLOR && process.env.TERM !== "dumb");
+}
+function createHelpBanner(version2, color = shouldUseTerminalColor()) {
+  const wordmark = renderCfonts("ANT DESIGN CLI", {
+    align: "left",
+    font: "tiny",
+    letterSpacing: 1
+  }, color);
+  const label = `@ant-design/cli v${version2}`;
+  const divider = "\u2500".repeat(label.length);
+  const wordmarkLines = wordmark.split("\n").map((line) => trimLineStart(line).trimEnd()).filter(Boolean);
+  const banner = addLogo(wordmarkLines, color);
+  return `
+${banner}
+
+${label}
+${divider}
+`;
+}
+function renderCfonts(text, options, color) {
+  const rendered = cfonts.render(text, {
+    ...options,
+    colors: ["system"],
+    gradient: color ? HELP_BANNER_GRADIENT : false,
+    independentGradient: true,
+    lineHeight: 0,
+    maxLength: 0,
+    spaceless: true,
+    transitionGradient: true
+  });
+  return rendered?.string || text;
+}
+function trimLineStart(line) {
+  let index = 0;
+  let pendingAnsi = "";
+  while (index < line.length) {
+    const ansiMatch = line.slice(index).match(ANSI_ESCAPE_PATTERN);
+    if (ansiMatch) {
+      pendingAnsi += ansiMatch[0];
+      index += ansiMatch[0].length;
+      continue;
+    }
+    if (/\s/.test(line[index])) {
+      pendingAnsi = "";
+      index += 1;
+      continue;
+    }
+    break;
+  }
+  return `${pendingAnsi}${line.slice(index)}`;
+}
+function addLogo(wordmarkLines, color) {
+  const logo = color ? HELP_LOGO_ANSI : HELP_LOGO_TEXT;
+  return `${logo}
+
+${wordmarkLines.join("\n")}`;
+}
+
 // src/index.ts
-var CLI_VERSION = "6.5.0";
+var CLI_VERSION = "6.5.2";
 function createProgram() {
   const program2 = new Command();
-  program2.name("antd").description("CLI tool for querying antd knowledge and analyzing antd usage").option("--format <format>", "Output format: json, text, or markdown", "text").option("--version <version>", "Target antd version (e.g. 5.20.0)").option("--lang <lang>", "Output language: en or zh", "en").option("--detail", "Full information output", false);
+  let displayedRootHelp = false;
+  program2.name("antd").description("CLI tool for querying antd knowledge and analyzing antd usage").addHelpCommand("help [command]", "display help for command").option("--format <format>", "Output format: json, text, or markdown", "text").option("--version <version>", "Target antd version (e.g. 5.20.0)").option("--lang <lang>", "Output language: en or zh", "en").option("--detail", "Full information output", false);
+  program2.addHelpText("before", () => createHelpBanner(CLI_VERSION));
   program2.addOption(new Option("-V, --cli-version", "Output the CLI version number"));
   program2.on("option:cli-version", () => {
     console.log(CLI_VERSION);
@@ -36533,6 +36966,10 @@ function createProgram() {
   registerUpgradeCommand(program2);
   registerBugCommand(program2);
   registerBugCliCommand(program2);
+  program2.action(() => {
+    displayedRootHelp = true;
+    program2.outputHelp();
+  });
   program2.hook("preAction", () => {
     const opts = program2.opts();
     const validFormats = ["json", "text", "markdown"];
@@ -36545,12 +36982,15 @@ function createProgram() {
     }
   });
   program2.hook("postAction", async () => {
+    if (displayedRootHelp) {
+      return;
+    }
     await checkForUpdate();
   });
   return program2;
 }
 if (!process.env.VITEST) {
-  createProgram().parseAsync();
+  await createProgram().parseAsync();
 }
 export {
   createProgram