@tencentcloud/sdk-mcp 1.6.0-beta.3 → 1.6.1

package/resource/knowledge/push/config/unity.md

@@ -0,0 +1,199 @@
+目前消息推送插件，在 Unity 中仅支持推送至 Android（含各厂商通道）和 iOS 设备。
+
+> **注意：**
+>
+
+> 每个厂商仅支持配置 1 个证书。
+>
+
+【iOS】
+
+集成消息推送插件之前，需要先向 Apple 申请 APNs 推送证书，然后上传推送证书到 IM 控制台 。之后按照快速接入步骤接入即可。
+
+## 操作步骤
+
+【p8 证书（推荐）】
+
+p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。此外，使用 p8 证书可以简化证书管理，因为您可以使用一个 p8 证书为多个应用程序提供推送通知服务。另外，p8 证书支持灵动岛推送。
+
+### 步骤1：申请 APNs 证书
+
+要创建 p8 证书文件，首先需要登录 [苹果开发者中心](https://developer.apple.com/)。
+
+1.  进入 Certificates, Identifiers & Profiles：在页面右上角单击 **Account**，然后在下拉菜单中选择 **Certificates, Identifiers & Profiles** 。
+
+2. 创建一个新的 App ID：在左侧菜单中单击 **Identifiers** ，然后单击右侧的 **+** 创建一个新的 App ID。填写相应的信息并单击 **Continue **。
+
+3. 创建一个新的密钥：在左侧菜单中单击 **Keys**，然后单击右侧的 **+** 创建一个新的密钥。输入密钥的名称，然后勾选 **Apple Push Notifications service (APNs)**，单击 **Continue** 。
+
+确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
+
+> **说明：**
+>
+> - p8 证书只可以下载一次，请妥善保存。
+> - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 p8 证书配置您的 iOS 应用程序以接收推送通知。
+
+### 步骤2：上传 p8 证书到 IM 控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择 **p8 证书**。
+
+> **说明：**
+>
+> - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
+> - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
+> - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
+
+【p12 证书】
+
+### 步骤1：申请 APNs 证书
+
+#### 开启 App 远程推送
+1. 登录 [苹果开发者中心](https://developer.apple.com/account/) 网站，单击 **Certificates, Identifiers & Profiles** 或者侧栏的 **Certificates, IDs & Profiles**，进入 **Certificates, IDs & Profiles** 页面。
+
+2. 单击 Identifiers 右侧的 **+**。
+
+3. 您可以参见如下步骤新建一个 AppID，或者在您原有的 AppID 上增加 `Push Notification` 的 `Service`。
+
+> **说明：**
+>
+
+>  您 App 的 `Bundle ID` 不能使用通配符 `*`，否则将无法使用远程推送服务。
+>
+
+4. 勾选 **App IDs**，单击 **Continue** 进行下一步。
+
+5. 选择 **App**，单击 **Continue** 进行下一步。
+
+6. 配置 `Bundle ID` 等其他信息，单击 **Continue** 进行下一步。
+
+7. 勾选 **Push Notifications**，开启远程推送服务。
+
+#### 生成证书
+1. 选中您的 AppID，选择 **Configure**。
+
+2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
+
+3.
+
+我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
+
+4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问 **> **证书助理 **> **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
+
+5. 输入用户电子邮件地址（您的邮箱）、常用名称（您的名称或公司名），选择**存储到磁盘**，单击**继续**，系统将生成一个 `*.certSigningRequest` 文件。
+
+6. 返回上述 步骤3 中 Apple Developer 网站刚才的页面，单击 **Choose File** 上传生成的 `*.certSigningRequest` 文件。
+
+7. 单击 **Continue**，即可生成推送证书。
+
+8. 单击 **Download** 下载开发环境的 `Development SSL Certificate` 到本地。
+
+9. 再次按照上述步骤1 - 8，将生产环境的 `Production SSL Certificate` 下载到本地。
+
+> **说明：**
+>
+
+> 生产环境的证书实际是开发（Sandbox）+生产（Production）的合并证书，可以同时作为开发环境和生产环境的证书使用。
+>
+
+10. 双击打开下载的开发环境和生产环境的 `SSL Certificate`，系统会将其导入钥匙串中。
+
+11. 打开钥匙串应用，在**登录 **> **我的证书**，右键分别导出刚创建的开发环境（`Apple Development IOS Push Service`）和生产环境（`Apple Push Services`）的 `p12` 文件。
+
+> **注意**
+>
+
+> 保存`.p12`文件时，请务必为其设置密码。
+>
+
+### 步骤2：上传证书到控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
+
+> **说明：**
+>
+> - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
+> - 上传证书需要设置密码，无密码收不到推送。
+> - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
+> - 上传的 p12 证书必须是自己申请的真实有效的证书。
+
+5. 待推送证书信息生成后，记录证书的 ID。
+
+【Android】
+
+## 操作步骤
+
+### 步骤1：注册应用到厂商推送平台
+
+离线推送需要将您自己的应用注册到各个厂商的推送平台，得到 AppID 和 AppKey 等参数，来实现离线推送功能。目前国内支持的手机厂商有：[小米](https://dev.mi.com/xiaomihyperos/documentation/detail)、[华为](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/service-introduction-0000001050040060)、[荣耀](https://developer.hihonor.com/cn/kitdoc)、[OPPO](https://open.oppomobile.com/wiki/doc#id=10195)、[vivo](https://dev.vivo.com.cn/documentCenter/doc/281)、[魅族](https://open.flyme.cn/service/3)，境外支持 [Google FCM](https://console.firebase.google.com/u/0/)，是否需要上架商店详情如下：
+
+|厂商|小米|华为|OPPO|vivo|魅族|荣耀|Google FCM|
+|---------|---------|---------|---------|---------|---------|---------|---------|
+|是否需要上架|是|否|是|是|否|否|否|
+
+### 步骤2：IM 控制台配置
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您在步骤一中获取的各厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
+
+> **注意：**
+>
+
+> 关于**点击后续动作**选项，如需使用本插件提供的点击跳转能力，请保持默认值不变， 即通常是`打开应用内指定页面`并带有默认配置。
+>
+
+> 如需使用上报统计功能，也请保持此项默认值不变。
+>
+
+【小米】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【华为】
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>说明：</strong><br>Client ID 对应 AppID，Client Secret 对应 AppSecret。 |
+
+【OPPO】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【vivo】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+回执配置请参考：[消息触达统计配置-vivo](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【魅族】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+回执配置请参考：[消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【荣耀】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【Google FCM】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||

package/resource/knowledge/push/config/unreal-engine.md

@@ -0,0 +1,199 @@
+推送服务目前推送支持小米、华为、荣耀、OPPO、vivo、魅族、一加、realme、iQOO 、FCM 和 Apple 等厂商通道。
+
+> **注意：**
+>
+
+> 每个厂商仅支持配置 1 个证书。
+>
+
+【iOS】
+
+集成 消息推送插件之前，需要先向 Apple 申请 APNs 推送证书，然后上传推送证书到 IM 控制台 。之后按照快速接入步骤接入即可。
+
+## 操作步骤
+
+【p8 证书（推荐）】
+
+p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。此外，使用 p8 证书可以简化证书管理，因为您可以使用一个 p8 证书为多个应用程序提供推送通知服务。另外，p8 证书支持灵动岛推送。
+
+### 步骤1：申请 APNs 证书
+
+要创建 p8 证书文件，首先需要登录 [苹果开发者中心](https://developer.apple.com/)。
+
+1.  进入 Certificates,Identifiers & Profiles：在页面右上角单击 **Account**，然后在下拉菜单中选择 **Certificates, Identifiers & Profiles** 。
+
+2. 创建一个新的 App ID：在左侧菜单中单击 **Identifiers** ，然后单击右侧的 **+** 创建一个新的 App ID。填写相应的信息并单击 **Continue **。
+
+3. 创建一个新的密钥：在左侧菜单中单击 **Keys**，然后单击右侧的 **+** 创建一个新的密钥。输入密钥的名称，然后勾选 **Apple Push Notifications service (APNs)**，单击 **Continue** 。
+
+确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
+
+> **说明：**
+>
+> - p8 证书只可以下载一次，请妥善保存。
+> - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 p8 证书配置您的 iOS 应用程序以接收推送通知。
+
+### 步骤2：上传 p8 证书到 IM 控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择 .p8 证书
+
+> **说明：**
+>
+> - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
+> - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
+> - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
+
+【p12 证书】
+
+### 步骤1：申请 APNs 证书
+
+#### 开启 App 远程推送
+1. 登录 [苹果开发者中心](https://developer.apple.com/account/) 网站，单击 **Certificates, Identifiers & Profiles** 或者侧栏的 **Certificates, IDs & Profiles**，进入 **Certificates, IDs & Profiles** 页面。
+
+2. 单击 Identifiers 右侧的 **+**。
+
+3. 您可以参见如下步骤新建一个 AppID，或者在您原有的 AppID 上增加 `Push Notification` 的 `Service`。
+
+> **说明：**
+>
+
+>  您 App 的 `Bundle ID` 不能使用通配符 `*`，否则将无法使用远程推送服务。
+>
+
+4. 勾选 **App IDs**，单击 **Continue** 进行下一步。
+
+5. 选择 **App**，单击 **Continue** 进行下一步。
+
+6. 配置 `Bundle ID` 等其他信息，单击 **Continue** 进行下一步。
+
+7. 勾选 **Push Notifications**，开启远程推送服务。
+
+#### 生成证书
+1. 选中您的 AppID，选择 **Configure**。
+
+2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
+
+3.
+
+我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
+
+4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问 **> **证书助理 **> **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
+
+5. 输入用户电子邮件地址（您的邮箱）、常用名称（您的名称或公司名），选择**存储到磁盘**，单击**继续**，系统将生成一个 `*.certSigningRequest` 文件。
+
+6. 返回上述 步骤3 中 Apple Developer 网站刚才的页面，单击 **Choose File** 上传生成的 `*.certSigningRequest` 文件。
+
+7. 单击 **Continue**，即可生成推送证书。
+
+8. 单击 **Download** 下载开发环境的 `Development SSL Certificate` 到本地。
+
+9. 再次按照上述步骤1 - 8，将生产环境的 `Production SSL Certificate` 下载到本地。
+
+> **说明：**
+>
+
+> 生产环境的证书实际是开发（Sandbox）+生产（Production）的合并证书，可以同时作为开发环境和生产环境的证书使用。
+>
+
+10. 双击打开下载的开发环境和生产环境的 `SSL Certificate`，系统会将其导入钥匙串中。
+
+11. 打开钥匙串应用，在**登录 **> **我的证书**，右键分别导出刚创建的开发环境（`Apple Development IOS Push Service`）和生产环境（`Apple Push Services`）的 `p12` 文件。
+
+> **注意**
+>
+
+> 保存`.p12`文件时，请务必为其设置密码。
+>
+
+### 步骤2：上传证书到控制台
+1. 登录 [即时通信 IM 控制台](https://console.cloud.tencent.com/im)。
+
+2. 单击目标应用卡片，进入应用的基础配置页面。
+
+3. 单击 **iOS 原生离线推送设置**右侧的**添加证书**。
+
+4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
+
+> **说明：**
+>
+> - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
+> - 上传证书需要设置密码，无密码收不到推送。
+> - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
+> - 上传的 p12 证书必须是自己申请的真实有效的证书。
+
+5. 待推送证书信息生成后，记录证书的 ID。
+
+【Android】
+
+## 操作步骤
+
+### 步骤1：注册应用到厂商推送平台
+
+离线推送需要将您自己的应用注册到各个厂商的推送平台，得到 AppID 和 AppKey 等参数，来实现离线推送功能。目前国内支持的手机厂商有：[小米](https://dev.mi.com/xiaomihyperos/documentation/detail)、[华为](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/service-introduction-0000001050040060)、[荣耀](https://developer.hihonor.com/cn/kitdoc)、[OPPO](https://open.oppomobile.com/wiki/doc#id=10195)、[vivo](https://dev.vivo.com.cn/documentCenter/doc/281)、[魅族](https://open.flyme.cn/service/3)，境外支持 [Google FCM](https://console.firebase.google.com/u/0/)，是否需要上架商店详情如下：
+
+|厂商|小米|华为|OPPO|vivo|魅族|荣耀|Google FCM|
+|---------|---------|---------|---------|---------|---------|---------|---------|
+|是否需要上架|是|否|是|是|否|否|否|
+
+### 步骤2：IM 控制台配置
+
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您在步骤一中获取的各厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
+
+> **注意：**
+>
+
+> 关于**点击后续动作**选项, 如需使用本插件提供的点击跳转能力, 请保持默认值不变, 即通常是 `打开应用内指定页面` 并带有默认配置.
+>
+
+> 如需使用上报统计功能, 也请保持此项默认值不变,
+>
+
+【小米】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【华为】
+| 厂商推送平台 | IM 控制台配置 |
+| --- | --- |
+|  | <strong>说明：</strong><br>Client ID 对应 AppID，Client Secret 对应 AppSecret。 |
+
+【OPPO】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【vivo】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+回执配置请参考：[消息触达统计配置-vivo](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【魅族】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+回执配置请参考：[消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
+
+【荣耀】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||
+
+【Google FCM】
+
+|厂商推送平台|IM 控制台配置|
+|---------|---------|
+|||

package/resource/knowledge/push/integration/harmonyos.md

@@ -64,7 +64,7 @@ let pushListener: TIMPushListener = {
 TIMPushManager.getInstance().addPushListener(pushListener);
 ```
 
-恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前[购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
+恭喜您已经完成了推送插件的接入，需要提醒您：推送插件**试用或购买到期后，将自动停止提供推送服务（包括普通消息离线推送、全员/标签推送等服务）**。为避免影响您业务正常使用，请提前 [购买](https://buy.cloud.tencent.com/avc)/[续费](https://console.cloud.tencent.com/account/renewal)。
 
 > **说明：**
 >

package/resource/knowledge/push/integration/uni-app.md

@@ -58,6 +58,14 @@
 
 【华为】
 
+> **注意：**
+>
+
+> **请勿配置**到 `nativeResources/android/assets` 目录下。
+>
+
+如图所示：
+
 【荣耀】
 1. 编辑 `uni_modules/TencentCloud-Push/utssdk/app-android/config.json` 的 `dependencies`，添加 `"com.tencent.timpush:honor:xxxx"`。如图所示：
 

package/resource/knowledge/rtcengine/web/plugin/24-advanced-network-quality.md

@@ -28,7 +28,7 @@ trtc.on(TRTC.EVENT.NETWORK_QUALITY, event => {
 5. 整个过程可持续 15s 左右，最后取平均网络质量，从而大致判断出上下行网络情况。
 
 > !
-> - 检测过程将产生少量的[基础服务费用](https://cloud.tencent.com/document/product/647/17157#.E5.9F.BA.E7.A1.80.E6.9C.8D.E5.8A.A1)。如果未指定推流分辨率，则默认以 640*480 的分辨率推流。
+> - 检测过程将产生少量的[音视频时长费用](https://cloud.tencent.com/document/product/647/44248)。如果未指定推流分辨率，则默认以 640*480 的分辨率推流。
 
 ### API 调用时序
 
@@ -101,7 +101,7 @@ setTimeout(() => {
     );
   }
 
-  const validDownlinkNetworkQualitiesList = testResult.uplinkNetworkQualities.filter(value => value >= 1 && value <= 5);
+  const validDownlinkNetworkQualitiesList = testResult.downlinkNetworkQualities.filter(value => value >= 1 && value <= 5);
   if (validDownlinkNetworkQualitiesList.length > 0) {
     // 计算下行平均网络质量
     testResult.average.downlinkNetworkQuality = Math.ceil(

package/server.js

@@ -8,6 +8,18 @@ You are using Tencent RTC MCP Server for SDK documentation retrieval.
   Use this tool FIRST for all technical documentation / FAQ / error code / integration guide lookups.
   Do NOT use web_search for questions that can be answered via this knowledge base.
 
+**Product routing（调用 search_trtc_knowledge 前 MUST 推断 product 数组）**：
+- TIMPush / 推送 / 厂商通道 / FCM / APNs / 华为 / 小米 / OPPO / vivo → product=["push"]（独立产品，禁止误归 chat）
+- 会话 / TUIKit / ChatKit / IM 组件 / 主题定制 → ["chat"]
+- CallKit / 通话 → ["call"]；直播 / 语聊房 / LiveKit → ["live"]；RoomKit / 会议 → ["room"]
+- TRTC Web SDK / rtcengine / WebRTC 插件 → ["rtcengine"]
+- TRTCCloud / Native SDK（客户端）→ ["native_trtc_sdk"]
+- 推送 + IM 同时涉及 → 可传 ["push","chat"]
+- 无法从 prompt 唯一判断 product → 先向用户确认，不要无 product 硬搜，也不要 web_search
+
+**Framework**：返回 needs_framework 时 MUST 先 present_framework_choice；详见 search_trtc_knowledge 工具 description 决策表。
+**When in doubt**：仍优先调用 search_trtc_knowledge（带最佳猜测 product）；status=empty 或 low_confidence 时再澄清或重搜。
+
 **queryID 传递规则（硬规则，违反会导致 CLS 数据断裂）**：
 - 首次调用 search_trtc_knowledge：无需传 queryID（默认空串），响应 JSON 中会有 server 生成的 queryID 字段
 - 后续每一次 search_trtc_knowledge / record_answer / record_feedback 调用：**MUST** 携带首次响应中的 queryID
@@ -18,6 +30,7 @@ Workflow:
 1. Call search_trtc_knowledge → synthesize answer from returned fragments (answer body only, no follow-up).
    - First call: no queryID (or empty string); extract queryID from response.
    - Subsequent calls: **MUST** pass the same queryID.
+   - If response includes meta.references or fragment doc_urls, append a「参考文档」section with those URLs at the end of your answer.
 2. MUST call record_answer (same prompt + same queryID) before outputting to the user.
    Pass the full answer text; record_answer returns the follow-up question text.
 3. Output a single message: your answer + the follow-up question text.
@@ -29,7 +42,7 @@ Workflow:
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.6.0-beta.2",
+        version: "1.6.1",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/tools/common/record_answer.js

@@ -8,9 +8,9 @@ const registryRecordAnswerTool = (mcpServer) => {
         inputSchema: {
             prompt: z.string().describe(parameter_descriptions.prompt),
             answer: z.string().describe(parameter_descriptions.answer),
-            product: z.enum(['chat', 'call', 'live', 'room', 'push', 'rtcengine', 'native_trtc_sdk']).optional().describe(parameter_descriptions.product),
+            product: z.array(z.enum(['chat', 'call', 'live', 'room', 'push', 'rtcengine', 'native_trtc_sdk'])).min(1).max(4).optional().describe(parameter_descriptions.product),
             framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
-            queryID: z.string().default("").describe(parameter_descriptions.queryID),
+            queryID: z.string().describe(parameter_descriptions.queryID),
         },
     }, (params) => {
         reportCLSClient({
@@ -18,7 +18,7 @@ const registryRecordAnswerTool = (mcpServer) => {
             queryID: params.queryID,
             answer: params.answer,
             prompt: params.prompt,
-            product: params.product ?? '',
+            product: params.product ? params.product.join(',') : '',
             framework: params.framework ?? '',
         });
         return {

package/tools/common/record_feedback.js

@@ -8,7 +8,7 @@ const registryRecordFeedbackTool = (mcpServer) => {
         inputSchema: {
             prompt: z.string().describe(parameter_descriptions.prompt),
             framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
-            queryID: z.string().default("").describe(parameter_descriptions.queryID),
+            queryID: z.string().describe(parameter_descriptions.queryID),
             resolved: z.enum(['0', '1']).describe(parameter_descriptions.resolved),
         },
     }, (params) => {

package/tools/common/search_trtc_knowledge.js

@@ -11,7 +11,7 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             prompt: z.string().describe(parameter_descriptions.prompt),
             product: z.array(z.enum(['chat', 'call', 'live', 'room', 'push', 'rtcengine', 'native_trtc_sdk'])).min(1).max(4).optional().describe(parameter_descriptions.product),
             framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
-            queryID: z.string().default("").describe(parameter_descriptions.queryID),
+            queryID: z.string().describe(parameter_descriptions.queryID),
             types: z.array(z.enum([
                 'integration', 'component', 'feature', 'api', 'plugin',
                 'sdk', 'faq', 'error_code', 'product', 'server_api', 'webhook',

package/tools/definitions/record_answer_def.js

@@ -9,10 +9,11 @@ When to call:
 
 Input:
 - prompt: User's original question in full (required; must match the prompt used in get_faq / doc tools).
-- answer: Your complete final answer text (the full answer as delivered to the user; must NOT be a summary or truncated version).
-- product: chat | call | live | room | push | rtcengine | native_trtc_sdk
+- answer: Your complete final answer text (the full answer as delivered to the user).
+  **Must NOT be a summary or truncated version** — except: if the answer exceeds 3000 characters and contains two or more of (pipe / backtick / quote / newline), simplify it first (remove redundant delimiters, collapse repeated lines), then pass the simplified version.
+- product: chat | call | live | room | push | rtcengine | native_trtc_sdk 数组（与 search_trtc_knowledge 同形；同链路复用相同值）
 - framework: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut
-- queryID: Query trace ID (optional). Must match the queryID returned by the first search_trtc_knowledge call.
+- queryID: Query ID. **REQUIRED**. Must match the queryID returned by search_trtc_knowledge (i.e. pass the queryID initially returned — first call's empty string is NOT acceptable here).
 
 Returns:
 - The follow-up question text as a plain string.
@@ -23,14 +24,14 @@ Boundaries:
 - This tool call is NOT silent — its return value is part of your answer.
 - The return value must be used as-is, without rephrasing.
 - Do NOT call this tool before the final answer is written to the user.
-- prompt is required and is stored in CLS text field for correlation with record_feedback.
+- Required params: prompt、answer、queryID（queryID is **REQUIRED** — must carry the non-empty queryID returned by search_trtc_knowledge; empty string is NOT acceptable）.
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: "User's original question in full. Required. Must match the prompt from the documentation tool call.",
-    answer: "Agent's complete final answer text (full answer as delivered to the user; must NOT be a summary or truncated version).",
-    product: 'Target product. One of: chat | call | live | room | push | rtcengine | native_trtc_sdk.',
+    answer: 'Agent complete final answer. Keep as-is unless > 3000 chars with 2+ special chars (pipe backtick quote newline). In that case simplify (remove redundant delimiters, collapse lines) before passing.',
+    product: 'Product array (1–4): chat | call | live | room | push | rtcengine | native_trtc_sdk. Same type and value as search_trtc_knowledge on this queryID chain.',
     framework: 'Target platform. One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.',
-    queryID: 'Query trace ID. Optional. Must match the queryID returned by search_trtc_knowledge.',
+    queryID: 'Query ID. **REQUIRED**. Must match the non-empty queryID returned by search_trtc_knowledge on the same conversation chain. Empty string is NOT acceptable.',
 };
 export const RECORD_ANSWER_DEFINITION = {
     name: 'record_answer',

package/tools/definitions/record_feedback_def.js

@@ -12,7 +12,7 @@ When to call:
 Input:
 - prompt: User's original question in full (required; must match record_answer prompt).
 - framework: Target platform (optional; must match the framework from the original doc tool call). One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.
-- queryID: Query trace ID (optional). Must match the queryID from the search_trtc_knowledge call.
+- queryID: Query ID. **REQUIRED**. Must match the queryID returned by search_trtc_knowledge / record_answer (i.e. pass the non-empty queryID — empty string is NOT acceptable here).
 - resolved: 1 if the user confirms solved; 0 if not solved or needs more help.
 
 Returns:
@@ -27,7 +27,7 @@ Boundaries:
 const PARAMETER_DESCRIPTIONS = {
     prompt: "User's original question in full. Required. Must match the prompt used in record_answer.",
     framework: 'Target platform. Optional. Must match the framework from the original doc tool call. One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.',
-    queryID: 'Query trace ID. Optional. Must match the queryID from search_trtc_knowledge.',
+    queryID: 'Query ID. **REQUIRED**. Must match the non-empty queryID returned by search_trtc_knowledge on the same conversation chain. Empty string is NOT acceptable.',
     resolved: '1 if user confirms solved; 0 if user says not solved or needs more help.',
 };
 export const RECORD_FEEDBACK_DEFINITION = {