chore: updater autobuild (#5295)

* chore(updater): configure autobuild channel and refresh suffixes * feat(updater): add channel-aware updater and UI integration * feat(updater): support channel-specific updater command * feat(updater): enable downgrade-aware updates for autobuild channel * fix(updater): tighten prerelease downgrade gating and forward target * style: prettier
2026-11-13 22:32:15 +08:00 · 2025-11-03 15:39:07 +08:00
parent af2c4429a1
commit 1c43996614
29 changed files with 699 additions and 98 deletions
@@ -5,12 +5,12 @@
 *   pnpm release-version <version>
 *
 * <version> can be:
- *   - A full semver version (e.g., 1.2.3, v1.2.3, 1.2.3-beta, v1.2.3+build)
+ *   - A full semver version (e.g., 1.2.3, v1.2.3, 1.2.3-beta, v1.2.3-rc.1)
 *   - A tag: "alpha", "beta", "rc", "autobuild", "autobuild-latest", or "deploytest"
 *     - "alpha", "beta", "rc": Appends the tag to the current base version (e.g., 1.2.3-beta)
- *     - "autobuild": Appends a timestamped autobuild tag (e.g., 1.2.3+autobuild.2406101530)
- *     - "autobuild-latest": Appends an autobuild tag with latest Tauri commit (e.g., 1.2.3+autobuild.0614.a1b2c3d)
- *     - "deploytest": Appends a timestamped deploytest tag (e.g., 1.2.3+deploytest.2406101530)
+ *     - "autobuild": Appends a timestamped autobuild tag (e.g., 1.2.3-autobuild.0610.cc39b2.r2)
+ *     - "autobuild-latest": Appends an autobuild tag with latest Tauri commit (e.g., 1.2.3-autobuild.0610.a1b2c3d.r2)
+ *     - "deploytest": Appends a timestamped deploytest tag (e.g., 1.2.3-deploytest.0610.cc39b2.r2)
 *
 * Examples:
 *   pnpm release-version 1.2.3
@@ -30,10 +30,12 @@
 */

 import { execSync } from "child_process";
-import { program } from "commander";
 import fs from "fs/promises";
+import process from "node:process";
 import path from "path";

+import { program } from "commander";
+
 /**
 * 获取当前 git 短 commit hash
 * @returns {string}
@@ -73,41 +75,91 @@ function getLatestTauriCommit() {
 }

 /**
- * 生成短时间戳（格式：MMDD）或带 commit（格式：MMDD.cc39b27）
- * 使用 Asia/Shanghai 时区
- * @param {boolean} withCommit 是否带 commit
- * @param {boolean} useTauriCommit 是否使用 Tauri 相关的 commit（仅当 withCommit 为 true 时有效）
+ * 获取 Asia/Shanghai 时区的日期片段
 * @returns {string}
 */
-function generateShortTimestamp(withCommit = false, useTauriCommit = false) {
+function getLocalDatePart() {
  const now = new Date();

-  const formatter = new Intl.DateTimeFormat("en-CA", {
+  const dateFormatter = new Intl.DateTimeFormat("en-CA", {
    timeZone: "Asia/Shanghai",
    month: "2-digit",
    day: "2-digit",
  });
+  const dateParts = Object.fromEntries(
+    dateFormatter.formatToParts(now).map((part) => [part.type, part.value]),
+  );

-  const parts = formatter.formatToParts(now);
-  const month = parts.find((part) => part.type === "month").value;
-  const day = parts.find((part) => part.type === "day").value;
+  const month = dateParts.month ?? "00";
+  const day = dateParts.day ?? "00";

-  if (withCommit) {
-    const gitShort = useTauriCommit
-      ? getLatestTauriCommit()
-      : getGitShortCommit();
-    return `${month}${day}.${gitShort}`;
-  }
  return `${month}${day}`;
 }

+/**
+ * 获取 GitHub Actions 运行编号（若存在）
+ * @returns {string|null}
+ */
+function getRunIdentifier() {
+  const attempt = process.env.GITHUB_RUN_ATTEMPT;
+  if (attempt && /^[0-9]+$/.test(attempt)) {
+    const attemptNumber = Number.parseInt(attempt, 10);
+    if (!Number.isNaN(attemptNumber)) {
+      return `r${attemptNumber.toString(36)}`;
+    }
+  }
+
+  const runNumber = process.env.GITHUB_RUN_NUMBER;
+  if (runNumber && /^[0-9]+$/.test(runNumber)) {
+    const runNum = Number.parseInt(runNumber, 10);
+    if (!Number.isNaN(runNum)) {
+      return `r${runNum.toString(36)}`;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 生成用于自动构建类渠道的版本后缀
+ * @param {Object} options
+ * @param {boolean} [options.includeCommit=false]
+ * @param {"current"|"tauri"} [options.commitSource="current"]
+ * @param {boolean} [options.includeRun=true]
+ * @returns {string}
+ */
+function generateChannelSuffix({
+  includeCommit = false,
+  commitSource = "current",
+  includeRun = true,
+} = {}) {
+  const segments = [];
+  const date = getLocalDatePart();
+  segments.push(date);
+
+  if (includeCommit) {
+    const commit =
+      commitSource === "tauri" ? getLatestTauriCommit() : getGitShortCommit();
+    segments.push(commit);
+  }
+
+  if (includeRun) {
+    const run = getRunIdentifier();
+    if (run) {
+      segments.push(run);
+    }
+  }
+
+  return segments.join(".");
+}
+
 /**
 * 验证版本号格式
 * @param {string} version
 * @returns {boolean}
 */
 function isValidVersion(version) {
-  return /^v?\d+\.\d+\.\d+(-(alpha|beta|rc)(\.\d+)?)?(\+[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*)?$/i.test(
+  return /^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(
    version,
  );
 }
@@ -122,13 +174,14 @@ function normalizeVersion(version) {
 }

 /**
- * 提取基础版本号（去掉所有 -tag 和 +build 部分）
+ * 提取基础版本号（去掉所有 pre-release 和 build metadata）
 * @param {string} version
 * @returns {string}
 */
 function getBaseVersion(version) {
-  let base = version.replace(/-(alpha|beta|rc)(\.\d+)?/i, "");
-  base = base.replace(/\+[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*/g, "");
+  const cleaned = version.startsWith("v") ? version.slice(1) : version;
+  const withoutBuild = cleaned.split("+")[0];
+  const [base] = withoutBuild.split("-");
  return base;
 }

@@ -273,17 +326,23 @@ async function main(versionArg) {
      const baseVersion = getBaseVersion(currentVersion);

      if (versionArg.toLowerCase() === "autobuild") {
-        // 格式: 2.3.0+autobuild.1004.cc39b27
-        // 使用 Tauri 相关的最新 commit hash
-        newVersion = `${baseVersion}+autobuild.${generateShortTimestamp(true, true)}`;
+        // 格式: 2.3.0-autobuild.0610.cc39b2.r2
+        newVersion = `${baseVersion}-autobuild.${generateChannelSuffix({
+          includeCommit: true,
+          commitSource: "tauri",
+        })}`;
      } else if (versionArg.toLowerCase() === "autobuild-latest") {
-        // 格式: 2.3.0+autobuild.1004.a1b2c3d (使用最新 Tauri 提交)
-        const latestTauriCommit = getLatestTauriCommit();
-        newVersion = `${baseVersion}+autobuild.${generateShortTimestamp()}.${latestTauriCommit}`;
+        // 格式: 2.3.0-autobuild.0610.a1b2c3d.r2 (使用最新 Tauri 提交)
+        newVersion = `${baseVersion}-autobuild.${generateChannelSuffix({
+          includeCommit: true,
+          commitSource: "tauri",
+        })}`;
      } else if (versionArg.toLowerCase() === "deploytest") {
-        // 格式: 2.3.0+deploytest.1004.cc39b27
-        // 使用 Tauri 相关的最新 commit hash
-        newVersion = `${baseVersion}+deploytest.${generateShortTimestamp(true, true)}`;
+        // 格式: 2.3.0-deploytest.0610.cc39b2.r2
+        newVersion = `${baseVersion}-deploytest.${generateChannelSuffix({
+          includeCommit: true,
+          commitSource: "tauri",
+        })}`;
      } else {
        newVersion = `${baseVersion}-${versionArg.toLowerCase()}`;
      }
@@ -1,5 +1,8 @@
-import fetch from "node-fetch";
+import process from "node:process";
+
 import { getOctokit, context } from "@actions/github";
+import fetch from "node-fetch";
+
 import { resolveUpdateLog, resolveUpdateLogDefault } from "./updatelog.mjs";

 // Add stable update JSON filenames
@@ -10,6 +13,11 @@ const UPDATE_JSON_PROXY = "update-proxy.json";
 const ALPHA_TAG_NAME = "updater-alpha";
 const ALPHA_UPDATE_JSON_FILE = "update.json";
 const ALPHA_UPDATE_JSON_PROXY = "update-proxy.json";
+// Add autobuild update JSON filenames
+const AUTOBUILD_SOURCE_TAG_NAME = "autobuild";
+const AUTOBUILD_TAG_NAME = "updater-autobuild";
+const AUTOBUILD_UPDATE_JSON_FILE = "update.json";
+const AUTOBUILD_UPDATE_JSON_PROXY = "update-proxy.json";

 /// generate update.json
 /// upload to update tag's release asset
@@ -48,12 +56,12 @@ async function resolveUpdater() {

  // More flexible tag detection with regex patterns
  const stableTagRegex = /^v\d+\.\d+\.\d+$/; // Matches vX.Y.Z format
-  // const preReleaseRegex = /^v\d+\.\d+\.\d+-(alpha|beta|rc|pre)/i; // Matches vX.Y.Z-alpha/beta/rc format
  const preReleaseRegex = /^(alpha|beta|rc|pre)$/i; // Matches exact alpha/beta/rc/pre tags

-  // Get the latest stable tag and pre-release tag
+  // Get tags for known channels
  const stableTag = tags.find((t) => stableTagRegex.test(t.name));
  const preReleaseTag = tags.find((t) => preReleaseRegex.test(t.name));
+  const autobuildTag = tags.find((t) => t.name === AUTOBUILD_SOURCE_TAG_NAME);

  console.log("All tags:", tags.map((t) => t.name).join(", "));
  console.log("Stable tag:", stableTag ? stableTag.name : "None found");
@@ -61,32 +69,79 @@ async function resolveUpdater() {
    "Pre-release tag:",
    preReleaseTag ? preReleaseTag.name : "None found",
  );
+  console.log(
+    "Autobuild tag:",
+    autobuildTag ? autobuildTag.name : "None found",
+  );
  console.log();

-  // Process stable release
-  if (stableTag) {
-    await processRelease(github, options, stableTag, false);
-  }
+  const channels = [
+    {
+      name: "stable",
+      tagName: stableTag?.name,
+      updateReleaseTag: UPDATE_TAG_NAME,
+      jsonFile: UPDATE_JSON_FILE,
+      proxyFile: UPDATE_JSON_PROXY,
+      prerelease: false,
+    },
+    {
+      name: "alpha",
+      tagName: preReleaseTag?.name,
+      updateReleaseTag: ALPHA_TAG_NAME,
+      jsonFile: ALPHA_UPDATE_JSON_FILE,
+      proxyFile: ALPHA_UPDATE_JSON_PROXY,
+      prerelease: true,
+    },
+    {
+      name: "autobuild",
+      tagName: autobuildTag?.name ?? AUTOBUILD_SOURCE_TAG_NAME,
+      updateReleaseTag: AUTOBUILD_TAG_NAME,
+      jsonFile: AUTOBUILD_UPDATE_JSON_FILE,
+      proxyFile: AUTOBUILD_UPDATE_JSON_PROXY,
+      prerelease: true,
+    },
+  ];

-  // Process pre-release if found
-  if (preReleaseTag) {
-    await processRelease(github, options, preReleaseTag, true);
+  for (const channel of channels) {
+    if (!channel.tagName) {
+      console.log(`[${channel.name}] tag not found, skipping...`);
+      continue;
+    }
+    await processRelease(github, options, channel);
  }
 }

-// Process a release (stable or alpha) and generate update files
-async function processRelease(github, options, tag, isAlpha) {
-  if (!tag) return;
+// Process a release and generate update files for the specified channel
+async function processRelease(github, options, channelConfig) {
+  if (!channelConfig) return;
+
+  const {
+    tagName,
+    name: channelName,
+    updateReleaseTag,
+    jsonFile,
+    proxyFile,
+    prerelease,
+  } = channelConfig;
+
+  const channelLabel =
+    channelName.charAt(0).toUpperCase() + channelName.slice(1);

  try {
    const { data: release } = await github.rest.repos.getReleaseByTag({
      ...options,
-      tag: tag.name,
+      tag: tagName,
    });

+    const releaseTagName = release.tag_name ?? tagName;
+
+    console.log(
+      `[${channelName}] Preparing update metadata from release "${releaseTagName}"`,
+    );
+
    const updateData = {
-      name: tag.name,
-      notes: await resolveUpdateLog(tag.name).catch(() =>
+      name: releaseTagName,
+      notes: await resolveUpdateLog(releaseTagName).catch(() =>
        resolveUpdateLogDefault().catch(() => "No changelog available"),
      ),
      pub_date: new Date().toISOString(),
@@ -186,13 +241,15 @@ async function processRelease(github, options, tag, isAlpha) {
    });

    await Promise.allSettled(promises);
-    console.log(updateData);
+    console.log(`[${channelName}] Update data snapshot:`, updateData);

    // maybe should test the signature as well
    // delete the null field
    Object.entries(updateData.platforms).forEach(([key, value]) => {
      if (!value.url) {
-        console.log(`[Error]: failed to parse release for "${key}"`);
+        console.log(
+          `[${channelName}] [Error]: failed to parse release for "${key}"`,
+        );
        delete updateData.platforms[key];
      }
    });
@@ -205,15 +262,14 @@ async function processRelease(github, options, tag, isAlpha) {
        updateDataNew.platforms[key].url =
          "https://download.clashverge.dev/" + value.url;
      } else {
-        console.log(`[Error]: updateDataNew.platforms.${key} is null`);
+        console.log(
+          `[${channelName}] [Error]: updateDataNew.platforms.${key} is null`,
+        );
      }
    });

-    // Get the appropriate updater release based on isAlpha flag
-    const releaseTag = isAlpha ? ALPHA_TAG_NAME : UPDATE_TAG_NAME;
    console.log(
-      `Processing ${isAlpha ? "alpha" : "stable"} release:`,
-      releaseTag,
+      `[${channelName}] Processing update release target "${updateReleaseTag}"`,
    );

    try {
@@ -223,30 +279,28 @@ async function processRelease(github, options, tag, isAlpha) {
        // Try to get the existing release
        const response = await github.rest.repos.getReleaseByTag({
          ...options,
-          tag: releaseTag,
+          tag: updateReleaseTag,
        });
        updateRelease = response.data;
        console.log(
-          `Found existing ${releaseTag} release with ID: ${updateRelease.id}`,
+          `[${channelName}] Found existing ${updateReleaseTag} release with ID: ${updateRelease.id}`,
        );
      } catch (error) {
        // If release doesn't exist, create it
        if (error.status === 404) {
          console.log(
-            `Release with tag ${releaseTag} not found, creating new release...`,
+            `[${channelName}] Release with tag ${updateReleaseTag} not found, creating new release...`,
          );
          const createResponse = await github.rest.repos.createRelease({
            ...options,
-            tag_name: releaseTag,
-            name: isAlpha
-              ? "Auto-update Alpha Channel"
-              : "Auto-update Stable Channel",
-            body: `This release contains the update information for ${isAlpha ? "alpha" : "stable"} channel.`,
-            prerelease: isAlpha,
+            tag_name: updateReleaseTag,
+            name: `Auto-update ${channelLabel} Channel`,
+            body: `This release contains the update information for the ${channelName} channel.`,
+            prerelease,
          });
          updateRelease = createResponse.data;
          console.log(
-            `Created new ${releaseTag} release with ID: ${updateRelease.id}`,
+            `[${channelName}] Created new ${updateReleaseTag} release with ID: ${updateRelease.id}`,
          );
        } else {
          // If it's another error, throw it
@@ -255,11 +309,8 @@ async function processRelease(github, options, tag, isAlpha) {
      }

      // File names based on release type
-      const jsonFile = isAlpha ? ALPHA_UPDATE_JSON_FILE : UPDATE_JSON_FILE;
-      const proxyFile = isAlpha ? ALPHA_UPDATE_JSON_PROXY : UPDATE_JSON_PROXY;
-
      // Delete existing assets with these names
-      for (let asset of updateRelease.assets) {
+      for (const asset of updateRelease.assets) {
        if (asset.name === jsonFile) {
          await github.rest.repos.deleteReleaseAsset({
            ...options,
@@ -270,7 +321,12 @@ async function processRelease(github, options, tag, isAlpha) {
        if (asset.name === proxyFile) {
          await github.rest.repos
            .deleteReleaseAsset({ ...options, asset_id: asset.id })
-            .catch(console.error); // do not break the pipeline
+            .catch((deleteError) =>
+              console.error(
+                `[${channelName}] Failed to delete existing proxy asset:`,
+                deleteError.message,
+              ),
+            ); // do not break the pipeline
        }
      }

@@ -290,20 +346,22 @@ async function processRelease(github, options, tag, isAlpha) {
      });

      console.log(
-        `Successfully uploaded ${isAlpha ? "alpha" : "stable"} update files to ${releaseTag}`,
+        `[${channelName}] Successfully uploaded update files to ${updateReleaseTag}`,
      );
    } catch (error) {
      console.error(
-        `Failed to process ${isAlpha ? "alpha" : "stable"} release:`,
+        `[${channelName}] Failed to process update release:`,
        error.message,
      );
    }
  } catch (error) {
    if (error.status === 404) {
-      console.log(`Release not found for tag: ${tag.name}, skipping...`);
+      console.log(
+        `[${channelName}] Release not found for tag: ${tagName}, skipping...`,
+      );
    } else {
      console.error(
-        `Failed to get release for tag: ${tag.name}`,
+        `[${channelName}] Failed to get release for tag: ${tagName}`,
        error.message,
      );
    }