@lobehub/chat 1.91.3 → 1.92.0

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 # Changelog
 
+## [Version 1.92.0](https://github.com/lobehub/lobe-chat/compare/v1.91.3...v1.92.0)
+
+<sup>Released on **2025-06-06**</sup>
+
+#### ✨ Features
+
+- **misc**: Support placeholder variables in prompts and input.
+
+#### 🐛 Bug Fixes
+
+- **misc**: Some web search bugs.
+
+#### 💄 Styles
+
+- **misc**: Support Vertex AI thought summaries.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Support placeholder variables in prompts and input, closes [#8060](https://github.com/lobehub/lobe-chat/issues/8060) ([3752739](https://github.com/lobehub/lobe-chat/commit/3752739))
+
+#### What's fixed
+
+- **misc**: Some web search bugs, closes [#8068](https://github.com/lobehub/lobe-chat/issues/8068) ([bebe7a3](https://github.com/lobehub/lobe-chat/commit/bebe7a3))
+
+#### Styles
+
+- **misc**: Support Vertex AI thought summaries, closes [#8090](https://github.com/lobehub/lobe-chat/issues/8090) ([1355a2e](https://github.com/lobehub/lobe-chat/commit/1355a2e))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.91.3](https://github.com/lobehub/lobe-chat/compare/v1.91.2...v1.91.3)
 
 <sup>Released on **2025-06-05**</sup>

package/changelog/v1.json

@@ -1,4 +1,19 @@
 [
+  {
+    "children": {
+      "features": [
+        "Support placeholder variables in prompts and input."
+      ],
+      "fixes": [
+        "Some web search bugs."
+      ],
+      "improvements": [
+        "Support Vertex AI thought summaries."
+      ]
+    },
+    "date": "2025-06-06",
+    "version": "1.92.0"
+  },
   {
     "children": {
       "fixes": [

package/locales/ar/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "سيتم ملء أحدث رسالة من المستخدم في هذا القالب",
-      "placeholder": "القالب المُعالج مسبقًا {{text}} سيتم استبداله بالمعلومات المُدخلة في الوقت الحقيقي",
+      "placeholder": "القالب المُعالج مسبقًا {{input_template}} سيتم استبداله بالمعلومات المُدخلة في الوقت الحقيقي",
       "title": "معالجة مُدخلات المستخدم"
     },
     "submit": "تحديث تفضيلات الدردشة",

package/locales/bg-BG/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Последното съобщение на потребителя ще бъде попълнено в този шаблон",
-      "placeholder": "Шаблонът за предварителна обработка {{text}} ще бъде заменен с информация за въвеждане в реално време",
+      "placeholder": "Шаблонът за предварителна обработка {{input_template}} ще бъде заменен с информация за въвеждане в реално време",
       "title": "Предварителна обработка на потребителския вход"
     },
     "submit": "Актуализиране на предпочитанията за чат",

package/locales/de-DE/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Die neueste Benutzernachricht wird in dieses Template eingefügt",
-      "placeholder": "Vorlagen-{{text}} werden durch Echtzeit-Eingabeinformationen ersetzt",
+      "placeholder": "Vorlagen-{{input_template}} werden durch Echtzeit-Eingabeinformationen ersetzt",
       "title": "Benutzereingabe-Vorverarbeitung"
     },
     "submit": "Chat-Präferenzen aktualisieren",

package/locales/en-US/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "The user's latest message will be filled into this template",
-      "placeholder": "Preprocessing template {{text}} will be replaced with real-time input information",
+      "placeholder": "Preprocessing template {{input_template}} will be replaced with real-time input information",
       "title": "User Input Preprocessing"
     },
     "submit": "Update Chat Preferences",

package/locales/es-ES/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "El último mensaje del usuario se completará en esta plantilla",
-      "placeholder": "La plantilla de preprocesamiento {{text}} se reemplazará por la información de entrada en tiempo real",
+      "placeholder": "La plantilla de preprocesamiento {{input_template}} se reemplazará por la información de entrada en tiempo real",
       "title": "Preprocesamiento de entrada del usuario"
     },
     "submit": "Actualizar preferencias de chat",

package/locales/fa-IR/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "آخرین پیام کاربر در این قالب پر می‌شود",
-      "placeholder": "قالب پیش‌پردازش {{text}} با اطلاعات ورودی لحظه‌ای جایگزین می‌شود",
+      "placeholder": "قالب پیش‌پردازش {{input_template}} با اطلاعات ورودی لحظه‌ای جایگزین می‌شود",
       "title": "پیش‌پردازش ورودی کاربر"
     },
     "submit": "به‌روزرسانی ترجیحات چت",

package/locales/fr-FR/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Le dernier message de l'utilisateur sera rempli dans ce modèle",
-      "placeholder": "Le modèle de prétraitement {{text}} sera remplacé par les informations d'entrée en temps réel",
+      "placeholder": "Le modèle de prétraitement {{input_template}} sera remplacé par les informations d'entrée en temps réel",
       "title": "Modèle de prétraitement de l'entrée utilisateur"
     },
     "submit": "Mettre à jour les préférences de chat",

package/locales/it-IT/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Il template verrà popolato con l'ultimo messaggio dell'utente",
-      "placeholder": "Il modello di input {{text}} verrà sostituito con le informazioni in tempo reale",
+      "placeholder": "Il modello di input {{input_template}} verrà sostituito con le informazioni in tempo reale",
       "title": "Pre-elaborazione dell'input dell'utente"
     },
     "submit": "Aggiorna preferenze chat",

package/locales/ja-JP/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "ユーザーの最新メッセージがこのテンプレートに埋め込まれます",
-      "placeholder": "入力テンプレート {{text}} はリアルタイムの入力情報に置き換えられます",
+      "placeholder": "入力テンプレート {{input_template}} はリアルタイムの入力情報に置き換えられます",
       "title": "ユーザー入力のプリプロセス"
     },
     "submit": "チャットの好みを更新",

package/locales/ko-KR/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "사용자의 최신 메시지가이 템플릿에 채워집니다",
-      "placeholder": "입력 템플릿 {{text}}은 실시간 입력 정보로 대체됩니다",
+      "placeholder": "입력 템플릿 {{input_template}}은 실시간 입력 정보로 대체됩니다",
       "title": "사용자 입력 전처리"
     },
     "submit": "채팅 선호도 업데이트",

package/locales/nl-NL/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "De meest recente gebruikersboodschap wordt ingevuld in dit sjabloon",
-      "placeholder": "Voorbewerkingssjabloon {{text}} wordt vervangen door realtime invoer",
+      "placeholder": "Voorbewerkingssjabloon {{input_template}} wordt vervangen door realtime invoer",
       "title": "Voorbewerking van gebruikersinvoer"
     },
     "submit": "Chatvoorkeuren bijwerken",

package/locales/pl-PL/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Ostatnia wiadomość użytkownika zostanie wypełniona w tym szablonie",
-      "placeholder": "Szablon wejściowy {{text}} zostanie zastąpiony rzeczywistą wiadomością",
+      "placeholder": "Szablon wejściowy {{input_template}} zostanie zastąpiony rzeczywistą wiadomością",
       "title": "Szablon wejściowy"
     },
     "submit": "Zaktualizuj preferencje czatu",

package/locales/pt-BR/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "A última mensagem do usuário será preenchida neste modelo",
-      "placeholder": "O modelo de pré-processamento {{text}} será substituído pela entrada em tempo real",
+      "placeholder": "O modelo de pré-processamento {{input_template}} será substituído pela entrada em tempo real",
       "title": "Pré-processamento de entrada do usuário"
     },
     "submit": "Atualizar preferências de chat",

package/locales/ru-RU/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Последнее сообщение пользователя будет использовано в этом шаблоне",
-      "placeholder": "Шаблон ввода {{text}} будет заменен на реальные данные",
+      "placeholder": "Шаблон ввода {{input_template}} будет заменен на реальные данные",
       "title": "Шаблон ввода пользователя"
     },
     "submit": "Обновить предпочтения чата",

package/locales/tr-TR/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Kullanıcının son mesajı bu şablona doldurulur",
-      "placeholder": "Ön işleme şablonu {{text}}, gerçek zamanlı giriş bilgileri ile değiştirilir",
+      "placeholder": "Ön işleme şablonu {{input_template}}, gerçek zamanlı giriş bilgileri ile değiştirilir",
       "title": "Kullanıcı Girişi Ön İşleme"
     },
     "submit": "Sohbet tercihlerini güncelle",

package/locales/vi-VN/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "Tin nhắn mới nhất của người dùng sẽ được điền vào mẫu này",
-      "placeholder": "Mẫu xử lý trước {{text}} sẽ được thay thế bằng thông tin nhập thời gian thực",
+      "placeholder": "Mẫu xử lý trước {{input_template}} sẽ được thay thế bằng thông tin nhập thời gian thực",
       "title": "Mẫu xử lý đầu vào của người dùng"
     },
     "submit": "Cập nhật sở thích trò chuyện",

package/locales/zh-CN/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "用户最新的一条消息会填充到此模板",
-      "placeholder": "预处理模版 {{text}} 将替换为实时输入信息",
+      "placeholder": "预处理模版 {{input_template}} 将替换为实时输入信息",
       "title": "用户输入预处理"
     },
     "submit": "更新聊天偏好",

package/locales/zh-TW/setting.json

@@ -220,7 +220,7 @@
     },
     "inputTemplate": {
       "desc": "使用者最新的一條訊息會填充到此模板",
-      "placeholder": "預處理模板 {{text}} 將替換為實時輸入資訊",
+      "placeholder": "預處理模板 {{input_template}} 將替換為實時輸入資訊",
       "title": "使用者輸入預處理"
     },
     "submit": "更新聊天偏好",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.91.3",
+  "version": "1.92.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",

package/src/features/AgentSetting/AgentModal/index.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { Form, type FormGroupItemType, SliderWithInput } from '@lobehub/ui';
-import { Switch } from 'antd';
+import { Form as AntdForm, Switch } from 'antd';
 import isEqual from 'fast-deep-equal';
 import { memo } from 'react';
 import { useTranslation } from 'react-i18next';
@@ -15,6 +15,7 @@ import { selectors, useStore } from '../store';
 const AgentModal = memo(() => {
   const { t } = useTranslation('setting');
   const [form] = Form.useForm();
+  const enableMaxTokens = AntdForm.useWatch(['chatConfig', 'enableMaxTokens'], form);
   const config = useStore(selectors.currentAgentConfig, isEqual);
 
   const updateConfig = useStore((s) => s.setAgentConfig);
@@ -69,7 +70,7 @@ const AgentModal = memo(() => {
         children: <SliderWithInput max={32_000} min={0} step={100} unlimitedInput={true} />,
         desc: t('settingModel.maxTokens.desc'),
         divider: false,
-        hidden: !config.chatConfig.enableMaxTokens,
+        hidden: !enableMaxTokens,
         label: t('settingModel.maxTokens.title'),
         name: ['params', 'max_tokens'],
         tag: 'max_tokens',

package/src/features/ChatInput/ActionBar/Search/Controls.tsx

@@ -9,7 +9,7 @@ import { Center, Flexbox } from 'react-layout-kit';
 
 import { useAgentStore } from '@/store/agent';
 import { agentChatConfigSelectors, agentSelectors } from '@/store/agent/slices/chat';
-import { aiModelSelectors, useAiInfraStore } from '@/store/aiInfra';
+import { aiModelSelectors, aiProviderSelectors, useAiInfraStore } from '@/store/aiInfra';
 import { SearchMode } from '@/types/search';
 
 import FCSearchModel from './FCSearchModel';
@@ -99,6 +99,9 @@ const Controls = memo(() => {
   ]);
 
   const supportFC = useAiInfraStore(aiModelSelectors.isModelSupportToolUse(model, provider));
+  const isProviderHasBuiltinSearchConfig = useAiInfraStore(
+    aiProviderSelectors.isProviderHasBuiltinSearchConfig(provider),
+  );
   const isModelHasBuiltinSearchConfig = useAiInfraStore(
     aiModelSelectors.isModelHasBuiltinSearchConfig(model, provider),
   );
@@ -119,6 +122,7 @@ const Controls = memo(() => {
   ];
 
   const showDivider = isModelHasBuiltinSearchConfig || !supportFC;
+  const showModelBuiltinSearch = isModelHasBuiltinSearchConfig || isProviderHasBuiltinSearchConfig;
 
   return (
     <Flexbox gap={4}>
@@ -126,7 +130,7 @@ const Controls = memo(() => {
         <Item {...option} key={option.value} />
       ))}
       {showDivider && <Divider style={{ margin: 0 }} />}
-      {isModelHasBuiltinSearchConfig && <ModelBuiltinSearch />}
+      {showModelBuiltinSearch && <ModelBuiltinSearch />}
       {!supportFC && <FCSearchModel />}
     </Flexbox>
   );

package/src/libs/model-runtime/utils/streams/vertex-ai.ts

@@ -48,6 +48,18 @@ const transformVertexAIStream = (
     );
   }
 
+  if (
+    candidate && // 首先检查是否为 reasoning 内容 (thought: true)
+    Array.isArray(candidate.content.parts) &&
+    candidate.content.parts.length > 0
+  ) {
+    for (const part of candidate.content.parts) {
+      if (part && part.text && (part as any).thought === true) {
+        return { data: part.text, id: context.id, type: 'reasoning' };
+      }
+    }
+  }
+
   const candidates = chunk.candidates;
   if (!candidates)
     return {

package/src/locales/default/setting.ts

@@ -224,7 +224,7 @@ export default {
     },
     inputTemplate: {
       desc: '用户最新的一条消息会填充到此模板',
-      placeholder: '预处理模版 {{text}} 将替换为实时输入信息',
+      placeholder: '预处理模版 {{input_template}} 将替换为实时输入信息',
       title: '用户输入预处理',
     },
     submit: '更新聊天偏好',

package/src/services/chat.ts

@@ -41,6 +41,7 @@ import { createErrorResponse } from '@/utils/errorResponse';
 import { FetchSSEOptions, fetchSSE, getMessageError } from '@/utils/fetch';
 import { genToolCallingName } from '@/utils/toolCall';
 import { createTraceHeader, getTraceId } from '@/utils/trace';
+import { parsePlaceholderVariablesMessages } from '@/utils/client/parserPlaceholder';
 
 import { createHeaderWithAuth, createPayloadWithKeyVaults } from './_auth';
 import { API_ENDPOINTS } from './_url';
@@ -172,14 +173,18 @@ class ChatService {
 
     // =================== 0. process search =================== //
     const chatConfig = agentChatConfigSelectors.currentChatConfig(getAgentStoreState());
-
+    const aiInfraStoreState = getAiInfraStoreState();
     const enabledSearch = chatConfig.searchMode !== 'off';
+    const isProviderHasBuiltinSearch = aiProviderSelectors.isProviderHasBuiltinSearch(
+      payload.provider!,
+    )(aiInfraStoreState);
     const isModelHasBuiltinSearch = aiModelSelectors.isModelHasBuiltinSearch(
       payload.model,
       payload.provider!,
-    )(getAiInfraStoreState());
+    )(aiInfraStoreState);
 
-    const useModelSearch = isModelHasBuiltinSearch && chatConfig.useModelBuiltinSearch;
+    const useModelSearch =
+      (isProviderHasBuiltinSearch || isModelHasBuiltinSearch) && chatConfig.useModelBuiltinSearch;
 
     const useApplicationBuiltinSearchTool = enabledSearch && !useModelSearch;
 
@@ -189,11 +194,14 @@ class ChatService {
       pluginIds.push(WebBrowsingManifest.identifier);
     }
 
-    // ============  1. preprocess messages   ============ //
+    // ============  1. preprocess placeholder variables   ============ //
+    const parsedMessages = parsePlaceholderVariablesMessages(messages);
+
+    // ============  2. preprocess messages   ============ //
 
     const oaiMessages = this.processMessages(
       {
-        messages,
+        messages: parsedMessages,
         model: payload.model,
         provider: payload.provider!,
         tools: pluginIds,
@@ -201,28 +209,28 @@ class ChatService {
       options,
     );
 
-    // ============  2. preprocess tools   ============ //
+    // ============  3. preprocess tools   ============ //
 
     const tools = this.prepareTools(pluginIds, {
       model: payload.model,
       provider: payload.provider!,
     });
 
-    // ============  3. process extend params   ============ //
+    // ============  4. process extend params   ============ //
 
     let extendParams: Record<string, any> = {};
 
     const isModelHasExtendParams = aiModelSelectors.isModelHasExtendParams(
       payload.model,
       payload.provider!,
-    )(getAiInfraStoreState());
+    )(aiInfraStoreState);
 
     // model
     if (isModelHasExtendParams) {
       const modelExtendParams = aiModelSelectors.modelExtendParams(
         payload.model,
         payload.provider!,
-      )(getAiInfraStoreState());
+      )(aiInfraStoreState);
       // if model has extended params, then we need to check if the model can use reasoning
 
       if (modelExtendParams!.includes('enableReasoning')) {

package/src/store/chat/slices/aiChat/actions/generateAIChat.ts

@@ -1,7 +1,6 @@
 /* eslint-disable sort-keys-fix/sort-keys-fix, typescript-sort-keys/interface */
 // Disable the auto sort key eslint rule to make the code more logic and readable
 import { produce } from 'immer';
-import { template } from 'lodash-es';
 import { StateCreator } from 'zustand/vanilla';
 
 import { LOADING_FLAT, MESSAGE_CANCEL_FLAT } from '@/const/message';
@@ -13,7 +12,7 @@ import { messageService } from '@/services/message';
 import { useAgentStore } from '@/store/agent';
 import { agentChatConfigSelectors, agentSelectors } from '@/store/agent/selectors';
 import { getAgentStoreState } from '@/store/agent/store';
-import { aiModelSelectors } from '@/store/aiInfra';
+import { aiModelSelectors, aiProviderSelectors } from '@/store/aiInfra';
 import { getAiInfraStoreState } from '@/store/aiInfra/store';
 import { chatHelpers } from '@/store/chat/helpers';
 import { ChatStore } from '@/store/chat/store';
@@ -299,7 +298,8 @@ export const generateAIChat: StateCreator<
     // create a new array to avoid the original messages array change
     const messages = [...originalMessages];
 
-    const { model, provider, chatConfig } = agentSelectors.currentAgentConfig(getAgentStoreState());
+    const agentStoreState = getAgentStoreState();
+    const { model, provider, chatConfig } = agentSelectors.currentAgentConfig(agentStoreState);
 
     let fileChunks: MessageSemanticSearchChunk[] | undefined;
     let ragQueryId;
@@ -323,7 +323,7 @@ export const generateAIChat: StateCreator<
         chunks,
         userQuery: lastMsg.content,
         rewriteQuery,
-        knowledge: agentSelectors.currentEnabledKnowledge(getAgentStoreState()),
+        knowledge: agentSelectors.currentEnabledKnowledge(agentStoreState),
       });
 
       // 3. add the retrieve context messages to the messages history
@@ -355,14 +355,25 @@ export const generateAIChat: StateCreator<
     if (!assistantId) return;
 
     // 3. place a search with the search working model if this model is not support tool use
+    const aiInfraStoreState = getAiInfraStoreState();
     const isModelSupportToolUse = aiModelSelectors.isModelSupportToolUse(
       model,
       provider!,
-    )(getAiInfraStoreState());
-    const isAgentEnableSearch = agentChatConfigSelectors.isAgentEnableSearch(getAgentStoreState());
+    )(aiInfraStoreState);
+    const isProviderHasBuiltinSearch = aiProviderSelectors.isProviderHasBuiltinSearch(provider!)(
+      aiInfraStoreState,
+    );
+    const isModelHasBuiltinSearch = aiModelSelectors.isModelHasBuiltinSearch(
+      model,
+      provider!,
+    )(aiInfraStoreState);
+    const useModelBuiltinSearch = agentChatConfigSelectors.useModelBuiltinSearch(agentStoreState);
+    const useModelSearch =
+      (isProviderHasBuiltinSearch || isModelHasBuiltinSearch) && useModelBuiltinSearch;
+    const isAgentEnableSearch = agentChatConfigSelectors.isAgentEnableSearch(agentStoreState);
 
-    if (isAgentEnableSearch && !isModelSupportToolUse) {
-      const { model, provider } = agentChatConfigSelectors.searchFCModel(getAgentStoreState());
+    if (isAgentEnableSearch && !useModelSearch && !isModelSupportToolUse) {
+      const { model, provider } = agentChatConfigSelectors.searchFCModel(agentStoreState);
 
       let isToolsCalling = false;
       let isError = false;
@@ -460,10 +471,10 @@ export const generateAIChat: StateCreator<
     }
 
     // 6. summary history if context messages is larger than historyCount
-    const historyCount = agentChatConfigSelectors.historyCount(getAgentStoreState());
+    const historyCount = agentChatConfigSelectors.historyCount(agentStoreState);
 
     if (
-      agentChatConfigSelectors.enableHistoryCount(getAgentStoreState()) &&
+      agentChatConfigSelectors.enableHistoryCount(agentStoreState) &&
       chatConfig.enableCompressHistory &&
       originalMessages.length > historyCount
     ) {
@@ -495,8 +506,6 @@ export const generateAIChat: StateCreator<
     const agentConfig = agentSelectors.currentAgentConfig(getAgentStoreState());
     const chatConfig = agentChatConfigSelectors.currentChatConfig(getAgentStoreState());
 
-    const compiler = template(chatConfig.inputTemplate, { interpolate: /{{([\S\s]+?)}}/g });
-
     // ================================== //
     //   messages uniformly preprocess    //
     // ================================== //
@@ -511,29 +520,12 @@ export const generateAIChat: StateCreator<
       historyCount,
     });
 
-    // 2. replace inputMessage template
-    preprocessMsgs = !chatConfig.inputTemplate
-      ? preprocessMsgs
-      : preprocessMsgs.map((m) => {
-          if (m.role === 'user') {
-            try {
-              return { ...m, content: compiler({ text: m.content }) };
-            } catch (error) {
-              console.error(error);
-
-              return m;
-            }
-          }
-
-          return m;
-        });
-
-    // 3. add systemRole
+    // 2. add systemRole
     if (agentConfig.systemRole) {
       preprocessMsgs.unshift({ content: agentConfig.systemRole, role: 'system' } as ChatMessage);
     }
 
-    // 4. handle max_tokens
+    // 3. handle max_tokens
     agentConfig.params.max_tokens = chatConfig.enableMaxTokens
       ? agentConfig.params.max_tokens
       : undefined;

package/src/store/user/slices/auth/selectors.test.ts

@@ -33,6 +33,24 @@ afterEach(() => {
 });
 
 describe('userProfileSelectors', () => {
+  describe('fullName', () => {
+    it('should return user fullName if exist', () => {
+      const store: UserStore = {
+        user: { fullName: 'John Doe' },
+      } as UserStore;
+
+      expect(userProfileSelectors.fullName(store)).toBe('John Doe');
+    });
+
+    it('should return empty string if not exist', () => {
+      const store: UserStore = {
+        user: { fullName: undefined },
+      } as UserStore;
+
+      expect(userProfileSelectors.fullName(store)).toBe('');
+    });
+  });
+
   describe('nickName', () => {
     it('should return default nickname when auth is disabled and not desktop', () => {
       enableAuth = false;

package/src/store/user/slices/auth/selectors.ts

@@ -36,6 +36,7 @@ const username = (s: UserStore) => {
 };
 
 export const userProfileSelectors = {
+  fullName: (s: UserStore): string => s.user?.fullName || '',
   nickName,
   userAvatar: (s: UserStore): string => s.user?.avatar || '',
   userId: (s: UserStore) => s.user?.id,

package/src/utils/client/parserPlaceholder.test.ts

@@ -0,0 +1,326 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { parsePlaceholderVariablesMessages, VARIABLE_GENERATORS } from './parserPlaceholder';
+
+// Mock dependencies
+vi.mock('@/utils/uuid', () => ({
+  uuid: () => 'mocked-uuid-12345'
+}));
+
+vi.mock('@/store/user', () => ({
+  useUserStore: {
+    getState: () => ({})
+  }
+}));
+
+vi.mock('@/store/user/selectors', () => ({
+  userProfileSelectors: {
+    nickName: () => 'Test User',
+    username: () => 'testuser',
+    fullName: () => 'Test Full Name'
+  }
+}));
+
+vi.mock('@/store/agent/store', () => ({
+  getAgentStoreState: () => ({})
+}));
+
+vi.mock('@/store/agent/selectors', () => ({
+  agentChatConfigSelectors: {
+    currentChatConfig: () => ({
+      inputTemplate: 'Hello {{username}}!'
+    })
+  }
+}));
+
+describe('parsePlaceholderVariablesMessages', () => {
+  beforeEach(() => {
+    // Mock Date for consistent testing
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2025-06-06T06:06:06.666Z'));
+
+    // Mock Math.random for consistent random values
+    vi.spyOn(Math, 'random').mockReturnValue(0.5);
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+
+  describe('string content messages', () => {
+    it('should replace template variables in string content', () => {
+      const messages = [
+        {
+          id: '1',
+          content: 'Hello {{username}}, today is {{date}}'
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toContain('testuser');
+      expect(result[0].content).toContain(new Date().toLocaleDateString());
+    });
+
+    it('should handle multiple variables in one message', () => {
+      const messages = [
+        {
+          id: '1',
+          content: 'Time: {{time}}, Date: {{date}}, User: {{nickname}}'
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toContain('Test User');
+      expect(result[0].content).toMatch(/Time: .+, Date: .+, User: Test User/);
+    });
+
+    it('should preserve message structure when replacing variables', () => {
+      const messages = [
+        {
+          id: '1',
+          role: 'user',
+          content: 'Hello {{username}}'
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0]).toEqual({
+        id: '1',
+        role: 'user',
+        content: 'Hello testuser'
+      });
+    });
+  });
+
+  describe('array content messages', () => {
+    it('should replace variables in text type array elements', () => {
+      const messages = [
+        {
+          id: '1',
+          content: [
+            {
+              type: 'text',
+              text: 'Hello {{username}}'
+            },
+            {
+              type: 'image_url',
+              image_url: 'image.jpg'
+            }
+          ]
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content[0].text).toBe('Hello testuser');
+      expect(result[0].content[1]).toEqual({
+        type: 'image_url',
+        image_url: 'image.jpg'
+      });
+    });
+
+    it('should handle multiple text elements with variables', () => {
+      const messages = [
+        {
+          id: '1',
+          content: [
+            {
+              type: 'text',
+              text: 'Date: {{date}}'
+            },
+            {
+              type: 'text',
+              text: 'Time: {{time}}'
+            },
+            {
+              type: 'image_url',
+              image_url: 'test.jpg'
+            }
+          ]
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content[0].text).toContain(new Date().toLocaleDateString());
+      expect(result[0].content[1].text).toContain(new Date().toLocaleTimeString());
+      expect(result[0].content[2]).toEqual({
+        type: 'image_url',
+        image_url: 'test.jpg'
+      });
+    });
+
+    it('should preserve non-text array elements unchanged', () => {
+      const messages = [
+        {
+          id: '1',
+          content: [
+            {
+              type: 'image_url',
+              image_url: 'image.jpg',
+            },
+            {
+              type: 'image_url',
+              name: 'image2.jpg'
+            }
+          ]
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toEqual([
+        {
+          type: 'image_url',
+          image_url: 'image.jpg'
+        },
+        {
+          type: 'image_url',
+          name: 'image2.jpg'
+        }
+      ]);
+    });
+  });
+
+  describe('edge cases', () => {
+    it('should handle empty messages array', () => {
+      const result = parsePlaceholderVariablesMessages([]);
+      expect(result).toEqual([]);
+    });
+
+    it('should handle messages without content', () => {
+      const messages = [
+        { id: '1' },
+        { id: '2', content: null },
+        { id: '3', content: undefined }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result).toEqual([
+        { id: '1' },
+        { id: '2', content: null },
+        { id: '3', content: undefined }
+      ]);
+    });
+
+    it('should handle empty string content', () => {
+      const messages = [
+        { id: '1', content: '' }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toBe('');
+    });
+
+    it('should handle content without variables', () => {
+      const messages = [
+        { id: '1', content: 'Hello world!' },
+        { 
+          id: '2', 
+          content: [
+            { type: 'text', text: 'No variables here' },
+            { type: 'image_url', image_url: 'test.jpg' }
+          ]
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toBe('Hello world!');
+      expect(result[1].content[0].text).toBe('No variables here');
+    });
+
+    it('should handle unknown variable types', () => {
+      const messages = [
+        { id: '1', content: 'Hello {{unknown_variable}}!' }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      // Unknown variables should remain unchanged
+      expect(result[0].content).toBe('Hello {{unknown_variable}}!');
+    });
+
+    it('should handle nested variables (input_template)', () => {
+      const messages = [
+        { id: '1', content: 'Template: {{input_template}}' }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      // Should resolve nested variables in input_template
+      expect(result[0].content).toBe('Template: Hello testuser!');
+    });
+  });
+
+  describe('specific variable types', () => {
+    it('should handle time variables', () => {
+      const messages = [
+        { 
+          id: '1', 
+          content: 'Year: {{year}}, Month: {{month}}, Day: {{day}}' 
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toContain('Year: 2025');
+      expect(result[0].content).toContain('Month: 06');
+      expect(result[0].content).toContain('Day: 06');
+    });
+
+    it('should handle random variables', () => {
+      const messages = [
+        { 
+          id: '1', 
+          content: 'Random: {{random}}, Bool: {{random_bool}}, UUID: {{uuid}}' 
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toContain('Random: 500001'); // Math.random() * 1000000 + 1 with 0.5
+      expect(result[0].content).toContain('Bool: false'); // Math.random() > 0.5 with 0.5
+      expect(result[0].content).toContain('UUID: mocked-uuid-12345');
+    });
+
+    it('should handle user variables', () => {
+      const messages = [
+        { 
+          id: '1', 
+          content: 'User: {{username}}, Nickname: {{nickname}}' 
+        }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toBe('User: testuser, Nickname: Test User');
+    });
+  });
+
+  describe('multiple messages', () => {
+    it('should process multiple messages correctly', () => {
+      const messages = [
+        { id: '1', content: 'Hello {{username}}' },
+        { 
+          id: '2', 
+          content: [
+            { type: 'text', text: 'Today is {{date}}' }
+          ]
+        },
+        { id: '3', content: 'Time: {{time}}' }
+      ];
+
+      const result = parsePlaceholderVariablesMessages(messages);
+
+      expect(result[0].content).toBe('Hello testuser');
+      expect(result[1].content[0].text).toContain(new Date().toLocaleDateString());
+      expect(result[2].content).toContain(new Date().toLocaleTimeString());
+    });
+  });
+});

package/src/utils/client/parserPlaceholder.ts

@@ -0,0 +1,190 @@
+import { template } from 'lodash-es';
+
+import { uuid } from '@/utils/uuid';
+
+import { useUserStore } from '@/store/user';
+import { userProfileSelectors } from '@/store/user/selectors';
+
+import { getAgentStoreState } from '@/store/agent/store';
+import { agentChatConfigSelectors } from '@/store/agent/selectors';
+
+const placeholderVariablesRegex = /{{(.*?)}}/g;
+
+/* eslint-disable sort-keys-fix/sort-keys-fix */
+export const VARIABLE_GENERATORS = {
+  /**
+  * 时间类模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{date}}` | 12/25/2023 |
+  * | `{{datetime}}` | 12/25/2023, 2:30:45 PM |
+  * | `{{day}}` | 25 |
+  * | `{{hour}}` | 14 |
+  * | `{{iso}}` | 2023-12-25T14:30:45.123Z |
+  * | `{{locale}}` | zh-CN |
+  * | `{{minute}}` | 30 |
+  * | `{{month}}` | 12 |
+  * | `{{second}}` | 45 |
+  * | `{{time}}` | 2:30:45 PM |
+  * | `{{timestamp}}` | 1703538645123 |
+  * | `{{timezone}}` | America/New_York |
+  * | `{{weekday}}` | Monday |
+  * | `{{year}}` | 2023 |
+  *
+  */
+  date: () => new Date().toLocaleDateString(),
+  datetime: () => new Date().toLocaleString(),
+  day: () => new Date().getDate().toString().padStart(2, '0'),
+  hour: () => new Date().getHours().toString().padStart(2, '0'),
+  iso: () => new Date().toISOString(),
+  locale: () => Intl.DateTimeFormat().resolvedOptions().locale,
+  minute: () => new Date().getMinutes().toString().padStart(2, '0'),
+  month: () => (new Date().getMonth() + 1).toString().padStart(2, '0'),
+  second: () => new Date().getSeconds().toString().padStart(2, '0'),
+  time: () => new Date().toLocaleTimeString(),
+  timestamp: () => Date.now().toString(),
+  timezone: () => Intl.DateTimeFormat().resolvedOptions().timeZone,
+  weekday: () => new Date().toLocaleDateString('en-US', { weekday: 'long' }),
+  year: () => new Date().getFullYear().toString(),
+
+  /**
+  * 用户信息类模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{nickname}}` | 社区版用户 |
+  * | `{{username}}` | LobeChat |
+  *
+  */
+  nickname: () => userProfileSelectors.nickName(useUserStore.getState()) ?? '',
+  username: () => userProfileSelectors.username(useUserStore.getState()) ?? userProfileSelectors.fullName(useUserStore.getState()) ?? '',
+
+  /**
+  * 随机值类模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{random}}` | 100041 |
+  * | `{{random_bool}}` | true |
+  * | `{{random_float}}` | 76.02 |
+  * | `{{random_hex}}` | de0dbd |
+  * | `{{random_int}}` | 68 |
+  * | `{{random_string}}` | wqn9zfrqe7h |
+  *
+  */
+  random: () => Math.floor(Math.random() * 1_000_000 + 1).toString(),
+  random_bool: () => (Math.random() > 0.5 ? 'true' : 'false'),
+  random_float: () => (Math.random() * 100).toFixed(2),
+  random_hex: () => Math.floor(Math.random() * 16_777_215).toString(16).padStart(6, '0'),
+  random_int: () => Math.floor(Math.random() * 100 + 1).toString(),
+  random_string: () => Math.random().toString(36).slice(2, 15),
+  random_digit: () => Math.floor(Math.random() * 10).toString(),
+
+  /**
+  * UUID 类模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{uuid}}` | dd90b35-669f-4e87-beb8-ac6877f6995d |
+  * | `{{uuid_short}}` | dd90b35 |
+  *
+  */
+  uuid: () => uuid(),
+  uuid_short: () => uuid().split('-')[0],
+
+  /**
+  * 平台类模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{language}}` | zh-CN |
+  * | `{{platform}}` | MacIntel |
+  * | `{{user_agent}}` | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36 Edg/132.0.0.0 |
+  *
+  */
+  language: () => typeof navigator !== 'undefined' ? navigator.language : '',
+  platform: () => typeof navigator !== 'undefined' ? navigator.platform : '',
+  user_agent: () => typeof navigator !== 'undefined' ? navigator.userAgent : '',
+
+  /**
+  * LobeChat 模板变量
+  *
+  * | Value | Example |
+  * |-------|---------|
+  * | `{{input_template}}` | Some contents |
+  *
+  */
+  input_template: () => agentChatConfigSelectors.currentChatConfig(getAgentStoreState()).inputTemplate || '',
+} as Record<string, () => string>;
+
+/**
+ * 从文本中提取所有 {{variable}} 占位符的变量名
+ * @param text 包含模板变量的字符串
+ * @returns 变量名数组，如 ['date', 'nickname']
+ */
+const extractPlaceholderVariables = (text: string): string[] => {
+  const matches = [...text.matchAll(placeholderVariablesRegex)];
+  return matches.map(m => m[1].trim());
+};
+
+/**
+ * 将模板变量替换为实际值，并支持递归解析嵌套变量
+ * @param text - 含变量的原始文本
+ * @param depth - 递归深度，默认 1，设置更高可支持 {{input_template}} 中的 {{date}} 等
+ * @returns 替换后的文本
+ */
+export const parsePlaceholderVariables = (text: string, depth = 2): string => {
+  let result = text;
+
+  // 递归解析，用于处理如 {{input_template}} 存在额外预设变量
+  for (let i = 0; i < depth; i++) {
+    try {
+      const variables = Object.fromEntries(
+        extractPlaceholderVariables(result)
+          .map((key) => [key, VARIABLE_GENERATORS[key]?.()])
+          .filter(([, value]) => value !== undefined)
+      );
+
+      const replaced = template(result, { interpolate: placeholderVariablesRegex })(variables);
+      if (replaced === result) break;
+
+      result = replaced;
+    } catch {
+      break;
+    }
+  }
+
+  return result;
+};
+
+/**
+ * 解析消息内容，替换占位符变量
+ * @param messages 原始消息数组
+ * @returns 处理后的消息数组
+ */
+export const parsePlaceholderVariablesMessages = (messages: any[]): any[] =>
+  messages.map(message => {
+    if (!message?.content) return message;
+
+    const { content } = message;
+
+    // 字符串类型直接处理
+    if (typeof content === 'string') {
+      return { ...message, content: parsePlaceholderVariables(content) };
+    }
+
+    // 数组类型处理其中的 text 元素
+    if (Array.isArray(content)) {
+      return {
+        ...message,
+        content: content.map(item => 
+          item?.type === 'text' 
+            ? { ...item, text: parsePlaceholderVariables(item.text) }
+            : item
+        )
+      };
+    }
+
+    return message;
+  });