参考
项目与公共格式
查询清单、锁文件、字节码、YXB、工程协议、报告与原生 ABI 主版本。
| 格式 | 当前主版本 | 兼容读取 | 主要标识 |
|---|---|---|---|
| 包清单 | 2 | 1、2 | [包].格式 |
| 锁文件 | 2 | 1、2 | lock_version |
| 字节码块 | 1 | 1 | Chunk.format_version |
| YXB 应用 | 1 | 1 | format_version与内容校验和 |
| 工程协议 | 1 | 1 | protocol_version |
| 原生扩展 ABI | 1、2 | 对应 ABI | abi_version与struct_size |
| 测试报告 | 1 | 1 | test-report-v1 |
| 兼容报告 | 1 | 1 | compatibility-report-v1 |
| C ABI 结果 | 1 | 1 | JSON schema |
| 标准库清单 | 1 | 1 | stdlib-api-v1 |
实现必须拒绝未知主版本,不得猜测解析。同一主版本只能增加接收方明确忽略的可选字段;删除字段、改变类型、语义或默认值需要新主版本。
格式 2 清单的最小必需表是[包]。锁文件固定完整依赖图和清单校验和。YXB/YXP 使用确定顺序,相同输入应逐字节相同;内容 SHA-256 只证明完整性,不证明发布者身份。详细安全预算与迁移行为见公共格式。