docs(codex): 補齊 read_account_email docstring 與指令檔註解並重建 README

.gitea/workflows/cd.yaml

@@ -1,12 +1,35 @@
+# =============================================================================
+# 用途：CD（Continuous Delivery）持續交付 workflow。
+#       當有 commit push 到 master 分支時觸發，呼叫 release-tag-version
+#       composite action 進行「釋出並標註正式成品版本」（建立 release / 打 tag），
+#       將 master 上的成果標記為一個正式可發布的版本。
+# 更新日期：2026/06/29 14:18:26
+# =============================================================================
+
+# workflow 顯示名稱，會出現在 Gitea Actions 的 workflow 清單與執行紀錄中，方便辨識。
 name: CD
+# 觸發條件：監聽 push 事件。
 on:
   push:
+    # 只在指定分支發生 push 時觸發，避免其他分支誤觸發正式釋出流程。
     branches:
+    # 僅限 master 分支：master 視為正式（穩定）分支，push 進來代表要正式釋出成品版本。
     - master
+# 此 workflow 包含的 job 清單。
 jobs:
+  # job 識別碼：release-tag-version，負責釋出並標註成品版本。
   release-tag-version:
+    # job 顯示名稱，呈現於 Actions 執行畫面，便於辨識此 job 的職責。
     name: Release Tag Version
+    # 指定執行此 job 的 runner 標籤；使用 ubuntu runner 執行後續步驟。
     runs-on: ubuntu
+    # 此 job 的執行步驟序列。
     steps:
+    # 步驟名稱：釋出並標註成品版本（建立 release / 打版本 tag）。
     - name: 釋出並標註成品版本
+      # 呼叫外部 composite action「release-tag-version」執行實際的釋出與 tag 標註邏輯。
+      # 版本以變數 vars.ACTION_RELEASE_TAG_VERSION 釘選，確保使用指定版本的 action，
+      # 避免上游 action 變動造成釋出行為不可預期。
+      # 副作用：此步驟會在遠端建立 release 或推送版本 tag（正式釋出動作）。
+      # 需人工確認：vars.ACTION_RELEASE_TAG_VERSION 變數需在 repo / org 層級正確設定，否則 action 解析會失敗。
       uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}