@tencentcloud/sdk-mcp 1.7.4 → 1.7.6

package/resource/knowledge/chat/preset/ios-uikit/integration.md

@@ -2,47 +2,54 @@ TUIKit 是基于 IM SDK 的一款 UI 组件库，可通过 UI 组件快速实现
 
 ## 集成 TUIKit
 
-TUIKit 采用数据驱动的响应式架构与原生 iOS View 体系（非 Compose），以源码方式开放集成。它提供会话列表、聊天、联系人、搜索、群组等完整 UI 能力。
+TUIKit 采用数据驱动的响应式架构与原生 iOS UIKit 体系（非声明式 UI ），以源码方式开放集成。它提供会话列表、聊天、联系人、搜索、群组等完整 UI 能力。
 
 ### 前提条件
-- Xcode 15 及以上
+- **Xcode**：16.0 或以上版本（推荐 Xcode 16.x 系列）。
 
-- iOS 14.0 及以上
+- **iOS**：14.0 及以上真机（暂时不支持模拟器）。
+
+- **CocoaPods**：1.12.0 及以上版本（推荐 1.16.x）。如尚未安装，请参考 [CocoaPods Getting Started](https://guides.cocoapods.org/using/getting-started.html) 进行安装。
 
 - 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
 
-  - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
+   - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
 
-  - SDKSecretKey：应用的密钥。
+   - SDKSecretKey：应用的密钥。
 
 ## 集成并引入组件
 
 > **说明：**
-> Demo：[GitHub 完整 Demo](https://github.com/Tencent-RTC/TUIKit_iOS) 开箱即用，[5 分钟跑通聊天 + 音视频通话全功能](https://cloud.tencent.com/document/product/269/68228)。
+> Demo：IM 在 [CNB](https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS) 及 [GitHub](https://github.com/Tencent-RTC/TUIKit_iOS) 上提供即时通信完整 Demo，[5 分钟跑通聊天 + 音视频通话全功能](https://cloud.tencent.com/document/product/269/68228)。
 >
 
 ### 下载源码
 
-从 GitHub 下载 [TUIKit iOS](https://github.com/Tencent-RTC/TUIKit_iOS) 源码：
+从 [CNB](https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS) 或者 [GitHub](https://github.com/Tencent-RTC/TUIKit_iOS) 克隆 TUIKit iOS 源码
 ``` bash
+# 从 CNB 中克隆代码
+git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_iOS.git
+
+# 从 GitHub 中克隆代码
 git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
 ```
 
 将仓库根目录下的 `chat`、`call` 文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
 ``` bash
 YourApplication/
-├── app/                    # 您的应用模块
+├── source/                 # 您的工程代码
 ├── call/                   # 音视频通话组件
 │   └── TUICallKit_Swift.podspec
 │   └── TUICallKit_Swift/
 ├── chat/                   # Chat 源码
 │   ├── demo/               # 示例工程
-│   └── uikit/              # Chat UIKit 组件库
-├── Podfile
+│   └── uikit/              # TUIChatKit 组件库
+├── Podfile                 # 依赖配置文件
+├── YourApplication.xcworkspace     # 您的项目文件
 ```
 
 > **说明：**
-> TUIKit_iOS 是包含多个产品的开源仓库，Chat 的 UI 源码位于 `chat/` 目录下（`chat/uikit` 为 UIKit 组件库，`chat/demo` 为示例工程），其依赖的音视频通话组件 `call/TUICallkit_Swift` 位于仓库根目录。模块目录可放在工程任意位置，只需在 `Podfile` 中设置正确的相对路径即可。
+> TUIKit_iOS 是包含多个产品的开源仓库，Chat 的 UI 源码位于 `chat/` 目录下（`chat/uikit` 为 UIKit 组件库，`chat/demo` 为示例工程），其依赖的音视频通话组件 `call/TUICallKit_Swift` 位于仓库根目录。模块目录可放在工程任意位置，只需在 `Podfile` 中设置正确的相对路径即可。
 >
 
 ### 集成组件
@@ -52,8 +59,9 @@ YourApplication/
    # 请使用您的真实项目名称替换 your_project_name
    target 'your_project_name' do
 
-     # 补充如下内容 增加 ChatUIKit 和 TUICallKit_Swift 这两个依赖
-     pod 'ChatUIKit', :path => 'chat/uikit/ChatUIKit.podspec'
+     # 补充如下内容 增加 TUIChatKit 和 TUICallKit_Swift 这两个依赖
+     # 注意 path 的相对路径
+     pod 'TUIChatKit', :path => 'chat/uikit/TUIChatKit.podspec'
      pod 'TUICallKit_Swift', :path => 'call/TUICallKit_Swift.podspec'
    end
 
@@ -71,7 +79,7 @@ YourApplication/
 
 ## 接入步骤
 
-完成上述集成后，参考以下步骤，您仅需几行代码即可在项目中快速搭建会话列表、聊天、联系人等核心界面
+完成上述集成后，参考以下步骤，您仅需几行代码即可在项目中快速搭建会话列表、聊天、联系人等核心界面。
 
 ### 步骤1：配置用户鉴权
 
@@ -84,14 +92,14 @@ YourApplication/
 【Swift】
 ``` swift
 import AtomicXCore
-import ChatUIKit
+import TUIChatKit
 import UIKit
 
-let youSdkAppID: Int32 = 10_000_000_00 // 填写你的实际sdkAppID
+let yourSdkAppID: Int32 = 10_000_000_00 // 填写你的实际sdkAppID
 let testUserID = "testUserID"          // 你的测试用户ID
 let userSig = "xxxxxxx"                // 你的测试用户ID对应的 userSig （从IM 控制台获取，看上面的截图）
 
-LoginStore.shared.login(sdkAppID: youSdkAppID, userID: testUserID, userSig: userSig) { [weak self] result in
+LoginStore.shared.login(sdkAppID: yourSdkAppID, userID: testUserID, userSig: userSig) { [weak self] result in
     DispatchQueue.main.async {
         switch result {
         case .success:
@@ -104,8 +112,7 @@ LoginStore.shared.login(sdkAppID: youSdkAppID, userID: testUserID, userSig: user
 }
 ```
 
-> **注意**：
->
+> **警告：**
 > 在正式的生产环境中，建议在您的服务端生成 UserSig，在需要时由 App 向业务服务器发起请求获取动态 UserSig 进行鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
 >
 
@@ -116,7 +123,7 @@ LoginStore.shared.login(sdkAppID: youSdkAppID, userID: testUserID, userSig: user
 【Swift】
 ``` java
 import AtomicXCore
-import ChatUIKit
+import TUIChatKit
 import UIKit
 
 func showConversationList() {
@@ -137,7 +144,7 @@ func showConversationList() {
 【Swift】
 ``` swift
 import AtomicXCore
-import ChatUIKit
+import TUIChatKit
 import UIKit
 
 // 进入单聊
@@ -155,9 +162,9 @@ groupConversation.title = "测试群"
 showChat(groupConversation)
 
 func showChat(_ info: ConversationInfo) {
-    let chatPage = ChatPage(conversation: info) { [weak self] in
+    let chatPage = ChatPage(conversation: info, onBack: { [weak self] in
         self?.navigationController.popViewController(animated: true)
-    }
+    })
     navigationController.pushViewController(chatPage, animated: true)
 }
 ```
@@ -177,23 +184,23 @@ func showChat(_ info: ConversationInfo) {
 
 ### 步骤5：构建联系人界面
 
-联系人页由 ContactsPage 承载，展示当前用户的好友列表（按字母索引分组）与群列表入口 等。页面自带导航栏，右上角的 **+** 按钮内置了**添加好友**和**加入群聊**两个功能入口。
+联系人页由 ContactsPage 承载，展示当前用户的好友列表（按字母索引分组）与群列表入口 等。页面自带导航栏，右上角的 **+**按钮内置了**添加好友**和**加入群聊**两个功能入口。
 
 【Swift】
 ``` swift
 import AtomicXCore
-import ChatUIKit
+import TUIChatKit
 import UIKit
 
 func showContacts() {
     let contactsPage = ContactsPage(
-        onContactClick: { [weak self] item in
-            // 点击好友列表中的某个联系人回调，可在该回调中进入单聊
-            // self?.showChat(with: item.userID, title: item.title)
+        onContactClick: { [weak self] contact in
+            // 点击好友列表中的某个联系人回调（ContactInfo），可在该回调中进入单聊
+            // self?.showChat(with: contact.userID, title: contact.nickname ?? contact.userID)
         },
-        onGroupClick: { [weak self] item in
-            // 点击群列表中的某个群的回调，可在该回调中进入群聊
-            // self?.showGroupChat(with: item.userID, title: item.title)
+        onGroupClick: { [weak self] group in
+            // 点击群列表中的某个群的回调（GroupInfo），可在该回调中进入群聊
+            // self?.showGroupChat(with: group.groupID, title: group.groupName)
         }
     )
     navigationController.pushViewController(contactsPage, animated: true)
@@ -248,24 +255,20 @@ func startVideoCall() {
 
 4. **如何移除音视频通话功能？**
 
-   ChatPage 默认集成了音视频通话功能，如果你不需要音视频通话功能。可以在 步骤 3 创建聊天界面 中关闭音视频通话开关，代码如下所示：
+   ChatPage 默认集成了音视频通话功能，如果你不需要音视频通话功能。可以在 步骤 4 创建聊天界面 中关闭音视频通话开关，代码如下所示：
 
 【Swift】
 ``` swift
 func showChat(_ info: ConversationInfo) {
         // 在输入配置中关闭输入面板中的视频通话和音频通话功能
         let inputConfig = ChatMessageInputConfig(isShowVideoCall: false, isShowAudioCall: false)
-        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig) { [weak self] in
+        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig, onBack: { [weak self] in
             self?.navigationController.popViewController(animated: true)
-        }
+        })
         navigationController.pushViewController(chatPage, animated: true)
     }
 ```
 
-## AI 助手：知识咨询与代码集成
-
-在接入 IM SDK 过程中，您可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和 UIKit 集成代码生成。支持 Web/Android/iOS/Flutter/uni-app 等平台，答案基于官方文档。适用于查询 SDK API、UI 组件用法、服务端 API 与 IM 产品配置等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/269/126983)。
-
 ## 常见问题
 
 ### 音视频常见问题
@@ -303,9 +306,9 @@ ChatPage 默认集成了音视频通话功能，如果你不需要音视频通
 func showChat(_ info: ConversationInfo) {
         // 在输入配置中关闭输入面板中的视频通话和音频通话功能
         let inputConfig = ChatMessageInputConfig(isShowVideoCall: false, isShowAudioCall: false)
-        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig) { [weak self] in
+        let chatPage = ChatPage(conversation: info, messageInputConfig: inputConfig, onBack: { [weak self] in
             self?.navigationController.popViewController(animated: true)
-        }
+        })
         navigationController.pushViewController(chatPage, animated: true)
     }
 ```

package/resource/knowledge/chat/preset/react/h5/integration.md

@@ -1,10 +1,5 @@
 TUIKit 是基于腾讯云 Chat SDK 的一款 React 组件库，它提供了一些通用的 UI 组件，包含会话、聊天、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
 
-> **AI 助手使用说明：**
->
-> MCP 提供了 **IM 知识咨询**和**含 UI 集成**的 AI 解决方案，您可以通过 MCP 查询 IM 相关的知识和集成 UIKit，[点击这里，立即体验 AI 助手](https://cloud.tencent.com/document/product/269/126983)。
->
-
 ## 关键概念
 
 chat-uikit-react 主要分为 ConversationListH5、MessageListH5、ChatHeaderH5、MessageInputH5、ChatSettingH5、SearchH5、ContactH5 等核心 UI 组件，每个 UI 组件负责展示不同的内容。

package/resource/knowledge/chat/preset/vue/features/message-input.md

@@ -46,9 +46,9 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 
 - 详细说明：attachmentPickerMode 用于设置附件选择器的显示模式，默认值为 `'collapsed'`。
 
-  - **collapsed**：收起模式，点击后展开选项。
+   - **collapsed**：收起模式，点击后展开选项。
 
-  - **expanded**：展开模式，直接显示所有选项。
+   - **expanded**：展开模式，直接显示所有选项。
 
 ### actions
 - 类型：`MessageInputActions`
@@ -57,9 +57,9 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 
 - 注意：
 
-  - 每一个 BuiltInAction 都支持默认插槽从而改变 Trigger 的 UI 展示。更加灵活的输入工具自定义建议使用 `headerToolbar` 插槽。
+   - 每一个 BuiltInAction 都支持默认插槽从而改变 Trigger 的 UI 展示。更加灵活的输入工具自定义建议使用 `headerToolbar` 插槽。
 
-  - 显示音视频通话的按钮并不意味着可以发起通话，发起音视频通话的前提是集成了 CallKit，集成 CallKit 可以参考 集成 TUICallKit。
+   - 显示音视频通话的按钮并不意味着可以发起通话，发起音视频通话的前提是集成了 CallKit，集成 CallKit 可以参考 集成 TUICallKit。
 
       ``` typescript
       type MessageInputActions = Array<BuiltInAction | CustomAction>;

package/resource/knowledge/chat/preset/vue/h5/integration.md

@@ -1,10 +1,5 @@
 TUIKit 是基于腾讯云 Chat SDK 的一款 Vue 3 UI 组件库，它提供了一些通用的 UI 组件，包含会话、聊天、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
 
-> **说明：**
-> - **AI 助手使用说明**
-> MCP 提供了 **IM 知识咨询**和**含 UI 集成**的 AI 解决方案，您可以通过 MCP 查询 IM 相关的知识和集成 UIKit，[点击这里，立即体验 AI 助手](https://cloud.tencent.com/document/product/269/126983)。
->
-
 |接入需求|桌面端|移动端 H5|
 |---------|---------|---------|
 |全新 Web Vue3 项目|全功能接入 > 移动端 > Vue3|

package/resource/knowledge/livekit/core-sdk/features/android/audience-list.md

@@ -261,11 +261,11 @@ class LiveRoomManager(
 
 - **更新机制与频率控制:**
 
-  - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
+   - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
 
-  - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
+   - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
 
-  - **关键点: 在"弹幕风暴"或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，人数变更的消息可能会被频控策略丢弃**。
+   - **关键点: 在"弹幕风暴"或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，人数变更的消息可能会被频控策略丢弃**。
 
       **这对开发者意味着什么？**
 

package/resource/knowledge/livekit/core-sdk/features/android/live-list.md

@@ -514,10 +514,10 @@ class YourAudienceActivity : AppCompatActivity() {
 
 - **数量与大小限制**：
 
-  - 单个房间最多支持 **10** 个 key。
+   - 单个房间最多支持 **10** 个 key。
 
-  - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
+   - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
 
-  - 单个房间所有 value 的总大小不超过 **16KB**。
+   - 单个房间所有 value 的总大小不超过 **16KB**。
 
 - **冲突解决**： `metaData` 的更新机制是"后来者覆盖"。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。

package/resource/knowledge/livekit/core-sdk/features/flutter/audience-list.md

@@ -251,11 +251,11 @@ class LiveRoomManager {
 
 - **更新机制与频率控制：**
 
-  - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
+   - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
 
-  - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
+   - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
 
-  - **关键点：**在"弹幕风暴"或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
+   - **关键点：**在"弹幕风暴"或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
 
       **这对开发者意味着什么？**
 

package/resource/knowledge/livekit/core-sdk/features/flutter/live-list.md

@@ -718,10 +718,10 @@ class _ProductCardWidgetState extends State<ProductCardWidget> {
 
 - **数量与大小限制：**
 
-  - 单个房间最多支持 **10** 个 key。
+   - 单个房间最多支持 **10** 个 key。
 
-  - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
+   - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
 
-  - 单个房间所有 value 的总大小不超过 **16KB**。
+   - 单个房间所有 value 的总大小不超过 **16KB**。
 
 - **冲突解决**：`metaData` 的更新机制是"后来者覆盖"。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。

package/resource/knowledge/livekit/core-sdk/features/ios/audience-list.md

@@ -254,11 +254,11 @@ class LiveRoomManager {
 
 - **更新机制与频率控制：**
 
-  - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
+   - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
 
-  - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
+   - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
 
-  - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
+   - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
 
       **这对开发者意味着什么？**
 

package/resource/knowledge/livekit/core-sdk/features/ios/live-list.md

@@ -395,10 +395,10 @@ class YourAudienceViewController: UIViewController {
 
 - **数量与大小限制**：
 
-  - 单个房间最多支持 **10** 个 key。
+   - 单个房间最多支持 **10** 个 key。
 
-  - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
+   - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
 
-  - 单个房间所有 value 的总大小不超过 **16KB**。
+   - 单个房间所有 value 的总大小不超过 **16KB**。
 
 - **冲突解决**： `metaData` 的更新机制是“后来者覆盖”。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。

package/resource/knowledge/livekit/core-sdk/features/uni-app/audience-list.md

@@ -206,11 +206,11 @@ onMounted(() => {
 
 - **更新机制与频率控制：**
 
-  - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
+   - 无论是即时触发还是延迟触发，所有的人数变更通知都是以消息的形式在房间内广播的。
 
-  - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
+   - 房间内每秒的消息总量有上限，单房间消息频控是**每秒 40 条消息**。
 
-  - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
+   - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
 
       **这对开发者意味着什么？**
 

package/resource/knowledge/livekit/core-sdk/features/uni-app/live-list.md

@@ -286,10 +286,10 @@ watch( currentLive, (newVal, oldVal) => {
 
 - **数量与大小限制**：
 
-  - 单个房间最多支持 **10** 个 key。
+   - 单个房间最多支持 **10** 个 key。
 
-  - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
+   - 每个 key 的长度不超过 **50 字节**，每个 value 的长度不超过 **2KB**。
 
-  - 单个房间所有 value 的总大小不超过 **16KB**。
+   - 单个房间所有 value 的总大小不超过 **16KB**。
 
 - **冲突解决**： `metaData` 的更新机制是“后来者覆盖”。如果多个管理员在短时间内修改同一个 key，最后一次的修改会生效。建议在业务设计上避免多人同时修改同一个关键信息。

package/resource/knowledge/livekit/core-sdk/live/android/host-interaction.md

@@ -508,9 +508,9 @@
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 
-  - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+   - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
 
-  - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
+   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
 2. **PK 分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
 

package/resource/knowledge/livekit/core-sdk/live/flutter/host-interaction.md

@@ -809,9 +809,9 @@ class _FullCustomLiveWidgetState extends State<FullCustomLiveWidget> {
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 
-  - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+   - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
 
-  - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
+   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
 2. **PK 分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
 

package/resource/knowledge/livekit/core-sdk/live/flutter/integration.md

@@ -139,9 +139,9 @@ void main() async {
 
    这是最关键的一步。我们需要根据 `_isLiveStarted` 的状态选择不同的组件：
 
-  - **预览态：**使用 `VideoView` + `setLocalVideoView`（直接渲染本地采集数据）。
+   - **预览态：**使用 `VideoView` + `setLocalVideoView`（直接渲染本地采集数据）。
 
-  - **直播态：**使用 `LiveCoreWidget`（渲染直播间流数据）。
+   - **直播态：**使用 `LiveCoreWidget`（渲染直播间流数据）。
 
       ``` java
       // 3.1 封装预览视图组件

package/resource/knowledge/livekit/core-sdk/live/ios/host-interaction.md

@@ -441,9 +441,9 @@
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 
-  - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+   - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
 
-  - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
+   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
 2. **PK 分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。
 

package/resource/knowledge/livekit/core-sdk/live/uni-app/co-guest-interaction.md

@@ -324,9 +324,9 @@
 
    这个组件是我们的“UI 贴纸”，它只负责根据数据渲染 UI，不关心视频。
 
-  - 在您的 `components` 目录下，创建一个新文件 `ParticipantOverlay.vue`。
+   - 在您的 `components` 目录下，创建一个新文件 `ParticipantOverlay.vue`。
 
-  - 将以下代码复制到文件中。
+   - 将以下代码复制到文件中。
 
       ``` typescript
       <template>
@@ -383,9 +383,9 @@
 
    这是将视频层和 `UI` 层“叠”在一起的关键步骤，同时需要解决 `nvue` 的布局问题。
 
-  - 打开您的直播间页面文件
+   - 打开您的直播间页面文件
 
-  - 按照以下结构和样式进行修改。
+   - 按照以下结构和样式进行修改。
 
       ``` typescript
       <template>
@@ -449,9 +449,9 @@
 
 - 解决方案：
 
-  - 使用 `Flex` 布局：从页面的最外层根 `<view>` 开始，使用 `flex: 1` 样式，让容器逐层向下“撑满”可用空间。
+   - 使用 `Flex` 布局：从页面的最外层根 `<view>` 开始，使用 `flex: 1` 样式，让容器逐层向下“撑满”可用空间。
 
-  - 使用绝对定位：对于需要覆盖的层（例如 `LiveCoreView` 和自定义的 `ParticipantOverlay`），将其父容器设置为 `position: relative` 和 `flex: 1`，然后将这些覆盖层设置为 `position: absolute` 并配合 `top: 0; left: 0; right: 0; bottom: 0;`，让它们从四个方向贴紧父容器边缘，这是在 `nvue` 中实现“占满”效果最可靠的方法。
+   - 使用绝对定位：对于需要覆盖的层（例如 `LiveCoreView` 和自定义的 `ParticipantOverlay`），将其父容器设置为 `position: relative` 和 `flex: 1`，然后将这些覆盖层设置为 `position: absolute` 并配合 `top: 0; left: 0; right: 0; bottom: 0;`，让它们从四个方向贴紧父容器边缘，这是在 `nvue` 中实现“占满”效果最可靠的方法。
 
 ### 自定义的昵称/头像 UI 与视频画面位置错乱
 - 问题描述： 按照“完善 `UI` 细节”章节添加了 `ParticipantOverlay` 组件后，显示的昵称条或头像占位图没有精确地覆盖在对应的视频小窗上，存在偏移或尺寸不匹配。
@@ -460,9 +460,9 @@
 
 - 解决方案：
 
-  - 确保 `scale` 值正确计算：必须在父页面中正确计算 `scale` 值。通常的计算方式是：`scaleX = 屏幕实际宽度 / 设计稿宽度。`
+   - 确保 `scale` 值正确计算：必须在父页面中正确计算 `scale` 值。通常的计算方式是：`scaleX = 屏幕实际宽度 / 设计稿宽度。`
 
-  - 确保 `scale` 值正确传递：将计算好的 `scale` 对象传递给 `<ParticipantOverlay>` 组件。
+   - 确保 `scale` 值正确传递：将计算好的 `scale` 对象传递给 `<ParticipantOverlay>` 组件。
 
 ### 连麦功能无响应（申请/邀请/接受/拒绝均失败）
 - 问题描述： 调用 `applyForSeat`, `acceptApplication`, `inviteToSeat` 等 `CoGuestState` 提供的方法后，没有任何效果，也没有收到预期的回调。
@@ -471,9 +471,9 @@
 
 - 解决方案：
 
-  - 校验 `liveID`：确保在调用 `useCoGuestState(liveID)` 和所有相关方法（例如 `applyForSeat({ liveID, ... })`）时，使用的 `liveID` 是当前直播间真实且有效的 `ID`。
+   - 校验 `liveID`：确保在调用 `useCoGuestState(liveID)` 和所有相关方法（例如 `applyForSeat({ liveID, ... })`）时，使用的 `liveID` 是当前直播间真实且有效的 `ID`。
 
-  - 保持 `liveID` 一致：在整个页面的生命周期中，所有与 `CoGuestState` 相关的操作都必须使用同一个 `liveID`。
+   - 保持 `liveID` 一致：在整个页面的生命周期中，所有与 `CoGuestState` 相关的操作都必须使用同一个 `liveID`。
 
 ### 无法接收到连麦相关的事件通知
 - 问题描述： 观众端收不到主播的邀请（`onHostInvitationReceived`），或者主播端收不到观众的申请（`onGuestApplicationReceived`）。
@@ -482,9 +482,9 @@
 
 - 解决方案： 确保在页面初始化时（例如在 `onMounted` 钩子中），根据角色（主播/观众）调用相应的方法来注册监听器：
 
-  - 主播端：调用 `addCoGuestHostListener` 来监听 `onGuestApplicationReceived`、`onHostInvitationResponded` 等事件。
+   - 主播端：调用 `addCoGuestHostListener` 来监听 `onGuestApplicationReceived`、`onHostInvitationResponded` 等事件。
 
-  - 观众端：调用 `addCoGuestGuestListener` 来监听 `onGuestApplicationResponded`、`onHostInvitationReceived` 等事件。
+   - 观众端：调用 `addCoGuestGuestListener` 来监听 `onGuestApplicationResponded`、`onHostInvitationReceived` 等事件。
 
 ### 连麦成功后，对方看不到我的画面或听不到我的声音
 - 问题描述： 作为观众，上麦申请被主播同意后，虽然麦位列表中有我，但我的视频画面没有出现，或者麦克风图标显示为关闭状态。

package/resource/knowledge/livekit/core-sdk/live/uni-app/host-interaction.md

@@ -133,9 +133,9 @@
 
    这个组件是我们的“UI 贴纸”，它只负责根据数据渲染 UI，不关心视频。
 
-  - 在您的 `components` 目录下，创建一个新文件 `ParticipantOverlay.vue`。
+   - 在您的 `components` 目录下，创建一个新文件 `ParticipantOverlay.vue`。
 
-  - 将以下代码复制到文件中。
+   - 将以下代码复制到文件中。
 
       ``` typescript
       <template>
@@ -192,9 +192,9 @@
 
    这是将视频层和 `UI` 层“叠”在一起的关键步骤，同时需要解决 `nvue` 的布局问题。
 
-  - 打开您的直播间页面文件
+   - 打开您的直播间页面文件
 
-  - 按照以下结构和样式进行修改。
+   - 按照以下结构和样式进行修改。
 
       ``` typescript
       <template>

package/resource/knowledge/livekit/core-sdk/live/uni-app/integration.md

@@ -13,13 +13,13 @@
 
 2. **配置工程权限:** 请在应用的 manifest.json 文件的 app-plus > distribute 节点下，确保添加了以下必要的权限：
 
-  - Android 平台（`android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
+   - Android 平台（`android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
 
       ``` json
       "<uses-permission android:name=\"android.permission.RECORD_AUDIO\" />",
       "<uses-permission android:name=\"android.permission.CAMERA\"/>"
       ```
-  - iOS 平台（ios 节点）：在 `privacyDescription` 对象中，请确保包含以下描述：
+   - iOS 平台（ios 节点）：在 `privacyDescription` 对象中，请确保包含以下描述：
 
       ``` json
       "NSCameraUsageDescription" : "应用需要访问您的相机以进行直播",
@@ -282,26 +282,26 @@ onMounted(() => {
 
 - 解决方案：
 
-  - 使用 `cover-view`：uni-app 提供了 `cover-view` 和 `cover-image`，它们可以覆盖在原生组件之上，但样式支持有限。
+   - 使用 `cover-view`：uni-app 提供了 `cover-view` 和 `cover-image`，它们可以覆盖在原生组件之上，但样式支持有限。
 
-  - 切换到 `nvue`：如果页面交互复杂，需要大量元素覆盖在原生组件上，建议将整个页面用 `nvue` 来编写。`nvue` 的所有组件都是原生渲染，不存在层级问题。
+   - 切换到 `nvue`：如果页面交互复杂，需要大量元素覆盖在原生组件上，建议将整个页面用 `nvue` 来编写。`nvue` 的所有组件都是原生渲染，不存在层级问题。
 
 ### nvue 与 vue 的抉择问题
 - 问题：不知道什么时候该用 `nvue`，什么时候用 `vue`。
 
 - 选型建议：
 
-  - 默认用 `vue`：适合绝大多数业务和 UI 复杂的页面。
+   - 默认用 `vue`：适合绝大多数业务和 UI 复杂的页面。
 
-  - 当遇到长列表滑动卡顿、复杂动画掉帧、需要覆盖原生组件等性能或层级问题时，再考虑将该页面重构为 `nvue`。直播、地图这类页面是 nvue 的绝佳应用场景。
+   - 当遇到长列表滑动卡顿、复杂动画掉帧、需要覆盖原生组件等性能或层级问题时，再考虑将该页面重构为 `nvue`。直播、地图这类页面是 nvue 的绝佳应用场景。
 
 ### 原生能力集成问题
 - 问题：插件调用失败或无响应。
 
 - 解决方案：
 
-  - 必须打包自定义基座：在开发调试原生插件时，不能使用标准基座，必须通过 `HBuilderX` > 运行 > 运行到手机或模拟器 > 制作自定义基座，然后选择这个自定义基座来运行。
+   - 必须打包自定义基座：在开发调试原生插件时，不能使用标准基座，必须通过 `HBuilderX` > 运行 > 运行到手机或模拟器 > 制作自定义基座，然后选择这个自定义基座来运行。
 
-  - 检查权限：如本文档“准备工作”中所述，`manifest.json` 必须声明相机、麦克风等权限。
+   - 检查权限：如本文档“准备工作”中所述，`manifest.json` 必须声明相机、麦克风等权限。
 
-  - 查看原生日志：这是终极调试手段。通过 `Android Studio (Logcat)` 或 `Xcode (Console)` 查看设备的原生日志，通常能发现最直接的错误信息。
+   - 查看原生日志：这是终极调试手段。通过 `Android Studio (Logcat)` 或 `Xcode (Console)` 查看设备的原生日志，通常能发现最直接的错误信息。

package/resource/knowledge/livekit/core-sdk/voice/android/host-interaction.md

@@ -435,9 +435,9 @@ override fun onCoHostRequestReceived(inviter: SeatUserInfo, extensionInfo: Strin
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 
-  - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+   - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
 
-  - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
+   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
 2. **PK 分数计算**​：您的后台服务根据业务规则（例如上述示例），计算 PK 分数增量。
 

package/resource/knowledge/livekit/core-sdk/voice/ios/host-interaction.md

@@ -531,9 +531,9 @@ coHostStore.coHostEventPublisher
 #### 关键流程说明
 1. ​**获取 PK 状态​**：
 
-  - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
+   - 回调配置​：您可以通过配置 PK 状态回调，由 LiveKit 后台在 PK 开始、结束时，主动通知您的系统 PK 状态。
 
-  - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
+   - 主动查询​：您的后台服务可主动调用 PK 状态查询 接口，随时查询当前 PK 状态。
 
 2. **PK 分数计算**​：您的后台服务根据业务规则（如上述示例），计算 PK 分数增量。