技能介绍

要解决什么问题

发电机励磁系统现场试验里，录波仪常导出 TK2 二进制（含 WFLC/TK 一类命名），通道里会有 UAB、UBC、UCA、UFD、Uld、IFD 等模拟量。这类文件头里是 GBK/ASCII 通道元数据，波形区是 小端有符号 int16 按固定通道顺序排列；手工用通用示波器软件读，往往对不上厂家头部长度，采样率、单周波 RMS 和阶跃指标也不好和报告口径一致。

本技能面向 励磁录波后处理：把脆弱的二进制解析、归一化曲线和试验指标计算收敛到一条可重复流程，并产出可审计的中间文件（CSV/JSON）与报告用图（PNG）。

技能如何工作

优先运行技能内捆绑脚本，由它完成解析与绘图。默认会从头部长度启发式定位波形起点（剩余字节能整除 6 × int16 采样），并按观测到的通道顺序读取六路数据。采样率可从选定相电压的 正向过零 推断（例如 50 Hz、512 点/周对应约 25600 Hz）；若自动检测失败，需显式指定头偏移与采样率后重跑。

常见处理模式：

单相模式（报告默认口径）：对 UAB / UBC / UCA 之一做 单周波 RMS，响应曲线按初始稳态值归一化；UFD、Uld、IFD 用单周波算术平均。
三相模式：分别算三路 RMS 再 取平均；不要与单相图混用指标。

--kind step 时可估计阶跃相关量：amp_pct、Mp_pct、Tup_s（10%～90% 上升时间）、Tp_s、Ts_s（进入终值 ±5% 带的时间）等。--kind decay 时从归一化电压首次低于 0.999 到跌至初值 1/e 的时间得到 T_decay_1e_s，在试验接线与方法与报告一致时可作脉冲封锁开路衰减时间常数参考。

输出通常包括：*_curve.png（归一化电压响应）、*_series.csv（逐周时间、电压 RMS、UFD/IFD 均值）、*_metrics.json（采样信息与指标）。写入 Word 报告时应写明计算依据（如「按 UAB 单相有效值计算」），图题与计算模式一致。

适用边界与注意点

解析假设来自 Manla 励磁试验 一类录波模式；若文件头布局或通道顺序与现场设备不一致，自动头检测可能失败，必须手工指定参数。阶跃检测有默认时间窗，若阶跃发生在窗外需调整 --step-start-s / --step-end-s。指标写入正式报告前应先核对 JSON；不要把三相平均指标配在单相曲线上。