Input Shaper（输入整形）是Klipper固件中消除打印共振纹（Ring/Ghosting）的最强工具。正确配置的Input Shaper可以将振纹降低80%以上，让打印件表面光滑如镜。但很多用户在配置过程中只完成了基础的加速度计校准，忽略了后续的精细调校环节。本文将系统讲解从加速度计安装到终极参数优化全流程。
加速度计的安装与数据采集规范
ADXL345加速度计是测量打印机振动频率的核心硬件。安装位置的选择直接影响测量数据的准确性。对于CoreXY机型，最佳安装位置是打印头靠近热端处（使用3M双面胶或M3螺丝固定），因为打印头的振动是振纹的主要来源。对于笛卡尔机型，需要在X轴和Y轴分别安装加速度计：X轴固定在打印头组件上，Y轴固定在热床支架上。务必确保加速度计的X/Y方向与打印机的运动轴方向对齐，否则测量数据会完全错误。
安装完成后，通过SSH或Mainsail/Fluidd Web终端连接到Klipper，执行ACCELEROMETER_QUERY命令确认加速度计正常通信。随后，分别对X轴和Y轴执行振动频率扫描：使用命令TEST_RESONANCES AXIS=X和TEST_RESONANCES AXIS=Y，Klipper会自动控制打印头在各轴方向上进行频率扫描并记录振动数据。建议每种轴做3次扫描取平均值，以排除偶然振动干扰。
频率谱分析与整形器参数选择
扫描完成后，使用Klipper的calibrate_shaper.py脚本分析生成的CSV数据文件。在终端执行~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png，脚本会自动生成频率响应曲线图并推荐最佳的整形器类型和频率参数。频率谱图中，峰值对应的频率即为该轴的共振频率。
Klipper支持多种整形器类型，根据频率谱特征选择：如果共振峰清晰单一（一个主峰），选择EI 2-Hump或EI 3-Hump整形器，它们在消除振纹的同时对打印速度影响最小。如果有多重共振峰（多个峰值），选择MZV（最小零振动）整形器，虽然在高速度下会小幅增加打印时间，但对于复杂频率响应的抑制效果更好。如果共振频率在40Hz以下（低刚度结构），选择ZV（零振动）整形器，虽然会引入一定的跟随误差，但对低谐振系统的抑制效果最稳定。
X/Y轴独立整形参数配置
完成频率分析和整形器选择后，将推荐参数写入printer.cfg配置文件。在[input_shaper]配置段中，关键参数包括：shaper_type_x和shaper_type_y（指定各轴的整形器类型），shaper_freq_x和shaper_freq_y（指定各轴的整形频率）。注意不要使用全局shaper_type参数，因为它会将同一配置应用到所有轴，而X轴和Y轴的共振频率通常不同，统一配置会降低整形效果。
写入配置后，重启Klipper固件，打印一个20×20×150mm的细长校准立方体，在侧面检查振纹是否已消除。如果发现某条边仍有轻微振纹，可以对对应的轴微调整形频率（±1-2Hz的步长进行测试），直到振纹消失为止。如果调整整形频率后效果仍然不佳，可以尝试更换整形器类型并重新测试。
Input Shaper与Pressure Advance联动调优
Input Shaper和Pressure Advance（压力提前）是两个独立但相互影响的参数，错误的调校顺序会导致两者相互干扰。正确的调优顺序为：先关闭Pressure Advance（设为0），调好Input Shaper参数；然后在Input Shaper开启的状态下调优Pressure Advance。这种顺序确保压力前导参数是在稳定的振动环境下校准的，避免了共振纹和压力挤出不足两种缺陷的混淆。
在Input Shaper开启后的Pressure Advance调优中，使用Klipper内置的TUNING_TOWER命令：SET_PRESSURE_ADVANCE ADVANCE=0 START=0 FACTOR=0.02来打印压力提前塔。由于Input Shaper消除了共振纹，压力提前塔上的挤出缺陷会更加清晰地暴露出来，便于精确判断最佳Pressure Advance值。经过联动调优后，打印件的角落挤出均匀度可提升约50%。
无加速度计的手动校准替代方案
没有加速度计的用户也可以使用手动校准法获得合理的Input Shaper参数。方法是通过打印一系列测试立方体，每个立方体使用不同的整形频率和整形器类型组合，通过目测对比选择最佳方案。在printer.cfg中设置shaper_type = zv（ZV整形器对参数误差容忍度最高），然后以5Hz为步长从30Hz到80Hz打印多个校准模型。
推荐的替代工具是Ringo的Input Shaper校准模型（可在 Printables 或 Thingiverse 上下载），该模型包含多个小立方体阵列，每个立方体顶部标注了使用的整形频率。打印完成后，选择振纹最轻微的立方体对应的频率作为最终参数。虽然手动校准的精度不如加速度计方案，但经过仔细挑选仍然可以将振纹降低60-70%。
参考来源：Klipper官方文档 - Resonance Compensation章节；Nero 3D Input Shaper调优实战视频；Ellis' Print Tuning Guide共振补偿参数对照表。