docs(README): 重建專案說明

.gitea/workflows/master.yaml

@@ -16,6 +16,6 @@ jobs:
         fetch-depth: 0
     - name: Get Commit Tag
       id: commit
-      run: echo "tag=$(git for-each-ref --sort=-creatordate --format='%(refname:strip=2)' refs/tags --contains ${{ env.COMMIT_SHA }} | head -n 1)" >> $GITEA_OUTPUT
+      run: echo "tag=$(git for-each-ref --sort=-refname --format='%(refname:strip=2)' refs/tags --contains ${{ env.COMMIT_SHA }} | head -n 1)" >> $GITEA_OUTPUT
     - name: Show Tag
       run: echo "${{ steps.commit.outputs.tag }}"

README.md

@@ -0,0 +1,37 @@
+# calculate-version
+
+更新時間：2026/07/11 14:03:52（Asia/Taipei）
+
+這個專案是一個 Gitea Docker action，會讀取 repository 的 release 清單，計算下一個正式版或 beta 版本號，並將結果輸出成 action output。
+
+## 專案列表
+
+### 專案描述表
+
+| 專案名稱 | 專案描述 |
+| --- | --- |
+| [calculate-version](https://gitea.jsc.idv.tw/actions/calculate-version/src/branch/develop/) | 這是一個用來計算 Gitea release 下一版版本號的 Node.js action，支援正式版與 beta 版推算。 |
+
+### 參考專案表
+
+| 專案名稱 | 參考專案列表 |
+| --- | --- |
+| [calculate-version](https://gitea.jsc.idv.tw/actions/calculate-version/src/branch/develop/) | 無 |
+
+### NuGet 套件表
+
+| 專案名稱 | NuGet 套件列表 |
+| --- | --- |
+| [calculate-version](https://gitea.jsc.idv.tw/actions/calculate-version/src/branch/develop/) | 無 |
+
+## 功能列表
+
+### calculate-version
+
+| 功能名稱 | 功能描述 |
+| --- | --- |
+| 無 | 此專案未公開可列入 README 的功能。 |
+
+## 使用範例
+
+此專案目前沒有可對外列入 README 的公開方法，因此沒有對應的使用範例。

src/index.js

@@ -4,13 +4,19 @@ const https = require('https');
 const { URL } = require('url');
 
 const RELEASES_PER_PAGE = 10;
+let currentStage = null;
 
 function section(title) {
-  process.stdout.write(`\n==================================================\n${title}\n--------------------------------------------------\n`);
+  currentStage = title;
 }
 
 function info(message) {
-  process.stdout.write(`[info] ${message}\n`);
+  const timestamp = new Date()
+    .toLocaleString('sv-SE', { timeZone: 'Asia/Taipei', hour12: false })
+    .replace(/-/g, '/');
+  const stagePrefix = currentStage ? `[${currentStage}]` : '';
+
+  process.stdout.write(`${stagePrefix}[INF][${timestamp}]: ${message}\n`);
 }
 
 function fail(message) {