PreDetailerFix
节点功能：用于图像生成前的预处理阶段，特别针对局部细节区域进行精细修复或增强。
输入参数
| 参数名称 | 说明 |
|---|---|
| pipe | 上游生成流程的 pipe 数据结构。 |
| bbox_segm_pipe | （可选）传入 bbox 分割流程的 pipe。 |
| sam_pipe | （可选）传入用于生成 mask 的 SAM 流程 pipe。 |
| optional_image | （可选）传入覆盖 pipe 内的图像。 |
输出参数
| 参数名称 | 说明 |
|---|---|
| pipe | 更新后的流程数据，包含 detail_fix_settings 配置。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| guide_size | 指定引导图（bbox 或 crop）缩放后的尺寸。 |
| guide_size_for | 引导图尺寸应用目标。开启表示应用于 bbox，关闭表示应用于 crop 区域。 |
| max_size | 限制最大图像放大尺寸，单位为像素。 |
| seed | 随机种子。相同 seed 可复现相同结果。 |
| steps | 采样步数，控制细化迭代次数。 |
| cfg | 提示词引导强度（Classifier Free Guidance）。 |
| sampler_name | 采样器名称。 |
| scheduler | 调度器名称。 |
| denoise | 去噪强度。 |
| feather | 区域边缘羽化（模糊）半径。 |
| noise_mask | 是否启用噪声掩码辅助细化。 |
| force_inpaint | 强制使用 inpaint 模式对引导区域修复。建议开启，确保不会越界影响非目标区域。 |
| drop_size | 滤除小尺寸目标的最小像素阈值。 |
| wildcard | 多轮细化时用于变体提示词拼接的字符串模板。 |
| cycle | 重复细化次数，每次随机提示。 |
由于在UltralyticsDetector (Pipe)节点中选择的是face模型，所以这里做的是脸部修复。
此处可根据所选的检测类型（如人脸、手部、眼睛、头发或人物检测）自动对应执行相应区域的细节修复操作。选择哪种检测类型，preDetailerFix 节点即会针对该区域进行精准修复。
还有就是SAMLoader (Pipe)节点中选择以下三个模型，其他模型会报错。
guide_size_for 的两个选项说明：
| 选项值 | 意义 | guide_size 应用于 | 应用场景 |
|---|---|---|---|
True （"bbox"） | 以目标检测出的边界框为基础，缩放到指定 guide_size 尺寸 | 目标区域的 包围盒（bounding box） | 人脸、手、人物等对象检测后统一缩放修复区域大小 |
False（"crop_region"） | 以剪裁区域本身尺寸为基础，不固定缩放大小 | 实际区域图像本体 | 更自然保留原始区域比例，适合自由修复风格 |
假设检测到了一个脸部区域，原始尺寸为 150×150：
✅ 当 guide_size_for = True (bbox)：
- 该 150×150 的区域将被 统一缩放到 256×256（或你设置的 guide_size）
- 有利于统一风格和采样尺度，适合在人脸修复等对齐需求中使用
✅ 当 guide_size_for = False (crop_region)：
- 系统使用检测出的真实尺寸，保持原始分辨率关系进行修复
- 更灵活自然，适合自由区域或艺术风格修复
wildcard：可注入 prompt 中的可变元素（如随机角色名、表情等）。如下，添加smiling表情。
cycle：修复重复执行次数，用于增强修复效果。如下，cycle设置为2，会进行2轮修复。