# STDF V4 支持清单

MoonSTDF 已支持 **STDF V4 基础标准全部 25 种在用记录及全部标准字段解析**，没有处于“开发中”的基础 V4 记录。列表以基础 V4 规范为准，不把旧 V3 已废弃记录或 V4-2007 新增记录计入。处理流程：文件读取 → 记录解析 → 结构化校验 → JSON/JSONL 输出。

| 记录 | REC_TYP/REC_SUB | 标准字段数 | 状态 | 内容 |
|---|---|---:|---|---|
| FAR | 0/10 | 2 | 已支持 | CPU 表示与版本 |
| ATR | 0/20 | 2 | 已支持 | 审计时间与命令 |
| MIR | 1/10 | 38 | 已支持 | 批次与测试环境 |
| MRR | 1/20 | 4 | 已支持 | 批次结束 |
| PCR | 1/30 | 7 | 已支持 | 芯片计数 |
| HBR | 1/40 | 6 | 已支持 | 硬件分档 |
| SBR | 1/50 | 6 | 已支持 | 软件分档 |
| PMR | 1/60 | 7 | 已支持 | 引脚映射 |
| PGR | 1/62 | 4 | 已支持 | 引脚组 |
| PLR | 1/63 | 8 | 已支持 | 引脚显示模式与字符 |
| RDR | 1/70 | 2 | 已支持 | 复测分档 |
| SDR | 1/80 | 20 | 已支持 | 站点组与设备描述 |
| WIR | 2/10 | 4 | 已支持 | 晶圆开始 |
| WRR | 2/20 | 14 | 已支持 | 晶圆结束 |
| WCR | 2/30 | 9 | 已支持 | 晶圆几何与坐标方向 |
| PIR | 5/10 | 2 | 已支持 | 芯片开始 |
| PRR | 5/20 | 12 | 已支持 | 芯片结果 |
| TSR | 10/30 | 16 | 已支持 | 测试汇总 |
| PTR | 15/10 | 20 | 已支持 | 单结果参数测试 |
| MPR | 15/15 | 27 | 已支持 | 多结果参数测试 |
| FTR | 15/20 | 28 | 已支持 | 功能测试 |
| BPS | 20/10 | 1 | 已支持 | 程序段开始 |
| EPS | 20/20 | 0 | 已支持 | 程序段结束 |
| GDR | 50/10 | 2 | 已支持 | 全部标准泛型数据码 |
| DTR | 50/30 | 1 | 已支持 | 文本数据 |

支持 CPU_TYPE 0（VAX F/D）、1（IEEE 大端）、2（IEEE 小端）；保留原始字节、源偏移、显式缺失字段及数组。`decode_v4_record`/`dump` 提供完整字段；`validate_v4`/`validate` 提供顺序、引用和生命周期等已列明的检查。`valid` 不是全部业务语义或厂商兼容认证。

验证：`moon build --target js --deny-warn` 后运行 `python tools/test_v4_coverage.py`，对照 [覆盖清单](fixtures/v4-coverage.json) 中三种表示的原创样本。每种表示均有 27 条记录；测试核对全部字段存在、数量、原始字节及已知值。用 `python tools/generate_demo.py --check` 核对仓库 JSON 示例是否与实际 CLI 一致。

更详细的省略规则、分析投影与校验边界见 [兼容性文档](docs/compatibility.md)。V4-2007、压缩输入、ATDF、写回及硬件采集当前不支持，不列为已完成能力。
