CorridorKey-Runtime绿屏蓝屏模型怎么选?Green与Blue双变体、动态TorchScript与回退机制完整指南

原创2026-10-26 13:22:371,425 阅读

CorridorKey-Runtime绿屏蓝屏模型怎么选?Green与Blue双变体、动态TorchScript与回退机制完整指南

CorridorKey-Runtime 是一款原生 AI 抠像运行时与 OFX 插件,专为 DaVinci Resolve 和 Foundry Nuke 打造,与 Corridor Digital 联合开发。它内置 Green(绿屏) 与 Blue(蓝屏) 两套模型变体:Green 走 ONNX TensorRT 优化阶梯,Blue 走动态 TorchScript 单文件路径,并配有自动回退机制保证"选错不翻车"。本文将从新手视角讲清楚:两个变体有什么区别、该怎么选、回退机制如何在背后兜底。

CorridorKey-Runtime绿屏蓝屏抠像OFX插件在DaVinci Resolve中的实际效果演示

为什么绿屏和蓝屏要分开两套模型?

很多人以为"绿幕蓝幕只是颜色不同,一个模型就够了"。实际上 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"。它的原理是:

  1. 动态尺寸导出:这个 .ts 模型导出时不锁定输入分辨率,运行时按你选择的质量档位(512 / 1024 / 1536 / 2048)动态决定推理分辨率;
  2. 省掉了逐分辨率编译引擎:Green 的 ONNX 阶梯每个分辨率都需要独立的 TensorRT 引擎文件,Blue 用一个动态工件替代了整条阶梯;
  3. 与 Green 完全隔离:Blue 走独立的 Torch-TensorRT 后端,不会抢占或干扰 Green 的优化路径。

CorridorKey-Runtime芯片图标:原生AI抠像运行时在RTX显卡上通过动态TorchScript后端加速推理

💡 设计初衷:动态 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-Runtime绿屏抠像实测:绿幕素材经AI抠像模型处理后的效果展示

装完后,跑一条命令确认状态即可(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 节点不受影响。

延伸阅读

登录后查看全文
CorridorKey-Runtime