@lobehub/lobehub 2.0.0-next.209 → 2.0.0-next.210

package/.vscode/settings.json

@@ -26,9 +26,9 @@
   ],
   "npm.packageManager": "pnpm",
   "search.exclude": {
-    "**/node_modules": true,
+    "**/node_modules": true
     // useless to search this big folder
-    "locales": true
+    // "locales": true
   },
   "stylelint.validate": [
     "css",
@@ -41,58 +41,43 @@
     "**/app/**/[[]*[]]/[[]*[]]/page.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • page component",
     "**/app/**/[[]*[]]/page.tsx": "${dirname(1)}/${dirname} • page component",
     "**/app/**/page.tsx": "${dirname} • page component",
-
     "**/app/**/[[]*[]]/[[]*[]]/layout.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • page layout",
     "**/app/**/[[]*[]]/layout.tsx": "${dirname(1)}/${dirname} • page layout",
     "**/app/**/layout.tsx": "${dirname} • page layout",
-
     "**/app/**/[[]*[]]/[[]*[]]/default.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • slot default",
     "**/app/**/[[]*[]]/default.tsx": "${dirname(1)}/${dirname} • slot default",
     "**/app/**/default.tsx": "${dirname} • slot default",
-
     "**/app/**/[[]*[]]/[[]*[]]/error.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • error component",
     "**/app/**/[[]*[]]/error.tsx": "${dirname(1)}/${dirname} • error component",
     "**/app/**/error.tsx": "${dirname} • error component",
-
     "**/app/**/[[]*[]]/[[]*[]]/loading.tsx": "${dirname(2)}/${dirname(1)}/${dirname} • loading component",
     "**/app/**/[[]*[]]/loading.tsx": "${dirname(1)}/${dirname} • loading component",
     "**/app/**/loading.tsx": "${dirname} • loading component",
-
     "**/src/**/route.ts": "${dirname(1)}/${dirname} • route",
     "**/src/**/index.tsx": "${dirname} • component",
-
     "**/packages/database/src/repositories/*/index.ts": "${dirname} • db repository",
     "**/packages/database/src/models/*.ts": "${filename} • db model",
     "**/packages/database/src/schemas/*.ts": "${filename} • db schema",
-
     "**/src/services/*.ts": "${filename} • service",
     "**/src/services/*/client.ts": "${dirname} • client service",
     "**/src/services/*/server.ts": "${dirname} • server service",
-
     "**/src/store/*/action.ts": "${dirname} • action",
     "**/src/store/*/slices/*/action.ts": "${dirname(2)}/${dirname} • action",
     "**/src/store/*/slices/*/actions/*.ts": "${dirname(1)}/${dirname}/${filename} • action",
-
     "**/src/store/*/initialState.ts": "${dirname} • state",
     "**/src/store/*/slices/*/initialState.ts": "${dirname(2)}/${dirname} • state",
-
     "**/src/store/*/selectors.ts": "${dirname} • selectors",
     "**/src/store/*/slices/*/selectors.ts": "${dirname(2)}/${dirname} • selectors",
-
     "**/src/store/*/reducer.ts": "${dirname} • reducer",
     "**/src/store/*/slices/*/reducer.ts": "${dirname(2)}/${dirname} • reducer",
-
     "**/src/config/modelProviders/*.ts": "${filename} • provider",
     "**/packages/model-bank/src/aiModels/*.ts": "${filename} • model",
     "**/packages/model-runtime/src/providers/*/index.ts": "${dirname} • runtime",
-
     "**/src/server/services/*/index.ts": "${dirname} • server/service",
     "**/src/server/routers/lambda/*.ts": "${filename} • lambda",
     "**/src/server/routers/async/*.ts": "${filename} • async",
     "**/src/server/routers/edge/*.ts": "${filename} • edge",
-
     "**/src/locales/default/*.ts": "${filename} • locale",
-
     "**/index.*": "${dirname}/${filename}.${extname}"
   }
 }

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 2.0.0-next.210](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.209...v2.0.0-next.210)
+
+<sup>Released on **2026-01-04**</sup>
+
+#### 🐛 Bug Fixes
+
+- **model-runtime**: Handle Qwen tool_calls without initial arguments.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **model-runtime**: Handle Qwen tool_calls without initial arguments, closes [#11211](https://github.com/lobehub/lobe-chat/issues/11211) ([5321d91](https://github.com/lobehub/lobe-chat/commit/5321d91))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.209](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.208...v2.0.0-next.209)
 
 <sup>Released on **2026-01-04**</sup>

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

@@ -38,6 +38,8 @@ export default class SystemController extends ControllerModule {
       isLinux: platform === 'linux',
       isMac: platform === 'darwin',
       isWindows: platform === 'win32',
+      locale: this.app.storeManager.get('locale', 'auto'),
+
       platform: platform as 'darwin' | 'win32' | 'linux',
       userPath: {
         // User Paths (ensure keys match UserPathData / DesktopAppState interface)
@@ -216,6 +218,14 @@ export default class SystemController extends ControllerModule {
     return result.filePaths[0];
   }
 
+  /**
+   * Get the OS system locale
+   */
+  @IpcMethod()
+  getSystemLocale(): string {
+    return app.getLocale();
+  }
+
   /**
    * 更新应用语言设置
    */

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

@@ -1,24 +1,15 @@
-import {
-  DEFAULT_VARIANTS,
-  LOBE_LOCALE_COOKIE,
-  LOBE_THEME_APPEARANCE,
-  Locales,
-  RouteVariants,
-} from '@lobechat/desktop-bridge';
 import { ElectronIPCEventHandler, ElectronIPCServer } from '@lobechat/electron-server-ipc';
-import { app, nativeTheme, protocol, session } from 'electron';
+import { app, nativeTheme, protocol } from 'electron';
 import installExtension, { REACT_DEVELOPER_TOOLS } from 'electron-devtools-installer';
 import { macOS, windows } from 'electron-is';
-import { pathExistsSync } from 'fs-extra';
 import os from 'node:os';
-import { extname, join } from 'node:path';
+import { join } from 'node:path';
 
 import { name } from '@/../../package.json';
-import { buildDir, nextExportDir } from '@/const/dir';
+import { buildDir } from '@/const/dir';
 import { isDev } from '@/const/env';
 import { ELECTRON_BE_PROTOCOL_SCHEME } from '@/const/protocol';
 import { IControlModule } from '@/controllers';
-import { getDesktopEnv } from '@/env';
 import { IServiceModule } from '@/services';
 import { getServerMethodMetadata } from '@/utils/ipc';
 import { createLogger } from '@/utils/logger';
@@ -27,7 +18,7 @@ import { BrowserManager } from './browser/BrowserManager';
 import { I18nManager } from './infrastructure/I18nManager';
 import { IoCContainer } from './infrastructure/IoCContainer';
 import { ProtocolManager } from './infrastructure/ProtocolManager';
-import { RendererProtocolManager } from './infrastructure/RendererProtocolManager';
+import { RendererUrlManager } from './infrastructure/RendererUrlManager';
 import { StaticFileServerManager } from './infrastructure/StaticFileServerManager';
 import { StoreManager } from './infrastructure/StoreManager';
 import { UpdaterManager } from './infrastructure/UpdaterManager';
@@ -45,11 +36,7 @@ type Class<T> = new (...args: any[]) => T;
 
 const importAll = (r: any) => Object.values(r).map((v: any) => v.default);
 
-const devDefaultRendererUrl = 'http://localhost:3015';
-
 export class App {
-  rendererLoadedUrl: string;
-
   browserManager: BrowserManager;
   menuManager: MenuManager;
   i18n: I18nManager;
@@ -59,12 +46,8 @@ export class App {
   trayManager: TrayManager;
   staticFileServerManager: StaticFileServerManager;
   protocolManager: ProtocolManager;
-  rendererProtocolManager: RendererProtocolManager;
+  rendererUrlManager: RendererUrlManager;
   chromeFlags: string[] = ['OverlayScrollbar', 'FluentOverlayScrollbar', 'FluentScrollbar'];
-  /**
-   * Escape hatch: allow testing static renderer in dev via env
-   */
-  private readonly rendererStaticOverride = getDesktopEnv().DESKTOP_RENDERER_STATIC;
 
   /**
    * whether app is in quiting
@@ -96,10 +79,7 @@ export class App {
     // Initialize store manager
     this.storeManager = new StoreManager(this);
 
-    this.rendererProtocolManager = new RendererProtocolManager({
-      nextExportDir,
-      resolveRendererFilePath: this.resolveRendererFilePath.bind(this),
-    });
+    this.rendererUrlManager = new RendererUrlManager();
     protocol.registerSchemesAsPrivileged([
       {
         privileges: {
@@ -111,12 +91,9 @@ export class App {
         },
         scheme: ELECTRON_BE_PROTOCOL_SCHEME,
       },
-      this.rendererProtocolManager.protocolScheme,
+      this.rendererUrlManager.protocolScheme,
     ]);
 
-    // Initialize rendererLoadedUrl from RendererProtocolManager
-    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
-
     // load controllers
     const controllers: IControlModule[] = importAll(
       import.meta.glob('@/controllers/*Ctr.ts', { eager: true }),
@@ -146,7 +123,7 @@ export class App {
 
     // Configure renderer loading strategy (dev server vs static export)
     // should register before app ready
-    this.configureRendererLoader();
+    this.rendererUrlManager.configureRendererLoader();
 
     // initialize protocol handlers
     this.protocolManager.initialize();
@@ -385,166 +362,11 @@ export class App {
     }
   };
 
-  private resolveExportFilePath(pathname: string) {
-    // Normalize by removing leading/trailing slashes so extname works as expected
-    const normalizedPath = decodeURIComponent(pathname).replace(/^\/+/, '').replace(/\/$/, '');
-
-    if (!normalizedPath) return join(nextExportDir, 'index.html');
-
-    const basePath = join(nextExportDir, normalizedPath);
-    const ext = extname(normalizedPath);
-
-    // If the request explicitly includes an extension (e.g. html, ico, txt),
-    // treat it as a direct asset without variant injection.
-    if (ext) {
-      return pathExistsSync(basePath) ? basePath : null;
-    }
-
-    const candidates = [`${basePath}.html`, join(basePath, 'index.html'), basePath];
-
-    for (const candidate of candidates) {
-      if (pathExistsSync(candidate)) return candidate;
-    }
-
-    const fallback404 = join(nextExportDir, '404.html');
-    if (pathExistsSync(fallback404)) return fallback404;
-
-    return null;
-  }
-
   /**
-   * Configure renderer loading strategy for dev/prod
-   */
-  private configureRendererLoader() {
-    if (isDev && !this.rendererStaticOverride) {
-      this.rendererLoadedUrl = devDefaultRendererUrl;
-      this.setupDevRenderer();
-      return;
-    }
-
-    if (isDev && this.rendererStaticOverride) {
-      logger.warn('Dev mode: DESKTOP_RENDERER_STATIC enabled, using static renderer handler');
-    }
-
-    this.setupProdRenderer();
-  }
-
-  /**
-   * Development: use Next dev server directly
-   */
-  private setupDevRenderer() {
-    logger.info('Development mode: renderer served from Next dev server, no protocol hook');
-  }
-
-  /**
-   * Production: serve static Next export assets
-   */
-  private setupProdRenderer() {
-    // Use the URL from RendererProtocolManager
-    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
-    this.rendererProtocolManager.registerHandler();
-  }
-
-  /**
-   * Resolve renderer file path in production by combining variant prefix and pathname.
-   * Falls back to default variant when cookies are missing or invalid.
-   */
-  private async resolveRendererFilePath(url: URL) {
-    const pathname = url.pathname;
-    const normalizedPathname = pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
-
-    // Static assets should be resolved from root (no variant prefix)
-    if (
-      pathname.startsWith('/_next/') ||
-      pathname.startsWith('/static/') ||
-      pathname === '/favicon.ico' ||
-      pathname === '/manifest.json'
-    ) {
-      return this.resolveExportFilePath(pathname);
-    }
-
-    // If the incoming path already contains an extension (like .html or .ico),
-    // treat it as a direct asset lookup to avoid double variant prefixes.
-    const extension = extname(normalizedPathname);
-    if (extension) {
-      const directPath = this.resolveExportFilePath(pathname);
-      if (directPath) return directPath;
-
-      // Next.js RSC payloads are emitted under variant folders (e.g. /en-US__0__light/__next._tree.txt),
-      // but the runtime may request them without the variant prefix. For missing .txt requests,
-      // retry resolution with variant injection.
-      if (extension === '.txt' && normalizedPathname.includes('__next.')) {
-        const variant = await this.getRouteVariantFromCookies();
-
-        return (
-          this.resolveExportFilePath(`/${variant}${pathname}`) ||
-          this.resolveExportFilePath(`/${this.defaultRouteVariant}${pathname}`) ||
-          null
-        );
-      }
-
-      return null;
-    }
-
-    const variant = await this.getRouteVariantFromCookies();
-    const variantPrefixedPath = `/${variant}${pathname}`;
-
-    // Try variant-specific path first, then default variant as fallback
-    return (
-      this.resolveExportFilePath(variantPrefixedPath) ||
-      this.resolveExportFilePath(`/${this.defaultRouteVariant}${pathname}`) ||
-      null
-    );
-  }
-
-  private readonly defaultRouteVariant = RouteVariants.serializeVariants(DEFAULT_VARIANTS);
-  private readonly localeCookieName = LOBE_LOCALE_COOKIE;
-  private readonly themeCookieName = LOBE_THEME_APPEARANCE;
-
-  /**
-   * Build variant string from Electron session cookies to match Next export structure.
-   * Desktop is always treated as non-mobile (0).
-   */
-  private async getRouteVariantFromCookies(): Promise<string> {
-    try {
-      const cookies = await session.defaultSession.cookies.get({
-        url: `${this.rendererLoadedUrl}/`,
-      });
-      const locale = cookies.find((c) => c.name === this.localeCookieName)?.value;
-      const themeCookie = cookies.find((c) => c.name === this.themeCookieName)?.value;
-
-      const serialized = RouteVariants.serializeVariants(
-        RouteVariants.createVariants({
-          isMobile: false,
-          locale: locale as Locales | undefined,
-          theme: themeCookie === 'dark' || themeCookie === 'light' ? themeCookie : undefined,
-        }),
-      );
-
-      return RouteVariants.serializeVariants(RouteVariants.deserializeVariants(serialized));
-    } catch (error) {
-      logger.warn('Failed to read route variant cookies, using default', error);
-      return this.defaultRouteVariant;
-    }
-  }
-
-  /**
-   * Build renderer URL with variant prefix injected into the path.
-   * In dev mode (without static override), Next.js dev server handles routing automatically.
-   * In prod or dev with static override, we need to inject variant to match export structure: /[variants]/path
+   * Build renderer URL for dev/prod.
    */
   async buildRendererUrl(path: string): Promise<string> {
-    // Ensure path starts with /
-    const cleanPath = path.startsWith('/') ? path : `/${path}`;
-
-    // In dev mode without static override, use dev server directly (no variant needed)
-    if (isDev && !this.rendererStaticOverride) {
-      return `${this.rendererLoadedUrl}${cleanPath}`;
-    }
-
-    // In prod or dev with static override, inject variant for static export structure
-    const variant = await this.getRouteVariantFromCookies();
-    return `${this.rendererLoadedUrl}/${variant}.html${cleanPath}`;
+    return this.rendererUrlManager.buildRendererUrl(path);
   }
 
   private initializeServerIpcEvents() {

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

@@ -12,6 +12,7 @@ vi.mock('electron', () => ({
     getLocale: vi.fn(() => 'en-US'),
     getPath: vi.fn(() => '/mock/user/path'),
     requestSingleInstanceLock: vi.fn(() => true),
+    isReady: vi.fn(() => true),
     whenReady: vi.fn(() => Promise.resolve()),
     on: vi.fn(),
     commandLine: {
@@ -32,6 +33,7 @@ vi.mock('electron', () => ({
   },
   protocol: {
     registerSchemesAsPrivileged: vi.fn(),
+    handle: vi.fn(),
   },
   session: {
     defaultSession: {
@@ -83,6 +85,10 @@ vi.mock('@/const/env', () => ({
   isDev: false,
 }));
 
+vi.mock('@/env', () => ({
+  getDesktopEnv: vi.fn(() => ({ DESKTOP_RENDERER_STATIC: false })),
+}));
+
 vi.mock('@/const/dir', () => ({
   buildDir: '/mock/build',
   nextExportDir: '/mock/export/out',
@@ -190,46 +196,4 @@ describe('App', () => {
       expect(storagePath).toBe('/mock/storage/path');
     });
   });
-
-  describe('resolveRendererFilePath', () => {
-    it('should retry missing .txt requests with variant-prefixed lookup', async () => {
-      appInstance = new App();
-
-      // Avoid touching the electron session cookie code path in this unit test
-      (appInstance as any).getRouteVariantFromCookies = vi.fn(async () => 'en-US__0__light');
-
-      mockPathExistsSync.mockImplementation((p: string) => {
-        // root miss
-        if (p === '/mock/export/out/__next._tree.txt') return false;
-        // variant hit
-        if (p === '/mock/export/out/en-US__0__light/__next._tree.txt') return true;
-        return false;
-      });
-
-      const resolved = await (appInstance as any).resolveRendererFilePath(
-        new URL('app://next/__next._tree.txt'),
-      );
-
-      expect(resolved).toBe('/mock/export/out/en-US__0__light/__next._tree.txt');
-    });
-
-    it('should keep direct lookup for existing root .txt assets (no variant retry)', async () => {
-      appInstance = new App();
-
-      (appInstance as any).getRouteVariantFromCookies = vi.fn(async () => {
-        throw new Error('should not be called');
-      });
-
-      mockPathExistsSync.mockImplementation((p: string) => {
-        if (p === '/mock/export/out/en-US__0__light.txt') return true;
-        return false;
-      });
-
-      const resolved = await (appInstance as any).resolveRendererFilePath(
-        new URL('app://next/en-US__0__light.txt'),
-      );
-
-      expect(resolved).toBe('/mock/export/out/en-US__0__light.txt');
-    });
-  });
 });

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

@@ -168,15 +168,23 @@ export default class Browser {
   loadUrl = async (path: string) => {
     const initUrl = await this.app.buildRendererUrl(path);
 
-    console.log('[Browser] initUrl', initUrl);
+    // Inject locale from store to help renderer boot with the correct language.
+    // Skip when set to auto to let the renderer detect locale normally.
+    const storedLocale = this.app.storeManager.get('locale', 'auto');
+    const urlWithLocale =
+      storedLocale && storedLocale !== 'auto'
+        ? `${initUrl}${initUrl.includes('?') ? '&' : '?'}lng=${storedLocale}`
+        : initUrl;
+
+    console.log('[Browser] initUrl', urlWithLocale);
 
     try {
-      logger.debug(`[${this.identifier}] Attempting to load URL: ${initUrl}`);
-      await this._browserWindow.loadURL(initUrl);
+      logger.debug(`[${this.identifier}] Attempting to load URL: ${urlWithLocale}`);
+      await this._browserWindow.loadURL(urlWithLocale);
 
-      logger.debug(`[${this.identifier}] Successfully loaded URL: ${initUrl}`);
+      logger.debug(`[${this.identifier}] Successfully loaded URL: ${urlWithLocale}`);
     } catch (error) {
-      logger.error(`[${this.identifier}] Failed to load URL (${initUrl}):`, error);
+      logger.error(`[${this.identifier}] Failed to load URL (${urlWithLocale}):`, error);
 
       // Try to load local error page
       try {
@@ -190,13 +198,13 @@ export default class Browser {
 
         // Set retry logic
         ipcMain.handle('retry-connection', async () => {
-          logger.info(`[${this.identifier}] Retry connection requested for: ${initUrl}`);
+          logger.info(`[${this.identifier}] Retry connection requested for: ${urlWithLocale}`);
           try {
-            await this._browserWindow?.loadURL(initUrl);
-            logger.info(`[${this.identifier}] Reconnection successful to ${initUrl}`);
+            await this._browserWindow?.loadURL(urlWithLocale);
+            logger.info(`[${this.identifier}] Reconnection successful to ${urlWithLocale}`);
             return { success: true };
           } catch (err) {
-            logger.error(`[${this.identifier}] Retry connection failed for ${initUrl}:`, err);
+            logger.error(`[${this.identifier}] Retry connection failed for ${urlWithLocale}:`, err);
             // Reload error page
             try {
               logger.info(`[${this.identifier}] Reloading error page after failed retry...`);

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

@@ -0,0 +1,126 @@
+import { pathExistsSync } from 'fs-extra';
+import { extname, join } from 'node:path';
+
+import { nextExportDir } from '@/const/dir';
+import { isDev } from '@/const/env';
+import { getDesktopEnv } from '@/env';
+import { createLogger } from '@/utils/logger';
+
+import { RendererProtocolManager } from './RendererProtocolManager';
+
+const logger = createLogger('core:RendererUrlManager');
+const devDefaultRendererUrl = 'http://localhost:3015';
+
+export class RendererUrlManager {
+  private readonly rendererProtocolManager: RendererProtocolManager;
+  private readonly rendererStaticOverride = getDesktopEnv().DESKTOP_RENDERER_STATIC;
+  private rendererLoadedUrl: string;
+
+  constructor() {
+    this.rendererProtocolManager = new RendererProtocolManager({
+      nextExportDir,
+      resolveRendererFilePath: this.resolveRendererFilePath,
+    });
+
+    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
+  }
+
+  get protocolScheme() {
+    return this.rendererProtocolManager.protocolScheme;
+  }
+
+  /**
+   * Configure renderer loading strategy for dev/prod
+   */
+  configureRendererLoader() {
+    if (isDev && !this.rendererStaticOverride) {
+      this.rendererLoadedUrl = devDefaultRendererUrl;
+      this.setupDevRenderer();
+      return;
+    }
+
+    if (isDev && this.rendererStaticOverride) {
+      logger.warn('Dev mode: DESKTOP_RENDERER_STATIC enabled, using static renderer handler');
+    }
+
+    this.setupProdRenderer();
+  }
+
+  /**
+   * Build renderer URL for dev/prod.
+   */
+  buildRendererUrl(path: string): string {
+    const cleanPath = path.startsWith('/') ? path : `/${path}`;
+    return `${this.rendererLoadedUrl}${cleanPath}`;
+  }
+
+  /**
+   * Resolve renderer file path in production.
+   * Static assets map directly; app routes fall back to index.html.
+   */
+  resolveRendererFilePath = async (url: URL): Promise<string | null> => {
+    const pathname = url.pathname;
+    const normalizedPathname = pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
+
+    // Static assets should be resolved from root
+    if (
+      pathname.startsWith('/_next/') ||
+      pathname.startsWith('/static/') ||
+      pathname === '/favicon.ico' ||
+      pathname === '/manifest.json'
+    ) {
+      return this.resolveExportFilePath(pathname);
+    }
+
+    // If the incoming path already contains an extension (like .html or .ico),
+    // treat it as a direct asset lookup.
+    const extension = extname(normalizedPathname);
+    if (extension) {
+      return this.resolveExportFilePath(pathname);
+    }
+
+    return this.resolveExportFilePath('/');
+  };
+
+  private resolveExportFilePath(pathname: string) {
+    // Normalize by removing leading/trailing slashes so extname works as expected
+    const normalizedPath = decodeURIComponent(pathname).replace(/^\/+/, '').replace(/\/$/, '');
+
+    if (!normalizedPath) return join(nextExportDir, 'index.html');
+
+    const basePath = join(nextExportDir, normalizedPath);
+    const ext = extname(normalizedPath);
+
+    // If the request explicitly includes an extension (e.g. html, ico, txt),
+    // treat it as a direct asset.
+    if (ext) {
+      return pathExistsSync(basePath) ? basePath : null;
+    }
+
+    const candidates = [`${basePath}.html`, join(basePath, 'index.html'), basePath];
+
+    for (const candidate of candidates) {
+      if (pathExistsSync(candidate)) return candidate;
+    }
+
+    const fallback404 = join(nextExportDir, '404.html');
+    if (pathExistsSync(fallback404)) return fallback404;
+
+    return null;
+  }
+
+  /**
+   * Development: use Next dev server directly
+   */
+  private setupDevRenderer() {
+    logger.info('Development mode: renderer served from Next dev server, no protocol hook');
+  }
+
+  /**
+   * Production: serve static Next export assets
+   */
+  private setupProdRenderer() {
+    this.rendererLoadedUrl = this.rendererProtocolManager.getRendererUrl();
+    this.rendererProtocolManager.registerHandler();
+  }
+}