@coze-arch/rush-publish-plugin 0.0.4 → 0.0.5-alpha.1ae01f

package/lib/index.js

@@ -13,6 +13,9 @@ var prompts = require('@inquirer/prompts');
 var dayjs = require('dayjs');
 var ChangeFile = require('@rushstack/rush-sdk/lib/api/ChangeFile');
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
 /**
  * 日志工具
  *
@@ -142,6 +145,34 @@ const logger = {
   },
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+/**
+ * 默认的 NPM registry 地址
+ */
+const DEFAULT_NPM_REGISTRY = 'https://registry.npmjs.org';
+
+/**
+ * 默认的 Git 分支名前缀
+ */
+const DEFAULT_BRANCH_PREFIX = 'bump';
+
+/**
+ * 默认允许发布正式版本的分支列表
+ */
+const DEFAULT_ALLOW_BRANCHES = ['main', 'feat/auto-publish'];
+
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
+
+
+
+
 class ExecError extends Error {
   
   
@@ -168,6 +199,10 @@ const exec = (
     });
   });
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const serializeFilesName = (output) =>
   output
     .split('\n')
@@ -197,6 +232,15 @@ const getCurrentBranchName = async () => {
   return stdout.trim();
 };
 
+/**
+ * 获取当前 commit hash
+ * @returns commit hash
+ */
+const getCurrentCommitHash = async () => {
+  const { stdout } = await exec('git rev-parse HEAD');
+  return stdout.trim();
+};
+
 const isMainBranch = async () => {
   const currentBranchName = await getCurrentBranchName();
   return currentBranchName === 'main';
@@ -238,6 +282,88 @@ const getCurrentOrigin = async (
   }
 };
 
+/**
+ * 解析 Git 远程仓库 URL，提取主机和仓库路径
+ * 支持 HTTP/HTTPS 和 SSH 格式
+ * @param gitUrl Git 仓库 URL
+ * @returns 包含主机和仓库路径的对象，解析失败返回 null
+ */
+const parseGitRemoteUrl = (
+  gitUrl,
+) => {
+  if (!gitUrl) {
+    return null;
+  }
+
+  const trimmedUrl = gitUrl.trim().replace(/\.git$/, '');
+
+  // 匹配 SSH 格式: git@github.com:owner/repo.git
+  const sshMatch = trimmedUrl.match(/^git@([^:]+):(.+)$/);
+  if (sshMatch) {
+    const host = sshMatch[1];
+    const path = sshMatch[2];
+    return {
+      host,
+      path,
+      fullUrl: `https://${host}/${path}`,
+    };
+  }
+
+  // 匹配 HTTP/HTTPS 格式: https://github.com/owner/repo.git
+  const httpMatch = trimmedUrl.match(/^https?:\/\/([^/]+)\/(.+)$/);
+  if (httpMatch) {
+    const host = httpMatch[1];
+    const path = httpMatch[2];
+    return {
+      host,
+      path,
+      fullUrl: `https://${host}/${path}`,
+    };
+  }
+
+  return null;
+};
+
+/**
+ * 根据仓库信息构建 MR/PR 创建链接
+ * @param repoInfo 仓库信息
+ * @param branchName 分支名称
+ * @returns MR/PR 创建链接，如果无法构建则返回 null
+ */
+const buildMergeRequestUrl = (
+  repoInfo,
+  branchName,
+) => {
+  const { host, fullUrl } = repoInfo;
+
+  // GitHub
+  if (host.includes('github.com')) {
+    return `${fullUrl}/compare/${branchName}?expand=1`;
+  }
+
+  // GitLab
+  if (host.includes('gitlab')) {
+    return `${fullUrl}/-/merge_requests/new?merge_request[source_branch]=${branchName}`;
+  }
+
+  // Gitee
+  if (host.includes('gitee.com')) {
+    return `${fullUrl}/compare/${branchName}...master`;
+  }
+
+  // Bitbucket
+  if (host.includes('bitbucket')) {
+    return `${fullUrl}/pull-requests/new?source=${branchName}`;
+  }
+
+  // 无法识别的平台
+  return null;
+};
+
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const readJsonFile = async ( path) => {
   const content = await fs.readFile(path, 'utf8');
   return JSON.parse(content) ;
@@ -259,7 +385,11 @@ const isDirExists = async (path) =>
     .then(() => true)
     .catch(() => false);
 
-const getRushConfiguration = (() => {
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+const getRushConfiguration$1 = (() => {
   let rushConfiguration = null;
   return (useCache = true) => {
     if (!useCache) {
@@ -271,19 +401,32 @@ const getRushConfiguration = (() => {
   };
 })();
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
+
+
+
+
+
 /**
  * 更新依赖版本
  */
 const updateDependencyVersions = async (
   packageJson,
 ) => {
-  const rushConfiguration = getRushConfiguration();
-  const { dependencies } = packageJson;
-  if (dependencies) {
-    for (const [dep, ver] of Object.entries(dependencies)) {
-      const project = rushConfiguration.getProjectByName(dep);
-      if (/^workspace:/.test(ver) && project) {
-        dependencies[dep] = project.packageJson.version;
+  const rushConfiguration = getRushConfiguration$1();
+  const depTypes = ['dependencies', 'peerDependencies'];
+  for (const depType of depTypes) {
+    if (packageJson[depType]) {
+      for (const [dep, ver] of Object.entries(packageJson[depType])) {
+        const project = rushConfiguration.getProjectByName(dep);
+        if (/^workspace:/.test(ver) && project) {
+          packageJson[depType][dep] = project.packageJson.version;
+        }
       }
     }
   }
@@ -331,7 +474,12 @@ const publishPackage = async (
     : version.includes('beta')
       ? 'beta'
       : 'latest';
-  const args = [`NPM_AUTH_TOKEN=${token}`, 'npm', 'publish', `--tag ${tag}`];
+  const setToken = `npm config set //bnpm.byted.org/:_authToken ${token}`;
+  await exec(setToken, {
+    cwd: project.projectFolder,
+  });
+
+  const args = [`NODE_AUTH_TOKEN=${token}`, 'npm', 'publish', `--tag ${tag}`];
   if (dryRun) {
     args.push('--dry-run');
   }
@@ -406,33 +554,51 @@ const calReleasePlan = (releaseManifests) => {
 const checkReleasePlan = (
   releaseManifests,
   branchName,
+  allowBranches = ['main', 'feat/auto-publish'],
 ) => {
   const releasePlan = calReleasePlan(releaseManifests);
   if (
     releasePlan === ReleaseType.LATEST &&
-    !['main', 'feat/auto-publish'].includes(branchName)
+    !allowBranches.includes(branchName)
   ) {
-    throw new Error('For LATEST release, should be on main branch only.');
+    throw new Error(
+      `For LATEST release, should be on one of these branches: ${allowBranches.join(', ')}. Current Branch: ${branchName}`,
+    );
   }
   return true;
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
 /**
  * 构建发布依赖树
  */
 function buildReleaseManifest(
   packages,
 ) {
-  const rushConfiguration = getRushConfiguration();
-  return packages.map(pkg => {
-    const project = rushConfiguration.getProjectByName(pkg.packageName);
-    if (!project) {
-      throw new Error(`Cannot find project: ${pkg.packageName}`);
-    }
-    return { project, version: project.packageJson.version };
-  });
+  const rushConfiguration = getRushConfiguration$1();
+  return packages
+    .map(pkg => {
+      const project = rushConfiguration.getProjectByName(pkg.packageName);
+      if (!project) {
+        throw new Error(`Cannot find project: ${pkg.packageName}`);
+      }
+      if (project.shouldPublish) {
+        return { project, version: project.packageJson.version };
+      }
+      return undefined;
+    })
+    .filter(Boolean) ;
 }
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
 /**
  * 从 git tag 中解析需要发布的包信息
  */
@@ -461,11 +627,37 @@ const getPackagesToPublish = async (
   return packages;
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 async function release(options) {
-  const { commit, dryRun = false, registry } = options;
+  const {
+    dryRun = false,
+    registry,
+    packages,
+    allowBranches = DEFAULT_ALLOW_BRANCHES,
+  } = options;
+  let { commit } = options;
+  const hasPassedCommit = !!options.commit;
 
   // 1. 获取需要发布的包列表
-  const packagesToPublish = await getPackagesToPublish(commit);
+  let packagesToPublish;
+  if (packages) {
+    // 直接使用传入的包列表
+    packagesToPublish = packages;
+    logger.info('Using provided package list');
+  } else {
+    // 从 git tags 获取包列表
+    if (!hasPassedCommit) {
+      commit = await getCurrentCommitHash();
+      logger.info('Using current commit');
+    }
+    // 此时 commit 必定有值（要么传入了，要么刚获取了）
+    const commitHash = commit ;
+    packagesToPublish = await getPackagesToPublish(commitHash);
+  }
+
   if (packagesToPublish.length === 0) {
     logger.warn('No packages to publish');
     return;
@@ -481,8 +673,16 @@ async function release(options) {
     false,
   );
   const branchName = await getCurrentBranchName();
-  checkReleasePlan(releaseManifests, branchName);
-  await exec(`git checkout ${commit}`);
+  checkReleasePlan(releaseManifests, branchName, allowBranches);
+
+  // 只有在指定了 commit 且与当前 HEAD 不同时才切换
+  if (hasPassedCommit) {
+    const currentHead = await getCurrentCommitHash();
+    if (currentHead !== commit) {
+      logger.info(`Checking out commit: ${commit}`);
+      await exec(`git checkout ${commit}`);
+    }
+  }
 
   await releasePackages(releaseManifests, { dryRun, registry });
   logger.success('All packages published successfully!');
@@ -498,18 +698,19 @@ const installAction$2 = (program) => {
   program
     .command('release')
     .description('Release packages based on git tags.')
-    .requiredOption('--commit <string>', '需要执行发布的 commit id')
+    .option('--commit <string>', '需要执行发布的 commit id (默认使用当前 HEAD)')
     .option('--dry-run', '是否只执行不真实发布', false)
     .option(
       '-r, --registry <string>',
-      '发布到的 registry',
-      'https://registry.npmjs.org',
+      `发布到的 registry (默认: ${DEFAULT_NPM_REGISTRY})`,
+      DEFAULT_NPM_REGISTRY,
+    )
+    .option(
+      '--allow-branches <branches...>',
+      `允许发布正式版本的分支列表 (默认: ${DEFAULT_ALLOW_BRANCHES.join(', ')})`,
     )
     .action(async (options) => {
       try {
-        if (!options.commit) {
-          throw new Error('请提供需要发布的 commit id');
-        }
         if (!process.env.NPM_AUTH_TOKEN) {
           throw new Error('请设置 NPM_AUTH_TOKEN 环境变量');
         }
@@ -522,7 +723,14 @@ const installAction$2 = (program) => {
     });
 };
 
-const GIT_REPO_URL_REGEX = /git@github\.com:([^\/]+)\/([^\.]+)\.git/;
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+const GIT_REPO_URL_REGEX = /git@.+:([^\/]+)\/([^\.]+)\.git/;
+
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
 
 /**
  * 生成指定长度的随机字符串(使用 crypto 模块)
@@ -544,6 +752,10 @@ var BumpType; (function (BumpType) {
   const MAJOR = 'major'; BumpType["MAJOR"] = MAJOR;
 })(BumpType || (BumpType = {}));
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 /**
  * 获取更新类型的描述
  */
@@ -592,6 +804,16 @@ const requestBumpType = async () => {
   }
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
+
+
+
+
 /**
  * 根据当前版本和发布类型计算新版本号
  */
@@ -718,28 +940,24 @@ const generatePublishManifest = async (
   };
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
+
+
+
 async function commitChanges({
-  sessionId,
   files,
   cwd,
-  publishManifests,
   branchName,
-  createTags,
 }) {
   await exec(`git add ${files.join(' ')}`, { cwd });
   await exec(`git commit -m "chore: Publish ${branchName}" -n`, { cwd });
 
-  let tags = [];
-  if (createTags) {
-    tags = publishManifests.map(
-      m => `v/${m.project.packageName}@${m.newVersion}`,
-    );
-    await exec(
-      tags.map(tag => `git tag -a ${tag} -m "Bump type ${tag}"`).join(' && '),
-      { cwd },
-    );
-  }
-  return { effects: [...tags, branchName], branchName };
+  return { effects: [branchName], branchName };
 }
 
 
@@ -754,83 +972,307 @@ async function push({ refs, cwd, repoUrl }) {
   });
 }
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+/**
+ * 获取或创建发布分支
+ */
+const getOrCreateBranch = async (params
+
+
+
+
+) => {
+  const { bumpPolicy, sessionId, branchPrefix, cwd } = params;
+
+  if (bumpPolicy === BumpType.BETA) {
+    return await getCurrentBranchName();
+  }
+
+  const date = dayjs().format('YYYYMMDD');
+  const branchName = `${branchPrefix}/${date}-${sessionId}`;
+  await exec(`git checkout -b ${branchName}`, { cwd });
+  return branchName;
+};
+
+/**
+ * 处理 Beta 发布流程：询问并执行 git push
+ */
+const handleBetaPublish = async (
+  branchName,
+  cwd,
+) => {
+  logger.success(`Changes have been committed to branch "${branchName}".`);
+
+  const shouldPush = await prompts.confirm({
+    message: 'Do you want to push the changes now?',
+    default: true,
+  });
+
+  if (shouldPush) {
+    logger.info('Pushing changes to remote...');
+    await exec('git push', { cwd });
+    logger.success('Changes pushed successfully!');
+  } else {
+    logger.info('Please run "git push" manually when you are ready.');
+  }
+};
+
+/**
+ * 显示手动创建 MR 的提示消息
+ */
+const showManualMrMessage = (
+  branchName,
+  repositoryUrl,
+) => {
+  const baseMessage = `Please create a merge request from branch "${branchName}" to the main branch`;
+  const suffix =
+    'The release will be triggered after the merge request is merged.';
+
+  if (repositoryUrl) {
+    logger.success(
+      `Repository: ${repositoryUrl}\n${baseMessage}.\n${suffix}`,
+      false,
+    );
+  } else {
+    logger.success(`${baseMessage} in your repository.\n${suffix}`);
+  }
+};
+
+/**
+ * 显示 MR/PR 创建链接并打开浏览器
+ */
+const showMrLinkAndOpenBrowser = async (mrUrl) => {
+  const log = [
+    '************************************************',
+    '*',
+    `* Please create MR/PR: ${mrUrl}`,
+    '*',
+    '* The release will be triggered after the MR is merged.',
+    '*',
+    '************************************************',
+  ];
+  logger.success(log.join('\n'), false);
+
+  const open = await import('open');
+  await open.default(mrUrl);
+};
+
+/**
+ * 处理正式版本发布流程：提示创建 MR/PR
+ */
+const handleProductionPublish = async (
+  branchName,
+  cwd,
+) => {
+  const originUrl = await getCurrentOrigin(cwd);
+  if (!originUrl) {
+    showManualMrMessage(branchName);
+    return;
+  }
+
+  const repoInfo = parseGitRemoteUrl(originUrl);
+  if (!repoInfo) {
+    showManualMrMessage(branchName);
+    return;
+  }
+
+  const mrUrl = buildMergeRequestUrl(repoInfo, branchName);
+  if (!mrUrl) {
+    showManualMrMessage(branchName, repoInfo.fullUrl);
+    return;
+  }
+
+  await showMrLinkAndOpenBrowser(mrUrl);
+};
+
+/**
+ * 根据发布类型处理后续提示
+ */
+const handlePostPushPrompts = async (
+  bumpPolicy,
+  branchName,
+  cwd,
+) => {
+  const isAlphaPublish = bumpPolicy === BumpType.ALPHA;
+  const isBetaPublish = bumpPolicy === BumpType.BETA;
+
+  // Alpha 发布：不需要提示（会自动触发 CI 发布）
+  if (isAlphaPublish) {
+    return;
+  }
+
+  // Beta 发布：询问用户是否立即执行 git push
+  if (isBetaPublish) {
+    await handleBetaPublish(branchName, cwd);
+    return;
+  }
+
+  // 正式版本发布：提示创建 MR/PR
+  await handleProductionPublish(branchName, cwd);
+};
+
 const pushToRemote = async (options) => {
   const {
     sessionId,
     changedFiles,
     cwd,
-    publishManifests,
     bumpPolicy,
     skipCommit,
     skipPush,
     repoUrl,
+    branchPrefix = 'release',
   } = options;
+
   if (skipCommit) {
     return;
   }
 
-  // 获取仓库 URL
-  const actualRepoUrl = repoUrl;
-
-  let branchName;
-  if (bumpPolicy === BumpType.BETA) {
-    branchName = await getCurrentBranchName();
-  } else {
-    const date = dayjs().format('YYYYMMDD');
-    branchName = `release/${date}-${sessionId}`;
-    await exec(`git checkout -b ${branchName}`, { cwd });
-  }
-  const isTestPublish = [BumpType.ALPHA, BumpType.BETA].includes(
-    bumpPolicy ,
-  );
+  // 1. 获取或创建发布分支
+  const branchName = await getOrCreateBranch({
+    bumpPolicy,
+    sessionId,
+    branchPrefix,
+    cwd,
+  });
 
-  // 4. 创建并推送发布分支
+  // 2. 提交变更
   const { effects } = await commitChanges({
-    sessionId,
     files: changedFiles,
     cwd,
-    publishManifests,
     branchName,
-    // 只有 alpha、beta 需要创建 tag，正式发布会在 .github/workflows/common-pr-checks.yml 创建并发布tag
-    createTags: isTestPublish,
   });
+
   if (skipPush) {
     return;
   }
+
+  // 3. 推送变更
   await push({
     refs: effects,
     cwd,
-    repoUrl: actualRepoUrl,
+    repoUrl,
   });
 
-  // 从 git URL 提取组织和仓库名称，用于构建 GitHub 链接
-  const repoInfoMatch = actualRepoUrl.match(GIT_REPO_URL_REGEX);
-  if (!repoInfoMatch) {
-    throw new Error('Invalid git repository URL');
-  }
-  const repoOwner = repoInfoMatch[1];
-  const repoName = repoInfoMatch[2];
+  // 4. 根据发布类型显示不同提示
+  await handlePostPushPrompts(bumpPolicy, branchName, cwd);
+};
 
-  if (isTestPublish) {
-    logger.success(
-      `Please refer to https://github.com/${repoOwner}/${repoName}/actions/workflows/release.yml for the release progress.`,
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+const getRushConfiguration = (() => {
+  const cachedRushConfigs = new Map();
+  return (startingFolder) => {
+    startingFolder = startingFolder || process.cwd();
+    const possibleRushFile = rushSdk.RushConfiguration.tryFindRushJsonLocation({
+      startingFolder,
+    });
+    if (!possibleRushFile) {
+      throw new Error(
+        `rush.json not found from starting folder: ${startingFolder}`,
+      );
+    }
+    if (cachedRushConfigs.has(possibleRushFile)) {
+      return cachedRushConfigs.get(possibleRushFile) ;
+    }
+
+    const rushConfig =
+      rushSdk.RushConfiguration.loadFromConfigurationFile(possibleRushFile);
+    cachedRushConfigs.set(startingFolder, rushConfig);
+    return rushConfig;
+  };
+})();
+
+const lookupTo = (to) => {
+  const cached = new Map();
+  const config = getRushConfiguration();
+  const core = (pkgName) => {
+    if (cached.has(pkgName)) {
+      return cached.get(pkgName);
+    }
+    const result = [pkgName];
+    cached.set(pkgName, result);
+    const projects = config.projects.filter(p => p.packageName === pkgName);
+    if (projects.length === 0) {
+      throw new Error(`Project ${pkgName} not found`);
+    }
+    const project = projects[0];
+    const deps = Array.from(project.dependencyProjects.values()).map(
+      p => p.packageName,
     );
-  } else {
-    const prUrl = `https://github.com/${repoOwner}/${repoName}/compare/${branchName}?expand=1`;
-    const log = [
-      '************************************************',
-      '*',
-      `* Please create PR: ${prUrl}`,
-      '*',
-      '************************************************',
-    ];
-    logger.success(log.join('\n'), false);
-    const open = await import('open');
-    await open.default(prUrl);
+    result.push(...deps);
+    deps.forEach(dep => {
+      const subPkgs = core(dep);
+      if (subPkgs) {
+        result.push(...subPkgs);
+      }
+    });
+    return result;
+  };
+  const result = core(to);
+  return [...new Set(result)];
+};
+
+const lookupFrom = (from) => {
+  const cached = new Map();
+  const config = getRushConfiguration();
+  const core = (pkgName) => {
+    if (cached.has(pkgName)) {
+      return cached.get(pkgName);
+    }
+    const result = new Set();
+    cached.set(pkgName, result);
+    const projects = config.projects.filter(p => p.packageName === pkgName);
+    if (projects.length === 0) {
+      throw new Error(`Project ${pkgName} not found`);
+    }
+    const project = projects[0];
+    const deps = Array.from([
+      ...project.dependencyProjects.values(),
+      ...project.consumingProjects.values(),
+    ]).map(p => p.packageName);
+    deps.forEach(dep => {
+      result.add(dep);
+      const subPkgs = cached.has(dep) ? cached.get(dep) : core(dep);
+      if (subPkgs) {
+        subPkgs.forEach(p => {
+          result.add(p);
+        });
+      }
+    });
+    return result;
+  };
+  const result = core(from);
+  return [...new Set(result)];
+};
+
+const lookupOnly = (packageName) => {
+  const config = getRushConfiguration();
+  const projects = config.projects.filter(p => p.packageName === packageName);
+  if (projects.length === 0) {
+    throw new Error(`Project ${packageName} not found`);
   }
+  return projects[0];
 };
 
-function _optionalChain$1(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$2(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
 
 
 var RetrievePattern; (function (RetrievePattern) {
@@ -843,10 +1285,9 @@ const retrievePackages = (
   pattern,
   packages,
 ) => {
-  const rushConfiguration = getRushConfiguration();
   const matchedPackages = new Set();
   packages.forEach(pkg => {
-    const project = rushConfiguration.getProjectByName(pkg);
+    const project = lookupOnly(pkg);
     if (!project) {
       throw new Error(`Package "${pkg}" not found in rush configuration`);
     }
@@ -858,16 +1299,15 @@ const retrievePackages = (
     const matched = [];
     switch (pattern) {
       case 'to': {
-        matched.push(project.dependencyProjects);
+        matched.push(...lookupTo(pkg));
         break;
       }
       case 'from': {
-        matched.push(project.consumingProjects);
-        matched.push(project.dependencyProjects);
+        matched.push(...lookupFrom(pkg));
         break;
       }
       case 'only': {
-        // do nothing
+        matched.push(pkg);
         break;
       }
       default: {
@@ -875,50 +1315,81 @@ const retrievePackages = (
       }
     }
 
-    for (const matchedSet of matched) {
-      for (const p of matchedSet) {
-        if (p.shouldPublish) {
-          matchedPackages.add(p);
-        }
-      }
-    }
-    matchedPackages.add(project);
+    matched.forEach(pkgName => {
+      matchedPackages.add(pkgName);
+    });
   });
-  return matchedPackages;
+
+  return [...matchedPackages];
 };
 
 const validateAndGetPackages = (options) => {
   const retrievePatterns = Object.values(RetrievePattern);
-  if (retrievePatterns.every(pattern => (_optionalChain$1([options, 'access', _ => _[pattern], 'optionalAccess', _2 => _2.length]) || 0) <= 0)) {
+  if (retrievePatterns.every(pattern => (_optionalChain$2([options, 'access', _ => _[pattern], 'optionalAccess', _2 => _2.length]) || 0) <= 0)) {
     throw new Error('No packages to publish');
   }
-  return retrievePatterns.reduce((acc, pattern) => {
+  const res = retrievePatterns.reduce((acc, pattern) => {
     const packages = options[pattern];
     if (!packages || packages.length <= 0) {
       return acc;
     }
     const placeholders = retrievePackages(pattern , packages);
-    return new Set([...acc, ...placeholders]);
+    placeholders.forEach(pkgName => {
+      acc.add(pkgName);
+    });
+    return acc;
   }, new Set());
+  const result = [...res]
+    .map(pkgName => {
+      const p = lookupOnly(pkgName);
+      if (p && p.shouldPublish) {
+        return p;
+      }
+      return undefined;
+    })
+    .filter(Boolean) ;
+  return result;
 };
 
+function _optionalChain$1(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }//  Copyright (c) 2025 coze-dev
+
+
+
+
+
+
+
+
 const confirmForPublish = async (
   publishManifest,
   dryRun,
+  options,
 ) => {
-  console.log(chalk.gray('Will publish the following packages:'));
+  logger.info(chalk.gray('Will publish the following packages:'), false);
   publishManifest.forEach(manifest => {
-    const msg = `${manifest.project.packageName}: ${chalk.bgGreen(`${manifest.currentVersion} -> ${chalk.bold(manifest.newVersion)}`)}`;
-    console.log(`- ${msg}`);
+    const versionChange = `${manifest.currentVersion} -> ${chalk.bold(manifest.newVersion)}`;
+    const msg = `${manifest.project.packageName}: ${chalk.bgGreen(versionChange)}`;
+    logger.info(`- ${msg}`, false);
   });
+
+  // Release 模式的额外提示
+  if (_optionalChain$1([options, 'optionalAccess', _ => _.isReleaseMode])) {
+    logger.info('', false);
+    logger.warn(chalk.yellow.bold('⚠️  Release Mode Enabled:'), false);
+    const registryMsg = `   Packages will be published directly to: ${chalk.bold(options.registry || 'default registry')}`;
+    logger.warn(chalk.yellow(registryMsg), false);
+  }
+
   if (dryRun) {
     return false;
   }
 
-  console.log('\n');
+  logger.info('', false);
   try {
     const result = await prompts.confirm({
-      message: 'Are you sure to publish?',
+      message: _optionalChain$1([options, 'optionalAccess', _2 => _2.isReleaseMode])
+        ? 'Are you sure to publish directly?'
+        : 'Are you sure to publish?',
       default: true,
     });
     return result;
@@ -927,7 +1398,8 @@ const confirmForPublish = async (
   }
 };
 
-function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }//  Copyright (c) 2025 coze-dev
+
 
 
 
@@ -1132,6 +1604,11 @@ const generateChangelog$1 = ({
   };
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
 const deleteFiles = async (files) => {
   await Promise.all(
     files.map(async file => {
@@ -1187,7 +1664,7 @@ const readPreviousChangelog = async (
 
 const generateChangelogForProject = async (manifest) => {
   const { project, newVersion } = manifest;
-  const rushConfiguration = getRushConfiguration();
+  const rushConfiguration = getRushConfiguration$1();
   const { changesFolder } = rushConfiguration;
   const changedFolderOfPkg = path.resolve(changesFolder, project.packageName);
   const changelogJsonPath = path.resolve(
@@ -1229,6 +1706,12 @@ const generateChangelog = async (
   return modifiedFiles.flat();
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
+
+
 const updatePackageVersion = async (
   project,
   newVersion,
@@ -1257,6 +1740,10 @@ const applyPublishManifest = async (
   return modifiedFiles;
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 // 针对不同类型的发布，对应不同 sideEffects：
 // 1. alpha: 直接创建并push 分支，触发 CI，执行发布；
 // 2. beta: 本分支直接切换版本号，并发布
@@ -1264,15 +1751,18 @@ const applyPublishManifest = async (
 
 const publish = async (options) => {
   const sessionId = randomHash(6);
-  const rushConfiguration = getRushConfiguration();
+  const rushConfiguration = getRushConfiguration$1();
   const rushFolder = rushConfiguration.rushJsonFolder;
-  if (process.env.SKIP_UNCOMMITTED_CHECK !== 'true') {
+  if (
+    process.env.SKIP_UNCOMMITTED_CHECK !== 'true' &&
+    options.release !== true
+  ) {
     await ensureNotUncommittedChanges();
   }
 
   // 1. 验证并获取需要发布的包列表
   const packagesToPublish = validateAndGetPackages(options);
-  if (packagesToPublish.size === 0) {
+  if (packagesToPublish.length === 0) {
     logger.error(
       'No packages to publish, should specify some package by `--to` or `--from` or `--only`',
     );
@@ -1291,7 +1781,11 @@ const publish = async (options) => {
   const isBetaPublish = [BumpType.BETA, BumpType.ALPHA].includes(
     bumpPolicy ,
   );
-  if (isBetaPublish === false && (await isMainBranch()) === false) {
+  if (
+    process.env.SKIP_BRANCH_CHECK !== 'true' &&
+    isBetaPublish === false &&
+    (await isMainBranch()) === false
+  ) {
     // 只允许在主分支发布
     logger.error(
       'You are not in main branch, please switch to main branch and try again.',
@@ -1302,6 +1796,10 @@ const publish = async (options) => {
   const continuePublish = await confirmForPublish(
     publishManifests,
     !!options.dryRun,
+    {
+      isReleaseMode: !!options.release,
+      registry: options.registry || DEFAULT_NPM_REGISTRY,
+    },
   );
 
   if (!continuePublish) {
@@ -1317,17 +1815,46 @@ const publish = async (options) => {
     await Promise.all(postHandles.map(handle => handle(publishManifests)))
   ).flat();
 
-  // 4. 创建并推送发布分支
-  await pushToRemote({
-    publishManifests,
-    bumpPolicy: bumpPolicy ,
-    sessionId,
-    changedFiles,
-    cwd: rushFolder,
-    skipCommit: !!options.skipCommit,
-    skipPush: !!options.skipPush,
-    repoUrl: options.repoUrl,
-  });
+  // 4. 创建并推送发布分支 或 直接发布
+  let shouldRelease = false;
+  if (options.release) {
+    // 验证 release 模式的前置条件
+    if (isBetaPublish === false) {
+      logger.error(
+        'Direct release (--release) is only allowed for alpha or beta versions.',
+      );
+      logger.error(`Current bump type is: ${bumpPolicy}`);
+      logger.warn('Falling back to normal publish mode...');
+    } else {
+      shouldRelease = true;
+    }
+  }
+
+  if (shouldRelease) {
+    // Release 模式：直接发布
+    logger.info('Running in direct release mode...');
+    logger.info('Starting package release...');
+    const registry = options.registry || DEFAULT_NPM_REGISTRY;
+    // 将 PublishManifest[] 转换为 PackageToPublish[]
+    const packages = publishManifests.map(manifest => ({
+      packageName: manifest.project.packageName,
+      version: manifest.newVersion,
+    }));
+    await release({ dryRun: !!options.dryRun, registry, packages });
+  } else {
+    // 普通模式：创建并推送发布分支
+    await pushToRemote({
+      bumpPolicy: bumpPolicy ,
+      sessionId,
+      changedFiles,
+      cwd: rushFolder,
+      skipCommit: !!options.skipCommit,
+      skipPush: !!options.skipPush,
+      repoUrl: options.repoUrl,
+      branchPrefix: options.branchPrefix,
+    });
+  }
+
   logger.success('Publish success.');
 };
 
@@ -1358,6 +1885,21 @@ const installAction$1 = (program) => {
       'Git repository URL (e.g. git@github.com:coze-dev/coze-js.git)',
       undefined,
     )
+    .option(
+      '--branch-prefix <prefix>',
+      `Git branch name prefix (default: ${DEFAULT_BRANCH_PREFIX})`,
+      DEFAULT_BRANCH_PREFIX,
+    )
+    .option(
+      '-l, --release',
+      'Directly publish packages (only for alpha/beta versions)',
+      false,
+    )
+    .option(
+      '--registry <url>',
+      `NPM registry URL (default: ${DEFAULT_NPM_REGISTRY})`,
+      DEFAULT_NPM_REGISTRY,
+    )
     .action(async (options) => {
       try {
         const repoUrl = options.repoUrl || (await getCurrentOrigin());
@@ -1365,8 +1907,9 @@ const installAction$1 = (program) => {
           throw new Error('Git repository URL is required');
         }
         if (!GIT_REPO_URL_REGEX.test(repoUrl)) {
+          const expectedFormat = 'git@github.com:${org}/${repo}.git';
           throw new Error(
-            `Invalid git repository URL: ${repoUrl}, it should be follow the format: git@github.com:\${org}/\${repo}.git`,
+            `Invalid git repository URL: ${repoUrl}, it should follow the format: ${expectedFormat}`,
           );
         }
         const normalizeOptions = {
@@ -1381,6 +1924,10 @@ const installAction$1 = (program) => {
     });
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const whoAmI = async () => {
   const [name, email] = await Promise.all([
     exec('git config user.name', { cwd: __dirname, silent: true }),
@@ -1392,6 +1939,10 @@ const whoAmI = async () => {
   };
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 // 这两个包没有 module 导出
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const { sync } = require('conventional-commits-parser');
@@ -1408,7 +1959,7 @@ const collectShouldUpdateChangesProjects = async (
 
 ) => {
   const changedFiles = await getChangedFilesFromCached();
-  const rushConfiguration = getRushConfiguration();
+  const rushConfiguration = getRushConfiguration$1();
   const lookup = rushConfiguration.getProjectLookupForRoot(
     rushConfiguration.rushJsonFolder,
   );
@@ -1520,7 +2071,7 @@ async function generateAllChangesFile(
   comment,
   patchType,
 ) {
-  const rushConfiguration = getRushConfiguration();
+  const rushConfiguration = getRushConfiguration$1();
   const needUpdateProjects = await collectShouldUpdateChangesProjects();
   const { email } = await whoAmI();
 
@@ -1544,9 +2095,13 @@ async function generateAllChangesFile(
   }
 }
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const amendCommit = async () => {
   const changedFiles = await getChangedFilesFromCached();
-  const rushConfiguration = getRushConfiguration();
+  const rushConfiguration = getRushConfiguration$1();
 
   const relativeChangesFolder = path.relative(
     rushConfiguration.rushJsonFolder,
@@ -1561,6 +2116,10 @@ const amendCommit = async () => {
   }
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const generateChangeFiles = async (options) => {
   // CI 环境的提交不做处理
   if (options.ci || process.env.CI === 'true') {
@@ -1573,7 +2132,7 @@ const generateChangeFiles = async (options) => {
   try {
     let { commitMsg } = options;
     if (!commitMsg) {
-      const rushConfiguration = getRushConfiguration();
+      const rushConfiguration = getRushConfiguration$1();
       commitMsg = await fs.readFile(
         path.resolve(rushConfiguration.rushJsonFolder, '.git/COMMIT_EDITMSG'),
         'utf-8',
@@ -1606,6 +2165,10 @@ const installAction = (program) => {
     });
 };
 
+//  Copyright (c) 2025 coze-dev
+//  SPDX-License-Identifier: MIT
+
+
 const main = () => {
   const packageJson = JSON.parse(
     fs$1.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8'),