video-enhancer — 视频增强流水线
锐化、调色并归一化一组视频的音频。不含字幕 —— 如需添加字幕请使用 video-captioner 技能。
流水线
输入视频 → unsharp + eq + colorbalance (ffmpeg) → -14 LUFS 音频归一化 → 输出
预设
| 预设 | 锐度 | 饱和度 | 暖色 |
|---|---|---|---|
natural | 细微 | +10% | 无 |
cinematic | 强烈 | +35% | 暖色(增强红色,减少蓝色) |
vivid | 强烈 | +40% | 无 |
如果用户未指定预设,请在运行前询问他们想要哪种效果。简要描述选项:natural 为干净、克制的效果;cinematic 为温暖、对比强烈的 Instagram 风格调色;vivid 为最大色彩强度。
如何运行
安装依赖(仅首次运行):
cd "$SKILL_DIR" && uv sync
然后处理视频:
cd "$SKILL_DIR" && uv run python scripts/enhance.py \
--input <path/to/input> \
--output <path/to/output> \
--preset natural|cinematic|vivid
常用调用
# 电影感调色
uv run python scripts/enhance.py --input ./input --output ./output --preset cinematic
# 自然调色
uv run python scripts/enhance.py --input ./input --output ./output --preset natural
# 鲜艳调色
uv run python scripts/enhance.py --input ./input --output ./output --preset vivid
运行后
向用户报告:
- 成功处理的视频数量和失败的数量。
- 输出目录的完整路径。
- 如果有视频失败,请明确命名它们。
边界情况
- 如果未安装
ffmpeg:告知用户安装(Arch/CachyOS 上使用sudo pacman -S ffmpeg,macOS 上使用brew install ffmpeg,Ubuntu 上使用sudo apt install ffmpeg) - 如果未安装
uv:引导至 https://docs.astral.sh/uv/getting-started/installation/ - 如果输入目录为空:清晰地报告,而不是静默退出
- 如果给出了未知预设:列出有效选项(natural, cinematic, vivid)
- 音频归一化可能会针对短片段打印关于动态模式的警告——这是预期行为,并非错误