中文文档

自定义节点 用于控件与光标的画布指针 API 使用 onPointerDown 处理自定义画布控件上的单击、双击和拖拽，并从 ComfyUI 前端扩展控制画布光标。 canvas-pointer-api 自定义节点 前端扩展的连接回调迁移 onConnectionsChange 与节点移除回调的顺序、子图边界处的 SubgraphIO，以及 ComfyUI 扩展中的 graph.events。 connection-callbacks-migration 自定义节点 上下文菜单 API 迁移：ComfyUI 画布与节点菜单 将 ComfyUI 扩展从已弃用的 monkey-patching 迁移到上下文菜单 API：画布菜单与节点菜单、条件项、子菜单及旧 API 调试技巧。 context-menu-migration 自定义节点 ComfyUI 自定义节点数据类型 ComfyUI 自定义节点数据类型参考：Python 类型、张量格式（IMAGE、LATENT、MASK）、自定义类型，以及 INPUT_TYPES 中的通配符。 datatypes 自定义节点 节点扩展 掌握 ComfyUI 节点扩展，在后端自定义节点中返回新的子图。了解 GraphBuilder 要求和缓存技巧。 expansion 自定义节点 为你的 ComfyUI 自定义节点添加节点文档 如何为内置节点创建帮助文档 help_page 自定义节点 ComfyUI 自定义节点 i18n：本地化节点定义 为 ComfyUI 自定义节点添加多语言支持：locales 目录结构、nodeDefs.json 节点定义翻译，以及设置菜单的翻译。 i18n 自定义节点 图像、潜变量和蒙版 掌握 ComfyUI 自定义节点后端中图像与蒙版的数据处理。学习 PyTorch 张量形状、PIL 转换和潜变量。 images_and_masks 自定义节点 自定义节点 选择构建、扩展和发布 ComfyUI 自定义节点的正确路径。 intro 自定义节点 关于面板徽章 使用 About Panel Badges API 为 ComfyUI 关于面板添加带标签、URL 和图标的自定义徽章，并链接到文档、GitHub 或扩展资源。 javascript_about_panel_badges 自定义节点 底部面板标签页 使用 Bottom Panel Tabs API 在 ComfyUI 底部面板添加自定义标签页，包括交互元素、React 组件和独立注册。 javascript_bottom_panel_tabs 自定义节点 命令与快捷键绑定 掌握 ComfyUI 命令与快捷键绑定，为扩展注册自定义操作和快捷键。 javascript_commands_keybindings 自定义节点 ComfyUI 对话框 API 使用 ComfyUI 的 Dialog API 在桌面端和 Web 端提供标准化的 prompt 与 confirm 对话框，含用法示例和完整 API 参考。 javascript_dialog 自定义节点 ComfyUI JavaScript 扩展示例 ComfyUI JavaScript 扩展示例：右键菜单与子菜单、UI 事件、工作流开始与中断钩子，以及节点点击处理。 javascript_examples 自定义节点 ComfyUI JavaScript 钩子 ComfyUI 前端 JavaScript 钩子参考：app.registerExtension、nodeCreated、beforeRegisterNodeDef，以及自定义界面行为的回调函数。 javascript_hooks 自定义节点 Comfy 对象 ComfyUI 核心前端对象参考：LiteGraph、ComfyApp、LGraph、LLink 和 ComfyNode，包括它们的属性、函数和 widget 类型。 javascript_objects_and_hijacking 自定义节点 Javascript 扩展 了解如何通过导出 WEB_DIRECTORY、添加 .js 文件，并用 app.registerExtension 注册扩展，为 ComfyUI 添加 JavaScript 扩展。 javascript_overview 自定义节点 选择工具箱 使用 getSelectionToolboxCommands，为选中的节点、组和画布项在 ComfyUI 选择工具箱中添加自定义操作命令。 javascript_selection_toolbox 自定义节点 设置 API 使用 app.registerExtension 添加、读取、写入 ComfyUI 扩展设置并响应变更，涵盖 boolean、text、number、slider、combo、color 和 image 等设置类型。 javascript_settings 自定义节点 侧边栏标签页 掌握 ComfyUI Extension API，构建自定义 JavaScript 侧边栏标签页。查看 React 组件和动态内容更新的代码示例。 javascript_sidebar_tabs 自定义节点 ComfyUI Toast API 使用 ComfyUI 的 Toast API 显示非阻塞通知，涵盖 toast 类型（success、warning、error）、alert 辅助函数以及完整 API 参考。 javascript_toast 自定义节点 ComfyUI 顶部菜单栏 API 向 ComfyUI 顶部菜单栏添加自定义命令，包括加入现有菜单、创建子菜单，以及将同一命令放在多个位置。 javascript_topbar_menu 自定义节点 延迟求值：ComfyUI 自定义节点输入求值控制 在自定义节点中推迟输入求值：在 INPUT_TYPES 中标记 lazy，并通过 check_lazy_status 只返回当前真正需要的输入。 lazy_evaluation 自定义节点 ComfyUI 自定义节点生命周期 了解 ComfyUI 如何加载自定义节点：__init__.py 导入流程、NODE_CLASS_MAPPINGS、NODE_DISPLAY_NAME_MAPPINGS，以及用于客户端 JavaScript 的 WEB_DIRECTORY。 lifecycle 自定义节点 前端扩展的连线注册迁移 处理 addFloatingLink 返回 undefined、由 store 支撑的 graph.links 视图，以及 ComfyUI 前端扩展中的连线 ID 冲突。 link-registration-migration 自定义节点 ComfyUI 数据列表与列表处理 ComfyUI 如何在自定义节点之间以 Python 列表传递数据：长度为 1 的包装、面向批处理的列表处理，以及 INPUT_IS_LIST 和 OUTPUT_IS_LIST。 lists 自定义节点 隐藏与灵活输入 构建自定义节点时使用 ComfyUI 隐藏输入（UNIQUE_ID、PROMPT、EXTRA_PNGINFO、DYNPROMPT）和灵活输入，包括自定义数据类型和通配符输入。 more_on_inputs 自定义节点 前端扩展的节点几何迁移 节点尺寸与渲染边界的对比、applyNodePositions 的重命名，以及布局存储变更后 ComfyUI 前端扩展的绘制顺序 z-order。 node-geometry-migration 自定义节点 前端扩展的节点 ID 迁移 将 ComfyUI 前端扩展迁移到带品牌标记的字符串节点 ID，以及字符串子图边界哨兵值 SUBGRAPH_INPUT_ID 和 SUBGRAPH_OUTPUT_ID。 node-id-migration 自定义节点 节点替换 注册节点替换以帮助用户从已弃用的节点迁移 node-replacement 自定义节点 ComfyUI 自定义节点类型与架构 了解 ComfyUI 自定义节点的工作方式、客户端-服务器模型，以及四类节点：仅服务端、仅客户端、独立和连接式。 overview 自定义节点 前端扩展的 PrimeVue 移除迁移 在 ComfyUI 前端移除 PrimeVue 之后，替换 $primevue、PrimeVue 组件、--p-* CSS 变量和 PrimeVue 工具提示选择器。 primevue-removal-migration 自定义节点 前端扩展的序列化回调迁移 在使用 store 支持的图时，onSerialize 与 onConfigure 的行为方式，以及 ComfyUI 前端扩展应在何处持久化自定义数据。 serialization-callbacks-migration 自定义节点 自定义节点属性 使用 V1 模式定义 ComfyUI 自定义节点：INPUT_TYPES、RETURN_TYPES、CATEGORY、FUNCTION、执行控制属性与输入校验。 server_overview 自定义节点 ComfyUI 自定义节点 Python 代码片段 ComfyUI 自定义节点代码示例：加载和保存图像、反转蒙版、转换蒙版形状、将蒙版用作透明层，以及创建噪声。 snippets 自定义节点 子图蓝图 将可复用的节点组打包为 ComfyUI 自定义节点的子图蓝图，用户可以直接从子图菜单添加。 subgraph_blueprints 自定义节点 ComfyUI 子图 在 ComfyUI 扩展中使用子图：节点 ID、图遍历、事件、控件提升和清理。 subgraphs 自定义节点 使用 torch.Tensor 学习 ComfyUI 自定义节点所需的 torch.Tensor 基础：张量形状、squeeze/unsqueeze、记号、逐元素运算，以及张量真值判断。 tensors 自定义节点 V3 迁移指南 如何将现有的 V1 节点迁移到新的 V3 架构。 v3_migration 自定义节点 在 ComfyUI 中创建自定义节点 在 ComfyUI 中创建自定义节点的分步指南：定义 CATEGORY、INPUT_TYPES 和 FUNCTION，注册节点，并构建客户端 JS 扩展。 walkthrough