fix: 修复 Docker 镜像删除时的 401 认证错误

- 改用 JWT Token 认证方式（推荐用于 Access Token）
- 添加 Basic Auth 降级方案（适用于密码）
- 改进 Token 提取逻辑，支持多种格式
- 添加详细的错误提示（401、403 等）
- 更新文档，说明如何配置 Docker Hub Access Token 权限

.github/workflows/docker-build.yml

@@ -91,10 +91,36 @@ jobs:
           
           echo "正在删除 Docker 镜像: ${IMAGE_NAME}:${TAG_NAME}"
           
-          # 使用 Docker Hub API v2 删除镜像标签
-          RESPONSE=$(curl -s -w "\n%{http_code}" -X DELETE \
-            -u "${DOCKER_USERNAME}:${DOCKER_PASSWORD}" \
-            "https://hub.docker.com/v2/repositories/${IMAGE_NAME}/tags/${TAG_NAME}/")
+          # 方法 1: 尝试使用 JWT Token 认证（推荐，适用于 Access Token）
+          # 获取 JWT Token
+          echo "正在获取 Docker Hub JWT Token..."
+          TOKEN_RESPONSE=$(curl -s -X POST \
+            -H "Content-Type: application/json" \
+            -d "{\"username\": \"${DOCKER_USERNAME}\", \"password\": \"${DOCKER_PASSWORD}\"}" \
+            "https://hub.docker.com/v2/users/login/")
+          
+          # 提取 Token（支持多种格式）
+          TOKEN=$(echo "$TOKEN_RESPONSE" | grep -oE '"token":"[^"]*"' | head -1 | cut -d'"' -f4)
+          
+          if [ -z "$TOKEN" ]; then
+            # 尝试另一种提取方式
+            TOKEN=$(echo "$TOKEN_RESPONSE" | python3 -c "import sys, json; print(json.load(sys.stdin).get('token', ''))" 2>/dev/null || echo "")
+          fi
+          
+          if [ -n "$TOKEN" ] && [ "$TOKEN" != "null" ]; then
+            echo "✅ 成功获取 JWT Token，使用 JWT Token 认证"
+            # 使用 JWT Token 删除镜像标签
+            RESPONSE=$(curl -s -w "\n%{http_code}" -X DELETE \
+              -H "Authorization: JWT ${TOKEN}" \
+              "https://hub.docker.com/v2/repositories/${IMAGE_NAME}/tags/${TAG_NAME}/")
+          else
+            echo "⚠️  JWT Token 获取失败，尝试使用 Basic Auth"
+            echo "   如果继续失败，请检查 DOCKER_USERNAME 和 DOCKER_PASSWORD 是否正确"
+            # 方法 2: 使用 Basic Auth（适用于密码）
+            RESPONSE=$(curl -s -w "\n%{http_code}" -X DELETE \
+              -u "${DOCKER_USERNAME}:${DOCKER_PASSWORD}" \
+              "https://hub.docker.com/v2/repositories/${IMAGE_NAME}/tags/${TAG_NAME}/")
+          fi
           
           HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
           BODY=$(echo "$RESPONSE" | head -n-1)
@@ -103,6 +129,20 @@ jobs:
             echo "✅ 成功删除 Docker 镜像标签: ${IMAGE_NAME}:${TAG_NAME}"
           elif [ "$HTTP_CODE" = "404" ]; then
             echo "⚠️  镜像标签不存在: ${IMAGE_NAME}:${TAG_NAME}，可能已被删除或不存在"
+          elif [ "$HTTP_CODE" = "401" ]; then
+            echo "❌ 认证失败 (HTTP 401): 未授权"
+            echo "   请检查以下内容："
+            echo "   1. DOCKER_USERNAME 和 DOCKER_PASSWORD 是否正确"
+            echo "   2. 如果使用 Access Token，确保有删除镜像的权限"
+            echo "   3. 访问令牌是否过期"
+            echo "   响应详情: $BODY"
+            exit 1
+          elif [ "$HTTP_CODE" = "403" ]; then
+            echo "❌ 权限不足 (HTTP 403): 没有删除镜像的权限"
+            echo "   请确保 Docker Hub 访问令牌具有以下权限："
+            echo "   - Delete repository tags"
+            echo "   响应详情: $BODY"
+            exit 1
           else
             echo "❌ 删除失败 (HTTP $HTTP_CODE): $BODY"
             exit 1

docs/VERSION_MANAGEMENT.md

@@ -20,12 +20,29 @@
 在 GitHub 仓库设置中添加以下 Secrets：
 
 - `DOCKER_USERNAME`: Docker Hub 用户名（例如：`wrbug`）
-- `DOCKER_PASSWORD`: Docker Hub 密码或访问令牌
+- `DOCKER_PASSWORD`: Docker Hub 访问令牌（推荐）或密码
 
 **设置步骤**：
-1. 访问 GitHub 仓库 → Settings → Secrets and variables → Actions
-2. 点击 "New repository secret"
-3. 添加 `DOCKER_USERNAME` 和 `DOCKER_PASSWORD`
+
+1. **创建 Docker Hub Access Token**（推荐）：
+   - 访问：https://hub.docker.com/settings/security
+   - 点击 "New Access Token"
+   - 填写描述（如：`GitHub Actions PolyHermes`）
+   - **重要**：勾选以下权限：
+     - ✅ `Read & Write`（用于推送镜像）
+     - ✅ `Delete repository tags`（用于删除镜像）
+   - 点击 "Generate"
+   - **立即复制令牌**（只显示一次）
+
+2. **在 GitHub 中添加 Secrets**：
+   - 访问 GitHub 仓库 → Settings → Secrets and variables → Actions
+   - 点击 "New repository secret"
+   - 添加 `DOCKER_USERNAME`：你的 Docker Hub 用户名
+   - 添加 `DOCKER_PASSWORD`：刚才创建的 Access Token（不是密码）
+
+**注意**：
+- ⚠️ 如果使用密码而不是 Access Token，删除镜像功能可能无法正常工作
+- ✅ 推荐使用 Access Token，并确保有 `Delete repository tags` 权限
 
 ### 2. 创建 Release（必须通过 GitHub Releases 页面）
 
@@ -151,11 +168,38 @@ VITE_APP_GITHUB_REPO_URL=https://github.com/WrBug/PolyHermes
 ### Q5: 删除 release 后 Docker 镜像没有被删除？
 
 **A:** 检查以下几点：
-1. 确认版本号格式为 `v数字.数字.数字`（例如：`v1.0.0`）
+1. 确认版本号格式为 `v数字.数字.数字` 或 `v数字.数字.数字-后缀`（例如：`v1.0.0`, `v1.0.0-beta`）
 2. 确认 Docker Hub 凭证（`DOCKER_USERNAME` 和 `DOCKER_PASSWORD`）正确配置
-3. 确认 Docker Hub 访问令牌有删除镜像的权限
-4. 查看 GitHub Actions 日志，确认删除操作是否执行
-5. 如果镜像标签不存在，会显示警告但不会失败（这是正常的）
+3. **确认 Docker Hub 访问令牌有删除镜像的权限**：
+   - 如果使用 Access Token，需要确保有 `Delete repository tags` 权限
+   - 访问 Docker Hub → Account Settings → Security → Access Tokens
+   - 创建或编辑访问令牌，确保勾选 `Delete repository tags` 权限
+4. 如果遇到 401 错误，可能是：
+   - 访问令牌过期，需要重新生成
+   - 访问令牌权限不足，需要添加删除权限
+   - 用户名或密码/令牌错误
+5. 查看 GitHub Actions 日志，确认删除操作是否执行
+6. 如果镜像标签不存在，会显示警告但不会失败（这是正常的）
+
+### Q7: 删除镜像时遇到 401 未授权错误？
+
+**A:** 这通常是因为认证失败，请检查：
+
+1. **如果使用 Access Token**：
+   - 确保访问令牌未过期
+   - 确保访问令牌有 `Delete repository tags` 权限
+   - 在 Docker Hub → Account Settings → Security → Access Tokens 中检查权限
+
+2. **如果使用密码**：
+   - 确保用户名和密码正确
+   - 如果启用了 2FA，需要使用 Access Token 而不是密码
+
+3. **创建新的 Access Token**：
+   - 访问：https://hub.docker.com/settings/security
+   - 点击 "New Access Token"
+   - 填写描述（如：`GitHub Actions Delete Images`）
+   - **重要**：勾选 `Delete repository tags` 权限
+   - 复制生成的令牌，更新 GitHub Secrets 中的 `DOCKER_PASSWORD`
 
 ### Q6: 版本号格式要求是什么？