CorridorKey-Runtime绿屏蓝屏模型怎么选?Green与Blue双变体、动态TorchScript与回退机制完整指南
CorridorKey-Runtime绿屏蓝屏模型怎么选?Green与Blue双变体、动态TorchScript与回退机制完整指南
CorridorKey-Runtime 是一款原生 AI 抠像运行时与 OFX 插件,专为 DaVinci Resolve 和 Foundry Nuke 打造,与 Corridor Digital 联合开发。它内置 Green(绿屏) 与 Blue(蓝屏) 两套模型变体:Green 走 ONNX TensorRT 优化阶梯,Blue 走动态 TorchScript 单文件路径,并配有自动回退机制保证"选错不翻车"。本文将从新手视角讲清楚:两个变体有什么区别、该怎么选、回退机制如何在背后兜底。
为什么绿屏和蓝屏要分开两套模型?
很多人以为"绿幕蓝幕只是颜色不同,一个模型就够了"。实际上 CorridorKey 的两套模型是分别用不同颜色的幕布素材训练出来的:
| 对比项 | Green(绿屏变体) | Blue(蓝屏变体) |
|---|---|---|
| 训练素材 | 绿屏素材 | 蓝屏素材 |
| 分发形式 | 按分辨率切分的 ONNX 阶梯 | 单个动态 TorchScript 文件 |
| 后端 | ONNX Runtime + TensorRT RTX EP | Torch-TensorRT |
| 定位 | 标准变体(canonical) | 专用变体,独立于 Green 路径 |
背后的原因是 spill(溢色)处理逻辑不同:绿光会向皮肤、白色衣物溢出,蓝光则影响方式完全不同,模型必须"见过"对应颜色才能学会如何恢复被污染的前景像素。相关色彩域转换与 despill 通道的实现可以在 screen_color.hpp 中查到。
Green 模型怎么选:理解 ONNX 分辨率阶梯
Green 模型以 corridorkey_fp16_<res>.onnx 命名,按分辨率提供了完整的"质量阶梯":
| 质量档位 | 模型分辨率 | 适用场景 |
|---|---|---|
| Draft | 512px | 低显存显卡、快速预览 |
| High | 1024px | 新手推荐起点,速度与细节平衡 |
| Ultra | 1536px | 稳定后想提升细节 |
| Maximum | 2048px | 大显存、追求极致细节 |
几个新手容易踩的知识点:
Auto模式会尊重"安全质量上限"。系统会检测你的显存档位(VRAM tier),自动选择不会爆显存的质量,而不是盲目拉满。- 手动选了 Ultra/Maximum 也可能被降级。如果当前显存装不下,运行时会明确回退并提示,面板中的 Effective Quality(有效质量)才是"真相",别只看下拉框选了啥。
- 首次渲染 TensorRT 编译需要 10-30 秒,属于正常现象,不必重启。
这套阶梯的模型清单与校验信息可以在 artifact_manifest.json 中核对。官方支持范围(各分辨率在 Windows RTX 与 macOS MLX 上的验证状态)详见 SUPPORT_MATRIX.md。
Blue 模型的秘密:动态 TorchScript 为什么只用一个文件?
Green 需要 4 个不同分辨率的 ONNX 文件,而 Blue 在 Windows RTX 上只需要一个文件:corridorkey_dynamic_blue_fp16.ts。
这就是标题里说的"动态 TorchScript"。它的原理是:
- 动态尺寸导出:这个
.ts模型导出时不锁定输入分辨率,运行时按你选择的质量档位(512 / 1024 / 1536 / 2048)动态决定推理分辨率; - 省掉了逐分辨率编译引擎:Green 的 ONNX 阶梯每个分辨率都需要独立的 TensorRT 引擎文件,Blue 用一个动态工件替代了整条阶梯;
- 与 Green 完全隔离:Blue 走独立的 Torch-TensorRT 后端,不会抢占或干扰 Green 的优化路径。
💡 设计初衷:动态 Green 的 TorchScript 实验方案曾被验证过,但实测比优化后的 Green ONNX 路径慢 40%-54%,因此产品决策是让 Green 留在 ONNX,Blue 用动态 TorchScript,两条路径各司其职。相关决策记录见 0002-dedicated-screen-nodes.md。
在 OFX 插件中,Blue 甚至是一个独立的节点(CorridorKey Blue),与 Green 节点身份分离——同一个时间线上可以混合放置 Green 和 Blue 节点,它们互不干扰,各自选择自己的模型与后端。
回退机制详解:Blue 包没装会怎样?
这是新手最关心的问题:"我只装了 Green 包,但项目里需要蓝幕镜头,会崩吗?"答案是:不会崩,但行为分两种。
1. macOS(Apple Silicon):自动色彩域规范化
Apple Silicon 上目前没有独立的 Blue MLX 工件。此时运行时的处理方式是:
- 自动把蓝幕输入规范化到绿域(通过 3×3 颜色映射矩阵把蓝幕"换算"成等效绿幕);
- 用 Green MLX 模型完成推理;
- 再把结果映射回蓝域。
整个过程自动完成,并会在 corridorkey doctor 诊断输出中报告。也就是说,Mac 用户哪怕只装了 Green 模型包,蓝幕素材也能用。
2. Windows RTX:Blue 节点"失败即明确报错"(fail closed)
在 Windows RTX 上,Blue 节点的行为更严格:
- 如果动态 Blue TorchScript 包未安装或初始化失败,Blue 节点会给出可恢复的明确诊断信息,提示缺少专用的 blue 模型工件;
- 它不会悄悄换成 Green ONNX 模型冒充结果(避免"看起来能跑但溢色处理全错"的隐蔽错误);
- 而 Green 节点完全不受影响——Green 依赖还在,就照常渲染。
这种"部分安装可恢复"的设计保证:装得少 → 功能少且报错明确;装了 → 功能完整。
3. 质量回退链(两种变体通用)
无论 Green 还是 Blue,手动选择的高质量档位如果无法在当前硬件上运行(显存不足、会话创建失败),运行时都会沿低分辨率回退链降级,并在面板的 Status 与 Effective Quality 中如实告知。
一句话总结回退哲学:宁可明确降级/报错,也不给你一份静默的"错误答案"。
实战选型速查:30 秒决定装哪个包
模型包是可选组件,安装时你可以选"仅 Green""仅 Blue"或"两个都要",少装只减少体积,不影响其他功能。按下面的决策表来:
| 你的情况 | 建议 |
|---|---|
| 只拍绿幕 | 只装 Green 包即可 |
| 只拍蓝幕(Windows RTX) | 装 Blue 动态包 |
| 蓝幕 + 想省空间(Mac) | 只装 Green 包,靠色彩域规范化自动处理蓝幕 |
| 剧组两色幕都用 | 两个包都装,Green 与 Blue 节点可混用 |
装完后,跑一条命令确认状态即可(corridorkey doctor 会报告:当前后端、已安装/缺失的模型包、以及任何回退条件)。缺失的包会附带官方下载位置提示,随时可以后补。
新手常见疑问 FAQ
Q:蓝幕镜头能用 Green 节点凑合吗? 不建议。两套模型的溢色恢复是分别训练的,强行混用会导致 spill 处理偏差。Windows 上请用 Blue 节点;Mac 上运行时会自动做色彩域规范化,体验上无感。
Q:面板显示"Rough Fallback"是什么意思? 说明没有读到有效的 Alpha Hint(引导遮罩),插件生成了降级自动引导。此时结果偏不稳定,建议补接一个粗略的 Qualifier 遮罩。详见 OFX_PANEL_GUIDE.md。
Q:Quality 选了 Maximum 但 Effective Quality 是 High? 这是回退机制在工作——你的显存档位没有托住 2048px。留在能稳定跑的最高档位即可,不必强拉。
Q:Blue 节点报"missing required dedicated blue model artifact"?
说明 Blue 动态 TorchScript 包没装好。按 corridorkey doctor 提示补装即可,Green 节点不受影响。
延伸阅读
- 支持矩阵与模型变体支持状态:help/SUPPORT_MATRIX.md
- 产品规格(模型工件与回退策略):docs/SPEC.md
- OFX 面板使用指南:help/OFX_PANEL_GUIDE.md
- Resolve 实战教程:help/OFX_RESOLVE_TUTORIALS.md
- Torch-TensorRT 会话实现:torch_trt_session.cpp
- 动态 Blue 节点设计规格:doc/specs/0002-dedicated-screen-nodes.md


