feat(檢查已標記): 新增 sha 輸入，commit 已有版號 tag 時直接輸出該版號

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

action.yml

@@ -3,7 +3,7 @@
 #       metadata 定義檔。宣告此 action 的名稱、輸入（is_beta）、輸出（value）
 #       與執行方式（runner 於執行時就地以 Dockerfile 建置映像並以 entrypoint.sh 啟動）。
 #       由 workflow 以 `uses:` 引用本 repo 時，runner 讀取此檔決定如何執行。
-# 更新時間：2026/07/16 09:17:01
+# 更新時間：2026/07/16 11:18:57
 # ============================================================================
 
 # action 的顯示名稱：出現在 workflow log 與 marketplace/action 清單中，
@@ -33,6 +33,18 @@ inputs:
     # action 輸入一律為字串，布林判斷由主程式自行解析
     default: 'false'
 
+  # sha：要檢查的 commit SHA，建議由 workflow 傳入 ${{ gitea.sha }}；
+  # runner 會以 INPUT_SHA 環境變數傳入容器，該 commit 已有版號 tag 時
+  # 直接輸出該版號（忽略 is_beta）、不再計算下一版
+  sha:
+    # 參數說明：未提供時主程式自動改用 runner 內建的 GITHUB_SHA；
+    # 兩者皆空才略過已標記檢查、直接走一般計算流程
+    description: '要檢查的 commit SHA（建議傳入 ${{ gitea.sha }}）；該 commit 已有版號 tag 時直接輸出該版號。未提供時自動改用 GITHUB_SHA'
+    # 非必填：省略時依上述順序自動回退
+    required: false
+    # 預設空字串，表示交由主程式依 INPUT_SHA → GITHUB_SHA 順序解析
+    default: ''
+
 # 輸出參數區：供 workflow 後續步驟以 steps.<id>.outputs.value 取用
 outputs:
   # value：計算出的下一版號；由主程式（src/index.js）將