@lobehub/chat 1.108.1 → 1.109.0

package/.cursor/rules/testing-guide/testing-guide.mdc

@@ -430,6 +430,22 @@ expect(result!.status).toBe('success');
 // ✅ 使用 any 类型简化复杂的 Mock 设置
 const mockStream = new ReadableStream() as any;
 mockStream.toReadableStream = () => mockStream;
+
+// ✅ 使用中括号访问私有属性和方法（推荐）
+class MyClass {
+  private _cache = new Map();
+  private getFromCache(key: string) { /* ... */ }
+}
+
+const instance = new MyClass();
+
+// 推荐：使用中括号访问私有成员
+await instance['getFromCache']('test-key');
+expect(instance['_cache'].size).toBe(1);
+
+// 避免：使用 as any 访问私有成员
+await (instance as any).getFromCache('test-key');  // ❌ 不推荐
+expect((instance as any)._cache.size).toBe(1);     // ❌ 不推荐
 ```
 
 #### 🎯 适用场景
@@ -437,11 +453,13 @@ mockStream.toReadableStream = () => mockStream;
 - **Mock 对象**: 对于测试用的 Mock 数据，使用 `as any` 避免复杂的类型定义
 - **第三方库**: 处理复杂的第三方库类型时，适当使用 `any` 提高效率
 - **测试断言**: 在确定对象存在的测试场景中，使用 `!` 非空断言
+- **私有成员访问**: 优先使用中括号 `instance['privateMethod']()` 而不是 `(instance as any).privateMethod()`
 - **临时调试**: 快速编写测试时，先用 `any` 保证功能，后续可选择性地优化类型
 
 #### ⚠️ 注意事项
 
 - **适度使用**: 不要过度依赖 `any`，核心业务逻辑的类型仍应保持严格
+- **私有成员访问优先级**: 中括号访问 > `as any` 转换，保持更好的类型安全性
 - **文档说明**: 对于使用 `any` 的复杂场景，添加注释说明原因
 - **测试覆盖**: 确保即使使用了 `any`，测试仍能有效验证功能正确性
 

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 1.109.0](https://github.com/lobehub/lobe-chat/compare/v1.108.2...v1.109.0)
+
+<sup>Released on **2025-08-05**</sup>
+
+#### ✨ Features
+
+- **misc**: Support gpt-oss in ollama provider.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Support gpt-oss in ollama provider, closes [#8682](https://github.com/lobehub/lobe-chat/issues/8682) ([6e0c386](https://github.com/lobehub/lobe-chat/commit/6e0c386))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+### [Version 1.108.2](https://github.com/lobehub/lobe-chat/compare/v1.108.1...v1.108.2)
+
+<sup>Released on **2025-08-05**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Provider config checker uses outdated API key.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Provider config checker uses outdated API key, closes [#8666](https://github.com/lobehub/lobe-chat/issues/8666) ([3a3e73e](https://github.com/lobehub/lobe-chat/commit/3a3e73e))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.108.1](https://github.com/lobehub/lobe-chat/compare/v1.108.0...v1.108.1)
 
 <sup>Released on **2025-08-05**</sup>

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "features": [
+        "Support gpt-oss in ollama provider."
+      ]
+    },
+    "date": "2025-08-05",
+    "version": "1.109.0"
+  },
+  {
+    "children": {
+      "fixes": [
+        "Provider config checker uses outdated API key."
+      ]
+    },
+    "date": "2025-08-05",
+    "version": "1.108.2"
+  },
   {
     "children": {
       "fixes": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.108.1",
+  "version": "1.109.0",
   "description": "Lobe Chat - an open-source, high-performance chatbot 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",
@@ -146,7 +146,7 @@
     "@lobechat/electron-server-ipc": "workspace:*",
     "@lobechat/file-loaders": "workspace:*",
     "@lobechat/web-crawler": "workspace:*",
-    "@lobehub/analytics": "^1.5.1",
+    "@lobehub/analytics": "^1.6.0",
     "@lobehub/charts": "^2.0.0",
     "@lobehub/chat-plugin-sdk": "^1.32.4",
     "@lobehub/chat-plugins-gateway": "^1.9.0",

package/src/app/[variants]/(main)/settings/provider/features/ProviderConfig/Checker.tsx

@@ -46,11 +46,13 @@ export type CheckErrorRender = (props: {
 interface ConnectionCheckerProps {
   checkErrorRender?: CheckErrorRender;
   model: string;
+  onAfterCheck: () => Promise<void>;
+  onBeforeCheck: () => Promise<void>;
   provider: string;
 }
 
 const Checker = memo<ConnectionCheckerProps>(
-  ({ model, provider, checkErrorRender: CheckErrorRender }) => {
+  ({ model, provider, checkErrorRender: CheckErrorRender, onBeforeCheck, onAfterCheck }) => {
     const { t } = useTranslation('setting');
 
     const isProviderConfigUpdating = useAiInfraStore(
@@ -152,7 +154,18 @@ const Checker = memo<ConnectionCheckerProps>(
             value={checkModel}
             virtual
           />
-          <Button disabled={isProviderConfigUpdating} loading={loading} onClick={checkConnection}>
+          <Button
+            disabled={isProviderConfigUpdating}
+            loading={loading}
+            onClick={async () => {
+              await onBeforeCheck();
+              try {
+                await checkConnection();
+              } finally {
+                await onAfterCheck();
+              }
+            }}
+          >
             {t('llm.checker.button')}
           </Button>
         </Flexbox>

package/src/app/[variants]/(main)/settings/provider/features/ProviderConfig/index.tsx

@@ -14,7 +14,7 @@ import { Skeleton, Switch } from 'antd';
 import { createStyles } from 'antd-style';
 import { Loader2Icon, LockIcon } from 'lucide-react';
 import Link from 'next/link';
-import { ReactNode, memo, useLayoutEffect } from 'react';
+import { ReactNode, memo, useCallback, useLayoutEffect, useRef } from 'react';
 import { Trans, useTranslation } from 'react-i18next';
 import { Center, Flexbox } from 'react-layout-kit';
 import urlJoin from 'url-join';
@@ -173,7 +173,24 @@ const ProviderConfig = memo<ProviderConfigProps>(
       form.setFieldsValue(data);
     }, [isLoading, id, data]);
 
-    const { run: debouncedUpdate } = useDebounceFn(updateAiProviderConfig, { wait: 500 });
+    // 标记是否正在进行连接测试
+    const isCheckingConnection = useRef(false);
+
+    const handleValueChange = useCallback(
+      (...params: Parameters<typeof updateAiProviderConfig>) => {
+        // 虽然 debouncedHandleValueChange 早于 onBeforeCheck 执行，
+        // 但是由于 debouncedHandleValueChange 因为 debounce 的原因，本来就会晚 500ms 执行
+        // 所以 isCheckingConnection.current 这时候已经更新了
+        // 测试链接时已经出发一次了 updateAiProviderConfig ， 不应该重复更新
+        if (isCheckingConnection.current) return;
+
+        updateAiProviderConfig(...params);
+      },
+      [updateAiProviderConfig],
+    );
+    const { run: debouncedHandleValueChange } = useDebounceFn(handleValueChange, {
+      wait: 500,
+    });
 
     const isCustom = source === AiProviderSourceEnum.Custom;
 
@@ -318,6 +335,16 @@ const ProviderConfig = memo<ProviderConfigProps>(
               <Checker
                 checkErrorRender={checkErrorRender}
                 model={data?.checkModel || checkModel!}
+                onAfterCheck={async () => {
+                  // 重置连接测试状态，允许后续的 onValuesChange 更新
+                  isCheckingConnection.current = false;
+                }}
+                onBeforeCheck={async () => {
+                  // 设置连接测试状态，阻止 onValuesChange 的重复请求
+                  isCheckingConnection.current = true;
+                  // 主动保存表单最新值，确保 fetchAiProviderRuntimeState 获取最新数据
+                  await updateAiProviderConfig(id, form.getFieldsValue());
+                }}
                 provider={id}
               />
             ),
@@ -389,7 +416,7 @@ const ProviderConfig = memo<ProviderConfigProps>(
         form={form}
         items={[model]}
         onValuesChange={(_, values) => {
-          debouncedUpdate(id, values);
+          debouncedHandleValueChange(id, values);
         }}
         variant={'borderless'}
         {...FORM_STYLE}

package/src/components/Analytics/LobeAnalyticsProvider.tsx

@@ -1,6 +1,10 @@
 'use client';
 
-import { createSingletonAnalytics } from '@lobehub/analytics';
+import {
+  GoogleAnalyticsProviderConfig,
+  PostHogProviderAnalyticsConfig,
+  createSingletonAnalytics,
+} from '@lobehub/analytics';
 import { AnalyticsProvider } from '@lobehub/analytics/react';
 import { ReactNode, memo, useMemo } from 'react';
 
@@ -10,16 +14,14 @@ import { isDev } from '@/utils/env';
 
 type Props = {
   children: ReactNode;
-  debugPosthog: boolean;
-  posthogEnabled: boolean;
-  posthogHost: string;
-  posthogToken: string;
+  ga4Config: GoogleAnalyticsProviderConfig;
+  postHogConfig: PostHogProviderAnalyticsConfig;
 };
 
 let analyticsInstance: ReturnType<typeof createSingletonAnalytics> | null = null;
 
 export const LobeAnalyticsProvider = memo(
-  ({ children, posthogHost, posthogToken, posthogEnabled, debugPosthog }: Props) => {
+  ({ children, ga4Config, postHogConfig }: Props) => {
     const analytics = useMemo(() => {
       if (analyticsInstance) {
         return analyticsInstance;
@@ -29,13 +31,8 @@ export const LobeAnalyticsProvider = memo(
         business: BUSINESS_LINE,
         debug: isDev,
         providers: {
-          posthog: {
-            debug: debugPosthog,
-            enabled: posthogEnabled,
-            host: posthogHost,
-            key: posthogToken,
-            person_profiles: 'always',
-          },
+          ga4: ga4Config,
+          posthog: postHogConfig,
         },
       });
 

package/src/components/Analytics/LobeAnalyticsProviderWrapper.tsx

@@ -2,6 +2,7 @@ import { ReactNode, memo } from 'react';
 
 import { LobeAnalyticsProvider } from '@/components/Analytics/LobeAnalyticsProvider';
 import { analyticsEnv } from '@/config/analytics';
+import { isDev } from '@/utils/env';
 
 type Props = {
   children: ReactNode;
@@ -10,10 +11,21 @@ type Props = {
 export const LobeAnalyticsProviderWrapper = memo<Props>(({ children }) => {
   return (
     <LobeAnalyticsProvider
-      debugPosthog={analyticsEnv.DEBUG_POSTHOG_ANALYTICS}
-      posthogEnabled={analyticsEnv.ENABLED_POSTHOG_ANALYTICS}
-      posthogHost={analyticsEnv.POSTHOG_HOST}
-      posthogToken={analyticsEnv.POSTHOG_KEY ?? ''}
+      ga4Config={{
+        debug: isDev,
+        enabled: analyticsEnv.ENABLE_GOOGLE_ANALYTICS,
+        gtagConfig: {
+          debug_mode: isDev,
+        },
+        measurementId: analyticsEnv.GOOGLE_ANALYTICS_MEASUREMENT_ID ?? '',
+      }}
+      postHogConfig={{
+        debug: analyticsEnv.DEBUG_POSTHOG_ANALYTICS,
+        enabled: analyticsEnv.ENABLED_POSTHOG_ANALYTICS,
+        host: analyticsEnv.POSTHOG_HOST,
+        key: analyticsEnv.POSTHOG_KEY ?? '',
+        person_profiles: 'always',
+      }}
     >
       {children}
     </LobeAnalyticsProvider>

package/src/config/aiModels/ollama.ts

@@ -1,6 +1,33 @@
 import { AIChatModelCard } from '@/types/aiModel';
 
 const ollamaChatModels: AIChatModelCard[] = [
+  {
+    abilities: {
+      functionCall: true,
+      reasoning: true,
+    },
+    contextWindowTokens: 32_768,
+    description:
+      'GPT-OSS 20B 是 OpenAI 发布的开源大语言模型，采用 MXFP4 量化技术，适合在高端消费级GPU或Apple Silicon Mac上运行。该模型在对话生成、代码编写和推理任务方面表现出色，支持函数调用和工具使用。',
+    displayName: 'GPT-OSS 20B',
+    enabled: true,
+    id: 'gpt-oss',
+    releasedAt: '2025-08-05',
+    type: 'chat',
+  },
+  {
+    abilities: {
+      functionCall: true,
+      reasoning: true,
+    },
+    contextWindowTokens: 32_768,
+    description:
+      'GPT-OSS 120B 是 OpenAI 发布的大型开源语言模型，采用 MXFP4 量化技术，为旗舰级模型。需要多GPU或高性能工作站环境运行，在复杂推理、代码生成和多语言处理方面具备卓越性能，支持高级函数调用和工具集成。',
+    displayName: 'GPT-OSS 120B',
+    id: 'gpt-oss:120b',
+    releasedAt: '2025-08-05',
+    type: 'chat',
+  },
   {
     abilities: {
       reasoning: true,