@gct-paas/cli 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -7,6 +7,18 @@
 
 ## [Unreleased]
 
+## [0.1.9] - 2026-04-02
+
+### Added
+
+- 命令 nginx-start 便捷本地启动 plugin 开发 nginx
+
+## [0.1.8] - 2026-04-02
+
+### Changed
+
+- 命令 gen-cdn-lib 改为 tag 默认识别当前运行项目分支映射，也可单独指定
+
 ## [0.1.7] - 2026-04-02
 
 ### Added

package/dist/actions/gen-cdn-lib/gen-cdn-lib.cjs

@@ -9,9 +9,10 @@ var _path = _interopRequireDefault(require("path"));
 var _fsExtra = _interopRequireDefault(require("fs-extra"));
 var _consola = _interopRequireDefault(require("consola"));
 var _listr = require("listr2");
+var _constants = require("../../constants/index.cjs");
+var _utils = require("../../utils/index.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 class GenCdnLibAction {
-  packages = ["@gct-paas/api", "@gct-paas/core", "@gct-paas/core-mobile", "@gct-paas/core-pad", "@gct-paas/core-web", "@gct-paas/design", "@gct-paas/design-mobile", "@gct-paas/design-pad", "@gct-paas/design-web", "@gct-paas/native", "@gct-paas/render", "@gct-paas/render-mobile", "@gct-paas/render-pad", "@gct-paas/render-web", "@gct-paas/schema", "@gct-paas/v-ben"];
   /**
    * 下载指定包并复制到外部依赖目录，返回入口文件名；若找不到入口文件则返回空字符串
    */
@@ -57,11 +58,21 @@ class GenCdnLibAction {
     }
     _consola.default.info("\u6B63\u5728\u8BFB\u53D6 import-map.json...");
     const importMap = _fsExtra.default.readJSONSync(importMapJsonPath);
-    const tasks = new _listr.Listr(this.packages.map(pkg => ({
-      title: `${pkg}@${opts.tag}`,
+    let tag = opts.tag;
+    if (!tag) {
+      const branch = await (0, _utils.getBranchName)();
+      if (branch) {
+        tag = _constants.branch_2_tag[branch];
+      }
+      if (!tag) {
+        tag = "latest";
+      }
+    }
+    const tasks = new _listr.Listr(_constants.lib_packages.map(pkg => ({
+      title: `${pkg}@${tag}`,
       task: async (_, task) => {
-        task.title = `${pkg}@${opts.tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
-        const pkgInfo = await _pacote.default.manifest(`${pkg}@${opts.tag}`, {
+        task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
+        const pkgInfo = await _pacote.default.manifest(`${pkg}@${tag}`, {
           registry: opts.registry,
           cache: cacheDir
         });

package/dist/actions/gen-cdn-lib/gen-cdn-lib.d.ts

@@ -6,7 +6,6 @@ import { IGenCdnLibOptions } from '../../interface';
  * @class GenCdnLibAction
  */
 export declare class GenCdnLibAction {
-    private packages;
     /**
      * 下载指定包并复制到外部依赖目录，返回入口文件名；若找不到入口文件则返回空字符串
      */

package/dist/actions/index.cjs

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "InitGitAction", {
     return _initGit.InitGitAction;
   }
 });
+Object.defineProperty(exports, "NginxStartAction", {
+  enumerable: true,
+  get: function () {
+    return _nginxStart.NginxStartAction;
+  }
+});
 Object.defineProperty(exports, "RestoreFilesAction", {
   enumerable: true,
   get: function () {
@@ -37,4 +43,5 @@ var _genApi = require("./gen-api/gen-api.cjs");
 var _genCdnLib = require("./gen-cdn-lib/gen-cdn-lib.cjs");
 var _initGit = require("./init-git/init-git.cjs");
 var _restoreFiles = require("./restore-files/restore-files.cjs");
-var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _nginxStart = require("./nginx-start/nginx-start.cjs");

package/dist/actions/index.d.ts

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from './gen-cdn-lib/gen-cdn-lib';
 export { InitGitAction } from './init-git/init-git';
 export { RestoreFilesAction } from './restore-files/restore-files';
 export { UpdateCatalogEnvAction } from './update-catalog-env/update-catalog-env';
+export { NginxStartAction } from './nginx-start/nginx-start';

package/dist/actions/nginx-start/nginx-start.cjs

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NginxStartAction = void 0;
+var _nodeChild_process = require("node:child_process");
+var _nodeFs = require("node:fs");
+var _nodePath = require("node:path");
+var _consola = require("consola");
+function sleep(ms) {
+  return new Promise(resolve2 => setTimeout(resolve2, ms));
+}
+class NginxStartAction {
+  nginxDir;
+  constructor(nginxDir) {
+    this.nginxDir = nginxDir ?? (0, _nodePath.resolve)(process.cwd(), "configs/nginx");
+  }
+  /**
+   * 停止已运行的 nginx 进程
+   * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+   * 若 nginx 未运行则忽略错误
+   */
+  async stopNginxIfRunning() {
+    try {
+      if (process.platform === "win32") {
+        (0, _nodeChild_process.execSync)("taskkill /F /IM nginx.exe", {
+          stdio: "pipe"
+        });
+      } else {
+        (0, _nodeChild_process.execSync)(`nginx -p "${this.nginxDir}" -s stop`, {
+          stdio: "pipe"
+        });
+      }
+      _consola.consola.info("\u5DF2\u505C\u6B62\u73B0\u6709 nginx \u8FDB\u7A0B\uFF0C\u7B49\u5F85 1 \u79D2...");
+      await sleep(1e3);
+    } catch {
+      _consola.consola.info("nginx \u672A\u8FD0\u884C\uFF0C\u8DF3\u8FC7\u505C\u6B62\u6B65\u9AA4");
+    }
+  }
+  /**
+   * 启动 nginx
+   * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+   */
+  startNginx() {
+    (0, _nodeFs.mkdirSync)((0, _nodePath.resolve)(this.nginxDir, "logs"), {
+      recursive: true
+    });
+    (0, _nodeFs.mkdirSync)((0, _nodePath.resolve)(this.nginxDir, "temp"), {
+      recursive: true
+    });
+    const nginxDirNormalized = this.nginxDir.split(_nodePath.sep).join("/");
+    const child = (0, _nodeChild_process.spawn)("nginx", ["-p", nginxDirNormalized, "-c", "nginx.conf"], {
+      cwd: process.cwd(),
+      stdio: "ignore",
+      detached: true
+    });
+    child.unref();
+  }
+  async run() {
+    _consola.consola.start("\u5F00\u59CB\u542F\u52A8 nginx...");
+    await this.stopNginxIfRunning();
+    _consola.consola.start("\u6B63\u5728\u542F\u52A8 nginx...");
+    this.startNginx();
+    _consola.consola.success("nginx \u542F\u52A8\u6267\u884C\u5B8C\u6BD5");
+  }
+}
+exports.NginxStartAction = NginxStartAction;

package/dist/actions/nginx-start/nginx-start.d.ts

@@ -0,0 +1,16 @@
+export declare class NginxStartAction {
+    private readonly nginxDir;
+    constructor(nginxDir?: string);
+    /**
+     * 停止已运行的 nginx 进程
+     * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+     * 若 nginx 未运行则忽略错误
+     */
+    private stopNginxIfRunning;
+    /**
+     * 启动 nginx
+     * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+     */
+    private startNginx;
+    run(): Promise<void>;
+}

package/dist/actions/update-catalog-env/update-catalog-env.cjs

@@ -11,17 +11,13 @@ var _fsExtra = _interopRequireDefault(require("fs-extra"));
 var _jsYaml = _interopRequireDefault(require("js-yaml"));
 var _utils = require("../../utils/index.cjs");
 var _path = _interopRequireDefault(require("path"));
+var _constants = require("../../constants/index.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const envMap = {
-  "paas-dev": "dev",
-  "paas-test": "test"
-};
 class UpdateCatalogEnvAction {
-  packages = ["@gct-paas/api", "@gct-paas/core", "@gct-paas/core-mobile", "@gct-paas/core-pad", "@gct-paas/core-web", "@gct-paas/design", "@gct-paas/design-mobile", "@gct-paas/design-pad", "@gct-paas/design-web", "@gct-paas/native", "@gct-paas/render", "@gct-paas/render-mobile", "@gct-paas/render-pad", "@gct-paas/render-web", "@gct-paas/schema", "@gct-paas/v-ben"];
   async run() {
     _consola.consola.start("\u4FEE\u6539 pnpm catalog \u914D\u7F6E...");
     const branch = await (0, _utils.getBranchName)();
-    const tag = envMap[branch];
+    const tag = _constants.branch_2_tag[branch];
     if (!tag) {
       _consola.consola.info(`\u5F53\u524D\u5206\u652F ${branch} \u4E0D\u5339\u914D\u4EFB\u4F55\u73AF\u5883\u6807\u7B7E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E`);
       return;
@@ -33,12 +29,10 @@ class UpdateCatalogEnvAction {
       _consola.consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
       return;
     }
-    const tasks = new _listr.Listr(this.packages.map(pkg => ({
+    const pkgsToUpdate = _constants.lib_packages.filter(pkg => pkg in catalogCfg);
+    const tasks = new _listr.Listr(pkgsToUpdate.map(pkg => ({
       title: `\u8BBE\u7F6E ${pkg} \u7684 catalog \u6807\u7B7E\u4E3A ${tag}`,
       task: async (_, task) => {
-        if (!catalogCfg[pkg]) {
-          return;
-        }
         task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
         try {
           const pkgInfo = await _pacote.default.manifest(`${pkg}@${tag}`);

package/dist/actions/update-catalog-env/update-catalog-env.d.ts

@@ -1,4 +1,3 @@
 export declare class UpdateCatalogEnvAction {
-    private packages;
     run(): Promise<void>;
 }

package/dist/commands/gen-cdn-lib/gen-cdn-lib.cjs

@@ -7,7 +7,7 @@ exports.GenCdnLibCommand = void 0;
 var _actions = require("../../actions/index.cjs");
 class GenCdnLibCommand {
   load(program) {
-    program.command("gen-cdn-lib").description("\u751F\u6210 cdn \u5E93\u6587\u4EF6").option("--tag <tag>", "\u6307\u5B9A\u4E0B\u8F7D\u7684\u7248\u672C\u6807\u7B7E(latest | dev | beta | alpha)\uFF0C\u9ED8\u8BA4\u4E3A latest", "latest").option("--dir <dir>", "\u6307\u5B9A\u8F93\u51FA\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u9ED8\u8BA4\u4E3A\u5F53\u524D\u6267\u884C\u76EE\u5F55").option("--jsonPath <jsonPath>", "\u6307\u5B9A import-map.json \u6587\u4EF6\u8DEF\u5F84\uFF0C\u672A\u5236\u5B9A\u9ED8\u8BA4\u4F7F\u7528\u6307\u5B9A\u7684 dir \u76EE\u5F55\u4E0B\u7684 import-map.json \u6587\u4EF6").option("--clean", "\u662F\u5426\u6E05\u7406\u8F93\u51FA\u76EE\u5F55\u540E\u518D\u751F\u6210").option("--registry <registry>", "\u6307\u5B9A npm registry \u5730\u5740\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4 registry").option("--cache <cache>", "\u6307\u5B9A pacote \u7F13\u5B58\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u7F13\u5B58\u76EE\u5F55").option("--cleanCache", "\u6E05\u7406\u7F13\u5B58\u76EE\u5F55\uFF0C\u9ED8\u8BA4\u4E3A false", false).option("--noFiles", "\u662F\u5426\u53EA\u751F\u6210 import-map.json \u6587\u4EF6\u800C\u4E0D\u4E0B\u8F7D\u5305\u6587\u4EF6\uFF0C\u9ED8\u8BA4\u4E3A false", false).action(this.action.bind(this));
+    program.command("gen-cdn-lib").description("\u751F\u6210 cdn \u5E93\u6587\u4EF6").option("--tag <tag>", "\u6307\u5B9A\u4E0B\u8F7D\u7684\u7248\u672C\u6807\u7B7E(latest | dev | beta | alpha)\uFF0C\u9ED8\u8BA4\u4E3A latest").option("--dir <dir>", "\u6307\u5B9A\u8F93\u51FA\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u9ED8\u8BA4\u4E3A\u5F53\u524D\u6267\u884C\u76EE\u5F55").option("--jsonPath <jsonPath>", "\u6307\u5B9A import-map.json \u6587\u4EF6\u8DEF\u5F84\uFF0C\u672A\u5236\u5B9A\u9ED8\u8BA4\u4F7F\u7528\u6307\u5B9A\u7684 dir \u76EE\u5F55\u4E0B\u7684 import-map.json \u6587\u4EF6").option("--clean", "\u662F\u5426\u6E05\u7406\u8F93\u51FA\u76EE\u5F55\u540E\u518D\u751F\u6210").option("--registry <registry>", "\u6307\u5B9A npm registry \u5730\u5740\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4 registry").option("--cache <cache>", "\u6307\u5B9A pacote \u7F13\u5B58\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u7F13\u5B58\u76EE\u5F55").option("--cleanCache", "\u6E05\u7406\u7F13\u5B58\u76EE\u5F55\uFF0C\u9ED8\u8BA4\u4E3A false", false).option("--noFiles", "\u662F\u5426\u53EA\u751F\u6210 import-map.json \u6587\u4EF6\u800C\u4E0D\u4E0B\u8F7D\u5305\u6587\u4EF6\uFF0C\u9ED8\u8BA4\u4E3A false", false).action(this.action.bind(this));
   }
   async action(args) {
     await new _actions.GenCdnLibAction().run(args);

package/dist/commands/index.cjs

@@ -10,6 +10,7 @@ var _genCdnLib = require("./gen-cdn-lib/gen-cdn-lib.cjs");
 var _initGit = require("./init-git/init-git.cjs");
 var _restoreFiles = require("./restore-files/restore-files.cjs");
 var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _nginxStart = require("./nginx-start/nginx-start.cjs");
 class CommandLoader {
   static load(program) {
     new _genApi.GenApiCommand().load(program);
@@ -17,6 +18,7 @@ class CommandLoader {
     new _initGit.InitGitCommand().load(program);
     new _restoreFiles.RestoreFilesCommand().load(program);
     new _updateCatalogEnv.UpdateCatalogEnvCommand().load(program);
+    new _nginxStart.NginxStartCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/dist/commands/nginx-start/nginx-start.cjs

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NginxStartCommand = void 0;
+var _actions = require("../../actions/index.cjs");
+class NginxStartCommand {
+  load(program) {
+    program.command("nginx-start").description("\u542F\u52A8 nginx\uFF08\u9700\u5C06 nginx \u53EF\u6267\u884C\u6587\u4EF6\u6DFB\u52A0\u5230\u7CFB\u7EDF PATH\uFF09").option("-d, --dir <path>", "nginx \u914D\u7F6E\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A<cwd>/configs/nginx\uFF09").action(this.action.bind(this));
+  }
+  async action(options) {
+    await new _actions.NginxStartAction(options.dir).run();
+  }
+}
+exports.NginxStartCommand = NginxStartCommand;

package/dist/commands/nginx-start/nginx-start.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+/**
+ * 插件开发本地调试 nginx 启动命令
+ *
+ * @export
+ * @class NginxStartCommand
+ * @implements {ICommand}
+ */
+export declare class NginxStartCommand implements ICommand {
+    load(program: Command): void;
+    action(options: {
+        dir?: string;
+    }): Promise<void>;
+}

package/dist/constants/index.cjs

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.lib_packages = exports.branch_2_tag = void 0;
+const lib_packages = exports.lib_packages = ["@gct-paas/api", "@gct-paas/core", "@gct-paas/core-mobile", "@gct-paas/core-pad", "@gct-paas/core-web", "@gct-paas/design", "@gct-paas/design-mobile", "@gct-paas/design-pad", "@gct-paas/design-web", "@gct-paas/native", "@gct-paas/render", "@gct-paas/render-mobile", "@gct-paas/render-pad", "@gct-paas/render-web", "@gct-paas/schema", "@gct-paas/v-ben"];
+const branch_2_tag = exports.branch_2_tag = {
+  "paas-dev": "dev",
+  "paas-test": "test"
+};

package/dist/constants/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description: 底包清单
+ */
+export declare const lib_packages: string[];
+/**
+ * @description: 环境标签映射，key 是分支名，value 是 npm 发包的标签
+ */
+export declare const branch_2_tag: Record<string, string>;

package/dist/interface/i-gen-cdn-lib-options/i-gen-cdn-lib-options.d.ts

@@ -11,7 +11,7 @@ export interface IGenCdnLibOptions {
      * @default 'latest'
      * @type {string}
      */
-    tag: string;
+    tag?: string;
     /**
      * 要输出的 extras 资源目录，未指定时默认为当前执行目录
      *

package/es/actions/gen-cdn-lib/gen-cdn-lib.d.ts

@@ -6,7 +6,6 @@ import { IGenCdnLibOptions } from '../../interface';
  * @class GenCdnLibAction
  */
 export declare class GenCdnLibAction {
-    private packages;
     /**
      * 下载指定包并复制到外部依赖目录，返回入口文件名；若找不到入口文件则返回空字符串
      */

package/es/actions/gen-cdn-lib/gen-cdn-lib.mjs

@@ -3,25 +3,9 @@ import path from "path";
 import fse from "fs-extra";
 import log from "consola";
 import { Listr } from "listr2";
+import { branch_2_tag, lib_packages } from "../../constants/index.mjs";
+import { getBranchName } from "../../utils/index.mjs";
 export class GenCdnLibAction {
-  packages = [
-    "@gct-paas/api",
-    "@gct-paas/core",
-    "@gct-paas/core-mobile",
-    "@gct-paas/core-pad",
-    "@gct-paas/core-web",
-    "@gct-paas/design",
-    "@gct-paas/design-mobile",
-    "@gct-paas/design-pad",
-    "@gct-paas/design-web",
-    "@gct-paas/native",
-    "@gct-paas/render",
-    "@gct-paas/render-mobile",
-    "@gct-paas/render-pad",
-    "@gct-paas/render-web",
-    "@gct-paas/schema",
-    "@gct-paas/v-ben"
-  ];
   /**
    * 下载指定包并复制到外部依赖目录，返回入口文件名；若找不到入口文件则返回空字符串
    */
@@ -65,12 +49,22 @@ export class GenCdnLibAction {
     }
     log.info("\u6B63\u5728\u8BFB\u53D6 import-map.json...");
     const importMap = fse.readJSONSync(importMapJsonPath);
+    let tag = opts.tag;
+    if (!tag) {
+      const branch = await getBranchName();
+      if (branch) {
+        tag = branch_2_tag[branch];
+      }
+      if (!tag) {
+        tag = "latest";
+      }
+    }
     const tasks = new Listr(
-      this.packages.map((pkg) => ({
-        title: `${pkg}@${opts.tag}`,
+      lib_packages.map((pkg) => ({
+        title: `${pkg}@${tag}`,
         task: async (_, task) => {
-          task.title = `${pkg}@${opts.tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
-          const pkgInfo = await pacote.manifest(`${pkg}@${opts.tag}`, {
+          task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
+          const pkgInfo = await pacote.manifest(`${pkg}@${tag}`, {
             registry: opts.registry,
             cache: cacheDir
           });

package/es/actions/index.d.ts

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from './gen-cdn-lib/gen-cdn-lib';
 export { InitGitAction } from './init-git/init-git';
 export { RestoreFilesAction } from './restore-files/restore-files';
 export { UpdateCatalogEnvAction } from './update-catalog-env/update-catalog-env';
+export { NginxStartAction } from './nginx-start/nginx-start';

package/es/actions/index.mjs

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from "./gen-cdn-lib/gen-cdn-lib.mjs";
 export { InitGitAction } from "./init-git/init-git.mjs";
 export { RestoreFilesAction } from "./restore-files/restore-files.mjs";
 export { UpdateCatalogEnvAction } from "./update-catalog-env/update-catalog-env.mjs";
+export { NginxStartAction } from "./nginx-start/nginx-start.mjs";

package/es/actions/nginx-start/nginx-start.d.ts

@@ -0,0 +1,16 @@
+export declare class NginxStartAction {
+    private readonly nginxDir;
+    constructor(nginxDir?: string);
+    /**
+     * 停止已运行的 nginx 进程
+     * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+     * 若 nginx 未运行则忽略错误
+     */
+    private stopNginxIfRunning;
+    /**
+     * 启动 nginx
+     * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+     */
+    private startNginx;
+    run(): Promise<void>;
+}

package/es/actions/nginx-start/nginx-start.mjs

@@ -0,0 +1,53 @@
+import { execSync, spawn } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { resolve, sep } from "node:path";
+import { consola } from "consola";
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+export class NginxStartAction {
+  nginxDir;
+  constructor(nginxDir) {
+    this.nginxDir = nginxDir ?? resolve(process.cwd(), "configs/nginx");
+  }
+  /**
+   * 停止已运行的 nginx 进程
+   * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+   * 若 nginx 未运行则忽略错误
+   */
+  async stopNginxIfRunning() {
+    try {
+      if (process.platform === "win32") {
+        execSync("taskkill /F /IM nginx.exe", { stdio: "pipe" });
+      } else {
+        execSync(`nginx -p "${this.nginxDir}" -s stop`, { stdio: "pipe" });
+      }
+      consola.info("\u5DF2\u505C\u6B62\u73B0\u6709 nginx \u8FDB\u7A0B\uFF0C\u7B49\u5F85 1 \u79D2...");
+      await sleep(1e3);
+    } catch {
+      consola.info("nginx \u672A\u8FD0\u884C\uFF0C\u8DF3\u8FC7\u505C\u6B62\u6B65\u9AA4");
+    }
+  }
+  /**
+   * 启动 nginx
+   * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+   */
+  startNginx() {
+    mkdirSync(resolve(this.nginxDir, "logs"), { recursive: true });
+    mkdirSync(resolve(this.nginxDir, "temp"), { recursive: true });
+    const nginxDirNormalized = this.nginxDir.split(sep).join("/");
+    const child = spawn("nginx", ["-p", nginxDirNormalized, "-c", "nginx.conf"], {
+      cwd: process.cwd(),
+      stdio: "ignore",
+      detached: true
+    });
+    child.unref();
+  }
+  async run() {
+    consola.start("\u5F00\u59CB\u542F\u52A8 nginx...");
+    await this.stopNginxIfRunning();
+    consola.start("\u6B63\u5728\u542F\u52A8 nginx...");
+    this.startNginx();
+    consola.success("nginx \u542F\u52A8\u6267\u884C\u5B8C\u6BD5");
+  }
+}

package/es/actions/update-catalog-env/update-catalog-env.d.ts

@@ -1,4 +1,3 @@
 export declare class UpdateCatalogEnvAction {
-    private packages;
     run(): Promise<void>;
 }

package/es/actions/update-catalog-env/update-catalog-env.mjs

@@ -5,33 +5,12 @@ import fse from "fs-extra";
 import jsYaml from "js-yaml";
 import { getBranchName } from "../../utils/index.mjs";
 import path from "path";
-const envMap = {
-  "paas-dev": "dev",
-  "paas-test": "test"
-};
+import { branch_2_tag, lib_packages } from "../../constants/index.mjs";
 export class UpdateCatalogEnvAction {
-  packages = [
-    "@gct-paas/api",
-    "@gct-paas/core",
-    "@gct-paas/core-mobile",
-    "@gct-paas/core-pad",
-    "@gct-paas/core-web",
-    "@gct-paas/design",
-    "@gct-paas/design-mobile",
-    "@gct-paas/design-pad",
-    "@gct-paas/design-web",
-    "@gct-paas/native",
-    "@gct-paas/render",
-    "@gct-paas/render-mobile",
-    "@gct-paas/render-pad",
-    "@gct-paas/render-web",
-    "@gct-paas/schema",
-    "@gct-paas/v-ben"
-  ];
   async run() {
     consola.start("\u4FEE\u6539 pnpm catalog \u914D\u7F6E...");
     const branch = await getBranchName();
-    const tag = envMap[branch];
+    const tag = branch_2_tag[branch];
     if (!tag) {
       consola.info(`\u5F53\u524D\u5206\u652F ${branch} \u4E0D\u5339\u914D\u4EFB\u4F55\u73AF\u5883\u6807\u7B7E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E`);
       return;
@@ -43,13 +22,11 @@ export class UpdateCatalogEnvAction {
       consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
       return;
     }
+    const pkgsToUpdate = lib_packages.filter((pkg) => pkg in catalogCfg);
     const tasks = new Listr(
-      this.packages.map((pkg) => ({
+      pkgsToUpdate.map((pkg) => ({
         title: `\u8BBE\u7F6E ${pkg} \u7684 catalog \u6807\u7B7E\u4E3A ${tag}`,
         task: async (_, task) => {
-          if (!catalogCfg[pkg]) {
-            return;
-          }
           task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
           try {
             const pkgInfo = await pacote.manifest(`${pkg}@${tag}`);

package/es/commands/gen-cdn-lib/gen-cdn-lib.mjs

@@ -1,7 +1,7 @@
 import { GenCdnLibAction } from "../../actions/index.mjs";
 export class GenCdnLibCommand {
   load(program) {
-    program.command("gen-cdn-lib").description("\u751F\u6210 cdn \u5E93\u6587\u4EF6").option("--tag <tag>", "\u6307\u5B9A\u4E0B\u8F7D\u7684\u7248\u672C\u6807\u7B7E(latest | dev | beta | alpha)\uFF0C\u9ED8\u8BA4\u4E3A latest", "latest").option("--dir <dir>", "\u6307\u5B9A\u8F93\u51FA\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u9ED8\u8BA4\u4E3A\u5F53\u524D\u6267\u884C\u76EE\u5F55").option("--jsonPath <jsonPath>", "\u6307\u5B9A import-map.json \u6587\u4EF6\u8DEF\u5F84\uFF0C\u672A\u5236\u5B9A\u9ED8\u8BA4\u4F7F\u7528\u6307\u5B9A\u7684 dir \u76EE\u5F55\u4E0B\u7684 import-map.json \u6587\u4EF6").option("--clean", "\u662F\u5426\u6E05\u7406\u8F93\u51FA\u76EE\u5F55\u540E\u518D\u751F\u6210").option("--registry <registry>", "\u6307\u5B9A npm registry \u5730\u5740\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4 registry").option("--cache <cache>", "\u6307\u5B9A pacote \u7F13\u5B58\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u7F13\u5B58\u76EE\u5F55").option("--cleanCache", "\u6E05\u7406\u7F13\u5B58\u76EE\u5F55\uFF0C\u9ED8\u8BA4\u4E3A false", false).option("--noFiles", "\u662F\u5426\u53EA\u751F\u6210 import-map.json \u6587\u4EF6\u800C\u4E0D\u4E0B\u8F7D\u5305\u6587\u4EF6\uFF0C\u9ED8\u8BA4\u4E3A false", false).action(this.action.bind(this));
+    program.command("gen-cdn-lib").description("\u751F\u6210 cdn \u5E93\u6587\u4EF6").option("--tag <tag>", "\u6307\u5B9A\u4E0B\u8F7D\u7684\u7248\u672C\u6807\u7B7E(latest | dev | beta | alpha)\uFF0C\u9ED8\u8BA4\u4E3A latest").option("--dir <dir>", "\u6307\u5B9A\u8F93\u51FA\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u9ED8\u8BA4\u4E3A\u5F53\u524D\u6267\u884C\u76EE\u5F55").option("--jsonPath <jsonPath>", "\u6307\u5B9A import-map.json \u6587\u4EF6\u8DEF\u5F84\uFF0C\u672A\u5236\u5B9A\u9ED8\u8BA4\u4F7F\u7528\u6307\u5B9A\u7684 dir \u76EE\u5F55\u4E0B\u7684 import-map.json \u6587\u4EF6").option("--clean", "\u662F\u5426\u6E05\u7406\u8F93\u51FA\u76EE\u5F55\u540E\u518D\u751F\u6210").option("--registry <registry>", "\u6307\u5B9A npm registry \u5730\u5740\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4 registry").option("--cache <cache>", "\u6307\u5B9A pacote \u7F13\u5B58\u76EE\u5F55\uFF0C\u672A\u6307\u5B9A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u7F13\u5B58\u76EE\u5F55").option("--cleanCache", "\u6E05\u7406\u7F13\u5B58\u76EE\u5F55\uFF0C\u9ED8\u8BA4\u4E3A false", false).option("--noFiles", "\u662F\u5426\u53EA\u751F\u6210 import-map.json \u6587\u4EF6\u800C\u4E0D\u4E0B\u8F7D\u5305\u6587\u4EF6\uFF0C\u9ED8\u8BA4\u4E3A false", false).action(this.action.bind(this));
   }
   async action(args) {
     await new GenCdnLibAction().run(

package/es/commands/index.mjs

@@ -4,6 +4,7 @@ import { GenCdnLibCommand } from "./gen-cdn-lib/gen-cdn-lib.mjs";
 import { InitGitCommand } from "./init-git/init-git.mjs";
 import { RestoreFilesCommand } from "./restore-files/restore-files.mjs";
 import { UpdateCatalogEnvCommand } from "./update-catalog-env/update-catalog-env.mjs";
+import { NginxStartCommand } from "./nginx-start/nginx-start.mjs";
 export class CommandLoader {
   static load(program) {
     new GenApiCommand().load(program);
@@ -11,6 +12,7 @@ export class CommandLoader {
     new InitGitCommand().load(program);
     new RestoreFilesCommand().load(program);
     new UpdateCatalogEnvCommand().load(program);
+    new NginxStartCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/es/commands/nginx-start/nginx-start.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+/**
+ * 插件开发本地调试 nginx 启动命令
+ *
+ * @export
+ * @class NginxStartCommand
+ * @implements {ICommand}
+ */
+export declare class NginxStartCommand implements ICommand {
+    load(program: Command): void;
+    action(options: {
+        dir?: string;
+    }): Promise<void>;
+}

package/es/commands/nginx-start/nginx-start.mjs

@@ -0,0 +1,9 @@
+import { NginxStartAction } from "../../actions/index.mjs";
+export class NginxStartCommand {
+  load(program) {
+    program.command("nginx-start").description("\u542F\u52A8 nginx\uFF08\u9700\u5C06 nginx \u53EF\u6267\u884C\u6587\u4EF6\u6DFB\u52A0\u5230\u7CFB\u7EDF PATH\uFF09").option("-d, --dir <path>", "nginx \u914D\u7F6E\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A<cwd>/configs/nginx\uFF09").action(this.action.bind(this));
+  }
+  async action(options) {
+    await new NginxStartAction(options.dir).run();
+  }
+}

package/es/constants/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description: 底包清单
+ */
+export declare const lib_packages: string[];
+/**
+ * @description: 环境标签映射，key 是分支名，value 是 npm 发包的标签
+ */
+export declare const branch_2_tag: Record<string, string>;

package/es/constants/index.mjs

@@ -0,0 +1,22 @@
+export const lib_packages = [
+  "@gct-paas/api",
+  "@gct-paas/core",
+  "@gct-paas/core-mobile",
+  "@gct-paas/core-pad",
+  "@gct-paas/core-web",
+  "@gct-paas/design",
+  "@gct-paas/design-mobile",
+  "@gct-paas/design-pad",
+  "@gct-paas/design-web",
+  "@gct-paas/native",
+  "@gct-paas/render",
+  "@gct-paas/render-mobile",
+  "@gct-paas/render-pad",
+  "@gct-paas/render-web",
+  "@gct-paas/schema",
+  "@gct-paas/v-ben"
+];
+export const branch_2_tag = {
+  "paas-dev": "dev",
+  "paas-test": "test"
+};

package/es/interface/i-gen-cdn-lib-options/i-gen-cdn-lib-options.d.ts

@@ -11,7 +11,7 @@ export interface IGenCdnLibOptions {
      * @default 'latest'
      * @type {string}
      */
-    tag: string;
+    tag?: string;
     /**
      * 要输出的 extras 资源目录，未指定时默认为当前执行目录
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "paas 平台核心包",
   "bin": {