美摄文档

简体中文

English

简体中文

English

美摄 Agent Skills ​

Agent 兼容性 ​

仓库内的 Skill 遵循开放的 Agent Skills 格式，不依赖某一家 Agent 的专属运行 API。可以通过 skills CLI 安装到 Codex、Cursor、Qoder、Claude Code，以及 市面上的主流Agent。

常用 Agent 参数如下：

Agent--agent 参数
Codexcodex
Cursorcursor
Qoderqoder
Claude Codeclaude-code

不指定 --agent 时，CLI 会检测本机已经安装的 Agent，并显示交互选择。

环境要求 ​

  • Node.js 18 或更高版本。
  • 能够运行 npx。
  • 已安装所选 Skill 需要的开发工具链，例如iOS需要Xcode，android需要Android Studio和Java等。
  • 所选 Skill 需要运行内置脚本时，已安装 Python 3.9 或更高版本。
  • 已准备对应美摄产品要求的 SDK 包、License、服务配置或签名材料。

每个产品的具体前置条件和限制以对应 Skill 内部文档为准。

查看当前可用 Skill ​

在准备使用 Skill 的项目根目录执行：

sh
npx skills add MeiShe-Skills/meishe-skills --list

也可以使用完整 GitHub 地址：

sh
npx skills add https://github.com/MeiShe-Skills/meishe-skills --list

该命令的输出是当前仓库版本所包含 Skill 的准确清单。

可用 Skill ​

下表列出本仓库当前发布的 Skill。仓库后续仍可增加新 Skill，请以 --list 的输出为准。

Skill能力目标平台
meishe-react-native-shortvideo-docking接入、配置、校验并排查官方 ShortVideo React Native 包，包括生成的 TypeScript Demo 界面、功能配置和原生桥接React Native Android、iOS 单端或双端
meishe-flutter-shortvideo-docking接入、配置、校验并排查官方 ShortVideo Flutter 插件，包括生成的 Dart Demo 界面、功能配置和平台桥接Flutter Android、iOS 单端或双端
meishe-native-ios-shortvideo-docking接入、配置、校验并排查官方 ShortVideo 原生 iOS 包（Pods-NvShortVideoEdit）：Podfile 与 Info.plist 调整、生成的 Swift 首页、功能配置，以及 License 和身份信息交接原生 iOS
meishe-native-android-shortvideo-docking接入、配置、校验并排查官方 ShortVideo 原生 Android AAR（NvShortVideoCore.aar）：Gradle 与 Manifest 接线、生成的 Java/Kotlin Demo 界面、功能配置，以及 applicationId 和 License 交接原生 Android
meishe-android-streaming-sdk-api生成、修改和排查按 API 调用 Android 流媒体 SDK 的独立 Android 工程：采集、预览、录制、时间线编辑、音频与音乐、滤镜、美颜、美妆、AR Scene、人脸网格、分割、字幕、贴纸、素材包、剪同款与模板编辑、导出Android
meishe-sdk-ios-streaming生成、接入和排查基于 NvStreamingSdkCore 的 iOS 工程：采集、录制、时间线编辑、LiveWindow 预览、字幕、贴纸、转场、音频、滤镜、主题、素材包、AR Scene、美颜、美妆、人脸检测、模板、合成与断点续导iOS
meishe-sdk-harmony-streaming生成、构建和接入基于 libNvStreamingSdkCore 的 HarmonyOS ArkTS/ETS Stage 工程：新建工程、增量接入、OHPM/Hvigor 构建、初始化、时间线与音频编辑、采集、字幕、贴纸、转场、特效参数、美颜、AR Scene、素材包、模板、合成导出和自定义 NAPI 特效HarmonyOS ArkTS/ETS
meishe-streaming-sdk-web在浏览器工程中接入、评审和排查流媒体编辑 SDK：运行时与 WASM 加载、时间线、轨道、片段、LiveWindow、字幕、贴纸、特效、转场、关键帧、模板、素材包、媒体 FS、播放、持久化和兼容性问题Web（React/Vite、Vue/Vite 或与框架无关）
meishe-web-effect-sdk-skill讲解并实现 Web EffectSDK 能力：NveEffectContext 与 NveARSceneRenderer API、相机/图片/RTC Demo、Agora 与 Zego 接入、美颜、美妆、滤镜、分割、Avatar、字幕、贴纸、素材包、WASM 加载、SharedArrayBuffer 配置和 License 校验Web 浏览器
meishe-effect-kit-android在客户已有 Android 工程中接入、扩展、排障和验收 NveEffectKit：完整或单项美肤、美型、微整形、美妆、滤镜、人脸道具、自定义特效，以及把现有 NVE 输出纹理录制到系统相册Android（已有工程）
meishe-effect-kit-ios在客户已有 Objective-C/Swift 工程中接入、扩展、修复和验收 NveEffectKit 3.16.1：美肤、美型、微整形、美妆、滤镜、人脸道具、背景分割、动画贴纸，以及把 CVPixelBuffer/OpenGL 渲染结果接入预览、录制或 RTC 消费端iOS（已有工程）
meishe-harmony-effect-skill生成或修改基于 libNvStreamingSdkCore 的 HarmonyOS ArkTS EffectSDK 集成代码：NvsEffectScheduler 相机预览、NvsEffectRenderCore buffer/离屏/编辑渲染、检测模型初始化、素材包安装、AR Scene、美颜、美妆、道具、滤镜、字幕、贴纸和转场HarmonyOS ArkTS
meishe-harmony-effect-cpp-skill生成或修改 HarmonyOS C++/NAPI EffectSDK 集成代码：CNvsEffectSdkContext 初始化、CNvsEffectRenderCore buffer 与 GPU 纹理渲染、EGL 和 XComponent NativeWindow 输出、ArkTS 到 C++ 的 NAPI 桥接、设备旋转处理，以及上述特效能力HarmonyOS C++/NAPI
meishe-shortvideo-service-reimplementation基于内置的语言无关规范，用任意语言重写单个接口、完整短视频服务或增量升级：保持 HTTP 契约、校验、业务规则、错误、数据库与存储行为、安全、顺序、事务、缓存和后台入库行为一致服务端（语言无关）
meishe-server-end-json-generate根据视频、音频、字幕、贴纸、视觉与音频特效、蒙版、转场、美颜、美妆、AR 道具和裁剪需求，生成后端美摄合成的云端合成业务 JSON；先构建并校验根节点为 <timelines> 的后端工程 XML 作为中间状态；也可校验、修复既有后端合成 XML 并转换成业务 JSON。不支持业务 JSON 转 XML、无损节点 JSON、interactpro、主题模板或其他 XML 方言服务端（云端合成）

所需外部资源与下载方式 ​

仓库内所有 Skill 都使用下方的安装命令安装。部分 Skill 还需要美摄官方包、 License、模型或素材，这些资源不随 Skill 打包：请通过 美摄开发者中心、 美摄下载页或对应产品的正式交付与 技术支持渠道获取。Skill 不会下载、伪造或替代这些资源。

Skill所需外部资源下载方式
meishe-react-native-shortvideo-dockingReact Native 插件 react-native-nvshortvideo开发者中心 → 产品及DEMO下载 → 移动端 → 短视频Demo → 下载「React Native工程」压缩包，使用其中的 react_native/react-native-nvshortvideo
meishe-flutter-shortvideo-dockingFlutter 插件 nvshortvideo同一短视频Demo入口 → 下载「Flutter工程」压缩包，使用其中的 flutter/nvshortvideo
meishe-native-ios-shortvideo-dockingnative/ios/Pods-NvShortVideoEdit 与 NvShortVideoEdit.podspec同一短视频Demo入口 → 下载「iOS App」或「iOS&Android」压缩包
meishe-native-android-shortvideo-dockingnative/android/ShortVideo/app/libs/NvShortVideoCore.aar同一短视频Demo入口 → 下载「iOS&Android」压缩包
meishe-android-streaming-sdk-apiAndroid LTS SDK 包（包含 lib、extrasdk、samples、doxygen）；美颜、美妆、AR、脸型、Avatar、手势/眼神检测和分割等能力需要人脸版本https://www.meishesdk.com/downloads → SDK下载及开发文档 → Android LTS → 下载SDK人脸版本
meishe-sdk-ios-streaming客户提供的 NvStreamingSdkCore.framework、SDK License、检测模型和素材包美摄开发者中心与产品正式交付；iOS API 文档：https://www.meishesdk.com/ios/doc_ch/html/content/index.html
meishe-sdk-harmony-streaminglibNvStreamingSdkCore HAR（@meishe/libnvstreamingsdkcore）、SDK License、模型、媒体、字体和素材包美摄开发者中心与产品正式交付；本 Skill 不携带上述任何资源
meishe-streaming-sdk-web客户交付的 NvStreamingSdk.js 与配套 WASM 文件、License 条款要求的授权数据，以及 npm 包 meishewasmloader客户 SDK 交付目录或已配置的 CDN；加载器通过 npm i meishewasmloader --save 安装
meishe-web-effect-sdk-skillNvEffectSdk.js 与配套 WASM 文件、非 localhost 部署所需的 License，以及 npm 包 meishewasmloader美摄 SDK 交付；需要匹配版本的 Skill 时访问 https://www.meishesdk.com/downloads/
meishe-effect-kit-android人脸版本 Android SDK 包；NveEffectKit AAR、SDK License、检测模型和带授权的商业素材人脸版本 SDK：https://www.meishesdk.com/downloads；AAR、License 与素材：项目正式交付、美摄技术支持或美摄商务
meishe-effect-kit-iosNveEffectKit 3.16.1 framework 与配套 core 变体、按 Bundle Identifier 签发的 SDK .lic、模型和带证书的素材美摄技术支持或商务；需要匹配版本的 Skill 时访问 https://www.meishesdk.com/downloads/
meishe-harmony-effect-skill、meishe-harmony-effect-cpp-skill技能包：meishe-harmony-effect/ 目录下的两个压缩包。外部资源：libNvStreamingSdkCore HAR 或 EffectSDK 原生库、SDK License、模型、媒体和素材包技能包：本仓库、美摄 Skills 下载包或美摄正式交付，解压后按本地路径安装（见 HarmonyOS EffectSDK 压缩包 Skill）；外部资源：美摄开发者中心与产品正式交付
meishe-shortvideo-service-reimplementation不需要 SDK、License 或服务访问，仅需脚本依赖的 Python 包在 Skill 目录执行 python -m pip install -r scripts/requirements.txt
meishe-server-end-json-generate不需要 SDK、License 或服务访问，脚本仅依赖 Python 标准库；素材路径、云资源 ID、包 UUID、字体文件和工程 URL 需来自你自己的业务数据无需下载外部资源，在 Skill 目录使用 Python 3 运行 python scripts/editor_xml.py ...

交互安装 ​

让 CLI 检测 Agent，并交互选择需要安装的 Skill：

sh
npx skills add MeiShe-Skills/meishe-skills

默认安装到当前项目。添加 --global 后安装到用户级别，可供多个项目使用：

sh
npx skills add MeiShe-Skills/meishe-skills --global

安装到指定 Agent ​

将仓库当前提供的全部 Skill 安装到一个 Agent：

sh
npx skills add MeiShe-Skills/meishe-skills \
  --skill '*' \
  --agent codex

可以把 codex 替换为 cursor、qoder、claude-code 或 CLI 支持的其他 Agent 参数。追加 --global 可进行用户级安装，追加 --yes 可跳过交互确认。

同时安装到多个 Agent：

sh
npx skills add MeiShe-Skills/meishe-skills \
  --skill '*' \
  --agent codex \
  --agent cursor \
  --agent qoder \
  --agent claude-code

将全部 Skill 安装到本地 CLI 支持的全部 Agent：

sh
npx skills add MeiShe-Skills/meishe-skills --all

安装指定 Skill ​

先执行 --list，然后选择输出中的实际名称。例如：

sh
npx skills add MeiShe-Skills/meishe-skills \
  --skill meishe-react-native-shortvideo-docking \
  --agent cursor

重复使用 --skill 可以一次安装多个指定 Skill：

sh
npx skills add MeiShe-Skills/meishe-skills \
  --skill SKILL_NAME_1 \
  --skill SKILL_NAME_2 \
  --agent claude-code

从美摄官网下载 ​

如果访问 GitHub 速度较慢或无法连接，可以前往 美摄开发者中心下载最新版美摄 Agent Skills 压缩包，并解压到本地目录。

查看下载包内包含的 Skill：

sh
npx skills add /你的绝对路径/meishe-skills --list

从本地下载包交互安装：

sh
npx skills add /你的绝对路径/meishe-skills

将本地下载包中的全部 Skill 安装到指定 Agent：

sh
npx skills add /你的绝对路径/meishe-skills \
  --skill '*' \
  --agent cursor

本地路径安装同样支持 --global、--agent、--skill、--all 和 --yes 参数。

确认安装结果 ​

查看已经安装的 Skill：

sh
npx skills list

按 Agent 筛选：

sh
npx skills list --agent codex
npx skills list --agent cursor
npx skills list --agent qoder
npx skills list --agent claude-code

只查看用户级 Skill：

sh
npx skills list --global

更新 ​

更新当前项目中的全部 Skill：

sh
npx skills update --project

更新用户级的全部 Skill：

sh
npx skills update --global

更新指定 Skill：

sh
npx skills update meishe-react-native-shortvideo-docking

注意事项 ​

  • 每个 Skill 必须完整包含自己的 SKILL.md、脚本、参考资料和资源。
  • 只使用所选 Skill 支持的官方包类型和版本。
  • 部分 Skill 绑定特定的 SDK 基线，例如 NveEffectKit 3.16.1、Web EffectSDK 3.15.1 或 Streaming SDK Web 3.16.0。如果目标工程使用更高版本 SDK，请从美摄下载页获取匹配版本的 Skill 包。
  • Skill 不会伪造包、License、模型或素材。缺少必需资源时，请提供官方包或 美摄交付的确切资源路径。
  • 遵守所选 Skill 的设备要求。移动端 SDK Demo 可能必须连接 Android 或 iOS 真机运行，不一定支持模拟器。

相关链接 ​

Copyright ©北京美摄网络科技有限公司 . All Right Reserved . 2014-2025版权所有