> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 高级配置

## 模型白名单与过滤

节点从 `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 口径的提示词安全配置(端点常驻;当前词表为占位哨兵,真实词表由运营配置接入后替换)。节点执行时按该配置处理敏感内容。

## 升级

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