sunchenzheng DaVinci Resolve EAL 技能
将自然语言调色指令转化为 DaVinci Resolve API 操作并执行。
前置条件
- DaVinci Resolve 必须正在运行
- DR 已开启 Scripting API：
- macOS:
Preferences → Scripts → Enable Scripting and Assistant - Windows:
Preferences → Script → Enable Scripting
- macOS:
Remote API (port 8080) 不需要开启，本 EAL 使用原生 Python Scripting API。
核心文件
| 文件 | 作用 |
|---|---|
scripts/davinci_eal.py |
EAL 执行器（Action 分发 → DR API） |
references/action_schema.json |
原子动作定义（输入/输出规范） |
使用方式
直接调用（命令行）
python skills/davinci-eal/scripts/davinci_eal.py <action> key=value [key=value...]
# 示例：调整 gamma 轮，降低饱和度
python skills/davinci-eal/scripts/davinci_eal.py color_wheel_adjust wheel=gamma saturation=0.8
# 示例：添加一个串行节点
python skills/davinci-eal/scripts/davinci_eal.py node_add node_type=serial
# 示例：应用 LUT
python skills/davinci-eal/scripts/davinci_eal.py lut_apply lut_name=Filmgrade node_index=1
# 示例：重置节点
python skills/davinci-eal/scripts/davinci_eal.py node_reset node_index=1 scope=all
# 示例：Magic Mask 创建
python skills/davinci-eal/scripts/davinci_eal.py magic_mask action=create subject=face
# 示例：读取波形示波器
python skills/davinci-eal/scripts/davinci_eal.py scope_read scope_type=waveform --json
通过 OpenClaw 自然语言调用
用户说："把画面高光降低一点"
→ EAL 执行 color_wheel_adjust wheel=gain luminance=-0.3
用户说："给暗部加暖色"
→ EAL 执行 color_wheel_adjust wheel=lift hue=30 saturation=1.1
用户说："应用 Filmgrade LUT"
→ EAL 执行 lut_apply lut_name=Filmgrade
用户说："Magic Mask 跟踪人脸"
→ EAL 执行 magic_mask action=create subject=face
可用 Action
调色类
| Action | 说明 | 关键参数 |
|---|---|---|
color_wheel_adjust |
颜色轮调整 | wheel (lift/gamma/gain/offset), hue, saturation, luminance |
curve_adjust |
曲线编辑 | curve_type, points |
lut_apply |
应用 LUT | lut_name, node_index |
lut_remove |
移除 LUT | node_index |
node_reset |
重置节点 | node_index, scope |
node_add |
添加节点 | node_type (serial/parallel/layer/compound) |
遮罩类
| Action | 说明 | 关键参数 |
|---|---|---|
power_window |
Power Window 遮罩 | shape, points, invert, feather |
auto_color |
自动调色（批量/单镜头） | contrast, saturation, lut_name, track_index, batch_mode |
magic_mask |
Magic Mask 跟踪 | action (create/track/refine/reset), subject |
导航/信息类
| Action | 说明 | 关键参数 |
|---|---|---|
scope_read |
读取示波器数据 | scope_type (waveform/rgb_parade/vectorscope/histogram) |
timeline_nav |
时间线导航 | action, timecode |
project_load |
加载项目/时间线 | project_name, timeline_name |
自然语言 → Action 映射规则
OpenClaw 收到 NL 指令后，按以下规则映射：
高光过曝 / 降低高光 / 亮部太亮
→ color_wheel_adjust wheel=gain luminance=-0.2~-0.5
暗部不足 / 提亮暗部 / 阴影太暗
→ color_wheel_adjust wheel=lift luminance=+0.1~+0.3
中间调偏冷 / 暖色化
→ color_wheel_adjust wheel=gamma hue=+15~+45 (偏黄/暖)
饱和度太高 / 色彩太浓
→ color_wheel_adjust wheel=[any] saturation=0.7~0.9
饱和度太低 / 色彩太淡
→ color_wheel_adjust wheel=[any] saturation=1.1~1.3
应用 [LUT名]
→ lut_apply lut_name=[LUT名]
新建调色节点 / 添加节点
→ node_add node_type=serial
重置当前调色
→ node_reset scope=all
跟踪人脸 / Magic Mask 人脸
→ magic_mask action=create subject=face
跟踪人体 / Magic Mask 身体
→ magic_mask action=create subject=body
批量自动调色 / 给所有镜头套 LUT
→ auto_color batch_mode=true lut_name=Rec.709
只调当前镜头 / 选中镜头加对比度
→ auto_color batch_mode=false contrast=1.2 saturation=1.1
圆形遮罩 / 圆形 Power Window
→ power_window shape=circle points=[cx,cy,r]
读取波形示波器
→ scope_read scope_type=waveform
执行流程
用户 NL 指令
↓
OpenClaw 解析意图 → Action + Params
↓
OpenClaw 执行: exec python davinci_eal.py <action> ...
↓
DR Scripting API 调用
↓
返回 JSON 结果 {status, action, ...}
↓
OpenClaw 反馈用户（自然语言）
DR 未运行 / 连接失败
如果 EAL 报错 Cannot connect to DaVinci Resolve：
- 确认 DR 正在运行
- 确认已开启 Scripting API（Preferences → Script）
- 尝试重启 DR 后重新执行
EAL 扩展
如需新增 Action：
- 在
action_schema.json添加 action 定义 - 在
davinci_eal.py实现 handler 函数 - 注册到
ACTION_HANDLERS字典