docs: update model platform configuration and command documentation

- Fix punctuation and grammar in introduction.md
- Improve OpenAI adapter usage instructions and add example test output
- Add new section for testing model availability in useful-commands/model.md
- Update bot configuration options including botNames, nickname matching,
  and message queue settings in useful-configurations.md
- Clarify chat mode descriptions and remove deprecated historyMode config
- Revise frontpage feature description for agentic capabilities

Author: dingyi222666

docs/guide/configure-model-platform/introduction.md

@@ -22,7 +22,7 @@ ChatLuna 的模型平台是其核心功能之一。它为 ChatLuna 核心和各
 - [RWKV](rwkv.md)
 - [混元大模型](hunyuan.md)
 
-对于 OpenAI 兼容 API（如 [One API](https://github.com/songquanpeng/one-api)，[New API](https://github.com/QuantumNous/new-api)，可以使用以下适配器进行多开接入：
+对于 OpenAI 兼容 API（如 [One API](https://github.com/songquanpeng/one-api)，[New API](https://github.com/QuantumNous/new-api)），可以使用以下适配器进行多开接入：
 
 - [OpenAI Like](openai-like.md)
 

docs/guide/configure-model-platform/openai.md

@@ -34,17 +34,25 @@ OpenAI 模型适配器还支持多模态和 Agent 模式。允许模型读取图
 
 ## 使用
 
-在 OpenAI 适配器的配置页面，点击运行按钮，如无误，你应该看不到任何错误 log，那即可转到 ChatLuna 的主插件页面。
+在 OpenAI 适配器的配置页面，点击运行按钮，检查你的日志界面，是否有看到错误日志。
 
-在主插件页面，下划到 [模版房间选项](../useful-configurations.md#模版房间选项)，查看 [defaultModel](../useful-configurations.md#defaultmodel) 的选项里是否含有 OpenAI 模型，如果有，则说明你已经成功地接入了 OpenAI 平台。
+如无误，则可以转到沙盒或者其他聊天平台，使用 `chatluna.model.test` 命令查看是否接入成功：
 
-![images](../../public/images/plugin_main_pic_1.png)
+<chat-panel>
+  <chat-message nickname="User">chatluna.model.test openai/gpt-4.1-nano</chat-message>
+  <chat-message nickname="Bot">模型 openai-like/gpt-4.1-nano 测试成功！<br/>
+响应时间：2255ms<br/>
+示例回复：Hello! How can I assist you today?<br/>
+  </chat-message>
+</chat-panel>  
+
+测试成功后，则代表你已成功接入 OpenAI 平台，可以正常使用了。
 
 ## 常见问题
 
 ### 1. 国内平台如何接入？
 
-国内平台接入 OpenAI 官方的接口，需要代理设置，前往主插件的配置页面，开启 [代理模式](../useful-configurations.md/#isproxy)，并配置 [代理地址](../useful-configurations.md#proxyaddress)。
+国内平台接入 OpenAI 官方的接口，需要代理设置。前往主插件的配置页面，开启 [代理模式](../useful-configurations.md/#isproxy)，并配置 [代理地址](../useful-configurations.md#proxyaddress)。
 
 > [!TIP] 提示
 > 社区成员提供了免费的反向代理地址，使用反向代理地址无需开启代理模式，请在确认风险后使用。

docs/guide/useful-commands/model.md

@@ -9,6 +9,29 @@ ChatLuna 提供了一些使用的模型指令，用于查看和设置模型。
 >
 > 阅读 [模型平台](../configure-model-platform/introduction.md) 了解更多。
 
+## 测试模型可用性
+
+测试当前平台或模型的可用性。
+
+以下为命令格式:
+
+```powershell
+chatluna.model.test <model:string>
+```
+
+以下为必须参数：
+
+- `model:string`: 模型名称。也可以是一个平台名称，如：（`openai`,`openai/gpt-4.1-nano`）
+
+以下为例子:
+<chat-panel>
+  <chat-message nickname="User">chatluna.model.test openai/gpt-4.1-nano</chat-message>
+  <chat-message nickname="Bot">模型 openai-like/gpt-4.1-nano 测试成功！<br/>
+响应时间：2255ms<br/>
+示例回复：Hello! How can I assist you today?<br/>
+  </chat-message>
+</chat-panel>  
+
 ## 列出大语言模型列表
 
 列出当前 ChatLuna 可用的大语言模型列表。

docs/guide/useful-configurations.md

@@ -4,19 +4,30 @@
 
 ## Bot 配置
 
-### botName
+### botNames
 
-- 类型：`string`
-- 默认值：`香草`
+- 类型：`string[]`
+- 默认值：`[香草]`
 
 Bot 的昵称，该昵称可用于下方的 [关键词唤醒](#isnickname) 对话。
 
+如果设置了多个昵称，只有第一个昵称会作为 bot 的名称。其他关键词仅用于触发会话。
+
 ### isNickName
 
 - 类型：`boolean`
 - 默认值：`false`
 
-是否可从昵称唤醒对话。当开启后，如发出的消息开头含有 [botName](#botname) 属性，将自动触发对话。
+是否可从昵称唤醒对话。当开启后，如发出的消息开头含有 [botNames](#botnames) 属性，将自动触发对话。
+
+### isNickNameWithContent
+
+- 类型：`boolean`
+- 默认值：`false`
+
+是否允许在对话内容里任意匹配 bot 配置中的昵称来触发对话。
+
+开启后，当消息内容里包含 bot 昵称，将自动触发对话。
 
 ## 对话行为选项
 
@@ -46,11 +57,14 @@ Bot 回复时是否引用原消息回复。开启后 Bot 的回复都会引用
 - 类型: `boolean`
 - 默认值：`false`
 
-是否让消息以转发消息的形式发送。开启后，当 Bot 回复时，将会回复一个转发消息组。
+是否让消息以合并消息的形式发送。开启后，当 Bot 回复时，将会回复一个转发消息组。
 
-:::warning 警告
-目前支持该功能的聊天平台可能很少或接近没有，在未来我们可能会删除该配置项。
-:::
+### forwardMsgMinLength
+
+- 类型：`number`
+- 默认值：`0`
+
+当开启 [isForwardMsg](#isforwardmsg) 选项时，当消息长度超过该值时，将消息以合并消息的形式发送。为 0 表示总是合并消息。
 
 ### privateChatWithoutCommand
 
@@ -68,6 +82,14 @@ Bot 回复时是否引用原消息回复。开启后 Bot 的回复都会引用
 
 是否允许使用房间名前缀触发对话。注意：启用此选项可能会显著影响 ChatLuna 的性能，建议配合过滤器仅在特定群组中启用。
 
+### includeQuoteReply
+
+- 类型：`boolean`
+- 默认值：`false`
+
+是否在回复内容中包含引用消息的内容。开启后，将会引用触发模型生成的消息。
+
+
 ### randomReplyFrequency
 
 - 类型：`number`
@@ -105,7 +127,24 @@ Bot 回复时是否引用原消息回复。开启后 Bot 的回复都会引用
 - 最大值：`3600`
 - 单位：`秒(s)`
 
-全局冷却时间，开启后，在该时间内，Bot 不会响应任何消息。
+全局冷却时间。
+开启后，当响应一跳消息后，在此时间内，Bot 不会再响应任何消息。
+
+### messageQueue
+
+- 类型：`boolean`
+- 默认值：`true`
+
+是否启用消息队列。
+当发送了多条消息，并且模型未响应消息时，会将多条消息合并成一条消息，等待模型响应后再次发送。
+
+### messageQueueDelay
+
+- 类型：`number`
+- 默认值：`0`
+
+消息队列的延迟时间，为 0 则不启用延迟。
+开启延迟后，等待指定时间后才发送消息给模型。此期间存在未处理的消息时，会将消息缓存合并成一条消息，发送给模型。
 
 ### showThoughtMessage
 
@@ -146,7 +185,7 @@ Bot 回复时是否引用原消息回复。开启后 Bot 的回复都会引用
 - 默认值：`'text'`
 
 ::: warning 警告
-如你开启了 [流式传输](#streamresponse)，那么输出格式请直接选择默认的 `text`。
+如你开启了 [流式传输](#streamresponse)，那么输出格式请选择默认的 `text`。
 否则可能出现意想不到的渲染结果。
 :::
 
@@ -203,19 +242,6 @@ Bot 回复时是否引用原消息回复。开启后 Bot 的回复都会引用
 
 数据库里存储的单个对话的最大消息数量，超出后会自动删除最久远的历史聊天消息。
 
-### historyMode
-
-- 类型: `default` | `summary`
-- 默认值: `default`
-
-历史聊天的模式，可选：
-
-- default: 默认模式，将历史消息原封不动的发送给模型。
-- summary: 摘要模式，只发送一条历史消息，其内容为模型总结的历史消息的摘要。
-
-使用 `summary` 模式时更能节省 token，但是也可能会遇到未知的 bug，连续对话效果不好。
-使用 `default` 模式时对话效果更佳，兼容性也最好。
-
 ### autoDelete
 
 - 类型: `boolean`
@@ -263,12 +289,13 @@ ChatLuna 默认使用的向量数据库。
 
 模版克隆房间里默认使用的聊天模式。
 
-由于 ChatLuna 扩展开放了该接口，因此任何插件都可以编写自己的聊天模式相关链接入到 ChatLuna 中。
-下面只介绍 ChatLuna 内置的几个聊天模式：
+ChatLuna 扩展开放了聊天链接口，任何插件都可以编写自己的聊天模式相关链接入到 ChatLuna 中。
+
+下面介绍 ChatLuna 内置的几个聊天模式：
 
-- chat: 普通聊天模式，支持预设和长期记忆，没有联网权限。
-- browsing: 浏览模式，支持预设和长期记忆，可以通过与用户的聊天内容从网络上搜索信息。
-- plugin:  Agent 模式，不完全支持预设，不支持长期记忆，模型可以调用各种工具如网络搜索插件，可以自主获取网络上的消息和执行某些操作。
+- chat: 普通聊天模式，不支持工具调用，支持大部分扩展插件，没有联网权限。
+- browsing: 浏览模式，不支持工具调用，可以通过与用户的聊天内容从网络上搜索信息。
+- plugin:  Agent 模式，支持工具调用，模型可以调用各种工具如网络搜索插件，可以自主获取网络上的消息，执行某些操作。
 
 ### defaultModel
 
@@ -295,15 +322,6 @@ ChatLuna 默认使用的向量数据库。
 
 ## 杂项
 
-### authSystem <Badge type="warning" text="实验性" />
-
-- 类型: `boolean`
-- 默认值: `false`
-
-配额组和其相关的用户系统。
-
-如需了解，可查看 [配额组和用户系统](../guide/session-related/concurrency-limit.md)。
-
 ### isProxy
 
 - 类型: `boolean`

docs/index.md

@@ -24,8 +24,8 @@ features:
     title: 多模型集成
     details: 集成 Deepseek、OpenAI、Google Gemini、Anthropic Claude 等主流平台，并持续扩展更多平台。
   - icon: 🔗
-    title: Agent 工具调用
-    details: Agent 模式，可以让模型任意调用已有工具。支持联网搜索，知识库等复杂工具。
+    title: Agentic 能力
+    details: 使用 Agent 模式，可以让模型任意调用已有工具。支持 MCP，联网搜索，知识库等复杂工具。
   - icon: 🎨
     title: 多模态与渲染输出
     details: 支持图片多模态，并可渲染模型回复，支持文本、图片、语音等多种格式。