无功补偿与滤波设计器 —— 补偿分档、滤波支路、防谐振校验
填负荷、变压器与谐波背景：得到标准 kvar 分档的补偿容量、补偿后的功率因数与降损、自动选型的滤波支路（调谐次数、容量、C/L/R），以及防谐振校验。覆盖范围是 0.4 kV 低压母线 —— 本工具所用引擎的谐波注入与支路容量口径按 0.4 kV 标定。
① 负荷与系统
本工具全链路覆盖 0.4 kV 低压母线；6/10 kV 需重新标定引擎的支路容量口径，因此不给换算值。
② 谐波背景
要治理的谐波次数
③ 补偿与滤波
引擎把滤波支路建模在**既有电容柜**之上。留空 = 新建（无电容柜）—— 此时候选支路可能被谐振复核拦下，页面如实显示该结论。
口径：Qc = P·(tan φ1 − tan φ2)，向上取标准档（引擎 yq-api/calc/pf.js）· 谐波限值按 GB/T 14549-1993 / IEEE Std 519-2022 / IEC 61000-2-2 / EREC G5/5（引擎 harmonic-limits.js）· 滤波调谐 h_r = n·(1 − 6%)、电抗率 p = 1/h_r²、R = Xc/(h_r·Q)（引擎 passive-filter.js，IEEE Std 1531 / PSCAD 惯例）· 防谐振取自同一份 Z(h) 模型（引擎 harmonic-scan.js resonanceScan：解析 h = √(Ssc/Qc) 与 1/√p，加 50 Hz 粗网格 + 极值附近 5 Hz 细化）。滤波设计是**工程近似、非最优**，不计制造公差、温漂与老化失谐。