docs(release-cleanup): 補齊 CI workflow 註解、統一日誌格式並重建 README

- .gitea/workflows/ci.yaml、cd.yaml：新增用途/更新日期區塊與逐行註解（指令邏輯不變）
- app/index.js：日誌統一為 [等級][台灣時間]: 訊息（新增 timestamp helper，INF/WRN/ERR；行為、控制流、exit code、stdout/stderr 皆等價）
- README.md：重建專案列表三表/功能列表/使用範例，新增日誌格式說明與 timestamp 功能

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.gitea/workflows/cd.yaml

@@ -1,12 +1,32 @@
+# 用途：本檔為 Gitea CD（持續部署）工作流程設定。
+#       當 master 分支有 push 時自動觸發，使用公司 Gitea 上的
+#       composite action「release-tag-version」對建置成品進行釋出與版本標註（tag）。
+# 更新日期（台灣時區 Asia/Taipei）：2026/06/30 16:44:09
+
+# 工作流程名稱，顯示於 Gitea Actions 介面，用以辨識此 CD 流程
 name: CD
+# 定義觸發此工作流程的事件
 on:
+  # 當有程式碼 push（推送）至指定分支時觸發
   push:
+    # 限定僅特定分支的 push 才觸發
     branches:
+    # 僅 master 分支（正式發布主線）push 時才執行此 CD 流程
     - master
+# 定義此工作流程包含的所有 job（工作）
 jobs:
+  # job 識別代號：release-tag-version（釋出並標註版本）
   release-tag-version:
+    # job 的顯示名稱，呈現於 Gitea Actions 執行畫面
     name: Release Tag Version
+    # 指定此 job 執行所使用的 runner 標籤（ubuntu runner）
     runs-on: ubuntu
+    # 定義此 job 依序執行的步驟清單
     steps:
+    # 步驟名稱：釋出並標註成品版本
     - name: 釋出並標註成品版本
+      # 引用公司 Gitea 上的 composite action「release-tag-version」執行釋出與打 tag。
+      # 版本（@ 之後）由 Gitea 變數 vars.ACTION_RELEASE_TAG_VERSION 動態決定，
+      # 便於集中管理所引用 action 的版本，不需修改本檔即可切換版本。
+      # 需人工確認：此 action 之具體釋出/標註行為與所需 secrets/權限，須參閱該 composite action 定義。
       uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}

.gitea/workflows/ci.yaml

@@ -1,19 +1,48 @@
+# ===================================================================
+# 用途：Gitea CI workflow，於 Pull Request 開啟或更新時觸發 AI 程式碼審查。
+#       透過公司 Gitea 上的 composite action `opencode-code-review`，
+#       對 PR 變更內容執行自動化 AI code review，並把審查結果以留言回貼到 PR。
+# 更新日期（台灣時區 Asia/Taipei）：2026/06/30 16:44:09
+# ===================================================================
+
+# workflow 名稱，顯示於 Gitea Actions 介面
 name: CI
+# 觸發事件設定
 on:
+  # 針對 Pull Request 事件觸發
   pull_request:
+    # 目標分支過濾：忽略以下分支（即 master 不觸發本 workflow）
     branches-ignore:
+    # 排除 master 分支，避免對正式主線的 PR 執行 AI 審查
     - master
+    # 僅在 PR 被「開啟（opened）」或「推送新 commit 同步（synchronize）」時觸發
     types: [opened, synchronize]
+# 定義所有 jobs
 jobs:
+  # job 識別碼：AI 程式碼審查
   ai-code-review:
+    # job 顯示名稱
     name: AI Code Review
+    # 指定執行環境（runner 標籤），使用 ubuntu runner
     runs-on: ubuntu
+    # 此 job 對 GITHUB_TOKEN 所需的權限範圍
     permissions:
+      # 允許寫入 repository 內容（供 action 讀取/操作程式碼）
       contents: write
+      # 允許寫入 Pull Request（供 action 回貼審查留言）
       pull-requests: write
+      # 允許寫入 issues（PR 留言底層走 issue comment API，需此權限）
       issues: write
+    # 此 job 的執行步驟
     steps:
+    # 步驟名稱：使用 OpenCode 進行 AI 程式碼審查
     - name: AI 程式碼審查 by OpenCode
+      # 引用公司 Gitea 上的 composite action `opencode-code-review`，
+      # 版本由 repository/organization 變數 ACTION_OPENCODE_CODE_REVIEW_VERSION 指定，
+      # 便於集中控管所使用的 action 版本
       uses: https://gitea.jsc.idv.tw/composite-actions/opencode-code-review@${{ vars.ACTION_OPENCODE_CODE_REVIEW_VERSION }}
+      # 傳遞給 composite action 的輸入參數
       with:
+        # 留言用 token，從 secrets.COMMENT_TOKEN 取得，
+        # 供 action 以該身分將審查結果回貼到 PR 留言
         comment_token: ${{ secrets.COMMENT_TOKEN }}