> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Audio Repair（音频修复）
> 用针对性的修复滤镜解决具体的音频瑕疵——咔哒声与爆音、削波/失真峰值、非规格化数、以及市电频率哼声。
## 这个节点是做什么的
**音频修复 (Audio Repair)** 对音轨施加一种修复处理，由 **method** 决定：
* **declick** —— 去除脉冲式咔哒与爆音（FFmpeg `adeclick`），如黑胶爆豆或剪辑点的咔嗒。
* **declip** —— 从失真、过响的录音中重建被削平的峰值（FFmpeg `adeclip`）。
* **denorm** —— 修正非规格化数问题（FFmpeg `adenorm`），此类问题可能在极安静段落引发 CPU 尖峰或细微伪影。
* **wavelet** —— 小波域降噪（FFmpeg `afwtdn`），针对宽带噪声，可精细控制强度与细节。
* **hum** —— 通过陷波掉基频及其谐波来去除市电哼声（一叠 FFmpeg `bandreject` 滤镜）。
输入为 `COMFYTV_AUDIO` 快照（也可接 `COMFYTV_VIDEO`，会取其音轨），输出处理后的 `COMFYTV_AUDIO` 以及一个 `fx_spec`。它带有 ▶ **运行**（处理由 FFmpeg 完成）。若未接源音频，只发出 `fx_spec` 以便串联。
要与 ComfyUI 原生 `AUDIO` 互通，请插入 **Bridge**——见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。
## 适用场景
* 清掉数字化黑胶或老磁带上的爆豆与咔哒（**declick**）。
* 抢救录制电平过高、已经削波的素材（**declip**）。
* 陷波掉 50 Hz 或 60 Hz 的电流嗡声及其谐波（**hum**）。
* 当宽带方法听起来太糊时，做一次可控的高质量降噪（**wavelet**）。
## 参数说明
### method
选择处理器：`declick`（默认）、`declip`、`denorm`、`wavelet`、`hum`。下方参数按所属 method 分组。
### declick 参数（`dk_*`）
* **dk\_window** —— 检测窗口大小。范围 **10–100**，默认 **55**。
* **dk\_threshold** —— 咔哒检测灵敏度。范围 **1–100**，默认 **2**。越低捕获越多（也更易误判）。
* **dk\_burst** —— 对连续咔哒爆发的处理力度。范围 **0–10**，默认 **2**。
### declip 参数（`dc_*`）
* **dc\_threshold** —— 削波检测阈值。范围 **1–100**，默认 **10**。
* **dc\_hsize** —— 重建窗口（历史长度）。范围 **100–9999**，默认 **1000**。
### denorm 参数（`dn_*`）
* **dn\_level** —— 非规格化处理电平（dB）。范围 **-451 到 -90**，默认 **-351**。
### wavelet 参数（`wt_*`）
* **wt\_sigma** —— 噪声强度。范围 **0–1**，默认 **0**。**必须大于 0**——在 wavelet 模式下留为 0 时节点会报错。
* **wt\_percent** —— 去除检测到的噪声的比例（百分比）。范围 **0–100**，默认 **85**。
* **wt\_levels** —— 小波分解层数。范围 **1–12**，默认 **10**。
### hum 参数（`hum_*`）
* **hum\_freq** —— 哼声基频（Hz），如市电的 50 或 60。范围 **10–2000**，默认 **50**。
* **hum\_harmonics** —— 陷波掉基频的多少个谐波。范围 **1–16**，默认 **8**。超过奈奎斯特上限的谐波会被跳过。
* **hum\_q** —— 陷波滤镜的宽度（Q）。范围 **1–100**，默认 **8**。谐波越高 Q 逐级加宽。
## 输出说明
| 输出 | 类型 | 含义 |
| ------------ | ---------------- | ---------------------- |
| **audio** | `COMFYTV_AUDIO` | 修复后的音频快照 |
| **fx\_spec** | `COMFYTV_FXSPEC` | 本步骤的 spec，可串入 FX Chain |
## 小贴士
* **Wavelet 需要 `wt_sigma` > 0**，否则节点报错——它不会静默地什么都不做。
* 把 **hum\_freq** 对准本地市电：世界多数地区为 **50** Hz，北美与部分亚洲地区为 **60** Hz。
* `declip` 重建的是波形；它无法找回硬削波真正丢失的细节，但能去掉刺耳的嗡鸣。
## 相关节点
* **Audio Denoise** —— 宽带嘶声/哼声削减与静音裁剪（`afftdn` / `anlmdn` / `silenceremove`）。
* **Audio EQ** —— 用 peak 衰减也能针对单一共振频率下手。
* **FX Chain** —— 把多个 `fx_spec` 步骤（含本节点）一趟渲染完成。