# 檔案用途：定義 CLEANUP OLD RELEASES 這個 Docker action 的輸入參數與執行環境
# 更新日期：2026/07/15 13:05:00

# Action 名稱，會顯示在 action 市集與文件中
name: 'CLEANUP OLD RELEASES'

# Action 描述，簡短說明這個 action 的目的
description: '清理舊版成品'

# 作者資訊，標示此 action 的維護者
author: 'Jeffery'

# 定義可由使用者或呼叫端傳入的輸入參數
inputs:
  # KEEP_COUNT 用於控制保留的 release 數量；正式版與預發行版（prerelease）分組各自保留這個數量
  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 }}
    # 使用 Gitea runtime 自動核發的 token，權限僅限當前 repo 且 job 結束即失效
    GITEA_TOKEN: ${{ gitea.token }}
    # KEEP_COUNT 直接沿用輸入值，交由程式驗證
    KEEP_COUNT: ${{ inputs.KEEP_COUNT }}