create-szyy-app 1.0.2 → 1.0.4

package/README.md

@@ -17,12 +17,13 @@ npx create-szyy-app my-order-sys --yes --minimal
 
 ## 选项
 
-| 选项                | 说明                                                 |
-| ------------------- | ---------------------------------------------------- |
-| `[project-name]`    | 项目名称（kebab-case，小写字母开头）                 |
-| `-p, --port <port>` | 联调端口，写入 `.env` / `.env.micro` 等（默认 5690） |
-| `--minimal`         | 删除 `templateSys` Demo，仅保留首页菜单              |
-| `-y, --yes`         | 跳过交互，使用默认值                                 |
+| 选项                   | 说明                                                 |
+| ---------------------- | ---------------------------------------------------- |
+| `[project-name]`       | 项目名称（kebab-case，小写字母开头）                 |
+| `-p, --port <port>`    | 联调端口，写入 `.env` / `.env.micro` 等（默认 5690） |
+| `--template-tag <tag>` | 覆盖模板 Git tag                                     |
+| `--minimal`            | 删除 `templateSys` Demo，仅保留首页菜单              |
+| `-y, --yes`            | 跳过交互，使用默认值                                 |
 
 > **注意：** `pnpm dev` 独立模式端口固定 **3000**（`.env.development`），不受 `--port` 影响。`pnpm dev:micro` 使用 `--port` 配置的联调端口。
 
@@ -42,10 +43,15 @@ pnpm build:prod   # 生产构建
 | -------------------- | --------------------------------------------------------------------------------- |
 | `SZYY_TEMPLATE_REPO` | 覆盖模板 Git 仓库 URL（默认 `http://172.1.1.65/RDKit/sunyard-szyy-app-template`） |
 | `SZYY_TEMPLATE_PATH` | 使用本地目录作为模板（开发/联调 CLI 时使用）                                      |
+| `SZYY_TEMPLATE_TAG`  | 覆盖模板 Git tag                                                                  |
+| `SZYY_VERSIONS_URL`  | 覆盖远程版本配置 URL（默认从模板仓 `create-app` 分支拉取 `versions.json`）        |
+| `SZYY_VERSIONS_PATH` | 使用本地 `versions.json`（开发/联调 CLI 时使用）                                  |
 
 ## 版本锁定
 
-依赖版本由 `templates/versions.json` 统一管理，生成项目的 `package.json` 会写死精确版本号（无 `^`）。
+版本配置默认从模板仓 **`create-app` 分支** 的 `versions.json` 远程拉取；拉取失败时使用 npm 包内置配置兜底。更新模板 tag 或依赖版本时，只需修改模板仓 `create-app` 分支上的 `versions.json`，**无需重新发布 CLI**。
+
+生成项目的 `package.json` 会写死精确版本号（无 `^`）。
 
 ## 开发 CLI
 
@@ -54,7 +60,7 @@ pnpm install
 pnpm build
 
 # 使用本地模板联调
-SZYY_TEMPLATE_PATH=../sunyard-szyy-app-template node dist/index.js test-app --yes
+SZYY_TEMPLATE_PATH=../sunyard-szyy-app-template SZYY_VERSIONS_PATH=../sunyard-szyy-app-template/versions.json node dist/index.js test-app --yes
 ```
 
 ## 发布
@@ -77,11 +83,12 @@ pnpm publish:pkg --tag=beta
 
 ## 故障排查
 
-| 问题           | 处理                                                          |
-| -------------- | ------------------------------------------------------------- |
-| degit 拉取失败 | 检查内网 Git 连通性，或设置 `SZYY_TEMPLATE_PATH` 使用本地模板 |
-| 占位符残留报错 | 确认模板 tag 与 `versions.json` 中 `template` 版本一致        |
-| 联调端口冲突   | 创建时指定 `--port`，或修改生成项目 `.env.micro`              |
+| 问题             | 处理                                                                                |
+| ---------------- | ----------------------------------------------------------------------------------- |
+| degit 拉取失败   | 检查内网 Git 连通性，或设置 `SZYY_TEMPLATE_PATH` 使用本地模板                       |
+| 占位符残留报错   | 确认模板 tag 与远程/本地 `versions.json` 中 `template` 版本一致                     |
+| 版本配置拉取失败 | 检查内网 Git 连通性，CLI 会自动回退内置配置；可用 `SZYY_VERSIONS_PATH` 指定本地配置 |
+| 联调端口冲突     | 创建时指定 `--port`，或修改生成项目 `.env.micro`                                    |
 
 ## 延伸阅读
 

package/dist/index.js

@@ -1,32 +1,133 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import fs3 from "fs";
-import path4 from "path";
+import fs4 from "fs";
+import path5 from "path";
 import { Command } from "commander";
 import * as p2 from "@clack/prompts";
 import pc2 from "picocolors";
 
 // src/prompts.ts
-import path2 from "path";
+import path from "path";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
 
+// src/validate.ts
+function validateName(name) {
+  if (!name) return "\u9879\u76EE\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
+  if (!/^[a-z][a-z0-9-_]*$/.test(name)) {
+    return "\u9879\u76EE\u540D\u79F0\u53EA\u80FD\u5305\u542B\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u8FDE\u5B57\u7B26(-)\u6216\u4E0B\u5212\u7EBF(_)\uFF0C\u4E14\u4EE5\u5B57\u6BCD\u5F00\u5934";
+  }
+  return null;
+}
+function validatePort(port) {
+  const n = Number(port);
+  if (!port || isNaN(n) || !Number.isInteger(n) || n < 1024 || n > 65535) {
+    return "\u7AEF\u53E3\u53F7\u5FC5\u987B\u662F 1024 ~ 65535 \u4E4B\u95F4\u7684\u6574\u6570";
+  }
+  return null;
+}
+function toAppTitle(name) {
+  return name.split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function toAppNameUpper(name) {
+  return name.replace(/[-_]/g, "").toUpperCase();
+}
+
+// src/prompts.ts
+async function collectOptions(projectNameArg, flags, versions) {
+  const cwd = process.cwd();
+  p.intro(`${pc.bgCyan(pc.black(" create-szyy-app "))} \u5FAE\u524D\u7AEF\u5B50\u5E94\u7528\u811A\u624B\u67B6`);
+  let appName = projectNameArg?.trim() || "";
+  if (!flags.yes || !appName) {
+    const nameResult = await p.text({
+      message: "\u9879\u76EE\u540D\u79F0",
+      placeholder: "my-order-sys",
+      initialValue: appName || void 0,
+      validate: (value) => validateName(value?.trim() || "") ?? void 0
+    });
+    if (p.isCancel(nameResult)) {
+      p.cancel("\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    appName = nameResult.trim();
+  } else {
+    const nameError = validateName(appName);
+    if (nameError) {
+      p.log.error(nameError);
+      return null;
+    }
+  }
+  let appPort = flags.port ?? versions.defaultPort;
+  if (!flags.yes || flags.port === void 0) {
+    const portResult = await p.text({
+      message: "\u672C\u5730\u8054\u8C03\u7AEF\u53E3",
+      placeholder: String(versions.defaultPort),
+      initialValue: String(appPort),
+      validate: (value) => {
+        const port = value?.trim() || String(versions.defaultPort);
+        return validatePort(port) ?? void 0;
+      }
+    });
+    if (p.isCancel(portResult)) {
+      p.cancel("\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    appPort = Number(portResult.trim() || versions.defaultPort);
+  } else {
+    const portError = validatePort(appPort);
+    if (portError) {
+      p.log.error(portError);
+      return null;
+    }
+  }
+  let keepDemo = !flags.minimal;
+  if (!flags.yes && flags.minimal === void 0) {
+    const demoResult = await p.confirm({
+      message: "\u662F\u5426\u4FDD\u7559 Demo \u9875",
+      initialValue: true
+    });
+    if (p.isCancel(demoResult)) {
+      p.cancel("\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    keepDemo = demoResult;
+  }
+  const defaultTarget = path.resolve(cwd, appName);
+  let targetDir = defaultTarget;
+  if (!flags.yes) {
+    const dirResult = await p.text({
+      message: "\u76EE\u6807\u76EE\u5F55",
+      initialValue: defaultTarget,
+      validate: (value) => {
+        if (!value?.trim()) return "\u76EE\u6807\u76EE\u5F55\u4E0D\u80FD\u4E3A\u7A7A";
+        return void 0;
+      }
+    });
+    if (p.isCancel(dirResult)) {
+      p.cancel("\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    targetDir = path.resolve(dirResult.trim());
+  }
+  return {
+    appName,
+    appNameUpper: toAppNameUpper(appName),
+    appTitle: toAppTitle(appName),
+    appPort,
+    targetDir,
+    keepDemo
+  };
+}
+
 // src/replace.ts
 import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
-function loadVersions() {
-  const versionsPath = path.resolve(__dirname, "../templates/versions.json");
-  return JSON.parse(fs.readFileSync(versionsPath, "utf-8"));
-}
+import path2 from "path";
 function stripRange(version) {
   return version.replace(/^[\^~>=<]+/, "");
 }
 function pinDependencies(targetDir, versions) {
-  const pkgPath = path.join(targetDir, "package.json");
+  const pkgPath = path2.join(targetDir, "package.json");
   const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
   for (const section of ["dependencies", "devDependencies"]) {
     const deps = pkg[section];
@@ -65,13 +166,13 @@ var INCLUDE_EXTENSIONS = [
 var INCLUDE_BASENAMES = [".env", ".env.development", ".env.production", ".env.micro", ".env.sit", ".gitignore"];
 var PORT_SKIP_FILES = /* @__PURE__ */ new Set([".env.development"]);
 function shouldSkip(filePath, rootDir) {
-  const rel = path.relative(rootDir, filePath);
-  return SKIP_PATTERNS.some((p3) => rel === p3 || rel.startsWith(`${p3}${path.sep}`) || rel.startsWith(`${p3}/`));
+  const rel = path2.relative(rootDir, filePath);
+  return SKIP_PATTERNS.some((p3) => rel === p3 || rel.startsWith(`${p3}${path2.sep}`) || rel.startsWith(`${p3}/`));
 }
 function shouldProcess(filePath) {
-  const base = path.basename(filePath);
+  const base = path2.basename(filePath);
   if (INCLUDE_BASENAMES.includes(base)) return true;
-  const ext = path.extname(filePath);
+  const ext = path2.extname(filePath);
   return !!ext && INCLUDE_EXTENSIONS.includes(ext);
 }
 function replaceInFile(filePath, replacements) {
@@ -97,14 +198,14 @@ function getReplacements(options) {
 }
 function walkReplace(dir, rootDir, options, count) {
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = path.join(dir, entry.name);
+    const fullPath = path2.join(dir, entry.name);
     if (shouldSkip(fullPath, rootDir)) continue;
     if (entry.isDirectory()) {
       walkReplace(fullPath, rootDir, options, count);
       continue;
     }
     if (!entry.isFile() || !shouldProcess(fullPath)) continue;
-    const fileBase = path.basename(fullPath);
+    const fileBase = path2.basename(fullPath);
     const fileReplacements = getReplacements(options).filter(([from]) => {
       if (from === "__APP_PORT__" && PORT_SKIP_FILES.has(fileBase)) return false;
       return true;
@@ -118,14 +219,14 @@ function validateNoPlaceholders(targetDir) {
   const leftovers = [];
   function scan(dir) {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      const fullPath = path.join(dir, entry.name);
+      const fullPath = path2.join(dir, entry.name);
       if (shouldSkip(fullPath, targetDir)) continue;
       if (entry.isDirectory()) {
         scan(fullPath);
       } else if (entry.isFile() && shouldProcess(fullPath)) {
         const content = fs.readFileSync(fullPath, "utf-8");
         if (content.includes("__APP_NAME__") || content.includes("__APP_NAME_UPPER__") || content.includes("__APP_PORT__") || content.includes("__APP_TITLE__")) {
-          leftovers.push(path.relative(targetDir, fullPath));
+          leftovers.push(path2.relative(targetDir, fullPath));
         }
       }
     }
@@ -137,7 +238,7 @@ ${leftovers.map((f) => `  - ${f}`).join("\n")}`);
   }
 }
 function validateDevelopmentPort(targetDir) {
-  const devEnv = path.join(targetDir, ".env.development");
+  const devEnv = path2.join(targetDir, ".env.development");
   const content = fs.readFileSync(devEnv, "utf-8");
   const match = content.match(/^\s*VITE_PORT\s*=\s*(\S+)/m);
   if (!match || match[1] !== "3000") {
@@ -152,11 +253,11 @@ function applyReplacements(targetDir, options) {
   return count.files;
 }
 function applyMinimalMode(targetDir, appName) {
-  const templateSysDir = path.join(targetDir, "src/views/templateSys");
+  const templateSysDir = path2.join(targetDir, "src/views/templateSys");
   if (fs.existsSync(templateSysDir)) {
     fs.rmSync(templateSysDir, { recursive: true, force: true });
   }
-  const menuPath = path.join(targetDir, "mock/authMenuList.ts");
+  const menuPath = path2.join(targetDir, "mock/authMenuList.ts");
   fs.writeFileSync(
     menuPath,
     `export const authMenuList = [
@@ -181,7 +282,7 @@ function applyMinimalMode(targetDir, appName) {
 `,
     "utf-8"
   );
-  const homePath = path.join(targetDir, "src/views/home/index.vue");
+  const homePath = path2.join(targetDir, "src/views/home/index.vue");
   fs.writeFileSync(
     homePath,
     `<template>
@@ -202,32 +303,26 @@ function applyMinimalMode(targetDir, appName) {
     "utf-8"
   );
 }
-function removeGitDir(targetDir) {
-  const gitDir = path.join(targetDir, ".git");
-  if (fs.existsSync(gitDir)) {
-    fs.rmSync(gitDir, { recursive: true, force: true });
-  }
-}
 var GENERATED_CHANGELOG = `# \u53D1\u5E03\u8BB0\u5F55
 
 > \u672C\u9879\u76EE\u6309\u7167\u81EA\u5B9A\u4E49\u63D0\u4EA4\u89C4\u8303\uFF08\u5982 fix: +\u63CF\u8FF0\uFF09\u81EA\u52A8\u751F\u6210\u4EE5\u4E0B\u53D8\u66F4\u8BB0\u5F55\u3002
 `;
 function cleanupTemplateArtifacts(targetDir) {
-  const cursorDir = path.join(targetDir, ".cursor");
+  const cursorDir = path2.join(targetDir, ".cursor");
   if (fs.existsSync(cursorDir)) {
     fs.rmSync(cursorDir, { recursive: true, force: true });
   }
-  const syncScript = path.join(targetDir, "build/sync-to-template.ts");
+  const syncScript = path2.join(targetDir, "build/sync-to-template.ts");
   if (fs.existsSync(syncScript)) {
     fs.rmSync(syncScript, { force: true });
   }
-  fs.writeFileSync(path.join(targetDir, "CHANGELOG.md"), GENERATED_CHANGELOG, "utf-8");
+  fs.writeFileSync(path2.join(targetDir, "CHANGELOG.md"), GENERATED_CHANGELOG, "utf-8");
   cleanupGeneratedPackageJson(targetDir);
   cleanupGeneratedReadme(targetDir);
   cleanupGeneratedGitignore(targetDir);
 }
 function cleanupGeneratedPackageJson(targetDir) {
-  const pkgPath = path.join(targetDir, "package.json");
+  const pkgPath = path2.join(targetDir, "package.json");
   const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
   if (pkg.scripts) {
     delete pkg.scripts["sync:to-template"];
@@ -237,7 +332,7 @@ function cleanupGeneratedPackageJson(targetDir) {
 `, "utf-8");
 }
 function cleanupGeneratedReadme(targetDir) {
-  const readmePath = path.join(targetDir, "README.md");
+  const readmePath = path2.join(targetDir, "README.md");
   if (!fs.existsSync(readmePath)) return;
   let content = fs.readFileSync(readmePath, "utf-8");
   content = content.replace(/\n> \*\*说明：\*\*[^\n]*\n/, "\n");
@@ -245,7 +340,7 @@ function cleanupGeneratedReadme(targetDir) {
   fs.writeFileSync(readmePath, content, "utf-8");
 }
 function cleanupGeneratedGitignore(targetDir) {
-  const gitignorePath = path.join(targetDir, ".gitignore");
+  const gitignorePath = path2.join(targetDir, ".gitignore");
   if (!fs.existsSync(gitignorePath)) return;
   let content = fs.readFileSync(gitignorePath, "utf-8");
   content = content.replace(/\n# Cursor project metadata[\s\S]*?(?=\n*$)/, "\n");
@@ -256,118 +351,10 @@ function cleanupGeneratedGitignore(targetDir) {
   fs.writeFileSync(gitignorePath, content.replace(/\n{3,}/g, "\n\n").replace(/\n+$/, "\n"), "utf-8");
 }
 
-// src/validate.ts
-function validateName(name) {
-  if (!name) return "\u9879\u76EE\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A";
-  if (!/^[a-z][a-z0-9-_]*$/.test(name)) {
-    return "\u9879\u76EE\u540D\u79F0\u53EA\u80FD\u5305\u542B\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u8FDE\u5B57\u7B26(-)\u6216\u4E0B\u5212\u7EBF(_)\uFF0C\u4E14\u4EE5\u5B57\u6BCD\u5F00\u5934";
-  }
-  return null;
-}
-function validatePort(port) {
-  const n = Number(port);
-  if (!port || isNaN(n) || !Number.isInteger(n) || n < 1024 || n > 65535) {
-    return "\u7AEF\u53E3\u53F7\u5FC5\u987B\u662F 1024 ~ 65535 \u4E4B\u95F4\u7684\u6574\u6570";
-  }
-  return null;
-}
-function toAppTitle(name) {
-  return name.split(/[-_]/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-}
-function toAppNameUpper(name) {
-  return name.replace(/[-_]/g, "").toUpperCase();
-}
-
-// src/prompts.ts
-async function collectOptions(projectNameArg, flags) {
-  const versions = loadVersions();
-  const cwd = process.cwd();
-  p.intro(`${pc.bgCyan(pc.black(" create-szyy-app "))} \u5FAE\u524D\u7AEF\u5B50\u5E94\u7528\u811A\u624B\u67B6`);
-  let appName = projectNameArg?.trim() || "";
-  if (!flags.yes || !appName) {
-    const nameResult = await p.text({
-      message: "\u9879\u76EE\u540D\u79F0",
-      placeholder: "my-order-sys",
-      initialValue: appName || void 0,
-      validate: (value) => validateName(value?.trim() || "") ?? void 0
-    });
-    if (p.isCancel(nameResult)) {
-      p.cancel("\u5DF2\u53D6\u6D88");
-      return null;
-    }
-    appName = nameResult.trim();
-  } else {
-    const nameError = validateName(appName);
-    if (nameError) {
-      p.log.error(nameError);
-      return null;
-    }
-  }
-  let appPort = flags.port ?? versions.defaultPort;
-  if (!flags.yes || flags.port === void 0) {
-    const portResult = await p.text({
-      message: "\u672C\u5730\u8054\u8C03\u7AEF\u53E3",
-      placeholder: String(versions.defaultPort),
-      initialValue: String(appPort),
-      validate: (value) => {
-        const port = value?.trim() || String(versions.defaultPort);
-        return validatePort(port) ?? void 0;
-      }
-    });
-    if (p.isCancel(portResult)) {
-      p.cancel("\u5DF2\u53D6\u6D88");
-      return null;
-    }
-    appPort = Number(portResult.trim() || versions.defaultPort);
-  } else {
-    const portError = validatePort(appPort);
-    if (portError) {
-      p.log.error(portError);
-      return null;
-    }
-  }
-  let keepDemo = !flags.minimal;
-  if (!flags.yes && flags.minimal === void 0) {
-    const demoResult = await p.confirm({
-      message: "\u662F\u5426\u4FDD\u7559 Demo \u9875",
-      initialValue: true
-    });
-    if (p.isCancel(demoResult)) {
-      p.cancel("\u5DF2\u53D6\u6D88");
-      return null;
-    }
-    keepDemo = demoResult;
-  }
-  const defaultTarget = path2.resolve(cwd, appName);
-  let targetDir = defaultTarget;
-  if (!flags.yes) {
-    const dirResult = await p.text({
-      message: "\u76EE\u6807\u76EE\u5F55",
-      initialValue: defaultTarget,
-      validate: (value) => {
-        if (!value?.trim()) return "\u76EE\u6807\u76EE\u5F55\u4E0D\u80FD\u4E3A\u7A7A";
-        return void 0;
-      }
-    });
-    if (p.isCancel(dirResult)) {
-      p.cancel("\u5DF2\u53D6\u6D88");
-      return null;
-    }
-    targetDir = path2.resolve(dirResult.trim());
-  }
-  return {
-    appName,
-    appNameUpper: toAppNameUpper(appName),
-    appTitle: toAppTitle(appName),
-    appPort,
-    targetDir,
-    keepDemo
-  };
-}
-
 // src/template.ts
 import fs2 from "fs";
 import path3 from "path";
+import os from "os";
 import { spawnSync } from "child_process";
 import degit from "degit";
 async function fetchTemplate(targetDir, versions) {
@@ -379,6 +366,10 @@ async function fetchTemplate(targetDir, versions) {
   const repoOverride = process.env.SZYY_TEMPLATE_REPO;
   const gitBase = repoOverride || `${versions.templateGitBase}/${versions.templateRepo}`;
   const degitSource = `${gitBase}#${versions.template}`;
+  if (shouldUseGitCloneDirectly(gitBase)) {
+    cloneWithGit(gitBase, versions.template, targetDir);
+    return;
+  }
   try {
     const emitter = degit(degitSource, {
       cache: false,
@@ -394,20 +385,37 @@ async function fetchTemplate(targetDir, versions) {
     cloneWithGit(gitBase, versions.template, targetDir);
   }
 }
+var DEGIT_HOSTS = /* @__PURE__ */ new Set(["github.com", "gitlab.com", "bitbucket.org", "git.sr.ht"]);
+function shouldUseGitCloneDirectly(source) {
+  if (source.startsWith("git@") || source.startsWith("file://")) return true;
+  if (source.startsWith(".") || source.startsWith("/") || /^[A-Za-z]:[\\/]/.test(source)) return true;
+  try {
+    const url = new URL(source);
+    return !DEGIT_HOSTS.has(url.hostname.toLowerCase());
+  } catch {
+    return true;
+  }
+}
 function shouldFallbackToGitClone(error) {
   const message = error instanceof Error ? error.message : String(error);
   return message.includes("degit supports GitHub, GitLab, Sourcehut and BitBucket");
 }
 function cloneWithGit(repo, ref, targetDir) {
-  const result = spawnSync("git", ["clone", "--depth", "1", "--branch", ref, repo, targetDir], {
-    encoding: "utf8"
-  });
-  if (result.status === 0) {
-    removeExcludedTemplateEntries(targetDir);
-    return;
+  const tempDir = fs2.mkdtempSync(path3.join(os.tmpdir(), "create-szyy-app-"));
+  try {
+    const cloneDir = path3.join(tempDir, "template");
+    const result = spawnSync("git", ["clone", "--depth", "1", "--branch", ref, repo, cloneDir], {
+      encoding: "utf8"
+    });
+    if (result.status === 0) {
+      copyRecursive(cloneDir, targetDir);
+      return;
+    }
+    const errorOutput = result.stderr?.trim() || result.stdout?.trim() || "git clone \u6267\u884C\u5931\u8D25";
+    throw new Error(`\u6A21\u677F\u62C9\u53D6\u5931\u8D25: ${errorOutput}`);
+  } finally {
+    fs2.rmSync(tempDir, { recursive: true, force: true });
   }
-  const errorOutput = result.stderr?.trim() || result.stdout?.trim() || "git clone \u6267\u884C\u5931\u8D25";
-  throw new Error(`\u6A21\u677F\u62C9\u53D6\u5931\u8D25: ${errorOutput}`);
 }
 function copyLocalTemplate(source, target) {
   if (!fs2.existsSync(source)) {
@@ -443,9 +451,105 @@ function removeExcludedTemplateEntries(targetDir) {
   }
 }
 
+// src/versions.ts
+import fs3 from "fs";
+import path4 from "path";
+import { fileURLToPath } from "url";
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = path4.dirname(__filename2);
+var CONFIG_BRANCH = "create-app";
+function loadBundledVersions() {
+  const versionsPath = path4.resolve(__dirname2, "../templates/versions.json");
+  return validateVersionsConfig(JSON.parse(fs3.readFileSync(versionsPath, "utf-8")));
+}
+function validateVersionsConfig(config) {
+  if (!config || typeof config !== "object") {
+    throw new Error("\u7248\u672C\u914D\u7F6E\u683C\u5F0F\u65E0\u6548");
+  }
+  const value = config;
+  if (typeof value.template !== "string" || !value.template.trim()) {
+    throw new Error("\u7248\u672C\u914D\u7F6E\u7F3A\u5C11 template");
+  }
+  if (typeof value.defaultPort !== "number" || !Number.isFinite(value.defaultPort)) {
+    throw new Error("\u7248\u672C\u914D\u7F6E\u7F3A\u5C11\u6709\u6548\u7684 defaultPort");
+  }
+  if (!value.dependencies || typeof value.dependencies !== "object" || Array.isArray(value.dependencies)) {
+    throw new Error("\u7248\u672C\u914D\u7F6E\u7F3A\u5C11 dependencies");
+  }
+  return config;
+}
+function mergeVersions(bundled, remote) {
+  return {
+    ...bundled,
+    ...remote,
+    dependencies: { ...bundled.dependencies, ...remote.dependencies },
+    compat: { ...bundled.compat, ...remote.compat }
+  };
+}
+function getRepoBase(bundled) {
+  const override = process.env.SZYY_TEMPLATE_REPO;
+  if (override) {
+    return override.replace(/\.git$/, "").replace(/\/$/, "");
+  }
+  return `${bundled.templateGitBase}/${bundled.templateRepo}`.replace(/\/$/, "");
+}
+function getDefaultRemoteVersionsUrl(bundled) {
+  return `${getRepoBase(bundled)}/-/raw/${CONFIG_BRANCH}/versions.json`;
+}
+async function fetchVersionsFromUrl(url) {
+  const response = await fetch(url, {
+    headers: { Accept: "application/json" },
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!response.ok) {
+    throw new Error(`\u62C9\u53D6\u7248\u672C\u914D\u7F6E\u5931\u8D25 (${response.status}): ${url}`);
+  }
+  return validateVersionsConfig(await response.json());
+}
+function readVersionsFromPath(filePath) {
+  const resolved = path4.resolve(filePath);
+  if (!fs3.existsSync(resolved)) {
+    throw new Error(`\u7248\u672C\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728: ${resolved}`);
+  }
+  return validateVersionsConfig(JSON.parse(fs3.readFileSync(resolved, "utf-8")));
+}
+function applyOverrides(versions, options) {
+  const templateTag = options?.templateTag?.trim() || process.env.SZYY_TEMPLATE_TAG?.trim();
+  if (!templateTag) {
+    return versions;
+  }
+  return { ...versions, template: templateTag };
+}
+async function resolveVersions(options) {
+  const bundled = loadBundledVersions();
+  if (process.env.SZYY_VERSIONS_PATH) {
+    return {
+      config: applyOverrides(readVersionsFromPath(process.env.SZYY_VERSIONS_PATH), options),
+      source: "path"
+    };
+  }
+  const remoteUrl = process.env.SZYY_VERSIONS_URL || getDefaultRemoteVersionsUrl(bundled);
+  try {
+    const remote = await fetchVersionsFromUrl(remoteUrl);
+    return {
+      config: applyOverrides(mergeVersions(bundled, remote), options),
+      source: "remote",
+      remoteUrl
+    };
+  } catch (error) {
+    const fallbackReason = error instanceof Error ? error.message : String(error);
+    return {
+      config: applyOverrides(bundled, options),
+      source: "bundled",
+      remoteUrl,
+      fallbackReason
+    };
+  }
+}
+
 // src/index.ts
 var program = new Command();
-program.name("create-szyy-app").description("\u521B\u5EFA\u5FAE\u524D\u7AEF\u5B50\u5E94\u7528").argument("[project-name]", "\u9879\u76EE\u540D\u79F0\uFF08kebab-case\uFF09").option("-p, --port <port>", "\u672C\u5730\u8054\u8C03\u7AEF\u53E3", (value) => Number(value)).option("--minimal", "\u4E0D\u4FDD\u7559 Demo \u9875").option("-y, --yes", "\u8DF3\u8FC7\u4EA4\u4E92\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u503C").action(async (projectName, options) => {
+program.name("create-szyy-app").description("\u521B\u5EFA\u5FAE\u524D\u7AEF\u5B50\u5E94\u7528").argument("[project-name]", "\u9879\u76EE\u540D\u79F0\uFF08kebab-case\uFF09").option("-p, --port <port>", "\u672C\u5730\u8054\u8C03\u7AEF\u53E3", (value) => Number(value)).option("--template-tag <tag>", "\u8986\u76D6\u6A21\u677F Git tag").option("--minimal", "\u4E0D\u4FDD\u7559 Demo \u9875").option("-y, --yes", "\u8DF3\u8FC7\u4EA4\u4E92\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u503C").action(async (projectName, options) => {
   try {
     await run(projectName, options);
   } catch (error) {
@@ -454,12 +558,16 @@ program.name("create-szyy-app").description("\u521B\u5EFA\u5FAE\u524D\u7AEF\u5B5
   }
 });
 async function run(projectName, flags) {
+  const spinner2 = p2.spinner();
+  spinner2.start("\u52A0\u8F7D\u7248\u672C\u914D\u7F6E...");
+  const resolved = await resolveVersions({ templateTag: flags.templateTag });
+  const { config: versions } = resolved;
+  spinner2.stop(formatVersionsMessage(resolved));
   let createOptions;
   if (flags.yes && projectName) {
     const nameError = validateName(projectName);
     if (nameError) throw new Error(nameError);
-    const versions2 = loadVersions();
-    const port = flags.port ?? versions2.defaultPort;
+    const port = flags.port ?? versions.defaultPort;
     const portError = validatePort(port);
     if (portError) throw new Error(portError);
     createOptions = {
@@ -467,25 +575,23 @@ async function run(projectName, flags) {
       appNameUpper: toAppNameUpper(projectName),
       appTitle: toAppTitle(projectName),
       appPort: port,
-      targetDir: path4.resolve(process.cwd(), projectName),
+      targetDir: path5.resolve(process.cwd(), projectName),
       keepDemo: !flags.minimal
     };
   } else {
-    createOptions = await collectOptions(projectName, flags);
+    createOptions = await collectOptions(projectName, flags, versions);
     if (!createOptions) {
       process.exit(0);
     }
   }
-  if (fs3.existsSync(createOptions.targetDir)) {
-    const entries = fs3.readdirSync(createOptions.targetDir);
+  if (fs4.existsSync(createOptions.targetDir)) {
+    const entries = fs4.readdirSync(createOptions.targetDir);
     if (entries.length > 0) {
       throw new Error(`\u76EE\u6807\u76EE\u5F55\u975E\u7A7A: ${createOptions.targetDir}`);
     }
   } else {
-    fs3.mkdirSync(createOptions.targetDir, { recursive: true });
+    fs4.mkdirSync(createOptions.targetDir, { recursive: true });
   }
-  const versions = loadVersions();
-  const spinner2 = p2.spinner();
   spinner2.start(`\u62C9\u53D6\u6A21\u677F ${versions.template}...`);
   await fetchTemplate(createOptions.targetDir, versions);
   spinner2.stop("\u6A21\u677F\u62C9\u53D6\u5B8C\u6210");
@@ -503,17 +609,29 @@ async function run(projectName, flags) {
   spinner2.start("\u6E05\u7406\u6A21\u677F\u7EF4\u62A4\u6587\u4EF6...");
   cleanupTemplateArtifacts(createOptions.targetDir);
   spinner2.stop("\u6A21\u677F\u7EF4\u62A4\u6587\u4EF6\u5DF2\u6E05\u7406");
-  removeGitDir(createOptions.targetDir);
   p2.outro(
     [
       `${pc2.green("\u2713")} \u9879\u76EE ${pc2.cyan(createOptions.appName)} \u521B\u5EFA\u6210\u529F`,
       "",
       "\u4E0B\u4E00\u6B65:",
-      `  cd ${path4.relative(process.cwd(), createOptions.targetDir) || "."}`,
+      `  cd ${path5.relative(process.cwd(), createOptions.targetDir) || "."}`,
       "  pnpm install",
       "  pnpm dev          # \u72EC\u7ACB\u6A21\u5F0F\uFF0C\u7AEF\u53E3 3000",
       `  pnpm dev:micro    # \u57FA\u5EA7\u8054\u8C03\uFF0C\u7AEF\u53E3 ${createOptions.appPort}`
     ].join("\n")
   );
 }
+function formatVersionsMessage(resolved) {
+  const { config, source, fallbackReason } = resolved;
+  if (source === "remote") {
+    return `\u7248\u672C\u914D\u7F6E\u5DF2\u52A0\u8F7D\uFF08\u8FDC\u7A0B\uFF0C\u6A21\u677F ${config.template}\uFF09`;
+  }
+  if (source === "path") {
+    return `\u7248\u672C\u914D\u7F6E\u5DF2\u52A0\u8F7D\uFF08\u672C\u5730\u6587\u4EF6\uFF0C\u6A21\u677F ${config.template}\uFF09`;
+  }
+  if (fallbackReason) {
+    p2.log.warn(`\u8FDC\u7A0B\u7248\u672C\u914D\u7F6E\u4E0D\u53EF\u7528\uFF0C\u5DF2\u4F7F\u7528\u5185\u7F6E\u914D\u7F6E: ${fallbackReason}`);
+  }
+  return `\u7248\u672C\u914D\u7F6E\u5DF2\u52A0\u8F7D\uFF08\u5185\u7F6E\u515C\u5E95\uFF0C\u6A21\u677F ${config.template}\uFF09`;
+}
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-szyy-app",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "脚手架：一键创建微前端子应用",
   "type": "module",
   "bin": {
@@ -53,6 +53,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "smoke": "pnpm build && node scripts/smoke-create.mjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",

package/templates/versions.json

@@ -1,5 +1,5 @@
 {
-  "template": "v1.0.2",
+  "template": "v1.0.3",
   "templateRepo": "sunyard-szyy-app-template",
   "templateGitBase": "http://172.1.1.65/RDKit",
   "defaultPort": 5690,