by 运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install alibabacloud-video-forge
镜像加速npx clawhub@latest install alibabacloud-video-forge --registry https://cn.longxiaskill.com 镜像可用
技能文档
阿里云视频Forge是一站式视频处理服务，通过阿里云媒体处理服务（MPS）实现封面生成、多分辨率转码、内容审核等功能。
预检查：
- 先决条件：Aliyun CLI >= 3.3.3，运行
aliyun version验证版本，如果未安装或版本过低，运行curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash更新，或者参考references/cli-installation-guide.md安装指南。 - 先决条件：Aliyun CLI插件更新，[必须]运行
aliyun configure set --auto-plugin-install true启用自动插件安装，[必须]运行aliyun plugin update确保现有插件保持最新。 - 先决条件：AI-Mode配置，[必须]在使用aliyun CLI命令前配置AI-Mode：
aliyun configure ai-mode enable、aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-video-forge"、aliyun configure ai-mode disable。 - 先决条件：Python >= 3.10，运行
python3 --version验证。 - 先决条件：阿里云凭证，运行
aliyun configure list检查凭证状态，如果没有有效配置，通过aliyun configure配置。参考references/security-guidelines.md凭证安全规则。
快速开始：
- 最简单方式 - 一键视频处理：
python scripts/video_workflow.py --input /path/to/video.mp4。
- 方法2：检查环境python scripts/health_check.py。
- 方法3：手动执行步骤python scripts/oss_upload.py --local-file video.mp4 --oss-key input/video.mp4、python scripts/mps_transcode.py --oss-object input/video.mp4 --preset multi、python scripts/mps_audit.py --oss-object input/video.mp4。常见场景：
- 场景1：Bilibili视频发布
python scripts/video_workflow.py --input my_video.mov --preset 720p --generate-cover --scenes porn terrorism ad。 - 场景2：UGC内容审核
python scripts/mps_audit.py --oss-object /input/user_uploaded.mp4。 - 场景3：多分辨率转码
python scripts/mps_transcode.py --oss-object /input/course_video.mp4 --preset multi --output-prefix output/course_2024/。
场景描述： 此技能支持视频分发场景：转码 - Narrowband HD压缩的多分辨率转码，内容审核 - 自动检测敏感内容（色情、恐怖主义、广告），截图 - 生成封面图和sprite表，防盗版 - 配置加密保护内容。
架构： OSS Bucket + MPS Pipeline + 转码模板 + 审核服务。
组件：
- OSS：存储视频和输出。
- MPS Pipeline：任务队列管理。
- 转码模板：Narrowband HD、标准预设。
- 审核：自动内容安全检查。
目标用户： 视频平台、内容创作者、企业培训、教育平台。
功能概述：
参考references/capability-overview.md详细功能树和自动管道管理。
环境变量：
ALIBABA_CLOUD_REGION- 服务区域（默认：cn-shanghai）。ALIBABA_CLOUD_OSS_BUCKET- OSS Bucket名称。ALIBABA_CLOUD_OSS_ENDPOINT- OSS端点。ALIBABA_CLOUD_MPS_PIPELINE_ID- MPS Pipeline ID（可选，未设置时自动选择）。
安全注意事项：
凭证通过阿里云默认凭证链管理。使用aliyun configure命令配置凭证。永远不要在脚本或命令中直接处理AK/SK。
安全指南：
参考references/security-guidelines.md完整安全指南和凭证管理最佳实践。
SDK安装：
参考references/sdk-installation.md详细安装指南和故障排除。运行python3 --version验证。一些脚本可能会在较旧的Python版本中失败。
RAM权限：
- [必须]RAM权限预检查：在执行前验证当前用户是否具有以下RAM权限。参考
references/ram-policies.md完整权限列表和详细信息。 - [必须]权限失败处理：当任何命令或API调用因权限错误而失败时，按照以下过程：阅读
references/ram-policies.md获取所需权限的完整列表，使用ram-permission-diagnose技能引导用户请求必要权限，暂停并等待用户确认已授予所需权限。
参数确认： 重要：参数确认 - 在执行任何命令或API调用前，[必须]所有用户可自定义参数（例如输入视频路径、输出Bucket、模板ID等）都必须与用户确认。不要假设或使用默认值而不经用户明确同意。