Agent Skills
› ZJU-REAL/Easel
› green-screen
green-screen
GitHub基于FFmpeg实现绿幕/蓝幕视频抠像与背景合成，支持图片、视频、纯色及模糊背景替换，自动处理溢色抑制与边缘融合。
Trigger Scenarios
绿幕抠像
换背景
chromakey
去绿幕
蓝幕合成
Install
npx skills add ZJU-REAL/Easel --skill green-screen -g -y
SKILL.md
Frontmatter
{
"name": "green-screen",
"layer": "produce",
"description": "绿幕抠像 \/ 换背景 \/ 合成：把绿幕（或蓝幕\/指定色）拍摄的前景人物抠出来，合成到新背景——图片、视频、纯色或前景自身模糊。当用户说 绿幕、抠像、抠图换背景、去绿幕、chromakey、绿幕合成、换背景、蓝幕、把绿幕背景换掉、人物抠出来、绿布 时使用。基于 shared\/scripts\/chromakey.py（ffmpeg chromakey + despill）。与 video-reframe 区别：reframe 只改画幅不换背景；与 ai-image-gen 区别：那个生成新图，本 SKILL 处理已拍的绿幕素材。"
}
绿幕抠像 / 换背景合成
把绿幕前景抠出来合成到新背景。全部走
skills/shared/scripts/chromakey.py， 不要手拼 chromakey/overlay 滤镜——脚本已处理抠像、溢色抑制(despill)、边缘融合、 背景缩放、音轨保留。
只改画幅见 video-reframe；从零 AI 生成画面见 ai-video-gen；通用剪辑见 video-editing。
输入
| 字段 | 必填 | 说明 |
|---|---|---|
| 前景视频 | 是 | 绿幕/蓝幕拍摄的素材（没给就问） |
| 背景 | 是 | 四选一：图片 / 视频 / 纯色 / 前景自身模糊 |
| 幕布色 | 否 | 默认绿 0x00ff00；蓝幕用 0x0000ff |
输出（outputs/主题名/）
- 合成后视频（
*-composited.mp4） - 报告：分辨率、抠掉的颜色、所用背景
执行步骤
脚本路径（相对项目根）：skills/shared/scripts/chromakey.py（key -h 看参数）。
# 合成到图片背景
python skills/shared/scripts/chromakey.py key -i <绿幕视频> \
--bg <背景图> -o outputs/主题名/<名>-composited.mp4
# 合成到视频背景（背景自动循环补足）
python skills/shared/scripts/chromakey.py key -i <绿幕视频> \
--bg <背景视频> -o outputs/主题名/<名>.mp4
# 合成到纯色背景
python skills/shared/scripts/chromakey.py key -i <绿幕视频> \
--bg-color white -o outputs/主题名/<名>.mp4
# 背景=前景自身放大模糊（虚化景深感）
python skills/shared/scripts/chromakey.py key -i <绿幕视频> \
--bg-blur -o outputs/主题名/<名>.mp4
调参（抠不干净时）
- 绿边残留 / 抠不净：调大
--similarity（默认 0.30，可到 0.4）。 - 主体边缘被吃 / 镂空：调小
--similarity，或加大--blend（默认 0.10）柔化边缘。 - 主体泛绿（溢色）：脚本已自动
despill；仍明显时说明幕布打光不匀，属素材问题。 - 蓝幕：
--color 0x0000ff。
规则
- 幕布色默认绿；蓝幕/其它色用
--color指定。 - 背景四选一（
--bg/--bg-color/--bg-blur），互斥。 - 背景自动缩放裁切到前景画幅、视频背景自动循环补足到前景时长。
- 前景音轨自动保留。
- 抠像质量取决于素材（幕布纯净度、打光均匀度）；脚本尽力，但拍摄差无法救回。
- 产物统一进
outputs/主题名/。
参考来源
绿幕抠像用 ffmpeg chromakey（按颜色距离生成 alpha）+ despill（抑制主体边缘溢色）+
overlay 合成，是标准无 GPU 抠像方案。把颜色阈值、边缘融合、背景适配封装成确定性脚本。
Version History
- 69c5928 Current 2026-09-08 17:36
