Install
openclaw skills install @thcjp/lh-video-gen-paidopenclaw skills install @thcjp/lh-video-gen-paid核心功能: 本技能提供自动化配置和灵活的参数设置、专业版工具、时使用等能力。
A: PRO版完全兼容免费版。现有Markdown脚本格式与命令行参数可直接使用。只需安装PRO版增强包即可启用批量生成与高级功能.
A: PRO版支持失败重试机制。失败的记录会保存到failed-tasks.json,可单独重试:
py --retry failed-tasks.json
A: 需要安装支持GPU的FFmpeg版本(如带NVIDIA CUDA支持)。在配置中设置gpu_acceleration: True即可自动启用.
A: 使用多品牌配置,每个品牌拥有独立的模板、配色与资产。可在批量任务中为不同视频指定不同品牌.
A: 默认输出9:16竖版(1080x1920)。可配置为16:9横版(1920x1080)或1:1方形(1080x1080),适配不同平台需求.
===
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 视频素材剪辑 | 8小时 | 1小时 | 7小时 | 5% |
| 视频模板应用 | 2小时 | 30分钟 | 1.5小时 | 3% |
| 文本翻译与添加 | 4小时 | 1小时 | 3小时 | 4% |
| 视频输出 | 2小时 | 15分钟 | 1.5小时 | 2% |
| 视频审查与调整 | 6小时 | 1小时 | 5小时 | 6% |
| 总计 | 27小时 | 5.5小时 | 21.5小时 | 5% |
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 批量处理能力 | 高 | 低 | 中 | 高 |
| 多语言支持 | 高 | 低 | 中 | 高 |
| 品牌定制化 | 高 | 低 | 中 | 高 |
| 自动化集成 | 高 | 低 | 中 | 高 |
| 成本效益 | 高 | 高 | 中 | 高 |
| 用户友好性 | 中 | 低 | 中 | 高 |
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 视频生产效率低 | 手动操作繁琐,耗时较长 | 整体工作进度缓慢,资源浪费 | 自动化批量处理 | 提高效率20% |
| 多语言内容生成困难 | 需要人工翻译,成本高 | 影响内容覆盖范围 | 多语言支持 | 扩大内容覆盖范围30% |
| 品牌一致性维护困难 | 各部门使用不同模板,品牌形象不统一 | 品牌形象受损 | 品牌资产管理 | 提升品牌形象满意度15% |
| === |
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 批量生成失败 | 任务配置错误 | 检查任务配置文件,确认脚本路径和参数正确 | 修正配置文件,重新执行批量生成 |
| 视频输出质量差 | 输出设置错误 | 检查输出设置,确认分辨率和编码格式正确 | 修正输出设置,重新生成视频 |
| 多语言混排错误 | 语言配置错误 | 检查语言配置,确认文本、语言和音色正确 | 修正语言配置,重新生成视频 |
| 品牌资产缺失 | 资产文件路径错误 | 检查资产文件路径,确认文件存在 | 修正文件路径,重新生成视频 |
| 系统崩溃 | 硬件或软件故障 | 检查系统日志,确认错误原因 | 重启系统或联系技术支持 |
| === |
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 短视频生成专业版级竖版短视频批量生成 | 不支持 | 支持 |
| 短视频生成专业版批量处理 | 不支持 | 支持 |
| 高清分辨率与无损输出 | 不支持 | 支持 |
| 批量生成与风格预设 | 不支持 | 支持 |
| 自定义模型微调 | 不支持 | 支持 |
# 批量生成任务队列
batch_tasks = [
{"script": "(请参考skill目录中的脚本文件)", "output": "output/product-a.mp4"},
{"script": "(请参考skill目录中的脚本文件)", "output": "output/product-b.mp4"},
{"script": "(请参考skill目录中的脚本文件)", "output": "output/product-c.mp4"},
{"script": "(请参考skill目录中的脚本文件)", "output": "output/tutorial-1.mp4"},
{"script": "(请参考skill目录中的脚本文件)", "output": "output/tutorial-2.mp4"}
]
# ...
# 执行批量生成
python3 batch_generate.py \
--tasks tasks.json \
--parallel 4 \
--output ./output/ \
--template brand \
--quality-check \
--auto-optimize
```- 验证返回数据的完整性和格式正确性
### 多模板系统
PRO版提供多种画面模板,支持不同视觉风格:
```yaml
# templates.yml - 模板配置
templates:
minimal:
name: "极简风格"
background: "linear-gradient(135deg, #FAFAFA, #F1F5F9)"
font: "Inter, sans-serif"
text_color: "#0F172A"
animation: "fade_in"
# ...
brand:
name: "品牌定制"
background: "brand_gradient"
logo: "assets/logo.png"
font: "brand_font"
text_color: "brand_primary"
watermark: True
animation: "slide_up"
# ...
dynamic:
name: "动态活力"
background: "animated_gradient"
font: "Poppins, sans-serif"
text_color: "#FFFFFF"
animation: "bounce_in"
particle_effect: True
# ...
education:
name: "教育培训"
background: "#FFFFFF"
font: "Noto Sans SC, sans-serif"
text_color: "#1E3A5A"
highlight_color: "#0052FF"
animation: "type_writer"
# 多语言混排配置
multilingual_config = {
"segments": [
{
"text": "Hello everyone, welcome to our channel.",
"lang": "en",
"voice": "en-US-JennyNeural",
"rate": "+0%"
},
{
"text": "大家好,欢迎来到我们的频道。",
"lang": "zh",
"voice": "zh-CN-XiaoxiaoNeural",
"rate": "+0%"
},
{
"text": "こんにちは、チャンネルへようこそ。",
"lang": "ja",
"voice": "ja-JP-NanamiNeural",
"rate": "+0%"
}
]
}
# 品牌资产统一管理
brand_assets = {
"logo": "assets/brand/logo.png",
"logo_dark": "assets/brand/logo-dark.png",
"colors": {
"primary": "#0052FF",
"secondary": "#4D7CFF",
"accent": "#FF6B35",
"background": "#FAFAFA",
"text": "#0F172A"
},
"fonts": {
"display": "Calistoga, serif",
"body": "Inter, sans-serif",
"mono": "JetBrains Mono, monospace"
},
"intro_animation": "assets/animations/intro.mp4",
"outro_animation": "assets/animations/outro.mp4",
"watermark": {
"enabled": True,
"image": "assets/brand/watermark.png",
"position": "bottom-right",
"opacity": 0.8
}
}
# 自动质量检查
quality_checks = {
"resolution": {"required": "1080x1920", "action": "reject_if_fail"},
"duration": {"min": 15, "max": 180, "action": "warn_if_outside"},
"audio_level": {"target": -16, "tolerance": 2, "action": "auto_normalize"},
"subtitle_sync": {"tolerance": 0.5, "action": "warn_if_fail"},
"text_readability": {"min_contrast": 4.5, "action": "warn_if_fail"},
"frame_rate": {"required": 30, "action": "reject_if_fail"}
}
```- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `多模板系统` 选项
## 快速部署
1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理
> 详细的输入输出格式请参考下方章节说明。
## 场景示例
### 场景一:MCN批量内容生产
需求:MCN机构需要为多个账号批量生产竖版短视频.
```python
# 批量内容生产工作流
mcn_pipeline = {
"accounts": [
{"name": "科技账号", "template": "minimal", "topics": ["AI", "编程", "工具"]},
{"name": "教育账号", "template": "education", "topics": ["英语", "数学", "科普"]},
{"name": "生活账号", "template": "dynamic", "topics": ["美食", "旅行", "日常"]}
],
"daily_quota": 10, # 每账号每日10条
"schedule": "daily 08:00",
"auto_publish": False, # 生成后人工审核
"quality_check": True
}
# ...
# 执行批量生成
for account in mcn_pipeline["accounts"]:
for topic in account["topics"]:
script = generate_script(topic, account["template"])
generate_video(script, account["template"])
需求:电商平台需要为100个商品生成介绍视频.
# 批量生成商品视频
--tasks products.csv \
--parallel 8 \
--template brand \
--brand-assets ./brand/ \
--output ./videos/ \
--quality-check \
--auto-optimize \
--generate-thumbnail \
--watermark
# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
result = "implementation_ready"
需求:将中文内容翻译并生成多语言版本视频.
# 多语言批量生成
languages = ["zh-CN", "en-US", "ja-JP", "ko-KR", "es-ES"]
source_script = "(请参考skill目录中的脚本文件)"
# ...
for lang in languages:
# 翻译脚本
translated = translate_script(source_script, target_lang=lang)
# ...
# 选择对应音色
voice = get_voice_for_lang(lang)
# ...
# 生成视频
generate_video(
script=translated,
output=f"output/video_{lang}.mp4",
voice=voice,
template="brand"
)
# 初始化视频生产项目
python3 init_project.py \
--name "MyVideoProject" \
--brand-assets ./brand/ \
--output ./project/
# 创建任务文件
cat > tasks.json << 'EOF'
[
{"script": "(请参考skill目录中的脚本文件)", "output": "out/01.mp4", "template": "brand"},
{"script": "(请参考skill目录中的脚本文件)", "output": "out/02.mp4", "template": "minimal"},
{"script": "(请参考skill目录中的脚本文件)", "output": "out/03.mp4", "template": "education"}
]
EOF
--tasks tasks.json \
--parallel 4 \
--quality-check \
--output ./output/
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | 处理的内容输入 |
| mode | string | 否 | 处理模式, 可选值: json/text/markdown |
| style | string | 否 | 输出风格, 参考 references/style.md |
{
"success": true,
"data": {
"result": "处理结果",
"status": "success",
"metadata": {
"metadata": {
"template_used": "reviewer",
"word_count": 0,
"style": "专业"
}
},
"error": null
}
输出模板参考: assets/output.json
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 |
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| FFmpeg 5.0+ | 系统工具 | 必需 | brew/apt安装 |
| Chrome | 浏览器 | 截图必需 | 系统自带或下载 |
| TTS服务 | 服务 | 必需 | 默认Edge TTS或自定义 |
| CUDA(可选) | GPU驱动 | GPU加速可选 | NVIDIA官方 |
# PRO版高级配置
pro_config = {
"rendering": {
"gpu_acceleration": True, # GPU加速
"parallel_workers": 4, # 并行任务数
"cache_enabled": True # 缓存启用
},
"video": {
"width": 1080,
"height": 1920,
"fps": 30,
"bitrate": "5M",
"format": "mp4",
"codec": "h264"
},
"audio": {
"sample_rate": 44100,
"bitrate": "128k",
"normalize": True, # 音量标准化
"target_loudness": -16 # 目标响度(LUFS)
},
"subtitles": {
"burn": True, # 烧录字幕
"font": "Inter, sans-serif",
"font_size": 48,
"position": "bottom",
"background": "semi-transparent"
},
"branding": {
"watermark": True,
"intro": True,
"outro": True,
"logo_position": "top-right"
}
}
A1: 企业级竖版短视频批量生成系统,支持多模板、多语言、批量处理、品牌定制与CI/CD集成,适合团队与商业项目。。支持文本指令和结构化参数输入,具体格式参考使用流程章节。
A2: 是的,部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求,并通过环境变量安全配置。
A3: 检查命令参数是否正确,确认运行环境支持exec能力。如遇权限问题,请参照错误处理章节排查。
针对短视频生成专业版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
针对短视频生成专业版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
针对短视频生成专业版使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |