@lightfish/cli 0.0.1

package/dist/create-lightfish.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/create-lightfish.js

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+
+// src/create-lightfish.ts
+import cac from "cac";
+
+// src/commands/create.ts
+import path3 from "path";
+import { execa as execa2 } from "execa";
+import fs3 from "fs-extra";
+import prompts3 from "prompts";
+
+// src/utils/download-template.ts
+import path from "path";
+import { tmpdir } from "os";
+import { randomUUID } from "crypto";
+import { execa } from "execa";
+import degit from "degit";
+import fs from "fs-extra";
+function parseDegitRepo(repo) {
+  const [repoPart, branch] = repo.split("#");
+  let url;
+  if (repoPart.startsWith("http://") || repoPart.startsWith("https://")) {
+    url = repoPart.replace(/\.git$/, "") + ".git";
+  } else if (repoPart.includes("/")) {
+    url = `https://github.com/${repoPart}.git`;
+  } else {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790\u4ED3\u5E93\u5730\u5740: ${repo}`);
+  }
+  return { url, branch };
+}
+async function gitClone(url, branch, targetDir) {
+  const tmpDir = path.join(tmpdir(), `lightfish-template-${randomUUID()}`);
+  await fs.ensureDir(tmpDir);
+  const args = ["clone", "--depth", "1"];
+  if (branch) {
+    args.push("--branch", branch);
+  }
+  args.push(url, tmpDir);
+  try {
+    await execa("git", args, { stdio: "inherit" });
+  } catch (error) {
+    await fs.remove(tmpDir).catch(() => {
+    });
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`Git \u514B\u9686\u5931\u8D25\uFF08${url}\uFF09\uFF1A${detail}`);
+  }
+  const entries = await fs.readdir(tmpDir);
+  for (const entry of entries) {
+    if (entry === ".git") continue;
+    const src = path.join(tmpDir, entry);
+    const dest = path.join(targetDir, entry);
+    await fs.move(src, dest, { overwrite: true });
+  }
+  await fs.remove(tmpDir).catch(() => {
+  });
+}
+async function downloadTemplate(repo, targetDir) {
+  await fs.ensureDir(targetDir);
+  const emitter = degit(repo, {
+    cache: false,
+    // 禁用缓存，避免使用损坏的本地缓存
+    force: true,
+    verbose: true
+    // 开启详细日志，方便调试
+  });
+  try {
+    console.log(`\u6B63\u5728\u901A\u8FC7 degit \u62C9\u53D6\u6A21\u677F: ${repo}`);
+    await emitter.clone(targetDir);
+    console.log("degit \u62C9\u53D6\u5B8C\u6210");
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    await fs.emptyDir(targetDir);
+    const { url, branch } = parseDegitRepo(repo);
+    console.log(`\u6B63\u5728\u901A\u8FC7 git clone \u62C9\u53D6\u6A21\u677F: ${url}${branch ? ` (\u5206\u652F: ${branch})` : ""}`);
+    await gitClone(url, branch, targetDir);
+    console.log("git clone \u62C9\u53D6\u5B8C\u6210");
+  }
+  const gitDir = path.join(targetDir, ".git");
+  if (await fs.pathExists(gitDir)) {
+    await fs.remove(gitDir);
+    console.log("\u5DF2\u5220\u9664 .git \u76EE\u5F55");
+  }
+}
+
+// src/utils/package-manager.ts
+function isPackageManager(value) {
+  return value === "npm" || value === "yarn" || value === "pnpm" || value === "bun";
+}
+function installCommand(packageManager) {
+  switch (packageManager) {
+    case "npm":
+      return ["npm", ["install"]];
+    case "yarn":
+      return ["yarn", []];
+    case "bun":
+      return ["bun", ["install"]];
+    case "pnpm":
+    default:
+      return ["pnpm", ["install"]];
+  }
+}
+
+// src/utils/project.ts
+import path2 from "path";
+import fs2 from "fs-extra";
+import prompts from "prompts";
+function normalizeProjectName(name) {
+  return name.trim();
+}
+function resolveTargetDir(cwd, projectName) {
+  return path2.resolve(cwd, projectName);
+}
+async function assertCanCreateProject(targetDir, yes) {
+  if (!await fs2.pathExists(targetDir)) {
+    return true;
+  }
+  const files = await fs2.readdir(targetDir);
+  if (files.length === 0) {
+    return true;
+  }
+  if (yes) {
+    await fs2.remove(targetDir);
+    await fs2.ensureDir(targetDir);
+    return true;
+  }
+  const { overwrite } = await prompts(
+    {
+      type: "confirm",
+      name: "overwrite",
+      message: `\u76EE\u6807\u76EE\u5F55\u5DF2\u5B58\u5728\u4E14\u4E0D\u4E3A\u7A7A\uFF1A${targetDir}\uFF0C\u662F\u5426\u8986\u76D6\uFF1F`,
+      initial: false
+    },
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  if (!overwrite) {
+    return false;
+  }
+  await fs2.remove(targetDir);
+  await fs2.ensureDir(targetDir);
+  return true;
+}
+function toPackageName(projectName) {
+  return projectName.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+
+// src/utils/resolve-template.ts
+import prompts2 from "prompts";
+
+// src/templates/registry.ts
+var BUILTIN_TEMPLATES = [
+  {
+    id: "react-vite",
+    label: "React + Vite",
+    repo: "QGtiger/template-vite-server#main"
+  }
+];
+var DEFAULT_TEMPLATE_ID = BUILTIN_TEMPLATES[0]?.id;
+function getTemplateById(id) {
+  return BUILTIN_TEMPLATES.find((entry) => entry.id === id);
+}
+function listTemplateIds() {
+  return BUILTIN_TEMPLATES.map((entry) => entry.id);
+}
+
+// src/utils/resolve-template.ts
+async function promptTemplateId() {
+  const { templateId } = await prompts2(
+    {
+      type: "select",
+      name: "templateId",
+      message: "\u9009\u62E9\u9879\u76EE\u6A21\u677F",
+      choices: BUILTIN_TEMPLATES.map((entry) => ({
+        title: entry.label,
+        value: entry.id
+      }))
+    },
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  if (!templateId) {
+    throw new Error("\u672A\u9009\u62E9\u6A21\u677F");
+  }
+  return templateId;
+}
+async function resolveTemplateRepo(options) {
+  if (options.templateRepo) {
+    return options.templateRepo;
+  }
+  if (options.template) {
+    const entry2 = getTemplateById(options.template);
+    if (!entry2) {
+      throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${options.template}\u3002\u53EF\u9009\uFF1A${listTemplateIds().join("\u3001")}`);
+    }
+    return entry2.repo;
+  }
+  if (options.yes) {
+    const entry2 = getTemplateById(DEFAULT_TEMPLATE_ID ?? BUILTIN_TEMPLATES[0].id);
+    if (!entry2) {
+      throw new Error("\u5185\u7F6E\u6A21\u677F\u5217\u8868\u4E3A\u7A7A");
+    }
+    return entry2.repo;
+  }
+  const templateId = await promptTemplateId();
+  const entry = getTemplateById(templateId);
+  if (!entry) {
+    throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${templateId}`);
+  }
+  return entry.repo;
+}
+
+// src/commands/create.ts
+async function patchPackageJsonName(targetDir, projectName) {
+  const packageJsonPath = path3.join(targetDir, "package.json");
+  if (!await fs3.pathExists(packageJsonPath)) {
+    throw new Error("\u6A21\u677F\u7F3A\u5C11 package.json");
+  }
+  const packageJson = await fs3.readJson(packageJsonPath);
+  packageJson.name = toPackageName(projectName);
+  await fs3.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+}
+async function resolveCreateOptions(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const initialProjectName = options.projectName ? normalizeProjectName(options.projectName) : "";
+  const answers = await prompts3(
+    [
+      {
+        type: initialProjectName ? null : "text",
+        name: "projectName",
+        message: "\u9879\u76EE\u540D",
+        initial: "lightfish-app"
+      },
+      {
+        type: options.install !== void 0 || options.skipInstall || options.yes ? null : "confirm",
+        name: "install",
+        message: "\u662F\u5426\u7ACB\u5373\u5B89\u88C5\u4F9D\u8D56\uFF1F",
+        initial: false
+      },
+      {
+        type: options.git !== void 0 || options.yes ? null : "confirm",
+        name: "git",
+        message: "\u662F\u5426\u521D\u59CB\u5316 git\uFF1F",
+        initial: false
+      }
+    ],
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  const projectName = normalizeProjectName(initialProjectName || answers.projectName);
+  if (!projectName) {
+    throw new Error("\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  const packageManager = options.packageManager ?? "pnpm";
+  if (!isPackageManager(packageManager)) {
+    throw new Error(`\u4E0D\u652F\u6301\u7684\u5305\u7BA1\u7406\u5668\uFF1A${String(packageManager)}`);
+  }
+  const templateRepo = await resolveTemplateRepo({
+    template: options.template,
+    templateRepo: options.templateRepo,
+    yes: options.yes
+  });
+  return {
+    cwd,
+    projectName,
+    targetDir: resolveTargetDir(cwd, projectName),
+    packageManager,
+    templateRepo,
+    install: options.skipInstall ? false : options.install ?? (options.yes ? false : answers.install ?? false),
+    git: options.git ?? answers.git ?? false
+  };
+}
+async function maybeInstall(options) {
+  if (!options.install) {
+    return;
+  }
+  const [command, args] = installCommand(options.packageManager);
+  await execa2(command, args, {
+    cwd: options.targetDir,
+    stdio: "inherit"
+  });
+}
+async function maybeInitGit(options) {
+  if (!options.git) {
+    return;
+  }
+  await execa2("git", ["init"], {
+    cwd: options.targetDir,
+    stdio: "inherit"
+  });
+}
+async function createProject(options = {}) {
+  const resolvedOptions = await resolveCreateOptions(options);
+  const canCreate = await assertCanCreateProject(resolvedOptions.targetDir, options.yes);
+  if (!canCreate) {
+    throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+  }
+  console.log("[create] \u5F00\u59CB\u4E0B\u8F7D\u6A21\u677F...");
+  await downloadTemplate(resolvedOptions.templateRepo, resolvedOptions.targetDir);
+  console.log("[create] \u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u4FEE\u6539 package.json...");
+  await patchPackageJsonName(resolvedOptions.targetDir, resolvedOptions.projectName);
+  console.log("[create] package.json \u4FEE\u6539\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u5B89\u88C5\u4F9D\u8D56...");
+  await maybeInstall(resolvedOptions);
+  console.log("[create] \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u521D\u59CB\u5316 git...");
+  await maybeInitGit(resolvedOptions);
+  console.log("[create] git \u521D\u59CB\u5316\u5B8C\u6210");
+  return resolvedOptions;
+}
+
+// src/utils/package-info.ts
+import fs4 from "fs";
+import path4 from "path";
+import { fileURLToPath } from "url";
+var dirname = path4.dirname(fileURLToPath(import.meta.url));
+function readPackageVersion() {
+  const packageJsonPathCandidates = [
+    // 源码模式：src/utils/package-info.ts -> packages/cli/package.json
+    path4.resolve(dirname, "../../package.json"),
+    // 构建产物模式：dist/lightfish.js -> packages/cli/package.json
+    path4.resolve(dirname, "../package.json")
+  ];
+  const packageJsonPath = packageJsonPathCandidates.find((candidate) => fs4.existsSync(candidate));
+  if (!packageJsonPath) {
+    return "0.0.0";
+  }
+  const packageJson = JSON.parse(fs4.readFileSync(packageJsonPath, "utf8"));
+  return packageJson.version ?? "0.0.0";
+}
+
+// src/create-lightfish.ts
+var cli = cac("create-lightfish");
+cli.command("[projectName]", "\u521B\u5EFA Lightfish React Vite \u9879\u76EE").option("--pm <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Anpm\u3001yarn\u3001pnpm\u3001bun", { default: "pnpm" }).option("--template <id>", "\u5185\u7F6E\u6A21\u677F id\uFF0C\u4F8B\u5982 react-vite").option("--template-repo <repo>", "\u76F4\u63A5\u6307\u5B9A degit \u6E90\uFF0C\u5982 QGtiger/template-vite-server#main\uFF08\u4F18\u5148\u4E8E --template\uFF09").option("--skip-install", "\u8DF3\u8FC7\u4F9D\u8D56\u5B89\u88C5").option("--git", "\u521B\u5EFA\u540E\u521D\u59CB\u5316 git").option("--yes", "\u4F7F\u7528\u9ED8\u8BA4\u9009\u9879\u5E76\u8DF3\u8FC7\u786E\u8BA4").action(async (projectName, options) => {
+  try {
+    const packageManager = options.pm ?? "pnpm";
+    if (!isPackageManager(packageManager)) {
+      throw new Error(`\u4E0D\u652F\u6301\u7684\u5305\u7BA1\u7406\u5668\uFF1A${packageManager}`);
+    }
+    await createProject({
+      projectName,
+      packageManager,
+      template: options.template,
+      templateRepo: options.templateRepo,
+      skipInstall: options.skipInstall,
+      git: options.git,
+      yes: options.yes
+    });
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\u521B\u5EFA\u5931\u8D25\uFF1A${message}`);
+    process.exit(1);
+  }
+});
+cli.help();
+cli.version(readPackageVersion());
+cli.parse();

package/dist/lightfish.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/lightfish.js

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+
+// src/lightfish.ts
+import cac from "cac";
+import { execa as execa3 } from "execa";
+
+// src/commands/create.ts
+import path3 from "path";
+import { execa as execa2 } from "execa";
+import fs3 from "fs-extra";
+import prompts3 from "prompts";
+
+// src/utils/download-template.ts
+import path from "path";
+import { tmpdir } from "os";
+import { randomUUID } from "crypto";
+import { execa } from "execa";
+import degit from "degit";
+import fs from "fs-extra";
+function parseDegitRepo(repo) {
+  const [repoPart, branch] = repo.split("#");
+  let url;
+  if (repoPart.startsWith("http://") || repoPart.startsWith("https://")) {
+    url = repoPart.replace(/\.git$/, "") + ".git";
+  } else if (repoPart.includes("/")) {
+    url = `https://github.com/${repoPart}.git`;
+  } else {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790\u4ED3\u5E93\u5730\u5740: ${repo}`);
+  }
+  return { url, branch };
+}
+async function gitClone(url, branch, targetDir) {
+  const tmpDir = path.join(tmpdir(), `lightfish-template-${randomUUID()}`);
+  await fs.ensureDir(tmpDir);
+  const args = ["clone", "--depth", "1"];
+  if (branch) {
+    args.push("--branch", branch);
+  }
+  args.push(url, tmpDir);
+  try {
+    await execa("git", args, { stdio: "inherit" });
+  } catch (error) {
+    await fs.remove(tmpDir).catch(() => {
+    });
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`Git \u514B\u9686\u5931\u8D25\uFF08${url}\uFF09\uFF1A${detail}`);
+  }
+  const entries = await fs.readdir(tmpDir);
+  for (const entry of entries) {
+    if (entry === ".git") continue;
+    const src = path.join(tmpDir, entry);
+    const dest = path.join(targetDir, entry);
+    await fs.move(src, dest, { overwrite: true });
+  }
+  await fs.remove(tmpDir).catch(() => {
+  });
+}
+async function downloadTemplate(repo, targetDir) {
+  await fs.ensureDir(targetDir);
+  const emitter = degit(repo, {
+    cache: false,
+    // 禁用缓存，避免使用损坏的本地缓存
+    force: true,
+    verbose: true
+    // 开启详细日志，方便调试
+  });
+  try {
+    console.log(`\u6B63\u5728\u901A\u8FC7 degit \u62C9\u53D6\u6A21\u677F: ${repo}`);
+    await emitter.clone(targetDir);
+    console.log("degit \u62C9\u53D6\u5B8C\u6210");
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    await fs.emptyDir(targetDir);
+    const { url, branch } = parseDegitRepo(repo);
+    console.log(`\u6B63\u5728\u901A\u8FC7 git clone \u62C9\u53D6\u6A21\u677F: ${url}${branch ? ` (\u5206\u652F: ${branch})` : ""}`);
+    await gitClone(url, branch, targetDir);
+    console.log("git clone \u62C9\u53D6\u5B8C\u6210");
+  }
+  const gitDir = path.join(targetDir, ".git");
+  if (await fs.pathExists(gitDir)) {
+    await fs.remove(gitDir);
+    console.log("\u5DF2\u5220\u9664 .git \u76EE\u5F55");
+  }
+}
+
+// src/utils/package-manager.ts
+function isPackageManager(value) {
+  return value === "npm" || value === "yarn" || value === "pnpm" || value === "bun";
+}
+function installCommand(packageManager) {
+  switch (packageManager) {
+    case "npm":
+      return ["npm", ["install"]];
+    case "yarn":
+      return ["yarn", []];
+    case "bun":
+      return ["bun", ["install"]];
+    case "pnpm":
+    default:
+      return ["pnpm", ["install"]];
+  }
+}
+
+// src/utils/project.ts
+import path2 from "path";
+import fs2 from "fs-extra";
+import prompts from "prompts";
+function normalizeProjectName(name) {
+  return name.trim();
+}
+function resolveTargetDir(cwd, projectName) {
+  return path2.resolve(cwd, projectName);
+}
+async function assertCanCreateProject(targetDir, yes) {
+  if (!await fs2.pathExists(targetDir)) {
+    return true;
+  }
+  const files = await fs2.readdir(targetDir);
+  if (files.length === 0) {
+    return true;
+  }
+  if (yes) {
+    await fs2.remove(targetDir);
+    await fs2.ensureDir(targetDir);
+    return true;
+  }
+  const { overwrite } = await prompts(
+    {
+      type: "confirm",
+      name: "overwrite",
+      message: `\u76EE\u6807\u76EE\u5F55\u5DF2\u5B58\u5728\u4E14\u4E0D\u4E3A\u7A7A\uFF1A${targetDir}\uFF0C\u662F\u5426\u8986\u76D6\uFF1F`,
+      initial: false
+    },
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  if (!overwrite) {
+    return false;
+  }
+  await fs2.remove(targetDir);
+  await fs2.ensureDir(targetDir);
+  return true;
+}
+function toPackageName(projectName) {
+  return projectName.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+
+// src/utils/resolve-template.ts
+import prompts2 from "prompts";
+
+// src/templates/registry.ts
+var BUILTIN_TEMPLATES = [
+  {
+    id: "react-vite",
+    label: "React + Vite",
+    repo: "QGtiger/template-vite-server#main"
+  }
+];
+var DEFAULT_TEMPLATE_ID = BUILTIN_TEMPLATES[0]?.id;
+function getTemplateById(id) {
+  return BUILTIN_TEMPLATES.find((entry) => entry.id === id);
+}
+function listTemplateIds() {
+  return BUILTIN_TEMPLATES.map((entry) => entry.id);
+}
+
+// src/utils/resolve-template.ts
+async function promptTemplateId() {
+  const { templateId } = await prompts2(
+    {
+      type: "select",
+      name: "templateId",
+      message: "\u9009\u62E9\u9879\u76EE\u6A21\u677F",
+      choices: BUILTIN_TEMPLATES.map((entry) => ({
+        title: entry.label,
+        value: entry.id
+      }))
+    },
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  if (!templateId) {
+    throw new Error("\u672A\u9009\u62E9\u6A21\u677F");
+  }
+  return templateId;
+}
+async function resolveTemplateRepo(options) {
+  if (options.templateRepo) {
+    return options.templateRepo;
+  }
+  if (options.template) {
+    const entry2 = getTemplateById(options.template);
+    if (!entry2) {
+      throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${options.template}\u3002\u53EF\u9009\uFF1A${listTemplateIds().join("\u3001")}`);
+    }
+    return entry2.repo;
+  }
+  if (options.yes) {
+    const entry2 = getTemplateById(DEFAULT_TEMPLATE_ID ?? BUILTIN_TEMPLATES[0].id);
+    if (!entry2) {
+      throw new Error("\u5185\u7F6E\u6A21\u677F\u5217\u8868\u4E3A\u7A7A");
+    }
+    return entry2.repo;
+  }
+  const templateId = await promptTemplateId();
+  const entry = getTemplateById(templateId);
+  if (!entry) {
+    throw new Error(`\u672A\u77E5\u6A21\u677F\uFF1A${templateId}`);
+  }
+  return entry.repo;
+}
+
+// src/commands/create.ts
+async function patchPackageJsonName(targetDir, projectName) {
+  const packageJsonPath = path3.join(targetDir, "package.json");
+  if (!await fs3.pathExists(packageJsonPath)) {
+    throw new Error("\u6A21\u677F\u7F3A\u5C11 package.json");
+  }
+  const packageJson = await fs3.readJson(packageJsonPath);
+  packageJson.name = toPackageName(projectName);
+  await fs3.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+}
+async function resolveCreateOptions(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const initialProjectName = options.projectName ? normalizeProjectName(options.projectName) : "";
+  const answers = await prompts3(
+    [
+      {
+        type: initialProjectName ? null : "text",
+        name: "projectName",
+        message: "\u9879\u76EE\u540D",
+        initial: "lightfish-app"
+      },
+      {
+        type: options.install !== void 0 || options.skipInstall || options.yes ? null : "confirm",
+        name: "install",
+        message: "\u662F\u5426\u7ACB\u5373\u5B89\u88C5\u4F9D\u8D56\uFF1F",
+        initial: false
+      },
+      {
+        type: options.git !== void 0 || options.yes ? null : "confirm",
+        name: "git",
+        message: "\u662F\u5426\u521D\u59CB\u5316 git\uFF1F",
+        initial: false
+      }
+    ],
+    {
+      onCancel() {
+        throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+      }
+    }
+  );
+  const projectName = normalizeProjectName(initialProjectName || answers.projectName);
+  if (!projectName) {
+    throw new Error("\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  const packageManager = options.packageManager ?? "pnpm";
+  if (!isPackageManager(packageManager)) {
+    throw new Error(`\u4E0D\u652F\u6301\u7684\u5305\u7BA1\u7406\u5668\uFF1A${String(packageManager)}`);
+  }
+  const templateRepo = await resolveTemplateRepo({
+    template: options.template,
+    templateRepo: options.templateRepo,
+    yes: options.yes
+  });
+  return {
+    cwd,
+    projectName,
+    targetDir: resolveTargetDir(cwd, projectName),
+    packageManager,
+    templateRepo,
+    install: options.skipInstall ? false : options.install ?? (options.yes ? false : answers.install ?? false),
+    git: options.git ?? answers.git ?? false
+  };
+}
+async function maybeInstall(options) {
+  if (!options.install) {
+    return;
+  }
+  const [command, args] = installCommand(options.packageManager);
+  await execa2(command, args, {
+    cwd: options.targetDir,
+    stdio: "inherit"
+  });
+}
+async function maybeInitGit(options) {
+  if (!options.git) {
+    return;
+  }
+  await execa2("git", ["init"], {
+    cwd: options.targetDir,
+    stdio: "inherit"
+  });
+}
+async function createProject(options = {}) {
+  const resolvedOptions = await resolveCreateOptions(options);
+  const canCreate = await assertCanCreateProject(resolvedOptions.targetDir, options.yes);
+  if (!canCreate) {
+    throw new Error("\u5DF2\u53D6\u6D88\u521B\u5EFA\u9879\u76EE");
+  }
+  console.log("[create] \u5F00\u59CB\u4E0B\u8F7D\u6A21\u677F...");
+  await downloadTemplate(resolvedOptions.templateRepo, resolvedOptions.targetDir);
+  console.log("[create] \u6A21\u677F\u4E0B\u8F7D\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u4FEE\u6539 package.json...");
+  await patchPackageJsonName(resolvedOptions.targetDir, resolvedOptions.projectName);
+  console.log("[create] package.json \u4FEE\u6539\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u5B89\u88C5\u4F9D\u8D56...");
+  await maybeInstall(resolvedOptions);
+  console.log("[create] \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210");
+  console.log("[create] \u5F00\u59CB\u521D\u59CB\u5316 git...");
+  await maybeInitGit(resolvedOptions);
+  console.log("[create] git \u521D\u59CB\u5316\u5B8C\u6210");
+  return resolvedOptions;
+}
+
+// src/utils/package-info.ts
+import fs4 from "fs";
+import path4 from "path";
+import { fileURLToPath } from "url";
+var dirname = path4.dirname(fileURLToPath(import.meta.url));
+function readPackageVersion() {
+  const packageJsonPathCandidates = [
+    // 源码模式：src/utils/package-info.ts -> packages/cli/package.json
+    path4.resolve(dirname, "../../package.json"),
+    // 构建产物模式：dist/lightfish.js -> packages/cli/package.json
+    path4.resolve(dirname, "../package.json")
+  ];
+  const packageJsonPath = packageJsonPathCandidates.find((candidate) => fs4.existsSync(candidate));
+  if (!packageJsonPath) {
+    return "0.0.0";
+  }
+  const packageJson = JSON.parse(fs4.readFileSync(packageJsonPath, "utf8"));
+  return packageJson.version ?? "0.0.0";
+}
+
+// src/lightfish.ts
+var cli = cac("lightfish");
+async function runBuild() {
+  await execa3("vite", ["build"], {
+    cwd: process.cwd(),
+    preferLocal: true,
+    stdio: "inherit"
+  });
+}
+cli.command("create [projectName]", "\u521B\u5EFA Lightfish React Vite \u9879\u76EE").option("--pm <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Anpm\u3001yarn\u3001pnpm\u3001bun", { default: "pnpm" }).option("--template <id>", "\u5185\u7F6E\u6A21\u677F id\uFF0C\u4F8B\u5982 react-vite").option("--template-repo <repo>", "\u76F4\u63A5\u6307\u5B9A degit \u6E90\uFF0C\u5982 QGtiger/template-vite-server#main\uFF08\u4F18\u5148\u4E8E --template\uFF09").option("--skip-install", "\u8DF3\u8FC7\u4F9D\u8D56\u5B89\u88C5").option("--git", "\u521B\u5EFA\u540E\u521D\u59CB\u5316 git").option("--yes", "\u4F7F\u7528\u9ED8\u8BA4\u9009\u9879\u5E76\u8DF3\u8FC7\u786E\u8BA4").action(async (projectName, options) => {
+  try {
+    const packageManager = options.pm ?? "pnpm";
+    if (!isPackageManager(packageManager)) {
+      throw new Error(`\u4E0D\u652F\u6301\u7684\u5305\u7BA1\u7406\u5668\uFF1A${packageManager}`);
+    }
+    await createProject({
+      projectName,
+      packageManager,
+      template: options.template,
+      templateRepo: options.templateRepo,
+      skipInstall: options.skipInstall,
+      git: options.git,
+      yes: options.yes
+    });
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\u521B\u5EFA\u5931\u8D25\uFF1A${message}`);
+    process.exit(1);
+  }
+});
+cli.command("build", "\u6267\u884C Vite \u6784\u5EFA\uFF0C\u540E\u7EED\u4F1A\u53E0\u52A0 Lightfish \u6784\u5EFA\u903B\u8F91").action(async () => {
+  try {
+    await runBuild();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\u6784\u5EFA\u5931\u8D25\uFF1A${message}`);
+    process.exitCode = 1;
+  }
+});
+cli.command("", "\u663E\u793A\u5E2E\u52A9").action(() => {
+  cli.outputHelp();
+});
+cli.help();
+cli.version(readPackageVersion());
+cli.parse();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@lightfish/cli",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-lightfish": "./dist/create-lightfish.js",
+    "lightfish": "./dist/lightfish.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/create-lightfish.ts src/lightfish.ts --format esm --dts --splitting false",
+    "dev": "tsx src/create-lightfish.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "cac": "^7.0.0",
+    "degit": "^2.8.4",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.5",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/prompts": "^2.4.9"
+  }
+}