Feedback
Skills

介绍
腾讯特效 SDK Skills 是面向腾讯特效 SDK 集成场景的结构化指引资源包，覆盖美颜、滤镜、动效贴纸、人像分割、3D 特效等核心能力。它将 SDK 领域知识直接注入 AI 编程助手的上下文，将自然语言需求转化为可执行的标准化步骤，帮助开发者高效完成 Android、iOS、Flutter 三平台的 SDK 集成。
优势
优势
说明
多平台覆盖
支持 Android、iOS、Flutter。
多种集成体系
支持纯 API 手动路线和 TEBeautyKit 官方面板路线，兼容不同业务需求。
主流音视频载体
与 TRTC、直播 SDK 深度对接。
标准化流程
内置 License 鉴权、资源下载、生命周期管理等一整套可复用执行路径。
零运行时依赖
纯静态文本资源，不引入额外运行时开销。
一站式脚本
内置面板 JSON 和套餐素材自动下载脚本，Agent 可主动替用户完成资源准备。
前置条件
使用前，请确保您使用的 AI 编程工具支持 Skills 功能，目前支持的工具包括：
CodeBuddy
Trae
Cursor
Codex
Claude Code
Claude Desktop
安装方式
Skills 资源包包含三个平台的 Skill（iOS / Android / Flutter），可根据项目需要按需导入一个或多个。
1. 单击下载 tencent-effect-skills.zip﻿
2. 解压后获得三个 Skill 目录：tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/。
3. 将需要的 Skill 目录（如 tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/）复制到对应 AI 编程工具的 Skills 存放目录下。
使用示例
以下是几种典型集成场景的描述示例，各平台（Android、iOS、Flutter）均可使用：
场景一：只集成 SDK（纯 API 手动路线）
"帮我在项目中集成腾讯特效 SDK，不需要美颜面板 UI，我自己管理视频帧处理。"
Agent 会引导您完成 License 鉴权、SDK 依赖配置、核心 API 初始化，以及视频帧的手动处理流程。
场景二：集成 TEBeautyKit（带官方面板）
"接入腾讯特效 SDK，并集成官方的美颜面板 UI。"
Agent 会走 TEBeautyKit 路线，帮您配置面板依赖、自动下载面板 JSON 资源和套餐素材，并给出面板初始化和美颜参数回调的完整代码。
场景三：集成 TEBeautyKit + TRTC
"在项目中集成 TEBeautyKit，搭配 TRTC 做实时音视频美颜。"
Agent 会走 Adapter 路线，帮您完成 TRTC 视频处理回调注册、面板与 Adapter 的绑定、美颜开关状态同步，以及旋转方向适配。
场景四：集成 TEBeautyKit + 直播
"接入 TEBeautyKit 和直播 SDK，实现推流美颜。"
Agent 会引导您完成直播 SDK 的视频处理回调注册、TEBeautyKit 与直播推流的联合配置，并提醒生命周期管理和 License 鉴权顺序。
触发关键词
当您的提问中包含以下关键词时，AI Agent 会自动激活此 Skills：
中文业务关键词：腾讯特效、美颜 SDK、滤镜、动效贴纸、人像分割、3D 特效、美颜面板、手势点位、身体点位、套餐包、套餐切换。
平台 / 类名关键词：
Android：XmagicApi、TEBeautyTRTCAdapter、TEPanelView、TEUIConfig、TEPanelViewCallback、TEBeautyKit.EffectState
iOS：XMagic、TEBeautyKit、TELicenseCheck、TRTCVideoFrameDelegate、V2TXLivePusherObserver、YTProcessInput、YTProcessOutput、TRTCAdapter、TELiveAdapter
Flutter：tencent_effect_flutter、TencentEffectApi、XmagicProcesserFactory、TEBeautyPanelView、TEResConfig
SDK 套餐 / 依赖关键词：TencentEffect_S1-07、TencentEffect_S1、TencentEffect_A1、pod TencentEffect_、pod TEBeautyKit、te_sub_spec
Skills 内容结构
Android
iOS
Flutter
tencent-effect-android/
   ├── SKILL.md                              # Android Skills 主文件
   ├── examples/
   │   ├── standalone/                       # 独立相机示例
   │   ├── trtc/                             # TRTC 示例
   │   └── mlvb/                             # 直播 SDK 示例
   ├── references/
   │   ├── 00-overview.md                    # 套餐选择与 License 申请
   │   ├── 01-license.md                     # License 初始化
   │   ├── 02-api-xmagicapi.md               # XmagicApi 核心 API
   │   ├── 10-standalone.md                  # 独立相机集成
   │   ├── 11-with-trtc.md                   # TRTC 集成（Adapter + 手动）
   │   ├── 12-with-mlvb.md                   # 直播 SDK 集成
   │   ├── 13-beauty-panel-assets.md         # 面板资源处理
   │   ├── 14-suite-resources.md             # 套餐素材处理
   │   ├── 20-atomic-abilities.md            # 原子能力（分割/点位）
   │   ├── 21-advanced-mode.md               # 性能调优与高级模式
   │   └── 30-faq-troubleshooting.md         # 常见问题排错
   └── snippets/
       ├── license-init.kt                   # License 初始化
       ├── resource-copy.kt                  # 资源拷贝到沙盒
       ├── lifecycle.kt                      # 生命周期管理
       ├── gradle-deps.txt                   # Gradle 依赖与权限
       ├── fetch-beauty-panel.sh             # 面板 JSON 下载脚本
       └── fetch-suite-resources.sh          # 套餐素材下载脚本
tencent-effect-ios/
   ├── SKILL.md                              # iOS Skills 主文件
   ├── examples/
   │   ├── standalone.md                     # 独立相机完整示例
   │   ├── trtc.md                           # TRTC 联合接入示例
   │   └── mlvb.md                           # 直播 SDK 联合接入示例
   ├── references/
   │   ├── 00-overview.md                    # 环境要求、套餐选择、Pod 依赖
   │   ├── 01-license.md                     # License 鉴权
   │   ├── 02-api-xmagic.md                  # 纯 XMagic API 说明
   │   ├── 03-tebeautykit.md                 # TEBeautyKit 体系说明
   │   ├── 10-standalone.md                  # 独立相机集成指南
   │   ├── 11-with-trtc.md                   # TRTC 联合集成指南
   │   ├── 12-with-mlvb.md                   # 直播 SDK 联合集成指南
   │   └── 30-faq-troubleshooting.md         # 常见问题排错
   └── snippets/
       ├── license-init.m                    # License 鉴权代码片段
       ├── resource-bundle.m                 # 资源目录配置
       ├── lifecycle.m                       # 生命周期管理
       ├── podfile.txt                       # Podfile 依赖示例
       ├── fetch-beauty-panel.sh             # 面板 JSON 资源下载脚本
       └── fetch-adapter.sh                  # Adapter 库下载脚本
tencent-effect-flutter/
   ├── SKILL.md                              # Flutter Skills 主文件
   ├── examples/
   │   ├── trtc/                             # trtc_cloud 示例
   │   ├── tencent-rtc-sdk/                  # tencent_rtc_sdk 示例
   │   └── live/                             # live_flutter_plugin 示例
   ├── references/
   │   ├── 00-overview.md                    # 套餐选型 + Flutter 插件引入
   │   ├── 01-license.md                     # License 鉴权（Dart 层）
   │   ├── 02-api-tencenteffectapi.md        # TencentEffectApi 完整 API
   │   ├── 11-with-trtc-cloud.md             # tencent_trtc_cloud 集成
   │   ├── 11b-with-tencent-rtc-sdk.md       # tencent_rtc_sdk 新版集成
   │   ├── 12-with-live-flutter-plugin.md    # live_flutter_plugin 集成
   │   ├── 13-beauty-panel-assets.md         # 面板资源处理
   │   ├── 14-suite-resources.md             # 套餐素材处理
   │   └── 30-faq-troubleshooting.md         # 常见问题排错
   └── snippets/
       ├── license-init.dart                 # License 初始化（Dart）
       ├── init-flow.dart                    # 完整初始化顺序
       ├── native-register-beauty-factory.md # 原生层注册 BeautyFactory
       ├── lifecycle.dart                    # 生命周期管理
       ├── pubspec.yaml.txt                  # pubspec.yaml 关键依赖
       ├── fetch-beauty-panel.sh             # 面板资源下载脚本
       └── fetch-suite-resources.sh          # 套餐素材下载脚本
优势	说明
多平台覆盖	支持 Android、iOS、Flutter。
多种集成体系	支持纯 API 手动路线和 TEBeautyKit 官方面板路线，兼容不同业务需求。
主流音视频载体	与 TRTC、直播 SDK 深度对接。
标准化流程	内置 License 鉴权、资源下载、生命周期管理等一整套可复用执行路径。
零运行时依赖	纯静态文本资源，不引入额外运行时开销。
一站式脚本	内置面板 JSON 和套餐素材自动下载脚本，Agent 可主动替用户完成资源准备。