@lobehub/chat 1.44.3 → 1.45.1

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

@@ -1,3 +1,16 @@
+---
+title: LobeChat Knowledge Base / File Upload
+description: >-
+  Explore LobeChat's file upload and knowledge base management features with
+  core components.
+tags:
+  - LobeChat
+  - File Upload
+  - Knowledge Base
+  - PostgreSQL
+  - OpenAI Embedding
+---
+
 # 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.
@@ -32,9 +45,7 @@ S3 (or S3-compatible storage services) is used for storing uploaded files.
 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.
-
+  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

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

@@ -1,3 +1,14 @@
+---
+title: LobeChat 知识库 / 文件上传
+description: 了解 LobeChat 的文件上传和知识库管理核心组件，助力成功部署。
+tags:
+  - LobeChat
+  - 文件上传
+  - 知识库管理
+  - PostgreSQL
+  - OpenAI
+---
+
 # 知识库 / 文件上传
 
 LobeChat 支持文件上传 / 知识库管理。该功能依赖于以下核心技术组件，了解这些组件将有助于你成功部署和维护知识库系统。
@@ -32,9 +43,7 @@ S3（或兼容 S3 协议的存储服务）用于存储上传的文件。
 OpenAI 的嵌入（Embedding）服务用于将文本转化为向量表示。
 
 <Callout type={'info'}>
-
-LobeChat 当前默认使用 OpenAI `text-embedding-3-small` 模型，请确保你的 API Key 可以访问该模型。
-
+  LobeChat 当前默认使用 OpenAI `text-embedding-3-small` 模型，请确保你的 API Key 可以访问该模型。
 </Callout>
 
 - **用途**：生成文本的向量表示，用于语义搜索

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

@@ -42,8 +42,8 @@ id=displayName<maxToken:vision:fc:file>
 
 目前支持的扩展能力有：
 
-| ---      | 描述                                 |
-| -------- | ------------------------------------ |
-| `fc`     | 函数调用（function calling）         |
-| `vision` | 视觉识别                             |
-| `file`   | 文件上传（比较hack，不建议日常使用） |
+| ---      | 描述                     |
+| -------- | ---------------------- |
+| `fc`     | 函数调用（function calling） |
+| `vision` | 视觉识别                   |
+| `file`   | 文件上传（比较 hack，不建议日常使用）  |

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

@@ -14,118 +14,89 @@ We need to configure an S3 storage service in the server-side database to store
 ## Configuration Steps
 
 <Steps>
+  ### Configure and Obtain S3 Bucket
 
-### Configure and Obtain S3 Bucket
+  You need to go to your S3 service provider (such as AWS S3, Cloudflare R2, etc.) and create a new storage bucket. The following is an example using Cloudflare R2 to guide you through the creation process.
 
-You need to go to your S3 service provider (such as AWS S3, Cloudflare R2, etc.) and create a new storage bucket. The following is an example using Cloudflare R2 to guide you through the creation process.
+  The interface of Cloudflare R2 is shown below:
 
-The interface of Cloudflare R2 is shown below:
+  <Image alt={'Cloudflare R2 Storage Interface'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee'} />
 
-<Image
-  alt={'Cloudflare R2 Storage Interface'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/41f7f677-0153-4a96-b849-5ac9b7ebefee'}
-/>
+  When creating the bucket, specify its name and then click create.
 
-When creating the bucket, specify its name and then click create.
+  <Image alt={'Create Bucket in R2'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'} />
 
-<Image
-  alt={'Create Bucket in R2'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'}
-/>
+  ### Obtain Environment Variables for the Bucket
 
-### Obtain Environment Variables for the Bucket
+  In the settings of the R2 storage bucket, you can view the bucket configuration information:
 
-In the settings of the R2 storage bucket, you can view the bucket configuration information:
+  <Image alt={'View relevant information of the bucket'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'} />
 
-<Image
-  alt={'View relevant information of the bucket'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'}
-/>
+  The corresponding environment variables are:
 
-The corresponding environment variables are:
+  ```shell
+  # Bucket name
+  S3_BUCKET=lobechat
+  # Request endpoint of the bucket (note that the path in this link includes the bucket name, which must be removed, or use the link provided on the page for applying S3 API token)
+  S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+  # Access domain of the bucket
+  S3_PUBLIC_DOMAIN=https://s3-for-lobechat.your-domain.com
+  ```
 
-```shell
-# Bucket name
-S3_BUCKET=lobechat
-# Request endpoint of the bucket (note that the path in this link includes the bucket name, which must be removed, or use the link provided on the page for applying S3 API token)
-S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
-# Access domain of the bucket
-S3_PUBLIC_DOMAIN=https://s3-for-lobechat.your-domain.com
-```
+  <Callout type={'warning'}>
+    `S3_ENDPOINT` must have its path removed, otherwise uploaded files cannot be accessed.
+  </Callout>
 
-<Callout type={'warning'}>
-  `S3_ENDPOINT` must have its path removed, otherwise uploaded files cannot be accessed.
-</Callout>
+  ### Obtain S3 Key Environment Variables
 
-### Obtain S3 Key Environment Variables
+  You need to obtain the access key for S3 so that the LobeChat server has permission to access the S3 storage service. In R2, you can configure the access key in the account details:
 
-You need to obtain the access key for S3 so that the LobeChat server has permission to access the S3 storage service. In R2, you can configure the access key in the account details:
+  <Image alt={'View access key of the bucket'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d'} />
 
-<Image
-  alt={'View access key of the bucket'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/be0c95c0-6693-44ee-a490-7e8dfaa8b34d'}
-/>
+  Click the button in the upper right corner to create an API token and enter the create API Token page.
 
-Click the button in the upper right corner to create an API token and enter the create API Token page.
+  <Image alt={'Create corresponding API token'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/7b0ea46c-5157-40a8-888f-f47664a4884f'} />
 
-<Image
-  alt={'Create corresponding API token'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/7b0ea46c-5157-40a8-888f-f47664a4884f'}
-/>
+  Since our server-side database needs to read and write to the S3 storage service, the permission needs to be set to `Object Read and Write`, then click create.
 
-Since our server-side database needs to read and write to the S3 storage service, the permission needs to be set to `Object Read and Write`, then click create.
+  <Image alt={'Configure API token permissions'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf'} />
 
-<Image
-  alt={'Configure API token permissions'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/d6f5a918-7b50-4d6e-83a6-3894ab930ddf'}
-/>
+  After creation, you can see the corresponding S3 API token.
 
-After creation, you can see the corresponding S3 API token.
+  <Image alt={'Copy API token'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397'} />
 
-<Image
-  alt={'Copy API token'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/763b18f9-2b5f-44bb-a479-9b56d46f7397'}
-/>
+  The corresponding environment variables are:
 
-The corresponding environment variables are:
+  ```shell
+  S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
+  S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
+  ```
 
-```shell
-S3_ACCESS_KEY_ID=9998d6757e276cf9f1edbd325b7083a6
-S3_SECRET_ACCESS_KEY=55af75d8eb6b99f189f6a35f855336ea62cd9c4751a5cf4337c53c1d3f497ac2
-```
+  ### Configure Cross-Origin Resource Sharing (CORS)
 
-### Configure Cross-Origin Resource Sharing (CORS)
+  Since S3 storage services are often on a separate domain, cross-origin access needs to be configured.
 
-Since S3 storage services are often on a separate domain, cross-origin access needs to be configured.
+  In R2, you can find the CORS configuration in the settings of the storage bucket:
 
-In R2, you can find the CORS configuration in the settings of the storage bucket:
+  <Image alt={'Cross-Origin Settings in Cloudflare R2'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23'} />
 
-<Image
-  alt={'Cross-Origin Settings in Cloudflare R2'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/ab008be7-26b2-4b78-8bd9-24301bf34d23'}
-/>
+  Add a CORS rule to allow requests from your domain (in the previous section, it is `https://your-project.vercel.app`):
 
-Add a CORS rule to allow requests from your domain (in the previous section, it is `https://your-project.vercel.app`):
+  <Image alt={'Configure allowed site domain'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'} />
 
-<Image
-  alt={'Configure allowed site domain'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'}
-/>
-
-Example configuration is as follows:
-
-```json
-[
-  {
-    "AllowedOrigins": ["https://your-project.vercel.app"],
-    "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
-    "AllowedHeaders": ["*"]
-  }
-]
-```
+  Example configuration is as follows:
 
-After configuration, click save.
+  ```json
+  [
+    {
+      "AllowedOrigins": ["https://your-project.vercel.app"],
+      "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
+      "AllowedHeaders": ["*"]
+    }
+  ]
+  ```
 
+  After configuration, click save.
 </Steps>
 
 ## Overview of Environment Variables

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

@@ -15,121 +15,92 @@ 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 alt={'R2 创建存储桶'} src={'https://github.com/lobehub/lobe-chat/assets/28616219/9c0d184c-3169-40fa-9115-011cfffb9ca7'} />
 
-<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
-  alt={'查看存储桶的相关信息'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/2ceb210c-eca0-4439-ba27-8734d4ebb3ee'}
-/>
+  其对应的环境变量为：
 
-其对应的环境变量为：
+  ```shell
+  # 存储桶的名称
+  S3_BUCKET=lobechat
+  # 存储桶的请求端点(注意此处链接的路径带存储桶名称，必须删除该路径，或使用申请 S3 API token 页面所提供的链接)
+  S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
+  # 存储桶对外的访问域名
+  S3_PUBLIC_DOMAIN=https://s3-for-lobechat.your-domain.com
+  ```
 
-```shell
-# 存储桶的名称
-S3_BUCKET=lobechat
-# 存储桶的请求端点(注意此处链接的路径带存储桶名称，必须删除该路径，或使用申请 S3 API token 页面所提供的链接)
-S3_ENDPOINT=https://0b33a03b5c993fd2f453379dc36558e5.r2.cloudflarestorage.com
-# 存储桶对外的访问域名
-S3_PUBLIC_DOMAIN=https://s3-for-lobechat.your-domain.com
-```
+  <Callout type={'warning'}>`S3_ENDPOINT`必须删除其路径，否则会无法访问所上传文件</Callout>
 
-<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
-  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
-  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
-  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
-  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
+  ```
 
-```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
-  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
-  alt={'配置允许你的站点域名'}
-  src={'https://github.com/lobehub/lobe-chat/assets/28616219/dfcc2cb3-2958-4498-a8a4-51bec584fe7d'}
-/>
-
-示例配置如下：
-
-```json
-[
-  {
-    "AllowedOrigins": ["https://your-project.vercel.app"],
-    "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
-    "AllowedHeaders": ["*"]
-  }
-]
-```
+  示例配置如下：
 
-配置后点击保存即可。
+  ```json
+  [
+    {
+      "AllowedOrigins": ["https://your-project.vercel.app"],
+      "AllowedMethods": ["GET", "PUT", "HEAD", "POST", "DELETE"],
+      "AllowedHeaders": ["*"]
+    }
+  ]
+  ```
 
+  配置后点击保存即可。
 </Steps>
 
 ## 环境变量一览
 
-<Callout type={'warning'}>URL的`https://`不可缺失，须保持URL的完整性</Callout>
+<Callout type={'warning'}>URL 的`https://`不可缺失，须保持 URL 的完整性</Callout>
 
 ```shell
 # S3 秘钥

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

@@ -19,58 +19,44 @@ We need to configure S3 storage service for file storage in the server-side data
 <Steps>
   ### Configure and Obtain S3 Bucket
 
-Create a new bucket on [Tencent Cloud COS](https://console.cloud.tencent.com/cos/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'}
-/>
+  <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.
+  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'}
-/>
+  <Image alt={'COS Create Bucket'} src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'} />
 
-### Get Bucket-related Environment Variables
+  ### Get Bucket-related Environment Variables
 
-View bucket information in COS bucket overview:
+  View bucket information in COS bucket overview:
 
-<Image
-  alt={'View Bucket Information'}
-  src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'}
-/>
+  <Image alt={'View Bucket Information'} src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'} />
 
-Corresponding environment variables:
+  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
-```
+  ```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>
 
-</Callout>
+  ### Configure CORS
 
-### Configure CORS
+  Add the following in 'Security Management - CORS Settings':
 
-Add the following in 'Security Management - CORS Settings':
+  <Image alt={'Configure CORS'} src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'} />
 
-<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`.
+  ### 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

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

@@ -15,65 +15,50 @@ tags:
 ## 配置步骤
 
 <Steps>
+  ### 配置并获取 S3 存储桶
 
-### 配置并获取 S3 存储桶
+  你需要首先前往 [腾讯云 COS](https://console.cloud.tencent.com/cos/bucket) 并创建一个新的存储桶（Bucket）：
 
-你需要首先前往 [腾讯云 COS](https://console.cloud.tencent.com/cos/bucket) 并创建一个新的存储桶（Bucket）：
+  <Image alt={'腾讯云 COS 存储界面'} src={'https://github.com/user-attachments/assets/d3626294-74ba-4944-9a63-052e6cf719ab'} />
 
-<Image
-  alt={'腾讯云 COS 存储界面'}
-  src={'https://github.com/user-attachments/assets/d3626294-74ba-4944-9a63-052e6cf719ab'}
-/>
+  创建存储桶时将指定其名称，下文以 `lobe` 为例。选择 `公有读私有写`，地域随意，其余配置一概默认即可，然后点击创建。
 
-创建存储桶时将指定其名称，下文以 `lobe` 为例。选择 `公有读私有写`，地域随意，其余配置一概默认即可，然后点击创建。
+  <Image alt={'COS 创建存储桶'} src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'} />
 
-<Image
-  alt={'COS 创建存储桶'}
-  src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'}
-/>
+  ### 获取存储桶相关环境变量
 
-### 获取存储桶相关环境变量
+  在 COS 存储桶的概览设置中，可以看到桶配置的信息：
 
-在 COS 存储桶的概览设置中，可以看到桶配置的信息：
+  <Image alt={'查看存储桶的相关信息'} src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'} />
 
-<Image
-  alt={'查看存储桶的相关信息'}
-  src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'}
-/>
+  其对应的环境变量为：
 
-其对应的环境变量为：
+  ```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
+  ```
 
-```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'}>
+    请注意，`S3_ENDPOINT` 的值为 `https://cos.ap-chengdu.myqcloud.com`，而不是 `https://lobe-130xxxxxx2.cos.ap-chengdu.myqcloud.com`
 
-<Callout type={'warning'}>
-请注意，`S3_ENDPOINT` 的值为 `https://cos.ap-chengdu.myqcloud.com`，而不是 `https://lobe-130xxxxxx2.cos.ap-chengdu.myqcloud.com`
+    且此处 URL 的 `https://` 不可缺失，须保持 URL 的完整性
+  </Callout>
 
-且此处 URL 的 `https://` 不可缺失，须保持 URL 的完整性
+  ### 配置跨域
 
-</Callout>
+  在左侧 `安全管理 - 跨域访问 CORS 设置` 中，添加以下配置并保存：
 
-### 配置跨域
+  <Image alt={'配置跨域'} src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'} />
 
-在左侧 `安全管理 - 跨域访问 CORS 设置` 中，添加以下配置并保存：
-
-<Image
-  alt={'配置跨域'}
-  src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'}
-/>
-
-### 获取 S3 秘钥
-
-前往 [腾讯云 API 密钥管理](https://console.cloud.tencent.com/cam/capi) 创建一个新的 SecretId 和 SecretKey，填写为 `S3_ACCESS_KEY_ID` 和 `S3_SECRET_ACCESS_KEY` 即可。
+  ### 获取 S3 秘钥
 
+  前往 [腾讯云 API 密钥管理](https://console.cloud.tencent.com/cam/capi) 创建一个新的 SecretId 和 SecretKey，填写为 `S3_ACCESS_KEY_ID` 和 `S3_SECRET_ACCESS_KEY` 即可。
 </Steps>
 
 ### 附加说明