把 `.tim` 文件想象成一本 “多层字典”——最前面是目录,后面是一页一页的词条块。
下面按 从头到尾的字节顺序 拆开讲:
---
1 全局布局(简化版)
```
┌-------------┐
│ Header │ CodecHeader(魔数+版本)
├-------------┤
│ PostingsHdr │ 由具体 postings 实现写的一段自定义头
├-------------┤
│ NodeBlock 0 │ 第 0 个词条块(Outer 或 Inner)
│ NodeBlock 1 │ 第 1 个词条块
│ ... │
├-------------┤
│ FieldSummary │ 每个字段的统计摘要
├-------------┤
│ DirOffset │ Uint64,指向 FieldSummary 的起点
├-------------┤
│ Footer │ CodecFooter(校验和)
└-------------┘
```
---
2 NodeBlock(词条块)内部结构
下面用一张 “四层剖面图” 把 NodeBlock 的完整结构一次性画清。
(把每个字节/字段都落到具体位置,可直接对照源码或十六进制查看器)
```
┌---------------------------------------------------------------┐
│ ① Block 公共头(Header) │
│ ├─ EntryCount VInt 本块条目数 (≥1) │
│ ├─ SuffixLength VInt 最长后缀字节数 │
│ ├─ SuffixBytesLen VLong 后缀区压缩后长度 │
│ ├─ SuffixByte