@tencentcloud/sdk-mcp 1.6.4 → 1.6.5

package/resource/knowledge/livekit/core-sdk/api-reference/vue/capability-matrix.md

@@ -0,0 +1,82 @@
+# AtomicX Core Web (Vue) 能力矩阵
+
+本文用于说明 `knowledge/livekit/core-sdk/api-reference/vue/` 在 MCP 知识库中的能力边界。
+
+## 当前能力概览
+
+支持的 state（来自 `index.md`）：
+- `LoginState`
+- `DeviceState`
+- `LiveListState`
+- `LiveSeatState`
+- `LiveAudienceState`
+- `LiveMonitorState`
+- `CoGuestState`
+- `CoHostState`
+- `BattleState`
+- `BarrageState`
+- `MessageListState`
+- `MessageInputState`
+- `MessageActionState`
+- `ConversationListState`
+- `ContactListState`
+- `C2CSettingState`
+- `GroupSettingState`
+- `VideoMixerState`
+- `VirtualBackgroundState`
+- `ASRState`
+- `SearchState`
+- `SeatStore`
+
+## 能力矩阵
+
+### 1. 参照 Android 13 个 Store 逐项对照
+
+| 能力（Android Store） | Android Core | Web (Vue) Core | 替代路径 |
+| --- | --- | --- | --- |
+| 登录管理 `LoginStore` | ✅ | ✅ | 直接参考 `index.md` 的 `LoginState` |
+| 设备状态 `DeviceStore` | ✅ | ✅ | 直接参考 `index.md` 的 `DeviceState`（web 端粒度更细：mic / camera / speaker / screen / network） |
+| 直播列表 `LiveListStore`（android 无独立 store，能力由其他 store 提供） | ⚠️ 间接 | ✅ | 直接参考 `index.md` 的 `LiveListState`（web 端独立 state，接口更完整：`createLive` / `joinLive` / `fetchLiveList` 等） |
+| 麦位管理 `LiveSeatStore` | ✅ | ✅ | 直接参考 `index.md` 的 `LiveSeatState`（web 端额外提供 `SeatStore` 底层存储） |
+| 观众管理 `LiveAudienceStore` | ✅ | ✅ | 直接参考 `index.md` 的 `LiveAudienceState` |
+| 连麦嘉宾 `CoGuestStore` | ✅ | ✅ | 直接参考 `index.md` 的 `CoGuestState` |
+| 连麦主播 `CoHostStore` | ✅ | ✅ | 直接参考 `index.md` 的 `CoHostState` |
+| PK 对战 `BattleStore` | ✅ | ✅ | 直接参考 `index.md` 的 `BattleState` |
+| 弹幕 `BarrageStore` | ✅ | ✅ | 直接参考 `index.md` 的 `BarrageState` |
+| 音效 `AudioEffectStore` | ✅ | ❌ 不支持 | 当前 Web Core 暂无该能力；若需音效处理，建议使用 Web 端 Web Audio API 自实现 |
+| 礼物 `GiftStore` | ✅ | ❌ 不支持 | 当前 Web Core 暂无礼物能力；如需礼物打赏，建议参考 Web 端自定义消息方案 |
+| 点赞 `LikeStore` | ✅ | ❌ 不支持 | 当前 Web Core 暂无点赞能力；如需点赞交互，建议自行接入 |
+| 相机视图 `CameraView` | ✅ | ❌ 不支持 | 当前 Web Core 暂无独立相机视图组件；如需本地预览，使用 Web 原生 `<video>` 标签 + TRTC 原生 SDK |
+| 主播核心视图 `LiveCoreView` | ✅ | ❌ 不支持 | 当前 Web Core 暂无统一主视图；推荐使用 `TUILiveRoom` / `TUIPlayer` 等预制 UI 组件 |
+
+### 2. Web 端独有 state（Android 参照标准外）
+
+下列 state 在 Web (Vue) 端独立存在，Android / iOS / Flutter Core **未提供对应 store**。如需在多端保持一致的体验，需要分别在 Web 端实现，**禁止直接套用其他平台的 API**。
+
+| Web 独有能力 | 对应 state | Android Core 对应情况 |
+| --- | --- | --- |
+| 直播监控 `LiveMonitorState` | 支持 | ❌ Android Core 无对应 store |
+| 视频混流 `VideoMixerState` | 支持 | ❌ Android Core 无对应 store |
+| 虚拟背景 `VirtualBackgroundState` | 支持 | ❌ Android Core 无对应 store |
+| 语音识别 `ASRState` | 支持 | ❌ Android Core 无对应 store |
+| 全局搜索 `SearchState` | 支持 | ❌ Android Core 无对应 store |
+| 消息列表 `MessageListState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 消息输入 `MessageInputState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 消息操作 `MessageActionState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 会话列表 `ConversationListState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 联系人列表 `ContactListState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 单聊设置 `C2CSettingState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+| 群聊设置 `GroupSettingState` | 支持 | ❌ Android Core 无对应 store；属于 IM / Chat 域 |
+
+## 回答口径
+
+当用户询问 Web (Vue) AtomicX Core 是否支持上述 ❌ 能力时：
+1. 必须先明确回答 **不支持**；
+2. 必须说明这是当前 Web Core 文档树中的能力边界，而不是“暂时没找到示例”；
+3. 禁止输出 Web Core 下的伪造 API 调用步骤；
+4. 仅可提供当前平台已支持的替代路径，例如使用 Web 原生 API / 预制 UI 组件；若无明确替代方案，应直接说明暂无可执行路径。
+
+当用户询问其他平台（Android / iOS / Flutter）的 ❌ 能力在 Web 端是否可用时：
+1. **必须先回答 web 端不支持**（如上表所示）；
+2. **禁止反推**其他平台该能力在 Web 端存在等价 store；
+3. 即使 Web 端 `index.md` 中存在名称相近的 state（如 `MessageListState`），也属于 IM / Chat 域而非 Live Core 域，**不要混为一谈**。

package/resource/knowledge/livekit/core-sdk/{voice/android/voice-audio-effect.md → features/android/audio-effect.md}

@@ -44,7 +44,6 @@ val deviceStore = DeviceStore.shared()
 
 > **注意：**
 >
-
 > 耳返功能通常需要连接耳机才能正常工作。
 >
 
@@ -170,7 +169,6 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 
 > **重要：**
 >
-
 > `AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 
@@ -196,7 +194,7 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 |**Store/Component**|**功能描述**|**API 文档**|
 |---------|---------|---------|
 |**AudioEffectStore**|音效管理：进行音效设置，并获取实时音效状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-audio-effect-store/index.html)|
-|**DeviceStore **|设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html)|
+|**DeviceStore** |设备管理：进行摄像头、麦克风操作，并获取实时设备状态。|[API 文档](https://tencent-rtc.github.io/TUIKit_Android/-atomic-x%20-core%20-a-p-i/io.trtc.tuikit.atomicxcore.api.device/-device-store/index.html)|
 
 ## 常见问题
 
@@ -209,7 +207,7 @@ audioEffectStore.setAudioReverbType(AudioReverbType.NONE)
 这是一个非常重要且易混淆的概念，区别如下：
 - **人声音量 (CaptureVolume)：**通过 `DeviceStore.setCaptureVolume()` 设置**。它决定了观众**能听到的您的声音大小。
 
-- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.setVoiceEarMonitorVolume()`** 设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
+- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.setVoiceEarMonitorVolume()` **设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 

package/resource/knowledge/livekit/core-sdk/{live/android/live-barrage.md → features/android/barrage.md}

@@ -471,7 +471,7 @@ class BarrageViewHolder(
 在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
 - 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
 
-   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+   左侧导航栏选择**应用管理** > **功能配置** > **LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
 
 - 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 

package/resource/knowledge/livekit/core-sdk/{live/android/live-base-beauty.md → features/android/base-beauty.md}

@@ -96,7 +96,7 @@ class BeautyManager() {
 #### 实现方式:
 1. **获取强度值**：从 UI 控件（例如 `SeekBar`）获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 SeekBar 的 `0 - 100`）映射到 `0 - 9` 的范围。
 
-2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:) `来设置磨皮、美白、红润的强度。
+2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 来设置磨皮、美白、红润的强度。
 
 #### 代码示例:
 ``` kotlin

package/resource/knowledge/livekit/core-sdk/{voice/android/voice-gift.md → features/android/gift.md}

@@ -29,7 +29,6 @@
 
 > **说明：**
 >
-
 > 使用**礼物系统**要求开通TUILiveKit **多人连麦版**、**大规模直播版**，不同套餐中可配置的礼物数量有所不同，详细参见 功能与计费说明 中的**礼物系统**说明。
 >
 
@@ -100,7 +99,7 @@ class GiftManager(
 ```
 
 #### 礼物列表结构体参数
-- `GiftCategory`**参数说明**
+- `GiftCategory` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|
@@ -110,7 +109,7 @@ class GiftManager(
    |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
    |`giftList`|`List`|该分类下包含的 Gift 礼物对象数组。|
 
-- `Gift`** 参数说明**
+- `Gift` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|

package/resource/knowledge/livekit/core-sdk/{live/android/live-live-list.md → features/android/live-list.md}

@@ -390,7 +390,7 @@ class LiveFeedActivity : AppCompatActivity() {
 
 #### 实现方式
 
-主播端将当前商品的结构化信息（建议使用 **JSON **格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListStore.liveState.currentLive`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
+主播端将当前商品的结构化信息（建议使用 **JSON** 格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListStore.liveState.currentLive`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
 
 #### 代码示例
 ``` kotlin

package/resource/knowledge/livekit/core-sdk/{live/flutter/live-audio-effect.md → features/flutter/audio-effect.md}

@@ -45,7 +45,6 @@ class _AudioEffectPanelWidgetState {
 
 > **注意：**
 >
-
 > 耳返功能通常需要连接耳机才能正常工作。
 >
 
@@ -330,7 +329,6 @@ class ReverbWidget extends StatelessWidget {
 
 > **重要：**
 >
-
 > AudioEffectStore 和 DeviceStore 是单例，即音效和设备设置会全局生效，如果您不希望当前直播间的设置影响到之后创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 

package/resource/knowledge/livekit/core-sdk/{voice/flutter/voice-barrage.md → features/flutter/barrage.md}

@@ -376,7 +376,7 @@ class _BarrageWidgetState extends State<BarrageWidget> {
 
 SDK 会以极高频率返回完整的弹幕列表。如果每次都重建 UI，主线程会被密集的 UI 布局和渲染操作阻塞，导致界面卡顿。
 
-#### **优化方案: **批处理与流量削峰 (Batch Processing & Debouncing)
+#### **优化方案:** 批处理与流量削峰 (Batch Processing & Debouncing)
 
 不必响应每一次的数据更新，而是设定一个时间阈值（例如300毫秒）。只在距离上次 UI 刷新超过这个阈值后，才执行下一次刷新操作。这能将每秒数十次的 UI 重绘，降低到每秒3-4次，极大提升流畅度。
 ``` java
@@ -491,7 +491,7 @@ void _refreshUIIfNeeded() {
 在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
 - 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
 
-   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+   左侧导航栏选择**应用管理** > **功能配置** > **LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
 
 - 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
@@ -499,7 +499,7 @@ void _refreshUIIfNeeded() {
 
    进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
-   **步骤2：客户端无感获取 **
+   **步骤2：客户端无感获取**
 
    完成上述配置后，您的客户端代码**无需做任何改动**。
 

package/resource/knowledge/livekit/core-sdk/{voice/flutter/voice-gift.md → features/flutter/gift.md}

@@ -96,7 +96,7 @@ class GiftManager {
 ```
 
 #### 礼物列表结构体参数
-- `GiftCategory`**参数说明**
+- `GiftCategory` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|
@@ -106,7 +106,7 @@ class GiftManager {
    |`extensionInfo`|`Map<String, String>`|扩展信息字段。|
    |`giftList`|`List<Gift>`|该分类下包含的 Gift 礼物对象数组。|
 
-- `Gift`**参数说明**
+- `Gift` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|

package/resource/knowledge/livekit/core-sdk/{voice/flutter/voice-room-list.md → features/flutter/live-list.md}

@@ -715,7 +715,7 @@ class _ProductCardWidgetState extends State<ProductCardWidget> {
 为了保证系统的稳定和高效，`metaData` 的使用遵循以下规则：
 - **权限**：只有房主和管理员可以调用 `updateLiveMetaData`。普通观众没有权限。
 
-- **数量与大小限制： **
+- **数量与大小限制：**
 
   - 单个房间最多支持 **10** 个 key。
 

package/resource/knowledge/livekit/core-sdk/{voice/ios/voice-audience-list.md → features/ios/audience-list.md}

@@ -18,7 +18,7 @@
 |**核心概念**|**类型**|**核心职责与描述**|
 |---------|---------|---------|
 |`LiveUserInfo`|struct|代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。|
-|`LiveAudienceState`|struct|代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo] `数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。|
+|`LiveAudienceState`|struct|代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo]` 数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。|
 |`LiveAudienceEvent`|enum|代表观众动态的实时事件。分为 `.onAudienceJoined`（观众加入） 和 `.onAudienceLeft`（观众离开）两种，用于实现对观众列表的增量更新。|
 |`LiveAudienceStore`|class|这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `liveAudienceEventPublisher` 来接收实时动态。|
 

package/resource/knowledge/livekit/core-sdk/{voice/ios/voice-audio-effect.md → features/ios/audio-effect.md}

@@ -45,7 +45,6 @@ let deviceStore = DeviceStore.shared
 
 > **注意：**
 >
-
 > 耳返功能通常需要连接耳机才能正常工作。
 >
 
@@ -156,7 +155,6 @@ audioEffectStore.setAudioReverbType(type: .none)
 
 > **重要：**
 >
-
 > `AudioEffectStore` 和 `DeviceStore` 是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
 >
 
@@ -194,7 +192,7 @@ audioEffectStore.setAudioReverbType(type: .none)
 这是一个非常重要且易混淆的概念，区别如下：
 - **人声音量 (CaptureVolume)：**通过 `DeviceStore.setCaptureVolume()` 设置**。它决定了观众**能听到的您的声音大小。
 
-- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.setVoiceEarMonitorVolume()`** 设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
+- **耳返音量 (EarMonitorVolume)：**通过 `AudioEffectStore.setVoiceEarMonitorVolume()` **设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 

package/resource/knowledge/livekit/core-sdk/{voice/ios/voice-barrage.md → features/ios/barrage.md}

@@ -412,7 +412,7 @@ class BarrageCell: UITableViewCell {
 在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
 - 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
 
-   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+   左侧导航栏选择**应用管理** > **功能配置** > **LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
 
 - 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
@@ -420,7 +420,7 @@ class BarrageCell: UITableViewCell {
 
    进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
-   **步骤2：客户端无感获取 **
+   **步骤2：客户端无感获取**
 
    完成上述配置后，您的客户端代码**无需做任何改动**。
 

package/resource/knowledge/livekit/core-sdk/{live/ios/live-base-beauty.md → features/ios/base-beauty.md}

@@ -73,7 +73,7 @@ class BeautyManager {
 #### 实现方式
 1. **获取强度值**：从 UI 控件（例如 `UISlider`）获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值（例如 UISlider 的 `0.0 - 1.0`）映射到 `0 - 9` 的范围。
 
-2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:) `来设置磨皮、美白、红润的强度。
+2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 来设置磨皮、美白、红润的强度。
 
 #### 代码示例
 ``` swift

package/resource/knowledge/livekit/core-sdk/{live/ios/live-gift.md → features/ios/gift.md}

@@ -18,7 +18,7 @@
 |**核心概念**|**类型**|**核心职责与描述**|
 |---------|---------|---------|
 |`Gift`|`struct`|代表一个具体的礼物数据模型。包含了礼物的 ID、名称、图标地址、动画资源地址 (resourceURL) 和价格 (coins) 等。|
-|`GiftCategory`|`struct`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift **列表。|
+|`GiftCategory`|`struct`|代表一个礼物分类，例如“热门”、“豪华”等。它包含了分类的名称以及该分类下的 **Gift** 列表。|
 |`GiftState`|`struct`|代表礼物模块的当前状态。其核心属性 usableGifts 是一个 [GiftCategory] 数组，存储了从服务端拉取到的完整礼物列表。|
 |`GiftEvent`|`enum`|代表直播间内发生的礼物事件。目前只有 .onReceiveGift，当有任何人（包括自己）调用发送礼物接口时，房间内所有人都会收到此事件。|
 |`GiftStore`|`class`|这是与礼物功能交互的核心管理类。通过它，您可以拉取礼物列表、调用发送礼物接口，并通过订阅其 giftEventPublisher 来接收礼物事件。|
@@ -29,7 +29,6 @@
 
 > **说明：**
 >
-
 > 使用**礼物系统**要求开通TUILiveKit **多人连麦版**、**大规模直播版**，不同套餐中可配置的礼物数量有所不同，详细参见 功能与计费说明 中的**礼物系统**说明。
 >
 
@@ -44,9 +43,9 @@
 #### 实现方式:
 1. **获取实例**：使用 `GiftStore.create(liveID:)` 获取与当前直播间绑定的 `GiftStore` 实例。
 
-2. **订阅事件**：订阅 `giftStore.giftEventPublisher` 以接收 `.onReceiveGift `事件。
+2. **订阅事件**：订阅 `giftStore.giftEventPublisher` 以接收 `.onReceiveGift` 事件。
 
-3. **订阅状态**：订阅 `giftStore.state` 以获取 `usableGifts `礼物列表。
+3. **订阅状态**：订阅 `giftStore.state` 以获取 `usableGifts` 礼物列表。
 
 #### 代码示例:
 ``` swift
@@ -106,7 +105,7 @@ class GiftManager {
    |`extensionInfo`|`[String: String]`|扩展信息字段。|
    |`giftList`|`[`[`Gift`](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/gift)`]`|该分类下包含的 Gift 礼物对象数组。|
 
-- `Gift`** 参数说明**
+- `Gift` **参数说明**
 
    |**参数**|**类型**|**描述**|
    |---------|---------|---------|
@@ -194,7 +193,7 @@ extension GiftManager {
 
 您需要自定义直播间可用的礼物种类、分类、名称、图标、价格以及动画效果，以满足运营需求和品牌特色。
 
-#### **实现方式 **
+#### **实现方式**
 1. **服务端配置**：使用 LiveKit 服务端 REST API 管理礼物信息、分类、多语言等。请参考 [礼物配置指引文档](https://cloud.tencent.com/document/product/647/121321)。
 
 2. **客户端拉取**：在客户端调用 `refreshUsableGifts` 获取配置数据。
@@ -272,7 +271,7 @@ extension GiftManager {
    ```
 2. **监听礼物事件**：订阅 `GiftStore` 的 `giftEventPublisher`。
 
-3. **解析并播放**：当收到 `.onReceiveGift `事件时，检查 `gift.resourceURL `是否有效且指向一个 SVGA 文件。如果是，则使用 `SVGAParser` 解析 URL，并将解析后的 `SVGAVideoEntity` 交给 `SVGAPlayer` 实例播放。
+3. **解析并播放**：当收到 `.onReceiveGift` 事件时，检查 `gift.resourceURL` 是否有效且指向一个 SVGA 文件。如果是，则使用 `SVGAParser` 解析 URL，并将解析后的 `SVGAVideoEntity` 交给 `SVGAPlayer` 实例播放。
 
 #### 代码示例
 ``` swift
@@ -342,11 +341,11 @@ class LiveRoomViewController: UIViewController, SVGAPlayerDelegate {
 
 2. **获取信息**：收到 `.onReceiveGift` 事件后，提取发送者 sender、礼物 gift 和数量 count。
 
-3. **获取弹幕 Store**：使用 `BarrageStore.create(liveID:) `获取与当前房间绑定的实例。
+3. **获取弹幕 Store**：使用 `BarrageStore.create(liveID:)` 获取与当前房间绑定的实例。
 
 4. **拼接消息**：创建一条 `Barrage` 结构体，设置 `messageType = .text`，textContent 为拼接好的字符串（例如 “[`sender.userName`] 送出了 [`gift.name`] x [`count`]”）。
 
-5. **本地插入**：调用 `barrageStore.appendLocalTip(message: giftTip) `将消息插入本地列表。
+5. **本地插入**：调用 `barrageStore.appendLocalTip(message: giftTip)` 将消息插入本地列表。
 
 #### 代码示例
 ``` swift

package/resource/knowledge/livekit/core-sdk/{live/ios/live-live-list.md → features/ios/live-list.md}

@@ -18,7 +18,7 @@
 |**核心概念**|**类型**|**核心职责与描述**|
 |---------|---------|---------|
 |`LiveInfo`|`struct`|代表一个直播间的所有信息模型。包含了直播 ID (`liveID`)、名称 (`liveName`)、房主信息 (`liveOwner`) 以及自定义元数据 (`metaData`) 等。|
-|`LiveListState`|`struct`|代表直播列表模块的当前状态。其核心属性 liveList 是一个 `[LiveInfo] `数组，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。|
+|`LiveListState`|`struct`|代表直播列表模块的当前状态。其核心属性 liveList 是一个 `[LiveInfo]` 数组，存储了拉取到的直播列表；`currentLive` 则代表用户当前所在的直播间信息。|
 |`LiveListEvent`|`enum`|代表直播房间的全局事件。分为 `.onLiveEnded` (直播结束) 和 `.onKickedOutOfLive` (被踢出直播) 两种，用于处理关键的房间状态变更。|
 |`LiveListStore`|`class`|这是与直播列表和房间生命周期交互的核心管理类。它是一个全局单例 (shared)，负责所有直播房间的创建、加入、信息更新等操作。|
 
@@ -306,7 +306,7 @@ class LiveFeedViewController: UIViewController, UICollectionViewDataSource, UICo
 
 #### 实现方式
 
-主播端将当前商品的结构化信息（建议使用 **JSON **格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListStore.state`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
+主播端将当前商品的结构化信息（建议使用 **JSON** 格式）通过 `updateLiveMetaData` 接口设置到一个自定义的 key（例如 "`product_info`"）中。**AtomicXCore** 会将这个变更实时同步给所有观众。观众端只需订阅 `LiveListStore.state`，监听 `metaData` 的变化，一旦发现 `product_info` 的值更新，就解析其中的 JSON 数据并刷新商品卡片 UI。
 
 #### 代码示例
 ``` swift

package/resource/knowledge/livekit/core-sdk/{voice/uni-app/voice-audio-effect.md → features/uni-app/audio-effect.md}

@@ -35,7 +35,6 @@ useDeviceState(liveID)
 
 > **注意：**
 >
-
 > 耳返功能通常需要连接耳机才能正常工作。
 >
 
@@ -89,7 +88,7 @@ watch(earMonitorVolume, (newVolume) => {
 当主播希望调节自己的上行采集音量大小时，调用 `DeviceState` 的 `setCaptureVolume(volume: )` 方法传入音量值即可。
 
 #### 实现方式:
-1. **设置采集音量值**：您可自行实现调节音量的功能，并将 `UI `上的值映射成音量值后调用 `setCaptureVolume(volume: 80)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
+1. **设置采集音量值**：您可自行实现调节音量的功能，并将 `UI` 上的值映射成音量值后调用 `setCaptureVolume(volume: 80)`。请注意，该接口接收的参数范围是 `[0, 150]，`所以您需要将 UI 控件的值映射到 `0 - 150` 的范围。
 
 2. **监听状态更新 UI**：您可以订阅实时的音量状态值更新 UI。
 
@@ -187,7 +186,7 @@ const setAudioReverbType = () => {
 这是一个非常重要且易混淆的概念，区别如下：
 - **人声音量 (CaptureVolume)：**通过 `setCaptureVolume()` 设置**。它决定了观众**能听到的您的声音大小。
 
-- **耳返音量 (EarMonitorVolume)：**通过 `setVoiceEarMonitorVolume()`** 设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
+- **耳返音量 (EarMonitorVolume)：**通过 `setVoiceEarMonitorVolume()` **设置。它只**决定了**您自己**在耳机里听到的监听声音大小，**不会**影响观众。
 
 ### **新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？**
 

package/resource/knowledge/livekit/core-sdk/{voice/uni-app/voice-barrage.md → features/uni-app/barrage.md}

@@ -357,7 +357,7 @@ SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使
 在控制台的配置页面中，找到**查看直播间历史消息**选项，修改其配置（最大支持 **50** 条消息）。
 - 若您的应用在 [实时音视频控制台](https://console.cloud.tencent.com/trtc/app) 创建，配置步骤如下：
 
-   左侧导航栏选择**应用管理** > **功能配置 **>** LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
+   左侧导航栏选择**应用管理** > **功能配置** > **LiveKit 功能**，在**应用管理**选择对应的应用后，单击**查看直播间历史消息 > 编辑**。
 
 - 若您的应用在 [即时通信 IM 控制台](https://console.cloud.tencent.com/im/rtc-config) 创建，配置步骤如下：
 
@@ -365,7 +365,7 @@ SDK 返回的全量 `messageList` 会在长时间直播中无限增长，即使
 
    进入 **LiveKit 功能配置**后，单击**查看直播间历史消息** > **编辑**。
 
-   **步骤2：客户端无感获取 **
+   **步骤2：客户端无感获取**
 
    完成上述配置后，您的客户端代码**无需做任何改动**。
 

package/resource/knowledge/livekit/core-sdk/features/uni-app/base-beauty.md

@@ -0,0 +1,145 @@
+`BaseBeautyState` 是 `AtomicXCore` 中负责管理人像基础美颜效果的模块。通过它，您可以轻松为您的直播或通话应用添加自然的美颜效果。
+
+## 核心功能
+- **磨皮效果调节**：设置磨皮强度 (0-9)。
+
+- **美白效果调节**：设置美白强度 (0-9)。
+
+- **红润效果调节**：设置红润强度 (0-9)。
+
+- **效果重置**：一键恢复所有美颜参数至默认值。
+
+- **状态监听**：实时获取当前生效的美颜参数。
+
+## 实现步骤
+
+### 步骤1：组件集成
+
+请参考 开播与观看 集成 **AtomicXCore**，并完成 **LiveCoreView** 的接入。
+
+### 步骤2：获取实例并监听状态
+
+获取 `BaseBeautyState` 的全局单例，并监听对应数据来实时获取当前的美颜参数状态。
+
+#### 实现方式
+1. **获取单例**：通过 `useBaseBeautyState` 来获取当前实例。
+
+2. **监听状态**：通过监听 `BaseBeautyState` 中的响应式数据来驱动 `UI` 的更新。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+import { watch } from 'vue';
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { whitenessLevel, ruddyLevel, smoothLevel } = useBaseBeautyState(liveID)
+
+// 2. 监听 whitenessLevel、ruddyLevel、smoothLevel 的实时变更，用于驱动 UI 变更
+watch( whitenessLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+
+watch( ruddyLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+
+watch( smoothLevel, (newVal, oldVal) => {
+    console.log(newVal)
+})
+```
+
+### 步骤3：设置美颜参数
+
+当用户拖动美颜滑块或点击预设按钮时，调用相应的接口设置美颜强度。
+
+#### 实现方式
+1. **获取强度值**：从 UI 控件获取用户设定的强度值。请注意，SDK 接口接收的参数范围是 `[0, 9]`，其中 `0` 表示关闭效果，`9` 表示效果最明显。您需要将 UI 控件的值映射到 `0 - 9` 的范围。
+
+2. **调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 来设置磨皮、美白、红润的强度。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { setSmoothLevel, setWhitenessLevel, setRuddyLevel } = useBaseBeautyState(liveID)
+
+// 2. 调用接口
+const setBeautyLevel = () => {
+    setSmoothLevel({
+      smoothLevel: 9
+    })
+    setWhitenessLevel({
+      whitenessLevel: 9
+    })
+    setRuddyLevel({
+      ruddyLevel: 9
+    })
+}
+```
+
+### 步骤4：重置美颜效果
+
+当用户点击“重置”或“关闭美颜”按钮时，将所有美颜参数恢复到默认值（通常是0）。
+
+#### 实现方式
+
+**调用接口**：分别调用 `setSmoothLevel(smoothLevel:)`、`setWhitenessLevel(whitenessLevel:)`、`setRuddyLevel(ruddyLevel:)` 并将参数设置为 0。
+
+#### 代码示例
+``` typescript
+import { useBaseBeautyState } from '@/uni_modules/tuikit-atomic-x/state/BaseBeautyState'
+
+// 1. 通过 liveID 获取 BaseBeautyState 的实例
+const { setSmoothLevel, setWhitenessLevel, setRuddyLevel } = useBaseBeautyState(liveID)
+
+// 2. 调用接口
+const setBeautyLevel = () => {
+    setSmoothLevel({
+      smoothLevel: 0
+    })
+    setWhitenessLevel({
+      whitenessLevel: 0
+    })
+    setRuddyLevel({
+      ruddyLevel: 0
+    })
+}
+```
+
+## 功能进阶
+
+### 基础美颜与高级美颜对比
+
+AtomicXCore 也提供了高级美颜支持，以满足不同场景的需求
+
+|**对比项**|**基础美颜 (BaseBeautyState)**|**高级美颜 (TEBeautyKit 需额外集成)**|
+|---------|---------|---------|
+|核心功能|磨皮、美白、红润。|包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果。|
+|计费|免费（包含在 AtomicXCore 授权内）。|付费（需要额外购买腾讯特效 SDK License） 。|
+|集成方式|默认内置，直接使用 `BaseBeautyState`。|需要额外集成 `TEBeautyKit` 组件并进行鉴权。|
+|推荐场景|对美颜要求不高，需要快速实现基础美颜功能的场景。|对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景。|
+
+### 集成高级美颜
+
+如果您需要使用高级美颜功能，请参考 [高级美颜](https://cloud.tencent.com/document/product/616/102495) 文档进行集成。集成并成功鉴权 `TEBeautyKit` 后，您可以通过 `TEBeautyKit` 提供的接口来控制所有美颜效果。
+
+## API 文档
+
+关于 [BaseBeautyState](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BaseBeautyState) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 AtomicXCore 框架的官方 API 文档。本指南使用到的相关 Store 如下：
+
+|**State**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|BaseBeautyState|基础美颜：调节磨皮 / 美白 / 红润（0-9 级），重置美颜状态，同步效果参数。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-BaseBeautyState)|
+|DeviceState|音视频设备控制：麦克风（开关 / 音量）、摄像头（开关 / 切换 / 画质）、屏幕共享，设备状态实时监听。|[API 文档](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#module-DeviceState)|
+
+## 常见问题
+
+### 我设置了美颜参数，为什么没有效果？
+
+请检查以下几点：
+1. **摄像头是否开启**：必须先成功打开摄像头，美颜效果才能应用到视频流上。
+
+2. **是否使用了高级美颜**：如果您集成了 `TEBeautyKit` (高级美颜)，请确保您使用的是 `TEBeautyKit` 提供的接口来调节美颜。
+
+3. **参数范围**：如果您使用的是基础美颜，请确认您传入的强度值在有效的范围内 (`0` 到 `9` 之间的 float 值)。