mcpField
V
video-quality-enhance

video-quality-enhance

github.com/meituCreative & media36127 installsUpdated 9w ago
Repository

About video-quality-enhance

A skill for general video-quality repair, intended for workflows that need to address blur, noise, frame rate, or dark areas. It adapts processing to video content, but does not handle images or resolution upscaling.

Key features

  1. 01Address blur and noise together
  2. 02Support frame interpolation and shadow brightening
  3. 03Adapt repair to content such as portraits
  4. 04Reject resolution-upscaling requests
  5. 05Process video only

Use cases

  1. 01Repair a blurry or noisy video
  2. 02Improve concert or anime video quality
  3. 03Brighten dark areas in night footage

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/meitu/meitu-skills --skill video-quality-enhance

After installing, type/video-quality-enhancein Claude Code to confirm it loaded.

Details

From the project README

Video Quality Enhance

Overview

调用 meitu video-quality-enhance 做视频综合画质修复：去模糊 + 降噪 + 补帧 + 暗部提亮，自适配人像/演唱会/动漫/夜景/商品全场景。单项画质诉求（降噪/补帧/暗部增强）也由本工具默认承接。

不接收 target_resolution，不处理分辨率/超分/放大相关诉求，不处理图片。

API Mapping

DAG 工具后端 API
video-quality-enhancevideo_hd_enhance

Dependencies

  • meitu-cli: >=2.0.6
  • 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 跑命令
  • 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver
Preflight
  1. meitu --version ≥ 2.0.6；meitu auth verify --json
  2. 确认已跑过 Config Phase；MEITU_OPENAPI_TOOL_TASK_MODE=command
  3. output_dir 解析：openclaw.yaml → ./output/ | else → $VISUAL/output/video-quality-enhance/；mkdir -p {output_dir}
Execute

触发信号/路由

命中信号词："画质修复、视频修复、一键修复、整体修复、综合修复、变清晰、老视频翻新、画质提升、一键增强"。

决策顺序（能力范围判断最高优先级）：

  1. 输入是否含分辨率/超分诉求（720P/1080P/2K/4K / 放大 / 超分 / 分辨率）？
    • 是 → 本工具不处理，返回能力范围外（引导 video-resolution-upscale）
    • 否 → 进入下一步
  2. Agent 画面识别视频内容类型生成 prompt
  3. video_url / prompt 缺失 → 追问
  4. 唯一路由 → video_hd_enhance

prompt → 内部场景适配

prompt 信号词内部适配
人像/自拍/人物/面部人像修复
演唱会/现场/舞台/音乐会演唱会修复
动漫/动画/二次元/卡通动漫修复
夜景/暗光/夜拍/低光夜景修复
商品/产品/展示/电商商品修复
其他/通用通用修复（默认）

无法判断 → prompt 写"通用视频"走默认修复模式。

参数定义

参数类型必填说明
video_urlSTRING是视频地址；缺失 → "请提供视频链接"
promptSTRING是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 → downloaded_files[0].saved_path 或 media_urls[0]。

mv {file} {output_dir}/{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

Comments

Markdown supported