.gitea/workflows/ci.yaml

@@ -1,8 +1,8 @@
 # ===================================================================
-# 用途：Gitea CI workflow，於 Pull Request 開啟或更新時觸發 AI 程式碼審查。
+# 用途：Gitea CI workflow，於 Pull Request 開啟（opened）或同步更新（synchronize）時觸發（master 分支除外）。
-#       透過公司 Gitea 上的 composite action `opencode-code-review`，
+#       流程先呼叫 composite action `release-tag-version`（is_beta: true）標註一個 beta 成品版本並輸出版本號，
-#       對 PR 變更內容執行自動化 AI code review，並把審查結果以留言回貼到 PR。
+#       再以該 beta 版本（@v${version}）執行本專案的 `release-cleanup` action，對自身成品做清理（dogfooding 自我清理驗證）。
-# 更新日期（台灣時區 Asia/Taipei）：2026/06/30 16:44:09
+# 更新日期（台灣時區 Asia/Taipei）：2026/06/30 18:19:59
 # ===================================================================
 
 # workflow 名稱，顯示於 Gitea Actions 介面
@@ -13,7 +13,7 @@ on:
   pull_request:
     # 目標分支過濾：忽略以下分支（即 master 不觸發本 workflow）
     branches-ignore:
-    # 排除 master 分支，避免對正式主線的 PR 執行 AI 審查
+    # 排除 master 分支，避免對正式主線的 PR 執行本流程
     - master
     # 僅在 PR 被「開啟（opened）」或「推送新 commit 同步（synchronize）」時觸發
     types: [opened, synchronize]
@@ -41,11 +41,17 @@ jobs:
       with:
         # is_beta 設為 true 表示走 beta 標版流程 (標註的是 beta 成品版本,而非正式版)。
         is_beta: true
+  # 第二個 job: 以前一個 job 標註出的 beta 版本執行清理成品 action (dogfooding 自我清理)。
   release-cleanup:
+    # job 顯示名稱。
     name: Release Cleanup
+    # 指定執行環境 (runner) 標籤為 ubuntu。
     runs-on: ubuntu
+    # 宣告相依於 release-tag-version job,確保其先完成且可取用其 outputs.version。
     needs: release-tag-version
+    # 此 job 依序執行的步驟。
     steps:
+    # 步驟: 呼叫 release-cleanup action 清理舊成品。
     - name: 清理舊成品
+      # 引用本專案 release-cleanup action,版本釘選為前一個 job 輸出的 beta 版本 v${version} (以剛標出的 beta 版自我驗證清理流程)。
       uses: https://gitea.jsc.idv.tw/docker-actions/release-cleanup@v${{ needs.release-tag-version.outputs.version }}
-

entrypoint.sh

@@ -7,7 +7,7 @@
 #   中辨識正在執行哪一個 action 及其版本；接著以 exec 啟動 node 主程式
 #   /app/index.js，並把所有外部傳入的參數原樣交給它。
 #
-# 更新日期（台灣時區）：2026/06/30 12:02:55
+# 更新日期（台灣時區）：2026/06/30 18:19:59
 # =============================================================================
 
 # 啟用「遇到任何指令失敗（非 0 結束碼）即立刻中止腳本」的模式。
@@ -19,7 +19,7 @@ ACTION_NAME='Release Cleanup'
 # action 用途說明，供下方橫幅輸出使用。
 ACTION_DESC='清理舊成品'
 # action 更新時間（固定字串，台灣時區），供下方橫幅輸出使用。
-ACTION_UPDATED='2026/06/30 12:02:55'
+ACTION_UPDATED='2026/06/30 18:19:59'
 
 # 輸出一個空行 + 分隔線，作為橫幅的上邊框，讓 log 中的資訊區塊更易閱讀。
 printf '\n%s\n' '=================================================='