- tag 刪除失敗後補上 hadFailure 檢查，確保以非 0 結束
- GITEA_SERVER_URL 的 log 改為遮罩後 origin，API URL 清除 userinfo/query
- release id 驗證為正整數才組 DELETE URL
- isEmptyOrNull 不再把字串 'null' 當空值，改在環境變數來源正規化
- 共用 keep-alive https.Agent 減少重複建連線
- 分頁抓取加入 MAX_PAGES 上限避免無限迴圈
- 批次大小抽成 DELETE_CONCURRENCY 常數
- 錯誤處理保留 currentStage 階段上下文

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

@@ -1,1 +2,4 @@
+# 更新日期：2026/07/11 21:02:25
+
+# 允許在建置時指定 Node.js 版本標籤
 ARG NODE_VERSION=alpine

@@ -12,0 +15,4 @@
+  # RUNNER_TOKEN 用於授權呼叫 Gitea API；未提供時會改用 secrets
+  RUNNER_TOKEN:
+    # 參數說明，讓呼叫端知道這是 Runner Token
+    description: 'GitHub Runner Token'

@@ -9,0 +7,4 @@
+ts=$(TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S')
+printf '[INF][%s]: Action: CLEANUP OLD RELEASES\n' "$ts"
+printf '[INF][%s]: 用途: 清理舊版成品\n' "$ts"
+printf '[INF][%s]: 更新時間: 2026/07/11\n' "$ts"

@@ -12,0 +9,4 @@
+ * @param {Date} [date=new Date()] 要格式化的時間。
+ * @returns {string} `yyyy/MM/dd HH:mm:ss` 格式時間字串。
+ */
+function formatTaipeiTimestamp(date = new Date()) {

@@ -12,0 +66,4 @@
+/**
+ * 保留舊介面以維持草稿對應，實際上不再輸出橫幅。
+ */
+function separator() {}

@@ -12,0 +69,4 @@
+function separator() {}
+
+/**
+ * 切換目前訊息所屬區塊，供 log 前綴使用。

@@ -12,0 +85,4 @@
+function info(message) {
+  writeStdout('INF', message);
+}
+

@@ -12,0 +92,4 @@
+ * @param {string} message 訊息內容。
+ */
+function success(message) {
+  writeStdout('INF', message);

@@ -12,0 +112,4 @@
+function fail(message) {
+  writeStderr('ERR', message);
+}
+

@@ -12,2 +136,4 @@
+    fail(`${name} is required`);
+    process.exit(1);
   }
 }

@@ -16,0 +148,4 @@
+  if (!/^[0-9]+$/.test(value)) {
+    fail(`${name} must be a non-negative integer`);
+    process.exit(1);
+  }

@@ -16,0 +159,4 @@
+ * @returns {Promise<{ statusCode: number, body: string }>} 回應狀態碼與內容。
+ */
+function requestJson(url, { method = 'GET', headers = {} } = {}) {
+  return new Promise((resolve, reject) => {

@@ -16,0 +161,4 @@
+function requestJson(url, { method = 'GET', headers = {} } = {}) {
+  return new Promise((resolve, reject) => {
+    const target = new URL(url);
+    const client = target.protocol === 'http:' ? http : https;

@@ -16,0 +208,4 @@
+      throw new Error(`GET ${pageUrl} failed with HTTP ${statusCode}: ${body}`);
+    }
+
+    const data = JSON.parse(body || '[]');

@@ -16,0 +209,4 @@
+    }
+
+    const data = JSON.parse(body || '[]');
+    if (!Array.isArray(data)) {

@@ -16,0 +266,4 @@
+
+  const releaseJson = await fetchAllPages(releaseApiUrl, authHeaders);
+  releaseJson.sort((left, right) => {
+    if (left.created_at < right.created_at) {

@@ -16,0 +287,4 @@
+    section('刪除舊版本成品');
+
+    const releaseToDelete = releaseJson.slice(keepCount);
+    for (const releaseItem of releaseToDelete) {

@@ -16,0 +299,4 @@
+      info(`DELETE ${releaseTag} (${releaseName})`);
+
+      const { statusCode } = await deleteResource(deleteUrl, authHeaders);
+      if (statusCode === 204) {

@@ -16,0 +309,4 @@
+
+  section('刪除未指定 release 的 tag');
+
+  const currentReleaseJson = await fetchAllPages(releaseApiUrl, authHeaders);

@@ -16,0 +323,4 @@
+  const tagJson = await fetchAllPages(tagApiUrl, authHeaders);
+  info(`TAG_COUNT=${tagJson.length}`);
+
+  for (const tagItem of tagJson) {

@@ -3,1 +5,4 @@
+ARG NODE_VERSION=22-alpine
+
+# 使用指定版本的 Node.js 基底映像
 FROM node:${NODE_VERSION}

@@ -1,15 +1,400 @@
-const fs = require('fs');
+const https = require('https');

@@ -12,0 +22,4 @@
+function formatTaipeiTimestamp(date = new Date()) {
+  const parts = taipeiFormatter.formatToParts(date);
+
+  const lookup = {};

@@ -16,0 +174,4 @@
+function request(url, { method = 'GET', headers = {} } = {}) {
+  return new Promise((resolve, reject) => {
+    const target = new URL(url);
+    if (target.protocol !== 'https:') {

@@ -16,0 +181,4 @@
+
+    const req = https.request(
+      target,
+      {

@@ -16,0 +296,4 @@
+  }
+
+  const releaseApiUrl = `${GITEA_SERVER_URL}/api/v1/repos/${GITEA_REPOSITORY}/releases`;
+

@@ -16,0 +350,4 @@
+
+  section('刪除未指定 release 的 tag');
+
+  const releaseTags = new Set(

@@ -12,0 +104,4 @@
+ *
+ * @param {string} title 區塊名稱。
+ */
+function section(title) {

@@ -12,0 +143,4 @@
+ */
+function isEmptyOrNull(value) {
+  return value === undefined || value === null || value === '' || value === 'null';
+}

@@ -16,0 +166,4 @@
+ * @param {string} name 參數名稱。
+ * @param {string} value 參數值。
+ */
+function requireInteger(name, value) {

@@ -16,0 +230,4 @@
+    const { statusCode, body } = await request(pageUrl, { headers });
+
+    if (statusCode < 200 || statusCode >= 300) {
+      throw new Error(`GET ${pageUrl} failed with HTTP ${statusCode}: ${summarizeResponseBody(body)}`);

@@ -16,0 +279,4 @@
+  for (let index = 0; index < items.length; index += batchSize) {
+    const batch = items.slice(index, index + batchSize);
+    await Promise.all(batch.map((item) => handler(item)));
+  }

@@ -12,0 +141,4 @@
+ * @param {*} value 要檢查的值。
+ * @returns {boolean} 如果是空值則回傳 `true`。
+ */
+function isEmptyOrNull(value) {

@@ -12,0 +152,4 @@
+ * @param {*} value 參數值。
+ */
+function requireValue(name, value) {
+  info(`${name}=${value}`);

@@ -16,0 +180,4 @@
+ * @param {{ method?: string, headers?: Record<string, string> }} [options] request 設定。
+ * @returns {Promise<{ statusCode: number, body: string }>} 回應狀態碼與內容。
+ */
+function request(url, { method = 'GET', headers = {} } = {}) {

@@ -16,0 +225,4 @@
+async function fetchAllPages(baseUrl, headers) {
+  const all = [];
+
+  for (let page = 1; ; page += 1) {

@@ -16,0 +334,4 @@
+    section('刪除舊版本成品');
+
+    const releaseToDelete = releaseJson.slice(keepCount);
+    await processInBatches(releaseToDelete, 4, async (releaseItem) => {

@@ -16,0 +342,4 @@
+        return;
+      }
+
+      const releaseTag = sanitizeLogText(releaseItem.tag_name || '');

@@ -16,0 +397,4 @@
+      info(`成功刪除未指定 release 的 tag: ${safeTagName}`);
+    } else {
+      hadFailure = true;
+      fail(`刪除 tag 失敗: ${safeTagName}, HTTP ${statusCode}`);

@@ -16,0 +406,4 @@
+main().catch((error) => {
+  currentStage = '';
+  fail(error instanceof Error ? error.stack || error.message : String(error));
+  process.exit(1);

@@ -16,0 +224,4 @@
+        method,
+        headers,
+        agent: keepAliveAgent,
+      },

@@ -16,0 +227,4 @@
+      },
+      (res) => {
+        const chunks = [];
+

@@ -16,0 +249,4 @@
+/**
+ * 逐頁抓取 JSON 陣列資料，直到回傳空頁為止；超過 `MAX_PAGES` 即中止並回報異常。
+ *
+ * @param {string} baseUrl 不含 page 參數的 API URL。

@@ -16,0 +316,4 @@
+    await Promise.all(batch.map((item) => handler(item)));
+  }
+}
+

@@ -16,0 +333,4 @@
+  requireInteger('KEEP_COUNT', KEEP_COUNT);
+
+  const keepCount = Number(KEEP_COUNT);
+  const authHeaders = {};

@@ -16,0 +342,4 @@
+  }
+
+  const serverBase = new URL(GITEA_SERVER_URL);
+  serverBase.username = '';

@@ -16,0 +360,4 @@
+    }
+
+    if (left.created_at > right.created_at) {
+      return -1;

@@ -16,0 +305,4 @@
+  const all = [];
+
+  for (let page = 1; ; page += 1) {
+    if (page > MAX_PAGES) {

@@ -16,0 +314,4 @@
+
+    if (statusCode < 200 || statusCode >= 300) {
+      throw new Error(`GET ${pageUrl} failed with HTTP ${statusCode}: ${summarizeResponseBody(body)}`);
+    }

@@ -16,0 +457,4 @@
+    const releaseToDelete = releaseJson.slice(keepCount);
+    const releaseResults = await processInBatches(releaseToDelete, DELETE_CONCURRENCY, async (releaseItem) => {
+      const releaseId = releaseItem?.id;
+      if (!Number.isSafeInteger(releaseId) || releaseId <= 0) {

@@ -16,0 +501,4 @@
+
+  const tagResults = await processInBatches(tagJson, DELETE_CONCURRENCY, async (tagItem) => {
+    const tagName = tagItem?.name;
+    if (isEmptyOrNull(tagName)) {

@@ -16,0 +533,4 @@
+main()
+  .catch((error) => {
+    fail(error instanceof Error ? error.stack || error.message : String(error));
+    process.exitCode = 1;