fix(cleanup-release): 重新整理 release 清理流程與輸出格式

action.yml

@@ -1,14 +1,41 @@
-name: 'Gitea Docker Template'
-description: 'Gitea Docker 範本'
+# 檔案用途：定義 CLEANUP OLD RELEASES 這個 Docker action 的輸入參數與執行環境
+# 更新日期：2026/07/11 21:02:25
+
+# Action 名稱，會顯示在 action 市集與文件中
+name: 'CLEANUP OLD RELEASES'
+
+# Action 描述，簡短說明這個 action 的目的
+description: '清理舊版成品'
+
+# 作者資訊，標示此 action 的維護者
 author: 'Jeffery'
+
+# 定義可由使用者或呼叫端傳入的輸入參數
 inputs:
-  message:
-    description: '輸入訊息'
-    required: false
-    default: 'Hello, World!'
-outputs:
-  message:
-    description: '輸出訊息'
+  # RUNNER_TOKEN 用於授權呼叫 Gitea API；未提供時會改用 secrets
+  RUNNER_TOKEN:
+    # 參數說明，讓呼叫端知道這是 Runner Token
+    description: 'GitHub Runner Token'
+  # KEEP_COUNT 用於控制保留的 release 數量
+  KEEP_COUNT:
+    # 參數說明，這裡表示保留的版本數量
+    description: '保留的版本數量'
+    # 預設保留 2 個版本，避免完全刪除歷史 release
+    default: '2'
+
+# 定義 action 的執行方式
 runs:
+  # 使用 Docker image 作為執行環境
   using: docker
+  # Dockerfile 位於 repo 根目錄
   image: Dockerfile
+  # 將 Gitea 與輸入參數映射為容器環境變數
+  env:
+    # GITEA_SERVER_URL 由 Gitea runtime 注入，供程式組 API URL
+    GITEA_SERVER_URL: ${{ gitea.server_url }}
+    # GITEA_REPOSITORY 由 Gitea runtime 注入，供程式指定目標 repo
+    GITEA_REPOSITORY: ${{ gitea.repository }}
+    # 優先使用傳入的 RUNNER_TOKEN，否則退回 Gitea token secrets
+    RUNNER_TOKEN: ${{ inputs.RUNNER_TOKEN || secrets.GITEA_TOKEN || secrets.RUNNER_TOKEN }}
+    # KEEP_COUNT 直接沿用輸入值，交由程式驗證
+    KEEP_COUNT: ${{ inputs.KEEP_COUNT }}