docs(antigravity): 補齊 action 與 workflow 逐行註解並重建 README

.gitea/workflows/cd.yaml

@@ -1,29 +1,31 @@
-# 用途：定義 CD 工作流程，在 master 分支收到 push 時執行版本標籤釋出流程。
-# 更新日期：2026/06/27 23:21:07
+# 用途：定義 CD（持續部署）工作流程，當 master 分支收到 push 時，執行「版本標籤釋出（release tag）」流程。
+# 更新日期：2026/06/29 14:21:50
 
-# 設定此 Gitea Actions workflow 顯示名稱為 CD，方便在工作流程清單中辨識。
+# 設定此 Gitea Actions workflow 的顯示名稱為 CD，方便在 Actions 工作流程清單中辨識。
 name: CD
 
 # 定義觸發此 workflow 的事件條件。
 on:
-  # 當程式碼被 push 到指定分支時觸發部署流程。
+  # 監聽 push 事件：當有 commit 被推送到指定分支時觸發。
   push:
-    # 指定只監聽下列分支的 push 事件。
+    # 指定只針對下列分支的 push 事件生效。
     branches:
-    # 限定 master 分支被推送時才執行 CD workflow。
+    # 限定僅 master 分支被推送時才執行此 CD workflow（避免其他分支誤觸發釋出）。
     - master
 
 # 定義此 workflow 需要執行的所有 job。
 jobs:
-  # 建立負責釋出版本標籤的 job。
+  # 建立負責釋出並標註版本標籤的 job，job id 為 release-tag-version。
   release-tag-version:
-    # 設定 job 在 Gitea Actions 介面中顯示的名稱。
+    # 設定此 job 在 Gitea Actions 介面中顯示的名稱。
     name: Release Tag Version
     # 指定此 job 使用 ubuntu runner 執行。
     runs-on: ubuntu
     # 定義此 job 內依序執行的步驟。
     steps:
-    # 建立釋出並標註成品版本的步驟。
+    # 步驟：釋出並標註成品版本。
     - name: 釋出並標註成品版本
-      # 呼叫共用 composite action，版本由 ACTION_RELEASE_TAG_VERSION 變數決定。
+      # 呼叫共用的 composite action release-tag-version 來完成版本標籤釋出；
+      # 使用的 action 版本由 repository variable ACTION_RELEASE_TAG_VERSION 動態決定，
+      # 可在不改動本檔案的情況下集中切換所引用的 action 版本。
       uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}