@zjex/git-workflow 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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))
+- refactor(update-notifier): Simplify version checking logic ([165e21f](https://github.com/iamzjt-front-end/git-workflow/commit/165e21f))
+
 ## [v0.5.1](https://github.com/iamzjt-front-end/git-workflow/compare/v0.5.0...v0.5.1) (2026-02-06)
 
 - 🔖 chore(release): 发布 v0.5.1 ([88c2089](https://github.com/iamzjt-front-end/git-workflow/commit/88c2089))

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-573%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

@@ -175,18 +175,19 @@ __export(update_notifier_exports, {
   checkForUpdates: () => checkForUpdates,
   clearUpdateCache: () => clearUpdateCache
 });
-import { execSync as execSync3 } from "child_process";
+import { execSync as execSync3, spawn as spawn3 } from "child_process";
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync4, existsSync as existsSync3, unlinkSync as unlinkSync2 } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join4 } from "path";
 import boxen2 from "boxen";
 import { select as select7 } from "@inquirer/prompts";
 import ora5 from "ora";
+import semver from "semver";
 async function checkForUpdates(currentVersion, packageName = "@zjex/git-workflow", interactive = false) {
   try {
     const cache = readCache();
     const now = Date.now();
-    if (cache?.latestVersion && cache.latestVersion !== currentVersion) {
+    if (cache?.latestVersion && semver.gt(cache.latestVersion, currentVersion)) {
       const isDismissed = cache.lastDismiss && now - cache.lastDismiss < DISMISS_INTERVAL;
       if (!isDismissed) {
         if (interactive) {
@@ -205,29 +206,45 @@ async function checkForUpdates(currentVersion, packageName = "@zjex/git-workflow
         }
       }
     }
-    backgroundCheck(currentVersion, packageName);
+    spawnBackgroundCheck(packageName);
   } catch (error) {
     if (error?.constructor?.name === "ExitPromptError") {
       throw error;
     }
   }
 }
-function backgroundCheck(currentVersion, packageName) {
-  setImmediate(async () => {
-    try {
-      const latestVersion = await getLatestVersion(packageName);
-      if (latestVersion) {
-        const cache = readCache() || {};
-        writeCache({
-          ...cache,
-          lastCheck: Date.now(),
-          latestVersion,
-          checkedVersion: currentVersion
-        });
-      }
-    } catch {
-    }
-  });
+function spawnBackgroundCheck(packageName) {
+  try {
+    const cacheFile = join4(homedir3(), CACHE_FILE);
+    const script = `
+      const { execSync } = require('child_process');
+      const { writeFileSync, readFileSync, existsSync } = require('fs');
+      try {
+        const version = execSync('npm view ${packageName} version', {
+          encoding: 'utf-8',
+          timeout: 10000,
+          stdio: ['pipe', 'pipe', 'ignore']
+        }).trim();
+        if (version) {
+          let cache = {};
+          try {
+            if (existsSync('${cacheFile}')) {
+              cache = JSON.parse(readFileSync('${cacheFile}', 'utf-8'));
+            }
+          } catch {}
+          cache.lastCheck = Date.now();
+          cache.latestVersion = version;
+          writeFileSync('${cacheFile}', JSON.stringify(cache), 'utf-8');
+        }
+      } catch {}
+    `;
+    const child = spawn3("node", ["-e", script], {
+      detached: true,
+      stdio: "ignore"
+    });
+    child.unref();
+  } catch {
+  }
 }
 function isUsingVolta() {
   try {
@@ -237,19 +254,6 @@ function isUsingVolta() {
     return false;
   }
 }
-async function getLatestVersion(packageName) {
-  try {
-    const result = execSync3(`npm view ${packageName} version`, {
-      encoding: "utf-8",
-      timeout: 3e3,
-      stdio: ["pipe", "pipe", "ignore"]
-      // 忽略 stderr
-    });
-    return result.trim();
-  } catch {
-    return null;
-  }
-}
 function showSimpleNotification(current, latest) {
   const message = `${colors.yellow("\u{1F389} \u53D1\u73B0\u65B0\u7248\u672C")} ${colors.dim(
     current
@@ -417,6 +421,7 @@ var defaultConfig = {
   requireId: false,
   featureIdLabel: "Story ID",
   hotfixIdLabel: "Issue ID",
+  tagLookupStrategy: "latest",
   autoStage: true,
   useEmoji: true
 };
@@ -743,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")
@@ -769,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, []);
     }
@@ -823,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):",
@@ -885,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):",
@@ -900,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 };
       });
@@ -925,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(
@@ -944,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(
@@ -1584,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: [
@@ -2808,10 +2865,10 @@ init_update_notifier();
 
 // src/commands/update.ts
 init_utils();
-import { execSync as execSync4, spawn as spawn3 } from "child_process";
+import { execSync as execSync4, spawn as spawn4 } from "child_process";
 import ora6 from "ora";
 import boxen3 from "boxen";
-import semver from "semver";
+import semver2 from "semver";
 import { existsSync as existsSync4, unlinkSync as unlinkSync3 } from "fs";
 import { homedir as homedir4 } from "os";
 import { join as join5 } from "path";
@@ -2825,9 +2882,9 @@ function clearUpdateCache2() {
   } catch {
   }
 }
-async function getLatestVersion2(packageName) {
+async function getLatestVersion(packageName) {
   return new Promise((resolve) => {
-    const npmView = spawn3("npm", ["view", packageName, "version"], {
+    const npmView = spawn4("npm", ["view", packageName, "version"], {
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 5e3
     });
@@ -2865,14 +2922,14 @@ async function update(currentVersion) {
   console.log("");
   const spinner = ora6("\u6B63\u5728\u83B7\u53D6\u6700\u65B0\u7248\u672C\u4FE1\u606F...").start();
   try {
-    const latestVersion = await getLatestVersion2(packageName);
+    const latestVersion = await getLatestVersion(packageName);
     if (!latestVersion) {
       spinner.fail("\u65E0\u6CD5\u83B7\u53D6\u6700\u65B0\u7248\u672C\u4FE1\u606F");
       console.log(colors.dim("  \u8BF7\u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5\u540E\u91CD\u8BD5"));
       return;
     }
     spinner.stop();
-    if (semver.gte(currentVersion, latestVersion)) {
+    if (semver2.gte(currentVersion, latestVersion)) {
       console.log(
         boxen3(
           [
@@ -2916,7 +2973,7 @@ async function update(currentVersion) {
     console.log("");
     const updateCommand = usingVolta ? `volta install ${packageName}@latest` : `npm install -g ${packageName}@latest`;
     const [command, ...args] = updateCommand.split(" ");
-    const updateProcess = spawn3(command, args, {
+    const updateProcess = spawn4(command, args, {
       stdio: "inherit"
       // 继承父进程的 stdio，显示实时输出
     });
@@ -2987,7 +3044,7 @@ async function update(currentVersion) {
 init_utils();
 import { execSync as execSync5 } from "child_process";
 import boxen4 from "boxen";
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 function parseGitLog(output) {
   const commits = [];
   const lines = output.trim().split("\n");
@@ -3205,7 +3262,7 @@ function formatTimelineStyle(commits) {
 function startInteractivePager(content) {
   const pager = process.env.PAGER || "less";
   try {
-    const pagerProcess = spawn4(pager, ["-R", "-S", "-F", "-X", "-i"], {
+    const pagerProcess = spawn5(pager, ["-R", "-S", "-F", "-X", "-i"], {
       stdio: ["pipe", "inherit", "inherit"],
       env: { ...process.env, LESS: "-R -S -F -X -i" }
     });
@@ -3621,16 +3678,19 @@ var AI_PROVIDERS2 = {
     defaultModel: "qwen2.5-coder:14b"
   }
 };
+function parseCommitLine(line) {
+  const parts = line.split("|");
+  if (parts.length < 5) return null;
+  const [hash, shortHash, subject, author, date] = parts;
+  return { hash, shortHash, subject, author, date };
+}
 function getRecentCommits3(limit = 20) {
   try {
     const output = execOutput(
       `git log -${limit} --pretty=format:"%H|%h|%s|%an|%ad" --date=short`
     );
     if (!output) return [];
-    return output.split("\n").filter(Boolean).map((line) => {
-      const [hash, shortHash, subject, author, date] = line.split("|");
-      return { hash, shortHash, subject, author, date };
-    });
+    return output.split("\n").filter(Boolean).map((line) => parseCommitLine(line)).filter((c) => c !== null);
   } catch {
     return [];
   }
@@ -4070,25 +4130,49 @@ async function review(hashes, options = {}) {
   let diff = "";
   let commits = [];
   if (hashes && hashes.length > 0) {
-    commits = hashes.map((hash) => {
-      const info = execOutput(
-        `git log -1 --pretty=format:"%H|%h|%s|%an|%ad" --date=short ${hash}`
-      );
-      if (!info) {
-        console.log(colors.red(`\u274C \u627E\u4E0D\u5230 commit: ${hash}`));
+    if (hashes.length === 1 && hashes[0].includes("..") && !hashes[0].includes("...")) {
+      const range = hashes[0];
+      const [startHash, endHash] = range.split("..");
+      const inclusiveRange = `${startHash}^..${endHash}`;
+      try {
+        const output = execOutput(
+          `git log ${inclusiveRange} --pretty=format:"%H|%h|%s|%an|%ad" --date=short --reverse`
+        );
+        if (!output) {
+          console.log(colors.red(`\u274C \u65E0\u6548\u7684 commit \u8303\u56F4: ${range}`));
+          process.exit(1);
+        }
+        commits = output.split("\n").filter(Boolean).map((line) => parseCommitLine(line)).filter((c) => c !== null);
+        diff = execOutput(`git diff ${inclusiveRange}`) || "";
+      } catch {
+        console.log(colors.red(`\u274C \u65E0\u6548\u7684 commit \u8303\u56F4: ${range}`));
         process.exit(1);
       }
-      const [fullHash, shortHash, subject, author, date] = info.split("|");
-      return { hash: fullHash, shortHash, subject, author, date };
-    });
-    diff = getMultipleCommitsDiff(hashes);
+    } else {
+      commits = hashes.map((hash) => {
+        const info = execOutput(
+          `git log -1 --pretty=format:"%H|%h|%s|%an|%ad" --date=short ${hash}`
+        );
+        if (!info) {
+          console.log(colors.red(`\u274C \u627E\u4E0D\u5230 commit: ${hash}`));
+          process.exit(1);
+        }
+        const commit2 = parseCommitLine(info);
+        if (!commit2) {
+          console.log(colors.red(`\u274C \u65E0\u6CD5\u89E3\u6790 commit \u4FE1\u606F: ${hash}`));
+          process.exit(1);
+        }
+        return commit2;
+      });
+      diff = getMultipleCommitsDiff(hashes);
+    }
   } else if (options.last) {
     commits = getRecentCommits3(options.last);
     diff = getMultipleCommitsDiff(commits.map((c) => c.hash));
   } else if (options.staged) {
     diff = getStagedDiff();
   } else {
-    const recentCommits = getRecentCommits3(20);
+    const recentCommits = getRecentCommits3(10);
     const stagedDiff = getStagedDiff();
     const choices = [];
     if (stagedDiff) {
@@ -4201,7 +4285,7 @@ process.on("SIGTERM", () => {
   console.log("");
   process.exit(0);
 });
-var version = true ? "0.5.2" : "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/commands/review.md

@@ -14,6 +14,9 @@ gw review abc1234
 # 审查多个 commits
 gw review abc1234 def5678
 
+# 审查 commit 范围（包含 abc1234 和 def5678 的所有 commits）
+gw review abc1234..def5678
+
 # 审查最近 N 个 commits
 gw review -n 3
 gw review --last 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/ai-review.md

@@ -21,6 +21,9 @@ gw review abc1234
 # 审查多个 commits
 gw review abc1234 def5678
 
+# 审查 commit 范围（包含 abc1234 和 def5678 的所有 commits）
+gw review abc1234..def5678
+
 # 审查最近 N 个 commits
 gw review -n 3
 
@@ -137,6 +140,9 @@ gw c
 ```bash
 # 审查某个 PR 的所有 commits
 gw review abc1234 def5678 ghi9012
+
+# 或使用范围语法审查从 abc1234 到 def5678 的所有 commits（包含两端）
+gw review abc1234..def5678
 ```
 
 ### 3. 定期代码审计

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.2",
+	"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: "创建分支后是否自动推送?",