前言¶
接入腾讯云 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
