@tencent-rtc/mcp 1.7.3 → 1.7.5

package/resource/knowledge/rtcengine/web/plugin/23-advanced-support-detection.md

@@ -23,7 +23,7 @@ TRTC.isSupported().then(checkResult => {
 
 ### Option 1: Use Device Detector Plugin (including default UI)
 
-The device detector plugin is used to test the user's media device(camera, microphone, speaker) and network which is recommended to be used before the user enters the room.
+The device detector plugin is used to test the user's media device(camera, microphone, speaker) and network which is recommended to be used before the user enters the room. 
 
 > - Support TRTC Web SDK version >= v5.8.0
 > - The plugin includes a default UI. If the UI does not meet your product design requirements, you can refer to Option 2 for a custom UI implementation.
@@ -38,7 +38,7 @@ const trtc = TRTC.create({ plugins: [DeviceDetector] });
 const result = await trtc.startPlugin('DeviceDetector');
 
 // 2. Test Media Device & Network Quality
-const options = {
+const options = { 
     networkDetect: { sdkAppId, userId, userSig }
 }
 const resultWithNetwork = await trtc.startPlugin('DeviceDetector', options);
@@ -70,11 +70,11 @@ Enable the mirror checkbox during camera detection
 
 | Name            | Type   | Attributes | Description                                                                                                                                                           |
 | --------------- | ------ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| sdkAppId        | string | required   | Your sdkAppId                                                                                                                                                         |
+| sdkAppId        | number | required   | Your sdkAppId                                                                                                                                                         |
 | userId          | string | required   | The userId for testing uplink network quality. It should be different from downlinkUserId.                                                                            |
 | userSig         | string | required   | The [UserSig](https://trtc.io/document/35166) of the userId.                                                                                                          |
-| downlinkUserId  | string | required   | The userId for testing downlink network quality. It should be different from userId. Fill in downlinkUserId and downlinkUserSig will perform a downlink network test. |
-| downlinkUserSig | string | required   | The [UserSig](https://trtc.io/document/35166) of the downlinkUserId.                                                                                                  |
+| downlinkUserId  | string | optional   | The userId for testing downlink network quality. It should be different from userId. Fill in downlinkUserId and downlinkUserSig will perform a downlink network test. |
+| downlinkUserSig | string | optional   | The [UserSig](https://trtc.io/document/35166) of the downlinkUserId.                                                                                                  |
 | roomId          | number | optional   | Optional. The default value is 8080. The value must be an integer of [1, 4294967294]                                                                                  |
 
 ##### trtc.stopPlugin('DeviceDetector')
@@ -125,7 +125,7 @@ The device connection checks if the user's device has a camera, microphone, and
 
   ```javascript
   import TRTC from 'trtc-sdk-v5';
-
+  
   const cameraList = await TRTC.getCameraList();
   const micList = await TRTC.getMicrophoneList();
   const hasCameraDevice = cameraList.some(camera => camera.deviceId !== '');

package/resource/knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md

@@ -28,6 +28,7 @@ TRTC Web SDK v5 provides a plugin system that supports on-demand loading of vari
 | **AIDenoiser** | AI noise reduction with support for far-field cancellation mode | - | Exclusive Edition | Required | {@tutorial 35-advanced-ai-denoiser} |
 | **VoiceChanger** | Voice effects with 11 voice types (child, loli, uncle, etc.) | ≥ 5.10.0 | Premium Edition | - | {@tutorial 37-advanced-voice-changer} |
 | **RealtimeTranscriber** | Real-time speech transcription and translation, converting audio to text with multi-language translation | ≥ 5.15.0 | None | - | {@tutorial 42-advanced-realtime-transcriber} |
+| **Chorus** | KTV chorus with lead/backup singer roles, lyrics sync
 
 ### Streaming & Mixing
 
@@ -42,6 +43,7 @@ TRTC Web SDK v5 provides a plugin system that supports on-demand loading of vari
 |---------|---------|---------|---------|---------|---------|
 | **DeviceDetector** | Device detection for camera, microphone, speaker, and network with default UI | ≥ 5.8.0 | None | - | {@tutorial 23-advanced-support-detection} |
 | **Debug** | Debug mode with full log upload/export and audio/video dump | ≥ 5.8.0 | None | - | {@tutorial 18-basic-debug} |
+| **TRTCVideoDecoder** | Video decoder fallback to software decoding on failure | ≥ 5.9
 | **SmallStreamAutoSwitcher** | Automatic dual-stream switching for smooth streaming in poor network | ≥ 5.11.0 | None | - | {@tutorial 41-advanced-small-stream-auto-switcher} |
 <!-- | **CustomEncryption** | Custom encryption for end-to-end audio/video encryption with built-in or custom algorithms | - | Contact us | - | - | -->
 
@@ -61,7 +63,7 @@ import TRTC from 'trtc-sdk-v5';
 import { VirtualBackground } from 'trtc-sdk-v5/plugins/video-effect/virtual-background';
 import { AIDenoiser } from 'trtc-sdk-v5/plugins/ai-denoiser';
 
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn/assets' // If plugins require static assets
 });
@@ -89,7 +91,7 @@ Use `trtc.updatePlugin(pluginName, options)` to dynamically update plugin parame
 ```javascript
 await trtc.updatePlugin('VirtualBackground', {
   type: 'image',
-  imageUrl: 'https://example.com/background.jpg'
+  src: 'https://example.com/background.jpg'
 });
 ```
 
@@ -164,8 +166,8 @@ await trtc.updatePlugin('VideoMixer', {
 });
 
 // Publish mixed track
-await trtc.startLocalVideo({
-  option: {
+await trtc.startLocalVideo({ 
+  option: { 
     videoTrack: track,
     profile: { width: 1920, height: 1080, bitrate: 2000 }
   }
@@ -185,7 +187,7 @@ TRTCVideoDecoder automatically starts fallback logic on decode failure after reg
 ```javascript
 import TRTCVideoDecoder from 'trtc-sdk-v5/plugins/video-decoder';
 
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [TRTCVideoDecoder],
   assetsPath: 'https://your-cdn/assets'
 });
@@ -309,7 +311,7 @@ cp -r node_modules/trtc-sdk-v5/assets ./public/assets
 Pass the asset path when creating TRTC instance:
 
 ```javascript
-const trtc = TRTC.create({
+const trtc = TRTC.create({ 
   plugins: [VirtualBackground, AIDenoiser],
   assetsPath: 'https://your-cdn.com/assets'
 });

package/resource/knowledge/rtcengine/web/plugin/42-advanced-realtime-transcriber.md

@@ -90,7 +90,7 @@ const robotId = await trtc.startPlugin('RealtimeTranscriber', {
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
   console.log(`👤 ${data.speakerUserId}:`);
   console.log(`  Original: ${data.sourceText}`);
-
+  
   if (data.translationTexts) {
     Object.entries(data.translationTexts).forEach(([lang, text]) => {
       console.log(`  ${lang.toUpperCase()}: ${text}`);
@@ -119,7 +119,7 @@ Starts a real-time transcription task.
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| sourceLanguage | `string` | Required | Source language code, currently supports only `'zh'` and `'en'` |
+| sourceLanguage | `string` | Required | Source language code. Specifies the language of the source audio. Use a standard language code (for example, `'zh'`). For the list of supported languages, see [Supported Languages](#supported-languages) |
 | translationLanguages | `string` \| `string[]` | Optional | Target translation language(s), supports single language or array, e.g., `'en'` or `['en', 'ja']` |
 | userIdsToTranscribe | `string` \| `string[]` | Optional | User ID(s) to transcribe, defaults to `'all'` for all users, can also specify single or multiple user IDs |
 | transcriberRobotId | `string` | Optional | Custom transcriber robot ID, auto-generated if not provided |
@@ -183,6 +183,30 @@ trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
 });
 ```
 
+#### Backend Resource Limitation Notification
+
+When the backend AI service (ASR/translation) resources are limited, the SDK proactively notifies through the `TRTC.EVENT.ERROR` event (the backend sends this notification at most once per minute, and stops sending it once resources recover). In this case:
+
+- `error.code` is always `5400` (SERVER_ERROR, indicating the server failed to process the request)
+- `error.extraCode` is the downgrade event code, see the table below
+- `error.data` carries `{ roomId, transcriberRobotId, taskId, resourceType }` to identify the affected transcription task
+
+You should degrade or disable the relevant AI capabilities in time to avoid affecting your online business.
+
+| Event Code (extraCode) | Description | Suggested Action |
+|------------|-------------|------------------|
+
+```javascript
+trtc.on(TRTC.EVENT.ERROR, (error) => {
+  if (error.code === 5400 && error.extraCode === 5001) {
+    // e.g. error.message: 'The ASR/Translate concurrent usage has exceeded the limit. ...'
+    // error.data: { roomId, transcriberRobotId, taskId, resourceType }
+    console.warn(`Transcription service resources are limited, robotId: ${error.data.transcriberRobotId}, ${error.message}`);
+    // Degrade or disable the relevant AI capabilities as needed
+  }
+});
+```
+
 ### TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE
 
 Transcription message event, triggered when new transcription results are available.
@@ -204,10 +228,10 @@ Transcription message event, triggered when new transcription results are availa
 ```javascript
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   const { speakerUserId, sourceText, translationTexts, isCompleted } = event;
-
+  
   // Display real-time transcription result
   console.log(`[${isCompleted ? 'Completed' : 'In Progress'}] ${speakerUserId}: ${sourceText}`);
-
+  
   // Display translation results
   if (translationTexts) {
     translationTexts.forEach(({ language, text }) => {
@@ -228,10 +252,6 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 |----------|------|
 | Chinese | `zh` |
 | English | `en` |
-
-<!--
-| Traditional Chinese | `zh-tw` |
-| Chinese Dialects | `zh-dialect` |
 | Cantonese | `zh-yue` |
 | Vietnamese | `vi` |
 | Japanese | `ja` |
@@ -252,7 +272,7 @@ trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
 | Swedish | `sv` |
 | Danish | `da` |
 | Norwegian | `no` |
--->
+| For more languages
 
 ### Translation Target Languages
 
@@ -301,7 +321,7 @@ const subtitleMap = new Map();
 
 trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
   subtitleMap.set(event.segmentId, event);
-
+  
   if (event.isCompleted) {
     // Speech segment completed, can be archived
     archiveSubtitle(subtitleMap.get(event.segmentId));

package/server.js

@@ -41,7 +41,7 @@ User-visible output rules (MUST):
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.7.3",
+        version: "1.7.5",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/utils/preflight-route.js

@@ -1,209 +1,227 @@
-// ========== 信号分层（方案 §3，中英双语） ==========
-// 产品词：产品线路标识
-const PRODUCT_SIGNALS = {
-    call: /CallKit|TUICallKit|TUICallEngine|语音通话|视频通话|来电|去电|拨打|\b(?:voice|video)\s+calls?\b|incoming\s+calls?|outgoing\s+calls?|make\s+a\s+call|\bdial(?:ing)?\b/i,
-    live: /LiveKit|TUILiveKit|直播|语聊房|连麦|开播|观看直播|\blive\s+stream(?:ing)?\b|\bvoice\s+room\b|co-?host(?:ing)?|go\s+live|start\s+stream(?:ing)?|watch(?:ing)?\s+live|\bbroadcast(?:ing)?\b/i,
-    room: /RoomKit|会议|会中|会议室|屏幕分享|白板|\bconference\b|\bmeetings?\b|in-?meeting|meeting\s+room|screen\s+shar(?:e|ing)|white\s*board/i,
-    chat: /\bchat\b|\bim\b|会话|消息|TUIKit|ChatKit|\bconversation\b|\bmessaging\b|\binstant\s+messaging\b/i,
-    push: /TIMPush|推送|离线推送|FCM|APNs|华为|小米|OPPO|vivo|\bpush(?:\s+notification)?s?\b|offline\s+push|vendor\s+channel|\bHuawei\b|\bXiaomi\b|\bHonor\b/i,
-};
-// 平台词（纯运行形态，不含任何产品词）
-const PLATFORM_NATIVE_SIGNAL = /\b(android|ios|flutter|c\+\+|native)\b|安卓\s*(sdk|端|原生)|iOS\s*(SDK|端|原生)|原生\s*(sdk|端)?|native\s+(?:sdk|client|app)|mobile\s+(?:sdk|native)/i;
-const PLATFORM_WEB_SIGNAL = /\b(web|h5|html5|browser|webview)\b|浏览器|网页|Web端|H5端|网页端|web\s+(?:app|client|page)|in-?browser|mobile\s+browser|安卓\s*(浏览器|网页|H5|Web|webview)|iOS\s*(浏览器|网页|H5|Web|webview)|Android\s*(?:浏览器|网页|H5|Web|webview|browser|web)|iPad\s*(?:浏览器|网页|H5|Web|browser|web)|\b(Safari|Chrome|Edge|UC|QQ浏览器|QQ\s+Browser)\b/i;
-// 小程序信号：小程序 / 微信小程序 / miniprogram / mini program / AppService（小程序逻辑层专有名词）。
-// 命中即锁定 miniprogram，并像 web 一样压制 native 单字与 native 兜底，
-// 避免「PC 微信小程序…没有原生 WebSocket」这类描述里的「原生」被 PLATFORM_NATIVE_SIGNAL 误命中后兜底成 android。
+const PLATFORM_WEB_SIGNAL = /\b(web|h5|html5|browser|webview)\b|\bweb[_-]?rtc\b|浏览器|网页|Web端|H5端|网页端|web\s+(?:app|client|page)|in-?browser|mobile\s+browser|安卓\s*(浏览器|网页|H5|Web|webview)|iOS\s*(浏览器|网页|H5|Web|webview)|Android\s*(?:浏览器|网页|H5|Web|webview|browser|web)|iPad\s*(?:浏览器|网页|H5|Web|browser|web)|\b(Safari|Chrome|Edge|UC|QQ浏览器|QQ\s+Browser)\b/i;
+const FRAMEWORK_UNIAPP_SIGNAL = /\buni[-\s]?app\b|\buniapp\b|uni-app|HBuilderX/i;
+const FRAMEWORK_FLUTTER_SIGNAL = /\bflutter\b/i;
+const FRAMEWORK_REACT_NATIVE_SIGNAL = /\breact-native\b/i;
 const PLATFORM_MINIPROGRAM_SIGNAL = /小程序|微信小程序|\bmini[-\s]?program\b|\bminiprogram\b|\bAppService\b/i;
-// 平台+产品复合词（运行形态 + 产品线路标识）
-const WEB_PRODUCT_PAIR_SIGNAL = /\bweb\s+(trtc|sdk|im|chat|roomkit)\b|\b(trtc|sdk|im|chat|roomkit)\s+web\b|trtc[-\s]?sdk|trtc\.js/i;
-// API 词（客户端调用形态）
+const WEB_PRODUCT_PAIR_SIGNAL = /\bweb\s+(trtc|sdk|im|chat|roomkit)\b|\b(trtc|sdk|im|chat|roomkit)\s+web\b|trtc[-\s]sdk[-\s]?web|trtc\.js/i;
 const NATIVE_TRTC_CLASS_SIGNAL = /\b(TRTCCloud|TRTCCloudListener|TRTCCloudDelegate|ITRTCCloud|TRTCTypeDef|TRTCCloudCallback|TXAudioEffectManager|TXBeautyManager|TXDeviceManager|TXLiteAVCode|TXLiveSDKTypeDef)\b/i;
 const NATIVE_TRTC_METHOD_SIGNAL = /\b(?:TRTCCloud|ITRTCCloud|TX[A-Za-z0-9_]+)\s*(?:\.|::|->)\s*(?:set|get|start|stop|enable|disable)[A-Z][A-Za-z0-9_]+\b/i;
-const WEB_TRTC_API_RE = /TRTC\.(setCurrentSpeaker|getMicrophoneList|getSpeakerList|getCameraList|isSupported|create)|trtc\.(startLocalAudio|startLocalVideo|updateLocalAudio|updateLocalVideo)/i;
-const WEB_TRTC_TOKEN_RE = /^TRTC\.(setCurrentSpeaker|getMicrophoneList|getSpeakerList|getCameraList|isSupported|create)$/i;
-// 协议级 TRTC 信号
-const TRTC_SIGNAL = /\bTRTC\b|\bWebRTC\b|rtcengine|TRTCCloud|腾讯实时音视频/i;
-// ========== 工具函数 ==========
+// Web-only TRTC API 特征识别（合并为一条正则，用 | 分支组织三类判定条件）：
+//   1. setCurrentSpeaker/getMicrophoneList/getSpeakerList/getCameraList
+//      —— Web SDK 专属命名，native SDK 无同名方法，允许裸词命中（无需 "TRTC."/"trtc." 前缀）
+//   2. TRTC.isSupported / TRTC.create —— 语义过于通用，仍要求带点号前缀限定
+//   3. trtc.startLocalAudio/startLocalVideo/updateLocalAudio/updateLocalVideo
+//      —— native（TRTCCloud.xxx）也有同名方法，不是 Web 专属，仍要求带 "trtc."（小写）前缀区分
+const WEB_TRTC_API_RE = /\b(setCurrentSpeaker|getMicrophoneList|getSpeakerList|getCameraList)\b|TRTC\.(isSupported|create)|trtc\.(startLocalAudio|startLocalVideo|updateLocalAudio|updateLocalVideo)/i;
+const TRTC_FAMILY = new Set(['rtcengine', 'native_trtc_sdk']);
 function uniq(list) {
     return [...new Set(list)];
 }
-function extractQueryApiTokens(prompt) {
-    const matches = prompt.match(/\b(?:TRTC|trtc)\.[A-Za-z_][A-Za-z0-9_]*\b/g) ?? [];
-    return uniq(matches.map((m) => m.replace(/^trtc\./i, 'TRTC.')));
-}
-function collectPromptSignals(prompt) {
-    const products = new Set();
-    if (PRODUCT_SIGNALS.call.test(prompt))
-        products.add('call');
-    if (PRODUCT_SIGNALS.live.test(prompt))
-        products.add('live');
-    if (PRODUCT_SIGNALS.room.test(prompt))
-        products.add('room');
-    if (PRODUCT_SIGNALS.chat.test(prompt))
-        products.add('chat');
-    if (PRODUCT_SIGNALS.push.test(prompt))
-        products.add('push');
-    if (TRTC_SIGNAL.test(prompt))
-        products.add('trtc');
-    // 平台 tokens：web signal 锁定 → 压制 native 单字(安卓/iOS 仅归 hostEnv);
-    // miniprogram signal 锁定 → 同样压制 native 单字与 native 兜底(小程序逻辑层"没有原生 X"不应被判成 native)。
-    // 真复合词(unreal/unity/harmonyos/react-native/flutter/c++)不受影响。
-    const platforms = [];
-    const webLocked = PLATFORM_WEB_SIGNAL.test(prompt) || WEB_PRODUCT_PAIR_SIGNAL.test(prompt);
-    if (webLocked) {
-        platforms.push('web');
-    }
-    // 小程序信号优先级高于 native 单字/兜底：命中即锁定 miniprogram。
-    // web + 小程序可同时成立(如"小程序 web-view"),各自入 platforms 由 search core 做多平台归并。
-    const mpLocked = PLATFORM_MINIPROGRAM_SIGNAL.test(prompt);
-    if (mpLocked) {
-        platforms.push('miniprogram');
-    }
-    const nativeSpecificHits = [];
-    if (/\b(?:unreal|UE[45]?|unreal-engine)\b/i.test(prompt))
-        nativeSpecificHits.push('unreal-engine');
-    if (/\b(?:unity)\b/i.test(prompt))
-        nativeSpecificHits.push('unity');
-    if (/\b(?:harmonyos|鸿蒙|HarmonyOS)\b/i.test(prompt))
-        nativeSpecificHits.push('harmonyos');
-    if (/\b(?:react-native)\b/i.test(prompt))
-        nativeSpecificHits.push('react-native');
-    if (/\b(?:flutter)\b/i.test(prompt))
-        nativeSpecificHits.push('flutter');
-    if (/\b(?:c\+\+)\b/i.test(prompt))
-        nativeSpecificHits.push('c++');
-    // 安卓/iOS 单字只在非 web-locked 且非 miniprogram-locked 时进 platforms(否则仅归 hostEnv)
-    if (!webLocked && !mpLocked && /\b(?:ios|iphone|ipad|苹果)\b/i.test(prompt))
-        nativeSpecificHits.push('ios');
-    if (!webLocked && !mpLocked && /\b(?:android|安卓)\b/i.test(prompt))
-        nativeSpecificHits.push('android');
-    // 真复合词(如 unity/unreal/flutter/harmonyos/react-native/c++)无条件 push;单字在 web/miniprogram 锁定时被压制
-    if (nativeSpecificHits.length > 0) {
-        platforms.push(...nativeSpecificHits);
-    }
-    else if (!webLocked && !mpLocked && PLATFORM_NATIVE_SIGNAL.test(prompt)) {
-        // 仅 "native" 词,未指定细分 → 默认 android(web/miniprogram 锁定时不触发 fallback,
-        // 避免被 \b(android|ios|...) 或"原生"反向命中把 web/小程序 路径覆盖成 native)
-        platforms.push('android');
-    }
-    // Host env：仅用于标记，不进 platforms 归一化
-    let hostEnv = null;
+function detectHostEnv(prompt) {
     if (/\bios\b|iphone|ipad|苹果/i.test(prompt))
-        hostEnv = 'ios';
-    else if (/\bandroid\b|安卓/i.test(prompt))
-        hostEnv = 'android';
-    const queryApiTokens = extractQueryApiTokens(prompt);
-    const hasWebTrtcApi = PLATFORM_WEB_SIGNAL.test(prompt)
-        || WEB_TRTC_API_RE.test(prompt)
-        || queryApiTokens.some((t) => WEB_TRTC_TOKEN_RE.test(t));
-    const hasNativeTrtcApi = NATIVE_TRTC_CLASS_SIGNAL.test(prompt) || NATIVE_TRTC_METHOD_SIGNAL.test(prompt);
-    return { products, platforms, hostEnv, hasWebTrtcApi, hasNativeTrtcApi, queryApiTokens };
+        return 'ios';
+    if (/\bandroid\b|安卓/i.test(prompt))
+        return 'android';
+    return null;
 }
-function reconcileWithPrompt(promptValues, explicit) {
-    // 核心规则：prompt 是真值源，explicit 只在 prompt 为空时启用。
-    // 这条规则必须严格遵守——
-    //   「prompt 是用户问题表达出来的真实意图」，explicit 只在外部上下文（IDE/文件/历史）有补充价值，
-    //   但 prompt 既然明示了「Web」，就要按 Web 来，不要因为 explicit 多了 'android' 就把它"补"进来当成双路。
-    // 情形 1：prompt 真值存在 → 信任 prompt 真值
-    //   - 即便 explicit 扩张（prompt 外多列了平台）→ 也只输出 prompt 真值（prompt_override=true 表示 agent 推理被忽略）
-    //   - 即便 explicit 收缩（prompt 真值的子集）→ 也只输出 prompt 真值（避免丢失用户意图）
-    if (promptValues.length > 0) {
-        const promptSet = new Set(promptValues);
-        const sameAsExplicit = !!explicit?.length
-            && explicit.length === promptValues.length
-            && explicit.every((v) => promptSet.has(v));
-        return { values: uniq(promptValues), corrected: !sameAsExplicit };
-    }
-    // 情形 2：prompt 真值无平台信息 → 信任上游 agent 基于上下文（IDE/文件/历史）的推理
-    if (!promptValues.length) {
-        return { values: uniq(explicit ?? []), corrected: false };
-    }
-    return { values: [], corrected: false };
+function applyFrameworkLock(frameworks) {
+    const unique = uniq(frameworks);
+    if (unique.includes('uni-app'))
+        return ['uni-app'];
+    if (unique.includes('flutter'))
+        return ['flutter'];
+    if (unique.includes('react-native'))
+        return ['react-native'];
+    if (unique.includes('miniprogram'))
+        return ['miniprogram'];
+    return unique;
 }
-// ========== Phase 3: 单 SearchParams 构造 ==========
-//
-// 关键约束：**永远只返回单 primary**，consumer 只跑一次 searchKnowledge。
-// multi-platform / multi-product 通过把 frameworks / product 设成数组交给 search core 处理。
-// search core 的 filterPool.applyRankMultipliers 已原生支持多值归并。
-function passthroughPlan(params, reason, env) {
-    return { primary: params, meta: { route_reason: reason, environment_downgraded: env } };
+function collectPromptFrameworks(prompt) {
+    const values = [];
+    const uniapp = FRAMEWORK_UNIAPP_SIGNAL.test(prompt);
+    const flutter = FRAMEWORK_FLUTTER_SIGNAL.test(prompt);
+    const reactNative = FRAMEWORK_REACT_NATIVE_SIGNAL.test(prompt);
+    if (uniapp)
+        values.push('uni-app');
+    if (flutter)
+        values.push('flutter');
+    if (reactNative)
+        values.push('react-native');
+    const web = !uniapp && !flutter && !reactNative && (PLATFORM_WEB_SIGNAL.test(prompt) || WEB_PRODUCT_PAIR_SIGNAL.test(prompt));
+    if (web)
+        values.push('web');
+    const miniprogram = !uniapp && !flutter && !reactNative && PLATFORM_MINIPROGRAM_SIGNAL.test(prompt);
+    if (miniprogram)
+        values.push('miniprogram');
+    if (!uniapp && !flutter && !reactNative && /\b(?:unreal|UE[45]?|unreal-engine)\b/i.test(prompt))
+        values.push('unreal-engine');
+    if (!uniapp && !flutter && !reactNative && /\b(?:unity)\b/i.test(prompt))
+        values.push('unity');
+    if (!uniapp && !flutter && !reactNative && /\b(?:harmonyos|鸿蒙|HarmonyOS)\b/i.test(prompt))
+        values.push('harmonyos');
+    if (!uniapp && !flutter && !reactNative && /\b(?:c\+\+)\b/i.test(prompt))
+        values.push('c++');
+    if (!uniapp && !flutter && !reactNative && !web && !miniprogram && /\b(?:ios|iphone|ipad)\b|苹果/i.test(prompt))
+        values.push('ios');
+    if (!uniapp && !flutter && !reactNative && !web && !miniprogram && /\b(?:apns|voip)\b/i.test(prompt))
+        values.push('ios');
+    if (!uniapp && !flutter && !reactNative && !web && !miniprogram && /\bandroid\b|安卓/i.test(prompt))
+        values.push('android');
+    return uniq(values);
 }
-/** 单产品路径：product 是单值；frameworks 是数组（可能多平台共享一个 product） */
-function singleProductPlan(params, product, frameworks, hostEnv, reason) {
-    const envDiff = hostEnv != null && !frameworks.includes(hostEnv);
+function collectHardSignals(prompt) {
+    const hasWebTrtcApi = WEB_TRTC_API_RE.test(prompt);
     return {
-        primary: { ...params, product: [product], frameworks },
-        meta: { route_reason: reason, environment_downgraded: envDiff },
+        hostEnv: detectHostEnv(prompt),
+        promptFrameworks: collectPromptFrameworks(prompt),
+        hasStrongFrameworkLock: FRAMEWORK_UNIAPP_SIGNAL.test(prompt)
+            || FRAMEWORK_FLUTTER_SIGNAL.test(prompt)
+            || FRAMEWORK_REACT_NATIVE_SIGNAL.test(prompt)
+            || PLATFORM_MINIPROGRAM_SIGNAL.test(prompt),
+        hasWebRtcHardSignal: /\bweb[_-]?rtc\b|webrtc/i.test(prompt)
+            || hasWebTrtcApi
+            || /trtc\.js/i.test(prompt),
+        hasWebTrtcApiSignal: hasWebTrtcApi,
+        hasNativeTrtcHardSignal: NATIVE_TRTC_CLASS_SIGNAL.test(prompt) || NATIVE_TRTC_METHOD_SIGNAL.test(prompt),
     };
 }
-/** TRC 路径：product 是数组（rtcengine/native_trtc_sdk 两个产品码，按 platforms 各命中其一）；frameworks 也是数组 */
-function trcMultiProductPlan(params, products, frameworks, reason, env) {
-    return {
-        primary: { ...params, product: products, frameworks },
-        meta: { route_reason: reason, environment_downgraded: env },
-    };
+function intersect(base, target) {
+    const set = new Set(target);
+    return base.filter((item) => set.has(item));
 }
-// ========== 主入口（基于 prompt 真值归一化） ==========
-export function preflightRoute(params) {
-    const prompt = params.prompt ?? '';
-    const explicitFrameworks = params.frameworks?.length ? uniq(params.frameworks) : undefined;
-    const explicitProducts = params.product?.length ? uniq(params.product) : undefined;
-    // Phase 1
-    const signals = collectPromptSignals(prompt);
-    // —— 真跨主题（多产品信号）直接 passthrough
-    const nonTrtcProducts = [...signals.products].filter((p) => p !== 'trtc');
-    if (nonTrtcProducts.length > 1) {
-        return passthroughPlan(params, 'cross_product_passthrough', false);
+function sameStringArray(a, b) {
+    const left = uniq(a ?? []);
+    const right = uniq(b);
+    if (left.length !== right.length)
+        return false;
+    const set = new Set(left);
+    return right.every((item) => set.has(item));
+}
+function reconcileFrameworkAgentFirst(agentFrameworks, signals) {
+    // agent 保留原始多框架，不执行 applyFrameworkLock（避免丢失 miniprogram/android 等）
+    const agent = uniq(agentFrameworks ?? []);
+    // prompt 保留完整采集信号，不提前强锁（强锁只在最终输出时按需执行）
+    const prompt = uniq(signals.promptFrameworks);
+    // WebRTC 硬信号：强制剔除 host-env（android/ios），保留真实 framework 或补 web。
+    if (signals.hasWebRtcHardSignal) {
+        const strongFw = agent.filter((f) => !['android', 'ios'].includes(f));
+        if (strongFw.length > 0) {
+            const same = sameStringArray(agentFrameworks, strongFw);
+            return { values: strongFw, changed: !same, reason: same ? 'framework_keep_agent' : 'framework_narrowed_by_prompt' };
+        }
+        const already = agent.includes('web');
+        return { values: ['web'], changed: !already, reason: already ? 'framework_keep_agent' : 'framework_corrected_by_hard_signal' };
     }
-    // Phase 2: frameworks 调和
-    const fwRecon = reconcileWithPrompt(signals.platforms, explicitFrameworks);
-    const frameworks = fwRecon.values;
-    const envDowngraded = signals.hostEnv != null && !frameworks.includes(signals.hostEnv);
-    // Phase 2.5: products 调和（仅当 prompt 有非 TRTC 单产品时取此产品；TRTC 由 platform 推断 rtcengine/native_trtc_sdk）
-    const explicitTrtcBoth = explicitProducts?.includes('rtcengine') && explicitProducts?.includes('native_trtc_sdk');
-    const explicitTrtcAny = explicitProducts?.some((p) => p === 'rtcengine' || p === 'native_trtc_sdk') ?? false;
-    const isTrtcFamily = signals.products.has('trtc') || explicitTrtcBoth || (explicitTrtcAny && !nonTrtcProducts[0]);
-    // —— TRTC 家族：产物随平台分流
-    if (isTrtcFamily) {
-        const hasWeb = frameworks.includes('web');
-        const natives = frameworks.filter((f) => f !== 'web');
-        // TRTC + 多平台（web + native）→ product 数组，search core filterPool 原生接受多 product 交集
-        if (hasWeb && natives.length > 0) {
-            const reason = fwRecon.corrected ? 'trtc_multi_platform_prompt_override' : 'trtc_multi_platform';
-            return trcMultiProductPlan(params, ['rtcengine', 'native_trtc_sdk'], frameworks, reason, envDowngraded);
+    if (signals.hasStrongFrameworkLock && prompt.length > 0) {
+        const promptSet = new Set(prompt);
+        // 强框架命中时，先剔除 agent 里的纯 host-env（ios/android 不应作为独立 framework 保留）
+        const HOST_ENV = new Set(['android', 'ios']);
+        const agentNonHost = agent.filter((f) => !HOST_ENV.has(f));
+        const base = agentNonHost.length > 0 ? agentNonHost : agent;
+        // prompt 是 base 子集 → base 更丰富，保留 base，不收窄
+        if (prompt.every((f) => new Set(base).has(f))) {
+            const same = sameStringArray(agentFrameworks, base);
+            return { values: base, changed: !same, reason: same ? 'framework_keep_agent' : 'framework_narrowed_by_prompt' };
         }
-        // TRTC + 仅 web
-        if (hasWeb) {
-            const reason = fwRecon.corrected ? 'trtc_web_prompt_override' : 'trtc_web';
-            return singleProductPlan(params, 'rtcengine', ['web'], signals.hostEnv, reason);
+        // prompt 与 base 有交集 → 取交集，有限收窄
+        const intersection = base.filter((f) => promptSet.has(f));
+        if (intersection.length > 0) {
+            const same = sameStringArray(agentFrameworks, intersection);
+            return { values: intersection, changed: !same, reason: same ? 'framework_keep_agent' : 'framework_narrowed_by_prompt' };
         }
-        // TRTC + 仅 native
-        if (natives.length > 0) {
-            const reason = fwRecon.corrected ? 'trtc_native_prompt_override' : 'trtc_native';
-            return singleProductPlan(params, 'native_trtc_sdk', natives, signals.hostEnv, reason);
+        // 无交集（真冲突）：
+        // - agentNonHost 含真实框架（非 host-env、非泛平台词 web）→ agent 推断可信，透传
+        // - agentNonHost 为空或只含泛平台词（web/android/ios）→ prompt 强框架更具体，执行纠偏
+        const GENERIC_PLATFORM = new Set(['android', 'ios', 'web']);
+        const agentSpecific = agentNonHost.filter((f) => !GENERIC_PLATFORM.has(f));
+        if (agentSpecific.length > 0) {
+            return { values: base, changed: false, reason: 'framework_keep_agent' };
+        }
+        return { values: applyFrameworkLock(prompt), changed: true, reason: 'framework_corrected_by_hard_signal' };
+    }
+    if (agent.length > 0 && prompt.length > 0) {
+        const narrowed = intersect(agent, prompt);
+        if (narrowed.length > 0 && narrowed.length < agent.length) {
+            return { values: narrowed, changed: true, reason: 'framework_narrowed_by_prompt' };
         }
-        // TRTC 但 prompt / explicit 都没有可用平台 → 透传
-        return passthroughPlan(params, 'trtc_no_platform_resolved', false);
+        return { values: agent, changed: false, reason: 'framework_keep_agent' };
     }
-    // —— 单非 TRTC 产品
-    if (nonTrtcProducts.length === 1) {
-        const product = nonTrtcProducts[0];
-        // 多平台 → product 单值，frameworks 多值（search core filterPool 原生按 framework 交集过滤）
-        if (frameworks.length >= 2) {
-            const reason = fwRecon.corrected ? 'multi_platform_prompt_override' : 'multi_platform';
-            return singleProductPlan(params, product, frameworks, signals.hostEnv, reason);
+    if (agent.length > 0) {
+        return { values: agent, changed: false, reason: 'framework_keep_agent' };
+    }
+    if (prompt.length > 0) {
+        return { values: applyFrameworkLock(prompt), changed: true, reason: 'framework_adopt_prompt' };
+    }
+    return { values: [], changed: false, reason: 'framework_no_signal' };
+}
+function reconcileProductAgentFirst(agentProducts, signals) {
+    const agent = uniq(agentProducts ?? []);
+    // native TRTC 纠偏：agent 传 rtcengine 但 prompt 明确出现 native 类/方法时，收窄为 native_trtc_sdk。
+    // 前提：无 WebRTC 硬信号（避免 web+native 混场景误纠）。
+    if (signals.hasNativeTrtcHardSignal && !signals.hasWebRtcHardSignal) {
+        if (agent.includes('rtcengine') && !agent.includes('native_trtc_sdk')) {
+            return { values: ['native_trtc_sdk'], changed: true, reason: 'product_corrected_by_native_trtc_hard_signal' };
         }
-        // 单平台
-        if (frameworks.length === 1) {
-            const reason = fwRecon.corrected ? 'single_platform_prompt_override' : 'single_platform';
-            return singleProductPlan(params, product, frameworks, signals.hostEnv, reason);
+        return { values: agent, changed: false, reason: agent.length > 0 ? 'product_keep_agent' : 'product_no_signal' };
+    }
+    if (!signals.hasWebRtcHardSignal) {
+        return { values: agent, changed: false, reason: agent.length > 0 ? 'product_keep_agent' : 'product_no_signal' };
+    }
+    const targetProduct = 'rtcengine';
+    // agent 未提供产品时：若命中 Web-only TRTC API 级强信号（如 setCurrentSpeaker），
+    // 该信号本身足以确定产品为 rtcengine；否则（仅泛协议词如 "webrtc"）不替 agent 猜测，透传空。
+    if (agent.length === 0) {
+        if (signals.hasWebTrtcApiSignal) {
+            return { values: [targetProduct], changed: true, reason: 'product_corrected_by_webrtc_hard_signal' };
         }
-        // 无平台信号：透传（保留 explicit frameworks）
-        if (explicitFrameworks?.length) {
-            return singleProductPlan(params, product, uniq(explicitFrameworks), signals.hostEnv, 'product_no_platform_explicit');
+        return { values: [], changed: false, reason: 'product_no_signal' };
+    }
+    // agent 传的不是 TRTC 家族产品时，WebRTC 信号不足以覆盖，保持 agent 结果。
+    if (!agent.some((p) => TRTC_FAMILY.has(p))) {
+        return { values: agent, changed: false, reason: 'product_keep_agent' };
+    }
+    if (agent.includes(targetProduct)) {
+        if (agent.length === 1) {
+            return { values: agent, changed: false, reason: 'product_keep_agent' };
         }
-        return passthroughPlan(params, 'product_no_platform_signal', false);
+        return { values: [targetProduct], changed: true, reason: 'product_narrowed_by_prompt' };
     }
-    // —— 无产品信号：纯透传
-    return passthroughPlan(params, 'no_product_signal', false);
+    return { values: [targetProduct], changed: true, reason: 'product_corrected_by_webrtc_hard_signal' };
+}
+function buildRouteReason(frameworkDecision, productDecision) {
+    const reasons = [frameworkDecision.reason, productDecision.reason]
+        .filter((r) => r !== 'framework_no_signal' && r !== 'product_no_signal' && r !== 'framework_keep_agent' && r !== 'product_keep_agent');
+    if (reasons.length === 0)
+        return 'agent_passthrough';
+    return reasons.join('+');
+}
+function passthroughPlan(params, reason, env) {
+    return { primary: params, meta: { route_reason: reason, environment_downgraded: env } };
+}
+export function preflightRoute(params) {
+    const prompt = params.prompt ?? '';
+    const signals = collectHardSignals(prompt);
+    const frameworkDecision = reconcileFrameworkAgentFirst(params.frameworks, signals);
+    const finalFrameworks = frameworkDecision.values;
+    const productDecision = reconcileProductAgentFirst(params.product, signals);
+    const finalProducts = productDecision.values;
+    const reason = buildRouteReason(frameworkDecision, productDecision);
+    const envDowngraded = signals.hostEnv != null && finalFrameworks.length > 0 && !finalFrameworks.includes(signals.hostEnv);
+    if (!frameworkDecision.changed
+        && !productDecision.changed
+        && sameStringArray(params.product, finalProducts)
+        && sameStringArray(params.frameworks, finalFrameworks)) {
+        return passthroughPlan(params, reason, envDowngraded);
+    }
+    return {
+        primary: {
+            ...params,
+            product: finalProducts,
+            frameworks: finalFrameworks,
+        },
+        meta: {
+            route_reason: reason,
+            environment_downgraded: envDowngraded,
+        },
+    };
 }

package/utils/report-cls-client.js

@@ -28,7 +28,7 @@ function sendCLSReport(reportData) {
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.7.3',
+        verison: '1.7.5',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: queryID || userID,