docs(calculate-version): 重建 README 並補齊指令檔註解與 logger JSDoc #11

Merged

admin merged 5 commits from ai-review-resolve/develop-20260630-164907 into develop 2026-06-30 10:23:29 +00:00

Conversation 0 Commits 5 Files Changed 11

+302 -233

jiantw83 commented 2026-06-30 08:50:03 +00:00

Member

Copy Link

Copy Source

變更摘要

透過 doc-funcs 流程補齊文件與指令檔註解，不含任何 runtime 行為或設定值變更。

• README.md：刪除舊檔重建，含更新時間（Asia/Taipei）、專案列表（專案描述／參考專案／NuGet 套件三張表）、17 個公開 function 的功能列表（連結到原始碼起始行）與對應使用範例；內部錨點一致性檢查通過。
• .gitea/workflows/ci.yaml：修正過時檔頭（原描述「OpenCode AI 程式碼審查」，已更新為「釋出標版 + 計算版本號」現況），並補齊逐行繁體中文註解；YAML 邏輯與值未變更。
• action.yaml：補上單一「用途 + 更新日期」檔頭區塊與逐行註解（原本完全無註解）；欄位與值未變更。
• app/logger.js：section() 的 JSDoc @remarks 範例由「取得版本資料」更新為「取得舊版本」，僅註解、無程式碼變更。

影響範圍

• 僅文件與註解：README.md、.gitea/workflows/ci.yaml、action.yaml、app/logger.js（僅 JSDoc）。
• 不涉及任何程式邏輯、YAML 設定值或對外行為。

風險／注意事項

• 純文件／註解變更。45 個單元測試全數通過；ci.yaml／cd.yaml／action.yaml YAML 語法驗證通過、entrypoint.sh bash 語法檢查通過。

## 變更摘要 透過 doc-funcs 流程補齊文件與指令檔註解，**不含任何 runtime 行為或設定值變更**。 - **README.md**：刪除舊檔重建，含更新時間（Asia/Taipei）、專案列表（專案描述／參考專案／NuGet 套件三張表）、17 個公開 function 的功能列表（連結到原始碼起始行）與對應使用範例；內部錨點一致性檢查通過。 - **.gitea/workflows/ci.yaml**：修正過時檔頭（原描述「OpenCode AI 程式碼審查」，已更新為「釋出標版 + 計算版本號」現況），並補齊逐行繁體中文註解；YAML 邏輯與值未變更。 - **action.yaml**：補上單一「用途 + 更新日期」檔頭區塊與逐行註解（原本完全無註解）；欄位與值未變更。 - **app/logger.js**：`section()` 的 JSDoc `@remarks` 範例由「取得版本資料」更新為「取得舊版本」，僅註解、無程式碼變更。 ## 影響範圍 - 僅文件與註解：`README.md`、`.gitea/workflows/ci.yaml`、`action.yaml`、`app/logger.js`（僅 JSDoc）。 - 不涉及任何程式邏輯、YAML 設定值或對外行為。 ## 風險／注意事項 - 純文件／註解變更。45 個單元測試全數通過；`ci.yaml`／`cd.yaml`／`action.yaml` YAML 語法驗證通過、`entrypoint.sh` bash 語法檢查通過。

jiantw83 added 1 commit 2026-06-30 08:50:04 +00:00

docs(calculate-version): 重建 README 並補齊 ci.yaml／action.yaml 指令檔註解與 logger JSDoc 7f3ddf62e3

jiantw83 added 1 commit 2026-06-30 09:43:18 +00:00

docs(calculate-version): 重建 README、修正 compareVersionArrays JSDoc 並更新指令檔註解日期 7de0900d5f

jiantw83 added 3 commits 2026-06-30 10:22:35 +00:00

feat(logger): 以階段前綴取代 section 區塊並新增 forStage 子記錄器 ead1afc79a

test(logger): 補上階段前綴與 forStage 測試並調整 silentLog 1a531bfb87

docs(README): 同步 logger 功能列表與使用範例（移除 section、新增 forStage） 4b450ae2d8

admin merged commit c267b60695 into develop 2026-06-30 10:23:29 +00:00

admin deleted branch ai-review-resolve/develop-20260630-164907 2026-06-30 10:23:29 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Assignees

Clear assignees

admin (系統管理員) jiantw83 (Jeffery)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: old-docker-actions/calculate-version#11