@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

package/resource/knowledge/callkit/preset/uni-app/integration.md

@@ -0,0 +1,353 @@
+本文将介绍如何快速接入 TUICallKit 组件。您可以在 10 分钟内完成以下关键步骤，最终获得一个功能完备的音视频通话界面。
+
+> **说明：**
+> 自 2025 年 5 月 1 日起，由于 uni-app 官方限制，CallKit 原生语言插件已终止迭代，为保障业务持续稳定运行，现提供 CallKit UTS 插件方案。
+>
+> ​​CallKit UTS 插件核心优势：​​
+>
+> - 支持自定义 UI、深度界面定制。
+> - 支持 uni-app 项目。
+> - 提供插件版本锁定功能，避免因更新导致兼容性问题。
+
+## 准备工作
+
+### 环境要求
+
+> **说明：**
+> HBuilderX 4.64 和 4.65 版本对 UTS 插件打包存在已知兼容性问题，建议使用 4.66 或更高版本。
+>
+
+- [HBuilderX](https://www.dcloud.io/hbuilderx.html)：HBuilderX 是 **uni-app 官方**的集成开发环境（IDE），我们需要用它来导入、配置和运行我们的 Demo。
+
+- 2个移动设备： Android 5.0 以上的设备 / iOS 13.0 及以上设备。
+
+### 开通服务
+
+您需要开通腾讯云服务，以获取应用所需的唯一身份标识和密钥。 。
+
+## 代码集成
+
+### **步骤 1：下载 TUICallKit 源码**
+
+【Vue3】
+1. **克隆项目源码。**
+
+``` bash
+git clone https://github.com/Tencent-RTC/TUIKit_uni-app.git
+```
+2. **导入 atomic-x 组件。**
+
+  - 将源码中 `TUIKit_uni-app/App/uni_modules` 目录下的 `tuikit-atomic-x` 文件夹，完整拷贝到您项目根目录下的 `uni_modules` 文件夹中。
+
+  - 将源码中 `TUIKit_uni-app/App/components` 下的文件，完整地拷贝到您项目的 `components` 文件夹中。
+
+  - 将源码中 `TUIKit_uni-app/App/static` 目录下的文件，完整拷贝到您项目根目录下的同名文件夹下。
+
+  - 将源码中 `TUIKit_uni-app/App/debug` 文件夹拷贝到您项目的根目录下，这个目录提供可以方便您在客户端快速生成的 **UserSig** 的快捷函数。
+
+3. **合并 App.vue 配置。**
+
+**TUIKit_uni-app/App/App.vue** 文件中包含通话能力的初始化逻辑，因此您需要将 **TUIKit_uni-app/App/App.vue** 文件和您项目下的 **App.vue** 文件进行合并。
+
+   > **注意：**
+   >
+   > 不要直接覆盖 **App.vue** 文件！ 打开源码中的 **TUIKit_uni-app/App/App.vue**， 将其 `<script>` 部分的 ts 内容追加到您自己项目的 **App.vue** 的 `<script>`  标签内。
+   >
+
+【Vue2】
+1. **安装 TUIKit 插件。**
+
+进入[【官方】腾讯云聊天+通话+直播响应式 SDK](https://ext.dcloud.net.cn/plugin)。点击【下载插件并导入 HBuilderX】，将插件导入您的项目中。
+
+2.  **导入 atomic-x 组件。**
+
+  1. **转化兼容模式**：仅 Vue2 项目，Vue3 项目可忽略。
+
+      > **说明：**
+      >
+      > 该脚本用于将插件源码中 Vue3 的 Composition API 写法自动转换为 Vue2 的 Options API 写法，以确保在 Vue2 项目中正常运行。
+      >
+
+``` bash
+node ./uni_modules/tuikit-atomic-x/scripts/switch-to-compatible-mode.js
+```
+  2. **拷贝静态资源**：将 `⁠uni_modules/tuikit-atomic-x/quickstart/` ⁠下的 ⁠⁠`static/*⁠` 拷贝到项目 `static` 目录下。
+
+【Mac 端】
+``` java
+cp -r uni_modules/tuikit-atomic-x/quickstart/static/* static/
+```
+
+【Windows 端】
+``` bash
+xcopy /E /I /Y "uni_modules\tuikit-atomic-x\quickstart\static\*" "static\"
+```
+3.  **合并 App.vue 配置。**
+
+通话能力的初始化需要在应用唤醒的时候进行，因此需要您将以下代码和您项目中的 `App.vue` 中的逻辑进行合并处理。
+``` typescript
+import { initCallService } from '@/uni_modules/tuikit-atomic-x/server/callService';
+  export default {
+    onLaunch: function() {
+	    initCallService()
+	    console.log('App Launch')
+	  },
+	onShow: function() {
+		console.log('App Show')
+	},
+	onHide: function() {
+		console.log('App Hide')
+	}
+}
+```
+
+### 步骤 2：工程配置
+1. 配置 `manifest.json`。
+
+   打开您项目的 **manifest.json** 文件，在 **app-plus** > **distribute** 节点下，确保添加了以下必要的权限：
+
+  - Android 平台（`Android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
+
+      ``` json
+      "<uses-permission android:name=\"android.permission.CAMERA\"/>",
+      "<uses-permission android:name=\"android.permission.RECORD_AUDIO\" />",
+      "<uses-permission android:name=\"android.permission.INTERNET\"/>",
+      "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
+      "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>",
+      "<uses-permission android:name=\"android.permission.SYSTEM_ALERT_WINDOW\"/>",
+      "<uses-permission android:name=\"android.permission.VIBRATE\"/>"
+      ```
+  - iOS 平台（`iOS` 节点）：在 `privacyDescription` 对象中，请确保包含以下描述：
+
+      ``` json
+      "NSCameraUsageDescription" : "应用需要访问您的相机以进行通话",
+      "NSMicrophoneUsageDescription" : "应用需要访问您的麦克风以进行通话"
+      ```
+
+      在 `UIBackgroundModes` 数组中，添加 `audio` 以支持后台播放音频。
+
+      ``` json
+      "UIBackgroundModes" : [ "audio" ]
+      ```
+2. 制作自定义基座。
+
+   > **说明：**
+   >
+   > 由于 TUICallKit 包含原生代码（UTS 插件），您**必须**制作自定义调试基座才能在真机上运行。
+   >
+
+  1. 在 HBuilderX 顶部菜单选择**运行** > **运行到手机或模拟器** > **制作自定义调试基座**。
+
+  2. 制作成功后，再次选择**运行** > **运行到手机或模拟器**，在弹窗中勾选**使用自定义调试基座**后运行到您的手机。
+
+      具体操作指引参见 跑通 Demo 的步骤3。
+
+### 步骤 3：完成登录
+
+集成完成后，您需要完成登录。在您项目中需要使用到通话能力的地方进行登录，这是**使用 TUICallKit 的关键步骤**，因为只有在登录成功后才能正常使用 TUICallKit 的各项功能，故请您耐心检查相关参数是否配置正确：
+
+【Vue3】
+``` typescript
+import { onMounted } from 'vue';
+import { useLoginState } from "@/uni_modules/tuikit-atomic-x/state/LoginState";
+
+const { login } = useLoginState();
+onMounted(() => {
+  login({
+	sdkAppID: 1400000001,     // 请替换为开通服务控制台的 SDKAppID
+	userID: "denny",        // 请替换为您的 UserID
+	userSig: "xxxxxxxxxxx",  // 您可以在控制台中计算一个 UserSig 并填在这个位置
+  });
+});
+```
+
+【Vue2】
+``` typescript
+<script>
+import { useLoginState } from '@/uni_modules/tuikit-atomic-x/state/LoginState'
+
+export default {
+  data() {
+    var loginStore = useLoginState()
+    return {
+      loginStore: loginStore,
+      userId: '',
+      userSig: ''
+    }
+  },
+  methods: {
+    handleLogin: function () {
+      if (!this.userId || !this.userSig) return
+      var self = this
+      this.loginStore.login({
+        sdkAppID: 1400000001,  // 你的 SDKAppID
+        userID: this.userId,
+        userSig: this.userSig,
+      })
+    }
+  }
+}
+</script>
+
+```
+
+**登录接口参数说明**
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| SDKAppID | Number | 从 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 获取。 |
+| userID | String | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。 |
+| userSig | String | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 UserSig 或者通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275#formal">服务端生成 UserSig</a>。<br>更多信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275">如何计算及使用 UserSig</a>。 |
+
+### 步骤 4：注册通话页面
+
+现在，您需要在 `pages.json` 文件中告诉您的应用，这个新页面是存在的。
+
+打开您项目根目录下的 `pages.json` 文件，在 `"pages"` 数组中，添加以下对象来注册通话页。
+``` java
+{
+    "pages": [
+        // ... 您项目已有的其他页面配置
+        {
+            "path": "uni_modules/tuikit-atomic-x/pages/call",
+            "style": {
+                "navigationBarTitleText": "",
+                "disableSwipeBack": true, // 禁止右滑返回，防止直播中误操作退出
+                "app-plus": {
+                    "titleNView": false // 隐藏原生导航栏，使用页面内的自定义导航
+                }
+            }
+        }
+    ]
+    // ... 其他配置
+}
+
+```
+
+### 步骤5：跳转通话页面
+
+在您需要发起通话的地方（具体由您的业务决定，在其点击事件里执行），您需要先调用 calls 函数。在该函数成功执行的 success 回调中，再通过 uni.navigateTo 跳转到通话页面，以确保通话状态已正确建立。
+
+【Vue3】
+``` typescript
+import { useCallState } from '@/uni_modules/tuikit-atomic-x/state/CallState';
+import { useDeviceState } from "@/uni_modules/tuikit-atomic-x/state/DeviceState";
+const { calls } = useCallState()
+const { openLocalCamera, openLocalMicrophone } = useDeviceState();
+
+// 示例：在一个按钮的点击事件中
+function startCall() {
+    // 跳转到通话页
+    calls({
+      participantIds: ['xxx'],
+      mediaType: 1, // 1 是视频通话, 0 是语音通话
+      success: () => {
+        openLocalCamera({isFront: true})
+        openLocalMicrophone()
+        uni.navigateTo({
+          url: '/uni_modules/tuikit-atomic-x/pages/call?layoutTemplate=Float'
+        })
+      },
+      fail: (error) => {
+        console.log('calls fail:', error)
+      }
+    });
+}
+
+```
+
+【Vue2】
+``` typescript
+<script>
+import { useCallState, CallMediaType } from '@/uni_modules/tuikit-atomic-x/state/CallState'
+import { useDeviceState } from '@/uni_modules/tuikit-atomic-x/state/DeviceState'
+
+export default {
+  data() {
+    var callStore = useCallState()
+    var deviceStore = useDeviceState()
+    return {
+      callStore: callStore,
+      deviceStore: deviceStore,
+      // 要呼叫的用户 ID
+      participantId: 'xxx'
+    }
+  },
+  methods: {
+    startCall: function () {
+      var self = this
+
+      // 发起通话
+      this.callStore.calls({
+        participantIds: [this.participantId],  // 被呼叫者用户 ID 数组
+        mediaType: CallMediaType.Video,        // 1 是视频通话, 0 是语音通话
+        success: function () {
+          console.log('发起通话成功')
+
+          // 打开本地摄像头
+          self.deviceStore.openLocalCamera({
+            isFront: true,  // 使用前置摄像头
+            success: function () {
+              console.log('摄像头打开成功')
+            },
+            fail: function (errCode, errMsg) {
+              console.log('摄像头打开失败:', errMsg)
+            }
+          })
+
+          // 打开本地麦克风
+          self.deviceStore.openLocalMicrophone({
+            success: function () {
+              console.log('麦克风打开成功')
+            },
+            fail: function (errCode, errMsg) {
+              console.log('麦克风打开失败:', errMsg)
+            }
+          })
+
+          // 跳转到通话页面
+          uni.navigateTo({
+            url: '/uni_modules/tuikit-atomic-x/pages/call?layoutTemplate=Float'
+          })
+        },
+        fail: function (error) {
+          console.log('发起通话失败:', error)
+        }
+      })
+    }
+  }
+}
+</script>
+```
+
+> **说明：**
+> 在 `tuikit-atomic-x/server/callService` 文件中进行了默认处理被叫端收到呼叫的逻辑，若您需要自定义，可以修改该文件中的 `"onCallReceived"` 事件对应的处理逻辑。
+>
+
+## 常见问题
+
+### 调用接口没有反应？
+
+请检查您是否制作了自定义基座并且使用自定义基座运行项目。
+
+### 如何禁止系统侧滑返回上一个页面的行为？
+
+iOS 端可以通过设置页面上的 **disableSwipeBack** 属性进行禁止。详情参考 [uni-app 官方文档](https://uniapp.dcloud.net.cn/collocation/pages.html)。
+
+Android 端可以通过 **onBackPress** 拦截系统侧滑和物理返回，示例代码如下
+
+> **注意：**
+> 使用该方式进行系统侧滑和物理返回的拦截的前提是该页面使用的是 [自定义导航栏](https://uniapp.dcloud.net.cn/collocation/pages.html#customnav)。
+>
+
+``` typescript
+<script setup>
+  import { onBackPress } from '@dcloudio/uni-app'
+
+  // 拦截系统侧滑和物理返回键，防止通话中误退出
+  onBackPress((option) => {
+    if (option.from === 'backbutton') {
+      return true; // 返回 true 阻止默认回退行为
+    }
+  });
+</script>
+```

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"
 ---