@zjex/git-workflow 0.3.10 → 0.4.0

package/docs/commands/index.md

@@ -6,27 +6,29 @@ Git Workflow 提供了一套简洁而强大的命令，涵盖了 Git 工作流
 
 ### 核心命令
 
-| 命令    | 别名              | 功能                 | 示例                    |
-| ------- | ----------------- | -------------------- | ----------------------- |
-| `gw`    | -                 | 显示交互式菜单       | `gw`                    |
-| `gw f`  | `feat`, `feature` | 创建 feature 分支    | `gw f --base develop`   |
-| `gw h`  | `fix`, `hotfix`   | 创建 hotfix 分支     | `gw h`                  |
-| `gw c`  | `cm`, `commit`    | 提交代码（AI 模式）  | `gw c`                  |
-| `gw log`| `ls`, `l`         | 查看提交历史         | `gw log`                |
-| `gw t`  | `tag`             | 创建 tag             | `gw t v`                |
-| `gw d`  | `del`, `delete`   | 删除分支             | `gw d feature/old`      |
-| `gw s`  | `st`, `stash`     | 管理 stash           | `gw s`                  |
+| 命令     | 别名              | 功能                | 示例                  |
+| -------- | ----------------- | ------------------- | --------------------- |
+| `gw`     | -                 | 显示交互式菜单      | `gw`                  |
+| `gw f`   | `feat`, `feature` | 创建 feature 分支   | `gw f --base develop` |
+| `gw h`   | `fix`, `hotfix`   | 创建 hotfix 分支    | `gw h`                |
+| `gw c`   | `cm`, `commit`    | 提交代码（AI 模式） | `gw c`                |
+| `gw log` | `ls`, `l`         | 查看提交历史        | `gw log`              |
+| `gw t`   | `tag`             | 创建 tag            | `gw t v`              |
+| `gw brd` | `br:del`          | 删除分支            | `gw brd feature/old`  |
+| `gw s`   | `st`, `stash`     | 管理 stash          | `gw s`                |
 
 ### 辅助命令
 
-| 命令     | 别名   | 功能                     | 示例      |
-| -------- | ------ | ------------------------ | --------- |
-| `gw r`   | `release` | 发布版本              | `gw r`    |
-| `gw ts`  | `tags` | 列出 tags                | `gw ts v` |
-| `gw td`  | `tag:delete` | 删除 tag           | `gw td`   |
-| `gw tu`  | `tag:update` | 修改 tag           | `gw tu`   |
-| `gw init`| -      | 初始化配置               | `gw init` |
-| `gw upt` | `update` | 更新工具               | `gw upt`  |
+| 命令      | 别名         | 功能               | 示例      |
+| --------- | ------------ | ------------------ | --------- |
+| `gw r`    | `release`    | 发布版本           | `gw r`    |
+| `gw ts`   | `tags`       | 列出 tags          | `gw ts v` |
+| `gw td`   | `tag:del`    | 删除 tag           | `gw td`   |
+| `gw tu`   | `tag:update` | 修改 tag           | `gw tu`   |
+| `gw tc`   | `tag:clean`  | 清理无效 tag       | `gw tc`   |
+| `gw init` | -            | 初始化配置         | `gw init` |
+| `gw upt`  | `update`     | 更新工具           | `gw upt`  |
+| `gw cc`   | `clean`      | 清理缓存和临时文件 | `gw cc`   |
 
 ## 🎯 使用模式
 
@@ -68,6 +70,7 @@ gw
 ```
 
 **特点：**
+
 - 🎨 优雅的 ASCII Art Logo
 - 📋 清晰的操作菜单
 - 🎯 键盘快捷操作
@@ -92,6 +95,7 @@ gw d
 ```
 
 **特点：**
+
 - ⚡️ 快速执行
 - 🤖 支持脚本化
 - 📝 支持参数传递
@@ -126,15 +130,15 @@ Git Workflow 使用颜色来区分不同类型的信息：
 
 所有交互界面都支持键盘操作：
 
-| 按键       | 功能                     |
-| ---------- | ------------------------ |
-| ↑/↓        | 上下选择选项             |
-| ←/→        | 左右切换（多选模式）     |
-| 空格       | 选择/取消选择（多选模式） |
-| 回车       | 确认选择                 |
-| Ctrl+C     | 优雅退出                 |
-| Tab        | 自动补全（输入模式）     |
-| Esc        | 取消当前操作             |
+| 按键   | 功能                      |
+| ------ | ------------------------- |
+| ↑/↓    | 上下选择选项              |
+| ←/→    | 左右切换（多选模式）      |
+| 空格   | 选择/取消选择（多选模式） |
+| 回车   | 确认选择                  |
+| Ctrl+C | 优雅退出                  |
+| Tab    | 自动补全（输入模式）      |
+| Esc    | 取消当前操作              |
 
 ## 🔧 全局选项
 
@@ -173,8 +177,8 @@ DEBUG=gw:* gw c
 专注于分支的创建、删除和管理：
 
 - [**gw f**](/commands/branch#创建-feature-分支) - 创建 feature 分支
-- [**gw h**](/commands/branch#创建-hotfix-分支) - 创建 hotfix 分支  
-- [**gw d**](/commands/branch#删除分支) - 删除本地/远程分支
+- [**gw h**](/commands/branch#创建-hotfix-分支) - 创建 hotfix 分支
+- [**gw brd**](/commands/branch#删除分支) - 删除本地/远程分支
 
 ### 提交管理
 
@@ -191,6 +195,7 @@ DEBUG=gw:* gw c
 - [**gw ts**](/commands/tag#列出-tags) - 列出所有标签
 - [**gw td**](/commands/tag#删除-tag) - 删除标签
 - [**gw tu**](/commands/tag#修改-tag) - 修改标签
+- [**gw tc**](/commands/tag#清理无效-tag) - 清理无效标签
 - [**gw r**](/commands/release) - 发布新版本
 
 ### 代码暂存
@@ -205,7 +210,7 @@ DEBUG=gw:* gw c
 
 - [**gw init**](/commands/config) - 初始化配置
 - [**gw upt**](/commands/update) - 更新工具
-- [**gw clean**](/commands/update#清理缓存) - 清理缓存
+- [**gw cc**](/commands/update#清理缓存) - 清理缓存和临时文件
 
 ## 🚀 快速参考
 
@@ -290,7 +295,7 @@ gw d
 - **我想提交代码** → `gw c` (commit)
 - **我想查看历史** → `gw log` (log)
 - **我想创建版本** → `gw t` (tag) 或 `gw r` (release)
-- **我想删除分支** → `gw d` (delete)
+- **我想删除分支** → `gw brd` (branch delete)
 - **我想管理 stash** → `gw s` (stash)
 - **我想配置工具** → `gw init`
 - **我想更新工具** → `gw upt`
@@ -302,7 +307,7 @@ gw d
 - **提交当前更改** → `gw c`
 - **查看项目历史** → `gw log`
 - **发布新版本** → `gw r` + `gw t`
-- **清理旧分支** → `gw d`
+- **清理旧分支** → `gw brd`
 - **暂存当前工作** → `gw s`
 
 ### 交互式查找
@@ -316,4 +321,4 @@ gw
 
 ---
 
-掌握这些命令后，你就能高效地管理 Git 工作流了。每个命令都经过精心设计，旨在简化复杂的 Git 操作，让你专注于代码开发。
+掌握这些命令后，你就能高效地管理 Git 工作流了。每个命令都经过精心设计，旨在简化复杂的 Git 操作，让你专注于代码开发。

package/docs/commands/tag.md

@@ -4,12 +4,13 @@ Tag 管理相关的命令详解。
 
 ## 📋 命令列表
 
-| 命令 | 别名 | 说明 |
-|------|------|------|
-| `gw tags [prefix]` | `gw ts` | 列出 tag |
-| `gw tag [prefix]` | `gw t` | 创建 tag |
-| `gw tag:delete` | `gw td` | 删除 tag |
-| `gw tag:update` | `gw tu` | 修改 tag |
+| 命令               | 别名    | 说明         |
+| ------------------ | ------- | ------------ |
+| `gw tags [prefix]` | `gw ts` | 列出 tag     |
+| `gw tag [prefix]`  | `gw t`  | 创建 tag     |
+| `gw tag:del`       | `gw td` | 删除 tag     |
+| `gw tag:update`    | `gw tu` | 修改 tag     |
+| `gw tag:clean`     | `gw tc` | 清理无效 tag |
 
 ## 📋 列出 Tag
 
@@ -32,7 +33,7 @@ $ gw ts
 📋 所有 tags (按时间倒序):
 
 v1.2.0    Release v1.2.0    2 days ago
-v1.1.0    Release v1.1.0    1 week ago  
+v1.1.0    Release v1.1.0    1 week ago
 v1.0.0    Initial release   2 weeks ago
 
 共 3 个 tags
@@ -139,23 +140,78 @@ $ gw tu
 ✔ 已推送到远程
 ```
 
+## 🧹 清理无效 Tag
+
+### 基本用法
+
+```bash
+gw tag:clean
+gw tc
+```
+
+### 什么是无效 Tag
+
+无效 tag 是指那些不包含有效版本号的标签，通常是由于脚本错误或配置问题产生的，例如：
+
+- `vnull` - 版本号为 null
+- `vundefined` - 版本号为 undefined
+- `v` - 空版本号
+- 其他不符合版本规范的标签
+
+### 清理流程
+
+```bash
+$ gw tc
+🧹 清理无效 tag
+
+检测到以下无效 tag:
+
+vnull
+  提交: abc1234 (2 days ago)
+  作者: John Doe
+  消息: Release vnull
+
+vundefined
+  提交: def5678 (1 week ago)
+  作者: Jane Smith
+  消息: Release vundefined
+
+? 是否删除这些无效 tag?
+❯ 是，删除本地和远程
+  取消
+
+✔ 本地 tag 已删除: vnull
+✔ 远程 tag 已删除: origin/vnull
+✔ 本地 tag 已删除: vundefined
+✔ 远程 tag 已删除: origin/vundefined
+
+✔ 已清理 2 个无效 tag
+```
+
+### 安全性
+
+- 只会删除明确不包含数字的标签
+- 删除前会显示详细信息供确认
+- 支持仅删除本地或同时删除远程
+- 不会影响正常的版本标签
+
 ## 🔧 版本类型详解
 
 ### 标准版本
 
-| 类型 | 说明 | 示例 |
-|------|------|------|
+| 类型    | 说明               | 示例          |
+| ------- | ------------------ | ------------- |
 | `patch` | 补丁版本，Bug 修复 | 1.0.0 → 1.0.1 |
-| `minor` | 次版本，新功能 | 1.0.0 → 1.1.0 |
+| `minor` | 次版本，新功能     | 1.0.0 → 1.1.0 |
 | `major` | 主版本，破坏性变更 | 1.0.0 → 2.0.0 |
 
 ### 预发布版本
 
-| 类型 | 说明 | 示例 |
-|------|------|------|
+| 类型    | 说明       | 示例                  |
+| ------- | ---------- | --------------------- |
 | `alpha` | 内部测试版 | 1.0.0 → 1.0.1-alpha.1 |
-| `beta` | 公开测试版 | 1.0.0 → 1.0.1-beta.1 |
-| `rc` | 发布候选版 | 1.0.0 → 1.0.1-rc.1 |
+| `beta`  | 公开测试版 | 1.0.0 → 1.0.1-beta.1  |
+| `rc`    | 发布候选版 | 1.0.0 → 1.0.1-rc.1    |
 
 ### 预发布版本升级
 
@@ -275,4 +331,4 @@ gw tag
 1.0.0-beta.2   → 修复反馈
 1.0.0-rc.1     → 发布候选
 1.0.0          → 正式发布
-```
+```

package/docs/commands/update.md

@@ -4,9 +4,10 @@
 
 ## 📋 命令概览
 
-| 命令 | 别名 | 说明 |
-|------|------|------|
+| 命令        | 别名     | 说明                 |
+| ----------- | -------- | -------------------- |
 | `gw update` | `gw upt` | 检查并更新到最新版本 |
+| `gw clean`  | `gw cc`  | 清理缓存和临时文件   |
 
 ## 🔄 版本更新
 
@@ -344,4 +345,79 @@ diff ~/.gwrc.json.backup ~/.gwrc.json
 # 监控版本状态
 gw --version
 gw update --check-only  # 仅检查，不更新
-```
+```
+
+## 🧹 清理缓存
+
+### 基本用法
+
+```bash
+gw clean
+gw cc
+```
+
+### 清理内容
+
+工具会清理以下文件：
+
+1. **更新缓存** - `~/.gw-update-check`
+2. **全局配置** - `~/.gwrc.json` (可选)
+3. **临时文件** - `/tmp/.gw-commit-msg-*`
+
+### 清理流程
+
+```bash
+$ gw clean
+? 检测到全局配置文件，是否删除？
+❯ 否，保留配置文件
+  是，删除配置文件
+
+✔ 已清理 3 个文件
+```
+
+### 删除全局配置
+
+如果选择删除全局配置文件：
+
+```bash
+$ gw clean
+? 检测到全局配置文件，是否删除？
+❯ 是，删除配置文件
+
+✔ 已清理 5 个文件
+
+⚠️  全局配置文件已删除
+   如需重新配置，请运行: gw init
+```
+
+### 使用场景
+
+**定期清理：**
+
+```bash
+# 清理缓存，释放空间
+gw clean
+```
+
+**重置配置：**
+
+```bash
+# 删除配置后重新初始化
+gw clean  # 选择删除配置
+gw init   # 重新配置
+```
+
+**故障排除：**
+
+```bash
+# 清理缓存解决更新检查问题
+gw clean
+gw update
+```
+
+### 安全性
+
+- 删除全局配置前会询问确认
+- 不会删除项目级配置文件
+- 不会影响 Git 仓库数据
+- 可以随时通过 `gw init` 重新配置

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.3.10",
+	"version": "0.4.0",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {

package/src/commands/tag.ts

@@ -624,3 +624,123 @@ export async function updateTag(): Promise<void> {
     }
   }
 }
+
+/**
+ * 清理无效标签（不包含数字的标签）
+ */
+export async function cleanInvalidTags(): Promise<void> {
+  const fetchSpinner = ora("正在获取 tags...").start();
+  exec("git fetch --tags", true);
+  fetchSpinner.stop();
+
+  divider();
+
+  // 获取所有标签
+  const allTags = execOutput("git tag -l").split("\n").filter(Boolean);
+
+  // 过滤出无效标签（不包含数字）
+  const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+  if (invalidTags.length === 0) {
+    console.log(colors.green("✅ 没有找到无效标签"));
+    return;
+  }
+
+  console.log(colors.yellow(`❌ 找到 ${invalidTags.length} 个无效标签：`));
+  console.log("");
+
+  // 显示每个无效标签的详细信息
+  for (const tag of invalidTags) {
+    try {
+      const commitHash = execOutput(`git rev-list -n 1 "${tag}"`).trim();
+      const commitDate = execOutput(`git log -1 --format=%ai "${tag}"`).trim();
+      const commitMsg = execOutput(`git log -1 --format=%s "${tag}"`).trim();
+
+      console.log(colors.red(`  标签: ${tag}`));
+      console.log(colors.dim(`    Commit: ${commitHash}`));
+      console.log(colors.dim(`    日期: ${commitDate}`));
+      console.log(colors.dim(`    消息: ${commitMsg}`));
+      console.log("");
+    } catch {
+      console.log(colors.red(`  标签: ${tag}`));
+      console.log(colors.dim(`    (无法获取提交信息)`));
+      console.log("");
+    }
+  }
+
+  divider();
+
+  const shouldClean = await select({
+    message: "是否删除这些无效标签？",
+    choices: [
+      { name: "是，删除所有无效标签", value: true },
+      { name: "否，取消操作", value: false },
+    ],
+    theme,
+  });
+
+  if (!shouldClean) {
+    console.log(colors.yellow("已取消"));
+    return;
+  }
+
+  divider();
+
+  // 删除本地标签
+  const localSpinner = ora("正在删除本地无效标签...").start();
+  let localSuccess = 0;
+  let localFailed = 0;
+
+  for (const tag of invalidTags) {
+    try {
+      execSync(`git tag -d "${tag}"`, { stdio: "pipe" });
+      localSuccess++;
+    } catch {
+      localFailed++;
+    }
+  }
+
+  if (localFailed === 0) {
+    localSpinner.succeed(`本地标签已删除: ${localSuccess} 个`);
+  } else {
+    localSpinner.warn(
+      `本地标签删除: 成功 ${localSuccess} 个，失败 ${localFailed} 个`
+    );
+  }
+
+  // 询问是否删除远程标签
+  const deleteRemote = await select({
+    message: "是否同时删除远程的无效标签？",
+    choices: [
+      { name: "是", value: true },
+      { name: "否", value: false },
+    ],
+    theme,
+  });
+
+  if (deleteRemote) {
+    const remoteSpinner = ora("正在删除远程无效标签...").start();
+    let remoteSuccess = 0;
+    let remoteFailed = 0;
+
+    for (const tag of invalidTags) {
+      try {
+        execSync(`git push origin --delete "${tag}"`, { stdio: "pipe" });
+        remoteSuccess++;
+      } catch {
+        remoteFailed++;
+      }
+    }
+
+    if (remoteFailed === 0) {
+      remoteSpinner.succeed(`远程标签已删除: ${remoteSuccess} 个`);
+    } else {
+      remoteSpinner.warn(
+        `远程标签删除: 成功 ${remoteSuccess} 个，失败 ${remoteFailed} 个`
+      );
+    }
+  }
+
+  console.log("");
+  console.log(colors.green("✨ 清理完成！"));
+}