@tencentcloud/sdk-mcp 1.6.8 → 1.7.0

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

@@ -216,7 +216,7 @@ iOS 如需统计推送触达数据，请在 `registerPush` 时传入 `applicatio
 
 运行 App 后，过滤 `TIMPush` 关键字查看注册日志。注册成功后，调用 `getRegistrationID()` 获取当前设备推送标识。控制台或服务端发送测试消息时，可使用该值定位设备。
 
-测试流程请参考 [Android 测试推送](https://cloud.tencent.com/document/product/269/100626#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 和 [iOS 测试推送](https://cloud.tencent.com/document/product/269/100627#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81)文档。仅集成 TIMPush 的用户，建议优先使用腾讯云控制台接入测试能力验证离线推送。
+测试流程请参考 [Android 测试推送](https://cloud.tencent.com/document/product/269/100626#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 和 [iOS 测试推送](https://cloud.tencent.com/document/product/269/100627#.E6.B5.8B.E8.AF.95.E6.8E.A8.E9.80.81) 文档。仅集成 TIMPush 的用户，建议优先使用腾讯云控制台接入测试能力验证离线推送。
 
 如果您的项目已接入 IM SDK，可通过 SDK API 发送一条带离线推送参数的消息进行验证。Flutter 侧示例如下：
 ``` java
@@ -354,11 +354,11 @@ Future<void> removeTIMPushListener() async {
 
 ## 收不到推送排障流程
 
-### 步骤一 原生侧排查
+### 步骤1：原生侧排查
 
 如果发送测试消息后设备没有收到推送，请先按平台文档 [Android 收不到推送排障流程](https://cloud.tencent.com/document/product/269/100626#.E6.94.B6.E4.B8.8D.E5.88.B0.E6.8E.A8.E9.80.81.E6.8E.92.E9.9A.9C.E6.B5.81.E7.A8.8B) 和 [iOS 收不到推送排障流程](https://cloud.tencent.com/document/product/269/100627#.E6.94.B6.E4.B8.8D.E5.88.B0.E6.8E.A8.E9.80.81.E6.8E.92.E9.9A.9C.E6.B5.81.E7.A8.8B) 完成原生侧排查。
 
-### 步骤二 Flutter 侧可按以下顺序补充检查
+### 步骤2：Flutter 侧可按以下顺序补充检查
 1. 确认 `registerPush` 返回 `code = 0`。如果返回非 0，请先根据错误码和 `errorMessage` 排查，不要只看 App 是否启动成功。
 
 2. 注册成功后调用 `getRegistrationID()`，确认返回值非空。控制台或服务端发送测试消息时，使用的 `RegistrationID / userID` 应与这里返回的值一致。

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

@@ -132,7 +132,7 @@ import TIMPush
 registerPush 用于向 TIMPush 注册当前设备的推送 token。推送 token 是厂商通道返回的设备凭证，通常由 SDK 自动处理。注册成功后，TIMPush 会为当前设备建立一个推送目标标识 `registrationID`；服务端、控制台接入测试和排查工具可以使用该标识向这台设备下发离线推送。若 App 同时接入 IM 并完成登录，也可以使用 `userID` 向该用户已建立推送关系的设备下发离线推送。
 
 `appKey` 的取值会影响注册方式和可用的推送标识：
-- `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 为腾讯云控制台 > 即时通信 IM > 推送服务 Push > 概览中的客户端密钥。
+- `appKey = Push Key`：注册 TIMPush 独立推送能力。Push Key 为腾讯云控制台 > 即时通信 IM > **推送服务 Push** > **概览**中的客户端密钥。
 
 - `appKey = nil`：复用 IM 登录态注册推送，必须在 IM `login` 成功后调用。
 
@@ -660,7 +660,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate, TIMPushListener {
 @end
 ```
 
-**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了「打开应用内指定页面」、监听器是否在 `didFinishLaunchingWithOptions` 中注册、发送消息时是否设置了 `ext`。
+**验证**：点击通知后 `onNotificationClicked` 被调用，且 `ext` 内容与发送时设置的一致。如果回调未触发，请检查：控制台点击动作是否选择了**打开应用内指定页面**、监听器是否在 `didFinishLaunchingWithOptions` 中注册、发送消息时是否设置了 `ext`。
 
 ## 收不到推送排障流程
 
@@ -685,7 +685,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate, TIMPushListener {
 ### 步骤3：确认控制台排查工具能查到 token
 
 在腾讯云控制台 **即时通信 IM > 推送服务 Push** 的排查工具中输入 `registrationID` 或 `userID`：
-- **能查到设备且 token 正常**：进入第四步。
+- **能查到设备且 token 正常**：进入步骤4。
 
 - **查不到设备 / 显示「没有上传成功 token」**：常见原因是 Chat 场景未在 Chat 登录成功后调用 `registerPush`，或调用顺序错误。请重新核对调用时机。
 

package/resource/knowledge/push/integration/react-native.md

@@ -260,7 +260,7 @@ pod install
 # 如果无法安装最新版本，执行以下命令更新本地的 CocoaPods 仓库列表
 pod repo update
 ```
-3. 在 App 中启用推送通知功能。打开 Xcode 项目，在 **Project > Target > Capabilities** 页面选择并添加 **Push Notifications**。
+3. 在 App 中启用推送通知功能。参考 iOS 配置消息触达统计。
 
 ### 步骤6：运行
 

package/resource/knowledge/roomkit/best-practice/common/room-ghost-member.md

@@ -0,0 +1,75 @@
+---
+title: TUIRoomKit 异常退出后成员仍显示在列表的原因与清理
+product: room
+frameworks: [react, vue, web, android, ios, flutter]
+scope: platform_common
+tags: [TUIRoomKit, 异常退出, 幽灵成员, 心跳检测, 离线检测, 踢出房间, kick_user_out, disconnect回调, 成员列表, 房间清理]
+version_range: ">=2.0.0"
+---
+
+# TUIRoomKit 异常退出后成员仍显示在列表的原因与清理
+
+## 1. 核心结论
+
+- 用户异常退出（杀进程、断网、关页未走 leave）后，成员仍显示在远端列表，是**视频会议 SDK 后台心跳离线检测**的预期行为。
+- 现行规则：后台在**心跳丢失约 5～6 分钟**后才将异常退出的用户移出房间，远端此时才收到离开通知并更新成员列表。
+- **不能默认把心跳设得很短**：网络抖动时容易被误踢出房，影响正常会议体验。
+- 若业务需要更快清理幽灵成员：方案一（提工单调心跳至约 2 分钟）或方案二（用 IM 断线回调 + `kick_user_out` 立即踢出）。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| 心跳离线检测 | 检测用户在线状态 | 后台检测用户是否心跳丢失 |
+| 心跳丢失 | 用户异常退出的信号 | 杀进程/断网/关页未走 leave 时心跳丢失 |
+| 幽灵成员 | 异常退出但仍显示的用户 | 约 5～6 分钟后被移出房间 |
+| `kick_user_out` | 踢出房间成员 | 业务后台主动调用立即清理 |
+| `disconnect` 回调 | 断线回调 | IM 服务端感知用户离线 |
+| 心跳时长调整 | 后台配置 | 提工单可调至约 2 分钟 |
+
+## 3. 机制/时序
+
+用户异常退出（杀进程、断网、关页未走 leave） -> 后台检测到心跳丢失 -> 约 5～6 分钟后将用户移出房间 -> 远端收到离开通知，更新成员列表。
+
+心跳时长默认不能太短，避免网络抖动导致误踢。若业务需要更快清理：
+
+- **方案一**：提工单调整后台心跳检测时长至约 2 分钟。
+- **方案二**：业务后台根据 IM `disconnect` 回调感知离线后，主动调用 `kick_user_out` 立即清理幽灵成员。
+
+## 4. 标准用法
+
+1. **方案一（改心跳时长）**：提工单，联系后台将心跳检测时长调整为约 2 分钟。
+2. **方案二（服务端主动清理）**：
+   - 业务后台监听 IM 服务端 `disconnect`（断线）回调。
+   - 收到离线信号后，调用 `kick_user_out` 踢出房间成员。
+
+## 5. 结果判定
+
+- 异常退出用户约 5～6 分钟后被移出房间，远端成员列表更新。
+- 提工单调整心跳至约 2 分钟后，清理更快。
+- 方案二通过 `disconnect` 回调 + `kick_user_out` 可立即清理幽灵成员。
+- 心跳过短会增大网络抖动时的误踢风险。
+
+## 6. 常见误区
+
+- 误区 1：认为异常退出用户应立即从成员列表消失（心跳检测约需 5～6 分钟）。
+- 误区 2：认为心跳时长可以随意设得很短（网络抖动会导致误踢，影响正常会议）。
+- 误区 3：忽略业务侧可以主动踢出（`disconnect` 回调 + `kick_user_out`）。
+
+## 7. 问题定义（检索辅助，极简）
+
+TUIRoomKit 用户异常退出后远端成员列表仍显示该用户的原因，以及如何更快清理幽灵成员。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- 用户异常退出还在成员列表里怎么办？
+- TUIRoomKit 幽灵成员怎么清理？
+- 断网用户多久被移出房间？
+- 心跳检测时间能调短吗？
+- 异常退出用户一直显示在列表？
+- 怎么踢出离线用户？
+
+## 9. 参考来源（可选）
+
+- 状态变更回调：`https://cloud.tencent.com/document/product/269/2570`
+- 踢出房间成员接口：`https://cloud.tencent.com/document/product/269/105393`

package/resource/knowledge/roomkit/best-practice/common/room-limit-and-multi.md

@@ -0,0 +1,88 @@
+---
+title: TUIRoomKit 并发房间上限与多房间支持说明
+product: room
+frameworks: [react, vue, web, android, ios, flutter]
+scope: platform_common
+tags: [TUIRoomKit, 并发房间, 房间上限, 同时进多个房间, 单房间人数, 峰值群组数, TUIRoomTypeConference, useRoomState, 多端登录, 互踢, 会议, 房间管理]
+version_range: ">=2.0.0"
+---
+
+# TUIRoomKit 并发房间上限与多房间支持说明
+
+## 1. 核心结论
+
+- 并发房间数有上限，与开通的 **多人音视频（TUIRoomKit）套餐版本 + IM 能力**相关。
+- **同一客户端 / 同一 SDK 实例不支持同时待在多个会议房间里**：会议类型房间单设备同时加入房间数上限为 1，超过会退出最早加入的房间。
+- **同一 userId 多设备进同一房间默认互踢**（后进踢先进）；多端同时进会需按套餐配置"多端登录"能力或为不同端分配不同 userId。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `TUIRoomTypeConference` | 会议类型房间 | 单设备同时加入房间数上限为 1 |
+| `useRoomState` | 房间状态（Atomicx 无 UI 路径） | 单例，同一用户同一时刻仅存在于一个房间内 |
+| 房间数限制 | 房间/群组类资源峰值 | 按自然月最高峰值结算，非无限开房 |
+| 单房间人数 | 一场会议最多多少人 | 套餐硬上限（20/50/200/300） |
+| 多端登录 | 同 userId 多端进会 | 仅更高版本套餐支持 |
+
+## 3. 机制/时序
+
+### 并发房间上限
+
+开通多人音视频（TUIRoomKit）套餐后，可同时开的会议数量受 **房间数限制 + 单房间人数** 约束：
+
+| 能力维度 | 体验版 | 基础互动版 | 进阶互动版 | 超大房间互动版 |
+|---|---|---|---|---|
+| **房间数限制**（计费口径） | 随 IM 版本 | 100,000 个/月 | 100,000 个/月 | 100,000 个/月 |
+| **单房间参会人数规模** | 20 | 50 | 200 | 300（扩容请提工单） |
+
+- 单房间人数是"一场会议最多多少人"的硬上限。
+- 房间数限制（峰值群组数）是套餐赠送的 IM 侧群组/房间类资源峰值（自然月最高峰值结算），不是"任意时刻可无限开房"。
+- 实际可同时开多少场，还受 IM 套餐、TRTC 资源与业务架构影响；超大房间有扩容通道。
+- 多端登录会议 / 同平台多端登录会议需要更高的套餐版本支持。
+
+### 同一用户多房间
+
+同一客户端 / 同一 SDK 实例调用 `joinRoom` 进入新房间时，若已存在会议类型房间，会退出最早加入的房间（单设备同时加入房间数上限为 1）。
+
+## 4. 标准用法
+
+业务需评估并发房间需求时，按以下步骤确认：
+
+1. 确认开通的 TUIRoomKit 套餐版本，查阅 [功能与计费说明](https://cloud.tencent.com/document/product/269/104946) 中的房间数限制与单房间人数。
+2. 评估单场会议人数是否超过套餐上限；超大房间需求可提工单扩容。
+3. 业务需同时承载多场会议时，评估房间数限制（峰值群组数）是否足够，并结合 IM 套餐与 TRTC 资源。
+4. 业务需同一用户多端同会时，确认套餐是否支持多端登录；否则为不同端分配不同 userId。
+
+## 5. 结果判定
+
+- 并发会议数量受套餐房间数限制与单房间人数约束。
+- 同一 SDK 实例同时加入多个会议房间时，超过 1 个会退出最早加入的房间。
+- 同一 userId 多设备进同一房间会互踢（后进踢先进）。
+- 多端同会需套餐支持多端登录，或为不同端分配不同 userId。
+
+## 6. 常见误区
+
+- 误区 1：认为房间数限制（峰值群组数）意味着可以"任意时刻无限开房"（按自然月最高峰值结算，非并发无限）。
+- 误区 2：认为同一 SDK 实例可以同时待多个会议房间（单设备上限 1）。
+- 误区 3：认为同一 userId 多设备可以同时进同一房间（默认互踢）。
+- 误区 4：忽略套餐版本差异（多端登录仅更高版本支持）。
+
+## 7. 问题定义（检索辅助，极简）
+
+TUIRoomKit 同时进行的会议室是否有上限，以及同一个用户是否可以同时进入不同房间。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- TUIRoomKit 并发房间数上限是多少？
+- 可以同时开多少场会议？
+- 同一个用户能同时进两个房间吗？
+- 单房间最多多少人？
+- TUIRoomKit 多端登录支持吗？
+- 同一 userId 多设备会互踢吗？
+- 会议室人数上限怎么扩容？
+
+## 9. 参考来源（可选）
+
+- 开通服务 / 功能与计费说明：`https://cloud.tencent.com/document/product/269/104946`
+- 单房间扩容提工单方式：`https://console.cloud.tencent.com/workorder/category`

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/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/server.js

@@ -29,14 +29,19 @@ 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.
+3. MUST call finalize_answer with the same prompt + queryID before replying (pass an audit digest in "answer", not necessarily full long-form text).
+4. Reply with: full user-visible 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.0",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/tools/common/finalize_answer.js

@@ -1,6 +1,14 @@
 import { z } from 'zod';
 import { FINALIZE_ANSWER_DEFINITION, FOLLOWUP_QUESTION } from '../definitions/finalize_answer_def.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
+const MAX_RECORDED_ANSWER_CHARS = 12000;
+function sanitizeAnswerForRecord(answer) {
+    if (answer.length <= MAX_RECORDED_ANSWER_CHARS)
+        return answer;
+    const head = answer.slice(0, 9000);
+    const tail = answer.slice(-2500);
+    return `${head}\n\n[...truncated_for_record:${answer.length - (9000 + 2500)} chars omitted...]\n\n${tail}`;
+}
 const registryFinalizeAnswerTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = FINALIZE_ANSWER_DEFINITION;
     mcpServer.registerTool(name, {
@@ -16,7 +24,7 @@ const registryFinalizeAnswerTool = (mcpServer) => {
         reportCLSClient({
             method: 'record_answer',
             queryID: params.queryID,
-            answer: params.answer,
+            answer: sanitizeAnswerForRecord(params.answer),
             prompt: params.prompt,
             product: params.product ? params.product.join(',') : '',
             framework: params.framework ?? '',

package/tools/common/search_trtc_knowledge.js

@@ -10,7 +10,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([

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: Final-answer digest for telemetry/audit (not necessarily full user-visible text). Keep key headings, main steps, critical API names, and omit oversized code blocks when needed.
 - 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: 'Final-answer digest for telemetry/audit. Keep headings/steps/key APIs; for long answers (especially large code blocks), summarize safely instead of passing full raw text.',
     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”等流程说明；直接输出结论与可执行内容。`;

package/tools/definitions/search_trtc_knowledge_def.js

@@ -24,7 +24,7 @@ types含api/component/feature/plugin/sdk/integration→MUST | API/组件/enterRo
 const PARAMETER_DESCRIPTIONS = {
     prompt: '用户原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
     product: '产品数组：chat|call|live|room|push|rtcengine|native_trtc_sdk。能推断 MUST 传；push优先(TIMPush/推送→push，禁止误归chat)。live 常见关键词：LiveKit/直播/语聊房/TUILiveKit/AtomicXCore/开播/观看。不能确定先问用户。',
-    frameworks: '平台数组：react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。支持传多个平台用于跨端检索；CallKit 中 TUICallKit 建议按 react/vue 区分检索，TUICallEngine/TUICallEvent 仍归 web；小程序用 miniprogram；harmonyos/react-native/unity/unreal/donut仅push适用。',
+    frameworks: '平台数组：react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。支持传多个平台用于跨端检索；CallKit 中 TUICallKit 建议按 react/vue 区分检索，TUICallEngine/TUICallEvent 仍归 web；小程序用 miniprogram；harmonyos/react-native/unity/unreal/donut仅push适用。若未传且问题依赖具体客户端平台，必须先调用 present_framework_choice 询问后重搜。',
     types: '默认不传；开放["faq"]。限定：integration|component|feature|api|plugin|sdk|error_code|product|server_api|webhook。component 与 feature 等价（同时匹配）；发现型/罗列型问题（"有哪些组件"）MUST 省略 types。控制台/计费/产品能力配置→product（非feature）。勿主动窄传。',
     scenario: 'live|voice，仅live产品。',
     queryID: '首次\'\'，后续同一咨询MUST透传（见server）。',

package/utils/report-cls-client.js

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

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.6.8',
+                version: '1.7.0',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,