@gct-paas/cli 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -7,6 +7,20 @@
 
 ## [Unreleased]
 
+## [0.1.8] - 2026-04-02
+
+### Changed
+
+- 命令 gen-cdn-lib 改为 tag 默认识别当前运行项目分支映射，也可单独指定
+
+## [0.1.7] - 2026-04-02
+
+### Added
+
+- 命令 init-git 初始化项目获取到本地后的配置
+- 命令 update-catalog-env 根据分支修改 pnpm catalog 配置，使具体分支使用对应环境的底包
+- 命令 restore-files 还原指定的已经修改的文件列表，目前还原修改的 pnpm-workspace.yaml 文件
+
 ## [0.1.3] - 2025-06-16
 
 ### 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,20 @@ Object.defineProperty(exports, "InitGitAction", {
     return _initGit.InitGitAction;
   }
 });
+Object.defineProperty(exports, "RestoreFilesAction", {
+  enumerable: true,
+  get: function () {
+    return _restoreFiles.RestoreFilesAction;
+  }
+});
+Object.defineProperty(exports, "UpdateCatalogEnvAction", {
+  enumerable: true,
+  get: function () {
+    return _updateCatalogEnv.UpdateCatalogEnvAction;
+  }
+});
 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 _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");

package/dist/actions/index.d.ts

@@ -1,3 +1,5 @@
 export { GenApiAction } from './gen-api/gen-api';
 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';

package/dist/actions/restore-files/restore-files.cjs

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RestoreFilesAction = void 0;
+var _consola = require("consola");
+var _simpleGit = _interopRequireDefault(require("simple-git"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const FILES_TO_RESTORE = ["pnpm-workspace.yaml"];
+class RestoreFilesAction {
+  async run() {
+    const git = (0, _simpleGit.default)(process.cwd());
+    _consola.consola.start(`\u8FD8\u539F\u6587\u4EF6: ${FILES_TO_RESTORE.join(", ")}`);
+    await git.checkout(FILES_TO_RESTORE);
+    _consola.consola.success("\u6587\u4EF6\u8FD8\u539F\u5B8C\u6210");
+  }
+}
+exports.RestoreFilesAction = RestoreFilesAction;

package/dist/actions/restore-files/restore-files.d.ts

@@ -0,0 +1,3 @@
+export declare class RestoreFilesAction {
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UpdateCatalogEnvAction = void 0;
+var _pacote = _interopRequireDefault(require("pacote"));
+var _consola = require("consola");
+var _listr = require("listr2");
+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 }; }
+class UpdateCatalogEnvAction {
+  async run() {
+    _consola.consola.start("\u4FEE\u6539 pnpm catalog \u914D\u7F6E...");
+    const branch = await (0, _utils.getBranchName)();
+    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;
+    }
+    const catalogPath = _path.default.join(process.cwd(), "pnpm-workspace.yaml");
+    const pnpmConfig = _jsYaml.default.load(await _fsExtra.default.readFile(catalogPath, "utf-8"));
+    const catalogCfg = pnpmConfig.catalog;
+    if (!catalogCfg) {
+      _consola.consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
+      return;
+    }
+    const tasks = new _listr.Listr(_constants.lib_packages.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}`);
+          catalogCfg[pkg] = pkgInfo.version;
+        } catch (error) {
+          const err = error;
+          throw new Error(`\u65E0\u6CD5\u83B7\u53D6 ${pkg}@${tag} \u7684\u7248\u672C\u4FE1\u606F\uFF0C\u53EF\u80FD\u662F\u5305\u4E0D\u5B58\u5728\u6216\u7F51\u7EDC\u95EE\u9898: ${err.message}`);
+        }
+      }
+    })), {
+      concurrent: true
+    });
+    await tasks.run();
+    await _fsExtra.default.writeFile(catalogPath, _jsYaml.default.dump(pnpmConfig, {
+      indent: 2
+    }), "utf-8");
+    _consola.consola.success("pnpm catalog \u914D\u7F6E\u4FEE\u6539\u5B8C\u6210");
+  }
+}
+exports.UpdateCatalogEnvAction = UpdateCatalogEnvAction;

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

@@ -0,0 +1,3 @@
+export declare class UpdateCatalogEnvAction {
+    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

@@ -8,11 +8,15 @@ var _consola = require("consola");
 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");
 class CommandLoader {
   static load(program) {
     new _genApi.GenApiCommand().load(program);
     new _genCdnLib.GenCdnLibCommand().load(program);
     new _initGit.InitGitCommand().load(program);
+    new _restoreFiles.RestoreFilesCommand().load(program);
+    new _updateCatalogEnv.UpdateCatalogEnvCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/dist/commands/restore-files/restore-files.cjs

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RestoreFilesCommand = void 0;
+var _actions = require("../../actions/index.cjs");
+class RestoreFilesCommand {
+  load(program) {
+    program.command("restore-files").description("\u8FD8\u539F\u9884\u8BBE\u7684\u5DF2\u4FEE\u6539\u6587\u4EF6\u5217\u8868\u5230 HEAD \u7248\u672C").action(this.action.bind(this));
+  }
+  async action() {
+    await new _actions.RestoreFilesAction().run();
+  }
+}
+exports.RestoreFilesCommand = RestoreFilesCommand;

package/dist/commands/restore-files/restore-files.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+export declare class RestoreFilesCommand implements ICommand {
+    load(program: Command): void;
+    action(): Promise<void>;
+}

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

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UpdateCatalogEnvCommand = void 0;
+var _actions = require("../../actions/index.cjs");
+class UpdateCatalogEnvCommand {
+  load(program) {
+    program.command("update-catalog-env").description("\u6839\u636E git \u5206\u652F\uFF0C\u66F4\u65B0\u9879\u76EE pnpm catalog \u914D\u7F6E\u4E3A\u5177\u4F53\u73AF\u5883").action(this.action.bind(this));
+  }
+  async action() {
+    await new _actions.UpdateCatalogEnvAction().run();
+  }
+}
+exports.UpdateCatalogEnvCommand = UpdateCatalogEnvCommand;

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

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+export declare class UpdateCatalogEnvCommand implements ICommand {
+    load(program: Command): void;
+    action(): 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/dist/utils/git-util/git-util.cjs

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getBranchName = getBranchName;
+var _simpleGit = _interopRequireDefault(require("simple-git"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+async function getBranchName() {
+  let targetBranch = process.env.CI_COMMIT_BRANCH || process.env.CI_BUILD_REF_NAME;
+  if (!targetBranch) {
+    const cwdGit = (0, _simpleGit.default)(process.cwd());
+    try {
+      const raw = await cwdGit.revparse(["--abbrev-ref", "HEAD"]);
+      const resolved = raw.trim();
+      if (resolved && resolved !== "HEAD") {
+        targetBranch = resolved;
+      }
+    } catch {}
+  }
+  if (!targetBranch) {
+    throw new Error("\u65E0\u6CD5\u81EA\u52A8\u83B7\u53D6\u5F53\u524D git \u5206\u652F\uFF1A\u5F53\u524D\u53EF\u80FD\u5904\u4E8E\u6E38\u79BB HEAD\uFF08detached HEAD\uFF09\u72B6\u6001\uFF08CI \u73AF\u5883\u5E38\u89C1\uFF09\u3002\u8BF7\u901A\u8FC7 options.branch \u660E\u786E\u6307\u5B9A\u5206\u652F\u540D\uFF0C\u6216\u786E\u4FDD\u73AF\u5883\u53D8\u91CF CI_COMMIT_BRANCH / CI_BUILD_REF_NAME \u5DF2\u8BBE\u7F6E\u3002");
+  }
+  return targetBranch;
+}

package/dist/utils/git-util/git-util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 获取当前执行命令项目的 git 分支名，优先使用 CI 环境变量，兼容游离 HEAD（detached HEAD）状态
+ *
+ * @export
+ * @return {*}  {Promise<string>}
+ */
+export declare function getBranchName(): Promise<string>;

package/dist/utils/index.cjs

@@ -3,6 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _exportNames = {
+  localBinExists: true,
+  loadLocalBinCommandLoader: true
+};
 Object.defineProperty(exports, "loadLocalBinCommandLoader", {
   enumerable: true,
   get: function () {
@@ -15,4 +19,16 @@ Object.defineProperty(exports, "localBinExists", {
     return _localBinaries.localBinExists;
   }
 });
+var _gitUtil = require("./git-util/git-util.cjs");
+Object.keys(_gitUtil).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _gitUtil[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _gitUtil[key];
+    }
+  });
+});
 var _localBinaries = require("./local-binaries/local-binaries.cjs");

package/dist/utils/index.d.ts

@@ -1 +1,2 @@
+export * from './git-util/git-util';
 export { localBinExists, loadLocalBinCommandLoader, } from './local-binaries/local-binaries';

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

@@ -1,3 +1,5 @@
 export { GenApiAction } from './gen-api/gen-api';
 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';

package/es/actions/index.mjs

@@ -1,3 +1,5 @@
 export { GenApiAction } from "./gen-api/gen-api.mjs";
 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";

package/es/actions/restore-files/restore-files.d.ts

@@ -0,0 +1,3 @@
+export declare class RestoreFilesAction {
+    run(): Promise<void>;
+}

package/es/actions/restore-files/restore-files.mjs

@@ -0,0 +1,13 @@
+import { consola } from "consola";
+import simpleGit from "simple-git";
+const FILES_TO_RESTORE = [
+  "pnpm-workspace.yaml"
+];
+export class RestoreFilesAction {
+  async run() {
+    const git = simpleGit(process.cwd());
+    consola.start(`\u8FD8\u539F\u6587\u4EF6: ${FILES_TO_RESTORE.join(", ")}`);
+    await git.checkout(FILES_TO_RESTORE);
+    consola.success("\u6587\u4EF6\u8FD8\u539F\u5B8C\u6210");
+  }
+}

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

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

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

@@ -0,0 +1,48 @@
+import pacote from "pacote";
+import { consola } from "consola";
+import { Listr } from "listr2";
+import fse from "fs-extra";
+import jsYaml from "js-yaml";
+import { getBranchName } from "../../utils/index.mjs";
+import path from "path";
+import { branch_2_tag, lib_packages } from "../../constants/index.mjs";
+export class UpdateCatalogEnvAction {
+  async run() {
+    consola.start("\u4FEE\u6539 pnpm catalog \u914D\u7F6E...");
+    const branch = await getBranchName();
+    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;
+    }
+    const catalogPath = path.join(process.cwd(), "pnpm-workspace.yaml");
+    const pnpmConfig = jsYaml.load(await fse.readFile(catalogPath, "utf-8"));
+    const catalogCfg = pnpmConfig.catalog;
+    if (!catalogCfg) {
+      consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
+      return;
+    }
+    const tasks = new Listr(
+      lib_packages.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}`);
+            catalogCfg[pkg] = pkgInfo.version;
+          } catch (error) {
+            const err = error;
+            throw new Error(`\u65E0\u6CD5\u83B7\u53D6 ${pkg}@${tag} \u7684\u7248\u672C\u4FE1\u606F\uFF0C\u53EF\u80FD\u662F\u5305\u4E0D\u5B58\u5728\u6216\u7F51\u7EDC\u95EE\u9898: ${err.message}`);
+          }
+        }
+      })),
+      { concurrent: true }
+    );
+    await tasks.run();
+    await fse.writeFile(catalogPath, jsYaml.dump(pnpmConfig, { indent: 2 }), "utf-8");
+    consola.success("pnpm catalog \u914D\u7F6E\u4FEE\u6539\u5B8C\u6210");
+  }
+}

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

@@ -2,11 +2,15 @@ import { consola } from "consola";
 import { GenApiCommand } from "./gen-api/gen-api.mjs";
 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";
 export class CommandLoader {
   static load(program) {
     new GenApiCommand().load(program);
     new GenCdnLibCommand().load(program);
     new InitGitCommand().load(program);
+    new RestoreFilesCommand().load(program);
+    new UpdateCatalogEnvCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/es/commands/restore-files/restore-files.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+export declare class RestoreFilesCommand implements ICommand {
+    load(program: Command): void;
+    action(): Promise<void>;
+}

package/es/commands/restore-files/restore-files.mjs

@@ -0,0 +1,9 @@
+import { RestoreFilesAction } from "../../actions/index.mjs";
+export class RestoreFilesCommand {
+  load(program) {
+    program.command("restore-files").description("\u8FD8\u539F\u9884\u8BBE\u7684\u5DF2\u4FEE\u6539\u6587\u4EF6\u5217\u8868\u5230 HEAD \u7248\u672C").action(this.action.bind(this));
+  }
+  async action() {
+    await new RestoreFilesAction().run();
+  }
+}

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

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+export declare class UpdateCatalogEnvCommand implements ICommand {
+    load(program: Command): void;
+    action(): Promise<void>;
+}

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

@@ -0,0 +1,9 @@
+import { UpdateCatalogEnvAction } from "../../actions/index.mjs";
+export class UpdateCatalogEnvCommand {
+  load(program) {
+    program.command("update-catalog-env").description("\u6839\u636E git \u5206\u652F\uFF0C\u66F4\u65B0\u9879\u76EE pnpm catalog \u914D\u7F6E\u4E3A\u5177\u4F53\u73AF\u5883").action(this.action.bind(this));
+  }
+  async action() {
+    await new UpdateCatalogEnvAction().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/es/utils/git-util/git-util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 获取当前执行命令项目的 git 分支名，优先使用 CI 环境变量，兼容游离 HEAD（detached HEAD）状态
+ *
+ * @export
+ * @return {*}  {Promise<string>}
+ */
+export declare function getBranchName(): Promise<string>;

package/es/utils/git-util/git-util.mjs

@@ -0,0 +1,21 @@
+import simpleGit from "simple-git";
+export async function getBranchName() {
+  let targetBranch = process.env.CI_COMMIT_BRANCH || process.env.CI_BUILD_REF_NAME;
+  if (!targetBranch) {
+    const cwdGit = simpleGit(process.cwd());
+    try {
+      const raw = await cwdGit.revparse(["--abbrev-ref", "HEAD"]);
+      const resolved = raw.trim();
+      if (resolved && resolved !== "HEAD") {
+        targetBranch = resolved;
+      }
+    } catch {
+    }
+  }
+  if (!targetBranch) {
+    throw new Error(
+      "\u65E0\u6CD5\u81EA\u52A8\u83B7\u53D6\u5F53\u524D git \u5206\u652F\uFF1A\u5F53\u524D\u53EF\u80FD\u5904\u4E8E\u6E38\u79BB HEAD\uFF08detached HEAD\uFF09\u72B6\u6001\uFF08CI \u73AF\u5883\u5E38\u89C1\uFF09\u3002\u8BF7\u901A\u8FC7 options.branch \u660E\u786E\u6307\u5B9A\u5206\u652F\u540D\uFF0C\u6216\u786E\u4FDD\u73AF\u5883\u53D8\u91CF CI_COMMIT_BRANCH / CI_BUILD_REF_NAME \u5DF2\u8BBE\u7F6E\u3002"
+    );
+  }
+  return targetBranch;
+}

package/es/utils/index.d.ts

@@ -1 +1,2 @@
+export * from './git-util/git-util';
 export { localBinExists, loadLocalBinCommandLoader, } from './local-binaries/local-binaries';

package/es/utils/index.mjs

@@ -1,3 +1,4 @@
+export * from "./git-util/git-util.mjs";
 export {
   localBinExists,
   loadLocalBinCommandLoader

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "paas 平台核心包",
   "bin": {
@@ -33,8 +33,18 @@
   },
   "license": "MIT",
   "author": "gct",
+  "scripts": {
+    "run": "tsx src/bin.ts gen-cdn-lib --tag=dev --dir=/Users/zhr/workspace/gct/gct-paas-cdn/extras",
+    "build": "unbuild",
+    "publish:next": "npm run build && npm publish --access public --tag=next --registry=https://registry.npmjs.org/",
+    "publish:dev": "npm run build && npm publish --access public --tag=dev --registry=https://registry.npmjs.org/",
+    "publish:alpha": "npm run build && npm publish --access public --tag=alpha --registry=https://registry.npmjs.org/",
+    "publish:beta": "npm run build && npm publish --access public --tag=beta --registry=https://registry.npmjs.org/",
+    "publish:npm": "npm run build && npm publish --access public --registry=https://registry.npmjs.org/"
+  },
   "dependencies": {
     "@inquirer/prompts": "^8.2.0",
+    "@types/js-yaml": "^4.0.9",
     "commander": "^14.0.2",
     "consola": "^3.4.2",
     "core-js": "^3.48.0",
@@ -43,6 +53,7 @@
     "got": "^14.6.6",
     "handlebars": "^4.7.8",
     "handlebars-helpers": "^0.10.0",
+    "js-yaml": "^4.1.1",
     "listr2": "^10.2.1",
     "lodash-es": "^4.17.23",
     "ora": "^9.1.0",
@@ -59,14 +70,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
-  },
-  "scripts": {
-    "run": "tsx src/bin.ts gen-cdn-lib --tag=dev --dir=/Users/zhr/workspace/gct/gct-paas-cdn/extras",
-    "build": "unbuild",
-    "publish:next": "npm run build && npm publish --access public --tag=next --registry=https://registry.npmjs.org/",
-    "publish:dev": "npm run build && npm publish --access public --tag=dev --registry=https://registry.npmjs.org/",
-    "publish:alpha": "npm run build && npm publish --access public --tag=alpha --registry=https://registry.npmjs.org/",
-    "publish:beta": "npm run build && npm publish --access public --tag=beta --registry=https://registry.npmjs.org/",
-    "publish:npm": "npm run build && npm publish --access public --registry=https://registry.npmjs.org/"
   }
-}
+}