Merge remote-tracking branch 'origin/dev' into dmux-2026-06-19-110554

Wavelet/frontend/app/(main)/admin/settings/components/openflare-ops.tsx

@@ -27,9 +27,10 @@ import {Textarea} from "@/components/ui/textarea"
 import {ErrorInline} from "@/components/layout/error"
 import {LoadingStateWithBorder} from "@/components/layout/loading"
 import type {DatabaseCleanupTarget} from "@/lib/services/openflare"
-import {NodeService, OptionService, StatusService, UpdateService, UptimeKumaService,} from "@/lib/services/openflare"
+import {AdminStatusService} from "@/lib/services/admin"
+import {NodeService, OptionService, StatusService, UptimeKumaService,} from "@/lib/services/openflare"
 import {VersionUpgradeDialog} from "@/app/(main)/components/version-upgrade-dialog"
-import {openflareLatestReleaseQueryKey, openflarePublicStatusQueryKey,} from "@/lib/hooks/use-openflare-server-upgrade"
+import {adminUpdateStatusQueryKey, openflarePublicStatusQueryKey,} from "@/lib/hooks/use-openflare-server-upgrade"
 
 import {
   agentOptionEntries,
@@ -102,8 +103,8 @@ export function OpenFlareOpsSettings() {
   })
 
   const releaseQuery = useQuery({
-    queryKey: openflareLatestReleaseQueryKey("stable"),
+    queryKey: adminUpdateStatusQueryKey,
-    queryFn: () => UpdateService.getLatestRelease("stable"),
+    queryFn: () => AdminStatusService.getUpdateStatus(),
   })
 
   useEffect(() => {
@@ -609,7 +610,7 @@ export function OpenFlareOpsSettings() {
           <div>
             <CardTitle className="text-base">版本信息</CardTitle>
             <CardDescription>
-              检查 GitHub Release、在线升级或手动上传服务端二进制包。
+              检查上游 GitHub Release 并升级当前服务。
             </CardDescription>
           </div>
           <Button type="button" size="sm" onClick={() => setVersionDialogOpen(true)}>
@@ -620,12 +621,12 @@ export function OpenFlareOpsSettings() {
           <InfoCell label="当前版本" value={statusQuery.data?.version ?? releaseQuery.data?.current_version ?? "—"} />
           <InfoCell
             label="最新 Release"
-            value={releaseQuery.data?.tag_name ?? "—"}
+            value={releaseQuery.data?.latest_version ?? "—"}
           />
           <div className="rounded-lg border border-dashed px-3 py-2">
             <p className="text-[10px] uppercase tracking-wider text-muted-foreground">更新状态</p>
             <div className="mt-2">
-              {releaseQuery.data?.has_update ? (
+              {releaseQuery.data?.update_available ? (
                 <Badge variant="secondary">有新版本</Badge>
               ) : (
                 <Badge variant="outline">已是最新</Badge>

Wavelet/frontend/app/(main)/components/upgrade-log-panel.tsx

@@ -1,71 +0,0 @@
-'use client';
-
-import {Badge} from '@/components/ui/badge';
-import type {LatestReleaseInfo} from '@/lib/services/openflare';
-
-function formatLogTimestamp(value: string) {
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) {
-    return '0000-00-00 00:00:00.000';
-  }
-
-  const year = date.getFullYear();
-  const month = `${date.getMonth() + 1}`.padStart(2, '0');
-  const day = `${date.getDate()}`.padStart(2, '0');
-  const hour = `${date.getHours()}`.padStart(2, '0');
-  const minute = `${date.getMinutes()}`.padStart(2, '0');
-  const second = `${date.getSeconds()}`.padStart(2, '0');
-  const millisecond = `${date.getMilliseconds()}`.padStart(3, '0');
-
-  return `${year}-${month}-${day} ${hour}:${minute}:${second}.${millisecond}`;
-}
-
-function formatLogLevel(level: string) {
-  return (level || 'info').toUpperCase().padEnd(8, ' ');
-}
-
-function getUpgradeStatusBadge(release: LatestReleaseInfo) {
-  if (release.upgrade_status === 'failed') {
-    return { label: '升级失败', variant: 'destructive' as const };
-  }
-  if (release.upgrade_status === 'succeeded') {
-    return { label: '准备重启', variant: 'default' as const };
-  }
-  if (release.in_progress) {
-    return { label: '升级中', variant: 'secondary' as const };
-  }
-  return { label: '空闲', variant: 'outline' as const };
-}
-
-export function UpgradeLogPanel({release}: {release: LatestReleaseInfo}) {
-  const statusBadge = getUpgradeStatusBadge(release);
-  const upgradeLogs = release.upgrade_logs ?? [];
-
-  if (upgradeLogs.length === 0) {
-    return (
-      <div className="rounded-lg border border-dashed px-4 py-8 text-center text-sm text-muted-foreground">
-        暂无升级日志
-      </div>
-    );
-  }
-
-  return (
-    <div className="space-y-3">
-      <Badge variant={statusBadge.variant}>{statusBadge.label}</Badge>
-      <div className="max-h-72 overflow-y-auto rounded-lg border bg-slate-950 px-4 py-3">
-        {upgradeLogs.map((log, index) => (
-          <pre
-            key={`${log.created_at}-${index}`}
-            className="overflow-x-auto border-b border-white/10 py-2 font-mono text-[12px] leading-6 text-slate-200 last:border-b-0"
-          >
-            <span className="text-slate-400">{formatLogTimestamp(log.created_at)}</span>
-            <span className="text-slate-500"> | </span>
-            <span className="text-cyan-300">{formatLogLevel(log.level)}</span>
-            <span className="text-slate-500"> | </span>
-            <span className="break-all whitespace-pre-wrap text-slate-100">{log.message}</span>
-          </pre>
-        ))}
-      </div>
-    </div>
-  );
-}

Wavelet/frontend/app/(main)/components/version-upgrade-dialog.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import {useEffect, useState} from 'react';
+import {useEffect} from 'react';
 import {ExternalLink, Loader2} from 'lucide-react';
 import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
@@ -8,26 +8,28 @@ import remarkGfm from 'remark-gfm';
 import {Badge} from '@/components/ui/badge';
 import {Button} from '@/components/ui/button';
 import {Card, CardContent, CardDescription, CardHeader, CardTitle} from '@/components/ui/card';
-import {Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle,} from '@/components/ui/dialog';
+import {
-import {Input} from '@/components/ui/input';
+  AlertDialog,
-import {Label} from '@/components/ui/label';
+  AlertDialogAction,
-import {Progress} from '@/components/ui/progress';
+  AlertDialogCancel,
-import {Tabs, TabsContent, TabsList, TabsTrigger} from '@/components/ui/tabs';
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+  AlertDialogTrigger,
+} from '@/components/ui/alert-dialog';
+import {Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle} from '@/components/ui/dialog';
 import {useOpenFlareServerUpgrade} from '@/lib/hooks/use-openflare-server-upgrade';
-import type {LatestReleaseInfo, ReleaseChannel} from '@/lib/services/openflare';
+import type {AppUpdateStatus} from '@/lib/services/admin/types';
 import {formatDateTime} from '@/lib/utils';
 import {formatRelativeTime} from '@/app/(main)/nodes/components/node-utils';
 
-import {UpgradeLogPanel} from './upgrade-log-panel';
+function getUpgradeBadge(update: AppUpdateStatus | null | undefined) {
-
+  if (!update) {
-function getUpgradeBadge(release: LatestReleaseInfo | null | undefined) {
-  if (!release) {
     return { label: '未检查', variant: 'outline' as const };
   }
-  if (release.in_progress) {
+  if (update.update_available) {
-    return { label: '升级中', variant: 'secondary' as const };
-  }
-  if (release.has_update) {
     return { label: '可升级', variant: 'secondary' as const };
   }
   return { label: '最新', variant: 'default' as const };
@@ -44,26 +46,15 @@ export function VersionUpgradeDialog({
 }) {
   const {
     currentVersion,
-    selectedChannel,
+    update,
-    release,
-    uploadedBinary,
     releaseErrorMessage,
-    manualStatusMessage,
-    manualErrorMessage,
     isInitialLoading,
     isChecking,
     isUpgrading,
-    isUploadingBinary,
-    uploadProgress,
-    isConfirmingManualUpgrade,
     handleOpen,
     handleCheckRelease,
-    handleChannelChange,
     handleUpgrade,
-    handleUploadBinary,
-    handleConfirmManualUpgrade,
   } = useOpenFlareServerUpgrade({ open, canUpgrade });
-  const [selectedBinary, setSelectedBinary] = useState<File | null>(null);
 
   useEffect(() => {
     if (open) {
@@ -71,22 +62,8 @@ export function VersionUpgradeDialog({
     }
   }, [open, handleOpen]);
 
-  useEffect(() => {
+  const upgradeBadge = getUpgradeBadge(update);
-    if (!open) {
+  const isBusy = isChecking || isUpgrading;
-      setSelectedBinary(null);
-    }
-  }, [open]);
-
-  const upgradeBadge = getUpgradeBadge(release);
-  const selectedChannelLabel = selectedChannel === 'preview' ? '预览版' : '正式版';
-  const uploadPhaseLabel =
-    uploadProgress >= 100 ? '已上传，正在服务端校验版本...' : '上传中...';
-  const canConfirmManualUpgrade = Boolean(
-    uploadedBinary?.ready_to_upgrade && uploadedBinary.upload_token,
-  );
-
-  const isBusy =
-    isChecking || isUpgrading || isUploadingBinary || isConfirmingManualUpgrade;
 
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
@@ -94,7 +71,7 @@ export function VersionUpgradeDialog({
         <DialogHeader>
           <DialogTitle>服务端版本</DialogTitle>
           <DialogDescription>
-            默认检查正式版更新；也可检查 preview 发布或手动上传二进制包。升级开始后服务会短暂重启。
+            检查上游 GitHub Release 并升级当前服务。升级开始后服务会短暂重启。
           </DialogDescription>
         </DialogHeader>
 
@@ -117,23 +94,7 @@ export function VersionUpgradeDialog({
                 <CardTitle className="text-sm">最新版本</CardTitle>
               </CardHeader>
               <CardContent className="px-4 space-y-3">
-                <div className="flex flex-wrap items-center gap-2">
+                <p className="text-sm font-medium">{update?.latest_version || '未检查'}</p>
-                  <p className="text-sm font-medium">{release?.tag_name || '未检查'}</p>
-                  {canUpgrade ? (
-                    <Button
-                      type="button"
-                      variant="outline"
-                      size="sm"
-                      className="h-7 text-xs"
-                      disabled={isBusy}
-                      onClick={() =>
-                        handleChannelChange(selectedChannel === 'preview' ? 'stable' : 'preview')
-                      }
-                    >
-                      {selectedChannelLabel}
-                    </Button>
-                  ) : null}
-                </div>
                 {canUpgrade ? (
                   <Button
                     type="button"
@@ -142,7 +103,7 @@ export function VersionUpgradeDialog({
                     disabled={isBusy}
                     onClick={handleCheckRelease}
                   >
-                    {isChecking ? '检查中...' : `检查${selectedChannelLabel}`}
+                    {isChecking ? '检查中...' : '检查更新'}
                   </Button>
                 ) : null}
               </CardContent>
@@ -162,240 +123,101 @@ export function VersionUpgradeDialog({
             </div>
           ) : null}
 
-          <Tabs defaultValue="online">
+          {!isInitialLoading && !releaseErrorMessage && !update ? (
-            <TabsList>
+            <div className="rounded-lg border border-dashed px-4 py-8 text-center text-sm text-muted-foreground">
-              <TabsTrigger value="online">在线升级</TabsTrigger>
+              尚未检查更新，点击「检查更新」后展示 GitHub Release 信息。
-              {canUpgrade ? <TabsTrigger value="manual">手动升级</TabsTrigger> : null}
+            </div>
-              {release ? <TabsTrigger value="logs">升级日志</TabsTrigger> : null}
+          ) : null}
-            </TabsList>
 
-            <TabsContent value="online" className="space-y-4">
+          {update ? (
-              {!isInitialLoading && !releaseErrorMessage && !release ? (
+            <Card className="border-dashed shadow-none py-4 gap-3">
-                <div className="rounded-lg border border-dashed px-4 py-8 text-center text-sm text-muted-foreground">
+              <CardHeader className="px-4 pb-0">
-                  尚未检查{selectedChannelLabel}，点击「检查{selectedChannelLabel}」后展示 GitHub Release 信息。
+                <CardTitle className="text-sm">GitHub Release · {update.latest_version}</CardTitle>
+                <CardDescription>
+                  {update.published_at
+                    ? `发布时间：${formatRelativeTime(update.published_at)} · ${formatDateTime(update.published_at)}`
+                    : '未提供发布时间'}
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="px-4 space-y-4">
+                <div className="flex flex-wrap items-center gap-2">
+                  <Badge variant={update.update_available ? 'secondary' : 'default'}>
+                    {update.update_available ? '发现新版本' : '已经是最新版本'}
+                  </Badge>
+                  {update.prerelease ? (
+                    <Badge variant="secondary">Preview 发布</Badge>
+                  ) : (
+                    <Badge variant="outline">正式发布</Badge>
+                  )}
+                  {!update.can_upgrade ? (
+                    <Badge variant="destructive">当前平台不支持自动升级</Badge>
+                  ) : null}
                 </div>
-              ) : null}
 
-              {release ? (
+                <div className="prose prose-sm dark:prose-invert max-w-none text-sm">
-                <Card className="border-dashed shadow-none py-4 gap-3">
+                  <ReactMarkdown remarkPlugins={[remarkGfm]}>
-                  <CardHeader className="px-4 pb-0">
+                    {update.release_notes || '暂无更新说明'}
-                    <CardTitle className="text-sm">
+                  </ReactMarkdown>
-                      GitHub {selectedChannelLabel} · {release.tag_name}
+                </div>
-                    </CardTitle>
-                    <CardDescription>
-                      {release.published_at
-                        ? `发布时间：${formatRelativeTime(release.published_at)} · ${formatDateTime(release.published_at)}`
-                        : '未提供发布时间'}
-                    </CardDescription>
-                  </CardHeader>
-                  <CardContent className="px-4 space-y-4">
-                    <div className="flex flex-wrap items-center gap-2">
-                      <Badge variant={release.has_update ? 'secondary' : 'default'}>
-                        {release.has_update ? '发现新版本' : '已经是最新版本'}
-                      </Badge>
-                      {release.prerelease ? (
-                        <Badge variant="secondary">Preview 发布</Badge>
-                      ) : (
-                        <Badge variant="outline">正式发布</Badge>
-                      )}
-                      {!release.upgrade_supported ? (
-                        <Badge variant="destructive">当前平台不支持自动升级</Badge>
-                      ) : null}
-                      {release.in_progress ? (
-                        <Badge variant="secondary">升级任务执行中</Badge>
-                      ) : null}
-                    </div>
 
-                    <div className="prose prose-sm dark:prose-invert max-w-none text-sm">
+                {update.release_url ? (
-                      <ReactMarkdown remarkPlugins={[remarkGfm]}>
+                  <a
-                        {release.body || '暂无更新说明'}
+                    href={update.release_url}
-                      </ReactMarkdown>
+                    target="_blank"
-                    </div>
+                    rel="noreferrer"
+                    className="inline-flex items-center text-sm text-primary hover:underline"
+                  >
+                    查看发布详情
+                    <ExternalLink className="size-3 ml-1" />
+                  </a>
+                ) : null}
 
-                    {release.html_url ? (
+                {canUpgrade ? (
-                      <a
+                  <div className="flex justify-end">
-                        href={release.html_url}
+                    <AlertDialog>
-                        target="_blank"
+                      <AlertDialogTrigger asChild>
-                        rel="noreferrer"
-                        className="inline-flex items-center text-sm text-primary hover:underline"
-                      >
-                        查看发布详情
-                        <ExternalLink className="size-3 ml-1" />
-                      </a>
-                    ) : null}
-
-                    {canUpgrade ? (
-                      <div className="flex justify-end">
                         <Button
                           type="button"
                           disabled={
-                            !release.has_update ||
+                            !update.update_available ||
-                            release.in_progress ||
                             isUpgrading ||
-                            !release.upgrade_supported ||
+                            !update.can_upgrade ||
-                            isUploadingBinary ||
+                            isBusy
-                            isConfirmingManualUpgrade
                           }
-                          onClick={handleUpgrade}
                         >
-                          {isUpgrading || release.in_progress
+                          {isUpgrading ? '升级中...' : '立即升级'}
-                            ? '升级中...'
-                            : selectedChannel === 'preview'
-                              ? '升级预览版'
-                              : '升级正式版'}
                         </Button>
-                      </div>
+                      </AlertDialogTrigger>
-                    ) : null}
+                      <AlertDialogContent>
-                  </CardContent>
+                        <AlertDialogHeader>
-                </Card>
+                          <AlertDialogTitle>升级到 {update.latest_version}？</AlertDialogTitle>
-              ) : null}
+                          <AlertDialogDescription>
-            </TabsContent>
+                            服务将下载并校验 {update.asset_name}，随后替换当前二进制并重启。请确保安装目录可写，且服务允许原地重启。
+                          </AlertDialogDescription>
+                        </AlertDialogHeader>
+                        <AlertDialogFooter>
+                          <AlertDialogCancel>取消</AlertDialogCancel>
+                          <AlertDialogAction onClick={handleUpgrade}>确认升级</AlertDialogAction>
+                        </AlertDialogFooter>
+                      </AlertDialogContent>
+                    </AlertDialog>
+                  </div>
+                ) : null}
 
-            {canUpgrade ? (
+                {!update.can_upgrade ? (
-              <TabsContent value="manual" className="space-y-4">
+                  <p className="text-sm text-muted-foreground">
-                <Card className="border-dashed shadow-none py-4 gap-3">
+                    {update.current_version === 'dev'
-                  <CardHeader className="px-4 pb-0">
+                      ? '开发构建没有可比较的 Release 版本，不能执行自动升级。'
-                    <CardTitle className="text-sm">手动升级</CardTitle>
+                      : update.update_available
-                    <CardDescription>
+                        ? '当前平台暂不支持自动替换二进制，请从 Release 页面手动升级。'
-                      支持上传已编译好的当前平台 Server 可执行文件。
+                        : '当前版本无需升级。'}
-                    </CardDescription>
+                  </p>
-                  </CardHeader>
+                ) : null}
-                  <CardContent className="px-4 space-y-4">
+              </CardContent>
-                    <div className="space-y-1.5">
+            </Card>
-                      <Label htmlFor="server-binary">服务端二进制</Label>
+          ) : null}
-                      <Input
-                        id="server-binary"
-                        type="file"
-                        disabled={isUploadingBinary || isConfirmingManualUpgrade}
-                        onChange={(event) => {
-                          setSelectedBinary(event.target.files?.[0] ?? null);
-                        }}
-                      />
-                    </div>
-
-                    <div className="flex justify-end">
-                      {canConfirmManualUpgrade ? (
-                        <Button
-                          type="button"
-                          disabled={
-                            !canConfirmManualUpgrade ||
-                            isConfirmingManualUpgrade ||
-                            isUploadingBinary ||
-                            isUpgrading
-                          }
-                          onClick={handleConfirmManualUpgrade}
-                        >
-                          {isConfirmingManualUpgrade ? '升级中...' : '确认升级'}
-                        </Button>
-                      ) : (
-                        <Button
-                          type="button"
-                          disabled={
-                            !selectedBinary ||
-                            isUploadingBinary ||
-                            isConfirmingManualUpgrade
-                          }
-                          onClick={() => {
-                            if (selectedBinary) {
-                              handleUploadBinary(selectedBinary);
-                            }
-                          }}
-                        >
-                          {isUploadingBinary
-                            ? uploadProgress >= 100
-                              ? '服务端校验中...'
-                              : '上传中...'
-                            : '上传并检查'}
-                        </Button>
-                      )}
-                    </div>
-
-                    {isUploadingBinary ? (
-                      <div className="space-y-2">
-                        <div className="flex items-center justify-between text-xs text-muted-foreground">
-                          <span>{uploadPhaseLabel}</span>
-                          <span>{uploadProgress}%</span>
-                        </div>
-                        <Progress value={uploadProgress} />
-                      </div>
-                    ) : null}
-
-                    {manualErrorMessage ? (
-                      <div className="rounded-lg border border-destructive/30 bg-destructive/5 px-4 py-3 text-sm text-destructive">
-                        {manualErrorMessage}
-                      </div>
-                    ) : null}
-
-                    {!manualErrorMessage && manualStatusMessage ? (
-                      <div className="rounded-lg border border-amber-500/30 bg-amber-500/10 px-4 py-3 text-sm text-amber-600 dark:text-amber-400">
-                        {manualStatusMessage}
-                      </div>
-                    ) : null}
-
-                    {uploadedBinary ? (
-                      <div className="space-y-4 rounded-lg border border-dashed p-4">
-                        <div className="flex flex-wrap items-center gap-2">
-                          <Badge
-                            variant={uploadedBinary.ready_to_upgrade ? 'secondary' : 'outline'}
-                          >
-                            {uploadedBinary.ready_to_upgrade
-                              ? '可确认升级'
-                              : uploadedBinary.has_update
-                                ? '待确认'
-                                : '不可升级'}
-                          </Badge>
-                          {!uploadedBinary.upgrade_supported ? (
-                            <Badge variant="destructive">当前版本不支持手动升级</Badge>
-                          ) : null}
-                        </div>
-
-                        <div className="grid gap-3 sm:grid-cols-2 text-sm">
-                          <InfoCell label="文件名" value={uploadedBinary.file_name} />
-                          <InfoCell
-                            label="上传时间"
-                            value={
-                              uploadedBinary.uploaded_at
-                                ? formatDateTime(uploadedBinary.uploaded_at)
-                                : '未知'
-                            }
-                          />
-                          <InfoCell label="当前版本" value={uploadedBinary.current_version} />
-                          <InfoCell label="上传版本" value={uploadedBinary.detected_version} />
-                        </div>
-
-                        <p className="text-sm text-muted-foreground">
-                          {uploadedBinary.comparison_message}
-                        </p>
-                      </div>
-                    ) : (
-                      <div className="rounded-lg border border-dashed px-4 py-8 text-center text-sm text-muted-foreground">
-                        尚未上传升级包
-                      </div>
-                    )}
-                  </CardContent>
-                </Card>
-              </TabsContent>
-            ) : null}
-
-            {release ? (
-              <TabsContent value="logs">
-                <UpgradeLogPanel release={release} />
-              </TabsContent>
-            ) : null}
-          </Tabs>
         </div>
       </DialogContent>
     </Dialog>
   );
-}
+}
-
-function InfoCell({label, value}: {label: string; value: string}) {
-  return (
-    <div>
-      <p className="text-xs text-muted-foreground">{label}</p>
-      <p className="mt-1 font-medium break-all">{value}</p>
-    </div>
-  );
-}
-
-export type {ReleaseChannel};

Wavelet/frontend/lib/hooks/use-openflare-server-upgrade.ts

@@ -3,36 +3,13 @@
 import {useMutation, useQuery} from '@tanstack/react-query';
 import {useCallback, useEffect, useRef, useState} from 'react';
 
-import type {
+import {AdminStatusService} from '@/lib/services/admin';
-  LatestReleaseInfo,
+import type {AppUpdateStatus} from '@/lib/services/admin/types';
-  ReleaseChannel,
+import {StatusService} from '@/lib/services/openflare';
-  UpgradeStreamSnapshot,
-  UploadedServerBinaryInfo,
-} from '@/lib/services/openflare';
-import {StatusService, UpdateService} from '@/lib/services/openflare';
-
-const UPGRADE_STATUS_POLL_INTERVAL = 3000;
 
 export const openflarePublicStatusQueryKey = ['openflare', 'public-status'] as const;
 
-export const openflareLatestReleaseQueryKey = (channel: ReleaseChannel = 'stable') =>
+export const adminUpdateStatusQueryKey = ['admin', 'update'] as const;
-  ['openflare', 'latest-release', channel] as const;
-
-export function mergeReleaseWithUpgradeStream(
-  release: LatestReleaseInfo | null | undefined,
-  stream: UpgradeStreamSnapshot | null,
-) {
-  if (!release || !stream) {
-    return release;
-  }
-
-  return {
-    ...release,
-    in_progress: stream.in_progress,
-    upgrade_status: stream.upgrade_status,
-    upgrade_logs: stream.upgrade_logs,
-  };
-}
 
 export function useOpenFlareServerUpgrade({
   open,
@@ -41,15 +18,8 @@ export function useOpenFlareServerUpgrade({
   open: boolean;
   canUpgrade: boolean;
 }) {
-  const [selectedChannel, setSelectedChannel] = useState<ReleaseChannel>('stable');
   const [feedback, setFeedback] = useState<string | null>(null);
-  const [manualStatusMessage, setManualStatusMessage] = useState<string | null>(null);
-  const [manualErrorMessage, setManualErrorMessage] = useState<string | null>(null);
-  const [uploadedBinary, setUploadedBinary] = useState<UploadedServerBinaryInfo | null>(null);
-  const [uploadProgress, setUploadProgress] = useState(0);
-  const [upgradeStream, setUpgradeStream] = useState<UpgradeStreamSnapshot | null>(null);
 
-  const upgradeRefreshPendingRef = useRef(false);
   const upgradeReloadStartedRef = useRef(false);
   const upgradeReloadTimerRef = useRef<number | null>(null);
 
@@ -59,30 +29,11 @@ export function useOpenFlareServerUpgrade({
     enabled: open,
   });
 
-  const stableReleaseQuery = useQuery({
+  const updateQuery = useQuery({
-    queryKey: openflareLatestReleaseQueryKey('stable'),
+    queryKey: adminUpdateStatusQueryKey,
-    queryFn: () => UpdateService.getLatestRelease('stable'),
+    queryFn: () => AdminStatusService.getUpdateStatus(),
     enabled: open && canUpgrade,
-    refetchInterval: (query) => {
+    staleTime: 5 * 60 * 1000,
-      const release = query.state.data;
-      if (open && release?.in_progress) {
-        return UPGRADE_STATUS_POLL_INTERVAL;
-      }
-      return 60 * 60 * 1000;
-    },
-  });
-
-  const previewReleaseQuery = useQuery({
-    queryKey: openflareLatestReleaseQueryKey('preview'),
-    queryFn: () => UpdateService.getLatestRelease('preview'),
-    enabled: false,
-    refetchInterval: (query) => {
-      const release = query.state.data;
-      if (open && release?.in_progress) {
-        return UPGRADE_STATUS_POLL_INTERVAL;
-      }
-      return false;
-    },
   });
 
   const scheduleUpgradePageReload = useCallback(() => {
@@ -113,236 +64,64 @@ export function useOpenFlareServerUpgrade({
     };
   }, []);
 
-  useEffect(() => {
-    if (!open || !canUpgrade) {
-      setUpgradeStream(null);
-      return;
-    }
-
-    let closed = false;
-    let reconnectTimer: number | null = null;
-    let socket: WebSocket | null = null;
-
-    const connect = () => {
-      if (closed) {
-        return;
-      }
-
-      socket = UpdateService.createUpgradeLogsWebSocket();
-      if (!socket) {
-        return;
-      }
-
-      socket.onmessage = (event) => {
-        const snapshot = UpdateService.parseUpgradeStreamSnapshot(String(event.data));
-        if (snapshot) {
-          if (snapshot.in_progress || snapshot.upgrade_status === 'succeeded') {
-            upgradeRefreshPendingRef.current = true;
-          }
-          if (snapshot.upgrade_status === 'failed') {
-            upgradeRefreshPendingRef.current = false;
-          }
-          setUpgradeStream(snapshot);
-        }
-      };
-
-      socket.onclose = () => {
-        if (closed) {
-          return;
-        }
-        if (upgradeRefreshPendingRef.current) {
-          scheduleUpgradePageReload();
-          return;
-        }
-        reconnectTimer = window.setTimeout(connect, 1500);
-      };
-    };
-
-    connect();
-
-    return () => {
-      closed = true;
-      if (reconnectTimer !== null) {
-        window.clearTimeout(reconnectTimer);
-      }
-      socket?.close();
-    };
-  }, [canUpgrade, open, scheduleUpgradePageReload]);
-
   const upgradeMutation = useMutation({
-    mutationFn: (channel: ReleaseChannel) => UpdateService.upgradeServer(channel),
+    mutationFn: () => AdminStatusService.applyUpdate(),
-    onSuccess: (release) => {
+    onSuccess: () => {
-      upgradeRefreshPendingRef.current = true;
+      scheduleUpgradePageReload();
-      setUploadedBinary(null);
+      setFeedback('升级包已校验完成，服务正在重启。');
-      setManualStatusMessage(null);
-      setManualErrorMessage(null);
-      setFeedback(
-        `服务升级任务已启动，目标版本 ${release.tag_name}（${release.channel === 'preview' ? '预览版' : '正式版'}）。页面可能短暂不可用。`,
-      );
-      void stableReleaseQuery.refetch();
-      if (release.channel === 'preview') {
-        void previewReleaseQuery.refetch();
-      }
     },
     onError: (error) => {
       setFeedback(error instanceof Error ? error.message : '升级失败，请稍后重试。');
     },
   });
 
-  const uploadBinaryMutation = useMutation({
-    mutationFn: (binary: File) =>
-      UpdateService.uploadServerBinary(binary, (progress) => {
-        setUploadProgress(progress);
-      }),
-    onSuccess: (candidate) => {
-      setUploadProgress(0);
-      setFeedback(null);
-      setManualErrorMessage(null);
-      setUploadedBinary(candidate);
-      setManualStatusMessage(candidate.comparison_message);
-    },
-    onError: (error) => {
-      setUploadProgress(0);
-      setUploadedBinary(null);
-      setManualStatusMessage(null);
-      setManualErrorMessage(
-        error instanceof Error ? error.message : '上传升级包失败，请稍后重试。',
-      );
-    },
-  });
-
-  const confirmManualUpgradeMutation = useMutation({
-    mutationFn: (uploadToken: string) => UpdateService.confirmManualServerUpgrade(uploadToken),
-    onSuccess: (candidate) => {
-      upgradeRefreshPendingRef.current = true;
-      setFeedback(null);
-      setManualErrorMessage(null);
-      setUploadedBinary(candidate);
-      setManualStatusMessage(
-        `手动升级任务已启动，目标版本 ${candidate.detected_version}。页面可能短暂不可用。`,
-      );
-      void stableReleaseQuery.refetch();
-      void previewReleaseQuery.refetch();
-    },
-    onError: (error) => {
-      setManualStatusMessage(null);
-      setManualErrorMessage(
-        error instanceof Error ? error.message : '确认手动升级失败，请稍后重试。',
-      );
-    },
-  });
-
   const resetTransientState = useCallback(() => {
-    setSelectedChannel('stable');
     setFeedback(null);
-    setManualStatusMessage(null);
-    setManualErrorMessage(null);
-    setUploadedBinary(null);
-    setUploadProgress(0);
-    setUpgradeStream(null);
-    upgradeRefreshPendingRef.current = false;
     upgradeReloadStartedRef.current = false;
   }, []);
 
   const handleOpen = useCallback(() => {
     resetTransientState();
     if (canUpgrade) {
-      void stableReleaseQuery.refetch();
+      void updateQuery.refetch();
     }
-  }, [canUpgrade, resetTransientState, stableReleaseQuery]);
+  }, [canUpgrade, resetTransientState, updateQuery]);
 
   const handleCheckRelease = useCallback(() => {
     setFeedback(null);
     if (!canUpgrade) {
       return;
     }
-    if (selectedChannel === 'preview') {
+    void updateQuery.refetch();
-      void previewReleaseQuery.refetch();
+  }, [canUpgrade, updateQuery]);
-      return;
-    }
-    void stableReleaseQuery.refetch();
-  }, [canUpgrade, previewReleaseQuery, selectedChannel, stableReleaseQuery]);
-
-  const handleChannelChange = useCallback((channel: ReleaseChannel) => {
-    setSelectedChannel(channel);
-    setFeedback(null);
-  }, []);
 
   const handleUpgrade = useCallback(() => {
     setFeedback(null);
-    setManualStatusMessage(null);
+    upgradeMutation.mutate();
-    setManualErrorMessage(null);
+  }, [upgradeMutation]);
-    upgradeMutation.mutate(selectedChannel);
-  }, [selectedChannel, upgradeMutation]);
-
-  const handleUploadBinary = useCallback(
-    (binary: File) => {
-      setUploadProgress(0);
-      setManualStatusMessage(null);
-      setManualErrorMessage(null);
-      uploadBinaryMutation.mutate(binary);
-    },
-    [uploadBinaryMutation],
-  );
-
-  const handleConfirmManualUpgrade = useCallback(() => {
-    if (!uploadedBinary?.upload_token) {
-      setManualStatusMessage(null);
-      setManualErrorMessage('请先上传并检查升级包。');
-      return;
-    }
-    setFeedback(null);
-    setManualStatusMessage(null);
-    setManualErrorMessage(null);
-    confirmManualUpgradeMutation.mutate(uploadedBinary.upload_token);
-  }, [confirmManualUpgradeMutation, uploadedBinary?.upload_token]);
-
-  const selectedRelease =
-    selectedChannel === 'preview' ? previewReleaseQuery.data : stableReleaseQuery.data;
-  const releaseWithStream = mergeReleaseWithUpgradeStream(selectedRelease, upgradeStream);
-  const selectedReleaseError =
-    selectedChannel === 'preview' ? previewReleaseQuery.error : stableReleaseQuery.error;
-  const isSelectedReleaseError =
-    selectedChannel === 'preview' ? previewReleaseQuery.isError : stableReleaseQuery.isError;
-  const isChecking =
-    selectedChannel === 'preview'
-      ? previewReleaseQuery.isFetching
-      : stableReleaseQuery.isFetching;
-  const isInitialLoading =
-    (selectedChannel === 'preview'
-      ? previewReleaseQuery.isLoading && !previewReleaseQuery.data
-      : stableReleaseQuery.isLoading && !stableReleaseQuery.data) && canUpgrade;
 
+  const update = updateQuery.data;
   const releaseErrorMessage =
     feedback ||
-    (isSelectedReleaseError
+    (updateQuery.isError
-      ? selectedReleaseError instanceof Error
+      ? updateQuery.error instanceof Error
-        ? selectedReleaseError.message
+        ? updateQuery.error.message
         : '版本检查失败，请稍后重试。'
       : undefined);
 
-  const currentVersion = statusQuery.data?.version || releaseWithStream?.current_version || 'unknown';
+  const currentVersion = statusQuery.data?.version || update?.current_version || 'unknown';
 
   return {
     currentVersion,
-    selectedChannel,
+    update,
-    release: releaseWithStream,
-    uploadedBinary,
     releaseErrorMessage,
-    manualStatusMessage,
+    isInitialLoading: updateQuery.isLoading && !updateQuery.data && canUpgrade,
-    manualErrorMessage,
+    isChecking: updateQuery.isFetching,
-    isInitialLoading,
-    isChecking,
     isUpgrading: upgradeMutation.isPending,
-    isUploadingBinary: uploadBinaryMutation.isPending,
-    uploadProgress,
-    isConfirmingManualUpgrade: confirmManualUpgradeMutation.isPending,
-    stableRelease: stableReleaseQuery.data,
     handleOpen,
     handleCheckRelease,
-    handleChannelChange,
     handleUpgrade,
-    handleUploadBinary,
-    handleConfirmManualUpgrade,
   };
-}
+}
+
+export type {AppUpdateStatus};

Wavelet/frontend/lib/services/index.ts

@@ -27,7 +27,6 @@ import {PushService} from './push';
 import {AdminUploadService, UploadService} from './upload';
 import {UserService} from './user';
 import {
-  AboutService,
   AccessLogService,
   ApplyLogService,
   ConfigVersionService,
@@ -40,7 +39,6 @@ import {
   ProxyRouteService,
   StatusService,
   TlsCertificateService,
-  UpdateService,
   UptimeKumaService,
   WafService,
   WebsiteService,
@@ -62,7 +60,6 @@ const services = {
   adminUpload: AdminUploadService,
   dbManage: DbManageService,
   push: PushService,
-  openflareAbout: AboutService,
   openflareNode: NodeService,
   openflareProxyRoute: ProxyRouteService,
   openflareConfigVersion: ConfigVersionService,
@@ -77,7 +74,6 @@ const services = {
   openflareAccessLog: AccessLogService,
   openflareOption: OptionService,
   openflareUptimeKuma: UptimeKumaService,
-  openflareUpdate: UpdateService,
   openflareStatus: StatusService,
 } as const;
 
@@ -183,7 +179,6 @@ export type { PushEvent, PushHistory, PushChannelConfig, ListPushHistoriesReques
 // ==================== OpenFlare 业务服务导出 ====================
 
 export {
-  AboutService,
   OpenFlareBaseService,
   NodeService,
   ProxyRouteService,
@@ -199,7 +194,6 @@ export {
   AccessLogService,
   OptionService,
   StatusService,
-  UpdateService,
   UptimeKumaService,
 } from './openflare';
 
@@ -227,6 +221,5 @@ export type {
   OptionItem,
   GeoIPLookupResult,
   DatabaseCleanupResult,
-  LatestReleaseInfo,
   OpenFlarePublicStatus,
 } from './openflare';

Wavelet/frontend/lib/services/openflare/about.service.ts

@@ -1,7 +0,0 @@
-import {OpenFlareBaseService} from './base.service';
-
-export class AboutService extends OpenFlareBaseService {
-  static getAboutContent(): Promise<string> {
-    return this.get<string>('/about');
-  }
-}

Wavelet/frontend/lib/services/openflare/index.ts

@@ -1,4 +1,3 @@
-export { AboutService } from './about.service';
 export { OpenFlareBaseService } from './base.service';
 
 export { NodeService } from './node.service';
@@ -15,7 +14,6 @@ export { OriginService } from './origin.service';
 export { AccessLogService } from './access-log.service';
 export { OptionService } from './option.service';
 export { UptimeKumaService } from './uptimekuma.service';
-export { UpdateService } from './update.service';
 export { StatusService } from './status.service';
 
 export type {
@@ -93,11 +91,7 @@ export type {
   DatabaseCleanupPayload,
   DatabaseCleanupResult,
   DatabaseCleanupTarget,
-  LatestReleaseInfo,
   OpenFlarePublicStatus,
-  UpgradeLogItem,
-  UpgradeStreamSnapshot,
-  UploadedServerBinaryInfo,
   OriginDetail,
   OriginItem,
   OriginMutationPayload,
@@ -119,7 +113,6 @@ export type {
   TlsCertificateMutationPayload,
 } from './types';
 
-import {AboutService} from './about.service';
 import {AccessLogService} from './access-log.service';
 import {ApplyLogService} from './apply-log.service';
 import {ConfigVersionService} from './config-version.service';
@@ -128,7 +121,6 @@ import {DnsAccountService} from './dns-account.service';
 import {NodeService} from './node.service';
 import {OptionService} from './option.service';
 import {StatusService} from './status.service';
-import {UpdateService} from './update.service';
 import {UptimeKumaService} from './uptimekuma.service';
 import {OriginService} from './origin.service';
 import {PagesService} from './pages.service';
@@ -138,7 +130,6 @@ import {WafService} from './waf.service';
 import {WebsiteService} from './website.service';
 
 export const openflareServices = {
-  about: AboutService,
   node: NodeService,
   proxyRoute: ProxyRouteService,
   configVersion: ConfigVersionService,
@@ -153,6 +144,5 @@ export const openflareServices = {
   accessLog: AccessLogService,
   option: OptionService,
   uptimeKuma: UptimeKumaService,
-  update: UpdateService,
   status: StatusService,
 } as const;

Wavelet/frontend/lib/services/openflare/types.ts

@@ -696,45 +696,6 @@ export interface OpenFlarePublicStatus {
   system_name: string;
 }
 
-export interface UpgradeLogItem {
-  level: string;
-  message: string;
-  created_at: string;
-}
-
-export interface LatestReleaseInfo {
-  tag_name: string;
-  body: string;
-  html_url: string;
-  published_at: string;
-  channel: ReleaseChannel;
-  prerelease: boolean;
-  current_version: string;
-  has_update: boolean;
-  upgrade_supported: boolean;
-  in_progress: boolean;
-  upgrade_status: 'idle' | 'running' | 'succeeded' | 'failed' | string;
-  upgrade_logs: UpgradeLogItem[];
-}
-
-export interface UpgradeStreamSnapshot {
-  in_progress: boolean;
-  upgrade_status: 'idle' | 'running' | 'succeeded' | 'failed' | string;
-  upgrade_logs: UpgradeLogItem[];
-}
-
-export interface UploadedServerBinaryInfo {
-  upload_token: string;
-  file_name: string;
-  detected_version: string;
-  current_version: string;
-  has_update: boolean;
-  upgrade_supported: boolean;
-  ready_to_upgrade: boolean;
-  comparison_message: string;
-  uploaded_at: string;
-}
-
 export interface WAFRuleGroup {
   id: number;
   name: string;

Wavelet/frontend/lib/services/openflare/update.service.ts

@@ -1,131 +0,0 @@
-import type {InternalAxiosRequestConfig} from 'axios';
-
-import {getApiBaseUrl} from '@/lib/services/core/config';
-import {ApiErrorBase} from '@/lib/services/core/errors';
-import type {ApiResponse} from '@/lib/services/core';
-
-import {OpenFlareBaseService} from './base.service';
-import type {LatestReleaseInfo, ReleaseChannel, UpgradeStreamSnapshot, UploadedServerBinaryInfo} from './types';
-
-/**
- * OpenFlare 服务端升级 API（`/api/v1/d/update/*`）。
- */
-export class UpdateService extends OpenFlareBaseService {
-  protected static override readonly basePath: string = '/api/v1/d/update';
-
-  private static getApiUrl(path: string): string {
-    const baseURL = getApiBaseUrl();
-    const fullPath = this.getFullPath(path);
-    if (!baseURL) {
-      return fullPath;
-    }
-    return `${baseURL.replace(/\/$/, '')}${fullPath}`;
-  }
-
-  static getLatestRelease(channel: ReleaseChannel = 'stable'): Promise<LatestReleaseInfo> {
-    return this.get<LatestReleaseInfo>('/latest-release', { channel });
-  }
-
-  static upgradeServer(channel: ReleaseChannel = 'stable'): Promise<LatestReleaseInfo> {
-    return this.post<LatestReleaseInfo>('/upgrade', { channel });
-  }
-
-  static uploadServerBinary(
-    binary: File,
-    onProgress?: (progress: number) => void,
-  ): Promise<UploadedServerBinaryInfo> {
-    const formData = new FormData();
-    formData.append('binary', binary);
-
-    if (!onProgress) {
-      return this.post<UploadedServerBinaryInfo>('/manual-upload', formData, {
-        headers: { 'Content-Type': 'multipart/form-data' },
-      } as InternalAxiosRequestConfig);
-    }
-
-    return new Promise((resolve, reject) => {
-      const xhr = new XMLHttpRequest();
-      xhr.open('POST', this.getApiUrl('/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: ApiResponse<UploadedServerBinaryInfo> | null = null;
-        try {
-          payload = JSON.parse(
-            xhr.responseText,
-          ) as ApiResponse<UploadedServerBinaryInfo>;
-        } catch {
-          payload = null;
-        }
-        if (xhr.status < 200 || xhr.status >= 300) {
-          reject(
-            new ApiErrorBase(
-              payload?.message || `请求失败（${xhr.status}）`,
-              undefined,
-              xhr.status,
-            ),
-          );
-          return;
-        }
-        if (!payload) {
-          reject(new ApiErrorBase('响应格式无效', undefined, xhr.status));
-          return;
-        }
-        resolve(payload.data);
-      });
-
-      xhr.addEventListener('error', () => {
-        reject(new ApiErrorBase('上传过程中网络连接中断，请检查网络后重试', undefined, 0));
-      });
-
-      xhr.send(formData);
-    });
-  }
-
-  static confirmManualServerUpgrade(uploadToken: string): Promise<UploadedServerBinaryInfo> {
-    return this.post<UploadedServerBinaryInfo>('/manual-upgrade', {
-      upload_token: uploadToken,
-    });
-  }
-
-  static createUpgradeLogsWebSocket(): WebSocket | null {
-    if (typeof window === 'undefined') {
-      return null;
-    }
-
-    const apiUrl = this.getApiUrl('/logs/ws');
-    const resolvedUrl = apiUrl.startsWith('http://')
-      ? `ws://${apiUrl.slice('http://'.length)}`
-      : apiUrl.startsWith('https://')
-        ? `wss://${apiUrl.slice('https://'.length)}`
-        : `${window.location.protocol === 'https:' ? 'wss:' : 'ws:'}//${window.location.host}${apiUrl}`;
-
-    return new WebSocket(resolvedUrl);
-  }
-
-  static parseUpgradeStreamSnapshot(rawMessage: string): UpgradeStreamSnapshot | null {
-    try {
-      const parsed = JSON.parse(rawMessage) as Partial<UpgradeStreamSnapshot>;
-      if (
-        typeof parsed.in_progress !== 'boolean' ||
-        typeof parsed.upgrade_status !== 'string' ||
-        !Array.isArray(parsed.upgrade_logs)
-      ) {
-        return null;
-      }
-      return {
-        in_progress: parsed.in_progress,
-        upgrade_status: parsed.upgrade_status,
-        upgrade_logs: parsed.upgrade_logs,
-      };
-    } catch {
-      return null;
-    }
-  }
-}

Wavelet/internal/apps/openflare/option/logics.go

@@ -146,13 +146,6 @@ func getNotice(ctx context.Context) (string, error) {
 	return model.OptionValue("Notice"), nil
 }
 
-func getAbout(ctx context.Context) (string, error) {
-	if err := EnsureInitialized(ctx); err != nil {
-		return "", err
-	}
-	return model.OptionValue("About"), nil
-}
-
 func getStatus(ctx context.Context, baseAPIPath string) (*statusView, error) {
 	if err := EnsureInitialized(ctx); err != nil {
 		return nil, err

Wavelet/internal/apps/openflare/option/logics_test.go

@@ -73,21 +73,16 @@ func TestUpdateOptionHotReloadsOptionMap(t *testing.T) {
 	assert.Equal(t, "HotReloaded", model.SystemName)
 }
 
-func TestGetNoticeAndAbout(t *testing.T) {
+func TestGetNotice(t *testing.T) {
 	cleanup := setupOptionTestDB(t)
 	defer cleanup()
 	ctx := context.Background()
 
 	require.NoError(t, updateOption(ctx, model.OpenFlareOption{Key: "Notice", Value: "hello"}))
-	require.NoError(t, updateOption(ctx, model.OpenFlareOption{Key: "About", Value: "about-us"}))
 
 	notice, err := getNotice(ctx)
 	require.NoError(t, err)
 	assert.Equal(t, "hello", notice)
-
-	about, err := getAbout(ctx)
-	require.NoError(t, err)
-	assert.Equal(t, "about-us", about)
 }
 
 func TestLookupGeoIPDisabledProvider(t *testing.T) {

Wavelet/internal/apps/openflare/option/routers.go

@@ -50,24 +50,6 @@ func GetNoticeHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, response.OK(notice))
 }
 
-// getAboutHandler 获取关于信息。
-// @Summary 获取关于信息
-// @Description 返回 OpenFlare 关于页面文本，无需登录
-// @Tags openflare-option
-// @Produce json
-// @Success 200 {object} response.Any{data=string} "关于信息"
-// @Failure 400 {object} response.Any "参数错误"
-// @Failure 500 {object} response.Any "内部错误"
-// @Router /api/v1/d/about [get]
-// GetAboutHandler returns the about content.
-func GetAboutHandler(c *gin.Context) {
-	about, err := getAbout(c.Request.Context())
-	if apiutil.AbortBadRequestOnError(c, err) {
-		return
-	}
-	c.JSON(http.StatusOK, response.OK(about))
-}
-
 // listOptionsHandler 列出全部配置项。
 // @Summary 列出 OpenFlare 配置项
 // @Description 返回全部非敏感 OpenFlare 配置项，需要管理员权限

Wavelet/internal/apps/openflare/update/logics.go

@@ -1,262 +0,0 @@
-// Copyright 2026 Arctel.net
-// SPDX-License-Identifier: Apache-2.0
-
-package update
-
-import (
-	"context"
-	"errors"
-	"fmt"
-	"runtime"
-	"strings"
-	"sync"
-	"time"
-
-	"github.com/Rain-kl/Wavelet/internal/apps/admin/updater"
-	"github.com/Rain-kl/Wavelet/pkg/logger"
-)
-
-const (
-	channelStable  = "stable"
-	channelPreview = "preview"
-)
-
-// UpgradeLogRecord is a single upgrade log entry for the legacy update API.
-type UpgradeLogRecord struct {
-	Level     string    `json:"level"`
-	Message   string    `json:"message"`
-	CreatedAt time.Time `json:"created_at"`
-}
-
-// LatestReleaseView mirrors the legacy OpenFlare latest-release payload.
-type LatestReleaseView struct {
-	TagName          string             `json:"tag_name"`
-	Body             string             `json:"body"`
-	HTMLURL          string             `json:"html_url"`
-	PublishedAt      string             `json:"published_at"`
-	Channel          string             `json:"channel"`
-	Prerelease       bool               `json:"prerelease"`
-	CurrentVersion   string             `json:"current_version"`
-	HasUpdate        bool               `json:"has_update"`
-	UpgradeSupported bool               `json:"upgrade_supported"`
-	InProgress       bool               `json:"in_progress"`
-	UpgradeStatus    string             `json:"upgrade_status"`
-	UpgradeLogs      []UpgradeLogRecord `json:"upgrade_logs"`
-}
-
-// StreamSnapshot is pushed over the upgrade logs websocket.
-type StreamSnapshot struct {
-	InProgress    bool               `json:"in_progress"`
-	UpgradeStatus string             `json:"upgrade_status"`
-	UpgradeLogs   []UpgradeLogRecord `json:"upgrade_logs"`
-}
-
-type upgradeRequest struct {
-	Channel string `json:"channel"`
-}
-
-var upgradeState struct {
-	sync.Mutex
-	inProgress bool
-	status     string
-	logs       []UpgradeLogRecord
-}
-
-var upgradeSubscribers struct {
-	sync.Mutex
-	nextID    int
-	listeners map[int]chan StreamSnapshot
-}
-
-func init() {
-	upgradeSubscribers.listeners = make(map[int]chan StreamSnapshot)
-	upgradeState.status = "idle"
-}
-
-func normalizeChannel(channel string) string {
-	switch strings.ToLower(strings.TrimSpace(channel)) {
-	case channelPreview:
-		return channelPreview
-	default:
-		return channelStable
-	}
-}
-
-func isDevBuild(version string) bool {
-	version = strings.TrimSpace(version)
-	return version == "" || strings.EqualFold(version, "dev")
-}
-
-func mapStatusToLatestRelease(status updater.Status, channel string) *LatestReleaseView {
-	inProgress, upgradeStatus, logs := snapshotUpgradeState()
-	view := &LatestReleaseView{
-		TagName:          status.LatestVersion,
-		Body:             status.ReleaseNotes,
-		HTMLURL:          status.ReleaseURL,
-		PublishedAt:      status.PublishedAt,
-		Channel:          channel,
-		Prerelease:       status.Prerelease,
-		CurrentVersion:   status.CurrentVersion,
-		HasUpdate:        status.UpdateAvailable,
-		UpgradeSupported: !isDevBuild(status.CurrentVersion) && runtime.GOOS != "windows",
-		InProgress:       inProgress || updater.IsUpgrading(),
-		UpgradeStatus:    upgradeStatus,
-		UpgradeLogs:      logs,
-	}
-	if channel == channelPreview && status.Prerelease {
-		view.HasUpdate = !isDevBuild(status.CurrentVersion)
-	}
-	return view
-}
-
-// GetLatestRelease returns the newest upstream release for the requested channel.
-func GetLatestRelease(ctx context.Context, channel string) (*LatestReleaseView, error) {
-	normalizedChannel := normalizeChannel(channel)
-	status, err := updater.GetStatus(ctx)
-	if err != nil {
-		return nil, err
-	}
-	return mapStatusToLatestRelease(status, normalizedChannel), nil
-}
-
-// ScheduleUpgrade downloads the latest release and restarts with the staged binary.
-func ScheduleUpgrade(ctx context.Context, channel string) (*LatestReleaseView, error) {
-	normalizedChannel := normalizeChannel(channel)
-
-	upgradeState.Lock()
-	if upgradeState.inProgress || updater.IsUpgrading() {
-		upgradeState.Unlock()
-		return nil, errors.New("服务升级正在执行中，请稍后再试")
-	}
-	resetUpgradeLogsLocked()
-	upgradeState.inProgress = true
-	upgradeState.status = "running"
-	appendUpgradeLogLocked("info", fmt.Sprintf("Automatic upgrade scheduled for channel: %s.", normalizedChannel))
-	upgradeState.Unlock()
-	broadcastUpgradeSnapshot()
-
-	executable, stagedBinary, status, err := updater.PrepareUpgrade(ctx)
-	if err != nil {
-		recordUpgradeFailure(err)
-		return nil, err
-	}
-
-	view := mapStatusToLatestRelease(status, normalizedChannel)
-	view.InProgress = true
-	view.UpgradeStatus = "running"
-	view.UpgradeLogs = snapshotUpgradeLogs()
-
-	appendUpgradeLogLocked("info", fmt.Sprintf("Upgrade package prepared: %s.", status.LatestVersion))
-	broadcastUpgradeSnapshot()
-
-	go func() {
-		time.Sleep(time.Second)
-		if err := updater.ApplyPreparedUpgrade(executable, stagedBinary); err != nil {
-			updater.FinishUpgrade()
-			recordUpgradeFailure(err)
-			logger.ErrorF(context.Background(), "[Update] replace and restart failed: %v", err)
-		}
-	}()
-
-	return view, nil
-}
-
-// UploadManualBinary is disabled in the legacy OpenFlare server.
-func UploadManualBinary() error {
-	return errors.New("手动升级功能已禁用")
-}
-
-// ConfirmManualUpgrade is disabled in the legacy OpenFlare server.
-func ConfirmManualUpgrade() error {
-	return errors.New("手动升级功能已禁用")
-}
-
-// SubscribeUpgradeStream registers a listener for upgrade websocket snapshots.
-func SubscribeUpgradeStream() (<-chan StreamSnapshot, func()) {
-	upgradeSubscribers.Lock()
-	defer upgradeSubscribers.Unlock()
-
-	id := upgradeSubscribers.nextID
-	upgradeSubscribers.nextID++
-	ch := make(chan StreamSnapshot, 1)
-	upgradeSubscribers.listeners[id] = ch
-
-	unsubscribe := func() {
-		upgradeSubscribers.Lock()
-		defer upgradeSubscribers.Unlock()
-		if listener, ok := upgradeSubscribers.listeners[id]; ok {
-			delete(upgradeSubscribers.listeners, id)
-			close(listener)
-		}
-	}
-
-	select {
-	case ch <- currentUpgradeSnapshot():
-	default:
-	}
-
-	return ch, unsubscribe
-}
-
-func snapshotUpgradeState() (bool, string, []UpgradeLogRecord) {
-	upgradeState.Lock()
-	defer upgradeState.Unlock()
-	return upgradeState.inProgress || updater.IsUpgrading(), upgradeState.status, cloneUpgradeLogsLocked()
-}
-
-func snapshotUpgradeLogs() []UpgradeLogRecord {
-	upgradeState.Lock()
-	defer upgradeState.Unlock()
-	return cloneUpgradeLogsLocked()
-}
-
-func currentUpgradeSnapshot() StreamSnapshot {
-	inProgress, status, logs := snapshotUpgradeState()
-	return StreamSnapshot{
-		InProgress:    inProgress,
-		UpgradeStatus: status,
-		UpgradeLogs:   logs,
-	}
-}
-
-func resetUpgradeLogsLocked() {
-	upgradeState.logs = nil
-}
-
-func appendUpgradeLogLocked(level, message string) {
-	upgradeState.logs = append(upgradeState.logs, UpgradeLogRecord{
-		Level:     level,
-		Message:   message,
-		CreatedAt: time.Now().UTC(),
-	})
-}
-
-func cloneUpgradeLogsLocked() []UpgradeLogRecord {
-	if len(upgradeState.logs) == 0 {
-		return []UpgradeLogRecord{}
-	}
-	cloned := make([]UpgradeLogRecord, len(upgradeState.logs))
-	copy(cloned, upgradeState.logs)
-	return cloned
-}
-
-func recordUpgradeFailure(err error) {
-	upgradeState.Lock()
-	upgradeState.inProgress = false
-	upgradeState.status = "failed"
-	appendUpgradeLogLocked("error", err.Error())
-	upgradeState.Unlock()
-	broadcastUpgradeSnapshot()
-}
-
-func broadcastUpgradeSnapshot() {
-	snapshot := currentUpgradeSnapshot()
-	upgradeSubscribers.Lock()
-	defer upgradeSubscribers.Unlock()
-	for _, listener := range upgradeSubscribers.listeners {
-		select {
-		case listener <- snapshot:
-		default:
-		}
-	}
-}

Wavelet/internal/apps/openflare/update/routers.go

@@ -1,157 +0,0 @@
-// Copyright 2026 Arctel.net
-// SPDX-License-Identifier: Apache-2.0
-
-package update
-
-import (
-	"encoding/json"
-	"errors"
-	"io"
-	"net/http"
-	"time"
-
-	"github.com/Rain-kl/Wavelet/internal/apps/openflare/apiutil"
-	"github.com/Rain-kl/Wavelet/internal/common/response"
-	"github.com/gin-gonic/gin"
-	"github.com/gorilla/websocket"
-)
-
-var upgradeLogsUpgrader = websocket.Upgrader{
-	CheckOrigin: func(_ *http.Request) bool { return true },
-}
-
-
-// GetLatestReleaseHandler 获取最新 GitHub 发布版本。
-// @Summary 获取最新服务端发布版本
-// @Description 查询 OpenFlare 服务端最新 GitHub Release 及升级状态，需要管理员权限
-// @Tags openflare-update
-// @Produce json
-// @Security SessionCookie
-// @Param channel query string false "发布渠道（stable/preview）"
-// @Success 200 {object} response.Any{data=update.LatestReleaseView} "最新发布信息"
-// @Failure 400 {object} response.Any "参数错误"
-// @Failure 401 {object} response.Any "未登录"
-// @Failure 403 {object} response.Any "无管理员权限"
-// @Failure 500 {object} response.Any "内部错误"
-// @Router /api/v1/d/update/latest-release [get]
-func GetLatestReleaseHandler(c *gin.Context) {
-	release, err := GetLatestRelease(c.Request.Context(), c.Query("channel"))
-	if apiutil.AbortBadRequestOnError(c, err) {
-		return
-	}
-	c.JSON(http.StatusOK, response.OK(release))
-}
-
-// UpgradeServerHandler 调度自动升级任务。
-// @Summary 触发服务端自动升级
-// @Description 从最新 Release 调度 OpenFlare 服务端自动升级，需要管理员权限
-// @Tags openflare-update
-// @Accept json
-// @Produce json
-// @Security SessionCookie
-// @Param request body update.upgradeRequest false "升级参数"
-// @Success 200 {object} response.Any{data=update.LatestReleaseView} "升级任务已调度"
-// @Failure 400 {object} response.Any "参数错误"
-// @Failure 401 {object} response.Any "未登录"
-// @Failure 403 {object} response.Any "无管理员权限"
-// @Failure 500 {object} response.Any "内部错误"
-// @Router /api/v1/d/update/upgrade [post]
-func UpgradeServerHandler(c *gin.Context) {
-	var request upgradeRequest
-	if err := bindOptionalJSON(c.Request.Body, &request); err != nil {
-		response.AbortBadRequest(c, "无效的参数")
-		return
-	}
-
-	release, err := ScheduleUpgrade(c.Request.Context(), request.Channel)
-	if apiutil.AbortBadRequestOnError(c, err) {
-		return
-	}
-
-	c.JSON(http.StatusOK, response.OK(release))
-}
-
-// UploadManualServerBinaryHandler 上传手动升级二进制（已禁用）。
-// @Summary 上传手动升级二进制
-// @Description 上传服务端二进制以进行手动升级（当前功能已禁用），需要管理员权限
-// @Tags openflare-update
-// @Accept multipart/form-data
-// @Produce json
-// @Security SessionCookie
-// @Param binary formData file true "服务端二进制文件"
-// @Failure 400 {object} response.Any "功能已禁用或参数错误"
-// @Failure 401 {object} response.Any "未登录"
-// @Failure 403 {object} response.Any "无管理员权限"
-// @Router /api/v1/d/update/manual-upload [post]
-func UploadManualServerBinaryHandler(c *gin.Context) {
-	if apiutil.AbortBadRequestOnError(c, UploadManualBinary()) {
-		return
-	}
-}
-
-// ConfirmManualServerUpgradeHandler 确认手动升级（已禁用）。
-// @Summary 确认手动服务端升级
-// @Description 确认并执行手动上传的服务端升级（当前功能已禁用），需要管理员权限
-// @Tags openflare-update
-// @Accept json
-// @Produce json
-// @Security SessionCookie
-// @Failure 400 {object} response.Any "功能已禁用或参数错误"
-// @Failure 401 {object} response.Any "未登录"
-// @Failure 403 {object} response.Any "无管理员权限"
-// @Router /api/v1/d/update/manual-upgrade [post]
-func ConfirmManualServerUpgradeHandler(c *gin.Context) {
-	if apiutil.AbortBadRequestOnError(c, ConfirmManualUpgrade()) {
-		return
-	}
-}
-
-// StreamServerUpgradeLogsHandler 通过 WebSocket 推送升级日志。
-// @Summary 流式获取服务端升级日志
-// @Description 通过 WebSocket 推送升级进度快照，需要管理员权限
-// @Tags openflare-update
-// @Security SessionCookie
-// @Success 101 {object} update.StreamSnapshot "WebSocket 升级日志流"
-// @Failure 401 {object} response.Any "未登录"
-// @Failure 403 {object} response.Any "无管理员权限"
-// @Router /api/v1/d/update/logs/ws [get]
-func StreamServerUpgradeLogsHandler(c *gin.Context) {
-	conn, err := upgradeLogsUpgrader.Upgrade(c.Writer, c.Request, nil)
-	if err != nil {
-		return
-	}
-	defer func() {
-		_ = conn.Close()
-	}()
-
-	updates, unsubscribe := SubscribeUpgradeStream()
-	defer unsubscribe()
-
-	heartbeatTicker := time.NewTicker(15 * time.Second)
-	defer heartbeatTicker.Stop()
-
-	for {
-		select {
-		case snapshot, ok := <-updates:
-			if !ok {
-				return
-			}
-			if err := conn.WriteJSON(snapshot); err != nil {
-				return
-			}
-		case <-heartbeatTicker.C:
-			if err := conn.WriteJSON(StreamSnapshot{}); err != nil {
-				return
-			}
-		case <-c.Request.Context().Done():
-			return
-		}
-	}
-}
-
-func bindOptionalJSON(body io.Reader, target any) error {
-	if err := json.NewDecoder(body).Decode(target); err != nil && !errors.Is(err, io.EOF) {
-		return err
-	}
-	return nil
-}

Wavelet/internal/router/v1/openflare/register_option.go

@@ -12,7 +12,6 @@ import (
 func registerOptionRoutes(apiGroup *gin.RouterGroup) {
 	apiGroup.GET("/status", option.GetStatusHandler)
 	apiGroup.GET("/notice", option.GetNoticeHandler)
-	apiGroup.GET("/about", option.GetAboutHandler)
 
 	optionRoute := apiGroup.Group("/option")
 	optionRoute.Use(apiutil.AdminMiddlewares()...)

Wavelet/internal/router/v1/openflare/register_update.go

@@ -1,22 +0,0 @@
-// Copyright 2026 Arctel.net
-// SPDX-License-Identifier: Apache-2.0
-
-package openflare
-
-import (
-	"github.com/Rain-kl/Wavelet/internal/apps/openflare/apiutil"
-	"github.com/Rain-kl/Wavelet/internal/apps/openflare/update"
-	"github.com/gin-gonic/gin"
-)
-
-func registerUpdateRoutes(apiGroup *gin.RouterGroup) {
-	updateRoute := apiGroup.Group("/update")
-	updateRoute.Use(apiutil.AdminMiddlewares()...)
-	{
-		updateRoute.GET("/latest-release", update.GetLatestReleaseHandler)
-		updateRoute.GET("/logs/ws", update.StreamServerUpgradeLogsHandler)
-		updateRoute.POST("/manual-upload", update.UploadManualServerBinaryHandler)
-		updateRoute.POST("/manual-upgrade", update.ConfirmManualServerUpgradeHandler)
-		updateRoute.POST("/upgrade", update.UpgradeServerHandler)
-	}
-}

Wavelet/internal/router/v1/openflare/v1.go

@@ -22,5 +22,4 @@ func RegisterV1Routes(apiV1Router *gin.RouterGroup) {
 	registerPagesRoutes(group)
 	registerDashboardRoutes(group)
 	registerObservabilityRoutes(group)
-	registerUpdateRoutes(group)
 }

docs/changelog/index.md

@@ -18,8 +18,10 @@ sidebar: false
 
 ### 移除
 
+- 移除 Wavelet About 界面相关代码：删除 `AboutService` 与 `GET /api/v1/d/about` 接口（页面从未实现，属冗余遗留）。
 - 移除 Wavelet 中从旧系统迁移但未实装的全局 API / Web / 敏感接口限流选项（`GlobalApiRateLimit*`、`GlobalWebRateLimit*`、`CriticalRateLimit*`）及相关校验与数据库种子。
 - 移除 `internal/apps/openflare/legacy/` 控制台兼容层、`compat/auth.go`（`OpenFlare-Token` JWT 桥接）及前端 `legacy-base.service.ts`；`openflare-server/web` 不再能对接当前 Wavelet 后端管理 API。
+- 移除旧 OpenFlare 服务升级兼容层（`/api/v1/openflare/update/*`）；统一使用 Wavelet 框架 `admin/updater`（`/api/v1/admin/update`）。
 
 ### 新增