- 模块架构与关联关系 - 各模块职责、依赖方向、控制流与数据流,附 Mermaid 图
- 基本概念 - Storage、Instance Group、Instance、Block、CacheLocation 等核心概念
- ReportEvent 增量上报与权威快照设计 - 增量/快照协同、提交屏障、故障恢复、性能取舍与 Subscriber 集成
- ReportEvent / GetHostCacheState 小 block 性能记录 - local/Redis 指标解释、锁与可见性语义、有界并发、容量基准及后续优化边界
- 高可用与选主机制 - HA 架构、LeaderElector 状态机、CoordinationBackend、Leader 发现
- CacheReclaimer 异步删除与过度逐出优化 - 异步删除生命周期、in-flight credit、反压与无进展退避
- 后台扫描 GC - 基于 authoritative cursor 的后台全量巡检;V1 清理长期 orphan WRITING 和普通 SERVING storage-missing,并提供无副作用读取、精确值条件 CAS 与 HA 生命周期
- 开发指南 - 开发者入门指南和开发环境配置
- Commit 要求 - 提交前检查和 commit message 格式约定
- 构建版本信息 - Version Stamping 机制原理与使用方式
- API 文档 - API 接口说明和使用示例
- ReportEvent 与查询接口行为 - 面向调用方的事件上报、全量对账、查询、错误处理和测试覆盖清单
- 优化器文档 - 缓存优化策略和算法说明
- Prometheus Metrics
- Crash Stack Trace
更多文档将会陆续迁移到本repo。