@lobehub/lobehub 2.0.0-next.291 → 2.0.0-next.293

package/apps/desktop/scripts/update-test/setup.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+
+# ============================================
+# 本地更新测试 - 一键设置脚本
+# ============================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_DIR="$SCRIPT_DIR/server"
+
+echo "🚀 设置本地更新测试环境..."
+
+# 创建服务器目录
+mkdir -p "$SERVER_DIR"
+echo "✅ 创建服务器目录: $SERVER_DIR"
+
+# 设置脚本执行权限
+chmod +x "$SCRIPT_DIR"/*.sh
+echo "✅ 设置脚本执行权限"
+
+# 检查是否安装了 serve
+if ! command -v npx &> /dev/null; then
+    echo "❌ 需要安装 Node.js 和 npm"
+    exit 1
+fi
+
+# 创建示例 latest-mac.yml
+cat > "$SERVER_DIR/latest-mac.yml" << 'EOF'
+version: 99.0.0
+files:
+  - url: LobeHub-99.0.0-arm64.dmg
+    sha512: placeholder-sha512-will-be-replaced
+    size: 100000000
+  - url: LobeHub-99.0.0-arm64-mac.zip
+    sha512: placeholder-sha512-will-be-replaced
+    size: 100000000
+path: LobeHub-99.0.0-arm64.dmg
+sha512: placeholder-sha512-will-be-replaced
+releaseDate: '2026-01-15T10:00:00.000Z'
+releaseNotes: |
+  ## 🎉 v99.0.0 本地测试版本
+
+  这是一个用于本地测试更新功能的模拟版本。
+
+  ### ✨ 新功能
+  - 测试功能 A
+  - 测试功能 B
+
+  ### 🐛 修复
+  - 修复测试问题 X
+EOF
+echo "✅ 创建示例 latest-mac.yml"
+
+# 创建 Windows 版本的 manifest (可选)
+cat > "$SERVER_DIR/latest.yml" << 'EOF'
+version: 99.0.0
+files:
+  - url: LobeHub-99.0.0-setup.exe
+    sha512: placeholder-sha512-will-be-replaced
+    size: 100000000
+path: LobeHub-99.0.0-setup.exe
+sha512: placeholder-sha512-will-be-replaced
+releaseDate: '2026-01-15T10:00:00.000Z'
+releaseNotes: |
+  ## 🎉 v99.0.0 本地测试版本
+
+  这是一个用于本地测试更新功能的模拟版本。
+EOF
+echo "✅ 创建示例 latest.yml (Windows)"
+
+# 创建本地测试用的 dev-app-update.yml
+cat > "$SCRIPT_DIR/dev-app-update.local.yml" << 'EOF'
+# 本地更新测试配置
+# 将此文件复制到 apps/desktop/dev-app-update.yml 以使用本地服务器测试
+
+provider: generic
+url: http://localhost:8787
+updaterCacheDirName: lobehub-desktop-local-test
+EOF
+echo "✅ 创建本地测试配置文件"
+
+echo ""
+echo "============================================"
+echo "✅ 设置完成！"
+echo "============================================"
+echo ""
+echo "下一步操作："
+echo ""
+echo "1. 构建测试包："
+echo "   cd $(dirname "$SCRIPT_DIR")"
+echo "   npm run build-local"
+echo ""
+echo "2. 复制构建产物到服务器目录："
+echo "   cp release/*.dmg scripts/update-test/server/"
+echo "   cp release/*.zip scripts/update-test/server/"
+echo ""
+echo "3. 更新 manifest 文件（可选）："
+echo "   cd scripts/update-test"
+echo "   ./generate-manifest.sh"
+echo ""
+echo "4. 启动本地服务器："
+echo "   ./start-server.sh"
+echo ""
+echo "5. 配置应用使用本地服务器："
+echo "   cp dev-app-update.local.yml ../../dev-app-update.yml"
+echo ""
+echo "6. 运行应用："
+echo "   cd ../.."
+echo "   npm run dev"
+echo ""

package/apps/desktop/scripts/update-test/start-server.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+
+# ============================================
+# 启动本地更新服务器
+# ============================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_DIR="$SCRIPT_DIR/server"
+PID_FILE="$SCRIPT_DIR/.server.pid"
+LOG_FILE="$SCRIPT_DIR/.server.log"
+PORT="${PORT:-8787}"
+
+# 检查服务器目录
+if [ ! -d "$SERVER_DIR" ]; then
+    echo "❌ 服务器目录不存在，请先运行 ./setup.sh"
+    exit 1
+fi
+
+# 检查是否已经在运行
+if [ -f "$PID_FILE" ]; then
+    OLD_PID=$(cat "$PID_FILE")
+    if ps -p "$OLD_PID" > /dev/null 2>&1; then
+        echo "⚠️  服务器已经在运行 (PID: $OLD_PID)"
+        echo "   地址: http://localhost:$PORT"
+        echo ""
+        echo "   如需重启，请先运行 ./stop-server.sh"
+        exit 0
+    else
+        rm -f "$PID_FILE"
+    fi
+fi
+
+echo "🚀 启动本地更新服务器..."
+echo "   目录: $SERVER_DIR"
+echo "   端口: $PORT"
+echo ""
+
+# 列出服务器目录中的文件
+echo "📦 可用文件:"
+ls -la "$SERVER_DIR" | grep -v "^d" | grep -v "^total" | awk '{print "   " $NF}'
+echo ""
+
+# 启动服务器 (后台运行)
+cd "$SERVER_DIR"
+nohup npx serve -p "$PORT" --cors -n > "$LOG_FILE" 2>&1 &
+SERVER_PID=$!
+echo "$SERVER_PID" > "$PID_FILE"
+
+# 等待服务器启动
+sleep 2
+
+# 检查是否启动成功
+if ps -p "$SERVER_PID" > /dev/null 2>&1; then
+    echo "✅ 服务器已启动!"
+    echo ""
+    echo "   地址: http://localhost:$PORT"
+    echo "   PID:  $SERVER_PID"
+    echo "   日志: $LOG_FILE"
+    echo ""
+    echo "📋 测试 URL:"
+    echo "   latest-mac.yml: http://localhost:$PORT/latest-mac.yml"
+    echo "   latest.yml:     http://localhost:$PORT/latest.yml"
+    echo ""
+    echo "🛑 停止服务器: ./stop-server.sh"
+else
+    echo "❌ 服务器启动失败"
+    echo "   查看日志: cat $LOG_FILE"
+    rm -f "$PID_FILE"
+    exit 1
+fi

package/apps/desktop/scripts/update-test/stop-server.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# ============================================
+# 停止本地更新服务器
+# ============================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PID_FILE="$SCRIPT_DIR/.server.pid"
+LOG_FILE="$SCRIPT_DIR/.server.log"
+
+if [ ! -f "$PID_FILE" ]; then
+    echo "ℹ️  服务器未运行 (找不到 PID 文件)"
+    exit 0
+fi
+
+PID=$(cat "$PID_FILE")
+
+if ps -p "$PID" > /dev/null 2>&1; then
+    echo "🛑 停止服务器 (PID: $PID)..."
+    kill "$PID"
+    sleep 1
+    
+    # 强制终止（如果还在运行）
+    if ps -p "$PID" > /dev/null 2>&1; then
+        kill -9 "$PID" 2>/dev/null
+    fi
+    
+    echo "✅ 服务器已停止"
+else
+    echo "ℹ️  服务器进程已不存在"
+fi
+
+rm -f "$PID_FILE"

package/apps/desktop/src/main/core/infrastructure/UpdaterManager.ts

@@ -2,11 +2,21 @@ import log from 'electron-log';
 import { autoUpdater } from 'electron-updater';
 
 import { isDev, isWindows } from '@/const/env';
-import { UPDATE_CHANNEL as channel, updaterConfig } from '@/modules/updater/configs';
+import { getDesktopEnv } from '@/env';
+import {
+  UPDATE_SERVER_URL,
+  UPDATE_CHANNEL as channel,
+  githubConfig,
+  isStableChannel,
+  updaterConfig,
+} from '@/modules/updater/configs';
 import { createLogger } from '@/utils/logger';
 
 import type { App as AppCore } from '../App';
 
+// Allow forcing dev update config via env (for testing updates in packaged app)
+const FORCE_DEV_UPDATE_CONFIG = getDesktopEnv().FORCE_DEV_UPDATE_CONFIG;
+
 // Create logger
 const logger = createLogger('core:UpdaterManager');
 
@@ -16,6 +26,7 @@ export class UpdaterManager {
   private downloading: boolean = false;
   private updateAvailable: boolean = false;
   private isManualCheck: boolean = false;
+  private usingFallbackProvider: boolean = false;
 
   constructor(app: AppCore) {
     this.app = app;
@@ -42,16 +53,26 @@ export class UpdaterManager {
     // Configure autoUpdater
     autoUpdater.autoDownload = false; // Set to false, we'll control downloads manually
     autoUpdater.autoInstallOnAppQuit = false;
-
-    autoUpdater.channel = channel;
-    autoUpdater.allowPrerelease = channel !== 'stable';
     autoUpdater.allowDowngrade = false;
 
-    // Enable test mode in development environment
-    if (isDev) {
-      logger.info(`Running in dev mode, forcing update check, channel: ${autoUpdater.channel}`);
-      // Allow testing updates in development environment
+    // Enable test mode in development environment or when forced via env
+    // IMPORTANT: This must be set BEFORE channel configuration so that
+    // dev-app-update.yml takes precedence over programmatic configuration
+    const useDevConfig = isDev || FORCE_DEV_UPDATE_CONFIG;
+    if (useDevConfig) {
+      // In dev mode, use dev-app-update.yml for all configuration including channel
+      // Don't set channel here - let dev-app-update.yml control it (defaults to "latest")
       autoUpdater.forceDevUpdateConfig = true;
+      logger.info(
+        `Using dev update config (isDev=${isDev}, FORCE_DEV_UPDATE_CONFIG=${FORCE_DEV_UPDATE_CONFIG})`,
+      );
+      logger.info('Dev mode: Using dev-app-update.yml for update configuration');
+    } else {
+      // Only configure channel and update provider programmatically in production
+      // Note: channel is configured in configureUpdateProvider based on provider type
+      autoUpdater.allowPrerelease = channel !== 'stable';
+      logger.info(`Production mode: channel=${channel}, allowPrerelease=${channel !== 'stable'}`);
+      this.configureUpdateProvider();
     }
 
     // Register events
@@ -291,6 +312,79 @@ export class UpdaterManager {
     }, 300);
   };
 
+  /**
+   * Configure update provider based on channel
+   * - Stable channel + UPDATE_SERVER_URL: Use generic HTTP provider (S3) as primary, channel=stable
+   * - Other channels (beta/nightly) or no S3: Use GitHub provider, channel=latest
+   *
+   * Important: S3 has stable-mac.yml, GitHub has latest-mac.yml
+   */
+  private configureUpdateProvider() {
+    if (isStableChannel && UPDATE_SERVER_URL && !this.usingFallbackProvider) {
+      // Stable channel uses custom update server (generic HTTP) as primary
+      // S3 has stable-mac.yml, so we set channel to 'stable'
+      autoUpdater.channel = 'stable';
+      logger.info(`Configuring generic provider for stable channel (primary)`);
+      logger.info(`Update server URL: ${UPDATE_SERVER_URL}`);
+      logger.info(`Channel set to: stable (will look for stable-mac.yml)`);
+
+      autoUpdater.setFeedURL({
+        provider: 'generic',
+        url: UPDATE_SERVER_URL,
+      });
+    } else {
+      // Beta/nightly channels use GitHub, or fallback to GitHub if UPDATE_SERVER_URL not configured
+      // GitHub releases have latest-mac.yml, so we use default channel (latest)
+      autoUpdater.channel = 'latest';
+      const reason = this.usingFallbackProvider ? '(fallback from S3)' : '';
+      logger.info(`Configuring GitHub provider for ${channel} channel ${reason}`);
+      logger.info(`Channel set to: latest (will look for latest-mac.yml)`);
+
+      autoUpdater.setFeedURL({
+        owner: githubConfig.owner,
+        provider: 'github',
+        repo: githubConfig.repo,
+      });
+
+      logger.info(`GitHub update URL configured: ${githubConfig.owner}/${githubConfig.repo}`);
+    }
+  }
+
+  /**
+   * Switch to fallback provider (GitHub) and retry update check
+   * Called when primary provider (S3) fails
+   */
+  private switchToFallbackAndRetry = async () => {
+    // Only fallback if we're on stable channel with S3 configured and haven't already fallen back
+    if (!isStableChannel || !UPDATE_SERVER_URL || this.usingFallbackProvider) {
+      return false;
+    }
+
+    logger.info('Primary update server (S3) failed, switching to GitHub fallback...');
+    this.usingFallbackProvider = true;
+    this.configureUpdateProvider();
+
+    // Retry update check with fallback provider
+    try {
+      await autoUpdater.checkForUpdates();
+      return true;
+    } catch (error) {
+      logger.error('Fallback provider (GitHub) also failed:', error);
+      return false;
+    }
+  };
+
+  /**
+   * Reset to primary provider for next update check
+   */
+  private resetToPrimaryProvider = () => {
+    if (this.usingFallbackProvider) {
+      logger.info('Resetting to primary update provider (S3)');
+      this.usingFallbackProvider = false;
+      this.configureUpdateProvider();
+    }
+  };
+
   private registerEvents() {
     logger.debug('Registering updater events');
 
@@ -302,6 +396,9 @@ export class UpdaterManager {
       logger.info(`Update available: ${info.version}`);
       this.updateAvailable = true;
 
+      // Reset to primary provider for next check cycle
+      this.resetToPrimaryProvider();
+
       if (this.isManualCheck) {
         this.mainWindow.broadcast('manualUpdateAvailable', info);
       } else {
@@ -313,13 +410,27 @@ export class UpdaterManager {
 
     autoUpdater.on('update-not-available', (info) => {
       logger.info(`Update not available. Current: ${info.version}`);
+
+      // Reset to primary provider for next check cycle
+      this.resetToPrimaryProvider();
+
       if (this.isManualCheck) {
         this.mainWindow.broadcast('manualUpdateNotAvailable', info);
       }
     });
 
-    autoUpdater.on('error', (err) => {
+    autoUpdater.on('error', async (err) => {
       logger.error('Error in auto-updater:', err);
+
+      // Try fallback to GitHub if S3 failed
+      if (!this.usingFallbackProvider && isStableChannel && UPDATE_SERVER_URL) {
+        logger.info('Attempting fallback to GitHub provider...');
+        const fallbackSucceeded = await this.switchToFallbackAndRetry();
+        if (fallbackSucceeded) {
+          return; // Fallback initiated, don't report error yet
+        }
+      }
+
       if (this.isManualCheck) {
         this.mainWindow.broadcast('updateError', err.message);
       }

package/apps/desktop/src/main/core/infrastructure/__tests__/UpdaterManager.test.ts

@@ -36,6 +36,7 @@ vi.mock('electron-updater', () => ({
     logger: null as any,
     on: vi.fn(),
     quitAndInstall: vi.fn(),
+    setFeedURL: vi.fn(),
   },
 }));
 
@@ -62,6 +63,12 @@ vi.mock('@/utils/logger', () => ({
 // Mock updater configs
 vi.mock('@/modules/updater/configs', () => ({
   UPDATE_CHANNEL: 'stable',
+  UPDATE_SERVER_URL: 'https://mock.update.server',
+  githubConfig: {
+    owner: 'lobehub',
+    repo: 'lobe-chat',
+  },
+  isStableChannel: true,
   updaterConfig: {
     app: {
       autoCheckUpdate: false,
@@ -73,6 +80,13 @@ vi.mock('@/modules/updater/configs', () => ({
   },
 }));
 
+// Mock env
+vi.mock('@/env', () => ({
+  getDesktopEnv: () => ({
+    FORCE_DEV_UPDATE_CONFIG: false,
+  }),
+}));
+
 // Mock isDev
 vi.mock('@/const/env', () => ({
   isDev: false,
@@ -454,9 +468,11 @@ describe('UpdaterManager', () => {
         vi.mocked(autoUpdater.checkForUpdates).mockResolvedValue({} as any);
         await updaterManager.checkForUpdates({ manual: true });
 
+        vi.mocked(autoUpdater.checkForUpdates).mockRejectedValueOnce(new Error('Fallback failed'));
+
         const error = new Error('Update error');
         const handler = registeredEvents.get('error');
-        handler?.(error);
+        await handler?.(error);
 
         expect(mockBroadcast).toHaveBeenCalledWith('updateError', 'Update error');
       });

package/apps/desktop/src/main/env.ts

@@ -59,29 +59,37 @@ const envNumber = (defaultValue: number) =>
  */
 export const getDesktopEnv = memoize(() =>
   createEnv({
+    client: {},
+    clientPrefix: 'PUBLIC_',
+    emptyStringAsUndefined: true,
+    isServer: true,
+    runtimeEnv: process.env,
     server: {
       DEBUG_VERBOSE: envBoolean(false),
 
-      // keep optional to preserve existing behavior:
-      // - unset NODE_ENV should behave like "not production" in logger runtime paths
-      NODE_ENV: z.enum(['development', 'production', 'test']).optional(),
-
       // escape hatch: allow testing static renderer in dev via env
       DESKTOP_RENDERER_STATIC: envBoolean(false),
 
-      // updater
-      UPDATE_CHANNEL: z.string().optional(),
+      // Force use dev-app-update.yml even in packaged app (for testing updates)
+      FORCE_DEV_UPDATE_CONFIG: envBoolean(false),
 
       // mcp client
       MCP_TOOL_TIMEOUT: envNumber(60_000),
 
+      // keep optional to preserve existing behavior:
+      // - unset NODE_ENV should behave like "not production" in logger runtime paths
+      NODE_ENV: z.enum(['development', 'production', 'test']).optional(),
+
       // cloud server url (can be overridden for selfhost/dev)
       OFFICIAL_CLOUD_SERVER: z.string().optional().default('https://app.lobehub.com'),
+
+      // updater
+      // process.env.xxx will replace in build stage
+      UPDATE_CHANNEL: z.string().optional().default(process.env.UPDATE_CHANNEL),
+
+      // Custom update server URL (for stable channel)
+      // e.g., https://releases.lobehub.com/stable or https://your-bucket.s3.amazonaws.com/releases
+      UPDATE_SERVER_URL: z.string().optional().default(process.env.UPDATE_SERVER_URL),
     },
-    clientPrefix: 'PUBLIC_',
-    client: {},
-    runtimeEnv: process.env,
-    emptyStringAsUndefined: true,
-    isServer: true,
   }),
 );

package/apps/desktop/src/main/modules/updater/configs.ts

@@ -2,7 +2,20 @@ import { isDev } from '@/const/env';
 import { getDesktopEnv } from '@/env';
 
 // 更新频道（stable, beta, alpha 等）
-export const UPDATE_CHANNEL = getDesktopEnv().UPDATE_CHANNEL;
+export const UPDATE_CHANNEL = getDesktopEnv().UPDATE_CHANNEL || 'stable';
+
+// 判断是否为 stable 频道
+export const isStableChannel = UPDATE_CHANNEL === 'stable' || !UPDATE_CHANNEL;
+
+// 自定义更新服务器 URL (用于 stable 频道)
+// e.g., https://releases.lobehub.com/stable
+export const UPDATE_SERVER_URL = getDesktopEnv().UPDATE_SERVER_URL;
+
+// GitHub 配置 (用于 beta/nightly 频道，或作为 fallback)
+export const githubConfig = {
+  owner: 'lobehub',
+  repo: 'lobe-chat',
+};
 
 export const updaterConfig = {
   // 应用更新配置

package/changelog/v1.json

@@ -1,4 +1,18 @@
 [
+  {
+    "children": {},
+    "date": "2026-01-15",
+    "version": "2.0.0-next.293"
+  },
+  {
+    "children": {
+      "improvements": [
+        "Use fallbackData to prevent useActionSWR auto-fetch."
+      ]
+    },
+    "date": "2026-01-15",
+    "version": "2.0.0-next.292"
+  },
   {
     "children": {
       "fixes": [

package/conductor.json

@@ -0,0 +1,5 @@
+{
+  "scripts": {
+    "setup": "bash \"$CONDUCTOR_ROOT_PATH/.conductor/setup.sh\""
+  }
+}

package/locales/en-US/subscription.json

@@ -54,11 +54,11 @@
   "funds.packages.expiresIn": "Expires in {{days}} days",
   "funds.packages.expiresToday": "Expires today",
   "funds.packages.expiringSoon": "Expiring soon",
+  "funds.packages.gift": "Gift",
+  "funds.packages.giftedOn": "Gifted on {{date}}",
   "funds.packages.noPackages": "No credit packages",
   "funds.packages.purchaseFirst": "Purchase your first credit package",
   "funds.packages.purchasedOn": "Purchased on {{date}}",
-  "funds.packages.gift": "Gift",
-  "funds.packages.giftedOn": "Gifted on {{date}}",
   "funds.packages.sort.amountAsc": "Amount: Low to High",
   "funds.packages.sort.amountDesc": "Amount: High to Low",
   "funds.packages.sort.balanceAsc": "Balance: Low to High",

package/locales/zh-CN/subscription.json

@@ -54,11 +54,11 @@
   "funds.packages.expiresIn": "{{days}} 天后过期",
   "funds.packages.expiresToday": "今日过期",
   "funds.packages.expiringSoon": "即将过期",
+  "funds.packages.gift": "赠送",
+  "funds.packages.giftedOn": "赠送于 {{date}}",
   "funds.packages.noPackages": "暂无积分包",
   "funds.packages.purchaseFirst": "购买您的第一个积分包",
   "funds.packages.purchasedOn": "购买于 {{date}}",
-  "funds.packages.gift": "赠送",
-  "funds.packages.giftedOn": "赠送于 {{date}}",
   "funds.packages.sort.amountAsc": "金额：从低到高",
   "funds.packages.sort.amountDesc": "金额：从高到低",
   "funds.packages.sort.balanceAsc": "余额：从低到高",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.291",
+  "version": "2.0.0-next.293",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/builtin-tool-notebook/src/client/Render/CreateDocument/DocumentCard.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { ActionIcon, CopyButton, Flexbox, Markdown, ScrollShadow } from '@lobehub/ui';
+import { ActionIcon, CopyButton, Flexbox, Markdown, ScrollShadow, TooltipGroup } from '@lobehub/ui';
 import { Button } from 'antd';
 import { createStaticStyles } from 'antd-style';
 import { Maximize2, Minimize2, NotebookText, PencilLine } from 'lucide-react';
@@ -85,19 +85,21 @@ const DocumentCard = memo<DocumentCardProps>(({ document }) => {
         <Flexbox flex={1}>
           <div className={styles.title}>{document.title}</div>
         </Flexbox>
-        <Flexbox gap={4} horizontal>
-          <CopyButton
-            content={document.content}
-            size={'small'}
-            title={t('builtins.lobe-notebook.actions.copy')}
-          />
-          <ActionIcon
-            icon={PencilLine}
-            onClick={handleToggle}
-            size={'small'}
-            title={t('builtins.lobe-notebook.actions.edit')}
-          />
-        </Flexbox>
+        <TooltipGroup>
+          <Flexbox gap={4} horizontal>
+            <CopyButton
+              content={document.content}
+              size={'small'}
+              title={t('builtins.lobe-notebook.actions.copy')}
+            />
+            <ActionIcon
+              icon={PencilLine}
+              onClick={handleToggle}
+              size={'small'}
+              title={t('builtins.lobe-notebook.actions.edit')}
+            />
+          </Flexbox>
+        </TooltipGroup>
       </Flexbox>
       {/* Content */}
       <ScrollShadow className={styles.content} offset={12} size={12} style={{ maxHeight: 400 }}>

package/packages/const/src/cacheControl.ts

@@ -1,3 +1,4 @@
 export enum FetchCacheTag {
   Changelog = 'changelog',
+  DesktopRelease = 'desktop-release',
 }

package/packages/electron-client-ipc/src/useWatchBroadcast.ts

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect } from 'react';
+import { useEffect, useLayoutEffect, useRef } from 'react';
 
 import { MainBroadcastEventKey, MainBroadcastParams } from './events';
 
@@ -21,11 +21,17 @@ export const useWatchBroadcast = <T extends MainBroadcastEventKey>(
   event: T,
   handler: (data: MainBroadcastParams<T>) => void,
 ) => {
+  const handlerRef = useRef<typeof handler>(handler);
+
+  useLayoutEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+
   useEffect(() => {
     if (!window.electron) return;
 
-    const listener = (e: any, data: MainBroadcastParams<T>) => {
-      handler(data);
+    const listener = (_e: any, data: MainBroadcastParams<T>) => {
+      handlerRef.current(data);
     };
 
     window.electron.ipcRenderer.on(event, listener);
@@ -33,5 +39,5 @@ export const useWatchBroadcast = <T extends MainBroadcastEventKey>(
     return () => {
       window.electron.ipcRenderer.removeListener(event, listener);
     };
-  }, []);
+  }, [event]);
 };