Lucene 8.5.0 的 `.pos` 文件**逻辑结构**（按真实实现重新整理）
```
.pos 文件
├─ Header (CodecHeader)
├─ TermPositions × TermCount ← 每个 term 一段，顺序由词典隐式决定
│ ├─ PackedPosDeltaBlock × N ← 仅当 **无 payload 且 无 offset** 时存在
│ │ └─ 64 个 position-delta（PackedInts 压缩）
│ ├─ VIntBlock × PosVIntCount ← 必写；剩余所有位置
│ │ ├─ PositionDelta VInt
│ │ ├─ PayloadLength? VInt ← 最低位标记法，payload 启用时出现
│ │ ├─ PayloadData? byte[len] ← **尾巴**阶段内联；整块阶段在 .pay
│ │ ├─ OffsetDelta? VInt ← offsets 启用时出现
│ │ └─ OffsetLength? VInt ← 同上
└─ Footer (CodecFooter)
```
关键结论
`TermPositions` 就是一段连续的二进制数据，其内部按顺序包含：
-
0 个或多个 `PackedPosDeltaBlock`（≥64 个 delta 时才有）
-
1 个 `VIntBlock`（剩余尾巴，长度 ≥0）
因此：
TermPositions ＝ [PackedPosDeltaBlock × N] ＋ VIntBlock
-
**PackedPosDeltaBlock** 只存 **纯 position delta**；
-
**只要启用 payload 或 offset，则 PackedPosDeltaBlock 不出现**，全部走 VIntBlock；
-
**payload bytes** 在"尾巴"阶段 **内联在 `.pos`**，整块阶段 **在 `.pay`**；
-
**offset 元数据** 始终写在 `.pos` 的 VIntBlock。