@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

package/resource/integration/callkit/preset/android/integration.md

@@ -253,6 +253,10 @@ TUICallKit.createInstance(this).calls(userIdList, mediaType, params, new Complet
 
 接听端完成登录后，拨打端发起通话，接收端就可以收到通话邀请，同时伴随铃声和振动。
 
+## AI 助手：知识咨询与代码集成
+
+您在接入视频通话 SDK 过程中，可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和集成代码生成。支持 Web/Android/iOS/Flutter/uni-app/HarmonyOS 等平台，答案基于官方文档。适用于查询 CallKit 组件和无 UI SDK 用法以及集成文档等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/647/129285)。
+
 ## 更多功能
 
 ### AI 转录与翻译

package/resource/integration/callkit/preset/flutter/integration.md

@@ -205,6 +205,10 @@ void _call() {
 
 接听端完成登录后，拨打端发起通话，接听端就可以收到通话邀请，同时伴随铃声和振动。
 
+## AI 助手：知识咨询与代码集成
+
+您在接入视频通话 SDK 过程中，可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和集成代码生成。支持 Web/Android/iOS/Flutter/uni-app/HarmonyOS 等平台，答案基于官方文档。适用于查询 CallKit 组件和无 UI SDK 用法以及集成文档等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/647/129285)。
+
 ## 更多功能
 
 ### AI 转录与翻译

package/resource/integration/callkit/preset/ios/integration.md

@@ -1,11 +1,5 @@
 本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
 
-## AI接入
-
-本接入文档已通过 **CodeBuddy** 的工程化验证，完全适配 **MCP (Model Context Protocol)** 协议。如需通过 AI 辅助接入，
-
-“您现在是一名资深的 iOS 开发专家。请基于本文档，协助我在现有的 iOS 项目中接入音视频通话功能。”
-
 ## 准备工作
 
 ### 环境要求
@@ -152,15 +146,16 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 import TUICallKit_Swift
 import AtomicXCore
 
-TUICallKit.createInstance().setSelfInfo(nickname: "jack", avatar: "https:/****/user_avatar.png", completion: { result in
+TUICallKit.createInstance().setSelfInfo(nickname: "jack", avatar: "https://****/user_avatar.png", completion: { result in
     switch result {
     case .success:
-        // 成功处理
+        print("setSelfInfo success")
     case .failure(let error):
-        // 失败处理:
+        print("setSelfInfo failed: \(error)")
+    @unknown default:
+        break
     }
 })
-
 ```
 
 |参数|类型|说明|
@@ -185,11 +180,13 @@ import AtomicXCore
 TUICallKit.createInstance().calls(userIdList: ["mike"], mediaType: .audio, params: nil, completion: { result in
     switch result {
     case .success:
-      // 成功处理
+        print("calls success")
     case .failure(let error):
-      // 失败处理
+        print("calls failed: \(error)")
+    @unknown default:
+        break
     }
-}
+})
 ```
 
 |参数|类型|说明|
@@ -203,6 +200,10 @@ TUICallKit.createInstance().calls(userIdList: ["mike"], mediaType: .audio, param
 
 接听端完成登录后，拨打端发起通话，接听端就可以收到通话邀请，同时伴随铃声和振动。
 
+## AI 助手：知识咨询与代码集成
+
+您在接入视频通话 SDK 过程中，可以通过 MCP 使用 AI 助手，快速完成知识咨询、报错排查和集成代码生成。支持 Web/Android/iOS/Flutter/uni-app/HarmonyOS 等平台，答案基于官方文档。适用于查询 CallKit 组件和无 UI SDK 用法以及集成文档等场景，[立即体验，提出您的第一个问题](https://cloud.tencent.com/document/product/647/129285)。
+
 ## 更多功能
 
 ### AI 转录与翻译

package/resource/integration/callkit/preset/vue/integration.md

@@ -173,9 +173,6 @@ const init = async () => {
 }
 </script>
 
-<style scoped>
-.demo-wrapper { max-width: 680px; margin: 40px auto; padding: 0 20px; font-family: system-ui, -apple-system, sans-serif; } .demo-card { background: #fff; border-radius: 16px; box-shadow: 0 4px 24px rgba(0,0,0,0.08); padding: 32px; margin-bottom: 24px; } .demo-title { margin: 0 0 28px; font-size: 22px; font-weight: 600; color: #1a1a2e; text-align: center; } .form-row { margin-bottom: 18px; } .form-row:last-of-type { margin-bottom: 0; } .form-label { display: block; font-size: 14px; font-weight: 600; color: #6b7280; letter-spacing: 0.5px; margin-bottom: 8px; } .form-controls { display: flex; gap: 10px; } .form-input { flex: 1; height: 42px; padding: 0 14px; border: 1.5px solid #e5e7eb; border-radius: 10px; font-size: 15px; color: #1a1a2e; background: #fafafa; outline: none; transition: border-color .2s, box-shadow .2s; } .form-input:focus { border-color: #6366f1; box-shadow: 0 0 0 3px rgba(99,102,241,0.15); background: #fff; } .form-input::placeholder { color: #c0c4cc; } .btn { height: 42px; padding: 0 20px; border: none; border-radius: 10px; font-size: 14px; font-weight: 600; cursor: pointer; white-space: nowrap; transition: transform .15s, box-shadow .2s, background .2s; } .btn:active { transform: scale(0.97); } .btn-primary { background: linear-gradient(135deg, #6366f1, #818cf8); color: #fff; box-shadow: 0 2px 8px rgba(99,102,241,0.3); } .btn-primary:hover { background: linear-gradient(135deg, #4f46e5, #6366f1); box-shadow: 0 4px 14px rgba(99,102,241,0.4); } .btn-success { background: linear-gradient(135deg, #10b981, #34d399); color: #fff; box-shadow: 0 2px 8px rgba(16,185,129,0.3); } .btn-success:hover { background: linear-gradient(135deg, #059669, #10b981); box-shadow: 0 4px 14px rgba(16,185,129,0.4); } .callkit-area { background: #fff; border-radius: 16px; box-shadow: 0 4px 24px rgba(0,0,0,0.08); overflow: hidden; }
-</style>
 ```
 
 【Vue2.7】

package/resource/integration/chat/preset/android/integration.md

@@ -39,38 +39,42 @@ TUIKit Compose 提供了一套完整的即时通信 UI 组件，向下依赖 Ato
 
 ## 集成并引入组件
 
+> **说明：**
+> Demo：IM 提供在 [CNB](https://cnb.cool/tencent/cloud/trtc/TUIKit_Android_Compose) 及 [GitHub](https://github.com/Tencent-RTC/TUIKit_Android_Compose) 上提供即时通信完整 Demo，您可以 5 分钟跑通聊天、音视频通话全功能，开箱即用。
+>
+
 ### 下载源码
-1. 从 GitHub 下载 [TUIKit Compose](https://github.com/Tencent-RTC/TUIKit_android_compose) 源码：
 
-   ``` bash
-   git clone https://github.com/Tencent-RTC/TUIKit_Android_Compose.git
-   ```
+从 CNB 下载 [TUIKit Compose](https://cnb.cool/tencent/cloud/trtc/TUIKit_Android_Compose) 源码或者 GitHub 下载 [TUIKit Compose](https://github.com/Tencent-RTC/TUIKit_Android_Compose) 源码：
+``` java
+git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_Android_Compose
+// 或者 git clone https://github.com/Tencent-RTC/TUIKit_Android_Compose.git
+```
 
-   项目目录结构说明：
-
-   ``` bash
-   atomic-x/
-   ├── src/main/
-   │   ├── java/io/trtc/tuikit/atomicx/     # UI 组件源码（必需集成）
-   │       ├── messagelist/      # 消息列表组件
-   │       ├── messageinput/     # 消息输入组件
-   │       ├── conversationlist/ # 会话列表组件
-   │       ├── contactlist/      # 联系人列表组件
-   │       ├── basecomponent/    # 基础组件
-   │       └── ...               # 其他 UI 组件
-   │   # 资源文件（必需集成）
-   │   ├── res/                    # 公共资源
-   │   ├── res-message-list/       # 消息列表组件资源
-   │   ├── res-message-input/      # 消息输入组件资源
-   │   ├── res-conversation-list/  # 会话列表组件资源
-   │   └── ...                     # 其他组件资源
-   chat/
-   ├── uikit/src/main/java/io/trtc/tuikit/chat/pages    # Page 组件（参考实现）
-   │   ├── ChatPage.kt
-   │   ├── ContactsPage.kt
-   │   └── ConversationsPage.kt
-   └── demo/                 # 示例应用（可选参考）
-   ```
+项目目录结构说明：
+``` bash
+atomic-x/
+├── src/main/
+│   ├── java/io/trtc/tuikit/atomicx/     # UI 组件源码（必需集成）
+│       ├── messagelist/      # 消息列表组件
+│       ├── messageinput/     # 消息输入组件
+│       ├── conversationlist/ # 会话列表组件
+│       ├── contactlist/      # 联系人列表组件
+│       ├── basecomponent/    # 基础组件
+│       └── ...               # 其他 UI 组件
+│   # 资源文件（必需集成）
+│   ├── res/                    # 公共资源
+│   ├── res-message-list/       # 消息列表组件资源
+│   ├── res-message-input/      # 消息输入组件资源
+│   ├── res-conversation-list/  # 会话列表组件资源
+│   └── ...                     # 其他组件资源
+chat/
+├── uikit/src/main/java/io/trtc/tuikit/chat/pages    # Page 组件（参考实现）
+│   ├── ChatPage.kt
+│   ├── ContactsPage.kt
+│   └── ConversationsPage.kt
+└── demo/                 # 示例应用（可选参考）
+```
 
 ### 集成组件
 
@@ -261,46 +265,7 @@ LoginStore.shared.login(context, SDKAPPID, userID, userSig,
 > 在正式的生产环境中，请在您的服务端生成 UserSig，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig 来进行鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
 >
 
-### 步骤3：构建会话列表界面
-
-您可以基于 TUIKit Compose 中的 ConversationList 组件，构建一个会话列表页面。ConversationList 内建的功能是：
-- 展示用户的会话列表，包含单聊和群聊会话
-
-- 支持用户操作单个会话：置顶、删除、清空会话消息等
-
-   将 ConversationList 封装为会话列表页，可参考 `chat/uikit/src/main/java/io/trtc/tuikit/chat/pages/ConversationsPage.kt` 文件里的实现，`ConversationsPage` 主要做了以下工作：
-
-1. 在 ConversationList 上方添加了 headerView。
-
-2. 传递点击会话列表 cell 事件。
-
-   核心示例代码如下所示：
-
-   ``` swift
-   @Composable
-   fun ConversationsPage(
-       onConversationClick: (ConversationInfo) -> Unit = {},
-       editContent: @Composable () -> Unit = {},
-   ) {
-       val colors = LocalTheme.current.colors
-       Column(
-           modifier = Modifier
-               .fillMaxSize()
-               .background(Colors.Transparent)
-       ) {
-
-           PageHeader(stringResource(R.string.chat_uikit_chat)) {
-               editContent()
-           }
-
-           Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
-               ConversationList(modifier = Modifier.navigationBarsPadding(), onConversationClick = onConversationClick)
-           }
-       }
-   }
-   ```
-
-### 步骤4：构建聊天界面
+### 步骤3：构建聊天界面
 
 您可以基于 TUIKit Compose 中的 MessageList、MessageInput 组件，构建一个聊天页面。
 
@@ -378,112 +343,10 @@ MessageList 内建的功能是：
    }
    ```
 
-### 步骤5：构建联系人界面
-
-您可以基于 TUIKit Compose 中的 ContactList 组件，构建一个联系人页面。ContactList 内建的功能是：
-- 查看好友申请列表。
-
-- 查看已加入的群列表。
-
-- 处理群组邀请和申请。
-
-- 管理黑名单列表。
-
-- 查看好友。
-
-   将 ContactList 封装为联系人列表页，可参考 `chat/uikit/src/main/java/io/trtc/tuikit/chat/pages/ContactsPage.kt` 文件里的实现，`ContactsPage` 主要做了以下工作：
-
-1. 在 ContactList 上方添加了 headerView。
-
-2. 传递点击联系人列表 cell 事件。
-
-   核心示例代码如下所示：
-
-   ``` swift
-   @Composable
-   fun ContactsPage(
-       onContactClick: (ContactInfo) -> Unit = {},
-       onGroupClick: (ContactInfo) -> Unit = {},
-       editContent: @Composable () -> Unit = {},
-   ) {
-
-       val colors = LocalTheme.current.colors
-       Column(
-           modifier = Modifier
-               .fillMaxSize()
-               .background(Colors.Transparent)
-       ) {
-           PageHeader(stringResource(R.string.chat_uikit_contacts)) {
-               editContent()
-           }
-
-           Box(
-               modifier = Modifier
-                   .fillMaxSize()
-                   .navigationBarsPadding(), contentAlignment = Alignment.Center
-           ) {
-               ContactList(onGroupClick = onGroupClick, onContactClick = onContactClick)
-           }
-       }
-   }
-   ```
-
-### 步骤6：完善界面间的跳转逻辑
-
-ConversationsPage、ChatPage、ContactsPage 中暴露了一些用户点击事件，您可以自定义事件来实现页面间的交互：
-| Page | 回调 | 建议跳转逻辑 |
-| --- | --- | --- |
-| <strong>ConversationsPage</strong> | <code>onConversationClick: (ConversationInfo) -> Unit</code> | 点击会话列表中的会话时触发，建议跳转到聊天页面（ChatPage）。 |
-| <strong>ContactsPage</strong> | <code>onContactClick: (ContactInfo) -> Unit</code> | 点击联系人 cell 时触发，建议跳转用户信息页（C2CChatSetting）。 |
-| <code>onGroupClick: (ContactInfo) -> Unit</code> | 点击群组 cell 时触发，建议跳转群聊页面（ChatPage）。 |  |
-| <strong>ChatPage</strong> | <code>onUserClick: (String) -> Unit</code> | 点击消息中的用户头像或昵称时触发，建议跳转用户信息页（C2CChatSetting）。 |
-| <code>onChatHeaderClick: (String) -> Unit</code> | 点击导航栏中的头像时触发，建议跳转用户信息页（C2CChatSetting）或群聊信息页（GroupChatSetting） |  |
-| <code>onBackClick: () -> Unit</code> | 点击返回按钮时触发，建议返回上一级页面。 |  |
-
-**chat/demo/app/src/main/java/io/trtc/tuikit/chat/MainActivity.kt** 和 **chat/demo/app/src/main/java/io/trtc/tuikit/chat/chat/ChatActivity.kt** 作为上述 Page 的粘合层，实现了各个 Page 的回调事件，核心示例代码如下：
-``` java
-// chat/demo/app/src/main/java/io/trtc/tuikit/chat/MainActivity.kt
-
-// 点击会话列表 cell 跳转
-ConversationsPage(onConversationClick = {
-    activity?.startActivity(
-        Intent(activity, ChatActivity::class.java).apply {
-            putExtra("conversationID", it.conversationID)
-        }
-    )
-})
-
-// 点击联系人页面跳转
-ContactsPage(onGroupClick = {
-    ChatSettingActivity.start(context, "", it.contactID, true)
-}, onContactClick = {
-    ChatSettingActivity.start(context, it.contactID, "", true)
-})
-```
-
-``` java
-// chat/demo/app/src/main/java/io/trtc/tuikit/chat/chat/ChatActivity.kt
-
-// 点击聊天页面跳转
-ChatPage(
-   conversationID = conversationID,
-   locateMessage = message,
-   onUserClick = {
-       handleChatSettingNavigation(it)
-   }, onChatHeaderClick = {
-       val userID = getUserID(conversationID)
-       val groupID = getGroupID(conversationID)
-       handleChatSettingNavigation(userID, groupID)
-   }, onBackClick = { finish() })
-```
-
-您可以参考上述回调说明及参考代码，实现 Page 之间交互逻辑。
-
-### 步骤7：接入智能客服 Desk 用户端（可选）
+### 步骤4：接入智能客服 Desk 用户端
 
 若需同时集成智能客服 Desk 用户端，请先 [开通智能客服 Desk 服务](https://cloud.tencent.com/document/product/269/96059)，并根据 [Android 接入智能客服用户端](https://cloud.tencent.com/document/product/269/110809) 文档完成 `com.tencentcloud.desk:aideskcustomer` 包引入和配置。即可在您的应用中引入客服会话能力。
 ``` java
-
 int SDKAppID = 0; // 开通了智能客服 Desk 的应用 ID
 String userID = "";
 String userSig = "";
@@ -509,7 +372,6 @@ TencentAiDeskCustomer.getInstance().initWithProfile(context, SDKAppID, userID, u
     @Override
     public void onError(int code, String desc) {}
 });
-
 ```
 
 ## 常见问题