fix: keep Chinese downloads on OSS loading state

The Chinese download cards briefly exposed the GitHub fallback before OSS index validation completed. They now stay disabled while loading and only show GitHub if the OSS request or validation fails; English downloads remain unchanged.

Release note: 中文官网下载入口加载 OSS 索引期间不再短暂跳转 GitHub，仅在索引失败时回退。

sites/README.md

@@ -71,6 +71,10 @@ Windows、macOS 和 Linux 下载卡片分别提供处理器架构与安装包类
 整组按钮会以 fail-closed 方式继续指向 GitHub 最新正式 Release，不会混用
 部分 OSS 数据：
 
+中文页面等待 OSS 索引时，三个正式下载入口保持禁用并显示加载状态，不会先
+短暂渲染或跳转到 GitHub。只有索引请求或完整校验明确失败后，正式下载入口
+才会显示 GitHub Release 回退；英文页面仍始终直接使用 GitHub Release。
+
 ```text
 https://github.com/mesalogo/goodbuddy/releases/latest
 ```

sites/app.js

@@ -28,6 +28,8 @@
   ];
   let verifiedRelease;
   let verifiedLoongArchPreview;
+  let releaseLoadState = "loading";
+  let loongArchPreviewLoadState = "loading";
   const interfaceCopy = isEnglish
     ? {
         themeDark: "Switch to dark theme",
@@ -162,6 +164,17 @@
     meta.textContent = "实验预览 · 仅 DEB · 索引尚未发布或校验失败。";
   };
 
+  const setDownloadPending = (link, meta, visibleText) => {
+    link.removeAttribute("href");
+    link.removeAttribute("target");
+    link.removeAttribute("rel");
+    link.setAttribute("aria-disabled", "true");
+    link.tabIndex = -1;
+    link.classList.add("is-disabled");
+    setLinkText(link, visibleText);
+    meta.textContent = "正在从 OSS 获取最新版本。";
+  };
+
   const setLoongArchFormat = (formatSelect, selected) => {
     for (const option of formatSelect.options) {
       const unavailable = selected && option.value !== "deb";
@@ -188,7 +201,11 @@
 
     if (loongArchSelected) {
       if (!verifiedLoongArchPreview) {
-        setDownloadUnavailable(link, meta);
+        if (loongArchPreviewLoadState === "loading") {
+          setDownloadPending(link, meta, "正在获取龙芯预览版下载信息…");
+        } else {
+          setDownloadUnavailable(link, meta);
+        }
         return;
       }
       setReleaseLink(
@@ -205,12 +222,20 @@
     }
 
     if (!verifiedRelease) {
-      setReleaseLink(
+      if (releaseLoadState === "loading") {
-        link,
+        setDownloadPending(
-        releaseFallbackUrl,
+          link,
-        `前往 GitHub 下载 ${platformNames[platform] ?? platform} →`,
+          meta,
-      );
+          `正在获取 ${platformNames[platform] ?? platform} 下载信息…`,
-      meta.textContent = "请在 GitHub Release 中选择对应的安装文件。";
+        );
+      } else {
+        setReleaseLink(
+          link,
+          releaseFallbackUrl,
+          `前往 GitHub 下载 ${platformNames[platform] ?? platform} →`,
+        );
+        meta.textContent = "请在 GitHub Release 中选择对应的安装文件。";
+      }
       return;
     }
 
@@ -247,11 +272,13 @@
 
   const setFallbackDownloads = () => {
     verifiedRelease = undefined;
+    releaseLoadState = "fallback";
     updateAllDownloadCards();
   };
 
   const setLoongArchPreviewUnavailable = () => {
     verifiedLoongArchPreview = undefined;
+    loongArchPreviewLoadState = "unavailable";
     const linuxCard = downloadCards.find(
       (card) => card.dataset.downloadCard === "linux",
     );
@@ -266,6 +293,7 @@
     }
     verifiedLoongArchPreview =
       releaseIndexApi.validateLoongArchPreviewIndex(payload);
+    loongArchPreviewLoadState = "ready";
     const linuxCard = downloadCards.find(
       (card) => card.dataset.downloadCard === "linux",
     );
@@ -279,6 +307,7 @@
       throw new Error("发布索引校验器不可用");
     }
     verifiedRelease = releaseIndexApi.validateReleaseIndex(payload);
+    releaseLoadState = "ready";
     updateAllDownloadCards();
   };
 

sites/index.html

@@ -271,14 +271,13 @@
                 </label>
               </div>
               <a
-                class="button button--download"
+                class="button button--download is-disabled"
-                href="https://github.com/mesalogo/goodbuddy/releases/latest"
-                target="_blank"
-                rel="noreferrer"
                 data-release-link
-              >下载 Windows 版 →<span class="sr-only">（在新窗口打开）</span></a>
+                aria-disabled="true"
+                tabindex="-1"
+              >正在获取 Windows 下载信息…<span class="sr-only">（在新窗口打开）</span></a>
               <p class="download-meta" data-download-meta aria-live="polite">
-                正在获取最新版本，暂时可前往 GitHub 下载。
+                正在从 OSS 获取最新版本。
               </p>
             </article>
             <article class="download-card">
@@ -305,14 +304,13 @@
                 </label>
               </div>
               <a
-                class="button button--download"
+                class="button button--download is-disabled"
-                href="https://github.com/mesalogo/goodbuddy/releases/latest"
-                target="_blank"
-                rel="noreferrer"
                 data-release-link
-              >下载 macOS 版 →<span class="sr-only">（在新窗口打开）</span></a>
+                aria-disabled="true"
+                tabindex="-1"
+              >正在获取 macOS 下载信息…<span class="sr-only">（在新窗口打开）</span></a>
               <p class="download-meta" data-download-meta aria-live="polite">
-                正在获取最新版本，暂时可前往 GitHub 下载。
+                正在从 OSS 获取最新版本。
               </p>
             </article>
             <article class="download-card">
@@ -339,14 +337,13 @@
                 </label>
               </div>
               <a
-                class="button button--download"
+                class="button button--download is-disabled"
-                href="https://github.com/mesalogo/goodbuddy/releases/latest"
-                target="_blank"
-                rel="noreferrer"
                 data-release-link
-              >下载 Linux 版 →<span class="sr-only">（在新窗口打开）</span></a>
+                aria-disabled="true"
+                tabindex="-1"
+              >正在获取 Linux 下载信息…<span class="sr-only">（在新窗口打开）</span></a>
               <p class="download-meta" data-download-meta aria-live="polite">
-                正在获取最新版本，暂时可前往 GitHub 下载。
+                正在从 OSS 获取最新版本。
               </p>
             </article>
           </div>

sites/scripts/app.test.mjs

@@ -282,6 +282,36 @@ test("enables only a validated LoongArch preview download", async () => {
   dom.window.close();
 });
 
+test("keeps Chinese downloads disabled while the OSS indexes are loading", async () => {
+  const { dom, window } = renderLoongArchPreview({
+    goodBuddyVersion: "0.11.5",
+    artifact: {
+      size: 186_853_872,
+      sha256: "a".repeat(64),
+      url: "https://goodbuddy.oss-cn-beijing.aliyuncs.com/releases/loongarch-preview/v0.11.5/GoodBuddy-0.11.5-linux-loong64-preview.deb",
+    },
+  });
+  const arch = window.document.querySelector("[data-download-arch]");
+  const link = window.document.querySelector("[data-release-link]");
+  const meta = window.document.querySelector("[data-download-meta]");
+
+  assert.equal(link.hasAttribute("href"), false);
+  assert.equal(link.getAttribute("aria-disabled"), "true");
+  assert.equal(link.tabIndex, -1);
+  assert.equal(link.classList.contains("is-disabled"), true);
+  assert.equal(link.textContent, "正在获取 Linux 下载信息…（在新窗口打开）");
+  assert.equal(meta.textContent, "正在从 OSS 获取最新版本。");
+
+  arch.value = "loong64";
+  arch.dispatchEvent(new window.Event("change"));
+  assert.equal(link.hasAttribute("href"), false);
+  assert.equal(link.getAttribute("aria-disabled"), "true");
+  assert.equal(link.textContent, "正在获取龙芯预览版下载信息…（在新窗口打开）");
+  assert.equal(meta.textContent, "正在从 OSS 获取最新版本。");
+  await new Promise((resolve) => window.setTimeout(resolve, 0));
+  dom.window.close();
+});
+
 test("keeps the LoongArch preview disabled when its index is unavailable", async () => {
   const { dom, window } = renderLoongArchPreview(null);
   await new Promise((resolve) => window.setTimeout(resolve, 0));

sites/scripts/validate.mjs

@@ -311,11 +311,12 @@ const releaseLinks = [
 report(releaseLinks.length >= 3, "缺少三个桌面系统的官方下载入口");
 for (const link of releaseLinks) {
   report(
-    /href="https:\/\/github\.com\/mesalogo\/goodbuddy\/releases\/latest"/.test(link),
+    !/\shref=/.test(link),
-    `下载入口必须指向官方最新 Release：${link}`,
+    `中文下载入口加载期间不得预先指向 GitHub：${link}`,
   );
-  report(/target="_blank"/.test(link), `下载入口必须在新窗口打开：${link}`);
+  report(/aria-disabled="true"/.test(link), `中文下载入口加载期间必须禁用：${link}`);
-  report(/rel="[^"]*noreferrer[^"]*"/.test(link), `下载入口缺少 noreferrer：${link}`);
+  report(/tabindex="-1"/.test(link), `禁用的中文下载入口不得进入 Tab 顺序：${link}`);
+  report(/\bis-disabled\b/.test(link), `中文下载入口缺少禁用样式：${link}`);
 }
 report(
   (html.match(/data-download-card="(?:windows|macos|linux)"/g) ?? []).length === 3,