@lobehub/lobehub 2.0.0-next.230 → 2.0.0-next.232

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 2.0.0-next.232](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.231...v2.0.0-next.232)
+
+<sup>Released on **2026-01-07**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Correct BrandTextLoading position after removing SSG CSS-in-JS injection.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Correct BrandTextLoading position after removing SSG CSS-in-JS injection, closes [#11312](https://github.com/lobehub/lobe-chat/issues/11312) ([0de4eb8](https://github.com/lobehub/lobe-chat/commit/0de4eb8))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.231](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.230...v2.0.0-next.231)
+
+<sup>Released on **2026-01-07**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Update desktop onboarding privacy description.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Update desktop onboarding privacy description, closes [#11307](https://github.com/lobehub/lobe-chat/issues/11307) [#11308](https://github.com/lobehub/lobe-chat/issues/11308) ([58b10a2](https://github.com/lobehub/lobe-chat/commit/58b10a2))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.230](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.229...v2.0.0-next.230)
 
 <sup>Released on **2026-01-07**</sup>

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Correct BrandTextLoading position after removing SSG CSS-in-JS injection."
+      ]
+    },
+    "date": "2026-01-07",
+    "version": "2.0.0-next.232"
+  },
+  {
+    "children": {
+      "fixes": [
+        "Update desktop onboarding privacy description."
+      ]
+    },
+    "date": "2026-01-07",
+    "version": "2.0.0-next.231"
+  },
   {
     "children": {
       "fixes": [

package/locales/ar/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "اختر كيف تريد مشاركة البيانات. يساعدنا اختيارك على التحسين، ويمكنك تغيير ذلك في أي وقت من الإعدادات.",
   "screen4.footerNote": "يمكنك تغيير ذلك في أي وقت من الإعدادات",
   "screen4.navigation.next": "متابعة",
-  "screen4.privacy.description": "احتفظ بكل شيء محليًا. لا يتم جمع أو مشاركة أي بيانات — خصوصية كاملة لمحادثاتك وسير عملك.",
+  "screen4.privacy.description": "عطّل تحليلات الاستخدام المجهّلة. لا تتم مشاركة بيانات الأداء أو استخدام النماذج أو تفاعلات الميزات.",
   "screen4.privacy.items.1": "لا جمع للبيانات",
   "screen4.privacy.items.2": "لا تحليلات استخدام",
   "screen4.privacy.items.3": "جميع المعالجة تتم محليًا",

package/locales/bg-BG/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Избери как искаш да споделяш данни. Твоят избор ни помага да се подобрим, а можеш да го промениш по всяко време от настройките.",
   "screen4.footerNote": "Можеш да го промениш по всяко време от настройките",
   "screen4.navigation.next": "Продължи",
-  "screen4.privacy.description": "Всичко остава локално. Никакви данни не се събират или споделят — пълна поверителност за твоите разговори и работни процеси.",
+  "screen4.privacy.description": "Изключете анонимната аналитика за използване. Не споделяме данни за производителност, използване на модели или взаимодействия с функции.",
   "screen4.privacy.items.1": "Без събиране на данни",
   "screen4.privacy.items.2": "Без анализ на използването",
   "screen4.privacy.items.3": "Цялата обработка е локална",

package/locales/de-DE/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Wählen Sie, wie Sie Daten teilen möchten. Ihre Entscheidung hilft uns bei der Verbesserung, und Sie können dies jederzeit in den Einstellungen ändern.",
   "screen4.footerNote": "Sie können dies jederzeit in den Einstellungen ändern",
   "screen4.navigation.next": "Weiter",
-  "screen4.privacy.description": "Alles bleibt lokal. Es werden keine Daten gesammelt oder geteilt – vollständige Privatsphäre für Ihre Gespräche und Arbeitsabläufe.",
+  "screen4.privacy.description": "Deaktivieren Sie anonymisierte Nutzungsanalysen. Es werden keine Leistungsdaten, Modellnutzung oder Funktionsinteraktionen geteilt.",
   "screen4.privacy.items.1": "Keine Datenerfassung",
   "screen4.privacy.items.2": "Keine Nutzungsanalysen",
   "screen4.privacy.items.3": "Alle Verarbeitungen bleiben lokal",

package/locales/en-US/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Choose how you want to share data. Your choice helps us improve, and you can change this anytime in settings.",
   "screen4.footerNote": "You can change this anytime in settings",
   "screen4.navigation.next": "Continue",
-  "screen4.privacy.description": "Keep everything local. No data is collected or shared—complete privacy for your conversations and workflows.",
+  "screen4.privacy.description": "Disable anonymized usage analytics. No performance, model usage, or feature interaction data is shared.",
   "screen4.privacy.items.1": "No data collection",
   "screen4.privacy.items.2": "No usage analytics",
   "screen4.privacy.items.3": "All processing stays local",

package/locales/es-ES/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Elige cómo deseas compartir tus datos. Tu elección nos ayuda a mejorar, y puedes cambiarla en cualquier momento desde la configuración.",
   "screen4.footerNote": "Puedes cambiar esto en cualquier momento desde la configuración",
   "screen4.navigation.next": "Continuar",
-  "screen4.privacy.description": "Mantén todo local. No se recopilan ni comparten datos: privacidad total para tus conversaciones y flujos de trabajo.",
+  "screen4.privacy.description": "Desactiva la analítica de uso anónima. No se comparten métricas de rendimiento, uso del modelo ni interacciones con funciones.",
   "screen4.privacy.items.1": "Sin recopilación de datos",
   "screen4.privacy.items.2": "Sin análisis de uso",
   "screen4.privacy.items.3": "Todo el procesamiento permanece local",

package/locales/fa-IR/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "نحوه اشتراک‌گذاری داده‌ها را انتخاب کنید. انتخاب شما به ما در بهبود کمک می‌کند و هر زمان می‌توانید آن را در تنظیمات تغییر دهید.",
   "screen4.footerNote": "شما می‌توانید هر زمان از طریق تنظیمات آن را تغییر دهید",
   "screen4.navigation.next": "ادامه",
-  "screen4.privacy.description": "همه چیز به صورت محلی باقی می‌ماند. هیچ داده‌ای جمع‌آوری یا به اشتراک گذاشته نمی‌شود — حریم خصوصی کامل برای گفتگوها و جریان‌های کاری شما.",
+  "screen4.privacy.description": "تحلیل استفادهٔ ناشناس را غیرفعال کنید. هیچ داده‌ای از عملکرد، میزان استفاده از مدل یا تعاملات ویژگی‌ها به اشتراک گذاشته نمی‌شود.",
   "screen4.privacy.items.1": "بدون جمع‌آوری داده",
   "screen4.privacy.items.2": "بدون تحلیل استفاده",
   "screen4.privacy.items.3": "تمام پردازش‌ها به صورت محلی انجام می‌شود",

package/locales/fr-FR/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Choisissez comment vous souhaitez partager vos données. Votre choix nous aide à nous améliorer, et vous pouvez le modifier à tout moment dans les paramètres.",
   "screen4.footerNote": "Vous pouvez modifier cela à tout moment dans les paramètres",
   "screen4.navigation.next": "Continuer",
-  "screen4.privacy.description": "Gardez tout en local. Aucune donnée n'est collectée ni partagée — confidentialité totale pour vos conversations et flux de travail.",
+  "screen4.privacy.description": "Désactivez l’analyse d’usage anonyme. Aucune donnée de performance, d’utilisation des modèles ou d’interactions avec les fonctionnalités n’est partagée.",
   "screen4.privacy.items.1": "Aucune collecte de données",
   "screen4.privacy.items.2": "Aucune analyse d'utilisation",
   "screen4.privacy.items.3": "Tout le traitement reste local",

package/locales/it-IT/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Scegli come desideri condividere i dati. La tua scelta ci aiuta a migliorare e puoi modificarla in qualsiasi momento nelle impostazioni.",
   "screen4.footerNote": "Puoi modificarla in qualsiasi momento nelle impostazioni",
   "screen4.navigation.next": "Continua",
-  "screen4.privacy.description": "Mantieni tutto in locale. Nessun dato viene raccolto o condiviso—privacy totale per le tue conversazioni e flussi di lavoro.",
+  "screen4.privacy.description": "Disattiva l’analisi d’uso anonima. Non vengono condivisi dati su prestazioni, utilizzo dei modelli o interazioni con le funzionalità.",
   "screen4.privacy.items.1": "Nessuna raccolta dati",
   "screen4.privacy.items.2": "Nessuna analisi d'uso",
   "screen4.privacy.items.3": "Tutto l'elaborazione resta in locale",

package/locales/ja-JP/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "データの共有方法を選択してください。ご選択は改善に役立ち、設定からいつでも変更できます。",
   "screen4.footerNote": "設定からいつでも変更できます",
   "screen4.navigation.next": "続行",
-  "screen4.privacy.description": "すべてをローカルに保持。データは収集・共有されず、会話やワークフローは完全にプライベートです。",
+  "screen4.privacy.description": "匿名の利用分析を無効にします。パフォーマンス、モデル利用状況、機能の操作データは共有されません。",
   "screen4.privacy.items.1": "データ収集なし",
   "screen4.privacy.items.2": "使用状況分析なし",
   "screen4.privacy.items.3": "すべての処理はローカルで実行",

package/locales/ko-KR/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "데이터 공유 방식을 선택하세요. 선택은 개선에 도움이 되며, 설정에서 언제든지 변경할 수 있습니다.",
   "screen4.footerNote": "설정에서 언제든지 변경할 수 있습니다",
   "screen4.navigation.next": "계속",
-  "screen4.privacy.description": "모든 데이터를 로컬에 유지합니다. 데이터 수집이나 공유 없이 대화와 워크플로우의 완전한 프라이버시를 보장합니다.",
+  "screen4.privacy.description": "익명 사용 분석을 끕니다. 성능, 모델 사용량, 기능 상호작용 데이터는 공유되지 않습니다.",
   "screen4.privacy.items.1": "데이터 수집 없음",
   "screen4.privacy.items.2": "사용 분석 없음",
   "screen4.privacy.items.3": "모든 처리는 로컬에서 수행",

package/locales/nl-NL/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Kies hoe je gegevens wilt delen. Jouw keuze helpt ons verbeteren, en je kunt dit op elk moment wijzigen in de instellingen.",
   "screen4.footerNote": "Je kunt dit op elk moment wijzigen in de instellingen",
   "screen4.navigation.next": "Doorgaan",
-  "screen4.privacy.description": "Houd alles lokaal. Er worden geen gegevens verzameld of gedeeld—volledige privacy voor je gesprekken en workflows.",
+  "screen4.privacy.description": "Schakel geanonimiseerde gebruiksanalyses uit. Er worden geen prestatiegegevens, modelgebruik of functie-interacties gedeeld.",
   "screen4.privacy.items.1": "Geen gegevensverzameling",
   "screen4.privacy.items.2": "Geen gebruiksanalyses",
   "screen4.privacy.items.3": "Alle verwerking blijft lokaal",

package/locales/pl-PL/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Wybierz, jak chcesz udostępniać dane. Twój wybór pomaga nam się rozwijać i możesz go zmienić w każdej chwili w ustawieniach.",
   "screen4.footerNote": "Możesz to zmienić w każdej chwili w ustawieniach",
   "screen4.navigation.next": "Kontynuuj",
-  "screen4.privacy.description": "Zachowaj wszystko lokalnie. Żadne dane nie są zbierane ani udostępniane — pełna prywatność Twoich rozmów i procesów.",
+  "screen4.privacy.description": "Wyłącz anonimową analitykę użycia. Nie udostępniamy danych o wydajności, użyciu modeli ani interakcjach z funkcjami.",
   "screen4.privacy.items.1": "Brak zbierania danych",
   "screen4.privacy.items.2": "Brak analityki użytkowania",
   "screen4.privacy.items.3": "Całe przetwarzanie lokalne",

package/locales/pt-BR/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Escolha como deseja compartilhar dados. Sua escolha nos ajuda a melhorar, e você pode alterá-la a qualquer momento nas configurações.",
   "screen4.footerNote": "Você pode alterar isso a qualquer momento nas configurações",
   "screen4.navigation.next": "Continuar",
-  "screen4.privacy.description": "Mantenha tudo local. Nenhum dado é coletado ou compartilhado — privacidade total para suas conversas e fluxos de trabalho.",
+  "screen4.privacy.description": "Desative a análise de uso anônima. Nenhum dado de desempenho, uso do modelo ou interações com recursos é compartilhado.",
   "screen4.privacy.items.1": "Sem coleta de dados",
   "screen4.privacy.items.2": "Sem análise de uso",
   "screen4.privacy.items.3": "Todo o processamento é local",

package/locales/ru-RU/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Выберите, как вы хотите делиться данными. Ваш выбор помогает нам становиться лучше. Вы можете изменить его в любое время в настройках.",
   "screen4.footerNote": "Вы можете изменить это в любое время в настройках",
   "screen4.navigation.next": "Продолжить",
-  "screen4.privacy.description": "Всё остаётся локально. Данные не собираются и не передаются — полная конфиденциальность ваших разговоров и рабочих процессов.",
+  "screen4.privacy.description": "Отключите анонимную аналитику использования. Мы не передаём данные о производительности, использовании моделей и взаимодействиях с функциями.",
   "screen4.privacy.items.1": "Без сбора данных",
   "screen4.privacy.items.2": "Без аналитики использования",
   "screen4.privacy.items.3": "Вся обработка — локально",

package/locales/tr-TR/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Verilerinizi nasıl paylaşmak istediğinizi seçin. Seçiminiz bize gelişmemizde yardımcı olur ve bunu istediğiniz zaman ayarlardan değiştirebilirsiniz.",
   "screen4.footerNote": "Bunu istediğiniz zaman ayarlardan değiştirebilirsiniz",
   "screen4.navigation.next": "Devam Et",
-  "screen4.privacy.description": "Her şey yerel kalır. Hiçbir veri toplanmaz veya paylaşılmaz—konuşmalarınız ve iş akışlarınız tamamen gizli kalır.",
+  "screen4.privacy.description": "Anonim kullanım analizini kapatın. Performans, model kullanımı veya özellik etkileşim verileri paylaşılmaz.",
   "screen4.privacy.items.1": "Veri toplanmaz",
   "screen4.privacy.items.2": "Kullanım analitiği yok",
   "screen4.privacy.items.3": "Tüm işlemler yerel olarak gerçekleştirilir",

package/locales/vi-VN/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "Chọn cách bạn muốn chia sẻ dữ liệu. Quyết định của bạn giúp chúng tôi cải thiện, và bạn có thể thay đổi bất cứ lúc nào trong phần cài đặt.",
   "screen4.footerNote": "Bạn có thể thay đổi điều này bất cứ lúc nào trong phần cài đặt",
   "screen4.navigation.next": "Tiếp tục",
-  "screen4.privacy.description": "Giữ mọi thứ cục bộ. Không thu thập hay chia sẻ dữ liệu—bảo mật hoàn toàn cho cuộc trò chuyện và quy trình làm việc của bạn.",
+  "screen4.privacy.description": "Tắt phân tích sử dụng ẩn danh. Không chia sẻ dữ liệu hiệu năng, mức sử dụng mô hình hoặc tương tác tính năng.",
   "screen4.privacy.items.1": "Không thu thập dữ liệu",
   "screen4.privacy.items.2": "Không phân tích hành vi sử dụng",
   "screen4.privacy.items.3": "Mọi xử lý đều diễn ra cục bộ",

package/locales/zh-CN/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "选择您希望如何共享数据。您的选择将帮助我们改进，您也可以随时在设置中更改。",
   "screen4.footerNote": "您可以随时在设置中更改",
   "screen4.navigation.next": "继续",
-  "screen4.privacy.description": "所有数据仅保留在本地。不收集或共享任何信息——为您的对话和工作流提供完整隐私保护。",
+  "screen4.privacy.description": "不共享匿名使用数据，也不会上传性能、模型使用或功能交互等统计信息。",
   "screen4.privacy.items.1": "不收集数据",
   "screen4.privacy.items.2": "不做使用分析",
   "screen4.privacy.items.3": "处理尽量在本地完成",

package/locales/zh-TW/desktop-onboarding.json

@@ -45,7 +45,7 @@
   "screen4.description": "選擇你希望如何分享資料。你的選擇將幫助我們改進，你可隨時在設定中變更。",
   "screen4.footerNote": "你可隨時在設定中變更",
   "screen4.navigation.next": "繼續",
-  "screen4.privacy.description": "所有資料皆保留於本地。不會收集或分享任何資料，確保對話與工作流程的完整隱私。",
+  "screen4.privacy.description": "不分享匿名使用資料，也不會上傳效能、模型使用或功能互動等統計資訊。",
   "screen4.privacy.items.1": "不收集資料",
   "screen4.privacy.items.2": "不進行使用分析",
   "screen4.privacy.items.3": "所有處理皆在本地完成",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.230",
+  "version": "2.0.0-next.232",
   "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/src/components/Loading/BrandTextLoading/index.module.css

@@ -0,0 +1,81 @@
+.container {
+  --brand-text-color: var(--colorText, #1f1f1f);
+  --brand-muted-color: var(--colorTextSecondary, #8c8c8c);
+  --brand-border-color: var(--colorBorder, #d9d9d9);
+  --brand-tag-bg: var(--colorFillTertiary, rgba(0, 0, 0, 0.04));
+
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+
+  width: 100%;
+  height: 100vh;
+  height: 100dvh;
+  gap: 12px;
+}
+
+[data-theme='dark'] .container {
+  --brand-text-color: var(--colorText, #f0f0f0);
+  --brand-muted-color: var(--colorTextSecondary, #a6a6a6);
+  --brand-border-color: var(--colorBorder, #424242);
+  --brand-tag-bg: var(--colorFillTertiary, rgba(255, 255, 255, 0.08));
+}
+
+.brand {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+
+  opacity: 0.6;
+  color: var(--brand-text-color);
+}
+
+.brand :global(.lobe-brand-loading) {
+  display: block;
+  color: inherit;
+}
+
+.debug {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+
+  padding: 16px;
+}
+
+.debugRow {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+
+  font-size: 12px;
+  color: var(--brand-muted-color);
+}
+
+.debugRow code {
+  font-family:
+    ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New',
+    monospace;
+}
+
+.debugTag {
+  display: inline-flex;
+  align-items: center;
+
+  padding: 2px 8px;
+  border: 1px solid var(--brand-border-color);
+  border-radius: 6px;
+
+  background: var(--brand-tag-bg);
+}
+
+.debugTag code {
+  color: var(--brand-text-color);
+}
+
+.debugHint {
+  font-size: 12px;
+  color: var(--brand-muted-color);
+}

package/src/components/Loading/BrandTextLoading/index.tsx

@@ -1,34 +1,41 @@
-import { Center, Tag, Text } from '@lobehub/ui';
 import { BrandLoading, LobeHubText } from '@lobehub/ui/brand';
 
 import { isCustomBranding } from '@/const/version';
 
 import CircleLoading from '../CircleLoading';
+import styles from './index.module.css';
 
 interface BrandTextLoadingProps {
   debugId: string;
 }
 
 const BrandTextLoading = ({ debugId }: BrandTextLoadingProps) => {
-  if (isCustomBranding) return <CircleLoading />;
+  if (isCustomBranding)
+    return (
+      <div className={styles.container}>
+        <CircleLoading />
+      </div>
+    );
+
+  const showDebug = process.env.NODE_ENV === 'development' && debugId;
 
   return (
-    <Center height={'100%'} width={'100%'}>
-      <BrandLoading size={40} style={{ opacity: 0.6 }} text={LobeHubText} />
-      {process.env.NODE_ENV === 'development' && debugId && (
-        <Center gap={4} padding={16}>
-          <Text code style={{ alignItems: 'center', display: 'flex' }}>
-            Debug ID:{' '}
-            <Tag size={'large'}>
-              <Text code>{debugId}</Text>
-            </Tag>
-          </Text>
-          <Text fontSize={12} type={'secondary'}>
-            only visible in development
-          </Text>
-        </Center>
+    <div className={styles.container}>
+      <div aria-label="Loading" className={styles.brand} role="status">
+        <BrandLoading size={40} text={LobeHubText} />
+      </div>
+      {showDebug && (
+        <div className={styles.debug}>
+          <div className={styles.debugRow}>
+            <code>Debug ID:</code>
+            <span className={styles.debugTag}>
+              <code>{debugId}</code>
+            </span>
+          </div>
+          <div className={styles.debugHint}>only visible in development</div>
+        </div>
       )}
-    </Center>
+    </div>
   );
 };
 

package/src/libs/redis/index.ts

@@ -1,3 +1,4 @@
+export * from './keys';
 export * from './manager';
 export * from './redis';
 export * from './types';

package/src/libs/redis/keys.ts

@@ -0,0 +1,59 @@
+/**
+ * Centralized Redis key definitions
+ *
+ * All Redis keys should be defined here for easy management and consistency.
+ *
+ * Structure:
+ * - RedisKeyNamespace: Contains all available prefixes
+ * - RedisKeys: Contains key builders organized by namespace/scope
+ */
+
+/**
+ * Redis key namespace prefixes
+ *
+ * Each prefix creates an isolated keyspace in Redis.
+ * When using `createRedisWithPrefix`, pass one of these as the prefix parameter.
+ */
+export const RedisKeyNamespace = {
+  /**
+   * AI generation related keys (agent welcome, placeholders, etc.)
+   */
+  AI_GENERATION: 'aiGeneration',
+  /**
+   * Core LOBEHUB application keys (sessions, cache, etc.)
+   */
+  LOBEHUB: 'lobechat',
+} as const;
+
+/**
+ * Redis key builders organized by namespace/scope
+ *
+ * Usage:
+ * ```ts
+ * // Get full key: agent_welcome:{agentId}
+ * const key = RedisKeys.aiGeneration.agentWelcome(agentId);
+ *
+ * // Use with Redis client (prefix is added by createRedisWithPrefix)
+ * const redis = await createRedisWithPrefix(config, RedisKeyNamespace.AI_GENERATION);
+ * await redis.get(key);
+ * // Actual Redis key: aiGeneration:agent_welcome:{agentId}
+ * ```
+ */
+export const RedisKeys = {
+  /**
+   * AI generation scope - for AI-generated content like welcome messages
+   */
+  aiGeneration: {
+    /**
+     * Agent welcome message and open questions
+     * Full key: aiGeneration:agent_welcome:{agentId}
+     */
+    agentWelcome: (agentId: string): string => `agent_welcome:${agentId}`,
+  },
+  /**
+   * Lobechat core scope - for application-level caching
+   */
+  lobechat: {
+    // Add lobechat scope keys here as needed
+  },
+} as const;

package/src/libs/redis/manager.ts

@@ -94,3 +94,66 @@ export const createRedisWithPrefix = async (
   await provider.initialize();
   return provider;
 };
+
+/**
+ * Manages singleton Redis clients per prefix
+ */
+class PrefixedRedisManager {
+  private static instances = new Map<string, BaseRedisProvider>();
+  private static initPromises = new Map<string, Promise<BaseRedisProvider | null>>();
+
+  static async initialize(config: RedisConfig, prefix: string): Promise<BaseRedisProvider | null> {
+    const existing = this.instances.get(prefix);
+    if (existing) return existing;
+
+    const pendingPromise = this.initPromises.get(prefix);
+    if (pendingPromise) return pendingPromise;
+
+    const initPromise = (async () => {
+      const provider = createProvider(config, prefix);
+      if (!provider) return null;
+
+      await provider.initialize();
+      this.instances.set(prefix, provider);
+      return provider;
+    })().catch((error) => {
+      this.initPromises.delete(prefix);
+      throw error;
+    });
+
+    this.initPromises.set(prefix, initPromise);
+    return initPromise;
+  }
+
+  static async reset(prefix?: string) {
+    if (prefix) {
+      const instance = this.instances.get(prefix);
+      if (instance) {
+        await instance.disconnect();
+        this.instances.delete(prefix);
+        this.initPromises.delete(prefix);
+      }
+    } else {
+      for (const instance of this.instances.values()) {
+        await instance.disconnect();
+      }
+      this.instances.clear();
+      this.initPromises.clear();
+    }
+  }
+}
+
+/**
+ * Initialize a singleton Redis client with custom prefix
+ *
+ * Unlike createRedisWithPrefix, this reuses the same client for each prefix,
+ * avoiding connection leaks when called frequently.
+ *
+ * @param config - Redis config
+ * @param prefix - Custom prefix for all keys (e.g., 'aiGeneration')
+ * @returns Redis client or null if Redis is disabled
+ */
+export const initializeRedisWithPrefix = (config: RedisConfig, prefix: string) =>
+  PrefixedRedisManager.initialize(config, prefix);
+
+export const resetPrefixedRedisClient = (prefix?: string) => PrefixedRedisManager.reset(prefix);

package/src/locales/default/desktop-onboarding.ts

@@ -58,7 +58,7 @@ export default {
   'screen4.footerNote': 'You can change this anytime in settings',
   'screen4.navigation.next': 'Continue',
   'screen4.privacy.description':
-    'Keep everything local. No data is collected or shared—complete privacy for your conversations and workflows.',
+    'Disable anonymized usage analytics. No performance, model usage, or feature interaction data is shared.',
   'screen4.privacy.items.1': 'No data collection',
   'screen4.privacy.items.2': 'No usage analytics',
   'screen4.privacy.items.3': 'All processing stays local',

package/src/server/services/agent/index.test.ts

@@ -5,6 +5,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { AgentModel } from '@/database/models/agent';
 import { SessionModel } from '@/database/models/session';
 import { UserModel } from '@/database/models/user';
+import { RedisKeys, initializeRedisWithPrefix, isRedisEnabled } from '@/libs/redis';
 import { parseAgentConfig } from '@/server/globalConfig/parseDefaultAgent';
 
 import { AgentService } from './index';
@@ -34,6 +35,19 @@ vi.mock('@/database/models/user', () => ({
   UserModel: vi.fn(),
 }));
 
+vi.mock('@/envs/redis', () => ({
+  getRedisConfig: vi.fn().mockReturnValue({ enabled: true }),
+}));
+
+vi.mock('@/libs/redis', async (importOriginal) => {
+  const original = await importOriginal<typeof import('@/libs/redis')>();
+  return {
+    ...original,
+    initializeRedisWithPrefix: vi.fn(),
+    isRedisEnabled: vi.fn(),
+  };
+});
+
 describe('AgentService', () => {
   let service: AgentService;
   const mockDb = {} as any;
@@ -271,5 +285,141 @@ describe('AgentService', () => {
       expect(result?.model).toBe('claude-3');
       expect(result?.provider).toBe('anthropic');
     });
+
+    describe('Redis welcome data integration', () => {
+      const mockRedisGet = vi.fn();
+      const mockRedisClient = { get: mockRedisGet };
+
+      beforeEach(() => {
+        vi.mocked(initializeRedisWithPrefix).mockReset();
+        vi.mocked(isRedisEnabled).mockReset();
+        mockRedisGet.mockReset();
+      });
+
+      it('should merge Redis welcome data when available', async () => {
+        const mockAgent = {
+          id: 'agent-1',
+          model: 'gpt-4',
+        };
+        const welcomeData = {
+          openQuestions: ['Question 1?', 'Question 2?'],
+          welcomeMessage: 'Hello from Redis!',
+        };
+
+        const mockAgentModel = {
+          getAgentConfigById: vi.fn().mockResolvedValue(mockAgent),
+        };
+
+        (AgentModel as any).mockImplementation(() => mockAgentModel);
+        (parseAgentConfig as any).mockReturnValue({});
+        vi.mocked(isRedisEnabled).mockReturnValue(true);
+        vi.mocked(initializeRedisWithPrefix).mockResolvedValue(mockRedisClient as any);
+        mockRedisGet.mockResolvedValue(JSON.stringify(welcomeData));
+
+        const newService = new AgentService(mockDb, mockUserId);
+        const result = await newService.getAgentConfigById('agent-1');
+
+        expect(result?.openingMessage).toBe('Hello from Redis!');
+        expect(result?.openingQuestions).toEqual(['Question 1?', 'Question 2?']);
+        expect(mockRedisGet).toHaveBeenCalledWith(RedisKeys.aiGeneration.agentWelcome('agent-1'));
+      });
+
+      it('should return normal config when Redis is disabled', async () => {
+        const mockAgent = {
+          id: 'agent-1',
+          model: 'gpt-4',
+          openingMessage: 'Default message',
+        };
+
+        const mockAgentModel = {
+          getAgentConfigById: vi.fn().mockResolvedValue(mockAgent),
+        };
+
+        (AgentModel as any).mockImplementation(() => mockAgentModel);
+        (parseAgentConfig as any).mockReturnValue({});
+        vi.mocked(isRedisEnabled).mockReturnValue(false);
+
+        const newService = new AgentService(mockDb, mockUserId);
+        const result = await newService.getAgentConfigById('agent-1');
+
+        // Should keep original config, not override with Redis data
+        expect(result?.openingMessage).toBe('Default message');
+        // openingQuestions comes from DEFAULT_AGENT_CONFIG (empty array)
+        expect(result?.openingQuestions).toEqual([]);
+        expect(initializeRedisWithPrefix).not.toHaveBeenCalled();
+      });
+
+      it('should return normal config when Redis key does not exist', async () => {
+        const mockAgent = {
+          id: 'agent-1',
+          model: 'gpt-4',
+        };
+
+        const mockAgentModel = {
+          getAgentConfigById: vi.fn().mockResolvedValue(mockAgent),
+        };
+
+        (AgentModel as any).mockImplementation(() => mockAgentModel);
+        (parseAgentConfig as any).mockReturnValue({});
+        vi.mocked(isRedisEnabled).mockReturnValue(true);
+        vi.mocked(initializeRedisWithPrefix).mockResolvedValue(mockRedisClient as any);
+        mockRedisGet.mockResolvedValue(null);
+
+        const newService = new AgentService(mockDb, mockUserId);
+        const result = await newService.getAgentConfigById('agent-1');
+
+        // No Redis welcome data, so openingMessage remains from DEFAULT_AGENT_CONFIG
+        expect(result?.openingMessage).toBeUndefined();
+        // openingQuestions comes from DEFAULT_AGENT_CONFIG (empty array)
+        expect(result?.openingQuestions).toEqual([]);
+      });
+
+      it('should gracefully fallback when Redis throws error', async () => {
+        const mockAgent = {
+          id: 'agent-1',
+          model: 'gpt-4',
+        };
+
+        const mockAgentModel = {
+          getAgentConfigById: vi.fn().mockResolvedValue(mockAgent),
+        };
+
+        (AgentModel as any).mockImplementation(() => mockAgentModel);
+        (parseAgentConfig as any).mockReturnValue({});
+        vi.mocked(isRedisEnabled).mockReturnValue(true);
+        vi.mocked(initializeRedisWithPrefix).mockRejectedValue(new Error('Redis connection failed'));
+
+        const newService = new AgentService(mockDb, mockUserId);
+        const result = await newService.getAgentConfigById('agent-1');
+
+        // Should return normal config without error
+        expect(result?.id).toBe('agent-1');
+        expect(result?.model).toBe('gpt-4');
+      });
+
+      it('should gracefully handle invalid JSON in Redis', async () => {
+        const mockAgent = {
+          id: 'agent-1',
+          model: 'gpt-4',
+        };
+
+        const mockAgentModel = {
+          getAgentConfigById: vi.fn().mockResolvedValue(mockAgent),
+        };
+
+        (AgentModel as any).mockImplementation(() => mockAgentModel);
+        (parseAgentConfig as any).mockReturnValue({});
+        vi.mocked(isRedisEnabled).mockReturnValue(true);
+        vi.mocked(initializeRedisWithPrefix).mockResolvedValue(mockRedisClient as any);
+        mockRedisGet.mockResolvedValue('invalid json {');
+
+        const newService = new AgentService(mockDb, mockUserId);
+        const result = await newService.getAgentConfigById('agent-1');
+
+        // Should return normal config without error
+        expect(result?.id).toBe('agent-1');
+        expect(result?.openingMessage).toBeUndefined();
+      });
+    });
   });
 });

package/src/server/services/agent/index.ts

@@ -3,15 +3,25 @@ import { DEFAULT_AGENT_CONFIG } from '@lobechat/const';
 import { type LobeChatDatabase } from '@lobechat/database';
 import { type AgentItem, type LobeAgentConfig } from '@lobechat/types';
 import { cleanObject, merge } from '@lobechat/utils';
+import debug from 'debug';
 import type { PartialDeep } from 'type-fest';
 
 import { AgentModel } from '@/database/models/agent';
 import { SessionModel } from '@/database/models/session';
 import { UserModel } from '@/database/models/user';
+import { getRedisConfig } from '@/envs/redis';
+import { RedisKeyNamespace, RedisKeys, initializeRedisWithPrefix, isRedisEnabled } from '@/libs/redis';
 import { getServerDefaultAgentConfig } from '@/server/globalConfig';
 
 import { type UpdateAgentResult } from './type';
 
+const log = debug('lobe-agent:service');
+
+interface AgentWelcomeData {
+  openQuestions: string[];
+  welcomeMessage: string;
+}
+
 /**
  * Agent Service
  *
@@ -76,13 +86,52 @@ export class AgentService {
    * 2. Server's globalDefaultAgentConfig (from environment variable DEFAULT_AGENT_CONFIG)
    * 3. User's defaultAgentConfig (from user settings)
    * 4. The actual agent config from database
+   * 5. AI-generated welcome data from Redis (if available)
    */
   async getAgentConfigById(agentId: string) {
-    const [agent, defaultAgentConfig] = await Promise.all([
+    const [agent, defaultAgentConfig, welcomeData] = await Promise.all([
       this.agentModel.getAgentConfigById(agentId),
       this.userModel.getUserSettingsDefaultAgentConfig(),
+      this.getAgentWelcomeFromRedis(agentId),
     ]);
-    return this.mergeDefaultConfig(agent, defaultAgentConfig);
+
+    const config = this.mergeDefaultConfig(agent, defaultAgentConfig);
+    if (!config) return null;
+
+    // Merge AI-generated welcome data if available
+    if (welcomeData) {
+      return {
+        ...config,
+        openingMessage: welcomeData.welcomeMessage,
+        openingQuestions: welcomeData.openQuestions,
+      };
+    }
+
+    return config;
+  }
+
+  /**
+   * Get AI-generated welcome data from Redis
+   * Returns null if Redis is disabled or data doesn't exist
+   */
+  private async getAgentWelcomeFromRedis(agentId: string): Promise<AgentWelcomeData | null> {
+    try {
+      const redisConfig = getRedisConfig();
+      if (!isRedisEnabled(redisConfig)) return null;
+
+      const redis = await initializeRedisWithPrefix(redisConfig, RedisKeyNamespace.AI_GENERATION);
+      if (!redis) return null;
+
+      const key = RedisKeys.aiGeneration.agentWelcome(agentId);
+      const value = await redis.get(key);
+      if (!value) return null;
+
+      return JSON.parse(value) as AgentWelcomeData;
+    } catch (error) {
+      // Log error for observability but don't break agent retrieval
+      log('Failed to get agent welcome from Redis for agent %s: %O', agentId, error);
+      return null;
+    }
   }
 
   /**

package/src/utils/identifier.test.ts

@@ -0,0 +1,103 @@
+import { describe, expect, it } from 'vitest';
+
+import { standardizeIdentifier } from './identifier';
+
+describe('standardizeIdentifier', () => {
+  describe('extracting ID from prefixed identifiers', () => {
+    it('should extract ID from docs_ prefix', () => {
+      expect(standardizeIdentifier('docs_123')).toBe('123');
+    });
+
+    it('should extract ID from agt_ prefix', () => {
+      expect(standardizeIdentifier('agt_456')).toBe('456');
+    });
+
+    it('should extract ID from any custom prefix', () => {
+      expect(standardizeIdentifier('custom_789')).toBe('789');
+    });
+
+    it('should extract ID from identifier with multiple underscores', () => {
+      // split('_')[1] only takes the second part, so 'docs_abc_def_123' becomes 'abc'
+      expect(standardizeIdentifier('docs_abc_def_123')).toBe('abc');
+    });
+
+    it('should handle numeric IDs', () => {
+      expect(standardizeIdentifier('docs_12345')).toBe('12345');
+    });
+
+    it('should handle alphanumeric IDs', () => {
+      expect(standardizeIdentifier('agt_abc123xyz')).toBe('abc123xyz');
+    });
+  });
+
+  describe('adding prefix to plain identifiers', () => {
+    it('should add docs prefix when specified', () => {
+      expect(standardizeIdentifier('123', 'docs')).toBe('docs_123');
+    });
+
+    it('should add agt prefix when specified', () => {
+      expect(standardizeIdentifier('456', 'agt')).toBe('agt_456');
+    });
+
+    it('should add prefix to alphanumeric identifier', () => {
+      expect(standardizeIdentifier('abc123', 'docs')).toBe('docs_abc123');
+    });
+
+    it('should add prefix to string identifier', () => {
+      expect(standardizeIdentifier('my-identifier', 'agt')).toBe('agt_my-identifier');
+    });
+  });
+
+  describe('returning identifier unchanged', () => {
+    it('should return plain identifier unchanged when no prefix specified', () => {
+      expect(standardizeIdentifier('123')).toBe('123');
+    });
+
+    it('should return plain alphanumeric identifier unchanged when no prefix specified', () => {
+      expect(standardizeIdentifier('abc123')).toBe('abc123');
+    });
+
+    it('should return plain string identifier unchanged when no prefix specified', () => {
+      expect(standardizeIdentifier('my-identifier')).toBe('my-identifier');
+    });
+  });
+
+  describe('edge cases', () => {
+    it('should handle empty string', () => {
+      expect(standardizeIdentifier('')).toBe('');
+    });
+
+    it('should handle empty string with prefix', () => {
+      expect(standardizeIdentifier('', 'docs')).toBe('docs_');
+    });
+
+    it('should handle identifier with only underscore', () => {
+      expect(standardizeIdentifier('_')).toBe('');
+    });
+
+    it('should handle identifier starting with underscore', () => {
+      // '_123' splits to ['', '123'], so [1] returns '123'
+      expect(standardizeIdentifier('_123')).toBe('123');
+    });
+
+    it('should handle identifier ending with underscore', () => {
+      expect(standardizeIdentifier('docs_')).toBe('');
+    });
+
+    it('should prioritize extraction over prefix addition when underscore present', () => {
+      // Even with prefix parameter, if underscore exists, it extracts
+      expect(standardizeIdentifier('docs_123', 'agt')).toBe('123');
+    });
+
+    it('should handle UUID-like identifiers', () => {
+      const uuid = '550e8400-e29b-41d4-a716-446655440000';
+      expect(standardizeIdentifier(uuid)).toBe(uuid);
+      expect(standardizeIdentifier(uuid, 'docs')).toBe(`docs_${uuid}`);
+    });
+
+    it('should handle very long identifiers', () => {
+      const longId = 'a'.repeat(1000);
+      expect(standardizeIdentifier(longId, 'docs')).toBe(`docs_${longId}`);
+    });
+  });
+});