把业务文件读成加工记录。必须写 format 和 product。裸文件和压缩包都能传，库按文件头先解开再解析。一次 parse 只出口这一列。各产品的交换文件名写在对应 API 页。
调用
import { parse } from '@dingnl/ltvis-map/parse'
const parsed = await parse(buffer, {
format: 'rstm',
// 一次只出这一列
product: 'cr'
})buffer 是 ArrayBuffer 或 Uint8Array。压缩包直接传入即可，不要先在外面解开。
传入 2～6 份同 format / 同 product 的 buffer 时，返回 ParseResult[]。每一项和单文件相同，不要把多场拼进一个 values。1 份不要包成数组；超过 6 份、网格或站心对不上会报错。开播前一次解完。切帧见 雷达时序。
文件格式
format 只认业务原件，不认压缩种类。解 .bin.gz 仍写 format: 'rstm'，不要写 gz / zip。
| format | 用来解什么 | 常见后缀 | 典型原件 |
|---|---|---|---|
rstm | QX/T 653 单站产品 | .bin | Z_RADR_I_*_P_DOR_* |
diamond | 天气雷达组网格点（MICAPS diamond 131） | .bin | Z_OTHE_RADA2DCR_*、Z_OTHE_RADAMCR_RFST_*、Z_SEVP_*_REFMOSAIC-* |
awx | 国家卫星气象中心 AWX 2.1 业务云图 | .AWX / .bin | C011_*_FY4B.AWX、C010_*_FY4B.AWX |
micaps4 | MICAPS 第 4 类地面分析场（头 diamond 4） | .001 / .000 / .txt / .bin | 平均温度 / 降水 / 冰雹 / 相对湿度 / 风速 / 海平面气压 / 露点 / 最高气温 / 最低气温 / 3小时变压 / 24小时变压 / 24小时变温 |
nc | 已带经纬的定量 NC | .NC | Z_SATE_*_L2-_OLR_*.NC 等 |
dwlp | 测风激光雷达 PPI（DWLP v1） | .bin | 一份一圈一列：radial / snr / width / intensity |
era5 | ECMWF ERA5 经纬 NetCDF3 | .nc | era5.t2m.YYYYMMDD.nc 等，按 product 取文件短名 |
nc 需要文件里带一维经纬坐标。定量产品按 product 取列，见 定量产品。测风 PPI 见 PPI 模式。ERA5 见 ERA5。不要把 ERA5 写成 format: 'nc'。
上面这些原件都可以再套压缩或打包，整包丢进 parse。按文件头认，不靠扩展名。
| 包装 | 常见后缀 | 说明 |
|---|---|---|
| gzip | .gz | 解开后是裸文件，或再拆 tar（即 tgz） |
| bz2 | .bz2 | 业务交换里很常见 |
| zip | .zip | 包内多份时，挑头能认的那一份 |
| tgz | .tgz / .tar.gz | 先解 gzip 再拆 tar |
| tar | .tar | 未再压的 tar，同样挑能认的那一份 |
套一层或两层都能解，例如 .bin.gz、.AWX.bz2、.001.zip、.NC.tgz。最多拆三步。zip / tar 里没有本包能认的成员会报错。
字段
| 字段 | 说明 | 类型 | 可选值 | 默认 |
|---|---|---|---|---|
format | 文件格式 | string | rstm / diamond / awx / micaps4 / nc / dwlp / era5 | — |
product | 按这个 key 只解一列 | string | 见各产品页 | — |
出口
解析成功后常用：
| 字段 | 说明 |
|---|---|
values | 加工记录。图层写进 data |
site | 站址或视野中心。lon / lat / stationCode / stationName |
单站格网还有 rows / cols / cellSize（米）。组网、通道图、定量、地面分析和 ERA5 是经纬格网，范围写在记录的 west / north / lonStep / latStep 上；site 只定视野中心。测风 PPI 是一圈射线，俯仰写在 pitch。
时间、站点从文件写入记录。没有时间写空串，不拦入图。数值列与 product 同名，且为 number[]。缺测留空，不要填 0。
原件可以有多列。一次只出 product 这一列；对不上再报错。