feat: 重構清理舊版成品

.gitea/workflows/master.yaml

@@ -3,26 +3,28 @@ on:
     branches:
     - master
 jobs:
-  cd:
+  version:
-    name: "CD > 發布專案"
+    name: "CD > 計算版本號"
-    runs-on: docker
+    runs-on: ubuntu
-    env:
+    outputs:
-      RUNNER_TOOL_CACHE: /toolcache
+      version: ${{ steps.version.outputs.version }}
     steps:
     - name: 計算版本號
       id: version
       uses: https://gitea.jsc.idv.tw/actions/calculate-version@${{ vars.ACTION_CALCULATE_VERSION }}
-      with:
+  release:
-        gitea-server: ${{ gitea.server_url }}
+    name: "CD > 發布專案"
-        repository: ${{ gitea.repository }}
+    runs-on: ubuntu
-        token: ${{ secrets.GITEA_TOKEN }}
+    needs: version
+    steps:
     - name: 發布專案
       uses: akkuman/gitea-release-action@${{ vars.ACTION_RELEASE_VERSION }}
       with:
-        tag_name: "v${{ steps.version.outputs.VERSION }}"
+        tag_name: "v${{ needs.version.outputs.version }}"
-    - name: 清理舊版本 (保留最新2個)
+  test:
-      uses: https://gitea.jsc.idv.tw/actions/cleanup-release@${{ vars.ACTION_CLEANUP_RELEASE_VERSION }}
+    name: "CD > 清理舊版成品"
-      with:
+    runs-on: ubuntu
-        gitea-server: ${{ gitea.server_url }}
+    needs: release
-        repository: ${{ gitea.repository }}
+    steps:
-        token: ${{ secrets.GITEA_TOKEN }}
+    - name: 清理舊版成品
+      uses: https://gitea.jsc.idv.tw/actions/cleanup-release@${{ vars.ACTION_CLEANUP_RELEASE_VERSION }}

Dockerfile

@@ -1,11 +1,11 @@
-FROM alpine:3.21
+FROM alpine:latest
 
-RUN apk add --no-cache bash curl jq
+# 更新並安裝必要的工具
-
+RUN apk update \
-COPY cleanup-releases.sh /cleanup-releases.sh
+    && apk add --no-cache bash curl jq
-COPY cleanup-images.sh /cleanup-images.sh
+    
 COPY entrypoint.sh /entrypoint.sh
 
-RUN chmod +x /cleanup-releases.sh /cleanup-images.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
 
-ENTRYPOINT ["/entrypoint.sh"]
+ENTRYPOINT ["/entrypoint.sh"]

action.yml

@@ -1,34 +1,15 @@
-name: 'Cleanup Old Releases'
+name: 'CLEANUP OLD RELEASES'
-description: '自動清理舊版本的 releases，保留指定數量的最新版本'
+description: '清理舊版成品'
+author: 'Jeffery'
 inputs:
-  gitea-server:
+  KEEP_COUNT:
-    description: 'Gitea 伺服器 URL'
+    description: '保留的版本數量'
-    required: true
-  repository:
-    description: '儲存庫名稱 (格式: owner/repo)'
-    required: true
-  package-name:
-    description: 'Container 套件名稱 (選填，若提供則會清理 Container Registry)'
-    required: false
-    default: ''
-  token:
-    description: 'Gitea API Token'
-    required: true
-  keep-count:
-    description: '保留的最新版本數量'
-    required: false
     default: '2'
-  dry-run:
-    description: '是否為模擬執行 (只顯示會刪除的版本，不實際刪除)'
-    required: false
-    default: 'false'
 runs:
   using: 'docker'
   image: 'Dockerfile'
   env:
-    GITEA_SERVER: ${{ inputs.gitea-server }}
+    GITEA_SERVER_URL: ${{ gitea.server_url }}
-    REPOSITORY: ${{ inputs.repository }}
+    GITEA_REPOSITORY: ${{ gitea.repository }}
-    PACKAGE_NAME: ${{ inputs.package-name }}
+    RUNNER_TOKEN: ${{ secrets.RUNNER_TOKEN }}
-    TOKEN: ${{ inputs.token }}
+    KEEP_COUNT: ${{ inputs.KEEP_COUNT }}
-    KEEP_COUNT: ${{ inputs.keep-count }}
-    DRY_RUN: ${{ inputs.dry-run }}

cleanup-images.sh

@@ -1,134 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-GITEA_SERVER="$1"
-REPOSITORY="$2"
-PACKAGE_NAME="$3"
-TOKEN="$4"
-KEEP_COUNT="$5"
-DRY_RUN="${6:-false}"
-
-# 參數驗證
-if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$PACKAGE_NAME" ]] || [[ -z "$TOKEN" ]] || [[ -z "$KEEP_COUNT" ]]; then
-  echo "❌ 錯誤：缺少必要參數"
-  echo "使用方式: $0 <gitea-server> <repository> <package-name> <token> <keep-count> [dry-run]"
-  exit 1
-fi
-
-echo "開始清理舊映像，保留最新 $KEEP_COUNT 個版本"
-
-# 提取 owner 名稱
-OWNER=$(echo "$REPOSITORY" | cut -d'/' -f1)
-
-echo "Owner: $OWNER"
-echo "Package: $PACKAGE_NAME"
-
-# 獲取所有 container 版本並按創建時間排序
-echo "正在獲取映像版本列表..."
-VERSIONS_JSON=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \
-  "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME?token=$TOKEN" \
-  -H "Accept: application/json")
-
-HTTP_STATUS=$(echo "$VERSIONS_JSON" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2)
-VERSIONS_JSON=$(echo "$VERSIONS_JSON" | sed '/HTTP_STATUS:/d')
-
-# 檢查是否成功獲取版本列表
-if [[ "$HTTP_STATUS" != "200" ]] || [[ -z "$VERSIONS_JSON" ]] || [[ "$VERSIONS_JSON" == "null" ]]; then
-  echo "❌ 錯誤：無法獲取 container 版本列表 (HTTP Status: $HTTP_STATUS)"
-  exit 1
-fi
-
-# 獲取並排序所有版本 (按創建時間降序)
-SORTED_VERSIONS=$(echo "$VERSIONS_JSON" | jq -e 'sort_by(.created_at) | reverse')
-
-if [[ $? -ne 0 ]]; then
-  echo "❌ 錯誤：無法解析版本資料"
-  exit 1
-fi
-
-# 計算總數量
-TOTAL_COUNT=$(echo "$SORTED_VERSIONS" | jq 'length')
-echo "目前總共有 $TOTAL_COUNT 個映像版本"
-
-# 如果總數量小於等於保留數量，則無需清理
-if [[ $TOTAL_COUNT -le $KEEP_COUNT ]]; then
-  echo "✅ 映像數量 ($TOTAL_COUNT) 未超過保留數量 ($KEEP_COUNT)，無需清理"
-  exit 0
-fi
-
-# 計算需要刪除的數量
-DELETE_COUNT=$((TOTAL_COUNT - KEEP_COUNT))
-echo "需要刪除 $DELETE_COUNT 個舊映像"
-
-# 獲取要刪除的版本 (跳過前 keep-count 個)
-TO_DELETE=$(echo "$SORTED_VERSIONS" | jq -c ".[$KEEP_COUNT:][]")
-
-# 初始化刪除計數器
-DELETED_COUNT=0
-FAILED_COUNT=0
-
-# 處理每個要刪除的版本
-while IFS= read -r version; do
-  if [[ -z "$version" ]] || [[ "$version" == "null" ]]; then
-    continue
-  fi
-  
-  VERSION_ID=$(echo "$version" | jq -r '.id')
-  VERSION_NAME=$(echo "$version" | jq -r '.version')
-  CREATED_AT=$(echo "$version" | jq -r '.created_at')
-  
-  if [[ -z "$VERSION_ID" ]] || [[ "$VERSION_ID" == "null" ]]; then
-    continue
-  fi
-  
-  echo "準備刪除: ID=$VERSION_ID, Version=$VERSION_NAME, Created=$CREATED_AT"
-  
-  if [[ "$DRY_RUN" == "true" ]]; then
-    echo "🔍 [模擬執行] 會刪除映像版本: $VERSION_NAME (ID: $VERSION_ID)"
-    DELETED_COUNT=$((DELETED_COUNT + 1))
-  else
-    # 實際刪除
-    DELETE_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \
-      -X DELETE "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME/$VERSION_NAME?token=$TOKEN" \
-      -H "Accept: application/json")
-    
-    DELETE_HTTP_STATUS=$(echo "$DELETE_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2)
-    
-    if [[ "$DELETE_HTTP_STATUS" == "204" ]] || [[ "$DELETE_HTTP_STATUS" == "200" ]]; then
-      echo "✅ 成功刪除映像版本: $VERSION_NAME (ID: $VERSION_ID)"
-      DELETED_COUNT=$((DELETED_COUNT + 1))
-    else
-      echo "❌ 刪除失敗映像版本: $VERSION_NAME (ID: $VERSION_ID), HTTP狀態: $DELETE_HTTP_STATUS"
-      FAILED_COUNT=$((FAILED_COUNT + 1))
-    fi
-  fi
-done <<< "$TO_DELETE"
-
-# 檢查是否有刪除失敗的情況
-if [[ $FAILED_COUNT -gt 0 ]]; then
-  echo ""
-  echo "❌ 錯誤：有 $FAILED_COUNT 個映像版本刪除失敗"
-  exit 1
-fi
-
-# 輸出最終結果
-echo ""
-echo "========================================="
-if [[ "$DRY_RUN" == "true" ]]; then
-  echo "🔍 [模擬執行] 總共會刪除 $DELETED_COUNT 個映像版本"
-  echo "✅ 模擬執行完成"
-else
-  echo "✅ 清理完成，成功刪除了 $DELETED_COUNT 個映像版本"
-  
-  # 驗證結果
-  if [[ $DELETED_COUNT -gt 0 ]]; then
-    echo ""
-    echo "正在驗證剩餘映像數量..."
-    VERIFY_JSON=$(curl -s "$GITEA_SERVER/api/v1/packages/$OWNER/container/$PACKAGE_NAME?token=$TOKEN" \
-      -H "Accept: application/json")
-    NEW_TOTAL_COUNT=$(echo "$VERIFY_JSON" | jq 'length')
-    echo "📊 目前剩餘 $NEW_TOTAL_COUNT 個映像版本（預期: $KEEP_COUNT）"
-  fi
-fi
-echo "========================================="

cleanup-releases.sh

@@ -1,129 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-GITEA_SERVER="$1"
-REPOSITORY="$2"
-TOKEN="$3"
-KEEP_COUNT="$4"
-DRY_RUN="${5:-false}"
-
-# 參數驗證
-if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$TOKEN" ]] || [[ -z "$KEEP_COUNT" ]]; then
-  echo "❌ 錯誤：缺少必要參數"
-  echo "使用方式: $0 <gitea-server> <repository> <token> <keep-count> [dry-run]"
-  exit 1
-fi
-
-echo "開始清理舊版本，保留最新 $KEEP_COUNT 個版本"
-
-# 獲取所有發佈並按創建時間排序
-echo "正在獲取發佈列表..."
-RELEASES_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \
-  "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \
-  -H "Authorization: token $TOKEN" \
-  -H "Accept: application/json")
-
-HTTP_STATUS=$(echo "$RELEASES_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2)
-RELEASES_JSON=$(echo "$RELEASES_RESPONSE" | sed '/HTTP_STATUS:/d')
-
-# 檢查是否成功獲取發佈
-if [[ "$HTTP_STATUS" != "200" ]] || [[ -z "$RELEASES_JSON" ]] || [[ "$RELEASES_JSON" == "null" ]]; then
-  echo "❌ 錯誤：無法獲取發佈列表 (HTTP Status: $HTTP_STATUS)"
-  exit 1
-fi
-
-# 計算總數量並排序（按創建時間降序，最新的在前）
-SORTED_RELEASES=$(echo "$RELEASES_JSON" | jq -e 'sort_by(.created_at) | reverse')
-
-if [[ $? -ne 0 ]]; then
-  echo "❌ 錯誤：無法解析發佈資料"
-  exit 1
-fi
-
-TOTAL_COUNT=$(echo "$SORTED_RELEASES" | jq 'length')
-echo "目前總共有 $TOTAL_COUNT 個發佈"
-
-# 如果總數量小於等於保留數量，則無需清理
-if [[ $TOTAL_COUNT -le $KEEP_COUNT ]]; then
-  echo "✅ 發佈數量 ($TOTAL_COUNT) 未超過保留數量 ($KEEP_COUNT)，無需清理"
-  exit 0
-fi
-
-# 計算需要刪除的數量
-DELETE_COUNT=$((TOTAL_COUNT - KEEP_COUNT))
-echo "需要刪除 $DELETE_COUNT 個舊版本"
-
-# 獲取要刪除的發佈（跳過前 keep-count 個）
-TO_DELETE=$(echo "$SORTED_RELEASES" | jq -c ".[$KEEP_COUNT:]")
-
-# 初始化刪除計數器
-DELETED_COUNT=0
-FAILED_COUNT=0
-
-# 處理每個要刪除的發佈
-echo "$TO_DELETE" | jq -c '.[]' | while IFS= read -r release; do
-  if [[ -z "$release" ]] || [[ "$release" == "null" ]]; then
-    continue
-  fi
-  
-  RELEASE_ID=$(echo "$release" | jq -r '.id')
-  RELEASE_TAG=$(echo "$release" | jq -r '.tag_name')
-  RELEASE_NAME=$(echo "$release" | jq -r '.name // "未命名"')
-  
-  if [[ -z "$RELEASE_ID" ]] || [[ "$RELEASE_ID" == "null" ]]; then
-    continue
-  fi
-  
-  if [[ "$DRY_RUN" == "true" ]]; then
-    echo "🔍 [模擬執行] 會刪除發佈: $RELEASE_TAG ($RELEASE_NAME)"
-  else
-    # 實際刪除
-    DELETE_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \
-      -X DELETE "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases/$RELEASE_ID" \
-      -H "Authorization: token $TOKEN")
-    
-    HTTP_STATUS=$(echo "$DELETE_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2)
-    
-    if [[ "$HTTP_STATUS" == "204" ]] || [[ "$HTTP_STATUS" == "200" ]]; then
-      echo "✅ 成功刪除發佈: $RELEASE_TAG ($RELEASE_NAME)"
-    else
-      echo "❌ 刪除失敗發佈: $RELEASE_TAG ($RELEASE_NAME), HTTP 狀態: $HTTP_STATUS"
-      FAILED_COUNT=$((FAILED_COUNT + 1))
-    fi
-  fi
-done
-
-# 檢查是否有刪除失敗的情況
-if [[ $FAILED_COUNT -gt 0 ]]; then
-  echo ""
-  echo "❌ 錯誤：有 $FAILED_COUNT 個發佈刪除失敗"
-  exit 1
-fi
-
-# 輸出最終結果
-if [[ "$DRY_RUN" == "true" ]]; then
-  echo ""
-  echo "🔍 [模擬執行] 總共會刪除 $DELETE_COUNT 個版本"
-  echo "✅ 模擬執行完成"
-else
-  # 重新獲取並計算實際刪除的數量
-  echo ""
-  echo "正在驗證刪除結果..."
-  NEW_RELEASES_RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" \
-    "$GITEA_SERVER/api/v1/repos/$REPOSITORY/releases" \
-    -H "Authorization: token $TOKEN" \
-    -H "Accept: application/json")
-  
-  NEW_HTTP_STATUS=$(echo "$NEW_RELEASES_RESPONSE" | grep -o "HTTP_STATUS:[0-9]*" | cut -d: -f2)
-  NEW_RELEASES_JSON=$(echo "$NEW_RELEASES_RESPONSE" | sed '/HTTP_STATUS:/d')
-  
-  if [[ "$NEW_HTTP_STATUS" == "200" ]] && [[ -n "$NEW_RELEASES_JSON" ]]; then
-    NEW_TOTAL_COUNT=$(echo "$NEW_RELEASES_JSON" | jq 'length')
-    ACTUAL_DELETED=$((TOTAL_COUNT - NEW_TOTAL_COUNT))
-    echo "✅ 清理完成！實際刪除了 $ACTUAL_DELETED 個版本"
-    echo "📊 目前剩餘 $NEW_TOTAL_COUNT 個發佈"
-  else
-    echo "✅ 清理完成（無法驗證最終數量）"
-  fi
-fi

entrypoint.sh

@@ -1,21 +1,81 @@
 #!/bin/bash
 
-set -euo pipefail
+echo "=================================================="
 
-GITEA_SERVER="${GITEA_SERVER:-}"
+echo "參數檢查"
-REPOSITORY="${REPOSITORY:-}"
-PACKAGE_NAME="${PACKAGE_NAME:-}"
-TOKEN="${TOKEN:-}"
-KEEP_COUNT="${KEEP_COUNT:-2}"
-DRY_RUN="${DRY_RUN:-false}"
 
-if [[ -z "$GITEA_SERVER" ]] || [[ -z "$REPOSITORY" ]] || [[ -z "$TOKEN" ]]; then
+echo "--------------------------------------------------"
-  echo "❌ 錯誤：缺少必要的 inputs (gitea-server, repository, token)"
+
-  exit 1
+# 顯示 GITEA_SERVER_URL 參數，並檢查是否為空或 "null"，如果是則輸出錯誤訊息並退出
+echo "GITEA_SERVER_URL=$GITEA_SERVER_URL" && ([ -z "$GITEA_SERVER_URL" ] || [ "$GITEA_SERVER_URL" = "null" ]) && exit 1
+
+# 顯示 GITEA_REPOSITORY 參數，並檢查是否為空或 "null"，如果是則輸出錯誤訊息並退出
+echo "GITEA_REPOSITORY=$GITEA_REPOSITORY" && ([ -z "$GITEA_REPOSITORY" ] || [ "$GITEA_REPOSITORY" = "null" ]) && exit 1
+
+# 顯示 RUNNER_TOKEN 參數
+echo "RUNNER_TOKEN=$RUNNER_TOKEN"
+
+# 顯示 KEEP_COUNT 參數，並檢查是否為空或 "null"，如果是則輸出錯誤訊息並退出
+echo "KEEP_COUNT=$KEEP_COUNT" && ([ -z "$KEEP_COUNT" ] || [ "$KEEP_COUNT" = "null" ]) && exit 1
+
+echo "=================================================="
+
+echo "取得成品資訊"
+
+echo "--------------------------------------------------"
+
+RELEASE_URL="$GITEA_SERVER_URL/api/v1/repos/$GITEA_REPOSITORY/releases"
+
+# 檢查是否為空或 "null"
+if [ -n "$RUNNER_TOKEN" ] && [ "$RUNNER_TOKEN" != "null" ]; then
+    # 組合 RELEASE_HEADER 參數，並顯示出來
+    RELEASE_HEADER="Authorization: token $RUNNER_TOKEN" && echo "RELEASE_HEADER=$RELEASE_HEADER"
+
+    # 取得成品資訊
+    RELEASE_JSON="$(curl -s -H "$RELEASE_HEADER" "$RELEASE_URL")"
+else
+    # 取得成品資訊
+    RELEASE_JSON="$(curl -s "$RELEASE_URL")"
 fi
 
-/cleanup-releases.sh "$GITEA_SERVER" "$REPOSITORY" "$TOKEN" "$KEEP_COUNT" "$DRY_RUN"
+# 計算成品數量並依照時間排序
+RELEASE_JSON=$(echo "$RELEASE_JSON" | jq -e 'sort_by(.created_at) | reverse')
+RELEASE_COUNT=$(echo "$RELEASE_JSON" | jq 'length')
 
-if [[ -n "$PACKAGE_NAME" ]]; then
+# 檢查成品數量是否需要清除
-  /cleanup-images.sh "$GITEA_SERVER" "$REPOSITORY" "$PACKAGE_NAME" "$TOKEN" "$KEEP_COUNT" "$DRY_RUN"
+[ $RELEASE_COUNT -le $KEEP_COUNT ] && exit 0
-fi
+
+echo "=================================================="
+
+echo "刪除舊版本的成品"
+
+echo "--------------------------------------------------"
+
+RELEASE_TO_DELETE=$(echo "$RELEASE_JSON" | jq -c ".[$KEEP_COUNT:]")
+
+echo "$RELEASE_TO_DELETE" | jq -c '.[]' | while IFS= read -r RELEASE_URL; do
+  # 檢查是否有成品連結
+  ([ -z "$RELEASE_URL" ] || [ "$RELEASE_URL" == "null" ]) && continue
+  
+  # 取得成品資訊
+  RELEASE_ID=$(echo "$RELEASE_URL" | jq -r '.id')
+  RELEASE_TAG=$(echo "$RELEASE_URL" | jq -r '.tag_name')
+  RELEASE_NAME=$(echo "$RELEASE_URL" | jq -r '.name')
+
+  # 檢查成品編號是否正確
+  ([ -z "$RELEASE_ID" ] || [ "$RELEASE_ID" == "null" ]) && continue
+
+  # 刪除成品
+  RELEASE_URL="$GITEA_SERVER_URL/api/v1/repos/$GITEA_REPOSITORY/releases/$RELEASE_ID"
+
+  RELEASE_DELETE_CODE=$(curl -s -o /dev/null -w "%{http_code}" -X DELETE -H "$RELEASE_HEADER" "$RELEASE_URL")
+
+  # 檢查刪除成品是否成功
+  if [ "$RELEASE_DELETE_CODE" -eq 204 ]; then
+    echo "✅ 成功刪除成品: $RELEASE_TAG ($RELEASE_NAME)"
+  else
+    echo "❌ 刪除成品失敗: $RELEASE_TAG ($RELEASE_NAME), HTTP 狀態碼: $RELEASE_DELETE_CODE"
+  fi
+done
+
+echo "=================================================="

readme.md

@@ -1,118 +0,0 @@
-# Cleanup Old Releases Action
-
-這是一個自動清理舊版本 releases 的 GitHub Action，可以保留指定數量的最新版本，刪除多餘的舊版本。
-
-## 功能特色
-
-- 🗑️ 自動清理舊版本 releases
-- 🔢 可配置保留的版本數量
-- 🔍 支援模擬執行模式
-- 📊 詳細的執行報告
-- 🛡️ 安全的錯誤處理
-
-## 輸入參數
-
-| 參數名稱 | 必要 | 預設值 | 描述 |
-|---------|------|--------|------|
-| `gitea-server` | ✅ | - | Gitea 伺服器 URL |
-| `repository` | ✅ | - | 儲存庫名稱 (格式: owner/repo) |
-| `token` | ✅ | - | Gitea API Token |
-| `keep-count` | ❌ | `2` | 保留的最新版本數量 |
-| `dry-run` | ❌ | `false` | 是否為模擬執行 (只顯示會刪除的版本，不實際刪除) |
-
-## 輸出參數
-
-| 參數名稱 | 描述 |
-|---------|------|
-| `deleted-count` | 已刪除的版本數量 |
-| `deleted-releases` | 已刪除的版本列表 (JSON 格式) |
-
-## 使用範例
-
-### 基本用法 (保留最新2個版本)
-
-```yaml
-- name: 清理舊版本
-  uses: ./.gitea/actions/cleanup-releases
-  with:
-    gitea-server: ${{ gitea.server_url }}
-    repository: ${{ gitea.repository }}
-    token: ${{ secrets.GITEA_TOKEN }}
-```
-
-### 自定義保留數量
-
-```yaml
-- name: 清理舊版本 (保留最新5個)
-  uses: ./.gitea/actions/cleanup-releases
-  with:
-    gitea-server: ${{ gitea.server_url }}
-    repository: ${{ gitea.repository }}
-    token: ${{ secrets.GITEA_TOKEN }}
-    keep-count: '5'
-```
-
-### 模擬執行模式
-
-```yaml
-- name: 檢查要清理的版本
-  id: check-cleanup
-  uses: ./.gitea/actions/cleanup-releases
-  with:
-    gitea-server: ${{ gitea.server_url }}
-    repository: ${{ gitea.repository }}
-    token: ${{ secrets.GITEA_TOKEN }}
-    keep-count: '3'
-    dry-run: 'true'
-
-- name: 顯示模擬結果
-  run: |
-    echo "模擬執行會刪除 ${{ steps.check-cleanup.outputs.deleted-count }} 個版本"
-```
-
-### 使用輸出結果
-
-```yaml
-- name: 清理舊版本
-  id: cleanup
-  uses: ./.gitea/actions/cleanup-releases
-  with:
-    gitea-server: ${{ gitea.server_url }}
-    repository: ${{ gitea.repository }}
-    token: ${{ secrets.GITEA_TOKEN }}
-    keep-count: '2'
-
-- name: 報告清理結果
-  run: |
-    echo "清理完成，刪除了 ${{ steps.cleanup.outputs.deleted-count }} 個舊版本"
-    echo "刪除的版本詳情: ${{ steps.cleanup.outputs.deleted-releases }}"
-```
-
-## 運作邏輯
-
-1. **獲取版本列表**：從 Gitea API 獲取所有 releases，按創建時間排序
-2. **計算刪除範圍**：保留最新的 `keep-count` 個版本，標記其餘版本為待刪除
-3. **執行清理**：
-   - 模擬模式：只顯示會刪除的版本，不實際執行
-   - 正常模式：逐一刪除標記的版本
-4. **回報結果**：提供刪除數量和詳細列表
-
-## 安全特性
-
-- ✅ **防護機制**：如果總版本數 ≤ 保留數量，則不執行任何刪除
-- ✅ **錯誤處理**：API 請求失敗時會顯示錯誤訊息並停止執行
-- ✅ **模擬模式**：可以先模擬執行，確認要刪除的版本無誤
-- ✅ **詳細日誌**：每個步驟都有清楚的日誌輸出
-
-## 注意事項
-
-- 需要有 `GITEA_TOKEN` secret 且具備刪除 releases 的權限
-- 刪除操作是不可逆的，建議先使用模擬模式確認
-- Action 按照創建時間排序，保留最新的版本
-- 建議在 release 創建之後執行此 action
-
-## 錯誤處理
-
-- 如果無法連接到 Gitea API，action 會失敗並顯示錯誤訊息
-- 如果某個版本刪除失敗，會記錄錯誤但繼續處理其他版本
-- 如果 token 權限不足，會顯示相應的 HTTP 錯誤狀態