From 3b8671d22db06002c7a0a4a22a8fe8d228858e43 Mon Sep 17 00:00:00 2001
From: GwWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Fri, 2 Jan 2026 13:32:35 +0800
Subject: [PATCH] =?UTF-8?q?chore(workflow):=20=E4=BC=98=E5=8C=96=E8=87=AA?=
 =?UTF-8?q?=E5=8A=A8=E6=A0=87=E7=AD=BE=E5=92=8C=E5=8F=91=E5=B8=83=E5=B7=A5?=
 =?UTF-8?q?=E4=BD=9C=E6=B5=81=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 调整 auto-tag 工作流触发条件，仅在 push 事件时执行
- 添加并发控制组配置避免重复执行
- 优化标签版本获取逻辑，使用 git tag 命令替代 describe
- 修复版本号解析方式，使用 IFS 分割替代 cut 命令
- 添加标签存在性检查，避免重复创建相同标签
- 为 publish 工作流添加详细功能注释和说明
- 优化 NuGet 包推送步骤的描述信息
- 改进 GitHub Release 创建和资产上传的注释说明
---
 .github/workflows/auto-tag.yml | 29 ++++++++++++++++-------------
 .github/workflows/publish.yml  | 24 ++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/auto-tag.yml b/.github/workflows/auto-tag.yml
index ef73d08..f17bc15 100644
--- a/.github/workflows/auto-tag.yml
+++ b/.github/workflows/auto-tag.yml
@@ -6,16 +6,17 @@ name: Auto Increment Version and Tag
 on:
   push:
     branches: [ main, master ]
-  pull_request:
-    branches: [ main, master ]
-    types: [ closed ]
-
+    tags-ignore:
+      - '*'
+concurrency:
+  group: auto-tag-main
+  cancel-in-progress: false
 jobs:
   auto-tag:
     name: Auto Increment Version and Create Tag
     runs-on: ubuntu-latest
     # 条件判断：仅在推送事件或已合并的 PR 关闭事件中执行
-    if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.action == 'closed' && github.event.pull_request.merged == true)
+    if: github.event_name == 'push'
     permissions:
       contents: write
     
@@ -68,16 +69,14 @@ jobs:
         if: steps.check_skip.outputs.skip_tag == 'false'
         run: |
           # 获取最新的标签版本号，如果没有标签则默认为 0.0.0
-          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
-          
-          # 移除可能存在的 v 前缀
+          LATEST_TAG=$(git tag --list "v*" --sort=-v:refname | head -n 1)
+          LATEST_TAG=${LATEST_TAG:-v0.0.0}
+           # 移除可能存在的 v 前缀
           VERSION_NUM=${LATEST_TAG#v}
           
           # 解析主版本号、次版本号和修订号
-          MAJOR=$(echo $VERSION_NUM | cut -d. -f1)
-          MINOR=$(echo $VERSION_NUM | cut -d. -f2)
-          PATCH=$(echo $VERSION_NUM | cut -d. -f3)
-          
+          IFS=. read MAJOR MINOR PATCH <<< "$VERSION_NUM"
+          unset IFS
           # 递增修订号
           PATCH=$((PATCH + 1))
           
@@ -105,7 +104,10 @@ jobs:
           set -e
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
-
+          if git show-ref --tags --verify --quiet "refs/tags/$NEW_TAG"; then
+            echo "Tag $NEW_TAG already exists, skipping"
+            exit 0
+          fi
           echo "Creating annotated tag $NEW_TAG"
           git tag -a "$NEW_TAG" -m "Auto-generated tag: $NEW_TAG"
 
@@ -126,3 +128,4 @@ jobs:
         if: steps.check_skip.outputs.skip_tag == 'true'
         run: |
           echo "Tag creation skipped due to commit message containing skip keyword"
+
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index e3319b5..3b32b86 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -1,3 +1,8 @@
+# 发布工作流（NuGet + GitHub Release）
+# 
+# 功能：当推送标签时自动构建、打包并发布到 NuGet.org 和 GitHub Release
+# 触发条件：推送任何标签（如 v1.0.0 或 1.0.0）
+# 权限：允许写入内容、包和使用 OIDC 身份验证
 name: Publish (NuGet + GitHub Release)
 
 # 触发：推送 tag 时触发（例如 v1.0.0 或 1.0.0）
@@ -43,6 +48,9 @@ jobs:
       - name: Restore dependencies
         run: dotnet restore
       
+      # 从 GitHub 引用中提取标签版本
+      # 提取逻辑：去除 refs/tags/ 前缀，然后去除 v/V 前缀
+      # 输出：version - 处理后的版本号
       - name: Determine tag version
         id: tag_version
         run: |
@@ -69,6 +77,9 @@ jobs:
         with:
           user: ${{ secrets.NUGET_USER }} # 推荐将用户名放 secrets
 
+      # 将所有生成的包推送到 nuget.org
+      # 使用临时 API 密钥进行身份验证
+      # 跳过重复包的上传
       - name: Push all packages to nuget.org
         env:
           NUGET_API_KEY: ${{ steps.nuget_login.outputs.NUGET_API_KEY }}
@@ -89,6 +100,12 @@ jobs:
             echo "No packages found to push."
           fi
 
+      # 从 .nupkg 文件中提取版本信息
+      # 通过解压 .nupkg（zip 格式）并读取 .nuspec 文件来获取版本
+      # 输出：
+      #   package_file - 第一个找到的包文件路径
+      #   package_basename - 包文件的基本名称
+      #   version - 从 nuspec 中解析出的版本号
       - name: Get Version and First Package Path
         id: get_version
         run: |
@@ -109,6 +126,9 @@ jobs:
           echo "package_basename=$BASENAME" >> $GITHUB_OUTPUT
           echo "version=$VERSION" >> $GITHUB_OUTPUT
 
+      # 创建 GitHub Release
+      # 使用从包中提取的版本信息和当前标签创建发布
+      # 发布包含描述信息和版本详情
       - name: Create GitHub Release
         id: create_release
         uses: actions/create-release@v1
@@ -121,6 +141,9 @@ jobs:
           draft: false
           prerelease: false
 
+      # 使用 curl 将所有 .nupkg 文件上传到 GitHub Release
+      # 从 create-release 步骤获取上传 URL 并移除模板部分
+      # 每个包文件作为资产上传到发布中
       - name: Upload all .nupkg to Release (curl)
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -144,3 +167,4 @@ jobs:
               echo "Uploaded $basename"
             fi
           done
+