@zjex/git-workflow 0.2.18 → 0.2.20

package/README.md

@@ -450,6 +450,12 @@ gw r
 | --------- | ------------------------------------------------ |
 | `gw init` | 交互式初始化配置文件（可选择全局配置或项目配置） |
 
+### 🔄 更新命令
+
+| 命令        | 别名     | 说明                 |
+| ----------- | -------- | -------------------- |
+| `gw update` | `gw upt` | 检查并更新到最新版本 |
+
 ```bash
 # 创建全局配置（推荐，一次配置所有项目生效）
 gw init
@@ -462,6 +468,49 @@ gw init
 # 配置保存到 .gwrc.json
 ```
 
+#### 更新命令
+
+```bash
+# 检查并更新到最新版本
+gw update
+
+# 或使用别名
+gw upt
+```
+
+**更新流程：**
+
+```bash
+gw update
+
+🔍 检查更新...
+
+┌─────────────────────────────────┐
+│                                 │
+│   🎉 发现新版本！               │
+│                                 │
+│   0.2.16  →  0.2.17             │
+│                                 │
+└─────────────────────────────────┘
+
+✔ 更新成功！
+
+┌─────────────────────────────────┐
+│                                 │
+│   ✨ 更新完成！                 │
+│                                 │
+│   请重新打开终端使用新版本      │
+│                                 │
+└─────────────────────────────────┘
+```
+
+**说明：**
+
+- 自动检测最新版本
+- 如果已是最新版本，显示提示
+- 如果有新版本，自动更新
+- 更新成功后提示重新打开终端
+
 **配置流程：**
 
 ```bash

package/dist/index.js

@@ -1,31 +1,16 @@
 #!/usr/bin/env -S node --no-warnings=ExperimentalWarning
-
-// src/index.ts
-import { cac } from "cac";
-import { select as select8 } from "@inquirer/prompts";
-import { ExitPromptError } from "@inquirer/core";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/utils.ts
 import { execSync } from "child_process";
-var colors = {
-  red: (s) => `\x1B[31m${s}\x1B[0m`,
-  green: (s) => `\x1B[32m${s}\x1B[0m`,
-  yellow: (s) => `\x1B[33m${s}\x1B[0m`,
-  cyan: (s) => `\x1B[36m${s}\x1B[0m`,
-  dim: (s) => `\x1B[2m${s}\x1B[0m`,
-  bold: (s) => `\x1B[1m${s}\x1B[0m`,
-  reset: "\x1B[0m"
-};
-var TODAY = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10).replace(/-/g, "");
-var theme = {
-  helpMode: "always",
-  style: {
-    keysHelpTip: (keys) => {
-      const tips = keys.map(([key, label]) => `${key} ${label}`).join(" \u2022 ");
-      return `\x1B[2m${tips} \u2022 Ctrl+C quit\x1B[0m`;
-    }
-  }
-};
 function exec(cmd, silent = false) {
   try {
     const options = {
@@ -66,13 +51,267 @@ function getMainBranch() {
 function divider() {
   console.log(colors.dim("\u2500".repeat(40)));
 }
+var colors, TODAY, theme;
+var init_utils = __esm({
+  "src/utils.ts"() {
+    "use strict";
+    colors = {
+      red: (s) => `\x1B[31m${s}\x1B[0m`,
+      green: (s) => `\x1B[32m${s}\x1B[0m`,
+      yellow: (s) => `\x1B[33m${s}\x1B[0m`,
+      cyan: (s) => `\x1B[36m${s}\x1B[0m`,
+      dim: (s) => `\x1B[2m${s}\x1B[0m`,
+      bold: (s) => `\x1B[1m${s}\x1B[0m`,
+      reset: "\x1B[0m"
+    };
+    TODAY = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10).replace(/-/g, "");
+    theme = {
+      helpMode: "always",
+      style: {
+        keysHelpTip: (keys) => {
+          const tips = keys.map(([key, label]) => `${key} ${label}`).join(" \u2022 ");
+          return `\x1B[2m${tips} \u2022 Ctrl+C quit\x1B[0m`;
+        }
+      }
+    };
+  }
+});
+
+// src/update-notifier.ts
+var update_notifier_exports = {};
+__export(update_notifier_exports, {
+  checkForUpdates: () => checkForUpdates,
+  clearUpdateCache: () => clearUpdateCache
+});
+import { execSync as execSync6 } from "child_process";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3, unlinkSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
+import boxen 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.checkedVersion === currentVersion) {
+      if (cache.lastDismiss && now - cache.lastDismiss < DISMISS_INTERVAL) {
+        backgroundCheck(currentVersion, packageName);
+        return;
+      }
+      if (semver.gt(cache.latestVersion, currentVersion)) {
+        if (interactive) {
+          const action = await showUpdateMessage(
+            currentVersion,
+            cache.latestVersion,
+            packageName
+          );
+          if (action === "update") {
+            await performUpdate(packageName);
+          } else if (action === "dismiss") {
+            writeCache({ ...cache, lastDismiss: now });
+          }
+        } else {
+          showSimpleNotification(currentVersion, cache.latestVersion);
+        }
+      }
+    }
+    backgroundCheck(currentVersion, packageName);
+  } catch (error) {
+    if (error?.constructor?.name === "ExitPromptError") {
+      throw error;
+    }
+  }
+}
+function backgroundCheck(currentVersion, packageName) {
+  const cache = readCache();
+  const now = Date.now();
+  if (cache?.lastCheck && now - cache.lastCheck < CHECK_INTERVAL) {
+    return;
+  }
+  Promise.resolve().then(async () => {
+    try {
+      const latestVersion = await getLatestVersion(packageName);
+      if (latestVersion) {
+        writeCache({
+          ...cache,
+          lastCheck: now,
+          latestVersion,
+          checkedVersion: currentVersion
+        });
+      }
+    } catch {
+    }
+  });
+}
+async function getLatestVersion(packageName) {
+  try {
+    const result = execSync6(`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
+  )} \u2192 ${colors.green(latest)}    ${colors.dim("\u8FD0\u884C")} ${colors.cyan(
+    "gw update"
+  )} ${colors.dim("\u66F4\u65B0")}`;
+  console.log("");
+  console.log(
+    boxen(message, {
+      padding: { top: 0, bottom: 0, left: 2, right: 2 },
+      margin: { top: 0, bottom: 1, left: 0, right: 0 },
+      borderStyle: "round",
+      borderColor: "yellow",
+      align: "center"
+    })
+  );
+}
+async function showUpdateMessage(current, latest, packageName) {
+  const message = [
+    colors.yellow(colors.bold("\u{1F389} \u53D1\u73B0\u65B0\u7248\u672C\uFF01")),
+    "",
+    `${colors.dim(current)}  \u2192  ${colors.green(colors.bold(latest))}`
+  ].join("\n");
+  console.log("");
+  console.log(
+    boxen(message, {
+      padding: { top: 1, bottom: 1, left: 3, right: 3 },
+      margin: 1,
+      borderStyle: "round",
+      borderColor: "yellow",
+      align: "center",
+      width: 40
+    })
+  );
+  try {
+    const action = await select7({
+      message: "\u4F60\u60F3\u505A\u4EC0\u4E48\uFF1F",
+      choices: [
+        {
+          name: "\u{1F680} \u7ACB\u5373\u66F4\u65B0",
+          value: "update",
+          description: `\u8FD0\u884C npm install -g ${packageName}`
+        },
+        {
+          name: "\u23ED\uFE0F  \u7A0D\u540E\u66F4\u65B0\uFF0C\u7EE7\u7EED\u4F7F\u7528",
+          value: "continue",
+          description: "\u4E0B\u6B21\u542F\u52A8\u65F6\u4F1A\u518D\u6B21\u63D0\u793A"
+        },
+        {
+          name: "\u{1F648} \u8DF3\u8FC7\u6B64\u7248\u672C (24h \u5185\u4E0D\u518D\u63D0\u793A)",
+          value: "dismiss",
+          description: "24 \u5C0F\u65F6\u5185\u4E0D\u4F1A\u518D\u63D0\u793A\u6B64\u7248\u672C"
+        }
+      ]
+    });
+    return action;
+  } catch (error) {
+    console.log("");
+    throw error;
+  }
+}
+async function performUpdate(packageName) {
+  console.log("");
+  const spinner = ora5({
+    text: "\u6B63\u5728\u66F4\u65B0...",
+    spinner: "dots"
+  }).start();
+  try {
+    execSync6(`npm install -g ${packageName}@latest`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    spinner.succeed(colors.green("\u66F4\u65B0\u6210\u529F\uFF01"));
+    clearUpdateCache();
+    console.log("");
+    console.log(
+      boxen(
+        [
+          colors.green(colors.bold("\u2728 \u66F4\u65B0\u5B8C\u6210\uFF01")),
+          "",
+          colors.dim("\u8BF7\u91CD\u65B0\u6253\u5F00\u7EC8\u7AEF\u4F7F\u7528\u65B0\u7248\u672C")
+        ].join("\n"),
+        {
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
+          margin: { top: 0, bottom: 1, left: 2, right: 2 },
+          borderStyle: "round",
+          borderColor: "green",
+          align: "center",
+          width: 40
+        }
+      )
+    );
+    process.exit(0);
+  } catch (error) {
+    spinner.fail(colors.red("\u66F4\u65B0\u5931\u8D25"));
+    console.log("");
+    console.log(colors.dim("  \u4F60\u53EF\u4EE5\u624B\u52A8\u8FD0\u884C\u4EE5\u4E0B\u547D\u4EE4\u66F4\u65B0:"));
+    console.log(colors.cyan(`  npm install -g ${packageName}@latest`));
+    console.log("");
+  }
+}
+function clearUpdateCache() {
+  try {
+    const cacheFile = join3(homedir3(), CACHE_FILE);
+    if (existsSync3(cacheFile)) {
+      unlinkSync(cacheFile);
+    }
+  } catch {
+  }
+}
+function readCache() {
+  try {
+    const cacheFile = join3(homedir3(), CACHE_FILE);
+    if (!existsSync3(cacheFile)) {
+      return null;
+    }
+    const content = readFileSync3(cacheFile, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    const cacheFile = join3(homedir3(), CACHE_FILE);
+    writeFileSync3(cacheFile, JSON.stringify(cache), "utf-8");
+  } catch {
+  }
+}
+var CHECK_INTERVAL, DISMISS_INTERVAL, CACHE_FILE;
+var init_update_notifier = __esm({
+  "src/update-notifier.ts"() {
+    "use strict";
+    init_utils();
+    CHECK_INTERVAL = 1e3 * 60 * 60 * 4;
+    DISMISS_INTERVAL = 1e3 * 60 * 60 * 24;
+    CACHE_FILE = ".gw-update-check";
+  }
+});
+
+// src/index.ts
+init_utils();
+import { cac } from "cac";
+import { select as select8 } from "@inquirer/prompts";
+import { ExitPromptError } from "@inquirer/core";
 
 // src/commands/branch.ts
+init_utils();
 import { execSync as execSync2 } from "child_process";
 import { select, input } from "@inquirer/prompts";
 import ora from "ora";
 
 // src/config.ts
+init_utils();
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -392,6 +631,7 @@ async function deleteBranch(branchArg) {
 }
 
 // src/commands/tag.ts
+init_utils();
 import { execSync as execSync3 } from "child_process";
 import { select as select2, input as input2 } from "@inquirer/prompts";
 import ora2 from "ora";
@@ -790,6 +1030,7 @@ async function updateTag() {
 }
 
 // src/commands/release.ts
+init_utils();
 import { readFileSync as readFileSync2, writeFileSync } from "fs";
 import { select as select3 } from "@inquirer/prompts";
 function getPackageVersion() {
@@ -888,6 +1129,7 @@ async function release() {
 }
 
 // src/commands/init.ts
+init_utils();
 import { existsSync as existsSync2, writeFileSync as writeFileSync2 } from "fs";
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
@@ -1172,6 +1414,7 @@ async function init() {
 }
 
 // src/commands/stash.ts
+init_utils();
 import { execSync as execSync4 } from "child_process";
 import { select as select5, input as input4 } from "@inquirer/prompts";
 import ora3 from "ora";
@@ -1406,11 +1649,13 @@ async function dropStash(index) {
 }
 
 // src/commands/commit.ts
+init_utils();
 import { execSync as execSync5 } from "child_process";
 import { select as select6, input as input5, checkbox } from "@inquirer/prompts";
 import ora4 from "ora";
 
 // src/ai-service.ts
+init_utils();
 var AI_PROVIDERS = {
   github: {
     name: "GitHub Models",
@@ -1890,6 +2135,7 @@ ${issues}`;
 }
 
 // src/commands/help.ts
+init_utils();
 function showHelp() {
   return `
 \u5206\u652F\u547D\u4EE4:
@@ -1928,6 +2174,13 @@ Tag \u547D\u4EE4:
                                   \u2022 \u9879\u76EE\u914D\u7F6E: .gwrc.json (\u4EC5\u5F53\u524D\u9879\u76EE)
                                   \u8FD0\u884C\u65F6\u53EF\u9009\u62E9\u914D\u7F6E\u8303\u56F4
 
+\u66F4\u65B0\u547D\u4EE4:
+  gw update                       \u68C0\u67E5\u5E76\u66F4\u65B0\u5230\u6700\u65B0\u7248\u672C
+  gw upt                          \u540C\u4E0A (\u522B\u540D)
+
+\u6E05\u7406\u547D\u4EE4:
+  gw clean                        \u6E05\u7406\u7F13\u5B58\u6587\u4EF6
+
 Stash \u547D\u4EE4:
   gw stash                        \u4EA4\u4E92\u5F0F\u7BA1\u7406 stash
   gw s                            \u540C\u4E0A (\u522B\u540D)
@@ -1958,124 +2211,121 @@ Commit \u547D\u4EE4:
 `;
 }
 
-// src/update-notifier.ts
-import { execSync as execSync6 } from "child_process";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3 } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join3 } from "path";
-import boxen from "boxen";
-import { select as select7 } from "@inquirer/prompts";
-import ora5 from "ora";
-var DISMISS_INTERVAL = 1e3 * 60 * 60 * 24;
-var CACHE_FILE = ".gw-update-check";
-async function checkForUpdates(currentVersion, packageName = "@zjex/git-workflow") {
+// src/index.ts
+init_update_notifier();
+
+// src/commands/update.ts
+init_utils();
+import { execSync as execSync7 } from "child_process";
+import ora6 from "ora";
+import boxen2 from "boxen";
+import semver2 from "semver";
+import { existsSync as existsSync4, unlinkSync as unlinkSync2 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+var CACHE_FILE2 = ".gw-update-check";
+function clearUpdateCache2() {
   try {
-    const cache = readCache();
-    const now = Date.now();
-    if (cache?.lastDismiss && now - cache.lastDismiss < DISMISS_INTERVAL) {
-      return;
-    }
-    const latestVersion = await getLatestVersion(packageName);
-    if (latestVersion && latestVersion !== currentVersion) {
-      const action = await showUpdateMessage(
-        currentVersion,
-        latestVersion,
-        packageName
-      );
-      if (action === "update") {
-        await performUpdate(packageName);
-      } else if (action === "dismiss") {
-        writeCache({ lastDismiss: now, latestVersion });
-      }
-    }
-  } catch (error) {
-    if (error?.constructor?.name === "ExitPromptError") {
-      throw error;
+    const cacheFile = join4(homedir4(), CACHE_FILE2);
+    if (existsSync4(cacheFile)) {
+      unlinkSync2(cacheFile);
     }
+  } catch {
   }
 }
-async function getLatestVersion(packageName) {
+async function getLatestVersion2(packageName) {
   try {
-    const result = execSync6(`npm view ${packageName} version`, {
+    const result = execSync7(`npm view ${packageName} version`, {
       encoding: "utf-8",
       timeout: 3e3,
       stdio: ["pipe", "pipe", "ignore"]
-      // 忽略 stderr
     });
     return result.trim();
   } catch {
     return null;
   }
 }
-async function showUpdateMessage(current, latest, packageName) {
-  const message = [
-    colors.bold("\uFFFD \u53D1\u73B0\u65B0\u7248\u65B0\u672C\u53EF\u7528\uFF01"),
-    "",
-    `${colors.dim(current)}  \u2192  ${colors.green(colors.bold(latest))}`
-  ].join("\n");
+async function update(currentVersion) {
+  const packageName = "@zjex/git-workflow";
   console.log("");
-  console.log(
-    boxen(message, {
-      padding: 1,
-      margin: 1,
-      borderStyle: "round",
-      borderColor: "yellow",
-      align: "left"
-    })
-  );
+  console.log(colors.bold("\u{1F50D} \u68C0\u67E5\u66F4\u65B0..."));
+  console.log("");
+  const spinner = ora6("\u6B63\u5728\u83B7\u53D6\u6700\u65B0\u7248\u672C\u4FE1\u606F...").start();
   try {
-    const action = await select7({
-      message: "\u4F60\u60F3\u505A\u4EC0\u4E48\uFF1F",
-      choices: [
-        {
-          name: "\u{1F680} \u7ACB\u5373\u66F4\u65B0",
-          value: "update",
-          description: `\u8FD0\u884C npm install -g ${packageName}`
-        },
-        {
-          name: "\u23ED\uFE0F  \u7A0D\u540E\u66F4\u65B0\uFF0C\u7EE7\u7EED\u4F7F\u7528",
-          value: "continue",
-          description: "\u4E0B\u6B21\u542F\u52A8\u65F6\u4F1A\u518D\u6B21\u63D0\u793A"
-        },
+    const latestVersion = await getLatestVersion2(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 (semver2.gte(currentVersion, latestVersion)) {
+      console.log(
+        boxen2(
+          [
+            colors.green(colors.bold("\u2705 \u5DF2\u662F\u6700\u65B0\u7248\u672C")),
+            "",
+            `\u5F53\u524D\u7248\u672C: ${colors.green(currentVersion)}`
+          ].join("\n"),
+          {
+            padding: 1,
+            margin: { top: 0, bottom: 1, left: 2, right: 2 },
+            borderStyle: "round",
+            borderColor: "green",
+            align: "left"
+          }
+        )
+      );
+      return;
+    }
+    const versionText = `${currentVersion}  \u2192  ${latestVersion}`;
+    const maxWidth = Math.max(
+      "\u{1F389} \u53D1\u73B0\u65B0\u7248\u672C\uFF01".length,
+      versionText.length,
+      "\u2728 \u66F4\u65B0\u5B8C\u6210\uFF01".length,
+      "\u8BF7\u91CD\u65B0\u6253\u5F00\u7EC8\u7AEF\u4F7F\u7528\u65B0\u7248\u672C".length
+    );
+    console.log(
+      boxen2(
+        [
+          colors.yellow(colors.bold("\u{1F389} \u53D1\u73B0\u65B0\u7248\u672C\uFF01")),
+          "",
+          `${colors.dim(currentVersion)}  \u2192  ${colors.green(
+            colors.bold(latestVersion)
+          )}`
+        ].join("\n"),
         {
-          name: "\u{1F648} \u8DF3\u8FC7\u6B64\u7248\u672C (24h \u5185\u4E0D\u518D\u63D0\u793A)",
-          value: "dismiss",
-          description: "24 \u5C0F\u65F6\u5185\u4E0D\u4F1A\u518D\u63D0\u793A\u6B64\u7248\u672C"
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
+          margin: { top: 0, bottom: 1, left: 2, right: 2 },
+          borderStyle: "round",
+          borderColor: "yellow",
+          align: "center",
+          width: 40
         }
-      ]
-    });
-    return action;
-  } catch (error) {
-    console.log("");
-    throw error;
-  }
-}
-async function performUpdate(packageName) {
-  console.log("");
-  const spinner = ora5({
-    text: "\u6B63\u5728\u66F4\u65B0...",
-    spinner: "dots"
-  }).start();
-  try {
-    execSync6(`npm install -g ${packageName}@latest`, {
+      )
+    );
+    const updateSpinner = ora6("\u6B63\u5728\u66F4\u65B0...").start();
+    execSync7(`npm install -g ${packageName}@latest`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
-    spinner.succeed(colors.green("\u66F4\u65B0\u6210\u529F\uFF01"));
+    updateSpinner.succeed(colors.green("\u66F4\u65B0\u6210\u529F\uFF01"));
+    clearUpdateCache2();
     console.log("");
     console.log(
-      boxen(
+      boxen2(
         [
-          colors.bold("\u2728 \u66F4\u65B0\u5B8C\u6210\uFF01"),
+          colors.green(colors.bold("\u2728 \u66F4\u65B0\u5B8C\u6210\uFF01")),
           "",
           colors.dim("\u8BF7\u91CD\u65B0\u6253\u5F00\u7EC8\u7AEF\u4F7F\u7528\u65B0\u7248\u672C")
         ].join("\n"),
         {
-          padding: 1,
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
           margin: { top: 0, bottom: 1, left: 2, right: 2 },
           borderStyle: "round",
           borderColor: "green",
-          align: "left"
+          align: "center",
+          width: 40
         }
       )
     );
@@ -2086,25 +2336,7 @@ async function performUpdate(packageName) {
     console.log(colors.dim("  \u4F60\u53EF\u4EE5\u624B\u52A8\u8FD0\u884C\u4EE5\u4E0B\u547D\u4EE4\u66F4\u65B0:"));
     console.log(colors.cyan(`  npm install -g ${packageName}@latest`));
     console.log("");
-  }
-}
-function readCache() {
-  try {
-    const cacheFile = join3(homedir3(), CACHE_FILE);
-    if (!existsSync3(cacheFile)) {
-      return null;
-    }
-    const content = readFileSync3(cacheFile, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-function writeCache(cache) {
-  try {
-    const cacheFile = join3(homedir3(), CACHE_FILE);
-    writeFileSync3(cacheFile, JSON.stringify(cache), "utf-8");
-  } catch {
+    process.exit(1);
   }
 }
 
@@ -2133,7 +2365,7 @@ process.on("SIGTERM", () => {
   console.log("");
   process.exit(0);
 });
-var version = true ? "0.2.18" : "0.0.0-dev";
+var version = true ? "0.2.20" : "0.0.0-dev";
 async function mainMenu() {
   console.log(
     colors.green(`
@@ -2252,7 +2484,7 @@ async function mainMenu() {
 }
 var cli = cac("gw");
 cli.command("", "\u663E\u793A\u4EA4\u4E92\u5F0F\u83DC\u5355").action(async () => {
-  await checkForUpdates(version, "@zjex/git-workflow");
+  await checkForUpdates(version, "@zjex/git-workflow", true);
   return mainMenu();
 });
 cli.command("feature", "\u521B\u5EFA feature \u5206\u652F").alias("feat").alias("f").option("--base <branch>", "\u6307\u5B9A\u57FA\u7840\u5206\u652F").action(async (options) => {
@@ -2308,6 +2540,16 @@ cli.command("commit", "\u4EA4\u4E92\u5F0F\u63D0\u4EA4 (Conventional Commits + Gi
   checkGitRepo();
   return commit();
 });
+cli.command("update", "\u68C0\u67E5\u5E76\u66F4\u65B0\u5230\u6700\u65B0\u7248\u672C").alias("upt").action(async () => {
+  return update(version);
+});
+cli.command("clean", "\u6E05\u7406\u7F13\u5B58\u6587\u4EF6").action(async () => {
+  const { clearUpdateCache: clearUpdateCache3 } = await Promise.resolve().then(() => (init_update_notifier(), update_notifier_exports));
+  clearUpdateCache3();
+  console.log("");
+  console.log(colors.green("\u2714 \u7F13\u5B58\u5DF2\u6E05\u7406"));
+  console.log("");
+});
 cli.help((sections) => {
   sections.push({
     body: showHelp()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.2.18",
+	"version": "0.2.20",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {
@@ -42,10 +42,12 @@
 		"@inquirer/prompts": "^7.0.0",
 		"boxen": "^8.0.1",
 		"cac": "^6.7.14",
-		"ora": "^9.0.0"
+		"ora": "^9.0.0",
+		"semver": "^7.7.3"
 	},
 	"devDependencies": {
 		"@types/node": "^25.0.3",
+		"@types/semver": "^7.7.1",
 		"changelogen": "^0.6.2",
 		"husky": "^9.1.7",
 		"tsup": "^8.5.1",

package/src/commands/help.ts

@@ -38,6 +38,13 @@ Tag 命令:
                                   • 项目配置: .gwrc.json (仅当前项目)
                                   运行时可选择配置范围
 
+更新命令:
+  gw update                       检查并更新到最新版本
+  gw upt                          同上 (别名)
+
+清理命令:
+  gw clean                        清理缓存文件
+
 Stash 命令:
   gw stash                        交互式管理 stash
   gw s                            同上 (别名)

package/src/commands/update.ts

@@ -0,0 +1,157 @@
+import { execSync } from "child_process";
+import ora from "ora";
+import boxen from "boxen";
+import semver from "semver";
+import { existsSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { colors } from "../utils.js";
+
+const CACHE_FILE = ".gw-update-check";
+
+/**
+ * 清理更新缓存文件
+ */
+function clearUpdateCache(): void {
+  try {
+    const cacheFile = join(homedir(), CACHE_FILE);
+    if (existsSync(cacheFile)) {
+      unlinkSync(cacheFile);
+    }
+  } catch {
+    // 静默失败
+  }
+}
+
+/**
+ * 获取 npm 上的最新版本
+ */
+async function getLatestVersion(packageName: string): Promise<string | null> {
+  try {
+    const result = execSync(`npm view ${packageName} version`, {
+      encoding: "utf-8",
+      timeout: 3000,
+      stdio: ["pipe", "pipe", "ignore"],
+    });
+    return result.trim();
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 手动更新命令
+ */
+export async function update(currentVersion: string): Promise<void> {
+  const packageName = "@zjex/git-workflow";
+
+  console.log("");
+  console.log(colors.bold("🔍 检查更新..."));
+  console.log("");
+
+  const spinner = ora("正在获取最新版本信息...").start();
+
+  try {
+    const latestVersion = await getLatestVersion(packageName);
+
+    if (!latestVersion) {
+      spinner.fail("无法获取最新版本信息");
+      console.log(colors.dim("  请检查网络连接后重试"));
+      return;
+    }
+
+    spinner.stop();
+
+    // 使用 semver 比较版本
+    if (semver.gte(currentVersion, latestVersion)) {
+      console.log(
+        boxen(
+          [
+            colors.green(colors.bold("✅ 已是最新版本")),
+            "",
+            `当前版本: ${colors.green(currentVersion)}`,
+          ].join("\n"),
+          {
+            padding: 1,
+            margin: { top: 0, bottom: 1, left: 2, right: 2 },
+            borderStyle: "round",
+            borderColor: "green",
+            align: "left",
+          }
+        )
+      );
+      return;
+    }
+
+    // 有新版本
+    const versionText = `${currentVersion}  →  ${latestVersion}`;
+    const maxWidth = Math.max(
+      "🎉 发现新版本！".length,
+      versionText.length,
+      "✨ 更新完成！".length,
+      "请重新打开终端使用新版本".length
+    );
+
+    console.log(
+      boxen(
+        [
+          colors.yellow(colors.bold("🎉 发现新版本！")),
+          "",
+          `${colors.dim(currentVersion)}  →  ${colors.green(
+            colors.bold(latestVersion)
+          )}`,
+        ].join("\n"),
+        {
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
+          margin: { top: 0, bottom: 1, left: 2, right: 2 },
+          borderStyle: "round",
+          borderColor: "yellow",
+          align: "center",
+          width: 40,
+        }
+      )
+    );
+
+    // 开始更新
+    const updateSpinner = ora("正在更新...").start();
+
+    execSync(`npm install -g ${packageName}@latest`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+
+    updateSpinner.succeed(colors.green("更新成功！"));
+
+    // 清理缓存文件
+    clearUpdateCache();
+
+    console.log("");
+    console.log(
+      boxen(
+        [
+          colors.green(colors.bold("✨ 更新完成！")),
+          "",
+          colors.dim("请重新打开终端使用新版本"),
+        ].join("\n"),
+        {
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
+          margin: { top: 0, bottom: 1, left: 2, right: 2 },
+          borderStyle: "round",
+          borderColor: "green",
+          align: "center",
+          width: 40,
+        }
+      )
+    );
+
+    // 更新成功后退出
+    process.exit(0);
+  } catch (error) {
+    spinner.fail(colors.red("更新失败"));
+    console.log("");
+    console.log(colors.dim("  你可以手动运行以下命令更新:"));
+    console.log(colors.cyan(`  npm install -g ${packageName}@latest`));
+    console.log("");
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -12,6 +12,7 @@ import { stash } from "./commands/stash.js";
 import { commit } from "./commands/commit.js";
 import { showHelp } from "./commands/help.js";
 import { checkForUpdates } from "./update-notifier.js";
+import { update } from "./commands/update.js";
 
 // 捕获 Ctrl+C 退出，静默处理
 process.on("uncaughtException", (err) => {
@@ -177,7 +178,7 @@ const cli = cac("gw");
 
 // 默认命令 - 显示交互式菜单
 cli.command("", "显示交互式菜单").action(async () => {
-  await checkForUpdates(version, "@zjex/git-workflow");
+  await checkForUpdates(version, "@zjex/git-workflow", true);
   return mainMenu();
 });
 
@@ -282,6 +283,21 @@ cli
     return commit();
   });
 
+cli
+  .command("update", "检查并更新到最新版本")
+  .alias("upt")
+  .action(async () => {
+    return update(version);
+  });
+
+cli.command("clean", "清理缓存文件").action(async () => {
+  const { clearUpdateCache } = await import("./update-notifier.js");
+  clearUpdateCache();
+  console.log("");
+  console.log(colors.green("✔ 缓存已清理"));
+  console.log("");
+});
+
 cli.help((sections) => {
   sections.push({
     body: showHelp(),

package/src/update-notifier.ts

@@ -1,57 +1,72 @@
 import { execSync } from "child_process";
-import { readFileSync, writeFileSync, existsSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, unlinkSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 import boxen from "boxen";
 import { select } from "@inquirer/prompts";
 import ora from "ora";
+import semver from "semver";
 import { colors } from "./utils.js";
 
+const CHECK_INTERVAL = 1000 * 60 * 60 * 4; // 4 小时检查一次
 const DISMISS_INTERVAL = 1000 * 60 * 60 * 24; // 24 小时后再次提示
 const CACHE_FILE = ".gw-update-check";
 
 interface UpdateCache {
+  lastCheck?: number; // 上次检查更新的时间
   lastDismiss?: number; // 用户上次关闭提示的时间
-  latestVersion?: string;
+  latestVersion?: string; // 最新版本号
+  checkedVersion?: string; // 检查时的当前版本
 }
 
 /**
- * 检查是否有新版本
+ * 检查是否有新版本（异步静默检查）
+ * @param currentVersion 当前版本
+ * @param packageName 包名
+ * @param interactive 是否交互式（true: 显示完整提示并可选择更新，false: 只显示简单提示）
  */
 export async function checkForUpdates(
   currentVersion: string,
-  packageName: string = "@zjex/git-workflow"
+  packageName: string = "@zjex/git-workflow",
+  interactive: boolean = false
 ): Promise<void> {
   try {
-    // 读取缓存
     const cache = readCache();
     const now = Date.now();
 
-    // 如果用户在 24 小时内关闭过提示，跳过
-    if (cache?.lastDismiss && now - cache.lastDismiss < DISMISS_INTERVAL) {
-      return;
-    }
+    // 1. 先检查缓存中是否有新版本需要提示
+    if (cache?.latestVersion && cache.checkedVersion === currentVersion) {
+      // 如果用户在 24 小时内关闭过提示，跳过
+      if (cache.lastDismiss && now - cache.lastDismiss < DISMISS_INTERVAL) {
+        // 继续后台检查（不阻塞）
+        backgroundCheck(currentVersion, packageName);
+        return;
+      }
+
+      // 使用 semver 比较版本
+      if (semver.gt(cache.latestVersion, currentVersion)) {
+        if (interactive) {
+          // 交互式模式：显示完整提示，可选择更新
+          const action = await showUpdateMessage(
+            currentVersion,
+            cache.latestVersion,
+            packageName
+          );
 
-    // 获取最新版本
-    const latestVersion = await getLatestVersion(packageName);
-
-    // 如果有新版本，显示提示
-    if (latestVersion && latestVersion !== currentVersion) {
-      const action = await showUpdateMessage(
-        currentVersion,
-        latestVersion,
-        packageName
-      );
-
-      if (action === "update") {
-        // 用户选择立即更新
-        await performUpdate(packageName);
-      } else if (action === "dismiss") {
-        // 用户选择跳过，记录时间
-        writeCache({ lastDismiss: now, latestVersion });
+          if (action === "update") {
+            await performUpdate(packageName);
+          } else if (action === "dismiss") {
+            writeCache({ ...cache, lastDismiss: now });
+          }
+        } else {
+          // 非交互式模式：只显示简单提示
+          showSimpleNotification(currentVersion, cache.latestVersion);
+        }
       }
-      // action === "continue" 时直接继续，不记录
     }
+
+    // 2. 后台异步检查更新（不阻塞当前命令）
+    backgroundCheck(currentVersion, packageName);
   } catch (error) {
     // 如果是用户按 Ctrl+C，重新抛出让全局处理
     if (error?.constructor?.name === "ExitPromptError") {
@@ -61,6 +76,37 @@ export async function checkForUpdates(
   }
 }
 
+/**
+ * 后台异步检查更新（不阻塞）
+ */
+function backgroundCheck(currentVersion: string, packageName: string): void {
+  const cache = readCache();
+  const now = Date.now();
+
+  // 如果距离上次检查不到 4 小时，跳过
+  if (cache?.lastCheck && now - cache.lastCheck < CHECK_INTERVAL) {
+    return;
+  }
+
+  // 使用 Promise 异步执行，不阻塞当前命令
+  Promise.resolve().then(async () => {
+    try {
+      const latestVersion = await getLatestVersion(packageName);
+
+      if (latestVersion) {
+        writeCache({
+          ...cache,
+          lastCheck: now,
+          latestVersion,
+          checkedVersion: currentVersion,
+        });
+      }
+    } catch {
+      // 静默失败
+    }
+  });
+}
+
 /**
  * 获取 npm 上的最新版本
  */
@@ -78,7 +124,29 @@ async function getLatestVersion(packageName: string): Promise<string | null> {
 }
 
 /**
- * 显示更新提示消息并让用户选择
+ * 显示简单的更新通知（非交互式，不阻塞）
+ */
+function showSimpleNotification(current: string, latest: string): void {
+  const message = `${colors.yellow("🎉 发现新版本")} ${colors.dim(
+    current
+  )} → ${colors.green(latest)}    ${colors.dim("运行")} ${colors.cyan(
+    "gw update"
+  )} ${colors.dim("更新")}`;
+
+  console.log("");
+  console.log(
+    boxen(message, {
+      padding: { top: 0, bottom: 0, left: 2, right: 2 },
+      margin: { top: 0, bottom: 1, left: 0, right: 0 },
+      borderStyle: "round",
+      borderColor: "yellow",
+      align: "center",
+    })
+  );
+}
+
+/**
+ * 显示更新提示消息并让用户选择（交互式）
  * @returns "update" | "continue" | "dismiss"
  */
 async function showUpdateMessage(
@@ -87,7 +155,7 @@ async function showUpdateMessage(
   packageName: string
 ): Promise<"update" | "continue" | "dismiss"> {
   const message = [
-    colors.bold("� 发现新版新本可用！"),
+    colors.yellow(colors.bold("🎉 发现新版本！")),
     "",
     `${colors.dim(current)}  →  ${colors.green(colors.bold(latest))}`,
   ].join("\n");
@@ -95,11 +163,12 @@ async function showUpdateMessage(
   console.log("");
   console.log(
     boxen(message, {
-      padding: 1,
+      padding: { top: 1, bottom: 1, left: 3, right: 3 },
       margin: 1,
       borderStyle: "round",
       borderColor: "yellow",
-      align: "left",
+      align: "center",
+      width: 40,
     })
   );
 
@@ -152,20 +221,25 @@ async function performUpdate(packageName: string): Promise<void> {
     });
 
     spinner.succeed(colors.green("更新成功！"));
+
+    // 清理缓存文件
+    clearUpdateCache();
+
     console.log("");
     console.log(
       boxen(
         [
-          colors.bold("✨ 更新完成！"),
+          colors.green(colors.bold("✨ 更新完成！")),
           "",
           colors.dim("请重新打开终端使用新版本"),
         ].join("\n"),
         {
-          padding: 1,
+          padding: { top: 1, bottom: 1, left: 3, right: 3 },
           margin: { top: 0, bottom: 1, left: 2, right: 2 },
           borderStyle: "round",
           borderColor: "green",
-          align: "left",
+          align: "center",
+          width: 40,
         }
       )
     );
@@ -181,6 +255,20 @@ async function performUpdate(packageName: string): Promise<void> {
   }
 }
 
+/**
+ * 清理更新缓存文件
+ */
+export function clearUpdateCache(): void {
+  try {
+    const cacheFile = join(homedir(), CACHE_FILE);
+    if (existsSync(cacheFile)) {
+      unlinkSync(cacheFile);
+    }
+  } catch {
+    // 静默失败
+  }
+}
+
 /**
  * 读取缓存
  */