@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/knowledge/chat/preset/android/features/search.md

@@ -0,0 +1,64 @@
+## **组件概述**
+
+Search 是搜索组件，为用户提供搜索框、搜索结果展示、界面跳转等功能的完整组件集合。该组件支持用户搜索、群组搜索、消息搜索等功能，并提供了丰富的交互回调接口。
+
+> **说明：**
+>
+
+> 搜索为旗舰版或企业版功能，购买旗舰版或企业版套餐包后可使用，详情请参见 [价格说明](https://cloud.tencent.com/document/product/269/81908#FUNCDetail)。
+>
+
+| <strong>搜索入口</strong> | <strong>搜索结果</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+Search 组件属于 TUIKit Compose 的一部分，集成 TUIKit Compose 即可获取并使用 Search 组件。集成方法请参考文档 [TUIKit Compose](https://cloud.tencent.com/document/product/269/125127) 里的集成步骤，完成登录操作。
+
+## 组件构成
+
+`SearchScreen` 是 Search 组件的入口组件，对外仅暴露了搜索组件的初始化方法，其他逻辑均封装在 `SearchScreen` 中。
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| SearchScreen | <code>modifier: Modifier</code> | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |
+| <code>onBack: () -> Unit</code> | 点击取消按钮的回调，可选参数。 |  |
+| <code>onContactSelect: (FriendSearchInfo) -> Unit</code> | 点击搜索到的联系人条目时的回调，可选参数。 |  |
+| <code>onGroupSelect: (GroupSearchInfo) -> Unit</code> | 点击搜索到的群组条目时的回调，可选参数。 |  |
+| <code>onConversationSelect: (MessageSearchResultItem) -> Unit</code> | 点击搜索到的会话条目时的回调，可选参数。 |  |
+| <code>onMessageSelect: (MessageInfo) -> Unit</code> | 点击搜索到的消息条目时的回调，可选参数。 |  |
+
+## 基础用法
+
+`SearchScreen` 的搜索结果路由跳转如下：
+- 自动路由：在搜索结果界面中，点击**更多**（**More**）按钮或聊天记录列表时，组件内部会通过自动完成页面跳转。
+
+- 自定义路由：当用户点击具体的联系人、群组、会话或消息时，组件会触发相应的回调`onContactSelect/onGroupSelect/onConversationSelect/onMessageSelect`，需在回调中实现自定义跳转（例如跳转到您的自定义聊天界面）。
+
+   如下图所示：
+
+   `SearchScreen`组件可直接初始化使用，示例代码如下：
+
+   ``` java
+   SearchScreen(
+       modifier = Modifier.Companion
+           .fillMaxSize()
+           .statusBarsPadding()
+           .navigationBarsPadding(),
+       onBack = {
+           // 取消按钮点击响应事件
+       },
+       onContactSelect = {
+           // 联系人点击响应事件
+       },
+       onGroupSelect = {
+           // 群组点击响应事件
+       },
+       onConversationSelect = {
+           // 会话点击响应事件
+       },
+       onMessageSelect = {
+           // 消息点击响应事件
+       }
+   )
+   ```

package/resource/{doc/chatkit → knowledge/chat/preset}/android/features/theme.md

@@ -1,7 +1,7 @@
 TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的主题模式（浅色/深色/跟随系统）和主题色。通过简单的配置，开发者可以轻松实现应用级别的主题切换和品牌色定制。
 
 以消息列表为例，自定义主题模式和主题色的效果如下图所示：
-| **浅色 + 默认颜色** | **浅色 + 橘黄色** | **深色 + 默认颜色** | **深色 + 绿色主题** |
+| <strong>浅色 + 默认颜色</strong> | <strong>浅色 + 橘黄色</strong> | <strong>深色 + 默认颜色</strong> | <strong>深色 + 绿色主题</strong> |
 | --- | --- | --- | --- |
 |  |  |  |  |
 
@@ -31,13 +31,14 @@ TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的
 ### 设置主题模式
 | 方法 | 参数 | 返回值 | 说明 |
 | --- | --- | --- | --- |
-| `setThemeMode` | `ThemeMode` | `Unit` | 设置显示模式，自动保存并刷新。<br>• `ThemeMode.SYSTEM`：跟随系统外观。<br>• `ThemeMode.LIGHT`：强制使用浅色模式。<br>• `ThemeMode.DARK`：强制使用深色模式。 |
+| <code>setThemeMode</code> | <code>ThemeMode</code> | <code>Unit</code> | 设置显示模式，自动保存并刷新。<br>- <code>ThemeMode.SYSTEM</code>：跟随系统外观。<br>- <code>ThemeMode.LIGHT</code>：强制使用浅色模式。<br>- <code>ThemeMode.DARK</code>：强制使用深色模式。 |
 
 ### 设置主题色
-| 方法 | 参数 | 返回值 | 说明 |
-| --- | --- | --- | --- |
-| `setPrimaryColor` | `String` | `Unit` | 设置主题色，需要 Hex 格式（例如 "#1C66E5"）。 |
-| `clearPrimaryColor` | 无 | `Unit` | 清除自定义主题色，恢复默认蓝色。 |
+
+|方法|参数|返回值|说明|
+|---------|---------|---------|---------|
+|`setPrimaryColor`|`String`|`Unit`|设置主题色，需要 Hex 格式（例如 "#1C66E5"）。|
+|`clearPrimaryColor`|无|`Unit`|清除自定义主题色，恢复默认蓝色。|
 
 > **说明：**
 >
@@ -48,12 +49,13 @@ TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的
 ### 查询 ThemeState 信息
 
 通过以下只读属性可以查询当前的主题配置状态和信息：
-| 属性 | 类型 | 说明 |
-| --- | --- | --- |
-| `currentMode` | `ThemeMode` | 当前主题模式。 |
-| `currentPrimaryColor` | `String?` | 当前主题色（Hex 格式）。 |
-| `hasCustomPrimaryColor` | `Boolean` | 是否设置了自定义主题色。 |
-| `isDarkMode` | `Boolean` | 当前是否为深色模式。 |
+
+|属性|类型|说明|
+|---------|---------|---------|
+|`currentMode`|`ThemeMode`|当前主题模式。|
+|`currentPrimaryColor`|`String?`|当前主题色（Hex 格式）。|
+|`hasCustomPrimaryColor`|`Boolean`|是否设置了自定义主题色。|
+|`isDarkMode`|`Boolean`|当前是否为深色模式。|
 
 ## 使用方式
 
@@ -63,7 +65,7 @@ TUIKit Compose 提供了强大的外观定制能力，支持自定义应用的
 
 AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配置文件统一管理，适用于 Web + Native 双端应用需要保持统一外观的场景。
 
-您可以在 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail?scene=messenger) 体验 AppBuilder 功能，体验入口：
+您可以在 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail) 体验 AppBuilder 功能，体验入口：
 
 虽然 Chat Web 体验馆上暂时无法实时观看移动端的配置效果，但移动端已经预先支持了 AppBuilder 的配置能力。
 
@@ -74,7 +76,7 @@ AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配
 
 ####  1. 下载配置文件
 
-访问 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail?scene=messenger)，下载配置文件 appConfig.json。下载路径为：
+访问 [Chat Web 体验馆](https://trtc.io/demo/homepage/#/detail)，下载配置文件 appConfig.json。下载路径为：
 
 `appConfig.json`文件内容如下所示，与 AppBuilder 页面的配置项一一对应，与定义外观相关的配置是 `theme`及其子字段：
 ``` json
@@ -117,10 +119,11 @@ AppBuilder是一个便捷式功能及 UI 自定义配置工具，通过 JSON 配
 ```
 
 **配置选项说明**
-| 参数说明 | 类型 | 可选值 | 说明 |
-| --- | --- | --- | --- |
-| `mode` | String | `"system"`、`"light"`、`"dark"` | 主题模式 |
-| `primaryColor` | String | Hex 颜色值，例如 `"#0ABF77"` | 主题色 |
+
+|参数说明|类型|可选值|说明|
+|---------|---------|---------|---------|
+|`mode`|String|`"system"`、`"light"`、`"dark"`|主题模式|
+|`primaryColor`|String|Hex 颜色值，例如 `"#0ABF77"`|主题色|
 
 #### 2. 将配置文件拖入项目中
 

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

@@ -0,0 +1,448 @@
+TUIKit 是基于 IM SDK 的一套 UI 组件库，可通过 UI 组件快速实现聊天、会话、搜索、关系链、群组等功能。本文介绍如何快速集成 TUIKit 并实现核心功能。
+
+## 集成 TUIKit
+
+TUIKit 采用数据驱动的响应式架构与原生 Android View 体系（非 Compose），以源码方式开放集成。它提供会话列表、聊天、联系人、搜索、群组等完整 UI 能力，并内置主题切换与全局配置。
+
+### 环境要求
+
+> **架构说明**：本文档对应 **Android TUIKit（View 架构 / 传统 XML 布局）**，适用于基于 Android View 体系的项目。如需 Jetpack Compose 架构，请参考 Android TUIKit Compose 集成文档。
+- Android Studio 2022.3.1 及之后的版本，JDK 17。
+
+- Android 6.0 及以上真机或模拟器。
+
+- 工程需支持 Kotlin（TUIKit 使用 Kotlin 开发）。
+
+- minSdk >= 23 。
+
+- 一个有效的腾讯云账号及 Chat 应用。可参考 开通服务 从控制台获取以下信息：
+
+  - SDKAppID：App 在控制台获取的 Chat 应用的 ID，为应用的唯一标识。
+
+  - SDKSecretKey：应用的密钥。
+
+      >
+
+> **版本兼容性说明：**
+>
+      >
+
+      > 为确保构建环境稳定，请严格遵循官方兼容性要求进行配置：
+      >
+>     - Gradle、Android Gradle Plugin、JDK 与 Android Studio 的兼容性，请参阅 Android 官方文档：[版本说明](https://developer.android.com/build/releases/gradle-plugin#updating-gradle)。
+>     - Kotlin、Android Gradle Plugin 与 Gradle 的版本对应关系，请参阅 Kotlin 官方文档：[Kotlin-Gradle 插件兼容性](https://kotlinlang.org/docs/gradle-configure-project.html#apply-the-plugin)。
+
+      > 我们建议您根据上述指南，选择与项目要求完全匹配的版本组合。
+      >
+
+### 集成步骤
+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` 中引入对应模块（请按源码实际存放位置调整相对路径）：
+
+【Kotlin DSL】
+``` kotlin
+// settings.gradle.kts
+
+// 引入 Chat UIKit 组件库（必要）
+include(":uikit")
+project(":uikit").projectDir = file("${settingsDir.path}/chat/uikit")
+
+// 引入 AtomicX 基础 UI 组件库（必要）
+include(":atomic_x")
+project(":atomic_x").projectDir = file("${settingsDir.path}/atomic_x")
+
+// 引入音视频通话组件（可选，集成音视频通话时需要）
+include(":tuicallkit-kt")
+project(":tuicallkit-kt").projectDir = file("${settingsDir.path}/call/tuicallkit-kt")
+```
+
+【Groovy DSL】
+``` groovy
+// settings.gradle
+
+// 引入 Chat UIKit 组件库（必要）
+include ':uikit'
+project(':uikit').projectDir = new File(settingsDir, 'chat/uikit')
+
+// 引入 AtomicX 基础 UI 组件库（必要）
+include ':atomic_x'
+project(':atomic_x').projectDir = new File(settingsDir, 'atomic_x')
+
+// 引入音视频通话组件（可选，集成音视频通话时需要）
+include ':tuicallkit-kt'
+project(':tuicallkit-kt').projectDir = new File(settingsDir, 'call/tuicallkit-kt')
+```
+
+3. 在 app 模块的 `build.gradle.kts` 中添加依赖：
+
+【Kotlin DSL】
+``` kotlin
+// app/build.gradle.kts
+dependencies {
+    // TUIKit 组件库（必要）
+    implementation(project(":uikit"))
+    implementation(project(":atomic_x"))
+    // 音视频通话（可选）
+    implementation(project(":tuicallkit-kt"))
+}
+```
+
+【Groovy DSL】
+``` groovy
+// app/build.gradle
+dependencies {
+    // TUIKit 组件库（必要）
+    implementation project(':uikit')
+    implementation project(':atomic_x')
+    // 音视频通话（可选）
+    implementation project(':tuicallkit-kt')
+}
+```
+
+### 接入步骤
+
+完成上述集成后，参考以下步骤，您仅需几行代码即可在项目中快速搭建会话列表、聊天、联系人等核心界面。
+
+#### 步骤1：配置用户鉴权
+
+在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/tool-usersig) 根据 UserID 获取 UserSig，用于后续登录时的用户鉴权。
+
+#### 步骤2：用户登录
+
+登录鉴权后才能正常使用组件的功能。调用 `LoginStore` 的 `login` 接口，传入上文获取的 sdkAppID、userID、userSig 进行登录鉴权：
+``` java
+import io.trtc.tuikit.atomicxcore.api.CompletionHandler
+import io.trtc.tuikit.atomicxcore.api.login.LoginStore
+
+LoginStore.shared.login(
+    context,
+    sdkAppID, // Int，控制台获取
+    userID,   // String
+    userSig,  // String，控制台或服务端生成
+    object : CompletionHandler {
+        override fun onSuccess() {
+            // 登录成功，可跳转会话列表或聊天页
+        }
+        override fun onFailure(code: Int, desc: String) {
+            // 登录失败，可弹框报错
+        }
+    }
+)
+```
+
+> **注意：**
+>
+
+> 在正式的生产环境中，建议在您的服务端生成 UserSig，在需要时由 App 向业务服务器发起请求获取动态 UserSig 进行鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
+>
+
+#### 步骤3：构建会话列表界面
+
+会话列表只需创建 `ConversationsPageView` 并加入到您的布局即可。它会自动从本地读取最近会话，点击某个会话时通过 `onConversationClick` 回调返回该会话的 `conversationID`，您可据此跳转聊天界面。
+``` kotlin
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.chat.uikit.pages.ConversationsPageView
+
+class ConversationActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        val conversationsPage = ConversationsPageView(this)
+        conversationsPage.setHeaderTitle("消息")
+
+        // 点击会话回调，conversationID 已带 c2c_ / group_ 前缀
+        conversationsPage.onConversationClick = { conversationID ->
+            // 跳转到您的聊天界面，并将 conversationID 传入（可参考步骤4 的 ChatActivity）
+        }
+        // 可选：搜索、发起单聊、创建群聊等入口回调
+        conversationsPage.onSearchClick = { /* 跳转搜索页 */ }
+        conversationsPage.onStartChatClick = { /* 发起单聊 */ }
+        conversationsPage.onCreateGroupClick = { /* 创建群聊 */ }
+
+        // 将会话列表设置为页面内容
+        setContentView(conversationsPage)
+    }
+}
+```
+
+#### 步骤4：构建聊天界面
+
+聊天界面使用 `ChatPageView` 展示和收发消息，通过 `setup` 传入 `conversationID` 即可。`conversationID` 的格式为：单聊 `c2c_<对方 UserID>`，群聊 `group_<群 GroupID>`。
+``` kotlin
+import android.content.Context
+import android.content.Intent
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+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>"
+        val conversationID = intent.getStringExtra("conversationID") ?: return
+
+        val chatPageView = ChatPageView(this)
+        chatPageView.setup(conversationID = conversationID)
+        setContentView(chatPageView)
+    }
+
+    companion object {
+        fun start(context: Context, conversationID: String) {
+            context.startActivity(Intent(context, ChatActivity::class.java).apply {
+                putExtra("conversationID", conversationID)
+            })
+        }
+    }
+}
+```
+
+> **注意：**
+>
+
+> 承载聊天页的 Activity **必须**设置 Material Components 主题（如 `setTheme(com.google.android.material.R.style.Theme_MaterialComponents_Light_NoActionBar)`），否则 `ChatPageView` 内部使用的 Material 控件会因缺少对应主题属性，在运行时直接 Crash。
+>
+
+> **说明：**示例工程（demo）中提供了基于 `ChatPageView` 封装好的聊天页 `ChatActivity`（带标题栏、未读角标、群事件处理等），可直接复用或参考其实现进行自定义：`ChatActivity.start(context, conversationID)`。
+>
+
+#### 步骤5：构建联系人界面
+
+联系人界面使用 `ContactsPageView` 展示好友列表、群组列表等，通过 `setup` 设置点击回调。点击联系人或群组时跳转对应聊天界面。
+``` kotlin
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.chat.uikit.pages.ContactsPageView
+
+class ContactActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+
+        val contactsPage = ContactsPageView(this)
+        contactsPage.setHeaderTitle("通讯录")
+        contactsPage.setup(
+            onContactClick = { contactInfo ->
+                // 跳转到您的聊天界面，单聊会话 ID 为 "c2c_" + contactInfo.userID（可参考步骤4 的 ChatActivity）
+            },
+            onGroupClick = { contactInfo ->
+                // 跳转到您的聊天界面，群聊会话 ID 为 "group_" + contactInfo.userID（可参考步骤4 的 ChatActivity）
+            }
+        )
+        setContentView(contactsPage)
+    }
+}
+```
+
+#### 步骤6：主题设置（可选）
+
+TUIKit 通过 `ThemeStore` 支持设置主题色与浅色 / 深色主题切换。
+``` kotlin
+import io.trtc.tuikit.atomicx.theme.Theme
+import io.trtc.tuikit.atomicx.theme.ThemeStore
+
+// 设置主题色
+ThemeStore.shared(context).setPrimaryColor("#1C66E5")
+
+// 切换浅色 / 深色主题
+ThemeStore.shared(context).setTheme(Theme.lightTheme(context))
+// ThemeStore.shared(context).setTheme(Theme.darkTheme(context))
+```
+
+#### 步骤7：音视频通话（可选）
+
+若需在聊天中支持音视频通话，请先 [开通音视频服务](https://console.cloud.tencent.com/im)，并在集成步骤中引入 `:tuicallkit-kt` 组件。**登录成功后**初始化 `TUICallEngine，`即可在 Chat 组件中正常使用该功能。
+``` kotlin
+import com.tencent.cloud.tuikit.engine.call.TUICallEngine
+import com.tencent.cloud.tuikit.engine.common.TUICommonDefine
+
+TUICallEngine.createInstance(context).init(
+    sdkAppID, userID, userSig,
+    object : TUICommonDefine.Callback {
+        override fun onSuccess() {
+            // 初始化成功，可使用音视频通话能力
+        }
+
+        override fun onError(errCode: Int, errMsg: String) {
+            // 初始化失败
+        }
+    }
+)
+```
+
+## 集成 TUIKit（旧架构）
+
+> **版本说明**
+>
+> - TUIKit（旧架构）为历史版本，目前已不再新增功能并逐步停止维护，主要面向存量项目继续使用。若您是新接入的项目，建议优先按上文「集成 TUIKit」章节进行集成，以获得更现代的架构、更低的接入成本与持续的功能更新。
+> - 如您当前仍在使用旧架构 TUIKit，欢迎花 1 分钟填写这份[调研问卷](https://wj.qq.com/s2/27183285/0606/)，帮我们了解您继续沿用旧版的原因，以便提供更合适的迁移支持。
+
+**TUIKit 新架构的主要优势**
+|  | 新架构 | 旧架构 |
+| --- | --- | --- |
+| 开发语言 | 基于 Kotlin，借力协程与空安全，语法更简洁、更易维护 | 以 Java 为主 |
+| 架构与自定义 | 界面与数据解耦，界面自定义更灵活、更安全 | 界面与数据耦合较高 |
+| 主题与语言切换 | 主题、语言支持动态切换，无需重启应用 | 主题、语言切换需重启应用 |
+| 性能与体验 | 动画更流畅，卡顿更少 | 受旧架构限制，流畅性弱于新架构 |
+| 功能演进 | 持续支持新功能 | 仅维护，不再新增功能 |
+
+> **消息引用与回复功能的版本兼容性：**
+>
+
+> 自 9.0.7652 版本起：
+>
+> - **消息引用（Quote）**改用 IMSDK 原生引用能力实现，与旧版本引用消息格式不兼容。新旧版本互发的引用消息无法正确解析引用内容，请将收发双方统一升级至 9.0.7652 及以上版本。
+> - **消息回复（Reply）**功能已下线，相关接口与 UI 入口不再提供，如业务有相关需求，可参考旧版本 TUIKit 自行实现。
+
+> **两者区别：**引用是发送新消息时附带一条历史消息的摘要卡片，点击可跳转原消息（一问一答）；回复是在某条消息下追加评论并聚合成回复列表（评论区式）。
+>
+
+### 集成步骤
+1. 从 GitHub 下载 [Android TUIKit 源码](https://github.com/TencentCloud/TIMSDK/tree/master/Android/TUIKit)，将 `TUIKit` 目录复制到工程目录下。
+
+2. 在 `settings.gradle` 中引入所需模块（模块相互独立，可只引入需要的模块）。核心模块如下，其余可选模块按需引入即可：
+
+   ``` groovy
+   include ':app'
+   include ':tuicore'
+   project(':tuicore').projectDir = new File(settingsDir, '../TUIKit/TUICore/tuicore')
+   include ':timcommon'
+   project(':timcommon').projectDir = new File(settingsDir, '../TUIKit/TIMCommon/timcommon')
+   include ':tuichat'
+   project(':tuichat').projectDir = new File(settingsDir, '../TUIKit/TUIChat/tuichat')
+   include ':tuicontact'
+   project(':tuicontact').projectDir = new File(settingsDir, '../TUIKit/TUIContact/tuicontact')
+   include ':tuiconversation'
+   project(':tuiconversation').projectDir = new File(settingsDir, '../TUIKit/TUIConversation/tuiconversation')
+   // 搜索、社群、通话、会议及各插件等可选模块按需引入
+   ```
+3. 在 app 模块的 `build.gradle` 中添加依赖：
+
+   ``` groovy
+   dependencies {
+       api project(':tuiconversation')
+       api project(':tuicontact')
+       api project(':tuichat')
+       // 其余已引入的可选模块按需添加 api project(...) 依赖
+   }
+   ```
+4. 配置 Kotlin 支持
+
+- 如果您的项目已是 Kotlin 工程​：可跳过此步。
+
+- ​如果您的项目尚未配置 Kotlin​：请添加对应版本的 Kotlin Gradle 插件
+
+   > **说明：**
+   >
+>   - 本地源码集成方式升级时需从 GitHub 重新拉取最新代码覆盖本地 `TUIKit` 目录，冲突需手动合并。
+>   - 旧架构默认提供经典版与简约版两套 UI，**不能混用**：集成多个组件时必须统一选择经典版或简约版。
+
+### 接入步骤
+
+常用聊天软件由会话列表、聊天窗口、好友列表、音视频通话等基本界面组成，参考下列步骤即可快速搭建。
+
+**步骤1：配置用户鉴权**
+
+在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/tool-usersig) 根据 UserID 获取 UserSig，用于后续登录鉴权。
+
+**步骤2：用户登录**
+``` java
+TUILogin.login(context, sdkAppID, userID, userSig, new TUICallback() {
+    @Override
+    public void onSuccess() {
+        // 登录成功，可跳转聊天或会话页
+    }
+    @Override
+    public void onError(final int code, final String desc) {
+        // 登录失败，可弹框报错
+    }
+});
+```
+
+> **注意：**
+>
+
+> 正式生产环境建议在服务端生成 UserSig，由 App 向业务服务器请求动态 UserSig 鉴权。详见 [服务端生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。
+>
+
+**步骤3：构建会话列表界面**
+
+创建 `TUIConversationFragment`（经典版）或 `TUIConversationMinimalistFragment`（简约版）并加入布局：
+``` java
+TUIConversationFragment conversationFragment = new TUIConversationFragment();
+getSupportFragmentManager().beginTransaction()
+        .add(R.id.fragment_container, conversationFragment).commitAllowingStateLoss();
+```
+
+**步骤4：构建聊天界面**
+
+可直接启动预置的聊天 Activity，或在自定义 Activity 中嵌入聊天 Fragment。以经典版为例：
+``` java
+Bundle param = new Bundle();
+param.putInt(TUIConstants.TUIChat.CHAT_TYPE, isGroup ? V2TIMConversation.V2TIM_GROUP : V2TIMConversation.V2TIM_C2C);
+param.putString(TUIConstants.TUIChat.CHAT_ID, chatID);
+if (isGroup) {
+    TUICore.startActivity("TUIGroupChatActivity", param);
+} else {
+    TUICore.startActivity("TUIC2CChatActivity", param);
+}
+```
+
+**步骤5：构建联系人界面**
+
+创建 `TUIContactFragment`（经典版）或 `TUIContactMinimalistFragment`（简约版）并加入布局：
+``` java
+TUIContactFragment contactFragment = new TUIContactFragment();
+getSupportFragmentManager().beginTransaction()
+        .add(R.id.fragment_container, contactFragment).commitAllowingStateLoss();
+```
+
+**步骤6：音视频通话（可选）**
+1. 在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 开通实时音视频（TRTC）服务。
+
+2. 在 `settings.gradle` 中引入 `atomic_x` 与 `tuicallkit-kt`，并在 app 的 `build.gradle` 添加 `api project(':tuicallkit-kt')`。
+
+3. 集成后聊天与联系人界面默认显示「视频通话」「语音通话」按钮，点击即可发起通话。
+
+   **步骤7：多人音视频（可选）**
+
+   在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im) 开通多人音视频（TUIRoomKit）免费体验，在 `settings.gradle` 引入 `tuiroomkit` 并在 app 的 `build.gradle` 添加 `api project(':tuiroomkit')`，集成后聊天界面将出现「快速会议」入口。
+
+## 常见问题
+
+### 音视频常见问题
+
+##### 通话邀请的超时时间默认是多久？
+
+通话邀请的默认超时时间是 30 秒。
+
+##### 在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？
+- 如果是单聊通话邀请，被邀请者离线再上线可以收到通话邀请，TUIKit 内部会自动唤起通话邀请界面。
+
+- 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 30 秒内的邀请，TUIKit 会自动唤起群通话界面。
+
+### 其他常见问题
+
+##### 表情包的使用
+
+为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。

package/resource/knowledge/chat/preset/flutter/features/chat-setting.md

@@ -0,0 +1,62 @@
+## 组件概述
+
+ChatSetting 是聊天设置组件集合，主要包含单聊设置（C2CChatSetting）和群聊设置（GroupChatSetting）两个核心组件。这些组件为用户提供了完整的聊天会话管理功能，包括用户信息管理、权限设置、群组管理等核心能力。
+| <strong>单聊设置界面</strong> | <strong>群聊设置界面</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+ChatSetting 组件属于 TUIKit Flutter 的一部分，集成 TUIKit Flutter 即可获取并使用 ChatSetting 组件。集成方法请参考文档 TUIKit Flutter 里的集成步骤。
+
+## 组件构成
+
+ChatSetting 包含两个主要组件：C2CChatSetting（单聊设置）和 GroupChatSetting（群聊设置），每个组件都提供了丰富的配置选项。
+
+### 单聊设置（C2CChatSetting）
+
+#### 初始化参数
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`userID`|`String`|聊天对象的用户 ID。|
+|`onSendMessageClick`|`void Function({String? userID, String? groupID})`|发送消息按钮点击回调，可选参数。|
+|`onContactDelete`|`VoidCallback`|删除联系人按钮点击回调，可选参数。|
+
+### 群聊设置（GroupChatSetting）
+
+#### 初始化参数
+
+|方法名|参数|描述|
+|---------|---------|---------|
+|`groupID`|`String`|群组 ID，用于标识群聊。|
+|`onSendMessageClick`|`void Function({String? userID, String? groupID})`|发送消息按钮点击回调，可选参数。|
+|`onGroupDelete`|`VoidCallback`|解散/退出群组点击回调，可选参数。|
+
+## 基础用法
+
+初始化 C2CChatSetting 即可直接展示单聊设置页面，示例代码如下：
+``` swift
+C2CChatSetting(
+  userID: userID,
+  onSendMessageClick: ({String? userID, String? groupID}) {
+    // 处理发送消息点击事件
+  },
+  onContactDelete: () {
+    // 处理删除好友点击事件
+  },
+);
+```
+
+初始化 GroupChatSetting 即可直接展示群聊设置页面，示例代码如下：
+``` swift
+GroupChatSetting(
+  groupID: groupID,
+  onGroupDelete: () {
+    // 处理删除、解散、退出群聊点击事件
+  },
+  onSendMessageClick: ({String? userID, String? groupID}) {
+    // 处理发送消息点击事件
+  },
+);
+```