mcpField
C
comfyui-nodes-dev

comfyui-nodes-dev

github.com/jimlee2048开发292 次安装
代码仓库

关于 comfyui-nodes-dev

comfyui-nodes-dev 是用于开发 ComfyUI V3 服务端 Python 自定义节点的技能，涵盖实现、注册与验证，并提供 Schema、I/O、预览和执行模式参考。

主要功能

  1. 01V3 节点实现流程
  2. 02API 适配器选择指引
  3. 03节点包脚手架指引
  4. 04节点注册与入口配置
  5. 05I/O、预览和验证参考

适用场景

  1. 01开发 ComfyUI V3 服务端节点
  2. 02搭建自定义节点包
  3. 03查阅输入、输出与缓存模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jimlee2048/skills --skill comfyui-nodes-dev

安装后在 Claude Code 中输入/comfyui-nodes-dev确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
v3_extension_template.py
references/
folder-paths-and-files.md
image-mask-performance.md
io-types.md
lazy-evaluation.md
scaffold.md
schema-nodeoutput.md
ui-helpers.md
v3-core.md
validation-and-caching.md

详细介绍

ComfyUI V3 自定义节点（服务端）

ComfyUI 基线版本：v0.12.0（Comfy API v0_0_2）。修订此技能时请更新此行。

范围

  • 专注于服务端 V3 节点（Python）。
  • 不包括客户端-服务端扩展模式和纯前端扩展。

快速工作流

  1. 选择 API 适配器：使用 comfy_api.v0_0_2 保持稳定，或使用 comfy_api.latest 获取最新功能。
  2. （可选）使用 comfy node scaffold 搭建节点包。
  3. 使用 io.ComfyNode.define_schema() 和 execute() 实现 V3 节点。
  4. 从 execute() 返回 io.NodeOutput（或元组/字典）。
  5. 通过 ComfyExtension.get_node_list() 和 comfy_entrypoint() 注册节点。
  6. 重启 ComfyUI，并在 UI/API 中验证。

应做 / 不应做

  • 应使用类方法 define_schema() 和 execute()。
  • 应从 execute() 返回 io.NodeOutput（或元组/字典）。
  • 应使用 ui.Preview* 辅助工具显示 UI 预览。
  • 不应在节点中存储可变的实例状态。
  • 不应使用客户端-服务端扩展模式（不属于本技能的范围）。

参考索引

按需使用以下参考资料（渐进式披露）：

  • references/v3-core.md：API 版本、ComfyExtension、进度报告。
  • references/io-types.md：IO 类型、控件输入、自定义类型。
  • references/schema-nodeoutput.md：Schema 字段、标志、隐藏输入、NodeOutput 模式。
  • references/ui-helpers.md：用于 UI 输出的预览和保存辅助工具。
  • references/scaffold.md：搭建工作流和 V3 默认设置。
  • references/lazy-evaluation.md：延迟输入、check_lazy_status、执行阻塞。
  • references/validation-and-caching.md：validate_inputs 和 fingerprint_inputs 模式。
  • references/folder-paths-and-files.md：folder_paths 辅助工具以及保存/加载模式。
  • references/image-mask-performance.md：张量形状、缩放、批处理、设备使用技巧。
  • 官方文档：Comfy-Org/docs custom-nodes

模板

  • assets/v3_extension_template.py：包含最简 V3 节点、扩展和入口点。

评论

支持 Markdown