SuperAPI AI 工具集

comfy-custom-nodes-frontend

前端与建站

查看项目

更新于 10-20 17:54

技能介绍

用途:该技能是 ComfyUI 自定义节点包发布浏览器端资源时使用的打包回退方案,用于把节点包中的前端目录暴露给 ComfyUI 前端加载。

主要能力:

  • 支持两种声明前端目录的方式,二者都写入同一个按名称索引的注册表。
  • 方式一:在包的 init.py 中设置模块级 WEB_DIRECTORY,键为包目录名。
  • 方式二:在 pyproject.toml 中配置 [tool.comfy].web,键为 project.name。
  • 两种声明都只在目录确实存在于磁盘时被接受;相对路径错误会被静默跳过且不报错,因此“脚本始终不加载”通常就是路径问题。
  • [tool.comfy].web 还要求运行时能够读取 pyproject.toml,否则只记录一条日志警告并跳过,因此 WEB_DIRECTORY 的前置条件更少。

使用方式与注意:

  • 只声明其中一种。同时声明时按名称解析而非合并:名称相同(常见情况)时 WEB_DIRECTORY 后生效,并静默丢弃 pyproject.toml 中的条目;名称不同时两个前缀都会服务,但对同一名称的第二次注册会抛错。
  • 文件通过 /extensions/<name>/… 路径提供,前端加载的清单只枚举 **/*.js,因此 TypeScript 或 JSX 必须先构建为 .js。
  • 扩展名称必须唯一,重复注册会报错。

适用场景:为 ComfyUI 自定义节点包附带浏览器端脚本或前端资源,并希望在不依赖额外构建流程的情况下提供回退加载路径。

限制与安全约定:

  • 前端状态仅用于展示。Python 节点读取的每个非机密值都必须保存在持久化的 widget 值里,因为通过 API 提交的 prompt 没有浏览器层。
  • 切勿把凭据放进 widget 值,机密应从环境变量或运行时的机密机制读取。