夜雨聆风NUKE学习社 · AI WORKFLOW BRIDGE
Nukomfy
把 ComfyUI 工作流
真正变成 Nuke Gizmo
它不是简单的“调用 ComfyUI”按钮，而是一套从工作流封装、多机提交、进度追踪，到结果回读和团队分发的完整桥接方案。
v0.1.0Nuke 14.1+Apache 2.0
WHY NUKOMFY
先说它解决了什么问题
ComfyUI 的优势，是工作流自由、节点丰富、模型选择多；它的门槛，也恰恰来自这些自由。对合成师来说，打开另一套节点图、确认模型和自定义节点、管理输入输出路径、盯住多台机器的队列，往往比真正调参数更耗精力。
Nukomfy 把“搭建工作流”和“使用工作流”拆成两个角色：TD 在 ComfyUI 中完成并验证流程，再把必要参数封装为 Nuke Gizmo；艺术家只在当前合成脚本里连接素材、调整少量旋钮、提交并回读结果。
Nukomfy 的核心价值
不是把 AI 塞进 Nuke，而是把已经验证过的 AI 流程，变成团队可复用、可约束、可追踪的合成工具。
WHAT IT IS / ISN'T
它是什么，又不是什么
它是：工作流封装与生产桥接层
Nuke 端是 Python 插件，负责 Library、Workflow Creator、Gizmo、提交、队列和历史；ComfyUI 端安装配套的 Nukomfy Suite，负责读写帧、色彩转换、任务历史和管理员操作。
它不是：在 Nuke 内重建 ComfyUI 节点图
工作流仍然在 ComfyUI 中设计和维护。Nukomfy 不会替你安装自定义节点、下载模型，也不会修复本来就无法运行的工作流。它提交的是成熟流程，而不是负责搭建流程。
ARCHITECTURE
一次完整任务，数据怎么走？
01 · COMFYUI
完成工作流，加入桥接节点
工作流必须先独立跑通；加入至少一个 NukomfyWrite，需要 Nuke 输入时再加入 NukomfyRead。
02 · APP BUILDER
暴露参数，导出 UI 格式 JSON
只暴露希望艺术家控制的 Widget，并把 NukomfyWrite 标记为 App Output。API 格式导出不受支持。
03 · NUKOMFY
Workflow Creator 生成可复用 Gizmo
同步服务器参数，决定哪些旋钮可见、顺序如何、输入输出是单帧还是序列，并保存元数据与预览图。
04 · SUBMIT
缓存输入帧，转换并提交任务
Nuke 上游画面先写入共享缓存，Nukomfy 把 UI 工作流转换为实际 API 任务，通过 HTTP 发往选定的 ComfyUI 主机。
05 · RETURN
监控、记录、回读到 Nuke
结果写入共享输出目录；任务完成后，可从 Gizmo 当前路径或 My Jobs 的提交时路径创建 Read 节点。
WORKFLOW LIBRARY
从工作流库到 Nuke 节点
Workflow Library：预览、搜索、标签筛选、收藏与本地/共享来源
Library 支持网格与列表视图、实时搜索、来源和标签过滤、收藏、排序与缩放。双击卡片，就会在当前 Nuke 脚本里创建一个普通 Group 节点，默认命名为 Nukomfy_工作流名。
每个工作流以文件夹形式存在，包含 UI 格式的 workflow.json、旋钮配置与 UUID 等 metadata.json、预览图，以及工作流专属的 Write Template。团队共享时，真正要分发的是这个文件夹，而不是复制出来的 Gizmo 节点。
WORKFLOW CREATOR
TD 决定艺术家能看到什么
Workflow Creator：同步参数、设置旋钮、顺序、默认值与 I/O 模式
参数行左侧的复选框，决定它是否出现在 Gizmo 上。未勾选的参数仍会把保存时的默认值提交给 ComfyUI，只是艺术家无法修改。这样可以隐藏模型路径、技术开关和容易误操作的设置，只保留 Prompt、Seed、强度、采样步数等必要控制。
同步不是简单覆盖
Sync Parameters 会重新扫描工作流：手动修改过的行保留选择，新参数加入、已删除参数移除；Reset Defaults 才会恢复服务器提供的字段，但不会重置 Write Template 与 I/O Mode。
AUTO-MANAGED
这些参数由 Nukomfy 自动接管
因此，即便这些值存在于原始 ComfyUI JSON 中，正式提交时也会被 Nukomfy 当前任务状态覆盖，保证帧范围和磁盘路径一致。
SUBMIT & PREFLIGHT
提交前，不是直接把任务扔出去
Submit Panel：主机、帧范围、输出起始帧与 Batch Count
| 主机健康 | |
| 工作流节点 | |
| 输入缓存并发 | |
| 输出目录并发 |
全部输出为 Single 模式时，可以使用 Batch Count 一次提交多个变体。它们写成同一版本里的连续帧；若 Seed 使用 randomize，每一帧就对应一个不同结果，而不是自动创建多个版本。
RENDER MANAGER
多台 ComfyUI 机器，一个队列视图
Render Manager：跨主机队列、进度、终止与历史
Render Manager 展示每台主机的 Running、Queued 和 History。安装 websocket-client 后，进度条可实时平滑更新；没有它也能使用，只是显示为斜纹进度条，并按刷新周期更新，默认自动刷新间隔为 30 秒。
任务详情包含提交与执行信息、输入输出路径、Seed、服务器事件、完整错误堆栈，以及实际提交的 API 工作流。My Jobs 还会在本地 SQLite 历史中保留自己的已终止任务，即使 ComfyUI 重启或服务器历史被清理，仍能按提交时路径重新回读。
READ OUTPUTS
两个“回读结果”，区别很关键
从 Gizmo 点击 Read Output(s)
按 Gizmo 当前版本、输出名和模板解析磁盘路径。适合读取当前设置对应的最新结果。
从 My Jobs 历史点击 Read Outputs
使用任务提交当时登记的路径，不受后来修改 Output Path、Template 或版本的影响。恢复旧任务时应优先使用这一入口。
CACHE & FILES
输入缓存不是简单重复渲染
Nukomfy 用 Nuke 原生上游 Hash 建立缓存指纹，并记录每帧文件的修改时间和大小。相同参数、相同范围、相同源文件会直接复用；范围扩大只补新帧；源文件被覆盖时只重写发生变化的帧；任何上游旋钮变化则生成新的指纹目录。
Write Template
输入缓存可以使用自定义 Nuke 链：一个 Input、一个 Write，中间可加入 LUT、预校色或 OCIO 节点。视频格式会被拒绝，只允许 EXR、TIFF、PNG、JPEG、DPX、HDR 等静帧格式。
安全清理
默认每次提交会清理同一输入的闲置旧指纹；也可以按 TTL 在 Nuke 启动时清理。删除只发生在当前用户分支，并要求有效的缓存哨兵文件，避免误删无关目录。
COMFYUI SUITE
ComfyUI 端不只有 Read 和 Write
ComfyUI-Nukomfy-Suite v0.1.0 提供的五个节点
读写依赖 OpenImageIO，色彩使用 OCIO。Suite 要求 OpenImageIO 3.1.10 或更高版本，并使用其自带的 ACES 2.0 Studio Config 作为默认色彩配置；多层功能仅适用于 EXR。
COLOR MANAGEMENT
色彩转换默认是关闭的
NukomfyRead 和 NukomfyWrite 都提供 Apply Color Transform 开关，默认关闭。关闭时像素值原样通过，所选颜色空间不会生效——这也是多数 AI 工作流更稳妥的起点。
开启后，Read 会从指定 Input Transform 转到 linear Rec.709；Write 则从 linear Rec.709 转到 Output Transform。对于 ACES、HDR 或跨色域项目，必须在测试图上明确确认，不要只凭菜单名称判断。
TEAM DEPLOYMENT
它已经考虑到团队部署
共享 Workflow Folder 可以集中分发工作流；Nuke 自带 Path Substitutions 可在 Windows 的盘符和 Linux 的挂载路径之间做转换；管理员还可以通过 settings_overrides 下发并锁定输出路径、刷新间隔、机器列表和共享目录。
机器状态
Idle、Rendering、Queued、Offline、Unavailable。Unavailable 会阻止新提交，但不会停止已有任务。
管理员操作
跨用户强制终止/移除、重启 ComfyUI、切换 Unavailable 均需要每台主机自己的管理员密码。
安全边界
Hide URL 只是混淆显示，不是身份认证；Unavailable 也是协作信号，不是安全锁。ComfyUI HTTP 服务仍应放在可信局域网、VPN 或有防火墙控制的网络中。
INSTALLATION
安装需要两端同时完成
Nuke 端
把 Nukomfy 文件夹复制到 ~/.nuke/，然后在 menu.py 加入：
import Nukomfy
ComfyUI 端
每一台 ComfyUI 主机都要安装 ComfyUI-Nukomfy-Suite。推荐在 ComfyUI Manager 搜索 Nukomfy Suite 安装；手动安装时，还要在 ComfyUI Python 环境安装：
OpenImageIO ≥ 3.1.10fileseq
可选实时进度
在 Nuke 使用的 Python 中安装 websocket-client。它不是提交和渲染的硬依赖；缺少时只是没有平滑实时进度。
REQUIREMENTS
使用前必须确认的条件
项目 README 与用户指南明确写 Nuke 14.1+
CHINESE LOCALIZATION
中文汉化
原版插件为纯英文，不易上手，所以我们将其进行了中文汉化.
同样免费分享给大家使用，我们保留了两个版本.
一个是英文原版，一个是我们中文汉化的中文语言版.
大家自行选择使用即可.
注：本中文界面由 Nuke学习社汉化并免费提供给大家使用，仅进行界面文字本地化，不参与原插件的功能及代码开发。
Nukomfy 的代码、功能及版权归原作者与原项目所有.
以下为中文汉化版截图：
WHO IS IT FOR
谁最适合使用 Nukomfy？
适合：有固定 ComfyUI 流程、希望合成师在 Nuke 内直接使用的 TD 与团队；需要管理多台 GPU 主机、统一路径和共享工作流的制作环境。
也适合：个人用户把常用修复、生成、重绘或风格化流程封装成少量旋钮，减少反复切换软件和手动整理文件。
不太适合：希望在 Nuke 节点图里逐个搭建 ComfyUI 节点的人。Nukomfy 的设计方向是“把完成的工作流封装成一个 Gizmo”，而不是在 Nuke 中复刻整张 ComfyUI 图。
CONCLUSION
它把“AI 工作流”变成了“制作工具”
从技术上看，Nukomfy 做的是工作流转换、文件缓存、任务提交和结果回读；从制作管理角度看，它更重要的意义是隔离复杂度：TD 维护流程，艺术家使用流程，机器执行流程，历史记录流程。
v0.1.0 还很年轻，部署门槛也不低，但它已经把 Library、Gizmo、队列、缓存、色彩、路径和团队控制串成了完整闭环。对于正在尝试把 ComfyUI 纳入 Nuke 正式制作流程的团队，这是一个值得认真测试，而不是只看 Demo 的项目。
项目与资料
Nukepedia：nukepedia.com/tools/python/render/nukomfy/
GitHub：github.com/francescolorussi/Nukomfy
用户指南：github.com/francescolorussi/Nukomfy/blob/master/USER_GUIDE.md
ComfyUI Suite：github.com/francescolorussi/ComfyUI-Nukomfy-Suite
获取方式
公众号内回复：173
