@tencentcloud/sdk-mcp 1.6.8 → 1.7.1

package/resource/knowledge/roomkit/best-practice/common/room-screen-share-preview.md

@@ -0,0 +1,87 @@
+---
+title: TUIRoomKit 屏幕共享本地预览与避免无限套娃
+product: room
+frameworks: [react, vue, web]
+scope: platform_common
+tags: [TUIRoomKit, 屏幕共享, 本地预览, startScreenSharing, startScreenShare, 整屏共享, 无限套娃, 无限镜像, 窗口共享, 外接显示器, useDeviceState, view参数]
+version_range: ">=2.0.0"
+---
+
+# TUIRoomKit 屏幕共享本地预览与避免无限套娃
+
+## 1. 核心结论
+
+- `view` 参数可以本地显示正在共享的内容：传入有效 `view` 会在本地容器渲染分享画面（本地预览）；不传或传 `null` 则不渲染本地预览。
+- 整屏共享时本地预览会出现"无限套娃/无限镜像"：原因在于本地预览区域也在被采集的整屏/当前页里，预览画面再次进入采集产生递归镜像。
+- **优先方案：改为分享"窗口"而非整屏**，从源头避免会议页被采进画面导致的套娃。
+  - **分享 WPS 注意事项**：通常无法单独拿到"放映窗口"（放映态与编辑窗在采集列表里表现受限）。此时可让用户接**外接显示器**：把放映画面放到外接屏，再分享该显示器/对应窗口，会议主屏继续操作、预览也不易套娃。
+- **兜底方案**：无法改分享窗口、也无法使用外接显示器时，将本地预览窗口尽量做小（缩小 `view` 容器），可明显降低递归镜像的影响面；或本地不传 `view` / 传 `null`，仅用"正在共享"状态提示。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `view` | 本地屏幕分享预览容器 | 传入有效 DOM（元素或 id）则渲染本地预览；传 `null` 不渲染 |
+| `startScreenSharing` | 屏幕共享接口 | TRTC Web / Room 屏幕共享，`view` 指定本地预览 |
+| `startScreenShare` | 底层屏幕共享 | TRTC `startScreenShare`，与 Atomicx 一致 |
+| `useDeviceState().startScreenShare` | Atomicx 无 UI 路径 | 屏幕共享入口，本地预览由预览视图/容器决定 |
+
+## 3. 机制/时序
+
+### 本地预览
+
+调用屏幕共享接口并传入有效 `view` -> 本地容器渲染正在分享的画面（本地预览）-> 不传或传 `null` 则不渲染本地预览。
+
+## 4. 标准用法
+
+### 带本地预览的屏幕共享
+
+```javascript
+// TRTC Web / Room 屏幕共享，view 指定本地预览容器（元素或 id）
+startScreenShare({
+  view: 'local-preview-container',   // 传入有效 view，本地渲染分享画面
+  // 传 null 则不渲染本地预览
+});
+```
+
+### 避免无限套娃
+
+```javascript
+// 方案 1：优先分享窗口而非整屏，从源头避免套娃
+startScreenShare({ view: 'local-preview-container' });  // 选择窗口采集源
+
+// 方案 2（兜底）：无法分享窗口时，缩小本地预览容器或本地不传 view
+startScreenShare({ view: null });  // 不渲染本地预览，仅用"正在共享"状态提示
+```
+
+## 5. 结果判定
+
+- 传入有效 `view`：本地容器渲染分享画面，实现本地预览。
+- 不传 / 传 `null`：不渲染本地预览，仅共享画面给远端。
+- 整屏共享 + 本地预览：可能出现无限套娃，需改为窗口共享或缩小预览。
+- 分享 WPS 放映：需用外接显示器方案避免套娃。
+
+## 6. 常见误区
+
+- 误区 1：认为 `view` 是远端渲染参数（`view` 指定的是本地屏幕分享预览）。
+- 误区 2：整屏共享时本地预览必然套娃就放弃本地预览（可改为窗口共享或缩小预览）。
+- 误区 3：分享 WPS 时以为能单独拿到放映窗口（通常受限，需外接显示器）。
+- 误区 4：混淆 `startScreenSharing` 与 `startScreenShare`（底层一致，均通过 `view` 指定本地预览）。
+
+## 7. 问题定义（检索辅助，极简）
+
+TUIRoomKit 屏幕共享时 `view` 参数能否本地预览正在共享的内容，以及整屏共享时本地预览如何避免无限套娃/无限镜像。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- 屏幕共享能本地预览吗？
+- TUIRoomKit 屏幕共享 startScreenShare view 参数是什么？
+- 整屏共享怎么避免无限镜像？
+- 屏幕共享出现套娃怎么办？
+- 分享窗口还是整屏更合适？
+- 本地预览窗口怎么缩小？
+- 屏幕共享怎么隐藏本地预览？
+
+## 9. 参考来源（可选）
+
+- TRTC Web `startScreenShare`：`https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/TRTC.html`

package/resource/knowledge/roomkit/best-practice/common/room-status-after-all-leave.md

@@ -0,0 +1,73 @@
+---
+title: TUIRoomKit 所有人离开后房间状态与计费说明
+product: room
+frameworks: [react, vue, web, android, ios, flutter]
+scope: platform_common
+tags: [TUIRoomKit, 所有人离开, 房间销毁, 回收房间, 解散房间, 计费, 会议结束, 房间存在, 房间数量]
+version_range: ">=2.0.0"
+---
+
+# TUIRoomKit 所有人离开后房间状态与计费说明
+
+## 1. 核心结论
+
+- 房间**不会**因为"所有人离开"就立刻自动销毁。
+- 会议结束后，业务侧应**主动调用解散房间接口**结束本场会议。
+- 若未手动解散：后台会在会议结束时间 **6 小时以后**尝试回收房间，回收条件是**房间内成员数为 0**。
+- 计费按实际推拉流/通话消耗；成员都离开且无媒体占用后一般不再产生音视频时长，但房间对象在未解散、未回收前仍占用房间数量。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| 解散房间接口 | 主动结束会议 | 业务侧会议结束后主动调用 |
+| 后台回收 | 自动清理房间 | 会议结束 6 小时后尝试回收，条件为成员数 0 |
+| 房间内成员数 | 房间成员统计 | 回收的条件：成员数为 0 |
+| 音视频时长计费 | 通话消耗计费 | 按实际推拉流/通话消耗计费 |
+| 房间数量占用 | 房间对象占用 | 未解散、未回收前仍占用房间数量 |
+
+## 3. 机制/时序
+
+所有人离开房间 -> 房间不会立刻自动销毁 -> 业务侧主动调用解散房间接口（推荐），或等待后台自动回收 -> 后台在会议结束 6 小时后尝试回收（条件为成员数 0）-> 房间回收。
+
+计费维度：
+
+- 音视频时长按实际推拉流/通话消耗计费。
+- 成员都离开且无媒体占用后，一般不再产生该房间的音视频时长。
+- 房间对象在未解散、未回收前仍占用房间数量。
+
+## 4. 标准用法
+
+1. 会议结束后，业务侧主动调用解散房间接口结束会议，避免房间残留。
+2. 若忘记手动解散，后台会在 6 小时后自动回收（成员数为 0 时）。
+3. 评估房间数量占用时，注意未解散、未回收的房间对象仍占用配额。
+
+## 5. 结果判定
+
+- 主动解散后，房间立即结束。
+- 未主动解散时，后台在会议结束 6 小时后、成员数为 0 时回收房间。
+- 成员都离开且无媒体占用后，不再产生音视频时长计费。
+- 未解散、未回收的房间对象仍占用房间数量。
+
+## 6. 常见误区
+
+- 误区 1：认为所有人离开后房间会自动销毁（需主动解散或等待 6 小时后台回收）。
+- 误区 2：认为未解散的房间不产生任何费用（房间对象仍占用房间数量，可能影响并发配额）。
+- 误区 3：忽略业务侧主动解散（推荐主动调用解散接口，而非依赖后台回收）。
+
+## 7. 问题定义（检索辅助，极简）
+
+TUIRoomKit 房间内所有人离开后房间是否还存在、是否会继续计费，以及如何主动解散房间。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- 所有人离开后房间会自动销毁吗？
+- TUIRoomKit 房间空了还会计费吗？
+- 会议结束后怎么解散房间？
+- 房间回收要等多久？
+- 房间成员数为 0 会怎样？
+- 房间对象还占房间数量吗？
+
+## 9. 参考来源（可选）
+
+- 开通服务 / 功能与计费说明：`https://cloud.tencent.com/document/product/269/104946`

package/resource/knowledge/roomkit/best-practice/vue/room-uikit-vs-atomicx.md

@@ -0,0 +1,115 @@
+---
+title: tuikit-atomicx-vue3/room 与 roomkit-web-vue3 定位对比
+product: room
+frameworks: [vue, web]
+scope: platform_specific
+tags: [TUIRoomKit, Atomicx, UIKit, tuikit-atomicx-vue3, roomkit-web-vue3, useRoomState, conference, 层级对比, 无UI, 预制UI, 自定义集成, 依赖关系, vue3]
+version_range: ">=2.0.0"
+---
+
+# tuikit-atomicx-vue3/room 与 roomkit-web-vue3 定位对比
+
+## 1. 核心结论
+
+- `tuikit-atomicx-vue3/room`（Atomicx）是**原子能力层**，无 UI / 强自定义集成主路径，把房间、设备、成员等拆成响应式 State。
+- `@tencentcloud/roomkit-web-vue3`（RoomKit / UIKit）是**含 UI 低代码层**，开箱即用的会议套件与页面级组件。
+- 依赖关系：**RoomKit（含 UI）建在 Atomicx/Room 能力之上的产品化封装**，业务上可理解为 RoomKit 复用/对接 Atomicx 能力，而非两套互不相干的房间协议。
+- API 入口：Atomicx 用 `useRoomState()`，UIKit 用 `conference`。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `useRoomState` | Atomicx 房间状态入口 | `createAndJoinRoom` / `joinRoom` / `leaveRoom` / `endRoom` / `currentRoom` |
+| `useDeviceState` | Atomicx 设备状态 | 设备开关、屏幕共享等 |
+| `useRoomParticipantState` | Atomicx 成员状态 | 成员管控、事件订阅 |
+| `useLoginState` | Atomicx 登录状态 | 登录能力，UIKit 会中可复用 |
+| `conference` | UIKit 会议门面 API | 推荐 `createAndJoinRoom` / `joinRoom` / `leaveRoom` / `endRoom` |
+| `ConferenceMainView` | UIKit 预制视图 | 登录进房、会控、布局、麦位等完整会议 UI |
+
+## 3. 机制/时序
+
+### 定位对比
+
+| 对比项 | `tuikit-atomicx-vue3/room`（Atomicx） | `@tencentcloud/roomkit-web-vue3`（RoomKit / UIKit） |
+|---|---|---|
+| **层级** | Atomicx（原子能力层）：State Hooks + 可选原子 UI 组件 | UIKit / 含 UI 低代码层：开箱即用的会议套件与页面级组件 |
+| **包定位** | 无 UI / 强自定义集成主路径；把房间、设备、成员等拆成响应式 State | 含 UI 快速集成主路径；提供完整会议 UI 与 `conference` 门面 API |
+| **核心能力** | `useRoomState` / `useDeviceState` / `useRoomParticipantState` / `useLoginState`：创房、入会、设备、屏幕共享、成员管控、事件订阅；可自拼 UI | `conference` + 预制视图（如 `ConferenceMainView`）：登录进房、会控、布局、麦位等会议完整体验；支持部分组件显隐/自定义 Widget |
+| **适用场景** | 把音视频嵌进自有业务 UI（医联、OA、教育后台等），要 100% 控交互与品牌 | 要最快上线标准会议/研讨会，少写 UI，接受官方会议交互 |
+| **依赖关系** | 底层基于 RoomEngine / TRTC / IM；是原子化接入方案 | 含 UI 方案复用/对接 Atomicx 能力（如登录用 `useLoginState`，会中逻辑走 Room 能力）；业务上可理解为 RoomKit（含 UI）建在 Atomicx/Room 能力之上的产品化封装 |
+| **API 入口** | `useRoomState()`：`createAndJoinRoom` / `joinRoom` / `leaveRoom` / `endRoom`、`currentRoom`、事件订阅等 | `conference`：推荐 `createAndJoinRoom` / `joinRoom` / `leaveRoom` / `endRoom` |
+| **UI 形态** | 预制原子组件可选用 + 自定义模块自拼为主 | 预制完整会议 UI 为主，可通过 Widget/显隐配置做有限定制 |
+
+## 4. 标准用法
+
+### Atomicx 方式（无 UI，自定义集成）
+
+```javascript
+import { useRoomState } from 'tuikit-atomicx-vue3/room';
+
+const { createAndJoinRoom } = useRoomState();
+
+createAndJoinRoom({
+  roomId: 'YOUR_ROOM_ID', // 必填：建议由业务后台生成的唯一标识
+  options: {
+    roomName: '项目进度周会',
+  },
+});
+// 通过 useDeviceState / useRoomParticipantState 等获取响应式状态自拼 UI
+```
+
+### UIKit 方式（含 UI，快速集成）
+
+```javascript
+import { conference, ConferenceMainView, ConferenceMainViewH5, RoomEvent, genTestUserSig } from '@tencentcloud/roomkit-web-vue3';
+const SDKAppID = 0; // 替换为您在开通服务阶段获取的 SDKAppID
+const SDKSecretKey = ''; // 替换为您在开通服务阶段获取的 SDKSecretKey
+const handleEnterRoom = async () => {
+  if (!SDKAppID || !SDKSecretKey) {
+    return;
+  }
+  try {
+    const { userSig } = genTestUserSig({ userId: 'test01', sdkAppId: SDKAppID, secretKey: SDKSecretKey });
+    await conference.login({ sdkAppId: SDKAppID, userId: 'test01', userSig });
+    await conference.setSelfInfo({ userName: 'test', avatarUrl: '' });
+    await conference.createAndJoinRoom({ roomId: '123456', options: { roomName: `test01 的会议` } });
+    inRoom.value = true;
+  } catch (error) {
+    console.error('进入会议失败:', error);
+  }
+};
+// 使用预制 ConferenceMainView 渲染完整会议 UI
+```
+
+## 5. 结果判定
+
+- 无 UI / 强自定义需求：选 Atomicx，用 `useRoomState()` + State Hooks 自拼 UI。
+- 快速上线标准会议：选 UIKit，用 `conference` + `ConferenceMainView`。
+- 依赖关系：UIKit 复用 Atomicx 能力，非两套独立协议。
+- API 入口：Atomicx 为 `useRoomState()`，UIKit 为 `conference`。
+
+## 6. 常见误区
+
+- 误区 1：认为 Atomicx 和 UIKit 是两套互不相干的房间协议（UIKit 建在 Atomicx/Room 能力之上）。
+- 误区 2：用 Atomicx 时误以为自带完整会议 UI（Atomicx 是 State Hooks + 可选原子组件，UI 需自拼）。
+- 误区 3：用 UIKit 时误以为无法自定义（支持部分组件显隐 / 自定义 Widget）。
+- 误区 4：混淆两套的 API 入口（Atomicx 用 `useRoomState()`，UIKit 用 `conference`）。
+
+## 7. 问题定义（检索辅助，极简）
+
+对比 TUIRoomKit Vue3 两种集成方案的定位差异：`tuikit-atomicx-vue3/room`（Atomicx Core SDK，无 UI，State Hooks 自拼）与 `@tencentcloud/roomkit-web-vue3`（RoomKit UIKit，含 UI，conference 低代码）在层级、能力、适用场景、依赖关系与 API 入口（useRoomState vs conference）方面的差异。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- Atomicx 和 RoomKit 有什么区别？
+- `tuikit-atomicx-vue3/room` 和 `roomkit-web-vue3` 怎么选？
+- TUIRoomKit 无 UI 和含 UI 方案怎么选？
+- `useRoomState` 和 `conference` 区别？
+- RoomKit 基于 Atomicx 吗？
+- 自定义会议室 UI 用哪个包？
+- 快速集成会议用 Atomicx 还是 UIKit？
+
+## 9. 参考来源（可选）
+
+- 房间管理 Web：`https://cloud.tencent.com/document/product/647/126919`

package/resource/knowledge/roomkit/core-sdk/android/call-user-to-room.md

@@ -232,3 +232,4 @@ fun rejectCall(roomID: String, reason: CallRejectionReason = CallRejectionReason
 | <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
 | <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 房间预约 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-store/index.html">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/android/room-participant-state.md

@@ -675,3 +675,4 @@ private fun subscribeParticipantState() {
 | <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
 | <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.room/-room-participant-store/index.html">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/android/room-state.md

@@ -355,3 +355,4 @@ private fun subscribeCurrentRoomState() {
       **这对开发者意味着什么？**
 
       `participantCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于 **UI 展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。
+

package/resource/knowledge/roomkit/core-sdk/android/schedule-room.md

@@ -333,3 +333,4 @@ private fun subscribeParticipantState() {
   - 场景说明：如果您的房间开始时间设置得过近（例如 5 分钟后开始），而提醒时间设置得过大（例如设置 10 分钟前提醒），系统将无法捕捉到触发时机，从而导致事件丢失。
 
   - 解决建议：请确保预定的开始时间距离当前时刻，大于您所设置的提醒秒数。
+

package/resource/knowledge/roomkit/core-sdk/flutter/call-user-to-room.md

@@ -226,3 +226,4 @@ Future<void> rejectCall(String roomID, {CallRejectionReason reason = CallRejecti
 | <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
 | <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 预定房间 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_store/RoomStore-class.html">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/flutter/room-participant-state.md

@@ -793,3 +793,4 @@ Widget buildSpeakingUsersWidget() {
 | <strong>Store</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
 | <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_Flutter/api_room_room_participant_store/RoomParticipantStore-class.html">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/flutter/room-state.md

@@ -321,3 +321,4 @@ ValueListenableBuilder(
       **这对开发者意味着什么？**
 
       `participantCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于 **UI 展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。
+

package/resource/knowledge/roomkit/core-sdk/flutter/schedule-room.md

@@ -321,3 +321,4 @@ Future<void> scheduleRoom() async {
 - 场景说明：如果您的房间开始时间设置得过近（例如 5 分钟后开始），而提醒时间设置得过大（例如设置 10 分钟前提醒），系统将无法捕捉到触发时机，从而导致事件丢失。
 
 - 解决建议：请确保预定的开始时间距离当前时刻，大于您所设置的提醒秒数。
+

package/resource/knowledge/roomkit/core-sdk/ios/call-user-to-room.md

@@ -224,3 +224,4 @@ func rejectCall(roomID: String, reason: CallRejectionReason = .rejected) {
 | <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API文档</strong> |
 | --- | --- | --- |
 | <strong>RoomStore</strong> | 房间全生命周期管理：创建并加入 / 加入 / 离开 / 结束房间 / 更新、获取房间信息 / 预定房间 / 呼叫房间外成员 / 监听房间内被动事件（例如房间解散，房间信息更新等）。 | <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomstore">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/ios/room-participant-state.md

@@ -648,3 +648,4 @@ private func subscribeParticipantState() {
 | <strong>Store/Component</strong> | <strong>功能描述</strong> | <strong>API 文档</strong> |
 | --- | --- | --- |
 | <strong>RoomParticipantStore</strong> | 房间内参与者管理：设置管理员 / 转移房主 / 获取参与者列表 / 移出房间 / 参与者设备控制（例如关闭、邀请打开摄像头、麦克风等）/ 申请打开设备（例如申请打开摄像头、麦克风等）。 | <a href="https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/roomparticipantstore">API 文档</a> |
+

package/resource/knowledge/roomkit/core-sdk/ios/room-state.md

@@ -316,3 +316,4 @@ private func subscribeRoomState() {
       **这对开发者意味着什么？**
 
       `participantCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于 **UI 展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。
+

package/resource/knowledge/roomkit/core-sdk/ios/schedule-room.md

@@ -314,3 +314,4 @@ private func subscribeScheduledRoomListState() {
 - 场景说明：如果您的房间开始时间设置得过近（例如 5 分钟后开始），而提醒时间设置得过大（例如设置 10 分钟前提醒），系统将无法捕捉到触发时机，从而导致事件丢失。
 
 - 解决建议：请确保预约的开始时间距离当前时刻，大于您所设置的提醒秒数。
+

package/resource/knowledge/roomkit/core-sdk/vue/room-view.md

@@ -525,3 +525,4 @@ PC Web 推荐使用 `RoomLayoutTemplate.SidebarLayout` 或 `RoomLayoutTemplate.C
 PC Web 宫格布局单页最多展示 9 路画面，超过后通过翻页展示。移动端布局采用滑动分页方式展示。
 
 ### `RoomView` 提供的布局均不满足需求，是否可以提供更多的可选布局？
+

package/resource/knowledge/roomkit/preset/react/integration.md

@@ -766,3 +766,4 @@ TUIRoomKit 已经为您提供了极其丰富的 UI 自定义能力，包括 自
 // 请替换为 TUIRoomKit 源码真实路径
 src/components/RoomKit
 ```
+

package/resource/knowledge/rtcengine/web/plugin/30-advanced-cross-room-link.md

@@ -8,6 +8,8 @@
 - **房间级连麦**：与目标房间的所有主播连麦。
 - **用户级连麦**：与目标房间的某个主播连麦。
 
+> **注意**：房间级连麦与用户级连麦不能混用。
+
 ## 工作原理
 
 - **房间级连麦**：将当前房间所有主播的音视频流额外推送到目标房间，同时将目标房间所有主播的音视频流额外推送到当前房间。

package/resource/knowledge/rtcengine/web/plugin/39-advanced-video-decoder.md

@@ -6,6 +6,8 @@
 
 - TRTC Web SDK 版本 >= 5.9.0
 
+- 浏览器版本：Chrome 141+、Edge 141+ 及其他 Chromium 内核浏览器 141+（Safari 和 Firefox 暂不支持）
+
 ## 实现流程
 
 ### 部署静态资源

package/resource/knowledge/trtc/android/TRTCCloud.md

@@ -1825,3 +1825,4 @@ true：消息已通过限制，等待后续视频帧发送；false：消息被
 >
 
 **返回值说明：**
+

package/resource/knowledge/trtc/c++/ITRTCCloud.md

@@ -1962,3 +1962,4 @@ true：消息已通过限制，等待后续视频帧发送；false：消息被
 >
 
 **返回值说明：**
+

package/resource/knowledge/trtc/ios/TRTCCloud.md

@@ -2024,3 +2024,4 @@ YES：消息已通过限制，等待后续视频帧发送；NO：消息被限制
 >
 
 **返回值说明：**
+

package/server.js

@@ -28,15 +28,20 @@ You are using Tencent RTC MCP Server for SDK documentation retrieval.
 
 Workflow:
 1. Call search_trtc_knowledge. Reuse the same queryID for all retries/searches in this consultation.
-2. Draft the final answer from fragments. Include References from meta.references/doc_urls when available.
-3. MUST call finalize_answer with the same prompt + queryID before replying.
-4. Reply with: answer + finalize_answer follow-up text.
+2. Draft the complete answer from fragments. Include References from meta.references/doc_urls when available.
+3. MUST call finalize_answer with the same prompt, answer, and queryID before replying.
+4. Reply with that answer + finalize_answer follow-up text.
 5. After finalize_answer follow-up, check the next user reply before any normal response. If it means Yes/已解决/thanks/OK, MUST call submit_feedback(resolved="1") before replying. If it means No/未解决/still not working, MUST call submit_feedback(resolved="0") before replying. Never say feedback was submitted unless submit_feedback was called.
+
+User-visible output rule (MUST):
+- Internal routing/tool decisions are NEVER user-facing text.
+- Before calling any tool, do NOT output preface like “应调用…/先调用…/让我先搜索…/属于咨询类问题…/而非 codegen…”.
+- If a tool call is needed, call it directly; then provide user-facing results only.
 `.trim();
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.6.8",
+        version: "1.7.1",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/streamable-http.js

@@ -3,66 +3,31 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import { createServer } from './server.js';
 const app = express();
 app.use(express.json());
-const server = createServer();
-const transport = new StreamableHTTPServerTransport({
-    sessionIdGenerator: undefined, // set to undefined for stateless servers
-});
-// Setup routes for the server
-const setupServer = async () => {
+// 无状态 Streamable HTTP：每个请求都新建独立 McpServer 实例和 transport，
+// 避免复用已 connect 的实例导致 "Already connected"。
+async function handleMcpRequest(req, res) {
+    const server = createServer();
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // 无状态服务：不生成持久 session
+    });
     await server.connect(transport);
-};
+    await transport.handleRequest(req, res, req.body);
+}
 app.post('/mcp', async (req, res) => {
-    console.log('Received MCP request:', req.body);
-    try {
-        await transport.handleRequest(req, res, req.body);
-    }
-    catch (error) {
-        console.error('Error handling MCP request:', error);
-        if (!res.headersSent) {
-            res.status(500).json({
-                jsonrpc: '2.0',
-                error: {
-                    code: -32603,
-                    message: 'Internal server error',
-                },
-                id: null,
-            });
-        }
-    }
+    await handleMcpRequest(req, res);
 });
 app.get('/mcp', async (req, res) => {
-    console.log('Received GET MCP request');
-    res.writeHead(405).end(JSON.stringify({
-        jsonrpc: "2.0",
-        error: {
-            code: -32000,
-            message: "Method not allowed."
-        },
-        id: null
-    }));
+    await handleMcpRequest(req, res);
 });
 app.delete('/mcp', async (req, res) => {
-    console.log('Received DELETE MCP request');
-    res.writeHead(405).end(JSON.stringify({
-        jsonrpc: "2.0",
-        error: {
-            code: -32000,
-            message: "Method not allowed."
-        },
-        id: null
-    }));
+    await handleMcpRequest(req, res);
 });
 // Start the server
-const PORT = process.env.PORT || 3088;
-setupServer().then(() => {
-    app.listen(PORT, (error) => {
-        if (error) {
-            console.error('Failed to start server:', error);
-            process.exit(1);
-        }
-        console.log(`Weather MCP Server listening on port ${PORT}`);
-    });
-}).catch(error => {
-    console.error('Failed to set up the server:', error);
-    process.exit(1);
+const PORT = process.env.PORT || 8081;
+app.listen(PORT, (error) => {
+    if (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+    console.log(`RTC MCP Server (streamable HTTP) listening on port ${PORT}`);
 });

package/tools/common/search_trtc_knowledge.js

@@ -2,7 +2,9 @@ import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { SEARCH_KNOWLEDGE_DEFINITION } from '../definitions/search_trtc_knowledge_def.js';
 import { searchKnowledge } from '../../knowledge/search/search-knowledge.js';
+import { enrichL1Fragments } from '../../knowledge/search/l1-enrich.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
+import { preflightRoute } from '../../utils/preflight-route.js';
 const registrySearchTRTCKnowledgeTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = SEARCH_KNOWLEDGE_DEFINITION;
     mcpServer.registerTool(name, {
@@ -10,7 +12,7 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
         inputSchema: {
             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),
-            frameworks: z.array(z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut'])).min(1).optional().describe(parameter_descriptions.frameworks),
+            frameworks: z.array(z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut'])).default([]).describe(parameter_descriptions.frameworks),
             queryID: z.string().describe(parameter_descriptions.queryID),
             ide: z.string().describe(parameter_descriptions.ide),
             types: z.array(z.enum([
@@ -21,18 +23,11 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             limit: z.number().min(1).max(16).default(8).describe(parameter_descriptions.limit),
             from: z.string().default('').describe(parameter_descriptions.from),
         },
-    }, (params) => {
+    }, async (params) => {
         const qid = params.queryID || randomUUID();
-        reportCLSClient({
-            method: 'search_trtc_knowledge',
-            queryID: qid,
-            prompt: params.prompt,
-            framework: params.frameworks?.join(',') ?? '',
-            product: params.product ? params.product.join(',') : '',
-            ide: params.ide,
-            from: params.from,
-        });
-        const response = searchKnowledge({
+        // preflight 只做归一化（归类、矛盾校正），不做 multi-path 编排。
+        // multi-platform 由 search core 的 filterPool（按 frameworks 交集）原生处理。
+        const routePlan = preflightRoute({
             prompt: params.prompt,
             product: params.product,
             frameworks: params.frameworks,
@@ -40,6 +35,23 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             scenario: params.scenario,
             limit: params.limit,
         });
+        reportCLSClient({
+            method: 'search_trtc_knowledge',
+            queryID: qid,
+            prompt: params.prompt,
+            framework: routePlan.primary.frameworks?.join(',') ?? '',
+            product: routePlan.primary.product?.join(',') ?? '',
+            ide: params.ide,
+            from: params.from,
+            info: JSON.stringify({
+                preflight: routePlan.meta,
+                normalized_product: routePlan.primary.product,
+                normalized_frameworks: routePlan.primary.frameworks,
+            }),
+        });
+        // 单次检索：multi-platform same-product 由 frameworks 数组承接；TRC web+native 由 product 数组承接。
+        const result = searchKnowledge(routePlan.primary);
+        const response = await enrichL1Fragments(result);
         return {
             content: [{ type: 'text', text: JSON.stringify({ ...response, queryID: qid }) }],
         };

package/tools/definitions/finalize_answer_def.js

@@ -9,7 +9,7 @@ When to call:
 
 Input:
 - prompt: Original user question. Must match the search_trtc_knowledge prompt.
-- answer: Complete final answer text, excluding the follow-up text. Do not summarize or truncate.
+- answer: Full synthesized answer (same text sent to the user).
 - queryID: REQUIRED. Must match the non-empty queryID returned by search_trtc_knowledge.
 - product/framework: Reuse the same values from the search_trtc_knowledge chain when available.
 
@@ -19,7 +19,7 @@ Returns:
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: 'Original user question. Must match search_trtc_knowledge.',
-    answer: 'Complete final answer text, excluding the follow-up text. Do not summarize or truncate.',
+    answer: 'Full synthesized answer (same text sent to the user).',
     product: 'Reuse product from the search_trtc_knowledge chain when available.',
     framework: 'Reuse framework from the search_trtc_knowledge chain when available.',
     queryID: 'REQUIRED. Non-empty queryID returned by search_trtc_knowledge.',

package/tools/definitions/integration-boundary.js

@@ -2,4 +2,5 @@
 export const INTEGRATION_BOUNDARY_SUFFIX = `
 - **Codegen 专用**：仅当用户明确要求「集成进项目 / 写接入代码 / 帮我实现接入 / 生成工程代码」时调用本工具
 - **纯咨询或查阅**（怎么用、是什么、有哪些步骤、先看文档、错误排查、API/组件说明）→ 调用 \`search_trtc_knowledge\`，**不要**调用本工具
-- 本工具属 codegen 链路：作答后**不**调用 \`finalize_answer\` / \`submit_feedback\`（这两个仅属 \`search_trtc_knowledge\` 链路）`;
+- 本工具属 codegen 链路：作答后**不**调用 \`finalize_answer\` / \`submit_feedback\`（这两个仅属 \`search_trtc_knowledge\` 链路）
+- **用户可见输出约束（强制）**：以上链路/工具选择仅用于内部决策，禁止在对用户文本中出现“应调用/先调用/让我先搜索/我将调用某工具/属于咨询类问题/而非 codegen”等流程说明；直接输出结论与可执行内容。`;