@lobehub/lobehub 2.0.0-next.109 → 2.0.0-next.110

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 # Changelog
 
+## [Version 2.0.0-next.110](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.109...v2.0.0-next.110)
+
+<sup>Released on **2025-11-24**</sup>
+
+#### 💄 Styles
+
+- **misc**: Add hyperlink to each topic & pinned agent, support ContextMenu on ChatItem.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Styles
+
+- **misc**: Add hyperlink to each topic & pinned agent, closes [#10367](https://github.com/lobehub/lobe-chat/issues/10367) ([63e4b3d](https://github.com/lobehub/lobe-chat/commit/63e4b3d))
+- **misc**: Support ContextMenu on ChatItem, closes [#9034](https://github.com/lobehub/lobe-chat/issues/9034) ([27c1154](https://github.com/lobehub/lobe-chat/commit/27c1154))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.109](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.108...v2.0.0-next.109)
 
 <sup>Released on **2025-11-24**</sup>

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

@@ -33,12 +33,6 @@ export interface RouteInterceptConfig {
  * 定义了所有需要特殊处理的路由
  */
 export const interceptRoutes: RouteInterceptConfig[] = [
-  {
-    description: '设置页面',
-    enabled: true,
-    pathPrefix: '/settings',
-    targetWindow: 'settings',
-  },
   {
     description: '开发者工具',
     enabled: true,

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

@@ -3,7 +3,6 @@ import type { BrowserWindowOpts } from './core/browser/Browser';
 export const BrowsersIdentifiers = {
   chat: 'chat',
   devtools: 'devtools',
-  settings: 'settings',
 };
 
 export const appBrowsers = {
@@ -32,18 +31,6 @@ export const appBrowsers = {
     vibrancy: 'under-window',
     width: 1000,
   },
-  settings: {
-    autoHideMenuBar: true,
-    height: 800,
-    identifier: 'settings',
-    keepAlive: true,
-    minWidth: 600,
-    parentIdentifier: 'chat',
-    path: '/settings',
-    titleBarStyle: 'hidden',
-    vibrancy: 'under-window',
-    width: 1000,
-  },
 } satisfies Record<string, BrowserWindowOpts>;
 
 // Window templates for multi-instance windows

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

@@ -1,9 +1,8 @@
 import { InterceptRouteParams, OpenSettingsWindowOptions } from '@lobechat/electron-client-ipc';
-import { extractSubPath, findMatchingRoute } from '~common/routes';
+import { findMatchingRoute } from '~common/routes';
 
 import {
   AppBrowsersIdentifiers,
-  BrowsersIdentifiers,
   WindowTemplateIdentifiers,
 } from '@/appBrowsers';
 import { IpcClientEventSender } from '@/types/ipcClientEvent';
@@ -24,14 +23,32 @@ export default class BrowserWindowsCtr extends ControllerModule {
         ? { tab: typeof options === 'string' ? options : undefined }
         : options;
 
-    console.log('[BrowserWindowsCtr] Received request to open settings window', normalizedOptions);
+    console.log('[BrowserWindowsCtr] Received request to open settings', normalizedOptions);
 
     try {
-      await this.app.browserManager.showSettingsWindowWithTab(normalizedOptions);
+      const query = new URLSearchParams();
+      if (normalizedOptions.searchParams) {
+        Object.entries(normalizedOptions.searchParams).forEach(([key, value]) => {
+          if (value !== undefined) query.set(key, value);
+        });
+      }
+
+      const tab = normalizedOptions.tab;
+      if (tab && tab !== 'common' && !query.has('active')) {
+        query.set('active', tab);
+      }
+
+      const queryString = query.toString();
+      const subPath = tab && !queryString ? `/${tab}` : '';
+      const fullPath = `/settings${subPath}${queryString ? `?${queryString}` : ''}`;
+
+      const mainWindow = this.app.browserManager.getMainWindow();
+      await mainWindow.loadUrl(fullPath);
+      mainWindow.show();
 
       return { success: true };
     } catch (error) {
-      console.error('[BrowserWindowsCtr] Failed to open settings window:', error);
+      console.error('[BrowserWindowsCtr] Failed to open settings:', error);
       return { error: error.message, success: false };
     }
   }
@@ -76,50 +93,14 @@ export default class BrowserWindowsCtr extends ControllerModule {
     );
 
     try {
-      if (matchedRoute.targetWindow === BrowsersIdentifiers.settings) {
-        const extractedSubPath = extractSubPath(path, matchedRoute.pathPrefix);
-        const sanitizedSubPath =
-          extractedSubPath && !extractedSubPath.startsWith('?') ? extractedSubPath : undefined;
-        let searchParams: Record<string, string> | undefined;
-        try {
-          const url = new URL(params.url);
-          const entries = Array.from(url.searchParams.entries());
-          if (entries.length > 0) {
-            searchParams = entries.reduce<Record<string, string>>((acc, [key, value]) => {
-              acc[key] = value;
-              return acc;
-            }, {});
-          }
-        } catch (error) {
-          console.warn(
-            '[BrowserWindowsCtr] Failed to parse URL for settings route interception:',
-            params.url,
-            error,
-          );
-        }
-
-        await this.app.browserManager.showSettingsWindowWithTab({
-          searchParams,
-          tab: sanitizedSubPath,
-        });
+      await this.openTargetWindow(matchedRoute.targetWindow as AppBrowsersIdentifiers);
 
-        return {
-          intercepted: true,
-          path,
-          source,
-          subPath: sanitizedSubPath,
-          targetWindow: matchedRoute.targetWindow,
-        };
-      } else {
-        await this.openTargetWindow(matchedRoute.targetWindow as AppBrowsersIdentifiers);
-
-        return {
-          intercepted: true,
-          path,
-          source,
-          targetWindow: matchedRoute.targetWindow,
-        };
-      }
+      return {
+        intercepted: true,
+        path,
+        source,
+        targetWindow: matchedRoute.targetWindow,
+      };
     } catch (error) {
       console.error('[BrowserWindowsCtr] Error while processing route interception:', error);
       return {

package/apps/desktop/src/main/controllers/__tests__/BrowserWindowsCtr.test.ts

@@ -9,36 +9,40 @@ import BrowserWindowsCtr from '../BrowserWindowsCtr';
 
 // 模拟 App 及其依赖项
 const mockToggleVisible = vi.fn();
-const mockShowSettingsWindowWithTab = vi.fn();
+const mockLoadUrl = vi.fn();
+const mockShow = vi.fn();
+const mockRedirectToPage = vi.fn();
 const mockCloseWindow = vi.fn();
 const mockMinimizeWindow = vi.fn();
 const mockMaximizeWindow = vi.fn();
 const mockRetrieveByIdentifier = vi.fn();
 const mockGetMainWindow = vi.fn(() => ({
   toggleVisible: mockToggleVisible,
+  loadUrl: mockLoadUrl,
+  show: mockShow,
 }));
-const mockShow = vi.fn();
+const mockShowOther = vi.fn();
 
 // mock findMatchingRoute and extractSubPath
 vi.mock('~common/routes', async () => ({
   findMatchingRoute: vi.fn(),
   extractSubPath: vi.fn(),
 }));
-const { findMatchingRoute, extractSubPath } = await import('~common/routes');
+const { findMatchingRoute } = await import('~common/routes');
 
 const mockApp = {
   browserManager: {
     getMainWindow: mockGetMainWindow,
-    showSettingsWindowWithTab: mockShowSettingsWindowWithTab,
+    redirectToPage: mockRedirectToPage,
     closeWindow: mockCloseWindow,
     minimizeWindow: mockMinimizeWindow,
     maximizeWindow: mockMaximizeWindow,
     retrieveByIdentifier: mockRetrieveByIdentifier.mockImplementation(
       (identifier: AppBrowsersIdentifiers | string) => {
-        if (identifier === BrowsersIdentifiers.settings || identifier === 'some-other-window') {
-          return { show: mockShow };
+        if (identifier === 'some-other-window') {
+          return { show: mockShowOther };
         }
-        return { show: mockShow }; // Default mock for other identifiers
+        return { show: mockShowOther }; // Default mock for other identifiers
       },
     ),
   },
@@ -61,16 +65,18 @@ describe('BrowserWindowsCtr', () => {
   });
 
   describe('openSettingsWindow', () => {
-    it('should show the settings window with the specified tab', async () => {
+    it('should navigate to settings in main window with the specified tab', async () => {
       const tab = 'appearance';
       const result = await browserWindowsCtr.openSettingsWindow(tab);
-      expect(mockShowSettingsWindowWithTab).toHaveBeenCalledWith({ tab });
+      expect(mockGetMainWindow).toHaveBeenCalled();
+      expect(mockLoadUrl).toHaveBeenCalledWith('/settings?active=appearance');
+      expect(mockShow).toHaveBeenCalled();
       expect(result).toEqual({ success: true });
     });
 
-    it('should return error if showing settings window fails', async () => {
-      const errorMessage = 'Failed to show';
-      mockShowSettingsWindowWithTab.mockRejectedValueOnce(new Error(errorMessage));
+    it('should return error if navigation fails', async () => {
+      const errorMessage = 'Failed to navigate';
+      mockLoadUrl.mockRejectedValueOnce(new Error(errorMessage));
       const result = await browserWindowsCtr.openSettingsWindow('display');
       expect(result).toEqual({ error: errorMessage, success: false });
     });
@@ -117,36 +123,7 @@ describe('BrowserWindowsCtr', () => {
       expect(result).toEqual({ intercepted: false, path: params.path, source: params.source });
     });
 
-    it('should show settings window if matched route target is settings', async () => {
-      const params: InterceptRouteParams = {
-        ...baseParams,
-        path: '/settings/provider',
-        url: 'app://host/settings/provider?active=provider&provider=ollama',
-      };
-      const matchedRoute = { targetWindow: BrowsersIdentifiers.settings, pathPrefix: '/settings' };
-      const subPath = 'provider';
-      (findMatchingRoute as Mock).mockReturnValue(matchedRoute);
-      (extractSubPath as Mock).mockReturnValue(subPath);
-
-      const result = await browserWindowsCtr.interceptRoute(params);
-
-      expect(findMatchingRoute).toHaveBeenCalledWith(params.path);
-      expect(extractSubPath).toHaveBeenCalledWith(params.path, matchedRoute.pathPrefix);
-      expect(mockShowSettingsWindowWithTab).toHaveBeenCalledWith({
-        searchParams: { active: 'provider', provider: 'ollama' },
-        tab: subPath,
-      });
-      expect(result).toEqual({
-        intercepted: true,
-        path: params.path,
-        source: params.source,
-        subPath,
-        targetWindow: matchedRoute.targetWindow,
-      });
-      expect(mockShow).not.toHaveBeenCalled();
-    });
-
-    it('should open target window if matched route target is not settings', async () => {
+    it('should open target window if matched route is found', async () => {
       const params: InterceptRouteParams = {
         ...baseParams,
         path: '/other/page',
@@ -160,44 +137,16 @@ describe('BrowserWindowsCtr', () => {
 
       expect(findMatchingRoute).toHaveBeenCalledWith(params.path);
       expect(mockRetrieveByIdentifier).toHaveBeenCalledWith(targetWindowIdentifier);
-      expect(mockShow).toHaveBeenCalled();
+      expect(mockShowOther).toHaveBeenCalled();
       expect(result).toEqual({
         intercepted: true,
         path: params.path,
         source: params.source,
         targetWindow: matchedRoute.targetWindow,
       });
-      expect(mockShowSettingsWindowWithTab).not.toHaveBeenCalled();
-    });
-
-    it('should return error if processing route interception fails for settings', async () => {
-      const params: InterceptRouteParams = {
-        ...baseParams,
-        path: '/settings',
-        url: 'app://host/settings?active=general',
-      };
-      const matchedRoute = { targetWindow: BrowsersIdentifiers.settings, pathPrefix: '/settings' };
-      const subPath = undefined;
-      const errorMessage = 'Processing error for settings';
-      (findMatchingRoute as Mock).mockReturnValue(matchedRoute);
-      (extractSubPath as Mock).mockReturnValue(subPath);
-      mockShowSettingsWindowWithTab.mockRejectedValueOnce(new Error(errorMessage));
-
-      const result = await browserWindowsCtr.interceptRoute(params);
-
-      expect(mockShowSettingsWindowWithTab).toHaveBeenCalledWith({
-        searchParams: { active: 'general' },
-        tab: subPath,
-      });
-      expect(result).toEqual({
-        error: errorMessage,
-        intercepted: false,
-        path: params.path,
-        source: params.source,
-      });
     });
 
-    it('should return error if processing route interception fails for other window', async () => {
+    it('should return error if processing route interception fails', async () => {
       const params: InterceptRouteParams = {
         ...baseParams,
         path: '/another/custom',

package/apps/desktop/src/main/core/browser/Browser.ts

@@ -336,6 +336,7 @@ export default class Browser {
       vibrancy: 'sidebar',
       visualEffectState: 'active',
       webPreferences: {
+        backgroundThrottling: false,
         contextIsolation: true,
         preload: join(preloadDir, 'index.js'),
       },

package/apps/desktop/src/main/core/browser/BrowserManager.ts

@@ -1,8 +1,4 @@
-import {
-  MainBroadcastEventKey,
-  MainBroadcastParams,
-  OpenSettingsWindowOptions,
-} from '@lobechat/electron-client-ipc';
+import { MainBroadcastEventKey, MainBroadcastParams } from '@lobechat/electron-client-ipc';
 import { WebContents } from 'electron';
 
 import { createLogger } from '@/utils/logger';
@@ -42,13 +38,6 @@ export class BrowserManager {
     window.show();
   }
 
-  showSettingsWindow() {
-    logger.debug('Showing settings window');
-    const window = this.retrieveByIdentifier('settings');
-    window.show();
-    return window;
-  }
-
   broadcastToAllWindows = <T extends MainBroadcastEventKey>(
     event: T,
     data: MainBroadcastParams<T>,
@@ -68,50 +57,6 @@ export class BrowserManager {
     this.browsers.get(identifier)?.broadcast(event, data);
   };
 
-  /**
-   * Display the settings window and navigate to a specific tab
-   * @param tab Settings window sub-path tab
-   */
-  async showSettingsWindowWithTab(options?: OpenSettingsWindowOptions) {
-    const tab = options?.tab;
-    const searchParams = options?.searchParams;
-
-    const query = new URLSearchParams();
-    if (searchParams) {
-      Object.entries(searchParams).forEach(([key, value]) => {
-        if (value !== undefined) query.set(key, value);
-      });
-    }
-
-    if (tab && tab !== 'common' && !query.has('active')) {
-      query.set('active', tab);
-    }
-
-    const queryString = query.toString();
-    const activeTab = query.get('active') ?? tab;
-
-    logger.debug(
-      `Showing settings window with navigation: active=${activeTab || 'default'}, query=${
-        queryString || 'none'
-      }`,
-    );
-
-    if (queryString) {
-      const browser = await this.redirectToPage('settings', undefined, queryString);
-
-      // make provider page more large
-      if (activeTab?.startsWith('provider')) {
-        logger.debug('Resizing window for provider settings');
-        browser.setWindowSize({ height: 1000, width: 1400 });
-        browser.moveToCenter();
-      }
-
-      return browser;
-    } else {
-      return this.showSettingsWindow();
-    }
-  }
-
   /**
    * Navigate window to specific sub-path
    * @param identifier Window identifier

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

@@ -81,8 +81,10 @@ export class MacOSMenu extends BaseMenuPlatform implements IMenuPlatform {
           { type: 'separator' },
           {
             accelerator: 'Command+,',
-            click: () => {
-              this.app.browserManager.showSettingsWindow();
+            click: async () => {
+              const mainWindow = this.app.browserManager.getMainWindow();
+              await mainWindow.loadUrl('/settings');
+              mainWindow.show();
             },
             label: t('macOS.preferences'),
           },
@@ -337,7 +339,11 @@ export class MacOSMenu extends BaseMenuPlatform implements IMenuPlatform {
         label: t('tray.show', { appName }),
       },
       {
-        click: () => this.app.browserManager.retrieveByIdentifier('settings').show(),
+        click: async () => {
+          const mainWindow = this.app.browserManager.getMainWindow();
+          await mainWindow.loadUrl('/settings');
+          mainWindow.show();
+        },
         label: t('file.preferences'),
       },
       { type: 'separator' },

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "improvements": [
+        "Add hyperlink to each topic & pinned agent, support ContextMenu on ChatItem."
+      ]
+    },
+    "date": "2025-11-24",
+    "version": "2.0.0-next.110"
+  },
   {
     "children": {
       "fixes": [

package/locales/ar/setting.json

@@ -293,6 +293,12 @@
       "elegant": "أنيق",
       "title": "حركة الاستجابة"
     },
+    "contextMenuMode": {
+      "default": "افتراضي",
+      "desc": "اختر طريقة عرض قائمة النقر بزر الماوس الأيمن لرسائل الدردشة",
+      "disabled": "عدم الاستخدام",
+      "title": "خطة قائمة النقر بزر الماوس الأيمن"
+    },
     "neutralColor": {
       "desc": "تخصيص تدرجات الرمادي ذات الاتجاهات اللونية المختلفة",
       "title": "لون محايد"
@@ -777,4 +783,4 @@
     },
     "title": "أدوات الامتداد"
   }
-}
+}

package/locales/bg-BG/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Елегантно",
       "title": "Анимация на отговор"
     },
+    "contextMenuMode": {
+      "default": "По подразбиране",
+      "desc": "Изберете начина на показване на контекстното меню за чат съобщения",
+      "disabled": "Не използвай",
+      "title": "Схема на контекстното меню"
+    },
     "neutralColor": {
       "desc": "Персонализиране на сивата скала с различни цветови нюанси",
       "title": "Неутрални цветове"
@@ -777,4 +783,4 @@
     },
     "title": "Инструменти за разширение"
   }
-}
+}

package/locales/de-DE/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Elegant",
       "title": "Reaktionsanimation"
     },
+    "contextMenuMode": {
+      "default": "Standard",
+      "desc": "Wählen Sie das Anzeigeformat des Kontextmenüs für Chatnachrichten",
+      "disabled": "Nicht verwenden",
+      "title": "Kontextmenü-Option"
+    },
     "neutralColor": {
       "desc": "Anpassung der Graustufen mit unterschiedlichen Farbneigungen",
       "title": "Neutrale Farben"
@@ -777,4 +783,4 @@
     },
     "title": "Erweiterungswerkzeuge"
   }
-}
+}

package/locales/en-US/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Elegant",
       "title": "Response Animation"
     },
+    "contextMenuMode": {
+      "default": "Default",
+      "desc": "Select the display mode for the chat message right-click menu",
+      "disabled": "Disabled",
+      "title": "Right-Click Menu Mode"
+    },
     "neutralColor": {
       "desc": "Custom grayscale with different color tendencies",
       "title": "Neutral Color"
@@ -777,4 +783,4 @@
     },
     "title": "Extension Tools"
   }
-}
+}

package/locales/es-ES/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Elegante",
       "title": "Animación de respuesta"
     },
+    "contextMenuMode": {
+      "default": "Predeterminado",
+      "desc": "Seleccione el esquema de visualización del menú contextual en los mensajes de chat",
+      "disabled": "No usar",
+      "title": "Esquema del menú contextual"
+    },
     "neutralColor": {
       "desc": "Personalización de escalas de grises con diferentes inclinaciones de color",
       "title": "Color Neutro"
@@ -777,4 +783,4 @@
     },
     "title": "Herramientas de extensión"
   }
-}
+}

package/locales/fa-IR/setting.json

@@ -293,6 +293,12 @@
       "elegant": "ظریف",
       "title": "انیمیشن پاسخ"
     },
+    "contextMenuMode": {
+      "default": "پیش‌فرض",
+      "desc": "انتخاب طرح نمایش منوی کلیک راست پیام‌های چت",
+      "disabled": "استفاده نشود",
+      "title": "طرح منوی کلیک راست"
+    },
     "neutralColor": {
       "desc": "سفارشی‌سازی مقیاس خاکستری با تم‌های رنگی مختلف",
       "title": "رنگ‌های خنثی"
@@ -777,4 +783,4 @@
     },
     "title": "افزونه‌های گسترش"
   }
-}
+}

package/locales/fr-FR/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Élégant",
       "title": "Animation de réponse"
     },
+    "contextMenuMode": {
+      "default": "Par défaut",
+      "desc": "Choisissez le mode d'affichage du menu contextuel des messages de chat",
+      "disabled": "Désactivé",
+      "title": "Mode du menu contextuel"
+    },
     "neutralColor": {
       "desc": "Personnalisation des nuances de gris selon les tendances de couleur",
       "title": "Couleur neutre"
@@ -777,4 +783,4 @@
     },
     "title": "Outils supplémentaires"
   }
-}
+}

package/locales/it-IT/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Elegante",
       "title": "Animazione di risposta"
     },
+    "contextMenuMode": {
+      "default": "Predefinito",
+      "desc": "Seleziona il tipo di menu contestuale per i messaggi di chat",
+      "disabled": "Disabilitato",
+      "title": "Tipo di menu contestuale"
+    },
     "neutralColor": {
       "desc": "Personalizzazione dei grigi con diverse inclinazioni di colore",
       "title": "Colore Neutro"
@@ -777,4 +783,4 @@
     },
     "title": "Strumenti aggiuntivi"
   }
-}
+}

package/locales/ja-JP/setting.json

@@ -293,6 +293,12 @@
       "elegant": "エレガント",
       "title": "応答アニメーション"
     },
+    "contextMenuMode": {
+      "default": "デフォルト",
+      "desc": "チャットメッセージの右クリックメニューの表示方法を選択してください",
+      "disabled": "使用しない",
+      "title": "右クリックメニューの設定"
+    },
     "neutralColor": {
       "desc": "異なる色彩傾向のグレースケールカスタマイズ",
       "title": "ニュートラルカラー"
@@ -777,4 +783,4 @@
     },
     "title": "拡張ツール"
   }
-}
+}

package/locales/ko-KR/setting.json

@@ -293,6 +293,12 @@
       "elegant": "우아함",
       "title": "반응 애니메이션"
     },
+    "contextMenuMode": {
+      "default": "기본값",
+      "desc": "채팅 메시지 우클릭 메뉴 표시 방식을 선택하세요",
+      "disabled": "사용 안 함",
+      "title": "우클릭 메뉴 방식"
+    },
     "neutralColor": {
       "desc": "다양한 색상 경향의 회색조 사용자 정의",
       "title": "중립 색상"
@@ -777,4 +783,4 @@
     },
     "title": "확장 도구"
   }
-}
+}

package/locales/nl-NL/setting.json

@@ -293,6 +293,12 @@
       "elegant": "Elegant",
       "title": "Reactie-animatie"
     },
+    "contextMenuMode": {
+      "default": "Standaard",
+      "desc": "Kies de weergaveoptie voor het contextmenu van chatberichten",
+      "disabled": "Niet gebruiken",
+      "title": "Contextmenu-optie"
+    },
     "neutralColor": {
       "desc": "Aangepaste grijstinten met verschillende kleurvoorkeuren",
       "title": "Neutrale kleur"
@@ -777,4 +783,4 @@
     },
     "title": "Uitbreidingsgereedschap"
   }
-}
+}