@lobehub/lobehub 2.0.0-next.353 → 2.0.0-next.355

package/GEMINI.md

@@ -1,64 +1,72 @@
 # GEMINI.md
 
-This document serves as a shared guideline for all team members when using Gemini CLI in this repository.
+Guidelines for using Gemini CLI in this LobeChat repository.
 
 ## Tech Stack
 
-read @.cursor/rules/project-introduce.mdc
-
-## Directory Structure
-
-read @.cursor/rules/project-structure.mdc
+- Next.js 16 + React 19 + TypeScript
+- SPA inside Next.js with `react-router-dom`
+- `@lobehub/ui`, antd for components; antd-style for CSS-in-JS
+- react-i18next for i18n; zustand for state management
+- SWR for data fetching; TRPC for type-safe backend
+- Drizzle ORM with PostgreSQL; Vitest for testing
+
+## Project Structure
+
+```
+lobe-chat/
+├── apps/desktop/           # Electron desktop app
+├── packages/               # Shared packages (@lobechat/*)
+│   ├── database/           # Database schemas, models, repositories
+│   ├── agent-runtime/      # Agent runtime
+│   └── ...
+├── src/
+│   ├── app/                # Next.js app router
+│   ├── store/              # Zustand stores
+│   ├── services/           # Client services
+│   ├── server/             # Server services and routers
+│   └── ...
+└── e2e/                    # E2E tests (Cucumber + Playwright)
+```
 
 ## Development
 
 ### Git Workflow
 
-- use rebase for git pull
-- git commit message should prefix with gitmoji
-- git branch name format template: <type>/<feature-name>
-- use .github/PULL_REQUEST_TEMPLATE.md to generate pull request description
-- PR titles starting with `✨ feat/` or `🐛 fix` will trigger the release workflow upon merge. Only use these prefixes for significant user-facing feature changes or bug fixes
+- Use rebase for `git pull`
+- Commit messages: prefix with gitmoji
+- Branch format: `<type>/<feature-name>`
+- PR titles with `✨ feat/` or `🐛 fix` trigger releases
 
 ### Package Management
 
-This repository adopts a monorepo structure.
-
-- Use `pnpm` as the primary package manager for dependency management
-- Use `bun` to run npm scripts
-- Use `bunx` to run executable npm packages
-
-### TypeScript Code Style Guide
-
-see @.cursor/rules/typescript.mdc
+- `pnpm` for dependency management
+- `bun` to run npm scripts
+- `bunx` for executable npm packages
 
 ### Testing
 
-- **Required Rule**: read `.cursor/rules/testing-guide/testing-guide.mdc` before writing tests
-- **Command**:
-  - web: `bunx vitest run --silent='passed-only' '[file-path-pattern]'`
-  - packages(eg: database): `cd packages/database && bunx vitest run --silent='passed-only' '[file-path-pattern]'`
-
-**Important**:
-
-- wrap the file path in single quotes to avoid shell expansion
-- Never run `bun run test` etc to run tests, this will run all tests and cost about 10mins
-- If trying to fix the same test twice, but still failed, stop and ask for help.
+```bash
+# Run specific test (NEVER run `bun run test` - takes ~10 minutes)
+bunx vitest run --silent='passed-only' '[file-path]'
 
-### Typecheck
+# Database package
+cd packages/database && bunx vitest run --silent='passed-only' '[file]'
+```
 
-- use `bun run type-check` to check type errors.
+- Tests must pass type check: `bun run type-check`
+- After 2 failed fix attempts, stop and ask for help
 
 ### i18n
 
-- **Keys**: Add to `src/locales/default/namespace.ts`
-- **Dev**: Translate `locales/zh-CN/namespace.json` and `locales/en-US/namespace.json` locales file only for dev preview
-- DON'T run `pnpm i18n`, let CI auto handle it
+- Add keys to `src/locales/default/namespace.ts`
+- For dev preview: translate `locales/zh-CN/` and `locales/en-US/`
+- Don't run `pnpm i18n` - CI handles it
 
-## 🚨 Quality Checks
+## Quality Checks
 
-**MANDATORY**: After completing code changes, always run `mcp__vscode-mcp__get_diagnostics` on the modified files to identify any errors introduced by your changes and fix them.
+**MANDATORY**: After completing code changes, run diagnostics on modified files to identify and fix any errors.
 
-## Rules Index
+## Skills (Auto-loaded)
 
-Some useful project rules are listed in @.cursor/rules/rules-index.mdc
+Skills are available in `.agents/skills/` directory. See CLAUDE.md for the full list.

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Fix favorite refresh bug and group topic refresh issue."
+      ]
+    },
+    "date": "2026-01-23",
+    "version": "2.0.0-next.355"
+  },
+  {
+    "children": {
+      "improvements": [
+        "Migrate AI Rules to Claude Code Skills."
+      ]
+    },
+    "date": "2026-01-23",
+    "version": "2.0.0-next.354"
+  },
   {
     "children": {},
     "date": "2026-01-23",

package/locales/en-US/plugin.json

@@ -177,6 +177,9 @@
   "builtins.lobe-user-memory.apiName.searchUserMemory": "Search memory",
   "builtins.lobe-user-memory.apiName.updateIdentityMemory": "Update identity memory",
   "builtins.lobe-user-memory.inspector.noResults": "No results",
+  "builtins.lobe-user-memory.render.contexts": "Contexts",
+  "builtins.lobe-user-memory.render.experiences": "Experiences",
+  "builtins.lobe-user-memory.render.preferences": "Preferences",
   "builtins.lobe-user-memory.title": "Memory",
   "builtins.lobe-web-browsing.apiName.crawlMultiPages": "Read multiple pages",
   "builtins.lobe-web-browsing.apiName.crawlSinglePage": "Read page content",

package/locales/zh-CN/plugin.json

@@ -177,6 +177,9 @@
   "builtins.lobe-user-memory.apiName.searchUserMemory": "搜索记忆",
   "builtins.lobe-user-memory.apiName.updateIdentityMemory": "更新身份记忆",
   "builtins.lobe-user-memory.inspector.noResults": "无结果",
+  "builtins.lobe-user-memory.render.contexts": "情境",
+  "builtins.lobe-user-memory.render.experiences": "经验",
+  "builtins.lobe-user-memory.render.preferences": "偏好",
   "builtins.lobe-user-memory.title": "记忆",
   "builtins.lobe-web-browsing.apiName.crawlMultiPages": "读取多个页面内容",
   "builtins.lobe-web-browsing.apiName.crawlSinglePage": "读取页面内容",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.353",
+  "version": "2.0.0-next.355",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/builtin-tool-memory/src/client/Render/SearchUserMemory/index.tsx

@@ -6,8 +6,6 @@ import { createStaticStyles } from 'antd-style';
 import { memo } from 'react';
 import { useTranslation } from 'react-i18next';
 
-import { highlightTextStyles } from '@/styles';
-
 import type { SearchMemoryParams, SearchUserMemoryState } from '../../../types';
 
 const styles = createStaticStyles(({ css, cssVar }) => ({
@@ -120,9 +118,7 @@ const SearchUserMemoryRender = memo<BuiltinRenderProps<SearchMemoryParams, Searc
               paddingInline={12}
               title={
                 <Text className={styles.sectionHeader}>
-                  <span className={highlightTextStyles.info}>
-                    {t('builtins.lobe-user-memory.render.contexts' as any)}
-                  </span>
+                  <span>{t('builtins.lobe-user-memory.render.contexts')}</span>
                   <Text as={'span'} type={'secondary'}>
                     {' '}
                     ({contexts.length})
@@ -152,9 +148,7 @@ const SearchUserMemoryRender = memo<BuiltinRenderProps<SearchMemoryParams, Searc
               paddingInline={12}
               title={
                 <Text className={styles.sectionHeader}>
-                  <span className={highlightTextStyles.gold}>
-                    {t('builtins.lobe-user-memory.render.experiences' as any)}
-                  </span>
+                  <span>{t('builtins.lobe-user-memory.render.experiences')}</span>
                   <Text as={'span'} type={'secondary'}>
                     {' '}
                     ({experiences.length})
@@ -184,9 +178,7 @@ const SearchUserMemoryRender = memo<BuiltinRenderProps<SearchMemoryParams, Searc
               paddingInline={12}
               title={
                 <Text className={styles.sectionHeader}>
-                  <span className={highlightTextStyles.warning}>
-                    {t('builtins.lobe-user-memory.render.preferences' as any)}
-                  </span>
+                  <span>{t('builtins.lobe-user-memory.render.preferences')}</span>
                   <Text as={'span'} type={'secondary'}>
                     {' '}
                     ({preferences.length})

package/packages/context-engine/src/engine/messages/MessagesEngine.ts

@@ -9,7 +9,6 @@ import {
   GroupMessageFlattenProcessor,
   GroupOrchestrationFilterProcessor,
   GroupRoleTransformProcessor,
-  HistoryTruncateProcessor,
   InputTemplateProcessor,
   MessageCleanupProcessor,
   MessageContentProcessor,
@@ -113,8 +112,6 @@ export class MessagesEngine {
       provider,
       systemRole,
       inputTemplate,
-      enableHistoryCount,
-      historyCount,
       historySummary,
       formatHistorySummary,
       knowledge,
@@ -145,16 +142,6 @@ export class MessagesEngine {
     const isGTDTodoEnabled = gtd?.enabled && gtd?.todos;
 
     return [
-      // =============================================
-      // Phase 1: History Management
-      // =============================================
-
-      // 1. History truncation (MUST be first, before any message injection)
-      new HistoryTruncateProcessor({
-        enableHistoryCount,
-        historyCount,
-      }),
-
       // =============================================
       // Phase 2: System Role Injection
       // =============================================

package/packages/context-engine/src/engine/messages/__tests__/MessagesEngine.test.ts

@@ -113,31 +113,6 @@ describe('MessagesEngine', () => {
       expect(result.messages[0].content).toBe(systemRole);
     });
 
-    it('should truncate history when enabled', async () => {
-      const messages: UIChatMessage[] = [];
-      for (let i = 0; i < 20; i++) {
-        messages.push({
-          content: `Message ${i}`,
-          createdAt: Date.now(),
-          id: `msg-${i}`,
-          role: i % 2 === 0 ? 'user' : 'assistant',
-          updatedAt: Date.now(),
-        } as UIChatMessage);
-      }
-
-      const params = createBasicParams({
-        enableHistoryCount: true,
-        historyCount: 5,
-        messages,
-      });
-      const engine = new MessagesEngine(params);
-
-      const result = await engine.process();
-
-      // Should have truncated to 5 messages
-      expect(result.messages.length).toBeLessThanOrEqual(5);
-    });
-
     it('should inject history summary when provided', async () => {
       const historySummary = 'We discussed AI and machine learning';
       const params = createBasicParams({ historySummary });

package/packages/database/src/models/__tests__/topics/topic.create.test.ts

@@ -1,4 +1,4 @@
-import { eq, inArray } from 'drizzle-orm';
+import { asc, eq, inArray } from 'drizzle-orm';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
 import { getTestDB } from '../../../core/getTestDB';
@@ -188,12 +188,12 @@ describe('TopicModel - Create', () => {
         userId,
       });
 
-      const items = await serverDB.select().from(topics);
+      const items = await serverDB.select().from(topics).orderBy(asc(topics.title));
       expect(items).toHaveLength(2);
       expect(items[0]).toMatchObject({ title: 'Topic 1', favorite: true, sessionId, userId });
       expect(items[1]).toMatchObject({ title: 'Topic 2', favorite: false, sessionId, userId });
 
-      const updatedMessages = await serverDB.select().from(messages);
+      const updatedMessages = await serverDB.select().from(messages).orderBy(asc(messages.id));
       expect(updatedMessages).toHaveLength(3);
       expect(updatedMessages[0].topicId).toBe(createdTopics[0].id);
       expect(updatedMessages[1].topicId).toBe(createdTopics[0].id);

package/src/app/[variants]/(main)/agent/_layout/Sidebar/Topic/List/Item/index.tsx

@@ -110,6 +110,7 @@ const TopicItem = memo<TopicItemProps>(({ id, title, fav, active, threadId }) =>
             fill={fav ? cssVar.colorWarning : 'transparent'}
             icon={Star}
             onClick={(e) => {
+              e.preventDefault();
               e.stopPropagation();
               favoriteTopic(id, !fav);
             }}

package/src/app/[variants]/(main)/agent/features/Conversation/ConversationArea.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { Flexbox } from '@lobehub/ui';
+import debug from 'debug';
 import { Suspense, memo, useMemo } from 'react';
 
 import ChatMiniMap from '@/features/ChatMiniMap';
@@ -18,6 +19,8 @@ import ThreadHydration from './ThreadHydration';
 import { useActionsBarConfig } from './useActionsBarConfig';
 import { useAgentContext } from './useAgentContext';
 
+const log = debug('lobe-render:agent:ConversationArea');
+
 /**
  * ConversationArea
  *
@@ -35,6 +38,7 @@ const Conversation = memo(() => {
   );
   const replaceMessages = useChatStore((s) => s.replaceMessages);
   const messages = useChatStore((s) => s.dbMessagesMap[chatKey]);
+  log('contextKey %s: %o', chatKey, messages);
 
   // Get operation state from ChatStore for reactive updates
   const operationState = useOperationState(context);

package/src/app/[variants]/(main)/group/_layout/Sidebar/Topic/List/Item/index.tsx

@@ -111,6 +111,7 @@ const TopicItem = memo<TopicItemProps>(({ id, title, fav, active, threadId }) =>
             fill={fav ? cssVar.colorWarning : 'transparent'}
             icon={Star}
             onClick={(e) => {
+              e.preventDefault();
               e.stopPropagation();
               favoriteTopic(id, !fav);
             }}

package/src/app/[variants]/(main)/home/_layout/Body/Agent/List/AgentItem/index.tsx

@@ -106,7 +106,7 @@ const AgentItem = memo<AgentItemProps>(({ item, style, className }) => {
 
   return (
     <>
-      <Link aria-label={id} to={agentUrl}>
+      <Link aria-label={displayTitle} to={agentUrl}>
         <NavItem
           actions={<Actions dropdownMenu={dropdownMenu} />}
           className={className}

package/src/app/[variants]/(main)/home/_layout/Body/Agent/List/InboxItem.tsx

@@ -2,8 +2,8 @@
 
 import { DEFAULT_INBOX_AVATAR, SESSION_CHAT_URL } from '@lobechat/const';
 import { Avatar } from '@lobehub/ui';
-import { type CSSProperties, memo, useCallback } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { type CSSProperties, memo } from 'react';
+import { Link } from 'react-router-dom';
 
 import NavItem from '@/features/NavPanel/components/NavItem';
 import { useAgentStore } from '@/store/agent';
@@ -17,38 +17,28 @@ interface InboxItemProps {
 }
 
 const InboxItem = memo<InboxItemProps>(({ className, style }) => {
-  const navigate = useNavigate();
-
   const inboxAgentId = useAgentStore(builtinAgentSelectors.inboxAgentId);
-  const activeAgentId = useAgentStore((s) => s.activeAgentId);
-  const isActive = !!inboxAgentId && activeAgentId === inboxAgentId;
 
-  const isLoading = useChatStore(
-    useCallback(
-      (s) => (isActive ? operationSelectors.isAgentRuntimeRunning(s) : false),
-      [isActive],
-    ),
-  );
+  const isLoading = useChatStore(operationSelectors.isAgentRuntimeRunning);
   const inboxAgentTitle = 'Lobe AI';
 
-  const handleClick = useCallback(() => {
-    if (inboxAgentId) {
-      navigate(SESSION_CHAT_URL(inboxAgentId, false));
-    }
-  }, [inboxAgentId, navigate]);
-
   return (
-    <NavItem
-      active={isActive}
-      className={className}
-      icon={
-        <Avatar avatar={DEFAULT_INBOX_AVATAR} emojiScaleWithBackground shape={'square'} size={24} />
-      }
-      loading={isLoading}
-      onClick={handleClick}
-      style={style}
-      title={inboxAgentTitle}
-    />
+    <Link aria-label={inboxAgentTitle} to={SESSION_CHAT_URL(inboxAgentId, false)}>
+      <NavItem
+        className={className}
+        icon={
+          <Avatar
+            avatar={DEFAULT_INBOX_AVATAR}
+            emojiScaleWithBackground
+            shape={'square'}
+            size={24}
+          />
+        }
+        loading={isLoading}
+        style={style}
+        title={inboxAgentTitle}
+      />
+    </Link>
   );
 });
 

package/src/app/[variants]/(main)/home/_layout/Body/Agent/List/List.tsx

@@ -4,6 +4,7 @@ import { MoreHorizontal } from 'lucide-react';
 import { type CSSProperties, memo, useMemo } from 'react';
 import { useTranslation } from 'react-i18next';
 
+import EmptyNavItem from '@/features/NavPanel/components/EmptyNavItem';
 import NavItem from '@/features/NavPanel/components/NavItem';
 import { useGlobalStore } from '@/store/global';
 import { systemStatusSelectors } from '@/store/global/selectors';
@@ -11,7 +12,6 @@ import { useHomeStore } from '@/store/home';
 import { homeAgentListSelectors } from '@/store/home/selectors';
 import { SessionDefaultGroup } from '@/types/session';
 
-import EmptyNavItem from '../../../../../../../../features/NavPanel/components/EmptyNavItem';
 import { useCreateMenuItems } from '../../../hooks';
 import GroupItem from './AgentGroupItem';
 import AgentItem from './AgentItem';

package/src/app/[variants]/(main)/home/_layout/Body/Agent/ModalProvider.tsx

@@ -5,8 +5,8 @@ import { type ReactNode, createContext, memo, useContext, useMemo, useState } fr
 import { ChatGroupWizard } from '@/components/ChatGroupWizard';
 import { MemberSelectionModal } from '@/components/MemberSelectionModal';
 
-import CreateGroupModal from '../../CreateGroupModal';
 import ConfigGroupModal from './Modals/ConfigGroupModal';
+import CreateGroupModal from './Modals/CreateGroupModal';
 
 interface AgentModalContextValue {
   closeAllModals: () => void;

package/src/features/FileViewer/Renderer/PDF/index.tsx

@@ -2,12 +2,11 @@
 
 import { Flexbox } from '@lobehub/ui';
 import { Fragment, memo, useCallback, useState } from 'react';
-import { Document, Page, pdfjs } from 'react-pdf';
 import 'react-pdf/dist/Page/AnnotationLayer.css';
 import 'react-pdf/dist/Page/TextLayer.css';
 
 import NeuralNetworkLoading from '@/components/NeuralNetworkLoading';
-import '@/libs/pdfjs/worker';
+import { Document, Page, pdfjs } from '@/libs/pdfjs';
 import { lambdaQuery } from '@/libs/trpc/client';
 
 import HighlightLayer from './HighlightLayer';
@@ -71,7 +70,7 @@ const PDFViewer = memo<PDFViewerProps>(({ url, fileId }) => {
           onLoadSuccess={onDocumentLoadSuccess}
           options={options}
         >
-          {Array.from({ length: numPages }, (el, index) => {
+          {Array.from({ length: numPages }, (_, index) => {
             const width = containerWidth ? Math.min(containerWidth, maxWidth) : maxWidth;
 
             return (

package/src/features/ShareModal/SharePdf/PdfPreview.tsx

@@ -7,10 +7,9 @@ import { createStaticStyles, cx } from 'antd-style';
 import { ChevronLeft, ChevronRight, Expand, FileText } from 'lucide-react';
 import { memo, useState } from 'react';
 import { useTranslation } from 'react-i18next';
-import { Document, Page } from 'react-pdf';
 
 import { useIsMobile } from '@/hooks/useIsMobile';
-import '@/libs/pdfjs/worker';
+import { Document, Page } from '@/libs/pdfjs';
 
 import { containerStyles } from '../style';
 

package/src/libs/pdfjs/index.tsx

@@ -0,0 +1,25 @@
+'use client';
+
+import type { ComponentProps } from 'react';
+import { Document as PdfDocument, Page as PdfPage, pdfjs } from 'react-pdf';
+
+const workerSrc = `https://registry.npmmirror.com/pdfjs-dist/${pdfjs.version}/files/build/pdf.worker.min.mjs`;
+
+function ensureWorker() {
+  if (!pdfjs.GlobalWorkerOptions.workerSrc) {
+    pdfjs.GlobalWorkerOptions.workerSrc = workerSrc;
+  }
+}
+
+export type DocumentProps = ComponentProps<typeof PdfDocument>;
+export type PageProps = ComponentProps<typeof PdfPage>;
+
+export const Document = (props: DocumentProps) => {
+  ensureWorker();
+  return <PdfDocument {...props} />;
+};
+
+
+
+
+export {Page, pdfjs} from 'react-pdf';

package/src/locales/default/plugin.ts

@@ -178,6 +178,9 @@ export default {
   'builtins.lobe-user-memory.apiName.searchUserMemory': 'Search memory',
   'builtins.lobe-user-memory.apiName.updateIdentityMemory': 'Update identity memory',
   'builtins.lobe-user-memory.inspector.noResults': 'No results',
+  'builtins.lobe-user-memory.render.contexts': 'Contexts',
+  'builtins.lobe-user-memory.render.experiences': 'Experiences',
+  'builtins.lobe-user-memory.render.preferences': 'Preferences',
   'builtins.lobe-user-memory.title': 'Memory',
   'builtins.lobe-web-browsing.apiName.crawlMultiPages': 'Read multiple pages',
   'builtins.lobe-web-browsing.apiName.crawlSinglePage': 'Read page content',

package/src/server/modules/Mecha/ContextEngineering/__tests__/serverMessagesEngine.test.ts

@@ -68,31 +68,6 @@ describe('serverMessagesEngine', () => {
     });
   });
 
-  describe('history truncation', () => {
-    it('should truncate history when enabled', async () => {
-      const messages: UIChatMessage[] = [];
-      for (let i = 0; i < 20; i++) {
-        messages.push({
-          content: `Message ${i}`,
-          createdAt: Date.now(),
-          id: `msg-${i}`,
-          role: i % 2 === 0 ? 'user' : 'assistant',
-          updatedAt: Date.now(),
-        } as UIChatMessage);
-      }
-
-      const result = await serverMessagesEngine({
-        enableHistoryCount: true,
-        historyCount: 5,
-        messages,
-        model: 'gpt-4',
-        provider: 'openai',
-      });
-
-      expect(result.length).toBeLessThanOrEqual(5);
-    });
-  });
-
   describe('knowledge injection', () => {
     it('should inject file contents', async () => {
       const messages = createBasicMessages();