統一日誌格式為 [階段][等級][時間] 並補齊指令檔文件與 README #1

2026-07-16T02:26:09Z

jiantw83 commented

2026-07-16 02:26:09 +00:00

變更摘要

執行 /jsc:doc-funcs 文件化流程的完整成果：統一日誌輸出格式、補齊指令檔逐行註解、重建 README，並將先前未進版控的 src/logger.js、src/version.js 納入追蹤。

影響範圍

日誌格式（行為可見變更）：所有輸出訊息由 [時間][階段][等級]: 訊息 改為 [階段][等級][時間]: 訊息（階段 選填、等級 為 INF/WRN/ERR/TRC/DBG、時間 為 Asia/Taipei 的 yyyy/MM/dd HH:mm:ss）。版號計算邏輯與 action 輸出 value 完全不變。
檔名調整：readme.md → README.md；容器建置檔定案為小寫 dockerfile，與 action.yml 的 image: dockerfile 引用一致。

重點檔案

檔案	變更
`src/logger.js`	`format()` 組字順序改為階段在前；全模組 JSDoc 與範例同步更新（新進版控）
`src/version.js`	版號解析／比較／進位模組，完整 JSDoc（新進版控）
`src/index.js`	JSDoc 日誌範例更新為新格式
`entrypoint.sh`	三行啟動訊息改用新格式、標頭更新時間刷新、加上執行權限（100755）
`action.yml`	新增用途／更新時間標頭與逐行繁中註解，所有設定值不變
`dockerfile`	標頭更新時間刷新，指令本體不變
`README.md`	重建：新增日誌格式說明、功能列表行號連結修正、更新時間刷新

驗證

node --check 三個 JS 模組、sh -n entrypoint.sh、YAML 解析全部通過。
以臨時 git repo 實測三情境：1.2.4-beta.3 → 1.2.4（轉正式）、→ 1.2.4-beta.4（beta 續號）、非法 is_beta 以 exit 1 結束，日誌皆為新格式。
README 錨點一致性檢查 9/9 通過。

風險與注意事項

日誌格式變更會影響任何解析 workflow log 的既有工具（若有）。
entrypoint.sh 啟動訊息中的時間為寫檔時的固定字串（非執行當下時間），檔內已註解標註。
Docker 映像未實際重新建置（dockerfile 指令本體與先前相同，僅註解時間更新）。

🤖 Generated with Claude Code

## 變更摘要執行 `/jsc:doc-funcs` 文件化流程的完整成果：統一日誌輸出格式、補齊指令檔逐行註解、重建 README，並將先前未進版控的 `src/logger.js`、`src/version.js` 納入追蹤。 ## 影響範圍 - **日誌格式（行為可見變更）**：所有輸出訊息由 `[時間][階段][等級]: 訊息` 改為 `[階段][等級][時間]: 訊息`（`階段` 選填、`等級` 為 INF/WRN/ERR/TRC/DBG、`時間` 為 Asia/Taipei 的 `yyyy/MM/dd HH:mm:ss`）。版號計算邏輯與 action 輸出 `value` 完全不變。 - **檔名調整**：`readme.md` → `README.md`；容器建置檔定案為小寫 `dockerfile`，與 `action.yml` 的 `image: dockerfile` 引用一致。 ## 重點檔案 | 檔案 | 變更 | | --- | --- | | `src/logger.js` | `format()` 組字順序改為階段在前；全模組 JSDoc 與範例同步更新（新進版控） | | `src/version.js` | 版號解析／比較／進位模組，完整 JSDoc（新進版控） | | `src/index.js` | JSDoc 日誌範例更新為新格式 | | `entrypoint.sh` | 三行啟動訊息改用新格式、標頭更新時間刷新、加上執行權限（100755） | | `action.yml` | 新增用途／更新時間標頭與逐行繁中註解，所有設定值不變 | | `dockerfile` | 標頭更新時間刷新，指令本體不變 | | `README.md` | 重建：新增日誌格式說明、功能列表行號連結修正、更新時間刷新 | ## 驗證 - `node --check` 三個 JS 模組、`sh -n entrypoint.sh`、YAML 解析全部通過。 - 以臨時 git repo 實測三情境：`1.2.4-beta.3` → `1.2.4`（轉正式）、→ `1.2.4-beta.4`（beta 續號）、非法 `is_beta` 以 exit 1 結束，日誌皆為新格式。 - README 錨點一致性檢查 9/9 通過。 ## 風險與注意事項 - 日誌格式變更會影響任何解析 workflow log 的既有工具（若有）。 - `entrypoint.sh` 啟動訊息中的時間為寫檔時的固定字串（非執行當下時間），檔內已註解標註。 - Docker 映像未實際重新建置（dockerfile 指令本體與先前相同，僅註解時間更新）。 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jiantw83 added 1 commit 2026-07-16 02:26:10 +00:00

refactor: 統一日誌格式為 [階段][等級][時間] 並補齊指令檔文件與 README

docker-actions/template: CI / BUILD (pull_request) Successful in 4s

Details

1773c646d5

- logger.js format() 組字順序改為階段在前、等級居中、時間在後（Asia/Taipei）
- entrypoint.sh 啟動訊息改用新格式並更新標頭時間
- action.yml 新增用途/更新時間標頭與逐行繁中註解，設定值不變
- dockerfile 檔名維持小寫並與 action.yml 的 image 引用一致
- 新增 src/logger.js、src/version.js 模組與完整 JSDoc；重建 README.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

admin closed this pull request

2026-07-16 02:47:37 +00:00

admin reopened this pull request

2026-07-16 02:47:39 +00:00

admin closed this pull request

2026-07-16 02:47:54 +00:00

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: docker-actions/calculate-next-version#1