diff --git a/README.md b/README.md
new file mode 100644
index 0000000..add3d3a
--- /dev/null
+++ b/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 的公開方法，因此沒有對應的使用範例。