核心观察
-
01
generate 支持 --async、--json、--timeout、--download，并可通过 resume 恢复异步视频任务，适合映射成 Nuke 中的提交、查询、取消和回填状态。
-
02
schema 与 list/refresh 可以帮助工具在运行前发现模型及参数，但正式项目仍应锁定已验证的模型和 CLI 版本，不能每次自动追随最新目录。
-
03
官方文档说明上传到 Comfy 托管存储的参考资产通过签名 URL 访问，并按生命周期自动删除；涉及客户素材时仍需先核对项目授权和数据策略。
-
04
这一路线调用的是云端 Partner Nodes，不等同于完全本地 ComfyUI。需要本地处理的保密镜头应继续使用批准的本地模型和隔离环境。
适合 Nuke 面板的最小任务状态机
面板提交前记录 product/model、参数、输入文件哈希、帧范围、色彩空间和目标路径；提交后保存 job ID，并显示 queued、running、succeeded、failed、expired 等状态。网络中断后应使用 resume 或状态查询恢复，而不是重复提交同一个镜头。
结果下载完成后先写入临时目录，完成哈希、分辨率、帧数和文件格式检查，再原子移动到正式版本目录并创建 Read 节点。失败任务保留错误摘要，不把 API 密钥或签名 URL写入 Nuke 脚本。
上线前必须补的生产控制
固定 CLI 和依赖版本，设置并发上限、总超时、重试退避、成本预算和取消机制；模型目录变化后先在测试镜头集回归，不直接更新生产白名单。
API 密钥存入系统凭据或服务端，不放在 gizmo、菜单脚本、工程文件和日志中。客户镜头上传前必须确认传输、留存、删除、训练使用和地域要求。