.gitea/workflows/ci.yaml

@@ -1,3 +1,8 @@
+# --------------------------------------------------
+# 用途：定義 CI 工作流程，處理 pull request 的版本發佈與測試。
+# 更新日期：2026/07/11 17:44:33（Asia/Taipei）
+# --------------------------------------------------
+
 name: CI
 on:
   pull_request:
@@ -53,7 +58,7 @@ jobs:
   result:
     name: 3. RESULT
     runs-on: ubuntu
-    needs: [build,test]
+    needs: [build, test]
     if: ${{ needs.build.outputs.is_beta == 'false' }}
     env:
       VERSION: ${{ needs.test.outputs.version }}

Dockerfile

@@ -1,3 +1,8 @@
+# --------------------------------------------------
+# 用途：定義 calculate-version action 的 Docker 執行環境。
+# 更新日期：2026/07/11 17:44:33（Asia/Taipei）
+# --------------------------------------------------
+
 FROM node:lts-alpine
 
 WORKDIR /action

action.yml

@@ -1,19 +1,24 @@
-name: 'Calculate Version'
-description: '計算版本號'
-author: 'Jeffery'
+# --------------------------------------------------
+# 用途：宣告 Calculate Version action 的輸入、輸出與 Docker 執行方式。
+# 更新日期：2026/07/11 17:44:33（Asia/Taipei）
+# --------------------------------------------------
+
+name: "Calculate Version"
+description: "計算版本號"
+author: "Jeffery"
 inputs:
   is_beta:
-    description: '是否為 beta 版本'
-    default: 'false'
+    description: "是否為 beta 版本"
+    default: "false"
   runner_token:
-    description: '用於讀取 release 的 token'
+    description: "用於讀取 release 的 token"
     required: false
 outputs:
   version:
-    description: '計算出的版本號'
+    description: "計算出的版本號"
 runs:
-  using: 'docker'
-  image: 'Dockerfile'
+  using: "docker"
+  image: "Dockerfile"
   env:
     GITEA_SERVER_URL: ${{ gitea.server_url }}
     GITEA_REPOSITORY: ${{ gitea.repository }}

entrypoint.sh

@@ -1,4 +1,9 @@
 #!/bin/sh
+# --------------------------------------------------
+# 用途：啟動 calculate-version action，將所有參數交給 Node 主程式。
+# 更新日期：2026/07/11 17:44:33（Asia/Taipei）
+# --------------------------------------------------
+
 set -eu
 
 exec node /action/src/index.js "$@"