feat(更新): 自动更新——检查 GitHub 最新版并后台下载、退出时覆盖安装

- 启动 15s 后自动检查 GitHub Releases，每 4 小时复查
- 发现新版即后台静默下载，退出应用时按原安装路径静默覆盖安装（Windows）
- 设置页新增「版本与更新」卡片：开关 / 当前版本 / 实时状态 / 立即检查与重启更新
- 用 toast 替代原系统弹窗，不打断使用；macOS 未签名不支持自动更新则提示手动下载

Author: simpleqt

package.json

@@ -1,6 +1,6 @@
 {
   "name": "snanswer",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "截屏解题助手，实时截屏并生成解题思路和答案",
   "main": "./out/main/index.js",
   "scripts": {

src/main/auto-updater.ts

@@ -1,55 +1,138 @@
-import { dialog } from 'electron'
+import { app, ipcMain } from 'electron'
 import { autoUpdater } from 'electron-updater'
+import { settings, registerSettingsChangeHook } from './settings'
 
-export function initAutoUpdater(): void {
-  if (process.platform === 'darwin') {
-    return
+/**
+ * Auto-update from GitHub Releases: checks after startup (and every 4 h),
+ * downloads in the background, and installs silently over the existing
+ * install path on quit (NSIS keeps the registry install location). macOS is
+ * excluded — unsigned builds cannot auto-update, users download the dmg.
+ */
+
+const STARTUP_DELAY_MS = 15 * 1000
+const CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000
+
+export interface UpdateStatus {
+  status:
+    | 'idle'
+    | 'checking'
+    | 'downloading'
+    | 'downloaded'
+    | 'not-available'
+    | 'error'
+    | 'unsupported'
+  currentVersion: string
+  version?: string
+  progress?: number
+  message?: string
+}
+
+let status: UpdateStatus = { status: 'idle', currentVersion: app.getVersion() }
+let startupTimer: NodeJS.Timeout | null = null
+let intervalTimer: NodeJS.Timeout | null = null
+let lastAvailableVersion = ''
+let initialized = false
+
+function sendToRenderer(channel: string, ...args: unknown[]) {
+  const mainWindow = global.mainWindow
+  if (mainWindow && !mainWindow.isDestroyed()) {
+    mainWindow.webContents.send(channel, ...args)
   }
+}
 
-  try {
-    autoUpdater.autoDownload = false
-
-    autoUpdater.on('update-available', async () => {
-      const result = await dialog.showMessageBox({
-        type: 'info',
-        buttons: ['立即下载', '稍后'],
-        defaultId: 0,
-        cancelId: 1,
-        title: '发现新版本',
-        message: '检测到新版本可用。',
-        detail: '现在下载并安装更新吗？'
-      })
-      if (result.response === 0) {
-        autoUpdater.downloadUpdate().catch((err) => console.error(err))
-      }
-    })
+function setStatus(next: Partial<UpdateStatus> & { status: UpdateStatus['status'] }): void {
+  status = { ...status, ...next }
+  sendToRenderer('update-status', status)
+}
 
-    autoUpdater.on('error', (error) => {
-      console.error('Auto update error:', error)
+function checkNow(): UpdateStatus {
+  if (!initialized) {
+    setStatus({
+      status: 'unsupported',
+      message: 'macOS 暂不支持自动更新，请到 GitHub Releases 手动下载 dmg'
     })
+    return status
+  }
+  if (status.status === 'checking' || status.status === 'downloading') {
+    return status // a check/download is already in flight
+  }
+  autoUpdater.checkForUpdates().catch((err) => {
+    console.error('Auto update check failed:', err)
+    setStatus({ status: 'error', message: err instanceof Error ? err.message : String(err) })
+  })
+  setStatus({ status: 'checking', message: undefined })
+  return status
+}
 
-    autoUpdater.on('update-not-available', () => {
-      // no-op
-    })
+function syncSchedule(): void {
+  if (startupTimer) {
+    clearTimeout(startupTimer)
+    startupTimer = null
+  }
+  if (intervalTimer) {
+    clearInterval(intervalTimer)
+    intervalTimer = null
+  }
+  if (!initialized || !settings.autoUpdateEnabled) return
+  startupTimer = setTimeout(() => {
+    startupTimer = null
+    checkNow()
+  }, STARTUP_DELAY_MS)
+  intervalTimer = setInterval(() => checkNow(), CHECK_INTERVAL_MS)
+}
 
-    autoUpdater.on('update-downloaded', async () => {
-      const res = await dialog.showMessageBox({
-        type: 'info',
-        buttons: ['立即重启', '稍后'],
-        defaultId: 0,
-        cancelId: 1,
-        title: '更新已就绪',
-        message: '更新已下载完成。',
-        detail: '是否立即重启以应用更新？'
-      })
-      if (res.response === 0) {
-        setImmediate(() => autoUpdater.quitAndInstall(false, true))
-      }
-    })
+export function getUpdateStatus(): UpdateStatus {
+  return status
+}
+
+export function initAutoUpdater(): void {
+  // IPC is registered on every platform so the renderer UI stays consistent
+  ipcMain.handle('get-update-status', () => getUpdateStatus())
+  ipcMain.handle('check-update', () => checkNow())
+  ipcMain.handle('install-update', () => {
+    if (initialized && status.status === 'downloaded') {
+      // Silent install over the current install path, relaunch after
+      autoUpdater.quitAndInstall(true, true)
+    }
+    return getUpdateStatus()
+  })
 
-    // Trigger the check after window creation
-    autoUpdater.checkForUpdates().catch((err) => console.error(err))
-  } catch (e) {
-    console.error('Failed to initialize auto-updater:', e)
+  registerSettingsChangeHook((changed) => {
+    if ('autoUpdateEnabled' in changed) {
+      syncSchedule()
+    }
+  })
+
+  if (process.platform === 'darwin') {
+    return
   }
+
+  initialized = true
+  autoUpdater.autoDownload = true
+  autoUpdater.autoInstallOnAppQuit = true
+
+  autoUpdater.on('checking-for-update', () => setStatus({ status: 'checking', message: undefined }))
+  autoUpdater.on('update-available', (info) => {
+    lastAvailableVersion = info.version
+    setStatus({ status: 'downloading', version: info.version, progress: 0 })
+  })
+  autoUpdater.on('download-progress', (progress) => {
+    setStatus({
+      status: 'downloading',
+      version: lastAvailableVersion || undefined,
+      progress: Math.round(progress.percent)
+    })
+  })
+  autoUpdater.on('update-downloaded', (info) => {
+    setStatus({ status: 'downloaded', version: info.version, progress: 100 })
+  })
+  autoUpdater.on('update-not-available', () =>
+    setStatus({ status: 'not-available', message: undefined })
+  )
+  autoUpdater.on('error', (err) => {
+    console.error('Auto update error:', err)
+    setStatus({ status: 'error', message: err.message })
+  })
+
+  syncSchedule()
 }

src/main/settings.ts

@@ -68,7 +68,9 @@ export const settings = {
   /** Real-time interview assistant: auto-answer detected interviewer questions */
   interviewAssistantEnabled: false,
   /** Global left-button click capture mode */
-  clickCaptureMode: 'off' as ClickCaptureMode
+  clickCaptureMode: 'off' as ClickCaptureMode,
+  /** Auto-update from GitHub Releases (Windows; silent install on quit) */
+  autoUpdateEnabled: true
 }
 
 export type AppSettings = typeof settings

src/preload/index.ts

@@ -69,6 +69,25 @@ const api = {
     ipcRenderer.removeAllListeners('double-click-state')
   },
 
+  // Auto-update (GitHub Releases)
+  getUpdateStatus: () => ipcRenderer.invoke('get-update-status'),
+  checkForUpdate: () => ipcRenderer.invoke('check-update'),
+  installUpdate: () => ipcRenderer.invoke('install-update'),
+  onUpdateStatus: (
+    callback: (data: {
+      status: string
+      currentVersion: string
+      version?: string
+      progress?: number
+      message?: string
+    }) => void
+  ) => {
+    ipcRenderer.on('update-status', (_event, data) => callback(data))
+  },
+  removeUpdateStatusListener: () => {
+    ipcRenderer.removeAllListeners('update-status')
+  },
+
   // Listen for screenshot events
   onScreenshotTaken: (callback: (screenshotData: string) => void) => {
     ipcRenderer.on('screenshot-taken', (_event, screenshotData) => {

src/renderer/src/App.tsx

@@ -107,6 +107,22 @@ export default function App() {
     return () => window.api.removeAssistantStateListener()
   }, [])
 
+  // Auto-update notifications (quiet toasts instead of blocking dialogs)
+  useEffect(() => {
+    window.api.onUpdateStatus((info) => {
+      if (info.status === 'downloaded') {
+        toast.success(`新版本 v${info.version ?? ''} 已就绪，退出应用时自动安装`, {
+          description: '可到「设置 → 版本与更新」立即重启更新'
+        })
+      } else if (info.status === 'downloading' && (info.progress ?? 0) === 0) {
+        toast.info(`发现新版本 v${info.version ?? ''}，正在后台下载…`)
+      }
+    })
+    return () => {
+      window.api.removeUpdateStatusListener()
+    }
+  }, [])
+
   return (
     <>
       <HashRouter>

src/renderer/src/lib/store/settings.ts

@@ -110,6 +110,9 @@ interface Settings {
   /** Saved provider profiles for one-key switching (URL/Key/model/thinking) */
   providerProfiles: ProviderProfile[]
   activeProviderId: string
+
+  /** Auto-update from GitHub Releases */
+  autoUpdateEnabled: boolean
 }
 
 export interface ProviderProfile {
@@ -185,7 +188,9 @@ const defaultSettings: Settings = {
   enableThinking: false,
 
   providerProfiles: [],
-  activeProviderId: ''
+  activeProviderId: '',
+
+  autoUpdateEnabled: true
 }
 
 export const useSettingsStore = create<SettingsStore>()(

src/renderer/src/settings/index.tsx

@@ -15,6 +15,7 @@ import {
   RotateCcw,
   Smartphone,
   MousePointerClick,
+  RefreshCw,
   X
 } from 'lucide-react'
 import QRCode from 'react-qr-code'
@@ -133,6 +134,7 @@ export default function SettingsPage() {
     enableThinking,
     providerProfiles,
     activeProviderId,
+    autoUpdateEnabled,
     updateSetting,
     applyProviderProfile,
     saveProviderProfile,
@@ -150,6 +152,52 @@ export default function SettingsPage() {
 
   const [audioDevices, setAudioDevices] = useState<MediaDeviceInfo[]>([])
   const [mobileInfo, setMobileInfo] = useState<MobileServerInfo | null>(null)
+  const [updateInfo, setUpdateInfo] = useState<{
+    status: string
+    currentVersion: string
+    version?: string
+    progress?: number
+    message?: string
+  } | null>(null)
+
+  useEffect(() => {
+    const load = async () => {
+      try {
+        setUpdateInfo(await window.api.getUpdateStatus())
+      } catch (err) {
+        console.error('Failed to get update status:', err)
+      }
+    }
+    load()
+    window.api.onUpdateStatus(setUpdateInfo)
+    return () => {
+      window.api.removeUpdateStatusListener()
+    }
+  }, [])
+
+  const updateStatusText =
+    updateInfo?.status === 'checking'
+      ? '正在检查更新…'
+      : updateInfo?.status === 'downloading'
+        ? `正在下载 v${updateInfo.version ?? ''}（${updateInfo.progress ?? 0}%）`
+        : updateInfo?.status === 'downloaded'
+          ? `新版本 v${updateInfo.version ?? ''} 已就绪，退出时自动安装`
+          : updateInfo?.status === 'not-available'
+            ? '已是最新版本'
+            : updateInfo?.status === 'error'
+              ? '检查更新失败'
+              : updateInfo?.status === 'unsupported'
+                ? 'macOS 暂不支持自动更新，请手动下载 dmg'
+                : ''
+
+  const updateButtonText =
+    updateInfo?.status === 'checking'
+      ? '检查中…'
+      : updateInfo?.status === 'downloading'
+        ? `下载中 ${updateInfo.progress ?? 0}%`
+        : updateInfo?.status === 'downloaded'
+          ? '重启并更新'
+          : '立即检查'
 
   const activeScene = scenes.find((s) => s.id === activeSceneId)
   const deletingScene = scenes.find((s) => s.id === sceneToDelete)
@@ -1005,6 +1053,52 @@ export default function SettingsPage() {
             )}
           </div>
         </div>
+
+        {/* Version & Update */}
+        <div className="bg-gray-300/80 rounded-lg p-6">
+          <h2 className="text-lg font-semibold mb-4 flex items-center">
+            <RefreshCw className="h-5 w-5 mr-2" />
+            版本与更新
+          </h2>
+
+          <div className="space-y-4">
+            <div className="flex items-center justify-between">
+              <label className="text-sm font-medium">
+                自动更新
+                <span className="ml-2 text-xs font-light">
+                  自动检查 GitHub 最新版本并后台下载，退出时自动覆盖安装到当前目录（Windows）
+                </span>
+              </label>
+              <Switch
+                className="scale-y-90"
+                checked={autoUpdateEnabled}
+                onCheckedChange={(checked) => updateSetting('autoUpdateEnabled', checked)}
+              />
+            </div>
+            <div className="flex items-center justify-between">
+              <label className="text-sm font-medium">
+                当前版本 v{updateInfo?.currentVersion ?? '--'}
+                <span className="ml-2 text-xs font-light">{updateStatusText}</span>
+              </label>
+              <Button
+                variant="outline"
+                size="sm"
+                disabled={updateInfo?.status === 'checking' || updateInfo?.status === 'downloading'}
+                onClick={async () => {
+                  const st = await window.api.checkForUpdate()
+                  if (st.status === 'downloaded') {
+                    await window.api.installUpdate()
+                  }
+                }}
+              >
+                {updateButtonText}
+              </Button>
+            </div>
+            {updateInfo?.status === 'error' && updateInfo.message && (
+              <p className="text-xs text-red-600 break-all">{updateInfo.message}</p>
+            )}
+          </div>
+        </div>
       </div>
     </>
   )