@lobehub/lobehub 2.0.0-next.292 → 2.0.0-next.294

package/.github/workflows/release-desktop-beta.yml

@@ -4,7 +4,7 @@ name: Release Desktop Beta
 # Beta/Nightly 频道发版工作流
 # ============================================
 # 触发条件: 发布包含 pre-release 标识的 release
-# 如: v2.0.0-beta.1, v2.0.0-alpha.1, v2.0.0-rc.1, v2.0.0-nightly.xxx
+# 如: v2.0.0-beta.1, v2.0.0-alpha.1, v2.0.0-rc.1, v2.0.0-nightly.xxx, v2.0.0-next.292
 #
 # 注意: Stable 版本 (如 v2.0.0) 由 release-desktop-stable.yml 处理
 # ============================================
@@ -24,10 +24,10 @@ env:
 
 jobs:
   # ============================================
-  # 检查是否为 Beta/Nightly 版本 (排除 Stable)
+  # 检查是否为 Beta/Nightly/Next 版本 (排除 Stable)
   # ============================================
   check-beta:
-    name: Check if Beta/Nightly Release
+    name: Check if Beta/Nightly/Next Release
     runs-on: ubuntu-latest
     outputs:
       is_beta: ${{ steps.check.outputs.is_beta }}
@@ -40,10 +40,10 @@ jobs:
           version="${version#v}"
           echo "version=${version}" >> $GITHUB_OUTPUT
 
-          # Beta/Nightly 版本包含 beta/alpha/rc/nightly
-          if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]]; then
+          # Beta/Nightly/Next 版本包含 beta/alpha/rc/nightly/next
+          if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]] || [[ "$version" == *"next"* ]]; then
             echo "is_beta=true" >> $GITHUB_OUTPUT
-            echo "✅ Beta/Nightly release detected: $version"
+            echo "✅ Beta/Nightly/Next release detected: $version"
           else
             echo "is_beta=false" >> $GITHUB_OUTPUT
             echo "⏭️ Skipping: $version is a stable release (handled by release-desktop-stable.yml)"

package/.github/workflows/release-desktop-stable.yml

@@ -3,10 +3,10 @@ name: Release Desktop Stable
 # ============================================
 # Stable 频道发版工作流
 # ============================================
-# 触发条件: 发布不含 pre-release 标识的 release (如 v2.0.0)
+# 触发条件: 发布不含 pre-release 后缀的 release (如 v2.0.0)
 #
 # 与 Beta 的区别:
-#   1. 仅响应 stable 版本 tag (不含 beta/alpha/rc/nightly)
+#   1. 仅响应 stable 版本 tag (不含任何 '-' 后缀)
 #   2. 使用 STABLE 专用的 Umami 配置
 #   3. 额外上传到 S3 更新服务器
 #   4. 构建时注入 UPDATE_SERVER_URL 让客户端从 S3 检查更新
@@ -34,6 +34,11 @@ on:
         required: false
         type: boolean
         default: true
+      build_mac_intel:
+        description: 'Build macOS (Intel x64)'
+        required: false
+        type: boolean
+        default: true
       build_windows:
         description: 'Build Windows'
         required: false
@@ -84,8 +89,8 @@ jobs:
           if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
             # 手动触发: 使用输入的版本号
             version="${{ inputs.version }}"
+            version="${version#v}"
             echo "is_manual=true" >> $GITHUB_OUTPUT
-            echo "is_stable=true" >> $GITHUB_OUTPUT
             echo "version=${version}" >> $GITHUB_OUTPUT
             echo "release_notes=" >> $GITHUB_OUTPUT
             echo "🔧 Manual trigger: version=${version}"
@@ -101,15 +106,15 @@ jobs:
               printf '%s\n' "$release_body"
               echo "EOF"
             } >> $GITHUB_OUTPUT
+          fi
 
-            # 检查是否为 stable 版本 (不含 beta/alpha/rc/nightly)
-            if [[ "$version" == *"beta"* ]] || [[ "$version" == *"alpha"* ]] || [[ "$version" == *"rc"* ]] || [[ "$version" == *"nightly"* ]]; then
-              echo "is_stable=false" >> $GITHUB_OUTPUT
-              echo "⏭️ Skipping: $version is not a stable release"
-            else
-              echo "is_stable=true" >> $GITHUB_OUTPUT
-              echo "✅ Stable release detected: $version"
-            fi
+          # 检查是否为 stable 版本 (不含任何 '-' 后缀)
+          if [[ "$version" == *"-"* ]]; then
+            echo "is_stable=false" >> $GITHUB_OUTPUT
+            echo "⏭️ Skipping: $version is not a stable release"
+          else
+            echo "is_stable=true" >> $GITHUB_OUTPUT
+            echo "✅ Stable release detected: $version"
           fi
 
   # ============================================
@@ -147,6 +152,12 @@ jobs:
             static_matrix=$(echo "$static_matrix" | jq -c --argjson entry "$arm_entry" '. + [$entry]')
           fi
 
+          if [[ "${{ github.event_name }}" != "workflow_dispatch" ]] || [[ "${{ inputs.build_mac_intel }}" == "true" ]]; then
+            echo "Using GitHub-Hosted Runner for macOS Intel x64"
+            intel_entry='{"os": "macos-15-intel", "name": "macos-intel"}'
+            static_matrix=$(echo "$static_matrix" | jq -c --argjson entry "$intel_entry" '. + [$entry]')
+          fi
+
           # 输出
           echo "matrix={\"include\":$static_matrix}" >> $GITHUB_OUTPUT
 

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 # Changelog
 
+## [Version 2.0.0-next.294](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.293...v2.0.0-next.294)
+
+<sup>Released on **2026-01-15**</sup>
+
+#### 🐛 Bug Fixes
+
+- **chat**: Reset activeTopicId when switching agent/group.
+- **mcp**: Fix installation check hanging issue in desktop app.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **chat**: Reset activeTopicId when switching agent/group, closes [#11523](https://github.com/lobehub/lobe-chat/issues/11523) ([fde54b0](https://github.com/lobehub/lobe-chat/commit/fde54b0))
+- **mcp**: Fix installation check hanging issue in desktop app, closes [#11524](https://github.com/lobehub/lobe-chat/issues/11524) ([b9341c3](https://github.com/lobehub/lobe-chat/commit/b9341c3))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.293](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.292...v2.0.0-next.293)
+
+<sup>Released on **2026-01-15**</sup>
+
+#### ✨ Features
+
+- **desktop**: Add desktop release service and API endpoint.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **desktop**: Add desktop release service and API endpoint, closes [#11520](https://github.com/lobehub/lobe-chat/issues/11520) ([e3dc5be](https://github.com/lobehub/lobe-chat/commit/e3dc5be))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.292](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.291...v2.0.0-next.292)
 
 <sup>Released on **2026-01-15**</sup>

package/apps/desktop/electron.vite.config.ts

@@ -21,7 +21,6 @@ export default defineConfig({
       },
       sourcemap: isDev ? 'inline' : false,
     },
-
     define: {
       'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV),
       'process.env.UPDATE_CHANNEL': JSON.stringify(process.env.UPDATE_CHANNEL),

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

@@ -7,7 +7,7 @@ import superjson from 'superjson';
 import FileService from '@/services/fileSrv';
 import { createLogger } from '@/utils/logger';
 
-import { MCPClient } from '../libs/mcp/client';
+import { MCPClient, MCPConnectionError } from '../libs/mcp/client';
 import type { MCPClientParams, ToolCallContent, ToolCallResult } from '../libs/mcp/types';
 import { ControllerModule, IpcMethod } from './index';
 
@@ -228,8 +228,9 @@ export default class McpCtr extends ControllerModule {
       type: 'stdio',
     };
 
-    const client = await this.createClient(params);
+    let client: MCPClient | undefined;
     try {
+      client = await this.createClient(params);
       const manifest = await client.listManifests();
       const identifier = input.name;
 
@@ -257,8 +258,25 @@ export default class McpCtr extends ControllerModule {
         mcpParams: params,
         type: 'mcp' as any,
       });
+    } catch (error) {
+      // If it's an MCPConnectionError with stderr logs, enhance the error message
+      if (error instanceof MCPConnectionError && error.stderrLogs.length > 0) {
+        const stderrOutput = error.stderrLogs.join('\n');
+        const enhancedError = new Error(
+          `${error.message}\n\n--- STDIO Process Output ---\n${stderrOutput}`,
+        );
+        enhancedError.name = error.name;
+        logger.error('getStdioMcpServerManifest failed with STDIO logs:', {
+          message: error.message,
+          stderrLogs: error.stderrLogs,
+        });
+        throw enhancedError;
+      }
+      throw error;
     } finally {
-      await client.disconnect();
+      if (client) {
+        await client.disconnect();
+      }
     }
   }
 
@@ -313,8 +331,9 @@ export default class McpCtr extends ControllerModule {
       type: 'stdio',
     };
 
-    const client = await this.createClient(params);
+    let client: MCPClient | undefined;
     try {
+      client = await this.createClient(params);
       const args = safeParseToRecord(input.args);
 
       const raw = (await client.callTool(input.toolName, args)) as ToolCallResult;
@@ -328,10 +347,25 @@ export default class McpCtr extends ControllerModule {
         success: true,
       });
     } catch (error) {
+      // If it's an MCPConnectionError with stderr logs, enhance the error message
+      if (error instanceof MCPConnectionError && error.stderrLogs.length > 0) {
+        const stderrOutput = error.stderrLogs.join('\n');
+        const enhancedError = new Error(
+          `${error.message}\n\n--- STDIO Process Output ---\n${stderrOutput}`,
+        );
+        enhancedError.name = error.name;
+        logger.error('callTool failed with STDIO logs:', {
+          message: error.message,
+          stderrLogs: error.stderrLogs,
+        });
+        throw enhancedError;
+      }
       logger.error('callTool failed:', error);
       throw error;
     } finally {
-      await client.disconnect();
+      if (client) {
+        await client.disconnect();
+      }
     }
   }
 
@@ -361,8 +395,9 @@ export default class McpCtr extends ControllerModule {
   }
 
   private async checkSystemDependency(dependency: any) {
+    const checkCommand = dependency.checkCommand || `${dependency.name} --version`;
+
     try {
-      const checkCommand = dependency.checkCommand || `${dependency.name} --version`;
       const { stdout, stderr } = await execPromise(checkCommand);
 
       if (stderr && !stdout) {
@@ -444,22 +479,19 @@ export default class McpCtr extends ControllerModule {
       const packageName = details?.packageName;
       if (!packageName) return { installed: false };
 
+      // Only check global npm list - do NOT use npx as it may download packages
       try {
         const { stdout } = await execPromise(`npm list -g ${packageName} --depth=0`);
-        if (!stdout.includes('(empty)') && stdout.includes(packageName)) return { installed: true };
+        if (!stdout.includes('(empty)') && stdout.includes(packageName)) {
+          return { installed: true };
+        }
       } catch {
-        // ignore
+        // ignore - package not found in global list
       }
 
-      try {
-        await execPromise(`npx -y ${packageName} --version`);
-        return { installed: true };
-      } catch (error) {
-        return {
-          error: error instanceof Error ? error.message : 'Unknown error',
-          installed: false,
-        };
-      }
+      // For npm packages, we don't require pre-installation
+      // npx will handle downloading and running on-demand during actual MCP connection
+      return { installed: false };
     }
 
     if (installationMethod === 'python') {
@@ -553,7 +585,7 @@ export default class McpCtr extends ControllerModule {
       const bestResult = recommendedResult || firstInstallableResult || results[0];
 
       const checkResult: CheckMcpInstallResult = {
-        ...(bestResult || {}),
+        ...bestResult,
         allOptions: results as any,
         platform: process.platform,
         success: true,

package/apps/desktop/src/main/libs/mcp/client.ts

@@ -6,15 +6,31 @@ import {
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import type { Progress } from '@modelcontextprotocol/sdk/types.js';
+import type { Readable } from 'node:stream';
 
 import { getDesktopEnv } from '@/env';
 
 import type { MCPClientParams, McpPrompt, McpResource, McpTool, ToolCallResult } from './types';
 
+/**
+ * Custom error class for MCP connection errors that includes STDIO logs
+ */
+export class MCPConnectionError extends Error {
+  readonly stderrLogs: string[];
+
+  constructor(message: string, stderrLogs: string[] = []) {
+    super(message);
+    this.name = 'MCPConnectionError';
+    this.stderrLogs = stderrLogs;
+  }
+}
+
 export class MCPClient {
   private readonly mcp: Client;
 
   private transport: Transport;
+  private stderrLogs: string[] = [];
+  private isStdio: boolean = false;
 
   constructor(params: MCPClientParams) {
     this.mcp = new Client({ name: 'lobehub-desktop-mcp-client', version: '1.0.0' });
@@ -40,14 +56,21 @@ export class MCPClient {
       }
 
       case 'stdio': {
-        this.transport = new StdioClientTransport({
+        this.isStdio = true;
+        const stdioTransport = new StdioClientTransport({
           args: params.args,
           command: params.command,
           env: {
             ...getDefaultEnvironment(),
             ...params.env,
           },
+          stderr: 'pipe', // Capture stderr for better error messages
         });
+
+        // Listen to stderr stream to collect logs
+        this.setupStderrListener(stdioTransport);
+
+        this.transport = stdioTransport;
         break;
       }
 
@@ -60,16 +83,45 @@ export class MCPClient {
     }
   }
 
+  private setupStderrListener(transport: StdioClientTransport) {
+    const stderr = transport.stderr as Readable | null;
+    if (stderr) {
+      stderr.on('data', (chunk: Buffer) => {
+        const text = chunk.toString('utf8');
+        // Split by newlines and filter empty lines
+        const lines = text.split('\n').filter((line) => line.trim());
+        this.stderrLogs.push(...lines);
+      });
+    }
+  }
+
+  /**
+   * Get collected stderr logs from the STDIO process
+   */
+  getStderrLogs(): string[] {
+    return this.stderrLogs;
+  }
+
   private isMethodNotFoundError(error: unknown) {
     const err = error as any;
     if (!err) return false;
+    // eslint-disable-next-line unicorn/numeric-separators-style
     if (err.code === -32601) return true;
     if (typeof err.message === 'string' && err.message.includes('Method not found')) return true;
     return false;
   }
 
   async initialize(options: { onProgress?: (progress: Progress) => void } = {}) {
-    await this.mcp.connect(this.transport, { onprogress: options.onProgress });
+    try {
+      await this.mcp.connect(this.transport, { onprogress: options.onProgress });
+    } catch (error) {
+      // If this is a STDIO connection and we have stderr logs, enhance the error
+      if (this.isStdio && this.stderrLogs.length > 0) {
+        const originalMessage = error instanceof Error ? error.message : String(error);
+        throw new MCPConnectionError(originalMessage, this.stderrLogs);
+      }
+      throw error;
+    }
   }
 
   async disconnect() {

package/changelog/v1.json

@@ -1,4 +1,14 @@
 [
+  {
+    "children": {},
+    "date": "2026-01-15",
+    "version": "2.0.0-next.294"
+  },
+  {
+    "children": {},
+    "date": "2026-01-15",
+    "version": "2.0.0-next.293"
+  },
   {
     "children": {
       "improvements": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.292",
+  "version": "2.0.0-next.294",
   "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/const/src/cacheControl.ts

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

package/src/app/(backend)/api/desktop/latest/route.ts

@@ -0,0 +1,115 @@
+import debug from 'debug';
+import { NextResponse } from 'next/server';
+import { z } from 'zod';
+
+import { zodValidator } from '@/app/(backend)/middleware/validate';
+import {
+  type DesktopDownloadType,
+  getLatestDesktopReleaseFromGithub,
+  getStableDesktopReleaseInfoFromUpdateServer,
+  resolveDesktopDownload,
+  resolveDesktopDownloadFromUrls,
+} from '@/server/services/desktopRelease';
+
+const log = debug('api-route:desktop:latest');
+
+const SupportedTypes = ['mac-arm', 'mac-intel', 'windows', 'linux'] as const;
+
+const truthyStringToBoolean = z.preprocess((value) => {
+  if (!value) return undefined;
+  if (typeof value === 'boolean') return value;
+  if (typeof value !== 'string') return undefined;
+
+  const v = value.trim().toLowerCase();
+  if (!v) return undefined;
+
+  return v === '1' || v === 'true' || v === 'yes' || v === 'y';
+}, z.boolean());
+
+const downloadTypeSchema = z.preprocess((value) => {
+  if (typeof value !== 'string') return value;
+  return value;
+}, z.enum(SupportedTypes));
+
+const querySchema = z
+  .object({
+    asJson: truthyStringToBoolean.optional(),
+    as_json: truthyStringToBoolean.optional(),
+    type: downloadTypeSchema.optional(),
+  })
+  .strip()
+  .transform((value) => ({
+    asJson: value.as_json ?? value.asJson ?? false,
+    type: value.type,
+  }))
+  .superRefine((value, ctx) => {
+    if (!value.asJson && !value.type) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: '`type` is required when `as_json` is false',
+        path: ['type'],
+      });
+    }
+  });
+
+export const GET = zodValidator(querySchema)(async (req, _context, query) => {
+  try {
+    const { asJson, type } = query;
+
+    const stableInfo = await getStableDesktopReleaseInfoFromUpdateServer();
+
+    if (!type) {
+      if (stableInfo) {
+        return NextResponse.json({
+          links: {
+            'linux': resolveDesktopDownloadFromUrls({ ...stableInfo, type: 'linux' }),
+            'mac-arm': resolveDesktopDownloadFromUrls({ ...stableInfo, type: 'mac-arm' }),
+            'mac-intel': resolveDesktopDownloadFromUrls({ ...stableInfo, type: 'mac-intel' }),
+            'windows': resolveDesktopDownloadFromUrls({ ...stableInfo, type: 'windows' }),
+          },
+          tag: stableInfo.tag,
+          version: stableInfo.version,
+        });
+      }
+
+      const release = await getLatestDesktopReleaseFromGithub();
+      const resolveOne = (t: DesktopDownloadType) => resolveDesktopDownload(release, t);
+
+      return NextResponse.json({
+        links: {
+          'linux': resolveOne('linux'),
+          'mac-arm': resolveOne('mac-arm'),
+          'mac-intel': resolveOne('mac-intel'),
+          'windows': resolveOne('windows'),
+        },
+        tag: release.tag_name,
+        version: release.tag_name.replace(/^v/i, ''),
+      });
+    }
+
+    const s3Resolved = stableInfo ? resolveDesktopDownloadFromUrls({ ...stableInfo, type }) : null;
+    if (s3Resolved) {
+      if (asJson) return NextResponse.json(s3Resolved);
+      return NextResponse.redirect(s3Resolved.url, { status: 302 });
+    }
+
+    const release = await getLatestDesktopReleaseFromGithub();
+    const resolved = resolveDesktopDownload(release, type);
+    if (!resolved) {
+      return NextResponse.json(
+        { error: 'No matched asset for type', supportedTypes: SupportedTypes, type },
+        { status: 404 },
+      );
+    }
+
+    if (asJson) return NextResponse.json(resolved);
+
+    return NextResponse.redirect(resolved.url, { status: 302 });
+  } catch (e) {
+    log('Failed to resolve latest desktop download: %O', e);
+    return NextResponse.json(
+      { error: 'Failed to resolve latest desktop download' },
+      { status: 500 },
+    );
+  }
+});

package/src/app/(backend)/middleware/validate/createValidator.test.ts

@@ -0,0 +1,61 @@
+import { NextRequest } from 'next/server';
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+
+import { createValidator } from './createValidator';
+
+describe('createValidator', () => {
+  it('should validate query for GET and pass parsed data to handler', async () => {
+    const validate = createValidator({
+      errorStatus: 422,
+      stopOnFirstError: true,
+      omitNotShapeField: true,
+    });
+    const schema = z.object({ type: z.enum(['a', 'b']) });
+
+    const handler = validate(schema)(async (_req: Request, _ctx: unknown, data: any) => {
+      return new Response(JSON.stringify({ ok: true, data }), { status: 200 });
+    });
+
+    const res = await handler(new NextRequest('https://example.com/api?type=a'));
+    expect(res.status).toBe(200);
+    expect(await res.json()).toEqual({ ok: true, data: { type: 'a' } });
+  });
+
+  it('should return 422 with one issue when stopOnFirstError', async () => {
+    const validate = createValidator({
+      errorStatus: 422,
+      stopOnFirstError: true,
+      omitNotShapeField: true,
+    });
+    const schema = z.object({
+      foo: z.string().min(2),
+      type: z.enum(['a', 'b']),
+    });
+
+    const handler = validate(schema)(async () => new Response('ok'));
+    const res = await handler(new NextRequest('https://example.com/api?foo=x&type=c'));
+    expect(res.status).toBe(422);
+    const body = await res.json();
+    expect(body.error).toBe('Invalid request');
+    expect(Array.isArray(body.issues)).toBe(true);
+    expect(body.issues).toHaveLength(1);
+  });
+
+  it('should omit unknown fields when omitNotShapeField enabled', async () => {
+    const validate = createValidator({
+      errorStatus: 422,
+      stopOnFirstError: true,
+      omitNotShapeField: true,
+    });
+    const schema = z.object({ type: z.enum(['a', 'b']) });
+
+    const handler = validate(schema)(async (_req: Request, _ctx: unknown, data: any) => {
+      return new Response(JSON.stringify(data), { status: 200 });
+    });
+
+    const res = await handler(new NextRequest('https://example.com/api?type=a&extra=1'));
+    expect(res.status).toBe(200);
+    expect(await res.json()).toEqual({ type: 'a' });
+  });
+});