diff --git a/CHANGELOG.md b/CHANGELOG.md
index b094b2ad..6c02afb3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1567,6 +1567,14 @@
 
 <summary>[展开查看]</summary>
 
+-   Release 3.1.0 (2024-06-05)
+
+    -   **新增**：适配新的 OpenAI v2 版接口。
+
+    -   **变更**：随官方标记部分接口为废弃。
+
+    -   **变更**：重命名原客户端相关类型 "WechatOpenAI" → "WechatChatbot"，并调整默认入口点。
+
 -   Release 3.0.0 (2024-02-07)
 
     -   **变更**：升级公共组件至 v3.0.0。完整变更说明请参阅迁移指南。
diff --git a/docs/WechatOpenAI/Basic_ModelDefinition.md b/docs/WechatOpenAI/Basic_ModelDefinition.md
index 0c1cae01..72df7d41 100644
--- a/docs/WechatOpenAI/Basic_ModelDefinition.md
+++ b/docs/WechatOpenAI/Basic_ModelDefinition.md
@@ -26,11 +26,12 @@
 
 <summary>[展开查看]</summary>
 
-|     |        微信 API         | 备注 |
-| :-: | :---------------------: | :--: |
-|  √  |      智能对话接口       |      |
-|  √  |     第三方客服接入      |      |
-|  √  |       机器人配置        |      |
-|  √  | 公众号、小程序、H5 绑定 |      |
+|     |        微信 API         |    所属客户端    | 备注 |
+| :-: | :---------------------: | :--------------: | :--: |
+|  √  |    获取 AccessToken     |      OpenAI      |      |
+|  √  |       机器人配置        | OpenAI & Chatbot |      |
+|  √  |   机器人对话/智能对话   | OpenAI & Chatbot |      |
+|  √  |     第三方客服接入      |     Chatbot      |      |
+|  √  | 公众号、小程序、H5 绑定 |     Chatbot      |      |
 
 </details>
diff --git a/docs/WechatOpenAI/README.md b/docs/WechatOpenAI/README.md
index f1be919c..0d111338 100644
--- a/docs/WechatOpenAI/README.md
+++ b/docs/WechatOpenAI/README.md
@@ -36,6 +36,16 @@
 using SKIT.FlurlHttpClient.Wechat;
 using SKIT.FlurlHttpClient.Wechat.OpenAI;
 
+/* 接入新 openaiapi.weixin.qq.com 相关的接口请构建以下客户端 */
+var options = new WechatOpenAIClientOptions()
+{
+    AppId = "微信智能对话 AppId",
+    Token = "微信智能对话 Token",
+    EncodingAESKey = "微信智能对话 EncodingAESKey"
+};
+var client = WechatOpenAIlientBuilder.Create(options).Build();
+
+/* 接入原 chatbot.weixin.qq.com 相关的接口请构建以下客户端 */
 var options = new WechatChatbotClientOptions()
 {
     AppId = "微信智能对话 AppId",
@@ -51,25 +61,22 @@ var client = WechatChatbotClientBuilder.Create(options).Build();
 using SKIT.FlurlHttpClient.Wechat.OpenAI;
 using SKIT.FlurlHttpClient.Wechat.OpenAI.Models;
 
-/* 以发送客服消息接口为例 */
-var request = new SendMessageRequest()
+/* 以调用智能对话接口为例 */
+var request = new Models.BotQueryV2Request()
 {
-    AppId = "公众号或小程序的 AppId",
-    OpenId = "用户的 OpenId",
-    Message = "消息内容",
-    Channel = 0
+    QueryString = "爸爸的爸爸叫什么？",
+    UserId = "用户 ID",
+    UserName = "用户昵称",
+    AccessToken = "微信 AccessToken"
 };
-var response = await client.ExecuteSendMessageAsync(request);
+var response = await client.ExecuteBotQueryV2Async(request);
 if (response.IsSuccessful())
 {
-    Console.WriteLine("错误代码：" + response.ErrorCode);
+    Console.WriteLine("命中回答：" + response.Data.Answer);
 }
 else
 {
-    Console.WriteLine("错误代码：" + response.ErrorCode);
-    Console.WriteLine("错误描述：" + response.ErrorMessage);
-    Console.WriteLine("返回代码：" + response.ReturnCode);
-    Console.WriteLine("返回错误：" + response.ReturnError);
+    Console.WriteLine("返回码：" + response.Code);
 }
 ```
 
diff --git a/src/SKIT.FlurlHttpClient.Wechat.OpenAI/SKIT.FlurlHttpClient.Wechat.OpenAI.csproj b/src/SKIT.FlurlHttpClient.Wechat.OpenAI/SKIT.FlurlHttpClient.Wechat.OpenAI.csproj
index f5e311c9..5a530a0d 100644
--- a/src/SKIT.FlurlHttpClient.Wechat.OpenAI/SKIT.FlurlHttpClient.Wechat.OpenAI.csproj
+++ b/src/SKIT.FlurlHttpClient.Wechat.OpenAI/SKIT.FlurlHttpClient.Wechat.OpenAI.csproj
@@ -14,7 +14,7 @@
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
         <PackageProjectUrl>https://github.com/fudiwei/DotNetCore.SKIT.FlurlHttpClient.Wechat</PackageProjectUrl>
         <PackageTags>Flurl.Http Wechat Weixin MicroMessage WechatAI WechatOpenAI WexinAI WeixinOpenAI 微信 微信智能对话 微信对话开放平台 微信智能对话开放平台 智能对话平台</PackageTags>
-        <Version>3.0.0</Version>
+        <Version>3.1.0</Version>
         <Description>基于 Flurl.Http 的微信对话开放平台（微信智能对话） API 客户端，支持机器人配置、机器人对话、客服消息收发等功能。</Description>
         <Authors>Fu Diwei</Authors>
         <RepositoryType>git</RepositoryType>