#高级配置

#模型白名单与过滤

节点从 GET /v1/worker/config/comfy 拉取目录;filter 参数按 workflowDependencies 键子串过滤,可让节点只暴露目标模型族(如 filter=minimax-h3)。目录文件缺失时节点上报零模型——宁缺勿滥,避免误报能力。

#显存释放(/free)

任意跨工作流切换前先调用 /free 释放已加载权重。这是当前 fork 的既定行为约定:跳过会导致显存碎片与切换失败;节点兼容层已内置该约定,自研接入方同样应遵守。

#资产目录

• 资产白名单根为 <root>/downloads/comfy-assets;产物与缓存集中于此,便于配额与清理;
• Docker 打包节点镜像时,working_dir 必须为 ComfyUI 根,否则兼容层与模板解析失效。

#安全配置

GET /v1/worker/config/prompt-safety 提供 fail-closed 口径的提示词安全配置(端点常驻;当前词表为占位哨兵,真实词表由运营配置接入后替换)。节点执行时按该配置处理敏感内容。

#升级

节点从不自升级:版本更新由主机侧运维完成(更新镜像/仓库后重启容器)。服务端仅触发与校验,不存在节点内的自动升级通道。工作流模板同样随镜像发布。