@lobehub/chat 1.15.1 → 1.15.2

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+### [Version 1.15.2](https://github.com/lobehub/lobe-chat/compare/v1.15.1...v1.15.2)
+
+<sup>Released on **2024-08-30**</sup>
+
+#### 💄 Styles
+
+- **misc**: Update Qwen and Gemini models info.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Styles
+
+- **misc**: Update Qwen and Gemini models info, closes [#3693](https://github.com/lobehub/lobe-chat/issues/3693) ([ba01641](https://github.com/lobehub/lobe-chat/commit/ba01641))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.15.1](https://github.com/lobehub/lobe-chat/compare/v1.15.0...v1.15.1)
 
 <sup>Released on **2024-08-30**</sup>

package/docker-compose/local/.env.example

@@ -6,7 +6,7 @@ LOGTO_CLIENT_SECRET=
 MINIO_ROOT_USER=YOUR_MINIO_USER
 MINIO_ROOT_PASSWORD=YOUR_MINIO_PASSWORD
 
-# 在下方配置 minio 中添加的桶
+# Configure the bucket information of MinIO
 MINIO_LOBE_BUCKET=lobe
 S3_ACCESS_KEY_ID=
 S3_SECRET_ACCESS_KEY=

package/docker-compose/production/.env.example

@@ -1,35 +1,56 @@
-# LobeChat domain
+# Required: LobeChat domain for tRPC calls
+# Ensure this domain is whitelisted in your NextAuth providers and S3 service CORS settings
 APP_URL=https://lobe.example.com/
 
-# Postgres related, which are the necessary environment variables for DB
-# Key used to encrypt sensitive information; can be generated using openssl rand -base64 32
+# Postgres related environment variables
+# Required: Secret key for encrypting sensitive information. Generate with: openssl rand -base64 32
 KEY_VAULTS_SECRET=Kix2wcUONd4CX51E/ZPAd36BqM4wzJgKjPtz2sGztqQ=
-# Postgres database connection string
-# Format: postgres://username:password@host:port/dbname; if your pg instance is a Docker container, use the container name
+# Required: Postgres database connection string
+# Format: postgresql://username:password@host:port/dbname
+# If using Docker, you can use the container name as the host
 DATABASE_URL=postgresql://postgres:uWNZugjBqixf8dxC@postgresql:5432/postgres
 
-# NEXT_AUTH related; can use auth0, Azure AD, GitHub, Authentik, Zitadel, Logto, etc. If you have other integration requests, feel free to submit a PR.
-# Here we take Logto as an example
+# NEXT_AUTH related environment variables
+# Supports auth0, Azure AD, GitHub, Authentik, Zitadel, Logto, etc.
+# For supported providers, see: https://lobehub.com/docs/self-hosting/advanced/auth#next-auth
+# If you have ACCESS_CODE, please remove it. We use NEXT_AUTH as the sole authentication source
+# Required: NextAuth secret key. Generate with: openssl rand -base64 32
 NEXT_AUTH_SECRET=NX2kaPE923dt6BL2U8e9oSre5RfoT7hg
+# Required: Specify the authentication provider (e.g., Logto)
 NEXT_AUTH_SSO_PROVIDERS=logto
+# Required: NextAuth URL for callbacks
 NEXTAUTH_URL=https://lobe.example.com/api/auth
+
+# NextAuth providers configuration (example using Logto)
+# For other providers, see: https://lobehub.com/docs/self-hosting/environment-variables/auth
 LOGTO_CLIENT_ID=YOUR_LOGTO_CLIENT_ID
 LOGTO_CLIENT_SECRET=YOUR_LOGTO_CLIENT_SECRET
 LOGTO_ISSUER=https://lobe-auth-api.example.com/oidc
-# Note: If you have ACCESS_CODE, be sure to clear it. We use NEXT_AUTH as the only authentication source.
-# Proxy, if you need it (e.g., if you use GitHub as an authentication service provider)
+
+# Proxy settings (if needed, e.g., when using GitHub as an auth provider)
 # HTTP_PROXY=http://localhost:7890
 # HTTPS_PROXY=http://localhost:7890
 
-# MinIO S3 configuration
-S3_ACCESS_KEY_ID=YOUR_S3_ACCESS_KEY_ID         # Invalid until manually created in MinIO UI
-S3_SECRET_ACCESS_KEY=YOUR_S3_SECRET_ACCESS_KEY # Invalid until manually created in MinIO UI
+# S3 related environment variables (example using MinIO)
+# Required: S3 Access Key ID (for MinIO, invalid until manually created in MinIO UI)
+S3_ACCESS_KEY_ID=YOUR_S3_ACCESS_KEY_ID
+# Required: S3 Secret Access Key (for MinIO, invalid until manually created in MinIO UI)
+S3_SECRET_ACCESS_KEY=YOUR_S3_SECRET_ACCESS_KEY
+# Required: S3 Endpoint for server/client connections to S3 API
 S3_ENDPOINT=https://lobe-s3-api.example.com
-S3_BUCKET=lobe # Invalid until manually created in MinIO UI
+# Required: S3 Bucket (invalid until manually created in MinIO UI)
+S3_BUCKET=lobe
+# Required: S3 Public Domain for client access to unstructured data
 S3_PUBLIC_DOMAIN=https://lobe-s3-api.example.com
+# Optional: S3 Enable Path Style
+# Use 0 for mainstream S3 cloud providers; use 1 for self-hosted MinIO
+# See: https://lobehub.com/docs/self-hosting/advanced/s3#s-3-enable-path-style
 S3_ENABLE_PATH_STYLE=1
 
-# Other environment variables, as needed. You can refer to the environment variables configuration for the client version, making sure not to have ACCESS_CODE.
+# Other basic environment variables (as needed)
+# See: https://lobehub.com/docs/self-hosting/environment-variables/basic
+# Note: For server versions, the API must support embedding models (OpenAI text-embedding-3-small) for file processing
+# You don't need to specify this model in OPENAI_MODEL_LIST
 # OPEANAI_API_KEY=sk-xxxx
 # OPENAI_PROXY_URL=https://api.openai.com/v1
-# OPENAI_MODEL_LIST=...
+# OPENAI_MODEL_LIST=...

package/docker-compose/production/.env.zh-CN.example

@@ -1,35 +1,55 @@
-# LobeChat 域名
+# 必填，LobeChat 域名，用于 tRPC 调用
+# 请保证此域名在你的 NextAuth 鉴权服务提供商、S3 服务商的 CORS 白名单中
 APP_URL=https://lobe.example.com/
 
-# Postgres 相关，也即 DB 必须的环境变量
-# 用于加密敏感信息的密钥，可以使用 openssl rand -base64 32 生成
+# Postgres 相关，也即 DB 必需的环境变量
+# 必填，用于加密敏感信息的密钥，可以使用 openssl rand -base64 32 生成
 KEY_VAULTS_SECRET=Kix2wcUONd4CX51E/ZPAd36BqM4wzJgKjPtz2sGztqQ=
-# Postgres 数据库连接字符串
-# 格式：postgres://username:password@host:port/dbname，如果你的 pg 实例为 Docker 容器，请使用容器名
+# 必填，Postgres 数据库连接字符串，用于连接到数据库
+# 格式：postgresql://username:password@host:port/dbname，如果你的 pg 实例为 Docker 容器且位于同一 docker-compose 文件中，亦可使用容器名作为 host
 DATABASE_URL=postgresql://postgres:uWNZugjBqixf8dxC@postgresql:5432/postgres
 
-# NEXT_AUTH 相关，可以使用 auth0、Azure AD、GitHub、Authentik、Zitadel、Logto 等，如有其他接入诉求欢迎提 PR
-# 这里以 Logto 为例
+# NEXT_AUTH 相关，也即鉴权服务必需的环境变量
+# 可以使用 auth0、Azure AD、GitHub、Authentik、Zitadel、Logto 等，如有其他接入诉求欢迎提 PR
+# 目前支持的鉴权服务提供商请参考：https://lobehub.com/zh/docs/self-hosting/advanced/auth#next-auth
+# 如果你有 ACCESS_CODE，请务必清空，我们以 NEXT_AUTH 作为唯一鉴权来源
+# 必填，用于 NextAuth 的密钥，可以使用 openssl rand -base64 32 生成
 NEXT_AUTH_SECRET=NX2kaPE923dt6BL2U8e9oSre5RfoT7hg
+# 必填，指定鉴权服务提供商，这里以 Logto 为例
 NEXT_AUTH_SSO_PROVIDERS=logto
+# 必填，NextAuth 的 URL，用于 NextAuth 的回调
 NEXTAUTH_URL=https://lobe.example.com/api/auth
+
+# NextAuth 鉴权服务提供商部分，以 Logto 为例
+# 其他鉴权服务提供商所需的环境变量，请参考：https://lobehub.com/zh/docs/self-hosting/environment-variables/auth
 LOGTO_CLIENT_ID=YOUR_LOGTO_CLIENT_ID
 LOGTO_CLIENT_SECRET=YOUR_LOGTO_CLIENT_SECRET
 LOGTO_ISSUER=https://lobe-auth-api.example.com/oidc
-# 注：如果你有 ACCESS_CODE，请务必清空，我们以 NEXT_AUTH 作为唯一鉴权来源
-# Proxy，如果你需要的话（比如你使用 GitHub 作为鉴权服务提供商）
+
+# 代理相关，如果你需要的话（比如你使用 GitHub 作为鉴权服务提供商）
 # HTTP_PROXY=http://localhost:7890
 # HTTPS_PROXY=http://localhost:7890
 
-# MinIO S3 配置
-S3_ACCESS_KEY_ID=YOUR_S3_ACCESS_KEY_ID         # 直到在 MinIO UI 中手动创建之前都是无效的
-S3_SECRET_ACCESS_KEY=YOUR_S3_SECRET_ACCESS_KEY # 直到在 MinIO UI 中手动创建之前都是无效的
+# S3 相关，也即非结构化数据（文件、图片等）存储必需的环境变量
+# 这里以 MinIO 为例
+# 必填，S3 的 Access Key ID，对于 MinIO 来说，直到在 MinIO UI 中手动创建之前都是无效的
+S3_ACCESS_KEY_ID=YOUR_S3_ACCESS_KEY_ID
+# 必填，S3 的 Secret Access Key，对于 MinIO 来说，直到在 MinIO UI 中手动创建之前都是无效的
+S3_SECRET_ACCESS_KEY=YOUR_S3_SECRET_ACCESS_KEY
+# 必填，S3 的 Endpoint，用于服务端/客户端连接到 S3 API
 S3_ENDPOINT=https://lobe-s3-api.example.com
-S3_BUCKET=lobe # 直到在 MinIO UI 中手动创建之前都是无效的
+# 必填，S3 的 Bucket，直到在 MinIO UI 中手动创建之前都是无效的
+S3_BUCKET=lobe
+# 必填，S3 的 Public Domain，用于客户端通过公开连接访问非结构化数据
 S3_PUBLIC_DOMAIN=https://lobe-s3-api.example.com
+# 选填，S3 的 Enable Path Style
+# 对于主流 S3 Cloud 服务商，一般填 0 即可；对于自部署的 MinIO，请填 1
+# 请参考：https://lobehub.com/zh/docs/self-hosting/advanced/s3#s-3-enable-path-style
 S3_ENABLE_PATH_STYLE=1
 
-# 其他环境变量，视需求而定，可以参照客户端版本的环境变量配置，注意不要有 ACCESS_CODE
+# 其他基础环境变量，视需求而定。注意不要有 ACCESS_CODE
+# 请参考：https://lobehub.com/zh/docs/self-hosting/environment-variables/basic
+# 请注意，对于服务端版本，其 API 必须支持嵌入（即 OpenAI text-embedding-3-small）模型，否则无法对上传文件进行处理，但你无需在 OPENAI_MODEL_LIST 中指定此模型
 # OPEANAI_API_KEY=sk-xxxx
 # OPENAI_PROXY_URL=https://api.openai.com/v1
 # OPENAI_MODEL_LIST=...

package/docs/self-hosting/advanced/auth/next-auth/authelia.zh-CN.mdx

@@ -63,7 +63,7 @@ identity_providers:
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://chat.example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variable#Authelia) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variable#Authelia) 可查阅相关变量详情。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/authentik.zh-CN.mdx

@@ -57,7 +57,7 @@ https://your-domain/api/auth/callback/authentik
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variable#Authentik) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variable#Authentik) 可查阅相关变量详情。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/cloudflare-zero-trust.zh-CN.mdx

@@ -55,7 +55,7 @@ tags:
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://chat.example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variable#Cloudflare%20Zero%20Trust) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variable#Cloudflare%20Zero%20Trust) 可查阅相关变量详情。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/github.zh-CN.mdx

@@ -85,7 +85,7 @@ tags:
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variables/auth#github) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#github) 可查阅相关变量详情。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/logto.zh-CN.mdx

@@ -70,7 +70,7 @@ tags:
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://lobe.example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variables/auth#logto) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#logto) 可查阅相关变量详情。
  
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/microsoft-entra-id.zh-CN.mdx

@@ -76,7 +76,7 @@ https://your-domain/api/auth/callback/azure-ad
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
 
   <Callout type={'tip'}>
-    前往 [📘 环境变量](/docs/self-hosting/environment-variable#microsoft-entra-id) 可查阅相关变量详情。
+    前往 [📘 环境变量](/zh/docs/self-hosting/environment-variable#microsoft-entra-id) 可查阅相关变量详情。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/auth/next-auth/zitadel.zh-CN.mdx

@@ -103,7 +103,7 @@ http(s)://your-domain/api/auth/callback/zitadel
 | `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 中执行 OAuth 认证的回调地址。仅当默认地址不正确时才需要设置。`https://example.com/api/auth` |
 
   <Callout type={'tip'}>
-    您可以在 [📘 环境变量](/docs/self-hosting/environment-variables/auth#zitadel) 中查看相关变量的详细信息。
+    您可以在 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#zitadel) 中查看相关变量的详细信息。
 
 </Callout>
 </Steps>

package/docs/self-hosting/advanced/knowledge-base.mdx

@@ -0,0 +1,53 @@
+# Knowledge Base / File Upload
+
+LobeChat supports file upload and knowledge base management. This feature relies on the following core technical components. Understanding these components will help you successfully deploy and maintain the knowledge base system.
+
+## Core Components
+
+### 1. PostgreSQL and PGVector
+
+PostgreSQL is a powerful open-source relational database system, and PGVector is its extension for vector operations.
+
+- **Purpose**: Store structured data and vector indexes
+- **Deployment Tip**: Use official Docker image for quick deployment
+
+Deployment script example:
+
+```
+docker run -p 5432:5432 -d --name pg -e POSTGRES_PASSWORD=mysecretpassword pgvector/pgvector:pg16
+```
+
+- **Note**: Ensure sufficient resources for vector operations
+
+### 2. S3-compatible Object Storage
+
+S3 (or S3-compatible storage services) is used for storing uploaded files.
+
+- **Purpose**: Store raw files
+- **Options**: AWS S3, MinIO, or other S3-compatible services
+- **Note**: Configure appropriate access permissions and security policies
+
+### 3. OpenAI Embedding
+
+OpenAI's Embedding service is used to convert text into vector representations.
+
+<Callout type={'info'}>
+
+LobeChat currently uses OpenAI's `text-embedding-3-small` model by default. Ensure your API Key has access to this model.
+
+</Callout>
+
+- **Purpose**: Generate vector representations for semantic search
+- **Notes**:
+  - Requires valid OpenAI API key
+  - Implement proper API call limits and error handling
+
+### 4. Unstructured.io (Optional)
+
+Unstructured.io is a powerful document processing tool.
+
+- **Purpose**: Process complex document formats, extract structured information
+- **Use Case**: Handle non-plain text formats like PDF, Word
+- **Note**: Evaluate processing needs based on document complexity
+
+By correctly configuring and integrating these core components, you can build a powerful and efficient knowledge base system for LobeChat. Each component plays a crucial role in the overall architecture, supporting advanced document management and intelligent retrieval functions.

package/docs/self-hosting/advanced/knowledge-base.zh-CN.mdx

@@ -1,6 +1,6 @@
-# 知识库/文件上传
+# 知识库 / 文件上传
 
-LobeChat 支持文件上传/知识库管理。该功能依赖于以下核心技术组件，了解这些组件将有助于你成功部署和维护知识库系统。
+LobeChat 支持文件上传 / 知识库管理。该功能依赖于以下核心技术组件，了解这些组件将有助于你成功部署和维护知识库系统。
 
 ## 核心组件
 
@@ -31,10 +31,16 @@ S3（或兼容 S3 协议的存储服务）用于存储上传的文件。
 
 OpenAI 的嵌入（Embedding）服务用于将文本转化为向量表示。
 
+<Callout type={'info'}>
+
+LobeChat 当前默认使用 OpenAI `text-embedding-3-small` 模型，请确保你的 API Key 可以访问该模型。
+
+</Callout>
+
 - **用途**：生成文本的向量表示，用于语义搜索
 - **注意事项**：
-- 需要有效的 OpenAI API 密钥
-- 实施适当的 API 调用限制和错误处理机制
+  - 需要有效的 OpenAI API 密钥
+  - 实施适当的 API 调用限制和错误处理机制
 
 ### 4. Unstructured.io（可选）
 

package/docs/self-hosting/advanced/model-list.mdx

@@ -12,7 +12,9 @@ tags:
 
 # Model List
 
-LobeChat supports customizing the model list during deployment. This configuration is done in the environment for each [model provider](/docs/self-hosting/environment-variables/model-provider). You can use `+` to add a model, `-` to hide a model, and use `model name=display name<extension configuration>` to customize the display name of a model, separated by English commas. The basic syntax is as follows:
+LobeChat supports customizing the model list during deployment. This configuration is done in the environment for each [model provider](/docs/self-hosting/environment-variables/model-provider). 
+
+You can use `+` to add a model, `-` to hide a model, and use `model name=display name<extension configuration>` to customize the display name of a model, separated by English commas. The basic syntax is as follows:
 
 ```text
 id=displayName<maxToken:vision:fc:file>,model2,model3

package/docs/self-hosting/advanced/model-list.zh-CN.mdx

@@ -11,7 +11,9 @@ tags:
 
 # Model List
 
-LobeChat 支持在部署时自定义模型列表，可以使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。通过 `<>` 来添加扩展配置。基本语法如下：
+LobeChat 支持在部署时自定义模型列表，详情请参考 [模型提供商](/zh/docs/self-hosting/environment-variables/model-provider) 。
+
+你可以使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。通过 `<>` 来添加扩展配置。基本语法如下：
 
 ```text
 id=displayName<maxToken:vision:fc:file>,model2,model3

package/docs/self-hosting/advanced/s3/cloudflare-r2.zh-CN.mdx

@@ -7,6 +7,7 @@ tags:
   - 文件存储
   - 环境变量
 ---
+
 # 配置 Cloudflare R2 存储服务
 
 在服务端数据库中我们需要配置 S3 存储服务来存储文件。
@@ -15,31 +16,32 @@ tags:
 
 <Steps>
 
-    ### 配置并获取 S3 存储桶
+### 配置并获取 S3 存储桶
+
+你需要前往你的 S3 服务提供商（如 AWS S3、Cloudflare R2 等）并创建一个新的存储桶（Bucket）。接下来以 Cloudflare R2 为例，介绍创建流程。
 
-    你需要前往你的 S3 服务提供商（如 AWS S3、Cloudflare R2 等）并创建一个新的存储桶（Bucket）。接下来以 Cloudflare R2 为例，介绍创建流程。
+下图是 Cloudflare R2 的界面：
 
-    下图是 Cloudflare R2 的界面：
+<Image
+  alt={'Cloudflare R2 存储界面'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee'}
+/>
 
-    <Image
-      alt={'Cloudflare R2 存储界面'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee'}
-    ></Image>
+创建存储桶时将指定其名称，然后点击创建。
 
-    创建存储桶时将指定其名称，然后点击创建。
-    <Image
-      alt={'R2 创建存储桶'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'}
-    ></Image>
+<Image
+  alt={'R2 创建存储桶'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'}
+/>
 
-    ### 获取存储桶相关环境变量
+### 获取存储桶相关环境变量
 
-    在 R2 存储桶的设置中，可以看到桶配置的信息：
+在 R2 存储桶的设置中，可以看到桶配置的信息：
 
-    <Image
-      alt={'查看存储桶的相关信息'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'}
-    ></Image>
+<Image
+  alt={'查看存储桶的相关信息'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'}
+/>
 
 其对应的环境变量为：
 
@@ -54,60 +56,60 @@ S3_PUBLIC_DOMAIN=https://s3-for-lobechat.your-domain.com
 
 <Callout type={'warning'}>`S3_ENDPOINT`必须删除其路径，否则会无法访问所上传文件</Callout>
 
-    ### 获取 S3 密钥环境变量
+### 获取 S3 密钥环境变量
 
-    你需要获取 S3 的访问密钥，以便 LobeChat 的服务端有权限访问 S3 存储服务。在 R2 中，你可以在账户详情中配置访问密钥：
+你需要获取 S3 的访问密钥，以便 LobeChat 的服务端有权限访问 S3 存储服务。在 R2 中，你可以在账户详情中配置访问密钥：
 
-    <Image
-      alt={'查看存储桶的访问秘钥'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d'}
-    ></Image>
+<Image
+  alt={'查看存储桶的访问秘钥'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d'}
+/>
 
-    点击右上角按钮创建 API token，进入创建 API Token 页面
+点击右上角按钮创建 API token，进入创建 API Token 页面
 
-    <Image
-      alt={'创建对应 API token'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/7b0ea46c-5157-40a8-888f-f47664a4884f'}
-    ></Image>
+<Image
+  alt={'创建对应 API token'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/7b0ea46c-5157-40a8-888f-f47664a4884f'}
+/>
 
-    鉴于我们的服务端数据库需要读写 S3 存储服务，因此权限需要选择`对象读与写`，然后点击创建。
+鉴于我们的服务端数据库需要读写 S3 存储服务，因此权限需要选择`对象读与写`，然后点击创建。
 
-    <Image
-      alt={'配置 API token 权限'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf'}
-    ></Image>
+<Image
+  alt={'配置 API token 权限'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf'}
+/>
 
-    创建完成后，就可以看到对应的 S3 API token
+创建完成后，就可以看到对应的 S3 API token
 
-    <Image
-      alt={'复制 API token'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397'}
-    ></Image>
+<Image
+  alt={'复制 API token'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397'}
+/>
 
-    其对应的环境变量为：
+其对应的环境变量为：
 
 ```shell
 S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
 S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
 ```
 
-    ### 配置跨域
+### 配置跨域
 
-    由于 S3 存储服务往往是一个独立的网址，因此需要配置跨域访问。
+由于 S3 存储服务往往是一个独立的网址，因此需要配置跨域访问。
 
-    在 R2 中，你可以在存储桶的设置中找到跨域配置：
+在 R2 中，你可以在存储桶的设置中找到跨域配置：
 
-    <Image
-      alt={'Cloudflare R2 的跨域设置'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23'}
-    ></Image>
+<Image
+  alt={'Cloudflare R2 的跨域设置'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23'}
+/>
 
-    添加跨域规则，允许你的域名（在上文是 `https://your-project.vercel.app`）来源的请求：
+添加跨域规则，允许你的域名（在上文是 `https://your-project.vercel.app`）来源的请求：
 
-    <Image
-      alt={'配置允许你的站点域名'}
-      src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'}
-    ></Image>
+<Image
+  alt={'配置允许你的站点域名'}
+  src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'}
+/>
 
 示例配置如下：
 

package/docs/self-hosting/advanced/s3/tencent-cloud.mdx

@@ -0,0 +1,66 @@
+---
+title: Configuring Tencent Cloud COS Storage Service
+description: >-
+  Detailed steps to configure Tencent Cloud COS storage service for smooth file
+  storage.
+tags:
+  - Tencent Cloud COS
+  - S3 Storage
+  - File Storage
+  - Environment Variables
+---
+
+# Configuring Tencent Cloud COS Storage Service
+
+We need to configure S3 storage service for file storage in the server-side database.
+
+## Configuration Steps
+
+<Steps>
+  ### Configure and Obtain S3 Bucket
+
+  Create a new bucket on [Tencent Cloud COS](https://console.cloud.tencent.com/cos/bucket):
+
+  <Image alt={'Tencent Cloud COS Storage Interface'} src={'https://github.com/user-attachments/assets/d3626294-74ba-4944-9a63-052e6cf719ab'} />
+
+  Name the bucket (e.g., 'lobe'). Choose 'Public Read, Private Write', select any region, and keep other settings default.
+
+  <Image alt={'COS Create Bucket'} src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'} />
+
+  ### Get Bucket-related Environment Variables
+
+  View bucket information in COS bucket overview:
+
+  <Image alt={'View Bucket Information'} src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'} />
+
+  Corresponding environment variables:
+
+  ```shell
+  S3_BUCKET=lobe-130xxxxxx2
+  S3_ENDPOINT=https://cos.ap-chengdu.myqcloud.com
+  S3_REGION=ap-chengdu
+  S3_PUBLIC_DOMAIN=https://lobe-1251234567.cos.ap-chengdu.myqcloud.com
+  ```
+
+  <Callout type={'warning'}>
+    Note: `S3_ENDPOINT` should be `https://cos.ap-chengdu.myqcloud.com`, not `https://lobe-130xxxxxx2.cos.ap-chengdu.myqcloud.com`
+
+    Include `https://` in the URL
+ 
+</Callout>
+
+  ### Configure CORS
+
+  Add the following in 'Security Management - CORS Settings':
+
+  <Image alt={'Configure CORS'} src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'} />
+
+  ### Get S3 Keys
+
+  Create a new SecretId and SecretKey at [Tencent Cloud API Key Management](https://console.cloud.tencent.com/cam/capi). Use as `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY`.
+</Steps>
+
+### Additional Notes
+
+- Consider setting up CDN acceleration for improved access speed and reduced costs.
+- Use role management when creating API keys for enhanced security.