SKILL.md
Video Quality Enhance
Overview
调用 meitu video-quality-enhance 做视频综合画质修复：去模糊 + 降噪 + 补帧 + 暗部提亮，自适配人像/演唱会/动漫/夜景/商品全场景。单项画质诉求（降噪/补帧/暗部增强）也由本工具默认承接。
不接收 target_resolution，不处理分辨率/超分/放大相关诉求，不处理图片。
API Mapping
| DAG 工具 | 后端 API |
|---|---|
| video-quality-enhance | videohdenhance |
Dependencies
- meitu-cli:
>=2.0.6 - 凭证：CONFIG AKSK →
meitu tools update；EXEC AKSK → 跑命令 - 环境变量：
MEITUOPENAPITOOLTASKMODE=command
路径别名：
$VISUAL={OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → Execute → DeliverPreflight
meitu --version≥ 2.0.6；meitu auth verify --json- 确认已跑过 Config Phase；
MEITUOPENAPITOOLTASKMODE=command - outputdir 解析：openclaw.yaml →
./output/| else →$VISUAL/output/video-quality-enhance/；mkdir -p {outputdir}
Execute
触发信号/路由
命中信号词："画质修复、视频修复、一键修复、整体修复、综合修复、变清晰、老视频翻新、画质提升、一键增强"。
决策顺序（能力范围判断最高优先级）：
- 输入是否含分辨率/超分诉求（720P/1080P/2K/4K / 放大 / 超分 / 分辨率）？
- 是 → 本工具不处理，返回能力范围外（引导 video-resolution-upscale） - 否 → 进入下一步
- Agent 画面识别视频内容类型生成
prompt video_url/prompt缺失 → 追问- 唯一路由 →
videohdenhance
prompt → 内部场景适配
| prompt 信号词 | 内部适配 |
|---|---|
| 人像/自拍/人物/面部 | 人像修复 |
| 演唱会/现场/舞台/音乐会 | 演唱会修复 |
| 动漫/动画/二次元/卡通 | 动漫修复 |
| 夜景/暗光/夜拍/低光 | 夜景修复 |
| 商品/产品/展示/电商 | 商品修复 |
| 其他/通用 | 通用修复（默认） |
无法判断 → prompt 写"通用视频"走默认修复模式。
参数定义
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
video_url |
STRING | 是 | 视频地址；缺失 → "请提供视频链接" |
prompt |
STRING | 是 | Agent 对视频内容的描述，用于内部多场景适配 |
不接收 target_resolution 参数——本工具不处理分辨率。
工具调用
meitu video-quality-enhance \
--skill_name skill_video-quality-enhance \
--video_url {video_url} \
--prompt "{prompt}" \
--json --download-dir {output_dir}错误降级
| 场景 | 处理 |
|---|---|
video_url 缺失 |
提示"请提供视频链接" |
video_url 不可访问 |
不重试，提示"请提供有效视频链接" |
prompt 为空或无信号词 |
Agent 识别后生成；仍无法判断写"通用视频" |
| 调用失败 | 重试 1 次，仍失败返回错误 |
| 超时 | 重试 1 次，仍超时返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试 |
| 用户中途追加分辨率/超分诉求 | 返回"本工具不处理分辨率相关诉求" |
| 输入为图片 | 拒绝，本工具仅支持视频 |
| "修复成 4K"等同时含修复+分辨率 | 本工具不处理（含分辨率诉求，能力范围外） |
Deliver
解析 --json → downloadedfiles[0].savedpath 或 media_urls[0]。
mv {file} {outputdir}/{YYYY-MM-DD}{name}_quality-enhance.mp4
Output
- 格式：MP4
- 命名：
{YYYY-MM-DD}{descriptive-name}quality-enhance.mp4 - 位置：项目 →
./output/；一次性 →$VISUAL/output/video-quality-enhance/
基线 Task ID
t_mt1a3i5n7b4715ca50-43d6-4ace-beec-b2557b9700ed