feat(release-tag-version): 支援測試標籤並強化釋出參數 #16

2026-06-26T15:07:52Z

jiantw83 commented

2026-06-26 15:07:52 +00:00

變更摘要

新增 is_debug input，並轉傳給 docker-actions/calculate-version，支援產生測試標籤版本。
補齊 files input 描述，讓 action metadata 可直接呈現用途。
精簡 action.yml 過度詳細的註解，只保留必要的業務摘要與關鍵邏輯。
在寫入 GITHUB_OUTPUT 前驗證版本格式，避免不合法版本值破壞輸出檔格式。
將 release 的 target_commitish 改為 gitea.sha，讓 release/tag 錨定到觸發 workflow 的實際 commit。
將版本計算 step id 由 version-calculate 改為 calculate-version，並同步更新所有 steps.calculate-version.outputs.version 參照。
更新 README 的 is_debug 使用範例，並清空已修復的 AI review findings。

影響範圍

action.yml：composite action inputs、版本計算 step id、版本計算參數轉傳、release 參數組合與 release 目標 commit。
README.md：使用範例與流程說明。
.gitea/ai-review/findings.json：已修復 finding 狀態。

Commit

21ab5c1 feat(release-tag-version): 支援測試標籤並強化釋出參數
265049a docs(README): 補充測試標籤參數用法
21470d1 chore(ai-review 狀態): 清除已修復 findings
49bb8c2 refactor(release-tag-version): 統一版本計算步驟 id

驗證

git diff --check
確認 action.yml 沒有殘留 steps.version-calculate 或 id: version-calculate。
node -e 解析 .gitea/ai-review/findings.json，確認為 top-level JSON array 且目前 0 筆。

風險與注意事項

版本格式目前允許數字、點號，以及以 .、_、- 接續的英數片段；若 calculate-version 未來輸出其他合法格式，需要同步調整 regex。
step id 已改為 calculate-version，後續若有外部文件引用內部 step id，需同步更新。

## 變更摘要 - 新增 `is_debug` input，並轉傳給 `docker-actions/calculate-version`，支援產生測試標籤版本。 - 補齊 `files` input 描述，讓 action metadata 可直接呈現用途。 - 精簡 `action.yml` 過度詳細的註解，只保留必要的業務摘要與關鍵邏輯。 - 在寫入 `GITHUB_OUTPUT` 前驗證版本格式，避免不合法版本值破壞輸出檔格式。 - 將 release 的 `target_commitish` 改為 `gitea.sha`，讓 release/tag 錨定到觸發 workflow 的實際 commit。 - 將版本計算 step id 由 `version-calculate` 改為 `calculate-version`，並同步更新所有 `steps.calculate-version.outputs.version` 參照。 - 更新 README 的 `is_debug` 使用範例，並清空已修復的 AI review findings。 ## 影響範圍 - `action.yml`：composite action inputs、版本計算 step id、版本計算參數轉傳、release 參數組合與 release 目標 commit。 - `README.md`：使用範例與流程說明。 - `.gitea/ai-review/findings.json`：已修復 finding 狀態。 ## Commit - `21ab5c1` feat(release-tag-version): 支援測試標籤並強化釋出參數 - `265049a` docs(README): 補充測試標籤參數用法 - `21470d1` chore(ai-review 狀態): 清除已修復 findings - `49bb8c2` refactor(release-tag-version): 統一版本計算步驟 id ## 驗證 - `git diff --check` - 確認 `action.yml` 沒有殘留 `steps.version-calculate` 或 `id: version-calculate`。 - `node -e` 解析 `.gitea/ai-review/findings.json`，確認為 top-level JSON array 且目前 0 筆。 ## 風險與注意事項 - 版本格式目前允許數字、點號，以及以 `.`、`_`、`-` 接續的英數片段；若 `calculate-version` 未來輸出其他合法格式，需要同步調整 regex。 - step id 已改為 `calculate-version`，後續若有外部文件引用內部 step id，需同步更新。

jiantw83 added 3 commits 2026-06-26 15:07:52 +00:00

feat(release-tag-version): 支援測試標籤並強化釋出參數 21ab5c1487

docs(README): 補充測試標籤參數用法 265049a96f

chore(ai-review 狀態): 清除已修復 findings 21470d1a89

jiantw83 added 1 commit 2026-06-26 15:12:48 +00:00

refactor(release-tag-version): 統一版本計算步驟 id 49bb8c2dc4

admin approved these changes 2026-06-26 15:14:15 +00:00

admin merged commit 91d3c463b5 into master

2026-06-26 15:14:18 +00:00

Sign in to join this conversation.