@agile-team/robot-cli 3.0.3 → 3.0.5

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [3.0.4] - 2026-03-29
+
+### Changed (Breaking)
+
+- **彻底重写下载策略 — `git clone --depth=1` 作为主方案**
+  - 根本原因分析：HTTP ZIP 下载受到国内网络封锁、Gitee 登录拦截、Content-Type 不一致等各种干扰，是错误的技术路线
+  - `git clone --depth=1` 是 create-vue / create-vite / degit / giget 等所有主流 CLI 的底层实现
+  - 自动继承用户系统级 git 代理配置 (`http.proxy` / `https.proxy`)，无需 CLI 工具自己处理网络问题
+  - 实时显示 git 进度条（解析 git stderr 百分比输出）
+  - 无超时问题：git 自己管理连接，有数据在流就不断
+  - 无 ZIP 解析问题：直接输出目录结构
+
+- **优先顺序**：Gitee git clone（国内快）→ GitHub git clone → HTTP ZIP 兜底（仅当系统无 git 时）
+
+- **缓存前置**：启动时先检查缓存，命中则直接用，不发起任何网络请求
+
 ## [3.0.3] - 2026-03-29
 
 ### Fixed

package/dist/index.js

@@ -18,6 +18,7 @@ import { execSync as execSync2 } from "child_process";
 import fs from "fs-extra";
 import path from "path";
 import os from "os";
+import { spawn } from "child_process";
 import chalk from "chalk";
 import extract from "extract-zip";
 
@@ -53,7 +54,8 @@ var TEMPLATE_CATEGORIES = {
                 description: "\u57FA\u7840\u67B6\u6784\u3001\u6838\u5FC3\u529F\u80FD\u3001\u5FEB\u901F\u542F\u52A8",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Admin_Base",
                 features: ["Naive UI", "Vue Router", "Pinia", "\u57FA\u7840\u5E03\u5C40"],
-                version: "base"
+                version: "base",
+                status: "coming-soon"
               }
             }
           },
@@ -107,14 +109,16 @@ var TEMPLATE_CATEGORIES = {
                 description: "Ant Design + \u5B8C\u6574\u529F\u80FD\u6F14\u793A",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_React",
                 features: ["Ant Design", "React Router", "Redux Toolkit"],
-                version: "full"
+                version: "full",
+                status: "coming-soon"
               },
               "robot-react-base": {
                 name: "Robot React \u7CBE\u7B80\u7248",
                 description: "\u57FA\u7840React + \u6838\u5FC3\u529F\u80FD",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_React_Base",
                 features: ["React", "React Router", "\u57FA\u7840\u7EC4\u4EF6"],
-                version: "base"
+                version: "base",
+                status: "coming-soon"
               }
             }
           }
@@ -144,7 +148,8 @@ var TEMPLATE_CATEGORIES = {
                 description: "\u57FA\u7840\u6846\u67B6 + \u6838\u5FC3\u529F\u80FD",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Uniapp_Base",
                 features: ["\u57FA\u7840\u6846\u67B6", "\u8DEF\u7531\u914D\u7F6E"],
-                version: "base"
+                version: "base",
+                status: "coming-soon"
               }
             }
           }
@@ -173,14 +178,16 @@ var TEMPLATE_CATEGORIES = {
                   "Redis",
                   "\u5FAE\u670D\u52A1"
                 ],
-                version: "full"
+                version: "full",
+                status: "coming-soon"
               },
               "robot-nest-base": {
                 name: "Robot NestJS \u7CBE\u7B80\u7248",
                 description: "\u57FA\u7840 NestJS + \u6838\u5FC3\u6A21\u5757",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Nest_Base",
                 features: ["NestJS", "\u57FA\u7840\u8DEF\u7531", "\u9519\u8BEF\u5904\u7406"],
-                version: "base"
+                version: "base",
+                status: "coming-soon"
               }
             }
           },
@@ -192,7 +199,8 @@ var TEMPLATE_CATEGORIES = {
                 description: "NestJS + \u5FAE\u670D\u52A1\u67B6\u6784 + gRPC + \u670D\u52A1\u53D1\u73B0",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Nest_Micro",
                 features: ["NestJS", "\u5FAE\u670D\u52A1", "gRPC", "Redis", "\u670D\u52A1\u53D1\u73B0"],
-                version: "micro"
+                version: "micro",
+                status: "coming-soon"
               }
             }
           }
@@ -214,14 +222,16 @@ var TEMPLATE_CATEGORIES = {
                 description: "Vue3 + Electron + \u81EA\u52A8\u66F4\u65B0 + \u539F\u751F\u80FD\u529B",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Electron",
                 features: ["Vue3", "Electron", "\u81EA\u52A8\u66F4\u65B0", "\u539F\u751FAPI"],
-                version: "full"
+                version: "full",
+                status: "coming-soon"
               },
               "robot-electron-base": {
                 name: "Robot Electron \u7CBE\u7B80\u7248",
                 description: "\u57FA\u7840Electron + Vue\u6846\u67B6",
                 repoUrl: "https://github.com/ChenyCHENYU/Robot_Electron_Base",
                 features: ["Vue3", "Electron", "\u57FA\u7840\u529F\u80FD"],
-                version: "base"
+                version: "base",
+                status: "coming-soon"
               }
             }
           }
@@ -482,6 +492,43 @@ function assertZipBuffer(buffer, sourceName) {
     );
   }
 }
+async function gitCloneTemplate(repoUrl, branch, targetDir, spinner) {
+  return new Promise((resolve, reject) => {
+    if (spinner) spinner.text = `\u8FDE\u63A5\u4E2D...`;
+    const args = [
+      "clone",
+      "--depth=1",
+      "--single-branch",
+      "--branch",
+      branch,
+      repoUrl,
+      targetDir
+    ];
+    const proc = spawn("git", args, { stdio: ["ignore", "ignore", "pipe"] });
+    proc.stderr?.on("data", (chunk) => {
+      if (!spinner) return;
+      const text3 = chunk.toString();
+      const pctMatch = text3.match(/(\d+)%\s*\((\d+)\/(\d+)\)/);
+      if (pctMatch) {
+        const pct = parseInt(pctMatch[1]);
+        const filled = Math.round(pct / 5);
+        const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
+        const speed = text3.match(/([\d.]+\s*[KMG]iB\/s)/)?.[1] ?? "";
+        spinner.text = `\u4E0B\u8F7D\u4E2D [${bar}] ${pct}%${speed ? "  " + speed : ""}`;
+      } else {
+        const line = text3.split(/\r?\n/).find((l) => l.trim())?.trim() ?? "";
+        if (line && line.length < 80) spinner.text = `\u514B\u9686\u4E2D... ${line}`;
+      }
+    });
+    proc.on("error", (err) => {
+      reject(new Error(err.code === "ENOENT" ? "GIT_NOT_FOUND" : `git \u542F\u52A8\u5931\u8D25: ${err.message}`));
+    });
+    proc.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`git clone \u5931\u8D25 (exit ${code})`));
+    });
+  });
+}
 async function downloadTemplate(template, options = {}) {
   const { spinner, noCache, giteeUrl: optGiteeUrl } = options;
   const branch = template.branch || "main";
@@ -489,15 +536,56 @@ async function downloadTemplate(template, options = {}) {
   if (!template?.repoUrl) {
     throw new Error(`\u6A21\u677F\u914D\u7F6E\u65E0\u6548: ${JSON.stringify(template)}`);
   }
+  if (!noCache) {
+    const cached = await getCachedTemplate(template.repoUrl);
+    if (cached) {
+      if (spinner) spinner.text = "\u5DF2\u4F7F\u7528\u7F13\u5B58\u6A21\u677F\uFF0C\u5982\u9700\u66F4\u65B0\u8BF7\u8FD0\u884C robot cache clear";
+      return cached;
+    }
+  }
+  const cloneSources = [];
+  if (giteeUrl) cloneSources.push({ url: giteeUrl, name: "Gitee" });
+  cloneSources.push({ url: template.repoUrl, name: "GitHub" });
+  let noGit = false;
+  const cloneErrors = [];
+  for (const { url: cloneUrl, name: srcName } of cloneSources) {
+    const tempDir = path.join(os.tmpdir(), `robot-git-${Date.now()}`);
+    try {
+      if (spinner) spinner.text = `\u8FDE\u63A5 ${srcName}...`;
+      await gitCloneTemplate(cloneUrl, branch, tempDir, spinner);
+      await fs.remove(path.join(tempDir, ".git")).catch(() => {
+      });
+      if (spinner) spinner.text = "\u9A8C\u8BC1\u6A21\u677F\u5B8C\u6574\u6027...";
+      if (!fs.existsSync(path.join(tempDir, "package.json"))) {
+        throw new Error("\u6A21\u677F\u7F3A\u5C11 package.json");
+      }
+      if (!noCache) saveToCache(template.repoUrl, tempDir, branch).catch(() => {
+      });
+      if (spinner) spinner.text = `\u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210 (${srcName})`;
+      return tempDir;
+    } catch (err) {
+      await fs.remove(tempDir).catch(() => {
+      });
+      const msg = err.message;
+      if (msg === "GIT_NOT_FOUND") {
+        noGit = true;
+        break;
+      }
+      cloneErrors.push(`${srcName}: ${msg}`);
+      if (spinner) spinner.text = `${srcName} \u514B\u9686\u5931\u8D25\uFF0C\u5C1D\u8BD5\u4E0B\u4E00\u4E2A\u6E90...`;
+      await new Promise((r) => setTimeout(r, 500));
+    }
+  }
+  if (noGit && spinner) spinner.text = "\u7CFB\u7EDF\u672A\u5B89\u88C5 git\uFF0C\u5207\u6362\u5230 HTTP \u4E0B\u8F7D...";
   try {
-    if (spinner) spinner.text = "\u5F00\u59CB\u4E0B\u8F7D\u6700\u65B0\u6A21\u677F...";
+    if (spinner) spinner.text = "HTTP \u4E0B\u8F7D\u6A21\u677F\u4E2D...";
     const { response, sourceName } = await tryDownload(
       template.repoUrl,
       branch,
       spinner,
       giteeUrl
     );
-    if (spinner) spinner.text = "\u4FDD\u5B58\u4E0B\u8F7D\u6587\u4EF6...";
+    if (spinner) spinner.text = "\u4FDD\u5B58\u6587\u4EF6...";
     const timestamp = Date.now();
     const tempZip = path.join(os.tmpdir(), `robot-template-${timestamp}.zip`);
     const tempExtract = path.join(os.tmpdir(), `robot-extract-${timestamp}`);
@@ -517,7 +605,7 @@ async function downloadTemplate(template, options = {}) {
         const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
         const sizeMB = (received / 1024 / 1024).toFixed(1);
         const totalMB = (totalSize / 1024 / 1024).toFixed(1);
-        spinner.text = `\u4E0B\u8F7D\u4E2D [${bar}] ${pct}% ${sizeMB}MB/${totalMB}MB (${sourceName})`;
+        spinner.text = `\u4E0B\u8F7D\u4E2D [${bar}] ${pct}% ${sizeMB}/${totalMB}MB (${sourceName})`;
       }
       const buffer = Buffer.concat(chunks);
       assertZipBuffer(buffer, sourceName);
@@ -529,59 +617,48 @@ async function downloadTemplate(template, options = {}) {
     }
     if (spinner) spinner.text = "\u89E3\u538B\u6A21\u677F\u6587\u4EF6...";
     await extract(tempZip, { dir: tempExtract });
-    if (spinner) spinner.text = "\u67E5\u627E\u9879\u76EE\u7ED3\u6784...";
     const extractedItems = await fs.readdir(tempExtract);
     const repoName = template.repoUrl.split("/").pop() || "";
     const projectDir = extractedItems.find(
       (item) => item === `${repoName}-${branch}` || item.endsWith(`-${branch}`) || item.endsWith("-main") || item.endsWith("-master") || item === repoName
     );
     if (!projectDir) {
-      throw new Error(
-        `\u89E3\u538B\u540E\u627E\u4E0D\u5230\u9879\u76EE\u76EE\u5F55\uFF0C\u53EF\u7528\u76EE\u5F55: ${extractedItems.join(", ")}`
-      );
+      throw new Error(`\u89E3\u538B\u540E\u627E\u4E0D\u5230\u9879\u76EE\u76EE\u5F55\uFF0C\u53EF\u7528\u76EE\u5F55: ${extractedItems.join(", ")}`);
     }
     const sourcePath = path.join(tempExtract, projectDir);
-    if (spinner) spinner.text = "\u9A8C\u8BC1\u6A21\u677F\u5B8C\u6574\u6027...";
     if (!fs.existsSync(path.join(sourcePath, "package.json"))) {
       throw new Error("\u6A21\u677F\u7F3A\u5C11 package.json \u6587\u4EF6");
     }
-    if (!noCache) {
-      saveToCache(template.repoUrl, sourcePath, branch).catch(() => {
-      });
-    }
-    if (spinner) spinner.text = `\u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210 (via ${sourceName})`;
+    if (!noCache) saveToCache(template.repoUrl, sourcePath, branch).catch(() => {
+    });
+    if (spinner) spinner.text = `\u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210 (HTTP/${sourceName})`;
     await fs.remove(tempZip).catch(() => {
     });
     return sourcePath;
-  } catch (downloadError) {
+  } catch (httpError) {
     if (!noCache) {
       const cached = await getCachedTemplate(template.repoUrl);
       if (cached) {
         if (spinner) spinner.text = "\u7F51\u7EDC\u4E0D\u53EF\u7528\uFF0C\u4F7F\u7528\u7F13\u5B58\u6A21\u677F...";
-        console.log();
-        console.log(`  ${chalk.yellow("  \u6CE8\u610F: \u4F7F\u7528\u7F13\u5B58\u7248\u672C\uFF08\u975E\u6700\u65B0\uFF09")}`);
+        console.log(`
+  ${chalk.yellow("\u6CE8\u610F: \u5DF2\u4F7F\u7528\u7F13\u5B58\u7248\u672C\uFF08\u975E\u6700\u65B0\uFF09")}`);
         return cached;
       }
     }
     try {
       const tmpFiles = await fs.readdir(os.tmpdir());
       for (const f of tmpFiles.filter(
-        (x) => x.includes("robot-template-") || x.includes("robot-extract-")
+        (x) => x.includes("robot-template-") || x.includes("robot-extract-") || x.includes("robot-git-")
       )) {
         await fs.remove(path.join(os.tmpdir(), f)).catch(() => {
         });
       }
     } catch {
     }
-    const errMsg = downloadError.message;
-    const isTimeout = errMsg.includes("aborted") || errMsg.includes("timeout") || downloadError.name === "TimeoutError";
-    let msg = `\u6A21\u677F\u4E0B\u8F7D\u5931\u8D25: ${errMsg}`;
-    if (isTimeout) {
-      msg += "\n\n  \u5EFA\u8BAE:\n  1. \u5F53\u524D\u7F51\u7EDC\u8FDE\u63A5\u8F83\u6162\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\n  2. \u5982\u679C\u5728\u56FD\u5185\uFF0C\u5C1D\u8BD5\u4F7F\u7528\u4EE3\u7406\u6216\u79D1\u5B66\u4E0A\u7F51\n  3. \u4F7F\u7528 robot doctor \u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5";
-    } else if (downloadError.code === "ENOTFOUND") {
-      msg += "\n\n  \u5EFA\u8BAE:\n  1. \u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5\u662F\u5426\u6B63\u5E38\n  2. \u5982\u679C\u5728\u56FD\u5185\uFF0C\u5C1D\u8BD5\u4F7F\u7528\u4EE3\u7406\n  3. \u7A0D\u540E\u91CD\u8BD5";
-    }
-    throw new Error(msg);
+    const errMsg = httpError.message;
+    const allErrors = [...cloneErrors, `HTTP: ${errMsg}`].map((e) => `  - ${e}`).join("\n");
+    throw new Error(`\u6A21\u677F\u4E0B\u8F7D\u5931\u8D25\uFF0C\u6240\u6709\u65B9\u5F0F\u5747\u4E0D\u53EF\u7528:
+${allErrors}`);
   }
 }
 
@@ -880,6 +957,9 @@ function formatBytes(bytes) {
 
 // src/create.ts
 var STRIP_VERSION_RE = /\s*(完整版|精简版|微服务版)\s*$/;
+function filterAvailable(map) {
+  return Object.fromEntries(Object.entries(map).filter(([, t]) => t.status !== "coming-soon"));
+}
 async function createProject(projectName, options = {}) {
   p.intro(chalk3.bgCyan.black(" Robot CLI - \u5F00\u59CB\u521B\u5EFA\u9879\u76EE "));
   let template;
@@ -1014,6 +1094,7 @@ async function selectFromRecommended() {
   p.log.info(chalk3.bold("\u63A8\u8350\u6A21\u677F") + chalk3.dim(" \u2014 \u57FA\u4E8E\u56E2\u961F\u4F7F\u7528\u9891\u7387\u548C\u9879\u76EE\u6210\u719F\u5EA6\u63A8\u8350"));
   const options = [];
   for (const [key, template] of Object.entries(recommended)) {
+    if (template.status === "coming-soon") continue;
     const ver = VERSION_LABELS[template.version] || template.version;
     const tags = template.features.slice(0, 3).join(", ");
     options.push({
@@ -1083,7 +1164,15 @@ async function selectByCategory() {
       if (pk === "back") continue;
       patternKey = pk;
     }
-    const templates = getTemplatesByCategory(catKey, stackKey, patternKey);
+    const allTemplates = getTemplatesByCategory(catKey, stackKey, patternKey);
+    const templates = filterAvailable(allTemplates);
+    const comingSoonCount = Object.keys(allTemplates).length - Object.keys(templates).length;
+    if (Object.keys(templates).length === 0) {
+      const names = Object.values(allTemplates).map((t2) => t2.name).join("\u3001");
+      p.log.warn(`\u8BE5\u5206\u7C7B\u4E0B\u7684\u6A21\u677F\u6B63\u5728\u5EFA\u8BBE\u4E2D\uFF0C\u656C\u8BF7\u671F\u5F85 (${names})`);
+      await new Promise((r) => setTimeout(r, 600));
+      continue;
+    }
     const tplOptions = Object.entries(templates).map(([key, t2]) => {
       const ver = VERSION_LABELS[t2.version] || t2.version;
       return {
@@ -1092,6 +1181,13 @@ async function selectByCategory() {
         hint: t2.description
       };
     });
+    if (comingSoonCount > 0) {
+      tplOptions.push({
+        value: "__coming_soon__",
+        label: chalk3.dim(`+ ${comingSoonCount} \u4E2A\u6A21\u677F\u5F00\u53D1\u4E2D...`),
+        hint: "\u656C\u8BF7\u671F\u5F85"
+      });
+    }
     tplOptions.push({ value: "back", label: "<- \u8FD4\u56DE", hint: "" });
     const tplKey = await p.select({
       message: "\u8BF7\u9009\u62E9\u6A21\u677F\u7248\u672C:",
@@ -1099,6 +1195,11 @@ async function selectByCategory() {
     });
     if (p.isCancel(tplKey)) process.exit(0);
     if (tplKey === "back") continue;
+    if (tplKey === "__coming_soon__") {
+      p.log.warn("\u8BE5\u6A21\u677F\u6B63\u5728\u5F00\u53D1\u4E2D\uFF0C\u656C\u8BF7\u671F\u5F85\uFF01");
+      await new Promise((r) => setTimeout(r, 600));
+      continue;
+    }
     const t = templates[tplKey];
     return { key: tplKey, ...t };
   }
@@ -1111,7 +1212,8 @@ async function selectBySearch() {
     });
     if (p.isCancel(keyword)) return await selectTemplateMethod();
     const results = searchTemplates(keyword);
-    if (Object.keys(results).length === 0) {
+    const availableResults = filterAvailable(results);
+    if (Object.keys(availableResults).length === 0) {
       p.log.warn(`\u6CA1\u6709\u627E\u5230\u5339\u914D\u7684\u6A21\u677F (\u5173\u952E\u8BCD: "${keyword}")`);
       const action = await p.select({
         message: "\u8BF7\u9009\u62E9\u4E0B\u4E00\u6B65\u64CD\u4F5C:",
@@ -1123,9 +1225,9 @@ async function selectBySearch() {
       if (p.isCancel(action) || action === "back") return await selectTemplateMethod();
       continue;
     }
-    p.log.info(`\u5173\u952E\u8BCD: "${keyword}" -- \u627E\u5230 ${Object.keys(results).length} \u4E2A\u5339\u914D\u6A21\u677F`);
+    p.log.info(`\u5173\u952E\u8BCD: "${keyword}" -- \u627E\u5230 ${Object.keys(availableResults).length} \u4E2A\u5339\u914D\u6A21\u677F`);
     const options = [];
-    for (const [key, t2] of Object.entries(results)) {
+    for (const [key, t2] of Object.entries(availableResults)) {
       const ver = VERSION_LABELS[t2.version] || t2.version;
       const info = t2.features.slice(0, 3).join(", ");
       options.push({
@@ -1145,18 +1247,22 @@ async function selectBySearch() {
     if (p.isCancel(selected)) process.exit(0);
     if (selected === "search_again") continue;
     if (selected === "back_to_mode") return await selectTemplateMethod();
-    const t = results[selected];
+    const t = availableResults[selected];
     return { key: selected, ...t };
   }
 }
 async function selectFromAll() {
   const allTemplates = getAllTemplates();
-  p.log.info(chalk3.bold("\u6240\u6709\u53EF\u7528\u6A21\u677F") + chalk3.dim(` -- \u5171 ${Object.keys(allTemplates).length} \u4E2A\u6A21\u677F\u53EF\u9009`));
+  const availableTemplates = filterAvailable(allTemplates);
+  const comingSoonCount = Object.keys(allTemplates).length - Object.keys(availableTemplates).length;
+  const countInfo = comingSoonCount > 0 ? chalk3.dim(` -- \u5171 ${Object.keys(availableTemplates).length} \u4E2A\u53EF\u7528\uFF0C${comingSoonCount} \u4E2A\u5F00\u53D1\u4E2D`) : chalk3.dim(` -- \u5171 ${Object.keys(availableTemplates).length} \u4E2A\u6A21\u677F\u53EF\u9009`);
+  p.log.info(chalk3.bold("\u6240\u6709\u53EF\u7528\u6A21\u677F") + countInfo);
   const options = [];
   for (const [_catKey, category] of Object.entries(TEMPLATE_CATEGORIES)) {
     for (const [_sKey, stack] of Object.entries(category.stacks)) {
       for (const _pattern of Object.values(stack.patterns)) {
         for (const [key, t2] of Object.entries(_pattern.templates)) {
+          if (t2.status === "coming-soon") continue;
           const ver = VERSION_LABELS[t2.version] || t2.version;
           options.push({
             value: key,
@@ -1174,7 +1280,7 @@ async function selectFromAll() {
   });
   if (p.isCancel(selected)) process.exit(0);
   if (selected === "back_to_mode") return await selectTemplateMethod();
-  const t = allTemplates[selected];
+  const t = availableTemplates[selected];
   return { key: selected, ...t };
 }
 async function configureProject(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/robot-cli",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "现代化项目脚手架工具，支持多技术栈快速创建项目 - 优先 bun，兼容 npm/pnpm/yarn",
   "type": "module",
   "bin": {