本节点实现了 TouchDesigner（以下简称 "TD"）与 ComfyUI 之间的无缝数据交互。

支持将 ComfyUI 生成的 图像、视频、点云（传统 PLY / 高斯泼溅 PLY）、音频 实时传输进 TD。

• 英文主页：https://jisenhua.github.io/ComfyUI-TD/
• 中文主页：https://jisenhua.github.io/ComfyUI-TD/zh/
• GitHub 仓库：https://github.com/JiSenHua/ComfyUI-TD

• ComfyUI-TD 的部分节点基于 ComfyUI-Tooling-Nodes 进行了移植和优化。
• ComfyUI-TD 需与 ComfyUI2TD.tox 组件配合使用（插件已上传至 tox 文件夹）。
• 请确保 ComfyUI2TD.tox 组件版本更新至 v_5.1.x 或更高版本。
  • 此版本对组件代码进行了全面重构，支持了视频与 3D 模型(点云)的数据传输。
  • 重写了 WebSocket 接口，有效解决了在网络条件较差时，使用云端 ComfyUI 可能出现的数据（图像）无法正常返回的问题。
• ComfyUI2TD.tox 组件至 v_5.1.x 版本起，预置的工作流将使用 ComfyUI-TD 节点，不再使用 ComfyUI-Tooling-Nodes。
• 旧版 ComfyUI2TD.tox 组件基于 TDComfyUI 项目开发，感谢 olegchomp！
• 若需使用云端 ComfyUI，可选择 仙宫云 服务器，配套镜像 已准备完毕。

---

请按照顺序观看以下视频：

1. ComfyUI2TD_v 5.1 新版使用教程 必看 (哔哩哔哩)
2. ComfyUI2TD 基础使用教程 (哔哩哔哩)
3. 云端部署 ComfyUI 仙宫云使用教程 (哔哩哔哩)

使用 ComfyUI-Manager 搜索 ComfyUI-TD，并直接进行节点安装。

将本项目下载后解压，放置于 X:\ComfyUI_windows_portable\ComfyUI\custom_nodes。

使用 git 命令进行安装：

cd custom_nodes
git clone https://github.com/JiSenHua/ComfyUI-TD.git

配合 ComfyUI2TD.tox 组件，使用 InjectFile 注入插件 功能，将节点自动注入至 X:\ComfyUI_windows_portable\ComfyUI\custom_nodes。

---

Hy3DtoTD
- 本节点支持将 Hunyuan3D_V2 混元V2 生成的 GLB 模型转换为点云数据，并返回至 TD 进行解析，从而生成对应的 CHOP 组件。 - 使用本节点需安装 ComfyUI-Hunyuan3DWrapper 节点。 - 若安装遇到困难，可选择使用云端 仙宫云镜像。 - ComfyUI2TD.tox 预置的工作流 Hunyuan3DV2_PointCloud 提供了此节点的基础用法示例，对应的 .js 工作流文件已上传至 workflow 文件夹。 - 最新的 ComfyUI-Hunyuan3DWrapper 已将所有模型工作流改为 trimesh。 - 建议配套安装 ComfyUI_essentials，避免运行预置工作流时报错。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的点云数据将广播至所有已建立 WebSocket 连接的客户端。

Tripo3DtoTD
- 本节点支持将 Tripo3D 生成的 GLB 模型转换为点云数据，并返回至 TD 进行解析，从而生成对应的 CHOP 组件。 - 使用本节点需安装 ComfyUI-Tripo 节点。 - API 调用更新：现已支持直接通过 ComfyUI 官方接口调用 Tripo 服务，无需再前往 Tripo 官网注册账户或单独申请 API Key，旧版的独立 API 配置方式已弃用。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的点云数据将广播至所有已建立 WebSocket 连接的客户端。

TripoSRtoTD
- 本节点支持将 TripoSR 生成的 GLB 模型转换为点云数据，并返回至 TD 进行解析，从而生成对应的 CHOP 组件。 - 使用本节点需安装 ComfyUI-Flowty-TripoSR 节点。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的点云数据将广播至所有已建立 WebSocket 连接的客户端。

Comfy3DPacktoTD
- 本节点支持将 3DPack 生成的 GLB 模型转换为点云数据，并返回至 TD 进行解析，从而生成对应的 CHOP 组件。 - 使用本节点需安装 ComfyUI-3D-Pack 节点。 - 若安装遇到困难，可选择使用云端 仙宫云镜像。 - ComfyUI2TD.tox 预置的工作流 3DPack_xxx_PointCloud 提供了此节点的基础用法示例，对应的 .js 工作流文件已上传至 workflow 文件夹。 - 3DPack 中的 Hunyuan3D_V2 与 Hunyuan3DWrapper 并不互通，请确保使用各自对应的传输节点。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的点云数据将广播至所有已建立 WebSocket 连接的客户端。 - 注意：目前仙宫云端镜像仅对 TRELLIS、Hunyuan3D_V2、TripoSR 和 StableFast3D 进行了测试。其他 3D 模型尚未验证，如遇问题请在 Issues 中反馈。

3DGStoTD
- 本节点支持将 3DGS（Gaussian Splatting  高斯泼溅）生成的 PLY 模型数据返回至 TD 进行解析，从而生成对应的 CHOP 组件。 -请确保 **ComfyUI2TD.tox 组件版本更新至 **v_5.3.x 或更高版本。 - 使用本节点需安装 ComfyUI-Sharp 节点。 - 若安装遇到困难，可选择使用云端 仙宫云镜像。 - ComfyUI2TD.tox 预置的工作流 3DGS 高斯泼溅 提供了此节点的基础用法示例，对应的 .js 工作流文件已上传至 workflow 文件夹。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的点云数据将广播至所有已建立 WebSocket 连接的客户端。 ComfyUI2TD.tox 中用于 Gaussian Splatting 高斯泼溅 的预览组件使用了 Tim Gerritsen 的成果制作，特此致谢；其插件可通过 此链接下载。

VideotoTD
- 本节点支持将视频转为数据，并返回至 TD 进行解析。 - 将你工作流中 ComfyUI-VideoHelperSuite 的 Video Combine 🎥🅥🅗🅢 替换成此节点。 - frame_rate 参数：影响视频的合成帧率，建议选择 8。 - quality 参数：控制视频的压缩质量，建议选择 75，以获得较好的数据大小与图像质量的平衡。 - 数据将通过 ComfyUI2TD.tox 解析，并生成 .MP4 格式文件保存在本地根目录中 VideoOutput 文件夹内。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的视频数据将广播至所有已建立 WebSocket 连接的客户端。

ImagetoTD
- 基于 ComfyUI-Tooling-Nodes Send Image (WebSocket) 节点二次开发。 - 本节点支持将 ComfyUI 生成的图片返回至 TD 进行解析，从而生成对应的 TOP 组件。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的图片数据将广播至所有已建立 WebSocket 连接的客户端。 - ComfyUI2TD.tox 组件至 v_5.1.x 版本起，预置的工作流将使用 ComfyUI-TD 节点，不再使用 ComfyUI-Tooling-Nodes。

AudiotoTD
- 本节点支持将 ComfyUI 生成的音频返回至 TD 进行解析，从而生成对应的 CHOP 组件。 - format 参数：支持选择输出格式为 wav 或 mp3。 - bitrate_kbps 参数：设置音频比特率，用于调节输出音频的质量与大小。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的 音频数据 将广播至所有已建立 WebSocket 连接的客户端。

ImagetoTD(JPEG)
- JPEG 传输模式：本节点会将 ComfyUI 生成的图像编码为 JPEG 压缩格式 后，通过 WebSocket 返回至 TD 进行解析生成 TOP 元件。 - 性能与场景：相比于标准的 ImageToTD 方式，JPEG 格式显著减少了传输的数据量。这不仅加快了传输与解析速度，更特别适合 云端部署 ComfyUI 的用户，能有效降低网络带宽需求。 - 画质说明：由于采用了压缩传输，图像质量相比 ImageToTD 会有所降低，请根据实际需求权衡使用。 - quality 参数：控制图像的压缩质量，建议选择 85，以获得较好的数据大小与图像质量的平衡。 - broadcast 广播参数（默认关闭）：启用该参数后，生成的图片数据将广播至所有已建立 WebSocket 连接的客户端。

LoadTDImage
- 基于 ComfyUI-Tooling-Nodes Load Image (Base64) 节点二次开发。 - 本节点支持由 TD 发送的 TOP 元件作为图像输入源发送给 ComfyUI。 - ComfyUI2TD.tox 组件至 v_5.1.x 版本起，预置的工作流将使用 ComfyUI-TD 节点，不再使用 ComfyUI-Tooling-Nodes。