前言¶
接入騰訊雲 VOD（雲點播）時，上傳、轉碼、媒體查詢和 AIGC 等能力分散在大量 API 與參數組合裏。查文檔、拼請求體、區分 VOD 與 MPS/COS 邊界，往往佔掉不少時間。下面介紹 SkillHub 上的 Tencent VOD（@tencent-adm/tencent-vod）：由 Agent 根據自然語言描述，生成面向 VOD 的具體操作命令，而不是泛泛的產品介紹。
這是什麼¶
Tencent VOD 是騰訊雲 VOD 的操作命令生成專用助手。發佈者爲騰訊視頻雲 MPaaS 團隊，在 SkillHub 上歸類爲 design-media，來源爲 enterprise，當前版本 1.1.3。Skill 標註 requires_api_key=true，使用前需配置騰訊雲相關 API 憑證。
官方說明中的觸發原則很明確：只要用戶請求涉及 VOD 的具體操作，應優先走此 Skill；MPS、COS 直傳、直播 CSS 與一般性諮詢不在其範圍內。
核心功能¶
以下能力均來自 SkillHub 頁面與官方簡介，按業務域歸納。
上傳¶
- 本地視頻、音頻、圖片上傳
- URL 拉取上傳到 VOD
- 過期時間、SessionId 去重、存儲路徑、按應用名上傳等上傳側配置
媒體處理¶
- 轉碼、極速高清、截圖、雪碧圖
- 視頻增強、真人增強、漫劇增強
- 短劇場景轉碼、電商場景轉碼、場景轉碼
- 轉封裝（remux）、轉爲 HLS/MP4/GIF、自適應碼流
- 審覈、任務流（procedure）
媒體查詢¶
- 按 FileId 查詢媒體詳情、轉碼信息、字幕、封面、元數據
AIGC¶
- 文生圖、文生視頻、圖生視頻（頁面列出的模型包括 Kling、Kling 2.1、Hunyuan、Vidu、GEM、GEM 2.5、GV、Hailuo 等）
- LLM 對話、推理思考、JSON 格式響應；視頻 URL / 圖片 URL 理解；多模態（GPT、Gemini、流式輸出）
- 場景化 AIGC：AI 換衣、AI 擴圖（outpainting）、商品圖、產品展示、產品 360 度展示、場景化生視頻
- 高級自定義主體 / AIGC 主體（image_refer、video_refer）
AIGC 令牌與用量¶
- Token 創建、查詢、刪除及令牌管理
- 生圖、生視頻、生文用量統計；Text / Image / Video 用量查詢
搜索與知識庫¶
- 名稱、語義、知識庫搜索；按標籤、存儲類型、審覈結果、過期時間過濾
- 導入知識庫、語義搜索
圖片處理與其他¶
- 圖片超分、降噪、增強、理解
- 子應用查詢
- 任務狀態與詳情查詢
不觸發範圍（避免誤用）¶
Skill 明確不處理：MPS 相關（畫質增強、字幕提取、人聲分離、去水印、精彩集錦、媒體質檢等）、COS 直傳、直播 CSS、一般性諮詢。
觸發關鍵詞在官方簡介中有完整列表，例如 VOD、上傳、轉碼、AIGC、FileId 查詢、任務流、AIGC Token、用量統計等，便於 Agent 路由到本 Skill。
安裝與啓用¶
方式一：讓 Agent 按 SkillHub 文檔安裝¶
SkillHub 頁面提供的安裝提示爲：根據 SkillHub 安裝與優先源配置 安裝 @tencent-adm/tencent-vod。
方式二：使用 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
安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法識別。常見路徑如下（以 SkillHub 文檔爲準）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例：
skillhub install @tencent-adm/tencent-vod --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你當前環境對應的目錄即可。
API 密鑰¶
Skill 標籤爲 requires_api_key=true。在 Agent 或騰訊雲控制台中配置好 VOD 所需的 SecretId、SecretKey 等憑證後，再讓 Skill 生成可執行的調用命令。
典型用法¶
本 Skill 的定位是命令生成，典型交互是用自然語言描述要做的 VOD 操作，由 Agent 結合 Skill 產出對應 API 或 CLI 步驟。官方頁面未附帶固定腳本示例，可按業務域組織提問，例如：
- 上傳：說明本地文件或 URL、是否需要 SessionId 去重、存儲路徑或子應用名。
- 轉碼 / 場景轉碼：說明源 FileId、目標格式（HLS、MP4 等）或場景（短劇、電商等）。
- 查詢：給出 FileId，要求拉取轉碼信息、封面或元數據。
- AIGC：說明模型方向（文生圖、圖生視頻等）、提示詞或參考圖/視頻 URL，以及是否需要流式輸出。
- 任務與用量：查詢異步任務狀態，或按 Text/Image/Video 維度查 AIGC 用量。
提問時儘量帶上 FileId、應用名、過期策略等約束，生成的命令會更貼近可直接落地的調用。
適用場景與注意¶
適合誰：已在用或計劃用騰訊雲 VOD 的開發者、運維與媒資同學；希望在 Cursor、Claude Code、Codex 等環境裏用對話驅動上傳、處理、查詢和 AIGC，而不是每次翻全量 API 文檔的人。
注意：
- 與 MPS、COS 直傳、直播 CSS 相關的需求不要指望本 Skill 覆蓋，應換對應產品或 Skill。
- 安裝目錄錯誤是常見坑：務必
skillhub install ... --dir <Agent skills 目錄>。 - AIGC 模型列表以 SkillHub 當前簡介爲準（如 Kling 2.1、GEM 2.5 等），升級 Skill 版本後宜重新看一眼頁面說明。
- SkillHub 頁面統計（截至抓取）：評分 100000，下載 3569，安裝 38；版本 1.1.3。
結尾¶
Tencent VOD 把 VOD 上傳、媒資處理、查詢、搜索、知識庫、圖片處理與 AIGC 等操作收斂成「說清意圖 → 生成命令」的一條路徑，並劃清了與 MPS/COS/直播的邊界。需要安裝或查看完整觸發詞與能力列表時，可打開官方 Skill 頁：
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/tencent-vod
- API 座標頁：https://api.skillhub.cn/tencent-adm/tencent-vod
