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

# Histogram Equalize

> 重新分布影调以扩展平淡素材的对比 —— 带强度旋钮和可选的 CLAHE 式限幅来抑制噪点。

<Frame caption="Histogram Equalize · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="Histogram Equalize" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 节点用途

**Histogram Equalize（直方图均衡）** 让片段的影调值在整个范围内分布得更均匀，从平淡、低对比或雾蒙蒙的素材中拉出细节。经典的直方图均衡可能显得生硬，因此本节点加入了 **strength** 混合（在原图与完全均衡之间过渡）以及 **clip\_limit**，后者限制任一单个影调被拉伸的幅度 —— 即 CLAHE 的思路 —— 以防止噪点和天空过曝。

它输入输出均为 `COMFYTV_VIDEO`，在 torch 后端（`histeq`）上渲染，因此带有 **▶ Run**，卡片上有实时预览。strength 为 0 时片段原样通过。

要与原生 ComfyUI 节点互通，请加一个 **Bridge**（见 [Bridge 指南](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)）。

## 何时使用

* 拯救平淡、低对比或雾气的镜头
* 在进一步调色前带出暗部/高光细节
* 以可控方式提升局部对比（配合 clip\_limit）

## 参数

### strength

均衡的推进程度，默认 0.5，范围 0.0…1.0。这是一个混合：0.0 为未改动的片段（节点变为直通），1.0 为完全均衡。从 0.4–0.6 附近起步，若显得生硬则回退。

### clip\_limit

限制任一单个直方图 bin 可容纳的比例，默认 0.0，范围 0.0…0.1（步长 0.005）。`0` 表示关闭（普通均衡）。较小的正值（即 CLAHE 式对比限制）可防止在天空等平坦区域过度放大噪点。若均衡放大了颗粒，可轻轻抬高。

## 输出

| 输出        | 类型              | 含义         |
| --------- | --------------- | ---------- |
| **video** | `COMFYTV_VIDEO` | 对比均衡后的片段快照 |

## 提示

* strength 为 0 时节点无任何作用 —— 调高才能看到效果。
* 若均衡使噪点或色带变糟，加一点 `clip_limit`，而不是把 strength 一路调低。
* 它是最大化对比而非匹配某种风格 —— 之后接 **Video Color** 或 **Video LUT** 做最终调色。

## 相关节点

* **Auto White Balance** —— 另一个单旋钮自动校正器（中性色彩）
* **Video Color** —— 手动曝光、色阶与调色
* **Video Curves** —— 需要精确控制时手工塑造对比
