外观
BTL 文件布局
1. 当前物理格式结论
原版 loader 先读取固定 0x80 字节 Header，再依据 Header 中的 count、版本和地图来源依次切分后续 section。当前最新 Android 1.30.0 原版 corpus 的 1383 个 BTL 已按正式物理布局合同全部精确切分到 EOF，1383/1383 zero-byte delta；1.29.0 / 1359 与 1.28.0 / 1358 保留为历史基线。
1.30 没有出现 v4、新 section、新 Unit/Reinforcement record size 或新的尾部包络。该结论是物理格式结论，不代表每个 section 内所有字段的玩法语义都已闭合。
2. 固定 section 顺序
| 顺序 | Section | Count 来源 | 单条长度 |
|---|---|---|---|
| 1 | Header | 固定 1 | 0x80 |
| 2 | Country | H18 | 0x12C |
| 3 | Embedded Terrain | MapSource == 0 时 width * height | 0x10 |
| 4 | Province Slot | H58 | 0x02 |
| 5 | Tile Owner Slot | H58 | 0x01 |
| 6 | Building | H1C | 0x20 |
| 7 | Unit | H20 | v1 0x30；v2/v3 0x40 |
| 8 | Mine | H68 | 0x0C |
| 9 | Behavior / ArmyAIConfig Entry | H24 | 0x10 |
| 10 | Weather | H2C | 0x10 |
| 11 | Event | H28 | 0x2C |
| 12 | Reinforcement | H3C | v1 0x50；v2/v3 0x68 |
| 13 | Airstrike | H40 | 0x14 |
| 14 | Start Group A | H44 | 0x08 |
| 15 | Start Group B | H48 | 0x08 |
| 16 | Flag / Capital | H4C | 0x04 |
| 17 | Initial Country Strategy Override | H6C | 0x08 |
| 18 | Country Strategy Schedule | H70 | 0x10 |
| 19 | Air Support | H7C | 0x10 |
| 20 | ExtensionArea | v3+ H54 字节 | byte stream |
证据入口：reports/btl_v1280_so_recovery.md。
3. Header H58
H58 不是社区旧文档所称的“可选择地块数量”。
在当前 1.30.0 的 1383/1383 原版 BTL 中：
text
H58 == align_up(width * height, 8)原版实际地图 cell 仍由 width * height 决定；H58 用于后续 Province 与 Tile Owner 平行数组的对齐 slot 数。
当前状态：Confirmed。
4. Header H54
H54 是版本相关字段：
- v3+：原版 parser 将其作为 ExtensionArea 的 protobuf 字节长度，并调用
ParseFromArray； - v1/v2：不能无条件赋予相同全局语义。
当前 415 个非空 v3 ExtensionArea 样本均成功按 1.30 Game.proto descriptor wire 解析。1.29 -> 1.30 的 BattleExArgs 可达类型树保持 17 个 message / 78 个字段，未新增 EliteSkin 字段。
当前状态：物理用途 Confirmed，完整 Extension 语义 Partial。
5. Header H6C
H6C 是 InitialCountryStrategyOverrideRecord 数量；每条记录 0x08：
text
+0x00 int32 countryId
+0x04 int32 strategyRowId原版 consumer 将记录写入国家 strategy 的开局覆盖容器。
当前 1.30.0 corpus 中 H6C == 0 为 1383/1383，因此布局与 consumer 已确认，但正记录值域和部分异常边界属于 UnknownNoPositiveCorpus。
证据入口：reconstruction/docs/btl_editor_round38_unknown_compatibility_record_semantics_recovery_report.md。
6. 版本统计
当前最新 1.30.0 corpus：
| BTL 版本 | 文件数 |
|---|---|
| v1 | 425 |
| v2 | 25 |
| v3 | 933 |
| 合计 | 1383 |
地图来源：
| MapSource | 文件数 | 当前解释 |
|---|---|---|
| 0 | 1073 | BTL 内嵌 terrain |
| 1 | 310 | 使用外部 world.bin 地图来源 |
其他 MapSource 值的容量和行为不能由当前 corpus 推断，保持 Unknown。
1.30 物理基线的机器证据见 reports/btl_reference/android_1300_baseline_and_elite_skin_index.json。其中新增 conquest9.btl 本身是 v3，但 H54 = 0，可直接排除“征服 9 的精英皮肤数据来自 v3 ExtensionArea”这一解释。
7. Round-trip 边界
当前 raw-first parser/writer 基线已经证明：
- 完整文件包络可以精确切分；
- 未修改 BTL 可以 byte-identical round-trip；
- ExtensionArea、未知字节和现有 section 布局可以原样保存；
- 这不等价于任意结构修改或未知字段写入已经安全。
结构增删、count/length 联动、未知字段规范化和任意 Extension 重建仍必须遵守独立 writer 门禁。