@lobehub/lobehub 2.0.0-next.302 → 2.0.0-next.304

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 2.0.0-next.304](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.303...v2.0.0-next.304)
+
+<sup>Released on **2026-01-18**</sup>
+
+#### 💄 Styles
+
+- **misc**: Improve auto scroll and loading hint.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Styles
+
+- **misc**: Improve auto scroll and loading hint, closes [#11579](https://github.com/lobehub/lobe-chat/issues/11579) ([277b42d](https://github.com/lobehub/lobe-chat/commit/277b42d))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.303](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.302...v2.0.0-next.303)
+
+<sup>Released on **2026-01-18**</sup>
+
+#### 💄 Styles
+
+- **misc**: Improve operation hint and fix scroll issue.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Styles
+
+- **misc**: Improve operation hint and fix scroll issue, closes [#11573](https://github.com/lobehub/lobe-chat/issues/11573) ([8505d14](https://github.com/lobehub/lobe-chat/commit/8505d14))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.302](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.301...v2.0.0-next.302)
 
 <sup>Released on **2026-01-17**</sup>

package/apps/desktop/src/common/routes.ts

@@ -1,36 +1,36 @@
 /**
- * 路由拦截类型，描述拦截路由和目标窗口的映射关系
+ * Route interception type, describing the mapping between intercepted routes and target windows
  */
 export interface RouteInterceptConfig {
   /**
-   * 是否始终在新窗口中打开，即使目标窗口已经存在
+   * Whether to always open in a new window, even if target window already exists
    */
   alwaysOpenNew?: boolean;
 
   /**
-   * 描述
+   * Description
    */
   description: string;
 
   /**
-   * 是否启用拦截
+   * Whether interception is enabled
    */
   enabled: boolean;
 
   /**
-   * 路由模式前缀，例如 '/settings'
+   * Route pattern prefix, e.g., '/settings'
    */
   pathPrefix: string;
 
   /**
-   * 目标窗口标识符
+   * Target window identifier
    */
   targetWindow: string;
 }
 
 /**
- * 拦截路由配置列表
- * 定义了所有需要特殊处理的路由
+ * Intercepted route configuration list
+ * Defines all routes that require special handling
  */
 export const interceptRoutes: RouteInterceptConfig[] = [
   {

package/apps/desktop/src/main/const/dir.ts

@@ -25,9 +25,9 @@ export const appStorageDir = join(userDataDir, 'lobehub-storage');
 
 // ------  Application storage directory ---- //
 
-// 本地存储文件（模拟 S3）
+// Local storage files (simulating S3)
 export const FILE_STORAGE_DIR = 'file-storage';
-// Plugin 安装目录
+// Plugin installation directory
 export const INSTALL_PLUGINS_DIR = 'plugins';
 
 // Desktop file service

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

@@ -13,18 +13,18 @@ export const isLinux = linux();
 
 function getIsWindows11() {
   if (!isWindows) return false;
-  // 获取操作系统版本（如 "10.0.22621"）
+  // Get OS version (e.g., "10.0.22621")
   const release = os.release();
   const parts = release.split('.');
 
-  // 主版本和次版本
+  // Major and minor version
   const majorVersion = parseInt(parts[0], 10);
   const minorVersion = parseInt(parts[1], 10);
 
-  // 构建号是第三部分
+  // Build number is the third part
   const buildNumber = parseInt(parts[2], 10);
 
-  // Windows 11 的构建号从 22000 开始
+  // Windows 11 build numbers start from 22000
   return majorVersion === 10 && minorVersion === 0 && buildNumber >= 22_000;
 }
 

package/apps/desktop/src/main/const/store.ts

@@ -1,5 +1,5 @@
 /**
- * 应用设置存储相关常量
+ * Application settings storage related constants
  */
 import { NetworkProxySettings } from '@lobechat/electron-client-ipc';
 
@@ -8,7 +8,7 @@ import { DEFAULT_SHORTCUTS_CONFIG } from '@/shortcuts';
 import { ElectronMainStore } from '@/types/store';
 
 /**
- * 存储名称
+ * Storage name
  */
 export const STORE_NAME = 'lobehub-settings';
 
@@ -22,7 +22,7 @@ export const defaultProxySettings: NetworkProxySettings = {
 };
 
 /**
- * 存储默认值
+ * Storage default values
  */
 export const STORE_DEFAULTS: ElectronMainStore = {
   dataSyncConfig: { storageMode: 'cloud' },

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

@@ -143,7 +143,7 @@ export default class AuthCtr extends ControllerModule {
   }
 
   /**
-   * 启动轮询机制获取凭证
+   * Start polling mechanism to get credentials
    */
   private startPolling() {
     if (!this.authRequestState) {

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/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/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;
 }