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

# 视频稳定 (Video Stabilize)

> 用 ffmpeg 的 deshake 滤镜进行快速单趟防抖。

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

## 这个节点是做什么的

**Video Stabilize** 用 ffmpeg 的 `deshake` 滤镜平滑 `COMFYTV_VIDEO` 中的相机抖动。它逐帧搜索最佳匹配位移并反向移动画面以保持稳定。这是快速的单趟稳定器；需要更强效果请用 **Stabilize Pro**。点 **▶ 运行** 处理并写出新的视频快照。

**video** 上必须接入源素材。输入输出都是 `COMFYTV_VIDEO`。要与原生 ComfyUI 节点互通，请插入 **Bridge** — 见[桥接说明](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。

## 适用场景

* 无需完整两趟分析，快速抚平手持抖动。
* 处理轻微抖动，又不想用 **Stabilize Pro** 的重处理时。

## 参数说明

### range\_x（水平搜索范围）

搜索的最大水平位移，单位像素，`8`–`64`，默认 `16`（内部四舍五入到 16 的倍数）。越大能纠正越大的水平抖动，但计算成本更高。

### range\_y（垂直搜索范围）

搜索的最大垂直位移，单位像素，`8`–`64`，默认 `16`。越大纠正越大的垂直抖动。

### edge（边缘填充）

画面移动后暴露的边缘如何填充。选项：`mirror`（默认，反射边缘）、`blank`（黑边）、`original`（保留原始边缘像素）、`clamp`（延展边缘像素）。`mirror` 通常最能隐藏位移。

## 输出说明

| 输出        | 类型              | 含义        |
| --------- | --------------- | --------- |
| **video** | `COMFYTV_VIDEO` | 稳定后的新项目快照 |

## 使用提示

* 对于强烈或滚动抖动，**Stabilize Pro**（两趟，带相机路径平滑和自动缩放）效果明显更好。
* `blank` 边缘会以黑边暴露纠正痕迹；`mirror` 或 `clamp` 能隐藏，代价是一些边缘失真。

## 相关节点

* **Stabilize Pro**——更强的两趟稳定，带平滑和自动缩放。
* **Blur / Sharpen**——若稳定使画面发虚可重新锐化。