@zjex/git-workflow 0.3.9 → 0.4.0

package/docs/commands/branch.md

@@ -8,7 +8,7 @@
 | ------------------------------ | ----------------- | ----------------- |
 | `gw feature [--base <branch>]` | `gw feat`, `gw f` | 创建 feature 分支 |
 | `gw hotfix [--base <branch>]`  | `gw fix`, `gw h`  | 创建 hotfix 分支  |
-| `gw delete [branch]`           | `gw del`, `gw d`  | 删除本地/远程分支 |
+| `gw br:del [branch]`           | `gw brd`          | 删除本地/远程分支 |
 
 ## ✨ 创建 Feature 分支
 
@@ -55,11 +55,13 @@ gw f --base release/1.0
 ### 分支命名规范
 
 **生成格式：**
+
 ```
 feature/YYYYMMDD-[ID-]description
 ```
 
 **示例：**
+
 ```bash
 # 有 ID 的情况
 feature/20260111-PROJ-123-add-user-login
@@ -69,6 +71,7 @@ feature/20260111-add-user-login
 ```
 
 **命名优势：**
+
 - 📅 **时间排序** - 按创建日期自然排序
 - 🔍 **易于搜索** - 可以按日期或 ID 快速查找
 - 📋 **可追溯性** - 每个分支都能追溯到具体需求
@@ -90,6 +93,7 @@ gw f
 ```
 
 选择"是"后：
+
 ```bash
 ✔ 更改已暂存到 stash
 ✔ 分支创建成功: feature/20260111-PROJ-123-add-login
@@ -121,12 +125,14 @@ gw h
 ### Hotfix 特点
 
 **与 Feature 分支的区别：**
+
 - 🚨 **紧急性** - 用于紧急修复生产环境问题
 - 🎯 **基础分支** - 通常基于 `main` 分支创建
 - 🔄 **合并策略** - 需要同时合并到 `main` 和 `develop`
 - 📝 **ID 标签** - 默认提示 "Issue ID" 而不是 "Story ID"
 
 **典型使用场景：**
+
 - 生产环境 Bug 修复
 - 安全漏洞修复
 - 关键功能故障修复
@@ -137,16 +143,15 @@ gw h
 ### 基本用法
 
 ```bash
-gw d
+gw brd
 # 或
-gw delete
-gw del
+gw br:del
 ```
 
 ### 交互式选择
 
 ```bash
-gw d
+gw brd
 ? 选择要删除的分支:
 ❯ feature/20260105-PROJ-100-old-feature (本地+远程) 3 days ago
   feature/20260103-test-branch (仅本地) 5 days ago
@@ -155,6 +160,7 @@ gw d
 ```
 
 **分支信息说明：**
+
 - **分支名** - 完整的分支名称
 - **状态** - 显示是否存在远程分支
 - **时间** - 最后提交时间，按最近使用排序
@@ -187,7 +193,7 @@ gw d
 
 ```bash
 # 直接删除指定分支
-gw d feature/old-branch
+gw brd feature/old-branch
 
 # 系统会自动检测并询问是否删除远程分支
 ```
@@ -197,7 +203,7 @@ gw d feature/old-branch
 虽然不支持多选，但可以连续删除：
 
 ```bash
-gw d
+gw brd
 # 删除第一个分支后，会自动返回分支列表
 # 可以继续选择删除其他分支
 ```
@@ -205,12 +211,14 @@ gw d
 ### 安全保护
 
 **保护机制：**
+
 - 🛡️ **当前分支保护** - 不能删除当前所在的分支
 - 🛡️ **主分支保护** - 不会显示 main/master/develop 等主分支
 - 🛡️ **确认机制** - 删除前需要明确确认
 - 🛡️ **状态检查** - 显示分支的本地/远程状态
 
 **错误处理：**
+
 ```bash
 ❌ 无法删除分支: 当前正在使用此分支
 ❌ 远程分支删除失败: 权限不足
@@ -229,6 +237,7 @@ gw d
 ```
 
 **自定义前缀示例：**
+
 ```json
 {
   "featurePrefix": "feat",
@@ -237,6 +246,7 @@ gw d
 ```
 
 生成的分支名：
+
 ```
 feat/20260111-PROJ-123-add-login
 fix/20260111-BUG-456-fix-crash
@@ -253,6 +263,7 @@ fix/20260111-BUG-456-fix-crash
 ```
 
 **强制要求 ID：**
+
 ```json
 {
   "requireId": true
@@ -262,6 +273,7 @@ fix/20260111-BUG-456-fix-crash
 设置后，创建分支时必须填写 ID，不能跳过。
 
 **自定义 ID 标签：**
+
 ```json
 {
   "featureIdLabel": "Jira ID",
@@ -288,6 +300,7 @@ fix/20260111-BUG-456-fix-crash
 ```
 
 **配置选项：**
+
 - `true` - 创建分支后自动推送，不询问
 - `false` - 创建分支后不推送，不询问
 - 不设置 - 每次创建分支时询问（默认行为）
@@ -330,7 +343,7 @@ gw c
 # 4. 合并到 main 和 develop
 
 # 5. 删除 hotfix 分支
-gw d
+gw brd
 ```
 
 ### 场景三：实验性功能
@@ -343,7 +356,7 @@ gw f
 # 2. 实验开发...
 
 # 3. 如果实验失败，直接删除分支
-gw d
+gw brd
 # 选择实验分支删除
 ```
 
@@ -361,7 +374,7 @@ git push origin feature/20260111-PROJ-123-add-feature
 # 3. 创建 Pull Request 到 develop
 
 # 4. 代码审查通过后，删除本地分支
-gw d
+gw brd
 ```
 
 ## 🔧 高级技巧
@@ -388,7 +401,7 @@ gw f
 
 ```bash
 # 使用 Git Workflow 逐个删除
-gw d
+gw brd
 
 # 或使用 Git 命令批量删除已合并分支
 git branch --merged | grep -v "\*\|main\|develop" | xargs -n 1 git branch -d
@@ -409,6 +422,7 @@ git checkout -b recovered-branch <commit-hash>
 ### 问题一：分支名包含特殊字符
 
 **问题：**
+
 ```bash
 gw f
 ? 请输入描述: fix bug #123
@@ -416,6 +430,7 @@ gw f
 ```
 
 **解决方案：**
+
 - 避免使用 `#`, `@`, `空格` 等特殊字符
 - 使用 `-` 或 `_` 连接单词
 - 推荐格式：`fix-bug-123`
@@ -423,11 +438,13 @@ gw f
 ### 问题二：无法删除远程分支
 
 **问题：**
+
 ```bash
 ❌ 远程分支删除失败: 权限不足
 ```
 
 **解决方案：**
+
 1. 检查是否有推送权限
 2. 确认远程分支是否存在
 3. 手动删除：`git push origin --delete branch-name`
@@ -435,11 +452,13 @@ gw f
 ### 问题三：基础分支不存在
 
 **问题：**
+
 ```bash
 ❌ 基础分支 'develop' 不存在
 ```
 
 **解决方案：**
+
 1. 检查分支名是否正确
 2. 拉取远程分支：`git fetch origin develop:develop`
 3. 或使用其他基础分支：`gw f --base main`
@@ -447,11 +466,13 @@ gw f
 ### 问题四：分支已存在
 
 **问题：**
+
 ```bash
 ❌ 分支 'feature/20260111-PROJ-123-add-login' 已存在
 ```
 
 **解决方案：**
+
 1. 使用不同的描述
 2. 切换到现有分支：`git checkout feature/20260111-PROJ-123-add-login`
 3. 或删除现有分支后重新创建
@@ -465,4 +486,4 @@ gw f
 
 ---
 
-分支管理是 Git 工作流的基础，通过 Git Workflow 的分支命令，你可以轻松创建规范的分支名称，高效管理分支生命周期。
+分支管理是 Git 工作流的基础，通过 Git Workflow 的分支命令，你可以轻松创建规范的分支名称，高效管理分支生命周期。

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.9",
+	"version": "0.4.0",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {