fix: skip version check for preview channel and add upload progress bar

Co-authored-by: Rain-kl <63696351+Rain-kl@users.noreply.github.com>

atsf_server/service/update.go

@@ -376,7 +376,15 @@ func buildLatestServerReleaseView(release *githubReleaseResponse, channel Releas
 	isDevBuild := currentVersion == "" || strings.EqualFold(currentVersion, "dev")
 	hasUpdate := false
 	if release != nil && !isDevBuild {
-		hasUpdate = isVersionNewer(currentVersion, release.TagName)
+		if channel == ReleaseChannelPreview {
+			// Preview releases use a "major.minor.patch-git-<commit>" scheme that cannot
+			// be meaningfully compared against the running stable version, so we skip the
+			// version check and always allow upgrading when the user explicitly selects
+			// the preview channel.
+			hasUpdate = true
+		} else {
+			hasUpdate = isVersionNewer(currentVersion, release.TagName)
+		}
 	}
 
 	serverUpgradeState.Lock()

atsf_server/service/update_test.go

@@ -140,6 +140,36 @@ func TestBuildLatestServerReleaseViewPreview(t *testing.T) {
 	}
 }
 
+// TestBuildLatestServerReleaseViewPreviewBypassVersionCheck verifies that switching to
+// the preview channel always reports has_update=true, even when the preview tag uses a
+// "major.minor.patch-git-<commit>" scheme that would otherwise compare as equal-or-older
+// than the currently running stable version.
+func TestBuildLatestServerReleaseViewPreviewBypassVersionCheck(t *testing.T) {
+	originalVersion := common.Version
+	common.Version = "v1.0.0"
+	t.Cleanup(func() {
+		common.Version = originalVersion
+		resetServerUpgradeTestState(t)
+	})
+
+	// A typical preview tag: same base version as stable but with a git-commit suffix.
+	// Without the bypass, isVersionNewer("v1.0.0", "v1.0.0-git-abc1234") returns false
+	// because a version without a prerelease identifier is considered higher than one
+	// with a prerelease identifier under semver rules.
+	view := buildLatestServerReleaseView(&githubReleaseResponse{
+		TagName:     "v1.0.0-git-abc1234",
+		Prerelease:  true,
+		PublishedAt: "2026-03-12T00:00:00Z",
+	}, ReleaseChannelPreview)
+
+	if !view.HasUpdate {
+		t.Fatal("expected preview channel to bypass version comparison and report has_update=true")
+	}
+	if view.Channel != ReleaseChannelPreview.String() {
+		t.Fatalf("unexpected channel: %s", view.Channel)
+	}
+}
+
 func TestUploadManualServerBinary(t *testing.T) {
 	originalVersion := common.Version
 	common.Version = "v0.4.0"

atsf_server/web/components/layout/dashboard-topbar.tsx

@@ -45,6 +45,7 @@ export function DashboardTopbar() {
   );
   const [uploadedBinary, setUploadedBinary] =
     useState<UploadedServerBinaryInfo | null>(null);
+  const [uploadProgress, setUploadProgress] = useState(0);
   const menuRef = useRef<HTMLDivElement | null>(null);
   const isRoot = (user?.role ?? 0) >= 100;
   const upgradeStatusPollInterval = 3000;
@@ -102,14 +103,19 @@ export function DashboardTopbar() {
   });
 
   const uploadBinaryMutation = useMutation({
-    mutationFn: uploadServerBinary,
+    mutationFn: (binary: File) =>
+      uploadServerBinary(binary, (progress) => {
+        setUploadProgress(progress);
+      }),
     onSuccess: (candidate) => {
+      setUploadProgress(0);
       setVersionFeedback(null);
       setManualUpgradeError(null);
       setUploadedBinary(candidate);
       setManualUpgradeStatus(candidate.comparison_message);
     },
     onError: (error) => {
+      setUploadProgress(0);
       setUploadedBinary(null);
       setManualUpgradeStatus(null);
       setManualUpgradeError(
@@ -217,6 +223,7 @@ export function DashboardTopbar() {
   };
 
   const handleUploadBinary = (binary: File) => {
+    setUploadProgress(0);
     setManualUpgradeStatus(null);
     setManualUpgradeError(null);
     uploadBinaryMutation.mutate(binary);
@@ -359,6 +366,7 @@ export function DashboardTopbar() {
         }
         isUpgrading={upgradeMutation.isPending}
         isUploadingBinary={uploadBinaryMutation.isPending}
+        uploadProgress={uploadProgress}
         isConfirmingManualUpgrade={confirmManualUpgradeMutation.isPending}
         onChannelChange={handleReleaseChannelChange}
         onCheck={handleCheckRelease}

atsf_server/web/features/update/api/update.ts

@@ -1,4 +1,5 @@
-import { apiRequest } from '@/lib/api/client';
+import { ApiError, apiRequest, getApiUrl } from '@/lib/api/client';
+import type { ApiEnvelope } from '@/types/api';
 
 import type {
   LatestReleaseInfo,
@@ -19,13 +20,63 @@ export function upgradeServer(channel: ReleaseChannel = 'stable') {
   });
 }
 
-export function uploadServerBinary(binary: File) {
+export function uploadServerBinary(
+  binary: File,
+  onProgress?: (progress: number) => void,
+): Promise<UploadedServerBinaryInfo> {
   const formData = new FormData();
   formData.append('binary', binary);
 
-  return apiRequest<UploadedServerBinaryInfo>('/update/manual-upload', {
-    method: 'POST',
-    body: formData,
+  if (!onProgress) {
+    return apiRequest<UploadedServerBinaryInfo>('/update/manual-upload', {
+      method: 'POST',
+      body: formData,
+    });
+  }
+
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open('POST', getApiUrl('/update/manual-upload'));
+    xhr.withCredentials = true;
+
+    xhr.upload.addEventListener('progress', (event) => {
+      if (event.lengthComputable) {
+        onProgress(Math.round((event.loaded / event.total) * 100));
+      }
+    });
+
+    xhr.addEventListener('load', () => {
+      let payload: ApiEnvelope<UploadedServerBinaryInfo> | null = null;
+      try {
+        payload = JSON.parse(xhr.responseText) as ApiEnvelope<UploadedServerBinaryInfo>;
+      } catch {
+        payload = null;
+      }
+      if (xhr.status < 200 || xhr.status >= 300) {
+        reject(
+          new ApiError(
+            payload?.message || `请求失败（${xhr.status}）`,
+            xhr.status,
+          ),
+        );
+        return;
+      }
+      if (!payload) {
+        reject(new ApiError('响应格式无效', xhr.status));
+        return;
+      }
+      if (!payload.success) {
+        reject(new ApiError(payload.message || '请求失败', xhr.status));
+        return;
+      }
+      resolve(payload.data);
+    });
+
+    xhr.addEventListener('error', () => {
+      reject(new ApiError('上传过程中网络连接中断，请检查网络后重试', 0));
+    });
+
+    xhr.send(formData);
   });
 }
 

atsf_server/web/features/update/components/version-upgrade-modal.tsx

@@ -34,6 +34,7 @@ interface VersionUpgradeModalProps {
     isChecking: boolean;
     isUpgrading: boolean;
     isUploadingBinary: boolean;
+    uploadProgress: number;
     isConfirmingManualUpgrade: boolean;
     onChannelChange: (channel: ReleaseChannel) => void;
     onCheck: () => void;
@@ -71,6 +72,7 @@ export function VersionUpgradeModal({
                                         isChecking,
                                         isUpgrading,
                                         isUploadingBinary,
+                                        uploadProgress,
                                         isConfirmingManualUpgrade,
                                         onChannelChange,
                                         onCheck,
@@ -290,6 +292,21 @@ export function VersionUpgradeModal({
                                 )}
                             </div>
 
+                            {isUploadingBinary ? (
+                                <div className="space-y-1">
+                                    <div className="flex items-center justify-between text-xs text-[var(--foreground-secondary)]">
+                                        <span>上传中...</span>
+                                        <span>{uploadProgress}%</span>
+                                    </div>
+                                    <div className="h-2 w-full overflow-hidden rounded-full bg-[var(--border-default)]">
+                                        <div
+                                            className="h-full rounded-full bg-[var(--brand-primary)] transition-all duration-200"
+                                            style={{width: `${uploadProgress}%`}}
+                                        />
+                                    </div>
+                                </div>
+                            ) : null}
+
                             {manualErrorMessage ? (
                                 <ErrorState
                                     title="手动升级检查失败"