@tencentcloud/sdk-mcp 1.7.1 → 1.7.3

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

@@ -39,38 +39,42 @@ TUIKit Compose 提供了一套完整的即时通信 UI 组件，向下依赖 Ato
 
 ## 集成并引入组件
 
+> **说明：**
+> Demo：[CNB 完整 Demo（国内）](https://cnb.cool/tencent/cloud/trtc/TUIKit_Android_Compose) 或者 [GitHub 完整 Demo](https://github.com/Tencent-RTC/TUIKit_Android_Compose) 开箱即用，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/                 # 示例应用（可选参考）
+```
 
 ### 集成组件
 

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

@@ -49,14 +49,15 @@ TUIKit 提供了一套完整的即时通信 UI 组件，向下依赖 AtomicXCore
 ## 集成并引入组件
 
 > **说明：**
-> **Demo**：[GitHub 完整 Demo](https://github.com/Tencent-RTC/TUIKit_Flutter) 开箱即用，5 分钟跑通聊天 + 音视频通话全功能。
+> **Demo**：[CNB 完整 Demo（国内）](https://cnb.cool/tencent/cloud/trtc/TUIKit_Flutter) 或者 [GitHub 完整 Demo](https://github.com/Tencent-RTC/TUIKit_Flutter) 开箱即用，5 分钟跑通聊天 + 音视频通话全功能。
 >
 
 ### 下载源码
 
-1. 从 GitHub 下载 [TUIKit Flutter](https://github.com/Tencent-RTC/TUIKit_Flutter) 源码：
+从 CNB 下载 [TUIKit Flutter](https://cnb.cool/tencent/cloud/trtc/TUIKit_Flutter) 源码或者 GitHub 下载 [TUIKit Flutter](https://github.com/Tencent-RTC/TUIKit_Flutter) 源码：
 ``` xml
-git clone https://github.com/Tencent-RTC/TUIKit_Flutter.git
+git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_Flutter
+// 或者 git clone https://github.com/Tencent-RTC/TUIKit_Flutter.git
 ```
 
 项目目录结构说明：
@@ -107,7 +108,7 @@ call/
 
 ### 配置项目
 
-#### iOS
+【iOS】
 
 在 iOS 端添加必要的权限配置。请打开 ios/Podfile ，在文件末尾新增如下权限代码：
 ``` objectivec
@@ -132,13 +133,13 @@ end
 
 ```
 
-#### Android
+【Android】
 - **清理 Gradle 全局配置：**如果您本地存在 `~/.gradle/init.gradle`，运行如下命令：
 
-   ``` bash
-   # 或者直接删除：rm -f ~/.gradle/init.gradle
-   mv ~/.gradle/init.gradle ~/.gradle/init.gradle.backup
-   ```
+``` bash
+# 或者直接删除：rm -f ~/.gradle/init.gradle
+mv ~/.gradle/init.gradle ~/.gradle/init.gradle.backup
+```
 
    > **说明：**
    >
@@ -147,101 +148,101 @@ end
 
 - **配置 JDK 17：**在项目例如 `chat/demo` 目录下的 `gradle.properties` 里增加一条 `org.gradle.java.home`，用来配置 JDK 17 路径，请替换成您实际的 JDK 17 的完整路径。参考如下：
 
-   ``` bash
-   # 请替换为您本地 JDK 17 的真实完整路径
-   org.gradle.java.home=xx/Java/JavaVirtualMachines/jdk-17.0.6.jdk/Contents/Home
-   ```
+``` bash
+# 请替换为您本地 JDK 17 的真实完整路径
+org.gradle.java.home=xx/Java/JavaVirtualMachines/jdk-17.0.6.jdk/Contents/Home
+```
 
-#### HarmonyOS
+【HarmonyOS】
 - 参考 [鸿蒙 Flutter 仓库文档](https://gitcode.com/CPF-Flutter/flutter_flutter/tree/oh-3.35.7-release) 的开发指南搭建环境。
 
 - 在您项目的 `pubspec.yaml` 文件中依赖重写（dependency_overrides）鸿蒙适配的第三方库，参考 `chat/demo/pubspec.yaml` 文件：
 
-   ``` javascript
-   dependency_overrides:
-     # ... 已有的 override 保持不变 ...
-     # HarmonyOS 专用(仅在使用 Flutter-OH 构建时启用,构建 Android/iOS 时请注释掉)
-
-     path_provider:
-       git:
-         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
-         path: "packages/path_provider/path_provider"
-         ref: "provider-v2.1.5-ohos-1.0.0"
-     shared_preferences:
-       git:
-         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
-         path: "packages/shared_preferences/shared_preferences"
-         ref: "shared_preferences-v2.5.4-ohos-1.0.0"
-     url_launcher:
-       git:
-         url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
-         path: "packages/url_launcher/url_launcher"
-         ref: "url_launcher_v6.3.2-ohos-1.0.0"
+``` javascript
+dependency_overrides:
+  # ... 已有的 override 保持不变 ...
+  # HarmonyOS 专用(仅在使用 Flutter-OH 构建时启用,构建 Android/iOS 时请注释掉)
+
+  path_provider:
+    git:
+      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+      path: "packages/path_provider/path_provider"
+      ref: "provider-v2.1.5-ohos-1.0.0"
+  shared_preferences:
+    git:
+      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+      path: "packages/shared_preferences/shared_preferences"
+      ref: "shared_preferences-v2.5.4-ohos-1.0.0"
+  url_launcher:
+    git:
+      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
+      path: "packages/url_launcher/url_launcher"
+      ref: "url_launcher_v6.3.2-ohos-1.0.0"
 
-   ```
+```
 - 声明 HarmonyOS 权限，参考 `chat/demo/ohos/entry/src/main/module.json5` 在 `requestPermissions` 数组中加入所需权限。
 
-   ``` java
-   {
-     "module": {
-       "requestPermissions": [
-         // ===== system_grant(声明即得) =====
-         { "name": "ohos.permission.INTERNET" },
-         { "name": "ohos.permission.GET_NETWORK_INFO" },
-         { "name": "ohos.permission.VIBRATE" },
-         // ===== user_grant(需运行时申请,必须提供 reason 和 usedScene) =====
-         {
-           "name": "ohos.permission.CAMERA",
-           "reason": "$string:permission_reason_camera",
-           "usedScene": {
-             "abilities": [ "EntryAbility" ],
-             "when": "inuse"
-           }
-         },
-         {
-           "name": "ohos.permission.MICROPHONE",
-           "reason": "$string:permission_reason_microphone",
-           "usedScene": {
-             "abilities": [ "EntryAbility" ],
-             "when": "inuse"
-           }
-         },
-         {
-           "name": "ohos.permission.WRITE_IMAGEVIDEO",
-           "reason": "$string:permission_reason_write_media",
-           "usedScene": {
-             "abilities": [ "EntryAbility" ],
-             "when": "inuse"
-           }
-         },
-         {
-           "name": "ohos.permission.READ_PASTEBOARD",
-           "reason": "$string:permission_reason_read_pasteboard",
-           "usedScene": {
-             "abilities": [ "EntryAbility" ],
-             "when": "inuse"
-           }
-         }
-       ]
-     }
-   }
+``` java
+{
+  "module": {
+    "requestPermissions": [
+      // ===== system_grant(声明即得) =====
+      { "name": "ohos.permission.INTERNET" },
+      { "name": "ohos.permission.GET_NETWORK_INFO" },
+      { "name": "ohos.permission.VIBRATE" },
+      // ===== user_grant(需运行时申请,必须提供 reason 和 usedScene) =====
+      {
+        "name": "ohos.permission.CAMERA",
+        "reason": "$string:permission_reason_camera",
+        "usedScene": {
+          "abilities": [ "EntryAbility" ],
+          "when": "inuse"
+        }
+      },
+      {
+        "name": "ohos.permission.MICROPHONE",
+        "reason": "$string:permission_reason_microphone",
+        "usedScene": {
+          "abilities": [ "EntryAbility" ],
+          "when": "inuse"
+        }
+      },
+      {
+        "name": "ohos.permission.WRITE_IMAGEVIDEO",
+        "reason": "$string:permission_reason_write_media",
+        "usedScene": {
+          "abilities": [ "EntryAbility" ],
+          "when": "inuse"
+        }
+      },
+      {
+        "name": "ohos.permission.READ_PASTEBOARD",
+        "reason": "$string:permission_reason_read_pasteboard",
+        "usedScene": {
+          "abilities": [ "EntryAbility" ],
+          "when": "inuse"
+        }
+      }
+    ]
+  }
+}
 
-   ```
+```
 - 在项目根目录 `ohos/build-profile.json5` 里启用 `useNormalizedOHMUrl`，否则会报“Bytecode HARs not supported when useNormalizedOHMUrl is not true”的错误。
 
-   ``` java
-   {
-     "app": {
-       "products": [{
-         "name": "default",
-         "buildOption": {
-           "arkOptions": { "useNormalizedOHMUrl": true }
-         }
-       }]
-     }
-   }
+``` java
+{
+  "app": {
+    "products": [{
+      "name": "default",
+      "buildOption": {
+        "arkOptions": { "useNormalizedOHMUrl": true }
+      }
+    }]
+  }
+}
 
-   ```
+```
 
 ## 接入步骤
 

package/resource/knowledge/callkit/core-sdk/ios/offline-push.md

@@ -1,4 +1,4 @@
-本文档将指导您如何基于 [TIMPush](https://cloud.tencent.com/document/product/269/133003) 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
+本文档将指导您如何基于 TIMPush 服务实现 VoIP 推送功能，适用于使用 AtomicXCore 进行无 UI 集成的场景。
 
 > **注意：**
 > - 使用 **VoIP** 推送功能首先需要 开通 TIMPush 服务。

package/resource/knowledge/chat/best-practice/common/web-sdk-log-level.md

@@ -0,0 +1,76 @@
+---
+title: Web Chat SDK 关闭/调整浏览器本地日志输出（setLogLevel）
+product: chat
+frameworks: [web, miniprogram]
+scope: platform_common
+tags: [setLogLevel, 日志, 日志级别, 关闭日志, 本地日志, 浏览器日志, 控制台日志, release, 生产环境, create, 初始化日志]
+version_range: ">=3.0.0"
+---
+
+# Web Chat SDK 关闭/调整浏览器本地日志输出（setLogLevel）
+
+## 1. 核心结论
+
+- 通过 `chat.setLogLevel(level)` 控制 SDK 本地日志输出级别，将 `level` 设为 `4` 即可关闭 SDK 的全部日志打印。
+- `setLogLevel` 需在 `create` 创建 `chat` 实例之后调用。
+- `setLogLevel` 只对调用成功**之后**的日志生效；调用之前已输出的初始化日志无法关闭，这是预期的设计行为。
+- 生产环境建议将级别设为 `1`（release），仅输出关键信息，而非直接设为 `4` 关闭全部日志，以保留必要的问题排查线索。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `chat.setLogLevel(level)` | 设置本地日志级别 | 需在 `create` 创建实例后调用 |
+| `level = 0` | 普通级别 | 日志量较多，接入调试阶段建议使用 |
+| `level = 1` | release 级别 | 仅输出关键信息，生产环境建议使用 |
+| `level = 2` | 告警级别 | 仅输出告警与错误级别日志 |
+| `level = 3` | 错误级别 | 仅输出错误级别日志 |
+| `level = 4` | 无日志级别 | 不打印任何日志（完全关闭） |
+
+## 3. 机制/时序
+
+`create` 创建 `chat` 实例 -> SDK 输出初始化日志（此阶段日志不受 `setLogLevel` 控制） -> 调用 `chat.setLogLevel(level)` -> 从调用成功之后开始，按设定级别过滤日志输出。
+
+## 4. 标准用法
+
+1. 调用 `create` 创建 `chat` 实例。
+2. 紧接着调用 `chat.setLogLevel(level)`，传入目标级别（关闭全部日志传 `4`，生产环境保留关键信息传 `1`）。
+3. 如需在不同环境使用不同级别，按环境变量在初始化后设置对应 `level`。
+
+``` javascript
+// 创建实例后立即设置日志级别
+const chat = TencentCloudChat.create({ SDKAppID });
+
+// 关闭 SDK 全部本地日志
+chat.setLogLevel(4);
+
+// 或：生产环境仅保留关键信息
+// chat.setLogLevel(1);
+```
+
+## 5. 结果判定
+
+- 设置 `level = 4` 后，`setLogLevel` 调用成功之后的浏览器控制台不再出现 SDK 日志。
+- 设置 `level = 1` 后，仅输出关键信息，告警/普通日志被过滤。
+- `create` 到 `setLogLevel` 之间的初始化日志仍会出现，属预期行为。
+
+## 6. 常见误区
+
+- 误区 1：认为 `setLogLevel(4)` 能连初始化日志一起清掉（调用前的初始化日志无法关闭）。
+- 误区 2：在 `create` 之前调用 `setLogLevel`（必须在创建实例之后调用才生效）。
+- 误区 3：生产环境直接设为 `4` 关闭全部日志，导致线上问题无日志可查（建议用 `1` 保留关键信息）。
+
+## 7. 问题定义（检索辅助，极简）
+
+Web/小程序 Chat SDK 如何关闭或调整浏览器本地（控制台）日志输出。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- web im sdk 怎么关闭浏览器本地日志？
+- chat.setLogLevel 各个级别是什么含义？
+- 生产环境 IM SDK 日志级别怎么设置？
+- 为什么设置了 setLogLevel 还有初始化日志？
+
+## 9. 参考来源（可选）
+
+- Web Chat SDK setLogLevel 接口说明：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/SDK.html#setLogLevel`

package/resource/knowledge/chat/best-practice/miniprogram/desktop-wechat-miniprogram-error.md

@@ -0,0 +1,79 @@
+---
+title: 桌面版微信小程序运行 IM SDK 报错（tencent_cloud_im_csig_flutter_for_web_25F_cy is uniefined / WebSocket is not a constructor）与升级修复
+product: chat
+frameworks: [miniprogram]
+scope: platform_specific
+tags: [桌面版微信, mac微信4.x, windows微信3.9.x, uniapp小程序, 微信原生小程序, WebSocket is not a constructor, tencent_cloud_im_csig, cannot read properties of undefined, tim-wx-sdk, "@tencentcloud/chat", "@tencentcloud/lite-chat", v2, v3, v4, 版本升级, 兼容性]
+version_range: ">=3.5.7"
+---
+
+# 桌面版微信小程序运行 IM SDK 报错（csig undefined / WebSocket is not a constructor）与升级修复
+
+## 1. 核心结论
+
+- 该问题的根因是桌面版微信（mac 4.x / windows 3.9.x）小程序底层 API 属性变更，导致 IM SDK 运行时环境识别异常。
+- 两种报错是同一根因的不同表现：uniapp 打包的微信小程序报 `cannot read properties of undefined (reading 'tencent_cloud_im_csig_flutter_for_web_25F_cy')`；微信原生小程序报 `TypeError: WebSocket is not a constructor`。
+- 该问题在 IM SDK v3（`3.5.7`）与 v4（`4.2.4`）中均已做兼容性处理，升级到对应大版本的最新版本即可修复。
+- v2/v3/v4 接口向下兼容、可平滑迁移，但 v3、v4 各自存在 breaking change，升级前需评估对业务无风险后再执行。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `tim-wx-sdk` | v2 版本包名 | 旧版本，推荐升级到 v4 最新版本 |
+| `@tencentcloud/chat` | v3 版本包名 | 已修复该问题（`>=3.5.7`）；v3 不再迭代新功能 |
+| `@tencentcloud/lite-chat` | v4 版本包名 | 已修复该问题（`>=4.2.4`）；推荐版本 |
+| `tencent_cloud_im_csig...` 属性缺失 | uniapp 小程序报错信号 | 桌面版微信底层 API 属性变更导致 undefined |
+| `WebSocket is not a constructor` | 原生小程序报错信号 | 桌面版微信运行环境识别异常，构造函数不可用 |
+
+## 3. 机制/时序
+
+桌面版微信升级（mac 4.x / windows 3.9.x） -> 小程序底层 API 属性发生变更 -> IM SDK 运行时环境识别异常 -> uniapp 打包小程序读取 `tencent_cloud_im_csig...` 属性时命中 undefined（报 `cannot read properties of undefined`）或原生小程序 `WebSocket` 构造异常（报 `WebSocket is not a constructor`） -> 升级到已做兼容处理的 v3（`>=3.5.7`）或 v4（`>=4.2.4`）后，SDK 正确识别桌面版微信运行环境，报错消失。
+
+## 4. 标准用法
+
+1. 确认当前使用的 IM SDK 版本与包名：v2（`tim-wx-sdk`）/ v3（`@tencentcloud/chat`）/ v4（`@tencentcloud/lite-chat`）。
+2. 按当前版本选择升级目标：
+   - 当前 v4（`@tencentcloud/lite-chat`）：升级到 v4 最新版本。
+   - 当前 v3（`@tencentcloud/chat`）：升级到 v3 最新版本（v3 不再迭代新功能），或升级到 v4 最新版本。
+   - 当前 v2（`tim-wx-sdk`）：升级到 v4 最新版本。
+3. 升级前阅读对应迁移指南，评估 breaking change 对业务的影响：
+   - v3 重大变更：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-07-breakingchanges.html`
+   - v2 升 v3 说明：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-05-integration.html`
+   - v4 重大变更：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-04-comparison-v4.html`
+   - v3 升 v4 说明：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-03-integration-v4.html`
+4. 完成升级并回归验证：在桌面版微信（mac 4.x / windows 3.9.x）上重新运行 uniapp 小程序与微信原生小程序，确认不再报错。
+
+## 5. 结果判定
+
+- 升级到 v3（`>=3.5.7`）或 v4（`>=4.2.4`）后，桌面版微信下 uniapp 小程序不再报 `cannot read properties of undefined (reading 'tencent_cloud_im_csig...')`。
+- 微信原生小程序不再报 `TypeError: WebSocket is not a constructor`。
+- IM SDK 在桌面版微信运行环境下可正常初始化并建立连接。
+
+## 6. 常见误区
+
+- 误区 1：认为是 uniapp 打包配置或业务代码 bug（实际是桌面版微信底层 API 属性变更导致的 SDK 环境识别异常）。
+- 误区 2：只在手机端微信验证通过就认为无问题（该问题仅在桌面版微信 mac 4.x / windows 3.9.x 出现）。
+- 误区 3：直接跨版本升级而不看 breaking change（v3、v4 各有 breaking change，需先评估业务影响）。
+- 误区 4：混淆包名（v3 是 `@tencentcloud/chat`，v4 是 `@tencentcloud/lite-chat`，v2 是 `tim-wx-sdk`）。
+
+## 7. 问题定义（检索辅助，极简）
+
+uniapp 打包微信小程序或微信原生小程序在桌面版微信（mac 4.x / windows 3.9.x）运行 IM SDK 时，报 csig 属性 undefined 或 `WebSocket is not a constructor`。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- 桌面版微信小程序 IM SDK 报 WebSocket is not a constructor 怎么办？
+- uniapp 小程序在 mac/windows 微信报 tencent_cloud_im_csig undefined？
+- Windows 3.9 / Mac 4.x 微信运行小程序 IM 初始化失败？
+- IM SDK 需要升级到哪个版本修复桌面版微信兼容问题？
+- PC 微信小程序的 AppService 逻辑层没有原生 WebSocket 构造函数怎么解决？
+- PC 端 tim-im app-service.js 报 WebSocket is not a constructor？
+- 小程序逻辑层没有原生 WebSocket 构造函数 / WebSocket 构造函数不可用？
+
+## 9. 参考来源（可选）
+
+- v3 重大变更：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-07-breakingchanges.html`
+- v2 升 v3 说明：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-05-integration.html`
+- v4 重大变更：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-04-comparison-v4.html`
+- v3 升 v4 说明：`https://web.sdk.qcloud.com/im/doc/v3/zh-cn/tutorial-03-integration-v4.html`

package/resource/knowledge/chat/best-practice/miniprogram/login-timeout-2801-diagnosis.md

@@ -3,7 +3,7 @@ title: 小程序集成 IM SDK 登录超时 2801 排查与修复
 product: chat
 frameworks: [miniprogram]
 scope: platform_specific
-tags: [login, timeout, 2801, websocket, 域名白名单, 调试模式, ipv6]
+tags: [login, timeout, 2801, 小程序域名白名单, 调试模式]
 version_range: ">=3.0.0"
 ---
 

package/resource/knowledge/chat/preset/android-view/integration.md

@@ -28,26 +28,40 @@ TUIKit 采用数据驱动的响应式架构与原生 Android View 体系（非 C
       > 我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
       >
 
-### 集成步骤
-1. 从 GitHub 仓库 [Tencent-RTC/TUIKit_Android](https://github.com/Tencent-RTC/TUIKit_Android) 下载源码，将仓库根目录下的 `chat`、`atomic_x`（以及可选的、用于音视频通话的 `call`）文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
-
-   ``` text
-   YourApplication/
-   ├── app/                    # 您的应用模块
-   ├── atomic_x/               # 基础 UI 组件库（必要）
-   ├── call/                   # 音视频通话组件（可选）
-   │   └── tuicallkit-kt/
-   ├── chat/                   # Chat 源码
-   │   ├── demo/               # 示例工程（可参考，非必需）
-   │   └── uikit/              # Chat UIKit 组件库（必要）
-   ├── settings.gradle.kts
-   └── build.gradle.kts
-   ```
-
-   > **说明：**TUIKit_Android 是包含多个产品的开源仓库，Chat 的 UI 源码位于 `chat/` 目录下（`chat/uikit` 为 UIKit 组件库，`chat/demo` 为示例工程），其依赖的基础组件 `atomic_x` 与音视频通话组件 `call/tuicallkit-kt` 位于仓库根目录。模块目录可放在工程任意位置，只需在 `settings.gradle.kts` 中设置正确的相对路径即可。
-   >
-
-2. 在 `settings.gradle.kts` 中引入对应模块（请按源码实际存放位置调整相对路径）：
+### 集成并引入组件
+
+> **说明：**
+> Demo：[CNB 完整 Demo（国内）](https://cnb.cool/tencent/cloud/trtc/TUIKit_Android) 或者 [GitHub 完整 Demo](https://github.com/Tencent-RTC/TUIKit_Android) 开箱即用，5 分钟跑通聊天 + 音视频通话全功能。
+>
+
+### 下载源码
+
+从 CNB 下载 [TUIKit Android](https://cnb.cool/tencent/cloud/trtc/TUIKit_Android) 源码或者 GitHub 下载 [TUIKit Android](https://github.com/Tencent-RTC/TUIKit_Android) 源码：
+``` java
+git clone https://cnb.cool/tencent/cloud/trtc/TUIKit_Android
+// 或者 git clone https://github.com/Tencent-RTC/TUIKit_Android.git
+```
+
+将仓库根目录下的 `chat`、`atomic_x`（以及可选的、用于音视频通话的 `call`）文件夹整体复制到您的工程根目录下。复制完成后的目录结构如下：
+``` text
+YourApplication/
+├── app/                    # 您的应用模块
+├── atomic_x/               # 基础 UI 组件库（必要）
+├── call/                   # 音视频通话组件（可选）
+│   └── tuicallkit-kt/
+├── chat/                   # Chat 源码
+│   ├── demo/               # 示例工程（可参考，非必需）
+│   └── uikit/              # Chat UIKit 组件库（必要）
+├── settings.gradle.kts
+└── build.gradle.kts
+```
+
+> **说明：**
+> TUIKit_Android 是包含多个产品的开源仓库，Chat 的 UI 源码位于 `chat/` 目录下（`chat/uikit` 为 UIKit 组件库，`chat/demo` 为示例工程），其依赖的基础组件 `atomic_x` 与音视频通话组件 `call/tuicallkit-kt` 位于仓库根目录。模块目录可放在工程任意位置，只需在 `settings.gradle.kts` 中设置正确的相对路径即可。
+>
+
+### 集成组件
+1. 在 `settings.gradle.kts` 中引入对应模块（请按源码实际存放位置调整相对路径）：
 
 【Kotlin DSL】
 ``` kotlin
@@ -83,7 +97,7 @@ include ':tuicallkit-kt'
 project(':tuicallkit-kt').projectDir = new File(settingsDir, 'call/tuicallkit-kt')
 ```
 
-3. 在 app 模块的 `build.gradle.kts` 中添加依赖：
+2. 在 app 模块的 `build.gradle.kts` 中添加依赖：
 
 【Kotlin DSL】
 ``` kotlin
@@ -187,8 +201,6 @@ import io.trtc.tuikit.chat.uikit.pages.ChatPageView
 class ChatActivity : AppCompatActivity() {
 
     override fun onCreate(savedInstanceState: Bundle?) {
-        // 必须设置 Material Components 主题，否则 ChatPageView 运行时会 Crash
-        setTheme(com.google.android.material.R.style.Theme_MaterialComponents_Light_NoActionBar)
         super.onCreate(savedInstanceState)
 
         // conversationID 格式：单聊 "c2c_<对方 UserID>"，群聊 "group_<群 GroupID>"
@@ -209,11 +221,8 @@ class ChatActivity : AppCompatActivity() {
 }
 ```
 
-> **注意：**
-> 承载聊天页的 Activity **必须**设置 Material Components 主题（如 `setTheme(com.google.android.material.R.style.Theme_MaterialComponents_Light_NoActionBar)`），否则 `ChatPageView` 内部使用的 Material 控件会因缺少对应主题属性，在运行时直接 Crash。
->
-
-> **说明：**示例工程（demo）中提供了基于 `ChatPageView` 封装好的聊天页 `ChatActivity`（带标题栏、未读角标、群事件处理等），可直接复用或参考其实现进行自定义：`ChatActivity.start(context, conversationID)`。
+> **说明：**
+> 示例工程（demo）中提供了基于 `ChatPageView` 封装好的聊天页 `ChatActivity`（带标题栏、未读角标、群事件处理等），可直接复用或参考其实现进行自定义：`ChatActivity.start(context, conversationID)`。
 >
 
 #### 步骤5：构建联系人界面
@@ -283,7 +292,6 @@ TUICallEngine.createInstance(context).init(
 
 若需同时集成智能客服 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 = "";

package/resource/knowledge/push/config/android/fcm.md

@@ -59,17 +59,13 @@
 
 ### 确认 FCM API V1 状态
 
-在 Firebase 控制台**项目设置 > Cloud Messaging** 中，确认 **Firebase Cloud Messaging API (V1)**已启用。新接入场景请使用 HTTP v1 API 和服务账号私钥进行 FCM 鉴权。
-
-> **注意：**
-> FCM 旧版 Server Key（HTTP/XMPP）已被弃用。TIMPush 的 Google FCM 通道应使用 HTTP v1 API 和服务账号私钥，请勿混用旧版 Server Key 凭据。
->
+在 Firebase 控制台**项目设置 > 云消息传递**中，确认 **Firebase Cloud Messaging API (V1)** 已启用。FCM 旧版 Server Key（HTTP/XMPP）已被弃用，TIMPush 的 Google FCM 通道应使用 HTTP v1 API 和服务账号私钥，请勿混用旧版 Server Key 凭据。
 
 ## 腾讯云控制台配置
 
 ### 添加 Google FCM 厂商证书
 
-登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 Google FCM 厂商证书，并按控制台要求上传或填写服务账号私钥相关配置。
+登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 Google FCM 厂商证书。
 
 ### 选择 FCM 消息类型