@zjex/git-workflow 0.5.3 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [v0.5.3](https://github.com/iamzjt-front-end/git-workflow/compare/v0.5.2...v0.5.3) (2026-02-06)
+
+- 🔖 chore(release): 发布 v0.5.3 ([a6b327d](https://github.com/iamzjt-front-end/git-workflow/commit/a6b327d))
+- docs(review): Clarify commit range syntax and refactor parsing logic ([63a77d2](https://github.com/iamzjt-front-end/git-workflow/commit/63a77d2))
+- 📝 docs: 自动更新测试数量徽章 [skip ci] ([21e365c](https://github.com/iamzjt-front-end/git-workflow/commit/21e365c))
+- feat(review): Add commit range syntax support and improve update notifier ([93184b0](https://github.com/iamzjt-front-end/git-workflow/commit/93184b0))
+
 ## [v0.5.2](https://github.com/iamzjt-front-end/git-workflow/compare/v0.5.1...v0.5.2) (2026-02-06)
 
 - 🔖 chore(release): 发布 v0.5.2 ([d2b659c](https://github.com/iamzjt-front-end/git-workflow/commit/d2b659c))

package/README.md

@@ -12,7 +12,7 @@
   <a href="https://github.com/iamzjt-front-end/git-workflow"><img src="https://img.shields.io/github/stars/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=F59E0B" alt="github stars"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@zjex/git-workflow?style=flat&colorA=18181B&colorB=10B981" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat&logo=node.js&logoColor=white&colorA=18181B" alt="node version"></a>
-  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-570%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
+  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-579%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/issues"><img src="https://img.shields.io/github/issues/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=EC4899" alt="issues"></a>
 </p>
 

package/dist/index.js

@@ -421,6 +421,7 @@ var defaultConfig = {
   requireId: false,
   featureIdLabel: "Story ID",
   hotfixIdLabel: "Issue ID",
+  tagLookupStrategy: "latest",
   autoStage: true,
   useEmoji: true
 };
@@ -747,13 +748,38 @@ async function deleteBranch(branchArg) {
 init_utils();
 import { select as select2, input as input2 } from "@inquirer/prompts";
 import ora2 from "ora";
+
+// src/tag-utils.ts
+function isValidVersionTag(tag) {
+  return /\d/.test(tag);
+}
+function extractTagPrefix(tag) {
+  return tag.replace(/\d.*/, "");
+}
+function normalizeTagLookupStrategy(value) {
+  return value === "all" ? "all" : "latest";
+}
+function getLatestTagCommand(prefix, strategy) {
+  if (strategy === "latest") {
+    return `git for-each-ref --sort=-creatordate --format="%(refname:short)" "refs/tags/${prefix}*"`;
+  }
+  return `git tag -l "${prefix}*" --sort=-v:refname`;
+}
+function shouldFetchAllTagsForCreateTag(strategy, prefix) {
+  if (strategy === "all") {
+    return true;
+  }
+  return !prefix;
+}
+
+// src/commands/tag.ts
 async function listTags(prefix) {
   const spinner = ora2("\u6B63\u5728\u83B7\u53D6 tags...").start();
   exec("git fetch --tags", true);
   spinner.stop();
   const pattern = prefix ? `${prefix}*` : "";
   const allTags = execOutput(`git tag -l ${pattern} --sort=v:refname`).split("\n").filter(Boolean);
-  const tags = allTags.filter((tag) => /\d/.test(tag));
+  const tags = allTags.filter(isValidVersionTag);
   if (tags.length === 0) {
     console.log(
       colors.yellow(prefix ? `\u6CA1\u6709 '${prefix}' \u5F00\u5934\u7684 tag` : "\u6CA1\u6709 tag")
@@ -773,7 +799,7 @@ async function listTags(prefix) {
   }
   const grouped = /* @__PURE__ */ new Map();
   tags.forEach((tag) => {
-    const prefix2 = tag.replace(/\d.*/, "") || "(\u65E0\u524D\u7F00)";
+    const prefix2 = extractTagPrefix(tag) || "(\u65E0\u524D\u7F00)";
     if (!grouped.has(prefix2)) {
       grouped.set(prefix2, []);
     }
@@ -827,23 +853,28 @@ async function listTags(prefix) {
     console.log("  " + row);
   }
 }
-function getLatestTag(prefix) {
-  const tags = execOutput(`git tag -l "${prefix}*" --sort=-v:refname`).split("\n").filter((tag) => tag && /\d/.test(tag));
+function getLatestTag(prefix, strategy = "latest") {
+  const tags = execOutput(getLatestTagCommand(prefix, strategy)).split("\n").filter((tag) => tag && isValidVersionTag(tag));
   return tags[0] || "";
 }
 async function createTag(inputPrefix) {
   const config2 = getConfig();
-  const fetchSpinner = ora2("\u6B63\u5728\u83B7\u53D6 tags...").start();
-  exec("git fetch --tags", true);
-  fetchSpinner.stop();
+  const tagLookupStrategy = normalizeTagLookupStrategy(
+    config2.tagLookupStrategy
+  );
   divider();
   let prefix = inputPrefix;
   if (!prefix && config2.defaultTagPrefix) {
     prefix = config2.defaultTagPrefix;
     console.log(colors.dim(`(\u4F7F\u7528\u914D\u7F6E\u7684\u9ED8\u8BA4\u524D\u7F00: ${prefix})`));
   }
+  if (shouldFetchAllTagsForCreateTag(tagLookupStrategy, prefix)) {
+    const fetchSpinner = ora2("\u6B63\u5728\u83B7\u53D6 tags...").start();
+    exec("git fetch --tags", true);
+    fetchSpinner.stop();
+  }
   if (!prefix) {
-    const allTags = execOutput("git tag -l").split("\n").filter((tag) => tag && /\d/.test(tag));
+    const allTags = execOutput("git tag -l").split("\n").filter((tag) => tag && isValidVersionTag(tag));
     if (allTags.length === 0) {
       prefix = await input2({
         message: "\u5F53\u524D\u4ED3\u5E93\u6CA1\u6709 tag\uFF0C\u8BF7\u8F93\u5165\u524D\u7F00 (\u5982 v):",
@@ -889,9 +920,7 @@ async function createTag(inputPrefix) {
       }
       return;
     }
-    const prefixes = [
-      ...new Set(allTags.map((t) => t.replace(/\d.*/, "")).filter(Boolean))
-    ];
+    const prefixes = [...new Set(allTags.map(extractTagPrefix).filter(Boolean))];
     if (prefixes.length === 0) {
       prefix = await input2({
         message: "\u8BF7\u8F93\u5165 tag \u524D\u7F00 (\u5982 v):",
@@ -904,7 +933,7 @@ async function createTag(inputPrefix) {
       }
     } else {
       const prefixWithDate = prefixes.map((p) => {
-        const latest = getLatestTag(p);
+        const latest = getLatestTag(p, tagLookupStrategy);
         const date = latest ? execOutput(`git log -1 --format=%ct "${latest}" 2>/dev/null`) : "0";
         return { prefix: p, latest, date: parseInt(date) || 0 };
       });
@@ -929,7 +958,13 @@ async function createTag(inputPrefix) {
       }
     }
   }
-  const latestTag = getLatestTag(prefix);
+  let latestTag = getLatestTag(prefix, tagLookupStrategy);
+  if (!latestTag && tagLookupStrategy === "latest") {
+    const fetchSpinner = ora2("\u672C\u5730\u672A\u627E\u5230\u5BF9\u5E94 tag\uFF0C\u6B63\u5728\u5168\u91CF\u540C\u6B65\u4E00\u6B21...").start();
+    exec("git fetch --tags", true);
+    fetchSpinner.stop();
+    latestTag = getLatestTag(prefix, tagLookupStrategy);
+  }
   if (!latestTag) {
     const newTag = `${prefix}1.0.0`;
     console.log(
@@ -948,7 +983,8 @@ async function createTag(inputPrefix) {
     }
     return;
   }
-  console.log(colors.yellow(`\u5F53\u524D\u6700\u65B0 tag: ${latestTag}`));
+  const strategyText = tagLookupStrategy === "latest" ? "\u6700\u65B0\u521B\u5EFA" : "\u7248\u672C\u6392\u5E8F";
+  console.log(colors.yellow(`\u5F53\u524D\u57FA\u51C6 tag (${strategyText}): ${latestTag}`));
   divider();
   const version2 = latestTag.slice(prefix.length);
   const preReleaseMatch = version2.match(
@@ -1588,6 +1624,23 @@ async function init() {
     theme
   });
   if (defaultTagPrefix) config2.defaultTagPrefix = defaultTagPrefix;
+  const tagLookupStrategy = await select4({
+    message: "Tag \u9012\u589E\u57FA\u51C6\u7B56\u7565:",
+    choices: [
+      {
+        name: "\u4EC5\u57FA\u4E8E\u6700\u65B0\u521B\u5EFA\u7684 Tag\uFF08\u9ED8\u8BA4\uFF09",
+        value: "latest",
+        description: "\u907F\u514D\u5386\u53F2\u8BEF\u6253\u7684\u9AD8\u7248\u672C tag \u5E72\u6270\u540E\u7EED\u9012\u589E"
+      },
+      {
+        name: "\u5168\u91CF\u6392\u5E8F",
+        value: "all",
+        description: "\u5168\u91CF\u62C9\u53D6 tags\uFF0C\u5E76\u6309\u7248\u672C\u53F7\u6392\u5E8F\u540E\u53D6\u6700\u65B0\u503C"
+      }
+    ],
+    theme
+  });
+  config2.tagLookupStrategy = tagLookupStrategy;
   const autoPushChoice = await select4({
     message: "\u521B\u5EFA\u5206\u652F\u540E\u662F\u5426\u81EA\u52A8\u63A8\u9001?",
     choices: [
@@ -4232,7 +4285,7 @@ process.on("SIGTERM", () => {
   console.log("");
   process.exit(0);
 });
-var version = true ? "0.5.3" : "0.0.0-dev";
+var version = true ? "0.6.0" : "0.0.0-dev";
 async function mainMenu() {
   console.log(
     colors.green(`

package/docs/commands/config.md

@@ -89,6 +89,9 @@ $ gw init
 
 ```bash
 ? 默认 Tag 前缀 (留空则每次选择): v
+? Tag 递增基准策略:
+❯ 仅基于最新创建的 Tag（默认）
+  全量排序
 ```
 
 ### 推送配置
@@ -343,4 +346,4 @@ vim .gwrc.json
 
 1. **定期更新** - 根据需求更新配置
 2. **备份配置** - 备份重要的配置文件
-3. **版本控制** - 跟踪配置文件的变更历史
+3. **版本控制** - 跟踪配置文件的变更历史

package/docs/config/config-file.md

@@ -42,6 +42,7 @@ gw.config.json      # 明确的配置文件名
   "featureIdLabel": "Story ID",
   "hotfixIdLabel": "Issue ID",
   "defaultTagPrefix": "v",
+  "tagLookupStrategy": "latest",
   "autoPush": true,
   "autoStage": true,
   "useEmoji": true
@@ -59,6 +60,7 @@ gw.config.json      # 明确的配置文件名
   "featureIdLabel": "Story ID",
   "hotfixIdLabel": "Issue ID",
   "defaultTagPrefix": "v",
+  "tagLookupStrategy": "latest",
   "autoPush": true,
   "autoStage": true,
   "useEmoji": true,
@@ -232,6 +234,22 @@ gw.config.json      # 明确的配置文件名
 - 创建 tag 时直接使用 `v` 前缀
 - 跳过前缀选择界面
 
+#### tagLookupStrategy
+
+**类型：** `"all" | "latest"`  
+**默认值：** `"latest"`  
+**说明：** 创建 tag 时如何确定递增基准
+
+```json
+{
+  "tagLookupStrategy": "latest"
+}
+```
+
+**选项说明：**
+- `"latest"` - 默认行为。优先基于本地最新创建的 tag 递增，避免历史误打的高版本 tag 干扰排序；如果当前前缀在本地不存在，会自动回退到一次全量同步
+- `"all"` - 全量拉取 tags，并按版本号排序后取最新值
+
 ### 提交配置
 
 #### autoStage
@@ -773,4 +791,4 @@ cp ../other-project/.gwrc.json .
 
 ---
 
-通过合理配置，Git Workflow 可以完美适应你的工作流程。配置文件是工具的核心，掌握配置文件的使用是高效使用 Git Workflow 的关键。
+通过合理配置，Git Workflow 可以完美适应你的工作流程。配置文件是工具的核心，掌握配置文件的使用是高效使用 Git Workflow 的关键。

package/docs/config/index.md

@@ -144,6 +144,7 @@ gw init
   "featureIdLabel": "Jira ID",
   "hotfixIdLabel": "Bug ID",
   "defaultTagPrefix": "v",
+  "tagLookupStrategy": "latest",
   "autoPush": true,
   "autoStage": true,
   "useEmoji": true,
@@ -186,6 +187,7 @@ gw init
 | 配置项             | 类型     | 默认值 | 说明                              |
 | ------------------ | -------- | ------ | --------------------------------- |
 | `defaultTagPrefix` | `string` | -      | 默认 tag 前缀，设置后跳过选择步骤 |
+| `tagLookupStrategy` | `"all" \| "latest"` | `"latest"` | tag 递增基准策略：`latest` 优先基于最新创建的 tag，`all` 按版本全量排序 |
 
 ### 提交配置
 
@@ -475,4 +477,4 @@ cp project-a/.gwrc.json project-b/.gwrc.json
 
 ---
 
-通过合理的配置，Git Workflow 可以完美适应你的工作流程。从简单的个人项目到复杂的企业级应用，都能找到合适的配置方案。
+通过合理的配置，Git Workflow 可以完美适应你的工作流程。从简单的个人项目到复杂的企业级应用，都能找到合适的配置方案。

package/docs/guide/tag-management.md

@@ -436,6 +436,19 @@ jobs:
 
 设置后，创建标签时会跳过前缀选择步骤。
 
+### Tag 基准策略
+
+```json
+{
+  "defaultTagPrefix": "v",
+  "tagLookupStrategy": "latest"
+}
+```
+
+`tagLookupStrategy` 支持两种模式：
+- `all`：全量拉取并按版本号排序，兼容当前默认行为
+- `latest`：优先基于最新创建的 tag 递增，适合历史上出现过误打高版本 tag 的仓库；如果本地没有该前缀的 tag，会自动回退一次全量同步
+
 ### 版本格式配置
 
 ```json
@@ -611,4 +624,4 @@ jobs:
 
 ---
 
-通过系统化的 Tag 管理，你可以建立清晰的版本发布流程。Git Workflow 的智能版本递增和前缀检测功能，让版本管理变得简单而规范。
+通过系统化的 Tag 管理，你可以建立清晰的版本发布流程。Git Workflow 的智能版本递增和前缀检测功能，让版本管理变得简单而规范。

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.5.3",
+	"version": "0.6.0",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {
@@ -40,7 +40,7 @@
 	"author": "zjex",
 	"license": "MIT",
 	"engines": {
-		"node": ">=18.0.0",
+		"node": ">=21.3.0",
 		"npm": ">=9.0.0"
 	},
 	"repository": {

package/src/commands/init.ts

@@ -148,6 +148,24 @@ export async function init(): Promise<void> {
   });
   if (defaultTagPrefix) config.defaultTagPrefix = defaultTagPrefix;
 
+  const tagLookupStrategy = await select({
+    message: "Tag 递增基准策略:",
+    choices: [
+      {
+        name: "仅基于最新创建的 Tag（默认）",
+        value: "latest",
+        description: "避免历史误打的高版本 tag 干扰后续递增",
+      },
+      {
+        name: "全量排序",
+        value: "all",
+        description: "全量拉取 tags，并按版本号排序后取最新值",
+      },
+    ],
+    theme,
+  });
+  config.tagLookupStrategy = tagLookupStrategy as "all" | "latest";
+
   // 自动推送
   const autoPushChoice = await select({
     message: "创建分支后是否自动推送?",

package/src/commands/tag.ts

@@ -10,6 +10,14 @@ import {
   divider,
 } from "../utils.js";
 import { getConfig } from "../config.js";
+import {
+  extractTagPrefix,
+  getLatestTagCommand,
+  isValidVersionTag,
+  normalizeTagLookupStrategy,
+  shouldFetchAllTagsForCreateTag,
+  type TagLookupStrategy,
+} from "../tag-utils.js";
 
 /**
  * 列出 tags（最新的显示在最下面，多个前缀分列展示）
@@ -29,7 +37,7 @@ export async function listTags(prefix?: string): Promise<void> {
 
   // 3. 过滤无效 tag（如 vnull、vundefined 等误操作产生的 tag）
   // 有效 tag 必须包含数字（版本号）
-  const tags = allTags.filter((tag) => /\d/.test(tag));
+  const tags = allTags.filter(isValidVersionTag);
 
   // 4. 如果没有 tags，提示并返回
   if (tags.length === 0) {
@@ -57,7 +65,7 @@ export async function listTags(prefix?: string): Promise<void> {
   const grouped = new Map<string, string[]>();
   tags.forEach((tag) => {
     // 提取数字之前的字母部分作为前缀（如 "v0.1.0" -> "v"）
-    const prefix = tag.replace(/\d.*/, "") || "(无前缀)";
+    const prefix = extractTagPrefix(tag) || "(无前缀)";
     if (!grouped.has(prefix)) {
       grouped.set(prefix, []);
     }
@@ -147,18 +155,21 @@ interface TagChoice {
 }
 
 // 获取指定前缀的最新有效 tag（必须包含数字）
-function getLatestTag(prefix: string): string {
-  const tags = execOutput(`git tag -l "${prefix}*" --sort=-v:refname`)
+function getLatestTag(
+  prefix: string,
+  strategy: TagLookupStrategy = "latest",
+): string {
+  const tags = execOutput(getLatestTagCommand(prefix, strategy))
     .split("\n")
-    .filter((tag) => tag && /\d/.test(tag)); // 过滤无效 tag
+    .filter((tag) => tag && isValidVersionTag(tag)); // 过滤无效 tag
   return tags[0] || "";
 }
 
 export async function createTag(inputPrefix?: string): Promise<void> {
   const config = getConfig();
-  const fetchSpinner = ora("正在获取 tags...").start();
-  exec("git fetch --tags", true);
-  fetchSpinner.stop();
+  const tagLookupStrategy = normalizeTagLookupStrategy(
+    config.tagLookupStrategy,
+  );
 
   divider();
 
@@ -170,11 +181,17 @@ export async function createTag(inputPrefix?: string): Promise<void> {
     console.log(colors.dim(`(使用配置的默认前缀: ${prefix})`));
   }
 
+  if (shouldFetchAllTagsForCreateTag(tagLookupStrategy, prefix)) {
+    const fetchSpinner = ora("正在获取 tags...").start();
+    exec("git fetch --tags", true);
+    fetchSpinner.stop();
+  }
+
   if (!prefix) {
     // 过滤无效 tag（如 vnull、vundefined 等误操作产生的 tag）
     const allTags = execOutput("git tag -l")
       .split("\n")
-      .filter((tag) => tag && /\d/.test(tag));
+      .filter((tag) => tag && isValidVersionTag(tag));
 
     // 仓库没有任何 tag 的情况
     if (allTags.length === 0) {
@@ -228,9 +245,7 @@ export async function createTag(inputPrefix?: string): Promise<void> {
     }
 
     // 从现有 tag 中提取前缀（数字之前的字母部分）
-    const prefixes = [
-      ...new Set(allTags.map((t) => t.replace(/\d.*/, "")).filter(Boolean)),
-    ];
+    const prefixes = [...new Set(allTags.map(extractTagPrefix).filter(Boolean))];
 
     if (prefixes.length === 0) {
       // 有 tag 但无法提取前缀（比如纯数字 tag）
@@ -245,7 +260,7 @@ export async function createTag(inputPrefix?: string): Promise<void> {
       }
     } else {
       const prefixWithDate: PrefixInfo[] = prefixes.map((p) => {
-        const latest = getLatestTag(p);
+        const latest = getLatestTag(p, tagLookupStrategy);
         const date = latest
           ? execOutput(`git log -1 --format=%ct "${latest}" 2>/dev/null`)
           : "0";
@@ -276,7 +291,14 @@ export async function createTag(inputPrefix?: string): Promise<void> {
     }
   }
 
-  const latestTag = getLatestTag(prefix);
+  let latestTag = getLatestTag(prefix, tagLookupStrategy);
+
+  if (!latestTag && tagLookupStrategy === "latest") {
+    const fetchSpinner = ora("本地未找到对应 tag，正在全量同步一次...").start();
+    exec("git fetch --tags", true);
+    fetchSpinner.stop();
+    latestTag = getLatestTag(prefix, tagLookupStrategy);
+  }
 
   if (!latestTag) {
     const newTag = `${prefix}1.0.0`;
@@ -297,7 +319,9 @@ export async function createTag(inputPrefix?: string): Promise<void> {
     return;
   }
 
-  console.log(colors.yellow(`当前最新 tag: ${latestTag}`));
+  const strategyText =
+    tagLookupStrategy === "latest" ? "最新创建" : "版本排序";
+  console.log(colors.yellow(`当前基准 tag (${strategyText}): ${latestTag}`));
 
   divider();
 

package/src/config.ts

@@ -21,6 +21,8 @@ export interface GwConfig {
   hotfixIdLabel: string;
   // 默认 tag 前缀
   defaultTagPrefix?: string;
+  // tag 递增基准策略，all=全量按版本排序，latest=按最新创建的 tag 递增
+  tagLookupStrategy?: "all" | "latest";
   // 创建分支后是否自动推送，默认询问
   autoPush?: boolean;
   // commit 时是否自动暂存所有更改，默认 true
@@ -60,6 +62,7 @@ const defaultConfig: GwConfig = {
   requireId: false,
   featureIdLabel: "Story ID",
   hotfixIdLabel: "Issue ID",
+  tagLookupStrategy: "latest",
   autoStage: true,
   useEmoji: true,
 };

package/src/tag-utils.ts

@@ -0,0 +1,37 @@
+export type TagLookupStrategy = "all" | "latest";
+
+export function isValidVersionTag(tag: string): boolean {
+  return /\d/.test(tag);
+}
+
+export function extractTagPrefix(tag: string): string {
+  return tag.replace(/\d.*/, "");
+}
+
+export function normalizeTagLookupStrategy(
+  value?: string,
+): TagLookupStrategy {
+  return value === "all" ? "all" : "latest";
+}
+
+export function getLatestTagCommand(
+  prefix: string,
+  strategy: TagLookupStrategy,
+): string {
+  if (strategy === "latest") {
+    return `git for-each-ref --sort=-creatordate --format="%(refname:short)" "refs/tags/${prefix}*"`;
+  }
+
+  return `git tag -l "${prefix}*" --sort=-v:refname`;
+}
+
+export function shouldFetchAllTagsForCreateTag(
+  strategy: TagLookupStrategy,
+  prefix?: string,
+): boolean {
+  if (strategy === "all") {
+    return true;
+  }
+
+  return !prefix;
+}

package/tests/config.test.ts

@@ -35,6 +35,7 @@ describe("Config 模块测试", () => {
         hotfixIdLabel: "Issue ID",
         autoStage: true,
         useEmoji: true,
+        tagLookupStrategy: "latest",
       });
     });
   });
@@ -92,6 +93,23 @@ describe("Config 模块测试", () => {
 
       expect(config.autoPush).toBe(true);
     });
+
+    it("应该加载 tagLookupStrategy 配置", () => {
+      const mockConfig = {
+        tagLookupStrategy: "latest" as const,
+      };
+
+      vi.mocked(existsSync).mockImplementation((path) => {
+        return path === ".gwrc.json";
+      });
+
+      vi.mocked(readFileSync).mockReturnValue(JSON.stringify(mockConfig));
+      vi.mocked(execOutput).mockReturnValue("");
+
+      const config = loadConfig();
+
+      expect(config.tagLookupStrategy).toBe("latest");
+    });
   });
 
   describe("全局配置", () => {

package/tests/init.test.ts

@@ -40,6 +40,74 @@ describe("Init 模块测试", () => {
   const mockJoin = vi.mocked(join);
   const mockHomedir = vi.mocked(homedir);
 
+  async function mockBasicInitFlow(options?: {
+    scope?: "global" | "project";
+    exists?: boolean;
+    overwrite?: boolean;
+    requireId?: boolean;
+    featureRequireDescription?: boolean;
+    hotfixRequireDescription?: boolean;
+    tagLookupStrategy?: "all" | "latest";
+    autoPushChoice?: "ask" | "yes" | "no";
+    autoStage?: boolean;
+    useEmoji?: boolean;
+    enableAI?: boolean;
+    inputs?: {
+      baseBranch?: string;
+      featurePrefix?: string;
+      hotfixPrefix?: string;
+      featureIdLabel?: string;
+      hotfixIdLabel?: string;
+      defaultTagPrefix?: string;
+    };
+  }) {
+    const {
+      scope = "project",
+      exists = false,
+      overwrite,
+      requireId = false,
+      featureRequireDescription = false,
+      hotfixRequireDescription = false,
+      tagLookupStrategy = "latest",
+      autoPushChoice = "ask",
+      autoStage = true,
+      useEmoji = true,
+      enableAI = false,
+      inputs = {},
+    } = options ?? {};
+
+    mockExistsSync.mockReturnValue(exists);
+
+    const { select, input } = await import("@inquirer/prompts");
+    const selectMock = vi.mocked(select);
+    const inputMock = vi.mocked(input);
+
+    selectMock.mockResolvedValueOnce(scope);
+    if (exists) {
+      selectMock.mockResolvedValueOnce(overwrite ?? true);
+    }
+
+    selectMock
+      .mockResolvedValueOnce(requireId)
+      .mockResolvedValueOnce(featureRequireDescription)
+      .mockResolvedValueOnce(hotfixRequireDescription)
+      .mockResolvedValueOnce(tagLookupStrategy)
+      .mockResolvedValueOnce(autoPushChoice)
+      .mockResolvedValueOnce(autoStage)
+      .mockResolvedValueOnce(useEmoji)
+      .mockResolvedValueOnce(enableAI);
+
+    inputMock
+      .mockResolvedValueOnce(inputs.baseBranch ?? "")
+      .mockResolvedValueOnce(inputs.featurePrefix ?? "feature")
+      .mockResolvedValueOnce(inputs.hotfixPrefix ?? "hotfix")
+      .mockResolvedValueOnce(inputs.featureIdLabel ?? "Story ID")
+      .mockResolvedValueOnce(inputs.hotfixIdLabel ?? "Issue ID")
+      .mockResolvedValueOnce(inputs.defaultTagPrefix ?? "");
+
+    return { select: selectMock, input: inputMock };
+  }
+
   beforeEach(() => {
     vi.clearAllMocks();
     vi.spyOn(console, "log").mockImplementation(() => {});
@@ -53,24 +121,7 @@ describe("Init 模块测试", () => {
 
   describe("配置范围选择", () => {
     it("应该支持全局配置", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("global")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ scope: "global" });
       const { init } = await import("../src/commands/init.js");
       await init();
       expect(mockJoin).toHaveBeenCalledWith("/home/user", ".gwrc.json");
@@ -81,24 +132,7 @@ describe("Init 模块测试", () => {
     });
 
     it("应该支持项目配置", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ scope: "project" });
       const { init } = await import("../src/commands/init.js");
       await init();
       expect(mockWriteFileSync).toHaveBeenCalledWith(
@@ -110,25 +144,7 @@ describe("Init 模块测试", () => {
 
   describe("配置文件覆盖", () => {
     it("应该处理配置文件已存在的情况", async () => {
-      mockExistsSync.mockReturnValue(true);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("global")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ scope: "global", exists: true, overwrite: true });
       const { init } = await import("../src/commands/init.js");
       await init();
       expect(mockWriteFileSync).toHaveBeenCalled();
@@ -149,24 +165,16 @@ describe("Init 模块测试", () => {
 
   describe("基础配置", () => {
     it("应该正确配置分支前缀", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("develop")
-        .mockResolvedValueOnce("feat")
-        .mockResolvedValueOnce("fix")
-        .mockResolvedValueOnce("Jira ID")
-        .mockResolvedValueOnce("Bug ID")
-        .mockResolvedValueOnce("v");
+      await mockBasicInitFlow({
+        inputs: {
+          baseBranch: "develop",
+          featurePrefix: "feat",
+          hotfixPrefix: "fix",
+          featureIdLabel: "Jira ID",
+          hotfixIdLabel: "Bug ID",
+          defaultTagPrefix: "v",
+        },
+      });
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -177,27 +185,11 @@ describe("Init 模块测试", () => {
       expect(config.featureIdLabel).toBe("Jira ID");
       expect(config.hotfixIdLabel).toBe("Bug ID");
       expect(config.defaultTagPrefix).toBe("v");
+      expect(config.tagLookupStrategy).toBe("latest");
     });
 
     it("应该正确配置 ID 要求", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ requireId: true });
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -206,57 +198,33 @@ describe("Init 模块测试", () => {
     });
 
     it("应该正确配置自动推送选项", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("yes")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ autoPushChoice: "yes" });
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
       const config = JSON.parse(writtenConfig);
       expect(config.autoPush).toBe(true);
     });
+
+    it("应该支持配置 tagLookupStrategy 为 latest", async () => {
+      await mockBasicInitFlow({ tagLookupStrategy: "latest" });
+      const { init } = await import("../src/commands/init.js");
+      await init();
+      const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
+      const config = JSON.parse(writtenConfig);
+      expect(config.tagLookupStrategy).toBe("latest");
+    });
   });
 
   describe("AI 配置", () => {
     it("应该正确配置 GitHub Models", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
+      const { select, input } = await mockBasicInitFlow({ enableAI: true });
+      select
         .mockResolvedValueOnce("github")
         .mockResolvedValueOnce("zh-CN")
         .mockResolvedValueOnce(true)
         .mockResolvedValueOnce(true);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("ghp_test_token");
+      input.mockResolvedValueOnce("ghp_test_token");
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -269,29 +237,13 @@ describe("Init 模块测试", () => {
     });
 
     it("应该正确配置 OpenAI", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
+      const { select, input } = await mockBasicInitFlow({ enableAI: true });
+      select
         .mockResolvedValueOnce("openai")
         .mockResolvedValueOnce("en-US")
         .mockResolvedValueOnce(true)
         .mockResolvedValueOnce(true);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("sk-test-key");
+      input.mockResolvedValueOnce("sk-test-key");
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -304,28 +256,12 @@ describe("Init 模块测试", () => {
     });
 
     it("应该正确配置 Ollama", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
+      const { select } = await mockBasicInitFlow({ enableAI: true });
+      select
         .mockResolvedValueOnce("ollama")
         .mockResolvedValueOnce("zh-CN")
         .mockResolvedValueOnce(true)
         .mockResolvedValueOnce(true);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -338,24 +274,7 @@ describe("Init 模块测试", () => {
     });
 
     it("应该正确配置禁用 AI", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ enableAI: false });
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -366,29 +285,13 @@ describe("Init 模块测试", () => {
 
   describe("配置验证", () => {
     it("应该验证 GitHub Token 不为空", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
+      const { select, input } = await mockBasicInitFlow({ enableAI: true });
+      select
         .mockResolvedValueOnce("github")
         .mockResolvedValueOnce("zh-CN")
         .mockResolvedValueOnce(true)
         .mockResolvedValueOnce(true);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("ghp_valid_token");
+      input.mockResolvedValueOnce("ghp_valid_token");
       const { init } = await import("../src/commands/init.js");
       await init();
       const inputCalls = vi.mocked(input).mock.calls;
@@ -403,29 +306,13 @@ describe("Init 模块测试", () => {
     });
 
     it("应该验证 OpenAI API Key 不为空", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
+      const { select, input } = await mockBasicInitFlow({ enableAI: true });
+      select
         .mockResolvedValueOnce("openai")
         .mockResolvedValueOnce("en-US")
         .mockResolvedValueOnce(true)
         .mockResolvedValueOnce(true);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("sk-valid-key");
+      input.mockResolvedValueOnce("sk-valid-key");
       const { init } = await import("../src/commands/init.js");
       await init();
       const inputCalls = vi.mocked(input).mock.calls;
@@ -442,24 +329,7 @@ describe("Init 模块测试", () => {
 
   describe("配置输出", () => {
     it("应该包含默认的 commit emojis", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("project")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow();
       const { init } = await import("../src/commands/init.js");
       await init();
       const writtenConfig = mockWriteFileSync.mock.calls[0][1] as string;
@@ -471,24 +341,7 @@ describe("Init 模块测试", () => {
     });
 
     it("应该显示成功消息", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("global")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ scope: "global" });
       const { init } = await import("../src/commands/init.js");
       await init();
       expect(console.log).toHaveBeenCalledWith(
@@ -497,24 +350,7 @@ describe("Init 模块测试", () => {
     });
 
     it("应该显示全局配置的提示信息", async () => {
-      mockExistsSync.mockReturnValue(false);
-      const { select, input } = await import("@inquirer/prompts");
-      vi.mocked(select)
-        .mockResolvedValueOnce("global")
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce(false)
-        .mockResolvedValueOnce("ask")
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(true)
-        .mockResolvedValueOnce(false);
-      vi.mocked(input)
-        .mockResolvedValueOnce("")
-        .mockResolvedValueOnce("feature")
-        .mockResolvedValueOnce("hotfix")
-        .mockResolvedValueOnce("Story ID")
-        .mockResolvedValueOnce("Issue ID")
-        .mockResolvedValueOnce("");
+      await mockBasicInitFlow({ scope: "global" });
       const { init } = await import("../src/commands/init.js");
       await init();
       expect(console.log).toHaveBeenCalledWith(

package/tests/tag.test.ts

@@ -1,46 +1,89 @@
 import { describe, it, expect } from "vitest";
+import {
+  extractTagPrefix,
+  getLatestTagCommand,
+  isValidVersionTag,
+  normalizeTagLookupStrategy,
+  shouldFetchAllTagsForCreateTag,
+} from "../src/tag-utils";
 
 describe("Tag 功能测试", () => {
+  describe("Tag 策略", () => {
+    it("默认应该使用 latest 策略", () => {
+      expect(normalizeTagLookupStrategy(undefined)).toBe("latest");
+      expect(normalizeTagLookupStrategy("unknown")).toBe("latest");
+    });
+
+    it("应该识别 latest 策略", () => {
+      expect(normalizeTagLookupStrategy("latest")).toBe("latest");
+    });
+
+    it("all 策略应该始终全量拉取 tags", () => {
+      expect(shouldFetchAllTagsForCreateTag("all", "v")).toBe(true);
+      expect(shouldFetchAllTagsForCreateTag("all")).toBe(true);
+    });
+
+    it("latest 策略在已知前缀时不应该全量拉取 tags", () => {
+      expect(shouldFetchAllTagsForCreateTag("latest", "v")).toBe(false);
+    });
+
+    it("latest 策略在未知前缀时应该回退为全量拉取", () => {
+      expect(shouldFetchAllTagsForCreateTag("latest")).toBe(true);
+    });
+
+    it("应该生成全量排序的最新 tag 查询命令", () => {
+      expect(getLatestTagCommand("v", "all")).toBe(
+        'git tag -l "v*" --sort=-v:refname',
+      );
+    });
+
+    it("应该生成按时间获取最新 tag 的查询命令", () => {
+      expect(getLatestTagCommand("v", "latest")).toBe(
+        'git for-each-ref --sort=-creatordate --format="%(refname:short)" "refs/tags/v*"',
+      );
+    });
+  });
+
   describe("前缀提取", () => {
     it("应该正确提取 v 前缀", () => {
       const tag = "v0.1.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("v");
     });
 
     it("应该正确提取 release- 前缀", () => {
       const tag = "release-1.0.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("release-");
     });
 
     it("应该正确提取 @ 开头的 scope 前缀", () => {
       const tag = "@scope/package@1.0.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("@scope/package@");
     });
 
     it("应该正确处理无前缀 tag", () => {
       const tag = "1.0.0";
-      const prefix = tag.replace(/[0-9].*/, "") || "(无前缀)";
+      const prefix = extractTagPrefix(tag) || "(无前缀)";
       expect(prefix).toBe("(无前缀)");
     });
 
     it("应该正确提取 g 前缀", () => {
       const tag = "g0.1.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("g");
     });
 
     it("应该正确提取带下划线的前缀", () => {
       const tag = "version_1.0.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("version_");
     });
 
     it("应该正确提取带点的前缀", () => {
       const tag = "v.1.0.0";
-      const prefix = tag.replace(/[0-9].*/, "");
+      const prefix = extractTagPrefix(tag);
       expect(prefix).toBe("v.");
     });
   });
@@ -51,7 +94,7 @@ describe("Tag 功能测试", () => {
       const grouped = new Map<string, string[]>();
 
       tags.forEach((tag) => {
-        const prefix = tag.replace(/[0-9].*/, "") || "(无前缀)";
+        const prefix = extractTagPrefix(tag) || "(无前缀)";
         if (!grouped.has(prefix)) {
           grouped.set(prefix, []);
         }
@@ -75,7 +118,7 @@ describe("Tag 功能测试", () => {
       const grouped = new Map<string, string[]>();
 
       tags.forEach((tag) => {
-        const prefix = tag.replace(/[0-9].*/, "") || "(无前缀)";
+        const prefix = extractTagPrefix(tag) || "(无前缀)";
         if (!grouped.has(prefix)) {
           grouped.set(prefix, []);
         }
@@ -94,7 +137,7 @@ describe("Tag 功能测试", () => {
       const grouped = new Map<string, string[]>();
 
       tags.forEach((tag) => {
-        const prefix = tag.replace(/[0-9].*/, "") || "(无前缀)";
+        const prefix = extractTagPrefix(tag) || "(无前缀)";
         if (!grouped.has(prefix)) {
           grouped.set(prefix, []);
         }
@@ -397,56 +440,56 @@ describe("Tag 功能测试", () => {
   describe("无效标签检测", () => {
     it("应该识别不包含数字的标签为无效", () => {
       const tag = "vnull";
-      const isInvalid = !/\d/.test(tag);
+      const isInvalid = !isValidVersionTag(tag);
 
       expect(isInvalid).toBe(true);
     });
 
     it("应该识别 vundefined 为无效标签", () => {
       const tag = "vundefined";
-      const isInvalid = !/\d/.test(tag);
+      const isInvalid = !isValidVersionTag(tag);
 
       expect(isInvalid).toBe(true);
     });
 
     it("应该识别空版本号为无效标签", () => {
       const tag = "v";
-      const isInvalid = !/\d/.test(tag);
+      const isInvalid = !isValidVersionTag(tag);
 
       expect(isInvalid).toBe(true);
     });
 
     it("应该识别纯字母标签为无效", () => {
       const tag = "release";
-      const isInvalid = !/\d/.test(tag);
+      const isInvalid = !isValidVersionTag(tag);
 
       expect(isInvalid).toBe(true);
     });
 
     it("应该识别包含数字的标签为有效", () => {
       const tag = "v1.0.0";
-      const isValid = /\d/.test(tag);
+      const isValid = isValidVersionTag(tag);
 
       expect(isValid).toBe(true);
     });
 
     it("应该识别预发布版本为有效", () => {
       const tag = "v1.0.0-beta.1";
-      const isValid = /\d/.test(tag);
+      const isValid = isValidVersionTag(tag);
 
       expect(isValid).toBe(true);
     });
 
     it("应该识别无前缀版本号为有效", () => {
       const tag = "1.0.0";
-      const isValid = /\d/.test(tag);
+      const isValid = isValidVersionTag(tag);
 
       expect(isValid).toBe(true);
     });
 
     it("应该识别带前缀的单数字版本为有效", () => {
       const tag = "v1";
-      const isValid = /\d/.test(tag);
+      const isValid = isValidVersionTag(tag);
 
       expect(isValid).toBe(true);
     });
@@ -463,7 +506,7 @@ describe("Tag 功能测试", () => {
         "v",
         "v2.0.0",
       ];
-      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const invalidTags = allTags.filter((tag) => !isValidVersionTag(tag));
 
       expect(invalidTags).toEqual(["vnull", "vundefined", "v"]);
       expect(invalidTags.length).toBe(3);
@@ -471,7 +514,7 @@ describe("Tag 功能测试", () => {
 
     it("应该在没有无效标签时返回空数组", () => {
       const allTags = ["v1.0.0", "v1.1.0", "v2.0.0", "release-1.0.0"];
-      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const invalidTags = allTags.filter((tag) => !isValidVersionTag(tag));
 
       expect(invalidTags).toEqual([]);
       expect(invalidTags.length).toBe(0);
@@ -479,7 +522,7 @@ describe("Tag 功能测试", () => {
 
     it("应该在全是无效标签时返回所有标签", () => {
       const allTags = ["vnull", "vundefined", "v", "release"];
-      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const invalidTags = allTags.filter((tag) => !isValidVersionTag(tag));
 
       expect(invalidTags).toEqual(allTags);
       expect(invalidTags.length).toBe(4);
@@ -493,7 +536,7 @@ describe("Tag 功能测试", () => {
         "vundefined",
         "v2.0.0-beta.1",
       ];
-      const validTags = allTags.filter((tag) => /\d/.test(tag));
+      const validTags = allTags.filter(isValidVersionTag);
 
       expect(validTags).toEqual(["v1.0.0", "v1.1.0", "v2.0.0-beta.1"]);
       expect(validTags.length).toBe(3);
@@ -501,7 +544,7 @@ describe("Tag 功能测试", () => {
 
     it("应该处理空标签列表", () => {
       const allTags: string[] = [];
-      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const invalidTags = allTags.filter((tag) => !isValidVersionTag(tag));
 
       expect(invalidTags).toEqual([]);
       expect(invalidTags.length).toBe(0);
@@ -516,7 +559,7 @@ describe("Tag 功能测试", () => {
         "g1.0.0",
         "tag",
       ];
-      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const invalidTags = allTags.filter((tag) => !isValidVersionTag(tag));
 
       expect(invalidTags).toEqual(["vnull", "release-", "hotfix", "tag"]);
       expect(invalidTags.length).toBe(4);