feat(install): linux-aarch64 + GitHub→GitCode(CN) mirror fallback (WS6) (#154)

* feat(install): add linux-aarch64 + GitHub→GitCode(CN) mirror fallback

- Platform detection now maps Linux-aarch64/Linux-arm64 → linux-aarch64 (Arch
  Linux ARM, aarch64 servers, Termux). Was linux-x86_64 + macosx-arm64 only.
- Download is mirror-aware: try GitHub (GLOBAL) first, fall back to GitCode
  (xlings-res/mcpp, CN) when GitHub is blocked/slow — so the one-liner works on
  CN/Termux without a manual flag. MCPP_MIRROR=CN forces GitCode. GitCode 'latest'
  resolved via /releases?per_page=100 + sort -V (default page misses recent vers).

Tested: x86_64 GitHub (0.0.60), CN GitCode (0.0.60), aarch64 URL 200.

* test(e2e): 45 — assert install.sh↔release.yml parity for linux-aarch64

install.sh now advertises linux-aarch64; the platform-mapping invariant
test pinned the old 'linux-x86_64, macosx-arm64' string and had no
aarch64 case, so it failed on the WS6 change. Add the Linux-aarch64→
linux-aarch64 mapping check, update the supported-platforms string, and
guard that release.yml publishes the mcpp-linux-aarch64.tar.gz alias
(parity with the existing macosx-arm64 guard) — keeping advertise↔publish
in lockstep.

Author: Sunrisepeak

install.sh

@@ -23,38 +23,82 @@ VERSION="${MCPP_VERSION:-latest}"
 PREFIX="${MCPP_PREFIX:-$HOME/.mcpp}"
 
 # ---- platform detection ---------------------------------------------------
+# OS+arch → release asset platform tag. Linux reports the arch as aarch64;
+# macOS reports it as arm64 (Apple). Arch Linux et al. are distro-agnostic here
+# (uname-based), so x86_64 and aarch64 Arch both work.
 uname_s=$(uname -s)
 uname_m=$(uname -m)
 case "${uname_s}-${uname_m}" in
-    Linux-x86_64)   PLAT="linux-x86_64" ;;
-    Darwin-arm64)   PLAT="macosx-arm64" ;;
+    Linux-x86_64)                 PLAT="linux-x86_64"  ;;
+    Linux-aarch64 | Linux-arm64)  PLAT="linux-aarch64" ;;   # aarch64 / arm64 alias
+    Darwin-arm64)                 PLAT="macosx-arm64"  ;;
     *)
         echo "error: unsupported platform ${uname_s}-${uname_m}." >&2
-        echo "       Currently supported: linux-x86_64, macosx-arm64." >&2
+        echo "       Currently supported: linux-x86_64, linux-aarch64, macosx-arm64." >&2
         echo "       Build from source instead:" >&2
         echo "       https://github.com/${REPO}#从源码构建开发者" >&2
         exit 1
         ;;
 esac
 
-# ---- resolve download URLs ------------------------------------------------
-if [[ "$VERSION" == "latest" ]]; then
-    BASE="https://github.com/${REPO}/releases/latest/download"
-    ASSET_NAME_GLOB="mcpp-*-${PLAT}.tar.gz"   # `latest` redirect uses fixed asset name
-    TARBALL_URL="${BASE}/mcpp-${PLAT}.tar.gz" # versionless alias served by the release
-else
-    BASE="https://github.com/${REPO}/releases/download/v${VERSION}"
-    TARBALL_URL="${BASE}/mcpp-${VERSION}-${PLAT}.tar.gz"
-fi
-SHA_URL="${TARBALL_URL}.sha256"
-
-# ---- fetch ----------------------------------------------------------------
+# ---- resolve + fetch (mirror-aware: GitHub GLOBAL → GitCode CN) ------------
+# Most users hit GitHub. On networks where GitHub is blocked/slow (e.g. CN,
+# Termux) we fall back to the GitCode mirror (xlings-res/mcpp), so the same
+# one-liner works without a manual --mirror flag. MCPP_MIRROR=CN forces GitCode.
 WORK=$(mktemp -d)
 trap 'rm -rf "$WORK"' EXIT
-echo ":: Downloading ${TARBALL_URL}"
-curl --fail --location --silent --show-error -o "$WORK/mcpp.tar.gz"  "$TARBALL_URL"
-curl --fail --location --silent --show-error -o "$WORK/mcpp.sha256" "$SHA_URL" || {
-    echo "warning: no .sha256 sidecar found, skipping verification" >&2
+
+GH_REL="https://github.com/${REPO}/releases"
+GTC_API="https://api.gitcode.com/api/v5/repos/xlings-res/mcpp"
+GTC_DL="https://gitcode.com/xlings-res/mcpp/releases/download"
+CT=8   # connect timeout (s) for the GitHub probe before falling back
+
+fetch_github() {
+    local url
+    if [[ "$VERSION" == "latest" ]]; then
+        url="${GH_REL}/latest/download/mcpp-${PLAT}.tar.gz"   # versionless alias
+    else
+        url="${GH_REL}/download/v${VERSION}/mcpp-${VERSION}-${PLAT}.tar.gz"
+    fi
+    echo ":: Trying GitHub: ${url}"
+    if curl --fail --location --silent --show-error \
+            --connect-timeout "$CT" -o "$WORK/mcpp.tar.gz" "$url"; then
+        SHA_URL="${url}.sha256"; SOURCE="GitHub"; return 0
+    fi
+    return 1
+}
+
+fetch_gitcode() {
+    local ver="$VERSION"
+    if [[ "$ver" == "latest" ]]; then
+        # GitCode has no 'latest' redirect — resolve the highest release tag.
+        # per_page=100: the default page (20) lists oldest-first and misses
+        # recent versions, so a plain sort would pick a stale release.
+        ver=$(curl --fail --location --silent --connect-timeout "$CT" \
+                "${GTC_API}/releases?per_page=100" 2>/dev/null \
+              | grep -oE '"tag_name":"[^"]+"' | sed 's/.*:"//; s/"$//' \
+              | sort -V | tail -1)
+        [[ -z "$ver" ]] && { echo "error: cannot resolve latest from GitCode" >&2; return 1; }
+    fi
+    local url="${GTC_DL}/${ver}/mcpp-${ver}-${PLAT}.tar.gz"
+    echo ":: Trying GitCode (CN mirror): ${url}"
+    if curl --fail --location --silent --show-error -o "$WORK/mcpp.tar.gz" "$url"; then
+        SHA_URL="${url}.sha256"; SOURCE="GitCode"; VERSION="$ver"; return 0
+    fi
+    return 1
+}
+
+SOURCE="" SHA_URL=""
+if [[ "${MCPP_MIRROR:-}" == "CN" ]]; then
+    fetch_gitcode || fetch_github || { echo "error: download failed (GitCode + GitHub)" >&2; exit 1; }
+else
+    fetch_github || { echo ":: GitHub unavailable — falling back to GitCode (CN mirror)"; fetch_gitcode; } \
+        || { echo "error: download failed (GitHub + GitCode)" >&2; exit 1; }
+fi
+echo ":: Downloaded from ${SOURCE}"
+# .sha256 sidecar is GitHub-only; GitCode mirror ships tarballs without it.
+curl --fail --location --silent --show-error -o "$WORK/mcpp.sha256" "$SHA_URL" 2>/dev/null || {
+    echo "warning: no .sha256 sidecar (${SOURCE}), skipping verification" >&2
 }
 
 # ---- verify ---------------------------------------------------------------

tests/e2e/45_install_platform_mapping.sh

@@ -12,12 +12,18 @@ grep -q 'Darwin-arm64).*PLAT="macosx-arm64"' "$INSTALL_SH" || {
     exit 1
 }
 
+# Linux aarch64 (also reported as arm64 on some kernels) → linux-aarch64 asset.
+grep -qE 'Linux-aarch64 \| Linux-arm64\).*PLAT="linux-aarch64"' "$INSTALL_SH" || {
+    echo "FAIL: Linux-aarch64 must map to the released linux-aarch64 asset"
+    exit 1
+}
+
 ! grep -q 'Darwin-x86_64).*PLAT=' "$INSTALL_SH" || {
     echo "FAIL: install.sh advertises Darwin-x86_64, but release CI publishes no macOS x86_64 asset"
     exit 1
 }
 
-grep -q 'Currently supported: linux-x86_64, macosx-arm64' "$INSTALL_SH" || {
+grep -q 'Currently supported: linux-x86_64, linux-aarch64, macosx-arm64' "$INSTALL_SH" || {
     echo "FAIL: supported platform message must match published install assets"
     exit 1
 }
@@ -26,3 +32,8 @@ grep -q 'mcpp-macosx-arm64.tar.gz' "$RELEASE_YML" || {
     echo "FAIL: release workflow must publish the macosx-arm64 alias used by install.sh"
     exit 1
 }
+
+grep -q 'mcpp-linux-aarch64.tar.gz' "$RELEASE_YML" || {
+    echo "FAIL: release workflow must publish the linux-aarch64 alias used by install.sh"
+    exit 1
+}