Expand description
Zenith 核心基础设施重导出
Modules§
- backoff
- 统一指数退避（全 workspace 唯一实现）
- config
- Zenith 配置系统
- ct_
compare - 恒定时间比较工具
- error
- 统一错误类型与错误处理规范
- frame
- Frame 池管理模块
- huffman
- HPACK/QPACK Huffman 编解码器 (RFC 7541 Appendix B)
- ledger
- 分层资源账本模块
- net
- 网络协议常量（单一权威来源）
- prefix_
int - RFC 7541 §5.1 前缀整数编解码（HPACK / QPACK 共享唯一实现）
- random
- 统一随机源（全 workspace 唯一入口）
- sync
- 同步原语辅助（全 workspace 唯一实现）
- token
- 所有权令牌模块
- varint
- QUIC 变长整数编码（RFC 9000 §16 唯一实现）
Structs§
- Cache
Config - 缓存分片与淘汰策略配置。
- FrameId
- Frame ID
- Frame
Info - Frame 信息（紧凑布局，面向缓存）
- Frame
Pool - Frame 池（极致优化版）
- Frame
Token - 所有权令牌
- Huffman
Decoder - Huffman 解码器：将 Huffman 压缩字节还原为原始字节
- Huffman
Encoder - Huffman 编码器：将字节流编码为 Huffman 压缩位流
- Ledger
Quota - 账本令牌数据
- Observability
Config - 可观测性配置（指标、追踪、日志）。
- Resource
Ledger - 层级资源账本
- Runtime
Cfg - 运行时线程模型与内核加速特性配置。
- Security
Config - 安全相关配置（TLS、常量时间比较、eBPF 完整性）。
- Server
Config - 服务器监听与连接生命周期配置。
- Splitmix64
- Splitmix64 伪随机生成器（值语义，零堆分配）
- Zenith
Config - Zenith 框架的顶层配置根，聚合全部子配置段。
Enums§
- Config
Error - 配置加载与校验过程中可能发生的错误。
- Core
Error - 核心错误类型
- Frame
State - Frame 状态
- Huffman
Decode Error - Huffman 解码错误
- Ledger
Type - 资源账本类型层级
- Resource
Type - 资源类型（令牌化）
Constants§
- HUFFMAN_
TABLE - Huffman 编码表：
HUFFMAN_TABLE[symbol] = (code, length) - MAX_
VARINT_ SIZE - RFC 9000 varint 最大编码长度（字节）
- MAX_
VARINT_ VALUE - RFC 9000 varint 最大可编码值（2^62 - 1）
Functions§
- constant_
time_ all_ pass - 恒定时间布尔累积 OR（用于多项验证）
- constant_
time_ contains - 恒定时间子串匹配（AGENT.md §4.9 时序安全）
- constant_
time_ contains_ case_ insensitive - 恒定时间 ASCII 大小写不敏感子串匹配（AGENT.md §4.9 时序安全）
- constant_
time_ eq - 恒定时间字节切片比较
- constant_
time_ eq_ ascii_ lower - 恒定时间 ASCII 大小写不敏感比较
- constant_
time_ eq_ case_ insensitive - 恒定时间 ASCII 大小写不敏感比较（双侧任意大小写）
- constant_
time_ eq_ u32 - 恒定时间 u32 比较
- constant_
time_ eq_ u64 - 恒定时间 u64 比较
- constant_
time_ eq_ u128 - 恒定时间 u128 比较
- constant_
time_ starts_ with - 恒定时间前缀比较（AGENT.md §4.9 时序安全）
- current_
time_ ms - 获取当前 Unix 时间戳（毫秒）
- decode_
prefix_ integer - 解码前缀整数（RFC 7541 §5.1）
- encode_
prefix_ integer - 编码前缀整数（RFC 7541 §5.1）
- encode_
varint - 编码 QUIC 变长度整数到 Vec（fail-closed 包装器）
- encode_
varint_ buf - 编码 QUIC 变长度整数到固定输出缓冲区（fail-closed）
- exponential_
backoff - 计算指数退避（毫秒）：
base * multiplier^exponent，封顶cap - exponential_
backoff_ with_ jitter - 计算带全抖动的指数退避（毫秒）：
[0, exponential_backoff]均匀随机 - hex_
encode - 字节切片 → 小写 hex 字符串（无依赖，逐字节
{:02x}） - lock_
recover - 获取互斥锁，中毒时恢复内部数据（poison-tolerant）
- parse_
varint - 解析 QUIC/HTTP/3 变长度整数 (RFC 9000 §16)
- pseudo_
random_ bounded - 线程本地伪随机，输出
[0, bound)（bound 为 0 时返回 0） - pseudo_
random_ u64 - 线程本地伪随机（热路径零系统调用、零同步开销）
- random_
u64 - 从 OS 熵源获取密码学安全随机数
- read_
recover - 获取 RwLock 读锁，中毒时恢复（语义同
lock_recover) - try_
fill_ random - 填充密码学安全随机字节
- try_
random_ u64 - 从 OS 熵源读取 8 字节（CSPRNG）
- write_
recover - 获取 RwLock 写锁，中毒时恢复（语义同
lock_recover)
Type Aliases§
- Core
Result - 核心结果类型