> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# FillHoles - ComfyUI Built-in Node Documentation

> 此节点通过检测开放边界边并创建新的面来闭合这些边，从而填充 3D 网格中的孔洞。

此节点通过检测开放边界边并创建新的面来闭合这些边，从而填充 3D 网格中的孔洞。它在 GPU 上运行，保留现有几何体和 UV，可处理单个网格、网格列表或批量网格。

## 输入

| 参数                 | 描述                                               | 数据类型    | 是否必须 | 范围                    |
| ------------------ | ------------------------------------------------ | ------- | ---- | --------------------- |
| `mesh`             | 要处理的 3D 网格。接受单个网格、网格列表或批量网格。                     | MESH    | 是    | -                     |
| `max_perimeter`    | 要填充的最大孔洞周长。0 表示禁用。（默认值：0.03）                     | FLOAT   | 是    | 0.0 to no upper limit |
| `weld_epsilon_rel` | 预焊接容差（边界框对角线的比例）；边界检测需要焊接后的顶点。0 表示跳过。（默认值：1e-5）  | FLOAT   | 是    | 0.0 to no upper limit |
| `max_vertices`     | 每个周期的边界顶点上限；质心扇形仅适用于小的近平面孔洞。保持 ≤16。（默认值：16）      | INT     | 是    | 3 到 1024              |
| `fill_chains`      | 同时填充开放链（不仅仅是闭合环）。噪声较大；关闭时与 cumesh 匹配。（默认值：False） | BOOLEAN | 是    | True or False         |

注意：当 `weld_epsilon_rel` 大于 0 时，节点会在检测孔洞之前预焊接重复顶点。焊接容差从给定的边界框对角线比例开始，并通过倍增自动增大，直到网格被视为已焊接或容差达到 1e-2 的上限。边界顶点超过 8 个的孔洞使用质心扇形填充（插入新的质心顶点），而较小的孔洞使用顶点扇形填充，复用现有的边界顶点。

## 输出

| 输出名称   | 描述                  | 数据类型 |
| ------ | ------------------- | ---- |
| `mesh` | 已填充孔洞的网格，与输入批量格式匹配。 | MESH |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/FillHoles/zh.md)

***

**Source fingerprint (SHA-256):** `c0fd7f0c2d6eea098efb1dcfd80eaa52997e185b9c442b483f75318eea082196`