WASasquatch/was-node-suite-comfyui

WAS-NS v3 Reborn; Tools for image processing, filters, masking, text, logic, numbers, latents, files, 3D scenes, and animation.

什么是 WAS Node Suite v3？

WAS Node Suite (WAS‑NS) 是 ComfyUI 的自定义节点集合，ComfyUI 是用于构建和运行 Stable Diffusion 风格图像生成管道的可视化工作流工具。该套件新增 532 个即用节点，涵盖广泛任务——图像过滤、颜色校正、遮罩、文本处理、逻辑流程、文件 I/O、动画、视频，甚至一些模型相关辅助功能。简而言之，它无需编写任何 Python 代码，即可将 ComfyUI 变成一个功能齐全的图形处理工具箱。

谁可能使用它？

艺术家与创作者：在 ComfyUI 中构建图像到图像或文本到图像工作流，并希望获得更多开箱即用的操作（例如人脸检测、渐变映射、视频帧插值）。
教育工作者与爱好者：需要大量节点库用于教学或实验生成式 AI 管道。
开发者：希望获得一个稳定、MIT 许可的基础，可扩展或嵌入付费服务。

主要特性（如 README 所述）

领域	套件提供的内容
节点数量	48 个类别中的 532 个节点（遮罩、图层、颜色/LUT、HDR、逻辑、数字、文本、提示词、文件、动画、LoRA 等）。
无强制依赖	克隆到 `ComfyUI/custom_nodes` 后，套件仅需 ComfyUI 0.14+ 和 Python 3.10+ 即可运行。不会自动执行 pip 安装。
可选功能组	`config.yaml` 中有 22 个可切换组；默认禁用 8 个（例如文档导出、网络密集型模型）。
内置第三方资源	捆绑字体、three.js、人脸级联文件、多个预训练网络及其他库——均采用宽松许可，无需运行时下载。
安全优先	默认禁用出站网络调用；文件访问通过允许列表控制。
升级路径	兼容早期版本保存的工作流；README 说明了如何处理已退役或移除的节点 ID。
文档导出（可选）	启用 `document_export` 组后，可直接从工作流写入 `.docx`、`.odt` 或 `.pdf` 文件。
Three.js 场景支持	使用 three.js 渲染交互式 3D 场景的节点；出于安全考虑，执行由配置标志控制。
模型权重处理	除非启用 `features.network`，否则不会下载任何权重。启用后，套件可以拉取随附的少量模型文件。

如何安装

通过 ComfyUI Manager – 搜索 WAS Node Suite v3 并点击安装（推荐）。
手动安装 – 将仓库克隆到 ComfyUI/custom_nodes：
```
cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/was-node-suite-comfyui.git
```
套件适用于 ComfyUI 0.14+ 和 Python 3.10+。除非启用可选组（例如 document_export），否则无需额外的 pip 命令。

版本 3 相比版本 2 的新特性

节点数量翻倍以上 – 从 220 个增加到 532 个。
默认零外部包 – v2 安装了约 20 个包；v3 除非选择启用，否则不安装任何包。
可选功能组 – 可通过 config.yaml 启用/禁用整个类别。
更新的第三方资源 – 现在包含 three.js、字体、人脸级联以及一些预训练网络。
改进的节点行为 – 许多节点已重写，完全在 ComfyUI 的设备上运行（无 OpenCV、无额外库），并且多个节点具有更丰富的选项（例如更多混合模式、更好的颗粒处理）。

配置与扩展性

首次运行时会生成 config.yaml 文件，位于 <ComfyUI user dir>/was-node-suite/。它镜像 config.example.yaml，允许您切换 22 个功能组、启用网络下载或调整安全允许列表。
节点可通过同一配置 逐节点禁用，有助于精简生产环境。
可以添加新的第三方代码，但出于安全考虑，任何文件访问都必须在配置中列入白名单。

许可证与社区

MIT 许可证——您可以自由使用、修改和重新分发该套件。
所有捆绑的第三方文件均带有各自的宽松许可证，并包含在 docs/THIRD_PARTY.md 中。
项目欢迎通过 GitHub issues 和 pull requests 贡献；提供了贡献指南。
包含一个小额捐赠链接（PayPal）供支持者使用。

快速入门清单

安装 ComfyUI 0.14+。
通过管理器或手动克隆添加套件。
启动 ComfyUI——套件将在首次运行时编译为字节码。
（可选）编辑 <ComfyUI user dir>/was-node-suite/config.yaml 以启用额外组，如 document_export 或 network。
打开 NODES.md 文件查看节点输入/输出的完整列表，或在 ComfyUI 内浏览节点面板。

简而言之： WAS Node Suite v3 是一个大型、MIT 许可的 ComfyUI 插件，提供数百个即用型图像处理和工作流控制节点，采用安全优先的设计，并可按需启用可选功能。它面向在 ComfyUI 中构建生成式 AI 图像管道的任何人，从休闲创作者到开发商业服务的开发者。