Load OCIO Config 算子节点

从环境变量 $OCIO 或显式指定的覆盖路径中加载 OpenColorIO 色彩配置文件，并将其封装为 OCIOConfigArtifact 凭证对象输出至下游节点。

算子所属分类：Colorspace

核心速查 (TL;DR)

若当前操作系统环境中已设置 $OCIO 环境变量，该节点会自动检测并直接回显——只需将节点拖入画布即可直接调度；
每次节点计算时均会实时动态重新读取 $OCIO，因此 Griptape 工程级配置文件（griptape-nodes-project.yml 中的 environment: 代码块）中声明的局部环境变量总能得到忠实应用；
输出成果为 OCIOConfigArtifact 对象——可直接连入 OCIO Color Parameters 节点或任何带有 OCIO Config 输入端口的色彩转换算子；
默认折叠的 Advanced (高级) 参数组允许你在不污染宿主机系统环境的前提下，临时通过文件选择器指定特定的 .ocio 文件路径进行针对性打样测试。

[Load OCIO Config 节点] → [OCIO Color Parameters 节点] → (下游 EXR 图像转换 / 显示监视节点)

端口名称	数据类型	是否必填	详细功能与业务规范说明
`context_vars`	`dict`	否	OCIO 上下文环境变量字典，例如 `{"SHOT": "sh010", "SEQ": "sq020"}`。该上下文将被持久化封装在输出凭据对象中供色彩变换解算。
`file_path`	`str`	否	指向 `.ocio` 配置文件的物理绝对路径。仅在启用了 Override OCIO Config 开关时生效，自带文件浏览选择器。

端口名称	数据类型	详细功能与业务规范说明
`config`	`OCIOConfigArtifact`	携带已解析的 OCIO 配置绝对路径与动态上下文变量的强类型资产凭据。
`was_successful`	`bool`	标识色彩配置文件是否成功完成语法解析与加载的布尔状态值。
`result_details`	`str`	加载状态的详细日志输出（折叠在状态组中，记录命中路径或阻断原因）。

参数名称	数据类型	默认值	详细业务功能与调优说明
`override_ocio_config`	布尔值 (bool)	`False`	开启后，将彻底无视系统 `$OCIO` 环境变量，强制转为使用下方填写的 `file_path` 物理路径。适合在不改动工作室全局环境变量的前提下快速验证测试特定配置。
`file_path`	文件路径 (file path)	`""`	在开启上述覆盖开关后显现，支持直接浏览并选择本地磁盘上的 `.ocio` 配置文件。

关注节点行内的状态提示徽标：节点上方会实时输出提示信息——成功检测到 $OCIO 时呈现绿色绝对路径；环境变量缺失时呈现黄色警告；若检测到自上次运行以来 $OCIO 发生了物理变更，会弹出橙色提示，此时重新点击执行节点即可无缝刷新下游全部色彩流水线。
覆盖模式具有绝对优先权：只要开启了 Override OCIO Config 开关，系统将彻底忽略环境变量；关闭开关即可即刻回归标准的环境变量驱动模式。
缺失配置将引发执行阻断：若系统全局未导出 $OCIO，且节点内未开启本地文件覆盖，节点将无法获取色彩基准而报错阻断。在团队管线中，推荐将配置文件路径统一沉淀在工程的 project.yml 中的 environment: OCIO 项下。