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

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

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

package/resource/knowledge/chat/preset/ios/features/contact-list.md

@@ -0,0 +1,119 @@
+## 组件概述
+
+ContactList 是基于 SwiftUI 构建的联系人列表组件，为用户提供完整的联系人管理功能。该组件支持好友列表展示、好友申请处理、群组列表管理、黑名单管理等功能，并提供了丰富的交互回调接口。
+| <strong>联系人列表</strong> | <strong>群组列表</strong> | <strong>好友申请列表</strong> |
+| --- | --- | --- |
+|  |  |  |
+
+## 组件集成
+
+`ContactList` 组件属于 TUIKit SwiftUI 的一部分，集成 TUIKit SwiftUI 即可获取并使用 `ContactList` 组件。集成方法请参考文档 TUIKit SwiftUI 里的集成步骤。
+
+## 组件构成
+
+`ContactList` 是联系人列表里的主组件，对应着整个联系人列表页框架，提供了一个对外的初始化 init 方法：
+| <strong>方法名</strong> | <strong>参数</strong> | <strong>描述</strong> |
+| --- | --- | --- |
+| <code>init</code> | <code>contactStore: ContactListStore</code> | 联系人数据存储，默认请使用 <code>ContactListStore.create()</code> 创建。 |
+| <code>onContactClick: ((AZOrderedListItem) -> Void)?</code> | 点击联系人的回调，可选参数。 |  |
+| <code>onGroupClick: ((AZOrderedListItem) -> Void)?</code> | 点击群组的回调，可选参数。 |  |
+
+`ContactList` 上半部分预留了各个子视图的入口 cell，例如好友申请、群聊申请、群组列表和黑名单列表。下半部分内嵌了联系人列表，如下图所示：
+
+`ContactList` 已内置子页面导航逻辑，点击好友申请、群组申请、群组列表、黑名单等入口时，会自动以全屏弹窗（fullScreenCover）的方式打开对应的子页面，无需您手动处理导航跳转。
+
+如果您需要单独使用子页面（例如好友申请列表、群组列表等），各子页面提供了独立的 init 方法，详情如下：
+| <strong>子页面</strong> | <strong>方法名</strong> | <strong>参数</strong> | <strong>描述</strong> |
+| --- | --- | --- | --- |
+| 好友申请页（FriendApplicationListView） | init | <code>contactStore: ContactListStore</code> | 联系人数据存储，从 ContactList 传过来。 |
+| <code>onDismiss: (() -> Void)?</code> | 关闭页面的回调，可选参数。 |  |  |
+| 群组申请页（GroupApplicationListView） | init | <code>contactStore: ContactListStore</code> | 联系人数据存储，从 ContactList 传过来。 |
+| <code>onDismiss: (() -> Void)?</code> | 关闭页面的回调，可选参数。 |  |  |
+| 群组列表页<br>（GroupListView） | init | <code>contactStore: ContactListStore</code> | 联系人数据存储，从 ContactList 传过来。 |
+| <code>onGroupClick: ((AZOrderedListItem) -> Void)?</code> | 点击群组列表页里的群组的回调，可选参数。 |  |  |
+| <code>onDismiss: (() -> Void)?</code> | 关闭页面的回调，可选参数。 |  |  |
+| 黑名单列表页<br>（BlackListView） | init | <code>contactStore: ContactListStore</code> | 联系人数据存储，从 ContactList 传过来。 |
+| <code>onDismiss: (() -> Void)?</code> | 关闭页面的回调，可选参数。 |  |  |
+
+## 基础用法
+
+### 快速集成
+
+`ContactList` 已内置子页面导航，您只需简单初始化即可获得完整的联系人管理功能：
+``` swift
+import AtomicX
+import SwiftUI
+
+struct ContactsPage: View {
+    private let contactStore = ContactListStore.create()
+
+    var body: some View {
+        ContactList(
+            contactStore: contactStore,
+            onContactClick: { contact in
+                // 处理联系人点击
+                print("点击联系人: \(contact.title)")
+            },
+            onGroupClick: { group in
+                // 处理群组点击（从群组列表页点击群组时触发）
+                print("点击群组: \(group.title)")
+            }
+        )
+    }
+}
+```
+
+点击好友申请、群组申请、群组列表、黑名单等入口时，组件会自动以全屏弹窗的方式打开对应子页面，无需额外处理导航逻辑。跳转示意图如下：
+
+### 集成要点说明
+
+#### 内置导航
+
+ContactList 内置了子页面导航逻辑，使用 fullScreenCover 方式呈现子页面：
+- 好友申请页（FriendApplicationListView）
+
+- 群组申请页（GroupApplicationListView）
+
+- 群组列表页（GroupListView）
+
+- 黑名单列表页（BlackListView）
+
+   您无需手动管理导航状态或配置 NavigationLink。
+
+#### 回调处理
+
+ContactList 提供两个可选回调：
+``` swift
+ContactList(
+    contactStore: contactStore,
+    onContactClick: { contact in
+        // 点击联系人列表中的联系人时触发
+    },
+    onGroupClick: { group in
+        // 点击群组列表中的群组时触发
+    }
+)
+```
+
+#### 数据共享
+
+使用 ContactListStore.create() 创建数据存储实例，组件内部会自动将该实例传递给所有子页面，确保数据一致性：
+``` swift
+private let contactStore = ContactListStore.create()
+```
+
+#### 单独使用子页面
+
+如果您需要在其他场景单独使用子页面，可以直接初始化对应的视图：
+``` swift
+// 单独使用群组列表页
+GroupListView(
+    contactStore: contactStore,
+    onGroupClick: { group in
+        print("点击群组: \(group.title)")
+    },
+    onDismiss: {
+        // 关闭页面
+    }
+)
+```

package/resource/knowledge/chat/preset/ios/features/conversation-list.md

@@ -0,0 +1,134 @@
+## 组件概述
+
+ConversationList 是一个基于 SwiftUI 构建的会话列表组件，主要用于展示和管理用户的聊天会话。该组件提供了完整的会话列表功能，包括会话展示、交互操作等核心能力。
+| <strong>会话列表</strong> | <strong>会话操作</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+ConversationList 是属于 TUIKit SwiftUI 的一个组件，集成 TUIKit SwiftUI 即可获取并使用 ConversationList，集成方法请参考文档 TUIKit SwiftUI 里的集成步骤。
+
+## 组件构成
+
+ConversationList 组件对外仅暴露了会话列表的初始化方法，其他逻辑均封装在 ConversationList 中。
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>init</code> | <code>onConversationClick: @escaping (ConversationInfo) -> Void</code> | 初始化组件，设置会话点击回调，必填。 |
+| <code>config: ConversationActionConfigProtocol = ChatConversationActionConfig()</code> | 初始化组件，设置会话操作菜单项，选填。 |  |
+| <code>customActions: [ConversationCustomAction] = []</code> | 初始化组件，设置自定义会话操作选项，选填。 |  |
+
+## 基础用法
+
+ConversationList 组件可直接初始化使用，需要实现 onConversationClick 回调。
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`onConversationClick`|`(ConversationInfo) -> Void`|会话点击回调，当用户点击某个会话 cell 时触发。|
+
+示例代码如下：
+``` swift
+import AtomicX
+import SwiftUI
+
+struct ContentView: View {
+    var body: some View {
+        ConversationList(
+            onConversationClick: { conversation in
+                // 这里建议导航到聊天页面
+            }
+        )
+    }
+}
+```
+
+## 自定义组件
+
+您可以自定义会话列表的操作项。方法如下。
+
+#### 方式 1. 局部隐藏会话操作项
+
+初始化 ConversationList 时传入自定义 config，设置是否展示某些菜单项：
+``` swift
+struct CustomConversationView: View {
+    var body: some View {
+        ConversationList(
+            onConversationClick: { conversation in
+                // 点击会话 cell 跳转
+            },
+            // 不展示 ClearHistory
+            config: ChatConversationActionConfig(isSupportDelete: true, isSupportPin: true, isSupportClearHistory: false)
+        )
+    }
+}
+```
+
+**目前支持的菜单项开关操作**
+
+|操作类型|描述|
+|---------|---------|
+|`isSupportDelete`|是否支持删除会话。|
+|`isSupportPin`|是否支持置顶会话。|
+|`isSupportClearHistory`|是否支持清空历史消息。|
+
+#### 方式 2. 局部增加会话操作项
+
+初始化 ConversationList 时传入 `customActions`，ConversationList 内部会在默认的 action 底部添加您增加的自定义选项：
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`customActions`|`[ConversationCustomAction]`|自定义会话操作，当用户点击会话操作菜单时展示。|
+
+示例代码如下：
+``` java
+struct CustomConversationView: View {
+    var body: some View {
+            ConversationList(
+                onConversationClick: { conversation in
+                    onShowMessage?(NavigationInfo(conversation: conversation))
+                },
+                // Custom actions
+                customActions: [
+                    ConversationCustomAction(title: "Share") { conversation in
+                        print("Share conversation: \(conversation.title ?? "")")
+                    },
+                ]
+            )
+            .conversationActions([.delete, .pin, .clearHistory])
+            .environmentObject(themeState)
+    }
+}
+
+```
+
+#### 方式 3. 全局配置方式
+
+通过 `AppBuilderConfig` 进行全局配置：
+``` swift
+// 在应用启动时配置，不包含则不支持
+AppBuilderConfig.shared.conversationActionList = [
+    .delete,        // 支持删除
+    .pin,           // 支持置顶
+    .clearHistory   // 清空会话消息
+]
+
+// 接下来再初始化 ConversationList，所有的 ConversationList 都会遵守上面 conversationActionList 的配置
+ConversationList(
+    onConversationClick: { conversation in
+        // 这里可以导航到聊天页面
+    }
+)
+```
+
+> **注意：**
+>
+
+> 局部配置的优先级大于全局配置。
+>
+
+自定义效果如下图所示：
+| 会话操作（默认选项） | 会话操作（隐藏<strong>删除</strong>选项） | 会话操作（新增<strong>隐藏会话</strong>选项） |
+| --- | --- | --- |
+|  |  |  |

package/resource/knowledge/chat/preset/ios/features/language.md

@@ -0,0 +1,105 @@
+## 功能描述
+
+iOS 端 `TUIKit`默认自带 **简体中文、英语 **和** 阿拉伯语** 语言包，作为界面展示语言。
+
+根据此文档指引，您可以使用默认语言包，也可自定义语言翻译表述和增加其他语言包。
+
+> **说明：**
+>
+
+> TUIKit 从 7.5.4852 版本开始，新增 RTL 语言（文字方向从右到左的语言，例如阿拉伯语、希伯来语等）支持，同时内置语言新增了阿拉伯语。
+>
+
+|简体中文|英文|阿拉伯语|
+|---------|---------|---------|
+||||
+
+## 使用自带语言
+
+如果您的 App 需要的语言仅包括 **简体中文、英语 **和** 阿拉伯语** ，请参考本部分。
+
+### 跟随系统语言
+
+直接使用 `TUIKit` 即可，无需额外步骤。组件内部语言会跟随系统语言。
+
+### 指定显示的语言
+
+如果您需要指定`TUIKit`界面语言，请在`[TUIGlobalization setPreferredLanguage:@""]`中传入需要的语言，指定语言后，组件内部不再跟随系统语言。
+语言可选项，取值为：
+``` Java
+@"zh-Hans" ,//简体中文
+@"en", // 英文
+@"ar", // 阿拉伯语
+```
+
+> **说明**
+>
+
+>  语言代码清单见 附录。
+>
+
+## 使用更多语言/自定义翻译表述
+
+如果您的 App 需要支持更多语言，或更改部分词条的翻译，请参考本部分。
+
+本章节以添加韩语语言包为例，讲解新增语言包和自定义翻译的流程。
+
+### 新增语言资源文件
+
+我们自带的所有语言包，以String文件模板的形式，存储于您项目里Pods中`TUICore`组件的`TUIKitLocalizable/Localizable/` 路径。
+
+请新建目录并命名为`{语言编码}.lproj`，在此目录下新增 `Localizable.strings`文件，其中，`${语言编码}` 需要替换为 ISO 639-1 语言代码。（可以直接复制您熟悉的语言文件，如zh-Hans.lproj，并直接修改目录名称）
+如果您需要兼容支持多个新语言，复制多份，并准确指定每一份的语言编码即可。
+
+以韩语为例，新增`ko.lproj/Localizable.strings`的语言资源文件：
+
+### 个性化自定义翻译
+
+上一步已经创建好了韩语资源文件 `ko.lproj/Localizable.strings`，不同语言资源文件中语言的 `key` 是相同的，具体内容可以自定义翻译。
+
+### 跟随系统语言
+
+如果是简体中文、繁体中文、英文、韩语、俄语、乌克兰语，添加完lproj资源包后直接使用TUIKit即可，无需额外步骤。
+
+如果是其他语种，则需要在 `TUIGlobalization.m`中的`+ (NSString *)tk_localizableLanguageKey`
+
+新增的语言词条包命名需要 符合标准，组件内部会跟随系统语言自适应。
+
+> **说明**
+>
+
+>  语言代码清单见 ISO 639-1 语言代码。
+>
+
+### 指定显示的语言
+
+如果您需要指定`TUIKit`界面语言，请在`[TUIGlobalization setPreferredLanguage:@""]`中传入需要的语言，指定语言后，组件内部不再跟随系统语言。
+语言可选项，取值为 ISO 639-1 语言代码
+以韩语为例，传入`[TUIGlobalization setPreferredLanguage:@"ko"];`
+
+效果如图所示：
+
+## 附录：语言代码表
+
+|语言|代码|语言|代码|
+|---------|---------|---------|---------|
+|阿拉伯语|ar|保加利亚语|bg|
+|克罗地亚语|hr|捷克语|cs|
+|丹麦语|da|德语|de|
+|希腊语|el|英语|en|
+|爱沙尼亚语|et|西班牙语|es|
+|芬兰语|fi|法语|fr|
+|爱尔兰语|ga|印地语|hi|
+|匈牙利语|hu|希伯来语|he|
+|意大利语|it|日语|ja|
+|朝鲜语/韩语|ko|拉脱维亚语|lv|
+|立陶宛语|lt|荷兰语|nl|
+|挪威语|no|波兰语|pl|
+|葡萄牙语|pt|瑞典语|sv|
+|罗马尼亚语|ro|俄语|ru|
+|塞尔维亚语|sr|斯洛伐克语|sk|
+|斯洛文尼亚语|sl|泰语|th|
+|土耳其语|tr|乌克兰语|uk|
+|中文（简体）|zh-Hans|中文（繁体）|zh-Hant|
+
+完整版 [请见此处](https://quickref.me/iso-639-1)。

package/resource/knowledge/chat/preset/ios/features/message-input.md

@@ -0,0 +1,69 @@
+## 组件概述
+
+MessageInput 是基于 SwiftUI 构建的消息输入组件，为用户提供完整的消息编辑和发送功能。该组件支持多种消息类型的输入和发送，包括文本消息、图片、视频、文件、语音等，同时提供表情选择等增强功能，支持多种样式配置和自定义选项。
+| <strong>消息输入界面</strong> | <strong>表情选择器</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+MessageInput 组件属于 TUIKit SwiftUI 的一部分，集成 TUIKit SwiftUI 即可获取并使用 MessageInput 组件。集成方法请参考文档 TUIKit SwiftUI 里的集成步骤。
+
+## 组件构成
+
+MessageInput 组件包含消息输入核心组件和样式配置协议，提供了消息输入功能，并支持自定义。
+
+#### 初始化参数
+
+|参数名|类型|描述|
+|---------|---------|---------|
+|`conversationID`|`String`|会话 ID，用于标识当前聊天会话。|
+|`config`|`MessageInputConfigProtocol`|输入样式配置，控制各功能按钮的显示。|
+
+#### 公开接口
+
+|方法名|参数|描述|
+|---------|---------|---------|
+|`init`|`conversationID: String, config: MessageInputConfigProtocol`|初始化消息输入组件。|
+
+## 基础用法
+
+MessageInput 组件可直接初始化使用，需要提供会话 ID。
+``` swift
+import AtomicX
+import SwiftUI
+
+struct ChatView: View {
+    var body: some View {
+        VStack {
+            Spacer()
+
+            MessageInput(
+                conversationID: "conversation_123"
+            )
+        }
+    }
+}
+```
+
+## 自定义组件
+
+您可以自定义决定是否显示输入栏上的功能入口：
+``` swift
+// 自定义显示哪些功能按钮
+MessageInput(
+    text: $inputText,
+    conversationID: conversationID,
+    config: ChatMessageInputConfig(
+        isShowAudioRecorder: false,  // 隐藏语音录制
+        isShowPhotoTaker: true,      // 显示拍照功能
+        isShowMore: true,            // 显示更多功能
+        isShowSendButton: true       // 显示发送按钮
+    )
+)
+```
+
+自定义效果如下图所示：
+| 默认输入框 | 隐藏输入框上的语音录制功能 | 隐藏输入框上的全部功能 |
+| --- | --- | --- |
+|  |  |  |

package/resource/knowledge/chat/preset/ios/features/message-list.md

@@ -0,0 +1,164 @@
+## 组件概述
+
+MessageList 是一个基于 SwiftUI 构建的消息列表组件，主要用于展示和管理聊天消息。该组件提供了完整的消息类型展示功能：
+- 消息类型支持：文本、图片、视频、语音、文件、系统消息、表情消息等。
+
+- 消息操作：支持长按菜单操作，例如复制、删除、撤回、以及自定义操作。
+
+- 高度可定制：支持多种样式配置（例如气泡颜色、圆角、字体）和自定义操作项。
+
+| <strong>聊天消息列表</strong> | <strong>消息长按菜单</strong> |
+| --- | --- |
+|  |  |
+
+## 组件集成
+
+MessageList 是属于 TUIKit SwiftUI 的一个组件，集成 TUIKit SwiftUI 即可获取并使用 MessageList，集成方法请参考文档 TUIKit SwiftUI 里的集成步骤。
+
+## 组件构成
+
+MessageList 组件对外仅暴露了消息列表的初始化方法，其他逻辑均封装在 MessageList 中。
+
+#### 对外方法
+| 方法名 | 参数 | 描述 |
+| --- | --- | --- |
+| <code>init</code> | <code>conversationID: String</code> | 初始化组件，设置会话 ID。 |
+| <code>config: MessageListConfigProtocol & MessageActionConfigProtocol = ChatMessageListConfig()</code> | 初始化组件，设置消息列表样式。 |  |
+| <code>locateMessage: MessageInfo? = nil</code> | 初始化组件，设置定位消息。通常用于从消息搜索结果页跳转消息页同时定位到目标消息。 |  |
+| <code>onUserClick: ((String) -> Void)? = nil</code> | 初始化组件，设置点击用户头像跳转响应事件。 |  |
+| <code>customActions: [MessageCustomAction] = []</code> | 初始化组件，设置自定义消息菜单选项。 |  |
+
+## 基础用法
+
+MessageList 组件可直接初始化使用，需要提供会话 ID。除此之外，我们还建议您在初始化方法中实现 onUserClick。
+``` swift
+import AtomicX
+import SwiftUI
+
+struct ContentView: View {
+    var body: some View {
+        MessageList(
+            conversationID: "conversation_123",
+            onUserClick: { userID in
+                // 点击用户头像响应事件
+            }
+        )
+    }
+}
+```
+
+## 自定义组件
+
+您可以自定义消息列表的样式和操作项。方法如下。
+
+#### 自定义样式
+
+您可以实现 `MessageListConfigProtocol` 协议来创建完全自定义的样式：
+``` swift
+struct MyCustomConfig: MessageListConfigProtocol & MessageActionConfigProtocol
+ {
+    let alignment: Int = 0
+    let isShowTimeMessage: Bool = true
+    let isShowLeftAvatar: Bool = true
+    let isShowLeftNickname: Bool = true
+    let isShowRightAvatar: Bool = true
+    let isShowRightNickname: Bool = true
+    let isSupportCopy: Bool = false
+    // ... 其他属性
+}
+
+// 使用自定义样式
+MessageList(
+    conversationID: "conversation_123",
+    config: MyCustomConfig()
+)
+```
+
+`MessageListConfigProtocol` 协议属性说明：
+| 属性名 | 类型 | 描述 | 备注 |
+| --- | --- | --- | --- |
+| <code>alignment</code> | <code>Int</code> | 消息对齐方式 | - 1: 左对齐<br>- 2: 右对齐<br>- 3: 左右对齐 |
+| <code>isShowTimeMessage</code> | <code>Bool</code> | 是否显示时间消息 | 控制是否显示消息时间戳。 |
+| <code>isShowLeftAvatar</code> | <code>Bool</code> | 是否显示左侧头像 | 控制接收消息时是否显示发送者头像。 |
+| <code>isShowLeftNickname</code> | <code>Bool</code> | 是否显示左侧昵称 | 控制接收消息时是否显示发送者昵称。 |
+| <code>isShowRightAvatar</code> | <code>Bool</code> | 是否显示右侧头像 | 控制发送消息时是否显示自己头像。 |
+| <code>isShowRightNickname</code> | <code>Bool</code> | 是否显示右侧昵称 | 控制发送消息时是否显示自己昵称。 |
+| <code>isShowTimeInBubble</code> | <code>Bool</code> | 是否在气泡内显示时间 | 控制时间戳是否显示在消息气泡内部。 |
+| <code>cellSpacing</code> | <code>CGFloat</code> | 消息间距 | 控制相邻消息之间的间距。 |
+| <code>isShowSystemMessage</code> | <code>Bool</code> | 是否显示系统消息 | 控制是否显示系统通知类消息。 |
+| <code>isShowUnsupportMessage</code> | <code>Bool</code> | 是否显示不支持的消息 | 控制是否显示不支持类型的消息。 |
+| <code>horizontalPadding</code> | <code>CGFloat</code> | 水平内边距 | 控制消息列表的左右内边距。 |
+| <code>avatarSpacing</code> | <code>CGFloat</code> | 头像间距 | 控制头像与消息内容之间的间距。 |
+
+`MessageActionConfigProtocol`协议属性说明：
+
+|属性名|类型|描述|
+|---------|---------|---------|
+|`isSupportCopy`|`Bool`|消息操作菜单是否支持复制。|
+|`isSupportDelete`|`Bool`|消息操作菜单是否支持删除。|
+|`isSupportRecall`|`Bool`|消息操作菜单是否支持撤回。|
+
+### **自定义操作项**
+
+您可以采用多种方式自定义长按消息菜单项。
+
+#### 方式 1. 局部显示操作项
+
+初始化 MessageList 时，通过设置 config 中的 `isSupportCopy`、`isSupportDelete`、`isSupportRecall`显示操作项：
+``` swift
+struct CustomMessageView: View {
+    var body: some View {
+        MessageList(
+            conversationID: "conversation_123",
+            config: ChatMessageListConfig(isSupportCopy:false)
+        )
+    }
+}
+```
+
+#### 方式 2. 局部增加操作项
+
+初始化 MessageList 时传入 `customActions`，MessageList 内部会在默认的 action 底部添加您增加的自定义选项：
+``` swift
+struct CustomMessageView: View {
+    var body: some View {
+        MessageList(
+            conversationID: "conversation_123",
+            // 新增自定义操作
+            customActions: [
+                MessageCustomAction(title: "Share", iconName: "forward_icon_figma", systemIconFallback: "square.and.arrow.up") { _ in
+                    print("share Message")
+                }
+            ]
+        )
+    }
+}
+```
+
+#### **方式 3. 全局配置操作项**
+
+通过 `AppBuilderConfig` 进行全局配置：
+``` swift
+// 在应用启动时配置
+AppBuilderConfig.shared.messageActionList = [
+    .copy,      // 支持复制
+    .delete,    // 支持删除
+    .recall     // 支持撤回
+]
+
+// 接下来再初始化 MessageList，所有的 MessageList 都会遵守上面的配置
+MessageList(
+    conversationID: "conversation_123"
+)
+```
+
+> **注意：**
+>
+
+> 局部配置的优先级大于全局配置。
+>
+
+自定义效果如下图所示：
+| 消息列表操作（默认选项） | 消息列表操作（隐藏<strong>复制</strong>选项） | 消息列表操作（新增<strong>分享</strong>选项） |
+| --- | --- | --- |
+|  |  |  |