@lobehub/lobehub 2.0.0-next.107 → 2.0.0-next.108

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 2.0.0-next.108](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.107...v2.0.0-next.108)
+
+<sup>Released on **2025-11-24**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Fixed the pinned session not work.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Fixed the pinned session not work, closes [#10323](https://github.com/lobehub/lobe-chat/issues/10323) ([224f999](https://github.com/lobehub/lobe-chat/commit/224f999))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.107](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.106...v2.0.0-next.107)
 
 <sup>Released on **2025-11-23**</sup>

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Fixed the pinned session not work."
+      ]
+    },
+    "date": "2025-11-24",
+    "version": "2.0.0-next.108"
+  },
   {
     "children": {
       "improvements": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.107",
+  "version": "2.0.0-next.108",
   "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/model-bank/src/aiModels/cometapi.ts

@@ -1,8 +1,8 @@
 import { AIChatModelCard } from '../types/aiModel';
 
-// 以 src/config/modelProviders/cometapi.ts 为准的 CometAPI 模型清单
+// CometAPI model list based on src/config/modelProviders/cometapi.ts
 const cometapiChatModels: AIChatModelCard[] = [
-  // GPT-5 系列
+  // GPT-5 series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 400_000,
@@ -46,7 +46,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // GPT-4.1 / 4o 系列
+  // GPT-4.1 / 4o series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 1_047_576,
@@ -103,7 +103,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // OpenAI o 系列
+  // OpenAI o series
   {
     abilities: { vision: true },
     contextWindowTokens: 200_000,
@@ -141,7 +141,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // Anthropic Claude 系列
+  // Anthropic Claude series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 200_000,
@@ -212,7 +212,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // Google Gemini 系列
+  // Google Gemini series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 1_114_112,
@@ -259,7 +259,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // xAI Grok 系列
+  // xAI Grok series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 131_072,
@@ -291,7 +291,7 @@ const cometapiChatModels: AIChatModelCard[] = [
     type: 'chat',
   },
 
-  // DeepSeek 系列
+  // DeepSeek series
   {
     abilities: { functionCall: true, vision: true },
     contextWindowTokens: 128_000,

package/packages/model-bank/src/aiModels/fal.ts

@@ -20,8 +20,8 @@ export const fluxKreaParamsSchema: ModelParamsSchema = {
 
 export const qwenImageParamsSchema: ModelParamsSchema = {
   cfg: { default: 2.5, max: 20, min: 0, step: 0.1 },
-  // 实测 fal 宽高 最大就支持到 1536
-  // 默认值取自 https://chat.qwen.ai/ 官网的默认值
+  // Tested: fal width/height max support up to 1536
+  // Default values from https://chat.qwen.ai/ official website
   height: { default: 1328, max: 1536, min: 512, step: 1 },
   prompt: { default: '' },
   seed: { default: null },

package/packages/model-bank/src/aiModels/nebius.ts

@@ -644,7 +644,7 @@ const nebiusChatModels: AIChatModelCard[] = [
   },
 ];
 
-// 下述模型待验证
+// Models below are pending verification
 
 // export const nebiusImageModels: AIImageModelCard[] = [
 //   {

package/packages/model-bank/src/aiModels/newapi.ts

@@ -1,9 +1,9 @@
 import { AIChatModelCard } from '../types/aiModel';
 
-// NewAPI Router Provider - 聚合多个 AI 服务
-// 模型通过动态获取，不预定义具体模型
+// NewAPI Router Provider - Aggregates multiple AI services
+// Models are fetched dynamically, not predefined
 const newapiChatModels: AIChatModelCard[] = [
-  // NewAPI 作为路由提供商，模型列表通过 API 动态获取
+  // NewAPI as router provider, model list fetched dynamically via API
 ];
 
 export const allModels = [...newapiChatModels];

package/packages/model-bank/src/aiModels/openai.ts

@@ -1074,7 +1074,7 @@ export const openaiEmbeddingModels: AIEmbeddingModelCard[] = [
   },
 ];
 
-// 语音合成模型
+// Text-to-speech models
 export const openaiTTSModels: AITTSModelCard[] = [
   {
     description: '最新的文本转语音模型，针对实时场景优化速度',
@@ -1109,7 +1109,7 @@ export const openaiTTSModels: AITTSModelCard[] = [
   },
 ];
 
-// 语音识别模型
+// Speech recognition models
 export const openaiSTTModels: AISTTModelCard[] = [
   {
     description: '通用语音识别模型，支持多语言语音识别、语音翻译和语言识别。',
@@ -1161,7 +1161,7 @@ export const openaiSTTModels: AISTTModelCard[] = [
   },
 ];
 
-// 图像生成模型
+// Image generation models
 export const openaiImageModels: AIImageModelCard[] = [
   // https://platform.openai.com/docs/models/gpt-image-1
   {
@@ -1276,7 +1276,7 @@ export const openaiImageModels: AIImageModelCard[] = [
   },
 ];
 
-// GPT-4o 和 GPT-4o-mini 实时模型
+// GPT-4o and GPT-4o-mini realtime models
 export const openaiRealtimeModels: AIRealtimeModelCard[] = [
   {
     abilities: {

package/packages/model-bank/src/aiModels/qwen.ts

@@ -310,7 +310,7 @@ const qwenChatModels: AIChatModelCard[] = [
       functionCall: true,
     },
     config: {
-      deploymentName: 'qwen3-coder-plus', // 支持上下文缓存
+      deploymentName: 'qwen3-coder-plus', // Supports context caching
     },
     contextWindowTokens: 1_000_000,
     description:
@@ -373,7 +373,7 @@ const qwenChatModels: AIChatModelCard[] = [
       functionCall: true,
     },
     config: {
-      deploymentName: 'qwen3-coder-flash', // 支持上下文缓存
+      deploymentName: 'qwen3-coder-flash', // Supports context caching
     },
     contextWindowTokens: 1_000_000,
     description:
@@ -1052,7 +1052,7 @@ const qwenChatModels: AIChatModelCard[] = [
       search: true,
     },
     config: {
-      deploymentName: 'qwen3-max', // 其支持上下文缓存
+      deploymentName: 'qwen3-max', // Supports context caching
     },
     contextWindowTokens: 262_144,
     description:
@@ -1119,7 +1119,7 @@ const qwenChatModels: AIChatModelCard[] = [
       search: true,
     },
     config: {
-      deploymentName: 'qwen3-max-preview', // 其支持上下文缓存
+      deploymentName: 'qwen3-max-preview', // Supports context caching
     },
     contextWindowTokens: 262_144,
     description: '通义千问系列效果最好的模型，适合复杂、多步骤的任务。预览版已支持思考。',

package/packages/model-bank/src/aiModels/stepfun.ts

@@ -31,7 +31,7 @@ const stepfunChatModels: AIChatModelCard[] = [
           strategy: 'tiered',
           tiers: [
             { rate: 4, upTo: 0.004 },
-            { rate: 8, upTo: 'infinity' }, // 仍与文档有出入
+            { rate: 8, upTo: 'infinity' }, // Still differs from documentation
           ],
           unit: 'millionTokens',
         },

package/packages/model-bank/src/aiModels/vercelaigateway.ts

@@ -1,6 +1,6 @@
 import { AIChatModelCard, AIEmbeddingModelCard } from '../types/aiModel';
 
-// 根据 Vercel AI Gateway 提供的模型列表，按 SOTA、大模型、小模型排序
+// Model list provided by Vercel AI Gateway, sorted by SOTA, large models, small models
 const vercelAIGatewayChatModels: AIChatModelCard[] = [
   {
     abilities: {

package/packages/model-bank/src/aiModels/volcengine.ts

@@ -790,7 +790,7 @@ const doubaoChatModels: AIChatModelCard[] = [
 const volcengineImageModels: AIImageModelCard[] = [
   {
     /*
-    // TODO: AIImageModelCard 不支持 config.deploymentName
+    // TODO: AIImageModelCard does not support config.deploymentName
     config: {
       deploymentName: 'doubao-seedream-3-0-t2i-250415',
     },
@@ -824,7 +824,7 @@ const volcengineImageModels: AIImageModelCard[] = [
   },
   {
     /*
-    // TODO: AIImageModelCard 不支持 config.deploymentName
+    // TODO: AIImageModelCard does not support config.deploymentName
     config: {
       deploymentName: 'doubao-seedream-3-0-t2i-250415',
     },
@@ -857,7 +857,7 @@ const volcengineImageModels: AIImageModelCard[] = [
     releasedAt: '2025-04-15',
     type: 'image',
   },
-  // Note: Doubao 图生图模型与文生图模型公用一个 Endpoint，当前如果存在 imageUrl 会切换至 edit endpoint 下
+  // Note: Doubao image-to-image and text-to-image models share the same Endpoint, currently switches to edit endpoint if imageUrl exists
   {
     // config: {
     //   deploymentName: 'doubao-seededit-3-0-i2i-250628',

package/packages/model-bank/src/aiModels/zhipu.ts

@@ -680,7 +680,7 @@ const zhipuChatModels: AIChatModelCard[] = [
     contextWindowTokens: 131_072,
     description: 'GLM-4-0520 是最新模型版本，专为高度复杂和多样化任务设计，表现卓越。',
     displayName: 'GLM-4-0520',
-    id: 'glm-4-0520', // 弃用时间 2025年12月30日
+    id: 'glm-4-0520', // Deprecation date: December 30, 2025
     pricing: {
       currency: 'CNY',
       units: [

package/packages/model-bank/src/types/aiModel.ts

@@ -70,34 +70,34 @@ const AiModelAbilitiesSchema = z.object({
   vision: z.boolean().optional(),
 });
 
-// 语言模型的设置参数
+// Language model configuration parameters
 export interface LLMParams {
   /**
-   * 控制生成文本中的惩罚系数，用于减少重复性
+   * Controls the penalty coefficient in generated text to reduce repetition
    * @default 0
    */
   frequency_penalty?: number;
   /**
-   * 生成文本的最大长度
+   * Maximum length of generated text
    */
   max_tokens?: number;
   /**
-   * 控制生成文本中的惩罚系数，用于减少主题的变化
+   * Controls the penalty coefficient in generated text to reduce topic variation
    * @default 0
    */
   presence_penalty?: number;
   /**
-   * 生成文本的随机度量，用于控制文本的创造性和多样性
+   * Random measure for generated text to control creativity and diversity
    * @default 1
    */
   reasoning_effort?: string;
   /**
-   * 生成文本的随机度量，用于控制文本的创造性和多样性
+   * Random measure for generated text to control creativity and diversity
    * @default 1
    */
   temperature?: number;
   /**
-   * 控制生成文本中最高概率的单个 token
+   * Controls the single token with highest probability in generated text
    * @default 1
    */
   top_p?: number;
@@ -248,7 +248,7 @@ export type ExtendParamsType =
 export interface AiModelSettings {
   extendParams?: ExtendParamsType[];
   /**
-   * 模型层实现搜索的方式
+   * How the model layer implements search
    */
   searchImpl?: ModelSearchImplementType;
   searchProvider?: string;

package/src/app/[variants]/(main)/layouts/desktop/SideBar/TopActions.tsx

@@ -2,11 +2,12 @@ import { ActionIcon, ActionIconProps, Hotkey } from '@lobehub/ui';
 import { Compass, FolderClosed, MessageSquare, Palette } from 'lucide-react';
 import { memo, useMemo, useTransition } from 'react';
 import { useTranslation } from 'react-i18next';
-import { useNavigate } from 'react-router-dom';
 import { Flexbox } from 'react-layout-kit';
+import { useNavigate } from 'react-router-dom';
 
 import { INBOX_SESSION_ID } from '@/const/session';
 import { SESSION_CHAT_URL } from '@/const/url';
+import { usePinnedAgentState } from '@/hooks/usePinnedAgentState';
 import { useGlobalStore } from '@/store/global';
 import { SidebarTabKey } from '@/store/global/initialState';
 import { featureFlagsSelectors, useServerConfigStore } from '@/store/serverConfig';
@@ -31,11 +32,8 @@ const TopActions = memo<TopActionProps>(({ tab, isPinned }) => {
   const { t } = useTranslation('common');
   const navigate = useNavigate();
   const [, startTransition] = useTransition();
-
-  const [switchBackToChat, isMobile] = useGlobalStore((s) => [
-    s.switchBackToChat,
-    s.isMobile,
-  ]);
+  const [, { unpinAgent }] = usePinnedAgentState();
+  const [switchBackToChat, isMobile] = useGlobalStore((s) => [s.switchBackToChat, s.isMobile]);
   const { showMarket, enableKnowledgeBase, showAiImage } =
     useServerConfigStore(featureFlagsSelectors);
   const hotkey = useUserStore(settingsSelectors.getHotkeyById(HotkeyEnum.NavigateToChat));
@@ -69,6 +67,7 @@ const TopActions = memo<TopActionProps>(({ tab, isPinned }) => {
           e.preventDefault();
           startTransition(() => {
             switchBackToChat(activeSessionId);
+            unpinAgent();
           });
         }}
         size={ICON_SIZE}

package/src/hooks/usePinnedAgentState.ts

@@ -1,21 +1,28 @@
-import { useMemo } from 'react';
+'use client';
 
-import { parseAsBoolean, useQueryParam } from './useQueryParam';
+import { useSessionStore } from '@/store/session';
+import { useUrlHydrationStore } from '@/store/urlHydration';
 
 export const usePinnedAgentState = () => {
-  const [isPinned, setIsPinned] = useQueryParam('pinned', parseAsBoolean.withDefault(false), {
-    clearOnDefault: true,
-  });
+  const isPinned = useSessionStore((s) => s.isAgentPinned);
+  const setAgentPinned = useSessionStore((s) => s.setAgentPinned);
+  const toggleAgentPinned = useSessionStore((s) => s.toggleAgentPinned);
+  const syncToUrl = useUrlHydrationStore((s) => s.syncAgentPinnedToUrl);
 
-  const actions = useMemo(
-    () => ({
-      pinAgent: () => setIsPinned(true),
-      setIsPinned,
-      togglePinAgent: () => setIsPinned((prev) => !prev),
-      unpinAgent: () => setIsPinned(false),
-    }),
-    [setIsPinned],
-  );
+  const withSync = <T extends (...args: any[]) => void>(fn: T) => {
+    return (...args: Parameters<T>) => {
+      fn(...args);
+      syncToUrl();
+    };
+  };
 
-  return [isPinned, actions] as const;
+  return [
+    isPinned,
+    {
+      pinAgent: withSync(() => setAgentPinned(true)),
+      setIsPinned: withSync(setAgentPinned),
+      togglePinAgent: withSync(toggleAgentPinned),
+      unpinAgent: withSync(() => setAgentPinned(false)),
+    },
+  ] as const;
 };

package/src/layout/GlobalProvider/StoreInitialization.tsx

@@ -12,6 +12,7 @@ import { useAiInfraStore } from '@/store/aiInfra';
 import { useGlobalStore } from '@/store/global';
 import { useServerConfigStore } from '@/store/serverConfig';
 import { serverConfigSelectors } from '@/store/serverConfig/selectors';
+import { useUrlHydrationStore } from '@/store/urlHydration';
 import { useUserStore } from '@/store/user';
 import { authSelectors } from '@/store/user/selectors';
 
@@ -19,6 +20,10 @@ const StoreInitialization = memo(() => {
   // prefetch error ns to avoid don't show error content correctly
   useTranslation('error');
 
+  // Initialize from URL (one-time)
+  const initAgentPinnedFromUrl = useUrlHydrationStore((s) => s.initAgentPinnedFromUrl);
+  initAgentPinnedFromUrl();
+
   const router = useRouter();
   const [isLogin, isSignedIn, useInitUserState] = useUserStore((s) => [
     authSelectors.isLogin(s),

package/src/store/session/slices/session/action.ts

@@ -76,6 +76,15 @@ export interface SessionAction {
    */
   removeSession: (id: string) => Promise<void>;
 
+  /**
+   * Set the agent panel pinned state
+   */
+  setAgentPinned: (pinned: boolean | ((prev: boolean) => boolean)) => void;
+  /**
+   * Toggle the agent panel pinned state
+   */
+  toggleAgentPinned: () => void;
+
   updateSearchKeywords: (keywords: string) => void;
 
   useFetchSessions: (
@@ -187,12 +196,26 @@ export const createSessionSlice: StateCreator<
     }
   },
 
+  setAgentPinned: (value) => {
+    set(
+      (state) => ({
+        isAgentPinned: typeof value === 'function' ? value(state.isAgentPinned) : value,
+      }),
+      false,
+      n('setAgentPinned'),
+    );
+  },
+
   switchSession: (sessionId) => {
     if (get().activeId === sessionId) return;
 
     set({ activeId: sessionId }, false, n(`activeSession/${sessionId}`));
   },
 
+  toggleAgentPinned: () => {
+    set((state) => ({ isAgentPinned: !state.isAgentPinned }), false, n('toggleAgentPinned'));
+  },
+
   triggerSessionUpdate: async (id) => {
     await get().internal_updateSession(id, { updatedAt: new Date() });
   },

package/src/store/session/slices/session/initialState.ts

@@ -7,6 +7,11 @@ export interface SessionState {
    */
   activeId: string;
   defaultSessions: LobeSessions;
+  /**
+   * @title Whether the agent panel is pinned
+   * @description Controls the agent panel pinning state in the UI layout
+   */
+  isAgentPinned: boolean;
   isSearching: boolean;
   isSessionsFirstFetchFinished: boolean;
   pinnedSessions: LobeSessions;
@@ -22,6 +27,7 @@ export interface SessionState {
 export const initialSessionState: SessionState = {
   activeId: 'inbox',
   defaultSessions: [],
+  isAgentPinned: false,
   isSearching: false,
   isSessionsFirstFetchFinished: false,
   pinnedSessions: [],

package/src/store/urlHydration/action.ts

@@ -0,0 +1,56 @@
+import { StateCreator } from 'zustand/vanilla';
+
+import { useSessionStore } from '@/store/session';
+
+import type { UrlHydrationStore } from './store';
+
+export interface UrlHydrationAction {
+  /**
+   * Initialize store state from URL (one-time on app load)
+   */
+  initAgentPinnedFromUrl: () => void;
+
+  /**
+   * Sync agent pinned state to URL (call after state change)
+   */
+  syncAgentPinnedToUrl: () => void;
+}
+
+export const urlHydrationAction: StateCreator<
+  UrlHydrationStore,
+  [['zustand/devtools', never]],
+  [],
+  UrlHydrationAction
+> = (set, get) => ({
+  initAgentPinnedFromUrl: () => {
+    if (get().isAgentPinnedInitialized) return;
+
+    if (typeof window !== 'undefined') {
+      const params = new URLSearchParams(window.location.search);
+      const pinnedParam = params.get('pinned');
+
+      console.log('pinnedParam', pinnedParam);
+
+      if (pinnedParam === 'true') {
+        useSessionStore.setState({ isAgentPinned: true });
+      }
+
+      set({ isAgentPinnedInitialized: true });
+    }
+  },
+
+  syncAgentPinnedToUrl: () => {
+    if (typeof window === 'undefined') return;
+
+    const isAgentPinned = useSessionStore.getState().isAgentPinned;
+    const url = new URL(window.location.href);
+
+    if (isAgentPinned) {
+      url.searchParams.set('pinned', 'true');
+    } else {
+      url.searchParams.delete('pinned');
+    }
+
+    window.history.replaceState(null, '', `${url.pathname}${url.search}`);
+  },
+});

package/src/store/urlHydration/index.ts

@@ -0,0 +1 @@
+export { type UrlHydrationStore,useUrlHydrationStore } from './store';

package/src/store/urlHydration/initialState.ts

@@ -0,0 +1,12 @@
+/**
+ * URL Hydration Store State
+ *
+ * Tracks initialization status to ensure one-time URL reading.
+ */
+export interface UrlHydrationState {
+  isAgentPinnedInitialized: boolean;
+}
+
+export const initialState: UrlHydrationState = {
+  isAgentPinnedInitialized: false,
+};

package/src/store/urlHydration/store.ts

@@ -0,0 +1,28 @@
+import { subscribeWithSelector } from 'zustand/middleware';
+import { shallow } from 'zustand/shallow';
+import { createWithEqualityFn } from 'zustand/traditional';
+import { StateCreator } from 'zustand/vanilla';
+
+import { createDevtools } from '../middleware/createDevtools';
+import { type UrlHydrationAction, urlHydrationAction } from './action';
+import { type UrlHydrationState, initialState } from './initialState';
+
+//  ===============  聚合 createStoreFn ============ //
+
+export interface UrlHydrationStore extends UrlHydrationState, UrlHydrationAction {}
+
+const createStore: StateCreator<UrlHydrationStore, [['zustand/devtools', never]]> = (
+  ...parameters
+) => ({
+  ...initialState,
+  ...urlHydrationAction(...parameters),
+});
+
+//  ===============  实装 useStore ============ //
+
+const devtools = createDevtools('urlHydration');
+
+export const useUrlHydrationStore = createWithEqualityFn<UrlHydrationStore>()(
+  subscribeWithSelector(devtools(createStore)),
+  shallow,
+);