@lobehub/lobehub 2.0.0-next.303 → 2.0.0-next.305

package/apps/desktop/src/main/controllers/McpInstallCtr.ts

@@ -8,23 +8,23 @@ const logger = createLogger('controllers:McpInstallCtr');
 const protocolHandler = createProtocolHandler('plugin');
 
 /**
- * 验证 MCP Schema 对象结构
+ * Validate MCP Schema object structure
  */
 function validateMcpSchema(schema: any): schema is McpSchema {
   if (!schema || typeof schema !== 'object') return false;
 
-  // 必填字段验证
+  // Required field validation
   if (typeof schema.identifier !== 'string' || !schema.identifier) return false;
   if (typeof schema.name !== 'string' || !schema.name) return false;
   if (typeof schema.author !== 'string' || !schema.author) return false;
   if (typeof schema.description !== 'string' || !schema.description) return false;
   if (typeof schema.version !== 'string' || !schema.version) return false;
 
-  // 可选字段验证
+  // Optional field validation
   if (schema.homepage !== undefined && typeof schema.homepage !== 'string') return false;
   if (schema.icon !== undefined && typeof schema.icon !== 'string') return false;
 
-  // config 字段验证
+  // config field validation
   if (!schema.config || typeof schema.config !== 'object') return false;
   const config = schema.config;
 
@@ -35,13 +35,13 @@ function validateMcpSchema(schema: any): schema is McpSchema {
   } else if (config.type === 'http') {
     if (typeof config.url !== 'string' || !config.url) return false;
     try {
-      new URL(config.url); // 验证URL格式
+      new URL(config.url); // Validate URL format
     } catch {
       return false;
     }
     if (config.headers !== undefined && typeof config.headers !== 'object') return false;
   } else {
-    return false; // 未知的 config type
+    return false; // Unknown config type
   }
 
   return true;
@@ -54,8 +54,8 @@ interface McpInstallParams {
 }
 
 /**
- * MCP 插件安装控制器
- * 负责处理 MCP 插件安装流程
+ * MCP plugin installation controller
+ * Responsible for handling MCP plugin installation process
  */
 export default class McpInstallController extends ControllerModule {
   /**

package/apps/desktop/src/main/controllers/NetworkProxyCtr.ts

@@ -16,13 +16,13 @@ import { ControllerModule, IpcMethod } from './index';
 const logger = createLogger('controllers:NetworkProxyCtr');
 
 /**
- * 网络代理控制器
- * 处理桌面应用的网络代理相关功能
+ * Network proxy controller
+ * Handle desktop application network proxy related functions
  */
 export default class NetworkProxyCtr extends ControllerModule {
   static override readonly groupName = 'networkProxy';
   /**
-   * 获取代理设置
+   * Get proxy settings
    */
   @IpcMethod()
   async getDesktopSettings(): Promise<NetworkProxySettings> {
@@ -43,18 +43,18 @@ export default class NetworkProxyCtr extends ControllerModule {
   }
 
   /**
-   * 设置代理配置
+   * Set proxy configuration
    */
   @IpcMethod()
   async setProxySettings(config: Partial<NetworkProxySettings>): Promise<void> {
     try {
-      // 获取当前配置
+      // Get current configuration
       const currentConfig = this.app.storeManager.get(
         'networkProxy',
         defaultProxySettings,
       ) as NetworkProxySettings;
 
-      // 合并配置并验证
+      // Merge configuration and validate
       const newConfig = merge({}, currentConfig, config);
 
       const validation = ProxyConfigValidator.validate(newConfig);
@@ -69,10 +69,10 @@ export default class NetworkProxyCtr extends ControllerModule {
         return;
       }
 
-      // 应用代理设置
+      // Apply proxy settings
       await ProxyDispatcherManager.applyProxySettings(newConfig);
 
-      // 保存到存储
+      // Save to storage
       this.app.storeManager.set('networkProxy', newConfig);
 
       logger.info('Proxy settings updated successfully', {
@@ -149,7 +149,7 @@ export default class NetworkProxyCtr extends ControllerModule {
         return;
       }
 
-      // 应用代理设置
+      // Apply proxy settings
       await ProxyDispatcherManager.applyProxySettings(networkProxy);
 
       logger.info('Initial proxy settings applied successfully', {

package/apps/desktop/src/main/controllers/RemoteServerSyncCtr.ts

@@ -47,7 +47,7 @@ export default class RemoteServerSyncCtr extends ControllerModule {
   }
 
   /**
-   * 处理流式请求的 IPC 调用
+   * Handle IPC calls for streaming requests
    */
   private handleStreamRequest = async (event: IpcMainEvent, args: ProxyTRPCStreamRequestParams) => {
     const { requestId } = args;
@@ -79,7 +79,7 @@ export default class RemoteServerSyncCtr extends ControllerModule {
         return;
       }
 
-      // 调用新的流式转发方法
+      // Call new streaming forwarding method
       await this.forwardStreamRequest(event.sender, {
         ...args,
         accessToken: token,
@@ -95,7 +95,7 @@ export default class RemoteServerSyncCtr extends ControllerModule {
   };
 
   /**
-   * 执行实际的流式请求转发
+   * Execute actual streaming request forwarding
    */
   private async forwardStreamRequest(
     sender: WebContents,
@@ -123,14 +123,14 @@ export default class RemoteServerSyncCtr extends ControllerModule {
     const clientReq = requester.request(requestOptions, (clientRes: IncomingMessage) => {
       logger.debug(`${logPrefix} Received response with status ${clientRes.statusCode}`);
 
-      // 添加调试信息
+      // Add debug information
       logger.debug(`${logPrefix} Response details:`, {
         headers: clientRes.headers,
         statusCode: clientRes.statusCode,
         statusMessage: clientRes.statusMessage,
       });
 
-      // 1. 立刻发送响应头和状态码
+      // 1. Immediately send response headers and status code
       const responseData = {
         headers: clientRes.headers || {},
         status: clientRes.statusCode || 500,
@@ -140,21 +140,21 @@ export default class RemoteServerSyncCtr extends ControllerModule {
       logger.debug(`${logPrefix} Sending response data:`, responseData);
       sender.send(`stream:response:${requestId}`, responseData);
 
-      // 2. 监听数据块并转发
+      // 2. Listen for data chunks and forward
       clientRes.on('data', (chunk: Buffer) => {
         if (sender.isDestroyed()) return;
         logger.debug(`${logPrefix} Received data chunk, size: ${chunk.length}. Forwarding...`);
         sender.send(`stream:data:${requestId}`, chunk);
       });
 
-      // 3. 监听结束信号并转发
+      // 3. Listen for end signal and forward
       clientRes.on('end', () => {
         logger.debug(`${logPrefix} Stream ended. Forwarding end signal...`);
         if (sender.isDestroyed()) return;
         sender.send(`stream:end:${requestId}`);
       });
 
-      // 4. 监听响应流错误并转发
+      // 4. Listen for response stream errors and forward
       clientRes.on('error', (error) => {
         logger.error(`${logPrefix} Error reading response stream:`, error);
         if (sender.isDestroyed()) return;

package/apps/desktop/src/main/core/App.ts

@@ -127,7 +127,7 @@ export class App {
     // initialize protocol handlers
     this.protocolManager.initialize();
 
-    // 统一处理 before-quit 事件
+    // Unified handling of before-quit event
     app.on('before-quit', this.handleBeforeQuit);
 
     // Initialize theme mode from store
@@ -224,10 +224,10 @@ export class App {
 
   /**
    * Handle protocol request by dispatching to registered handlers
-   * @param urlType 协议URL类型 (如: 'plugin')
-   * @param action 操作类型 (如: 'install')
-   * @param data 解析后的协议数据
-   * @returns 是否成功处理
+   * @param urlType Protocol URL type (e.g., 'plugin')
+   * @param action Action type (e.g., 'install')
+   * @param data Parsed protocol data
+   * @returns Whether successfully handled
    */
   async handleProtocolRequest(urlType: string, action: string, data: any): Promise<boolean> {
     const key = `${urlType}:${action}`;
@@ -241,7 +241,7 @@ export class App {
     try {
       logger.debug(`Dispatching protocol request ${key} to controller`);
       const result = await handler.controller[handler.methodName](data);
-      return result !== false; // 假设控制器返回 false 表示处理失败
+      return result !== false; // Assume controller returning false indicates handling failure
     } catch (error) {
       logger.error(`Error handling protocol request ${key}:`, error);
       return false;
@@ -385,17 +385,17 @@ export class App {
     this.ipcServer = new ElectronIPCServer(name, ipcServerEvents);
   }
 
-  // 新增 before-quit 处理函数
+  // Add before-quit handler function
   private handleBeforeQuit = () => {
     logger.info('Application is preparing to quit');
     this.isQuiting = true;
 
-    // 销毁托盘
+    // Destroy tray
     if (process.platform === 'win32') {
       this.trayManager.destroyAll();
     }
 
-    // 执行清理操作
+    // Execute cleanup operations
     this.staticFileServerManager.destroy();
   };
 }

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

@@ -163,13 +163,14 @@ export class BackendProxyProtocolManager {
         responseHeaders.set('Access-Control-Allow-Headers', '*');
         responseHeaders.set('X-Src-Url', rewrittenUrl);
 
-        // Handle 401 Unauthorized: notify authorization required regardless of token presence
-        // This covers cases where:
-        // 1. No token exists
-        // 2. Token has expired
-        // 3. Token has been revoked server-side
+        // Handle 401 Unauthorized: only notify authorization required for real auth failures
+        // The server sets X-Auth-Required header for real authentication failures (e.g., token expired)
+        // Other 401 errors (e.g., invalid API keys) should not trigger re-authentication
         if (upstreamResponse.status === 401) {
-          this.notifyAuthorizationRequired();
+          const authRequired = upstreamResponse.headers.get('X-Auth-Required') === 'true';
+          if (authRequired) {
+            this.notifyAuthorizationRequired();
+          }
         }
 
         return new Response(upstreamResponse.body, {

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

@@ -160,7 +160,7 @@ export class StaticFileServerManager {
       logger.debug(`Request method: ${req.method}`);
       logger.debug(`Request headers: ${JSON.stringify(req.headers)}`);
 
-      // 提取文件路径：从 /desktop-file/path/to/file.png 中提取相对路径
+      // 提取File path：从 /desktop-file/path/to/file.png 中提取相对路径
       let filePath = decodeURIComponent(url.pathname.slice(1)); // 移除开头的 /
       logger.debug(`Initial file path after decode: ${filePath}`);
 
@@ -243,7 +243,7 @@ export class StaticFileServerManager {
   }
 
   /**
-   * 获取文件服务器域名
+   * Get file server domain
    */
   getFileServerDomain(): string {
     if (!this.isInitialized || !this.serverPort) {

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

@@ -113,6 +113,26 @@ export class UpdaterManager {
 
     logger.info(`${manual ? 'Manually checking' : 'Auto checking'} for updates...`);
 
+    // Log detailed updater configuration for debugging
+    const inferredChannel =
+      autoUpdater.channel ||
+      (autoUpdater.currentVersion?.prerelease?.[0]
+        ? String(autoUpdater.currentVersion.prerelease[0])
+        : null);
+
+    logger.info('[Updater Config] Channel:', autoUpdater.channel);
+    logger.info('[Updater Config] inferredChannel:', inferredChannel);
+    logger.info('[Updater Config] allowPrerelease:', autoUpdater.allowPrerelease);
+    logger.info('[Updater Config] currentVersion:', autoUpdater.currentVersion?.version);
+    logger.info('[Updater Config] allowDowngrade:', autoUpdater.allowDowngrade);
+    logger.info('[Updater Config] autoDownload:', autoUpdater.autoDownload);
+    logger.info('[Updater Config] forceDevUpdateConfig:', autoUpdater.forceDevUpdateConfig);
+    logger.info('[Updater Config] Build channel from config:', channel);
+    logger.info('[Updater Config] isStableChannel:', isStableChannel);
+    logger.info('[Updater Config] UPDATE_SERVER_URL:', UPDATE_SERVER_URL || '(not set)');
+    logger.info('[Updater Config] usingFallbackProvider:', this.usingFallbackProvider);
+    logger.info('[Updater Config] GitHub config:', JSON.stringify(githubConfig));
+
     // If manual check, notify renderer process about check start
     if (manual) {
       this.mainWindow.broadcast('manualUpdateCheckStart');
@@ -322,7 +342,7 @@ export class UpdaterManager {
   /**
    * 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
+   * - Other channels (beta/nightly) or no S3: Use GitHub provider, channel unset (defaults to latest)
    *
    * Important: S3 has stable-mac.yml, GitHub has latest-mac.yml
    */
@@ -340,12 +360,15 @@ export class UpdaterManager {
         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';
+      // GitHub provider:
+      // - stable: use default latest-mac.yml (GitHub uploads latest* only)
+      // - beta/nightly: leave channel unset so prerelease matching uses tag (e.g. next)
       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)`);
+      if (autoUpdater.channel !== null) {
+        autoUpdater.channel = null;
+      }
+      logger.info('Channel left unset (defaults to latest-mac.yml for GitHub)');
 
       // For beta/nightly channels, we need prerelease versions
       const needPrerelease = channel !== 'stable';
@@ -406,6 +429,8 @@ export class UpdaterManager {
 
     autoUpdater.on('checking-for-update', () => {
       logger.info('[Updater] Checking for update...');
+      logger.info('[Updater] Current channel:', autoUpdater.channel);
+      logger.info('[Updater] Current allowPrerelease:', autoUpdater.allowPrerelease);
     });
 
     autoUpdater.on('update-available', (info) => {
@@ -437,6 +462,14 @@ export class UpdaterManager {
 
     autoUpdater.on('error', async (err) => {
       logger.error('Error in auto-updater:', err);
+      // Log configuration state when error occurs for debugging
+      logger.error('[Updater Error Context] Channel:', autoUpdater.channel);
+      logger.error('[Updater Error Context] allowPrerelease:', autoUpdater.allowPrerelease);
+      logger.error('[Updater Error Context] Build channel from config:', channel);
+      logger.error('[Updater Error Context] isStableChannel:', isStableChannel);
+      logger.error('[Updater Error Context] UPDATE_SERVER_URL:', UPDATE_SERVER_URL || '(not set)');
+      logger.error('[Updater Error Context] usingFallbackProvider:', this.usingFallbackProvider);
+      logger.error('[Updater Error Context] GitHub config:', JSON.stringify(githubConfig));
 
       // Try fallback to GitHub if S3 failed
       if (!this.usingFallbackProvider && isStableChannel && UPDATE_SERVER_URL) {

package/apps/desktop/src/main/core/ui/ShortcutManager.ts

@@ -77,25 +77,25 @@ export class ShortcutManager {
     try {
       logger.debug(`Updating shortcut ${id} to ${accelerator}`);
 
-      // 1. 检查 ID 是否有效
+      // 1. Check if ID is valid
       if (!DEFAULT_SHORTCUTS_CONFIG[id]) {
         logger.error(`Invalid shortcut ID: ${id}`);
         return { errorType: 'INVALID_ID', success: false };
       }
 
-      // 2. 基本格式校验
+      // 2. Basic format validation
       if (!accelerator || typeof accelerator !== 'string' || accelerator.trim() === '') {
         logger.error(`Invalid accelerator format: ${accelerator}`);
         return { errorType: 'INVALID_FORMAT', success: false };
       }
 
-      // 转换前端格式到 Electron 格式
+      // Convert frontend format to Electron format
       const convertedAccelerator = this.convertAcceleratorFormat(accelerator.trim());
       const cleanAccelerator = convertedAccelerator.toLowerCase();
 
       logger.debug(`Converted accelerator from ${accelerator} to ${convertedAccelerator}`);
 
-      // 3. 检查是否包含 + 号（修饰键格式）
+      // 3. Check if contains + sign (modifier key format)
       if (!cleanAccelerator.includes('+')) {
         logger.error(
           `Invalid accelerator format: ${cleanAccelerator}. Must contain modifier keys like 'CommandOrControl+E'`,
@@ -103,7 +103,7 @@ export class ShortcutManager {
         return { errorType: 'INVALID_FORMAT', success: false };
       }
 
-      // 4. 检查是否有基本的修饰键
+      // 4. Check if has basic modifier keys
       const hasModifier = ['CommandOrControl', 'Command', 'Ctrl', 'Alt', 'Shift'].some((modifier) =>
         cleanAccelerator.includes(modifier.toLowerCase()),
       );
@@ -113,7 +113,7 @@ export class ShortcutManager {
         return { errorType: 'NO_MODIFIER', success: false };
       }
 
-      // 5. 检查冲突
+      // 5. Check for conflicts
       for (const [existingId, existingAccelerator] of Object.entries(this.shortcutsConfig)) {
         if (
           existingId !== id &&
@@ -125,7 +125,7 @@ export class ShortcutManager {
         }
       }
 
-      // 6. 尝试注册测试（检查是否被系统占用）
+      // 6. Try test registration (check if occupied by system)
       const testSuccess = globalShortcut.register(convertedAccelerator, () => {});
       if (!testSuccess) {
         logger.error(
@@ -133,11 +133,11 @@ export class ShortcutManager {
         );
         return { errorType: 'SYSTEM_OCCUPIED', success: false };
       } else {
-        // 测试成功，立即取消注册
+        // Test successful, immediately unregister
         globalShortcut.unregister(convertedAccelerator);
       }
 
-      // 7. 更新配置
+      // 7. Update configuration
       this.shortcutsConfig[id] = convertedAccelerator;
 
       this.saveShortcutsConfig();
@@ -285,7 +285,7 @@ export class ShortcutManager {
     Object.entries(this.shortcutsConfig).forEach(([id, accelerator]) => {
       logger.debug(`Registering shortcut '${id}' with ${accelerator}`);
 
-      // 只注册在 DEFAULT_SHORTCUTS_CONFIG 中存在的快捷键
+      // Only register shortcuts that exist in DEFAULT_SHORTCUTS_CONFIG
       if (!DEFAULT_SHORTCUTS_CONFIG[id]) {
         logger.debug(`Skipping shortcut '${id}' - not found in DEFAULT_SHORTCUTS_CONFIG`);
         return;

package/apps/desktop/src/main/core/ui/TrayManager.ts

@@ -8,11 +8,11 @@ import { createLogger } from '@/utils/logger';
 import type { App } from '../App';
 import { Tray, TrayOptions } from './Tray';
 
-// 创建日志记录器
+// Create logger
 const logger = createLogger('core:TrayManager');
 
 /**
- * 托盘标识符类型
+ * Tray identifier type
  */
 export type TrayIdentifiers = 'main';
 
@@ -20,41 +20,41 @@ export class TrayManager {
   app: App;
 
   /**
-   * 存储所有托盘实例
+   * Store all tray instances
    */
   trays: Map<TrayIdentifiers, Tray> = new Map();
 
   /**
-   * 构造方法
-   * @param app 应用实例
+   * Constructor
+   * @param app Application instance
    */
   constructor(app: App) {
-    logger.debug('初始化 TrayManager');
+    logger.debug('Initialize TrayManager');
     this.app = app;
   }
 
   /**
-   * 初始化所有托盘
+   * Initialize all trays
    */
   initializeTrays() {
-    logger.debug('初始化应用托盘');
+    logger.debug('Initialize application tray');
 
-    // 初始化主托盘
+    // Initialize main tray
     this.initializeMainTray();
   }
 
   /**
-   * 获取主托盘
+   * Get main tray
    */
   getMainTray() {
     return this.retrieveByIdentifier('main');
   }
 
   /**
-   * 初始化主托盘
+   * Initialize main tray
    */
   initializeMainTray() {
-    logger.debug('初始化主托盘');
+    logger.debug('Initialize main tray');
     return this.retrieveOrInitialize({
       iconPath: isMac
         ? nativeTheme.shouldUseDarkColorsForSystemIntegratedUI

package/apps/desktop/src/main/locales/resources.ts

@@ -1,12 +1,12 @@
 /**
- * 规范化语言代码
+ * Normalize language code
  */
 export const normalizeLocale = (locale: string) => {
   return locale.toLowerCase().replace('_', '-');
 };
 
 /**
- * 按需加载翻译资源
+ * Load translation resources on demand
  */
 export const loadResources = async (lng: string, ns: string) => {
   // All en-* locales fallback to 'en' and use default TypeScript files
@@ -16,7 +16,7 @@ export const loadResources = async (lng: string, ns: string) => {
 
       return content;
     } catch (error) {
-      console.error(`[I18n] 无法加载翻译文件: ${ns}`, error);
+      console.error(`[I18n] Unable to load translation file: ${ns}`, error);
       return {};
     }
   }
@@ -26,7 +26,7 @@ export const loadResources = async (lng: string, ns: string) => {
 
     return content;
   } catch (error) {
-    console.error(`无法加载翻译文件: ${lng} - ${ns}`, error);
+    console.error(`Unable to load translation file: ${lng} - ${ns}`, error);
     return {};
   }
 };

package/apps/desktop/src/main/menus/impls/macOS.ts

@@ -47,7 +47,7 @@ export class MacOSMenu extends BaseMenuPlatform implements IMenuPlatform {
   }
 
   refresh(options?: MenuOptions): void {
-    // 重建应用菜单
+    // 重建Application menu
     this.buildAndSetAppMenu(options);
     // 如果托盘菜单存在，也重建它（如果需要动态更新）
     // this.trayMenu = this.buildTrayMenu();

package/apps/desktop/src/main/menus/types.ts

@@ -2,27 +2,27 @@ import { Menu } from 'electron';
 
 export interface MenuOptions {
   showDevItems?: boolean;
-  // 其他可能的配置项
+  // Other possible configuration items
 }
 
 export interface IMenuPlatform {
   /**
-   * 构建并设置应用菜单
+   * Build and set application menu
    */
   buildAndSetAppMenu(options?: MenuOptions): Menu;
 
   /**
-   * 构建上下文菜单
+   * Build context menu
    */
   buildContextMenu(type: string, data?: any): Menu;
 
   /**
-   * 构建托盘菜单
+   * Build tray menu
    */
   buildTrayMenu(): Menu;
 
   /**
-   * 刷新菜单
+   * Refresh menu
    */
   refresh(options?: MenuOptions): void;
 }

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

@@ -1,34 +1,34 @@
 import { isDev } from '@/const/env';
 import { getDesktopEnv } from '@/env';
 
-// 更新频道（stable, beta, alpha 等）
+// Update channel (stable, beta, alpha, etc.)
 export const UPDATE_CHANNEL = getDesktopEnv().UPDATE_CHANNEL || 'stable';
 
-// 判断是否为 stable 频道
+// Determine if stable channel
 export const isStableChannel = UPDATE_CHANNEL === 'stable' || !UPDATE_CHANNEL;
 
-// 自定义更新服务器 URL (用于 stable 频道)
+// Custom update server URL (for stable channel)
 // e.g., https://releases.lobehub.com/stable
 export const UPDATE_SERVER_URL = getDesktopEnv().UPDATE_SERVER_URL;
 
-// GitHub 配置 (用于 beta/nightly 频道，或作为 fallback)
+// GitHub configuration (for beta/nightly channels, or as fallback)
 export const githubConfig = {
   owner: 'lobehub',
   repo: 'lobe-chat',
 };
 
 export const updaterConfig = {
-  // 应用更新配置
+  // 应用Update configuration
   app: {
-    // 是否自动检查更新
+    // Whether to auto-check for updates
     autoCheckUpdate: true,
-    // 是否自动下载更新
+    // Whether to auto-download updates
     autoDownloadUpdate: true,
-    // 检查更新的时间间隔（毫秒）
-    checkUpdateInterval: 60 * 60 * 1000, // 1小时
+    // Update check interval (milliseconds)
+    checkUpdateInterval: 60 * 60 * 1000, // 1 hour
   },
 
-  // 是否启用应用更新
+  // Whether to enable application updates
   enableAppUpdate: !isDev,
 
   // 是否启用渲染层热更新