前言¶

做音視頻或圖片相關需求時，常見路徑是查 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