From 78e78e71ba1831119b47db676039cb6d68350ca9 Mon Sep 17 00:00:00 2001
From: minecraft1024a <wwwww95915@qq.com>
Date: Thu, 28 Aug 2025 20:47:49 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=A8=A1=E5=9E=8B?=
 =?UTF-8?q?=E9=85=8D=E7=BD=AE=E6=8C=87=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 `gemini` 客户端类型
- 更新 Google API 的 `base_url`
- 移除 `extra_params` 对 `gemini` 客户端的无效说明
- 新增 `anti_truncation` 参数说明
- 增加多个新的模型任务配置示例
- 将文档中的 `MaiBot` 统一为 `MoFox_Bot
---
 docs/guides/model_configuration_guide.md | 48 +++++++++++++++++++++---
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/docs/guides/model_configuration_guide.md b/docs/guides/model_configuration_guide.md
index e2df27d74..3ef495eca 100644
--- a/docs/guides/model_configuration_guide.md
+++ b/docs/guides/model_configuration_guide.md
@@ -43,7 +43,7 @@ retry_interval = 10                     # 重试间隔（秒）
 | `name` | ✅ | 服务商名称，需要在模型配置中引用 | - |
 | `base_url` | ✅ | API服务的基础URL | - |
 | `api_key` | ✅ | API密钥，请替换为实际密钥 | - |
-| `client_type` | ❌ | 客户端类型：`openai`（OpenAI格式）或 `aiohttp_gemini`(至少现在支持良好) | `openai` |
+| `client_type` | ❌ | 客户端类型：`openai`、`gemini` 或 `aiohttp_gemini` | `openai` |
 | `max_retry` | ❌ | API调用失败时的最大重试次数 | 2 |
 | `timeout` | ❌ | API请求超时时间（秒） | 30 |
 | `retry_interval` | ❌ | 重试间隔时间（秒） | 10 |
@@ -72,7 +72,7 @@ client_type = "openai"
 ```toml
 [[api_providers]]
 name = "Google"
-base_url = "https://api.google.com/v1" #在MoFox-Bot中, 使用aiohttp_gemini客户端的提供商可以自定义base_url
+base_url = "https://generativelanguage.googleapis.com/v1beta" # 在MoFox-Bot中, 使用aiohttp_gemini客户端的提供商可以自定义base_url
 api_key = "your-google-api-key"
 client_type = "aiohttp_gemini"  # 注意：Gemini需要使用特殊客户端
 ```
@@ -132,7 +132,6 @@ thinking = {type = "disabled"} # 禁用思考
 ```
 请注意，`extra_params` 的配置应该构成一个合法的TOML字典结构，具体内容取决于API服务商的要求。
 
-**请注意，对于`client_type`为`gemini`的模型，此字段无效。**
 ### 3.3 配置参数说明
 
 | 参数 | 必填 | 说明 |
@@ -144,6 +143,7 @@ thinking = {type = "disabled"} # 禁用思考
 | `price_out` | ❌ | 输出价格（元/M token），用于成本统计 |
 | `force_stream_mode` | ❌ | 是否强制使用流式输出 |
 | `extra_params` | ❌ | 额外的模型参数配置 |
+| `anti_truncation` | ❌ | 是否启用反截断功能 |
 
 ## 4. 模型任务配置
 
@@ -183,7 +183,7 @@ max_tokens = 800
 ```
 
 ### planner - 决策模型
-负责决定MaiBot该做什么：
+负责决定MoFox_Bot该做什么：
 ```toml
 [model_task_config.planner]
 model_list = ["siliconflow-deepseek-v3"]
@@ -192,7 +192,7 @@ max_tokens = 800
 ```
 
 ### emotion - 情绪模型
-负责MaiBot的情绪变化：
+负责MoFox_Bot的情绪变化：
 ```toml
 [model_task_config.emotion]
 model_list = ["siliconflow-deepseek-v3"]
@@ -261,6 +261,44 @@ temperature = 0.7
 max_tokens = 800
 ```
 
+### schedule_generator - 日程生成模型
+```toml
+[model_task_config.schedule_generator]
+model_list = ["deepseek-v3"]
+temperature = 0.5
+max_tokens = 1024
+```
+
+### monthly_plan_generator - 月度计划生成模型
+```toml
+[model_task_config.monthly_plan_generator]
+model_list = ["deepseek-v3"]
+temperature = 0.7
+max_tokens = 1024
+```
+
+### emoji_vlm - 表情包VLM模型
+```toml
+[model_task_config.emoji_vlm]
+model_list = ["qwen-vl-max"]
+max_tokens = 800
+```
+
+### anti_injection - 反注入模型
+```toml
+[model_task_config.anti_injection]
+model_list = ["deepseek-v3"]
+temperature = 0.1
+max_tokens = 512
+```
+
+### utils_video - 视频分析模型
+```toml
+[model_task_config.utils_video]
+model_list = ["qwen-vl-max"]
+max_tokens = 800
+```
+
 ## 5. 配置建议
 
 ### 5.1 Temperature 参数选择