@lobehub/chat 1.96.17 → 1.96.18

package/.cursor/rules/typescript.mdc

@@ -0,0 +1,19 @@
+---
+description: 
+globs: *.ts,*.tsx,*.mts
+alwaysApply: false
+---
+
+TypeScript Code Style Guide:
+
+- Avoid explicit type annotations when TypeScript can infer types.
+- Avoid defining `any` type variables (e.g., `let a: number;` instead of `let a;`).
+- Use the most accurate type possible (e.g., use `Record<PropertyKey, unknown>` instead of `object`).
+- Prefer `interface` over `type` (e.g., define react component props).
+- Use `as const satisfies XyzInterface` instead of `as const` when suitable
+- import index.ts module(directory module) like `@/db/index` instead of `@/db`
+- Instead of calling Date.now() multiple times, assign it to a constant once and reuse it. This ensures consistency and improves readability
+- Always refactor repeated logic into a reusable function
+- Don't remove meaningful code comments, be sure to keep original comments when providing applied code
+- Update the code comments when needed after you modify the related code
+- Please respect my prettier preferences when you provide code

package/.cursor/rules/zustand-action-patterns.mdc

@@ -87,7 +87,7 @@ internal_dispatchTopic: (payload, action) => {
 
 ### 使用 Reducer 模式的场景
 
-**适用于复杂的数据结构管理**，特别是：
+适用于复杂的数据结构管理，特别是：
 - 管理对象列表或映射（如 `messagesMap`, `topicMaps`）
 - 需要乐观更新的场景
 - 状态转换逻辑复杂
@@ -125,7 +125,7 @@ export const messagesReducer = (state: ChatMessage[], payload: MessageDispatch):
 
 ### 使用简单 `set` 的场景
 
-**适用于简单状态更新**：
+适用于简单状态更新：
 - 切换布尔值
 - 更新简单字符串/数字
 - 设置单一状态字段
@@ -204,6 +204,43 @@ internal_createMessage: async (message, context) => {
 },
 ```
 
+### 删除操作模式（不使用乐观更新）
+
+删除操作通常不适合乐观更新，因为：
+- 删除是破坏性操作，错误恢复复杂
+- 用户对删除操作的即时反馈期望较低
+- 删除失败时恢复原状态会造成困惑
+
+```typescript
+// 删除操作的标准模式 - 无乐观更新
+removeGenerationTopic: async (id: string) => {
+  const { internal_removeGenerationTopic } = get();
+  await internal_removeGenerationTopic(id);
+},
+
+internal_removeGenerationTopic: async (id: string) => {
+  // 1. 显示加载状态
+  get().internal_updateGenerationTopicLoading(id, true);
+  
+  try {
+    // 2. 直接调用后端服务
+    await generationTopicService.deleteTopic(id);
+    
+    // 3. 刷新数据获取最新状态
+    await get().refreshGenerationTopics();
+  } finally {
+    // 4. 确保清除加载状态（无论成功或失败）
+    get().internal_updateGenerationTopicLoading(id, false);
+  }
+},
+```
+
+删除操作的特点：
+- 直接调用服务，不预先更新状态
+- 依赖 loading 状态提供用户反馈
+- 操作完成后刷新整个列表确保一致性
+- 使用 `try/finally` 确保 loading 状态总是被清理
+
 ## 加载状态管理模式
 
 LobeChat 使用统一的加载状态管理模式：
@@ -292,27 +329,32 @@ refreshTopic: async () => {
 ## 命名规范总结
 
 ### Action 命名模式
-- **Public Actions**: 动词形式，描述用户意图
+- Public Actions: 动词形式，描述用户意图
   - `createTopic`, `sendMessage`, `regenerateMessage`
-- **Internal Actions**: `internal_` + 动词，描述内部操作
+- Internal Actions: `internal_` + 动词，描述内部操作
   - `internal_createTopic`, `internal_updateMessageContent`
-- **Dispatch Methods**: `internal_dispatch` + 实体名
+- Dispatch Methods: `internal_dispatch` + 实体名
   - `internal_dispatchTopic`, `internal_dispatchMessage`
-- **Toggle Methods**: `internal_toggle` + 状态名
+- Toggle Methods: `internal_toggle` + 状态名
   - `internal_toggleMessageLoading`, `internal_toggleChatLoading`
 
 ### 状态命名模式
-- **ID 数组**: `[entity]LoadingIds`, `[entity]EditingIds`
-- **映射结构**: `[entity]Maps`, `[entity]Map`
-- **当前激活**: `active[Entity]Id`
-- **初始化标记**: `[entity]sInit`
+- ID 数组: `[entity]LoadingIds`, `[entity]EditingIds`
+- 映射结构: `[entity]Maps`, `[entity]Map`
+- 当前激活: `active[Entity]Id`
+- 初始化标记: `[entity]sInit`
 
 ## 最佳实践
 
-1. **始终实现乐观更新**：对于用户交互频繁的操作
-2. **加载状态管理**：使用统一的加载状态数组管理并发操作
-3. **类型安全**：为所有 action payload 定义 TypeScript 接口
-4. **SWR 集成**：使用 SWR 管理数据获取和缓存失效
-5. **AbortController**：为长时间运行的操作提供取消能力
+1. 合理使用乐观更新：
+   - ✅ 适用：创建、更新操作（用户交互频繁）
+   - ❌ 避免：删除操作（破坏性操作，错误恢复复杂）
+2. 加载状态管理：使用统一的加载状态数组管理并发操作
+3. 类型安全：为所有 action payload 定义 TypeScript 接口
+4. SWR 集成：使用 SWR 管理数据获取和缓存失效
+5. AbortController：为长时间运行的操作提供取消能力
+6. 操作模式选择：
+   - 创建/更新：乐观更新 + 最终一致性
+   - 删除：加载状态 + 服务调用 + 数据刷新
 
 这套 Action 组织模式确保了代码的一致性、可维护性，并提供了优秀的用户体验。

package/.cursor/rules/zustand-slice-organization.mdc

@@ -13,10 +13,10 @@ LobeChat 的 `chat` store (`src/store/chat/`) 采用模块化的 slice 结构来
 
 ### 关键聚合文件
 
-- **`src/store/chat/initialState.ts`**: 聚合所有 slice 的初始状态
-- **`src/store/chat/store.ts`**: 定义顶层的 `ChatStore`，组合所有 slice 的 actions
-- **`src/store/chat/selectors.ts`**: 统一导出所有 slice 的 selectors
-- **`src/store/chat/helpers.ts`**: 提供聊天相关的辅助函数
+- `src/store/chat/initialState.ts`: 聚合所有 slice 的初始状态
+- `src/store/chat/store.ts`: 定义顶层的 `ChatStore`，组合所有 slice 的 actions
+- `src/store/chat/selectors.ts`: 统一导出所有 slice 的 selectors
+- `src/store/chat/helpers.ts`: 提供聊天相关的辅助函数
 
 ### Store 聚合模式
 
@@ -81,7 +81,7 @@ src/store/chat/slices/
 
 ### 文件职责说明
 
-1. **`initialState.ts`**:
+1. `initialState.ts`:
    - 定义 slice 的 TypeScript 状态接口
    - 提供初始状态默认值
 
@@ -104,7 +104,7 @@ export const initialTopicState: ChatTopicState = {
 };
 ```
 
-2. **`reducer.ts`** (复杂状态使用):
+2. `reducer.ts` (复杂状态使用):
    - 定义纯函数 reducer，处理同步状态转换
    - 使用 `immer` 确保不可变更新
 
@@ -150,10 +150,10 @@ export const topicReducer = (state: ChatTopic[] = [], payload: ChatTopicDispatch
 };
 ```
 
-3. **`selectors.ts`**:
+3. `selectors.ts`:
    - 提供状态查询和计算函数
    - 供 UI 组件使用的状态订阅接口
-   - **重要**: 使用 `export const xxxSelectors` 模式聚合所有 selectors
+   - 重要: 使用 `export const xxxSelectors` 模式聚合所有 selectors
 
 ```typescript
 // 典型的 selectors.ts 结构
@@ -277,22 +277,22 @@ export { aiChatSelectors } from './slices/aiChat/selectors';
 
 ## 最佳实践
 
-1. **Slice 划分原则**:
+1. Slice 划分原则:
    - 按功能领域划分（message, topic, aiChat 等）
    - 每个 slice 管理相关的状态和操作
    - 避免 slice 之间的强耦合
 
-2. **文件命名规范**:
+2. 文件命名规范:
    - 使用小驼峰命名 slice 目录
    - 文件名使用一致的模式（action.ts, selectors.ts 等）
    - 复杂 actions 时使用 actions/ 子目录
 
-3. **状态结构设计**:
+3. 状态结构设计:
    - 扁平化的状态结构，避免深层嵌套
    - 使用 Map 结构管理列表数据
    - 分离加载状态和业务数据
 
-4. **类型安全**:
+4. 类型安全:
    - 为每个 slice 定义清晰的 TypeScript 接口
    - 使用 Zustand 的 StateCreator 确保类型一致性
    - 在顶层聚合时保持类型安全

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 # Changelog
 
+### [Version 1.96.18](https://github.com/lobehub/lobe-chat/compare/v1.96.17...v1.96.18)
+
+<sup>Released on **2025-07-06**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Change the wrong github checkmodel name.
+
+#### 💄 Styles
+
+- **misc**: Files hello pages should scroll.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Change the wrong github checkmodel name, closes [#8339](https://github.com/lobehub/lobe-chat/issues/8339) ([f07d912](https://github.com/lobehub/lobe-chat/commit/f07d912))
+
+#### Styles
+
+- **misc**: Files hello pages should scroll, closes [#8340](https://github.com/lobehub/lobe-chat/issues/8340) ([df9b7df](https://github.com/lobehub/lobe-chat/commit/df9b7df))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.96.17](https://github.com/lobehub/lobe-chat/compare/v1.96.16...v1.96.17)
 
 <sup>Released on **2025-07-03**</sup>

package/changelog/v1.json

@@ -1,4 +1,16 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Change the wrong github checkmodel name."
+      ],
+      "improvements": [
+        "Files hello pages should scroll."
+      ]
+    },
+    "date": "2025-07-06",
+    "version": "1.96.18"
+  },
   {
     "children": {},
     "date": "2025-07-03",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.96.17",
+  "version": "1.96.18",
   "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/app/[variants]/(main)/files/(content)/NotSupportClient.tsx

@@ -88,7 +88,14 @@ const NotSupportClient = () => {
   ];
 
   return (
-    <Center gap={40} height={'100%'} width={'100%'}>
+    <Center
+      gap={40}
+      height={'100%'}
+      style={{
+        overflow: 'scroll',
+      }}
+      width={'100%'}
+    >
       <Flexbox className={styles.iconGroup} gap={12} horizontal>
         <Center
           className={styles.icon}

package/src/config/modelProviders/github.ts

@@ -256,7 +256,7 @@ const Github: ModelProviderCard = {
       maxOutput: 4096,
     },
   ],
-  checkModel: 'Phi-3-mini-4k-instruct',
+  checkModel: 'microsoft/Phi-3-mini-4k-instruct',
   // Ref: https://github.blog/news-insights/product-news/introducing-github-models/
   description: '通过GitHub模型，开发人员可以成为AI工程师，并使用行业领先的AI模型进行构建。',
   id: 'github',

package/.cursor/rules/cursor-ux-optimize.mdc

@@ -1,27 +0,0 @@
----
-description: 
-globs: 
-alwaysApply: false
----
-## Formatting Response
-
-This is about how you should format your responses.
-
-### Render Markdown Table
-
-- Be aware that the cursor chat you are in can't render markdown table correctly.
-- IMPORTANT: Tables need to be rendered in plain text and not markdown
-
-When rendering tables, do not use markdown table syntax or plain text alone. Instead, place the entire table inside a code/text block (using triple backticks). This ensures the table formatting is preserved and readable in the chat interface.
-
-Example:
-
-```plaintext
-+----+---------+-----------+
-| ID |  Name   |   Role    |
-+----+---------+-----------+
-| 1  | Alice   | Admin     |
-| 2  | Bob     | User      |
-| 3  | Charlie | Moderator |
-+----+---------+-----------+
-```

package/.cursor/rules/packages/lobe-ui.mdc

@@ -1,72 +0,0 @@
----
-description: @lobehub/ui components list
-globs: 
-alwaysApply: false
----
-## @lobehub/ui Components
-
-- General
-  ActionIcon
-  ActionIconGroup
-  Block
-  Button
-  Icon
-- Data Display
-  Avatar
-  Collapse
-  FileTypeIcon
-  FluentEmoji
-  GuideCard
-  Highlighter
-  Hotkey
-  Image
-  List
-  Markdown
-  MaterialFileTypeIcon
-  Mermaid
-  Segmented
-  Snippet
-  SortableList
-  Tag
-  Tooltip
-  Video
-- Data Entry
-  AutoComplete
-  CodeEditor
-  ColorSwatches
-  CopyButton
-  DatePicker
-  EditableText
-  EmojiPicker
-  Form
-  FormModal
-  HotkeyInput
-  ImageSelect
-  Input
-  SearchBar
-  Select
-  SliderWithInput
-  ThemeSwitch
-- Feedback
-  Alert
-  Drawer
-  Modal
-- Layout
-  DraggablePanel
-  Footer
-  Grid
-  Header
-  Layout
-  MaskShadow
-  ScrollShadow
-- Navigation
-  Burger
-  Dropdown
-  Menu
-  SideNav
-  Tabs
-  Toc
-- Theme
-  ConfigProvider
-  FontLoader
-  ThemeProvider