preMaskDetailerFix

preMaskDetailerFix 对由现有遮罩定义的区域执行一次 detailer fix 采样过程。它属于 EasyUse/Fix 类别，并基于 EasyUse pipeline 运行。与基于检测器的 detailer fix 节点不同，它不需要目标检测模型：所提供的 mask 直接定义被裁剪、采样并合成回图像的区域。

输入

必填

名称	类型	默认值	描述
`pipe`	`PIPE_LINE`	—	包含修复过程所用模型、CLIP、VAE、条件、Latent 和图像数据的 EasyUse pipeline。此节点会在其输出端返回已更新的 pipeline。
`mask`	`MASK`	—	定义要修复区域的遮罩。其边界框/裁剪区域决定了发送到 detailer 采样过程的区域。
`guide_size`	`FLOAT`	—	传入采样器的区域的目标大小。较小的区域会在采样之前放大到该大小。此节点未指定默认值。
`guide_size_for`	`BOOLEAN`	`true`	控制 `guide_size` 是应用于边界框（`true`）还是应用于扩展后的裁剪区域（`false`）。
`max_size`	`FLOAT`	—	采样裁剪允许的最大大小。较大的裁剪会在采样之前缩小到此限制。此节点未指定默认值。
`mask_mode`	`BOOLEAN`	`true`	启用时，所提供的 `mask` 将用作 detailer 的工作遮罩。禁用时，该遮罩将被忽略。
`seed`	`INT`	`0`	用于采样的随机种子。
`steps`	`INT`	`20`	detailer 过程的采样步数。
`cfg`	`FLOAT`	`8`	采样期间使用的 CFG 缩放。
`sampler_name`	`COMBO`	—	要使用的采样器，从可用的 ComfyUI 采样器中选择。
`scheduler`	`COMBO`	—	要使用的调度器，从可用的 ComfyUI 调度器中选择。
`denoise`	`FLOAT`	`0.5`	修复过程的 denoise 强度。较低的值会保留更多原始图像。
`feather`	`INT`	`5`	在将采样结果合成回图像之前，应用于遮罩边缘的羽化半径。
`crop_factor`	`FLOAT`	`3`	控制遮罩或边界框周围包含多少上下文。裁剪区域会在采样之前按此因子扩展。
`drop_size`	`INT`	—	遮罩区域的最小大小阈值。如果区域小于此值，则跳过 detailer 修复。
`refiner_ratio`	`FLOAT`	`0.2`	为 refiner 模型保留的步数比例（如果 pipeline 中包含该模型）。
`batch_size`	`INT`	`1`	每次采样批处理生成的样本数。
`cycle`	`INT`	`1`	重复 detailer 修复循环的次数。每个循环都使用上一个循环的输出。

可选

名称	类型	默认值	描述
`optional_image`	`IMAGE`	—	如果提供，则使用此图像代替存储在 `pipe` 中的图像。省略时，将使用 pipeline 中的图像。
`inpaint_model`	`BOOLEAN`	`false`	如果已加载的模型支持，则启用使用图像修复模型进行采样。
`noise_mask_feather`	`INT`	`20`	当启用 `inpaint_model` 时，应用于噪波遮罩的羽化。

输出

名称	类型	描述
`pipe`	`PIPE_LINE`	已更新的 EasyUse pipeline，包含经过 detailer 修复的图像和 Latent，可供下游节点使用。

使用说明

当您已经知道要修复的区域时，请使用此节点。为区域绘制或生成遮罩，将其输入到 mask，detailer 过程将仅限于该区域。
禁用 mask_mode 后，遮罩输入将被忽略。这对于比较行为或当您希望依赖其他 pipeline 逻辑时非常有用。
crop_factor 控制采样器看到的周围上下文量。较大的值有助于模型更好地理解区域，但也会增加裁剪大小和处理成本。
denoise 控制区域被更改的强度。较低的值对于小范围修复更安全，而较高的值则适用于显著的重新生成。
cycle 会重复运行修复。循环次数越多，结果越精细，但也会增加处理时间。
使用 inpaint_model 时，请保持启用 mask_mode，并确保已加载的 checkpoint 或模型支持图像修复。noise_mask_feather 可平滑噪波遮罩的边界，并防止出现可见的接缝。
此节点仅输出 PIPE_LINE，因此请将其连接到 pipeline 输出节点或其他 EasyUse 节点，以查看或使用生成的图像。

pre Mask Detailer Fix

输入

必填

可选

输出

使用说明

评论