@tencentcloud/sdk-mcp 1.3.0 → 1.3.2

package/resource/doc/chatuikit/uniapp-app/workflow.md

@@ -0,0 +1,576 @@
+# Uniapp Chat TUIKit 代码生成工作流指令（打包 App）
+
+## 📋 指令目的
+
+为 Agent 提供实现 Uniapp Chat TUIKit **核心功能的代码生成蓝图**，并指导 Agent **优先使用工具实时获取的最新文档内容**，专门针对 Uniapp 打包 App 的特殊场景。
+
+---
+
+## 🛑 Agent 执行硬性限制 (Guardrails)
+
+Agent 在生成代码时必须严格遵守以下指令：
+
+### 1. 文档驱动集成
+- 必须严格按照工具返回结果中的 `llm_code_generation_instructions_md` 步骤执行
+- 严格遵循 Uniapp 开发规范和目录结构
+
+### 2. 静默执行集成
+- 所有代码编写完成后，最后一步自动安装依赖
+- 提示用户使用 HBuilderX 运行项目（不能自动启动）
+
+### 3. 零外部配置
+- 禁止自动创建任何 `config.js` 或 `.env` 文件
+- SDKAppID、UserID 和 UserSig 等关键凭证必须直接注入到登录页面代码变量中
+
+### 4. 强制使用 get_usersig 工具获取测试凭证（🔴 硬性约束）
+- **必须强制调用** `get_usersig` 工具获取完整的测试凭证（SDKAppID、UserID、UserSig）
+- **禁止**让用户手动填写 SDKAppID 和 secretKey
+- **禁止**引导用户从控制台获取密钥
+- 登录页面代码中**必须注释掉**所有关于 secretKey 配置的示例代码
+- 登录页面应直接使用 `get_usersig` 工具返回的测试账号和凭证
+- UserID 应保持简洁（禁止拼接动态时间戳以防逻辑出错）
+
+**正确示例**：
+```javascript
+// Agent 自动注入 get_usersig 工具返回的测试凭证
+const SDKAppID = 0; // 从 get_usersig 获取
+const userID = 'user001'; // 从 get_usersig 获取
+const userSig = 'eJw1j...'; // 从 get_usersig 获取
+
+// ❌ 错误：不要引导用户填写 secretKey
+// const secretKey = '请从控制台获取您的 secretKey'; // 应注释此类代码
+```
+
+### 5. Uniapp 特殊配置
+- 必须正确配置 `manifest.json` 关闭 H5 `treeShaking`
+- Vue2 项目必须创建 `vue.config.js` 并配置 `unplugin-vue2-script-setup`
+- 必须正确配置 `pages.json` 路由和 TabBar
+
+### 6. 🔴 强制执行 TUIKit 源码拷贝（核心步骤，不可跳过）
+**⚠️ 这是 Uniapp TUIKit 集成的核心步骤，遗漏将导致项目无法运行！**
+
+#### 必须执行的拷贝操作：
+1. **拷贝 TUIKit 组件源码**：从 `node_modules/@tencentcloud/chat-uikit-uniapp/` 到项目根目录 `./TUIKit`
+2. **拷贝 static 静态资源**：从 `node_modules/@tencentcloud/chat-uikit-uniapp/static` 到项目根目录 `./static`
+
+#### Agent 强制执行规则：
+- ✅ **必须**在安装依赖后立即执行拷贝命令
+- ✅ **必须**根据操作系统自动选择正确的拷贝命令
+- ✅ **必须**验证拷贝是否成功（检查 `./TUIKit` 目录是否存在）
+- ❌ **禁止**跳过此步骤，即使用户未明确要求
+- ❌ **禁止**让用户手动执行拷贝操作
+
+#### 拷贝命令（Agent 自动执行）：
+
+**macOS/Linux 系统：**
+```bash
+mkdir -p ./TUIKit && rsync -av --exclude={'node_modules','excluded-list.txt'} ./node_modules/@tencentcloud/chat-uikit-uniapp/ ./TUIKit && rsync -av ./node_modules/@tencentcloud/chat-uikit-uniapp/static ./
+```
+
+**Windows 系统：**
+```bash
+xcopy .\node_modules\@tencentcloud\chat-uikit-uniapp .\TUIKit /i /e /exclude:.\node_modules\@tencentcloud\chat-uikit-uniapp\excluded-list.txt && xcopy node_modules\@tencentcloud\chat-uikit-uniapp\static .\static /i /e
+```
+
+#### 拷贝后验证：
+Agent 必须在执行拷贝后确认以下目录结构存在：
+```
+项目根目录/
+├── TUIKit/
+│   ├── components/
+│   │   ├── TUIConversation/
+│   │   ├── TUIChat/
+│   │   ├── TUIContact/
+│   │   ├── TUIGroup/
+│   │   └── TUISearch/
+│   ├── core/
+│   └── debug/
+├── static/
+│   └── images/
+└── ...
+```
+
+### 7. 集成模式支持
+- ✅ **支持 full-featured 模式**（全量功能集成）
+- ✅ **支持 chat-only 模式**（仅集成聊天窗口）
+- 根据用户需求选择合适的集成模式
+
+---
+
+## 📦 TUIKit 版本与依赖自动化
+
+Agent 生成代码后，必须自动执行以下依赖链：
+
+### 1. 核心依赖版本推荐
+
+```json
+{
+  "@tencentcloud/chat-uikit-uniapp": "latest",
+  "unplugin-vue2-script-setup": "latest"
+}
+```
+
+### 2. Vue2 项目额外依赖
+
+```json
+{
+  "@vue/composition-api": "latest"
+}
+```
+
+### 3. 🔴 依赖安装后强制执行源码拷贝（核心步骤）
+
+**⚠️ 关键约束**：依赖安装完成后，Agent **必须立即自动执行**源码拷贝命令，不得遗漏！
+
+#### 执行流程：
+1. 检测当前操作系统（macOS/Linux 或 Windows）
+2. 自动选择对应的拷贝命令
+3. 执行拷贝操作
+4. 验证拷贝结果（确认 `./TUIKit` 和 `./static` 目录已创建）
+5. 如果拷贝失败，必须报错并终止流程
+
+#### 拷贝命令：
+
+**macOS/Linux 系统（Agent 自动执行）：**
+```bash
+mkdir -p ./TUIKit && rsync -av --exclude={'node_modules','excluded-list.txt'} ./node_modules/@tencentcloud/chat-uikit-uniapp/ ./TUIKit && rsync -av ./node_modules/@tencentcloud/chat-uikit-uniapp/static ./
+```
+
+**Windows 系统（Agent 自动执行）：**
+```bash
+xcopy .\node_modules\@tencentcloud\chat-uikit-uniapp .\TUIKit /i /e /exclude:.\node_modules\@tencentcloud\chat-uikit-uniapp\excluded-list.txt && xcopy node_modules\@tencentcloud\chat-uikit-uniapp\static .\static /i /e
+```
+
+#### 为什么必须拷贝源码？
+- Uniapp 需要在项目中直接引用 TUIKit 源码文件，而非 node_modules 中的包
+- TUIKit 组件需要在编译时参与 Uniapp 的构建流程
+- Static 资源需要被 Uniapp 正确识别和打包
+
+---
+
+## 🛠️ 集成模式分发 (Goals)
+
+Uniapp 打包 App 支持两种集成模式，Agent 应根据用户需求选择对应的模式。
+
+### 模式 1: 全量功能集成 (full-featured)
+
+**目标**: 实现类似微信的完整 IM 应用
+
+**适用场景**: 
+- 构建独立的聊天应用
+- 需要完整的会话管理、通讯录、群组管理功能
+- 作为 App 的核心功能模块
+
+**核心组件**: 
+- `TUIConversation` (会话列表页)
+- `TUIChat` (聊天页)
+- `TUIContact` (通讯录页)
+- `TUIGroup` (群组管理页)
+- `TUISearch` (云端搜索页)
+- 登录页 (`pages/index/index.vue`)
+- 个人中心页 (`pages/profile/profile.vue`)
+
+**TabBar 配置**:
+- 消息 Tab → `TUIKit/components/TUIConversation/index`
+- 通讯录 Tab → `TUIKit/components/TUIContact/index`
+- 个人中心 Tab → `pages/profile/profile`
+
+**执行参考**: 
+- 参考工具返回结果中实时获取的 `integration.md` 指令
+- 严格按照 Uniapp 目录结构组织文件
+
+---
+
+### 模式 2: 仅聊天窗口集成 (chat-only)
+
+**目标**: 在现有应用中嵌入聊天窗口功能
+
+**适用场景**: 
+- 客服咨询场景（用户点击咨询按钮进入聊天页面）
+- 医疗在线问诊（患者与医生一对一沟通）
+- 订单详情页私聊（买家与卖家沟通）
+- 社交应用中的私信功能
+
+**核心组件**: 
+- `TUIChat` (聊天页) - 仅集成单个聊天组件
+- 登录页 (`pages/index/index.vue`) - 可选，根据应用已有的登录逻辑决定
+
+**路由配置**:
+- 仅需配置 TUIChat 聊天页路由
+- 不需要配置 TabBar
+- 通过页面跳转进入聊天页（携带 conversationID 参数）
+
+**执行参考**: 
+- 参考工具返回结果中实时获取的 `integration.md` 指令
+- TUIChat 组件作为普通页面集成，无需 TabBar 配置
+
+**关键差异**:
+- ❌ 不集成会话列表（TUIConversation）
+- ❌ 不集成通讯录（TUIContact）
+- ❌ 不配置 TabBar
+- ✅ 仅集成 TUIChat 聊天组件
+- ✅ 适合作为 App 某个功能页面的一部分
+
+
+---
+
+## 🔧 关键配置要点
+
+Agent 在生成代码时，必须确保以下配置正确：
+
+### 0. Vue 版本检测（🔴 核心前置步骤）
+
+**检测方法**：
+- 必须读取项目根目录的 `manifest.json` 文件
+- 检查 `vueVersion` 字段的值来判断 Vue 版本
+  - `"2"` 或 `"vue2"` → Vue2 项目
+  - `"3"` 或 `"vue3"` → Vue3 项目
+
+**manifest.json 配置示例**：
+```json
+{
+  "name": "my-uniapp",
+  "vueVersion": "2",
+  // ...其他配置
+}
+```
+
+**Agent 执行规则**：
+- ✅ **必须**在生成任何配置文件前先检测 Vue 版本
+- ✅ **必须**读取 `manifest.json` 的 `vueVersion` 字段
+- ✅ 根据检测结果决定是否生成 `vue.config.js`
+- ✅ 根据检测结果决定 `main.js` 中是否引入组合式 API
+- ❌ **禁止**假设或猜测 Vue 版本
+- ❌ **禁止**仅通过 `package.json` 的依赖判断版本
+
+**版本差异化配置**：
+
+| Vue 版本 | vue.config.js | main.js 组合式 API | 额外依赖 |
+|---------|--------------|-------------------|---------|
+| Vue2 | ✅ 必须生成 | ✅ 必须引入 | @vue/composition-api |
+| Vue3 | ❌ 不需要 | ❌ 内置支持 | 无 |
+
+### 1. manifest.json 必需配置
+- 关闭 H5 treeShaking：`h5.optimization.treeShaking.enable: false`
+
+### 2. vue.config.js（仅 Vue2 项目）
+- 配置 `unplugin-vue2-script-setup/webpack`
+- 关闭 `fork-ts-checker` 插件
+
+### 3. pages.json 必需配置
+- 包含所有 TUIKit 组件路由（TUIConversation、TUIChat、TUIContact、TUIGroup、TUISearch）
+- 包含登录页和个人中心页路由
+- 配置 TabBar 包含三个 Tab（消息、通讯录、个人中心）
+- 设置 TUIChat 的 `softinputMode: "adjustResize"`（仅 app-plus）
+
+### 4. App.vue 必需配置
+- 引入并初始化 `TUIChatKit.init()`
+- 设置全局样式确保页面高度和宽度 100%
+
+### 5. main.js（仅 Vue2 项目）
+- 引入 `@vue/composition-api`
+- 使用 `Vue.use(VueCompositionAPI)`
+
+### 6. 登录页面必需配置（🔴 核心约束）
+
+#### 测试凭证注入规则：
+- **必须**直接使用 `get_usersig` 工具返回的测试凭证（SDKAppID、UserID、UserSig）
+- **禁止**从 `../../TUIKit/debug` 引入 `genTestUserSig`
+- **禁止**在代码中保留 secretKey 配置变量
+- **必须注释或删除**文档示例中所有关于用户手动填写 secretKey 的代码
+
+#### 登录成功后必须执行的操作（根据集成模式区分）：
+
+**full-featured 模式**：
+1. 调用 `TUIConversationService.getConversationProfile()` 创建默认会话
+2. 跳转到会话列表页 `/TUIKit/components/TUIConversation/index`
+
+**chat-only 模式**：
+1. 调用 `TUIConversationService.switchConversation()` 切换到目标会话
+2. 跳转到聊天页 `/TUIKit/components/TUIChat/index`（无需携带 conversationID 参数）
+
+**Agent 代码生成规则**：
+
+1. 首先调用 `get_usersig` 工具获取测试凭证
+2. 将获取到的 SDKAppID、UserID、UserSig 直接注入到登录页代码中
+3. 注释掉示例代码中关于 secretKey 的部分，添加注释说明禁止在客户端配置密钥
+4. **根据集成模式添加对应的会话处理逻辑**
+
+---
+
+#### 创建/切换默认会话的引导（根据集成模式）
+
+**full-featured 模式 - 创建默认会话**：
+
+```javascript
+import { TUIConversationService } from '@tencentcloud/chat-uikit-engine-lite';
+
+// 在登录成功的回调中添加
+await TUIConversationService.getConversationProfile('C2Cadministrator');
+// 然后跳转到会话列表页
+```
+
+**说明**：
+- `getConversationProfile()` 用于获取并创建会话
+- 用户首次登录时会话列表会显示一个默认会话，而不是空白页面
+- 会话 ID 格式：`C2C{userID}` 表示单聊，`GROUP{groupID}` 表示群聊
+
+---
+
+**chat-only 模式 - 切换到目标会话**：
+
+```javascript
+import { TUIConversationService } from '@tencentcloud/chat-uikit-engine-lite';
+
+// 在登录成功的回调中添加
+await TUIConversationService.switchConversation('C2Cadministrator');
+// 然后跳转到 TUIChat/index 页面，无需携带 conversationID 参数
+```
+
+**说明**：
+- `switchConversation()` 用于切换到指定会话
+- 切换会话后，TUIChat 组件会自动加载该会话的聊天内容
+- 跳转到 `/TUIKit/components/TUIChat/index` 时**无需**在 URL 中携带 conversationID
+- 会话 ID 格式：`C2C{userID}` 表示单聊，`GROUP{groupID}` 表示群聊
+
+---
+
+**Agent 应将对应的逻辑集成到登录页面的登录成功处理流程中。**
+
+### 7. 个人中心页面必需配置（仅 full-featured 模式）
+- 显示用户头像、昵称、ID
+- 提供退出登录功能
+- 退出后跳转到登录页
+- **注意**：chat-only 模式不需要个人中心页面
+
+---
+
+## 🔄 完整自动化流程总结
+
+```mermaid
+graph TD
+    A[接收用户需求] --> B{检测是否为 Uniapp App}
+    B -->|是| C{检查集成模式}
+    B -->|否| Z[引导使用其他框架]
+    C -->|full-featured| E1[调用 get_web_chat_uikit_integration 获取全量文档]
+    C -->|chat-only| E2[调用 get_web_chat_uikit_integration 获取 chat-only 文档]
+    E1 --> F[检测项目已存在]
+    E2 --> F
+    F --> F1[🔴 读取 manifest.json 检测 Vue 版本]
+    F1 --> G[创建 package.json 并安装依赖]
+    G --> H{🔴 检测操作系统}
+    H -->|macOS| I[🔴 强制执行 macOS 拷贝命令]
+    H -->|Windows| J[🔴 强制执行 Windows 拷贝命令]
+    I --> I1[验证 TUIKit 和 static 目录已创建]
+    J --> J1[验证 TUIKit 和 static 目录已创建]
+    I1 --> K[根据文档生成配置文件]
+    J1 --> K
+    K --> L{根据检测到的 Vue 版本}
+    L -->|Vue2| M[生成 vue.config.js 和 main.js]
+    L -->|Vue3| N[仅生成 main.js]
+    M --> O{根据集成模式生成对应页面}
+    N --> O
+    O -->|full-featured| O1[生成全量页面+TabBar配置]
+    O -->|chat-only| O2[仅生成 TUIChat 页面+登录页]
+    O1 --> P[🔴 强制调用 get_usersig 获取完整测试凭证]
+    O2 --> P
+    P --> Q[注入 SDKAppID/UserID/UserSig 到登录页 + 注释 secretKey 代码]
+    Q --> Q1{检测集成模式}
+    Q1 -->|full-featured| Q2[添加 getConversationProfile 创建默认会话]
+    Q1 -->|chat-only| Q3[添加 switchConversation 切换会话]
+    Q2 --> R[record_result 记录集成结果]
+    Q3 --> R
+    R --> S[提示用户使用 HBuilderX 运行]
+```
+
+---
+
+## ✍️ Agent 代码生成示例指令 (Prompts)
+
+⚠️ **重要前提**: 用户需要提前通过 HBuilderX 手动创建 Uniapp 项目（选择 Vue2 或 Vue3 模板）。
+
+当用户提供已创建的项目后，Agent 应根据用户需求选择集成模式：
+
+**全量功能集成 (full-featured)**：
+> "在现有的 Uniapp 项目中集成 Chat TUIKit，使用 `full-featured` 模式。请根据工具返回的实时文档内容生成所有必需的配置文件和页面，自动配置 TabBar，注入由 `get_usersig` 工具获取的测试凭证。如果是 Vue2 项目需要额外配置 vue.config.js 和引入组合式 API。"
+
+**仅聊天窗口集成 (chat-only)**：
+> "在现有的 Uniapp 项目中集成 Chat TUIKit，使用 `chat-only` 模式。请根据工具返回的实时文档内容仅集成 TUIChat 聊天组件，不配置 TabBar，注入由 `get_usersig` 工具获取的测试凭证。如果是 Vue2 项目需要额外配置 vue.config.js 和引入组合式 API。"
+
+---
+
+## 📝 关键要点总结
+
+| 类别 | 要求 |
+|------|------|
+| **文档优先** | 严格遵循工具返回的 integration.md 指令 |
+| **平台限制** | 仅支持 Uniapp 打包 App，不支持微信小程序 |
+| **功能模式** | 支持 full-featured（全量）和 chat-only（仅聊天） |
+| **源码拷贝** | 🔴 强制执行拷贝命令，创建 ./TUIKit 目录（核心步骤） |
+| **静态资源** | 🔴 强制拷贝 static 资源到项目根目录（核心步骤） |
+| **拷贝验证** | 必须验证 TUIKit 和 static 目录已成功创建 |
+| **路由配置** | 必须配置 pages.json 包含所有 TUIKit 页面 |
+| **TabBar 配置** | 必须配置消息、通讯录、个人中心三个 Tab |
+| **特殊配置** | manifest.json 关闭 treeShaking |
+| **Vue2 配置** | vue.config.js + 引入组合式 API |
+| **凭证获取** | 🔴 强制使用 get_usersig 工具获取测试凭证 |
+| **凭证注入** | 注入 SDKAppID/UserID/UserSig，注释 secretKey 代码 |
+| **运行方式** | 使用 HBuilderX 运行，不能自动启动 |
+
+---
+
+## ⚠️ 重要安全提示
+
+**Debug 文件的作用和安全警告：**
+
+- `TUIKit/debug/GenerateTestUserSig.js` 用于本地生成 UserSig，**仅适合开发调试**
+- ⚠️ **绝对不能用于生产环境**
+- 生产环境必须在后端生成 UserSig，参考：[服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)
+- 密钥泄露会导致腾讯云流量被盗用
+
+---
+
+## 📞 扩展功能：音视频通话 (TUICallKit)
+
+### 运行平台选择
+
+| 运行平台 | 集成方案 | 文档链接 |
+|---------|---------|---------|
+| 移动端应用 (App) | uni-app (客户端) TUICallKit | [音视频通话（客户端）](https://cloud.tencent.com/document/product/269/83857) |
+
+### 集成注意事项
+
+- TUIKit 默认不包含 TUICallKit
+- 需要单独按照文档集成音视频通话功能
+
+---
+
+## 🔗 相关工具参考
+
+### 🔴 必须使用的工具
+
+#### `get_usersig` - 获取完整测试凭证（强制调用）
+**用途**：生成完整的测试账号和鉴权凭证，包括：
+- `SDKAppID`: 应用标识
+- `userID`: 测试用户 ID
+- `userSig`: 用户签名（有效期 7 天）
+
+**调用时机**：在生成登录页面代码之前必须调用
+
+**使用约束**：
+- ✅ 必须使用工具返回的完整凭证
+- ❌ 禁止让用户手动填写 SDKAppID 和 secretKey
+- ❌ 禁止在登录页代码中保留 secretKey 配置示例
+
+#### `record_result` - 记录集成结果
+**用途**：记录集成过程和结果，用于统计和分析
+
+---
+
+## 🎯 Agent 执行检查清单
+
+在完成代码生成后，Agent 必须确认以下所有项目：
+
+- [ ] 已确认用户通过 HBuilderX 创建了 Uniapp 项目
+- [ ] 🔴 已读取 `manifest.json` 的 `vueVersion` 字段检测 Vue 版本
+- [ ] 已创建 package.json 并安装 @tencentcloud/chat-uikit-uniapp
+- [ ] 🔴 已强制执行拷贝命令将 TUIKit 源码复制到 ./TUIKit 目录（核心步骤）
+- [ ] 🔴 已强制拷贝 static 资源到项目根目录（核心步骤）
+- [ ] 🔴 已验证 ./TUIKit 和 ./static 目录成功创建并包含必要文件
+- [ ] 已配置 manifest.json 关闭 treeShaking
+- [ ] 如果是 Vue2，已创建 vue.config.js
+- [ ] 如果是 Vue2，已在 main.js 引入组合式 API
+- [ ] 已配置 pages.json 包含所有必需路由
+- [ ] 已配置 TabBar 包含三个 Tab
+- [ ] 已配置 App.vue 初始化 TUIChatKit
+- [ ] 🔴 已强制调用 get_usersig 工具获取完整测试凭证
+- [ ] 已将 SDKAppID、UserID、UserSig 注入到登录页面代码
+- [ ] 已注释或删除登录页面中关于 secretKey 配置的示例代码
+- [ ] 已根据集成模式添加对应的会话处理逻辑：
+  - full-featured：添加 `getConversationProfile` 创建默认会话
+  - chat-only：添加 `switchConversation` 切换到目标会话
+- [ ] 已根据文档创建个人中心页面
+- [ ] 已调用 record_result 记录结果
+- [ ] 已提示用户使用 HBuilderX 运行项目
+
+---
+
+## 📚 参考信息
+
+- [chat-uikit-uniapp GitHub 源码](https://github.com/TencentCloud/chat-uikit-uniapp)
+- [ChatEngine API 手册](https://web.sdk.qcloud.com/im/doc/chat-engine-lite/index.html)
+- [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)
+- [uni-app 官方文档](https://uniapp.dcloud.net.cn/)
+
+---
+
+## 💡 常见问题处理
+
+### 1. 源码拷贝失败排查
+
+**问题现象**：项目运行时提示找不到 TUIKit 组件
+
+**原因**：Agent 未执行源码拷贝命令或拷贝失败
+
+**解决方案**：
+1. 确认 `./TUIKit` 目录是否存在
+2. 确认 `./static/images` 目录是否存在
+3. 如果目录不存在，手动执行拷贝命令（参见上文命令）
+4. 如果使用 Windows 且 xcopy 失败，检查路径分隔符是否正确
+
+### 2. 首次登录会话处理
+
+#### full-featured 模式 - 会话列表为空
+
+**问题现象**：用户首次登录后会话列表是空的，体验不佳
+
+**原因**：未创建任何会话
+
+**解决方案**：
+在登录成功回调中添加创建默认会话的逻辑：
+```javascript
+import { TUIConversationService } from '@tencentcloud/chat-uikit-engine-lite';
+
+// 登录成功后
+await TUIConversationService.getConversationProfile('C2Cadministrator');
+```
+
+**说明**：
+- `getConversationProfile` 用于获取并创建会话
+- `C2Cadministrator` 表示与系统管理员 `administrator` 的单聊会话
+- 用户首次登录就能看到一个默认会话，可以立即开始聊天
+
+---
+
+#### chat-only 模式 - 进入聊天页无内容
+
+**问题现象**：登录后跳转到聊天页，但没有加载任何会话内容
+
+**原因**：未切换到目标会话
+
+**解决方案**：
+在登录成功回调中添加切换会话的逻辑：
+```javascript
+import { TUIConversationService } from '@tencentcloud/chat-uikit-engine-lite';
+
+// 登录成功后
+await TUIConversationService.switchConversation('C2Cadministrator');
+// 然后跳转到 TUIChat/index，无需携带 conversationID 参数
+```
+
+**说明**：
+- `switchConversation` 用于切换到指定会话
+- 切换会话后，TUIChat 组件会自动加载该会话的聊天内容
+- 跳转到聊天页时**无需**在 URL 中携带 conversationID 参数
+- 会话 ID 格式：`C2C{userID}` （单聊）或 `GROUP{groupID}`（群聊）
+
+### 3. Chat 实例类型
+即使打包为 App，Chat 实例仍是 **web 实例**，而非 native 实例。
+
+### 4. 运行方式
+必须使用 HBuilderX：**运行** > **运行到手机或模拟器** > **运行到"指定"基座**
+
+---
+
+**适用平台**: Uniapp 打包 App（iOS/Android）  
+**TUIKit 版本**: @tencentcloud/chat-uikit-uniapp ≥ 3.2.0