docs(指令檔與 README): 補齊 action/master 逐行註解並更新 README 與 CI 觸發說明

.gitea/workflows/master.yaml

@@ -3,7 +3,7 @@
 #   本 workflow 為「CD（持續部署）」流程，於程式碼 push 到 master 分支時觸發。
 #   主要工作為 checkout 完整原始碼、依指定 commit 反查其所屬的 git tag，
 #   並將該 tag 輸出顯示，供後續部署或版本追蹤使用。
-# 更新日期：2026/07/03 11:41:20 (Asia/Taipei)
+# 更新日期：2026/07/03 17:43:30 (Asia/Taipei)
 # =============================================================================
 
 # workflow 名稱，顯示於 Gitea Actions 介面
@@ -36,6 +36,7 @@ jobs:
     - name: Source Code Checkout
       # 使用 actions/checkout，版本由 repo/organization 變數 ACTION_CHECKOUT_VERSION 決定
       uses: actions/checkout@${{ vars.ACTION_CHECKOUT_VERSION }}
+      # with：傳入 checkout action 的參數區塊
       with:
         # fetch-depth: 0 代表抓取完整 git 歷史（含所有 tag），
         # 以利後續 git describe 能正確反查 tag（淺層 clone 會導致查不到）。