@lobehub/lobehub 2.0.0-next.226 → 2.0.0-next.227

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 2.0.0-next.227](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.226...v2.0.0-next.227)
+
+<sup>Released on **2026-01-06**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Allow zero-byte files and add business hooks for error handling.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Allow zero-byte files and add business hooks for error handling, closes [#11283](https://github.com/lobehub/lobe-chat/issues/11283) ([38f5b78](https://github.com/lobehub/lobe-chat/commit/38f5b78))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.226](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.225...v2.0.0-next.226)
 
 <sup>Released on **2026-01-06**</sup>

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Allow zero-byte files and add business hooks for error handling."
+      ]
+    },
+    "date": "2026-01-06",
+    "version": "2.0.0-next.227"
+  },
   {
     "children": {
       "improvements": [

package/docs/self-hosting/server-database/docker-compose.mdx

@@ -440,6 +440,17 @@ Solutions:
 
 - A straightforward troubleshooting method is to use the `curl` command in the LobeChat container terminal to access your authentication service at `https://auth.example.com/.well-known/openid-configuration`. If JSON format data is returned, it indicates your authentication service is functioning correctly.
 
+#### OAuth Token Exchange Failures with Reverse Proxy
+
+If OAuth authentication fails during the token exchange phase when using Docker behind a reverse proxy, this is typically caused by the default `MIDDLEWARE_REWRITE_THROUGH_LOCAL=1` setting which rewrites URLs to `127.0.0.1:3210`.
+
+**Solution**: Set `MIDDLEWARE_REWRITE_THROUGH_LOCAL=0` in your `.env` file and restart Docker containers:
+
+```bash
+docker compose down
+docker compose up -d
+```
+
 ````markdown
 ## Extended Configuration
 

package/docs/self-hosting/server-database/docker-compose.zh-CN.mdx

@@ -421,6 +421,17 @@ lobe-chat      | [auth][error] TypeError: fetch failed
 
 - 一个直接的排查方式，你可以在 LobeChat 容器的终端中，使用 `curl` 命令访问你的鉴权服务 `https://auth.example.com/.well-known/openid-configuration`，如果返回了 JSON 格式的数据，则说明你的鉴权服务正常运行。
 
+#### 反向代理下 OAuth 令牌交换失败
+
+如果在反向代理后使用 Docker 时 OAuth 认证在令牌交换阶段失败，这通常是由默认的 `MIDDLEWARE_REWRITE_THROUGH_LOCAL=1` 设置引起的，该设置会将 URL 重写为 `127.0.0.1:3210`。
+
+**解决方案**: 在 `.env` 文件中设置 `MIDDLEWARE_REWRITE_THROUGH_LOCAL=0` 并重启 Docker 容器：
+
+```bash
+docker compose down
+docker compose up -d
+```
+
 ## 拓展配置
 
 为了完善你的 LobeChat 服务，你可以根据你的需求进行以下拓展配置。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.226",
+  "version": "2.0.0-next.227",
   "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/model-bank/src/aiModels/lobehub.ts

@@ -860,6 +860,34 @@ const lobehubChatModels: AIChatModelCard[] = [
     releasedAt: '2025-08-26',
     type: 'chat',
   },
+  {
+    abilities: {
+      functionCall: true,
+      reasoning: true,
+      search: true,
+      vision: true,
+    },
+    contextWindowTokens: 256_000,
+    description:
+      'Our newest and strongest flagship model, excelling in NLP, math, and reasoning—an ideal all-rounder.',
+    displayName: 'Grok 4',
+    enabled: true,
+    id: 'grok-4',
+    pricing: {
+      units: [
+        { name: 'textInput_cacheRead', rate: 0.75, strategy: 'fixed', unit: 'millionTokens' },
+        { name: 'textInput', rate: 3, strategy: 'fixed', unit: 'millionTokens' },
+        { name: 'textOutput', rate: 15, strategy: 'fixed', unit: 'millionTokens' },
+      ],
+    },
+    releasedAt: '2025-07-09',
+    settings: {
+      // reasoning_effort is not supported by grok-4. Specifying reasoning_effort parameter will get an error response.
+      // extendParams: ['reasoningEffort'],
+      searchImpl: 'params',
+    },
+    type: 'chat',
+  },
   {
     abilities: {
       imageOutput: true,

package/src/business/client/hooks/useBusinessErrorAlertConfig.ts

@@ -0,0 +1,9 @@
+import type { ErrorType } from '@lobechat/types';
+import type { AlertProps } from '@lobehub/ui';
+
+export default function useBusinessErrorAlertConfig(
+  // eslint-disable-next-line unused-imports/no-unused-vars, @typescript-eslint/no-unused-vars
+  errorType?: ErrorType,
+): AlertProps | undefined {
+  return undefined;
+}

package/src/business/client/hooks/useBusinessErrorContent.ts

@@ -0,0 +1,13 @@
+import type { ErrorType } from '@lobechat/types';
+
+export interface BusinessErrorContentResult {
+  errorType?: string;
+  hideMessage?: boolean;
+}
+
+export default function useBusinessErrorContent(
+  // eslint-disable-next-line unused-imports/no-unused-vars, @typescript-eslint/no-unused-vars
+  errorType?: ErrorType | string,
+): BusinessErrorContentResult {
+  return {};
+}

package/src/business/server/lambda-routers/file.ts

@@ -0,0 +1,12 @@
+export interface BusinessFileUploadCheckParams {
+  actualSize: number;
+  clientIp?: string;
+  inputSize: number;
+  url: string;
+  userId: string;
+}
+
+export async function businessFileUploadCheck(
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  params: BusinessFileUploadCheckParams,
+): Promise<void> {}

package/src/features/Conversation/Error/index.tsx

@@ -7,6 +7,8 @@ import dynamic from 'next/dynamic';
 import { memo, useMemo } from 'react';
 import { useTranslation } from 'react-i18next';
 
+import useBusinessErrorAlertConfig from '@/business/client/hooks/useBusinessErrorAlertConfig';
+import useBusinessErrorContent from '@/business/client/hooks/useBusinessErrorContent';
 import useRenderBusinessChatErrorMessageExtra from '@/business/client/hooks/useRenderBusinessChatErrorMessageExtra';
 import ErrorContent from '@/features/Conversation/ChatItem/components/ErrorContent';
 import { useProviderName } from '@/hooks/useProviderName';
@@ -85,18 +87,26 @@ const getErrorAlertConfig = (
 export const useErrorContent = (error: any) => {
   const { t } = useTranslation('error');
   const providerName = useProviderName(error?.body?.provider || '');
+  const businessAlertConfig = useBusinessErrorAlertConfig(error?.type);
+  const { errorType: businessErrorType, hideMessage } = useBusinessErrorContent(error?.type);
 
   return useMemo<AlertProps | undefined>(() => {
     if (!error) return;
     const messageError = error;
 
-    const alertConfig = getErrorAlertConfig(messageError.type);
+    // Use business alert config if provided, otherwise fall back to default
+    const alertConfig = businessAlertConfig ?? getErrorAlertConfig(messageError.type);
+
+    // Use business error type if provided, otherwise use original
+    const finalErrorType = businessErrorType ?? messageError.type;
 
     return {
-      message: t(`response.${messageError.type}` as any, { provider: providerName }),
+      message: hideMessage
+        ? undefined
+        : t(`response.${finalErrorType}` as any, { provider: providerName }),
       ...alertConfig,
     };
-  }, [error]);
+  }, [businessAlertConfig, businessErrorType, error, hideMessage, providerName, t]);
 };
 
 interface ErrorExtraProps {

package/src/server/routers/lambda/__tests__/file.test.ts

@@ -273,7 +273,7 @@ describe('fileRouter', () => {
       );
     });
 
-    it('should throw error when getFileMetadata fails and input size is less than 1', async () => {
+    it('should throw error when getFileMetadata fails and input size is negative', async () => {
       mockFileModelCheckHash.mockResolvedValue({ isExist: false });
       mockFileServiceGetFileMetadata.mockRejectedValue(new Error('File not found in S3'));
 
@@ -282,11 +282,11 @@ describe('fileRouter', () => {
           hash: 'test-hash',
           fileType: 'text',
           name: 'test.txt',
-          size: 0,
+          size: -1,
           url: 'files/non-existent.txt',
           metadata: {},
         }),
-      ).rejects.toThrow('File size must be at least 1 byte');
+      ).rejects.toThrow('File size cannot be negative');
     });
 
     it('should use input size when getFileMetadata returns contentLength less than 1', async () => {
@@ -315,10 +315,10 @@ describe('fileRouter', () => {
       );
     });
 
-    it('should throw error when both getFileMetadata contentLength and input size are less than 1', async () => {
+    it('should throw error when both getFileMetadata contentLength and input size are negative', async () => {
       mockFileModelCheckHash.mockResolvedValue({ isExist: false });
       mockFileServiceGetFileMetadata.mockResolvedValue({
-        contentLength: 0,
+        contentLength: -1,
         contentType: 'text/plain',
       });
 
@@ -327,11 +327,11 @@ describe('fileRouter', () => {
           hash: 'test-hash',
           fileType: 'text',
           name: 'test.txt',
-          size: 0,
+          size: -1,
           url: 'files/test.txt',
           metadata: {},
         }),
-      ).rejects.toThrow('File size must be at least 1 byte');
+      ).rejects.toThrow('File size cannot be negative');
     });
   });
 

package/src/server/routers/lambda/file.ts

@@ -1,6 +1,7 @@
 import { TRPCError } from '@trpc/server';
 import { z } from 'zod';
 
+import { businessFileUploadCheck } from '@/business/server/lambda-routers/file';
 import { checkFileStorageUsage } from '@/business/server/trpc-middlewares/lambda';
 import { serverDBEnv } from '@/config/db';
 import { AsyncTaskModel } from '@/database/models/asyncTask';
@@ -74,8 +75,16 @@ export const fileRouter = router({
         // If metadata fetch fails, use original size from input
       }
 
-      if (actualSize < 1) {
-        throw new TRPCError({ code: 'BAD_REQUEST', message: 'File size must be at least 1 byte' });
+      await businessFileUploadCheck({
+        actualSize,
+        clientIp: ctx.clientIp ?? undefined,
+        inputSize: input.size,
+        url: input.url,
+        userId: ctx.userId,
+      });
+
+      if (actualSize < 0) {
+        throw new TRPCError({ code: 'BAD_REQUEST', message: 'File size cannot be negative' });
       }
 
       const { id } = await ctx.fileModel.create(
@@ -367,7 +376,7 @@ export const fileRouter = router({
 
     if (!file) return;
 
-    // delele the file from remove from S3 if it is not used by other files
+    // delete the file from S3 if it is not used by other files
     await ctx.fileService.deleteFile(file.url!);
   }),