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

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/app/[variants]/desktopRouter.config.tsx

@@ -385,6 +385,11 @@ export const createDesktopRouter = (locale: Locales) =>
               element: <KnowledgeHome />,
               index: true,
             },
+            {
+              element: <KnowledgeHome />,
+              loader: idLoader,
+              path: ':id',
+            },
             {
               element: <KnowledgeBasesList />,
               path: 'bases',

package/src/app/[variants]/mobileRouter.config.tsx

@@ -402,6 +402,11 @@ export const createMobileRouter = (locale: Locales) =>
               element: <KnowledgeHome />,
               index: true,
             },
+            {
+              element: <KnowledgeHome />,
+              loader: idLoader,
+              path: ':id',
+            },
             {
               element: <KnowledgeBasesList />,
               path: 'bases',

package/src/features/KnowledgeManager/Home/index.tsx

@@ -104,7 +104,7 @@ const Home = memo<HomeProps>(({ knowledgeBaseId, onOpenFile }) => {
   const handleDocumentClick = (documentId: string) => {
     // Navigate to the document in the explorer
     // The KnowledgeHomePage will automatically set category to 'documents' when it detects the id param
-    navigate(`/${documentId}`);
+    navigate(`/knowledge/${documentId}`);
   };
 
   return (

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/server/globalConfig/genServerAiProviderConfig.ts

@@ -18,7 +18,7 @@ export const genServerAiProvidersConfig = async (
 ) => {
   const llmConfig = getLLMConfig() as Record<string, any>;
 
-  // 并发处理所有 providers
+  // Process all providers concurrently
   const providerConfigs = await Promise.all(
     Object.values(ModelProvider).map(async (provider) => {
       const providerUpperCase = provider.toUpperCase();
@@ -33,7 +33,7 @@ export const genServerAiProvidersConfig = async (
       const modelString =
         process.env[providerConfig.modelListKey ?? `${providerUpperCase}_MODEL_LIST`];
 
-      // 并发处理 extractEnabledModels 和 transformToAiModelList
+      // Process extractEnabledModels and transformToAiModelList concurrently
       const [enabledModels, serverModelLists] = await Promise.all([
         extractEnabledModels(provider, modelString, providerConfig.withDeploymentName || false),
         transformToAiModelList({
@@ -61,7 +61,7 @@ export const genServerAiProvidersConfig = async (
     }),
   );
 
-  // 将结果转换为对象
+  // Convert the results to an object
   const config = {} as Record<string, ProviderConfig>;
   for (const { provider, config: providerConfig } of providerConfigs) {
     config[provider] = providerConfig;

package/src/server/globalConfig/parseFilesConfig.ts

@@ -12,7 +12,7 @@ export const parseFilesConfig = (envString: string = ''): SystemEmbeddingConfig
   if (!envString) return DEFAULT_FILES_CONFIG;
   const config: FilesConfig = {} as any;
 
-  // 处理全角逗号和多余空格
+  // Handle full-width commas and extra spaces
   let envValue = envString.replaceAll('，', ',').trim();
 
   const pairs = envValue.split(',');

package/src/server/globalConfig/parseSystemAgent.ts

@@ -10,12 +10,12 @@ export const parseSystemAgent = (envString: string = ''): Partial<UserSystemAgen
 
   const config: Partial<UserSystemAgentConfig> = {};
 
-  // 处理全角逗号和多余空格
+  // Handle full-width commas and extra spaces
   let envValue = envString.replaceAll('，', ',').trim();
 
   const pairs = envValue.split(',');
 
-  // 用于存储默认设置，如果有 default=provider/model 的情况
+  // Store default settings if there is a default=provider/model case
   let defaultSetting: { model: string; provider: string } | undefined;
 
   for (const pair of pairs) {
@@ -29,7 +29,7 @@ export const parseSystemAgent = (envString: string = ''): Partial<UserSystemAgen
         throw new Error('Missing model or provider value');
       }
 
-      // 如果是 default 键，保存默认设置
+      // If it's the default key, save the default settings
       if (key === 'default') {
         defaultSetting = {
           model: model.trim(),
@@ -50,7 +50,7 @@ export const parseSystemAgent = (envString: string = ''): Partial<UserSystemAgen
     }
   }
 
-  // 如果有默认设置，应用到所有未设置的系统智能体
+  // If there are default settings, apply them to all unconfigured system agents
   if (defaultSetting) {
     for (const key of protectedKeys) {
       if (!config[key as keyof UserSystemAgentConfig]) {

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,
+);