@zjex/git-workflow 0.3.10 → 0.4.1

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` 重新配置