前言¶

做音视频或图片相关需求时，常见路径是查 MPS 文档、拼 API 参数、再把文件放进 COS、轮询 TaskId。流程长，且转码、增强、字幕、AIGC 等能力分散在不同接口里。若你已经在 Cursor、Claude Code 等环境里用 Skill 扩展 Agent，可以把「描述需求 → 选脚本 → 调云 API → 查任务」交给 Skill 内的规范与脚本，而不是每次从零对接。

下面介绍 SkillHub 上的 Tencent MPS（坐标 @tencent-adm/tencent-mps），以及安装、配置和典型用法。

这是什么¶

Tencent MPS 是面向 Agent 的 SKILL.md 格式技能包，由 腾讯视频云 MPaaS 团队 发布（SkillHub 来源：enterprise，分类 design-media）。当前 SkillHub 版本为 v1.3.2，标签 requires_api_key=true，需配置腾讯云 API 密钥与 COS 后才能实际发起处理任务。

它把腾讯云 MPS（媒体处理） 的音视频与图片处理、AI 生成、内容理解等能力，封装成 Agent 可识别的触发场景与配套 Python 脚本；涉及实际上传、转码、增强等操作时由 Agent 按 Skill 指引调用，仅咨询能力、不需要处理时 Skill 说明中明确不触发。

官方入口：

• Skill API / 资料页：https://api.skillhub.cn/tencent-adm/tencent-mps
• SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencent-mps
• 上游仓库（SkillHub 标注）：https://clawhub.ai/ollielin/tencent-mps
• 腾讯云部署说明：https://cloud.tencent.cn/document/product/862/129183

核心功能¶

以下能力均来自 SkillHub 简介与页面说明，按场景归类；具体参数与脚本名以安装后的 SKILL.md 及 references/ 为准。

视频与音频¶

• 转码：转码、压缩、格式转换、转封装；H.264 / H.265 / AV1、码率、分辨率等。
• 画质增强：画质修复、老片修复、超分、真人增强、漫剧增强、防抖、人脸保真，提升至 1080P / 2K / 4K 等。
• 音频：音频分离、人声提取、伴奏提取、去人声、降噪、音量均衡。
• 横竖转换：转横屏 / 竖屏、9:16 / 16:9、ROI 智能裁剪、AIGC 补全画面、短视频比例转换。
• 集锦与解说：精彩集锦、高光提取、自动剪辑（含体育、短剧、VLOG 等场景描述）；短剧解说、短剧混剪。
• 二创与去重：换脸、换人、视频交错；视频去重、画中画、视频扩展。
• 质检：媒体质检、画质检测、模糊 / 花屏 / 卡顿检测、音频质检。

字幕、擦除与配音¶

• 字幕：字幕提取、字幕翻译、语音识别 / 语音转文字、ASR / OCR 字幕、SRT、视频翻译。
• 擦除：去字幕、去水印、人脸模糊、车牌模糊、马赛克（视频与图片能力在 Skill 内分脚本区分）。
• 配音：语音合成 / TTS、文字转语音、AI 配音、声音克隆 / 音色复刻。

图片与电商¶

• 图增强：图片超分、美颜、降噪、色彩增强、低光照增强。
• 抠扩图：AI 抠图、去背景、透明 PNG、AI 扩图 / outpaint、图片修复。
• 图片编辑：局部重绘 / inpainting、目标检测、分镜拆图、多视角生图、换角度、水印擦除。
• 图片理解：图片 OCR、图片问答、AI 看图。
• 电商图：AI 试衣、图片换装、换模特 / 换体型、换背景、背景融合、商品套图、海报套图等。

AIGC 与文档¶

• AIGC：AI 生图 / 文生图 / 图生图、全景图；AI 生视频 / 文生视频 / 图生视频、参考视频、分镜生成；Skill 简介中提及 Kling（可灵）、Vidu、Mingmou、PixVerse、Hunyuan 等模型相关场景。
• AI 生音频：文生音效、视频生音效、文生音乐、BGM 生成、歌曲翻唱等。
• 文档生视频：PDF / PPT / Word 等文档生成视频。

内容理解、COS 与运维¶

• 多模态理解：音视频理解、视频摘要、场景识别、内容分析、对比分析多段音视频、音频理解。
• COS：上传、下载、列出 Bucket 文件、查看目录等——须使用本 Skill 自带的 COS 脚本，Skill 要求禁用 coscli、tccli、aws s3 等替代 CLI。
• 任务与用量：查询 MPS 任务 / TaskId、环境变量检查、MPS 用量查询。
• 对比：生成对比页面（Skill 提供本地对比工具脚本）。

Skill 通过 腾讯云官方 SDK（如 tencentcloud-sdk-python、cos-python-sdk-v5）调用 API；任务费用与直接调用 MPS API 一致，为后付费，详见腾讯云 计费说明 中「Skill 如何收费」一节。

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明见：https://skillhub.cn/install/skillhub.md

2、安装 Tencent MPS¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

skillhub install tencent-adm/tencent-mps --dir <你的 skills 目录>

也可在对话中让 Agent 按 SkillHub 说明安装，提示词示例（来自 SkillHub 页面）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencent-mps`。

各客户端常见 skills 路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

WorkBuddy 等可在 Skill 市场页面直接安装；亦可用 SkillHub 提供的 Zip 包，在智能体对话中要求安装（见腾讯云部署指南）。

3、前置条件（腾讯云）¶

使用前需具备（见 腾讯云 MPS Skill 部署使用指南）：

1. 已注册腾讯云账号并开通 媒体处理 MPS，完成服务相关角色授权。
2. 已开通 COS 并创建存储桶，记录桶名（如 examplebucket-1250000000）与地域（如 ap-guangzhou）；指南建议为 Skill 单独建桶并设为公有读、私有写。
3. 在访问管理获取 SecretId、SecretKey。

4、配置环境变量¶

Skill 文档要求通过用户环境自行配置密钥，不要在对话中让他人代填 SecretKey。可在 ~/.env（优先级最高）、Skill 目录下的 .env、~/.bashrc 或 ~/.profile 中设置。

检查是否配置完整：

python3 scripts/mps_load_env.py --check-only

（在 Skill 安装目录下执行；<SKILL_DIR> 即 tencent-mps 所在路径。）

必填项示例（占位符须替换为真实值，照抄会导致 AuthFailure.SecretIdNotFound 等认证失败）：

export TENCENTCLOUD_SECRET_ID="<SecretId>"
export TENCENTCLOUD_SECRET_KEY="<SecretKey>"
export TENCENTCLOUD_API_REGION="<MPS API 区域，如 ap-guangzhou>"
export TENCENTCLOUD_COS_BUCKET="<存储桶名>"
export TENCENTCLOUD_COS_REGION="<桶地域，如 ap-guangzhou>"

国际站用户可选：

export TENCENTCLOUD_MPS_ENDPOINT="mps.intl.tencentcloudapi.com"

修改 ~/.bashrc 后执行：

source ~/.bashrc

5、安装 Python 依赖¶

首次使用需在 Skill 目录安装脚本依赖：

python3 -m pip install -r scripts/requirements.txt

建议每隔一段时间执行 --upgrade 以获取新模型与新能力支持（Skill 文档说明）。

典型用法¶

配置完成后，在 Agent 对话里用自然语言描述需求即可；Agent 按 Skill 选择对应脚本（如转码 mps_transcode.py、增强 mps_enhance.py、字幕 mps_subtitle.py 等），处理对象多为 URL 或 COS 路径，异步任务可通过 Skill 提供的任务查询脚本跟踪 TaskId。

以下对话示例来自腾讯云官方部署指南，可直接复现表述方式（将 URL 或文件换成你的资源）：

视频转码压缩

帮我把这个视频转码压缩成 H265 格式
https://example.com/video.mp4

画质提升

这个短剧视频有点模糊，帮我做大模型增强，把分辨率提升到 2K

字幕与擦除（译制场景）

帮我提取这个中文视频的字幕，翻译成英文，导出SRT字幕文件给我。然后再帮我擦除这个视频上的中文字幕

AI 生图

用GEM模型帮我生成一张图：
赛博朋克风格的城市夜景，霓虹灯倒影在雨后街道上

AI 生视频

用混元帮我生成一段视频：
一片樱花林，花瓣随风飘落，阳光透过树叶洒落

说明：首次调用时安装 SDK 等依赖可能较慢；COS 相关操作应走 Skill 内置 COS 脚本，而非 coscli / tccli / aws s3。

适用场景与注意¶

适合谁

• 已在 Agent 工作流中处理媒体，希望统一走腾讯云 MPS 的团队或个人。
• 需要覆盖转码、增强、字幕、擦除、AIGC、理解、质检等长链路，又不想为每个接口单独写集成代码的场景。
• 短剧译制、电商图、文档转视频、集锦剪辑等 Skill 简介中已列出的触发场景。

限制与注意

1. 必须配置 API Key 与 COS；未设置 TENCENTCLOUD_API_REGION 时 Skill 脚本会报错退出。
2. 会产生 MPS 后付费，与 API 直调一致。
3. 合规与密钥：SecretKey 勿泄露、勿在群聊发送；擦除、换脸、去水印等能力需遵守平台与法律要求。
4. COS 路径：指南建议专用 Bucket 与合适读写策略，便于 Agent 回写结果。
5. 纯咨询：只问「支持哪些能力」且不需要实际处理时，按 Skill 设计不应触发执行脚本。

SkillHub 公开数据（截至页面展示）：enterprise 来源、v1.3.2；SkillHub 腾讯云站点显示约 4.1 万次下载、AI 评分 4.7；预抓取 metadata 中还有安装量等统计，以 SkillHub 当前页面为准。

结尾¶

Tencent MPS 把腾讯云 MPS 的转码、增强、字幕、AIGC、理解、COS 与任务查询等能力收拢到一个 Agent Skill 里，适合用自然语言驱动媒体流水线。安装时记住 --dir 指向正确的 skills 目录，配齐 SecretId / SecretKey、API 区域与 COS，并用 Skill 自带脚本做环境与 COS 操作。

官方 Skill 地址：https://api.skillhub.cn/tencent-adm/tencent-mps