Foundry Nuke 影视合成工程算子库 (Nuke Library)

构建并执行直接在工业级视效合成行业标准工具 Foundry Nuke 内部运行的专业工作流。本算子库提供了一整套专门针对 Nuke 定制的工作流流控节点、支持将 Griptape Nodes 工作流一键打包编译为带版本管理的商业级 Nuke .gizmo 自定义插件节点，以及一个能够通过无头模式 (nuke -t) 调度本地已有的 .nk 合成工程脚本、并将脚本内打标的 Read/Write 节点直接投射为画布强类型输入输出端口的 Nuke Script 算子。

官方开源代码仓库：griptape-ai/griptape-nodes-library-nuke
运行依赖与环境要求：本机已成功安装 Foundry Nuke 并具备合法商业或非商业许可证 (License)；
算子选择器分类：在算子面板中统一归类于 Foundry Nuke 分组。

安装与集成途径 (Installation)

在编辑器顶部菜单栏依次打开 Manage → Library Management，点击 Add Library 并粘贴 Git 仓库地址：

https://github.com/griptape-ai/griptape-nodes-library-nuke

亦可通过命令行工具 CLI 极速下载：

gtn libraries download https://github.com/griptape-ai/griptape-nodes-library-nuke

常规的更新与故障排查请参阅算子库管理手册。

核心算子功能矩阵 (Nodes)

算子名称	功能与业务语义说明
Nuke Start Flow	面向 Nuke 专属工作流的入口起点节点——是将流程打包编译并发布为 Nuke Gizmo 的绝对强制前置节点。
Nuke End Flow	面向 Nuke 专属工作流的终点出口节点；暴露 `was_successful` 执行状态与 `result_details` 运行日志输出。
Nuke Script	通过后台无头终端模式 (`nuke -t`) 调度本地现有 `.nk` 合成工程，将打标的 Read 输入节点与 Write 输出节点投射为画布端口。

本机 Nuke 安装环境自动发现与配置 (Configuring Nuke installations)

1. 宿主机全自动扫描发现 (Auto-discovery)

算子库在冷启动时会自动扫描操作系统的通用安装路径，并自动在节点的 Nuke Version 下拉列表中填充检测到的版本：

操作系统平台	系统默认扫描的物理路径范围
macOS	`/Applications/Nuke*`
Windows	`%ProgramFiles%\Nuke`, `%ProgramFiles(x86)%\Nuke`
Linux	`/usr/local/Nuke`, `/opt/Nuke`, `~/Nuke*`

此外，系统还会检测系统环境变量 PATH 中名为 Nuke 或 nuke 的可执行命令。在安装了新的 Nuke 版本后，点击节点上的 Refresh UI 即可即刻重新执行探测。

2. 通过引擎全局设置手动声明非标路径 (Manual configuration)

若你的 Nuke 安装在非标准路径（如 NAS 集中共享卷或自研 Pipeline 挂载点），可在引擎配置中通过 nuke.installations 手动指定：

{
  "nuke": {
    "installations": [
      {
        "display_name": "Nuke 16.0v7",
        "executable_path": "/opt/nuke/16.0v7/Nuke16.0",
        "annotator_nuke_version": 16
      }
    ]
  }
}

display_name：在前端下拉列表中呈现的人类可读版本名（必填）；
executable_path：Nuke 主执行文件的绝对物理路径（必填）；
annotator_nuke_version：Nuke 主版本号，用于决定加载哪个版本的标注面板扩展（默认：16）；
env_overrides：启动 Nuke 子进程时合并注入的局部环境变量字典。

3. Foundry 商业许可证配置 (License)

在 Griptape Nodes 的 Secrets (凭证管理) 面板中登记 foundry_LICENSE。系统会在拉起 Nuke 子进程时自动将该凭据广播至子进程环境中——切勿将其硬编码写在明文配置文件中。

将 Griptape 工作流发布为 Nuke Gizmo 插件 (Publishing as a gizmo)

在画布上构建一条顶层流：必须以 Nuke Start Flow 作为唯一入口，以 Nuke End Flow 作为终点；
触发 Publish Workflow (发布工作流) 操作（详见工作流发布指南），在弹出的发布对话框中选定：
- Nuke install：选择目标 Nuke 安装环境，用于解析插件依赖；
- gizmo install path：指定 .gizmo 的安装落盘目录（如用户的 ~/.nuke、NUKE_PATH 中的共享路径或 Nuke 自带的 plugins 目录）；
- update mode：选择是发布为全新版本号，还是直接覆盖当前线上已有版本；
打开 Nuke 软件：在左侧 Nodes 工具栏中即可找到专属的 Griptape 级联菜单，直接像普通 Nuke 原生节点一样将编译出的 Gizmo 拖入合成树节点图（Node Graph）中！若 Nuke 处于打开状态，从顶部菜单执行 Griptape > Refresh Griptape Gizmos 即可热重载全新版本，完全无需重启 Nuke。

发布流程会自动生成带版本号的 .gizmo 文件、对应的后台执行脚本以及用于在 Nuke 中注入菜单的 menu.py。同一工作流发布的不同历史版本会清晰折叠在子菜单中。Gizmo 执行生成的渲染物会自动保存在当前 .nk 工程文件同级的 griptape_outputs/<workflow_name>/... 专用目录下。

技术支持与反馈 (Support)

若在 Nuke Gizmo 编译或后台无头渲染中捕获到异常，欢迎前往 GitHub Issues 页面提交工单。